@happyvertical/smrt-svelte 0.55.10 → 0.55.11

package/dist/components/cookbook/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @happyvertical/smrt-svelte/cookbook
+ *
+ * A cookbook-driven app shell (#3749): `buildCookbookShell` turns a cookbook
+ * plus a recipe catalog into `AppShell` configuration (sections, entries,
+ * layout, theme, section overviews, recipe surfaces); `CookbookApp` renders it
+ * and `CookbookSectionPage` is a section's own page. Browser-safe: use
+ * `@happyvertical/smrt-svelte/cookbook/server` to load the cookbook and the
+ * installed packages' manifests in a `+layout.server.ts`.
+ */
+export { applyCookbookTheme } from './brand-theme.js';
+export { buildCookbookShell, humanize, pluralize } from './build.js';
+export { default as CookbookApp } from './CookbookApp.svelte';
+export { default as CookbookSectionPage } from './CookbookSectionPage.svelte';
+export { type CookbookManifest, catalogFromManifests, narrowCatalog, packageIdOf, } from './catalog.js';
+export { type CookbookContext, getCookbookContext, tryGetCookbookContext, } from './context.js';
+export { type CookbookOverviewStore, createSectionOverview, loadSectionWidget, } from './page.js';
+export { type CookbookRegistry, type CookbookRegistryOptions, type CookbookWidgetContext, createCookbookRegistry, loadShortcuts, } from './registry.js';
+export { buildNavSections, DEFAULT_ENTRY_ICON, DEFAULT_SECTION_ICON, defaultEntryPath, defaultSectionPath, FEATURE_SECTION, navItemId, navSectionOf, sectionIdFromSlug, sectionLayoutId, sectionSlug, } from './sections.js';
+export { brandThemeId, DEFAULT_COLOR_SCHEME, DEFAULT_THEME_PRESET, normalizeHex, resolveCookbookTheme, THEME_FONTS, } from './theme.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/cookbook/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/cookbook/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EACL,KAAK,gBAAgB,EACrB,oBAAoB,EACpB,aAAa,EACb,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,KAAK,eAAe,EACpB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,KAAK,qBAAqB,EAC1B,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,sBAAsB,EACtB,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,mBAAmB,YAAY,CAAC"}

package/dist/components/cookbook/index.js

@@ -0,0 +1,20 @@
+/**
+ * @happyvertical/smrt-svelte/cookbook
+ *
+ * A cookbook-driven app shell (#3749): `buildCookbookShell` turns a cookbook
+ * plus a recipe catalog into `AppShell` configuration (sections, entries,
+ * layout, theme, section overviews, recipe surfaces); `CookbookApp` renders it
+ * and `CookbookSectionPage` is a section's own page. Browser-safe: use
+ * `@happyvertical/smrt-svelte/cookbook/server` to load the cookbook and the
+ * installed packages' manifests in a `+layout.server.ts`.
+ */
+export { applyCookbookTheme } from './brand-theme.js';
+export { buildCookbookShell, humanize, pluralize } from './build.js';
+export { default as CookbookApp } from './CookbookApp.svelte';
+export { default as CookbookSectionPage } from './CookbookSectionPage.svelte';
+export { catalogFromManifests, narrowCatalog, packageIdOf, } from './catalog.js';
+export { getCookbookContext, tryGetCookbookContext, } from './context.js';
+export { createSectionOverview, loadSectionWidget, } from './page.js';
+export { createCookbookRegistry, loadShortcuts, } from './registry.js';
+export { buildNavSections, DEFAULT_ENTRY_ICON, DEFAULT_SECTION_ICON, defaultEntryPath, defaultSectionPath, FEATURE_SECTION, navItemId, navSectionOf, sectionIdFromSlug, sectionLayoutId, sectionSlug, } from './sections.js';
+export { brandThemeId, DEFAULT_COLOR_SCHEME, DEFAULT_THEME_PRESET, normalizeHex, resolveCookbookTheme, THEME_FONTS, } from './theme.js';

package/dist/components/cookbook/page.d.ts

@@ -0,0 +1,23 @@
+/**
+ * How a section page wires its overview to the cookbook (#3749): the
+ * controller reads the page's stored override and writes every edit back, so
+ * the cookbook is the single source of truth. Ported from smrt-planner's
+ * `overviews/page.ts`.
+ */
+import { type OverviewController } from '../overview/controller.svelte.js';
+import type { WidgetRegistry } from '../overview/registry.js';
+import type { OverviewDefinition, OverviewOverride, OverviewWidget } from '../overview/types.js';
+/** The part of the app an overview reads and writes. */
+export interface CookbookOverviewStore {
+    overview(id: string): unknown;
+    setOverview(id: string, override: OverviewOverride | null): void;
+}
+/**
+ * One widget's data through the same sanitize-and-load path (timeout,
+ * serializable check) as a page load. A failed load throws, which the grid
+ * shows as that widget's error tile.
+ */
+export declare function loadSectionWidget(definition: OverviewDefinition, registry: WidgetRegistry, context: Record<string, unknown>, widget: OverviewWidget, signal?: AbortSignal): Promise<unknown>;
+/** The controller of a section's overview, persisted through `store`. */
+export declare function createSectionOverview(definition: OverviewDefinition, registry: WidgetRegistry, store: CookbookOverviewStore, context: () => Record<string, unknown>): OverviewController;
+//# sourceMappingURL=page.d.ts.map

package/dist/components/cookbook/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../../src/components/cookbook/page.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,wDAAwD;AACxD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAAC;CAClE;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED,yEAAyE;AACzE,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,kBAAkB,CAUpB"}

package/dist/components/cookbook/page.js

@@ -0,0 +1,32 @@
+/**
+ * How a section page wires its overview to the cookbook (#3749): the
+ * controller reads the page's stored override and writes every edit back, so
+ * the cookbook is the single source of truth. Ported from smrt-planner's
+ * `overviews/page.ts`.
+ */
+import { createOverview, } from '../overview/controller.svelte.js';
+import { loadOverview } from '../overview/load.js';
+/**
+ * One widget's data through the same sanitize-and-load path (timeout,
+ * serializable check) as a page load. A failed load throws, which the grid
+ * shows as that widget's error tile.
+ */
+export async function loadSectionWidget(definition, registry, context, widget, signal) {
+    const loaded = await loadOverview({ widgets: [widget] }, definition, registry, { ...context, signal, locale: 'en-US' });
+    const result = loaded.widgets[0];
+    if (!result || result.status === 'error') {
+        throw new Error(result?.error?.code ?? 'load_failed');
+    }
+    return result.data;
+}
+/** The controller of a section's overview, persisted through `store`. */
+export function createSectionOverview(definition, registry, store, context) {
+    const id = definition.id;
+    return createOverview({
+        definition,
+        registry,
+        override: () => store.overview(id),
+        onchange: (override) => store.setOverview(id, override),
+        loadWidget: (widget, signal) => loadSectionWidget(definition, registry, context(), widget, signal),
+    });
+}

package/dist/components/cookbook/registry.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The widget registry of a cookbook app's section pages (#3749): the core
+ * widgets (a shortcuts loader that reads the shell's resolved sections, plus
+ * whatever data loaders the host injects) and the recipes' `widget` surfaces.
+ */
+import { type RecipeExportResolver, type RecipeWidgetRegistration, type RecipeWidgetSource } from '../overview/recipe-widgets.js';
+import { type WidgetRegistry } from '../overview/registry.js';
+import type { WidgetLoadContext } from '../overview/types.js';
+import { type CoreWidgetLoaders } from '../overview/widgets/core.js';
+import { type ShortcutNavSection, type ShortcutsWidgetData } from '../overview/widgets/data.js';
+/** What a section page hands its widgets' loaders besides the host's own context. */
+export interface CookbookWidgetContext {
+    /** The shell's resolved sections (renames, hides and moves applied). */
+    sections: readonly ShortcutNavSection[];
+}
+/**
+ * `shortcuts`: the section's menu entries as cards, as the shell resolves
+ * them. `section` names another section by its id without the `section:` /
+ * `custom:` prefix; absent, the overview's own section.
+ */
+export declare function loadShortcuts(options: Record<string, unknown>, ctx: WidgetLoadContext): ShortcutsWidgetData;
+export interface CookbookRegistryOptions {
+    /** Data loaders for `metric`, `records` and `chart` (omitted ones are not registered). */
+    loaders?: Omit<CoreWidgetLoaders, 'shortcuts'>;
+    /** Recipes whose `widget` surfaces to register. */
+    widgets?: readonly RecipeWidgetSource[];
+    /** The host's module resolver for recipe exports. */
+    resolveExport?: RecipeExportResolver;
+}
+export interface CookbookRegistry {
+    registry: WidgetRegistry;
+    /** Recipe widgets registered or skipped, for diagnostics. */
+    recipeWidgets: RecipeWidgetRegistration | null;
+}
+/** An isolated registry for one cookbook app. */
+export declare function createCookbookRegistry(options?: CookbookRegistryOptions): Promise<CookbookRegistry>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/components/cookbook/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/components/cookbook/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EAExB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAEzB,MAAM,6BAA6B,CAAC;AAErC,qFAAqF;AACrF,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACzC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,GAAG,EAAE,iBAAiB,GACrB,mBAAmB,CAYrB;AAED,MAAM,WAAW,uBAAuB;IACtC,0FAA0F;IAC1F,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;IAC/C,mDAAmD;IACnD,OAAO,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,qDAAqD;IACrD,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,cAAc,CAAC;IACzB,6DAA6D;IAC7D,aAAa,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAChD;AAED,iDAAiD;AACjD,wBAAsB,sBAAsB,CAC1C,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,gBAAgB,CAAC,CAe3B"}

package/dist/components/cookbook/registry.js

@@ -0,0 +1,38 @@
+/**
+ * The widget registry of a cookbook app's section pages (#3749): the core
+ * widgets (a shortcuts loader that reads the shell's resolved sections, plus
+ * whatever data loaders the host injects) and the recipes' `widget` surfaces.
+ */
+import { registerRecipeWidgets, } from '../overview/recipe-widgets.js';
+import { createWidgetRegistry, } from '../overview/registry.js';
+import { registerCoreWidgets, } from '../overview/widgets/core.js';
+import { shortcutsFromNav, } from '../overview/widgets/data.js';
+/**
+ * `shortcuts`: the section's menu entries as cards, as the shell resolves
+ * them. `section` names another section by its id without the `section:` /
+ * `custom:` prefix; absent, the overview's own section.
+ */
+export function loadShortcuts(options, ctx) {
+    const { sections } = ctx;
+    if (!sections)
+        throw new Error('the cookbook widget context is missing');
+    const named = typeof options.section === 'string' ? options.section : '';
+    const sectionId = named
+        ? sections.find((s) => s.id === `section:${named}` || s.id === `custom:${named}`)?.id
+        : ctx.overviewId;
+    if (!sectionId)
+        throw new Error(`unknown section ${named}`);
+    return shortcutsFromNav(sections, sectionId);
+}
+/** An isolated registry for one cookbook app. */
+export async function createCookbookRegistry(options = {}) {
+    const registry = createWidgetRegistry();
+    registerCoreWidgets(registry, {
+        ...options.loaders,
+        shortcuts: loadShortcuts,
+    });
+    const recipeWidgets = options.widgets && options.widgets.length > 0 && options.resolveExport
+        ? await registerRecipeWidgets(registry, options.widgets, options.resolveExport)
+        : null;
+    return { registry, recipeWidgets };
+}

package/dist/components/cookbook/sections.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Navigation sections and entry ids (#3749), ported from smrt-planner's
+ * `recipes/sections.ts` so a generated app and the planner derive the same
+ * ids: a saved layout names them, so they must stay stable.
+ */
+import type { RecipeSection } from '@happyvertical/smrt-types';
+import type { CookbookRecipe } from './types.js';
+/** The section that holds feature models no recipe covers. */
+export declare const FEATURE_SECTION: RecipeSection;
+/** Icon of an entry whose recipe names none, and of feature entries. */
+export declare const DEFAULT_ENTRY_ICON = "fileText";
+/** The icon of a section the user made, or one the host knows nothing of. */
+export declare const DEFAULT_SECTION_ICON = "folder";
+/** The id of the group (or recipe) a recipe belongs to. */
+export declare function groupId(recipe: Pick<CookbookRecipe, 'id' | 'group'>): string;
+/**
+ * The nav section a recipe's entries sit under by default: the section it
+ * suggests, else its group, else the recipe itself.
+ */
+export declare function navSectionOf(recipe: CookbookRecipe): RecipeSection;
+export type NavSectionGroup = RecipeSection & {
+    recipes: CookbookRecipe[];
+};
+/** Nav sections of the given recipes, in the order their first recipe comes. */
+export declare function buildNavSections(recipes: readonly CookbookRecipe[]): NavSectionGroup[];
+/**
+ * The stable layout id of a navigation item: `item:<package>:<Model>`, or
+ * `item:<package>:<Model>:<key>` when a model appears twice in the nav and the
+ * extra entry declares a fixed `key`. It never names the section, the label or
+ * the href, so renaming an entry or moving a recipe's section leaves a saved
+ * layout valid.
+ */
+export declare function navItemId(packageId: string, modelName: string, key?: string): string;
+/** `section:<id>` for a recipe-suggested section. */
+export declare function sectionLayoutId(id: string): string;
+/**
+ * A section page lives at `/s/<slug>/`. The slug is the layout id with its
+ * `kind:` prefix turned into `kind-` (`section:sales` -> `section-sales`), so
+ * no path segment holds a colon. Only the first colon is the prefix.
+ */
+export declare function sectionSlug(id: string): string;
+/** The layout id a slug names; the inverse of {@link sectionSlug}. */
+export declare function sectionIdFromSlug(slug: string): string;
+/** Default in-app path of a section page. */
+export declare function defaultSectionPath(id: string): string;
+/** Default in-app path of a model entry: `/m/<pkg>/<Model>/[<key>/]`. */
+export declare function defaultEntryPath(entry: {
+    packageId: string;
+    modelName: string;
+    key?: string;
+}): string;
+/**
+ * The line under an entry on its section card: the recipe's own text first,
+ * then the model's description, then a plain fallback.
+ */
+export declare function entryDescription(own: string | undefined, model: {
+    description?: string;
+    name: string;
+}): string;
+//# sourceMappingURL=sections.d.ts.map

package/dist/components/cookbook/sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.d.ts","sourceRoot":"","sources":["../../../src/components/cookbook/sections.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,8DAA8D;AAC9D,eAAO,MAAM,eAAe,EAAE,aAK7B,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,aAAa,CAAC;AAE7C,6EAA6E;AAC7E,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAE7C,2DAA2D;AAC3D,wBAAgB,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,OAAO,CAAC,GAAG,MAAM,CAE5E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,CAOlE;AAED,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG;IAAE,OAAO,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC;AAE5E,gFAAgF;AAChF,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,cAAc,EAAE,GACjC,eAAe,EAAE,CAanB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAER;AAED,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,6CAA6C;AAC7C,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAET;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,KAAK,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5C,MAAM,CAMR"}

package/dist/components/cookbook/sections.js

@@ -0,0 +1,88 @@
+/** The section that holds feature models no recipe covers. */
+export const FEATURE_SECTION = {
+    id: 'more',
+    label: 'More',
+    icon: 'layers',
+    description: 'Extra records you added one at a time.',
+};
+/** Icon of an entry whose recipe names none, and of feature entries. */
+export const DEFAULT_ENTRY_ICON = 'fileText';
+/** The icon of a section the user made, or one the host knows nothing of. */
+export const DEFAULT_SECTION_ICON = 'folder';
+/** The id of the group (or recipe) a recipe belongs to. */
+export function groupId(recipe) {
+    return recipe.group?.id ?? recipe.id;
+}
+/**
+ * The nav section a recipe's entries sit under by default: the section it
+ * suggests, else its group, else the recipe itself.
+ */
+export function navSectionOf(recipe) {
+    return (recipe.section ?? {
+        id: groupId(recipe),
+        label: recipe.group?.label ?? recipe.label,
+    });
+}
+/** Nav sections of the given recipes, in the order their first recipe comes. */
+export function buildNavSections(recipes) {
+    const out = new Map();
+    for (const recipe of recipes) {
+        const nav = navSectionOf(recipe);
+        const existing = out.get(nav.id);
+        if (existing) {
+            existing.recipes.push(recipe);
+            // The first recipe supplies the label; a later one may add what is missing.
+            existing.icon ??= nav.icon;
+            existing.description ??= nav.description;
+        }
+        else
+            out.set(nav.id, { ...nav, recipes: [recipe] });
+    }
+    return [...out.values()];
+}
+/**
+ * The stable layout id of a navigation item: `item:<package>:<Model>`, or
+ * `item:<package>:<Model>:<key>` when a model appears twice in the nav and the
+ * extra entry declares a fixed `key`. It never names the section, the label or
+ * the href, so renaming an entry or moving a recipe's section leaves a saved
+ * layout valid.
+ */
+export function navItemId(packageId, modelName, key) {
+    return `item:${packageId}:${modelName}${key ? `:${key}` : ''}`;
+}
+/** `section:<id>` for a recipe-suggested section. */
+export function sectionLayoutId(id) {
+    return `section:${id}`;
+}
+/**
+ * A section page lives at `/s/<slug>/`. The slug is the layout id with its
+ * `kind:` prefix turned into `kind-` (`section:sales` -> `section-sales`), so
+ * no path segment holds a colon. Only the first colon is the prefix.
+ */
+export function sectionSlug(id) {
+    return id.replace(':', '-');
+}
+/** The layout id a slug names; the inverse of {@link sectionSlug}. */
+export function sectionIdFromSlug(slug) {
+    return slug.replace('-', ':');
+}
+/** Default in-app path of a section page. */
+export function defaultSectionPath(id) {
+    return `/s/${sectionSlug(id)}/`;
+}
+/** Default in-app path of a model entry: `/m/<pkg>/<Model>/[<key>/]`. */
+export function defaultEntryPath(entry) {
+    return `/m/${entry.packageId}/${entry.modelName}/${entry.key ? `${entry.key}/` : ''}`;
+}
+function humanizeName(name) {
+    return name.replace(/([a-z0-9])([A-Z])/g, '$1 $2').toLowerCase();
+}
+/**
+ * The line under an entry on its section card: the recipe's own text first,
+ * then the model's description, then a plain fallback.
+ */
+export function entryDescription(own, model) {
+    return (own?.trim() ||
+        model.description?.trim() ||
+        `Your ${humanizeName(model.name)} records, all in one place.`);
+}

package/dist/components/cookbook/server.d.ts

@@ -0,0 +1,61 @@
+import type { Cookbook } from '@happyvertical/smrt-types';
+import { type CookbookManifest } from './catalog.js';
+import type { CookbookCatalog } from './types.js';
+export { buildCookbookShell } from './build.js';
+export { type CookbookManifest, catalogFromManifests, narrowCatalog, packageIdOf, } from './catalog.js';
+export { resolveCookbookTheme } from './theme.js';
+export type * from './types.js';
+export declare const COOKBOOK_FILE = "smrt.cookbook.json";
+/** The result of validating a cookbook document (`validateCookbook` in smrt-core). */
+export type CookbookValidation = {
+    ok: true;
+    cookbook: Cookbook;
+    warnings?: string[];
+} | {
+    ok: false;
+    errors: string[];
+};
+export type CookbookValidator = (document: unknown, options?: {
+    recipes?: Iterable<string>;
+}) => CookbookValidation;
+/** What `+layout.server.ts` returns and `CookbookApp` takes. Plain JSON. */
+export interface CookbookAppData {
+    cookbook: Cookbook;
+    /** Only the recipes and models the cookbook uses. */
+    catalog: CookbookCatalog;
+    /** The validator's warnings. */
+    warnings: string[];
+}
+export interface LoadCookbookAppOptions {
+    /** Project root; default `process.cwd()`. */
+    root?: string;
+    /** Cookbook file relative to `root`; default {@link COOKBOOK_FILE}. */
+    file?: string;
+    /**
+     * Packages whose `manifest.json` to read. Default: every dependency of the
+     * project's `package.json` that exports `./manifest.json`.
+     */
+    packages?: readonly string[];
+    /**
+     * The validator. Default: `validateCookbook` from
+     * `@happyvertical/smrt-core/cookbook`, which the app depends on.
+     */
+    validate?: CookbookValidator;
+}
+/**
+ * Read a package's `manifest.json` through its `./manifest.json` (or
+ * `./manifest`) export; `null` when the package has none or is not installed.
+ */
+export declare function readInstalledManifest(root: string, packageName: string): Promise<CookbookManifest | null>;
+/** Read the manifests of `packages`, skipping those that have none. */
+export declare function readInstalledManifests(root: string, packages?: readonly string[]): Promise<CookbookManifest[]>;
+/**
+ * Load and validate the project's cookbook and resolve it against the
+ * installed packages' recipes. Throws when the cookbook is missing or invalid
+ * (the message lists every problem), including a recipe no installed package
+ * declares.
+ */
+export declare function loadCookbookApp(options?: LoadCookbookAppOptions): Promise<CookbookAppData>;
+/** Whether `root` has a cookbook file (for apps that fall back to a plain shell). */
+export declare function hasCookbook(root?: string, file?: string): Promise<boolean>;
+//# sourceMappingURL=server.d.ts.map

package/dist/components/cookbook/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/components/cookbook/server.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EACL,KAAK,gBAAgB,EAGtB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EACL,KAAK,gBAAgB,EACrB,oBAAoB,EACpB,aAAa,EACb,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,mBAAmB,YAAY,CAAC;AAEhC,eAAO,MAAM,aAAa,uBAAuB,CAAC;AAElD,sFAAsF;AACtF,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACrD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEpC,MAAM,MAAM,iBAAiB,GAAG,CAC9B,QAAQ,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;CAAE,KACrC,kBAAkB,CAAC;AAExB,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,QAAQ,CAAC;IACnB,qDAAqD;IACrD,OAAO,EAAE,eAAe,CAAC;IACzB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AA8BD;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAclC;AAED,uEAAuE;AACvE,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAC3B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAM7B;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,eAAe,CAAC,CAgC1B;AAED,qFAAqF;AACrF,wBAAsB,WAAW,CAC/B,IAAI,GAAE,MAAsB,EAC5B,IAAI,GAAE,MAAsB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAOlB"}

package/dist/components/cookbook/server.js

@@ -0,0 +1,108 @@
+/**
+ * @happyvertical/smrt-svelte/cookbook/server
+ *
+ * Node-only loading for a cookbook app's `+layout.server.ts` (#3749): read and
+ * validate `smrt.cookbook.json`, read the installed packages' manifests and
+ * return the plain-JSON data `CookbookApp` takes. Also re-exports the pure,
+ * Svelte-free builder so a server can derive the shell without a DOM.
+ */
+import { access, readFile } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { join, resolve } from 'node:path';
+import { catalogFromManifests, narrowCatalog, } from './catalog.js';
+export { buildCookbookShell } from './build.js';
+export { catalogFromManifests, narrowCatalog, packageIdOf, } from './catalog.js';
+export { resolveCookbookTheme } from './theme.js';
+export const COOKBOOK_FILE = 'smrt.cookbook.json';
+async function readJson(path) {
+    return JSON.parse(await readFile(path, 'utf8'));
+}
+async function defaultValidator() {
+    try {
+        const mod = (await import(
+        /* @vite-ignore */ '@happyvertical/smrt-core/cookbook'));
+        return mod.validateCookbook;
+    }
+    catch (error) {
+        throw new Error('loadCookbookApp needs @happyvertical/smrt-core (it validates the ' +
+            'cookbook); install it or pass `validate`. ' +
+            (error instanceof Error ? error.message : String(error)));
+    }
+}
+/** Dependencies of the project that publish a manifest. */
+async function manifestPackages(root) {
+    const pkg = (await readJson(join(root, 'package.json')));
+    return Object.keys({ ...pkg.dependencies, ...pkg.devDependencies }).sort();
+}
+/**
+ * Read a package's `manifest.json` through its `./manifest.json` (or
+ * `./manifest`) export; `null` when the package has none or is not installed.
+ */
+export async function readInstalledManifest(root, packageName) {
+    const require = createRequire(join(resolve(root), 'package.json'));
+    for (const subpath of ['manifest.json', 'manifest']) {
+        try {
+            const path = require.resolve(`${packageName}/${subpath}`);
+            const manifest = (await readJson(path));
+            if (manifest && typeof manifest === 'object' && manifest.packageName) {
+                return manifest;
+            }
+        }
+        catch {
+            // Not exported or not installed: try the next subpath.
+        }
+    }
+    return null;
+}
+/** Read the manifests of `packages`, skipping those that have none. */
+export async function readInstalledManifests(root, packages) {
+    const names = packages ?? (await manifestPackages(root));
+    const found = await Promise.all(names.map((name) => readInstalledManifest(root, name)));
+    return found.filter((m) => m !== null);
+}
+/**
+ * Load and validate the project's cookbook and resolve it against the
+ * installed packages' recipes. Throws when the cookbook is missing or invalid
+ * (the message lists every problem), including a recipe no installed package
+ * declares.
+ */
+export async function loadCookbookApp(options = {}) {
+    const root = resolve(options.root ?? process.cwd());
+    const file = options.file ?? COOKBOOK_FILE;
+    const validate = options.validate ?? (await defaultValidator());
+    let document;
+    try {
+        document = await readJson(join(root, file));
+    }
+    catch (error) {
+        throw new Error(`Cannot read ${file}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const manifests = await readInstalledManifests(root, options.packages);
+    const full = catalogFromManifests(manifests);
+    const result = validate(document, {
+        recipes: full.recipes.map((r) => r.id),
+    });
+    if (!result.ok) {
+        throw new Error(`${file} is not a valid cookbook:\n- ${result.errors.join('\n- ')}`);
+    }
+    const { cookbook } = result;
+    const warnings = [...(result.warnings ?? [])];
+    return {
+        cookbook,
+        catalog: narrowCatalog(full, {
+            recipes: cookbook.recipes,
+            features: cookbook.features ?? [],
+        }),
+        warnings,
+    };
+}
+/** Whether `root` has a cookbook file (for apps that fall back to a plain shell). */
+export async function hasCookbook(root = process.cwd(), file = COOKBOOK_FILE) {
+    try {
+        await access(join(resolve(root), file));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/components/cookbook/theme.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The cookbook's `theme` as the shell applies it (#3749). Pure: registering a
+ * brand colour with smrt-ui is the component's job (`brand-theme.ts`).
+ */
+import type { CookbookTheme } from '@happyvertical/smrt-types';
+import type { ResolvedCookbookTheme } from './types.js';
+export declare const DEFAULT_THEME_PRESET = "smrt";
+export declare const DEFAULT_COLOR_SCHEME: "system";
+/** The fonts a brand theme may name, each with its CSS stack. A fixed list, never free text. */
+export declare const THEME_FONTS: Readonly<Record<string, string>>;
+/** `#rgb` or `#rrggbb` (with or without `#`) as lowercase `#rrggbb`; else null. */
+export declare function normalizeHex(value: unknown): string | null;
+/** The brand theme's id: unique per colour and font, since a registered id never changes. */
+export declare function brandThemeId(primary: string, fontFamily?: string): string;
+/**
+ * The preset and scheme a theme means. Lenient: a bad colour or font is
+ * ignored rather than throwing, because a hand-edited file must still render
+ * (`validateCookbook` is where it is rejected).
+ */
+export declare function resolveCookbookTheme(theme: CookbookTheme | undefined): ResolvedCookbookTheme;
+//# sourceMappingURL=theme.d.ts.map

package/dist/components/cookbook/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/components/cookbook/theme.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAC3C,eAAO,MAAM,oBAAoB,EAAG,QAAiB,CAAC;AAEtD,gGAAgG;AAChG,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMxD,CAAC;AAIF,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAO1D;AAED,6FAA6F;AAC7F,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAKzE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,GAAG,SAAS,GAC/B,qBAAqB,CAmBvB"}

package/dist/components/cookbook/theme.js

@@ -0,0 +1,53 @@
+export const DEFAULT_THEME_PRESET = 'smrt';
+export const DEFAULT_COLOR_SCHEME = 'system';
+/** The fonts a brand theme may name, each with its CSS stack. A fixed list, never free text. */
+export const THEME_FONTS = {
+    'system-ui': 'system-ui, -apple-system, "Segoe UI", sans-serif',
+    Inter: 'Inter, system-ui, sans-serif',
+    Georgia: 'Georgia, "Times New Roman", serif',
+    'ui-rounded': 'ui-rounded, "SF Pro Rounded", system-ui, sans-serif',
+    'ui-monospace': 'ui-monospace, "SF Mono", Menlo, monospace',
+};
+const HEX = /^#?([0-9a-f]{3}|[0-9a-f]{6})$/i;
+/** `#rgb` or `#rrggbb` (with or without `#`) as lowercase `#rrggbb`; else null. */
+export function normalizeHex(value) {
+    if (typeof value !== 'string')
+        return null;
+    const match = HEX.exec(value.trim());
+    if (!match)
+        return null;
+    let digits = match[1].toLowerCase();
+    if (digits.length === 3)
+        digits = [...digits].map((d) => d + d).join('');
+    return `#${digits}`;
+}
+/** The brand theme's id: unique per colour and font, since a registered id never changes. */
+export function brandThemeId(primary, fontFamily) {
+    const font = fontFamily
+        ? `-${fontFamily.toLowerCase().replace(/[^a-z0-9]/g, '')}`
+        : '';
+    return `cookbook-brand-${primary.replace('#', '')}${font}`;
+}
+/**
+ * The preset and scheme a theme means. Lenient: a bad colour or font is
+ * ignored rather than throwing, because a hand-edited file must still render
+ * (`validateCookbook` is where it is rejected).
+ */
+export function resolveCookbookTheme(theme) {
+    const colorScheme = theme?.colorScheme === 'light' || theme?.colorScheme === 'dark'
+        ? theme.colorScheme
+        : DEFAULT_COLOR_SCHEME;
+    const primary = theme?.custom ? normalizeHex(theme.custom.primary) : null;
+    if (theme?.custom && primary) {
+        const font = theme.custom.fontFamily;
+        const fontFamily = typeof font === 'string' && Object.hasOwn(THEME_FONTS, font)
+            ? font
+            : undefined;
+        return {
+            preset: brandThemeId(primary, fontFamily),
+            colorScheme,
+            brand: { primary, ...(fontFamily ? { fontFamily } : {}) },
+        };
+    }
+    return { preset: theme?.preset || DEFAULT_THEME_PRESET, colorScheme };
+}