@happyvertical/smrt-planner 0.57.17 → 0.57.19

package/dist/components/HeaderIconLink.svelte

@@ -1,11 +1,16 @@
 <script lang="ts">
 /**
- * An icon-only link in the shell header's end slot: the planner's "Plan the
+ * A normally icon-only link in the shell header's end slot: the planner's "Plan the
  * app" (chef's hat) and "Export the app" (download) controls, in the mounted
  * `Planner` and the static app's layout alike. `label` is the accessible name
- * and the tooltip; `current` marks the control whose page is open
+ * and the tooltip; `showLabel` opts into visible text. `current` marks the control whose page is open
  * (`aria-current="page"`); `transitionName` is the `view-transition-name` it
  * carries while a route transition runs (one per control, unique on screen).
+ *
+ * `tone` turns it into one of the labelled header navigation buttons
+ * (`headerNav: 'labelled'`): a bordered button with icon and visible text in
+ * its own theme colour (info, success, tertiary, warning). A host overrides
+ * `--smrt-header-icon-link-accent` on `[data-tone='…']` to recolour one.
  */
 import {
   shellTargetAction,
@@ -17,11 +22,15 @@ interface Props {
   href: string;
   guideTarget?: string;
   label: string;
+  /** Opt-in visible text for a host-labelled action; other links stay icon-only. */
+  showLabel?: boolean;
   /** A smrt-ui preset icon name. */
   icon?: string;
   /** A custom icon path (wins over `icon`). */
   path?: string;
   current?: boolean;
+  /** Labelled navigation button: its accent colour; implies visible text. */
+  tone?: 'specs' | 'features' | 'styles' | 'build';
   transitionName: string;
   onclick?: (event: MouseEvent) => void;
 }
@@ -30,9 +39,11 @@ let {
   href,
   guideTarget,
   label,
+  showLabel = false,
   icon,
   path,
   current = false,
+  tone,
   transitionName,
   onclick,
 }: Props = $props();
@@ -42,6 +53,9 @@ const target = shellTargetAction(tryUseShellTargets());
 <a
   use:target={guideTarget ?? `item:${transitionName}`}
   class="header-link"
+  class:header-link--labelled={showLabel || tone !== undefined}
+  class:header-link--nav={tone !== undefined}
+  data-tone={tone}
   {href}
   aria-label={label}
   title={label}
@@ -50,6 +64,7 @@ const target = shellTargetAction(tryUseShellTargets());
   {onclick}
 >
   <Icon {path} name={path ? undefined : icon} size={18} />
+  {#if showLabel || tone}<span>{label}</span>{/if}
 </a>
 
 <style>
@@ -66,6 +81,13 @@ const target = shellTargetAction(tryUseShellTargets());
     color: inherit;
     border-radius: var(--smrt-radius-medium, 0.5rem);
   }
+  .header-link--labelled {
+    display: inline-flex;
+    gap: var(--smrt-spacing-1);
+    inline-size: auto;
+    padding-inline: var(--smrt-spacing-2);
+    white-space: nowrap;
+  }
   .header-link:hover {
     background: color-mix(in srgb, currentColor calc(var(--smrt-state-hover) * 100%), transparent);
   }
@@ -77,6 +99,68 @@ const target = shellTargetAction(tryUseShellTargets());
     background: var(--smrt-color-secondary-container, rgb(0 0 0 / 12%));
     color: var(--smrt-color-primary);
   }
