@happyvertical/smrt-planner 0.57.18 → 0.57.20

package/dist/planner/Planner.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Planner.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/planner/Planner.svelte.ts"],"names":[],"mappings":"AA8DA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAod/C,QAAA,MAAM,OAAO,kDAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}
+{"version":3,"file":"Planner.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/planner/Planner.svelte.ts"],"names":[],"mappings":"AA0EA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAogB/C,QAAA,MAAM,OAAO,kDAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}

package/dist/planner/PlannerControls.svelte

@@ -13,6 +13,7 @@ import ExportPanel from '../components/ExportPanel.svelte';
 import FeaturesPanel from '../components/FeaturesPanel.svelte';
 import RecipeCards from '../components/RecipeCards.svelte';
 import SettingsPanel from '../components/SettingsPanel.svelte';
+import SpecsPanel from '../components/SpecsPanel.svelte';
 import ThemeSection from '../components/ThemeSection.svelte';
 import { cookbookStore } from '../cookbook/store.svelte.js';
 import { provideDataSource, tryUseDataSource } from '../data/context.js';
@@ -20,6 +21,7 @@ import { createPlannerDataSource } from '../data/planner-source.js';
 import { cookbookNavGroups } from '../library/menu.js';
 import { recipeState } from '../recipes/state.svelte.js';
 import { PLANNER_TAB_IDS, type PlannerTabId } from './commands/index.js';
+import { NAV_GROUP_TABS, navGroupOf } from './header-nav.js';
 import { plannerController } from './instance.js';
 import PlannerLifecycle from './PlannerLifecycle.svelte';
 import { plannerTab } from './tab.svelte.js';
@@ -48,7 +50,18 @@ const DEFAULT_TABS: PlannerTabId[] = [
   'settings',
   'export',
 ];
