@happyvertical/smrt-core 0.55.20 → 0.55.21

package/agents/cookbook-engine.md

@@ -31,6 +31,13 @@ engine.tools / engine.batchTool                      // JSON Schema tool definit
   `set_policy`, `set_theme`, `reset_theme`, `set_name`, `rename_section`,
   `rename_item`, `hide`, `show`, `validate`, `export_cookbook`, `undo`. Navigation
   and focus are not commands: they are an adapter concern.
+- **`set_theme`** takes `preset`, `primary` (a brand colour that replaces the
+  preset, see cookbook.md), `colorScheme`, `fontFamily` (`null` restores the
+  preset font), and `borderRadius` (`none|sm|md|lg|xl|full`), `density`
+  (`comfortable|touch`), `contrast` (`auto|standard|more`). Each is optional and
+  only the fields given change; repeating the same input is an unchanged
+  receipt. Values outside the enums are `invalid_input`. `snapshot().theme`
+  reports the three new fields (`null` when unset); `reset_theme` clears them.
 - **Errors** are typed (`CommandError`: `code`, `message`, `path?`, `details?`):
   `unknown_command`, `invalid_input`, `not_found`, `confirmation_required`,
   `conflict`, `id_reuse`, `batch_failed`, `failed`.

package/agents/cookbook.md

@@ -28,6 +28,21 @@ stylesheet after review.
 brand colour. A host that knows the key applies it; unknown keys are retained
 in the portable document. Older `theme.custom.fontFamily` values still read.
 
+`theme.borderRadius` (`none|sm|md|lg|xl|full`), `theme.density`
+(`comfortable|touch`) and `theme.contrast` (`auto|standard|more`) are optional
+and mirror the `ThemeProvider` props of the same names. Absent means the
+preset's own value (`contrast` absent is `auto`, which follows the OS). They are
+additive: a document without them validates and reads unchanged, so there is no
+version bump. Anything outside the enums is an `invalid_value` diagnostic at
+`theme.<field>`.
+
+`theme.custom.primary` and `ThemeProvider`'s `primaryColor` are different
+controls. The cookbook sets `custom.primary`: the shell builds a whole theme
+from it (`createThemeFromColor`) that REPLACES the preset, so `preset` is
+ignored while it is present. `primaryColor` instead TINTS the current preset by
+overriding only the derived primary colours (`derivePrimaryOverrides`). The
+cookbook has no `primaryColor` field and the shell never passes one.
+
 ## Rules
 
 - Versioning: add optional fields within `version: 1`; readers keep and ignore

package/dist/cookbook/engine/document.d.ts