+  /* The labelled navigation buttons. The accent is the border, the icon and a
+     tint; the text stays the theme's own on-surface colour, so its contrast is
+     the theme's whatever the accent. The icon and border mix the accent toward
+     on-surface (a darker tone in light schemes, a lighter one in dark), so
+     they stay at 3:1 or better against the surface in both. */
+  .header-link--nav {
+    --smrt-header-icon-link-accent: var(--smrt-color-info);
+    --smrt-header-icon-link-ink: color-mix(in srgb, var(--smrt-header-icon-link-accent) 60%, var(--smrt-color-on-surface, CanvasText));
+    gap: var(--smrt-spacing-2);
+    block-size: 2.25rem;
+    padding-inline: var(--smrt-spacing-3);
+    border: 0.125rem solid var(--smrt-header-icon-link-ink);
+    border-radius: var(--smrt-radius-medium, 0.5rem);
+    background: color-mix(in srgb, var(--smrt-header-icon-link-accent) 14%, var(--smrt-color-surface, Canvas));
+    color: var(--smrt-color-on-surface, CanvasText);
+    font-weight: 600;
+    text-decoration: none;
+  }
+  .header-link--nav[data-tone='features'] {
+    --smrt-header-icon-link-accent: var(--smrt-color-success);
+  }
+  .header-link--nav[data-tone='styles'] {
+    --smrt-header-icon-link-accent: var(--smrt-color-tertiary);
+  }
+  .header-link--nav[data-tone='build'] {
+    --smrt-header-icon-link-accent: var(--smrt-color-warning);
+  }
+  .header-link--nav :global(svg) {
+    color: var(--smrt-header-icon-link-ink);
+  }
+  .header-link--nav:hover {
+    background: color-mix(in srgb, var(--smrt-header-icon-link-accent) 28%, var(--smrt-color-surface, Canvas));
+  }
+  .header-link--nav[aria-current='page'] {
+    background: color-mix(in srgb, var(--smrt-header-icon-link-accent) 32%, var(--smrt-color-surface, Canvas));
+    color: var(--smrt-color-on-surface, CanvasText);
+    box-shadow: inset 0 -0.25rem 0 var(--smrt-header-icon-link-ink);
+  }
+  /* Phone footer bar: four buttons share the row, icon over text. */
+  @media (max-width: 30rem) {
+    .header-link--nav {
+      flex: 1 1 0;
+      min-inline-size: 0;
+      flex-direction: column;
+      gap: 0;
+      block-size: auto;
+      padding: var(--smrt-spacing-1);
+      font-size: 0.6875rem;
+      line-height: 1.2;
+    }
+    .header-link--nav :global(span) {
+      max-inline-size: 100%;
+      overflow: hidden;
+      text-overflow: ellipsis;
+    }
+  }
+  @media (max-width: 20rem) {
+    .header-link--nav {
+      font-size: 0.625rem;
+      border-width: 0.0625rem;
+    }
+  }
   /* Named only while a transition runs, as in Planner.svelte: a permanent
      name makes a stacking context. */
   :global([data-smrt-view-transition]) .header-link {
@@ -89,6 +173,26 @@ const target = shellTargetAction(tryUseShellTargets());
       background: Highlight;
       color: HighlightText;
     }
+    .header-link--nav {
+      border-color: ButtonText;
+      background: ButtonFace;
+      color: ButtonText;
+    }
+    .header-link--nav :global(svg) {
+      color: ButtonText;
+    }
+    .header-link--nav:hover {
+      border-color: Highlight;
+    }
+    .header-link--nav[aria-current='page'] {
+      border-color: Highlight;
+      background: Highlight;
+      color: HighlightText;
+      box-shadow: none;
+    }
+    .header-link--nav[aria-current='page'] :global(svg) {
+      color: HighlightText;
+    }
   }
 }
 </style>

package/dist/components/HeaderIconLink.svelte.d.ts

@@ -2,11 +2,15 @@ interface Props {
     href: string;
     guideTarget?: string;
     label: string;
+    /** Opt-in visible text for a host-labelled action; other links stay icon-only. */
+    showLabel?: boolean;
     /** A smrt-ui preset icon name. */
     icon?: string;
     /** A custom icon path (wins over `icon`). */
     path?: string;
     current?: boolean;
+    /** Labelled navigation button: its accent colour; implies visible text. */
+    tone?: 'specs' | 'features' | 'styles' | 'build';
     transitionName: string;
     onclick?: (event: MouseEvent) => void;
 }

package/dist/components/HeaderIconLink.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HeaderIconLink.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/HeaderIconLink.svelte.ts"],"names":[],"mappings":"AAkBA,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACvC;AA4BD,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}
+{"version":3,"file":"HeaderIconLink.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/HeaderIconLink.svelte.ts"],"names":[],"mappings":"AAuBA,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IACjD,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACvC;AA+BD,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/components/SpecsPanel.svelte

