@happyvertical/smrt-svelte 0.55.10 → 0.55.11

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/overview/OverviewGrid.svelte

@@ -41,6 +41,8 @@ let {
   editing: editingProp,
   label,
   headingLevel = 2,
+  heading,
+  presentation = 'card',
   models,
   iconComponent,
 }: OverviewGridProps = $props();
@@ -348,7 +350,7 @@ const headingTag = $derived(`h${headingLevel}`);
 {#snippet body(row: Row)}
   {@const Widget = components?.get(row.widget.type) ?? row.def?.component}
   <article class="smrt-overview__widget" aria-labelledby="{uid}-title-{row.widget.id}">
-    <svelte:element this={headingTag} class="smrt-overview__title" id="{uid}-title-{row.widget.id}">{row.title}</svelte:element>
+    <svelte:element this={headingTag} class="smrt-overview__title" id="{uid}-title-{row.widget.id}">{#if heading}{@render heading(row.widget, row.title)}{:else}{row.title}{/if}</svelte:element>
     <div class="smrt-overview__content" aria-busy={row.status === 'loading'}>
       {#if !row.def}
         <p class="smrt-overview__state">{t(M['ui.overview.unavailable'])}</p>
@@ -376,7 +378,7 @@ const headingTag = $derived(`h${headingLevel}`);
   </article>
 {/snippet}
 
-<div class="smrt-overview" bind:this={rootEl} data-editing={editing ? '' : undefined}>
+<div class="smrt-overview" bind:this={rootEl} data-editing={editing ? '' : undefined} data-presentation={presentation}>
   {#if editing}
     <div class="smrt-overview__toolbar" role="toolbar" aria-label={t(M['ui.overview.toolbar'])}>
       <ShellIconButton
@@ -547,6 +549,7 @@ const headingTag = $derived(`h${headingLevel}`);
   .smrt-overview__item[data-drop='before']::before { inset-inline-start: 0; }
   .smrt-overview__item[data-drop='after']::before { inset-inline-end: 0; }
   .smrt-overview__tile { position: relative; block-size: 100%; box-sizing: border-box; padding: var(--smrt-spacing-3); border: 1px solid var(--smrt-color-outline-variant); border-radius: var(--smrt-radius-large, var(--smrt-radius-medium)); background: var(--smrt-color-surface); color: var(--smrt-color-on-surface); }
+  [data-presentation='plain']:not([data-editing]) .smrt-overview__tile { padding: 0; border: 0; border-radius: 0; background: transparent; }
   [data-editing] .smrt-overview__tile { border-style: dashed; }
   .smrt-overview__widget { display: grid; gap: var(--smrt-spacing-2); align-content: start; min-inline-size: 0; }
   .smrt-overview__title { margin: 0; color: var(--smrt-color-on-surface-variant); font-size: var(--smrt-typography-title-small-size, 0.875rem); font-weight: var(--smrt-typography-weight-medium, 500); }

package/dist/components/overview/OverviewGrid.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OverviewGrid.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/overview/OverviewGrid.svelte.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AA0bzD,QAAA,MAAM,YAAY,uDAAwC,CAAC;AAC3D,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AACpD,eAAe,YAAY,CAAC"}
+{"version":3,"file":"OverviewGrid.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/overview/OverviewGrid.svelte.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AA4bzD,QAAA,MAAM,YAAY,uDAAwC,CAAC;AAC3D,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AACpD,eAAe,YAAY,CAAC"}

package/dist/components/overview/grid-types.d.ts

@@ -1,6 +1,6 @@
-import type { Component } from 'svelte';
+import type { Component, Snippet } from 'svelte';
 import type { OverviewController } from './controller.svelte.js';
-import type { OverviewOptions, RegisteredWidget, WidgetComponentProps } from './types.js';
+import type { OverviewOptions, OverviewWidget, RegisteredWidget, WidgetComponentProps } from './types.js';
 /** A model the option editor offers for `model` fields. */
 export interface OverviewModelChoice {
     value: string;
@@ -25,6 +25,10 @@ export interface OverviewGridProps {
     label?: string;
     /** Heading level of widget titles (default 2). */
     headingLevel?: 2 | 3 | 4;
+    /** Optional title content; the grid retains the heading element and accessible id. */
+    heading?: Snippet<[widget: OverviewWidget, title: string]>;
+    /** Tile presentation outside edit mode (default card). Editing retains its frame. */
+    presentation?: 'card' | 'plain';
     /** Models offered by `model` option fields (else a text box). */
     models?: readonly OverviewModelChoice[];
     /** Host renderer for icon names that are not built in. */

package/dist/components/overview/grid-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grid-types.d.ts","sourceRoot":"","sources":["../../../src/components/overview/grid-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,2DAA2D;AAC3D,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,+BAA+B;AAC/B,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,UAAU,EAAE,kBAAkB,CAAC;IAC/B;;;;OAIG;IACH,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAClE;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,iEAAiE;IACjE,MAAM,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACxC,0DAA0D;IAC1D,aAAa,CAAC,EAAE,SAAS,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oCAAoC;AACpC,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,+DAA+D;IAC/D,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACxC,+DAA+D;IAC/D,MAAM,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,iBAAiB,EAAE,GAAG,IAAI,CAAC;IACjE,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB"}
+{"version":3,"file":"grid-types.d.ts","sourceRoot":"","sources":["../../../src/components/overview/grid-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,2DAA2D;AAC3D,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,+BAA+B;AAC/B,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,UAAU,EAAE,kBAAkB,CAAC;IAC/B;;;;OAIG;IACH,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAClE;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,qFAAqF;IACrF,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,iEAAiE;IACjE,MAAM,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACxC,0DAA0D;IAC1D,aAAa,CAAC,EAAE,SAAS,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oCAAoC;AACpC,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,+DAA+D;IAC/D,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACxC,+DAA+D;IAC/D,MAAM,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,iBAAiB,EAAE,GAAG,IAAI,CAAC;IACjE,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB"}

package/dist/i18n/strings.overview.d.ts

@@ -102,5 +102,8 @@ export declare const M: {
     readonly 'ui.overview.records.view_all': "ui.overview.records.view_all";
     readonly 'ui.overview.records.total': "ui.overview.records.total";
     readonly 'ui.overview.shortcuts.empty': "ui.overview.shortcuts.empty";
+    readonly 'ui.cookbook.menu_entries': "ui.cookbook.menu_entries";
+    readonly 'ui.cookbook.section_not_found': "ui.cookbook.section_not_found";
+    readonly 'ui.cookbook.section_not_found_hint': "ui.cookbook.section_not_found_hint";
 };
 //# sourceMappingURL=strings.overview.d.ts.map

package/dist/i18n/strings.overview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"strings.overview.d.ts","sourceRoot":"","sources":["../../src/i18n/strings.overview.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8HZ,CAAC"}
+{"version":3,"file":"strings.overview.d.ts","sourceRoot":"","sources":["../../src/i18n/strings.overview.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmIZ,CAAC"}

package/dist/i18n/strings.overview.js

@@ -111,4 +111,8 @@ export const M = defineMessages({
     'ui.overview.records.view_all': 'View all',
     'ui.overview.records.total': '{count} in total',
     'ui.overview.shortcuts.empty': 'No pages to show.',
+    // Cookbook section page
+    'ui.cookbook.menu_entries': 'Menu entries',
+    'ui.cookbook.section_not_found': 'Section not found',
+    'ui.cookbook.section_not_found_hint': 'This section is not in your app.',
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-svelte",
-  "version": "0.55.10",
+  "version": "0.55.11",
   "smrtJsdoc": "strict",
   "description": "Svelte 5 components for SMRT user management - auth, users, tenants, roles, permissions, groups",
   "type": "module",
@@ -63,6 +63,17 @@
       "import": "./dist/components/overview/index.js",
       "default": "./dist/components/overview/index.js"
     },
+    "./cookbook": {
+      "types": "./dist/components/cookbook/index.d.ts",
+      "svelte": "./dist/components/cookbook/index.js",
+      "import": "./dist/components/cookbook/index.js",
+      "default": "./dist/components/cookbook/index.js"
+    },
+    "./cookbook/server": {
+      "types": "./dist/components/cookbook/server.d.ts",
+      "import": "./dist/components/cookbook/server.js",
+      "default": "./dist/components/cookbook/server.js"
+    },
     "./overview/server": {
       "types": "./dist/components/overview/server.d.ts",
       "import": "./dist/components/overview/server.js",
@@ -194,11 +205,11 @@
   },
   "dependencies": {
     "@happyvertical/logger": "^0.103.1",
-    "@happyvertical/smrt-languages": "0.55.10",
-    "@happyvertical/smrt-mcp-apps": "0.55.10",
-    "@happyvertical/smrt-types": "0.55.10",
-    "@happyvertical/smrt-ui": "0.55.10",
-    "@happyvertical/smrt-web": "0.55.10",
+    "@happyvertical/smrt-languages": "0.55.11",
+    "@happyvertical/smrt-mcp-apps": "0.55.11",
+    "@happyvertical/smrt-types": "0.55.11",
+    "@happyvertical/smrt-ui": "0.55.11",
+    "@happyvertical/smrt-web": "0.55.11",
     "@tanstack/db": "^0.6.14",
     "@tanstack/svelte-db": "^0.1.91",
     "esm-env": "^1.2.2"
@@ -233,14 +244,14 @@
     }
   },
   "devDependencies": {
-    "@happyvertical/smrt-agents": "0.55.10",
-    "@happyvertical/smrt-chat": "0.55.10",
-    "@happyvertical/smrt-content": "0.55.10",
-    "@happyvertical/smrt-core": "0.55.10",
-    "@happyvertical/smrt-reports": "0.55.10",
-    "@happyvertical/smrt-scanner": "0.55.10",
-    "@happyvertical/smrt-tenancy": "0.55.10",
-    "@happyvertical/smrt-users": "0.55.10",
+    "@happyvertical/smrt-agents": "0.55.11",
+    "@happyvertical/smrt-chat": "0.55.11",
+    "@happyvertical/smrt-content": "0.55.11",
+    "@happyvertical/smrt-core": "0.55.11",
+    "@happyvertical/smrt-reports": "0.55.11",
+    "@happyvertical/smrt-scanner": "0.55.11",
+    "@happyvertical/smrt-tenancy": "0.55.11",
+    "@happyvertical/smrt-users": "0.55.11",
     "@happyvertical/speech": "^0.103.1",
     "@sveltejs/package": "^2.5.8",
     "@sveltejs/vite-plugin-svelte": "^7.3.0",