@happyvertical/smrt-svelte 0.55.9 → 0.55.11

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

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