@astryxdesign/cli 0.6.4 → 0.6.5-canary.01972bc

package/assets/docs/working-with-ai.doc.mjs

@@ -8,6 +8,7 @@ export const docs = {
   category: 'guide',
   description:
     'How to set up AI coding tools to generate correct component code.',
+  keywords: ['claude', 'cursor', 'codex', 'copilot', 'agents', 'mcp'],
 
   sections: [
     {
@@ -24,7 +25,8 @@ export const docs = {
       ],
     },
     {
-      title: 'Quick Start',
+      id: 'quick-start',
+      title: 'Set up agent docs',
       content: [
         {
           type: 'prose',
@@ -38,7 +40,7 @@ export const docs = {
         },
         {
           type: 'prose',
-          text: "That's it. The `init --features agents` command generates everything your AI needs (component index, behavioral rules, CLI reference, and package guidance from configured integrations) from the installed project. After a dependency bump, `astryx upgrade` reports a stale block and `astryx upgrade --apply` refreshes it.",
+          text: "That's it. The `init --features agents` command generates everything your AI needs (component index, behavioral rules, CLI reference, and package guidance from configured integrations) from the installed project. After a dependency bump, `astryx upgrade --from <old version>` reports a stale block and adding `--apply` refreshes it.",
         },
         {
           type: 'prose',
@@ -48,10 +50,12 @@ export const docs = {
           type: 'code',
           lang: 'bash',
           label: 'Manual options',
-          code: `npx @astryxdesign/cli init --features agents --agent claude    # .claude/CLAUDE.md
-npx @astryxdesign/cli init --features agents --agent cursor    # .cursorrules
+          code: `npx @astryxdesign/cli init --features agents --agent claude    # CLAUDE.md if present, else .claude/CLAUDE.md
+npx @astryxdesign/cli init --features agents --agent cursor    # .cursorrules if present, else AGENTS.md
 npx @astryxdesign/cli init --features agents --agent codex     # AGENTS.md (Copilot, Codex, etc.)
-npx @astryxdesign/cli init --features agents --agent muse      # AGENTS.md (Muse)`,
+npx @astryxdesign/cli init --features agents --agent hermes    # .hermes.md or HERMES.md if present, else AGENTS.md
+npx @astryxdesign/cli init --features agents --agent muse      # AGENTS.md (Muse)
+npx @astryxdesign/cli init --features agents --agent all       # every agent file present, else AGENTS.md and .claude/CLAUDE.md`,
         },
       ],
     },
@@ -82,14 +86,17 @@ npx @astryxdesign/cli init --features agents --agent muse      # AGENTS.md (Muse
       content: [
         {
           type: 'prose',
-          text: 'Cursor project rules aren\'t always picked up; it selects which rules to apply based on relevance. For reliable inclusion, install the design system context as a User Rule instead. User Rules live at ~/.cursor/rules/ and apply across all projects.',
+          text: 'Cursor reads project rules from `.cursor/rules/`. To keep the Astryx context in a rule of its own, write it there. Give a path relative to the project root, such as `.cursor/rules/astryx.mdc`; an absolute path is refused.',
         },
         {
           type: 'code',
           lang: 'bash',
-          label: 'Install as a Cursor user rule',
-          code: `mkdir -p ~/.cursor/rules
-npx @astryxdesign/cli init --features agents --agent-docs-path ~/.cursor/rules/xds.mdc`,
+          label: 'Install as a Cursor project rule',
+          code: `npx @astryxdesign/cli init --features agents --agent-docs-path .cursor/rules/astryx.mdc`,
+        },
+        {
+          type: 'prose',
+          text: 'Rerunning the same command rewrites only the Astryx block, so frontmatter you add above it (such as `alwaysApply: true`) stays.',
         },
       ],
     },
@@ -98,7 +105,7 @@ npx @astryxdesign/cli init --features agents --agent-docs-path ~/.cursor/rules/x
       content: [
         {
           type: 'prose',
-          text: 'Paste this into your AI before writing any component code. These three questions have a 0% pass rate without docs; models confidently guess wrong on all of them. If your AI can\'t answer them, it\'ll know to install the agent docs first.',
+          text: 'Paste this into your AI before writing any component code. If your AI can\'t answer these questions, it\'ll know to install the agent docs first.',
         },
         {
           type: 'code',
@@ -107,7 +114,7 @@ npx @astryxdesign/cli init --features agents --agent-docs-path ~/.cursor/rules/x
           code: `Before writing any Astryx code, check your knowledge:
 
 1. What is the correct import path for Button?
-2. How do you make an Dialog non-dismissible?
+2. How do you make a Dialog non-dismissible?
 3. What prop does Selector use for its items?
 
 If you don't know all three, run \`npx @astryxdesign/cli init --features agents\` to generate agent docs, then read the generated file.`,
@@ -131,33 +138,34 @@ If you don't know all three, run \`npx @astryxdesign/cli init --features agents\
         },
         {
           type: 'prose',
-          text: 'With this alias, agents use `astryx component --list` instead of guessing the binary path. The `--` separator is standard npm convention for passing flags to scripts.',
+          text: 'With this alias, agents run `npm run astryx -- component --list` instead of guessing the binary path. The `--` separator is standard npm convention for passing flags to scripts.',
         },
         {
           type: 'code',
           lang: 'bash',
           label: 'Reliable CLI invocation',
-          code: `astryx component --list
-astryx component Dialog --dense
-astryx docs styling --dense
-astryx docs tokens --dense`,
+          code: `npm run astryx -- component --list
+npm run astryx -- component Dialog --dense
+npm run astryx -- docs styling --full --detail brief
+npm run astryx -- docs tokens --dense`,
         },
       ],
     },
     {
-      title: 'The --dense Flag',
+      id: 'the-dense-flag',
+      title: 'Shorter output: --detail and --dense',
       content: [
         {
           type: 'prose',
-          text: 'Every CLI command supports --dense, which outputs a token-efficient format designed for AI context windows. Use it when pasting CLI output into a web-based AI tool like ChatGPT or Claude.',
+          text: 'For a shorter read, add `--detail brief` (one line per section) or `--detail compact`. `--dense` swaps in a shorter text where a doc ships one. Use them when pasting CLI output into a web-based AI tool like ChatGPT or Claude.',
         },
         {
           type: 'code',
           lang: 'bash',
-          label: 'Dense output for pasting into AI conversations',
-          code: `astryx component Dialog --dense
-astryx docs styling --dense
-astryx docs tokens --dense`,
+          label: 'Short output for pasting into AI conversations',
+          code: `astryx docs styling --full --detail brief
+astryx component Dialog --detail compact
+astryx docs principles --dense`,
         },
       ],
     },

package/assets/templates/blocks/components/InternationalizationProvider/InternationalizationProvider01ShippedLocale.tsx

@@ -4,7 +4,7 @@
 
 import {useState} from 'react';
 import {InternationalizationProvider} from '@astryxdesign/core/i18n';
-import frFR from '@astryxdesign/core/locales/fr-FR.json';
+import frFR from '@astryxdesign/core/locales/fr-FR.generated.js';
 import {Stack} from '@astryxdesign/core/Layout';
 import {
   SegmentedControl,

package/assets/templates/pages/ai-chat/template.doc.mjs

@@ -5,7 +5,22 @@ export const doc = {
   type: 'page',
   name: 'AI Chat Conversation',
   displayName: 'AI Chat Conversation',
-  description: 'Transcript of alternating turns carrying mixed rich content inline (markdown, code blocks, collapsible tool-call output) beside a resizable artifact panel that holds generated output while the stream keeps scrolling. Chat, conversation, assistant, messages, or copilot thread.',
+  description:
+    'Transcript of alternating turns carrying mixed rich content inline (markdown, code blocks, collapsible tool-call output) beside a resizable artifact panel that holds generated output while the stream keeps scrolling.',
+  keywords: [
+    'chat',
+    'conversation',
+    'assistant',
+    'messages',
+    'copilot thread',
+    'agent',
+    'session',
+    'composer',
+    'questions',
+    'answers with citations',
+    'reasoning trace',
+    'prompt playground',
+  ],
   isReady: true,
   category: 'AI Chat - Conversation',
 };

package/assets/templates/pages/ai-chat-landing/template.doc.mjs

@@ -5,7 +5,15 @@ export const doc = {
   type: 'page',
   name: 'AI Chat Landing',
   displayName: 'AI Chat Landing',
-  description: 'Zero-state entry surface centered on a single composer with suggestion chips instead of history, sized for the moment before any content exists. The empty counterpart to a transcript. Chat, conversation, assistant, prompt, or messages launcher.',
+  description:
+    'Zero-state entry surface centered on a single composer with suggestion chips instead of history, sized for the moment before any content exists. The empty counterpart to a transcript.',
+  keywords: [
+    'chat',
+    'conversation',
+    'assistant',
+    'prompt',
+    'messages launcher',
+  ],
   isReady: true,
   category: 'AI Chat - Landing',
 };

package/assets/templates/pages/blank/template.doc.mjs

@@ -5,7 +5,9 @@ export const doc = {
   type: 'page',
   name: 'Blank',
   displayName: 'Blank',
-  description: 'Bare scaffold: one heading slot, one empty content region, no navigation and no chrome. The starting point when every other layout imposes more structure than wanted. Blank, empty, stub, placeholder, or minimal scaffold.',
+  description:
+    'Bare scaffold: one heading slot, one empty content region, no navigation and no chrome. The starting point when every other layout imposes more structure than wanted.',
+  keywords: ['blank', 'empty', 'stub', 'placeholder', 'minimal scaffold'],
   isReady: true,
   scaffold: true,
   category: 'Shell - Blank',

package/assets/templates/pages/canvas-editor/template.doc.mjs

@@ -6,7 +6,15 @@ export const doc = {
   name: 'Canvas Editor',
   displayName: 'Canvas Editor',
   description:
-    'Layered artboard workspace: document tabs over a layer rail, a fixed-size frame you zoom on a muted backdrop, and an inspector of position, type, and filter fields that retargets to the selected layer. Objects hold a coordinate rather than reflowing, so moving one never moves another. Design tool, artboard, poster, graphic, image, or slide editor.',
+    'Layered artboard workspace: document tabs over a layer rail, a fixed-size frame you zoom on a muted backdrop, and an inspector of position, type, and filter fields that retargets to the selected layer. Objects hold a coordinate rather than reflowing, so moving one never moves another.',
+  keywords: [
+    'design tool',
+    'artboard',
+    'poster',
+    'graphic',
+    'image',
+    'slide editor',
+  ],
   isReady: true,
   category: 'Tools - Canvas Editor',
 };

package/assets/templates/pages/centered-hero/template.doc.mjs

@@ -5,7 +5,9 @@ export const doc = {
   type: 'page',
   name: 'Centered Hero',
   displayName: 'Centered Hero',
-  description: 'Symmetrical centered stack (headline, short blurb, paired call-to-action buttons) resting on one wide full-bleed picture, with nothing on either flank competing. Hero, banner, splash, landing image, or marketing masthead.',
+  description:
+    'Symmetrical centered stack (headline, short blurb, paired call-to-action buttons) resting on one wide full-bleed picture, with nothing on either flank competing.',
+  keywords: ['hero', 'banner', 'splash', 'landing image', 'marketing masthead'],
   isReady: true,
   category: 'Gallery - Hero',
 };

package/assets/templates/pages/checkout-wizard/template.doc.mjs

@@ -7,6 +7,7 @@ export const doc = {
   displayName: 'Checkout Wizard',
   description:
     'Multi-step checkout, cart, order, and payment wizard with a running summary that recalculates as answers change. It adapts to its host width, renders the summary first on narrow surfaces, validates every forward path, and completes locally without sending payment.',
+  keywords: ['checkout', 'cart', 'order', 'payment'],
   isReady: true,
   category: 'Form - Checkout',
 };

package/assets/templates/pages/classic-gallery/template.doc.mjs

@@ -4,7 +4,9 @@
 export const doc = {
   name: 'Classic Gallery',
   displayName: 'Classic Gallery',
-  description: 'Uniform grid of equal-ratio media tiles under a centered intro, with filter tabs that narrow the set in place. Regular rhythm, unlike the variable-height masonry variant. Gallery, photos, images, pictures, or portfolio index.',
+  description:
+    'Uniform grid of equal-ratio media tiles under a centered intro, with filter tabs that narrow the set in place. Regular rhythm, unlike the variable-height masonry variant.',
+  keywords: ['gallery', 'photos', 'images', 'pictures', 'portfolio index'],
   type: 'page',
   isReady: true,
   category: 'Gallery - Basic',

package/assets/templates/pages/contact-form/template.doc.mjs

@@ -5,7 +5,22 @@ export const doc = {
   type: 'page',
   name: 'Contact Form',
   displayName: 'Contact Form',
-  description: 'Flat single-column form mixing control types (text, pill toggles, dropdowns, long free-text) landing on one full-width submit. No steps, no branching, no summary rail. Contact, lead capture, enquiry, survey, or intake form.',
+  description:
+    'Flat single-column form mixing control types (text, pill toggles, dropdowns, long free-text) landing on one full-width submit. No steps, no branching, no summary rail.',
+  keywords: [
+    'contact',
+    'lead capture',
+    'enquiry',
+    'survey',
+    'intake form',
+    'questionnaire',
+    'feedback',
+    'request',
+    'submission',
+    'entry',
+    'fields',
+    'upload',
+  ],
   isReady: true,
   category: 'Form - Basic',
 };

package/assets/templates/pages/dashboard/template.doc.mjs

@@ -6,7 +6,21 @@ export const doc = {
   name: 'Analytics Dashboard',
   displayName: 'Analytics Dashboard',
   description:
-    'Three-band analytics: a row of headline tiles, then charts, then supporting tables, all re-reading from one global filter bar. Breadth over depth, a summary surface rather than a drill-down. Dashboard, overview, metrics, stats, analytics, reporting, or insights.',
+    'Three-band analytics: a row of headline tiles, then charts, then supporting tables, all re-reading from one global filter bar. Breadth over depth, a summary surface rather than a drill-down.',
+  keywords: [
+    'dashboard',
+    'overview',
+    'metrics',
+    'stats',
+    'analytics',
+    'reporting',
+    'insights',
+    'kpi tiles',
+    'widgets',
+    'donut charts',
+    'breakdowns',
+    'forecasts',
+  ],
   isReady: true,
   category: 'Dashboard - Analytics',
 };

package/assets/templates/pages/dashboard-alert-rail/template.doc.mjs

@@ -6,7 +6,29 @@ export const doc = {
   name: 'Service Monitoring Dashboard',
   displayName: 'Service Monitoring Dashboard',
   description:
-    'Always-on analytics with a triage rail: status-colored tiles with sparklines, multi-series time charts over a switchable window, and an independently scrolling alert column that folds into the content when narrow. Monitoring, uptime, health, latency, alerting, incidents, or observability.',
+    'Always-on analytics with a triage rail: status-colored tiles with sparklines, multi-series time charts over a switchable window, and an independently scrolling alert column that folds into the content when narrow.',
+  keywords: [
+    'monitoring',
+    'uptime',
+    'health',
+    'latency',
+    'alerting',
+    'incidents',
+    'observability',
+    'operations',
+    'live status',
+    'real-time',
+    'reliability',
+    'traffic',
+    'anomalies',
+    'severity',
+    'on-call',
+    'oncall',
+    'fleet',
+    'pipelines',
+    'freshness',
+    'command center',
+  ],
   isReady: true,
   category: 'Dashboard - Monitoring',
 };

package/assets/templates/pages/dashboard-cohort-funnel/template.doc.mjs

@@ -6,7 +6,16 @@ export const doc = {
   name: 'Funnel & Cohort Dashboard',
   displayName: 'Funnel & Cohort Dashboard',
   description:
-    'Analytics for sequence and retention questions, pairing two shapes a plain dashboard cannot hold: a staged funnel where each step reads as drop-off against the one before, and a two-axis cohort matrix rendered as a heatmap. Conversion, drop-off, activation, churn, or retention reporting.',
+    'Analytics for sequence and retention questions, pairing two shapes a plain dashboard cannot hold: a staged funnel where each step reads as drop-off against the one before, and a two-axis cohort matrix rendered as a heatmap.',
+  keywords: [
+    'conversion',
+    'drop-off',
+    'activation',
+    'churn',
+    'retention reporting',
+    'stages',
+    'segments',
+  ],
   isReady: true,
   category: 'Dashboard - Funnel & Cohort',
 };

package/assets/templates/pages/dashboard-comparison/template.doc.mjs

@@ -6,7 +6,15 @@ export const doc = {
   name: 'Data Dashboard',
   displayName: 'Data Dashboard',
   description:
-    'Comparison-heavy analytics behind a persistent filter bar: tiles that each carry an inline sparkline and several period-over-period deltas, then segmented breakdowns underneath. Every number is shown against another number. Dashboard, metrics, stats, analytics, trends, or reporting.',
+    'Comparison-heavy analytics behind a persistent filter bar: tiles that each carry an inline sparkline and several period-over-period deltas, then segmented breakdowns underneath. Every number is shown against another number.',
+  keywords: [
+    'dashboard',
+    'metrics',
+    'stats',
+    'analytics',
+    'trends',
+    'reporting',
+  ],
   isReady: true,
   category: 'Dashboard - Comparison',
 };

package/assets/templates/pages/dashboard-composition/template.doc.mjs

@@ -6,7 +6,16 @@ export const doc = {
   name: 'Portfolio Dashboard',
   displayName: 'Portfolio Dashboard',
   description:
-    'Analytics for a value-over-time question: balance and change tiles above a stacked area chart of composition through time, closing on a ranked table of the largest contributors. Portfolio, holdings, positions, returns, allocation, investments, or performance reporting.',
+    'Analytics for a value-over-time question: balance and change tiles above a stacked area chart of composition through time, closing on a ranked table of the largest contributors.',
+  keywords: [
+    'portfolio',
+    'holdings',
+    'positions',
+    'returns',
+    'allocation',
+    'investments',
+    'performance reporting',
+  ],
   isReady: true,
   category: 'Dashboard - Portfolio',
 };

package/assets/templates/pages/dashboard-progress/template.doc.mjs

@@ -6,7 +6,23 @@ export const doc = {
   name: 'Project Status Dashboard',
   displayName: 'Project Status Dashboard',
   description:
-    'Status analytics mixing progress and time-axis shapes: a completion donut, a horizontal timeline of dated bars against a today marker, a per-owner table with progress and status, an at-risk list, and a burndown. Project, program, milestone, roadmap, launch, or delivery status.',
+    'Status analytics mixing progress and time-axis shapes: a completion donut, a horizontal timeline of dated bars against a today marker, a per-owner table with progress and status, an at-risk list, and a burndown.',
+  keywords: [
+    'project',
+    'program',
+    'milestone',
+    'roadmap',
+    'launch',
+    'delivery status',
+    'workstreams and milestones',
+    'gates',
+    'blockers',
+    'gantt',
+    'rollout',
+    'release planning',
+    'readiness',
+    'tracker',
+  ],
   isReady: true,
   category: 'Dashboard - Project Status',
 };

package/assets/templates/pages/dashboard-scorecard/template.doc.mjs

@@ -6,7 +6,8 @@ export const doc = {
   name: 'Executive Summary Dashboard',
   displayName: 'Executive Summary Dashboard',
   description:
-    'Report-shaped analytics with a prose rail beside the charts: a scorecard of headline numbers with period deltas and status coloring, goal-attainment bars, a trend grid, and a written commentary column that folds beneath the content when narrow. Executive summary, business review, readout, or reporting.',
+    'Report-shaped analytics with a prose rail beside the charts: a scorecard of headline numbers with period deltas and status coloring, goal-attainment bars, a trend grid, and a written commentary column that folds beneath the content when narrow.',
+  keywords: ['executive summary', 'business review', 'readout', 'reporting'],
   isReady: true,
   category: 'Dashboard - Scorecard',
 };

package/assets/templates/pages/detail-page/template.doc.mjs

@@ -6,6 +6,14 @@ export const doc = {
   name: 'Order Detail',
   displayName: 'Order Detail',
   description: 'Single-record detail in two columns: a summary header with status and actions, a repeating line-item list, a totals block that sums it, and a chronological activity timeline in the rail. The shape for any record holding children plus a history: a customer order with shipping, an invoice, a transaction, or a job.',
+  keywords: [
+    'order',
+    'invoice',
+    'transaction',
+    'job',
+    'record detail',
+    'summary header',
+  ],
   isReady: true,
   category: 'Content - Order Detail',
 };

package/assets/templates/pages/documentation/template.doc.mjs

@@ -5,7 +5,16 @@ export const doc = {
   type: 'page',
   name: 'Documentation Catalog',
   displayName: 'Documentation Catalog',
-  description: 'Reference landing that is pure wayfinding: a banner above a grid of category cards linking into sections, with no article content on the surface itself. Documentation, docs, guide, handbook, reference, or API index.',
+  description:
+    'Reference landing that is pure wayfinding: a banner above a grid of category cards linking into sections, with no article content on the surface itself.',
+  keywords: [
+    'documentation',
+    'docs',
+    'guide',
+    'handbook',
+    'reference',
+    'api index',
+  ],
   isReady: true,
   category: 'Content - Documentation Catalog',
 };

package/assets/templates/pages/documentation-design/template.doc.mjs

@@ -5,7 +5,16 @@ export const doc = {
   type: 'page',
   name: 'Documentation Design',
   displayName: 'Documentation Design',
-  description: 'Reference article alternating prose with live rendered examples: an interactive preview, a property table, paired do and don\'t comparisons, and copyable code blocks. Documentation, docs, guide, reference, usage, or API entry.',
+  description:
+    'Reference article alternating prose with live rendered examples: an interactive preview, a property table, paired do and don\'t comparisons, and copyable code blocks.',
+  keywords: [
+    'documentation',
+    'docs',
+    'guide',
+    'reference',
+    'usage',
+    'api entry',
+  ],
   isReady: true,
   category: 'Content - Documentation Design',
 };

package/assets/templates/pages/documentation-technical/template.doc.mjs

@@ -5,7 +5,16 @@ export const doc = {
   type: 'page',
   name: 'Documentation Technical',
   displayName: 'Documentation Technical',
-  description: 'Reference article ordered as sequential numbered steps with code at each stage, plus callout cards for prerequisites and onward links. A linear walkthrough rather than a browsable reference. Getting started, install, setup, tutorial, quickstart, or onboarding guide.',
+  description:
+    'Reference article ordered as sequential numbered steps with code at each stage, plus callout cards for prerequisites and onward links. A linear walkthrough rather than a browsable reference.',
+  keywords: [
+    'getting started',
+    'install',
+    'setup',
+    'tutorial',
+    'quickstart',
+    'onboarding guide',
+  ],
   isReady: true,
   category: 'Content - Documentation Technical',
 };

package/assets/templates/pages/editor/template.doc.mjs

@@ -5,7 +5,15 @@ export const doc = {
   type: 'page',
   name: 'Page Editor',
   displayName: 'Page Editor',
-  description: 'Three-pane authoring workspace: a source palette on one flank, a live canvas in the middle, and an inspector that retargets to whatever is selected. Drag and drop to reorder, edit to see it render immediately. Builder, composer, drag and drop, page builder, or WYSIWYG editor.',
+  description:
+    'Three-pane authoring workspace: a source palette on one flank, a live canvas in the middle, and an inspector that retargets to whatever is selected. Drag and drop to reorder, edit to see it render immediately.',
+  keywords: [
+    'builder',
+    'composer',
+    'drag and drop',
+    'page builder',
+    'wysiwyg editor',
+  ],
   isReady: true,
   category: 'Tools - Page Editor',
 };

package/assets/templates/pages/file-explorer/template.doc.mjs

@@ -5,7 +5,9 @@ export const doc = {
   type: 'page',
   name: 'File Explorer',
   displayName: 'File Explorer',
-  description: 'Hierarchical browser that drills through nested levels as adjacent columns rather than replacing the list each time, with breadcrumb history, switchable list and grid density, and a metadata pane for the selected node. Files, folders, directory, tree, or Finder-style navigator.',
+  description:
+    'Hierarchical browser that drills through nested levels as adjacent columns rather than replacing the list each time, with breadcrumb history, switchable list and grid density, and a metadata pane for the selected node.',
+  keywords: ['files', 'folders', 'directory', 'tree', 'finder-style navigator'],
   isReady: true,
   category: 'Tools - File Explorer',
 };

package/assets/templates/pages/form-two-column/template.doc.mjs

@@ -5,7 +5,23 @@ export const doc = {
   type: 'page',
   name: 'Two-column Form',
   displayName: 'Two-column Form',
-  description: 'Form split into two columns beneath a hero header: inputs on one flank, a persistent context panel opposite that stays put while the fields scroll. Flat, single submit, no steps. Contact, lead capture, intake, request, or enquiry form.',
+  description:
+    'Form split into two columns beneath a hero header: inputs on one flank, a persistent context panel opposite that stays put while the fields scroll. Flat, single submit, no steps.',
+  keywords: [
+    'contact',
+    'lead capture',
+    'intake',
+    'request',
+    'enquiry form',
+    'configurator',
+    'generator',
+    'launcher',
+    'calculator',
+    'checklist',
+    'upload',
+    'live preview',
+    'side panel',
+  ],
   isReady: true,
   category: 'Form - Two-column',
 };

package/assets/templates/pages/form-wizard/template.doc.mjs

@@ -6,7 +6,20 @@ export const doc = {
   name: 'Form Wizard',
   displayName: 'Form Wizard',
   description:
-    'Linear multi-step form that moves through one panel at a time, with a horizontal progress track pinned above rather than running down a rail, so every step keeps the full content width for its fields. Only the current step renders, unlike an accordion where each section expands into one long scrolling form. Each advance is validated, and a step left broken stays flagged to jump back to. Wizard, stepper, multi-step, onboarding, setup, signup, or guided flow.',
+    'Linear multi-step form that moves through one panel at a time, with a horizontal progress track pinned above rather than running down a rail, so every step keeps the full content width for its fields. Only the current step renders, unlike an accordion where each section expands into one long scrolling form. Each advance is validated, and a step left broken stays flagged to jump back to.',
+  keywords: [
+    'wizard',
+    'stepper',
+    'multi-step',
+    'onboarding',
+    'setup',
+    'signup',
+    'guided flow',
+    'step-by-step',
+    'workflow',
+    'review step',
+    'request flow',
+  ],
   isReady: true,
   category: 'Form - Wizard',
 };

package/assets/templates/pages/form-wizard-dialog/template.doc.mjs

@@ -7,6 +7,7 @@ export const doc = {
   displayName: 'Dialog Wizard',
   description:
     'Step through a short flow in a dialog, overlay, or popup launched from the page underneath, which stays where it was. Compact step markers and a pinned action row inside a constrained width, rather than the full page a wizard usually gets. Best for two to four short steps — setup, invite, schedule, onboarding — where losing the context underneath would cost more than the flow is worth.',
+  keywords: ['setup', 'invite', 'schedule', 'onboarding'],
   isReady: true,
   category: 'Form - Wizard Dialog',
 };

package/assets/templates/pages/gallery-hero/template.doc.mjs

@@ -5,7 +5,16 @@ export const doc = {
   type: 'page',
   name: 'Gallery Hero',
   displayName: 'Gallery Hero',
-  description: 'Centered stack (headline, short blurb, call-to-action buttons) resolving into a multi-image photo grid rather than one wide full-bleed picture, so the imagery reads as a set. Hero, banner, splash, landing image, masthead, or gallery intro.',
+  description:
+    'Centered stack (headline, short blurb, call-to-action buttons) resolving into a multi-image photo grid rather than one wide full-bleed picture, so the imagery reads as a set.',
+  keywords: [
+    'hero',
+    'banner',
+    'splash',
+    'landing image',
+    'masthead',
+    'gallery intro',
+  ],
   isReady: true,
   category: 'Gallery - Hero',
 };

package/assets/templates/pages/ide/template.doc.mjs

@@ -5,7 +5,15 @@ export const doc = {
   type: 'page',
   name: 'IDE',
   displayName: 'IDE',
-  description: 'Dense multi-pane workspace of resizable, collapsible regions: a hierarchy tree on one flank, tabbed documents in the middle, a docked drawer along the bottom, an inspector opposite. Drag a divider to resize or collapse any of them. Editor, IDE, workbench, terminal, or development environment.',
+  description:
+    'Dense multi-pane workspace of resizable, collapsible regions: a hierarchy tree on one flank, tabbed documents in the middle, a docked drawer along the bottom, an inspector opposite. Drag a divider to resize or collapse any of them.',
+  keywords: [
+    'editor',
+    'ide',
+    'workbench',
+    'terminal',
+    'development environment',
+  ],
   isReady: true,
   category: 'Tools - IDE',
 };

package/assets/templates/pages/incident-console/template.doc.mjs

@@ -5,7 +5,16 @@ export const doc = {
   type: 'page',
   name: 'Incident Console',
   displayName: 'Incident Console',
-  description: 'Dense row queue with an inspector: severity-coded rows grouped by status, a saved-search filter bar, a segmented status control, and a resizable detail pane for the selected row. Rows, not cards, sized for scanning volume. Incident, alert, on-call, outage, ticket, or triage console.',
+  description:
+    'Dense row queue with an inspector: severity-coded rows grouped by status, a saved-search filter bar, a segmented status control, and a resizable detail pane for the selected row. Rows, not cards, sized for scanning volume.',
+  keywords: [
+    'incident',
+    'alert',
+    'on-call',
+    'outage',
+    'ticket',
+    'triage console',
+  ],
   isReady: false,
   category: 'Tools - Incident Console',
 };