@happyvertical/smrt-core 0.55.7 → 0.55.9

package/dist/recipe-demo.js

@@ -0,0 +1,130 @@
+//#region src/recipe-demo.ts
+/** Modes from best to worst for a demo; used to pick the worst of several. */
+var RECIPE_DEMO_MODES = [
+	"live",
+	"mock",
+	"sample",
+	"server"
+];
+/** The provider option that names a fake a demo can use instead of the real one. */
+var MOCK_PROVIDER_OPTION = "mock";
+var rank = (mode) => RECIPE_DEMO_MODES.indexOf(mode);
+/** True when the provider holds credentials a browser cannot (`secrets` listed). */
+function isServerProvider(provider) {
+	return (provider.secrets?.length ?? 0) > 0;
+}
+/** True when one of the provider's options runs in a browser (`browserOptions`). */
+function hasBrowserOption(provider) {
+	return (provider.browserOptions?.length ?? 0) > 0;
+}
+/** True when a demo can fake the provider (`options` includes `mock`). */
+function isMockableProvider(provider) {
+	return provider.options.includes(MOCK_PROVIDER_OPTION);
+}
+function describePackage(capability) {
+	const issues = capability.issues?.length ? ` (${capability.issues.join(", ")})` : "";
+	return `${[capability.reason ? `its package does not build for a browser: ${capability.reason}` : void 0, capability.via?.length ? `its package depends on ${capability.via.join(", ")}, which do not build for a browser` : void 0].filter(Boolean).join("; and ") || "its package does not build for a browser"}${issues}`;
+}
+/**
+* Classify one recipe. `capability` is the bundle-gate result for the recipe's
+* package, or `undefined` when the package is not measured (a consumer app's
+* own recipes); then only the recipe's own declarations decide.
+*/
+function deriveRecipeDemo(recipe, capability) {
+	const problems = [];
+	const reasons = [];
+	let mode = "live";
+	const raise = (next) => {
+		if (rank(next) > rank(mode)) mode = next;
+	};
+	const providers = recipe.providers ?? [];
+	const serverProviders = providers.filter((provider) => isServerProvider(provider) && !hasBrowserOption(provider));
+	const inBrowser = providers.filter((provider) => isServerProvider(provider) && hasBrowserOption(provider));
+	const mockable = serverProviders.filter(isMockableProvider);
+	const blocking = serverProviders.filter((provider) => provider.required && !isMockableProvider(provider));
+	const optionalUnavailable = serverProviders.filter((provider) => !provider.required && !isMockableProvider(provider));
+	const packageServerOnly = capability?.status === "server-only";
+	if (recipe.runtime === "browser") {
+		if (capability && packageServerOnly) problems.push(`recipe ${recipe.id}: runtime is "browser" but ${describePackage(capability)}; declare "both" or fix the package`);
+		for (const provider of blocking) problems.push(`recipe ${recipe.id}: runtime is "browser" but provider "${provider.id}" is required and holds secrets (${provider.secrets?.join(", ")}) a browser cannot keep; give it a browserOptions entry or a "${MOCK_PROVIDER_OPTION}" option, make it optional, or declare "both" or "server"`);
+	}
+	if (recipe.runtime === "server") {
+		raise("server");
+		reasons.push("The recipe declares runtime \"server\".");
+	}
+	if (capability && packageServerOnly) {
+		raise("server");
+		reasons.push(`Needs a server because ${describePackage(capability)}.`);
+	}
+	if (blocking.length > 0) {
+		const names = blocking.map((provider) => provider.id).join(", ");
+		if (recipe.demoSeed) {
+			raise("sample");
+			reasons.push(`Required provider ${names} holds secrets a browser cannot keep and has no in-browser or "${MOCK_PROVIDER_OPTION}" option; the demo seed stands in for its data.`);
+		} else {
+			raise("server");
+			reasons.push(`Required provider ${names} holds secrets a browser cannot keep and has no in-browser or "${MOCK_PROVIDER_OPTION}" option and the recipe has no demo seed.`);
+		}
+	}
+	if (mockable.length > 0) {
+		raise("mock");
+		reasons.push(`Provider ${mockable.map((provider) => provider.id).join(", ")} is faked in a demo.`);
+	}
+	if (inBrowser.length > 0) reasons.push(`Provider ${inBrowser.map((provider) => provider.id).join(", ")} has an in-browser option (${inBrowser.flatMap((provider) => provider.browserOptions ?? []).join(", ")}).`);
+	if (optionalUnavailable.length > 0) reasons.push(`Optional provider ${optionalUnavailable.map((provider) => provider.id).join(", ")} is unavailable in a browser.`);
+	const declares = recipe.runtime !== void 0 || providers.length > 0 || recipe.demoSeed !== void 0;
+	if (!capability && !declares) return { problems };
+	if (!capability) reasons.push("The package browser capability is not measured.");
+	if (mode === "live" && capability && reasons.length === 0) reasons.push("The package builds for a browser and nothing needs faking.");
+	return {
+		demo: {
+			mode,
+			reasons,
+			...mockable.length > 0 ? { mocked: mockable.map((provider) => provider.id) } : {}
+		},
+		problems
+	};
+}
+/**
+* The mode a host should show for `recipeId`: the worst of its own `demo` and
+* that of every recipe it needs. Each `requiresAny` list counts its best known
+* alternative. Ids that are unknown, or whose recipe has no `demo`, are
+* ignored, so a partial catalog degrades to the recipe's own answer. Returns
+* `undefined` when the recipe is unknown or has no `demo` of its own.
+*/
+function effectiveRecipeDemo(recipeId, recipes) {
+	const byId = new Map(recipes.map((recipe) => [recipe.id, recipe]));
+	const resolve = (id, trail) => {
+		const recipe = byId.get(id);
+		if (!recipe?.demo || trail.includes(id)) return recipe?.demo;
+		let mode = recipe.demo.mode;
+		const reasons = [...recipe.demo.reasons];
+		const consider = (needed, via) => {
+			if (rank(via.mode) > rank(mode)) mode = via.mode;
+			if (via.mode !== "live") reasons.push(`Needs ${needed}, which is ${via.mode}.`);
+		};
+		for (const needed of recipe.requires) {
+			const demo = resolve(needed, [...trail, id]);
+			if (demo) consider(needed, demo);
+		}
+		for (const alternatives of recipe.requiresAny ?? []) {
+			const known = alternatives.map((needed) => ({
+				needed,
+				demo: resolve(needed, [...trail, id])
+			})).filter((entry) => entry.demo !== void 0);
+			if (known.length === 0) continue;
+			const best = known.reduce((a, b) => rank(b.demo.mode) < rank(a.demo.mode) ? b : a);
+			consider(best.needed, best.demo);
+		}
+		return {
+			mode,
+			reasons,
+			...recipe.demo.mocked ? { mocked: recipe.demo.mocked } : {}
+		};
+	};
+	return resolve(recipeId, []);
+}
+//#endregion
+export { MOCK_PROVIDER_OPTION, RECIPE_DEMO_MODES, deriveRecipeDemo, effectiveRecipeDemo, hasBrowserOption, isMockableProvider, isServerProvider };
+
+//# sourceMappingURL=recipe-demo.js.map

