@hanzogui/recipes 8.3.0 → 8.3.2

package/package.json

@@ -1,37 +1,48 @@
 {
   "name": "@hanzogui/recipes",
-  "version": "8.3.0",
+  "version": "8.3.2",
   "description": "Hanzo GUI recipe library: read from Base, resolve transitive deps, install into a project.",
+  "homepage": "https://gui.hanzo.ai",
   "license": "BSD-3-Clause",
   "author": "Hanzo AI <dev@hanzo.ai>",
-  "homepage": "https://gui.hanzo.ai",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/hanzoai/gui.git",
     "directory": "pkgs/recipes"
   },
+  "source": "src/index.ts",
+  "files": [
+    "src",
+    "types",
+    "dist"
+  ],
   "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./types/index.d.ts",
   "exports": {
+    "./package.json": "./package.json",
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "types": "./types/index.d.ts",
+      "react-native": "./dist/esm/index.js",
+      "browser": "./dist/esm/index.js",
+      "module": "./dist/esm/index.js",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "default": "./dist/esm/index.js"
     }
   },
-  "source": "src/index.ts",
-  "files": [
-    "src/**/*.ts",
-    "!src/**/*.test.ts",
-    "dist"
-  ],
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "bun run build.ts",
-    "clean": "rm -rf dist",
-    "test": "bun test"
+    "build": "hanzogui-build --skip-native",
+    "test": "bun test",
+    "clean": "hanzogui-build clean",
+    "clean:build": "hanzogui-build clean:build"
+  },
+  "devDependencies": {
+    "@hanzogui/build": "8.3.2"
   },
   "engines": {
     "node": ">=20"

package/readme.md

@@ -3,12 +3,7 @@
 Library for reading and installing Hanzo GUI recipes from Hanzo Base.
 
 ```ts
-import {
-  listRecipes,
-  getRecipe,
-  resolveRecipe,
-  installPlan,
-} from '@hanzogui/recipes'
+import { listRecipes, getRecipe, resolveRecipe, installPlan } from '@hanzogui/recipes'
 
 // Anonymous read path (used by @hanzogui/get CLI, website, IDE extensions)
 const recipes = await listRecipes()

package/src/admin.test.ts

@@ -0,0 +1,116 @@
+import { test, expect, beforeEach, afterEach } from 'bun:test'
+import { authAdmin, ensureCollection, upsertRecipe } from './admin.js'
+
+const BASE = 'https://example.test'
+
+let calls: Array<{ url: string; method?: string; body?: string }> = []
+let responses: Response[]
+const originalFetch = globalThis.fetch
+
+beforeEach(() => {
+  calls = []
+  responses = []
+  globalThis.fetch = ((url: string, init?: RequestInit) => {
+    calls.push({ url, method: init?.method, body: init?.body as string | undefined })
+    const r = responses.shift()
+    if (!r) throw new Error(`No response queued for ${url}`)
+    return Promise.resolve(r)
+  }) as typeof fetch
+})
+
+afterEach(() => {
+  globalThis.fetch = originalFetch
+})
+
+const json = (body: unknown, status = 200) =>
+  new Response(JSON.stringify(body), {
+    status,
+    headers: { 'Content-Type': 'application/json' },
+  })
+const empty = (status: number) => new Response('', { status })
+
+test('authAdmin POSTs to /v1/base/admins/auth-with-password and returns token', async () => {
+  responses = [json({ token: 'tok-abc' })]
+  const token = await authAdmin({ baseUrl: BASE, email: 'z@hanzo.ai', password: 'pw' })
+  expect(token).toBe('tok-abc')
+  expect(calls[0].url).toBe(`${BASE}/v1/base/admins/auth-with-password`)
+  expect(calls[0].method).toBe('POST')
+  expect(JSON.parse(calls[0].body!)).toEqual({ identity: 'z@hanzo.ai', password: 'pw' })
+})
+
+test('authAdmin throws on bad credentials', async () => {
+  responses = [new Response('bad', { status: 401 })]
+  try {
+    await authAdmin({ baseUrl: BASE, email: 'z@hanzo.ai', password: 'wrong' })
+    throw new Error('expected throw')
+  } catch (e: any) {
+    expect(e.message).toContain('Admin auth failed')
+    expect(e.message).toContain('401')
+  }
+})
+
+test('ensureCollection returns "existed" when collection probe is 200', async () => {
+  responses = [json({ name: 'gui_recipes' })]
+  expect(await ensureCollection({ baseUrl: BASE, token: 't' })).toBe('existed')
+  expect(calls).toHaveLength(1)
+})
+
+test('ensureCollection POSTs schema when probe is 404, returns "created"', async () => {
+  responses = [empty(404), json({ id: 'new' })]
+  expect(await ensureCollection({ baseUrl: BASE, token: 't' })).toBe('created')
+  expect(calls[1].method).toBe('POST')
+  expect(calls[1].url).toBe(`${BASE}/v1/base/collections`)
+  const sent = JSON.parse(calls[1].body!)
+  expect(sent.name).toBe('gui_recipes')
+  expect(sent.schema.find((f: any) => f.name === 'slug').unique).toBe(true)
+})
+
+test('upsertRecipe POSTs new record when no existing match', async () => {
+  responses = [
+    json({ items: [], page: 1, perPage: 1, totalItems: 0, totalPages: 0 }),
+    json({ id: 'new-id' }),
+  ]
+  const result = await upsertRecipe(
+    { baseUrl: BASE, token: 't' },
+    {
+      slug: 'x',
+      name: 'X',
+      description: '',
+      category: 'misc',
+      npmDeps: [],
+      recipeDeps: [],
+      files: [],
+    }
+  )
+  expect(result).toBe('created')
+  expect(calls[1].method).toBe('POST')
+  expect(calls[1].url).toBe(`${BASE}/v1/base/collections/gui_recipes/records`)
+})
+
+test('upsertRecipe PATCHes existing record when slug matches', async () => {
+  responses = [
+    json({
+      items: [{ id: 'existing-id' }],
+      page: 1,
+      perPage: 1,
+      totalItems: 1,
+      totalPages: 1,
+    }),
+    json({ id: 'existing-id' }),
+  ]
+  const result = await upsertRecipe(
+    { baseUrl: BASE, token: 't' },
+    {
+      slug: 'x',
+      name: 'X',
+      description: '',
+      category: 'misc',
+      npmDeps: [],
+      recipeDeps: [],
+      files: [],
+    }
+  )
+  expect(result).toBe('updated')
+  expect(calls[1].method).toBe('PATCH')
+  expect(calls[1].url).toBe(`${BASE}/v1/base/collections/gui_recipes/records/existing-id`)
+})

package/src/config.test.ts

@@ -0,0 +1,28 @@
+import { test, expect, afterEach } from 'bun:test'
+import { resolveBaseUrl, DEFAULT_BASE_URL } from './config.js'
+
+const original = process.env.HANZO_BASE_URL
+
+afterEach(() => {
+  if (original === undefined) delete process.env.HANZO_BASE_URL
+  else process.env.HANZO_BASE_URL = original
+})
+
+test('resolveBaseUrl returns the override when provided', () => {
+  expect(resolveBaseUrl('https://x.example')).toBe('https://x.example')
+})
+
+test('resolveBaseUrl reads HANZO_BASE_URL env when no override', () => {
+  process.env.HANZO_BASE_URL = 'https://env.example'
+  expect(resolveBaseUrl()).toBe('https://env.example')
+})
+
+test('resolveBaseUrl falls back to DEFAULT_BASE_URL', () => {
+  delete process.env.HANZO_BASE_URL
+  expect(resolveBaseUrl()).toBe(DEFAULT_BASE_URL)
+})
+
+test('explicit override beats env', () => {
+  process.env.HANZO_BASE_URL = 'https://env.example'
+  expect(resolveBaseUrl('https://arg.example')).toBe('https://arg.example')
+})

package/src/project.test.ts

@@ -0,0 +1,63 @@
+import { test, expect } from 'bun:test'
+import { mkdtemp, writeFile, mkdir, rm } from 'node:fs/promises'
+import path from 'node:path'
+import os from 'node:os'
+import { findProjectRoot, readConfig, resolveInstallDir } from './project.js'
+import { DEFAULT_INSTALL_DIR } from './config.js'
+
+async function tmpDir(): Promise<string> {
+  return await mkdtemp(path.join(os.tmpdir(), 'recipes-test-'))
+}
+
+test('findProjectRoot returns nearest dir with workspaces in package.json', async () => {
+  const root = await tmpDir()
+  await writeFile(path.join(root, 'package.json'), JSON.stringify({ workspaces: [] }))
+  const child = path.join(root, 'apps', 'foo')
+  await mkdir(child, { recursive: true })
+  expect(await findProjectRoot(child)).toBe(root)
+  await rm(root, { recursive: true })
+})
+
+test('findProjectRoot falls back to .git root when no workspaces', async () => {
+  const root = await tmpDir()
+  await mkdir(path.join(root, '.git'))
+  const child = path.join(root, 'src')
+  await mkdir(child, { recursive: true })
+  expect(await findProjectRoot(child)).toBe(root)
+  await rm(root, { recursive: true })
+})
+
+test('findProjectRoot returns start when nothing matches', async () => {
+  const root = await tmpDir()
+  expect(await findProjectRoot(root)).toBe(root)
+  await rm(root, { recursive: true })
+})
+
+test('readConfig prefers gui.config.json over .guirc.json', async () => {
+  const root = await tmpDir()
+  await writeFile(path.join(root, 'gui.config.json'), JSON.stringify({ installDir: 'a' }))
+  await writeFile(path.join(root, '.guirc.json'), JSON.stringify({ installDir: 'b' }))
+  expect((await readConfig(root)).installDir).toBe('a')
+  await rm(root, { recursive: true })
+})
+
+test('readConfig returns {} when no config file', async () => {
+  const root = await tmpDir()
+  expect(await readConfig(root)).toEqual({})
+  await rm(root, { recursive: true })
+})
+
+test('readConfig returns {} when config is invalid JSON', async () => {
+  const root = await tmpDir()
+  await writeFile(path.join(root, 'gui.config.json'), '{ broken')
+  expect(await readConfig(root)).toEqual({})
+  await rm(root, { recursive: true })
+})
+
+test('resolveInstallDir uses config.installDir when present', () => {
+  expect(resolveInstallDir('/r', { installDir: 'src/widgets' })).toBe('/r/src/widgets')
+})
+
+test('resolveInstallDir falls back to DEFAULT_INSTALL_DIR', () => {
+  expect(resolveInstallDir('/r', {})).toBe(`/r/${DEFAULT_INSTALL_DIR}`)
+})

package/src/read.test.ts

@@ -0,0 +1,163 @@
+import { test, expect, beforeEach, afterEach, mock } from 'bun:test'
+import { listRecipes, getRecipe, resolveRecipe } from './read.js'
+import type { Recipe } from './types.js'
+
+const BASE = 'https://example.test'
+
+type FetchCall = { url: string; init?: RequestInit }
+
+let calls: FetchCall[] = []
+let responses: Array<(url: string) => Response>
+const originalFetch = globalThis.fetch
+
+beforeEach(() => {
+  calls = []
+  responses = []
+  globalThis.fetch = ((url: string, init?: RequestInit) => {
+    calls.push({ url, init })
+    const handler = responses.shift()
+    if (!handler) throw new Error(`No response queued for ${url}`)
+    return Promise.resolve(handler(url))
+  }) as typeof fetch
+})
+
+afterEach(() => {
+  globalThis.fetch = originalFetch
+})
+
+const jsonResponse = (body: unknown, status = 200) =>
+  new Response(JSON.stringify(body), {
+    status,
+    headers: { 'Content-Type': 'application/json' },
+  })
+
+const recipeFixture = (slug: string, recipeDeps: string[] = []): Recipe => ({
+  id: `id-${slug}`,
+  slug,
+  name: slug,
+  description: '',
+  category: 'test',
+  npmDeps: [],
+  recipeDeps,
+  files: [{ path: `${slug}.tsx`, source: `// ${slug}` }],
+  created: '',
+  updated: '',
+})
+
+test('listRecipes hits /v1/base path and returns items', async () => {
+  responses = [
+    () =>
+      jsonResponse({
+        items: [recipeFixture('a'), recipeFixture('b')],
+        page: 1,
+        perPage: 200,
+        totalItems: 2,
+        totalPages: 1,
+      }),
+  ]
+  const recipes = await listRecipes({ baseUrl: BASE })
+  expect(recipes).toHaveLength(2)
+  expect(calls[0].url).toContain('/v1/base/collections/gui_recipes/records')
+  expect(calls[0].url).not.toContain('/api/')
+})
+
+test('getRecipe filters by slug and returns first item', async () => {
+  responses = [
+    () =>
+      jsonResponse({
+        items: [recipeFixture('foo')],
+        page: 1,
+        perPage: 1,
+        totalItems: 1,
+        totalPages: 1,
+      }),
+  ]
+  const recipe = await getRecipe('foo', { baseUrl: BASE })
+  expect(recipe.slug).toBe('foo')
+  expect(calls[0].url).toContain('filter=')
+  expect(decodeURIComponent(calls[0].url)).toContain('slug="foo"')
+})
+
+test('getRecipe throws 404 when no items', async () => {
+  responses = [
+    () => jsonResponse({ items: [], page: 1, perPage: 1, totalItems: 0, totalPages: 0 }),
+  ]
+  try {
+    await getRecipe('missing', { baseUrl: BASE })
+    throw new Error('should have thrown')
+  } catch (e: any) {
+    expect(e.status).toBe(404)
+    expect(e.message).toContain('missing')
+  }
+})
+
+test('resolveRecipe walks transitive recipeDeps', async () => {
+  responses = [
+    () =>
+      jsonResponse({
+        items: [recipeFixture('parent', ['childA', 'childB'])],
+        page: 1,
+        perPage: 1,
+        totalItems: 1,
+        totalPages: 1,
+      }),
+    () =>
+      jsonResponse({
+        items: [recipeFixture('childA', ['grandchild'])],
+        page: 1,
+        perPage: 1,
+        totalItems: 1,
+        totalPages: 1,
+      }),
+    () =>
+      jsonResponse({
+        items: [recipeFixture('childB')],
+        page: 1,
+        perPage: 1,
+        totalItems: 1,
+        totalPages: 1,
+      }),
+    () =>
+      jsonResponse({
+        items: [recipeFixture('grandchild')],
+        page: 1,
+        perPage: 1,
+        totalItems: 1,
+        totalPages: 1,
+      }),
+  ]
+  const plan = await resolveRecipe('parent', { baseUrl: BASE, installDir: '/tmp/test' })
+  expect(plan.recipe.slug).toBe('parent')
+  expect(plan.transitiveRecipes.map((r) => r.slug).sort()).toEqual([
+    'childA',
+    'childB',
+    'grandchild',
+  ])
+  expect(plan.targetPaths).toHaveLength(4)
+  expect(plan.targetPaths.every((p) => p.startsWith('/tmp/test/'))).toBe(true)
+})
+
+test('resolveRecipe avoids re-fetching cycles', async () => {
+  responses = [
+    () =>
+      jsonResponse({
+        items: [recipeFixture('a', ['b'])],
+        page: 1,
+        perPage: 1,
+        totalItems: 1,
+        totalPages: 1,
+      }),
+    () =>
+      jsonResponse({
+        items: [recipeFixture('b', ['a'])],
+        page: 1,
+        perPage: 1,
+        totalItems: 1,
+        totalPages: 1,
+      }),
+  ]
+  const plan = await resolveRecipe('a', { baseUrl: BASE, installDir: '/tmp/test' })
+  expect(plan.recipe.slug).toBe('a')
+  expect(plan.transitiveRecipes.map((r) => r.slug)).toEqual(['b'])
+  expect(calls).toHaveLength(2) // not 3 — cycle detected
+})