@@ -55,6 +55,9 @@ export declare function withThemePatch(doc: Cookbook, patch: {
     primary?: string;
     colorScheme?: CookbookTheme['colorScheme'];
     fontFamily?: string | null;
+    borderRadius?: CookbookTheme['borderRadius'];
+    density?: CookbookTheme['density'];
+    contrast?: CookbookTheme['contrast'];
 }): Cookbook;
 /**
  * Check a document against the catalog. Structural errors come from

package/dist/cookbook/engine/document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/cookbook/engine/document.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/cookbook/engine/document.ts"],"names":[],"mappings":"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"}

package/dist/cookbook/engine/document.js

@@ -264,6 +264,9 @@ function compactTheme(theme) {
 	const out = {};
 	if (theme.preset) out.preset = theme.preset;
 	if (theme.colorScheme) out.colorScheme = theme.colorScheme;
+	if (theme.borderRadius) out.borderRadius = theme.borderRadius;
+	if (theme.density) out.density = theme.density;
+	if (theme.contrast) out.contrast = theme.contrast;
 	if (theme.fontFamily) out.fontFamily = theme.fontFamily;
 	if (theme.custom) out.custom = { ...theme.custom };
 	if (theme.customCss) out.customCss = theme.customCss;
@@ -286,6 +289,9 @@ function withThemePatch(doc, patch) {
 		...doc.theme?.custom?.fontFamily ? { fontFamily: doc.theme.custom.fontFamily } : {}
 	};
 	if (patch.colorScheme) next.colorScheme = patch.colorScheme;
+	if (patch.borderRadius) next.borderRadius = patch.borderRadius;
+	if (patch.density) next.density = patch.density;
+	if (patch.contrast) next.contrast = patch.contrast;
 	if (patch.fontFamily === null) {
 		delete next.fontFamily;
 		if (next.custom?.fontFamily) next.custom = { primary: next.custom.primary };

package/dist/cookbook/engine/document.js.map

@@ -1 +1 @@
-{"version":3,"file":"document.js","names":[],"sources":["../../../src/cookbook/engine/document.ts"],"sourcesContent":["import type {\n  Cookbook,\n  CookbookPolicyRow,\n  CookbookTheme,\n} from '@happyvertical/smrt-types';\nimport {\n  COOKBOOK_SCHEMA_URL,\n  COOKBOOK_VERSION,\n  validateCookbook,\n} from '../validate.js';\nimport {\n  COMMERCE_SETTING_TARGETS,\n  DEFAULT_COLOR_SCHEME,\n  DEFAULT_PRESET,\n  DEFAULT_THEME_PRESETS,\n} from './defaults.js';\nimport { buildNav, findModel } from './nav.js';\nimport type {\n  Diagnostic,\n  EngineCatalog,\n  EngineRecipe,\n  RecipeChanges,\n  SettingTargets,\n} from './types.js';\n\n/*\n * Pure document rules: every function takes a cookbook and returns a new one.\n * The engine holds a document and calls these; nothing here keeps state.\n */\n\nexport const clone = <T>(value: T): T =>\n  value === undefined ? value : structuredClone(value);\n\nexport const same = (a: unknown, b: unknown): boolean =>\n  JSON.stringify(a ?? null) === JSON.stringify(b ?? null);\n\nexport const emptyCookbook = (): Cookbook => ({\n  $schema: COOKBOOK_SCHEMA_URL,\n  version: COOKBOOK_VERSION,\n  recipes: [],\n  features: [],\n  policies: [],\n});\n\n/** Does the document hold nothing yet (so replacing it needs no say-so)? */\nexport function isEmptyCookbook(doc: Cookbook): boolean {\n  return (\n    !doc.recipes.length &&\n    !doc.features.length &&\n    !doc.policies.length &&\n    !Object.keys(doc.exposure ?? {}).length &&\n    !doc.layout &&\n    !doc.theme &&\n    !Object.keys(doc.overviews ?? {}).length\n  );\n}\n\nconst sortedUnique = (ids: Iterable<string>) => [...new Set(ids)].sort();\n\n/**\n * The document in its stable shape: sorted ids, sorted policies, empty optional\n * sections absent, key order fixed. Unknown top-level keys are kept (additive\n * fields in v1). Two engines given the same commands export identical text.\n */\nexport function canonical(doc: Cookbook): Cookbook {\n  const known = new Set([\n    '$schema',\n    'version',\n    'name',\n    'description',\n    'recipes',\n    'features',\n    'policies',\n    'exposure',\n    'layout',\n    'theme',\n    'overviews',\n  ]);\n  const out: Cookbook = {\n    $schema: COOKBOOK_SCHEMA_URL,\n    version: COOKBOOK_VERSION,\n    ...(doc.name ? { name: doc.name } : {}),\n    ...(doc.description ? { description: doc.description } : {}),\n    recipes: sortedUnique(doc.recipes),\n    features: sortedUnique(doc.features),\n    policies: [...doc.policies]\n      .sort(\n        (a, b) =>\n          a.objectRef.localeCompare(b.objectRef) ||\n          a.fieldName.localeCompare(b.fieldName),\n      )\n      .map((row) => ({ ...row })),\n  };\n  const exposure = Object.fromEntries(\n    Object.keys(doc.exposure ?? {})\n      .sort()\n      .filter((ref) => doc.exposure?.[ref]?.length)\n      .map((ref) => [ref, [...(doc.exposure?.[ref] ?? [])].sort()]),\n  );\n  if (Object.keys(exposure).length) {\n    out.exposure = exposure as NonNullable<Cookbook['exposure']>;\n  }\n  if (doc.layout) out.layout = clone(doc.layout);\n  const theme = compactTheme(doc.theme);\n  if (theme) out.theme = theme;\n  const overviews = Object.entries(doc.overviews ?? {}).sort(([a], [b]) =>\n    a < b ? -1 : a > b ? 1 : 0,\n  );\n  if (overviews.length) {\n    out.overviews = Object.fromEntries(\n      overviews.map(([id, value]) => [id, clone(value)]),\n    );\n  }\n  for (const [key, value] of Object.entries(doc)) {\n    if (!known.has(key))\n      (out as unknown as Record<string, unknown>)[key] = clone(value);\n  }\n  return out;\n}\n\n// ---- recipes ---------------------------------------------------------------\n\nconst recipeMap = (catalog: EngineCatalog) =>\n  new Map(catalog.recipes.map((r) => [r.id, r]));\n\n/** `ids` plus everything they transitively require, as a sorted set. */\nexport function withRequirements(\n  ids: Iterable<string>,\n  recipes: ReadonlyMap<string, EngineRecipe>,\n): string[] {\n  const result = new Set<string>();\n  const visit = (id: string) => {\n    const recipe = recipes.get(id);\n    if (!recipe || result.has(id)) return;\n    result.add(id);\n    for (const required of recipe.requires) visit(required);\n  };\n  for (const id of ids) visit(id);\n  let changed = true;\n  while (changed) {\n    changed = false;\n    for (const id of [...result]) {\n      for (const alternatives of recipes.get(id)?.requiresAny ?? []) {\n        if (alternatives.some((alt) => result.has(alt))) continue;\n        const first = alternatives.find((alt) => recipes.has(alt));\n        if (first) {\n          visit(first);\n          changed = true;\n        }\n      }\n    }\n  }\n  return sortedUnique(result);\n}\n\n/** Models the added recipes and features cover. */\nexport function coveredModels(\n  catalog: EngineCatalog,\n  doc: Cookbook,\n): Set<string> {\n  const byId = recipeMap(catalog);\n  return new Set([\n    ...doc.recipes.flatMap((id) => byId.get(id)?.models ?? []),\n    ...doc.features,\n  ]);\n}\n\nexport function settingTargets(catalog: EngineCatalog): SettingTargets {\n  return catalog.settingTargets ?? COMMERCE_SETTING_TARGETS;\n}\n\nfunction isSettingRow(catalog: EngineCatalog, row: CookbookPolicyRow): boolean {\n  return Object.values(settingTargets(catalog)).some((targets) =>\n    targets.some((t) => t.model === row.objectRef && t.field === row.fieldName),\n  );\n}\n\n/** Drop options for models nothing covers any more (settings rows stay). */\nexport function prune(catalog: EngineCatalog, doc: Cookbook): Cookbook {\n  const covered = coveredModels(catalog, doc);\n  const next: Cookbook = {\n    ...doc,\n    policies: doc.policies.filter(\n      (r) => covered.has(r.objectRef) || isSettingRow(catalog, r),\n    ),\n  };\n  if (doc.exposure) {\n    const exposure = Object.fromEntries(\n      Object.entries(doc.exposure).filter(([ref]) => covered.has(ref)),\n    );\n    if (Object.keys(exposure).length) next.exposure = exposure;\n    else delete next.exposure;\n  }\n  return next;\n}\n\nconst knownRecipeIds = (catalog: EngineCatalog, doc: Cookbook) => {\n  const byId = recipeMap(catalog);\n  return doc.recipes.filter((id) => byId.has(id));\n};\n\nconst unknownRecipeIds = (catalog: EngineCatalog, doc: Cookbook) => {\n  const byId = recipeMap(catalog);\n  return doc.recipes.filter((id) => !byId.has(id));\n};\n\nfunction diff(\n  before: string[],\n  after: string[],\n): Pick<RecipeChanges, 'added' | 'removed'> {\n  const b = new Set(before);\n  const a = new Set(after);\n  return {\n    added: after.filter((id) => !b.has(id)),\n    removed: before.filter((id) => !a.has(id)),\n  };\n}\n\nexport function withRecipesAdded(\n  catalog: EngineCatalog,\n  doc: Cookbook,\n  ids: readonly string[],\n): { doc: Cookbook; changes: RecipeChanges } {\n  const byId = recipeMap(catalog);\n  const before = knownRecipeIds(catalog, doc);\n  const known = withRequirements([...before, ...ids], byId);\n  const next = {\n    ...doc,\n    recipes: sortedUnique([...known, ...unknownRecipeIds(catalog, doc)]),\n  };\n  return { doc: next, changes: { ...diff(before, known), kept: [] } };\n}\n\nexport function withRecipesRemoved(\n  catalog: EngineCatalog,\n  doc: Cookbook,\n  ids: readonly string[],\n): { doc: Cookbook; changes: RecipeChanges } {\n  const byId = recipeMap(catalog);\n  const before = knownRecipeIds(catalog, doc);\n  const removing = new Set(ids);\n  const known = withRequirements(\n    before.filter((id) => !removing.has(id)),\n    byId,\n  );\n  const next = prune(catalog, {\n    ...doc,\n    recipes: sortedUnique([...known, ...unknownRecipeIds(catalog, doc)]),\n  });\n  const { added, removed } = diff(before, known);\n  return {\n    doc: next,\n    changes: {\n      added,\n      removed,\n      kept: ids.filter((id) => known.includes(id) && before.includes(id)),\n    },\n  };\n}\n\nexport function withFeaturesChanged(\n  catalog: EngineCatalog,\n  doc: Cookbook,\n  ids: readonly string[],\n  on: boolean,\n): { doc: Cookbook; changes: RecipeChanges } {\n  const set = new Set(doc.features);\n  for (const id of ids) {\n    if (on) set.add(id);\n    else set.delete(id);\n  }\n  const features = [...set].sort();\n  let next: Cookbook = { ...doc, features };\n  if (!on) next = prune(catalog, next);\n  return {\n    doc: next,\n    changes: { ...diff(doc.features, features), kept: [] },\n  };\n}\n\nexport const mergeChanges = (\n  a: RecipeChanges,\n  b: RecipeChanges,\n): RecipeChanges => ({\n  added: [...a.added, ...b.added],\n  removed: [...a.removed, ...b.removed],\n  kept: [...a.kept, ...b.kept],\n});\n\n// ---- settings --------------------------------------------------------------\n\nexport interface AppSettings {\n  currency: string;\n  /** A fraction: 0.0825 is 8.25%. */\n  taxRate: number;\n  paymentTerms: string;\n}\n\nexport const DEFAULT_SETTINGS: Readonly<AppSettings> = {\n  currency: 'USD',\n  taxRate: 0,\n  paymentTerms: '',\n};\n\nconst SETTING_KEYS = ['currency', 'taxRate', 'paymentTerms'] as const;\n\nfunction rowValue(row: CookbookPolicyRow | undefined): unknown {\n  if (row?.defaultValue === undefined || row.defaultValue === null)\n    return undefined;\n  try {\n    return JSON.parse(row.defaultValue);\n  } catch {\n    return undefined;\n  }\n}\n\nconst findRow = (\n  policies: readonly CookbookPolicyRow[],\n  model: string,\n  field: string,\n) =>\n  policies.find(\n    (r) =>\n      r.scopeType === 'app' && r.objectRef === model && r.fieldName === field,\n  );\n\n/** The app's settings: the first stored row of each, else the defaults. */\nexport function readSettings(\n  catalog: EngineCatalog,\n  doc: Cookbook,\n): AppSettings {\n  const targets = settingTargets(catalog);\n  const out: AppSettings = { ...DEFAULT_SETTINGS };\n  const first = (key: keyof AppSettings, type: 'number' | 'string') => {\n    for (const { model, field } of targets[key]) {\n      const value = rowValue(findRow(doc.policies, model, field));\n      if (typeof value === type) return value;\n    }\n    return undefined;\n  };\n  const currency = first('currency', 'string');\n  const taxRate = first('taxRate', 'number');\n  const paymentTerms = first('paymentTerms', 'string');\n  if (typeof currency === 'string') out.currency = currency;\n  if (typeof taxRate === 'number') out.taxRate = taxRate;\n  if (typeof paymentTerms === 'string') out.paymentTerms = paymentTerms;\n  return out;\n}\n\nconst isUnset = (v: unknown) => v === undefined || v === null || v === '';\n\nfunction seedDefault(\n  catalog: EngineCatalog,\n  doc: Cookbook,\n  modelId: string,\n  field: string,\n): unknown {\n  const byId = recipeMap(catalog);\n  for (const id of doc.recipes) {\n    const hint = byId.get(id)?.options?.[modelId]?.fields?.[field];\n    if (hint && 'default' in hint) return hint.default;\n  }\n  return findModel(catalog, modelId)?.fields?.find((f) => f.name === field)\n    ?.default;\n}\n\n/**\n * The document with the settings written as app-scope policy rows. A row is\n * written for every model a setting covers (covered or not, so a recipe added\n * later picks it up) and only where the value differs from what the model\n * starts as; otherwise the row's default is removed. Other row keys are kept.\n */\nexport function writeSettings(\n  catalog: EngineCatalog,\n  doc: Cookbook,\n  settings: AppSettings,\n): Cookbook {\n  const targets = settingTargets(catalog);\n  let policies = doc.policies.map((row) => ({ ...row }));\n  for (const key of SETTING_KEYS) {\n    const raw = settings[key];\n    const value =\n      key === 'paymentTerms'\n        ? String(raw).trim()\n        : key === 'currency'\n          ? String(raw).trim().toUpperCase()\n          : raw;\n    for (const { model, field } of targets[key]) {\n      const seed = seedDefault(catalog, doc, model, field);\n      const wanted =\n        !isUnset(value) &&\n        !(!isUnset(seed) && seed === value) &&\n        !(isUnset(seed) && key === 'taxRate' && value === 0);\n      const existing = findRow(policies, model, field);\n      if (wanted) {\n        const encoded = JSON.stringify(value);\n        if (existing) existing.defaultValue = encoded;\n        else\n          policies.push({\n            objectRef: model,\n            fieldName: field,\n            scopeType: 'app',\n            defaultValue: encoded,\n          });\n      } else if (existing) {\n        delete existing.defaultValue;\n        if (Object.keys(existing).length <= 3) {\n          policies = policies.filter((r) => r !== existing);\n        }\n      }\n    }\n  }\n  return { ...doc, policies };\n}\n\n// ---- theme -----------------------------------------------------------------\n\nexport function compactTheme(\n  theme: CookbookTheme | undefined,\n): CookbookTheme | undefined {\n  if (!theme) return undefined;\n  const out: CookbookTheme = {};\n  if (theme.preset) out.preset = theme.preset;\n  if (theme.colorScheme) out.colorScheme = theme.colorScheme;\n  if (theme.fontFamily) out.fontFamily = theme.fontFamily;\n  if (theme.custom) out.custom = { ...theme.custom };\n  if (theme.customCss) out.customCss = theme.customCss;\n  return Object.keys(out).length ? out : undefined;\n}\n\nexport function describeTheme(theme: CookbookTheme | undefined): string {\n  const scheme = theme?.colorScheme ?? DEFAULT_COLOR_SCHEME;\n  const base = theme?.custom\n    ? `brand colour ${theme.custom.primary}`\n    : (theme?.preset ?? DEFAULT_PRESET);\n  return scheme === 'system' ? base : `${base}, ${scheme}`;\n}\n\n/** A preset replaces a brand colour; a brand colour sits on the preset; the scheme is kept. */\nexport function withThemePatch(\n  doc: Cookbook,\n  patch: {\n    preset?: string;\n    primary?: string;\n    colorScheme?: CookbookTheme['colorScheme'];\n    fontFamily?: string | null;\n  },\n): Cookbook {\n  const next: CookbookTheme = { ...(doc.theme ?? {}) };\n  if (patch.preset) {\n    next.preset = patch.preset;\n    delete next.custom;\n  }\n  if (patch.primary) {\n    next.custom = {\n      primary: patch.primary.toLowerCase(),\n      ...(doc.theme?.custom?.fontFamily\n        ? { fontFamily: doc.theme.custom.fontFamily }\n        : {}),\n    };\n  }\n  if (patch.colorScheme) next.colorScheme = patch.colorScheme;\n  if (patch.fontFamily === null) {\n    // Null restores the preset font, so a legacy brand font goes too.\n    delete next.fontFamily;\n    if (next.custom?.fontFamily) next.custom = { primary: next.custom.primary };\n  } else if (patch.fontFamily !== undefined) next.fontFamily = patch.fontFamily;\n  const theme = compactTheme(next);\n  const out = { ...doc };\n  if (theme) out.theme = theme;\n  else delete out.theme;\n  return out;\n}\n\n// ---- validation ------------------------------------------------------------\n\n/**\n * Check a document against the catalog. Structural errors come from\n * `validateCookbook`; the rest need the catalog: unknown ids, unmet `requires`,\n * policy targets nothing covers, layout ids the menu does not have, theme\n * values. Errors mean the app would not build as written; warnings mean\n * something is carried but unused.\n */\nexport function diagnose(\n  catalog: EngineCatalog,\n  input: Cookbook,\n): Diagnostic[] {\n  const out: Diagnostic[] = [];\n  const add = (\n    severity: Diagnostic['severity'],\n    code: string,\n    path: string,\n    message: string,\n  ) => out.push({ severity, code, path, message });\n\n  const structural = validateCookbook(input);\n  if (!structural.ok) {\n    for (const issue of structural.diagnostics.filter(\n      (diagnostic) => diagnostic.severity === 'error',\n    )) {\n      add('error', 'invalid_document', issue.path, issue.message);\n    }\n    return out;\n  }\n  for (const issue of structural.diagnostics) {\n    add(\n      issue.severity,\n      issue.code === 'migrated_schema' ? 'migrated' : issue.code,\n      issue.path,\n      issue.message,\n    );\n  }\n  const doc = structural.cookbook;\n  const byId = recipeMap(catalog);\n\n  const nav = buildNav(catalog, { ...doc, layout: undefined });\n  const checked = validateCookbook(doc, {\n    themePresets: catalog.themePresets ?? DEFAULT_THEME_PRESETS,\n    layout: {\n      sections: nav.map((section) => section.id),\n      items: nav.flatMap((section) => section.items.map((item) => item.id)),\n      ...(catalog.placementItems\n        ? { placementItems: catalog.placementItems }\n        : {}),\n    },\n    overviewIds: [\n      ...nav.map((section) => section.id),\n      ...(doc.layout?.customSections ?? []).map((section) => section.id),\n    ],\n  });\n  for (const issue of checked.diagnostics) {\n    if (\n      issue.code === 'unknown_theme_preset' ||\n      issue.code === 'unknown_layout_id' ||\n      issue.code === 'unknown_overview'\n    ) {\n      add(\n        issue.code === 'unknown_layout_id' &&\n          !issue.path.startsWith('layout.placements.')\n          ? 'warning'\n          : issue.severity,\n        issue.code === 'unknown_theme_preset' ? 'unknown_preset' : issue.code,\n        issue.path,\n        issue.message,\n      );\n    }\n  }\n\n  for (const [i, id] of doc.recipes.entries()) {\n    if (!byId.has(id))\n      add(\n        'error',\n        'unknown_recipe',\n        `recipes[${i}]`,\n        `Unknown recipe \"${id}\".`,\n      );\n  }\n  const closure = new Set(withRequirements(doc.recipes, byId));\n  for (const id of closure) {\n    if (!doc.recipes.includes(id)) {\n      add(\n        'error',\n        'missing_requirement',\n        'recipes',\n        `A recipe needs \"${id}\", which is not listed.`,\n      );\n    }\n  }\n  for (const [i, id] of doc.features.entries()) {\n    const model = findModel(catalog, id);\n    if (!model)\n      add('error', 'unknown_model', `features[${i}]`, `Unknown model \"${id}\".`);\n    else if (model.exposed === false) {\n      add(\n        'error',\n        'model_not_exposed',\n        `features[${i}]`,\n        `${id} cannot be added as a feature.`,\n      );\n    }\n  }\n  const covered = coveredModels(catalog, doc);\n  for (const [i, row] of doc.policies.entries()) {\n    const at = `policies[${i}]`;\n    const model = findModel(catalog, row.objectRef);\n    if (!model) {\n      add(\n        'error',\n        'unknown_model',\n        `${at}.objectRef`,\n        `Unknown model \"${row.objectRef}\".`,\n      );\n      continue;\n    }\n    if (\n      model.fields &&\n      !model.fields.some((f) => f.name === row.fieldName && !f.system)\n    ) {\n      add(\n        'error',\n        'unknown_field',\n        `${at}.fieldName`,\n        `${model.name} has no field \"${row.fieldName}\".`,\n      );\n    }\n    if (!covered.has(row.objectRef) && !isSettingRow(catalog, row)) {\n      add(\n        'warning',\n        'policy_not_covered',\n        at,\n        `${model.name} is not in the app, so this row has no effect.`,\n      );\n    }\n  }\n  for (const ref of Object.keys(doc.exposure ?? {})) {\n    if (!findModel(catalog, ref)) {\n      add(\n        'error',\n        'unknown_model',\n        `exposure.${ref}`,\n        `Unknown model \"${ref}\".`,\n      );\n    }\n  }\n  return out;\n}\n"],"mappings":"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"}
+{"version":3,"file":"document.js","names":[],"sources":["../../../src/cookbook/engine/document.ts"],"sourcesContent":["import type {\n  Cookbook,\n  CookbookPolicyRow,\n  CookbookTheme,\n} from '@happyvertical/smrt-types';\nimport {\n  COOKBOOK_SCHEMA_URL,\n  COOKBOOK_VERSION,\n  validateCookbook,\n} from '../validate.js';\nimport {\n  COMMERCE_SETTING_TARGETS,\n  DEFAULT_COLOR_SCHEME,\n  DEFAULT_PRESET,\n  DEFAULT_THEME_PRESETS,\n} from './defaults.js';\nimport { buildNav, findModel } from './nav.js';\nimport type {\n  Diagnostic,\n  EngineCatalog,\n  EngineRecipe,\n  RecipeChanges,\n  SettingTargets,\n} from './types.js';\n\n/*\n * Pure document rules: every function takes a cookbook and returns a new one.\n * The engine holds a document and calls these; nothing here keeps state.\n */\n\nexport const clone = <T>(value: T): T =>\n  value === undefined ? value : structuredClone(value);\n\nexport const same = (a: unknown, b: unknown): boolean =>\n  JSON.stringify(a ?? null) === JSON.stringify(b ?? null);\n\nexport const emptyCookbook = (): Cookbook => ({\n  $schema: COOKBOOK_SCHEMA_URL,\n  version: COOKBOOK_VERSION,\n  recipes: [],\n  features: [],\n  policies: [],\n});\n\n/** Does the document hold nothing yet (so replacing it needs no say-so)? */\nexport function isEmptyCookbook(doc: Cookbook): boolean {\n  return (\n    !doc.recipes.length &&\n    !doc.features.length &&\n    !doc.policies.length &&\n    !Object.keys(doc.exposure ?? {}).length &&\n    !doc.layout &&\n    !doc.theme &&\n    !Object.keys(doc.overviews ?? {}).length\n  );\n}\n\nconst sortedUnique = (ids: Iterable<string>) => [...new Set(ids)].sort();\n\n/**\n * The document in its stable shape: sorted ids, sorted policies, empty optional\n * sections absent, key order fixed. Unknown top-level keys are kept (additive\n * fields in v1). Two engines given the same commands export identical text.\n */\nexport function canonical(doc: Cookbook): Cookbook {\n  const known = new Set([\n    '$schema',\n    'version',\n    'name',\n    'description',\n    'recipes',\n    'features',\n    'policies',\n    'exposure',\n    'layout',\n    'theme',\n    'overviews',\n  ]);\n  const out: Cookbook = {\n    $schema: COOKBOOK_SCHEMA_URL,\n    version: COOKBOOK_VERSION,\n    ...(doc.name ? { name: doc.name } : {}),\n    ...(doc.description ? { description: doc.description } : {}),\n    recipes: sortedUnique(doc.recipes),\n    features: sortedUnique(doc.features),\n    policies: [...doc.policies]\n      .sort(\n        (a, b) =>\n          a.objectRef.localeCompare(b.objectRef) ||\n          a.fieldName.localeCompare(b.fieldName),\n      )\n      .map((row) => ({ ...row })),\n  };\n  const exposure = Object.fromEntries(\n    Object.keys(doc.exposure ?? {})\n      .sort()\n      .filter((ref) => doc.exposure?.[ref]?.length)\n      .map((ref) => [ref, [...(doc.exposure?.[ref] ?? [])].sort()]),\n  );\n  if (Object.keys(exposure).length) {\n    out.exposure = exposure as NonNullable<Cookbook['exposure']>;\n  }\n  if (doc.layout) out.layout = clone(doc.layout);\n  const theme = compactTheme(doc.theme);\n  if (theme) out.theme = theme;\n  const overviews = Object.entries(doc.overviews ?? {}).sort(([a], [b]) =>\n    a < b ? -1 : a > b ? 1 : 0,\n  );\n  if (overviews.length) {\n    out.overviews = Object.fromEntries(\n      overviews.map(([id, value]) => [id, clone(value)]),\n    );\n  }\n  for (const [key, value] of Object.entries(doc)) {\n    if (!known.has(key))\n      (out as unknown as Record<string, unknown>)[key] = clone(value);\n  }\n  return out;\n}\n\n// ---- recipes ---------------------------------------------------------------\n\nconst recipeMap = (catalog: EngineCatalog) =>\n  new Map(catalog.recipes.map((r) => [r.id, r]));\n\n/** `ids` plus everything they transitively require, as a sorted set. */\nexport function withRequirements(\n  ids: Iterable<string>,\n  recipes: ReadonlyMap<string, EngineRecipe>,\n): string[] {\n  const result = new Set<string>();\n  const visit = (id: string) => {\n    const recipe = recipes.get(id);\n    if (!recipe || result.has(id)) return;\n    result.add(id);\n    for (const required of recipe.requires) visit(required);\n  };\n  for (const id of ids) visit(id);\n  let changed = true;\n  while (changed) {\n    changed = false;\n    for (const id of [...result]) {\n      for (const alternatives of recipes.get(id)?.requiresAny ?? []) {\n        if (alternatives.some((alt) => result.has(alt))) continue;\n        const first = alternatives.find((alt) => recipes.has(alt));\n        if (first) {\n          visit(first);\n          changed = true;\n        }\n      }\n    }\n  }\n  return sortedUnique(result);\n}\n\n/** Models the added recipes and features cover. */\nexport function coveredModels(\n  catalog: EngineCatalog,\n  doc: Cookbook,\n): Set<string> {\n  const byId = recipeMap(catalog);\n  return new Set([\n    ...doc.recipes.flatMap((id) => byId.get(id)?.models ?? []),\n    ...doc.features,\n  ]);\n}\n\nexport function settingTargets(catalog: EngineCatalog): SettingTargets {\n  return catalog.settingTargets ?? COMMERCE_SETTING_TARGETS;\n}\n\nfunction isSettingRow(catalog: EngineCatalog, row: CookbookPolicyRow): boolean {\n  return Object.values(settingTargets(catalog)).some((targets) =>\n    targets.some((t) => t.model === row.objectRef && t.field === row.fieldName),\n  );\n}\n\n/** Drop options for models nothing covers any more (settings rows stay). */\nexport function prune(catalog: EngineCatalog, doc: Cookbook): Cookbook {\n  const covered = coveredModels(catalog, doc);\n  const next: Cookbook = {\n    ...doc,\n    policies: doc.policies.filter(\n      (r) => covered.has(r.objectRef) || isSettingRow(catalog, r),\n    ),\n  };\n  if (doc.exposure) {\n    const exposure = Object.fromEntries(\n      Object.entries(doc.exposure).filter(([ref]) => covered.has(ref)),\n    );\n    if (Object.keys(exposure).length) next.exposure = exposure;\n    else delete next.exposure;\n  }\n  return next;\n}\n\nconst knownRecipeIds = (catalog: EngineCatalog, doc: Cookbook) => {\n  const byId = recipeMap(catalog);\n  return doc.recipes.filter((id) => byId.has(id));\n};\n\nconst unknownRecipeIds = (catalog: EngineCatalog, doc: Cookbook) => {\n  const byId = recipeMap(catalog);\n  return doc.recipes.filter((id) => !byId.has(id));\n};\n\nfunction diff(\n  before: string[],\n  after: string[],\n): Pick<RecipeChanges, 'added' | 'removed'> {\n  const b = new Set(before);\n  const a = new Set(after);\n  return {\n    added: after.filter((id) => !b.has(id)),\n    removed: before.filter((id) => !a.has(id)),\n  };\n}\n\nexport function withRecipesAdded(\n  catalog: EngineCatalog,\n  doc: Cookbook,\n  ids: readonly string[],\n): { doc: Cookbook; changes: RecipeChanges } {\n  const byId = recipeMap(catalog);\n  const before = knownRecipeIds(catalog, doc);\n  const known = withRequirements([...before, ...ids], byId);\n  const next = {\n    ...doc,\n    recipes: sortedUnique([...known, ...unknownRecipeIds(catalog, doc)]),\n  };\n  return { doc: next, changes: { ...diff(before, known), kept: [] } };\n}\n\nexport function withRecipesRemoved(\n  catalog: EngineCatalog,\n  doc: Cookbook,\n  ids: readonly string[],\n): { doc: Cookbook; changes: RecipeChanges } {\n  const byId = recipeMap(catalog);\n  const before = knownRecipeIds(catalog, doc);\n  const removing = new Set(ids);\n  const known = withRequirements(\n    before.filter((id) => !removing.has(id)),\n    byId,\n  );\n  const next = prune(catalog, {\n    ...doc,\n    recipes: sortedUnique([...known, ...unknownRecipeIds(catalog, doc)]),\n  });\n  const { added, removed } = diff(before, known);\n  return {\n    doc: next,\n    changes: {\n      added,\n      removed,\n      kept: ids.filter((id) => known.includes(id) && before.includes(id)),\n    },\n  };\n}\n\nexport function withFeaturesChanged(\n  catalog: EngineCatalog,\n  doc: Cookbook,\n  ids: readonly string[],\n  on: boolean,\n): { doc: Cookbook; changes: RecipeChanges } {\n  const set = new Set(doc.features);\n  for (const id of ids) {\n    if (on) set.add(id);\n    else set.delete(id);\n  }\n  const features = [...set].sort();\n  let next: Cookbook = { ...doc, features };\n  if (!on) next = prune(catalog, next);\n  return {\n    doc: next,\n    changes: { ...diff(doc.features, features), kept: [] },\n  };\n}\n\nexport const mergeChanges = (\n  a: RecipeChanges,\n  b: RecipeChanges,\n): RecipeChanges => ({\n  added: [...a.added, ...b.added],\n  removed: [...a.removed, ...b.removed],\n  kept: [...a.kept, ...b.kept],\n});\n\n// ---- settings --------------------------------------------------------------\n\nexport interface AppSettings {\n  currency: string;\n  /** A fraction: 0.0825 is 8.25%. */\n  taxRate: number;\n  paymentTerms: string;\n}\n\nexport const DEFAULT_SETTINGS: Readonly<AppSettings> = {\n  currency: 'USD',\n  taxRate: 0,\n  paymentTerms: '',\n};\n\nconst SETTING_KEYS = ['currency', 'taxRate', 'paymentTerms'] as const;\n\nfunction rowValue(row: CookbookPolicyRow | undefined): unknown {\n  if (row?.defaultValue === undefined || row.defaultValue === null)\n    return undefined;\n  try {\n    return JSON.parse(row.defaultValue);\n  } catch {\n    return undefined;\n  }\n}\n\nconst findRow = (\n  policies: readonly CookbookPolicyRow[],\n  model: string,\n  field: string,\n) =>\n  policies.find(\n    (r) =>\n      r.scopeType === 'app' && r.objectRef === model && r.fieldName === field,\n  );\n\n/** The app's settings: the first stored row of each, else the defaults. */\nexport function readSettings(\n  catalog: EngineCatalog,\n  doc: Cookbook,\n): AppSettings {\n  const targets = settingTargets(catalog);\n  const out: AppSettings = { ...DEFAULT_SETTINGS };\n  const first = (key: keyof AppSettings, type: 'number' | 'string') => {\n    for (const { model, field } of targets[key]) {\n      const value = rowValue(findRow(doc.policies, model, field));\n      if (typeof value === type) return value;\n    }\n    return undefined;\n  };\n  const currency = first('currency', 'string');\n  const taxRate = first('taxRate', 'number');\n  const paymentTerms = first('paymentTerms', 'string');\n  if (typeof currency === 'string') out.currency = currency;\n  if (typeof taxRate === 'number') out.taxRate = taxRate;\n  if (typeof paymentTerms === 'string') out.paymentTerms = paymentTerms;\n  return out;\n}\n\nconst isUnset = (v: unknown) => v === undefined || v === null || v === '';\n\nfunction seedDefault(\n  catalog: EngineCatalog,\n  doc: Cookbook,\n  modelId: string,\n  field: string,\n): unknown {\n  const byId = recipeMap(catalog);\n  for (const id of doc.recipes) {\n    const hint = byId.get(id)?.options?.[modelId]?.fields?.[field];\n    if (hint && 'default' in hint) return hint.default;\n  }\n  return findModel(catalog, modelId)?.fields?.find((f) => f.name === field)\n    ?.default;\n}\n\n/**\n * The document with the settings written as app-scope policy rows. A row is\n * written for every model a setting covers (covered or not, so a recipe added\n * later picks it up) and only where the value differs from what the model\n * starts as; otherwise the row's default is removed. Other row keys are kept.\n */\nexport function writeSettings(\n  catalog: EngineCatalog,\n  doc: Cookbook,\n  settings: AppSettings,\n): Cookbook {\n  const targets = settingTargets(catalog);\n  let policies = doc.policies.map((row) => ({ ...row }));\n  for (const key of SETTING_KEYS) {\n    const raw = settings[key];\n    const value =\n      key === 'paymentTerms'\n        ? String(raw).trim()\n        : key === 'currency'\n          ? String(raw).trim().toUpperCase()\n          : raw;\n    for (const { model, field } of targets[key]) {\n      const seed = seedDefault(catalog, doc, model, field);\n      const wanted =\n        !isUnset(value) &&\n        !(!isUnset(seed) && seed === value) &&\n        !(isUnset(seed) && key === 'taxRate' && value === 0);\n      const existing = findRow(policies, model, field);\n      if (wanted) {\n        const encoded = JSON.stringify(value);\n        if (existing) existing.defaultValue = encoded;\n        else\n          policies.push({\n            objectRef: model,\n            fieldName: field,\n            scopeType: 'app',\n            defaultValue: encoded,\n          });\n      } else if (existing) {\n        delete existing.defaultValue;\n        if (Object.keys(existing).length <= 3) {\n          policies = policies.filter((r) => r !== existing);\n        }\n      }\n    }\n  }\n  return { ...doc, policies };\n}\n\n// ---- theme -----------------------------------------------------------------\n\nexport function compactTheme(\n  theme: CookbookTheme | undefined,\n): CookbookTheme | undefined {\n  if (!theme) return undefined;\n  const out: CookbookTheme = {};\n  if (theme.preset) out.preset = theme.preset;\n  if (theme.colorScheme) out.colorScheme = theme.colorScheme;\n  if (theme.borderRadius) out.borderRadius = theme.borderRadius;\n  if (theme.density) out.density = theme.density;\n  if (theme.contrast) out.contrast = theme.contrast;\n  if (theme.fontFamily) out.fontFamily = theme.fontFamily;\n  if (theme.custom) out.custom = { ...theme.custom };\n  if (theme.customCss) out.customCss = theme.customCss;\n  return Object.keys(out).length ? out : undefined;\n}\n\nexport function describeTheme(theme: CookbookTheme | undefined): string {\n  const scheme = theme?.colorScheme ?? DEFAULT_COLOR_SCHEME;\n  const base = theme?.custom\n    ? `brand colour ${theme.custom.primary}`\n    : (theme?.preset ?? DEFAULT_PRESET);\n  return scheme === 'system' ? base : `${base}, ${scheme}`;\n}\n\n/** A preset replaces a brand colour; a brand colour sits on the preset; the scheme is kept. */\nexport function withThemePatch(\n  doc: Cookbook,\n  patch: {\n    preset?: string;\n    primary?: string;\n    colorScheme?: CookbookTheme['colorScheme'];\n    fontFamily?: string | null;\n    borderRadius?: CookbookTheme['borderRadius'];\n    density?: CookbookTheme['density'];\n    contrast?: CookbookTheme['contrast'];\n  },\n): Cookbook {\n  const next: CookbookTheme = { ...(doc.theme ?? {}) };\n  if (patch.preset) {\n    next.preset = patch.preset;\n    delete next.custom;\n  }\n  if (patch.primary) {\n    next.custom = {\n      primary: patch.primary.toLowerCase(),\n      ...(doc.theme?.custom?.fontFamily\n        ? { fontFamily: doc.theme.custom.fontFamily }\n        : {}),\n    };\n  }\n  if (patch.colorScheme) next.colorScheme = patch.colorScheme;\n  if (patch.borderRadius) next.borderRadius = patch.borderRadius;\n  if (patch.density) next.density = patch.density;\n  if (patch.contrast) next.contrast = patch.contrast;\n  if (patch.fontFamily === null) {\n    // Null restores the preset font, so a legacy brand font goes too.\n    delete next.fontFamily;\n    if (next.custom?.fontFamily) next.custom = { primary: next.custom.primary };\n  } else if (patch.fontFamily !== undefined) next.fontFamily = patch.fontFamily;\n  const theme = compactTheme(next);\n  const out = { ...doc };\n  if (theme) out.theme = theme;\n  else delete out.theme;\n  return out;\n}\n\n// ---- validation ------------------------------------------------------------\n\n/**\n * Check a document against the catalog. Structural errors come from\n * `validateCookbook`; the rest need the catalog: unknown ids, unmet `requires`,\n * policy targets nothing covers, layout ids the menu does not have, theme\n * values. Errors mean the app would not build as written; warnings mean\n * something is carried but unused.\n */\nexport function diagnose(\n  catalog: EngineCatalog,\n  input: Cookbook,\n): Diagnostic[] {\n  const out: Diagnostic[] = [];\n  const add = (\n    severity: Diagnostic['severity'],\n    code: string,\n    path: string,\n    message: string,\n  ) => out.push({ severity, code, path, message });\n\n  const structural = validateCookbook(input);\n  if (!structural.ok) {\n    for (const issue of structural.diagnostics.filter(\n      (diagnostic) => diagnostic.severity === 'error',\n    )) {\n      add('error', 'invalid_document', issue.path, issue.message);\n    }\n    return out;\n  }\n  for (const issue of structural.diagnostics) {\n    add(\n      issue.severity,\n      issue.code === 'migrated_schema' ? 'migrated' : issue.code,\n      issue.path,\n      issue.message,\n    );\n  }\n  const doc = structural.cookbook;\n  const byId = recipeMap(catalog);\n\n  const nav = buildNav(catalog, { ...doc, layout: undefined });\n  const checked = validateCookbook(doc, {\n    themePresets: catalog.themePresets ?? DEFAULT_THEME_PRESETS,\n    layout: {\n      sections: nav.map((section) => section.id),\n      items: nav.flatMap((section) => section.items.map((item) => item.id)),\n      ...(catalog.placementItems\n        ? { placementItems: catalog.placementItems }\n        : {}),\n    },\n    overviewIds: [\n      ...nav.map((section) => section.id),\n      ...(doc.layout?.customSections ?? []).map((section) => section.id),\n    ],\n  });\n  for (const issue of checked.diagnostics) {\n    if (\n      issue.code === 'unknown_theme_preset' ||\n      issue.code === 'unknown_layout_id' ||\n      issue.code === 'unknown_overview'\n    ) {\n      add(\n        issue.code === 'unknown_layout_id' &&\n          !issue.path.startsWith('layout.placements.')\n          ? 'warning'\n          : issue.severity,\n        issue.code === 'unknown_theme_preset' ? 'unknown_preset' : issue.code,\n        issue.path,\n        issue.message,\n      );\n    }\n  }\n\n  for (const [i, id] of doc.recipes.entries()) {\n    if (!byId.has(id))\n      add(\n        'error',\n        'unknown_recipe',\n        `recipes[${i}]`,\n        `Unknown recipe \"${id}\".`,\n      );\n  }\n  const closure = new Set(withRequirements(doc.recipes, byId));\n  for (const id of closure) {\n    if (!doc.recipes.includes(id)) {\n      add(\n        'error',\n        'missing_requirement',\n        'recipes',\n        `A recipe needs \"${id}\", which is not listed.`,\n      );\n    }\n  }\n  for (const [i, id] of doc.features.entries()) {\n    const model = findModel(catalog, id);\n    if (!model)\n      add('error', 'unknown_model', `features[${i}]`, `Unknown model \"${id}\".`);\n    else if (model.exposed === false) {\n      add(\n        'error',\n        'model_not_exposed',\n        `features[${i}]`,\n        `${id} cannot be added as a feature.`,\n      );\n    }\n  }\n  const covered = coveredModels(catalog, doc);\n  for (const [i, row] of doc.policies.entries()) {\n    const at = `policies[${i}]`;\n    const model = findModel(catalog, row.objectRef);\n    if (!model) {\n      add(\n        'error',\n        'unknown_model',\n        `${at}.objectRef`,\n        `Unknown model \"${row.objectRef}\".`,\n      );\n      continue;\n    }\n    if (\n      model.fields &&\n      !model.fields.some((f) => f.name === row.fieldName && !f.system)\n    ) {\n      add(\n        'error',\n        'unknown_field',\n        `${at}.fieldName`,\n        `${model.name} has no field \"${row.fieldName}\".`,\n      );\n    }\n    if (!covered.has(row.objectRef) && !isSettingRow(catalog, row)) {\n      add(\n        'warning',\n        'policy_not_covered',\n        at,\n        `${model.name} is not in the app, so this row has no effect.`,\n      );\n    }\n  }\n  for (const ref of Object.keys(doc.exposure ?? {})) {\n    if (!findModel(catalog, ref)) {\n      add(\n        'error',\n        'unknown_model',\n        `exposure.${ref}`,\n        `Unknown model \"${ref}\".`,\n      );\n    }\n  }\n  return out;\n}\n"],"mappings":";;;;AA8BA,IAAa,SAAY,UACvB,UAAU,KAAA,IAAY,QAAQ,gBAAgB,KAAK;AAErD,IAAa,QAAQ,GAAY,MAC/B,KAAK,UAAU,KAAK,IAAI,MAAM,KAAK,UAAU,KAAK,IAAI;AAExD,IAAa,uBAAiC;CAC5C,SAAS;CACT,SAAA;CACA,SAAS,CAAC;CACV,UAAU,CAAC;CACX,UAAU,CAAC;AACb;;AAGA,SAAgB,gBAAgB,KAAwB;CACtD,OACE,CAAC,IAAI,QAAQ,UACb,CAAC,IAAI,SAAS,UACd,CAAC,IAAI,SAAS,UACd,CAAC,OAAO,KAAK,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,UACjC,CAAC,IAAI,UACL,CAAC,IAAI,SACL,CAAC,OAAO,KAAK,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC;AAEtC;AAEA,IAAM,gBAAgB,QAA0B,CAAC,GAAG,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK;;;;;;AAOvE,SAAgB,UAAU,KAAyB;CACjD,MAAM,wBAAQ,IAAI,IAAI;EACpB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC;CACD,MAAM,MAAgB;EACpB,SAAS;EACT,SAAA;EACA,GAAI,IAAI,OAAO,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;EACrC,GAAI,IAAI,cAAc,EAAE,aAAa,IAAI,YAAY,IAAI,CAAC;EAC1D,SAAS,aAAa,IAAI,OAAO;EACjC,UAAU,aAAa,IAAI,QAAQ;EACnC,UAAU,CAAC,GAAG,IAAI,QAAQ,CAAC,CACxB,MACE,GAAG,MACF,EAAE,UAAU,cAAc,EAAE,SAAS,KACrC,EAAE,UAAU,cAAc,EAAE,SAAS,CACzC,CAAC,CACA,KAAK,SAAS,EAAE,GAAG,IAAI,EAAE;CAC9B;CACA,MAAM,WAAW,OAAO,YACtB,OAAO,KAAK,IAAI,YAAY,CAAC,CAAC,CAAC,CAC5B,KAAK,CAAC,CACN,QAAQ,QAAQ,IAAI,WAAW,IAAI,EAAE,MAAM,CAAC,CAC5C,KAAK,QAAQ,CAAC,KAAK,CAAC,GAAI,IAAI,WAAW,QAAQ,CAAC,CAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAChE;CACA,IAAI,OAAO,KAAK,QAAQ,CAAC,CAAC,QACxB,IAAI,WAAW;CAEjB,IAAI,IAAI,QAAQ,IAAI,SAAS,MAAM,IAAI,MAAM;CAC7C,MAAM,QAAQ,aAAa,IAAI,KAAK;CACpC,IAAI,OAAO,IAAI,QAAQ;CACvB,MAAM,YAAY,OAAO,QAAQ,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAChE,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAC3B;CACA,IAAI,UAAU,QACZ,IAAI,YAAY,OAAO,YACrB,UAAU,KAAK,CAAC,IAAI,WAAW,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,CACnD;CAEF,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,GAAG,GAC3C,IAAI,CAAC,MAAM,IAAI,GAAG,GAChB,IAA4C,OAAO,MAAM,KAAK;CAElE,OAAO;AACT;AAIA,IAAM,aAAa,YACjB,IAAI,IAAI,QAAQ,QAAQ,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;;AAG/C,SAAgB,iBACd,KACA,SACU;CACV,MAAM,yBAAS,IAAI,IAAY;CAC/B,MAAM,SAAS,OAAe;EAC5B,MAAM,SAAS,QAAQ,IAAI,EAAE;EAC7B,IAAI,CAAC,UAAU,OAAO,IAAI,EAAE,GAAG;EAC/B,OAAO,IAAI,EAAE;EACb,KAAK,MAAM,YAAY,OAAO,UAAU,MAAM,QAAQ;CACxD;CACA,KAAK,MAAM,MAAM,KAAK,MAAM,EAAE;CAC9B,IAAI,UAAU;CACd,OAAO,SAAS;EACd,UAAU;EACV,KAAK,MAAM,MAAM,CAAC,GAAG,MAAM,GACzB,KAAK,MAAM,gBAAgB,QAAQ,IAAI,EAAE,CAAC,EAAE,eAAe,CAAC,GAAG;GAC7D,IAAI,aAAa,MAAM,QAAQ,OAAO,IAAI,GAAG,CAAC,GAAG;GACjD,MAAM,QAAQ,aAAa,MAAM,QAAQ,QAAQ,IAAI,GAAG,CAAC;GACzD,IAAI,OAAO;IACT,MAAM,KAAK;IACX,UAAU;GACZ;EACF;CAEJ;CACA,OAAO,aAAa,MAAM;AAC5B;;AAGA,SAAgB,cACd,SACA,KACa;CACb,MAAM,OAAO,UAAU,OAAO;CAC9B,uBAAO,IAAI,IAAI,CACb,GAAG,IAAI,QAAQ,SAAS,OAAO,KAAK,IAAI,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,GACzD,GAAG,IAAI,QACT,CAAC;AACH;AAEA,SAAgB,eAAe,SAAwC;CACrE,OAAO,QAAQ,kBAAkB;AACnC;AAEA,SAAS,aAAa,SAAwB,KAAiC;CAC7E,OAAO,OAAO,OAAO,eAAe,OAAO,CAAC,CAAC,CAAC,MAAM,YAClD,QAAQ,MAAM,MAAM,EAAE,UAAU,IAAI,aAAa,EAAE,UAAU,IAAI,SAAS,CAC5E;AACF;;AAGA,SAAgB,MAAM,SAAwB,KAAyB;CACrE,MAAM,UAAU,cAAc,SAAS,GAAG;CAC1C,MAAM,OAAiB;EACrB,GAAG;EACH,UAAU,IAAI,SAAS,QACpB,MAAM,QAAQ,IAAI,EAAE,SAAS,KAAK,aAAa,SAAS,CAAC,CAC5D;CACF;CACA,IAAI,IAAI,UAAU;EAChB,MAAM,WAAW,OAAO,YACtB,OAAO,QAAQ,IAAI,QAAQ,CAAC,CAAC,QAAQ,CAAC,SAAS,QAAQ,IAAI,GAAG,CAAC,CACjE;EACA,IAAI,OAAO,KAAK,QAAQ,CAAC,CAAC,QAAQ,KAAK,WAAW;OAC7C,OAAO,KAAK;CACnB;CACA,OAAO;AACT;AAEA,IAAM,kBAAkB,SAAwB,QAAkB;CAChE,MAAM,OAAO,UAAU,OAAO;CAC9B,OAAO,IAAI,QAAQ,QAAQ,OAAO,KAAK,IAAI,EAAE,CAAC;AAChD;AAEA,IAAM,oBAAoB,SAAwB,QAAkB;CAClE,MAAM,OAAO,UAAU,OAAO;CAC9B,OAAO,IAAI,QAAQ,QAAQ,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;AACjD;AAEA,SAAS,KACP,QACA,OAC0C;CAC1C,MAAM,IAAI,IAAI,IAAI,MAAM;CACxB,MAAM,IAAI,IAAI,IAAI,KAAK;CACvB,OAAO;EACL,OAAO,MAAM,QAAQ,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;EACtC,SAAS,OAAO,QAAQ,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;CAC3C;AACF;AAEA,SAAgB,iBACd,SACA,KACA,KAC2C;CAC3C,MAAM,OAAO,UAAU,OAAO;CAC9B,MAAM,SAAS,eAAe,SAAS,GAAG;CAC1C,MAAM,QAAQ,iBAAiB,CAAC,GAAG,QAAQ,GAAG,GAAG,GAAG,IAAI;CAKxD,OAAO;EAAE,KAAK;GAHZ,GAAG;GACH,SAAS,aAAa,CAAC,GAAG,OAAO,GAAG,iBAAiB,SAAS,GAAG,CAAC,CAAC;EAEvD;EAAM,SAAS;GAAE,GAAG,KAAK,QAAQ,KAAK;GAAG,MAAM,CAAC;EAAE;CAAE;AACpE;AAEA,SAAgB,mBACd,SACA,KACA,KAC2C;CAC3C,MAAM,OAAO,UAAU,OAAO;CAC9B,MAAM,SAAS,eAAe,SAAS,GAAG;CAC1C,MAAM,WAAW,IAAI,IAAI,GAAG;CAC5B,MAAM,QAAQ,iBACZ,OAAO,QAAQ,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,GACvC,IACF;CACA,MAAM,OAAO,MAAM,SAAS;EAC1B,GAAG;EACH,SAAS,aAAa,CAAC,GAAG,OAAO,GAAG,iBAAiB,SAAS,GAAG,CAAC,CAAC;CACrE,CAAC;CACD,MAAM,EAAE,OAAO,YAAY,KAAK,QAAQ,KAAK;CAC7C,OAAO;EACL,KAAK;EACL,SAAS;GACP;GACA;GACA,MAAM,IAAI,QAAQ,OAAO,MAAM,SAAS,EAAE,KAAK,OAAO,SAAS,EAAE,CAAC;EACpE;CACF;AACF;AAEA,SAAgB,oBACd,SACA,KACA,KACA,IAC2C;CAC3C,MAAM,MAAM,IAAI,IAAI,IAAI,QAAQ;CAChC,KAAK,MAAM,MAAM,KACf,IAAI,IAAI,IAAI,IAAI,EAAE;MACb,IAAI,OAAO,EAAE;CAEpB,MAAM,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK;CAC/B,IAAI,OAAiB;EAAE,GAAG;EAAK;CAAS;CACxC,IAAI,CAAC,IAAI,OAAO,MAAM,SAAS,IAAI;CACnC,OAAO;EACL,KAAK;EACL,SAAS;GAAE,GAAG,KAAK,IAAI,UAAU,QAAQ;GAAG,MAAM,CAAC;EAAE;CACvD;AACF;AAEA,IAAa,gBACX,GACA,OACmB;CACnB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,EAAE,KAAK;CAC9B,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,EAAE,OAAO;CACpC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,IAAI;AAC7B;AAWA,IAAa,mBAA0C;CACrD,UAAU;CACV,SAAS;CACT,cAAc;AAChB;AAEA,IAAM,eAAe;CAAC;CAAY;CAAW;AAAc;AAE3D,SAAS,SAAS,KAA6C;CAC7D,IAAI,KAAK,iBAAiB,KAAA,KAAa,IAAI,iBAAiB,MAC1D,OAAO,KAAA;CACT,IAAI;EACF,OAAO,KAAK,MAAM,IAAI,YAAY;CACpC,QAAQ;EACN;CACF;AACF;AAEA,IAAM,WACJ,UACA,OACA,UAEA,SAAS,MACN,MACC,EAAE,cAAc,SAAS,EAAE,cAAc,SAAS,EAAE,cAAc,KACtE;;AAGF,SAAgB,aACd,SACA,KACa;CACb,MAAM,UAAU,eAAe,OAAO;CACtC,MAAM,MAAmB,EAAE,GAAG,iBAAiB;CAC/C,MAAM,SAAS,KAAwB,SAA8B;EACnE,KAAK,MAAM,EAAE,OAAO,WAAW,QAAQ,MAAM;GAC3C,MAAM,QAAQ,SAAS,QAAQ,IAAI,UAAU,OAAO,KAAK,CAAC;GAC1D,IAAI,OAAO,UAAU,MAAM,OAAO;EACpC;CAEF;CACA,MAAM,WAAW,MAAM,YAAY,QAAQ;CAC3C,MAAM,UAAU,MAAM,WAAW,QAAQ;CACzC,MAAM,eAAe,MAAM,gBAAgB,QAAQ;CACnD,IAAI,OAAO,aAAa,UAAU,IAAI,WAAW;CACjD,IAAI,OAAO,YAAY,UAAU,IAAI,UAAU;CAC/C,IAAI,OAAO,iBAAiB,UAAU,IAAI,eAAe;CACzD,OAAO;AACT;AAEA,IAAM,WAAW,MAAe,MAAM,KAAA,KAAa,MAAM,QAAQ,MAAM;AAEvE,SAAS,YACP,SACA,KACA,SACA,OACS;CACT,MAAM,OAAO,UAAU,OAAO;CAC9B,KAAK,MAAM,MAAM,IAAI,SAAS;EAC5B,MAAM,OAAO,KAAK,IAAI,EAAE,CAAC,EAAE,UAAU,QAAQ,EAAE,SAAS;EACxD,IAAI,QAAQ,aAAa,MAAM,OAAO,KAAK;CAC7C;CACA,OAAO,UAAU,SAAS,OAAO,CAAC,EAAE,QAAQ,MAAM,MAAM,EAAE,SAAS,KAAK,CAAC,EACrE;AACN;;;;;;;AAQA,SAAgB,cACd,SACA,KACA,UACU;CACV,MAAM,UAAU,eAAe,OAAO;CACtC,IAAI,WAAW,IAAI,SAAS,KAAK,SAAS,EAAE,GAAG,IAAI,EAAE;CACrD,KAAK,MAAM,OAAO,cAAc;EAC9B,MAAM,MAAM,SAAS;EACrB,MAAM,QACJ,QAAQ,iBACJ,OAAO,GAAG,CAAC,CAAC,KAAK,IACjB,QAAQ,aACN,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,IAC/B;EACR,KAAK,MAAM,EAAE,OAAO,WAAW,QAAQ,MAAM;GAC3C,MAAM,OAAO,YAAY,SAAS,KAAK,OAAO,KAAK;GACnD,MAAM,SACJ,CAAC,QAAQ,KAAK,KACd,EAAE,CAAC,QAAQ,IAAI,KAAK,SAAS,UAC7B,EAAE,QAAQ,IAAI,KAAK,QAAQ,aAAa,UAAU;GACpD,MAAM,WAAW,QAAQ,UAAU,OAAO,KAAK;GAC/C,IAAI,QAAQ;IACV,MAAM,UAAU,KAAK,UAAU,KAAK;IACpC,IAAI,UAAU,SAAS,eAAe;SAEpC,SAAS,KAAK;KACZ,WAAW;KACX,WAAW;KACX,WAAW;KACX,cAAc;IAChB,CAAC;GACL,OAAO,IAAI,UAAU;IACnB,OAAO,SAAS;IAChB,IAAI,OAAO,KAAK,QAAQ,CAAC,CAAC,UAAU,GAClC,WAAW,SAAS,QAAQ,MAAM,MAAM,QAAQ;GAEpD;EACF;CACF;CACA,OAAO;EAAE,GAAG;EAAK;CAAS;AAC5B;AAIA,SAAgB,aACd,OAC2B;CAC3B,IAAI,CAAC,OAAO,OAAO,KAAA;CACnB,MAAM,MAAqB,CAAC;CAC5B,IAAI,MAAM,QAAQ,IAAI,SAAS,MAAM;CACrC,IAAI,MAAM,aAAa,IAAI,cAAc,MAAM;CAC/C,IAAI,MAAM,cAAc,IAAI,eAAe,MAAM;CACjD,IAAI,MAAM,SAAS,IAAI,UAAU,MAAM;CACvC,IAAI,MAAM,UAAU,IAAI,WAAW,MAAM;CACzC,IAAI,MAAM,YAAY,IAAI,aAAa,MAAM;CAC7C,IAAI,MAAM,QAAQ,IAAI,SAAS,EAAE,GAAG,MAAM,OAAO;CACjD,IAAI,MAAM,WAAW,IAAI,YAAY,MAAM;CAC3C,OAAO,OAAO,KAAK,GAAG,CAAC,CAAC,SAAS,MAAM,KAAA;AACzC;AAEA,SAAgB,cAAc,OAA0C;CACtE,MAAM,SAAS,OAAO,eAAA;CACtB,MAAM,OAAO,OAAO,SAChB,gBAAgB,MAAM,OAAO,YAC5B,OAAO,UAAA;CACZ,OAAO,WAAW,WAAW,OAAO,GAAG,KAAK,IAAI;AAClD;;AAGA,SAAgB,eACd,KACA,OASU;CACV,MAAM,OAAsB,EAAE,GAAI,IAAI,SAAS,CAAC,EAAG;CACnD,IAAI,MAAM,QAAQ;EAChB,KAAK,SAAS,MAAM;EACpB,OAAO,KAAK;CACd;CACA,IAAI,MAAM,SACR,KAAK,SAAS;EACZ,SAAS,MAAM,QAAQ,YAAY;EACnC,GAAI,IAAI,OAAO,QAAQ,aACnB,EAAE,YAAY,IAAI,MAAM,OAAO,WAAW,IAC1C,CAAC;CACP;CAEF,IAAI,MAAM,aAAa,KAAK,cAAc,MAAM;CAChD,IAAI,MAAM,cAAc,KAAK,eAAe,MAAM;CAClD,IAAI,MAAM,SAAS,KAAK,UAAU,MAAM;CACxC,IAAI,MAAM,UAAU,KAAK,WAAW,MAAM;CAC1C,IAAI,MAAM,eAAe,MAAM;EAE7B,OAAO,KAAK;EACZ,IAAI,KAAK,QAAQ,YAAY,KAAK,SAAS,EAAE,SAAS,KAAK,OAAO,QAAQ;CAC5E,OAAO,IAAI,MAAM,eAAe,KAAA,GAAW,KAAK,aAAa,MAAM;CACnE,MAAM,QAAQ,aAAa,IAAI;CAC/B,MAAM,MAAM,EAAE,GAAG,IAAI;CACrB,IAAI,OAAO,IAAI,QAAQ;MAClB,OAAO,IAAI;CAChB,OAAO;AACT;;;;;;;;AAWA,SAAgB,SACd,SACA,OACc;CACd,MAAM,MAAoB,CAAC;CAC3B,MAAM,OACJ,UACA,MACA,MACA,YACG,IAAI,KAAK;EAAE;EAAU;EAAM;EAAM;CAAQ,CAAC;CAE/C,MAAM,aAAa,iBAAiB,KAAK;CACzC,IAAI,CAAC,WAAW,IAAI;EAClB,KAAK,MAAM,SAAS,WAAW,YAAY,QACxC,eAAe,WAAW,aAAa,OAC1C,GACE,IAAI,SAAS,oBAAoB,MAAM,MAAM,MAAM,OAAO;EAE5D,OAAO;CACT;CACA,KAAK,MAAM,SAAS,WAAW,aAC7B,IACE,MAAM,UACN,MAAM,SAAS,oBAAoB,aAAa,MAAM,MACtD,MAAM,MACN,MAAM,OACR;CAEF,MAAM,MAAM,WAAW;CACvB,MAAM,OAAO,UAAU,OAAO;CAE9B,MAAM,MAAM,SAAS,SAAS;EAAE,GAAG;EAAK,QAAQ,KAAA;CAAU,CAAC;CAC3D,MAAM,UAAU,iBAAiB,KAAK;EACpC,cAAc,QAAQ,gBAAgB;EACtC,QAAQ;GACN,UAAU,IAAI,KAAK,YAAY,QAAQ,EAAE;GACzC,OAAO,IAAI,SAAS,YAAY,QAAQ,MAAM,KAAK,SAAS,KAAK,EAAE,CAAC;GACpE,GAAI,QAAQ,iBACR,EAAE,gBAAgB,QAAQ,eAAe,IACzC,CAAC;EACP;EACA,aAAa,CACX,GAAG,IAAI,KAAK,YAAY,QAAQ,EAAE,GAClC,IAAI,IAAI,QAAQ,kBAAkB,CAAC,EAAA,CAAG,KAAK,YAAY,QAAQ,EAAE,CACnE;CACF,CAAC;CACD,KAAK,MAAM,SAAS,QAAQ,aAC1B,IACE,MAAM,SAAS,0BACf,MAAM,SAAS,uBACf,MAAM,SAAS,oBAEf,IACE,MAAM,SAAS,uBACb,CAAC,MAAM,KAAK,WAAW,oBAAoB,IACzC,YACA,MAAM,UACV,MAAM,SAAS,yBAAyB,mBAAmB,MAAM,MACjE,MAAM,MACN,MAAM,OACR;CAIJ,KAAK,MAAM,CAAC,GAAG,OAAO,IAAI,QAAQ,QAAQ,GACxC,IAAI,CAAC,KAAK,IAAI,EAAE,GACd,IACE,SACA,kBACA,WAAW,EAAE,IACb,mBAAmB,GAAG,GACxB;CAEJ,MAAM,UAAU,IAAI,IAAI,iBAAiB,IAAI,SAAS,IAAI,CAAC;CAC3D,KAAK,MAAM,MAAM,SACf,IAAI,CAAC,IAAI,QAAQ,SAAS,EAAE,GAC1B,IACE,SACA,uBACA,WACA,mBAAmB,GAAG,wBACxB;CAGJ,KAAK,MAAM,CAAC,GAAG,OAAO,IAAI,SAAS,QAAQ,GAAG;EAC5C,MAAM,QAAQ,UAAU,SAAS,EAAE;EACnC,IAAI,CAAC,OACH,IAAI,SAAS,iBAAiB,YAAY,EAAE,IAAI,kBAAkB,GAAG,GAAG;OACrE,IAAI,MAAM,YAAY,OACzB,IACE,SACA,qBACA,YAAY,EAAE,IACd,GAAG,GAAG,+BACR;CAEJ;CACA,MAAM,UAAU,cAAc,SAAS,GAAG;CAC1C,KAAK,MAAM,CAAC,GAAG,QAAQ,IAAI,SAAS,QAAQ,GAAG;EAC7C,MAAM,KAAK,YAAY,EAAE;EACzB,MAAM,QAAQ,UAAU,SAAS,IAAI,SAAS;EAC9C,IAAI,CAAC,OAAO;GACV,IACE,SACA,iBACA,GAAG,GAAG,aACN,kBAAkB,IAAI,UAAU,GAClC;GACA;EACF;EACA,IACE,MAAM,UACN,CAAC,MAAM,OAAO,MAAM,MAAM,EAAE,SAAS,IAAI,aAAa,CAAC,EAAE,MAAM,GAE/D,IACE,SACA,iBACA,GAAG,GAAG,aACN,GAAG,MAAM,KAAK,iBAAiB,IAAI,UAAU,GAC/C;EAEF,IAAI,CAAC,QAAQ,IAAI,IAAI,SAAS,KAAK,CAAC,aAAa,SAAS,GAAG,GAC3D,IACE,WACA,sBACA,IACA,GAAG,MAAM,KAAK,+CAChB;CAEJ;CACA,KAAK,MAAM,OAAO,OAAO,KAAK,IAAI,YAAY,CAAC,CAAC,GAC9C,IAAI,CAAC,UAAU,SAAS,GAAG,GACzB,IACE,SACA,iBACA,YAAY,OACZ,kBAAkB,IAAI,GACxB;CAGJ,OAAO;AACT"}

