@happyvertical/smrt-svelte 0.55.9 → 0.55.11

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 };
+}

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

@@ -0,0 +1,204 @@
+/**
+ * Inputs and outputs of the cookbook app shell (#3749).
+ *
+ * Everything here is plain data: the builder takes a cookbook plus a recipe
+ * catalog and returns shell configuration; nothing imports Svelte or the DOM.
+ */
+import type { Cookbook, CookbookPolicyRow, RecipeDefinition, RecipeShellSlot, RecipeWidgetSurface } from '@happyvertical/smrt-types';
+import type { ComponentProps } from 'svelte';
+import type AppShell from '../app/AppShell.svelte';
+import type { RecipeExportResolver } from '../overview/recipe-widgets.js';
+import type { OverviewDefinition } from '../overview/types.js';
+import type { CoreWidgetLoaders } from '../overview/widgets/core.js';
+import type { ShellLayout } from '../workspace/admin-shell/layout.js';
+import type { ShellNavGroup } from '../workspace/admin-shell/types.js';
+/**
+ * The part of a recipe the shell reads. A manifest `RecipeDefinition` fits;
+ * hosts may drop `help`, `synonyms` and other bulk before serializing.
+ */
+export type CookbookRecipe = Pick<RecipeDefinition, 'id' | 'label' | 'nav' | 'models'> & Partial<Pick<RecipeDefinition, 'group' | 'section' | 'surfaces' | 'requires' | 'requiresAny'>>;
+/** What the shell needs to know about one model. */
+export interface CookbookModelInfo {
+    /** Qualified name, `@scope/pkg:Class`. */
+    id: string;
+    /** Class name, e.g. `Order`. */
+    name: string;
+    /** Package id used in item ids and routes: `commerce` for `@happyvertical/smrt-commerce`. */
+    packageId: string;
+    /** The model's own description, for an entry with no description of its own. */
+    description?: string;
+    /** Has an API, MCP or CLI surface; only exposed models get a feature entry. */
+    exposed?: boolean;
+}
+/** Recipes plus the models they point at: the catalog a cookbook resolves against. */
+export interface CookbookCatalog {
+    recipes: readonly CookbookRecipe[];
+    models: readonly CookbookModelInfo[];
+}
+/** One navigation entry: a layout item id and the model page it opens. */
+export interface CookbookEntry {
+    /** Layout item id: `item:<package>:<Model>` or `item:<package>:<Model>:<key>`. */
+    id: string;
+    label: string;
+    icon: string;
+    description: string;
+    model: CookbookModelInfo;
+    /** In-app path of the entry's page, without any host base. */
+    path: string;
+    /** Link the nav uses (`path` through `entryHref`). */
+    href: string;
+    /** Explicit noun for the New button. */
+    noun?: string;
+    /** Row filter of a keyed entry. */
+    filter?: {
+        field: string;
+        value: string;
+    };
+    /** Recipe that contributed the entry; `null` for a feature model. */
+    recipeId: string | null;
+}
+/** A suggested navigation section and what it holds. */
+export interface CookbookSection {
+    /** Layout id: `section:<id>`. */
+    id: string;
+    label: string;
+    icon?: string;
+    description?: string;
+    /** Entry ids, in recipe order. */
+    entryIds: string[];
+    /** Ids of the recipes that suggest the section. */
+    recipeIds: string[];
+    /** In-app path of the section page. */
+    path: string;
+}
+/** A recipe surface placed into a shell slot. */
+export interface CookbookShellWidget {
+    recipeId: string;
+    slot: RecipeShellSlot;
+    /** `'<module specifier>#<ExportName>'`; the host resolves it. */
+    export: `${string}#${string}`;
+    label: string;
+    icon?: string;
+}
+export interface CookbookRouteSurface {
+    recipeId: string;
+    path: string;
+    export: `${string}#${string}`;
+    label: string;
+}
+export interface CookbookSettingsPanel {
+    recipeId: string;
+    export: `${string}#${string}`;
+    label: string;
+}
+/** The theme as the shell applies it; a brand colour is registered by the component. */
+export interface ResolvedCookbookTheme {
+    /** Preset id: a built-in smrt-ui preset, or the brand theme's id. */
+    preset: string;
+    colorScheme: 'light' | 'dark' | 'system';
+    /** Present when the cookbook names a brand colour (it wins over `preset`). */
+    brand?: {
+        primary: string;
+        fontFamily?: string;
+    };
+}
+/** One section page: its overview definition and the cookbook's saved override. */
+export interface CookbookOverviewPage {
+    definition: OverviewDefinition;
+    /** The cookbook's stored override for this page, if any (untrusted JSON). */
+    override: unknown;
+}
+export interface BuildCookbookShellOptions {
+    cookbook: Cookbook;
+    /** Recipes and models, usually from {@link catalogFromManifests}. */
+    catalog: CookbookCatalog;
+    /** The app name shown in the shell brand. */
+    title?: string;
+    /**
+     * Recipe order, when it differs from the cookbook's (the cookbook lists ids
+     * sorted). Recipes it does not list follow in cookbook order. Section order
+     * follows the first recipe of each section, then the cookbook layout.
+     */
+    recipeOrder?: readonly string[];
+    /** In-app path of a model entry; default `/m/<package>/<Model>/[key/]`. */
+    entryPath?: (entry: {
+        packageId: string;
+        modelName: string;
+        key?: string;
+    }) => string;
+    /** In-app path of a section page; default `/s/<slug>/`. */
+    sectionPath?: (sectionId: string) => string;
+    /** Prefix for every generated href (`/app` or an app query helper). */
+    href?: (path: string) => string;
+    /**
+     * Put a record count and the latest records on every section page. They need
+     * `metric` and `records` loaders on the host; without them leave this off
+     * and the page shows the entries as shortcut cards only.
+     */
+    dataWidgets?: boolean;
+    /** Where the app's settings page lives; passed through to the shell. */
+    settingsHref?: string;
+}
+/** Everything `AppShell` and the section pages need, derived from a cookbook. */
+export interface CookbookShell {
+    title: string;
+    navMode: 'sections';
+    /** Sections as the shell takes them (layout is applied by the shell). */
+    navGroups: ShellNavGroup[];
+    /** The cookbook's layout, or `null` when it has none. */
+    layout: ShellLayout | null;
+    /** Suggested sections in order, whether or not the layout hides them. */
+    sections: CookbookSection[];
+    /** Every entry by layout item id. */
+    entries: ReadonlyMap<string, CookbookEntry>;
+    theme: ResolvedCookbookTheme;
+    /** Section page overviews by section id (`section:sales`, `custom:shop`). */
+    overviews: Record<string, CookbookOverviewPage>;
+    /** Recipe `shell-widget` surfaces, for the host to resolve into `slotItems`. */
+    shellWidgets: CookbookShellWidget[];
+    routes: CookbookRouteSurface[];
+    settingsPanels: CookbookSettingsPanel[];
+    /** Recipe `widget` surfaces, for `registerRecipeWidgets`. */
+    widgets: Array<Pick<RecipeDefinition, 'id'> & {
+        surfaces: RecipeWidgetSurface[];
+    }>;
+    /** The cookbook's app-scope field policy rows, applied by the runtime. */
+    policies: CookbookPolicyRow[];
+    settingsHref?: string;
+    /** Layout id to section page path (the shell's `sectionHref`). */
+    sectionPath: (sectionId: string) => string;
+    /** Problems that did not stop the build (unknown recipes, models, ...). */
+    issues: string[];
+}
+/** Props of `CookbookSectionPage`. */
+export interface CookbookSectionPageProps {
+    /** The layout id (`section:sales`, `custom:shop`). */
+    sectionId?: string;
+    /** The route slug (`section-sales`); used when `sectionId` is absent. */
+    slug?: string;
+    /** Extra content under the overview. */
+    children?: import('svelte').Snippet;
+}
+/** Props of `CookbookApp`; anything else is passed to `AppShell` unchanged. */
+export interface CookbookAppProps extends Omit<ComponentProps<typeof AppShell>, 'navGroups' | 'nav' | 'navMode' | 'layout' | 'onlayoutchange' | 'preset' | 'colorScheme' | 'sectionHref' | 'title' | 'children'>, Pick<BuildCookbookShellOptions, 'recipeOrder' | 'entryPath' | 'sectionPath' | 'href' | 'title'> {
+    cookbook: Cookbook;
+    catalog: CookbookCatalog;
+    /**
+     * Data loaders for the `metric`, `records` and `chart` widgets. With
+     * `metric` and `records`, section pages also show a record count and the
+     * latest records of the section's lead model.
+     */
+    loaders?: Omit<CoreWidgetLoaders, 'shortcuts'>;
+    /** Host capabilities handed to widget loaders that run in the browser. */
+    widgetContext?: () => Record<string, unknown>;
+    /**
+     * Turns a recipe export reference (`'@acme/shop/svelte#SalesTotal'`) into
+     * the export: a static map of dynamic imports in a bundled app. Without it,
+     * recipe `widget` and `shell-widget` surfaces are ignored.
+     */
+    resolveExport?: RecipeExportResolver;
+    /** Called with the cookbook after a layout or overview edit. */
+    oncookbookchange?: (cookbook: Cookbook) => void;
+    children: import('svelte').Snippet;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/components/cookbook/types.js

@@ -0,0 +1 @@
+export {};

package/dist/components/notifications/LocalizedNotifications.fixture.svelte

@@ -0,0 +1,16 @@
+<script lang="ts">
+import { type I18nStore, setI18nContext } from '@happyvertical/smrt-ui/i18n';
+import { untrack } from 'svelte';
+import MailboxDemo from '../../../../messages/src/svelte/components/MailboxDemo.svelte';
+import NotificationBell from './NotificationBell.svelte';
+import type { NotificationProvider } from './types.js';
+
+interface Props {
+  store: I18nStore;
+  provider?: NotificationProvider;
+  mailbox?: boolean;
+}
+let { store, provider, mailbox = false }: Props = $props();
+setI18nContext(untrack(() => store));
+</script>
+{#if mailbox}<MailboxDemo />{:else if provider}<NotificationBell {provider} />{/if}

package/dist/components/notifications/LocalizedNotifications.fixture.svelte.d.ts

@@ -0,0 +1,11 @@
+import { type I18nStore } from '@happyvertical/smrt-ui/i18n';
+import type { NotificationProvider } from './types.js';
+interface Props {
+    store: I18nStore;
+    provider?: NotificationProvider;
+    mailbox?: boolean;
+}
+declare const LocalizedNotifications: import("svelte").Component<Props, {}, "">;
+type LocalizedNotifications = ReturnType<typeof LocalizedNotifications>;
+export default LocalizedNotifications;
+//# sourceMappingURL=LocalizedNotifications.fixture.svelte.d.ts.map