@@ -0,0 +1,54 @@
+<script lang="ts">
+import { cookbookStore } from '../cookbook/store.svelte.js';
+
+/**
+ * The Specs tab: the visitor's own product requirements, beyond what the
+ * chosen features cover. Saved in the cookbook (`specs`) and carried into the
+ * build prompt, so each keystroke goes straight through `setSpecs`.
+ */
+const LIMIT = 20000;
+// The store trims trailing whitespace, so the textarea keeps its own draft:
+// a typed space or new line at the end must not vanish mid-typing. Outside
+// changes (an import, an assistant append) replace the draft.
+let value = $state(cookbookStore.specs ?? '');
+$effect(() => {
+  const saved = cookbookStore.specs ?? '';
+  if (saved !== value.trimEnd()) value = saved;
+});
+const count = $derived(Array.from(value).length);
+</script>
+
+<section class="specs" aria-labelledby="planner-specs-heading">
+  <h2 id="planner-specs-heading">Specs</h2>
+  <p id="planner-specs-help" class="help">
+    What your app must also do beyond its features: unique rules, workflows,
+    integrations. They go into your build prompt and exported cookbook.
+  </p>
+  <textarea
+    id="planner-specs-input"
+    aria-labelledby="planner-specs-heading"
+    {value}
+    maxlength={LIMIT}
+    rows="14"
+    aria-describedby="planner-specs-help planner-specs-count"
+    placeholder={'Examples:\n- Customers can only book a class if their waiver is signed.\n- Send a Slack message when an order over $500 is paid.\n- Staff see their own schedule; managers see everyone\'s.'}
+    oninput={(event) => {
+      value = event.currentTarget.value;
+      cookbookStore.setSpecs(value);
+    }}
+  ></textarea>
+  <p id="planner-specs-count" class="count">{count.toLocaleString('en-US')} / {LIMIT.toLocaleString('en-US')}</p>
+</section>
+
+<style>
+@layer smrt.reset, smrt.structure, smrt.theme;
+@layer smrt.theme {
+  .specs { display: grid; gap: var(--smrt-spacing-3); max-inline-size: 48rem; }
+  h2, .help, .count { margin: 0; }
+  .help { color: var(--smrt-color-on-surface-variant); }
+  textarea { box-sizing: border-box; inline-size: 100%; min-block-size: 16rem; padding: var(--smrt-spacing-3); border: var(--smrt-control-border); border-radius: var(--smrt-radius-large, 0.75rem); background: var(--smrt-surface-control); color: var(--smrt-color-on-surface); font: inherit; line-height: 1.5; resize: vertical; }
+  textarea:focus-visible { outline: var(--smrt-focus-ring-width) solid var(--smrt-focus-ring-color); outline-offset: var(--smrt-focus-ring-offset); }
+  textarea::placeholder { color: var(--smrt-color-on-surface-variant); }
+  .count { justify-self: end; color: var(--smrt-color-on-surface-variant); font-size: 0.875rem; }
+}
+</style>

package/dist/components/SpecsPanel.svelte.d.ts

@@ -0,0 +1,4 @@
+declare const SpecsPanel: import("svelte").Component<Record<string, never>, {}, "">;
+type SpecsPanel = ReturnType<typeof SpecsPanel>;
+export default SpecsPanel;
+//# sourceMappingURL=SpecsPanel.svelte.d.ts.map

package/dist/components/SpecsPanel.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpecsPanel.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/SpecsPanel.svelte.ts"],"names":[],"mappings":"AA0CA,QAAA,MAAM,UAAU,2DAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/cookbook/assemble.d.ts

@@ -13,5 +13,6 @@ export declare function assembleCookbook(plan: PlanData, extras?: {
     overviews?: Record<string, OverviewOverride>;
     name?: string;
     description?: string;
+    specs?: string;
 }): Cookbook;
 //# sourceMappingURL=assemble.d.ts.map