package/src/write.test.ts

@@ -0,0 +1,52 @@
+import { test, expect } from 'bun:test'
+import { mkdtemp, readFile, rm } from 'node:fs/promises'
+import path from 'node:path'
+import os from 'node:os'
+import { installRecipe, installPlan } from './write.js'
+import type { Recipe, InstallPlan } from './types.js'
+
+const stub = (slug: string, files: Array<[string, string]>): Recipe => ({
+  id: slug,
+  slug,
+  name: slug,
+  description: '',
+  category: 'test',
+  npmDeps: [],
+  recipeDeps: [],
+  files: files.map(([p, s]) => ({ path: p, source: s })),
+  created: '',
+  updated: '',
+})
+
+test('installRecipe writes files into installDir, creating subdirs', async () => {
+  const dir = await mkdtemp(path.join(os.tmpdir(), 'recipes-write-'))
+  const recipe = stub('foo', [
+    ['Foo.tsx', 'export const Foo = 1\n'],
+    ['nested/Deep.tsx', 'export const Deep = 1\n'],
+  ])
+  const written = await installRecipe(recipe, { installDir: dir })
+  expect(written).toHaveLength(2)
+  expect(await readFile(path.join(dir, 'Foo.tsx'), 'utf8')).toBe('export const Foo = 1\n')
+  expect(await readFile(path.join(dir, 'nested/Deep.tsx'), 'utf8')).toBe(
+    'export const Deep = 1\n'
+  )
+  await rm(dir, { recursive: true })
+})
+
+test('installPlan writes the recipe plus its transitive deps', async () => {
+  const dir = await mkdtemp(path.join(os.tmpdir(), 'recipes-plan-'))
+  const plan: InstallPlan = {
+    recipe: stub('parent', [['Parent.tsx', 'P']]),
+    transitiveRecipes: [
+      stub('childA', [['ChildA.tsx', 'A']]),
+      stub('childB', [['nested/ChildB.tsx', 'B']]),
+    ],
+    targetPaths: [],
+  }
+  const written = await installPlan(plan, { installDir: dir })
+  expect(written).toHaveLength(3)
+  expect(await readFile(path.join(dir, 'Parent.tsx'), 'utf8')).toBe('P')
+  expect(await readFile(path.join(dir, 'ChildA.tsx'), 'utf8')).toBe('A')
+  expect(await readFile(path.join(dir, 'nested/ChildB.tsx'), 'utf8')).toBe('B')
+  await rm(dir, { recursive: true })
+})

