@almadar/core 10.107.0 → 10.109.0

package/dist/patterns/index.js

@@ -3,7 +3,7 @@ import { z } from 'zod';
 // src/patterns/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-27T02:12:25.691Z",
+  exportedAt: "2026-09-28T12:49:04.761Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -3906,6 +3906,7 @@ var patterns_registry_default = {
     "search-input": {
       type: "search-input",
       category: "filter",
+      sourceFile: "components/core/molecules/SearchInput.tsx",
       tier: "molecules",
       family: "core",
       description: "Search input with events",
@@ -4003,6 +4004,7 @@ var patterns_registry_default = {
     "filter-group": {
       type: "filter-group",
       category: "filter",
+      sourceFile: "components/core/molecules/FilterGroup.tsx",
       tier: "molecules",
       family: "core",
       description: "FilterGroup \u2014 a panel of filter controls that narrows a collection by field values.",
@@ -4706,7 +4708,16 @@ var patterns_registry_default = {
             required: [
               "label"
             ]
-          }
+          },
+          example: [
+            {
+              label: "Home",
+              href: "/"
+            },
+            {
+              label: "Page"
+            }
+          ]
         },
         fromNavStack: {
           types: [
@@ -4764,6 +4775,7 @@ var patterns_registry_default = {
     "wizard-progress": {
       type: "wizard-progress",
       category: "navigation",
+      sourceFile: "components/core/molecules/WizardProgress.tsx",
       tier: "molecules",
       family: "core",
       description: "Wizard step progress indicator",
@@ -4865,6 +4877,7 @@ var patterns_registry_default = {
     "wizard-navigation": {
       type: "wizard-navigation",
       category: "navigation",
+      sourceFile: "components/core/molecules/WizardNavigation.tsx",
       tier: "molecules",
       family: "core",
       description: "Wizard navigation buttons",
@@ -5840,6 +5853,7 @@ var patterns_registry_default = {
     pagination: {
       type: "pagination",
       category: "navigation",
+      sourceFile: "components/core/molecules/Pagination.tsx",
       tier: "molecules",
       family: "core",
       description: "Page navigation controls",
@@ -5985,6 +5999,7 @@ var patterns_registry_default = {
     "empty-state": {
       type: "empty-state",
       category: "state",
+      sourceFile: "components/core/molecules/EmptyState.tsx",
       tier: "molecules",
       family: "core",
       description: "Message when no data exists",
@@ -6084,6 +6099,7 @@ var patterns_registry_default = {
     "loading-state": {
       type: "loading-state",
       category: "state",
+      sourceFile: "components/core/molecules/LoadingState.tsx",
       tier: "molecules",
       family: "core",
       description: "Loading indicator",
@@ -6122,6 +6138,7 @@ var patterns_registry_default = {
     "error-state": {
       type: "error-state",
       category: "state",
+      sourceFile: "components/core/molecules/ErrorState.tsx",
       tier: "molecules",
       family: "core",
       description: "Error message display",
@@ -6176,6 +6193,7 @@ var patterns_registry_default = {
     notification: {
       type: "notification",
       category: "state",
+      sourceFile: "components/core/molecules/Toast.tsx",
       tier: "molecules",
       family: "core",
       description: "Toast notification message",
@@ -6282,6 +6300,7 @@ var patterns_registry_default = {
     modal: {
       type: "modal",
       category: "container",
+      sourceFile: "components/core/molecules/Modal.tsx",
       tier: "molecules",
       family: "core",
       description: "Modal dialog overlay",
@@ -6408,6 +6427,7 @@ var patterns_registry_default = {
     drawer: {
       type: "drawer",
       category: "container",
+      sourceFile: "components/core/molecules/Drawer.tsx",
       tier: "molecules",
       family: "core",
       description: "Side drawer panel",
@@ -6509,6 +6529,7 @@ var patterns_registry_default = {
     "confirm-dialog": {
       type: "confirm-dialog",
       category: "container",
+      sourceFile: "components/core/molecules/ConfirmDialog.tsx",
       tier: "molecules",
       family: "core",
       description: "Confirmation dialog",
@@ -6662,6 +6683,7 @@ var patterns_registry_default = {
     "master-detail": {
       type: "master-detail",
       category: "layout",
+      sourceFile: "components/core/organisms/MasterDetail.tsx",
       tier: "organisms",
       family: "core",
       description: "List on left, selected item detail on right",
@@ -6864,7 +6886,8 @@ var patterns_registry_default = {
             "lg",
             "xl",
             "2xl"
-          ]
+          ],
+          example: "md"
         },
         paddingX: {
           types: [
@@ -6965,7 +6988,8 @@ var patterns_registry_default = {
             "boolean"
           ],
           description: "Show border",
-          default: false
+          default: false,
+          example: true
         },
         rounded: {
           types: [
@@ -7108,6 +7132,7 @@ var patterns_registry_default = {
     grid: {
       type: "grid",
       category: "layout",
+      sourceFile: "components/core/molecules/Grid.tsx",
       tier: "molecules",
       family: "core",
       description: "CSS Grid layout for multi-column content",
@@ -7302,6 +7327,7 @@ var patterns_registry_default = {
     center: {
       type: "center",
       category: "layout",
+      sourceFile: "components/core/atoms/Center.tsx",
       tier: "atoms",
       family: "core",
       description: "Centers content horizontally and vertically",
@@ -7390,6 +7416,7 @@ var patterns_registry_default = {
     spacer: {
       type: "spacer",
       category: "layout",
+      sourceFile: "components/core/atoms/Spacer.tsx",
       tier: "atoms",
       family: "core",
       description: "Flexible space that expands to fill available room",
@@ -7438,6 +7465,7 @@ var patterns_registry_default = {
     divider: {
       type: "divider",
       category: "layout",
+      sourceFile: "components/core/atoms/Divider.tsx",
       tier: "atoms",
       family: "core",
       description: "Visual separator between content sections",
@@ -7488,6 +7516,7 @@ var patterns_registry_default = {
     "runtime-debugger": {
       type: "runtime-debugger",
       category: "debug",
+      sourceFile: "components/core/organisms/debug/RuntimeDebugger.tsx",
       tier: "organisms",
       family: "core",
       description: "Debug overlay showing FPS, entity states, event logs",
@@ -7752,7 +7781,8 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Button label text (alternative to children for schema-driven rendering)"
+          description: "Button label text (alternative to children for schema-driven rendering)",
+          example: "Button"
         },
         disabled: {
           types: [
@@ -7962,6 +7992,7 @@ var patterns_registry_default = {
     avatar: {
       type: "avatar",
       category: "component",
+      sourceFile: "components/core/atoms/Avatar.tsx",
       tier: "atoms",
       family: "core",
       description: "User avatar image or initials",
@@ -8062,13 +8093,15 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Payload to include with the action event",
-          payloadFor: "action"
+          payloadFor: "action",
+          eventPayloadBrand: true
         }
       }
     },
     icon: {
       type: "icon",
       category: "component",
+      sourceFile: "components/core/atoms/Icon.tsx",
       tier: "atoms",
       family: "core",
       description: "Icon from Lucide icon set",
@@ -8152,6 +8185,7 @@ var patterns_registry_default = {
     card: {
       type: "card",
       category: "component",
+      sourceFile: "components/core/atoms/Card.tsx",
       tier: "atoms",
       family: "core",
       description: "Card container with optional header and footer",
@@ -8258,6 +8292,7 @@ var patterns_registry_default = {
     "progress-bar": {
       type: "progress-bar",
       category: "component",
+      sourceFile: "components/core/atoms/ProgressBar.tsx",
       tier: "atoms",
       family: "core",
       description: "Progress indicator bar",
@@ -8373,6 +8408,7 @@ var patterns_registry_default = {
     spinner: {
       type: "spinner",
       category: "component",
+      sourceFile: "components/core/atoms/Spinner.tsx",
       tier: "atoms",
       family: "core",
       description: "Loading spinner animation",
@@ -8881,6 +8917,7 @@ var patterns_registry_default = {
     checkbox: {
       type: "checkbox",
       category: "component",
+      sourceFile: "components/core/atoms/Checkbox.tsx",
       tier: "atoms",
       family: "core",
       description: "Checkbox input",
@@ -8935,6 +8972,7 @@ var patterns_registry_default = {
     radio: {
       type: "radio",
       category: "component",
+      sourceFile: "components/core/atoms/Radio.tsx",
       tier: "atoms",
       family: "core",
       description: "Radio button input",
@@ -9016,6 +9054,7 @@ var patterns_registry_default = {
     switch: {
       type: "switch",
       category: "component",
+      sourceFile: "components/core/atoms/Switch.tsx",
       tier: "atoms",
       family: "core",
       description: "Toggle switch input",
@@ -9088,6 +9127,7 @@ var patterns_registry_default = {
     label: {
       type: "label",
       category: "component",
+      sourceFile: "components/core/atoms/Label.tsx",
       tier: "atoms",
       family: "core",
       description: "Form field label",
@@ -9126,6 +9166,7 @@ var patterns_registry_default = {
     alert: {
       type: "alert",
       category: "component",
+      sourceFile: "components/core/molecules/Alert.tsx",
       tier: "molecules",
       family: "core",
       description: "Alert message box",
@@ -9215,6 +9256,7 @@ var patterns_registry_default = {
     tooltip: {
       type: "tooltip",
       category: "component",
+      sourceFile: "components/core/molecules/Tooltip.tsx",
       tier: "molecules",
       family: "core",
       description: "Hover tooltip",
@@ -9284,6 +9326,7 @@ var patterns_registry_default = {
     popover: {
       type: "popover",
       category: "component",
+      sourceFile: "components/core/molecules/Popover.tsx",
       tier: "molecules",
       family: "core",
       description: "Click-triggered popover",
@@ -9520,6 +9563,7 @@ var patterns_registry_default = {
     accordion: {
       type: "accordion",
       category: "component",
+      sourceFile: "components/core/molecules/Accordion.tsx",
       tier: "molecules",
       family: "core",
       description: "Collapsible accordion sections",
@@ -9664,6 +9708,7 @@ var patterns_registry_default = {
     container: {
       type: "container",
       category: "component",
+      sourceFile: "components/core/molecules/Container.tsx",
       tier: "molecules",
       family: "core",
       description: "Centered max-width container",
@@ -9747,6 +9792,7 @@ var patterns_registry_default = {
     "simple-grid": {
       type: "simple-grid",
       category: "component",
+      sourceFile: "components/core/molecules/SimpleGrid.tsx",
       tier: "molecules",
       family: "core",
       description: "Simple responsive grid with auto columns",
@@ -10139,6 +10185,7 @@ var patterns_registry_default = {
     "law-reference-tooltip": {
       type: "law-reference-tooltip",
       category: "component",
+      sourceFile: "components/core/atoms/LawReferenceTooltip.tsx",
       tier: "atoms",
       family: "core",
       description: "LawReferenceTooltip Atom Component  A specialized tooltip for displaying law references in inspection forms. Shows law name, article number, and relevant clause text.",
@@ -10219,6 +10266,7 @@ var patterns_registry_default = {
     overlay: {
       type: "overlay",
       category: "container",
+      sourceFile: "components/core/atoms/Overlay.tsx",
       tier: "atoms",
       family: "core",
       description: "Overlay Atom Component  A fixed backdrop for modals and drawers.",
@@ -10273,6 +10321,7 @@ var patterns_registry_default = {
     stack: {
       type: "stack",
       category: "component",
+      sourceFile: "components/core/atoms/Stack.tsx",
       tier: "atoms",
       family: "core",
       description: "Stack Component  A layout primitive for arranging children in a vertical or horizontal stack with consistent spacing. Includes convenience exports VStack and HStack for common use cases.",
@@ -10439,7 +10488,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Payload to include with the action event",
-          payloadFor: "action"
+          payloadFor: "action",
+          eventPayloadBrand: true
         },
         responsive: {
           types: [
@@ -10453,6 +10503,7 @@ var patterns_registry_default = {
     "text-highlight": {
       type: "text-highlight",
       category: "component",
+      sourceFile: "components/core/atoms/TextHighlight.tsx",
       tier: "atoms",
       family: "core",
       description: "TextHighlight Atom Component  A styled span component for highlighting text with annotations (questions or notes). Uses different colors for different annotation types: - Questions: Blue highlight - Notes: Yellow highlight",
@@ -10562,6 +10613,7 @@ var patterns_registry_default = {
     "theme-toggle": {
       type: "theme-toggle",
       category: "component",
+      sourceFile: "components/core/atoms/ThemeToggle.tsx",
       tier: "atoms",
       family: "core",
       description: "ThemeToggle Atom Component  A button that toggles between light and dark themes. Uses Sun and Moon icons to indicate current/target theme.",
@@ -10602,6 +10654,7 @@ var patterns_registry_default = {
     typography: {
       type: "typography",
       category: "component",
+      sourceFile: "components/core/atoms/Typography.tsx",
       tier: "atoms",
       family: "core",
       description: "Typography Atom Component  Text elements following the KFlow design system with theme-aware styling.",
@@ -11022,6 +11075,7 @@ var patterns_registry_default = {
     flex: {
       type: "flex",
       category: "component",
+      sourceFile: "components/core/molecules/Flex.tsx",
       tier: "molecules",
       family: "core",
       description: "Flex Component  A flexbox wrapper with all common flex properties exposed as props. More explicit than Stack for when you need full flex control.",
@@ -11290,6 +11344,7 @@ var patterns_registry_default = {
     "form-field": {
       type: "form-field",
       category: "form",
+      sourceFile: "components/core/molecules/FormField.tsx",
       tier: "molecules",
       family: "core",
       description: "FormField Molecule Component  A form field wrapper with label, hint, and error message support. **Atomic Design**: Composed using Label and Typography atoms.",
@@ -11343,6 +11398,7 @@ var patterns_registry_default = {
     "form-section-header": {
       type: "form-section-header",
       category: "form",
+      sourceFile: "components/core/molecules/FormSectionHeader.tsx",
       tier: "molecules",
       family: "core",
       description: "FormSectionHeader  Header component for collapsible form sections. Provides consistent styling and interaction for section headers.",
@@ -11624,6 +11680,7 @@ var patterns_registry_default = {
     "relation-select": {
       type: "relation-select",
       category: "form",
+      sourceFile: "components/core/molecules/RelationSelect.tsx",
       tier: "molecules",
       family: "core",
       description: "RelationSelect Molecule Component  A searchable select component for relation fields. Allows users to search and select from related entities.  Composed from: Box, HStack, VStack, Input, Button, Spinner, Typography atoms",
@@ -11761,6 +11818,7 @@ var patterns_registry_default = {
     "side-panel": {
       type: "side-panel",
       category: "component",
+      sourceFile: "components/core/molecules/SidePanel.tsx",
       tier: "molecules",
       family: "core",
       description: "SidePanel Molecule Component  A side panel that slides in from the right (or left) with header and content. Uses Button, Typography atoms.",
@@ -11845,6 +11903,7 @@ var patterns_registry_default = {
     "violation-alert": {
       type: "violation-alert",
       category: "state",
+      sourceFile: "components/core/molecules/ViolationAlert.tsx",
       tier: "molecules",
       family: "core",
       description: "ViolationAlert  Displays inspection violations with law references and action types. Used in inspection forms to show detected compliance violations.  Action Types: - measure: Corrective measure required (warning) - admin: Administrative action (error) - penalty: Penalty proceedings (error, severe)",
@@ -11983,6 +12042,7 @@ var patterns_registry_default = {
     "drawer-slot": {
       type: "drawer-slot",
       category: "layout",
+      sourceFile: "components/core/organisms/DrawerSlot.tsx",
       tier: "organisms",
       family: "core",
       description: "DrawerSlot Component  Wraps drawer slot content in a proper Drawer component. Used by trait-driven pages to display drawer UI from render_ui effects.  Handles: - Auto-open when content is present - Dispatches CLOSE/CANCEL events when closed - Extracts title from Form or DetailPanel components - Configurable position and size",
@@ -12357,6 +12417,7 @@ var patterns_registry_default = {
     "modal-slot": {
       type: "modal-slot",
       category: "layout",
+      sourceFile: "components/core/organisms/ModalSlot.tsx",
       tier: "organisms",
       family: "core",
       description: "ModalSlot Component  Wraps modal slot content in a proper Modal component. Used by trait-driven pages to display modal UI from render_ui effects.  Handles: - Auto-open when content is present - Dispatches CLOSE/CANCEL events when closed - Extracts title from Form components",
@@ -12736,6 +12797,7 @@ var patterns_registry_default = {
     section: {
       type: "section",
       category: "display",
+      sourceFile: "components/core/molecules/Section.tsx",
       tier: "molecules",
       family: "core",
       description: "Section Component  A semantic section wrapper with optional title, description, and action. Perfect for grouping related content with consistent spacing.",
@@ -13239,6 +13301,7 @@ var patterns_registry_default = {
     "toast-slot": {
       type: "toast-slot",
       category: "layout",
+      sourceFile: "components/core/organisms/ToastSlot.tsx",
       tier: "organisms",
       family: "core",
       description: "ToastSlot Component  Wraps toast slot content in a proper Toast component with positioning. Used by trait-driven pages to display toast UI from render_ui effects.  Handles: - Auto-show when content is present - Dispatches DISMISS event when dismissed - Fixed positioning in corner of screen",
@@ -13388,6 +13451,7 @@ var patterns_registry_default = {
     "counter-template": {
       type: "counter-template",
       category: "template",
+      sourceFile: "components/core/templates/CounterTemplate.tsx",
       tier: "templates",
       family: "core",
       description: "CounterTemplate  A presentational template for counter/incrementer features. Supports increment, decrement, and reset operations.",
@@ -13854,6 +13918,7 @@ var patterns_registry_default = {
     "generic-app-template": {
       type: "generic-app-template",
       category: "template",
+      sourceFile: "components/core/templates/GenericAppTemplate.tsx",
       tier: "templates",
       family: "core",
       description: "GenericAppTemplate  A simple, generic template for any application. Includes a header with title and actions, and a main content area. **Atomic Design**: Composed using Box, Typography, and Button atoms.",
@@ -15263,6 +15328,7 @@ var patterns_registry_default = {
     "signature-pad": {
       type: "signature-pad",
       category: "form",
+      sourceFile: "components/core/molecules/SignaturePad.tsx",
       tier: "molecules",
       family: "core",
       description: "SignaturePad \u2014 a draw-to-sign canvas that captures a handwritten signature or initials.",
@@ -16367,6 +16433,7 @@ var patterns_registry_default = {
     "error-boundary": {
       type: "error-boundary",
       category: "state",
+      sourceFile: "components/core/molecules/ErrorBoundary.tsx",
       tier: "molecules",
       family: "core",
       description: "ErrorBoundary component",
@@ -16420,6 +16487,7 @@ var patterns_registry_default = {
     skeleton: {
       type: "skeleton",
       category: "component",
+      sourceFile: "components/core/molecules/Skeleton.tsx",
       tier: "molecules",
       family: "core",
       description: "Skeleton component",
@@ -16474,6 +16542,7 @@ var patterns_registry_default = {
     "quiz-block": {
       type: "quiz-block",
       category: "component",
+      sourceFile: "components/core/molecules/QuizBlock.tsx",
       tier: "molecules",
       family: "core",
       description: "QuizBlock \u2014 a single quiz question with answer choices and submit/reveal feedback.",
@@ -17183,12 +17252,191 @@ var patterns_registry_default = {
             "replace"
           ],
           tier: "presentation"
+        },
+        completions: {
+          types: [
+            "function"
+          ],
+          description: "Editable only: answers the caret's valid continuations after a keystroke (and on Ctrl-Space); they show under the editor and Tab or a click inserts one.",
+          callbackArgs: [
+            {
+              name: "code",
+              type: "string"
+            },
+            {
+              name: "offset",
+              type: "number"
+            }
+          ],
+          renderCallback: true,
+          tier: "presentation"
+        },
+        assist: {
+          types: [
+            "function"
+          ],
+          description: "Editable only: model-assisted editing. Asked after a pause (and on Ctrl-Space) for a completion at the caret, shown as ghost text; on \u2318/Ctrl-. for fixes, listed under the editor. Tab accepts the next, \u2318/Ctrl-Enter accepts all, Escape dismisses.",
+          callbackArgs: [
+            {
+              name: "request",
+              type: "object",
+              schema: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  code: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  offset: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  kind: {
+                    types: [
+                      "string"
+                    ],
+                    enumValues: [
+                      "complete",
+                      "fix"
+                    ]
+                  },
+                  trigger: {
+                    types: [
+                      "string"
+                    ],
+                    enumValues: [
+                      "idle",
+                      "explicit"
+                    ]
+                  }
+                },
+                required: [
+                  "code",
+                  "offset",
+                  "kind",
+                  "trigger"
+                ]
+              }
+            }
+          ],
+          renderCallback: true,
+          tier: "presentation"
+        },
+        problems: {
+          types: [
+            "number"
+          ],
+          description: "Editable only: how many problems the host knows the code has (some, like a parse error, have no line to mark). With `assist`, the editor offers to fix them.",
+          tier: "presentation"
+        },
+        diagnostics: {
+          types: [
+            "array"
+          ],
+          description: "Editable only: problems located in the code (1-based line/column in characters, `endColumn` just past the last one), each underlined exactly \u2014 red wavy for an error, amber for a warning, dotted where the position is approximate. The message of the one under the caret shows below the editor.",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              line: {
+                types: [
+                  "number"
+                ]
+              },
+              column: {
+                types: [
+                  "number"
+                ]
+              },
+              endLine: {
+                types: [
+                  "number"
+                ]
+              },
+              endColumn: {
+                types: [
+                  "number"
+                ]
+              },
+              severity: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "error",
+                  "warning"
+                ]
+              },
+              message: {
+                types: [
+                  "string"
+                ]
+              },
+              approximate: {
+                types: [
+                  "boolean"
+                ]
+              }
+            },
+            required: [
+              "line",
+              "severity",
+              "message"
+            ]
+          },
+          tier: "presentation"
+        },
+        definitionAt: {
+          types: [
+            "function"
+          ],
+          description: "Editable only: go to definition. Whether the identifier (a dotted path is one) leads somewhere; with Cmd/Ctrl held the one under the pointer is underlined when it does. Comments and strings never qualify.",
+          callbackArgs: [
+            {
+              name: "identifier",
+              type: "string"
+            }
+          ],
+          renderCallback: true
+        },
+        onGoToDefinition: {
+          types: [
+            "function"
+          ],
+          description: "Editable only: Cmd/Ctrl+click, or Cmd/Ctrl+Enter at the caret, on an identifier `definitionAt` accepts.",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "identifier",
+              type: "string"
+            }
+          ]
+        },
+        diagnosticsCode: {
+          types: [
+            "string"
+          ],
+          description: "The code `diagnostics` were computed on. When the editor's text has moved on, each range is carried over the edit; a range the edit touches is dropped until the code is checked again. Absent: they describe the current text.",
+          tier: "presentation"
+        },
+        lineNumbers: {
+          types: [
+            "boolean"
+          ],
+          description: "Editable only: number the lines in a gutter (lines with errors in red). Default on.",
+          tier: "presentation"
         }
       }
     },
     "markdown-content": {
       type: "markdown-content",
       category: "component",
+      sourceFile: "components/core/molecules/markdown/MarkdownContent.tsx",
       tier: "molecules",
       family: "core",
       description: "MarkdownContent Molecule Component  Renders markdown content with support for GFM (GitHub Flavored Markdown), math equations (KaTeX), and raw HTML. Handles inline code only \u2014 fenced code blocks should be parsed out and rendered with CodeBlock component.  Event Contract: - No events emitted (display-only component) - entityAware: false  NOTE: react-markdown's `components` override API requires native HTML elements \u2014 this is the same library-boundary exception as `<iframe>` in DocumentViewer and `<svg>` in JazariStateMachine/StateMachineView.",
@@ -17228,6 +17476,7 @@ var patterns_registry_default = {
     "content-renderer": {
       type: "content-renderer",
       category: "display",
+      sourceFile: "components/core/molecules/ContentRenderer.tsx",
       tier: "molecules",
       family: "core",
       description: "ContentRenderer Organism  Renders rich content as a sequence of typed segments: markdown, code, orbital diagrams (via JazariStateMachine), and quiz blocks. Accepts either raw content string (auto-parsed) or pre-parsed segments.  Event Contract: - Delegates to child components (CodeBlock -> UI:COPY_CODE) - entityAware: false",
@@ -17395,6 +17644,7 @@ var patterns_registry_default = {
     "jazari-state-machine": {
       type: "jazari-state-machine",
       category: "display",
+      sourceFile: "components/core/molecules/JazariStateMachine.tsx",
       tier: "molecules",
       family: "core",
       description: "JazariStateMachine component",
@@ -17511,18 +17761,284 @@ var patterns_registry_default = {
       ],
       typicalSize: "large",
       propsSchema: {
+        activeState: {
+          types: [
+            "string"
+          ],
+          description: "State execution is currently in."
+        },
+        activeTransition: {
+          types: [
+            "number"
+          ],
+          description: "`index` of the transition that just fired."
+        },
+        visitedStates: {
+          types: [
+            "array"
+          ],
+          description: "States already passed through, in order.",
+          items: {
+            types: [
+              "string"
+            ]
+          }
+        },
+        stateClickEvent: {
+          types: [
+            "string"
+          ],
+          description: "Emits UI:{stateClickEvent} with { stateId } when a state is clicked.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "stateId",
+              type: "string",
+              required: true
+            }
+          ]
+        },
+        transitionClickEvent: {
+          types: [
+            "string"
+          ],
+          description: "Emits UI:{transitionClickEvent} with { index, event, from, to } when a transition label is clicked.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "index",
+              type: "number",
+              required: true
+            },
+            {
+              name: "event",
+              type: "string",
+              required: true
+            },
+            {
+              name: "from",
+              type: "string",
+              required: true
+            },
+            {
+              name: "to",
+              type: "string",
+              required: true
+            }
+          ]
+        },
+        selectedState: {
+          types: [
+            "string"
+          ],
+          description: "State picked in an editor (first click)."
+        },
+        pendingSourceState: {
+          types: [
+            "string"
+          ],
+          description: "Source of a transition being drawn \u2014 the next state click picks its target."
+        },
+        nodeShape: {
+          types: [
+            "string"
+          ],
+          description: "Node silhouette. @default 'pill'",
+          enumValues: [
+            "pill",
+            "gear"
+          ]
+        },
+        entityFields: {
+          types: [
+            "array"
+          ],
+          description: "Entity field names listed in the header.",
+          items: {
+            types: [
+              "string"
+            ]
+          }
+        },
+        direction: {
+          types: [
+            "string"
+          ],
+          description: "Flow direction. @default 'ltr'",
+          enumValues: [
+            "ltr",
+            "rtl"
+          ]
+        },
+        showHeader: {
+          types: [
+            "boolean"
+          ],
+          description: "Show the trait header (name, entity, listens/emits). @default true"
+        },
         className: {
           types: [
             "string"
           ],
-          description: "Additional CSS classes",
-          default: ""
+          description: "className prop"
+        },
+        trait: {
+          types: [
+            "object"
+          ],
+          description: "The trait to draw (see `parseTraitLevel` / `traitLevelFromTrait`).",
+          properties: {
+            name: {
+              types: [
+                "string"
+              ]
+            },
+            linkedEntity: {
+              types: [
+                "string"
+              ]
+            },
+            states: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  name: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  isInitial: {
+                    types: [
+                      "boolean"
+                    ]
+                  },
+                  isTerminal: {
+                    types: [
+                      "boolean"
+                    ]
+                  }
+                },
+                required: [
+                  "name"
+                ]
+              }
+            },
+            transitions: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  from: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  to: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  event: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  guard: {
+                    types: [
+                      "sexpr"
+                    ]
+                  },
+                  effects: {
+                    types: [
+                      "array"
+                    ],
+                    items: {
+                      types: [
+                        "object"
+                      ],
+                      properties: {
+                        type: {
+                          types: [
+                            "string"
+                          ]
+                        },
+                        args: {
+                          types: [
+                            "array"
+                          ],
+                          items: {
+                            types: [
+                              "sexpr"
+                            ]
+                          }
+                        }
+                      },
+                      required: [
+                        "type",
+                        "args"
+                      ]
+                    }
+                  },
+                  index: {
+                    types: [
+                      "number"
+                    ]
+                  }
+                },
+                required: [
+                  "from",
+                  "to",
+                  "event",
+                  "effects",
+                  "index"
+                ]
+              }
+            },
+            emittedEvents: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            listenedEvents: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "string"
+                ]
+              }
+            }
+          },
+          propertyRequired: [
+            "name",
+            "linkedEntity",
+            "states",
+            "transitions",
+            "emittedEvents",
+            "listenedEvents"
+          ]
         },
         isLoading: {
           types: [
             "boolean"
           ],
-          description: "Loading state indicator"
+          description: "Loading state indicator",
+          default: false
         },
         error: {
           types: [
@@ -17553,230 +18069,15 @@ var patterns_registry_default = {
           },
           propertyRequired: [
             "message"
-          ]
-        },
-        layoutData: {
-          types: [
-            "object"
-          ],
-          description: "Pre-computed visualizer layout. Optional: when absent the view renders nothing (an author wires real layout via config; the generic factory can't synthesize a `DomLayoutData`).",
-          nonAuthorable: true
-        },
-        renderStateNode: {
-          types: [
-            "function"
-          ],
-          description: "Custom state node renderer \u2014 when provided, replaces the default circle nodes",
-          callbackArgs: [
-            {
-              name: "state",
-              type: "object",
-              schema: {
-                types: [
-                  "object"
-                ],
-                properties: {
-                  id: {
-                    types: [
-                      "string"
-                    ]
-                  },
-                  name: {
-                    types: [
-                      "string"
-                    ]
-                  },
-                  x: {
-                    types: [
-                      "number"
-                    ]
-                  },
-                  y: {
-                    types: [
-                      "number"
-                    ]
-                  },
-                  radius: {
-                    types: [
-                      "number"
-                    ]
-                  },
-                  isInitial: {
-                    types: [
-                      "boolean"
-                    ]
-                  },
-                  isFinal: {
-                    types: [
-                      "boolean"
-                    ]
-                  },
-                  description: {
-                    types: [
-                      "string"
-                    ]
-                  }
-                },
-                required: [
-                  "id",
-                  "name",
-                  "x",
-                  "y",
-                  "radius",
-                  "isInitial",
-                  "isFinal"
-                ]
-              }
-            },
-            {
-              name: "config",
-              type: "object",
-              schema: {
-                types: [
-                  "object"
-                ],
-                properties: {
-                  nodeRadius: {
-                    types: [
-                      "number"
-                    ]
-                  },
-                  nodeSpacing: {
-                    types: [
-                      "number"
-                    ]
-                  },
-                  initialIndicatorOffset: {
-                    types: [
-                      "number"
-                    ]
-                  },
-                  arrowSize: {
-                    types: [
-                      "number"
-                    ]
-                  },
-                  colors: {
-                    types: [
-                      "object"
-                    ],
-                    properties: {
-                      background: {
-                        types: [
-                          "string"
-                        ]
-                      },
-                      node: {
-                        types: [
-                          "string"
-                        ]
-                      },
-                      nodeBorder: {
-                        types: [
-                          "string"
-                        ]
-                      },
-                      nodeText: {
-                        types: [
-                          "string"
-                        ]
-                      },
-                      initialNode: {
-                        types: [
-                          "string"
-                        ]
-                      },
-                      finalNode: {
-                        types: [
-                          "string"
-                        ]
-                      },
-                      arrow: {
-                        types: [
-                          "string"
-                        ]
-                      },
-                      arrowText: {
-                        types: [
-                          "string"
-                        ]
-                      },
-                      effectText: {
-                        types: [
-                          "string"
-                        ]
-                      },
-                      guardText: {
-                        types: [
-                          "string"
-                        ]
-                      },
-                      initial: {
-                        types: [
-                          "string"
-                        ]
-                      }
-                    },
-                    required: [
-                      "background",
-                      "node",
-                      "nodeBorder",
-                      "nodeText",
-                      "initialNode",
-                      "finalNode",
-                      "arrow",
-                      "arrowText",
-                      "effectText",
-                      "guardText",
-                      "initial"
-                    ]
-                  },
-                  fonts: {
-                    types: [
-                      "object"
-                    ],
-                    properties: {
-                      node: {
-                        types: [
-                          "string"
-                        ]
-                      },
-                      event: {
-                        types: [
-                          "string"
-                        ]
-                      },
-                      effect: {
-                        types: [
-                          "string"
-                        ]
-                      }
-                    },
-                    required: [
-                      "node",
-                      "event",
-                      "effect"
-                    ]
-                  }
-                },
-                required: [
-                  "nodeRadius",
-                  "nodeSpacing",
-                  "initialIndicatorOffset",
-                  "arrowSize",
-                  "colors",
-                  "fonts"
-                ]
-              }
-            }
           ],
-          renderCallback: true
+          default: null
         }
       }
     },
     "scaled-diagram": {
       type: "scaled-diagram",
       category: "component",
+      sourceFile: "components/core/molecules/ScaledDiagram.tsx",
       tier: "molecules",
       family: "core",
       description: "ScaledDiagram Molecule  Wraps a fixed-size diagram (like JazariStateMachine / StateMachineView) and CSS-scales it to fit the parent container width.  The diagram renders at its natural (large) size. We observe the content element and once the diagram is measured we apply transform:scale() with a corrected container height so surrounding layout flows correctly.  Event Contract: - No events emitted (layout-only wrapper) - entityAware: false",
@@ -17805,6 +18106,7 @@ var patterns_registry_default = {
     "day-cell": {
       type: "day-cell",
       category: "component",
+      sourceFile: "components/core/atoms/DayCell.tsx",
       tier: "atoms",
       family: "core",
       description: "DayCell component",
@@ -17852,6 +18154,7 @@ var patterns_registry_default = {
     "flip-container": {
       type: "flip-container",
       category: "layout",
+      sourceFile: "components/core/atoms/FlipContainer.tsx",
       tier: "atoms",
       family: "core",
       description: "FlipContainer component",
@@ -17895,6 +18198,7 @@ var patterns_registry_default = {
     "time-slot-cell": {
       type: "time-slot-cell",
       category: "layout",
+      sourceFile: "components/core/atoms/TimeSlotCell.tsx",
       tier: "atoms",
       family: "core",
       description: "TimeSlotCell component",
@@ -18185,6 +18489,7 @@ var patterns_registry_default = {
     "chart-legend": {
       type: "chart-legend",
       category: "display",
+      sourceFile: "components/core/molecules/ChartLegend.tsx",
       tier: "molecules",
       family: "core",
       description: "ChartLegend component",
@@ -18245,6 +18550,7 @@ var patterns_registry_default = {
     "date-range-selector": {
       type: "date-range-selector",
       category: "form",
+      sourceFile: "components/core/molecules/DateRangeSelector.tsx",
       tier: "molecules",
       family: "core",
       description: "DateRangeSelector component",
@@ -18314,6 +18620,7 @@ var patterns_registry_default = {
     "flip-card": {
       type: "flip-card",
       category: "display",
+      sourceFile: "components/core/molecules/FlipCard.tsx",
       tier: "molecules",
       family: "core",
       description: "FlipCard \u2014 flip card that reveals a hidden back face on tap or click, toggling between a front and back content slot.",
@@ -18372,6 +18679,7 @@ var patterns_registry_default = {
     "graph-view": {
       type: "graph-view",
       category: "component",
+      sourceFile: "components/core/molecules/GraphView.tsx",
       tier: "molecules",
       family: "core",
       description: "GraphView component",
@@ -19903,6 +20211,7 @@ var patterns_registry_default = {
     "map-view": {
       type: "map-view",
       category: "component",
+      sourceFile: "components/core/molecules/MapView.tsx",
       tier: "molecules",
       family: "core",
       description: "MapView component",
@@ -20344,6 +20653,7 @@ var patterns_registry_default = {
     "status-dot": {
       type: "status-dot",
       category: "display",
+      sourceFile: "components/core/atoms/StatusDot.tsx",
       tier: "atoms",
       family: "core",
       description: "StatusDot component",
@@ -20405,6 +20715,7 @@ var patterns_registry_default = {
     "trend-indicator": {
       type: "trend-indicator",
       category: "component",
+      sourceFile: "components/core/atoms/TrendIndicator.tsx",
       tier: "atoms",
       family: "core",
       description: "TrendIndicator component",
@@ -20475,6 +20786,7 @@ var patterns_registry_default = {
     lightbox: {
       type: "lightbox",
       category: "component",
+      sourceFile: "components/core/molecules/Lightbox.tsx",
       tier: "molecules",
       family: "core",
       description: "Lightbox component",
@@ -20572,6 +20884,7 @@ var patterns_registry_default = {
     "number-stepper": {
       type: "number-stepper",
       category: "component",
+      sourceFile: "components/core/molecules/NumberStepper.tsx",
       tier: "molecules",
       family: "core",
       description: "NumberStepper component",
@@ -20659,7 +20972,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Payload to include with the action event",
-          payloadFor: "action"
+          payloadFor: "action",
+          eventPayloadBrand: true
         },
         className: {
           types: [
@@ -20678,6 +20992,7 @@ var patterns_registry_default = {
     "star-rating": {
       type: "star-rating",
       category: "component",
+      sourceFile: "components/core/molecules/StarRating.tsx",
       tier: "molecules",
       family: "core",
       description: "StarRating component",
@@ -20751,7 +21066,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Payload to include with the action event",
-          payloadFor: "action"
+          payloadFor: "action",
+          eventPayloadBrand: true
         },
         onChange: {
           types: [
@@ -20783,6 +21099,7 @@ var patterns_registry_default = {
     "upload-drop-zone": {
       type: "upload-drop-zone",
       category: "component",
+      sourceFile: "components/core/molecules/UploadDropZone.tsx",
       tier: "molecules",
       family: "core",
       description: "UploadDropZone component",
@@ -20896,7 +21213,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Payload to include with the action event",
-          payloadFor: "action"
+          payloadFor: "action",
+          eventPayloadBrand: true
         },
         onFiles: {
           types: [
@@ -20994,6 +21312,7 @@ var patterns_registry_default = {
     "confetti-effect": {
       type: "confetti-effect",
       category: "component",
+      sourceFile: "components/core/atoms/ConfettiEffect.tsx",
       tier: "atoms",
       family: "core",
       description: "ConfettiEffect component",
@@ -21036,6 +21355,7 @@ var patterns_registry_default = {
     "infinite-scroll-sentinel": {
       type: "infinite-scroll-sentinel",
       category: "component",
+      sourceFile: "components/core/atoms/InfiniteScrollSentinel.tsx",
       tier: "atoms",
       family: "core",
       description: "InfiniteScrollSentinel component",
@@ -21060,7 +21380,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Optional payload to include with the load-more event",
-          payloadFor: "loadMoreEvent"
+          payloadFor: "loadMoreEvent",
+          eventPayloadBrand: true
         },
         isLoading: {
           types: [
@@ -21094,6 +21415,7 @@ var patterns_registry_default = {
     "typewriter-text": {
       type: "typewriter-text",
       category: "component",
+      sourceFile: "components/core/atoms/TypewriterText.tsx",
       tier: "atoms",
       family: "core",
       description: "TypewriterText component",
@@ -21333,6 +21655,7 @@ var patterns_registry_default = {
     "pull-to-refresh": {
       type: "pull-to-refresh",
       category: "component",
+      sourceFile: "components/core/molecules/PullToRefresh.tsx",
       tier: "molecules",
       family: "core",
       description: "PullToRefresh component",
@@ -21356,7 +21679,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Payload to include with the refresh event",
-          payloadFor: "refreshEvent"
+          payloadFor: "refreshEvent",
+          eventPayloadBrand: true
         },
         threshold: {
           types: [
@@ -21633,6 +21957,7 @@ var patterns_registry_default = {
     "stat-display": {
       type: "stat-display",
       category: "display",
+      sourceFile: "components/core/molecules/StatDisplay.tsx",
       tier: "molecules",
       family: "core",
       description: "StatDisplay component",
@@ -21852,6 +22177,7 @@ var patterns_registry_default = {
     "section-header": {
       type: "section-header",
       category: "header",
+      sourceFile: "components/core/atoms/SectionHeader.tsx",
       tier: "atoms",
       family: "core",
       description: "SectionHeader component",
@@ -21992,6 +22318,7 @@ var patterns_registry_default = {
     "feature-grid": {
       type: "feature-grid",
       category: "display",
+      sourceFile: "components/core/molecules/FeatureGrid.tsx",
       tier: "molecules",
       family: "core",
       description: "FeatureGrid component",
@@ -22108,6 +22435,7 @@ var patterns_registry_default = {
     "social-proof": {
       type: "social-proof",
       category: "component",
+      sourceFile: "components/core/molecules/SocialProof.tsx",
       tier: "molecules",
       family: "core",
       description: "SocialProof component",
@@ -22446,6 +22774,7 @@ var patterns_registry_default = {
     "edge-decoration": {
       type: "edge-decoration",
       category: "component",
+      sourceFile: "components/core/molecules/EdgeDecoration.tsx",
       tier: "molecules",
       family: "core",
       description: "EdgeDecoration component",
@@ -22519,6 +22848,7 @@ var patterns_registry_default = {
     "ui-slot-renderer": {
       type: "ui-slot-renderer",
       category: "layout",
+      sourceFile: "components/core/organisms/UISlotRenderer.tsx",
       tier: "organisms",
       family: "core",
       description: "UISlotRenderer component",
@@ -22635,6 +22965,7 @@ var patterns_registry_default = {
     "trait-frame": {
       type: "trait-frame",
       category: "component",
+      sourceFile: "components/core/atoms/TraitFrame.tsx",
       tier: "atoms",
       family: "core",
       description: "TraitFrame \u2014 renders the current frame of a referenced trait.  Resolves the `@trait.X[.slot]` binding at render time by looking up the referenced trait's last `render-ui` payload from the orbital's `UISlotManager`. Re-renders automatically when that trait transitions via the per-trait subscription channel (`subscribeTrait`).  This is the single rendering primitive both runtime paths converge on:  - **Interpreted path** \u2014 the trait-binding resolver in `renderer/trait-binding-resolver.ts` walks pattern trees at render time, substituting `\"@trait.X\"` string children with this component. - **Compiled path** \u2014 the TypeScript shell codegen in `orbital-shell-typescript/src/backend.rs::pattern_to_jsx_with_data` emits this component directly into generated JSX wherever a `@trait.*` string appears in a pattern tree.  Embedding is passive: the referenced trait's state machine runs unchanged; TraitFrame is only a read-only lens on its current frame. Event propagation happens over the shared event bus, not through this component.",
@@ -22716,6 +23047,16 @@ var patterns_registry_default = {
                   cyclicTypeName: "FileTreeNode"
                 }
               },
+              note: {
+                types: [
+                  "string"
+                ]
+              },
+              expandable: {
+                types: [
+                  "boolean"
+                ]
+              },
               size: {
                 types: [
                   "number"
@@ -22807,6 +23148,30 @@ var patterns_registry_default = {
             }
           ]
         },
+        onNodeExpand: {
+          types: [
+            "function"
+          ],
+          description: "Called the first time a node marked `expandable` is expanded, with its path, so its children can be loaded.",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "path",
+              type: "string"
+            }
+          ]
+        },
+        expandedPaths: {
+          types: [
+            "array"
+          ],
+          description: "Paths to show expanded (e.g. to reveal a node): each is expanded when it appears here, loading its children if needed.",
+          items: {
+            types: [
+              "string"
+            ]
+          }
+        },
         onNodeSelect: {
           types: [
             "function"
@@ -22887,6 +23252,7 @@ var patterns_registry_default = {
     "filter-pill": {
       type: "filter-pill",
       category: "filter",
+      sourceFile: "components/core/atoms/FilterPill.tsx",
       tier: "atoms",
       family: "core",
       description: "FilterPill component",
@@ -23004,6 +23370,7 @@ var patterns_registry_default = {
     "likert-scale": {
       type: "likert-scale",
       category: "component",
+      sourceFile: "components/core/molecules/LikertScale.tsx",
       tier: "molecules",
       family: "core",
       description: "LikertScale component",
@@ -23124,6 +23491,7 @@ var patterns_registry_default = {
     "matrix-question": {
       type: "matrix-question",
       category: "component",
+      sourceFile: "components/core/molecules/MatrixQuestion.tsx",
       tier: "molecules",
       family: "core",
       description: "MatrixQuestion component",
@@ -23273,6 +23641,7 @@ var patterns_registry_default = {
     "qr-scanner": {
       type: "qr-scanner",
       category: "component",
+      sourceFile: "components/core/molecules/QrScanner.tsx",
       tier: "molecules",
       family: "core",
       description: "QrScanner component",
@@ -23409,6 +23778,7 @@ var patterns_registry_default = {
     "vote-stack": {
       type: "vote-stack",
       category: "component",
+      sourceFile: "components/core/molecules/VoteStack.tsx",
       tier: "molecules",
       family: "core",
       description: "VoteStack component",
@@ -23517,6 +23887,7 @@ var patterns_registry_default = {
     "branching-logic-builder": {
       type: "branching-logic-builder",
       category: "display",
+      sourceFile: "components/core/molecules/BranchingLogicBuilder.tsx",
       tier: "molecules",
       family: "core",
       description: "BranchingLogicBuilder component",
@@ -24251,6 +24622,7 @@ var patterns_registry_default = {
     "option-constraint-group": {
       type: "option-constraint-group",
       category: "component",
+      sourceFile: "components/core/molecules/OptionConstraintGroup.tsx",
       tier: "molecules",
       family: "core",
       description: 'OptionConstraintGroup Molecule Component  Generic constrained option selector (radio for "single", checkbox for "multi") with required/optional/multi constraints. Renders radio inputs for `single` constraint and checkboxes for `multi`. Reports validation errors inline when the current selection violates the constraint.  **Atomic Design**: Composed using Typography atom and native form controls.',
@@ -24434,6 +24806,7 @@ var patterns_registry_default = {
     "positioned-canvas": {
       type: "positioned-canvas",
       category: "game",
+      sourceFile: "components/core/molecules/PositionedCanvas.tsx",
       tier: "molecules",
       family: "core",
       description: "PositionedCanvas component",
@@ -25785,6 +26158,7 @@ var patterns_registry_default = {
     "svg-branch": {
       type: "svg-branch",
       category: "component",
+      sourceFile: "components/core/atoms/svg/SvgBranch.tsx",
       tier: "atoms",
       family: "core",
       description: "SvgBranch component",
@@ -25881,6 +26255,7 @@ var patterns_registry_default = {
     "svg-connection": {
       type: "svg-connection",
       category: "component",
+      sourceFile: "components/core/atoms/svg/SvgConnection.tsx",
       tier: "atoms",
       family: "core",
       description: "SvgConnection component",
@@ -25984,6 +26359,7 @@ var patterns_registry_default = {
     "svg-flow": {
       type: "svg-flow",
       category: "component",
+      sourceFile: "components/core/atoms/svg/SvgFlow.tsx",
       tier: "atoms",
       family: "core",
       description: "SvgFlow component",
@@ -26070,6 +26446,7 @@ var patterns_registry_default = {
     "svg-grid": {
       type: "svg-grid",
       category: "display",
+      sourceFile: "components/core/atoms/svg/SvgGrid.tsx",
       tier: "atoms",
       family: "core",
       description: "SvgGrid component",
@@ -26180,6 +26557,7 @@ var patterns_registry_default = {
     "svg-lobe": {
       type: "svg-lobe",
       category: "component",
+      sourceFile: "components/core/atoms/svg/SvgLobe.tsx",
       tier: "atoms",
       family: "core",
       description: "SvgLobe component",
@@ -26278,6 +26656,7 @@ var patterns_registry_default = {
     "svg-mesh": {
       type: "svg-mesh",
       category: "component",
+      sourceFile: "components/core/atoms/svg/SvgMesh.tsx",
       tier: "atoms",
       family: "core",
       description: "SvgMesh component",
@@ -26369,6 +26748,7 @@ var patterns_registry_default = {
     "svg-morph": {
       type: "svg-morph",
       category: "component",
+      sourceFile: "components/core/atoms/svg/SvgMorph.tsx",
       tier: "atoms",
       family: "core",
       description: "SvgMorph component",
@@ -26458,6 +26838,7 @@ var patterns_registry_default = {
     "svg-node": {
       type: "svg-node",
       category: "component",
+      sourceFile: "components/core/atoms/svg/SvgNode.tsx",
       tier: "atoms",
       family: "core",
       description: "SvgNode component",
@@ -26553,6 +26934,7 @@ var patterns_registry_default = {
     "svg-pulse": {
       type: "svg-pulse",
       category: "component",
+      sourceFile: "components/core/atoms/svg/SvgPulse.tsx",
       tier: "atoms",
       family: "core",
       description: "SvgPulse component",
@@ -26644,6 +27026,7 @@ var patterns_registry_default = {
     "svg-ring": {
       type: "svg-ring",
       category: "component",
+      sourceFile: "components/core/atoms/svg/SvgRing.tsx",
       tier: "atoms",
       family: "core",
       description: "SvgRing component",
@@ -26746,6 +27129,7 @@ var patterns_registry_default = {
     "svg-shield": {
       type: "svg-shield",
       category: "component",
+      sourceFile: "components/core/atoms/svg/SvgShield.tsx",
       tier: "atoms",
       family: "core",
       description: "SvgShield component",
@@ -26835,6 +27219,7 @@ var patterns_registry_default = {
     "svg-stack": {
       type: "svg-stack",
       category: "component",
+      sourceFile: "components/core/atoms/svg/SvgStack.tsx",
       tier: "atoms",
       family: "core",
       description: "SvgStack component",
@@ -26936,6 +27321,7 @@ var patterns_registry_default = {
     "doc-breadcrumb": {
       type: "doc-breadcrumb",
       category: "navigation",
+      sourceFile: "components/core/molecules/DocBreadcrumb.tsx",
       tier: "molecules",
       family: "core",
       description: "DocBreadcrumb component",
@@ -26984,6 +27370,7 @@ var patterns_registry_default = {
     "doc-pagination": {
       type: "doc-pagination",
       category: "navigation",
+      sourceFile: "components/core/molecules/DocPagination.tsx",
       tier: "molecules",
       family: "core",
       description: "DocPagination component",
@@ -27166,6 +27553,7 @@ var patterns_registry_default = {
     "doc-toc": {
       type: "doc-toc",
       category: "component",
+      sourceFile: "components/core/molecules/DocTOC.tsx",
       tier: "molecules",
       family: "core",
       description: "DocTOC component",
@@ -27226,6 +27614,7 @@ var patterns_registry_default = {
     "gradient-divider": {
       type: "gradient-divider",
       category: "component",
+      sourceFile: "components/core/molecules/GradientDivider.tsx",
       tier: "molecules",
       family: "core",
       description: "GradientDivider component",
@@ -27253,6 +27642,7 @@ var patterns_registry_default = {
     "behavior-view": {
       type: "behavior-view",
       category: "component",
+      sourceFile: "components/avl/molecules/BehaviorView.tsx",
       tier: "molecules",
       family: "avl",
       description: "BehaviorView component",
@@ -27267,7 +27657,7 @@ var patterns_registry_default = {
           types: [
             "object"
           ],
-          description: "data prop",
+          description: "The orbital to summarize.",
           required: true,
           properties: {
             orbitalName: {
@@ -27282,7 +27672,7 @@ var patterns_registry_default = {
             },
             persistence: {
               types: [
-                "string"
+                "object"
               ]
             },
             fields: {
@@ -27454,9 +27844,7 @@ var patterns_registry_default = {
                         }
                       },
                       required: [
-                        "name",
-                        "isInitial",
-                        "isTerminal"
+                        "name"
                       ]
                     }
                   },
@@ -27530,7 +27918,6 @@ var patterns_registry_default = {
                         "from",
                         "to",
                         "event",
-                        "guard",
                         "effects",
                         "index"
                       ]
@@ -27615,17 +28002,199 @@ var patterns_registry_default = {
             "pages",
             "traitDetails",
             "externalLinks"
-          ]
+          ],
+          example: {
+            orbitalName: "OrderOrbital",
+            entityName: "Order",
+            persistence: "persistent",
+            fields: [
+              {
+                name: "customer",
+                type: "string",
+                required: true,
+                hasDefault: false
+              },
+              {
+                name: "qty",
+                type: "number",
+                required: true,
+                hasDefault: true
+              },
+              {
+                name: "status",
+                type: "string",
+                required: false,
+                hasDefault: true
+              }
+            ],
+            traits: [
+              {
+                name: "OrderFlow",
+                stateCount: 5,
+                eventCount: 7,
+                transitionCount: 7,
+                emits: [
+                  "ORDER_SAVED"
+                ],
+                listens: [
+                  "PAYMENT_OK"
+                ]
+              }
+            ],
+            pages: [
+              {
+                name: "Orders",
+                route: "/orders"
+              }
+            ],
+            traitDetails: {
+              OrderFlow: {
+                name: "OrderFlow",
+                linkedEntity: "Order",
+                states: [
+                  {
+                    name: "browsing",
+                    isInitial: true,
+                    isTerminal: false
+                  },
+                  {
+                    name: "editing",
+                    isInitial: false,
+                    isTerminal: false
+                  },
+                  {
+                    name: "saving",
+                    isInitial: false,
+                    isTerminal: false
+                  },
+                  {
+                    name: "confirmed",
+                    isInitial: false,
+                    isTerminal: true
+                  },
+                  {
+                    name: "failed",
+                    isInitial: false,
+                    isTerminal: false
+                  }
+                ],
+                transitions: [
+                  {
+                    from: "browsing",
+                    to: "editing",
+                    event: "EDIT",
+                    effects: [
+                      {
+                        type: "render-ui",
+                        args: []
+                      }
+                    ],
+                    index: 0
+                  },
+                  {
+                    from: "editing",
+                    to: "saving",
+                    event: "SAVE",
+                    effects: [
+                      {
+                        type: "persist",
+                        args: []
+                      },
+                      {
+                        type: "notify",
+                        args: []
+                      }
+                    ],
+                    index: 1
+                  },
+                  {
+                    from: "saving",
+                    to: "confirmed",
+                    event: "SAVED",
+                    effects: [
+                      {
+                        type: "emit",
+                        args: []
+                      },
+                      {
+                        type: "render-ui",
+                        args: []
+                      }
+                    ],
+                    index: 2
+                  },
+                  {
+                    from: "saving",
+                    to: "failed",
+                    event: "SAVE_FAILED",
+                    effects: [
+                      {
+                        type: "notify",
+                        args: []
+                      }
+                    ],
+                    index: 3
+                  },
+                  {
+                    from: "failed",
+                    to: "editing",
+                    event: "RETRY",
+                    effects: [],
+                    index: 4
+                  },
+                  {
+                    from: "editing",
+                    to: "browsing",
+                    event: "CANCEL",
+                    effects: [
+                      {
+                        type: "render-ui",
+                        args: []
+                      }
+                    ],
+                    index: 5
+                  },
+                  {
+                    from: "confirmed",
+                    to: "browsing",
+                    event: "DONE",
+                    effects: [
+                      {
+                        type: "navigate",
+                        args: []
+                      }
+                    ],
+                    index: 6
+                  }
+                ],
+                emittedEvents: [
+                  "ORDER_SAVED"
+                ],
+                listenedEvents: [
+                  "PAYMENT_OK"
+                ]
+              }
+            },
+            externalLinks: [
+              {
+                targetOrbital: "PaymentOrbital",
+                eventName: "PAYMENT_OK",
+                direction: "in",
+                traitName: "OrderFlow"
+              }
+            ]
+          }
         }
       }
     },
     "module-card": {
       type: "module-card",
       category: "display",
+      sourceFile: "components/avl/molecules/ModuleCard.tsx",
       tier: "molecules",
       family: "avl",
-      description: "ModuleCard \u2014 a card summarizing one course module or lesson with progress and entry point.",
-      capabilities: "course module card, lesson card, curriculum unit card, learning-path step card",
+      description: "ModuleCard \u2014 a compact summary card for one orbital module: its entity and fields, a mini state machine per trait, and its pages.",
+      capabilities: "orbital module summary card, entity and trait overview card, app architecture node card",
       suggestedFor: [
         "module",
         "card",
@@ -27637,7 +28206,7 @@ var patterns_registry_default = {
           types: [
             "object"
           ],
-          description: "data prop",
+          description: "The orbital to summarize.",
           required: true,
           properties: {
             orbitalName: {
@@ -27652,7 +28221,7 @@ var patterns_registry_default = {
             },
             persistence: {
               types: [
-                "string"
+                "object"
               ]
             },
             fields: {
@@ -27824,9 +28393,7 @@ var patterns_registry_default = {
                         }
                       },
                       required: [
-                        "name",
-                        "isInitial",
-                        "isTerminal"
+                        "name"
                       ]
                     }
                   },
@@ -27900,7 +28467,6 @@ var patterns_registry_default = {
                         "from",
                         "to",
                         "event",
-                        "guard",
                         "effects",
                         "index"
                       ]
@@ -27985,7 +28551,188 @@ var patterns_registry_default = {
             "pages",
             "traitDetails",
             "externalLinks"
-          ]
+          ],
+          example: {
+            orbitalName: "OrderOrbital",
+            entityName: "Order",
+            persistence: "persistent",
+            fields: [
+              {
+                name: "customer",
+                type: "string",
+                required: true,
+                hasDefault: false
+              },
+              {
+                name: "qty",
+                type: "number",
+                required: true,
+                hasDefault: true
+              },
+              {
+                name: "status",
+                type: "string",
+                required: false,
+                hasDefault: true
+              }
+            ],
+            traits: [
+              {
+                name: "OrderFlow",
+                stateCount: 5,
+                eventCount: 7,
+                transitionCount: 7,
+                emits: [
+                  "ORDER_SAVED"
+                ],
+                listens: [
+                  "PAYMENT_OK"
+                ]
+              }
+            ],
+            pages: [
+              {
+                name: "Orders",
+                route: "/orders"
+              }
+            ],
+            traitDetails: {
+              OrderFlow: {
+                name: "OrderFlow",
+                linkedEntity: "Order",
+                states: [
+                  {
+                    name: "browsing",
+                    isInitial: true,
+                    isTerminal: false
+                  },
+                  {
+                    name: "editing",
+                    isInitial: false,
+                    isTerminal: false
+                  },
+                  {
+                    name: "saving",
+                    isInitial: false,
+                    isTerminal: false
+                  },
+                  {
+                    name: "confirmed",
+                    isInitial: false,
+                    isTerminal: true
+                  },
+                  {
+                    name: "failed",
+                    isInitial: false,
+                    isTerminal: false
+                  }
+                ],
+                transitions: [
+                  {
+                    from: "browsing",
+                    to: "editing",
+                    event: "EDIT",
+                    effects: [
+                      {
+                        type: "render-ui",
+                        args: []
+                      }
+                    ],
+                    index: 0
+                  },
+                  {
+                    from: "editing",
+                    to: "saving",
+                    event: "SAVE",
+                    effects: [
+                      {
+                        type: "persist",
+                        args: []
+                      },
+                      {
+                        type: "notify",
+                        args: []
+                      }
+                    ],
+                    index: 1
+                  },
+                  {
+                    from: "saving",
+                    to: "confirmed",
+                    event: "SAVED",
+                    effects: [
+                      {
+                        type: "emit",
+                        args: []
+                      },
+                      {
+                        type: "render-ui",
+                        args: []
+                      }
+                    ],
+                    index: 2
+                  },
+                  {
+                    from: "saving",
+                    to: "failed",
+                    event: "SAVE_FAILED",
+                    effects: [
+                      {
+                        type: "notify",
+                        args: []
+                      }
+                    ],
+                    index: 3
+                  },
+                  {
+                    from: "failed",
+                    to: "editing",
+                    event: "RETRY",
+                    effects: [],
+                    index: 4
+                  },
+                  {
+                    from: "editing",
+                    to: "browsing",
+                    event: "CANCEL",
+                    effects: [
+                      {
+                        type: "render-ui",
+                        args: []
+                      }
+                    ],
+                    index: 5
+                  },
+                  {
+                    from: "confirmed",
+                    to: "browsing",
+                    event: "DONE",
+                    effects: [
+                      {
+                        type: "navigate",
+                        args: []
+                      }
+                    ],
+                    index: 6
+                  }
+                ],
+                emittedEvents: [
+                  "ORDER_SAVED"
+                ],
+                listenedEvents: [
+                  "PAYMENT_OK"
+                ]
+              }
+            },
+            externalLinks: [
+              {
+                targetOrbital: "PaymentOrbital",
+                eventName: "PAYMENT_OK",
+                direction: "in",
+                traitName: "OrderFlow"
+              }
+            ]
+          }
         }
       }
     },
@@ -31815,6 +32562,7 @@ var patterns_registry_default = {
     "dashboard-grid": {
       type: "dashboard-grid",
       category: "game",
+      sourceFile: "components/core/organisms/layout/DashboardGrid.tsx",
       tier: "organisms",
       family: "core",
       description: "DashboardGrid Component  Multi-column grid for widgets and stats cards. Supports cell spanning for flexible dashboard layouts.  Uses wireframe theme styling (high contrast, sharp edges).",
@@ -32004,6 +32752,7 @@ var patterns_registry_default = {
     "split-pane": {
       type: "split-pane",
       category: "layout",
+      sourceFile: "components/core/organisms/layout/SplitPane.tsx",
       tier: "organisms",
       family: "core",
       description: "SplitPane component",
@@ -32095,6 +32844,7 @@ var patterns_registry_default = {
     "tabbed-container": {
       type: "tabbed-container",
       category: "navigation",
+      sourceFile: "components/core/organisms/layout/TabbedContainer.tsx",
       tier: "organisms",
       family: "core",
       description: "TabbedContainer component",
@@ -32201,6 +32951,7 @@ var patterns_registry_default = {
     "master-detail-layout": {
       type: "master-detail-layout",
       category: "display",
+      sourceFile: "components/core/organisms/layout/MasterDetailLayout.tsx",
       tier: "organisms",
       family: "core",
       description: "MasterDetail Component  Classic master-detail pattern with a list on the left and selected item detail on the right.  Uses wireframe theme styling (high contrast, sharp edges).",
@@ -32269,6 +33020,7 @@ var patterns_registry_default = {
     sparkline: {
       type: "sparkline",
       category: "component",
+      sourceFile: "components/core/atoms/Sparkline.tsx",
       tier: "atoms",
       family: "core",
       description: "Sparkline Atom Component  Minimal inline trend chart. Pure SVG polyline over a numeric series. Extracted from StatCard's sparkline path so any KPI or list row can include a trend visualization without compositing the whole card.",
@@ -32344,6 +33096,7 @@ var patterns_registry_default = {
     "date-range-picker": {
       type: "date-range-picker",
       category: "component",
+      sourceFile: "components/core/molecules/DateRangePicker.tsx",
       tier: "molecules",
       family: "core",
       description: "DateRangePicker component",
@@ -32494,6 +33247,7 @@ var patterns_registry_default = {
     aside: {
       type: "aside",
       category: "component",
+      sourceFile: "components/core/atoms/Aside.tsx",
       tier: "atoms",
       family: "core",
       description: "Aside \u2014 a secondary side panel that hosts navigation links or supplementary content alongside a main content area.",
@@ -32520,6 +33274,7 @@ var patterns_registry_default = {
     dialog: {
       type: "dialog",
       category: "container",
+      sourceFile: "components/core/atoms/Dialog.tsx",
       tier: "atoms",
       family: "core",
       description: 'Dialog Atom Component  Semantic wrapper for the native `<dialog>` element. Owns the raw HTML rendering so molecules (Modal, ConfirmDialog, etc.) can compose the dialog primitive without dropping back to raw HTML.  Defaults `role="dialog"` and `aria-modal="true"`; both overridable for non-modal use cases.',
@@ -32545,6 +33300,7 @@ var patterns_registry_default = {
     "tag-input": {
       type: "tag-input",
       category: "form",
+      sourceFile: "components/core/molecules/TagInput.tsx",
       tier: "molecules",
       family: "core",
       description: "TagInput component",
@@ -33260,6 +34016,7 @@ var patterns_registry_default = {
     "stat-card": {
       type: "stat-card",
       category: "display",
+      sourceFile: "components/core/organisms/StatCard.tsx",
       tier: "organisms",
       family: "core",
       description: "StatCard component",
@@ -33570,6 +34327,7 @@ var patterns_registry_default = {
     "activation-block": {
       type: "activation-block",
       category: "component",
+      sourceFile: "components/core/molecules/ActivationBlock.tsx",
       tier: "molecules",
       family: "core",
       description: "ActivationBlock component",
@@ -33611,6 +34369,7 @@ var patterns_registry_default = {
     "bloom-quiz-block": {
       type: "bloom-quiz-block",
       category: "component",
+      sourceFile: "components/core/molecules/BloomQuizBlock.tsx",
       tier: "molecules",
       family: "core",
       description: "BloomQuizBlock component",
@@ -33681,6 +34440,7 @@ var patterns_registry_default = {
     "connection-block": {
       type: "connection-block",
       category: "component",
+      sourceFile: "components/core/molecules/ConnectionBlock.tsx",
       tier: "molecules",
       family: "core",
       description: "ConnectionBlock component",
@@ -33709,6 +34469,7 @@ var patterns_registry_default = {
     "reflection-block": {
       type: "reflection-block",
       category: "component",
+      sourceFile: "components/core/molecules/ReflectionBlock.tsx",
       tier: "molecules",
       family: "core",
       description: "ReflectionBlock component",
@@ -35525,6 +36286,7 @@ var patterns_registry_default = {
     vstack: {
       type: "vstack",
       category: "component",
+      sourceFile: "components/core/atoms/Stack.tsx",
       tier: "atoms",
       family: "core",
       description: "VStack - Vertical stack shorthand",
@@ -35681,7 +36443,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Payload to include with the action event",
-          payloadFor: "action"
+          payloadFor: "action",
+          eventPayloadBrand: true
         },
         responsive: {
           types: [
@@ -35695,6 +36458,7 @@ var patterns_registry_default = {
     hstack: {
       type: "hstack",
       category: "component",
+      sourceFile: "components/core/atoms/Stack.tsx",
       tier: "atoms",
       family: "core",
       description: "HStack - Horizontal stack shorthand",
@@ -35851,7 +36615,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Payload to include with the action event",
-          payloadFor: "action"
+          payloadFor: "action",
+          eventPayloadBrand: true
         },
         responsive: {
           types: [
@@ -35865,6 +36630,7 @@ var patterns_registry_default = {
     "form-layout": {
       type: "form-layout",
       category: "form",
+      sourceFile: "components/core/molecules/FormSection.tsx",
       tier: "molecules",
       family: "core",
       description: "Form layout with multiple sections",
@@ -36000,6 +36766,7 @@ var patterns_registry_default = {
     "learning-canvas": {
       type: "learning-canvas",
       category: "learning",
+      sourceFile: "components/learning/atoms/LearningCanvas.tsx",
       tier: "atoms",
       family: "learning",
       description: "LearningCanvas component",
@@ -36604,6 +37371,7 @@ var patterns_registry_default = {
     "biology-canvas": {
       type: "biology-canvas",
       category: "learning",
+      sourceFile: "components/learning/molecules/BiologyCanvas.tsx",
       tier: "molecules",
       family: "learning",
       description: "BiologyCanvas component",
@@ -37900,6 +38668,7 @@ var patterns_registry_default = {
     "chemistry-canvas": {
       type: "chemistry-canvas",
       category: "learning",
+      sourceFile: "components/learning/molecules/ChemistryCanvas.tsx",
       tier: "molecules",
       family: "learning",
       description: "ChemistryCanvas component",
@@ -40277,6 +41046,7 @@ var patterns_registry_default = {
     "physics-canvas": {
       type: "physics-canvas",
       category: "learning",
+      sourceFile: "components/learning/molecules/PhysicsCanvas.tsx",
       tier: "molecules",
       family: "learning",
       description: "PhysicsCanvas component",
@@ -41794,6 +42564,7 @@ var patterns_registry_default = {
     "state-graph": {
       type: "state-graph",
       category: "game",
+      sourceFile: "components/game/molecules/StateGraph.tsx",
       tier: "molecules",
       family: "game",
       description: `StateGraph (molecule)  Dumb visual renderer for a state-machine graph: lays states out on a circle, draws the player's transitions as SVG arrows, and emits a node-click event. All state (which transitions exist, the pending "from" selection, test results) lives in the .lolo FSM \u2014 this molecule only renders and reports clicks.`,
@@ -41918,6 +42689,7 @@ var patterns_registry_default = {
     "state-json-view": {
       type: "state-json-view",
       category: "game",
+      sourceFile: "components/game/molecules/StateJsonView.tsx",
       tier: "molecules",
       family: "game",
       description: "StateJsonView Component  Shows a state machine's definition as an expandable code block, so the learner sees the declarative schema behind the visual graph. Dumb molecule: takes the machine as plain typed fields (name/states/initialState/transitions) \u2014 the .lolo organism owns the entity and the molecule renders + stringifies it.",
@@ -42013,6 +42785,7 @@ var patterns_registry_default = {
     "algorithm-canvas": {
       type: "algorithm-canvas",
       category: "learning",
+      sourceFile: "components/learning/molecules/AlgorithmCanvas.tsx",
       tier: "molecules",
       family: "learning",
       description: "AlgorithmCanvas component",
@@ -42804,6 +43577,7 @@ var patterns_registry_default = {
     "atlas-image": {
       type: "atlas-image",
       category: "component",
+      sourceFile: "components/core/atoms/AtlasImage.tsx",
       tier: "atoms",
       family: "core",
       description: "AtlasImage component",
@@ -42918,6 +43692,7 @@ var patterns_registry_default = {
     "atlas-panel": {
       type: "atlas-panel",
       category: "component",
+      sourceFile: "components/core/atoms/AtlasImage.tsx",
       tier: "atoms",
       family: "core",
       description: "AtlasPanel component",
@@ -43020,6 +43795,7 @@ var patterns_registry_default = {
     "draw-shape": {
       type: "draw-shape",
       category: "game",
+      sourceFile: "components/game/atoms/DrawShape.tsx",
       tier: "atoms",
       family: "game",
       description: "DrawShape component",
@@ -43987,6 +44763,7 @@ var patterns_registry_default = {
     "draw-text": {
       type: "draw-text",
       category: "game",
+      sourceFile: "components/game/atoms/DrawText.tsx",
       tier: "atoms",
       family: "game",
       description: "DrawText component",
@@ -44124,6 +44901,7 @@ var patterns_registry_default = {
     "draw-shape-layer": {
       type: "draw-shape-layer",
       category: "game",
+      sourceFile: "components/game/molecules/DrawShapeLayer.tsx",
       tier: "molecules",
       family: "game",
       description: "DrawShapeLayer component",
@@ -45114,6 +45892,7 @@ var patterns_registry_default = {
     "draw-text-layer": {
       type: "draw-text-layer",
       category: "game",
+      sourceFile: "components/game/molecules/DrawTextLayer.tsx",
       tier: "molecules",
       family: "game",
       description: "DrawTextLayer component",
@@ -46049,6 +46828,7 @@ var patterns_registry_default = {
     presence: {
       type: "presence",
       category: "component",
+      sourceFile: "components/core/atoms/Presence.tsx",
       tier: "atoms",
       family: "core",
       description: "Presence component",
@@ -46082,6 +46862,7 @@ var patterns_registry_default = {
     "page-transition": {
       type: "page-transition",
       category: "component",
+      sourceFile: "components/core/molecules/PageTransition.tsx",
       tier: "molecules",
       family: "core",
       description: "PageTransition component",
@@ -46278,6 +47059,7 @@ var patterns_registry_default = {
     "import-progress": {
       type: "import-progress",
       category: "component",
+      sourceFile: "components/core/molecules/import/ImportProgress.tsx",
       tier: "molecules",
       family: "core",
       description: "ImportProgress component",
@@ -46348,6 +47130,7 @@ var patterns_registry_default = {
     "import-source-picker": {
       type: "import-source-picker",
       category: "component",
+      sourceFile: "components/core/molecules/import/ImportSourcePicker.tsx",
       tier: "molecules",
       family: "core",
       description: "ImportSourcePicker component",
@@ -46482,6 +47265,7 @@ var patterns_registry_default = {
     "draw-group": {
       type: "draw-group",
       category: "game",
+      sourceFile: "components/game/atoms/DrawGroup.tsx",
       tier: "atoms",
       family: "game",
       description: "DrawGroup component",
@@ -46701,6 +47485,7 @@ var patterns_registry_default = {
     "emoji-picker": {
       type: "emoji-picker",
       category: "component",
+      sourceFile: "components/core/molecules/EmojiPicker.tsx",
       tier: "molecules",
       family: "core",
       description: "EmojiPicker component",
@@ -46762,6 +47547,7 @@ var patterns_registry_default = {
     "draw-mesh": {
       type: "draw-mesh",
       category: "game",
+      sourceFile: "components/game/atoms/DrawMesh.tsx",
       tier: "atoms",
       family: "game",
       description: "DrawMesh component",
@@ -47239,6 +48025,7 @@ var patterns_registry_default = {
     "algo-graph-canvas": {
       type: "algo-graph-canvas",
       category: "learning",
+      sourceFile: "components/learning/molecules/AlgoGraphCanvas.tsx",
       tier: "molecules",
       family: "learning",
       description: "AlgoGraphCanvas component",
@@ -47804,6 +48591,7 @@ var patterns_registry_default = {
     "fx-overlay": {
       type: "fx-overlay",
       category: "container",
+      sourceFile: "components/core/molecules/FxOverlay.tsx",
       tier: "molecules",
       family: "core",
       description: "FxOverlay component",
@@ -48381,6 +49169,7 @@ var patterns_registry_default = {
     "rich-text-editor": {
       type: "rich-text-editor",
       category: "component",
+      sourceFile: "components/core/molecules/RichTextEditor.tsx",
       tier: "molecules",
       family: "core",
       description: "RichTextEditor component",
@@ -49418,6 +50207,7 @@ var patterns_registry_default = {
     "game-audio-cue": {
       type: "game-audio-cue",
       category: "game",
+      sourceFile: "components/game/atoms/GameAudioCue.tsx",
       tier: "atoms",
       family: "game",
       description: "GameAudioCue component",
@@ -49528,6 +50318,7 @@ var patterns_registry_default = {
     "ui-slot-component": {
       type: "ui-slot-component",
       category: "layout",
+      sourceFile: "components/core/organisms/UISlotRenderer.tsx",
       tier: "organisms",
       family: "core",
       description: "UISlotComponent component",
@@ -49959,7 +50750,6 @@ var patterns_registry_default = {
             },
             required: [
               "name",
-              "parent",
               "pivot",
               "tip"
             ]
@@ -50947,6 +51737,524 @@ var patterns_registry_default = {
           description: "className prop"
         }
       }
+    },
+    "avl-state-machine": {
+      type: "avl-state-machine",
+      category: "display",
+      sourceFile: "components/avl/molecules/AvlStateMachine.tsx",
+      tier: "molecules",
+      family: "avl",
+      description: "AvlStateMachine component",
+      suggestedFor: [
+        "avl",
+        "state",
+        "machine",
+        "avl state machine"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        trait: {
+          types: [
+            "object"
+          ],
+          description: "The trait to draw (see `parseTraitLevel`).",
+          required: true,
+          properties: {
+            name: {
+              types: [
+                "string"
+              ]
+            },
+            linkedEntity: {
+              types: [
+                "string"
+              ]
+            },
+            states: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  name: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  isInitial: {
+                    types: [
+                      "boolean"
+                    ]
+                  },
+                  isTerminal: {
+                    types: [
+                      "boolean"
+                    ]
+                  }
+                },
+                required: [
+                  "name"
+                ]
+              }
+            },
+            transitions: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  from: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  to: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  event: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  guard: {
+                    types: [
+                      "sexpr"
+                    ]
+                  },
+                  effects: {
+                    types: [
+                      "array"
+                    ],
+                    items: {
+                      types: [
+                        "object"
+                      ],
+                      properties: {
+                        type: {
+                          types: [
+                            "string"
+                          ]
+                        },
+                        args: {
+                          types: [
+                            "array"
+                          ],
+                          items: {
+                            types: [
+                              "sexpr"
+                            ]
+                          }
+                        }
+                      },
+                      required: [
+                        "type",
+                        "args"
+                      ]
+                    }
+                  },
+                  index: {
+                    types: [
+                      "number"
+                    ]
+                  }
+                },
+                required: [
+                  "from",
+                  "to",
+                  "event",
+                  "effects",
+                  "index"
+                ]
+              }
+            },
+            emittedEvents: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            listenedEvents: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "string"
+                ]
+              }
+            }
+          },
+          propertyRequired: [
+            "name",
+            "linkedEntity",
+            "states",
+            "transitions",
+            "emittedEvents",
+            "listenedEvents"
+          ],
+          example: {
+            name: "OrderFlow",
+            linkedEntity: "Order",
+            states: [
+              {
+                name: "browsing",
+                isInitial: true,
+                isTerminal: false
+              },
+              {
+                name: "editing",
+                isInitial: false,
+                isTerminal: false
+              },
+              {
+                name: "saving",
+                isInitial: false,
+                isTerminal: false
+              },
+              {
+                name: "confirmed",
+                isInitial: false,
+                isTerminal: true
+              },
+              {
+                name: "failed",
+                isInitial: false,
+                isTerminal: false
+              }
+            ],
+            transitions: [
+              {
+                from: "browsing",
+                to: "editing",
+                event: "EDIT",
+                effects: [
+                  {
+                    type: "render-ui",
+                    args: []
+                  }
+                ],
+                index: 0
+              },
+              {
+                from: "editing",
+                to: "saving",
+                event: "SAVE",
+                effects: [
+                  {
+                    type: "persist",
+                    args: []
+                  },
+                  {
+                    type: "notify",
+                    args: []
+                  }
+                ],
+                index: 1
+              },
+              {
+                from: "saving",
+                to: "confirmed",
+                event: "SAVED",
+                effects: [
+                  {
+                    type: "emit",
+                    args: []
+                  },
+                  {
+                    type: "render-ui",
+                    args: []
+                  }
+                ],
+                index: 2
+              },
+              {
+                from: "saving",
+                to: "failed",
+                event: "SAVE_FAILED",
+                effects: [
+                  {
+                    type: "notify",
+                    args: []
+                  }
+                ],
+                index: 3
+              },
+              {
+                from: "failed",
+                to: "editing",
+                event: "RETRY",
+                effects: [],
+                index: 4
+              },
+              {
+                from: "editing",
+                to: "browsing",
+                event: "CANCEL",
+                effects: [
+                  {
+                    type: "render-ui",
+                    args: []
+                  }
+                ],
+                index: 5
+              },
+              {
+                from: "confirmed",
+                to: "browsing",
+                event: "DONE",
+                effects: [
+                  {
+                    type: "navigate",
+                    args: []
+                  }
+                ],
+                index: 6
+              }
+            ],
+            emittedEvents: [
+              "ORDER_SAVED"
+            ],
+            listenedEvents: [
+              "PAYMENT_OK"
+            ]
+          }
+        },
+        activeState: {
+          types: [
+            "string"
+          ],
+          description: "State execution is currently in."
+        },
+        activeTransition: {
+          types: [
+            "number"
+          ],
+          description: "`index` of the transition that just fired."
+        },
+        visitedStates: {
+          types: [
+            "array"
+          ],
+          description: "States already passed through, in order.",
+          items: {
+            types: [
+              "string"
+            ]
+          }
+        },
+        stateClickEvent: {
+          types: [
+            "string"
+          ],
+          description: "Emits UI:{stateClickEvent} with { stateId } when a state is clicked.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "stateId",
+              type: "string",
+              required: true
+            }
+          ]
+        },
+        transitionClickEvent: {
+          types: [
+            "string"
+          ],
+          description: "Emits UI:{transitionClickEvent} with { index, event, from, to } when a transition label is clicked.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "index",
+              type: "number",
+              required: true
+            },
+            {
+              name: "event",
+              type: "string",
+              required: true
+            },
+            {
+              name: "from",
+              type: "string",
+              required: true
+            },
+            {
+              name: "to",
+              type: "string",
+              required: true
+            }
+          ]
+        },
+        selectedState: {
+          types: [
+            "string"
+          ],
+          description: "State picked in an editor (first click)."
+        },
+        pendingSourceState: {
+          types: [
+            "string"
+          ],
+          description: "Source of a transition being drawn \u2014 the next state click picks its target."
+        },
+        nodeShape: {
+          types: [
+            "string"
+          ],
+          description: "Node silhouette. @default 'pill'",
+          enumValues: [
+            "pill",
+            "gear"
+          ],
+          default: "pill"
+        },
+        entityFields: {
+          types: [
+            "array"
+          ],
+          description: "Entity field names listed in the header.",
+          items: {
+            types: [
+              "string"
+            ]
+          }
+        },
+        direction: {
+          types: [
+            "string"
+          ],
+          description: "Flow direction. @default 'ltr'",
+          enumValues: [
+            "ltr",
+            "rtl"
+          ],
+          default: "ltr"
+        },
+        showHeader: {
+          types: [
+            "boolean"
+          ],
+          description: "Show the trait header (name, entity, listens/emits). @default true",
+          default: true
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "className prop"
+        }
+      }
+    },
+    "avl-glyph": {
+      type: "avl-glyph",
+      category: "component",
+      sourceFile: "components/avl/molecules/AvlGlyph.tsx",
+      tier: "molecules",
+      family: "avl",
+      description: "AvlGlyph component",
+      suggestedFor: [
+        "avl",
+        "glyph",
+        "avl glyph"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        kind: {
+          types: [
+            "string"
+          ],
+          description: "Which notation symbol to draw.",
+          required: true,
+          enumValues: [
+            "application",
+            "orbital",
+            "entity",
+            "trait",
+            "page",
+            "state",
+            "transition",
+            "event",
+            "guard",
+            "effect",
+            "field",
+            "fieldType",
+            "binding",
+            "bindingRef",
+            "persistence",
+            "operator",
+            "sexpr",
+            "literal"
+          ],
+          example: "state"
+        },
+        label: {
+          types: [
+            "string"
+          ],
+          description: "Caption, and the drawn text for operator / literal / bindingRef symbols."
+        },
+        effectType: {
+          types: [
+            "string"
+          ],
+          description: "Effect symbol variant. @default 'set'"
+        },
+        fieldType: {
+          types: [
+            "object"
+          ],
+          description: "Field-type symbol variant. @default 'string'"
+        },
+        persistence: {
+          types: [
+            "object"
+          ],
+          description: "Persistence symbol variant (also the entity's ring). @default 'persistent'"
+        },
+        namespace: {
+          types: [
+            "object"
+          ],
+          description: "Operator category tint. @default 'arithmetic'"
+        },
+        size: {
+          types: [
+            "string"
+          ],
+          description: "Symbol height. @default 'md'",
+          enumValues: [
+            "sm",
+            "md",
+            "lg"
+          ],
+          default: "md"
+        },
+        showCaption: {
+          types: [
+            "boolean"
+          ],
+          description: "Show the caption under the symbol. @default true",
+          default: true
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "className prop"
+        }
+      }
     }
   },
   categories: [
@@ -54986,7 +56294,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-27T02:12:25.691Z",
+  exportedAt: "2026-09-28T12:49:04.761Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -56279,6 +57587,16 @@ var component_mapping_default = {
       component: "CommitRow",
       importPath: "@/components/core/molecules/CommitRow",
       category: "component"
+    },
+    "avl-state-machine": {
+      component: "AvlStateMachine",
+      importPath: "@/components/avl/molecules/AvlStateMachine",
+      category: "display"
+    },
+    "avl-glyph": {
+      component: "AvlGlyph",
+      importPath: "@/components/avl/molecules/AvlGlyph",
+      category: "component"
     }
   }
 };
@@ -56286,7 +57604,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-27T02:12:25.691Z",
+  exportedAt: "2026-09-28T12:49:04.761Z",
   contracts: {
     form: {
       emits: [
@@ -57399,6 +58717,8 @@ var PATTERN_TYPES = [
   "atlas-panel",
   "auth-layout",
   "avatar",
+  "avl-glyph",
+  "avl-state-machine",
   "badge",
   "behavior-view",
   "biology-canvas",