@almadar/core 10.104.0 → 10.106.0

package/dist/builders.d.ts

@@ -1,6 +1,6 @@
-import { I as IdentityLedger, A as AnyPatternConfig, U as UISlot, c as Effect, l as RenderBinding, m as RenderUIEffect, e as EntityId, f as Entity, E as EntityField, a as EntityPersistence, g as EntityRow } from './effect-DhsB3usU.js';
-import { a as OrbitalDefinition, O as OrbitalSchema, U as UseDeclaration, E as EntityRef, b as ExpectDeclaration, P as PageRef, c as Page, d as PageRefObject } from './schema-CjwAD-Y4.js';
-import { b as TraitConfig, h as Trait, T as TraitEventListener, i as CallSiteConfig, k as TraitEventContract, d as TraitRef, a as TraitReference } from './trait-DoFyUfui.js';
+import { I as IdentityLedger, A as AnyPatternConfig, U as UISlot, c as Effect, l as RenderBinding, m as RenderUIEffect, e as EntityId, f as Entity, E as EntityField, a as EntityPersistence, g as EntityRow } from './effect-DtAf51pB.js';
+import { a as OrbitalDefinition, O as OrbitalSchema, U as UseDeclaration, E as EntityRef, b as ExpectDeclaration, P as PageRef, c as Page, d as PageRefObject } from './schema-aRqGRPE_.js';
+import { b as TraitConfig, h as Trait, T as TraitEventListener, i as CallSiteConfig, k as TraitEventContract, d as TraitRef, a as TraitReference } from './trait-CzhNoRw4.js';
 import { S as SExpr } from './expression-CfeHdS-f.js';
 import 'zod';
 import './json-D8gmyK3l.js';

package/dist/{bus-DCYJF88B.d.ts → bus-CHi3QOOi.d.ts}

@@ -1,4 +1,4 @@
-import { F as FieldValue, S as ServerReportedEffect, N as NamespacedEffectName, g as EntityRow, d as OrbitalId, T as TraitId, b as EventId, h as PatternConfig, i as ResolvedPatternProps, A as AnyPatternConfig } from './effect-DhsB3usU.js';
+import { F as FieldValue, S as ServerReportedEffect, N as NamespacedEffectName, g as EntityRow, d as OrbitalId, T as TraitId, b as EventId, h as PatternConfig, i as ResolvedPatternProps, A as AnyPatternConfig } from './effect-DtAf51pB.js';
 import { z } from 'zod';
 import { a as EventPayloadValue, b as EventPayload } from './expression-CfeHdS-f.js';
 

package/dist/{effect-DhsB3usU.d.ts → effect-DtAf51pB.d.ts}

@@ -2840,8 +2840,8 @@ type EntityData = Record<string, EntityRow[]>;
  *
  * DO NOT EDIT MANUALLY — regenerated by almadar-pattern-sync `patterns` command.
  *
- * Generated: 2026-09-25T03:49:13.655Z
- * Pattern count: 246
+ * Generated: 2026-09-26T10:53:57.286Z
+ * Pattern count: 248
  */
 
 /**
@@ -2853,7 +2853,7 @@ type PatternPropValue = Record<string, FieldValue | undefined>;
  * All valid pattern type names from @almadar/core/patterns registry.
  * Use this type in render-ui effects for compile-time validation.
  */