package/dist/cookbook/engine/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/cookbook/engine/engine.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,KAAK,EAKN,MAAM,eAAe,CAAC;AASvB,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,YAAY,EAGjB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,EAEhB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,aAAa,CAAC;IACvB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC;IAC3D;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,GAAG,WAAW,CAAC;IAClD,+DAA+D;IAC/D,QAAQ,IAAI,YAAY,CAAC;IACzB,6BAA6B;IAC7B,QAAQ,IAAI,UAAU,CAAC,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvD,uEAAuE;IACvE,KAAK,IAAI,WAAW,CAAC;IACrB,oEAAoE;IACpE,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAClE,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE;QAClB,IAAI,EAAE,WAAW,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,UAAU,CAAC;KACzB,CAAC;CACH;AAsGD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CA8fhB"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/cookbook/engine/engine.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,KAAK,EAKN,MAAM,eAAe,CAAC;AASvB,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,YAAY,EAGjB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,EAEhB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,aAAa,CAAC;IACvB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC;IAC3D;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,GAAG,WAAW,CAAC;IAClD,+DAA+D;IAC/D,QAAQ,IAAI,YAAY,CAAC;IACzB,6BAA6B;IAC7B,QAAQ,IAAI,UAAU,CAAC,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvD,uEAAuE;IACvE,KAAK,IAAI,WAAW,CAAC;IACrB,oEAAoE;IACpE,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAClE,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE;QAClB,IAAI,EAAE,WAAW,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,UAAU,CAAC;KACzB,CAAC;CACH;AAsGD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CAigBhB"}

