@happyvertical/smrt-svelte 0.55.10 → 0.55.12

package/dist/components/cookbook/CookbookSectionPage.svelte

@@ -0,0 +1,133 @@
+<script lang="ts">
+/**
+ * A navigation section's own page in a cookbook app (#3749). The sidebar lists
+ * only sections, so this is where a section's entries are: an editable
+ * overview (the entries as shortcut cards by default) with the shell's layout
+ * edit mode driving its grid. A section with no overview shows its menu.
+ *
+ * Render it from one route (`s/[slug]/+page.svelte`), inside `CookbookApp`.
+ */
+import { useI18n } from '@happyvertical/smrt-ui/i18n';
+import { M } from '../../i18n/strings.overview.js';
+import type { OverviewOverride } from '../overview/types.js';
+import { useShellLayout } from '../workspace/admin-shell/layout-context.js';
+import ShellSectionIcon from '../workspace/admin-shell/ShellSectionIcon.svelte';
+import ShellSectionMenu from '../workspace/admin-shell/ShellSectionMenu.svelte';
+import CookbookSectionOverview from './CookbookSectionOverview.svelte';
+import { getCookbookContext } from './context.js';
+import { DEFAULT_SECTION_ICON, sectionIdFromSlug } from './sections.js';
+import type { CookbookSectionPageProps } from './types.js';
+
+let { sectionId, slug, children }: CookbookSectionPageProps = $props();
+
+const { t } = useI18n();
+const cookbook = getCookbookContext();
+const layout = useShellLayout();
+
+const id = $derived(sectionId ?? (slug ? sectionIdFromSlug(slug) : ''));
+const section = $derived(layout.sections.find((s) => s.id === id));
+const suggested = $derived(cookbook.shell.sections.find((s) => s.id === id));
+const title = $derived(section?.heading?.trim() || suggested?.label || '');
+const icon = $derived(section?.icon ?? suggested?.icon ?? DEFAULT_SECTION_ICON);
+const description = $derived(suggested?.description);
+const page = $derived(cookbook.shell.overviews[id]);
+const registry = $derived(cookbook.registry);
+const store = {
+  overview: (key: string) => cookbook.overrideFor(key),
+  setOverview: (key: string, override: OverviewOverride | null) =>
+    cookbook.setOverride(key, override),
+};
+</script>
+
+<svelte:head>
+  {#if title}<title>{title}</title>{/if}
+</svelte:head>
+
+<main class="cookbook-section">
+  {#if section}
+    <header>
+      <span class="mark"><ShellSectionIcon name={icon} size={28} /></span>
+      <div class="heading">
+        <h1>{title}</h1>
+        {#if description}<p>{description}</p>{/if}
+      </div>
+    </header>
+    {#if page && registry}
+      {#key id}
+        <CookbookSectionOverview
+          definition={page.definition}
+          {registry}
+          {store}
+          entries={cookbook.shell.entries}
+          components={cookbook.components}
+          models={cookbook.models}
+          hostContext={cookbook.widgetContext}
+          label={`${title} overview`}
+        />
+      {/key}
+      {#if layout.editing}
+        <section class="entries" aria-labelledby="cookbook-section-entries">
+          <h2 id="cookbook-section-entries">{t(M['ui.cookbook.menu_entries'])}</h2>
+          <ShellSectionMenu sectionId={id} />
+        </section>
+      {/if}
+    {:else if !page}
+      <ShellSectionMenu sectionId={id} layout="cards" />
+    {/if}
+    {@render children?.()}
+  {:else}
+    <h1>{t(M['ui.cookbook.section_not_found'])}</h1>
+    <p>{t(M['ui.cookbook.section_not_found_hint'])}</p>
+  {/if}
+</main>
+
+<style>
+  .cookbook-section {
+    display: grid;
+    gap: var(--smrt-spacing-6);
+    width: min(100%, 64rem);
+    margin-inline: auto;
+    padding: var(--smrt-spacing-6);
+  }
+
+  header {
+    display: flex;
+    align-items: center;
+    gap: var(--smrt-spacing-4);
+  }
+
+  .mark {
+    display: inline-grid;
+    place-items: center;
+    flex: 0 0 auto;
+    inline-size: 3rem;
+    block-size: 3rem;
+    border-radius: var(--smrt-radius-large, 0.75rem);
+    background: var(--smrt-color-primary-container);
+    color: var(--smrt-color-on-primary-container);
+  }
+
+  .heading {
+    flex: 1 1 auto;
+    min-inline-size: 0;
+  }
+
+  h1 {
+    margin: 0;
+  }
+
+  .heading p {
+    margin: var(--smrt-spacing-1) 0 0;
+    color: var(--smrt-color-on-surface-variant);
+  }
+
+  .entries {
+    display: grid;
+    gap: var(--smrt-spacing-3);
+  }
+
+  .entries h2 {
+    margin: 0;
+    font-size: var(--smrt-typography-title-medium-size, 1rem);
+  }
+</style>

package/dist/components/cookbook/CookbookSectionPage.svelte.d.ts

@@ -0,0 +1,5 @@
+import type { CookbookSectionPageProps } from './types.js';
+declare const CookbookSectionPage: import("svelte").Component<CookbookSectionPageProps, {}, "">;
+type CookbookSectionPage = ReturnType<typeof CookbookSectionPage>;
+export default CookbookSectionPage;
+//# sourceMappingURL=CookbookSectionPage.svelte.d.ts.map

package/dist/components/cookbook/CookbookSectionPage.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CookbookSectionPage.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/cookbook/CookbookSectionPage.svelte.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAyE3D,QAAA,MAAM,mBAAmB,8DAAwC,CAAC;AAClE,KAAK,mBAAmB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAClE,eAAe,mBAAmB,CAAC"}

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

@@ -0,0 +1,11 @@
+import { type ThemePreset } from '@happyvertical/smrt-ui/themes';
+import type { ResolvedCookbookTheme } from './types.js';
+/**
+ * The preset id `ThemeProvider` should use for a resolved cookbook theme.
+ * A brand colour is registered through `createThemeFromColor` first; a
+ * registered id is never reused for another colour because `ThemeProvider`
+ * looks a theme up once per preset id (the id encodes colour and font).
+ * An unknown preset name falls back to the default rather than breaking.
+ */
+export declare function applyCookbookTheme(theme: ResolvedCookbookTheme): ThemePreset;
+//# sourceMappingURL=brand-theme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brand-theme.d.ts","sourceRoot":"","sources":["../../../src/components/cookbook/brand-theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAIxD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,WAAW,CAiB5E"}

package/dist/components/cookbook/brand-theme.js

@@ -0,0 +1,24 @@
+import { createThemeFromColor, isValidPreset, registerTheme, } from '@happyvertical/smrt-ui/themes';
+import { DEFAULT_THEME_PRESET, THEME_FONTS } from './theme.js';
+const registered = new Set();
+/**
+ * The preset id `ThemeProvider` should use for a resolved cookbook theme.
+ * A brand colour is registered through `createThemeFromColor` first; a
+ * registered id is never reused for another colour because `ThemeProvider`
+ * looks a theme up once per preset id (the id encodes colour and font).
+ * An unknown preset name falls back to the default rather than breaking.
+ */
+export function applyCookbookTheme(theme) {
+    const { brand } = theme;
+    if (brand) {
+        if (!registered.has(theme.preset)) {
+            const font = brand.fontFamily ? THEME_FONTS[brand.fontFamily] : undefined;
+            registerTheme(createThemeFromColor(brand.primary, theme.preset, 'Brand colour', {
+                ...(font ? { fontFamily: font } : {}),
+            }));
+            registered.add(theme.preset);
+        }
+        return theme.preset;
+    }
+    return (isValidPreset(theme.preset) ? theme.preset : DEFAULT_THEME_PRESET);
+}

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

@@ -0,0 +1,8 @@
+import type { BuildCookbookShellOptions, CookbookShell } from './types.js';
+/** `PurchaseOrder` -> `Purchase Order`. */
+export declare function humanize(name: string): string;
+/** `Customer` -> `Customers`, `Category` -> `Categories`. */
+export declare function pluralize(noun: string): string;
+/** Derive the shell configuration from a cookbook (see {@link CookbookShell}). */
+export declare function buildCookbookShell(options: BuildCookbookShellOptions): CookbookShell;
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/components/cookbook/build.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EACV,yBAAyB,EAQzB,aAAa,EAEd,MAAM,YAAY,CAAC;AAEpB,2CAA2C;AAC3C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI9C;AA0ED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,aAAa,CAyOf"}

package/dist/components/cookbook/build.js

@@ -0,0 +1,277 @@
+import { defineOverview, isEmptyOverride, parseOverviewOverride, } from '../overview/model.js';
+import { OVERVIEW_PAGE_ID_PATTERN, } from '../overview/types.js';
+import { buildNavSections, DEFAULT_ENTRY_ICON, defaultEntryPath, defaultSectionPath, entryDescription, FEATURE_SECTION, navItemId, sectionLayoutId, } from './sections.js';
+import { resolveCookbookTheme } from './theme.js';
+/** `PurchaseOrder` -> `Purchase Order`. */
+export function humanize(name) {
+    return name.replace(/([a-z0-9])([A-Z])/g, '$1 $2');
+}
+/** `Customer` -> `Customers`, `Category` -> `Categories`. */
+export function pluralize(noun) {
+    if (/[^aeiou]y$/i.test(noun))
+        return `${noun.slice(0, -1)}ies`;
+    if (/(s|x|z|ch|sh)$/i.test(noun))
+        return `${noun}es`;
+    return `${noun}s`;
+}
+/** The recipes the cookbook selects, in catalog order; unknown ids are reported. */
+function selectRecipes(options, issues) {
+    const { cookbook, catalog, recipeOrder } = options;
+    const byId = new Map(catalog.recipes.map((r) => [r.id, r]));
+    const wanted = new Set(cookbook.recipes);
+    const order = [...(recipeOrder ?? []), ...catalog.recipes.map((r) => r.id)];
+    const picked = [];
+    const done = new Set();
+    for (const id of order) {
+        const recipe = byId.get(id);
+        if (!recipe || !wanted.has(id) || done.has(id))
+            continue;
+        done.add(id);
+        picked.push(recipe);
+    }
+    for (const id of cookbook.recipes) {
+        if (!done.has(id))
+            issues.push(`Unknown recipe "${id}".`);
+    }
+    return picked;
+}
+/**
+ * The section's lead model: the first nav entry of the first recipe that
+ * suggests the section. Its count and records go on the section page.
+ */
+function leadModel(recipes, models) {
+    for (const recipe of recipes) {
+        for (const entry of recipe.nav) {
+            const model = models.get(entry.model);
+            if (model)
+                return model;
+        }
+    }
+    return undefined;
+}
+function overviewDefaults(lead, dataWidgets) {
+    const widgets = [
+        { id: 'shortcuts', type: 'shortcuts', span: 4, options: {} },
+    ];
+    if (dataWidgets && lead) {
+        const name = humanize(lead.name);
+        widgets.push({
+            id: 'count',
+            type: 'metric',
+            span: 1,
+            options: { title: pluralize(name), model: lead.id, measure: 'count' },
+        }, {
+            id: 'latest',
+            type: 'records',
+            span: 3,
+            options: { title: `${name} records`, model: lead.id, limit: 5 },
+        });
+    }
+    return widgets;
+}
+/** The cookbook layout as the shell takes it: `null` when it has none. */
+function layoutOf(cookbook) {
+    return cookbook.layout ? cookbook.layout : null;
+}
+/** Derive the shell configuration from a cookbook (see {@link CookbookShell}). */
+export function buildCookbookShell(options) {
+    const { cookbook, catalog } = options;
+    const issues = [];
+    const href = options.href ?? ((path) => path);
+    const entryPath = options.entryPath ?? defaultEntryPath;
+    const sectionPath = options.sectionPath ?? defaultSectionPath;
+    const models = new Map(catalog.models.map((m) => [m.id, m]));
+    const recipes = selectRecipes(options, issues);
+    const entries = new Map();
+    const sections = [];
+    const navGroups = [];
+    const addEntry = (recipe, spec) => {
+        const id = navItemId(spec.model.packageId, spec.model.name, spec.key);
+        if (entries.has(id))
+            return undefined;
+        const path = entryPath({
+            packageId: spec.model.packageId,
+            modelName: spec.model.name,
+            ...(spec.key ? { key: spec.key } : {}),
+        });
+        const entry = {
+            id,
+            label: spec.label,
+            icon: spec.icon ?? DEFAULT_ENTRY_ICON,
+            description: entryDescription(spec.description, spec.model),
+            model: spec.model,
+            path,
+            href: href(path),
+            recipeId: recipe?.id ?? null,
+            ...(spec.noun ? { noun: spec.noun } : {}),
+            ...(spec.filter ? { filter: spec.filter } : {}),
+        };
+        entries.set(id, entry);
+        return entry;
+    };
+    const toItem = (entry) => ({
+        id: entry.id,
+        href: entry.href,
+        label: entry.label,
+        icon: entry.icon,
+        description: entry.description,
+    });
+    const pushSection = (id, label, icon, description, recipeIds, items) => {
+        const layoutId = sectionLayoutId(id);
+        const path = sectionPath(layoutId);
+        sections.push({
+            id: layoutId,
+            label,
+            ...(icon ? { icon } : {}),
+            ...(description ? { description } : {}),
+            entryIds: items.map((e) => e.id),
+            recipeIds,
+            path,
+        });
+        navGroups.push({
+            id: layoutId,
+            heading: label,
+            ...(icon ? { icon } : {}),
+            href: href(path),
+            items: items.map(toItem),
+        });
+    };
+    // Recipe sections: a section none of whose recipes has a menu entry (an
+    // assistant, a settings panel) is left out rather than shown empty.
+    const leads = new Map();
+    for (const section of buildNavSections(recipes)) {
+        const items = [];
+        for (const recipe of section.recipes) {
+            for (const nav of recipe.nav) {
+                const model = models.get(nav.model);
+                if (!model) {
+                    issues.push(`Recipe ${recipe.id} lists unknown model ${nav.model}.`);
+                    continue;
+                }
+                const entry = addEntry(recipe, {
+                    model,
+                    label: nav.label,
+                    icon: nav.icon,
+                    description: nav.description,
+                    key: nav.key,
+                    noun: nav.noun,
+                    filter: nav.filter,
+                });
+                if (entry)
+                    items.push(entry);
+            }
+        }
+        if (items.length === 0)
+            continue;
+        leads.set(sectionLayoutId(section.id), leadModel(section.recipes, models));
+        pushSection(section.id, section.label, section.icon, section.description ??
+            section.recipes.find((r) => r.group?.summary)?.group?.summary, section.recipes.map((r) => r.id), items);
+    }
+    // Features: exposed models no recipe covers, in one section after the recipes'.
+    const featureItems = [];
+    for (const id of cookbook.features ?? []) {
+        const model = models.get(id);
+        if (!model?.exposed) {
+            issues.push(`Feature ${id} is not an exposed model.`);
+            continue;
+        }
+        const entry = addEntry(null, { model, label: humanize(model.name) });
+        if (entry)
+            featureItems.push(entry);
+    }
+    if (featureItems.length > 0) {
+        leads.set(sectionLayoutId(FEATURE_SECTION.id), featureItems[0]?.model);
+        pushSection(FEATURE_SECTION.id, FEATURE_SECTION.label, FEATURE_SECTION.icon, FEATURE_SECTION.description, [], featureItems);
+    }
+    // Section page overviews: one per suggested section and per custom section
+    // of the layout, so a cookbook's `overviews` key names the page it
+    // customises and stays valid when the section is renamed.
+    const layout = layoutOf(cookbook);
+    const modelIds = catalog.models.map((m) => m.id);
+    const overviews = {};
+    const overviewIds = [
+        ...sections.map((s) => s.id),
+        ...(layout?.customSections ?? []).map((s) => s.id),
+    ];
+    for (const id of new Set(overviewIds)) {
+        // A hand-edited custom id outside the pattern has no overview: its page
+        // shows the menu.
+        if (!OVERVIEW_PAGE_ID_PATTERN.test(id))
+            continue;
+        const definition = defineOverview({
+            id,
+            ...(modelIds.length > 0 ? { models: modelIds } : {}),
+            defaults: overviewDefaults(leads.get(id), options.dataWidgets === true),
+        });
+        const stored = cookbook.overviews?.[id];
+        const parsed = parseOverviewOverride(stored);
+        for (const issue of parsed.issues) {
+            issues.push(`Overview ${id}: ${issue.message}`);
+        }
+        overviews[id] = {
+            definition,
+            override: isEmptyOverride(parsed.override) ? null : stored,
+        };
+    }
+    for (const id of Object.keys(cookbook.overviews ?? {})) {
+        if (!overviews[id]) {
+            issues.push(`Overview "${id}" names no section; its override is ignored.`);
+        }
+    }
+    // Recipe surfaces placed into shell slots and routes.
+    const shellWidgets = [];
+    const routes = [];
+    const settingsPanels = [];
+    const widgets = [];
+    for (const recipe of recipes) {
+        const found = [];
+        for (const surface of recipe.surfaces ?? []) {
+            if (surface.kind === 'shell-widget') {
+                shellWidgets.push({
+                    recipeId: recipe.id,
+                    slot: surface.slot,
+                    export: surface.export,
+                    label: surface.label,
+                    ...(surface.icon ? { icon: surface.icon } : {}),
+                });
+            }
+            else if (surface.kind === 'route') {
+                routes.push({
+                    recipeId: recipe.id,
+                    path: surface.path,
+                    export: surface.export,
+                    label: surface.label,
+                });
+            }
+            else if (surface.kind === 'settings-panel') {
+                settingsPanels.push({
+                    recipeId: recipe.id,
+                    export: surface.export,
+                    label: surface.label,
+                });
+            }
+            else if (surface.kind === 'widget')
+                found.push(surface);
+        }
+        if (found.length > 0)
+            widgets.push({ id: recipe.id, surfaces: found });
+    }
+    return {
+        title: options.title ?? cookbook.name ?? 'SMRT',
+        navMode: 'sections',
+        navGroups,
+        layout,
+        sections,
+        entries,
+        theme: resolveCookbookTheme(cookbook.theme),
+        overviews,
+        shellWidgets,
+        routes,
+        settingsPanels,
+        widgets,
+        policies: cookbook.policies ?? [],
+        ...(options.settingsHref ? { settingsHref: options.settingsHref } : {}),
+        sectionPath: (id) => href(sectionPath(id)),
+        issues,
+    };
+}

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

@@ -0,0 +1,37 @@
+import type { CookbookCatalog } from './types.js';
+/** The subset of a package `manifest.json` the shell reads. */
+export interface CookbookManifest {
+    packageName: string;
+    objects?: Record<string, RawManifestObject>;
+    recipes?: unknown;
+}
+interface RawManifestObject {
+    className?: string;
+    qualifiedName?: string;
+    description?: string;
+    fields?: Record<string, {
+        type?: string;
+    }>;
+    decoratorConfig?: Record<string, unknown>;
+}
+/**
+ * `@happyvertical/smrt-commerce` -> `commerce`. Other scopes keep their
+ * unscoped name with a leading `smrt-` dropped, so ids stay short and stable.
+ */
+export declare function packageIdOf(packageName: string): string;
+/**
+ * The catalog of the given manifests. Recipes keep their declaration order
+ * across manifests (the order given); a repeated recipe id keeps the first.
+ */
+export declare function catalogFromManifests(manifests: readonly CookbookManifest[]): CookbookCatalog;
+/**
+ * Narrow a catalog to what a cookbook uses, so a server load serializes only
+ * that: the selected recipes, and the models they list or the cookbook names
+ * as features.
+ */
+export declare function narrowCatalog(catalog: CookbookCatalog, selection: {
+    recipes: readonly string[];
+    features: readonly string[];
+}): CookbookCatalog;
+export {};
+//# sourceMappingURL=catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/components/cookbook/catalog.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,YAAY,CAAC;AAEpB,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,iBAAiB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAKD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAQvD;AAoDD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,gBAAgB,EAAE,GACrC,eAAe,CA0BjB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE;IAAE,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACrE,eAAe,CASjB"}

package/dist/components/cookbook/catalog.js

@@ -0,0 +1,99 @@
+const PACKAGE_PREFIXES = ['@happyvertical/smrt-'];
+const NON_VALUE_TYPES = new Set(['oneToMany', 'meta']);
+/**
+ * `@happyvertical/smrt-commerce` -> `commerce`. Other scopes keep their
+ * unscoped name with a leading `smrt-` dropped, so ids stay short and stable.
+ */
+export function packageIdOf(packageName) {
+    for (const prefix of PACKAGE_PREFIXES) {
+        if (packageName.startsWith(prefix))
+            return packageName.slice(prefix.length);
+    }
+    const bare = packageName.includes('/')
+        ? packageName.slice(packageName.indexOf('/') + 1)
+        : packageName;
+    return bare.replace(/^smrt-/, '');
+}
+/** A model, not a collection class: it holds at least one value field. */
+function isModel(raw) {
+    return Object.values(raw.fields ?? {}).some((f) => !NON_VALUE_TYPES.has(f.type ?? ''));
+}
+/** An omitted `api`/`mcp`/`cli` key means full CRUD; all three `false` means none. */
+function isExposed(config) {
+    const c = config ?? {};
+    return !(c.api === false && c.mcp === false && c.cli === false);
+}
+function isRecipe(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const r = value;
+    return (typeof r.id === 'string' &&
+        typeof r.label === 'string' &&
+        Array.isArray(r.nav) &&
+        Array.isArray(r.models));
+}
+/** Drop what the shell never reads (help markdown, synonyms, providers, ...). */
+function trimRecipe(recipe) {
+    const { id, label, nav, models, group, section, surfaces, requires, requiresAny, } = recipe;
+    return {
+        id,
+        label,
+        nav,
+        models,
+        ...(group ? { group } : {}),
+        ...(section ? { section } : {}),
+        ...(surfaces && surfaces.length > 0 ? { surfaces } : {}),
+        ...(requires ? { requires } : {}),
+        ...(requiresAny ? { requiresAny } : {}),
+    };
+}
+/**
+ * The catalog of the given manifests. Recipes keep their declaration order
+ * across manifests (the order given); a repeated recipe id keeps the first.
+ */
+export function catalogFromManifests(manifests) {
+    const recipes = [];
+    const seen = new Set();
+    const models = [];
+    for (const manifest of manifests) {
+        const packageId = packageIdOf(manifest.packageName);
+        for (const raw of Object.values(manifest.objects ?? {})) {
+            if (!raw.qualifiedName || !raw.className || !isModel(raw))
+                continue;
+            const description = raw.description?.trim();
+            models.push({
+                id: raw.qualifiedName,
+                name: raw.className,
+                packageId,
+                exposed: isExposed(raw.decoratorConfig),
+                ...(description ? { description } : {}),
+            });
+        }
+        if (Array.isArray(manifest.recipes)) {
+            for (const recipe of manifest.recipes) {
+                if (!isRecipe(recipe) || seen.has(recipe.id))
+                    continue;
+                seen.add(recipe.id);
+                recipes.push(trimRecipe(recipe));
+            }
+        }
+    }
+    return { recipes, models };
+}
+/**
+ * Narrow a catalog to what a cookbook uses, so a server load serializes only
+ * that: the selected recipes, and the models they list or the cookbook names
+ * as features.
+ */
+export function narrowCatalog(catalog, selection) {
+    const wanted = new Set(selection.recipes);
+    const recipes = catalog.recipes.filter((r) => wanted.has(r.id));
+    const modelIds = new Set(selection.features);
+    for (const recipe of recipes) {
+        for (const id of recipe.models)
+            modelIds.add(id);
+        for (const entry of recipe.nav)
+            modelIds.add(entry.model);
+    }
+    return { recipes, models: catalog.models.filter((m) => modelIds.has(m.id)) };
+}

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

@@ -0,0 +1,23 @@
+import type { OverviewModelChoice } from '../overview/grid-types.js';
+import type { WidgetComponents, WidgetRegistry } from '../overview/registry.js';
+import type { OverviewOverride } from '../overview/types.js';
+import type { CookbookShell } from './types.js';
+/** What `CookbookApp` shares with `CookbookSectionPage` below it. */
+export interface CookbookContext {
+    readonly shell: CookbookShell;
+    /** `null` until the recipe widgets are registered. */
+    readonly registry: WidgetRegistry | null;
+    readonly components: WidgetComponents;
+    /** Models the overview option editor offers. */
+    readonly models: readonly OverviewModelChoice[];
+    /** The page's stored override (untrusted JSON), reactive. */
+    overrideFor(sectionId: string): unknown;
+    /** Store an edit; `null` resets the page to its defaults. */
+    setOverride(sectionId: string, override: OverviewOverride | null): void;
+    /** Host capabilities passed to widget loaders (a data source, ...). */
+    widgetContext(): Record<string, unknown>;
+}
+export declare function setCookbookContext(context: CookbookContext): void;
+export declare function tryGetCookbookContext(): CookbookContext | undefined;
+export declare function getCookbookContext(): CookbookContext;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/components/cookbook/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAChD,6DAA6D;IAC7D,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACxC,6DAA6D;IAC7D,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAAC;IACxE,uEAAuE;IACvE,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAID,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAEjE;AAED,wBAAgB,qBAAqB,IAAI,eAAe,GAAG,SAAS,CAEnE;AAED,wBAAgB,kBAAkB,IAAI,eAAe,CAQpD"}

package/dist/components/cookbook/context.js

@@ -0,0 +1,15 @@
+import { getContext, setContext } from 'svelte';
+const KEY = Symbol('smrt-cookbook');
+export function setCookbookContext(context) {
+    setContext(KEY, context);
+}
+export function tryGetCookbookContext() {
+    return getContext(KEY);
+}
+export function getCookbookContext() {
+    const context = tryGetCookbookContext();
+    if (!context) {
+        throw new Error('CookbookSectionPage must be rendered inside <CookbookApp>.');
+    }
+    return context;
+}