package/types/admin.d.ts

@@ -0,0 +1,17 @@
+import type { RecipeInput } from './types.js';
+export type AdminAuth = {
+    baseUrl?: string;
+    token: string;
+};
+export type AdminPasswordAuth = {
+    baseUrl?: string;
+    email: string;
+    password: string;
+};
+/** Exchanges admin email+password for a Base session token. */
+export declare function authAdmin({ baseUrl, email, password, }: AdminPasswordAuth): Promise<string>;
+/** Idempotent: creates the gui_recipes collection if missing, no-ops otherwise. */
+export declare function ensureCollection(auth: AdminAuth): Promise<'created' | 'existed'>;
+/** Upsert by slug: PATCH if existing, POST if new. */
+export declare function upsertRecipe(auth: AdminAuth, recipe: RecipeInput): Promise<'created' | 'updated'>;
+//# sourceMappingURL=admin.d.ts.map

package/types/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../src/admin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAU,WAAW,EAAE,MAAM,YAAY,CAAA;AAErD,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,+DAA+D;AAC/D,wBAAsB,SAAS,CAAC,EAC9B,OAAO,EACP,KAAK,EACL,QAAQ,GACT,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAYrC;AAED,mFAAmF;AACnF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAsCtF;AAcD,sDAAsD;AACtD,wBAAsB,YAAY,CAChC,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAqBhC"}