package/dist/cookbook/assemble.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assemble.d.ts","sourceRoot":"","sources":["../../src/lib/cookbook/assemble.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,EAAE,KAAK,QAAQ,EAAc,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAqC,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE9E;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,QAAQ,EACd,MAAM,GAAE;IACN,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GACL,QAAQ,CAmBV"}
+{"version":3,"file":"assemble.d.ts","sourceRoot":"","sources":["../../src/lib/cookbook/assemble.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,EAAE,KAAK,QAAQ,EAAc,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAqC,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE9E;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,QAAQ,EACd,MAAM,GAAE;IACN,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,GACL,QAAQ,CAoBV"}

package/dist/cookbook/assemble.js

@@ -15,6 +15,8 @@ export function assembleCookbook(plan, extras = {}) {
         cookbook.name = extras.name;
     if (extras.description)
         cookbook.description = extras.description;
+    if (extras.specs)
+        cookbook.specs = extras.specs;
     if (extras.layout)
         cookbook.layout = extras.layout;
     const theme = compactTheme(extras.theme);

package/dist/cookbook/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/lib/cookbook/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAQhE,OAAO,EAIL,KAAK,cAAc,EAEpB,MAAM,YAAY,CAAC;AAUpB,2EAA2E;AAC3E,MAAM,MAAM,cAAc,GAAG,CAC3B,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,WAAW,GAAG,SAAS,KAC5B,eAAe,GAAG,IAAI,CAAC;AAE5B,MAAM,WAAW,oBAAoB;IACnC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,kFAAkF;IAClF,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAsFD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,oBAAyB,GACjC,cAAc,CAqKhB"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/lib/cookbook/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAQhE,OAAO,EAIL,KAAK,cAAc,EAEpB,MAAM,YAAY,CAAC;AAUpB,2EAA2E;AAC3E,MAAM,MAAM,cAAc,GAAG,CAC3B,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,WAAW,GAAG,SAAS,KAC5B,eAAe,GAAG,IAAI,CAAC;AAE5B,MAAM,WAAW,oBAAoB;IACnC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,kFAAkF;IAClF,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAsFD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,oBAAyB,GACjC,cAAc,CA4KhB"}

package/dist/cookbook/parse.js

@@ -231,6 +231,14 @@ export function parseCookbookWith(input, options = {}) {
         if (value.trim())
             cookbook[key] = value.trim();
     }
+    if (input.specs !== undefined) {
+        if (typeof input.specs !== 'string') {
+            return fail('The cookbook "specs" must be a string.');
+        }
+        // Keep internal newlines: specs are free text, not a one-line label.
+        if (input.specs.trim())
+            cookbook.specs = input.specs.trim();
+    }
     if (exposure && Object.keys(exposure).length)
         cookbook.exposure = exposure;
     if (layout)

package/dist/cookbook/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/lib/cookbook/prompt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;;;;;GAYG;AAEH,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AACnD,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAG7C,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,OAAO,SAAe,GAAG,MAAM,CAEzD;AAED,sHAAsH;AACtH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,SAAe,GACrB,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAiB,GAAG,MAAM,CAK5E;AAED,iFAAiF;AACjF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,iGAAiG;AACjG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAU1E;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CAkCb"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/lib/cookbook/prompt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;;;;;GAYG;AAEH,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AACnD,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAG7C,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,OAAO,SAAe,GAAG,MAAM,CAEzD;AAED,sHAAsH;AACtH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,SAAe,GACrB,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAiB,GAAG,MAAM,CAK5E;AAED,iFAAiF;AACjF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,iGAAiG;AACjG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAU1E;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CAwCb"}

package/dist/cookbook/prompt.js

@@ -83,6 +83,12 @@ export function buildAgentPrompt(cookbook, options = {}) {
         '',
         `(cd ${appName} && pnpm exec smrt app install)`,
         '',
+        ...(cookbook.specs?.trim()
+            ? [
+                `5. The cookbook's \`specs\` field lists product requirements beyond the recipes and features: after step 4, implement them in ${appName}, and report any you could not build.`,
+                '',
+            ]
+            : []),
         `If any step fails, run \`pnpm exec smrt app doctor\` inside ${appName} and include its findings in your report. Do not hand-edit the app's smrt.cookbook.json: change ${COOKBOOK_FILE} and run \`${cli} cookbook apply ${COOKBOOK_FILE} --into ${appName}\` instead.`,
         '',
     ].join('\n');

package/dist/cookbook/store.svelte.d.ts