-type PatternType = 'accordion' | 'action-palette' | 'action-tile' | 'activation-block' | 'alert' | 'algo-graph-canvas' | 'algorithm-canvas' | 'animated-counter' | 'animated-graphic' | 'animated-reveal' | 'aside' | 'atlas-image' | 'atlas-panel' | 'auth-layout' | 'avatar' | 'badge' | 'behavior-view' | 'biology-canvas' | 'bloom-quiz-block' | 'box' | 'branching-logic-builder' | 'breadcrumb' | 'button' | 'calendar-grid' | 'canvas' | 'canvas-2d' | 'card' | 'carousel' | 'center' | 'chart' | 'chart-legend' | 'chat-bar' | 'checkbox' | 'chemistry-canvas' | 'choice-button' | 'code-block' | 'code-runner-panel' | 'command-palette' | 'conditional-wrapper' | 'confetti-effect' | 'confirm-dialog' | 'connection-block' | 'container' | 'content-renderer' | 'control-button' | 'control-grid' | 'counter-template' | 'dashboard-grid' | 'dashboard-layout' | 'data-grid' | 'data-list' | 'date-range-picker' | 'date-range-selector' | 'day-cell' | 'detail-panel' | 'dialog' | 'dialogue-bubble' | 'divider' | 'doc-breadcrumb' | 'doc-pagination' | 'doc-search' | 'doc-sidebar' | 'doc-toc' | 'dock-layout' | 'document-details' | 'document-panel' | 'document-viewer' | 'draw-fx-layer' | 'draw-group' | 'draw-mesh' | 'draw-shape' | 'draw-shape-layer' | 'draw-skinned-mesh' | 'draw-sprite' | 'draw-sprite-layer' | 'draw-text' | 'draw-text-layer' | 'drawer' | 'drawer-slot' | 'edge-decoration' | 'emoji-picker' | 'empty-state' | 'entity-cards' | 'entity-list' | 'entity-table' | 'error-boundary' | 'error-state' | 'feature-card' | 'feature-grid' | 'file-tree' | 'filter-group' | 'filter-pill' | 'flex' | 'flip-card' | 'flip-container' | 'floating-action-button' | 'floating-toolbar' | 'form' | 'form-actions' | 'form-field' | 'form-layout' | 'form-section' | 'form-section-header' | 'fx-overlay' | 'game-audio-cue' | 'game-audio-toggle' | 'game-hud' | 'game-icon' | 'game-menu' | 'game-shell' | 'gantt' | 'generic-app-template' | 'geometric-pattern' | 'gradient-divider' | 'graph-canvas' | 'graph-view' | 'grid' | 'header' | 'health-bar' | 'hstack' | 'icon' | 'image' | 'import-preview-tree' | 'import-progress' | 'import-source-picker' | 'infinite-scroll-sentinel' | 'input' | 'input-group' | 'jazari-state-machine' | 'label' | 'law-reference-tooltip' | 'learning-canvas' | 'lightbox' | 'likert-scale' | 'line-chart' | 'loading-state' | 'map-view' | 'markdown-content' | 'master-detail' | 'master-detail-layout' | 'math-canvas' | 'matrix-question' | 'media-gallery' | 'menu' | 'meter' | 'modal' | 'modal-slot' | 'module-card' | 'navigation' | 'notification' | 'number-stepper' | 'option-constraint-group' | 'orbital-visualization' | 'overlay' | 'page-header' | 'page-transition' | 'pagination' | 'pattern-tile' | 'physics-canvas' | 'popover' | 'positioned-canvas' | 'presence' | 'progress-bar' | 'progress-dots' | 'pull-to-refresh' | 'qr-scanner' | 'quiz-block' | 'radio' | 'range-slider' | 'reflection-block' | 'relation-select' | 'repeatable-form-section' | 'reply-tree' | 'rich-text-editor' | 'runtime-debugger' | 'scaled-diagram' | 'score-display' | 'search-input' | 'section' | 'section-header' | 'segment-renderer' | 'select' | 'sequence-bar' | 'side-panel' | 'sidebar' | 'signature-pad' | 'simple-grid' | 'skeleton' | 'social-proof' | 'sortable-list' | 'spacer' | 'sparkline' | 'spinner' | 'split' | 'split-pane' | 'stack' | 'star-rating' | 'stat-badge' | 'stat-card' | 'stat-display' | 'state-graph' | 'state-json-view' | 'state-machine-view' | 'status-dot' | 'subagent-trace-panel' | 'svg-branch' | 'svg-connection' | 'svg-flow' | 'svg-grid' | 'svg-lobe' | 'svg-mesh' | 'svg-morph' | 'svg-node' | 'svg-pulse' | 'svg-ring' | 'svg-shield' | 'svg-stack' | 'swipeable-row' | 'switch' | 'tabbed-container' | 'table-view' | 'tabs' | 'tag-input' | 'text-highlight' | 'textarea' | 'theme-toggle' | 'time-slot-cell' | 'timeline' | 'timer-display' | 'toast-slot' | 'tooltip' | 'trait-frame' | 'trait-slot' | 'trend-indicator' | 'typewriter-text' | 'typography' | 'ui-slot-component' | 'ui-slot-renderer' | 'upload-drop-zone' | 'version-diff' | 'violation-alert' | 'vote-stack' | 'vstack' | 'wizard-container' | 'wizard-navigation' | 'wizard-progress';
+type PatternType = 'accordion' | 'action-palette' | 'action-tile' | 'activation-block' | 'alert' | 'algo-graph-canvas' | 'algorithm-canvas' | 'animated-counter' | 'animated-graphic' | 'animated-reveal' | 'aside' | 'atlas-image' | 'atlas-panel' | 'auth-layout' | 'avatar' | 'badge' | 'behavior-view' | 'biology-canvas' | 'bloom-quiz-block' | 'box' | 'branching-logic-builder' | 'breadcrumb' | 'button' | 'calendar-grid' | 'canvas' | 'canvas-2d' | 'card' | 'carousel' | 'center' | 'chart' | 'chart-legend' | 'chat-bar' | 'checkbox' | 'chemistry-canvas' | 'choice-button' | 'code-block' | 'code-runner-panel' | 'command-palette' | 'conditional-wrapper' | 'confetti-effect' | 'confirm-dialog' | 'connection-block' | 'container' | 'content-renderer' | 'control-button' | 'control-grid' | 'counter-template' | 'dashboard-grid' | 'dashboard-layout' | 'data-grid' | 'data-list' | 'date-range-picker' | 'date-range-selector' | 'day-cell' | 'detail-panel' | 'dialog' | 'dialogue-bubble' | 'divider' | 'doc-breadcrumb' | 'doc-pagination' | 'doc-search' | 'doc-sidebar' | 'doc-toc' | 'dock-layout' | 'document-details' | 'document-panel' | 'document-viewer' | 'draw-fx-layer' | 'draw-group' | 'draw-mesh' | 'draw-shape' | 'draw-shape-layer' | 'draw-skinned-mesh' | 'draw-sprite' | 'draw-sprite-layer' | 'draw-text' | 'draw-text-layer' | 'drawer' | 'drawer-slot' | 'edge-decoration' | 'emoji-picker' | 'empty-state' | 'entity-cards' | 'entity-list' | 'entity-table' | 'error-boundary' | 'error-state' | 'feature-card' | 'feature-grid' | 'file-tree' | 'filter-group' | 'filter-pill' | 'flex' | 'flip-card' | 'flip-container' | 'floating-action-button' | 'floating-toolbar' | 'form' | 'form-actions' | 'form-field' | 'form-layout' | 'form-section' | 'form-section-header' | 'fx-overlay' | 'game-audio-cue' | 'game-audio-toggle' | 'game-hud' | 'game-icon' | 'game-menu' | 'game-shell' | 'gantt' | 'generic-app-template' | 'geometric-pattern' | 'gradient-divider' | 'graph-canvas' | 'graph-view' | 'grid' | 'header' | 'health-bar' | 'hstack' | 'icon' | 'icon-button' | 'image' | 'import-preview-tree' | 'import-progress' | 'import-source-picker' | 'infinite-scroll-sentinel' | 'input' | 'input-group' | 'jazari-state-machine' | 'label' | 'law-reference-tooltip' | 'learning-canvas' | 'lightbox' | 'likert-scale' | 'line-chart' | 'loading-state' | 'map-view' | 'markdown-content' | 'master-detail' | 'master-detail-layout' | 'math-canvas' | 'matrix-question' | 'media-gallery' | 'menu' | 'meter' | 'modal' | 'modal-slot' | 'module-card' | 'navigation' | 'notification' | 'number-stepper' | 'option-constraint-group' | 'orbital-visualization' | 'overlay' | 'page-header' | 'page-transition' | 'pagination' | 'pattern-tile' | 'physics-canvas' | 'popover' | 'positioned-canvas' | 'presence' | 'progress-bar' | 'progress-dots' | 'pull-to-refresh' | 'qr-scanner' | 'quiz-block' | 'radio' | 'range-slider' | 'reflection-block' | 'relation-select' | 'repeatable-form-section' | 'reply-tree' | 'rich-text-editor' | 'runtime-debugger' | 'scaled-diagram' | 'score-display' | 'search-input' | 'section' | 'section-header' | 'segment-renderer' | 'select' | 'sequence-bar' | 'side-panel' | 'sidebar' | 'signature-pad' | 'simple-grid' | 'skeleton' | 'social-proof' | 'sortable-list' | 'spacer' | 'sparkline' | 'spinner' | 'split' | 'split-pane' | 'stack' | 'star-rating' | 'stat-badge' | 'stat-card' | 'stat-display' | 'state-graph' | 'state-json-view' | 'state-machine-view' | 'status-dot' | 'subagent-trace-panel' | 'svg-branch' | 'svg-connection' | 'svg-flow' | 'svg-grid' | 'svg-lobe' | 'svg-mesh' | 'svg-morph' | 'svg-node' | 'svg-pulse' | 'svg-ring' | 'svg-shield' | 'svg-stack' | 'swipeable-row' | 'switch' | 'tabbed-container' | 'table-view' | 'tabs' | 'tag-input' | 'text-highlight' | 'textarea' | 'theme-toggle' | 'time-slot-cell' | 'timeline' | 'timer-display' | 'toast-slot' | 'tooltip' | 'top-nav-item' | 'trait-frame' | 'trait-slot' | 'trend-indicator' | 'typewriter-text' | 'typography' | 'ui-slot-component' | 'ui-slot-renderer' | 'upload-drop-zone' | 'version-diff' | 'violation-alert' | 'vote-stack' | 'vstack' | 'wizard-container' | 'wizard-navigation' | 'wizard-progress';
 /**
  * Pattern props map — each pattern type maps to its valid props interface.
  */