package/types/config.d.ts

@@ -0,0 +1,6 @@
+export declare const DEFAULT_BASE_URL = "https://base.hanzo.ai";
+export declare const RECIPES_COLLECTION = "gui_recipes";
+export declare const DEFAULT_INSTALL_DIR = "src/gui";
+export declare const DEFAULT_CONFIG_FILENAMES: readonly ['gui.config.json', '.guirc.json'];
+export declare function resolveBaseUrl(override?: string): string;
+//# sourceMappingURL=config.d.ts.map

package/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,0BAA0B,CAAA;AACvD,eAAO,MAAM,kBAAkB,gBAAgB,CAAA;AAC/C,eAAO,MAAM,mBAAmB,YAAY,CAAA;AAC5C,eAAO,MAAM,wBAAwB,YAAI,iBAAiB,EAAE,aAAa,CAAU,CAAA;AAEnF,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/types/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './config.js';
+export * from './project.js';
+export * from './read.js';
+export * from './write.js';
+export * from './admin.js';
+//# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}

package/types/project.d.ts

@@ -0,0 +1,8 @@
+import type { ProjectConfig } from './types.js';
+/** Walks up from `start` until it finds a workspace root, git root, or any package.json. */
+export declare function findProjectRoot(start?: string): Promise<string>;
+/** Reads the first config file that exists in `root`. Returns `{}` if none. */
+export declare function readConfig(root: string): Promise<ProjectConfig>;
+/** Pure resolver: given a root and config, where do recipes install? */
+export declare function resolveInstallDir(root: string, config: ProjectConfig): string;
+//# sourceMappingURL=project.d.ts.map

