@almadar/core 10.106.0 → 10.108.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-26T10:53:57.077Z",
+  exportedAt: "2026-09-27T13:02:32.256Z",
   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,31 @@ 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"
         }
       }
     },
     "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 +17316,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 +17484,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",
@@ -17777,6 +17867,7 @@ var patterns_registry_default = {
     "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 +17896,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 +17944,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 +17988,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 +18279,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 +18340,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 +18410,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 +18469,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 +20001,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 +20443,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 +20505,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 +20576,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 +20674,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 +20762,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Payload to include with the action event",
-          payloadFor: "action"
+          payloadFor: "action",
+          eventPayloadBrand: true
         },
         className: {
           types: [
@@ -20678,6 +20782,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 +20856,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Payload to include with the action event",
-          payloadFor: "action"
+          payloadFor: "action",
+          eventPayloadBrand: true
         },
         onChange: {
           types: [
@@ -20783,6 +20889,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 +21003,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Payload to include with the action event",
-          payloadFor: "action"
+          payloadFor: "action",
+          eventPayloadBrand: true
         },
         onFiles: {
           types: [
@@ -20994,6 +21102,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 +21145,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 +21170,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 +21205,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 +21445,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 +21469,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Payload to include with the refresh event",
-          payloadFor: "refreshEvent"
+          payloadFor: "refreshEvent",
+          eventPayloadBrand: true
         },
         threshold: {
           types: [
@@ -21633,6 +21747,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 +21967,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 +22108,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 +22225,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 +22564,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 +22638,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 +22755,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 +22837,11 @@ var patterns_registry_default = {
                   cyclicTypeName: "FileTreeNode"
                 }
               },
+              note: {
+                types: [
+                  "string"
+                ]
+              },
               size: {
                 types: [
                   "number"
@@ -22887,6 +23013,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 +23131,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 +23252,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 +23402,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 +23539,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 +23648,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",
@@ -24010,9 +24142,11 @@ var patterns_registry_default = {
     "version-diff": {
       type: "version-diff",
       category: "display",
+      sourceFile: "components/core/molecules/VersionDiff.tsx",
       tier: "molecules",
       family: "core",
-      description: "VersionDiff component",
+      description: "A line diff between two versions \u2014 two whole texts, or a pre-computed diff such as one commit.",
+      capabilities: "version diff, compare revisions, what changed, before and after, code diff, commit diff, revision comparison",
       suggestedFor: [
         "version",
         "diff",
@@ -24026,7 +24160,6 @@ var patterns_registry_default = {
             "object"
           ],
           description: "All available revisions (at least 2). Accepts either a typed array (direct consumers) or the runtime payload shape from a render-ui binding (`@payload.revisions`). Narrowed to `[]` internally when the value isn't an array.",
-          required: true,
           items: {
             types: [
               "object"
@@ -24065,6 +24198,70 @@ var patterns_registry_default = {
             ]
           }
         },
+        hunks: {
+          types: [
+            "array"
+          ],
+          description: "A pre-computed diff to render instead of diffing `revisions` (no revision pickers).",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              header: {
+                types: [
+                  "string"
+                ]
+              },
+              lines: {
+                types: [
+                  "array"
+                ],
+                items: {
+                  types: [
+                    "object"
+                  ],
+                  properties: {
+                    type: {
+                      types: [
+                        "string"
+                      ],
+                      enumValues: [
+                        "added",
+                        "removed",
+                        "unchanged",
+                        "context"
+                      ]
+                    },
+                    beforeLineNumber: {
+                      types: [
+                        "number"
+                      ]
+                    },
+                    afterLineNumber: {
+                      types: [
+                        "number"
+                      ]
+                    },
+                    content: {
+                      types: [
+                        "string"
+                      ]
+                    }
+                  },
+                  required: [
+                    "type",
+                    "content"
+                  ]
+                }
+              }
+            },
+            required: [
+              "header",
+              "lines"
+            ]
+          }
+        },
         beforeId: {
           types: [
             "string"
@@ -24081,7 +24278,7 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Display mode.",
+          description: "Display mode to start in; the toggle switches it.",
           enumValues: [
             "side-by-side",
             "inline"
@@ -24186,6 +24383,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.',
@@ -24369,6 +24567,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",
@@ -25720,6 +25919,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",
@@ -25816,6 +26016,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",
@@ -25919,6 +26120,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",
@@ -26005,6 +26207,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",
@@ -26115,6 +26318,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",
@@ -26213,6 +26417,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",
@@ -26304,6 +26509,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",
@@ -26393,6 +26599,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",
@@ -26488,6 +26695,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",
@@ -26579,6 +26787,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",
@@ -26681,6 +26890,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",
@@ -26770,6 +26980,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",
@@ -26871,6 +27082,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",
@@ -26919,6 +27131,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",
@@ -27101,6 +27314,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",
@@ -27161,6 +27375,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",
@@ -27188,6 +27403,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",
@@ -27557,6 +27773,7 @@ var patterns_registry_default = {
     "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.",
@@ -31750,6 +31967,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).",
@@ -31939,6 +32157,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",
@@ -32030,6 +32249,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",
@@ -32136,6 +32356,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).",
@@ -32204,6 +32425,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.",
@@ -32279,6 +32501,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",
@@ -32429,6 +32652,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.",
@@ -32455,6 +32679,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.',
@@ -32480,6 +32705,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",
@@ -33195,6 +33421,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",
@@ -33505,6 +33732,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",
@@ -33546,6 +33774,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",
@@ -33616,6 +33845,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",
@@ -33644,6 +33874,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",
@@ -35460,6 +35691,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",
@@ -35616,7 +35848,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Payload to include with the action event",
-          payloadFor: "action"
+          payloadFor: "action",
+          eventPayloadBrand: true
         },
         responsive: {
           types: [
@@ -35630,6 +35863,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",
@@ -35786,7 +36020,8 @@ var patterns_registry_default = {
             "object"
           ],
           description: "Payload to include with the action event",
-          payloadFor: "action"
+          payloadFor: "action",
+          eventPayloadBrand: true
         },
         responsive: {
           types: [
@@ -35800,6 +36035,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",
@@ -35935,6 +36171,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",
@@ -36539,6 +36776,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",
@@ -37835,6 +38073,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",
@@ -40212,6 +40451,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",
@@ -41729,6 +41969,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.`,
@@ -41853,6 +42094,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.",
@@ -41948,6 +42190,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",
@@ -42739,6 +42982,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",
@@ -42853,6 +43097,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",
@@ -42955,6 +43200,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",
@@ -43922,6 +44168,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",
@@ -44059,6 +44306,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",
@@ -45049,6 +45297,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",
@@ -45984,6 +46233,7 @@ var patterns_registry_default = {
     presence: {
       type: "presence",
       category: "component",
+      sourceFile: "components/core/atoms/Presence.tsx",
       tier: "atoms",
       family: "core",
       description: "Presence component",
@@ -46017,6 +46267,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",
@@ -46213,6 +46464,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",
@@ -46283,6 +46535,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",
@@ -46417,6 +46670,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",
@@ -46636,6 +46890,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",
@@ -46697,6 +46952,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",
@@ -47174,6 +47430,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",
@@ -47739,6 +47996,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",
@@ -48316,6 +48574,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",
@@ -49353,6 +49612,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",
@@ -49463,6 +49723,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",
@@ -50669,6 +50930,219 @@ var patterns_registry_default = {
           description: "className prop"
         }
       }
+    },
+    "change-list": {
+      type: "change-list",
+      category: "display",
+      sourceFile: "components/core/molecules/ChangeList.tsx",
+      tier: "molecules",
+      family: "core",
+      description: "The plain-language changes in one version (added / modified / removed).",
+      capabilities: "change summary, what changed, version changes, diff summary, release notes list, modification list",
+      suggestedFor: [
+        "change",
+        "list",
+        "change list"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        changes: {
+          types: [
+            "array",
+            "object"
+          ],
+          description: "The changes. Accepts a typed list or a render-ui payload binding.",
+          required: true,
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              type: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "added",
+                  "modified",
+                  "removed"
+                ]
+              },
+              title: {
+                types: [
+                  "string"
+                ]
+              },
+              description: {
+                types: [
+                  "string"
+                ]
+              },
+              before: {
+                types: [
+                  "string"
+                ]
+              },
+              after: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            required: [
+              "type",
+              "title"
+            ]
+          }
+        },
+        inspectEvent: {
+          types: [
+            "string"
+          ],
+          description: "Emitted by a change's Inspect button. Payload: { title, type }.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "title",
+              type: "string",
+              required: true
+            },
+            {
+              name: "type",
+              type: "string",
+              required: true,
+              enumValues: [
+                "added",
+                "modified",
+                "removed"
+              ]
+            }
+          ]
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "className prop"
+        }
+      }
+    },
+    "commit-row": {
+      type: "commit-row",
+      category: "component",
+      sourceFile: "components/core/molecules/CommitRow.tsx",
+      tier: "molecules",
+      family: "core",
+      description: "One version in a history list \u2014 a commit row with select and restore.",
+      capabilities: "version history row, commit entry, revision list item, change log entry, restore point, undo history item",
+      suggestedFor: [
+        "commit",
+        "row",
+        "commit row"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        sha: {
+          types: [
+            "string"
+          ],
+          description: "Commit id; the first 7 characters are shown, the whole id on hover.",
+          required: true
+        },
+        message: {
+          types: [
+            "string"
+          ],
+          description: "Commit message.",
+          required: true
+        },
+        author: {
+          types: [
+            "string"
+          ],
+          description: "author prop"
+        },
+        timestamp: {
+          types: [
+            "string"
+          ],
+          description: 'Display time (already formatted, e.g. "2 min ago").'
+        },
+        kind: {
+          types: [
+            "string"
+          ],
+          description: "What made this version (a user save, an agent turn, a restore, an undo/redo, a snapshot).",
+          enumValues: [
+            "user",
+            "agent",
+            "restore",
+            "undo",
+            "redo",
+            "snapshot"
+          ]
+        },
+        additions: {
+          types: [
+            "number"
+          ],
+          description: "additions prop"
+        },
+        deletions: {
+          types: [
+            "number"
+          ],
+          description: "deletions prop"
+        },
+        selected: {
+          types: [
+            "boolean"
+          ],
+          description: "The row the user picked (shows its detail).",
+          default: false
+        },
+        current: {
+          types: [
+            "boolean"
+          ],
+          description: "The version the app is at now \u2014 it cannot be restored to.",
+          default: false
+        },
+        selectEvent: {
+          types: [
+            "string"
+          ],
+          description: "Emitted when the row is picked. Payload: { sha }.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "sha",
+              type: "string",
+              required: true
+            }
+          ]
+        },
+        restoreEvent: {
+          types: [
+            "string"
+          ],
+          description: "Emitted by the Restore button. Payload: { sha }.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "sha",
+              type: "string",
+              required: true
+            }
+          ]
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "className prop"
+        }
+      }
     }
   },
   categories: [
@@ -50694,7 +51168,7 @@ var patterns_registry_default = {
 // src/patterns/integrators-registry.json
 var integrators_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-12T17:27:32.966Z",
+  exportedAt: "2026-09-27T02:05:16.940Z",
   integrators: {
     github: {
       name: "github",
@@ -53560,13 +54034,13 @@ var integrators_registry_default = {
       actions: [
         {
           name: "authorize",
-          description: "Build the provider authorization URL (PKCE + state) for an OAuth/OIDC login redirect; real OIDC discovery when OAUTH_CLIENT_ID/SECRET are configured, an in-memory mock otherwise.",
+          description: "Build the provider authorization URL (PKCE + state) for an OAuth/OIDC login redirect; OIDC discovery (Google) or static OAuth 2 metadata (GitHub) when OAUTH_CLIENT_ID/SECRET are configured, an in-memory mock otherwise.",
           params: [
             {
               name: "provider",
               type: "'google' | 'github' | 'auth0'",
               required: true,
-              description: "Identity provider; OIDC issuer defaults to Google unless OIDC_ISSUER_URL overrides it."
+              description: "Identity provider; OIDC issuer defaults to Google unless OIDC_ISSUER_URL overrides it; GitHub uses its OAuth 2 endpoints."
             },
             {
               name: "scopes",
@@ -53579,6 +54053,12 @@ var integrators_registry_default = {
               type: "string",
               required: true,
               description: "Callback URL the provider redirects back to after consent."
+            },
+            {
+              name: "subject",
+              type: "string",
+              required: false,
+              description: "Opaque id of whoever started the flow (the verified user); `token` returns it so the host can refuse anyone else completing."
             }
           ],
           responseShape: {
@@ -53601,13 +54081,21 @@ var integrators_registry_default = {
               type: "string",
               required: true,
               description: "The `state` value returned by `authorize`."
+            },
+            {
+              name: "subject",
+              type: "string",
+              required: false,
+              description: "Who is completing; must equal the `subject` bound at `authorize`, checked before the code is exchanged."
             }
           ],
           responseShape: {
             accessToken: "string",
             refreshToken: "string",
             expiresIn: "number",
-            tokenType: "'bearer'"
+            tokenType: "'bearer'",
+            scope: "string[]",
+            subject: "string"
           }
         },
         {
@@ -54694,7 +55182,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-26T10:53:57.077Z",
+  exportedAt: "2026-09-27T13:02:32.256Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -55977,6 +56465,16 @@ var component_mapping_default = {
       component: "TopNavItem",
       importPath: "@/components/core/molecules/TopNavItem",
       category: "navigation"
+    },
+    "change-list": {
+      component: "ChangeList",
+      importPath: "@/components/core/molecules/ChangeList",
+      category: "display"
+    },
+    "commit-row": {
+      component: "CommitRow",
+      importPath: "@/components/core/molecules/CommitRow",
+      category: "component"
     }
   }
 };
@@ -55984,7 +56482,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-26T10:53:57.077Z",
+  exportedAt: "2026-09-27T13:02:32.256Z",
   contracts: {
     form: {
       emits: [
@@ -57111,6 +57609,7 @@ var PATTERN_TYPES = [
   "card",
   "carousel",
   "center",
+  "change-list",
   "chart",
   "chart-legend",
   "chat-bar",
@@ -57120,6 +57619,7 @@ var PATTERN_TYPES = [
   "code-block",
   "code-runner-panel",
   "command-palette",
+  "commit-row",
   "conditional-wrapper",
   "confetti-effect",
   "confirm-dialog",