@@ -23,9 +23,10 @@ export declare class CookbookStore {
     replacementGeneration: number;
     /** The shell layout, owned here and passed to `AppShell`. */
     layout: ShellLayout | undefined;
-    /** The app's name and description (`set_name`); not shown in the UI yet. */
+    /** The app's name, description and specs (`set_name`); specs show in the Specs tab. */
     name: string | undefined;
     description: string | undefined;
+    specs: string | undefined;
     /** The app's theme; undefined is the default. The shell applies it live. */
     theme: ThemeSetting | undefined;
     /**
@@ -71,6 +72,8 @@ export declare class CookbookStore {
     setOverview(id: string, override: OverviewOverride | null): void;
     /** An edit from the shell or its layout editor; an empty one clears it. */
     setLayout(next: ShellLayout): void;
+    /** The product specs from a text box: ends trimmed, blank clears. Saved like any other change. */
+    setSpecs(text: string): void;
     /** Replace everything from a validated cookbook. */
     apply(cookbook: Cookbook): void;
     /**

package/dist/cookbook/store.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/cookbook/store.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,6CAA6C,CAAC;AAIrD,OAAO,EACL,KAAK,WAAW,EAKjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAWpE,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG3D,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,uBAAuB,CAAC;AAEtD,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,iFAAiF;AACjF,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,IAAI,GAAG,QAAQ,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,GAAG,IAAI,CAgBzE;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,qBAAqB,SAAa;IAClC,6DAA6D;IAC7D,MAAM,0BAAqC;IAC3C,4EAA4E;IAC5E,IAAI,qBAAgC;IACpC,WAAW,qBAAgC;IAC3C,4EAA4E;IAC5E,KAAK,2BAAsC;IAC3C;;;OAGG;IACH,SAAS,mCAAoD;IAC7D,OAAO,eAAmC;IAC1C,0EAA0E;IAC1E,MAAM,UAAiB;IACvB,6EAA6E;IAC7E,WAAW,UAAS;IACpB,0DAA0D;IAC1D,UAAU,SAAc;IAExB;;;;;OAKG;IACH,OAAO,CAAC,WAAW,CAAS;IAC5B,4EAA4E;IAC5E,aAAa,UAAiB;IAE9B,8EAA8E;IAC9E,OAAO,CAAC,kBAAkB,CAAS;IAEnC,8EAA8E;IAC9E,OAAO,CAAC,YAAY,CAAS;IAE7B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,KAAK,CAA4C;IAEzD;;;;;OAKG;IACH,QAAQ,IAAI,QAAQ;IAapB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAI7C;;;OAGG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI;IAQhE,2EAA2E;IAC3E,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAIlC,oDAAoD;IACpD,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAU/B;;;OAGG;IACH,IAAI,iBAAiB,IAAI,MAAM,CAQ9B;IAED,0EAA0E;IAC1E,iBAAiB,IAAI,IAAI;IAKzB,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI;IAI9C,uFAAuF;IACvF,QAAQ,IAAI,WAAW;IAIvB,yEAAyE;IACzE,WAAW,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAMxC,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAQjC,2EAA2E;IAC3E,KAAK,CAAC,OAAO,GAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;IAatD,oFAAoF;IACpF,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAMxC;;;;OAIG;IACH,OAAO,CACL,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,OAAO,GAAG,IAAyB,GAC3C,OAAO;IA0CV,4EAA4E;IAC5E,IAAI,IAAI,OAAO;IAmBf,kDAAkD;IAClD,YAAY,IAAI,IAAI;IAMpB,+CAA+C;IAC/C,KAAK,IAAI,IAAI;CAGd;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}
+{"version":3,"file":"store.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/cookbook/store.svelte.ts"],"names":[],"mappings":"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"}

package/dist/cookbook/store.svelte.js

@@ -38,9 +38,10 @@ export class CookbookStore {
     replacementGeneration = $state(0);
     /** The shell layout, owned here and passed to `AppShell`. */
     layout = $state();
-    /** The app's name and description (`set_name`); not shown in the UI yet. */
+    /** The app's name, description and specs (`set_name`); specs show in the Specs tab. */
     name = $state();
     description = $state();
+    specs = $state();
     /** The app's theme; undefined is the default. The shell applies it live. */
     theme = $state();
     /**
@@ -83,6 +84,7 @@ export class CookbookStore {
             overviews: $state.snapshot(this.overviews),
             name: this.name,
             description: this.description,
+            specs: this.specs,
         });
     }
     /** A page's stored override, or `null` when it is on its defaults. */
@@ -103,6 +105,11 @@ export class CookbookStore {
     setLayout(next) {
         this.layout = isShellLayoutEmpty(next) ? undefined : next;
     }
+    /** The product specs from a text box: ends trimmed, blank clears. Saved like any other change. */
+    setSpecs(text) {
+        const clean = text.trimEnd();
+        this.specs = clean.trim() ? clean : undefined;
+    }
     /** Replace everything from a validated cookbook. */
     apply(cookbook) {
         recipeState.load(cookbook);
@@ -110,6 +117,7 @@ export class CookbookStore {
         this.theme = cookbook.theme;
         this.name = cookbook.name;
         this.description = cookbook.description;
+        this.specs = cookbook.specs;
         this.overviews = { ...(cookbook.overviews ?? {}) };
         followSettings(cookbook);
     }
@@ -165,6 +173,7 @@ export class CookbookStore {
             this.theme = undefined;
         this.name = undefined;
         this.description = undefined;
+        this.specs = undefined;
         this.overviews = {};
         this.saveBlocked = false;
         this.keepLegacyUrl = false;

package/dist/cookbook/types.d.ts

@@ -30,6 +30,8 @@ export interface Cookbook {
     name?: string;
     /** A line about the app (`set_name`). */
     description?: string;
+    /** Product requirements beyond recipes and features (`set_name`); agents treat it as requirements to build. */
+    specs?: string;
     /** Added recipe ids, sorted; requirements are already included. */
     recipes: string[];
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/cookbook/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,eAAe,iDAAiD,CAAC;AAE9E;;;GAGG;AACH,eAAO,MAAM,eAAe,kDAAkD,CAAC;AAE/E,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,gBAAgB,CAAC;IACjC,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;OAGG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8DAA8D;IAC9D,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;IAC7C,2EAA2E;IAC3E,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC9C;AAED,MAAM,MAAM,cAAc,GACtB;IACE,EAAE,EAAE,IAAI,CAAC;IACT,QAAQ,EAAE,QAAQ,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/cookbook/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,eAAe,iDAAiD,CAAC;AAE9E;;;GAGG;AACH,eAAO,MAAM,eAAe,kDAAkD,CAAC;AAE/E,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,gBAAgB,CAAC;IACjC,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+GAA+G;IAC/G,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;OAGG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8DAA8D;IAC9D,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;IAC7C,2EAA2E;IAC3E,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC9C;AAED,MAAM,MAAM,cAAc,GACtB;IACE,EAAE,EAAE,IAAI,CAAC;IACT,QAAQ,EAAE,QAAQ,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/core/index.d.ts

@@ -18,6 +18,7 @@
  *
  * @module
  */
+export { type AgentPrompt, type AgentPromptOptions, buildAgentPrompt, } from '../cookbook/prompt.ts';
 export { parseSampleContext, type SampleContext, sampleContextSchema, } from '../data/sample-context.ts';
 export { HOST_HISTORY_CHARS, HOST_HISTORY_TURNS, HOST_MESSAGE_CHARS, HOST_WIRE_VERSION, type HostRequest, } from '../inference/host.ts';
 export { buildCommandTools, COMMAND_NAMES, type CommandTool, checkSchema, commandSchemas, commandTools, type JsonSchema, } from '../planner/commands/schemas.ts';

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,kBAAkB,EAClB,KAAK,aAAa,EAClB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,WAAW,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,KAAK,WAAW,EAChB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,KAAK,UAAU,GAChB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,wBAAwB,EACxB,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,KAAK,aAAa,EAClB,cAAc,EACd,kBAAkB,EAClB,SAAS,EACT,KAAK,eAAe,EACpB,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,MAAM,EACX,OAAO,EACP,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,eAAe,EACf,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,QAAQ,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,cAAc,EACd,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,kBAAkB,EAClB,KAAK,aAAa,EAClB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,WAAW,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,KAAK,WAAW,EAChB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,KAAK,UAAU,GAChB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,wBAAwB,EACxB,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,KAAK,aAAa,EAClB,cAAc,EACd,kBAAkB,EAClB,SAAS,EACT,KAAK,eAAe,EACpB,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,MAAM,EACX,OAAO,EACP,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,eAAe,EACf,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,QAAQ,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,cAAc,EACd,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/core/index.js

@@ -18,6 +18,7 @@
  *
  * @module
  */
+export { buildAgentPrompt, } from "../cookbook/prompt.js";
 export { parseSampleContext, sampleContextSchema, } from "../data/sample-context.js";
 export { HOST_HISTORY_CHARS, HOST_HISTORY_TURNS, HOST_MESSAGE_CHARS, HOST_WIRE_VERSION, } from "../inference/host.js";
 export { buildCommandTools, COMMAND_NAMES, checkSchema, commandSchemas, commandTools, } from "../planner/commands/schemas.js";

package/dist/index.d.ts

@@ -7,6 +7,7 @@
  * @module
  */
 export type { BrowserAssistantTransport, PlannerConversationSeed, } from './assistant/transport.ts';
+export { type AgentPrompt, type AgentPromptOptions, buildAgentPrompt, } from './cookbook/prompt.ts';
 export { type ByoPresetDefinition, type ConfigResult, type CredentialPersistence, type InferenceConfig, type InferenceMode, loadInferenceConfig, parseInferenceConfig, } from './inference/config.ts';
 export { createHostChat, type HostChatOptions, type HostRequest, } from './inference/host.ts';
 export { createOpenAIChat, testConnection } from './inference/openai.ts';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,kBAAkB,EAClB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,KAAK,eAAe,EACpB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EACV,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EACL,KAAK,eAAe,EACpB,iBAAiB,EACjB,KAAK,QAAQ,EACb,KAAK,WAAW,GACjB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,yBAAyB,EACzB,YAAY,GACb,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,kBAAkB,EAClB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,KAAK,eAAe,EACpB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EACV,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EACL,KAAK,eAAe,EACpB,iBAAiB,EACjB,KAAK,QAAQ,EACb,KAAK,WAAW,GACjB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,yBAAyB,EACzB,YAAY,GACb,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -6,6 +6,7 @@
  *
  * @module
  */
+export { buildAgentPrompt, } from "./cookbook/prompt.js";
 export { loadInferenceConfig, parseInferenceConfig, } from "./inference/config.js";
 export { createHostChat, } from "./inference/host.js";
 export { createOpenAIChat, testConnection } from "./inference/openai.js";

package/dist/planner/Planner.svelte

@@ -48,7 +48,19 @@ import { sectionIdFromSlug } from '../sections/path.js';
 import { DEFAULT_PRESET } from '../theme/theme.js';
 import { appHref, setBasePath } from './app.svelte.js';
 import { PLANNER_TAB_IDS } from './commands/index.js';
-import { CHEF_HAT_ICON, EXPORT_ICON } from './header-icons.js';
+import {
+  CHEF_HAT_ICON,
+  EXPORT_ICON,
+  FEATURES_ICON,
+  SPECS_ICON,
+  STYLES_ICON,
+} from './header-icons.js';
+import {
+  NAV_GROUP_HREF,
+  type NavGroup,
+  navEntryTab,
+  navGroupOf,
+} from './header-nav.js';
 import { plannerRuntime } from './instance.js';
 import PlannerControls from './PlannerControls.svelte';
 import PlannerHostAction from './PlannerHostAction.svelte';
@@ -73,6 +85,8 @@ let {
   onready,
   entryMode = 'browse',
   exportAction,
+  exportLabel,
+  headerNav = 'icons',
   headerAction,
   initialConversation,
   cookbookOffers,
@@ -81,6 +95,11 @@ let {
   resetDisabledReason,
 }: PlannerProps = $props();
 
+const nativeExportLabel = $derived(exportLabel?.trim() || 'Export the app');
+const showExportLabel = $derived(Boolean(exportLabel?.trim()));
+const labelledNav = $derived(headerNav === 'labelled');
+const buildLabel = $derived(exportLabel?.trim() || 'Build');
+
 /** The mount's links: its pages are fragment routes, so no host router. */
 const hashHref = (path: string) => `#${path}`;
 // Before anything below renders a link: the planner-wide `appHref` writes
@@ -370,18 +389,47 @@ const slotItems = $derived<ShellSlotItem[]>([
         },
       ]
     : []),
-  {
-    id: 'planner-customize',
-    label: 'Plan the app',
-    slot: 'header.end' as const,
-    render: customize,
-  },
-  {
-    id: 'planner-export',
-    label: 'Export the app',
-    slot: 'header.end' as const,
-    render: exportLink,
-  },
+  ...(labelledNav
+    ? [
+        {
+          id: 'planner-specs',
+          label: 'Specs',
+          slot: 'header.end' as const,
+          render: specsNav,
+        },
+        {
+          id: 'planner-customize',
+          label: 'Features',
+          slot: 'header.end' as const,
+          render: featuresNav,
+        },
+        {
+          id: 'planner-styles',
+          label: 'Styles',
+          slot: 'header.end' as const,
+          render: stylesNav,
+        },
+        {
+          id: 'planner-export',
+          label: buildLabel,
+          slot: 'header.end' as const,
+          render: buildNav,
+        },
+      ]
+    : [
+        {
+          id: 'planner-customize',
+          label: 'Plan the app',
+          slot: 'header.end' as const,
+          render: customize,
+        },
+        {
+          id: 'planner-export',
+          label: nativeExportLabel,
+          slot: 'header.end' as const,
+          render: exportLink,
+        },
+      ]),
 ]);
 // The shell's own `dock:assistant` button (header end, the dock tab on phones)
 // opens the assistant dock; until the assistant can answer it is a link to the
@@ -425,6 +473,28 @@ const dockToggles = $derived(
   />
 {/snippet}
 
+<!-- Labelled header navigation (`headerNav: 'labelled'`): one button per tab
+     group. The route selects the tab; the click also does, for when the hash
+     is already there. -->
+{#snippet nav(group: NavGroup, label: string, transitionName: string, icon: { path?: string; name?: string })}
+  <HeaderIconLink
+    href={NAV_GROUP_HREF[group]}
+    {label}
+    path={icon.path}
+    icon={icon.name}
+    tone={group}
+    current={configuring && navGroupOf(plannerTab.active) === group}
+    {transitionName}
+    onclick={() => {
+      plannerTab.active = navEntryTab(group, plannerTab.active);
+    }}
+  />
+{/snippet}
+{#snippet specsNav()}{@render nav('specs', 'Specs', 'planner-specs', { path: SPECS_ICON })}{/snippet}
+{#snippet featuresNav()}{@render nav('features', 'Features', 'planner-customize', { path: FEATURES_ICON })}{/snippet}
+{#snippet stylesNav()}{@render nav('styles', 'Styles', 'planner-styles', { path: STYLES_ICON })}{/snippet}
+{#snippet buildNav()}{@render nav('build', buildLabel, 'planner-export', { name: EXPORT_ICON })}{/snippet}
+
 <!-- The chef's hat: the planner's own pages (Cookbooks, Recipes, Theme,
      Settings, Export), apart from the shell's pencil, which edits the layout. -->
 {#snippet customize()}
@@ -444,7 +514,8 @@ const dockToggles = $derived(
 {#snippet exportLink()}
   <HeaderIconLink
     href="#/configure/export/"
-    label="Export the app"
+    label={nativeExportLabel}
+    showLabel={showExportLabel}
     icon={EXPORT_ICON}
     current={exporting}
     transitionName="planner-export"
@@ -487,7 +558,7 @@ const dockToggles = $derived(
   {...plannerShellProps()}
 >
   <ThemeBridge deferInitial={persistence === 'host'} presetOverride={applyCookbookTheme(shell.theme)} />
-  <PlannerLifecycle {controller} {basePath} {inference} {persistence} {onready} {initialConversation} {cookbookOffers} {conversationalAction} nativeAssistant links="hash" />
+  <PlannerLifecycle {controller} {basePath} {inference} {persistence} {onready} {initialConversation} {cookbookOffers} {conversationalAction} nativeAssistant links="hash" onreset={resetProject} />
   <main class="content">
     {#if sectionSlug}
       {#if cookbookStore.loaded}
@@ -523,7 +594,7 @@ const dockToggles = $derived(
     {:else if entryMode === 'planning' && recipeState.ids.length === 0 && recipeState.features.length === 0 && (!route || /^\/configure\/?$/.test(route))}
       <section aria-label="App planning" role="status"><h1>Your app starts here</h1><p>The planner will show your app here as we plan it.</p><a href="#/configure/cookbooks/">Browse cookbooks</a></section>
     {:else}
-      <PlannerControls onreset={resetProject} {resetDisabledReason} {exportAction} {projectPersistence} nativeAssistant={assistant ? aiState.session.transport : undefined} {controller} {basePath} {inference} {persistence} {themeControls} {tabs} managedByParent layout="shell" advancedStylesHref="#/advanced-styles/" />
+      <PlannerControls onreset={resetProject} {resetDisabledReason} {exportAction} {projectPersistence} nativeAssistant={assistant ? aiState.session.transport : undefined} {controller} {basePath} {inference} {persistence} {themeControls} {tabs} {headerNav} managedByParent layout="shell" advancedStylesHref="#/advanced-styles/" />
     {/if}
   </main>
 </CookbookApp>