package/types/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,4FAA4F;AAC5F,wBAAsB,eAAe,CAAC,KAAK,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAepF;AAED,+EAA+E;AAC/E,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAUrE;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAE7E"}

package/types/read.d.ts

@@ -0,0 +1,15 @@
+import type { InstallPlan, Recipe, RecipeSummary } from './types.js';
+export type ReaderOptions = {
+    baseUrl?: string;
+};
+export declare function listRecipes(opts?: ReaderOptions): Promise<RecipeSummary[]>;
+export declare function getRecipe(slug: string, opts?: ReaderOptions): Promise<Recipe>;
+export type ResolveOptions = ReaderOptions & {
+    /** Override the install dir lookup; if omitted, resolved from the user's project. */
+    installDir?: string;
+    /** Override the project root for path resolution. */
+    cwd?: string;
+};
+/** Walks recipeDeps transitively, computes target paths under the resolved install dir. */
+export declare function resolveRecipe(slug: string, opts?: ResolveOptions): Promise<InstallPlan>;
+//# sourceMappingURL=read.d.ts.map

package/types/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../src/read.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAUpE,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAmBD,wBAAsB,WAAW,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAIpF;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CASvF;AAED,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG;IAC3C,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,2FAA2F;AAC3F,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,WAAW,CAAC,CA4BtB"}