-const UNLISTED_TABS: PlannerTabId[] = ['features', 'layout'];
+const UNLISTED_TABS: PlannerTabId[] = ['specs', 'features', 'layout'];
+// `headerNav: 'labelled'`: Specs and Features join the strip, which then shows
+// only the group of the header button that opened it.
+const LABELLED_TABS: PlannerTabId[] = [
+  'specs',
+  'cookbooks',
+  'recipes',
+  'features',
+  'theme',
+  'settings',
+  'export',
+];
 
 let {
   controller = plannerController,
@@ -58,6 +71,7 @@ let {
   persistence = 'self',
   projectPersistence,
   themeControls = false,
+  headerNav = 'icons',
   advancedStylesHref,
   tabs = DEFAULT_TABS,
   onready,
@@ -85,6 +99,7 @@ if (!tryUseDataSource()) provideDataSource(createPlannerDataSource());
 const hasAppState = tryGetAppStateContext() !== null;
 
 const labels: Record<PlannerTabId, string> = {
+  specs: 'Specs',
   cookbooks: 'Cookbooks',
   recipes: 'Recipes',
   features: 'Features',
@@ -93,11 +108,25 @@ const labels: Record<PlannerTabId, string> = {
   settings: 'Settings',
   export: 'Export',
 };
-const shown = $derived(tabs.filter((id) => PLANNER_TAB_IDS.includes(id)));
+const labelled = $derived(headerNav === 'labelled');
+const defaulted = $derived(tabs === DEFAULT_TABS);
+const listed = $derived(
+  (labelled && defaulted ? LABELLED_TABS : tabs).filter((id) =>
+    PLANNER_TAB_IDS.includes(id),
+  ),
+);
+// Labelled: only the clicked button's group (all of them if the host's own
+// `tabs` leave that group empty).
+const shown = $derived.by(() => {
+  if (!labelled) return listed;
+  const group = NAV_GROUP_TABS[navGroupOf(plannerTab.active)];
+  const grouped = listed.filter((id) => group.includes(id));
+  return grouped.length > 0 ? grouped : listed;
+});
 // Features and Layout left the default tab strip but stay reachable from
 // their links, the command palette and focus commands.
 const reachable = $derived<readonly PlannerTabId[]>(
-  tabs === DEFAULT_TABS ? [...shown, ...UNLISTED_TABS] : shown,
+  defaulted ? [...new Set([...listed, ...UNLISTED_TABS])] : listed,
 );
 const items = $derived(shown.map((id) => ({ id, label: labels[id] })));
 const active = $derived(
@@ -177,6 +206,9 @@ $effect(() => {
 {#snippet view()}
 <div class="planner" bind:this={root}>
   <Tabs tabs={items} {active} onchange={select} aria-label="Planner">
+    {#if reachable.includes('specs')}
+      <div hidden={active !== 'specs'}><SpecsPanel /></div>
+    {/if}
     {#if reachable.includes('cookbooks')}
       <div hidden={active !== 'cookbooks'}><CookbooksPanel /></div>
     {/if}

package/dist/planner/PlannerControls.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlannerControls.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/planner/PlannerControls.svelte.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAgB3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C;;;;GAIG;AACH,UAAU,oBAAqB,SAAQ,YAAY;IACjD;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,yBAAyB,CAAC;CAC7C;AA2MD,QAAA,MAAM,eAAe,0DAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}
+{"version":3,"file":"PlannerControls.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/planner/PlannerControls.svelte.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAkB3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C;;;;GAIG;AACH,UAAU,oBAAqB,SAAQ,YAAY;IACjD;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,yBAAyB,CAAC;CAC7C;AA2OD,QAAA,MAAM,eAAe,0DAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}

package/dist/planner/PlannerLifecycle.svelte

@@ -16,6 +16,7 @@ import { createPlannerAssistant } from './assistant.js';
 import { createPlannerGuide } from './guide.js';
 import { plannerController, plannerRuntime } from './instance.js';
 import type { PlannerProps } from './types.js';
+import { resetWorkspace } from './workspace.svelte.js';
 import { workspaceStorage } from './workspace-storage.js';
 
 let {
@@ -29,6 +30,7 @@ let {
   conversationalAction,
   nativeAssistant = false,
   links = 'path',
+  onreset,
 }: Pick<
   PlannerProps,
   | 'controller'
@@ -39,6 +41,7 @@ let {
   | 'initialConversation'
   | 'cookbookOffers'
   | 'conversationalAction'
+  | 'onreset'
 > & {
   nativeAssistant?: boolean;
   /** `'hash'` in the complete `Planner`, whose pages are fragment routes. */
@@ -106,6 +109,13 @@ onMount(() => {
     controller,
     ...(guide ? { guide } : {}),
     workspaceStorage: workspaceStorage(),
+    reset: (options = {}) =>
+      resetWorkspace({
+        controller,
+        dataSource,
+        nativeAssistant: privateNative,
+        ...(options.silent ? {} : { onreset }),
+      }),
     ...(assistant ? { assistant } : {}),
     ...(native
       ? {

package/dist/planner/PlannerLifecycle.svelte.d.ts

@@ -1,6 +1,6 @@
 import { type LinkMode } from './app.svelte.ts';
 import type { PlannerProps } from './types.ts';
-type $$ComponentProps = Pick<PlannerProps, 'controller' | 'basePath' | 'inference' | 'persistence' | 'onready' | 'initialConversation' | 'cookbookOffers' | 'conversationalAction'> & {
+type $$ComponentProps = Pick<PlannerProps, 'controller' | 'basePath' | 'inference' | 'persistence' | 'onready' | 'initialConversation' | 'cookbookOffers' | 'conversationalAction' | 'onreset'> & {
     nativeAssistant?: boolean;
     /** `'hash'` in the complete `Planner`, whose pages are fragment routes. */
     links?: LinkMode;

package/dist/planner/PlannerLifecycle.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlannerLifecycle.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/planner/PlannerLifecycle.svelte.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,QAAQ,EAAe,MAAM,iBAAiB,CAAC;AAI7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG9C,KAAK,gBAAgB,GAAI,IAAI,CAC5B,YAAY,EACV,YAAY,GACZ,UAAU,GACV,WAAW,GACX,aAAa,GACb,SAAS,GACT,qBAAqB,GACrB,gBAAgB,GAChB,sBAAsB,CACzB,GAAG;IACF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB,CAAC;AAkIF,QAAA,MAAM,gBAAgB,sDAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"PlannerLifecycle.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/planner/PlannerLifecycle.svelte.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,QAAQ,EAAe,MAAM,iBAAiB,CAAC;AAI7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI9C,KAAK,gBAAgB,GAAI,IAAI,CAC5B,YAAY,EACV,YAAY,GACZ,UAAU,GACV,WAAW,GACX,aAAa,GACb,SAAS,GACT,qBAAqB,GACrB,gBAAgB,GAChB,sBAAsB,GACtB,SAAS,CACZ,GAAG;IACF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB,CAAC;AA2IF,QAAA,MAAM,gBAAgB,sDAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}

package/dist/planner/bridge.d.ts

@@ -48,6 +48,8 @@ export interface PlannerCommandPortClient {
         kind: 'arrival' | 'addition' | 'control';
         control?: PlannerGuideControl;
         requestId?: string;
+        /** How long to keep the spotlight, 1–30 s; default 6 s. */
+        holdMs?: number;
     }): Promise<PlannerGuideResult>;
     dismissGuide(input: {
         generation: string;

package/dist/planner/bridge.d.ts.map

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

package/dist/planner/bridge.js

@@ -127,12 +127,22 @@ export function bindPlannerCommandPort(options) {
             else if (raw.type === 'guide') {
                 const input = raw.input;
                 if (!object(input) ||
-                    Object.keys(input).some((key) => !['generation', 'kind', 'requestId', 'control'].includes(key)) ||
+                    Object.keys(input).some((key) => ![
+                        'generation',
+                        'kind',
+                        'requestId',
+                        'control',
+                        'holdMs',
+                    ].includes(key)) ||
                     input.generation !== generation ||
                     !['arrival', 'addition', 'control'].includes(String(input.kind)) ||
                     (input.kind === 'control' &&
-                        !['build', 'export', 'chef', 'edit'].includes(String(input.control))) ||
+                        !['build', 'export', 'chef', 'edit', 'specs', 'styles'].includes(String(input.control))) ||
                     (input.kind !== 'control' && input.control !== undefined) ||
+                    (input.holdMs !== undefined &&
+                        (typeof input.holdMs !== 'number' ||
+                            !Number.isFinite(input.holdMs) ||
+                            input.holdMs < 0)) ||
                     !options.guide)
                     value = {
                         ok: false,
@@ -142,9 +152,13 @@ export function bindPlannerCommandPort(options) {
                     value = await options.guide.highlight({
                         kind: 'control',
                         control: input.control,
+                        holdMs: input.holdMs,
                     });
                 else if (input.kind === 'arrival')
-                    value = await options.guide.highlight({ kind: 'arrival' });
+                    value = await options.guide.highlight({
+                        kind: 'arrival',
+                        holdMs: input.holdMs,
+                    });
                 else {
                     const receipt = typeof input.requestId === 'string'
                         ? receipts.get(input.requestId)

package/dist/planner/commands/types.d.ts

@@ -2,7 +2,7 @@ import type { CommandError as EngineCommandError, CommandInputs as EngineCommand
 export { COOKBOOK_COMMANDS_VERSION as PLANNER_COMMANDS_VERSION } from '@happyvertical/smrt-core/cookbook/engine';
 export type { ExportData, RecipeChanges, RunOptions };
 /** The planner's tabs, in order. Navigation only; never part of the cookbook. */
-export declare const PLANNER_TAB_IDS: readonly ["cookbooks", "recipes", "features", "layout", "theme", "settings", "export"];
+export declare const PLANNER_TAB_IDS: readonly ["specs", "cookbooks", "recipes", "features", "layout", "theme", "settings", "export"];
 export type PlannerTabId = (typeof PLANNER_TAB_IDS)[number];
 /** Input of each command, keyed by the command's (tool) name. */
 export interface CommandInputs extends EngineCommandInputs {

package/dist/planner/commands/types.d.ts.map

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

package/dist/planner/commands/types.js

@@ -9,6 +9,7 @@
 export { COOKBOOK_COMMANDS_VERSION as PLANNER_COMMANDS_VERSION } from '@happyvertical/smrt-core/cookbook/engine';
 /** The planner's tabs, in order. Navigation only; never part of the cookbook. */
 export const PLANNER_TAB_IDS = [
+    'specs',
     'cookbooks',
     'recipes',
     'features',

package/dist/planner/guide.d.ts

@@ -1,6 +1,6 @@
 import type { ShellTargets } from '@happyvertical/smrt-svelte/workspace';
 import type { BatchResult, PlanSnapshot } from './commands/index.ts';
-export type PlannerGuideControl = 'build' | 'export' | 'chef' | 'edit';
+export type PlannerGuideControl = 'build' | 'export' | 'chef' | 'edit' | 'specs' | 'styles';
 export declare const PLANNER_GUIDE_CONTROLS: {
     build: {
         targetId: string;
@@ -17,6 +17,16 @@ export declare const PLANNER_GUIDE_CONTROLS: {
         label: string;
         description: string;
     };
+    specs: {
+        targetId: string;
+        label: string;
+        description: string;
+    };
+    styles: {
+        targetId: string;
+        label: string;
+        description: string;
+    };
     edit: {
         targetId: string;
         label: string;
@@ -33,13 +43,16 @@ export interface PlannerGuideResult {
 export interface PlannerGuideHandle {
     highlight(input: {
         kind: 'arrival';
+        holdMs?: number;
     } | {
         kind: 'control';
         control: PlannerGuideControl;
+        holdMs?: number;
     } | {
         kind: 'addition';
         before: PlanSnapshot;
         result: BatchResult;
+        holdMs?: number;
     }): Promise<PlannerGuideResult>;
     dismiss(): void;
 }
@@ -61,6 +74,13 @@ export declare function additionGuideTarget(before: PlanSnapshot, result: BatchR
         hidden: boolean;
     };
 } | undefined;
+/** Default spotlight lifetime, and the bounds a host may hold one for. */
+export declare const GUIDE_HOLD_MS: {
+    readonly default: 6000;
+    readonly min: 1000;
+    readonly max: 30000;
+};
+export declare function guideHold(holdMs: unknown): number;
 export declare function createPlannerGuide(options: {
     targets?: ShellTargets;
     isMounted: () => boolean;

package/dist/planner/guide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guide.d.ts","sourceRoot":"","sources":["../../src/lib/planner/guide.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAGzE,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAErE,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AACvE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;CA4BlC,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,kBAAkB;IACjC,SAAS,CACP,KAAK,EACD;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE,GACnB;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,mBAAmB,CAAA;KAAE,GACjD;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,WAAW,CAAA;KAAE,GAClE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC/B,OAAO,IAAI,IAAI,CAAC;CACjB;AACD,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW;;;;;;;;;;;;;;;;cAY5E;AACD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB,GAAG,kBAAkB,CA8ErB"}
+{"version":3,"file":"guide.d.ts","sourceRoot":"","sources":["../../src/lib/planner/guide.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAGzE,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAErE,MAAM,MAAM,mBAAmB,GAC3B,OAAO,GACP,QAAQ,GACR,MAAM,GACN,MAAM,GACN,OAAO,GACP,QAAQ,CAAC;AACb,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuClC,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,kBAAkB;IACjC,SAAS,CACP,KAAK,EACD;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACpC;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,mBAAmB,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAClE;QACE,IAAI,EAAE,UAAU,CAAC;QACjB,MAAM,EAAE,YAAY,CAAC;QACrB,MAAM,EAAE,WAAW,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GACJ,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC/B,OAAO,IAAI,IAAI,CAAC;CACjB;AACD,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW;;;;;;;;;;;;;;;;cAY5E;AACD,0EAA0E;AAC1E,eAAO,MAAM,aAAa;;;;CAAoD,CAAC;AAC/E,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAIjD;AACD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB,GAAG,kBAAkB,CAgFrB"}

package/dist/planner/guide.js

@@ -16,6 +16,16 @@ export const PLANNER_GUIDE_CONTROLS = {
         label: 'Plan the app',
         description: 'The chef hat opens Cookbooks, Recipes, Theme and Settings to plan your app.',
     },
+    specs: {
+        targetId: 'item:planner-specs',
+        label: 'Specs',
+        description: 'Specs holds anything your app must also do beyond its features.',
+    },
+    styles: {
+        targetId: 'item:planner-styles',
+        label: 'Styles',
+        description: 'Styles changes how your app looks: theme and settings.',
+    },
     edit: {
         targetId: 'item:layout-edit',
         label: 'Edit',
@@ -35,6 +45,13 @@ export function additionGuideTarget(before, result) {
             return { section, item };
     }
 }
+/** Default spotlight lifetime, and the bounds a host may hold one for. */
+export const GUIDE_HOLD_MS = { default: 6000, min: 1000, max: 30000 };
+export function guideHold(holdMs) {
+    return typeof holdMs === 'number' && Number.isFinite(holdMs)
+        ? Math.min(GUIDE_HOLD_MS.max, Math.max(GUIDE_HOLD_MS.min, holdMs))
+        : GUIDE_HOLD_MS.default;
+}
 export function createPlannerGuide(options) {
     let active;
     let clearHighlight;
@@ -66,6 +83,8 @@ export function createPlannerGuide(options) {
     return {
         dismiss,
         async highlight(input) {
+            // A host narrating the guide may hold it for as long as it speaks.
+            const hold = guideHold(input.holdMs);
             if (input.kind === 'arrival' && arrivalShown)
                 return { ok: false, reason: 'Arrival guidance was already shown.' };
             const request = ++ticket;
@@ -90,7 +109,7 @@ export function createPlannerGuide(options) {
                 };
             clear();
             active = node;
-            clearHighlight = highlightControl(node, 6000, {
+            clearHighlight = highlightControl(node, hold, {
                 presentation: 'spotlight',
                 dismissLabel: 'Dismiss guidance',
                 onDismiss: dismiss,
@@ -101,7 +120,7 @@ export function createPlannerGuide(options) {
                 arrivalShown = true;
             node.addEventListener('click', dismiss, { once: true });
             document.addEventListener('keydown', onKey);
-            timer = setTimeout(clear, 6000);
+            timer = setTimeout(clear, hold);
             return {
                 ok: true,
                 targetId: node.dataset.smrtTarget ?? targetId,

package/dist/planner/header-icons.d.ts

@@ -10,4 +10,10 @@
 export declare const CHEF_HAT_ICON = "M4 9.5a3.5 3.5 0 1 1 7 0a3.5 3.5 0 1 1-7 0zM13 9.5a3.5 3.5 0 1 1 7 0a3.5 3.5 0 1 1-7 0zM8 7a4 4 0 1 1 8 0a4 4 0 1 1-8 0zM6 9.5h12V15H6zM7 16.5h10a1 1 0 0 1 1 1V19a1 1 0 0 1-1 1H7a1 1 0 0 1-1-1v-1.5a1 1 0 0 1 1-1z";
 /** smrt-ui's preset icon for the export control. */
 export declare const EXPORT_ICON = "download";
+/** Specs: a bulleted list of requirements. Original drawing. */
+export declare const SPECS_ICON = "M4 5h3v3H4zM9 5.5h11v2H9zM4 10.5h3v3H4zM9 11h11v2H9zM4 16h3v3H4zM9 16.5h11v2H9z";
+/** Features: three tiles and a round one, like pieces to add. Original drawing. */
+export declare const FEATURES_ICON = "M4 4h7v7H4zM4 13h7v7H4zM13 13h7v7h-7zM16.5 3.5a4 4 0 1 1 0 8a4 4 0 1 1 0-8z";
+/** Styles: a drop of colour. Original drawing. */
+export declare const STYLES_ICON = "M12 2.5c3.5 4.2 6 7.4 6 10.5a6 6 0 0 1-12 0c0-3.1 2.5-6.3 6-10.5z";
 //# sourceMappingURL=header-icons.d.ts.map

package/dist/planner/header-icons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"header-icons.d.ts","sourceRoot":"","sources":["../../src/lib/planner/header-icons.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,yNAC8L,CAAC;AAEzN,oDAAoD;AACpD,eAAO,MAAM,WAAW,aAAa,CAAC"}
+{"version":3,"file":"header-icons.d.ts","sourceRoot":"","sources":["../../src/lib/planner/header-icons.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,yNAC8L,CAAC;AAEzN,oDAAoD;AACpD,eAAO,MAAM,WAAW,aAAa,CAAC;AAEtC,gEAAgE;AAChE,eAAO,MAAM,UAAU,oFAC4D,CAAC;AAEpF,mFAAmF;AACnF,eAAO,MAAM,aAAa,gFACqD,CAAC;AAEhF,kDAAkD;AAClD,eAAO,MAAM,WAAW,sEAC6C,CAAC"}

package/dist/planner/header-icons.js

@@ -10,3 +10,9 @@
 export const CHEF_HAT_ICON = 'M4 9.5a3.5 3.5 0 1 1 7 0a3.5 3.5 0 1 1-7 0zM13 9.5a3.5 3.5 0 1 1 7 0a3.5 3.5 0 1 1-7 0zM8 7a4 4 0 1 1 8 0a4 4 0 1 1-8 0zM6 9.5h12V15H6zM7 16.5h10a1 1 0 0 1 1 1V19a1 1 0 0 1-1 1H7a1 1 0 0 1-1-1v-1.5a1 1 0 0 1 1-1z';
 /** smrt-ui's preset icon for the export control. */
 export const EXPORT_ICON = 'download';
+/** Specs: a bulleted list of requirements. Original drawing. */
+export const SPECS_ICON = 'M4 5h3v3H4zM9 5.5h11v2H9zM4 10.5h3v3H4zM9 11h11v2H9zM4 16h3v3H4zM9 16.5h11v2H9z';
+/** Features: three tiles and a round one, like pieces to add. Original drawing. */
+export const FEATURES_ICON = 'M4 4h7v7H4zM4 13h7v7H4zM13 13h7v7h-7zM16.5 3.5a4 4 0 1 1 0 8a4 4 0 1 1 0-8z';
+/** Styles: a drop of colour. Original drawing. */
+export const STYLES_ICON = 'M12 2.5c3.5 4.2 6 7.4 6 10.5a6 6 0 0 1-12 0c0-3.1 2.5-6.3 6-10.5z';

package/dist/planner/header-nav.d.ts

@@ -0,0 +1,17 @@
+import type { PlannerTabId } from './commands/types.ts';
+/**
+ * The labelled header navigation (`headerNav: 'labelled'`): four buttons, each
+ * opening one group of the planner's configure tabs. Specs and Build are a
+ * single tab; Features and Styles keep their siblings together.
+ */
+export declare const NAV_GROUPS: readonly ["specs", "features", "styles", "build"];
+export type NavGroup = (typeof NAV_GROUPS)[number];
+/** The tabs each group shows in the tab strip, in order. */
+export declare const NAV_GROUP_TABS: Record<NavGroup, readonly PlannerTabId[]>;
+/** The tab each button opens. */
+export declare const NAV_GROUP_HREF: Record<NavGroup, string>;
+/** The group an active tab belongs to; the unlisted Layout tab sits with Features. */
+export declare function navGroupOf(tab: PlannerTabId): NavGroup;
+/** The tab a click on a group's button lands on: the current one if already inside the group. */
+export declare function navEntryTab(group: NavGroup, active: PlannerTabId): PlannerTabId;
+//# sourceMappingURL=header-nav.d.ts.map

package/dist/planner/header-nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-nav.d.ts","sourceRoot":"","sources":["../../src/lib/planner/header-nav.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,UAAU,mDAAoD,CAAC;AAC5E,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,4DAA4D;AAC5D,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAKpE,CAAC;AAEF,iCAAiC;AACjC,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAKnD,CAAC;AASF,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,GAAG,EAAE,YAAY,GAAG,QAAQ,CAKtD;AAED,iGAAiG;AACjG,wBAAgB,WAAW,CACzB,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,YAAY,GACnB,YAAY,CAKd"}

package/dist/planner/header-nav.js

@@ -0,0 +1,41 @@
+/**
+ * The labelled header navigation (`headerNav: 'labelled'`): four buttons, each
+ * opening one group of the planner's configure tabs. Specs and Build are a
+ * single tab; Features and Styles keep their siblings together.
+ */
+export const NAV_GROUPS = ['specs', 'features', 'styles', 'build'];
+/** The tabs each group shows in the tab strip, in order. */
+export const NAV_GROUP_TABS = {
+    specs: ['specs'],
+    features: ['cookbooks', 'recipes', 'features'],
+    styles: ['theme', 'settings'],
+    build: ['export'],
+};
+/** The tab each button opens. */
+export const NAV_GROUP_HREF = {
+    specs: '#/configure/specs/',
+    features: '#/configure/recipes/',
+    styles: '#/configure/theme/',
+    build: '#/configure/export/',
+};
+const GROUP_ENTRY = {
+    specs: 'specs',
+    features: 'recipes',
+    styles: 'theme',
+    build: 'export',
+};
+/** The group an active tab belongs to; the unlisted Layout tab sits with Features. */
+export function navGroupOf(tab) {
+    for (const group of NAV_GROUPS) {
+        if (NAV_GROUP_TABS[group].includes(tab))
+            return group;
+    }
+    return 'features';
+}
+/** The tab a click on a group's button lands on: the current one if already inside the group. */
+export function navEntryTab(group, active) {
+    return navGroupOf(active) === group &&
+        (NAV_GROUP_TABS[group].includes(active) || group === 'features')
+        ? active
+        : GROUP_ENTRY[group];
+}

package/dist/planner/instance.d.ts

@@ -18,5 +18,5 @@ export declare const plannerRuntime: {
  * The app's one planner controller: the assistant, the palette, a host page
  * and (later) the MCP and CLI servers all drive the planner through it.
  */
-export declare const plannerController: import("./commands/adapter.ts").PlannerController & Pick<import("./commands/adapter.ts").PlannerAdapter, "undo" | "cookbook" | "tools">;
+export declare const plannerController: import("./commands/adapter.ts").PlannerController & Pick<import("./commands/adapter.ts").PlannerAdapter, "cookbook" | "undo" | "tools">;
 //# sourceMappingURL=instance.d.ts.map

package/dist/planner/tab.svelte.d.ts

@@ -1,10 +1,10 @@
-export declare const PLANNER_TABS: readonly ["cookbooks", "recipes", "features", "layout", "theme", "settings", "export"];
+export declare const PLANNER_TABS: readonly ["specs", "cookbooks", "recipes", "features", "layout", "theme", "settings", "export"];
 export type PlannerTab = (typeof PLANNER_TABS)[number];
 /** `fallback` (Cookbooks) unless the query names another known tab. */
 export declare function parseTab(search: string, fallback?: PlannerTab): PlannerTab;
 /** The Planner page's active tab; the address bar mirrors it (`?tab=`). */
 declare class PlannerTabState {
-    active: "export" | "settings" | "features" | "recipes" | "theme" | "layout" | "cookbooks";
+    active: "export" | "settings" | "features" | "recipes" | "theme" | "specs" | "layout" | "cookbooks";
     fromSearch(search: string, fallback?: PlannerTab): void;
     /** The chef's hat from Export: `#/configure/` names no tab, so leave Export
      *  for the default rather than stay on it; any other tab is kept. */

package/dist/planner/tab.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tab.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/planner/tab.svelte.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,wFAQf,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,uEAAuE;AACvE,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,UAAwB,GACjC,UAAU,CAGZ;AAED,2EAA2E;AAC3E,cAAM,eAAe;IACnB,MAAM,oFAAmC;IAEzC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,UAAwB;IAI7D;yEACqE;IACrE,WAAW,CAAC,QAAQ,GAAE,UAAwB;CAG/C;AAED,eAAO,MAAM,UAAU,iBAAwB,CAAC"}
+{"version":3,"file":"tab.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/planner/tab.svelte.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,iGASf,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,uEAAuE;AACvE,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,UAAwB,GACjC,UAAU,CAGZ;AAED,2EAA2E;AAC3E,cAAM,eAAe;IACnB,MAAM,8FAAmC;IAEzC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,UAAwB;IAI7D;yEACqE;IACrE,WAAW,CAAC,QAAQ,GAAE,UAAwB;CAG/C;AAED,eAAO,MAAM,UAAU,iBAAwB,CAAC"}

package/dist/planner/tab.svelte.js

@@ -1,5 +1,6 @@
 import { TAB_PARAM } from "./query.js";
 export const PLANNER_TABS = [
+    'specs',
     'cookbooks',
     'recipes',
     'features',

package/dist/planner/types.d.ts

@@ -16,6 +16,14 @@ export interface PlannerHandle {
     nativeAssistant?: BrowserAssistantTransport;
     /** Complete Planner only: open/focus the ready native dock; false if unavailable. */
     openAssistant?: () => Promise<boolean>;
+    /**
+     * Reset the saved plan, samples and native thread as the Reset control does.
+     * `silent` skips the host's `onreset` (the host is the caller and already
+     * knows); returns false when storage could not be cleared.
+     */
+    reset?: (options?: {
+        silent?: boolean;
+    }) => boolean;
 }
 /** Detached, complete document and native thread captured together at action time. */
 export interface PlannerExportContext {
@@ -41,6 +49,19 @@ export interface PlannerProps {
      * too; the planner follows its `focus` tab.
      */
     controller?: PlannerController;
+    /**
+     * Complete Planner only: the header's navigation. `'icons'` (default) is the
+     * chef's hat and export icon. `'labelled'` shows four bordered, coloured
+     * buttons, Specs, Features, Styles and Build, each opening that group of
+     * configure tabs (`#/configure/specs/`, `recipes/`, `theme/`, `export/`);
+     * Features and Build keep the guide's `planner-customize` / `planner-export`
+     * targets, and Build uses `exportLabel` when set. The tab strip then shows
+     * only the opened button's group. Accents are the theme's info, success,
+     * tertiary and warning colours.
+     */
+    headerNav?: 'icons' | 'labelled';
+    /** Complete Planner only: visible native export label; blank/omitted keeps the icon-only default. */
+    exportLabel?: string;
     /** Complete Planner only: primary header action with the same export capture. */
     headerAction?: PlannerExportAction;
     /** Optional first primary Export action; native download remains available. */

package/dist/planner/types.d.ts.map

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

package/dist/smrt-version.d.ts

@@ -1,3 +1,3 @@
 /** The released smrt line the planner is built against (the `smrt` CLI version its commands name). */
-export declare const SMRT_VERSION = "0.57.18";
+export declare const SMRT_VERSION = "0.57.20";
 //# sourceMappingURL=smrt-version.d.ts.map

package/dist/smrt-version.js

@@ -1,4 +1,4 @@
 // Generated by scripts/write-smrt-version.ts from the installed
 // @happyvertical/smrt-core; do not edit. `pnpm version:smrt` refreshes it.
 /** The released smrt line the planner is built against (the `smrt` CLI version its commands name). */
-export const SMRT_VERSION = '0.57.18';
+export const SMRT_VERSION = '0.57.20';