Typescript API spec proposal

typescript/index.ts

@@ -1,4 +1,45 @@
-import { version, Parser } from "./pkg/cooklang_wasm";
+import { version, Parser, Recipe } from "./pkg/cooklang_wasm";
 
 export { version, Parser };
 export type { ScaledRecipeWithReport } from "./pkg/cooklang_wasm";
+
+type RecipeRenderer<T> = (recipe: Recipe) => T;
+
+export class CooklangRecipe {
+
+    private recipe: Recipe;
+
+    static parser = new Parser();
+
+    static fromString(raw: string) {
+        const recipe = CooklangRecipe.parser.parse(raw);
+        return new CooklangRecipe(recipe.recipe);
+    }
+
+    static fromStringNaive(raw: string) {
+        const parser = new Parser();
+        const recipe = parser.parse(raw);
+        return new CooklangRecipe(recipe.recipe);
+    }
+
+    static async fromFile(fp: File) {
+        return CooklangRecipe.fromString(await fp.text());
+    }
+
+    constructor(recipe: Recipe) {
+        this.recipe = recipe;
+    }
+
+    public render<T>(renderer: RecipeRenderer<T>) {
+        return renderer(this.recipe);
+    }
+
+    get ingredients() {
+        return this.recipe.ingredients;
+    }
+
+    get metadata() {
+        return {}  // Todo: implement
+    }
+
+}

typescript/package.json

@@ -23,11 +23,12 @@
     "build-wasm": "wasm-pack build --target bundler",
     "watch-wasm": "wasm-pack build --dev --mode no-install --target bundler",
     "prepare": "npm run build-wasm && npm run build",
-    "test": "vitest"
+    "test": "vitest",
+    "bench": "vitest bench"
   },
   "devDependencies": {
     "vite-plugin-wasm": "^3.4.1",
     "vitest": "^3.2.3",
     "wasm-pack": "^0.13.1"
   }
-}
+}

typescript/test/parse.bench.ts

@@ -0,0 +1,13 @@
+import { describe, bench } from "vitest";
+import { CooklangRecipe } from "..";
+
+describe("Recipe Parse", async () => {
+    bench("optimized", async () => {
+        const recipeRaw = "this could be a @recipe";
+        CooklangRecipe.fromString(recipeRaw);
+    });
+    bench("naive", async () => {
+        const recipeRaw = "this could be a @recipe";
+        CooklangRecipe.fromStringNaive(recipeRaw);
+    });
+})