@@ -3815,6 +3815,12 @@ interface PatternPropsMap {
         bottomPanelMinSize?: number | string | SExpr;
         secondarySidebarCollapsed?: boolean | string | SExpr;
         onSecondarySidebarCollapsedChange?: ((...args: unknown[]) => unknown) | string | SExpr;
+        compact?: boolean | string | SExpr;
+        secondarySidebarLabel?: string | SExpr;
+        secondarySidebarIcon?: unknown | string | SExpr;
+        bottomPanelLabel?: string | SExpr;
+        bottomPanelIcon?: unknown | string | SExpr;
+        topBarActions?: unknown | string | SExpr;
         className?: string | SExpr;
         railClassName?: string | SExpr;
         sidebarClassName?: string | SExpr;
@@ -4641,6 +4647,22 @@ interface PatternPropsMap {
         strokeWidth?: number | string | SExpr;
         style?: PatternPropValue | string | SExpr;
     };
+    'icon-button': {
+        type: 'icon-button';
+        className?: string | SExpr;
+        variant?: string | SExpr;
+        size?: string | SExpr;
+        isLoading?: boolean | string | SExpr;
+        iconAsset?: PatternPropValue | string | SExpr;
+        action?: string | SExpr;
+        actionPayload?: PatternPropValue | string | SExpr;
+        disabled?: boolean | string | SExpr;
+        href?: string | SExpr;
+        'data-testid'?: string | SExpr;
+        icon: unknown | string | SExpr;
+        label: string | SExpr;
+        tooltipPosition?: string | SExpr;
+    };
     'image': {
         type: 'image';
         src: unknown | string | SExpr;
@@ -6066,6 +6088,13 @@ interface PatternPropsMap {
         showArrow?: boolean | string | SExpr;
         className?: string | SExpr;
     };
+    'top-nav-item': {
+        type: 'top-nav-item';
+        item: PatternPropValue | string | SExpr;
+        activeHref?: string | SExpr;
+        tone?: string | SExpr;
+        className?: string | SExpr;
+    };
     'trait-frame': {
         type: 'trait-frame';
         traitName: string | SExpr;

package/dist/{entityAccess-CLWlioZ0.d.ts → entityAccess-Y0Hh6fCW.d.ts}

@@ -1,5 +1,5 @@
-import { O as OrbitalEntity } from './effect-DhsB3usU.js';
-import { O as OrbitalSchema, a as OrbitalDefinition } from './schema-CjwAD-Y4.js';
+import { O as OrbitalEntity } from './effect-DtAf51pB.js';
+import { O as OrbitalSchema, a as OrbitalDefinition } from './schema-aRqGRPE_.js';
 import { S as SExpr } from './expression-CfeHdS-f.js';
 
 /**

package/dist/factory/index.d.ts

@@ -1,7 +1,7 @@
-import { k as FactorySignatureCatalog, h as FactoryParamValue, c as FactoryConfigTier, b as FactoryConfigParam, F as FactoryCallSite, j as FactorySignature, R as RuleOverlay, p as RuleOverlayEntry, o as PresentationOverlay, T as TraitOverlay, J as JsonSchema } from '../types-DBAbXfRk.js';
-export { a as FactoryCallSiteParams, d as FactoryEntitySignature, e as FactoryEventSignature, f as FactoryExposure, g as FactoryPageSignature, i as FactoryProvenance, l as FactorySignatureEntityField, m as FactoryTraitSignature, n as JsonSchemaType, O as OwnershipOverlayEntry, P as PresentationNavItem, S as SchemaFieldType, q as TraitOverlayEntry, r as TraitOverlayListener } from '../types-DBAbXfRk.js';
-import { a as EntityPersistence, E as EntityField } from '../effect-DhsB3usU.js';
-import { a as TraitReference } from '../trait-DoFyUfui.js';
+import { k as FactorySignatureCatalog, h as FactoryParamValue, c as FactoryConfigTier, b as FactoryConfigParam, F as FactoryCallSite, j as FactorySignature, R as RuleOverlay, p as RuleOverlayEntry, o as PresentationOverlay, T as TraitOverlay, J as JsonSchema } from '../types-4EKT1Oco.js';
+export { a as FactoryCallSiteParams, d as FactoryEntitySignature, e as FactoryEventSignature, f as FactoryExposure, g as FactoryPageSignature, i as FactoryProvenance, l as FactorySignatureEntityField, m as FactoryTraitSignature, n as JsonSchemaType, O as OwnershipOverlayEntry, P as PresentationNavItem, S as SchemaFieldType, q as TraitOverlayEntry, r as TraitOverlayListener } from '../types-4EKT1Oco.js';
+import { a as EntityPersistence, E as EntityField } from '../effect-DtAf51pB.js';
+import { a as TraitReference } from '../trait-CzhNoRw4.js';
 export { J as JsonValue } from '../json-D8gmyK3l.js';
 import 'zod';
 import '../expression-CfeHdS-f.js';

package/dist/factory/index.js

@@ -10360,6 +10360,11 @@ var patterns_registry_default = {
                 ],
                 kind: "event"
               },
+              href: {
+                types: [
+                  "string"
+                ]
+              },
               url: {
                 types: [
                   "string"
@@ -13002,6 +13007,7 @@ var patterns_registry_default = {
     header: {
       type: "header",
       category: "header",
+      sourceFile: "components/core/molecules/Header.tsx",
       tier: "molecules",
       family: "core",
       description: "Header Organism Component  A header component for mobile/responsive layouts with menu toggle, brand, and user avatar. Styled to match the main Layout component's mobile header.",
@@ -13070,6 +13076,18 @@ var patterns_registry_default = {
                 types: [
                   "boolean"
                 ]
+              },
+              children: {
+                types: [
+                  "array"
+                ],
+                items: {
+                  types: [
+                    "object"
+                  ],
+                  cyclic: true,
+                  cyclicTypeName: "HeaderNavigationItem"
+                }
               }
             },
             required: [
@@ -49776,6 +49794,7 @@ var patterns_registry_default = {
     "dock-layout": {
       type: "dock-layout",
       category: "layout",
+      sourceFile: "components/core/organisms/layout/DockLayout.tsx",
       tier: "organisms",
       family: "core",
       description: "DockLayout component",
@@ -49827,8 +49846,7 @@ var patterns_registry_default = {
           types: [
             "number"
           ],
-          description: "Width of `rail` in pixels. @default 56",
-          default: 56
+          description: "Width of `rail` in pixels; the rail sizes the column itself when omitted."
         },
         secondarySidebarWidth: {
           types: [
@@ -49841,8 +49859,7 @@ var patterns_registry_default = {
           types: [
             "boolean"
           ],
-          description: "Whether `sidebar` is collapsed. @default false",
-          default: false
+          description: "Whether `sidebar` is collapsed. @default false"
         },
         onSidebarCollapsedChange: {
           types: [
@@ -49888,8 +49905,7 @@ var patterns_registry_default = {
           types: [
             "boolean"
           ],
-          description: "Whether `bottomPanel` is collapsed. @default false",
-          default: false
+          description: "Whether `bottomPanel` is collapsed. @default false"
         },
         onBottomPanelCollapsedChange: {
           types: [
@@ -49935,8 +49951,7 @@ var patterns_registry_default = {
           types: [
             "boolean"
           ],
-          description: "Whether `secondarySidebar` is collapsed. @default false",
-          default: false
+          description: "Whether `secondarySidebar` is collapsed. @default false"
         },
         onSecondarySidebarCollapsedChange: {
           types: [
@@ -49951,6 +49966,44 @@ var patterns_registry_default = {
             }
           ]
         },
+        compact: {
+          types: [
+            "boolean"
+          ],
+          description: "The mobile variant; decided by the viewport (narrower than 1024px) when omitted."
+        },
+        secondarySidebarLabel: {
+          types: [
+            "string"
+          ],
+          description: 'Compact: the top-bar button that opens `secondarySidebar` (e.g. "Inspector", "Chat").'
+        },
+        secondarySidebarIcon: {
+          types: [
+            "icon",
+            "string"
+          ],
+          description: "secondarySidebarIcon prop"
+        },
+        bottomPanelLabel: {
+          types: [
+            "string"
+          ],
+          description: "Compact: the top-bar button that opens `bottomPanel`."
+        },
+        bottomPanelIcon: {
+          types: [
+            "icon",
+            "string"
+          ],
+          description: "bottomPanelIcon prop"
+        },
+        topBarActions: {
+          types: [
+            "node"
+          ],
+          description: "Compact: the host's own actions at the end of the top bar (e.g. Run)."
+        },
         className: {
           types: [
             "string"
@@ -51221,6 +51274,318 @@ var patterns_registry_default = {
           description: "className prop"
         }
       }
+    },
+    "icon-button": {
+      type: "icon-button",
+      category: "component",
+      sourceFile: "components/core/molecules/IconButton.tsx",
+      tier: "molecules",
+      family: "core",
+      description: "IconButton component",
+      suggestedFor: [
+        "icon",
+        "button",
+        "icon button"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes applied to the root element."
+        },
+        variant: {
+          types: [
+            "string"
+          ],
+          description: "variant prop",
+          enumValues: [
+            "primary",
+            "secondary",
+            "ghost",
+            "danger",
+            "success",
+            "warning",
+            "default",
+            "link"
+          ],
+          default: "ghost"
+        },
+        size: {
+          types: [
+            "string"
+          ],
+          description: "size prop",
+          enumValues: [
+            "sm",
+            "md",
+            "lg"
+          ],
+          default: "sm"
+        },
+        isLoading: {
+          types: [
+            "boolean"
+          ],
+          description: "isLoading prop"
+        },
+        iconAsset: {
+          types: [
+            "object"
+          ],
+          description: "Asset image rendered as the leading icon; takes precedence over icon/leftIcon when provided.",
+          properties: {
+            url: {
+              types: [
+                "asset"
+              ]
+            },
+            role: {
+              types: [
+                "string"
+              ]
+            },
+            category: {
+              types: [
+                "string"
+              ]
+            },
+            animations: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            style: {
+              types: [
+                "string"
+              ],
+              enumValues: [
+                "pixel",
+                "vector",
+                "hd",
+                "1-bit",
+                "isometric"
+              ]
+            },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
+            dimension: {
+              types: [
+                "string"
+              ],
+              enumValues: [
+                "2d",
+                "3d"
+              ]
+            },
+            aspect: {
+              types: [
+                "string"
+              ],
+              enumValues: [
+                "1:1",
+                "16:9",
+                "5:7",
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
+              ]
+            },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
+            name: {
+              types: [
+                "string"
+              ]
+            },
+            thumbnailUrl: {
+              types: [
+                "string"
+              ]
+            }
+          },
+          propertyRequired: [
+            "url",
+            "role",
+            "category"
+          ]
+        },
+        action: {
+          types: [
+            "string"
+          ],
+          description: "Declarative event name \u2014 emits UI:{action} via eventBus on click",
+          kind: "event"
+        },
+        actionPayload: {
+          types: [
+            "object"
+          ],
+          description: "Payload to include with the action event",
+          payloadFor: "action",
+          eventPayloadBrand: true
+        },
+        disabled: {
+          types: [
+            "boolean"
+          ],
+          description: "Disable the button (greys out, blocks click events)"
+        },
+        href: {
+          types: [
+            "string"
+          ],
+          description: "Makes the button a link: `#anchor` scrolls, an absolute URL loads, a path navigates in-app"
+        },
+        "data-testid": {
+          types: [
+            "string"
+          ],
+          description: "Test identifier for automated tests"
+        },
+        icon: {
+          types: [
+            "icon",
+            "string"
+          ],
+          description: "icon prop",
+          required: true
+        },
+        label: {
+          types: [
+            "string"
+          ],
+          description: "What the button does \u2014 its accessible name and its tooltip.",
+          required: true
+        },
+        tooltipPosition: {
+          types: [
+            "string"
+          ],
+          description: "Where the tooltip opens.",
+          enumValues: [
+            "top",
+            "bottom",
+            "left",
+            "right"
+          ],
+          default: "right"
+        }
+      }
+    },
+    "top-nav-item": {
+      type: "top-nav-item",
+      category: "navigation",
+      sourceFile: "components/core/molecules/TopNavItem.tsx",
+      tier: "molecules",
+      family: "core",
+      description: "TopNavItem component",
+      suggestedFor: [
+        "top",
+        "nav",
+        "item",
+        "top nav item"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        item: {
+          types: [
+            "object"
+          ],
+          description: "item prop",
+          required: true,
+          properties: {
+            label: {
+              types: [
+                "string"
+              ]
+            },
+            href: {
+              types: [
+                "string"
+              ]
+            },
+            icon: {
+              types: [
+                "icon",
+                "string"
+              ]
+            },
+            badge: {
+              types: [
+                "string",
+                "number"
+              ]
+            },
+            active: {
+              types: [
+                "boolean"
+              ]
+            },
+            onClick: {
+              types: [
+                "function"
+              ]
+            },
+            children: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "object"
+                ],
+                cyclic: true,
+                cyclicTypeName: "TopNavItemData"
+              }
+            }
+          },
+          propertyRequired: [
+            "label"
+          ]
+        },
+        activeHref: {
+          types: [
+            "string"
+          ],
+          description: "The href of the active page, used to mark the item (or its parent) active."
+        },
+        tone: {
+          types: [
+            "string"
+          ],
+          description: "Active styling: `solid` fills with the primary colour (dashboard top bar); `soft` tints it (site header).",
+          enumValues: [
+            "solid",
+            "soft"
+          ],
+          default: "solid"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "className prop"
+        }
+      }
     }
   }};
 var JsonValueSchema = z.lazy(