package/types/types.d.ts

@@ -0,0 +1,27 @@
+export type RecipeFile = {
+    path: string;
+    source: string;
+};
+export type Recipe = {
+    id: string;
+    slug: string;
+    name: string;
+    description: string;
+    category: string;
+    npmDeps: string[];
+    recipeDeps: string[];
+    files: RecipeFile[];
+    created: string;
+    updated: string;
+};
+export type RecipeSummary = Pick<Recipe, 'id' | 'slug' | 'name' | 'description' | 'category'>;
+export type RecipeInput = Pick<Recipe, 'slug' | 'name' | 'description' | 'category' | 'npmDeps' | 'recipeDeps' | 'files'>;
+export type InstallPlan = {
+    recipe: Recipe;
+    transitiveRecipes: Recipe[];
+    targetPaths: string[];
+};
+export type ProjectConfig = {
+    installDir?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,MAAM,GAAG;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,IAAI,CAC9B,MAAM,EACN,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,UAAU,CACpD,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,IAAI,CAC5B,MAAM,EACN,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,OAAO,CAClF,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA"}

package/types/write.d.ts

@@ -0,0 +1,12 @@
+import type { InstallPlan, Recipe } from './types.js';
+export type WriteOptions = {
+    /** Override the install dir; if omitted, resolved from the user's project. */
+    installDir?: string;
+    /** Override project root for resolution. */
+    cwd?: string;
+};
+/** Writes one recipe's files. Returns absolute paths written. */
+export declare function installRecipe(recipe: Recipe, opts?: WriteOptions): Promise<string[]>;
+/** Writes a recipe and all its transitive dependents from a resolved plan. */
+export declare function installPlan(plan: InstallPlan, opts?: WriteOptions): Promise<string[]>;
+//# sourceMappingURL=write.d.ts.map

package/types/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../src/write.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAErD,MAAM,MAAM,YAAY,GAAG;IACzB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAQD,iEAAiE;AACjE,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,MAAM,EAAE,CAAC,CAWnB;AAED,8EAA8E;AAC9E,wBAAsB,WAAW,CAC/B,IAAI,EAAE,WAAW,EACjB,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,MAAM,EAAE,CAAC,CAMnB"}