package/dist/cookbook/engine/engine.js

@@ -119,7 +119,10 @@ function createCookbookEngine(options) {
 				text: describeTheme(doc.theme),
 				preset: doc.theme?.preset ?? null,
 				primary: doc.theme?.custom?.primary ?? null,
-				colorScheme: doc.theme?.colorScheme ?? "system"
+				colorScheme: doc.theme?.colorScheme ?? "system",
+				borderRadius: doc.theme?.borderRadius ?? null,
+				density: doc.theme?.density ?? null,
+				contrast: doc.theme?.contrast ?? null
 			},
 			sections: buildNav(catalog, doc).map((s) => ({
 				id: s.id,

package/dist/cookbook/engine/engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine.js","names":[],"sources":["../../../src/cookbook/engine/engine.ts"],"sourcesContent":["import { validateCookbook } from '../validate.js';\nimport {\n  adopt,\n  execute,\n  libraryName,\n  type Outcome,\n  type PlanState,\n} from './commands.js';\nimport { DEFAULT_APP_NAME, DEFAULT_COLOR_SCHEME } from './defaults.js';\nimport {\n  clone,\n  describeTheme,\n  emptyCookbook,\n  readSettings,\n  same,\n} from './document.js';\nimport { buildNav } from './nav.js';\nimport {\n  buildBatchTool,\n  buildCommandTools,\n  type CommandSchemas,\n  checkSchema,\n  commandSchemas,\n} from './schemas.js';\nimport {\n  type BatchResult,\n  COOKBOOK_COMMANDS_VERSION,\n  type CommandBatch,\n  type CommandError,\n  type CommandName,\n  type CommandResult,\n  type CommandTool,\n  type EngineCatalog,\n  type EngineState,\n  type JournalEntry,\n  type JsonSchema,\n  type PlanSnapshot,\n  type RunOptions,\n} from './types.js';\n\nexport interface CookbookEngineOptions {\n  catalog: EngineCatalog;\n  /** Start from this document (strictly checked; the call throws if invalid). */\n  cookbook?: unknown;\n  /** Resume from a saved {@link EngineState} (wins over `cookbook`). */\n  state?: EngineState;\n  /** How many command ids are remembered for retries; default 500. */\n  maxJournal?: number;\n  /** How many undo entries are kept; default 20. */\n  maxUndo?: number;\n  /** Optional namespace for process-local undo handles; default `undo`. */\n  undoPrefix?: string;\n}\n\n/**\n * The cookbook command engine: typed, versioned commands over one cookbook\n * document, held in plain objects. Never throws from `run`/`batch`; every\n * refusal is a typed error and leaves the document untouched.\n */\nexport interface CookbookEngine {\n  /**\n   * Run one command (`{ name, input, id?, expectedRevision? }`). A repeated\n   * `id` returns the first result with `replayed: true` and applies nothing.\n   */\n  run(command: unknown, options?: RunOptions): CommandResult;\n  /**\n   * Run several commands all-or-nothing. On any failure the state is exactly\n   * as before and the error names the failing command.\n   */\n  batch(batch: CommandBatch | unknown): BatchResult;\n  /** The compact plan state, cheap enough for a model prompt. */\n  snapshot(): PlanSnapshot;\n  /** The document (a copy). */\n  cookbook(): ReturnType<typeof clone<PlanState['doc']>>;\n  /** Serializable state to persist and resume from, retries included. */\n  state(): EngineState;\n  /** Call `listener` with the snapshot now and after every change. */\n  subscribe(listener: (snapshot: PlanSnapshot) => void): () => void;\n  /** Command tool definitions (JSON Schema inputs), enums narrowed to the catalog. */\n  readonly tools: readonly CommandTool[];\n  /** The atomic-batch tool definition. */\n  readonly batchTool: {\n    name: 'run_batch';\n    description: string;\n    inputSchema: JsonSchema;\n  };\n}\n\ninterface UndoEntry {\n  before: PlanState;\n  /** What the change left; undo is a conflict while the plan differs from it. */\n  after: PlanState;\n}\n\nconst err = (\n  code: CommandError['code'],\n  message: string,\n  extra: Pick<CommandError, 'path' | 'details'> = {},\n): CommandError => ({ code, message, ...extra });\n\n/** Key order never changes a payload's identity: `{a, b}` and `{b, a}` match. */\nconst canonical = (value: unknown): unknown => {\n  if (Array.isArray(value)) return value.map(canonical);\n  if (value && typeof value === 'object') {\n    return Object.fromEntries(\n      Object.keys(value)\n        .sort()\n        .map((key) => [\n          key,\n          canonical((value as Record<string, unknown>)[key]),\n        ]),\n    );\n  }\n  return value;\n};\n\nconst fingerprint = (value: unknown): string => {\n  try {\n    return JSON.stringify(canonical(value)) ?? 'undefined';\n  } catch {\n    return 'unserializable';\n  }\n};\n\ntype Parsed =\n  | { ok: true; name: CommandName; input: Record<string, unknown> }\n  | { ok: false; error: CommandError };\n\nfunction readCommand(\n  value: unknown,\n  schemas: CommandSchemas,\n  extraKeys: readonly string[],\n): Parsed {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return {\n      ok: false,\n      error: err('unknown_command', 'A command is an object: { name, input }.'),\n    };\n  }\n  const record = value as Record<string, unknown>;\n  const { name, input = {} } = record;\n  if (typeof name !== 'string' || !Object.hasOwn(schemas, name)) {\n    return {\n      ok: false,\n      error: err('unknown_command', `Unknown command ${JSON.stringify(name)}.`),\n    };\n  }\n  for (const key of Object.keys(record)) {\n    if (key !== 'name' && key !== 'input' && !extraKeys.includes(key)) {\n      return {\n        ok: false,\n        error: err('invalid_input', `${key} is not part of a command.`, {\n          path: key,\n        }),\n      };\n    }\n  }\n  const problem = checkSchema(schemas[name as CommandName], input);\n  if (problem) {\n    return {\n      ok: false,\n      error: err('invalid_input', problem.message, { path: problem.path }),\n    };\n  }\n  return {\n    ok: true,\n    name: name as CommandName,\n    input: input as Record<string, unknown>,\n  };\n}\n\nconst checkId = (id: unknown): CommandError | null =>\n  id === undefined ||\n  (typeof id === 'string' && id.length > 0 && id.length <= 200)\n    ? null\n    : err(\n        'invalid_input',\n        'id must be a non-empty string of at most 200 characters.',\n        { path: 'id' },\n      );\n\nconst checkRevision = (value: unknown): CommandError | null =>\n  value === undefined || (Number.isInteger(value) && (value as number) >= 0)\n    ? null\n    : err('invalid_input', 'expectedRevision must be a whole number.', {\n        path: 'expectedRevision',\n      });\n\nexport function createCookbookEngine(\n  options: CookbookEngineOptions,\n): CookbookEngine {\n  const { catalog } = options;\n  const schemas = commandSchemas(catalog);\n  const tools = buildCommandTools(catalog);\n  const batchTool = buildBatchTool(catalog);\n  const maxJournal = options.maxJournal ?? 500;\n  const maxUndo = options.maxUndo ?? 20;\n\n  let current: PlanState;\n  let revision = 0;\n  const journal = new Map<string, JournalEntry>();\n\n  if (options.state) {\n    const saved = options.state;\n    const checked = validateCookbook(saved.cookbook);\n    if (!checked.ok)\n      throw new Error(`Invalid saved cookbook: ${checked.errors.join('; ')}`);\n    if (!Number.isInteger(saved.revision) || saved.revision < 0) {\n      throw new Error('Invalid saved revision.');\n    }\n    current = {\n      doc: adopt(catalog, checked.cookbook),\n      applied: saved.applied ?? null,\n    };\n    revision = saved.revision;\n    for (const entry of saved.journal ?? [])\n      journal.set(entry.id, clone(entry));\n  } else if (options.cookbook !== undefined) {\n    const checked = validateCookbook(options.cookbook);\n    if (!checked.ok)\n      throw new Error(`Invalid cookbook: ${checked.errors.join('; ')}`);\n    current = { doc: adopt(catalog, checked.cookbook), applied: null };\n  } else {\n    current = { doc: adopt(catalog, emptyCookbook()), applied: null };\n  }\n\n  const undos = new Map<string, UndoEntry>();\n  let undoIds: string[] = [];\n  let undoCounter = 0;\n  const listeners = new Map<(s: PlanSnapshot) => void, number>();\n\n  function snapshotOf(state: PlanState, rev: number): PlanSnapshot {\n    const { doc } = state;\n    const byId = new Map(catalog.recipes.map((r) => [r.id, r]));\n    const settings = readSettings(catalog, doc);\n    const exposed = new Set(\n      catalog.models.filter((m) => m.exposed !== false).map((m) => m.id),\n    );\n    return {\n      version: COOKBOOK_COMMANDS_VERSION,\n      revision: rev,\n      app: {\n        name:\n          doc.name ?? libraryName(catalog, state.applied) ?? DEFAULT_APP_NAME,\n        description: doc.description ?? null,\n        cookbook: state.applied,\n      },\n      recipes: doc.recipes.flatMap((id) => {\n        const recipe = byId.get(id);\n        return recipe ? [{ id, label: recipe.label }] : [];\n      }),\n      features: doc.features.filter((id) => exposed.has(id)),\n      unavailable: [\n        ...doc.recipes.filter((id) => !byId.has(id)),\n        ...doc.features.filter((id) => !exposed.has(id)),\n      ],\n      settings: {\n        currency: settings.currency,\n        taxRate: Number((settings.taxRate * 100).toFixed(4)),\n        paymentTerms: settings.paymentTerms,\n      },\n      theme: {\n        text: describeTheme(doc.theme),\n        preset: doc.theme?.preset ?? null,\n        primary: doc.theme?.custom?.primary ?? null,\n        colorScheme: doc.theme?.colorScheme ?? DEFAULT_COLOR_SCHEME,\n      },\n      sections: buildNav(catalog, doc).map((s) => ({\n        id: s.id,\n        label: s.label,\n        hidden: s.hidden,\n        items: s.items.map((i) => ({\n          id: i.id,\n          label: i.label,\n          hidden: i.hidden,\n        })),\n      })),\n      policies: doc.policies.length,\n      undo: [...undoIds],\n    };\n  }\n\n  const snapshot = () => snapshotOf(current, revision);\n\n  function notify(): void {\n    for (const [listener, last] of listeners) {\n      if (last === revision) continue;\n      listeners.set(listener, revision);\n      listener(snapshot());\n    }\n  }\n\n  function remember(\n    id: string | undefined,\n    print: string,\n    result: CommandResult | BatchResult,\n  ) {\n    if (id === undefined) return;\n    journal.set(id, { id, fingerprint: print, result: clone(result) });\n    while (journal.size > maxJournal) {\n      const oldest = journal.keys().next().value;\n      if (oldest === undefined) break;\n      journal.delete(oldest);\n    }\n  }\n\n  function replay<R extends CommandResult | BatchResult>(\n    id: string | undefined,\n    print: string,\n  ): R | CommandResult | null {\n    if (id === undefined) return null;\n    const hit = journal.get(id);\n    if (!hit) return null;\n    if (hit.fingerprint !== print) {\n      return {\n        ok: false,\n        id,\n        error: err(\n          'id_reuse',\n          `The id \"${id}\" was already used for a different command.`,\n          {\n            path: 'id',\n          },\n        ),\n      };\n    }\n    return { ...(clone(hit.result) as R), replayed: true };\n  }\n\n  function recordUndo(before: PlanState, after: PlanState): string {\n    const undoId = `${options.undoPrefix ?? 'undo'}-${++undoCounter}`;\n    undos.set(undoId, { before: clone(before), after: clone(after) });\n    undoIds = [...undoIds, undoId].slice(-maxUndo);\n    for (const key of [...undos.keys()])\n      if (!undoIds.includes(key)) undos.delete(key);\n    return undoId;\n  }\n\n  const changedBetween = (a: PlanState, b: PlanState) =>\n    a.applied !== b.applied || !same(a.doc, b.doc);\n\n  function toSuccess(\n    id: string | undefined,\n    name: CommandName,\n    outcome: Extract<Outcome, { ok: true }>,\n    revisionBefore: number,\n    revisionAfter: number,\n    snap: PlanSnapshot,\n    undoId?: string,\n  ): Extract<CommandResult, { ok: true }> {\n    return {\n      ok: true,\n      ...(id !== undefined ? { id } : {}),\n      snapshot: snap,\n      receipt: {\n        name,\n        ...(id !== undefined ? { id } : {}),\n        summary: revisionAfter !== revisionBefore ? outcome.summary : '',\n        changed: revisionAfter !== revisionBefore,\n        revisionBefore,\n        revisionAfter,\n        ...(undoId ? { undoId } : {}),\n        ...(outcome.changes ? { changes: outcome.changes } : {}),\n        ...(outcome.warnings ? { warnings: outcome.warnings } : {}),\n      },\n      ...(outcome.data !== undefined ? { data: outcome.data } : {}),\n    };\n  }\n\n  function runUndo(\n    id: string | undefined,\n    input: { undoId: string; force?: boolean },\n  ): CommandResult {\n    const entry = undos.get(input.undoId);\n    if (!entry) {\n      return {\n        ok: false,\n        ...(id !== undefined ? { id } : {}),\n        error: err('not_found', `Nothing to undo for \"${input.undoId}\".`, {\n          path: 'input.undoId',\n        }),\n      };\n    }\n    if (!input.force && changedBetween(current, entry.after)) {\n      return {\n        ok: false,\n        ...(id !== undefined ? { id } : {}),\n        error: err(\n          'conflict',\n          'The plan changed since; send force: true to undo anyway.',\n          {\n            details: { currentRevision: revision },\n          },\n        ),\n      };\n    }\n    const before = revision;\n    const restored = clone(entry.before);\n    const changed = changedBetween(current, restored);\n    current = restored;\n    if (changed) revision += 1;\n    undos.delete(input.undoId);\n    undoIds = undoIds.filter((u) => u !== input.undoId);\n    const result = toSuccess(\n      id,\n      'undo',\n      { ok: true, state: current, summary: 'Undone.' },\n      before,\n      revision,\n      snapshot(),\n    );\n    notify();\n    return result;\n  }\n\n  function run(command: unknown, runOptions: RunOptions = {}): CommandResult {\n    try {\n      const raw =\n        command && typeof command === 'object' && !Array.isArray(command)\n          ? (command as Record<string, unknown>)\n          : undefined;\n      const id = raw?.id as string | undefined;\n      const idProblem = checkId(id);\n      if (idProblem) return { ok: false, error: idProblem };\n      const expected = (raw?.expectedRevision ?? runOptions.expectedRevision) as\n        | number\n        | undefined;\n      const revProblem = checkRevision(expected);\n      if (revProblem)\n        return {\n          ok: false,\n          ...(id !== undefined ? { id } : {}),\n          error: revProblem,\n        };\n\n      const print = fingerprint({\n        name: raw?.name,\n        input: raw?.input ?? {},\n        expectedRevision: expected,\n      });\n      const replayed = replay<CommandResult>(id, print);\n      if (replayed) return replayed as CommandResult;\n\n      const finish = (result: CommandResult) => {\n        remember(id, print, result);\n        return result;\n      };\n      const withId = (error: CommandError): CommandResult => ({\n        ok: false,\n        ...(id !== undefined ? { id } : {}),\n        error,\n      });\n\n      const parsed = readCommand(command, schemas, ['id', 'expectedRevision']);\n      if (!parsed.ok) return finish(withId(parsed.error));\n      if (expected !== undefined && expected !== revision) {\n        return finish(\n          withId(\n            err(\n              'conflict',\n              `The plan is at revision ${revision}, not ${expected}. Read the snapshot and try again.`,\n              {\n                details: {\n                  expectedRevision: expected,\n                  currentRevision: revision,\n                },\n              },\n            ),\n          ),\n        );\n      }\n      if (parsed.name === 'undo') {\n        return finish(\n          runUndo(id, parsed.input as { undoId: string; force?: boolean }),\n        );\n      }\n      const before = current;\n      const outcome = execute(\n        catalog,\n        before,\n        parsed.name,\n        parsed.input as never,\n      );\n      if (!outcome.ok) return finish(withId(outcome.error));\n      const revisionBefore = revision;\n      const changed = changedBetween(before, outcome.state);\n      let undoId: string | undefined;\n      if (changed) {\n        current = outcome.state;\n        revision += 1;\n        undoId = recordUndo(before, outcome.state);\n      }\n      const result = finish(\n        toSuccess(\n          id,\n          parsed.name,\n          outcome,\n          revisionBefore,\n          revision,\n          snapshot(),\n          undoId,\n        ),\n      );\n      notify();\n      return result;\n    } catch (cause) {\n      return {\n        ok: false,\n        error: err(\n          'failed',\n          cause instanceof Error ? cause.message : String(cause),\n        ),\n      };\n    }\n  }\n\n  function batch(input: CommandBatch | unknown): BatchResult {\n    const unchanged = (error: CommandError, id?: string): BatchResult => ({\n      ok: false,\n      ...(id !== undefined ? { id } : {}),\n      error,\n      snapshot: snapshot(),\n    });\n    try {\n      if (!input || typeof input !== 'object' || Array.isArray(input)) {\n        return unchanged(\n          err('invalid_input', 'A batch is an object: { commands }.'),\n        );\n      }\n      const raw = input as Record<string, unknown>;\n      const id = raw.id as string | undefined;\n      const idProblem = checkId(id);\n      if (idProblem) return unchanged(idProblem);\n      const revProblem = checkRevision(raw.expectedRevision);\n      if (revProblem) return unchanged(revProblem, id);\n      const print = fingerprint({\n        commands: raw.commands,\n        expectedRevision: raw.expectedRevision,\n      });\n      const replayed = replay<BatchResult>(id, print);\n      if (replayed) {\n        return 'results' in replayed || 'snapshot' in replayed\n          ? (replayed as BatchResult)\n          : unchanged(\n              (replayed as Extract<CommandResult, { ok: false }>).error,\n              id,\n            );\n      }\n      const finish = (result: BatchResult) => {\n        remember(id, print, result);\n        return result;\n      };\n\n      const commands = raw.commands;\n      if (\n        !Array.isArray(commands) ||\n        commands.length === 0 ||\n        commands.length > 50\n      ) {\n        return finish(\n          unchanged(\n            err(\n              'invalid_input',\n              'commands must be a list of 1 to 50 commands.',\n              { path: 'commands' },\n            ),\n            id,\n          ),\n        );\n      }\n      const expected = raw.expectedRevision as number | undefined;\n      if (expected !== undefined && expected !== revision) {\n        return finish(\n          unchanged(\n            err(\n              'conflict',\n              `The plan is at revision ${revision}, not ${expected}. Read the snapshot and try again.`,\n              {\n                details: {\n                  expectedRevision: expected,\n                  currentRevision: revision,\n                },\n              },\n            ),\n            id,\n          ),\n        );\n      }\n\n      const failAt = (index: number, name: unknown, cause: CommandError) =>\n        finish(\n          unchanged(\n            err(\n              'batch_failed',\n              `Command ${index + 1} (${String(name)}) failed: ${cause.message}`,\n              {\n                path: `commands[${index}]`,\n                details: { index, cause },\n              },\n            ),\n            id,\n          ),\n        );\n\n      // Everything runs on a working copy; the live state is replaced once, at the end.\n      const base = current;\n      const baseRevision = revision;\n      let working = base;\n      let rev = baseRevision;\n      const results: Extract<CommandResult, { ok: true }>[] = [];\n      for (const [index, command] of commands.entries()) {\n        const parsed = readCommand(command, schemas, []);\n        if (!parsed.ok)\n          return failAt(\n            index,\n            (command as { name?: unknown })?.name,\n            parsed.error,\n          );\n        if (parsed.name === 'undo') {\n          return failAt(\n            index,\n            'undo',\n            err('invalid_input', 'undo cannot run inside a batch.'),\n          );\n        }\n        const outcome = execute(\n          catalog,\n          working,\n          parsed.name,\n          parsed.input as never,\n        );\n        if (!outcome.ok) return failAt(index, parsed.name, outcome.error);\n        const before = rev;\n        if (changedBetween(working, outcome.state)) rev += 1;\n        working = outcome.state;\n        results.push(\n          toSuccess(\n            undefined,\n            parsed.name,\n            outcome,\n            before,\n            rev,\n            snapshotOf(working, rev),\n          ),\n        );\n      }\n      const changed = rev !== baseRevision;\n      let undoId: string | undefined;\n      if (changed) {\n        current = working;\n        revision = rev;\n        undoId = recordUndo(base, working);\n        // The batch's one undo restores the state before all of it.\n        for (const r of results) if (r.receipt.changed) delete r.receipt.undoId;\n      }\n      const result = finish({\n        ok: true,\n        ...(id !== undefined ? { id } : {}),\n        snapshot: snapshot(),\n        receipt: {\n          ...(id !== undefined ? { id } : {}),\n          count: results.length,\n          changed,\n          revisionBefore: baseRevision,\n          revisionAfter: rev,\n          ...(undoId ? { undoId } : {}),\n        },\n        results,\n      });\n      notify();\n      return result;\n    } catch (cause) {\n      return unchanged(\n        err('failed', cause instanceof Error ? cause.message : String(cause)),\n      );\n    }\n  }\n\n  return {\n    run: run as CookbookEngine['run'],\n    batch,\n    snapshot,\n    cookbook: () => clone(current.doc),\n    state: () => ({\n      version: COOKBOOK_COMMANDS_VERSION,\n      revision,\n      applied: current.applied,\n      cookbook: clone(current.doc),\n      journal: [...journal.values()].map((entry) => clone(entry)),\n    }),\n    subscribe(listener) {\n      listeners.set(listener, revision);\n      listener(snapshot());\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    tools,\n    batchTool,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"engine.js","names":[],"sources":["../../../src/cookbook/engine/engine.ts"],"sourcesContent":["import { validateCookbook } from '../validate.js';\nimport {\n  adopt,\n  execute,\n  libraryName,\n  type Outcome,\n  type PlanState,\n} from './commands.js';\nimport { DEFAULT_APP_NAME, DEFAULT_COLOR_SCHEME } from './defaults.js';\nimport {\n  clone,\n  describeTheme,\n  emptyCookbook,\n  readSettings,\n  same,\n} from './document.js';\nimport { buildNav } from './nav.js';\nimport {\n  buildBatchTool,\n  buildCommandTools,\n  type CommandSchemas,\n  checkSchema,\n  commandSchemas,\n} from './schemas.js';\nimport {\n  type BatchResult,\n  COOKBOOK_COMMANDS_VERSION,\n  type CommandBatch,\n  type CommandError,\n  type CommandName,\n  type CommandResult,\n  type CommandTool,\n  type EngineCatalog,\n  type EngineState,\n  type JournalEntry,\n  type JsonSchema,\n  type PlanSnapshot,\n  type RunOptions,\n} from './types.js';\n\nexport interface CookbookEngineOptions {\n  catalog: EngineCatalog;\n  /** Start from this document (strictly checked; the call throws if invalid). */\n  cookbook?: unknown;\n  /** Resume from a saved {@link EngineState} (wins over `cookbook`). */\n  state?: EngineState;\n  /** How many command ids are remembered for retries; default 500. */\n  maxJournal?: number;\n  /** How many undo entries are kept; default 20. */\n  maxUndo?: number;\n  /** Optional namespace for process-local undo handles; default `undo`. */\n  undoPrefix?: string;\n}\n\n/**\n * The cookbook command engine: typed, versioned commands over one cookbook\n * document, held in plain objects. Never throws from `run`/`batch`; every\n * refusal is a typed error and leaves the document untouched.\n */\nexport interface CookbookEngine {\n  /**\n   * Run one command (`{ name, input, id?, expectedRevision? }`). A repeated\n   * `id` returns the first result with `replayed: true` and applies nothing.\n   */\n  run(command: unknown, options?: RunOptions): CommandResult;\n  /**\n   * Run several commands all-or-nothing. On any failure the state is exactly\n   * as before and the error names the failing command.\n   */\n  batch(batch: CommandBatch | unknown): BatchResult;\n  /** The compact plan state, cheap enough for a model prompt. */\n  snapshot(): PlanSnapshot;\n  /** The document (a copy). */\n  cookbook(): ReturnType<typeof clone<PlanState['doc']>>;\n  /** Serializable state to persist and resume from, retries included. */\n  state(): EngineState;\n  /** Call `listener` with the snapshot now and after every change. */\n  subscribe(listener: (snapshot: PlanSnapshot) => void): () => void;\n  /** Command tool definitions (JSON Schema inputs), enums narrowed to the catalog. */\n  readonly tools: readonly CommandTool[];\n  /** The atomic-batch tool definition. */\n  readonly batchTool: {\n    name: 'run_batch';\n    description: string;\n    inputSchema: JsonSchema;\n  };\n}\n\ninterface UndoEntry {\n  before: PlanState;\n  /** What the change left; undo is a conflict while the plan differs from it. */\n  after: PlanState;\n}\n\nconst err = (\n  code: CommandError['code'],\n  message: string,\n  extra: Pick<CommandError, 'path' | 'details'> = {},\n): CommandError => ({ code, message, ...extra });\n\n/** Key order never changes a payload's identity: `{a, b}` and `{b, a}` match. */\nconst canonical = (value: unknown): unknown => {\n  if (Array.isArray(value)) return value.map(canonical);\n  if (value && typeof value === 'object') {\n    return Object.fromEntries(\n      Object.keys(value)\n        .sort()\n        .map((key) => [\n          key,\n          canonical((value as Record<string, unknown>)[key]),\n        ]),\n    );\n  }\n  return value;\n};\n\nconst fingerprint = (value: unknown): string => {\n  try {\n    return JSON.stringify(canonical(value)) ?? 'undefined';\n  } catch {\n    return 'unserializable';\n  }\n};\n\ntype Parsed =\n  | { ok: true; name: CommandName; input: Record<string, unknown> }\n  | { ok: false; error: CommandError };\n\nfunction readCommand(\n  value: unknown,\n  schemas: CommandSchemas,\n  extraKeys: readonly string[],\n): Parsed {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return {\n      ok: false,\n      error: err('unknown_command', 'A command is an object: { name, input }.'),\n    };\n  }\n  const record = value as Record<string, unknown>;\n  const { name, input = {} } = record;\n  if (typeof name !== 'string' || !Object.hasOwn(schemas, name)) {\n    return {\n      ok: false,\n      error: err('unknown_command', `Unknown command ${JSON.stringify(name)}.`),\n    };\n  }\n  for (const key of Object.keys(record)) {\n    if (key !== 'name' && key !== 'input' && !extraKeys.includes(key)) {\n      return {\n        ok: false,\n        error: err('invalid_input', `${key} is not part of a command.`, {\n          path: key,\n        }),\n      };\n    }\n  }\n  const problem = checkSchema(schemas[name as CommandName], input);\n  if (problem) {\n    return {\n      ok: false,\n      error: err('invalid_input', problem.message, { path: problem.path }),\n    };\n  }\n  return {\n    ok: true,\n    name: name as CommandName,\n    input: input as Record<string, unknown>,\n  };\n}\n\nconst checkId = (id: unknown): CommandError | null =>\n  id === undefined ||\n  (typeof id === 'string' && id.length > 0 && id.length <= 200)\n    ? null\n    : err(\n        'invalid_input',\n        'id must be a non-empty string of at most 200 characters.',\n        { path: 'id' },\n      );\n\nconst checkRevision = (value: unknown): CommandError | null =>\n  value === undefined || (Number.isInteger(value) && (value as number) >= 0)\n    ? null\n    : err('invalid_input', 'expectedRevision must be a whole number.', {\n        path: 'expectedRevision',\n      });\n\nexport function createCookbookEngine(\n  options: CookbookEngineOptions,\n): CookbookEngine {\n  const { catalog } = options;\n  const schemas = commandSchemas(catalog);\n  const tools = buildCommandTools(catalog);\n  const batchTool = buildBatchTool(catalog);\n  const maxJournal = options.maxJournal ?? 500;\n  const maxUndo = options.maxUndo ?? 20;\n\n  let current: PlanState;\n  let revision = 0;\n  const journal = new Map<string, JournalEntry>();\n\n  if (options.state) {\n    const saved = options.state;\n    const checked = validateCookbook(saved.cookbook);\n    if (!checked.ok)\n      throw new Error(`Invalid saved cookbook: ${checked.errors.join('; ')}`);\n    if (!Number.isInteger(saved.revision) || saved.revision < 0) {\n      throw new Error('Invalid saved revision.');\n    }\n    current = {\n      doc: adopt(catalog, checked.cookbook),\n      applied: saved.applied ?? null,\n    };\n    revision = saved.revision;\n    for (const entry of saved.journal ?? [])\n      journal.set(entry.id, clone(entry));\n  } else if (options.cookbook !== undefined) {\n    const checked = validateCookbook(options.cookbook);\n    if (!checked.ok)\n      throw new Error(`Invalid cookbook: ${checked.errors.join('; ')}`);\n    current = { doc: adopt(catalog, checked.cookbook), applied: null };\n  } else {\n    current = { doc: adopt(catalog, emptyCookbook()), applied: null };\n  }\n\n  const undos = new Map<string, UndoEntry>();\n  let undoIds: string[] = [];\n  let undoCounter = 0;\n  const listeners = new Map<(s: PlanSnapshot) => void, number>();\n\n  function snapshotOf(state: PlanState, rev: number): PlanSnapshot {\n    const { doc } = state;\n    const byId = new Map(catalog.recipes.map((r) => [r.id, r]));\n    const settings = readSettings(catalog, doc);\n    const exposed = new Set(\n      catalog.models.filter((m) => m.exposed !== false).map((m) => m.id),\n    );\n    return {\n      version: COOKBOOK_COMMANDS_VERSION,\n      revision: rev,\n      app: {\n        name:\n          doc.name ?? libraryName(catalog, state.applied) ?? DEFAULT_APP_NAME,\n        description: doc.description ?? null,\n        cookbook: state.applied,\n      },\n      recipes: doc.recipes.flatMap((id) => {\n        const recipe = byId.get(id);\n        return recipe ? [{ id, label: recipe.label }] : [];\n      }),\n      features: doc.features.filter((id) => exposed.has(id)),\n      unavailable: [\n        ...doc.recipes.filter((id) => !byId.has(id)),\n        ...doc.features.filter((id) => !exposed.has(id)),\n      ],\n      settings: {\n        currency: settings.currency,\n        taxRate: Number((settings.taxRate * 100).toFixed(4)),\n        paymentTerms: settings.paymentTerms,\n      },\n      theme: {\n        text: describeTheme(doc.theme),\n        preset: doc.theme?.preset ?? null,\n        primary: doc.theme?.custom?.primary ?? null,\n        colorScheme: doc.theme?.colorScheme ?? DEFAULT_COLOR_SCHEME,\n        borderRadius: doc.theme?.borderRadius ?? null,\n        density: doc.theme?.density ?? null,\n        contrast: doc.theme?.contrast ?? null,\n      },\n      sections: buildNav(catalog, doc).map((s) => ({\n        id: s.id,\n        label: s.label,\n        hidden: s.hidden,\n        items: s.items.map((i) => ({\n          id: i.id,\n          label: i.label,\n          hidden: i.hidden,\n        })),\n      })),\n      policies: doc.policies.length,\n      undo: [...undoIds],\n    };\n  }\n\n  const snapshot = () => snapshotOf(current, revision);\n\n  function notify(): void {\n    for (const [listener, last] of listeners) {\n      if (last === revision) continue;\n      listeners.set(listener, revision);\n      listener(snapshot());\n    }\n  }\n\n  function remember(\n    id: string | undefined,\n    print: string,\n    result: CommandResult | BatchResult,\n  ) {\n    if (id === undefined) return;\n    journal.set(id, { id, fingerprint: print, result: clone(result) });\n    while (journal.size > maxJournal) {\n      const oldest = journal.keys().next().value;\n      if (oldest === undefined) break;\n      journal.delete(oldest);\n    }\n  }\n\n  function replay<R extends CommandResult | BatchResult>(\n    id: string | undefined,\n    print: string,\n  ): R | CommandResult | null {\n    if (id === undefined) return null;\n    const hit = journal.get(id);\n    if (!hit) return null;\n    if (hit.fingerprint !== print) {\n      return {\n        ok: false,\n        id,\n        error: err(\n          'id_reuse',\n          `The id \"${id}\" was already used for a different command.`,\n          {\n            path: 'id',\n          },\n        ),\n      };\n    }\n    return { ...(clone(hit.result) as R), replayed: true };\n  }\n\n  function recordUndo(before: PlanState, after: PlanState): string {\n    const undoId = `${options.undoPrefix ?? 'undo'}-${++undoCounter}`;\n    undos.set(undoId, { before: clone(before), after: clone(after) });\n    undoIds = [...undoIds, undoId].slice(-maxUndo);\n    for (const key of [...undos.keys()])\n      if (!undoIds.includes(key)) undos.delete(key);\n    return undoId;\n  }\n\n  const changedBetween = (a: PlanState, b: PlanState) =>\n    a.applied !== b.applied || !same(a.doc, b.doc);\n\n  function toSuccess(\n    id: string | undefined,\n    name: CommandName,\n    outcome: Extract<Outcome, { ok: true }>,\n    revisionBefore: number,\n    revisionAfter: number,\n    snap: PlanSnapshot,\n    undoId?: string,\n  ): Extract<CommandResult, { ok: true }> {\n    return {\n      ok: true,\n      ...(id !== undefined ? { id } : {}),\n      snapshot: snap,\n      receipt: {\n        name,\n        ...(id !== undefined ? { id } : {}),\n        summary: revisionAfter !== revisionBefore ? outcome.summary : '',\n        changed: revisionAfter !== revisionBefore,\n        revisionBefore,\n        revisionAfter,\n        ...(undoId ? { undoId } : {}),\n        ...(outcome.changes ? { changes: outcome.changes } : {}),\n        ...(outcome.warnings ? { warnings: outcome.warnings } : {}),\n      },\n      ...(outcome.data !== undefined ? { data: outcome.data } : {}),\n    };\n  }\n\n  function runUndo(\n    id: string | undefined,\n    input: { undoId: string; force?: boolean },\n  ): CommandResult {\n    const entry = undos.get(input.undoId);\n    if (!entry) {\n      return {\n        ok: false,\n        ...(id !== undefined ? { id } : {}),\n        error: err('not_found', `Nothing to undo for \"${input.undoId}\".`, {\n          path: 'input.undoId',\n        }),\n      };\n    }\n    if (!input.force && changedBetween(current, entry.after)) {\n      return {\n        ok: false,\n        ...(id !== undefined ? { id } : {}),\n        error: err(\n          'conflict',\n          'The plan changed since; send force: true to undo anyway.',\n          {\n            details: { currentRevision: revision },\n          },\n        ),\n      };\n    }\n    const before = revision;\n    const restored = clone(entry.before);\n    const changed = changedBetween(current, restored);\n    current = restored;\n    if (changed) revision += 1;\n    undos.delete(input.undoId);\n    undoIds = undoIds.filter((u) => u !== input.undoId);\n    const result = toSuccess(\n      id,\n      'undo',\n      { ok: true, state: current, summary: 'Undone.' },\n      before,\n      revision,\n      snapshot(),\n    );\n    notify();\n    return result;\n  }\n\n  function run(command: unknown, runOptions: RunOptions = {}): CommandResult {\n    try {\n      const raw =\n        command && typeof command === 'object' && !Array.isArray(command)\n          ? (command as Record<string, unknown>)\n          : undefined;\n      const id = raw?.id as string | undefined;\n      const idProblem = checkId(id);\n      if (idProblem) return { ok: false, error: idProblem };\n      const expected = (raw?.expectedRevision ?? runOptions.expectedRevision) as\n        | number\n        | undefined;\n      const revProblem = checkRevision(expected);\n      if (revProblem)\n        return {\n          ok: false,\n          ...(id !== undefined ? { id } : {}),\n          error: revProblem,\n        };\n\n      const print = fingerprint({\n        name: raw?.name,\n        input: raw?.input ?? {},\n        expectedRevision: expected,\n      });\n      const replayed = replay<CommandResult>(id, print);\n      if (replayed) return replayed as CommandResult;\n\n      const finish = (result: CommandResult) => {\n        remember(id, print, result);\n        return result;\n      };\n      const withId = (error: CommandError): CommandResult => ({\n        ok: false,\n        ...(id !== undefined ? { id } : {}),\n        error,\n      });\n\n      const parsed = readCommand(command, schemas, ['id', 'expectedRevision']);\n      if (!parsed.ok) return finish(withId(parsed.error));\n      if (expected !== undefined && expected !== revision) {\n        return finish(\n          withId(\n            err(\n              'conflict',\n              `The plan is at revision ${revision}, not ${expected}. Read the snapshot and try again.`,\n              {\n                details: {\n                  expectedRevision: expected,\n                  currentRevision: revision,\n                },\n              },\n            ),\n          ),\n        );\n      }\n      if (parsed.name === 'undo') {\n        return finish(\n          runUndo(id, parsed.input as { undoId: string; force?: boolean }),\n        );\n      }\n      const before = current;\n      const outcome = execute(\n        catalog,\n        before,\n        parsed.name,\n        parsed.input as never,\n      );\n      if (!outcome.ok) return finish(withId(outcome.error));\n      const revisionBefore = revision;\n      const changed = changedBetween(before, outcome.state);\n      let undoId: string | undefined;\n      if (changed) {\n        current = outcome.state;\n        revision += 1;\n        undoId = recordUndo(before, outcome.state);\n      }\n      const result = finish(\n        toSuccess(\n          id,\n          parsed.name,\n          outcome,\n          revisionBefore,\n          revision,\n          snapshot(),\n          undoId,\n        ),\n      );\n      notify();\n      return result;\n    } catch (cause) {\n      return {\n        ok: false,\n        error: err(\n          'failed',\n          cause instanceof Error ? cause.message : String(cause),\n        ),\n      };\n    }\n  }\n\n  function batch(input: CommandBatch | unknown): BatchResult {\n    const unchanged = (error: CommandError, id?: string): BatchResult => ({\n      ok: false,\n      ...(id !== undefined ? { id } : {}),\n      error,\n      snapshot: snapshot(),\n    });\n    try {\n      if (!input || typeof input !== 'object' || Array.isArray(input)) {\n        return unchanged(\n          err('invalid_input', 'A batch is an object: { commands }.'),\n        );\n      }\n      const raw = input as Record<string, unknown>;\n      const id = raw.id as string | undefined;\n      const idProblem = checkId(id);\n      if (idProblem) return unchanged(idProblem);\n      const revProblem = checkRevision(raw.expectedRevision);\n      if (revProblem) return unchanged(revProblem, id);\n      const print = fingerprint({\n        commands: raw.commands,\n        expectedRevision: raw.expectedRevision,\n      });\n      const replayed = replay<BatchResult>(id, print);\n      if (replayed) {\n        return 'results' in replayed || 'snapshot' in replayed\n          ? (replayed as BatchResult)\n          : unchanged(\n              (replayed as Extract<CommandResult, { ok: false }>).error,\n              id,\n            );\n      }\n      const finish = (result: BatchResult) => {\n        remember(id, print, result);\n        return result;\n      };\n\n      const commands = raw.commands;\n      if (\n        !Array.isArray(commands) ||\n        commands.length === 0 ||\n        commands.length > 50\n      ) {\n        return finish(\n          unchanged(\n            err(\n              'invalid_input',\n              'commands must be a list of 1 to 50 commands.',\n              { path: 'commands' },\n            ),\n            id,\n          ),\n        );\n      }\n      const expected = raw.expectedRevision as number | undefined;\n      if (expected !== undefined && expected !== revision) {\n        return finish(\n          unchanged(\n            err(\n              'conflict',\n              `The plan is at revision ${revision}, not ${expected}. Read the snapshot and try again.`,\n              {\n                details: {\n                  expectedRevision: expected,\n                  currentRevision: revision,\n                },\n              },\n            ),\n            id,\n          ),\n        );\n      }\n\n      const failAt = (index: number, name: unknown, cause: CommandError) =>\n        finish(\n          unchanged(\n            err(\n              'batch_failed',\n              `Command ${index + 1} (${String(name)}) failed: ${cause.message}`,\n              {\n                path: `commands[${index}]`,\n                details: { index, cause },\n              },\n            ),\n            id,\n          ),\n        );\n\n      // Everything runs on a working copy; the live state is replaced once, at the end.\n      const base = current;\n      const baseRevision = revision;\n      let working = base;\n      let rev = baseRevision;\n      const results: Extract<CommandResult, { ok: true }>[] = [];\n      for (const [index, command] of commands.entries()) {\n        const parsed = readCommand(command, schemas, []);\n        if (!parsed.ok)\n          return failAt(\n            index,\n            (command as { name?: unknown })?.name,\n            parsed.error,\n          );\n        if (parsed.name === 'undo') {\n          return failAt(\n            index,\n            'undo',\n            err('invalid_input', 'undo cannot run inside a batch.'),\n          );\n        }\n        const outcome = execute(\n          catalog,\n          working,\n          parsed.name,\n          parsed.input as never,\n        );\n        if (!outcome.ok) return failAt(index, parsed.name, outcome.error);\n        const before = rev;\n        if (changedBetween(working, outcome.state)) rev += 1;\n        working = outcome.state;\n        results.push(\n          toSuccess(\n            undefined,\n            parsed.name,\n            outcome,\n            before,\n            rev,\n            snapshotOf(working, rev),\n          ),\n        );\n      }\n      const changed = rev !== baseRevision;\n      let undoId: string | undefined;\n      if (changed) {\n        current = working;\n        revision = rev;\n        undoId = recordUndo(base, working);\n        // The batch's one undo restores the state before all of it.\n        for (const r of results) if (r.receipt.changed) delete r.receipt.undoId;\n      }\n      const result = finish({\n        ok: true,\n        ...(id !== undefined ? { id } : {}),\n        snapshot: snapshot(),\n        receipt: {\n          ...(id !== undefined ? { id } : {}),\n          count: results.length,\n          changed,\n          revisionBefore: baseRevision,\n          revisionAfter: rev,\n          ...(undoId ? { undoId } : {}),\n        },\n        results,\n      });\n      notify();\n      return result;\n    } catch (cause) {\n      return unchanged(\n        err('failed', cause instanceof Error ? cause.message : String(cause)),\n      );\n    }\n  }\n\n  return {\n    run: run as CookbookEngine['run'],\n    batch,\n    snapshot,\n    cookbook: () => clone(current.doc),\n    state: () => ({\n      version: COOKBOOK_COMMANDS_VERSION,\n      revision,\n      applied: current.applied,\n      cookbook: clone(current.doc),\n      journal: [...journal.values()].map((entry) => clone(entry)),\n    }),\n    subscribe(listener) {\n      listeners.set(listener, revision);\n      listener(snapshot());\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    tools,\n    batchTool,\n  };\n}\n"],"mappings":"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"}

package/dist/cookbook/engine/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/cookbook/engine/schemas.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,UAAU,EACX,MAAM,YAAY,CAAC;AA8BpB;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW,EAAE,CAwPvE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG;IACtD,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;CACzB,CA+BA;AAgBD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,OAAO,EACd,IAAI,SAAU,GACb;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiG1C;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;AAEvE,yCAAyC;AACzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CAIrE"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/cookbook/engine/schemas.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,UAAU,EACX,MAAM,YAAY,CAAC;AA8BpB;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW,EAAE,CAqQvE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG;IACtD,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;CACzB,CA+BA;AAgBD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,OAAO,EACd,IAAI,SAAU,GACb;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiG1C;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;AAEvE,yCAAyC;AACzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CAIrE"}

package/dist/cookbook/engine/schemas.js

@@ -175,6 +175,29 @@ function buildCommandTools(catalog) {
 					type: ["string", "null"],
 					minLength: 1,
 					description: "Font key. Null restores the preset font."
+				},
+				borderRadius: {
+					enum: [
+						"none",
+						"sm",
+						"md",
+						"lg",
+						"xl",
+						"full"
+					],
+					description: "Corner roundness."
+				},
+				density: {
+					enum: ["comfortable", "touch"],
+					description: "Control size: comfortable, or larger touch targets."
+				},
+				contrast: {
+					enum: [
+						"auto",
+						"standard",
+						"more"
+					],
+					description: "Contrast: auto follows the device, or force standard or more."
 				}
 			})
 		},

package/dist/cookbook/engine/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","names":[],"sources":["../../../src/cookbook/engine/schemas.ts"],"sourcesContent":["import { DEFAULT_THEME_PRESETS, MAX_TERMS_LENGTH } from './defaults.js';\nimport type {\n  CommandName,\n  CommandTool,\n  EngineCatalog,\n  JsonSchema,\n} from './types.js';\n\nconst ids = (description: string, values?: readonly string[]): JsonSchema => ({\n  type: 'array',\n  description,\n  minItems: 1,\n  maxItems: 50,\n  items: values?.length\n    ? { type: 'string', enum: [...values] }\n    : { type: 'string', minLength: 1 },\n});\n\nconst text = (description: string, extra: JsonSchema = {}): JsonSchema => ({\n  type: 'string',\n  description,\n  minLength: 1,\n  maxLength: 200,\n  ...extra,\n});\n\nconst object = (\n  properties: Record<string, JsonSchema>,\n  required: string[] = [],\n): JsonSchema => ({\n  type: 'object',\n  properties,\n  ...(required.length ? { required } : {}),\n  additionalProperties: false,\n});\n\n/**\n * Every command as an MCP/LLM tool definition (`inputSchema` is JSON Schema\n * 2020-12). Recipe and cookbook ids become enums from the catalog, so\n * grammar-constrained decoding cannot name one that does not exist.\n */\nexport function buildCommandTools(catalog: EngineCatalog): CommandTool[] {\n  const recipeIds = catalog.recipes.map((r) => r.id);\n  const cookbookIds = (catalog.cookbooks ?? []).map((c) => c.id);\n  const presets = catalog.themePresets ?? DEFAULT_THEME_PRESETS;\n  const cookbookId = (description: string): JsonSchema => ({\n    type: 'string',\n    description,\n    ...(cookbookIds.length ? { enum: [...cookbookIds] } : { minLength: 1 }),\n  });\n  const entryId = (what: string): JsonSchema =>\n    text(`The id of ${what}, as the plan snapshot's \"sections\" lists it.`);\n  const replace: JsonSchema = {\n    type: 'boolean',\n    description: 'Confirm replacing what is there.',\n  };\n  return [\n    {\n      name: 'add_recipes',\n      description:\n        'Switch recipes on. Recipes they require come along. Returns what was added.',\n      inputSchema: object({ ids: ids('Recipe ids to add.', recipeIds) }, [\n        'ids',\n      ]),\n    },\n    {\n      name: 'remove_recipes',\n      description:\n        'Switch recipes off. A recipe another one needs is kept and reported.',\n      inputSchema: object({ ids: ids('Recipe ids to remove.', recipeIds) }, [\n        'ids',\n      ]),\n    },\n    {\n      name: 'add_features',\n      description:\n        'Add single models no recipe covers, by qualified name (`@scope/pkg:Class`).',\n      inputSchema: object({ ids: ids('Qualified model names to add.') }, [\n        'ids',\n      ]),\n    },\n    {\n      name: 'remove_features',\n      description: 'Remove single models added with add_features.',\n      inputSchema: object({ ids: ids('Qualified model names to remove.') }, [\n        'ids',\n      ]),\n    },\n    {\n      name: 'add_cookbook',\n      description:\n        'Add the recipes and features of a ready-made cookbook to the current app. Nothing is replaced.',\n      inputSchema: object({ id: cookbookId('The cookbook to add.') }, ['id']),\n    },\n    {\n      name: 'remove_cookbook',\n      description:\n        'Remove the recipes and features a ready-made cookbook adds. Ones another recipe needs are kept.',\n      inputSchema: object({ id: cookbookId('The cookbook to remove.') }, [\n        'id',\n      ]),\n    },\n    {\n      name: 'apply_cookbook',\n      description:\n        'Select a ready-made cookbook: replace the whole app (recipes, options, menu, theme) with it. When the app has anything in it, replace must be true.',\n      inputSchema: object(\n        { id: cookbookId('The cookbook to set up.'), replace },\n        ['id'],\n      ),\n    },\n    {\n      name: 'import_cookbook',\n      description:\n        'Replace the whole app with a cookbook document (version 1). Checked strictly; nothing is applied if it is invalid. When the app has anything in it, replace must be true.',\n      inputSchema: object(\n        {\n          document: {\n            type: 'object',\n            description: 'A cookbook document, version 1.',\n          },\n          replace,\n        },\n        ['document'],\n      ),\n    },\n    {\n      name: 'set_settings',\n      description:\n        'Change app settings: currency, default tax rate (percent), default payment terms. Applies to new records only.',\n      inputSchema: object({\n        currency: catalog.currencies?.length\n          ? {\n              type: 'string',\n              description: 'ISO 4217 code, e.g. CAD.',\n              enum: [...catalog.currencies],\n            }\n          : {\n              type: 'string',\n              description: 'ISO 4217 code, e.g. CAD.',\n              pattern: '^[A-Z]{3}$',\n            },\n        taxRate: {\n          type: 'number',\n          description: 'Default tax rate in percent, 0 to 100.',\n          minimum: 0,\n          maximum: 100,\n        },\n        paymentTerms: {\n          type: 'string',\n          description: 'Default payment terms, e.g. \"Net 30\".',\n          minLength: 1,\n          maxLength: MAX_TERMS_LENGTH,\n        },\n      }),\n    },\n    {\n      name: 'set_policy',\n      description:\n        \"Set one field's policy: default value, visibility, label or help. The model must be covered by a recipe or feature that is on. null clears a part.\",\n      inputSchema: object(\n        {\n          model: text(\n            'Qualified model name, e.g. @happyvertical/smrt-commerce:Order.',\n          ),\n          field: text('The model field name.'),\n          defaultValue: {\n            description:\n              'The default as a JSON value (a string, number or boolean). null clears it.',\n          },\n          visibility: {\n            enum: ['basic', 'advanced', 'hidden', null],\n            description: 'Whether the field shows in forms and lists.',\n          },\n          label: {\n            type: ['string', 'null'],\n            description: 'A different label.',\n            maxLength: 120,\n          },\n          help: {\n            type: ['string', 'null'],\n            description: 'Help text under the field.',\n            maxLength: 400,\n          },\n        },\n        ['model', 'field'],\n      ),\n    },\n    {\n      name: 'set_theme',\n      description:\n        'Change the look: a preset, a brand colour, light or dark. A preset replaces a brand colour.',\n      inputSchema: object({\n        preset: { enum: [...presets], description: 'A built-in theme.' },\n        primary: {\n          type: 'string',\n          description: 'Brand colour as #rrggbb.',\n          pattern: '^#[0-9a-fA-F]{6}$',\n        },\n        colorScheme: {\n          enum: ['light', 'dark', 'system'],\n          description: 'Light, dark or follow the device.',\n        },\n        fontFamily: {\n          type: ['string', 'null'],\n          minLength: 1,\n          description: 'Font key. Null restores the preset font.',\n        },\n      }),\n    },\n    {\n      name: 'reset_theme',\n      description: 'Go back to the default look.',\n      inputSchema: object({}),\n    },\n    {\n      name: 'set_name',\n      description: 'Name and describe the app. null clears a part.',\n      inputSchema: object({\n        name: { type: ['string', 'null'], minLength: 1, maxLength: 60 },\n        description: {\n          type: ['string', 'null'],\n          minLength: 1,\n          maxLength: 400,\n        },\n      }),\n    },\n    {\n      name: 'rename_section',\n      description: 'Rename a menu section.',\n      inputSchema: object(\n        {\n          id: entryId('the section'),\n          label: text('The new name.', { maxLength: 60 }),\n        },\n        ['id', 'label'],\n      ),\n    },\n    {\n      name: 'rename_item',\n      description: 'Rename a menu entry. A null label restores its own name.',\n      inputSchema: object(\n        {\n          id: entryId('the entry'),\n          label: { type: ['string', 'null'], minLength: 1, maxLength: 60 },\n        },\n        ['id', 'label'],\n      ),\n    },\n    {\n      name: 'hide',\n      description: 'Hide a menu section or entry. Nothing is deleted.',\n      inputSchema: object({ id: entryId('the section or entry') }, ['id']),\n    },\n    {\n      name: 'show',\n      description: 'Show a hidden menu section or entry again.',\n      inputSchema: object({ id: entryId('the section or entry') }, ['id']),\n    },\n    {\n      name: 'validate',\n      description:\n        'Check the current cookbook against the catalog and report typed diagnostics. Changes nothing.',\n      inputSchema: object({}),\n    },\n    {\n      name: 'export_cookbook',\n      description:\n        'The cookbook as a <name>.cookbook.json file (text in the result). Changes nothing.',\n      inputSchema: object({\n        name: text('A name for the file.', { maxLength: 60 }),\n      }),\n    },\n    {\n      name: 'undo',\n      description:\n        'Undo an earlier change by the undoId its receipt carried. Refused with a conflict when the plan changed since, unless force is true.',\n      inputSchema: object(\n        {\n          undoId: text('The undoId from a receipt.'),\n          force: {\n            type: 'boolean',\n            description: 'Undo even after later edits.',\n          },\n        },\n        ['undoId'],\n      ),\n    },\n  ];\n}\n\n/**\n * The batch envelope as a tool definition: several commands, applied\n * all-or-nothing. Commands inside are validated against their own schemas.\n */\nexport function buildBatchTool(catalog: EngineCatalog): {\n  name: 'run_batch';\n  description: string;\n  inputSchema: JsonSchema;\n} {\n  return {\n    name: 'run_batch',\n    description:\n      'Run several commands as one atomic batch: all apply or none does. A failure names the command and leaves the plan unchanged.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        id: { type: 'string', minLength: 1, maxLength: 200 },\n        expectedRevision: { type: 'integer', minimum: 0 },\n        commands: {\n          type: 'array',\n          minItems: 1,\n          maxItems: 50,\n          items: {\n            oneOf: buildCommandTools(catalog).map((tool) => ({\n              type: 'object',\n              properties: {\n                name: { const: tool.name },\n                input: tool.inputSchema,\n              },\n              required: ['name'],\n              additionalProperties: false,\n            })),\n          },\n        },\n      },\n      required: ['commands'],\n      additionalProperties: false,\n    },\n  };\n}\n\nconst typeOf = (value: unknown): string =>\n  value === null\n    ? 'null'\n    : Array.isArray(value)\n      ? 'array'\n      : Number.isInteger(value)\n        ? 'integer'\n        : typeof value;\n\nfunction typeMatches(wanted: string, value: unknown): boolean {\n  const actual = typeOf(value);\n  return actual === wanted || (wanted === 'number' && actual === 'integer');\n}\n\n/**\n * Check a value against a command schema (the subset the commands use). One\n * validator for runtime and exported schemas, so they cannot drift. Returns\n * the first problem as `{ path, message }`, or null.\n */\nexport function checkSchema(\n  schema: JsonSchema,\n  value: unknown,\n  path = 'input',\n): { path: string; message: string } | null {\n  const bad = (message: string) => ({ path, message: `${path} ${message}` });\n  const type = schema.type as string | string[] | undefined;\n  if (type) {\n    const wanted = Array.isArray(type) ? type : [type];\n    if (!wanted.some((t) => typeMatches(t, value))) {\n      return bad(`must be ${wanted.join(' or ')}`);\n    }\n  }\n  const choices = schema.enum as unknown[] | undefined;\n  if (choices && !choices.includes(value)) {\n    return bad(\n      choices.length > 12\n        ? 'is not a known value'\n        : `must be one of ${choices.map((c) => JSON.stringify(c)).join(', ')}`,\n    );\n  }\n  if (typeof value === 'string') {\n    const { minLength, maxLength, pattern } = schema as {\n      minLength?: number;\n      maxLength?: number;\n      pattern?: string;\n    };\n    if (minLength !== undefined && value.length < minLength) {\n      return bad('must not be empty');\n    }\n    if (maxLength !== undefined && value.length > maxLength) {\n      return bad(`must be at most ${maxLength} characters`);\n    }\n    if (pattern && !new RegExp(pattern).test(value)) {\n      return bad('has the wrong format');\n    }\n  }\n  if (typeof value === 'number') {\n    const { minimum, maximum } = schema as {\n      minimum?: number;\n      maximum?: number;\n    };\n    if (!Number.isFinite(value)) return bad('must be a finite number');\n    if (minimum !== undefined && value < minimum) {\n      return bad(`must be at least ${minimum}`);\n    }\n    if (maximum !== undefined && value > maximum) {\n      return bad(`must be at most ${maximum}`);\n    }\n  }\n  if (Array.isArray(value)) {\n    const { minItems, maxItems, items } = schema as {\n      minItems?: number;\n      maxItems?: number;\n      items?: JsonSchema;\n    };\n    if (minItems !== undefined && value.length < minItems) {\n      return bad(`needs at least ${minItems} item${minItems === 1 ? '' : 's'}`);\n    }\n    if (maxItems !== undefined && value.length > maxItems) {\n      return bad(`takes at most ${maxItems} items`);\n    }\n    if (items) {\n      for (const [index, item] of value.entries()) {\n        const problem = checkSchema(items, item, `${path}[${index}]`);\n        if (problem) return problem;\n      }\n    }\n  }\n  if (typeOf(value) === 'object') {\n    const object = value as Record<string, unknown>;\n    const { properties, required, additionalProperties } = schema as {\n      properties?: Record<string, JsonSchema>;\n      required?: string[];\n      additionalProperties?: boolean;\n    };\n    for (const key of required ?? []) {\n      if (object[key] === undefined) {\n        return {\n          path: `${path}.${key}`,\n          message: `${path}.${key} is required`,\n        };\n      }\n    }\n    for (const [key, entry] of Object.entries(object)) {\n      const child = properties?.[key];\n      if (!child) {\n        if (additionalProperties === false) {\n          return {\n            path: `${path}.${key}`,\n            message: `${path}.${key} is not an option of this command`,\n          };\n        }\n        continue;\n      }\n      if (entry === undefined) continue;\n      const problem = checkSchema(child, entry, `${path}.${key}`);\n      if (problem) return problem;\n    }\n  }\n  return null;\n}\n\nexport type CommandSchemas = Readonly<Record<CommandName, JsonSchema>>;\n\n/** The input schemas by command name. */\nexport function commandSchemas(catalog: EngineCatalog): CommandSchemas {\n  return Object.fromEntries(\n    buildCommandTools(catalog).map((tool) => [tool.name, tool.inputSchema]),\n  ) as CommandSchemas;\n}\n"],"mappings":"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"}
+{"version":3,"file":"schemas.js","names":[],"sources":["../../../src/cookbook/engine/schemas.ts"],"sourcesContent":["import { DEFAULT_THEME_PRESETS, MAX_TERMS_LENGTH } from './defaults.js';\nimport type {\n  CommandName,\n  CommandTool,\n  EngineCatalog,\n  JsonSchema,\n} from './types.js';\n\nconst ids = (description: string, values?: readonly string[]): JsonSchema => ({\n  type: 'array',\n  description,\n  minItems: 1,\n  maxItems: 50,\n  items: values?.length\n    ? { type: 'string', enum: [...values] }\n    : { type: 'string', minLength: 1 },\n});\n\nconst text = (description: string, extra: JsonSchema = {}): JsonSchema => ({\n  type: 'string',\n  description,\n  minLength: 1,\n  maxLength: 200,\n  ...extra,\n});\n\nconst object = (\n  properties: Record<string, JsonSchema>,\n  required: string[] = [],\n): JsonSchema => ({\n  type: 'object',\n  properties,\n  ...(required.length ? { required } : {}),\n  additionalProperties: false,\n});\n\n/**\n * Every command as an MCP/LLM tool definition (`inputSchema` is JSON Schema\n * 2020-12). Recipe and cookbook ids become enums from the catalog, so\n * grammar-constrained decoding cannot name one that does not exist.\n */\nexport function buildCommandTools(catalog: EngineCatalog): CommandTool[] {\n  const recipeIds = catalog.recipes.map((r) => r.id);\n  const cookbookIds = (catalog.cookbooks ?? []).map((c) => c.id);\n  const presets = catalog.themePresets ?? DEFAULT_THEME_PRESETS;\n  const cookbookId = (description: string): JsonSchema => ({\n    type: 'string',\n    description,\n    ...(cookbookIds.length ? { enum: [...cookbookIds] } : { minLength: 1 }),\n  });\n  const entryId = (what: string): JsonSchema =>\n    text(`The id of ${what}, as the plan snapshot's \"sections\" lists it.`);\n  const replace: JsonSchema = {\n    type: 'boolean',\n    description: 'Confirm replacing what is there.',\n  };\n  return [\n    {\n      name: 'add_recipes',\n      description:\n        'Switch recipes on. Recipes they require come along. Returns what was added.',\n      inputSchema: object({ ids: ids('Recipe ids to add.', recipeIds) }, [\n        'ids',\n      ]),\n    },\n    {\n      name: 'remove_recipes',\n      description:\n        'Switch recipes off. A recipe another one needs is kept and reported.',\n      inputSchema: object({ ids: ids('Recipe ids to remove.', recipeIds) }, [\n        'ids',\n      ]),\n    },\n    {\n      name: 'add_features',\n      description:\n        'Add single models no recipe covers, by qualified name (`@scope/pkg:Class`).',\n      inputSchema: object({ ids: ids('Qualified model names to add.') }, [\n        'ids',\n      ]),\n    },\n    {\n      name: 'remove_features',\n      description: 'Remove single models added with add_features.',\n      inputSchema: object({ ids: ids('Qualified model names to remove.') }, [\n        'ids',\n      ]),\n    },\n    {\n      name: 'add_cookbook',\n      description:\n        'Add the recipes and features of a ready-made cookbook to the current app. Nothing is replaced.',\n      inputSchema: object({ id: cookbookId('The cookbook to add.') }, ['id']),\n    },\n    {\n      name: 'remove_cookbook',\n      description:\n        'Remove the recipes and features a ready-made cookbook adds. Ones another recipe needs are kept.',\n      inputSchema: object({ id: cookbookId('The cookbook to remove.') }, [\n        'id',\n      ]),\n    },\n    {\n      name: 'apply_cookbook',\n      description:\n        'Select a ready-made cookbook: replace the whole app (recipes, options, menu, theme) with it. When the app has anything in it, replace must be true.',\n      inputSchema: object(\n        { id: cookbookId('The cookbook to set up.'), replace },\n        ['id'],\n      ),\n    },\n    {\n      name: 'import_cookbook',\n      description:\n        'Replace the whole app with a cookbook document (version 1). Checked strictly; nothing is applied if it is invalid. When the app has anything in it, replace must be true.',\n      inputSchema: object(\n        {\n          document: {\n            type: 'object',\n            description: 'A cookbook document, version 1.',\n          },\n          replace,\n        },\n        ['document'],\n      ),\n    },\n    {\n      name: 'set_settings',\n      description:\n        'Change app settings: currency, default tax rate (percent), default payment terms. Applies to new records only.',\n      inputSchema: object({\n        currency: catalog.currencies?.length\n          ? {\n              type: 'string',\n              description: 'ISO 4217 code, e.g. CAD.',\n              enum: [...catalog.currencies],\n            }\n          : {\n              type: 'string',\n              description: 'ISO 4217 code, e.g. CAD.',\n              pattern: '^[A-Z]{3}$',\n            },\n        taxRate: {\n          type: 'number',\n          description: 'Default tax rate in percent, 0 to 100.',\n          minimum: 0,\n          maximum: 100,\n        },\n        paymentTerms: {\n          type: 'string',\n          description: 'Default payment terms, e.g. \"Net 30\".',\n          minLength: 1,\n          maxLength: MAX_TERMS_LENGTH,\n        },\n      }),\n    },\n    {\n      name: 'set_policy',\n      description:\n        \"Set one field's policy: default value, visibility, label or help. The model must be covered by a recipe or feature that is on. null clears a part.\",\n      inputSchema: object(\n        {\n          model: text(\n            'Qualified model name, e.g. @happyvertical/smrt-commerce:Order.',\n          ),\n          field: text('The model field name.'),\n          defaultValue: {\n            description:\n              'The default as a JSON value (a string, number or boolean). null clears it.',\n          },\n          visibility: {\n            enum: ['basic', 'advanced', 'hidden', null],\n            description: 'Whether the field shows in forms and lists.',\n          },\n          label: {\n            type: ['string', 'null'],\n            description: 'A different label.',\n            maxLength: 120,\n          },\n          help: {\n            type: ['string', 'null'],\n            description: 'Help text under the field.',\n            maxLength: 400,\n          },\n        },\n        ['model', 'field'],\n      ),\n    },\n    {\n      name: 'set_theme',\n      description:\n        'Change the look: a preset, a brand colour, light or dark. A preset replaces a brand colour.',\n      inputSchema: object({\n        preset: { enum: [...presets], description: 'A built-in theme.' },\n        primary: {\n          type: 'string',\n          description: 'Brand colour as #rrggbb.',\n          pattern: '^#[0-9a-fA-F]{6}$',\n        },\n        colorScheme: {\n          enum: ['light', 'dark', 'system'],\n          description: 'Light, dark or follow the device.',\n        },\n        fontFamily: {\n          type: ['string', 'null'],\n          minLength: 1,\n          description: 'Font key. Null restores the preset font.',\n        },\n        borderRadius: {\n          enum: ['none', 'sm', 'md', 'lg', 'xl', 'full'],\n          description: 'Corner roundness.',\n        },\n        density: {\n          enum: ['comfortable', 'touch'],\n          description: 'Control size: comfortable, or larger touch targets.',\n        },\n        contrast: {\n          enum: ['auto', 'standard', 'more'],\n          description:\n            'Contrast: auto follows the device, or force standard or more.',\n        },\n      }),\n    },\n    {\n      name: 'reset_theme',\n      description: 'Go back to the default look.',\n      inputSchema: object({}),\n    },\n    {\n      name: 'set_name',\n      description: 'Name and describe the app. null clears a part.',\n      inputSchema: object({\n        name: { type: ['string', 'null'], minLength: 1, maxLength: 60 },\n        description: {\n          type: ['string', 'null'],\n          minLength: 1,\n          maxLength: 400,\n        },\n      }),\n    },\n    {\n      name: 'rename_section',\n      description: 'Rename a menu section.',\n      inputSchema: object(\n        {\n          id: entryId('the section'),\n          label: text('The new name.', { maxLength: 60 }),\n        },\n        ['id', 'label'],\n      ),\n    },\n    {\n      name: 'rename_item',\n      description: 'Rename a menu entry. A null label restores its own name.',\n      inputSchema: object(\n        {\n          id: entryId('the entry'),\n          label: { type: ['string', 'null'], minLength: 1, maxLength: 60 },\n        },\n        ['id', 'label'],\n      ),\n    },\n    {\n      name: 'hide',\n      description: 'Hide a menu section or entry. Nothing is deleted.',\n      inputSchema: object({ id: entryId('the section or entry') }, ['id']),\n    },\n    {\n      name: 'show',\n      description: 'Show a hidden menu section or entry again.',\n      inputSchema: object({ id: entryId('the section or entry') }, ['id']),\n    },\n    {\n      name: 'validate',\n      description:\n        'Check the current cookbook against the catalog and report typed diagnostics. Changes nothing.',\n      inputSchema: object({}),\n    },\n    {\n      name: 'export_cookbook',\n      description:\n        'The cookbook as a <name>.cookbook.json file (text in the result). Changes nothing.',\n      inputSchema: object({\n        name: text('A name for the file.', { maxLength: 60 }),\n      }),\n    },\n    {\n      name: 'undo',\n      description:\n        'Undo an earlier change by the undoId its receipt carried. Refused with a conflict when the plan changed since, unless force is true.',\n      inputSchema: object(\n        {\n          undoId: text('The undoId from a receipt.'),\n          force: {\n            type: 'boolean',\n            description: 'Undo even after later edits.',\n          },\n        },\n        ['undoId'],\n      ),\n    },\n  ];\n}\n\n/**\n * The batch envelope as a tool definition: several commands, applied\n * all-or-nothing. Commands inside are validated against their own schemas.\n */\nexport function buildBatchTool(catalog: EngineCatalog): {\n  name: 'run_batch';\n  description: string;\n  inputSchema: JsonSchema;\n} {\n  return {\n    name: 'run_batch',\n    description:\n      'Run several commands as one atomic batch: all apply or none does. A failure names the command and leaves the plan unchanged.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        id: { type: 'string', minLength: 1, maxLength: 200 },\n        expectedRevision: { type: 'integer', minimum: 0 },\n        commands: {\n          type: 'array',\n          minItems: 1,\n          maxItems: 50,\n          items: {\n            oneOf: buildCommandTools(catalog).map((tool) => ({\n              type: 'object',\n              properties: {\n                name: { const: tool.name },\n                input: tool.inputSchema,\n              },\n              required: ['name'],\n              additionalProperties: false,\n            })),\n          },\n        },\n      },\n      required: ['commands'],\n      additionalProperties: false,\n    },\n  };\n}\n\nconst typeOf = (value: unknown): string =>\n  value === null\n    ? 'null'\n    : Array.isArray(value)\n      ? 'array'\n      : Number.isInteger(value)\n        ? 'integer'\n        : typeof value;\n\nfunction typeMatches(wanted: string, value: unknown): boolean {\n  const actual = typeOf(value);\n  return actual === wanted || (wanted === 'number' && actual === 'integer');\n}\n\n/**\n * Check a value against a command schema (the subset the commands use). One\n * validator for runtime and exported schemas, so they cannot drift. Returns\n * the first problem as `{ path, message }`, or null.\n */\nexport function checkSchema(\n  schema: JsonSchema,\n  value: unknown,\n  path = 'input',\n): { path: string; message: string } | null {\n  const bad = (message: string) => ({ path, message: `${path} ${message}` });\n  const type = schema.type as string | string[] | undefined;\n  if (type) {\n    const wanted = Array.isArray(type) ? type : [type];\n    if (!wanted.some((t) => typeMatches(t, value))) {\n      return bad(`must be ${wanted.join(' or ')}`);\n    }\n  }\n  const choices = schema.enum as unknown[] | undefined;\n  if (choices && !choices.includes(value)) {\n    return bad(\n      choices.length > 12\n        ? 'is not a known value'\n        : `must be one of ${choices.map((c) => JSON.stringify(c)).join(', ')}`,\n    );\n  }\n  if (typeof value === 'string') {\n    const { minLength, maxLength, pattern } = schema as {\n      minLength?: number;\n      maxLength?: number;\n      pattern?: string;\n    };\n    if (minLength !== undefined && value.length < minLength) {\n      return bad('must not be empty');\n    }\n    if (maxLength !== undefined && value.length > maxLength) {\n      return bad(`must be at most ${maxLength} characters`);\n    }\n    if (pattern && !new RegExp(pattern).test(value)) {\n      return bad('has the wrong format');\n    }\n  }\n  if (typeof value === 'number') {\n    const { minimum, maximum } = schema as {\n      minimum?: number;\n      maximum?: number;\n    };\n    if (!Number.isFinite(value)) return bad('must be a finite number');\n    if (minimum !== undefined && value < minimum) {\n      return bad(`must be at least ${minimum}`);\n    }\n    if (maximum !== undefined && value > maximum) {\n      return bad(`must be at most ${maximum}`);\n    }\n  }\n  if (Array.isArray(value)) {\n    const { minItems, maxItems, items } = schema as {\n      minItems?: number;\n      maxItems?: number;\n      items?: JsonSchema;\n    };\n    if (minItems !== undefined && value.length < minItems) {\n      return bad(`needs at least ${minItems} item${minItems === 1 ? '' : 's'}`);\n    }\n    if (maxItems !== undefined && value.length > maxItems) {\n      return bad(`takes at most ${maxItems} items`);\n    }\n    if (items) {\n      for (const [index, item] of value.entries()) {\n        const problem = checkSchema(items, item, `${path}[${index}]`);\n        if (problem) return problem;\n      }\n    }\n  }\n  if (typeOf(value) === 'object') {\n    const object = value as Record<string, unknown>;\n    const { properties, required, additionalProperties } = schema as {\n      properties?: Record<string, JsonSchema>;\n      required?: string[];\n      additionalProperties?: boolean;\n    };\n    for (const key of required ?? []) {\n      if (object[key] === undefined) {\n        return {\n          path: `${path}.${key}`,\n          message: `${path}.${key} is required`,\n        };\n      }\n    }\n    for (const [key, entry] of Object.entries(object)) {\n      const child = properties?.[key];\n      if (!child) {\n        if (additionalProperties === false) {\n          return {\n            path: `${path}.${key}`,\n            message: `${path}.${key} is not an option of this command`,\n          };\n        }\n        continue;\n      }\n      if (entry === undefined) continue;\n      const problem = checkSchema(child, entry, `${path}.${key}`);\n      if (problem) return problem;\n    }\n  }\n  return null;\n}\n\nexport type CommandSchemas = Readonly<Record<CommandName, JsonSchema>>;\n\n/** The input schemas by command name. */\nexport function commandSchemas(catalog: EngineCatalog): CommandSchemas {\n  return Object.fromEntries(\n    buildCommandTools(catalog).map((tool) => [tool.name, tool.inputSchema]),\n  ) as CommandSchemas;\n}\n"],"mappings":"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"}

package/dist/cookbook/engine/types.d.ts

@@ -119,6 +119,9 @@ export interface CommandInputs {
         primary?: string;
         colorScheme?: 'light' | 'dark' | 'system';
         fontFamily?: string | null;
+        borderRadius?: 'none' | 'sm' | 'md' | 'lg' | 'xl' | 'full';
+        density?: 'comfortable' | 'touch';
+        contrast?: 'auto' | 'standard' | 'more';
     };
     reset_theme: Record<string, never>;
     /** Name (and describe) the app; null clears. */
@@ -215,6 +218,9 @@ export interface PlanSnapshot {
         preset: string | null;
         primary: string | null;
         colorScheme: string;
+        borderRadius: string | null;
+        density: string | null;
+        contrast: string | null;
     };
     sections: {
         id: string;