package/dist/recipe-demo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-demo.js","names":[],"sources":["../src/recipe-demo.ts"],"sourcesContent":["/**\n * Browser-demo classification of a recipe (#3709): the pure, browser-safe\n * rules that turn what a recipe declares (`runtime`, `providers`, `demoSeed`)\n * and what the bundle-gate measured for its package into one of four modes.\n *\n * - `live`: the real browser data layer (PGlite), nothing faked.\n * - `mock`: runs in the browser, but a provider (sending mail, OAuth) is faked.\n * - `sample`: runs in the browser on fixture data (`demoSeed`) only.\n * - `server`: needs a server; a browser-only host cannot offer it.\n *\n * The classification is **derived**, never authored: the build calls\n * {@link deriveRecipeDemo} and emits `demo` on the recipe entry. A host that\n * wants the answer for a recipe together with the recipes it needs calls\n * {@link effectiveRecipeDemo}.\n *\n * Rules, in the order they fire (the worst mode wins; `live` < `mock` <\n * `sample` < `server`):\n *\n * 1. `runtime: 'server'` is `server`. `runtime: 'both'` (or omitted) makes no\n *    claim, so the package capability refines it.\n * 2. A package the bundle-gate reports `server-only` is `server`.\n * 3. A *server provider* is one that lists `secrets`: it holds credentials a\n *    browser cannot. One with a `browserOptions` entry is satisfied in a\n *    browser (an in-browser model), so it changes nothing. Otherwise it is\n *    *mockable* when `options` includes `mock`. A required server provider\n *    that is neither is `sample` when the recipe ships a `demoSeed` (the\n *    fixtures stand in for what the provider would feed), otherwise `server`.\n * 4. Any other mockable server provider makes the recipe `mock`.\n * 5. Otherwise `live`.\n *\n * Contradictions fail the build: `runtime: 'browser'` on a `server-only`\n * package, or beside a required server provider with no browser option and no\n * mock.\n *\n * @packageDocumentation\n */\n\nimport type {\n  PackageBrowserCapability,\n  RecipeDefinition,\n  RecipeDemo,\n  RecipeDemoMode,\n  RecipeProvider,\n} from '@happyvertical/smrt-types';\n\nexport type {\n  PackageBrowserCapability,\n  RecipeDemo,\n  RecipeDemoMode,\n} from '@happyvertical/smrt-types';\n\n/** Modes from best to worst for a demo; used to pick the worst of several. */\nexport const RECIPE_DEMO_MODES: readonly RecipeDemoMode[] = [\n  'live',\n  'mock',\n  'sample',\n  'server',\n];\n\n/** The provider option that names a fake a demo can use instead of the real one. */\nexport const MOCK_PROVIDER_OPTION = 'mock';\n\nconst rank = (mode: RecipeDemoMode): number => RECIPE_DEMO_MODES.indexOf(mode);\n\n/** True when the provider holds credentials a browser cannot (`secrets` listed). */\nexport function isServerProvider(provider: RecipeProvider): boolean {\n  return (provider.secrets?.length ?? 0) > 0;\n}\n\n/** True when one of the provider's options runs in a browser (`browserOptions`). */\nexport function hasBrowserOption(provider: RecipeProvider): boolean {\n  return (provider.browserOptions?.length ?? 0) > 0;\n}\n\n/** True when a demo can fake the provider (`options` includes `mock`). */\nexport function isMockableProvider(provider: RecipeProvider): boolean {\n  return provider.options.includes(MOCK_PROVIDER_OPTION);\n}\n\n/** What {@link deriveRecipeDemo} found: the classification and any contradictions. */\nexport interface RecipeDemoDerivation {\n  /** Omitted when nothing is known about the package and the recipe declares nothing relevant. */\n  demo?: RecipeDemo;\n  /** One sentence per contradictory declaration; the build fails on any. */\n  problems: string[];\n}\n\nfunction describePackage(capability: PackageBrowserCapability): string {\n  const issues = capability.issues?.length\n    ? ` (${capability.issues.join(', ')})`\n    : '';\n  const own = capability.reason\n    ? `its package does not build for a browser: ${capability.reason}`\n    : undefined;\n  const inherited = capability.via?.length\n    ? `its package depends on ${capability.via.join(', ')}, which do not build for a browser`\n    : undefined;\n  return `${[own, inherited].filter(Boolean).join('; and ') || 'its package does not build for a browser'}${issues}`;\n}\n\n/**\n * Classify one recipe. `capability` is the bundle-gate result for the recipe's\n * package, or `undefined` when the package is not measured (a consumer app's\n * own recipes); then only the recipe's own declarations decide.\n */\nexport function deriveRecipeDemo(\n  recipe: Pick<RecipeDefinition, 'id' | 'runtime' | 'providers' | 'demoSeed'>,\n  capability?: PackageBrowserCapability,\n): RecipeDemoDerivation {\n  const problems: string[] = [];\n  const reasons: string[] = [];\n  let mode: RecipeDemoMode = 'live';\n  const raise = (next: RecipeDemoMode) => {\n    if (rank(next) > rank(mode)) mode = next;\n  };\n\n  const providers = recipe.providers ?? [];\n  // A provider with an in-browser option is satisfied there: it needs no faking.\n  const serverProviders = providers.filter(\n    (provider) => isServerProvider(provider) && !hasBrowserOption(provider),\n  );\n  const inBrowser = providers.filter(\n    (provider) => isServerProvider(provider) && hasBrowserOption(provider),\n  );\n  const mockable = serverProviders.filter(isMockableProvider);\n  const blocking = serverProviders.filter(\n    (provider) => provider.required && !isMockableProvider(provider),\n  );\n  const optionalUnavailable = serverProviders.filter(\n    (provider) => !provider.required && !isMockableProvider(provider),\n  );\n  const packageServerOnly = capability?.status === 'server-only';\n\n  if (recipe.runtime === 'browser') {\n    if (capability && packageServerOnly) {\n      problems.push(\n        `recipe ${recipe.id}: runtime is \"browser\" but ${describePackage(capability)}; declare \"both\" or fix the package`,\n      );\n    }\n    for (const provider of blocking) {\n      problems.push(\n        `recipe ${recipe.id}: runtime is \"browser\" but provider \"${provider.id}\" is required and holds secrets (${provider.secrets?.join(', ')}) a browser cannot keep; give it a browserOptions entry or a \"${MOCK_PROVIDER_OPTION}\" option, make it optional, or declare \"both\" or \"server\"`,\n      );\n    }\n  }\n\n  if (recipe.runtime === 'server') {\n    raise('server');\n    reasons.push('The recipe declares runtime \"server\".');\n  }\n  if (capability && packageServerOnly) {\n    raise('server');\n    reasons.push(`Needs a server because ${describePackage(capability)}.`);\n  }\n  if (blocking.length > 0) {\n    const names = blocking.map((provider) => provider.id).join(', ');\n    if (recipe.demoSeed) {\n      raise('sample');\n      reasons.push(\n        `Required provider ${names} holds secrets a browser cannot keep and has no in-browser or \"${MOCK_PROVIDER_OPTION}\" option; the demo seed stands in for its data.`,\n      );\n    } else {\n      raise('server');\n      reasons.push(\n        `Required provider ${names} holds secrets a browser cannot keep and has no in-browser or \"${MOCK_PROVIDER_OPTION}\" option and the recipe has no demo seed.`,\n      );\n    }\n  }\n  if (mockable.length > 0) {\n    raise('mock');\n    reasons.push(\n      `Provider ${mockable.map((provider) => provider.id).join(', ')} is faked in a demo.`,\n    );\n  }\n  if (inBrowser.length > 0) {\n    reasons.push(\n      `Provider ${inBrowser.map((provider) => provider.id).join(', ')} has an in-browser option (${inBrowser\n        .flatMap((provider) => provider.browserOptions ?? [])\n        .join(', ')}).`,\n    );\n  }\n  if (optionalUnavailable.length > 0) {\n    reasons.push(\n      `Optional provider ${optionalUnavailable.map((provider) => provider.id).join(', ')} is unavailable in a browser.`,\n    );\n  }\n\n  const declares =\n    recipe.runtime !== undefined ||\n    providers.length > 0 ||\n    recipe.demoSeed !== undefined;\n  if (!capability && !declares) return { problems };\n  if (!capability) {\n    reasons.push('The package browser capability is not measured.');\n  }\n  if (mode === 'live' && capability && reasons.length === 0) {\n    reasons.push('The package builds for a browser and nothing needs faking.');\n  }\n\n  const demo: RecipeDemo = {\n    mode,\n    reasons,\n    ...(mockable.length > 0\n      ? { mocked: mockable.map((provider) => provider.id) }\n      : {}),\n  };\n  return { demo, problems };\n}\n\n/**\n * The mode a host should show for `recipeId`: the worst of its own `demo` and\n * that of every recipe it needs. Each `requiresAny` list counts its best known\n * alternative. Ids that are unknown, or whose recipe has no `demo`, are\n * ignored, so a partial catalog degrades to the recipe's own answer. Returns\n * `undefined` when the recipe is unknown or has no `demo` of its own.\n */\nexport function effectiveRecipeDemo(\n  recipeId: string,\n  recipes: readonly Pick<\n    RecipeDefinition,\n    'id' | 'requires' | 'requiresAny' | 'demo'\n  >[],\n): RecipeDemo | undefined {\n  const byId = new Map(recipes.map((recipe) => [recipe.id, recipe]));\n\n  const resolve = (\n    id: string,\n    trail: readonly string[],\n  ): RecipeDemo | undefined => {\n    const recipe = byId.get(id);\n    if (!recipe?.demo || trail.includes(id)) return recipe?.demo;\n    let mode = recipe.demo.mode;\n    const reasons = [...recipe.demo.reasons];\n    const consider = (needed: string, via: RecipeDemo) => {\n      if (rank(via.mode) > rank(mode)) mode = via.mode;\n      if (via.mode !== 'live') {\n        reasons.push(`Needs ${needed}, which is ${via.mode}.`);\n      }\n    };\n    for (const needed of recipe.requires) {\n      const demo = resolve(needed, [...trail, id]);\n      if (demo) consider(needed, demo);\n    }\n    for (const alternatives of recipe.requiresAny ?? []) {\n      const known = alternatives\n        .map((needed) => ({ needed, demo: resolve(needed, [...trail, id]) }))\n        .filter(\n          (entry): entry is { needed: string; demo: RecipeDemo } =>\n            entry.demo !== undefined,\n        );\n      if (known.length === 0) continue;\n      const best = known.reduce((a, b) =>\n        rank(b.demo.mode) < rank(a.demo.mode) ? b : a,\n      );\n      consider(best.needed, best.demo);\n    }\n    return {\n      mode,\n      reasons,\n      ...(recipe.demo.mocked ? { mocked: recipe.demo.mocked } : {}),\n    };\n  };\n\n  return resolve(recipeId, []);\n}\n"],"mappings":"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"}

package/dist/recipe.d.ts

@@ -23,6 +23,7 @@
  *   static models = [Order];
  *   static nav = [{ label: 'Sales Orders', model: Order }];
  *   static requires = ['commerce.customers'];
+ *   static section = { id: 'sales', label: 'Sales', icon: 'shoppingBag' };
  *   static options = {
  *     Order: { fields: { status: { default: 'draft', locked: true } } },
  *   };
@@ -30,7 +31,7 @@
  * }
  * ```
  */
-import type { RecipeExposureNarrowing, RecipeFieldOptions } from '@happyvertical/smrt-types';
+import type { RecipeDemoSeed, RecipeExposureNarrowing, RecipeFieldOptions, RecipeProvider, RecipeRuntime, RecipeSurface } from '@happyvertical/smrt-types';
 /**
  * A model class as a recipe references it. Any constructor qualifies; the
  * parameter list is `never[]` so models with required constructor options
@@ -41,6 +42,38 @@ export type SmrtRecipeModel = abstract new (...args: never[]) => object;
 export interface SmrtRecipeNavEntry {
     label: string;
     model: SmrtRecipeModel;
+    /** A shell icon name (`users`, `calendar`...) drawn on the entry's row. */
+    icon?: string;
+    /** One friendly line for a business owner, shown on the section card. */
+    description?: string;
+    /**
+     * Fixed key making the entry's layout id `item:<pkg>:<Model>:<key>`. Needed
+     * for a second entry over the same model, and for a `filter`.
+     */
+    key?: string;
+    /** What "New" creates when the label is not a countable noun. */
+    noun?: string;
+    /**
+     * Narrow the entry to rows whose `field` equals `value`; new rows from the
+     * view carry the value. Needs a `key`.
+     */
+    filter?: {
+        field: string;
+        value: string;
+    };
+}
+/** Recipes sharing a `group.id` share one card in a host. */
+export interface SmrtRecipeGroup {
+    id: string;
+    label: string;
+    summary?: string;
+}
+/** The navigation section a recipe suggests; same `id` shares a section. */
+export interface SmrtRecipeSection {
+    id: string;
+    label: string;
+    icon?: string;
+    description?: string;
 }
 /**
  * Curation hints for one model, keyed in `static options` by the model's class
@@ -70,6 +103,22 @@ export declare abstract class SmrtRecipe {
     static nav: readonly SmrtRecipeNavEntry[];
     /** Ids of recipes needed first; they may live in other packages. */
     static requires: readonly string[];
+    /**
+     * Alternatives: at least one id of each inner list must be on. Adding the
+     * recipe with none on adds the first of the list.
+     */
+    static requiresAny: readonly (readonly string[])[];
+    /**
+     * Card the recipe is a sub-switch of in a host such as an app shell. Recipes
+     * with the same `group.id` share it; the first declaration supplies the
+     * card's `label` and `summary`.
+     */
+    static group?: SmrtRecipeGroup;
+    /**
+     * Navigation section the recipe suggests its `nav` entries sit under. The
+     * host owns sections and the user may rename them, so keep `id` stable.
+     */
+    static section?: SmrtRecipeSection;
     /** Curation hints keyed by model class name. */
     static options: Readonly<Record<string, SmrtRecipeModelOptions>>;
     /**
@@ -79,5 +128,19 @@ export declare abstract class SmrtRecipe {
      * `renderHelp` for how a host follows the app's options.
      */
     static help?: string;
+    /**
+     * Non-model surfaces (#3708): shell widgets, routes, settings panels,
+     * playground entries and overview `widget`s (#3727, with an options schema,
+     * data needs and allowed overview ids). Components are referenced by
+     * `'<module specifier>#<ExportName>'`, never imported by the manifest.
+     * Write the array `as const` so literal kinds and slots survive.
+     */
+    static surfaces?: readonly RecipeSurface[];
+    /** Providers and secrets the recipe needs or can use (#3708). */
+    static providers?: readonly RecipeProvider[];
+    /** Where the recipe's runtime pieces can run; omitted means `both`. */
+    static runtime?: RecipeRuntime;
+    /** Demo fixture data: a fixture export or small inline JSON (#3708). */
+    static demoSeed?: RecipeDemoSeed;
 }
 //# sourceMappingURL=recipe.d.ts.map

package/dist/recipe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recipe.d.ts","sourceRoot":"","sources":["../src/recipe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAEnC;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,MAAM,CAAC;AAExE,iDAAiD;AACjD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,eAAe,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE;QACT,GAAG,CAAC,EAAE,uBAAuB,CAAC;QAC9B,GAAG,CAAC,EAAE,uBAAuB,CAAC;QAC9B,GAAG,CAAC,EAAE,uBAAuB,CAAC;KAC/B,CAAC;CACH;AAED,8BAAsB,UAAU;IAC9B,0EAA0E;IAC1E,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,MAAM,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAM;IACxC,yEAAyE;IACzE,MAAM,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC1C,sEAAsE;IACtE,MAAM,CAAC,GAAG,EAAE,SAAS,kBAAkB,EAAE,CAAM;IAC/C,oEAAoE;IACpE,MAAM,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAM;IACxC,gDAAgD;IAChD,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAM;IACtE;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"recipe.d.ts","sourceRoot":"","sources":["../src/recipe.ts"],"names":[],"mappings":"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"}

package/dist/recipe.js

@@ -14,6 +14,22 @@ var SmrtRecipe = class {
 	static nav = [];
 	/** Ids of recipes needed first; they may live in other packages. */
 	static requires = [];
+	/**
+	* Alternatives: at least one id of each inner list must be on. Adding the
+	* recipe with none on adds the first of the list.
+	*/
+	static requiresAny = [];
+	/**
+	* Card the recipe is a sub-switch of in a host such as an app shell. Recipes
+	* with the same `group.id` share it; the first declaration supplies the
+	* card's `label` and `summary`.
+	*/
+	static group;
+	/**
+	* Navigation section the recipe suggests its `nav` entries sit under. The
+	* host owns sections and the user may rename them, so keep `id` stable.
+	*/
+	static section;
 	/** Curation hints keyed by model class name. */
 	static options = {};
 	/**
@@ -23,6 +39,20 @@ var SmrtRecipe = class {
 	* `renderHelp` for how a host follows the app's options.
 	*/
 	static help;
+	/**
+	* Non-model surfaces (#3708): shell widgets, routes, settings panels,
+	* playground entries and overview `widget`s (#3727, with an options schema,
+	* data needs and allowed overview ids). Components are referenced by
+	* `'<module specifier>#<ExportName>'`, never imported by the manifest.
+	* Write the array `as const` so literal kinds and slots survive.
+	*/
+	static surfaces;
+	/** Providers and secrets the recipe needs or can use (#3708). */
+	static providers;
+	/** Where the recipe's runtime pieces can run; omitted means `both`. */
+	static runtime;
+	/** Demo fixture data: a fixture export or small inline JSON (#3708). */
+	static demoSeed;
 };
 //#endregion
 export { SmrtRecipe };

package/dist/recipe.js.map

@@ -1 +1 @@
-{"version":3,"file":"recipe.js","names":[],"sources":["../src/recipe.ts"],"sourcesContent":["/**\n * `SmrtRecipe` — a declared, user-facing unit of app functionality (#3590).\n *\n * A recipe is smaller than a package: \"Sales\" or \"Customers\", not all of\n * smrt-commerce. It names the models that make up the unit, the navigation\n * entries it contributes, the recipes it needs first, and curation hints for\n * how its models' forms present. It is declaration only: not persisted and not\n * `@smrt()`-decorated.\n *\n * Declare a recipe as a subclass with static properties, in the package that\n * owns the models. The scanner reads the statics at build time and emits them\n * as the top-level `recipes` array of `manifest.json` and\n * `smrt-knowledge.json`; nothing here runs at that point, so every static must\n * be spelled literally (model entries are class references).\n *\n * @example\n * ```typescript\n * export class SalesRecipe extends SmrtRecipe {\n *   static id = 'commerce.sales';\n *   static label = 'Sales';\n *   static summary = 'Take customer orders and track them.';\n *   static synonyms = ['sales orders', 'orders'];\n *   static models = [Order];\n *   static nav = [{ label: 'Sales Orders', model: Order }];\n *   static requires = ['commerce.customers'];\n *   static options = {\n *     Order: { fields: { status: { default: 'draft', locked: true } } },\n *   };\n *   static help = './sales.recipe.md';\n * }\n * ```\n */\n\nimport type {\n  RecipeExposureNarrowing,\n  RecipeFieldOptions,\n} from '@happyvertical/smrt-types';\n\n/**\n * A model class as a recipe references it. Any constructor qualifies; the\n * parameter list is `never[]` so models with required constructor options\n * remain assignable.\n */\nexport type SmrtRecipeModel = abstract new (...args: never[]) => object;\n\n/** One navigation entry a recipe contributes. */\nexport interface SmrtRecipeNavEntry {\n  label: string;\n  model: SmrtRecipeModel;\n}\n\n/**\n * Curation hints for one model, keyed in `static options` by the model's class\n * name. Hints only ever refine what the model already declares: they name its\n * existing fields and can narrow, never widen, its API/MCP/CLI exposure.\n */\nexport interface SmrtRecipeModelOptions {\n  fields?: Record<string, RecipeFieldOptions>;\n  exposure?: {\n    api?: RecipeExposureNarrowing;\n    mcp?: RecipeExposureNarrowing;\n    cli?: RecipeExposureNarrowing;\n  };\n}\n\nexport abstract class SmrtRecipe {\n  /** Stable dotted id, e.g. `commerce.sales`. Unique across all recipes. */\n  static id: string;\n  /** Display name, e.g. `Sales`. */\n  static label: string;\n  /** One sentence on what the unit gives the user. */\n  static summary: string;\n  /** Other words someone might use to ask for it. */\n  static synonyms: readonly string[] = [];\n  /** Models the unit brings. They must belong to the declaring package. */\n  static models: readonly SmrtRecipeModel[];\n  /** Navigation entries; each model must also be listed in `models`. */\n  static nav: readonly SmrtRecipeNavEntry[] = [];\n  /** Ids of recipes needed first; they may live in other packages. */\n  static requires: readonly string[] = [];\n  /** Curation hints keyed by model class name. */\n  static options: Readonly<Record<string, SmrtRecipeModelOptions>> = {};\n  /**\n   * Optional user-facing help (#3591): a path to a Markdown file beside the\n   * recipe, such as `./sales.recipe.md`. The scanner reads it at build time and\n   * embeds `{ markdown, fieldRefs }` in the recipe's manifest entry. See\n   * `renderHelp` for how a host follows the app's options.\n   */\n  static help?: string;\n}\n"],"mappings":";AAiEA,IAAsB,aAAtB,MAAiC;;CAE/B,OAAO;;CAEP,OAAO;;CAEP,OAAO;;CAEP,OAAO,WAA8B,CAAC;;CAEtC,OAAO;;CAEP,OAAO,MAAqC,CAAC;;CAE7C,OAAO,WAA8B,CAAC;;CAEtC,OAAO,UAA4D,CAAC;;;;;;;CAOpE,OAAO;AACT"}
+{"version":3,"file":"recipe.js","names":[],"sources":["../src/recipe.ts"],"sourcesContent":["/**\n * `SmrtRecipe` — a declared, user-facing unit of app functionality (#3590).\n *\n * A recipe is smaller than a package: \"Sales\" or \"Customers\", not all of\n * smrt-commerce. It names the models that make up the unit, the navigation\n * entries it contributes, the recipes it needs first, and curation hints for\n * how its models' forms present. It is declaration only: not persisted and not\n * `@smrt()`-decorated.\n *\n * Declare a recipe as a subclass with static properties, in the package that\n * owns the models. The scanner reads the statics at build time and emits them\n * as the top-level `recipes` array of `manifest.json` and\n * `smrt-knowledge.json`; nothing here runs at that point, so every static must\n * be spelled literally (model entries are class references).\n *\n * @example\n * ```typescript\n * export class SalesRecipe extends SmrtRecipe {\n *   static id = 'commerce.sales';\n *   static label = 'Sales';\n *   static summary = 'Take customer orders and track them.';\n *   static synonyms = ['sales orders', 'orders'];\n *   static models = [Order];\n *   static nav = [{ label: 'Sales Orders', model: Order }];\n *   static requires = ['commerce.customers'];\n *   static section = { id: 'sales', label: 'Sales', icon: 'shoppingBag' };\n *   static options = {\n *     Order: { fields: { status: { default: 'draft', locked: true } } },\n *   };\n *   static help = './sales.recipe.md';\n * }\n * ```\n */\n\nimport type {\n  RecipeDemoSeed,\n  RecipeExposureNarrowing,\n  RecipeFieldOptions,\n  RecipeProvider,\n  RecipeRuntime,\n  RecipeSurface,\n} from '@happyvertical/smrt-types';\n\n/**\n * A model class as a recipe references it. Any constructor qualifies; the\n * parameter list is `never[]` so models with required constructor options\n * remain assignable.\n */\nexport type SmrtRecipeModel = abstract new (...args: never[]) => object;\n\n/** One navigation entry a recipe contributes. */\nexport interface SmrtRecipeNavEntry {\n  label: string;\n  model: SmrtRecipeModel;\n  /** A shell icon name (`users`, `calendar`...) drawn on the entry's row. */\n  icon?: string;\n  /** One friendly line for a business owner, shown on the section card. */\n  description?: string;\n  /**\n   * Fixed key making the entry's layout id `item:<pkg>:<Model>:<key>`. Needed\n   * for a second entry over the same model, and for a `filter`.\n   */\n  key?: string;\n  /** What \"New\" creates when the label is not a countable noun. */\n  noun?: string;\n  /**\n   * Narrow the entry to rows whose `field` equals `value`; new rows from the\n   * view carry the value. Needs a `key`.\n   */\n  filter?: { field: string; value: string };\n}\n\n/** Recipes sharing a `group.id` share one card in a host. */\nexport interface SmrtRecipeGroup {\n  id: string;\n  label: string;\n  summary?: string;\n}\n\n/** The navigation section a recipe suggests; same `id` shares a section. */\nexport interface SmrtRecipeSection {\n  id: string;\n  label: string;\n  icon?: string;\n  description?: string;\n}\n\n/**\n * Curation hints for one model, keyed in `static options` by the model's class\n * name. Hints only ever refine what the model already declares: they name its\n * existing fields and can narrow, never widen, its API/MCP/CLI exposure.\n */\nexport interface SmrtRecipeModelOptions {\n  fields?: Record<string, RecipeFieldOptions>;\n  exposure?: {\n    api?: RecipeExposureNarrowing;\n    mcp?: RecipeExposureNarrowing;\n    cli?: RecipeExposureNarrowing;\n  };\n}\n\nexport abstract class SmrtRecipe {\n  /** Stable dotted id, e.g. `commerce.sales`. Unique across all recipes. */\n  static id: string;\n  /** Display name, e.g. `Sales`. */\n  static label: string;\n  /** One sentence on what the unit gives the user. */\n  static summary: string;\n  /** Other words someone might use to ask for it. */\n  static synonyms: readonly string[] = [];\n  /** Models the unit brings. They must belong to the declaring package. */\n  static models: readonly SmrtRecipeModel[];\n  /** Navigation entries; each model must also be listed in `models`. */\n  static nav: readonly SmrtRecipeNavEntry[] = [];\n  /** Ids of recipes needed first; they may live in other packages. */\n  static requires: readonly string[] = [];\n  /**\n   * Alternatives: at least one id of each inner list must be on. Adding the\n   * recipe with none on adds the first of the list.\n   */\n  static requiresAny: readonly (readonly string[])[] = [];\n  /**\n   * Card the recipe is a sub-switch of in a host such as an app shell. Recipes\n   * with the same `group.id` share it; the first declaration supplies the\n   * card's `label` and `summary`.\n   */\n  static group?: SmrtRecipeGroup;\n  /**\n   * Navigation section the recipe suggests its `nav` entries sit under. The\n   * host owns sections and the user may rename them, so keep `id` stable.\n   */\n  static section?: SmrtRecipeSection;\n  /** Curation hints keyed by model class name. */\n  static options: Readonly<Record<string, SmrtRecipeModelOptions>> = {};\n  /**\n   * Optional user-facing help (#3591): a path to a Markdown file beside the\n   * recipe, such as `./sales.recipe.md`. The scanner reads it at build time and\n   * embeds `{ markdown, fieldRefs }` in the recipe's manifest entry. See\n   * `renderHelp` for how a host follows the app's options.\n   */\n  static help?: string;\n  /**\n   * Non-model surfaces (#3708): shell widgets, routes, settings panels,\n   * playground entries and overview `widget`s (#3727, with an options schema,\n   * data needs and allowed overview ids). Components are referenced by\n   * `'<module specifier>#<ExportName>'`, never imported by the manifest.\n   * Write the array `as const` so literal kinds and slots survive.\n   */\n  static surfaces?: readonly RecipeSurface[];\n  /** Providers and secrets the recipe needs or can use (#3708). */\n  static providers?: readonly RecipeProvider[];\n  /** Where the recipe's runtime pieces can run; omitted means `both`. */\n  static runtime?: RecipeRuntime;\n  /** Demo fixture data: a fixture export or small inline JSON (#3708). */\n  static demoSeed?: RecipeDemoSeed;\n}\n"],"mappings":";AAqGA,IAAsB,aAAtB,MAAiC;;CAE/B,OAAO;;CAEP,OAAO;;CAEP,OAAO;;CAEP,OAAO,WAA8B,CAAC;;CAEtC,OAAO;;CAEP,OAAO,MAAqC,CAAC;;CAE7C,OAAO,WAA8B,CAAC;;;;;CAKtC,OAAO,cAA8C,CAAC;;;;;;CAMtD,OAAO;;;;;CAKP,OAAO;;CAEP,OAAO,UAA4D,CAAC;;;;;;;CAOpE,OAAO;;;;;;;;CAQP,OAAO;;CAEP,OAAO;;CAEP,OAAO;;CAEP,OAAO;AACT"}

package/dist/registry/class-registration.js

@@ -4,9 +4,9 @@ import { declareChangeFeedSensitiveTable, setChangeFeedSensitiveClassResolver }
 import { tableNameFromClass } from "../utils.js";
 import { bumpRegistryGeneration } from "./generation.js";
 import { createQualifiedName, isQualifiedName, parseQualifiedName } from "../utils/qualified-names.js";
-import { getClasses, getCollections, getConstructorFieldDecorators, getConstructorIndex, getConstructorTenantScopedDeclarations, getInheritanceCache, getLegacyFieldDecorators, getSourceFileFromStack, getStampedPackageName, getStiSiblingsLoaded, verboseLog } from "./shared-state.js";
 import { cloneManifestSchemaColumns, findWorkspaceRootSync, getLocalTestManifestCache, getManifestCache, getNodeBuiltins, getStaticManifestCache, getTestManifestCache, packageStampsConstructors } from "../manifest/store.js";
 import { discoverManifestSync, discoverSTISiblingsSync, getPackageName, lookupInManifest, readProjectManifestSync } from "../manifest/manifest-loader.js";
+import { getClasses, getCollections, getConstructorFieldDecorators, getConstructorIndex, getConstructorTenantScopedDeclarations, getInheritanceCache, getLegacyFieldDecorators, getSourceFileFromStack, getStampedPackageName, getStiSiblingsLoaded, verboseLog } from "./shared-state.js";
 import { assertQualifiedNameAliasesAvailable } from "./qualified-name-aliases.js";
 import { findClass, findClassesByName, getCanonicalClassName, hasClassCaseInsensitive, qualifyExtendsName } from "./name-resolver.js";
 import { buildInheritanceChain } from "./inheritance-resolver.js";
@@ -887,7 +887,7 @@ function registerUntracked(ctor, config = {}) {
 		validators,
 		validationRules,
 		tools: manifestEntry?.tools,
-		collection: config.collection ?? manifestEntry?.collection ?? inheritedStiCollection(ctor) ?? pluralizeCollection(name),
+		collection: mergedConfig.collection ?? manifestEntry?.collection ?? inheritedStiCollection(ctor) ?? pluralizeCollection(name),
 		collectionConstructor: promotedCollectionConstructor,
 		replacedQualifiedNames: promotedReplacementAncestry,
 		packageName,