@almadar/core 10.107.0 → 10.108.0

package/dist/patterns/index.d.ts

@@ -1,11 +1,11 @@
-import { A as AnyPatternConfig, l as RenderBinding, F as FieldValue, bs as PatternType, c as Effect } from '../effect-CXEHwilA.js';
-export { bl as PATTERN_TYPES, h as PatternConfig, bq as PatternProps, br as PatternPropsMap, dv as isValidPatternType } from '../effect-CXEHwilA.js';
+import { A as AnyPatternConfig, l as RenderBinding, F as FieldValue, bs as PatternType, c as Effect } from '../effect-CG7murna.js';
+export { bl as PATTERN_TYPES, h as PatternConfig, bq as PatternProps, br as PatternPropsMap, dv as isValidPatternType } from '../effect-CG7murna.js';
 import { a as EventPayloadValue, b as EventPayload, n as SExprObject, S as SExpr } from '../expression-CfeHdS-f.js';
 import { J as JsonValue } from '../json-D8gmyK3l.js';
 import 'zod';
 
 var version$3 = "1.0.0";
-var exportedAt$3 = "2026-09-27T02:12:25.691Z";
+var exportedAt$3 = "2026-09-27T13:02:32.256Z";
 var patterns = {
 	"entity-table": {
 		type: "entity-table",
@@ -3917,6 +3917,7 @@ var patterns = {
 	"search-input": {
 		type: "search-input",
 		category: "filter",
+		sourceFile: "components/core/molecules/SearchInput.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "Search input with events",
@@ -4014,6 +4015,7 @@ var patterns = {
 	"filter-group": {
 		type: "filter-group",
 		category: "filter",
+		sourceFile: "components/core/molecules/FilterGroup.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "FilterGroup — a panel of filter controls that narrows a collection by field values.",
@@ -4718,7 +4720,16 @@ var patterns = {
 					required: [
 						"label"
 					]
-				}
+				},
+				example: [
+					{
+						label: "Home",
+						href: "/"
+					},
+					{
+						label: "Page"
+					}
+				]
 			},
 			fromNavStack: {
 				types: [
@@ -4776,6 +4787,7 @@ var patterns = {
 	"wizard-progress": {
 		type: "wizard-progress",
 		category: "navigation",
+		sourceFile: "components/core/molecules/WizardProgress.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "Wizard step progress indicator",
@@ -4877,6 +4889,7 @@ var patterns = {
 	"wizard-navigation": {
 		type: "wizard-navigation",
 		category: "navigation",
+		sourceFile: "components/core/molecules/WizardNavigation.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "Wizard navigation buttons",
@@ -5856,6 +5869,7 @@ var patterns = {
 	pagination: {
 		type: "pagination",
 		category: "navigation",
+		sourceFile: "components/core/molecules/Pagination.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "Page navigation controls",
@@ -6001,6 +6015,7 @@ var patterns = {
 	"empty-state": {
 		type: "empty-state",
 		category: "state",
+		sourceFile: "components/core/molecules/EmptyState.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "Message when no data exists",
@@ -6102,6 +6117,7 @@ var patterns = {
 	"loading-state": {
 		type: "loading-state",
 		category: "state",
+		sourceFile: "components/core/molecules/LoadingState.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "Loading indicator",
@@ -6140,6 +6156,7 @@ var patterns = {
 	"error-state": {
 		type: "error-state",
 		category: "state",
+		sourceFile: "components/core/molecules/ErrorState.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "Error message display",
@@ -6196,6 +6213,7 @@ var patterns = {
 	notification: {
 		type: "notification",
 		category: "state",
+		sourceFile: "components/core/molecules/Toast.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "Toast notification message",
@@ -6306,6 +6324,7 @@ var patterns = {
 	modal: {
 		type: "modal",
 		category: "container",
+		sourceFile: "components/core/molecules/Modal.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "Modal dialog overlay",
@@ -6435,6 +6454,7 @@ var patterns = {
 	drawer: {
 		type: "drawer",
 		category: "container",
+		sourceFile: "components/core/molecules/Drawer.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "Side drawer panel",
@@ -6537,6 +6557,7 @@ var patterns = {
 	"confirm-dialog": {
 		type: "confirm-dialog",
 		category: "container",
+		sourceFile: "components/core/molecules/ConfirmDialog.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "Confirmation dialog",
@@ -6692,6 +6713,7 @@ var patterns = {
 	"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",
@@ -6894,7 +6916,8 @@ var patterns = {
 					"lg",
 					"xl",
 					"2xl"
-				]
+				],
+				example: "md"
 			},
 			paddingX: {
 				types: [
@@ -6995,7 +7018,8 @@ var patterns = {
 					"boolean"
 				],
 				description: "Show border",
-				"default": false
+				"default": false,
+				example: true
 			},
 			rounded: {
 				types: [
@@ -7138,6 +7162,7 @@ var patterns = {
 	grid: {
 		type: "grid",
 		category: "layout",
+		sourceFile: "components/core/molecules/Grid.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "CSS Grid layout for multi-column content",
@@ -7332,6 +7357,7 @@ var patterns = {
 	center: {
 		type: "center",
 		category: "layout",
+		sourceFile: "components/core/atoms/Center.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "Centers content horizontally and vertically",
@@ -7420,6 +7446,7 @@ var patterns = {
 	spacer: {
 		type: "spacer",
 		category: "layout",
+		sourceFile: "components/core/atoms/Spacer.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "Flexible space that expands to fill available room",
@@ -7468,6 +7495,7 @@ var patterns = {
 	divider: {
 		type: "divider",
 		category: "layout",
+		sourceFile: "components/core/atoms/Divider.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "Visual separator between content sections",
@@ -7518,6 +7546,7 @@ var patterns = {
 	"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",
@@ -7782,7 +7811,8 @@ var patterns = {
 				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: [
@@ -7993,6 +8023,7 @@ var patterns = {
 	avatar: {
 		type: "avatar",
 		category: "component",
+		sourceFile: "components/core/atoms/Avatar.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "User avatar image or initials",
@@ -8094,13 +8125,15 @@ var patterns = {
 					"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",
@@ -8184,6 +8217,7 @@ var patterns = {
 	card: {
 		type: "card",
 		category: "component",
+		sourceFile: "components/core/atoms/Card.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "Card container with optional header and footer",
@@ -8290,6 +8324,7 @@ var patterns = {
 	"progress-bar": {
 		type: "progress-bar",
 		category: "component",
+		sourceFile: "components/core/atoms/ProgressBar.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "Progress indicator bar",
@@ -8405,6 +8440,7 @@ var patterns = {
 	spinner: {
 		type: "spinner",
 		category: "component",
+		sourceFile: "components/core/atoms/Spinner.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "Loading spinner animation",
@@ -8913,6 +8949,7 @@ var patterns = {
 	checkbox: {
 		type: "checkbox",
 		category: "component",
+		sourceFile: "components/core/atoms/Checkbox.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "Checkbox input",
@@ -8967,6 +9004,7 @@ var patterns = {
 	radio: {
 		type: "radio",
 		category: "component",
+		sourceFile: "components/core/atoms/Radio.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "Radio button input",
@@ -9048,6 +9086,7 @@ var patterns = {
 	"switch": {
 		type: "switch",
 		category: "component",
+		sourceFile: "components/core/atoms/Switch.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "Toggle switch input",
@@ -9120,6 +9159,7 @@ var patterns = {
 	label: {
 		type: "label",
 		category: "component",
+		sourceFile: "components/core/atoms/Label.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "Form field label",
@@ -9158,6 +9198,7 @@ var patterns = {
 	alert: {
 		type: "alert",
 		category: "component",
+		sourceFile: "components/core/molecules/Alert.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "Alert message box",
@@ -9249,6 +9290,7 @@ var patterns = {
 	tooltip: {
 		type: "tooltip",
 		category: "component",
+		sourceFile: "components/core/molecules/Tooltip.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "Hover tooltip",
@@ -9318,6 +9360,7 @@ var patterns = {
 	popover: {
 		type: "popover",
 		category: "component",
+		sourceFile: "components/core/molecules/Popover.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "Click-triggered popover",
@@ -9554,6 +9597,7 @@ var patterns = {
 	accordion: {
 		type: "accordion",
 		category: "component",
+		sourceFile: "components/core/molecules/Accordion.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "Collapsible accordion sections",
@@ -9698,6 +9742,7 @@ var patterns = {
 	container: {
 		type: "container",
 		category: "component",
+		sourceFile: "components/core/molecules/Container.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "Centered max-width container",
@@ -9781,6 +9826,7 @@ var patterns = {
 	"simple-grid": {
 		type: "simple-grid",
 		category: "component",
+		sourceFile: "components/core/molecules/SimpleGrid.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "Simple responsive grid with auto columns",
@@ -10174,6 +10220,7 @@ var patterns = {
 	"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.",
@@ -10254,6 +10301,7 @@ var patterns = {
 	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.",
@@ -10308,6 +10356,7 @@ var patterns = {
 	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.",
@@ -10474,7 +10523,8 @@ var patterns = {
 					"object"
 				],
 				description: "Payload to include with the action event",
-				payloadFor: "action"
+				payloadFor: "action",
+				eventPayloadBrand: true
 			},
 			responsive: {
 				types: [
@@ -10488,6 +10538,7 @@ var patterns = {
 	"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",
@@ -10600,6 +10651,7 @@ var patterns = {
 	"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.",
@@ -10640,6 +10692,7 @@ var patterns = {
 	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.",
@@ -11060,6 +11113,7 @@ var patterns = {
 	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.",
@@ -11329,6 +11383,7 @@ var patterns = {
 	"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.",
@@ -11382,6 +11437,7 @@ var patterns = {
 	"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.",
@@ -11664,6 +11720,7 @@ var patterns = {
 	"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",
@@ -11802,6 +11859,7 @@ var patterns = {
 	"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.",
@@ -11888,6 +11946,7 @@ var patterns = {
 	"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)",
@@ -12027,6 +12086,7 @@ var patterns = {
 	"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",
@@ -12404,6 +12464,7 @@ var patterns = {
 	"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",
@@ -12784,6 +12845,7 @@ var patterns = {
 	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.",
@@ -13289,6 +13351,7 @@ var patterns = {
 	"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",
@@ -13438,6 +13501,7 @@ var patterns = {
 	"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.",
@@ -13912,6 +13976,7 @@ var patterns = {
 	"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.",
@@ -15322,6 +15387,7 @@ var patterns = {
 	"signature-pad": {
 		type: "signature-pad",
 		category: "form",
+		sourceFile: "components/core/molecules/SignaturePad.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "SignaturePad — a draw-to-sign canvas that captures a handwritten signature or initials.",
@@ -16427,6 +16493,7 @@ var patterns = {
 	"error-boundary": {
 		type: "error-boundary",
 		category: "state",
+		sourceFile: "components/core/molecules/ErrorBoundary.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "ErrorBoundary component",
@@ -16480,6 +16547,7 @@ var patterns = {
 	skeleton: {
 		type: "skeleton",
 		category: "component",
+		sourceFile: "components/core/molecules/Skeleton.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "Skeleton component",
@@ -16534,6 +16602,7 @@ var patterns = {
 	"quiz-block": {
 		type: "quiz-block",
 		category: "component",
+		sourceFile: "components/core/molecules/QuizBlock.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "QuizBlock — a single quiz question with answer choices and submit/reveal feedback.",
@@ -17243,12 +17312,31 @@ var patterns = {
 					"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 — 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 — this is the same library-boundary exception as `<iframe>` in DocumentViewer and `<svg>` in JazariStateMachine/StateMachineView.",
@@ -17288,6 +17376,7 @@ var patterns = {
 	"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",
@@ -17455,6 +17544,7 @@ var patterns = {
 	"jazari-state-machine": {
 		type: "jazari-state-machine",
 		category: "display",
+		sourceFile: "components/core/molecules/JazariStateMachine.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "JazariStateMachine component",
@@ -17837,6 +17927,7 @@ var patterns = {
 	"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",
@@ -17865,6 +17956,7 @@ var patterns = {
 	"day-cell": {
 		type: "day-cell",
 		category: "component",
+		sourceFile: "components/core/atoms/DayCell.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "DayCell component",
@@ -17912,6 +18004,7 @@ var patterns = {
 	"flip-container": {
 		type: "flip-container",
 		category: "layout",
+		sourceFile: "components/core/atoms/FlipContainer.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "FlipContainer component",
@@ -17956,6 +18049,7 @@ var patterns = {
 	"time-slot-cell": {
 		type: "time-slot-cell",
 		category: "layout",
+		sourceFile: "components/core/atoms/TimeSlotCell.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "TimeSlotCell component",
@@ -18249,6 +18343,7 @@ var patterns = {
 	"chart-legend": {
 		type: "chart-legend",
 		category: "display",
+		sourceFile: "components/core/molecules/ChartLegend.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "ChartLegend component",
@@ -18309,6 +18404,7 @@ var patterns = {
 	"date-range-selector": {
 		type: "date-range-selector",
 		category: "form",
+		sourceFile: "components/core/molecules/DateRangeSelector.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "DateRangeSelector component",
@@ -18378,6 +18474,7 @@ var patterns = {
 	"flip-card": {
 		type: "flip-card",
 		category: "display",
+		sourceFile: "components/core/molecules/FlipCard.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "FlipCard — flip card that reveals a hidden back face on tap or click, toggling between a front and back content slot.",
@@ -18437,6 +18534,7 @@ var patterns = {
 	"graph-view": {
 		type: "graph-view",
 		category: "component",
+		sourceFile: "components/core/molecules/GraphView.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "GraphView component",
@@ -19968,6 +20066,7 @@ var patterns = {
 	"map-view": {
 		type: "map-view",
 		category: "component",
+		sourceFile: "components/core/molecules/MapView.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "MapView component",
@@ -20411,6 +20510,7 @@ var patterns = {
 	"status-dot": {
 		type: "status-dot",
 		category: "display",
+		sourceFile: "components/core/atoms/StatusDot.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "StatusDot component",
@@ -20472,6 +20572,7 @@ var patterns = {
 	"trend-indicator": {
 		type: "trend-indicator",
 		category: "component",
+		sourceFile: "components/core/atoms/TrendIndicator.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "TrendIndicator component",
@@ -20542,6 +20643,7 @@ var patterns = {
 	lightbox: {
 		type: "lightbox",
 		category: "component",
+		sourceFile: "components/core/molecules/Lightbox.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "Lightbox component",
@@ -20641,6 +20743,7 @@ var patterns = {
 	"number-stepper": {
 		type: "number-stepper",
 		category: "component",
+		sourceFile: "components/core/molecules/NumberStepper.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "NumberStepper component",
@@ -20728,7 +20831,8 @@ var patterns = {
 					"object"
 				],
 				description: "Payload to include with the action event",
-				payloadFor: "action"
+				payloadFor: "action",
+				eventPayloadBrand: true
 			},
 			className: {
 				types: [
@@ -20747,6 +20851,7 @@ var patterns = {
 	"star-rating": {
 		type: "star-rating",
 		category: "component",
+		sourceFile: "components/core/molecules/StarRating.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "StarRating component",
@@ -20820,7 +20925,8 @@ var patterns = {
 					"object"
 				],
 				description: "Payload to include with the action event",
-				payloadFor: "action"
+				payloadFor: "action",
+				eventPayloadBrand: true
 			},
 			onChange: {
 				types: [
@@ -20852,6 +20958,7 @@ var patterns = {
 	"upload-drop-zone": {
 		type: "upload-drop-zone",
 		category: "component",
+		sourceFile: "components/core/molecules/UploadDropZone.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "UploadDropZone component",
@@ -20965,7 +21072,8 @@ var patterns = {
 					"object"
 				],
 				description: "Payload to include with the action event",
-				payloadFor: "action"
+				payloadFor: "action",
+				eventPayloadBrand: true
 			},
 			onFiles: {
 				types: [
@@ -21063,6 +21171,7 @@ var patterns = {
 	"confetti-effect": {
 		type: "confetti-effect",
 		category: "component",
+		sourceFile: "components/core/atoms/ConfettiEffect.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "ConfettiEffect component",
@@ -21105,6 +21214,7 @@ var patterns = {
 	"infinite-scroll-sentinel": {
 		type: "infinite-scroll-sentinel",
 		category: "component",
+		sourceFile: "components/core/atoms/InfiniteScrollSentinel.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "InfiniteScrollSentinel component",
@@ -21129,7 +21239,8 @@ var patterns = {
 					"object"
 				],
 				description: "Optional payload to include with the load-more event",
-				payloadFor: "loadMoreEvent"
+				payloadFor: "loadMoreEvent",
+				eventPayloadBrand: true
 			},
 			isLoading: {
 				types: [
@@ -21163,6 +21274,7 @@ var patterns = {
 	"typewriter-text": {
 		type: "typewriter-text",
 		category: "component",
+		sourceFile: "components/core/atoms/TypewriterText.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "TypewriterText component",
@@ -21403,6 +21515,7 @@ var patterns = {
 	"pull-to-refresh": {
 		type: "pull-to-refresh",
 		category: "component",
+		sourceFile: "components/core/molecules/PullToRefresh.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "PullToRefresh component",
@@ -21426,7 +21539,8 @@ var patterns = {
 					"object"
 				],
 				description: "Payload to include with the refresh event",
-				payloadFor: "refreshEvent"
+				payloadFor: "refreshEvent",
+				eventPayloadBrand: true
 			},
 			threshold: {
 				types: [
@@ -21705,6 +21819,7 @@ var patterns = {
 	"stat-display": {
 		type: "stat-display",
 		category: "display",
+		sourceFile: "components/core/molecules/StatDisplay.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "StatDisplay component",
@@ -21924,6 +22039,7 @@ var patterns = {
 	"section-header": {
 		type: "section-header",
 		category: "header",
+		sourceFile: "components/core/atoms/SectionHeader.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "SectionHeader component",
@@ -22064,6 +22180,7 @@ var patterns = {
 	"feature-grid": {
 		type: "feature-grid",
 		category: "display",
+		sourceFile: "components/core/molecules/FeatureGrid.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "FeatureGrid component",
@@ -22180,6 +22297,7 @@ var patterns = {
 	"social-proof": {
 		type: "social-proof",
 		category: "component",
+		sourceFile: "components/core/molecules/SocialProof.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "SocialProof component",
@@ -22518,6 +22636,7 @@ var patterns = {
 	"edge-decoration": {
 		type: "edge-decoration",
 		category: "component",
+		sourceFile: "components/core/molecules/EdgeDecoration.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "EdgeDecoration component",
@@ -22591,6 +22710,7 @@ var patterns = {
 	"ui-slot-renderer": {
 		type: "ui-slot-renderer",
 		category: "layout",
+		sourceFile: "components/core/organisms/UISlotRenderer.tsx",
 		tier: "organisms",
 		family: "core",
 		description: "UISlotRenderer component",
@@ -22707,6 +22827,7 @@ var patterns = {
 	"trait-frame": {
 		type: "trait-frame",
 		category: "component",
+		sourceFile: "components/core/atoms/TraitFrame.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "TraitFrame — 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** — 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** — 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.",
@@ -22788,6 +22909,11 @@ var patterns = {
 								cyclicTypeName: "FileTreeNode"
 							}
 						},
+						note: {
+							types: [
+								"string"
+							]
+						},
 						size: {
 							types: [
 								"number"
@@ -22959,6 +23085,7 @@ var patterns = {
 	"filter-pill": {
 		type: "filter-pill",
 		category: "filter",
+		sourceFile: "components/core/atoms/FilterPill.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "FilterPill component",
@@ -23078,6 +23205,7 @@ var patterns = {
 	"likert-scale": {
 		type: "likert-scale",
 		category: "component",
+		sourceFile: "components/core/molecules/LikertScale.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "LikertScale component",
@@ -23198,6 +23326,7 @@ var patterns = {
 	"matrix-question": {
 		type: "matrix-question",
 		category: "component",
+		sourceFile: "components/core/molecules/MatrixQuestion.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "MatrixQuestion component",
@@ -23347,6 +23476,7 @@ var patterns = {
 	"qr-scanner": {
 		type: "qr-scanner",
 		category: "component",
+		sourceFile: "components/core/molecules/QrScanner.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "QrScanner component",
@@ -23483,6 +23613,7 @@ var patterns = {
 	"vote-stack": {
 		type: "vote-stack",
 		category: "component",
+		sourceFile: "components/core/molecules/VoteStack.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "VoteStack component",
@@ -23591,6 +23722,7 @@ var patterns = {
 	"branching-logic-builder": {
 		type: "branching-logic-builder",
 		category: "display",
+		sourceFile: "components/core/molecules/BranchingLogicBuilder.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "BranchingLogicBuilder component",
@@ -24325,6 +24457,7 @@ var patterns = {
 	"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.",
@@ -24509,6 +24642,7 @@ var patterns = {
 	"positioned-canvas": {
 		type: "positioned-canvas",
 		category: "game",
+		sourceFile: "components/core/molecules/PositionedCanvas.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "PositionedCanvas component",
@@ -25863,6 +25997,7 @@ var patterns = {
 	"svg-branch": {
 		type: "svg-branch",
 		category: "component",
+		sourceFile: "components/core/atoms/svg/SvgBranch.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "SvgBranch component",
@@ -25959,6 +26094,7 @@ var patterns = {
 	"svg-connection": {
 		type: "svg-connection",
 		category: "component",
+		sourceFile: "components/core/atoms/svg/SvgConnection.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "SvgConnection component",
@@ -26062,6 +26198,7 @@ var patterns = {
 	"svg-flow": {
 		type: "svg-flow",
 		category: "component",
+		sourceFile: "components/core/atoms/svg/SvgFlow.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "SvgFlow component",
@@ -26148,6 +26285,7 @@ var patterns = {
 	"svg-grid": {
 		type: "svg-grid",
 		category: "display",
+		sourceFile: "components/core/atoms/svg/SvgGrid.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "SvgGrid component",
@@ -26259,6 +26397,7 @@ var patterns = {
 	"svg-lobe": {
 		type: "svg-lobe",
 		category: "component",
+		sourceFile: "components/core/atoms/svg/SvgLobe.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "SvgLobe component",
@@ -26357,6 +26496,7 @@ var patterns = {
 	"svg-mesh": {
 		type: "svg-mesh",
 		category: "component",
+		sourceFile: "components/core/atoms/svg/SvgMesh.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "SvgMesh component",
@@ -26448,6 +26588,7 @@ var patterns = {
 	"svg-morph": {
 		type: "svg-morph",
 		category: "component",
+		sourceFile: "components/core/atoms/svg/SvgMorph.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "SvgMorph component",
@@ -26537,6 +26678,7 @@ var patterns = {
 	"svg-node": {
 		type: "svg-node",
 		category: "component",
+		sourceFile: "components/core/atoms/svg/SvgNode.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "SvgNode component",
@@ -26632,6 +26774,7 @@ var patterns = {
 	"svg-pulse": {
 		type: "svg-pulse",
 		category: "component",
+		sourceFile: "components/core/atoms/svg/SvgPulse.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "SvgPulse component",
@@ -26723,6 +26866,7 @@ var patterns = {
 	"svg-ring": {
 		type: "svg-ring",
 		category: "component",
+		sourceFile: "components/core/atoms/svg/SvgRing.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "SvgRing component",
@@ -26825,6 +26969,7 @@ var patterns = {
 	"svg-shield": {
 		type: "svg-shield",
 		category: "component",
+		sourceFile: "components/core/atoms/svg/SvgShield.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "SvgShield component",
@@ -26914,6 +27059,7 @@ var patterns = {
 	"svg-stack": {
 		type: "svg-stack",
 		category: "component",
+		sourceFile: "components/core/atoms/svg/SvgStack.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "SvgStack component",
@@ -27015,6 +27161,7 @@ var patterns = {
 	"doc-breadcrumb": {
 		type: "doc-breadcrumb",
 		category: "navigation",
+		sourceFile: "components/core/molecules/DocBreadcrumb.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "DocBreadcrumb component",
@@ -27063,6 +27210,7 @@ var patterns = {
 	"doc-pagination": {
 		type: "doc-pagination",
 		category: "navigation",
+		sourceFile: "components/core/molecules/DocPagination.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "DocPagination component",
@@ -27245,6 +27393,7 @@ var patterns = {
 	"doc-toc": {
 		type: "doc-toc",
 		category: "component",
+		sourceFile: "components/core/molecules/DocTOC.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "DocTOC component",
@@ -27305,6 +27454,7 @@ var patterns = {
 	"gradient-divider": {
 		type: "gradient-divider",
 		category: "component",
+		sourceFile: "components/core/molecules/GradientDivider.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "GradientDivider component",
@@ -27332,6 +27482,7 @@ var patterns = {
 	"behavior-view": {
 		type: "behavior-view",
 		category: "component",
+		sourceFile: "components/avl/molecules/BehaviorView.tsx",
 		tier: "molecules",
 		family: "avl",
 		description: "BehaviorView component",
@@ -27701,6 +27852,7 @@ var patterns = {
 	"module-card": {
 		type: "module-card",
 		category: "display",
+		sourceFile: "components/avl/molecules/ModuleCard.tsx",
 		tier: "molecules",
 		family: "avl",
 		description: "ModuleCard — a card summarizing one course module or lesson with progress and entry point.",
@@ -31897,6 +32049,7 @@ var patterns = {
 	"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).",
@@ -32086,6 +32239,7 @@ var patterns = {
 	"split-pane": {
 		type: "split-pane",
 		category: "layout",
+		sourceFile: "components/core/organisms/layout/SplitPane.tsx",
 		tier: "organisms",
 		family: "core",
 		description: "SplitPane component",
@@ -32177,6 +32331,7 @@ var patterns = {
 	"tabbed-container": {
 		type: "tabbed-container",
 		category: "navigation",
+		sourceFile: "components/core/organisms/layout/TabbedContainer.tsx",
 		tier: "organisms",
 		family: "core",
 		description: "TabbedContainer component",
@@ -32283,6 +32438,7 @@ var patterns = {
 	"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).",
@@ -32351,6 +32507,7 @@ var patterns = {
 	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.",
@@ -32426,6 +32583,7 @@ var patterns = {
 	"date-range-picker": {
 		type: "date-range-picker",
 		category: "component",
+		sourceFile: "components/core/molecules/DateRangePicker.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "DateRangePicker component",
@@ -32576,6 +32734,7 @@ var patterns = {
 	aside: {
 		type: "aside",
 		category: "component",
+		sourceFile: "components/core/atoms/Aside.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "Aside — a secondary side panel that hosts navigation links or supplementary content alongside a main content area.",
@@ -32602,6 +32761,7 @@ var patterns = {
 	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.",
@@ -32627,6 +32787,7 @@ var patterns = {
 	"tag-input": {
 		type: "tag-input",
 		category: "form",
+		sourceFile: "components/core/molecules/TagInput.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "TagInput component",
@@ -33342,6 +33503,7 @@ var patterns = {
 	"stat-card": {
 		type: "stat-card",
 		category: "display",
+		sourceFile: "components/core/organisms/StatCard.tsx",
 		tier: "organisms",
 		family: "core",
 		description: "StatCard component",
@@ -33652,6 +33814,7 @@ var patterns = {
 	"activation-block": {
 		type: "activation-block",
 		category: "component",
+		sourceFile: "components/core/molecules/ActivationBlock.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "ActivationBlock component",
@@ -33693,6 +33856,7 @@ var patterns = {
 	"bloom-quiz-block": {
 		type: "bloom-quiz-block",
 		category: "component",
+		sourceFile: "components/core/molecules/BloomQuizBlock.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "BloomQuizBlock component",
@@ -33763,6 +33927,7 @@ var patterns = {
 	"connection-block": {
 		type: "connection-block",
 		category: "component",
+		sourceFile: "components/core/molecules/ConnectionBlock.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "ConnectionBlock component",
@@ -33791,6 +33956,7 @@ var patterns = {
 	"reflection-block": {
 		type: "reflection-block",
 		category: "component",
+		sourceFile: "components/core/molecules/ReflectionBlock.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "ReflectionBlock component",
@@ -35609,6 +35775,7 @@ var patterns = {
 	vstack: {
 		type: "vstack",
 		category: "component",
+		sourceFile: "components/core/atoms/Stack.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "VStack - Vertical stack shorthand",
@@ -35765,7 +35932,8 @@ var patterns = {
 					"object"
 				],
 				description: "Payload to include with the action event",
-				payloadFor: "action"
+				payloadFor: "action",
+				eventPayloadBrand: true
 			},
 			responsive: {
 				types: [
@@ -35779,6 +35947,7 @@ var patterns = {
 	hstack: {
 		type: "hstack",
 		category: "component",
+		sourceFile: "components/core/atoms/Stack.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "HStack - Horizontal stack shorthand",
@@ -35935,7 +36104,8 @@ var patterns = {
 					"object"
 				],
 				description: "Payload to include with the action event",
-				payloadFor: "action"
+				payloadFor: "action",
+				eventPayloadBrand: true
 			},
 			responsive: {
 				types: [
@@ -35949,6 +36119,7 @@ var patterns = {
 	"form-layout": {
 		type: "form-layout",
 		category: "form",
+		sourceFile: "components/core/molecules/FormSection.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "Form layout with multiple sections",
@@ -36084,6 +36255,7 @@ var patterns = {
 	"learning-canvas": {
 		type: "learning-canvas",
 		category: "learning",
+		sourceFile: "components/learning/atoms/LearningCanvas.tsx",
 		tier: "atoms",
 		family: "learning",
 		description: "LearningCanvas component",
@@ -36689,6 +36861,7 @@ var patterns = {
 	"biology-canvas": {
 		type: "biology-canvas",
 		category: "learning",
+		sourceFile: "components/learning/molecules/BiologyCanvas.tsx",
 		tier: "molecules",
 		family: "learning",
 		description: "BiologyCanvas component",
@@ -37991,6 +38164,7 @@ var patterns = {
 	"chemistry-canvas": {
 		type: "chemistry-canvas",
 		category: "learning",
+		sourceFile: "components/learning/molecules/ChemistryCanvas.tsx",
 		tier: "molecules",
 		family: "learning",
 		description: "ChemistryCanvas component",
@@ -40382,6 +40556,7 @@ var patterns = {
 	"physics-canvas": {
 		type: "physics-canvas",
 		category: "learning",
+		sourceFile: "components/learning/molecules/PhysicsCanvas.tsx",
 		tier: "molecules",
 		family: "learning",
 		description: "PhysicsCanvas component",
@@ -41908,6 +42083,7 @@ var patterns = {
 	"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 — this molecule only renders and reports clicks.",
@@ -42033,6 +42209,7 @@ var patterns = {
 	"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) — the .lolo organism owns the entity and the molecule renders + stringifies it.",
@@ -42128,6 +42305,7 @@ var patterns = {
 	"algorithm-canvas": {
 		type: "algorithm-canvas",
 		category: "learning",
+		sourceFile: "components/learning/molecules/AlgorithmCanvas.tsx",
 		tier: "molecules",
 		family: "learning",
 		description: "AlgorithmCanvas component",
@@ -42930,6 +43108,7 @@ var patterns = {
 	"atlas-image": {
 		type: "atlas-image",
 		category: "component",
+		sourceFile: "components/core/atoms/AtlasImage.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "AtlasImage component",
@@ -43044,6 +43223,7 @@ var patterns = {
 	"atlas-panel": {
 		type: "atlas-panel",
 		category: "component",
+		sourceFile: "components/core/atoms/AtlasImage.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "AtlasPanel component",
@@ -43146,6 +43326,7 @@ var patterns = {
 	"draw-shape": {
 		type: "draw-shape",
 		category: "game",
+		sourceFile: "components/game/atoms/DrawShape.tsx",
 		tier: "atoms",
 		family: "game",
 		description: "DrawShape component",
@@ -44113,6 +44294,7 @@ var patterns = {
 	"draw-text": {
 		type: "draw-text",
 		category: "game",
+		sourceFile: "components/game/atoms/DrawText.tsx",
 		tier: "atoms",
 		family: "game",
 		description: "DrawText component",
@@ -44250,6 +44432,7 @@ var patterns = {
 	"draw-shape-layer": {
 		type: "draw-shape-layer",
 		category: "game",
+		sourceFile: "components/game/molecules/DrawShapeLayer.tsx",
 		tier: "molecules",
 		family: "game",
 		description: "DrawShapeLayer component",
@@ -45240,6 +45423,7 @@ var patterns = {
 	"draw-text-layer": {
 		type: "draw-text-layer",
 		category: "game",
+		sourceFile: "components/game/molecules/DrawTextLayer.tsx",
 		tier: "molecules",
 		family: "game",
 		description: "DrawTextLayer component",
@@ -46176,6 +46360,7 @@ var patterns = {
 	presence: {
 		type: "presence",
 		category: "component",
+		sourceFile: "components/core/atoms/Presence.tsx",
 		tier: "atoms",
 		family: "core",
 		description: "Presence component",
@@ -46209,6 +46394,7 @@ var patterns = {
 	"page-transition": {
 		type: "page-transition",
 		category: "component",
+		sourceFile: "components/core/molecules/PageTransition.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "PageTransition component",
@@ -46408,6 +46594,7 @@ var patterns = {
 	"import-progress": {
 		type: "import-progress",
 		category: "component",
+		sourceFile: "components/core/molecules/import/ImportProgress.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "ImportProgress component",
@@ -46478,6 +46665,7 @@ var patterns = {
 	"import-source-picker": {
 		type: "import-source-picker",
 		category: "component",
+		sourceFile: "components/core/molecules/import/ImportSourcePicker.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "ImportSourcePicker component",
@@ -46612,6 +46800,7 @@ var patterns = {
 	"draw-group": {
 		type: "draw-group",
 		category: "game",
+		sourceFile: "components/game/atoms/DrawGroup.tsx",
 		tier: "atoms",
 		family: "game",
 		description: "DrawGroup component",
@@ -46831,6 +47020,7 @@ var patterns = {
 	"emoji-picker": {
 		type: "emoji-picker",
 		category: "component",
+		sourceFile: "components/core/molecules/EmojiPicker.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "EmojiPicker component",
@@ -46892,6 +47082,7 @@ var patterns = {
 	"draw-mesh": {
 		type: "draw-mesh",
 		category: "game",
+		sourceFile: "components/game/atoms/DrawMesh.tsx",
 		tier: "atoms",
 		family: "game",
 		description: "DrawMesh component",
@@ -47369,6 +47560,7 @@ var patterns = {
 	"algo-graph-canvas": {
 		type: "algo-graph-canvas",
 		category: "learning",
+		sourceFile: "components/learning/molecules/AlgoGraphCanvas.tsx",
 		tier: "molecules",
 		family: "learning",
 		description: "AlgoGraphCanvas component",
@@ -47937,6 +48129,7 @@ var patterns = {
 	"fx-overlay": {
 		type: "fx-overlay",
 		category: "container",
+		sourceFile: "components/core/molecules/FxOverlay.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "FxOverlay component",
@@ -48514,6 +48707,7 @@ var patterns = {
 	"rich-text-editor": {
 		type: "rich-text-editor",
 		category: "component",
+		sourceFile: "components/core/molecules/RichTextEditor.tsx",
 		tier: "molecules",
 		family: "core",
 		description: "RichTextEditor component",
@@ -49551,6 +49745,7 @@ var patterns = {
 	"game-audio-cue": {
 		type: "game-audio-cue",
 		category: "game",
+		sourceFile: "components/game/atoms/GameAudioCue.tsx",
 		tier: "atoms",
 		family: "game",
 		description: "GameAudioCue component",
@@ -49661,6 +49856,7 @@ var patterns = {
 	"ui-slot-component": {
 		type: "ui-slot-component",
 		category: "layout",
+		sourceFile: "components/core/organisms/UISlotRenderer.tsx",
 		tier: "organisms",
 		family: "core",
 		description: "UISlotComponent component",
@@ -55135,7 +55331,7 @@ var integratorsRegistry = {
 };
 
 var version$1 = "1.0.0";
-var exportedAt$1 = "2026-09-27T02:12:25.691Z";
+var exportedAt$1 = "2026-09-27T13:02:32.256Z";
 var mappings = {
 	"page-header": {
 		component: "PageHeader",
@@ -56437,7 +56633,7 @@ var componentMapping = {
 };
 
 var version = "1.0.0";
-var exportedAt = "2026-09-27T02:12:25.691Z";
+var exportedAt = "2026-09-27T13:02:32.256Z";
 var contracts = {
 	form: {
 		emits: [
@@ -60602,6 +60798,7 @@ declare const registry: {
         "search-input": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -60667,6 +60864,7 @@ declare const registry: {
         "filter-group": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -61059,6 +61257,13 @@ declare const registry: {
                         };
                         required: string[];
                     };
+                    example: ({
+                        label: string;
+                        href: string;
+                    } | {
+                        label: string;
+                        href?: undefined;
+                    })[];
                 };
                 fromNavStack: {
                     types: string[];
@@ -61093,6 +61298,7 @@ declare const registry: {
         "wizard-progress": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -61161,6 +61367,7 @@ declare const registry: {
         "wizard-navigation": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -61760,6 +61967,7 @@ declare const registry: {
         pagination: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -61859,6 +62067,7 @@ declare const registry: {
         "empty-state": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -61921,6 +62130,7 @@ declare const registry: {
         "loading-state": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -61949,6 +62159,7 @@ declare const registry: {
         "error-state": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -61988,6 +62199,7 @@ declare const registry: {
         notification: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -62060,6 +62272,7 @@ declare const registry: {
         modal: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -62143,6 +62356,7 @@ declare const registry: {
         drawer: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -62213,6 +62427,7 @@ declare const registry: {
         "confirm-dialog": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -62310,6 +62525,7 @@ declare const registry: {
         "master-detail": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -62435,6 +62651,7 @@ declare const registry: {
                     types: string[];
                     description: string;
                     enumValues: string[];
+                    example: string;
                 };
                 paddingX: {
                     types: string[];
@@ -62471,6 +62688,7 @@ declare const registry: {
                     types: string[];
                     description: string;
                     default: boolean;
+                    example: boolean;
                 };
                 rounded: {
                     types: string[];
@@ -62552,6 +62770,7 @@ declare const registry: {
         grid: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -62646,6 +62865,7 @@ declare const registry: {
         center: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -62706,6 +62926,7 @@ declare const registry: {
         spacer: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -62733,6 +62954,7 @@ declare const registry: {
         divider: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -62764,6 +62986,7 @@ declare const registry: {
         "runtime-debugger": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -62912,6 +63135,7 @@ declare const registry: {
                 label: {
                     types: string[];
                     description: string;
+                    example: string;
                 };
                 disabled: {
                     types: string[];
@@ -63030,6 +63254,7 @@ declare const registry: {
         avatar: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -63090,12 +63315,14 @@ declare const registry: {
                     types: string[];
                     description: string;
                     payloadFor: string;
+                    eventPayloadBrand: boolean;
                 };
             };
         };
         icon: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -63146,6 +63373,7 @@ declare const registry: {
         card: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -63205,6 +63433,7 @@ declare const registry: {
         "progress-bar": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -63272,6 +63501,7 @@ declare const registry: {
         spinner: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -63591,6 +63821,7 @@ declare const registry: {
         checkbox: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -63628,6 +63859,7 @@ declare const registry: {
         radio: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -63682,6 +63914,7 @@ declare const registry: {
         switch: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -63732,6 +63965,7 @@ declare const registry: {
         label: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -63759,6 +63993,7 @@ declare const registry: {
         alert: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -63818,6 +64053,7 @@ declare const registry: {
         tooltip: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -63864,6 +64100,7 @@ declare const registry: {
         popover: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -64010,6 +64247,7 @@ declare const registry: {
         accordion: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -64099,6 +64337,7 @@ declare const registry: {
         container: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -64143,6 +64382,7 @@ declare const registry: {
         "simple-grid": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -64392,6 +64632,7 @@ declare const registry: {
         "law-reference-tooltip": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -64441,6 +64682,7 @@ declare const registry: {
         overlay: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -64481,6 +64723,7 @@ declare const registry: {
         stack: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -64582,6 +64825,7 @@ declare const registry: {
                     types: string[];
                     description: string;
                     payloadFor: string;
+                    eventPayloadBrand: boolean;
                 };
                 responsive: {
                     types: string[];
@@ -64593,6 +64837,7 @@ declare const registry: {
         "text-highlight": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -64666,6 +64911,7 @@ declare const registry: {
         "theme-toggle": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -64692,6 +64938,7 @@ declare const registry: {
         typography: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -64908,6 +65155,7 @@ declare const registry: {
         flex: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -65062,6 +65310,7 @@ declare const registry: {
         "form-field": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -65099,6 +65348,7 @@ declare const registry: {
         "form-section-header": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -65272,6 +65522,7 @@ declare const registry: {
         "relation-select": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -65364,6 +65615,7 @@ declare const registry: {
         "side-panel": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -65423,6 +65675,7 @@ declare const registry: {
         "violation-alert": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -65508,6 +65761,7 @@ declare const registry: {
         "drawer-slot": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -65748,6 +66002,7 @@ declare const registry: {
         "modal-slot": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -65990,6 +66245,7 @@ declare const registry: {
         section: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -66307,6 +66563,7 @@ declare const registry: {
         "toast-slot": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -66405,6 +66662,7 @@ declare const registry: {
         "counter-template": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -66703,6 +66961,7 @@ declare const registry: {
         "generic-app-template": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -67544,6 +67803,7 @@ declare const registry: {
         "signature-pad": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -68229,6 +68489,7 @@ declare const registry: {
         "error-boundary": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -68263,6 +68524,7 @@ declare const registry: {
         skeleton: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -68299,6 +68561,7 @@ declare const registry: {
         "quiz-block": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -68630,11 +68893,22 @@ declare const registry: {
                     default: string[];
                     tier: string;
                 };
+                completions: {
+                    types: string[];
+                    description: string;
+                    callbackArgs: {
+                        name: string;
+                        type: string;
+                    }[];
+                    renderCallback: boolean;
+                    tier: string;
+                };
             };
         };
         "markdown-content": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -68661,6 +68935,7 @@ declare const registry: {
         "content-renderer": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -68764,6 +69039,7 @@ declare const registry: {
         "jazari-state-machine": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -69005,6 +69281,7 @@ declare const registry: {
         "scaled-diagram": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -69025,6 +69302,7 @@ declare const registry: {
         "day-cell": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -69058,6 +69336,7 @@ declare const registry: {
         "flip-container": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -69089,6 +69368,7 @@ declare const registry: {
         "time-slot-cell": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -69276,6 +69556,7 @@ declare const registry: {
         "chart-legend": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -69314,6 +69595,7 @@ declare const registry: {
         "date-range-selector": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -69359,6 +69641,7 @@ declare const registry: {
         "flip-card": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -69401,6 +69684,7 @@ declare const registry: {
         "graph-view": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -70313,6 +70597,7 @@ declare const registry: {
         "map-view": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -70582,6 +70867,7 @@ declare const registry: {
         "status-dot": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -70618,6 +70904,7 @@ declare const registry: {
         "trend-indicator": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -70662,6 +70949,7 @@ declare const registry: {
         lightbox: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -70731,6 +71019,7 @@ declare const registry: {
         "number-stepper": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -70789,6 +71078,7 @@ declare const registry: {
                     types: string[];
                     description: string;
                     payloadFor: string;
+                    eventPayloadBrand: boolean;
                 };
                 className: {
                     types: string[];
@@ -70803,6 +71093,7 @@ declare const registry: {
         "star-rating": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -70850,6 +71141,7 @@ declare const registry: {
                     types: string[];
                     description: string;
                     payloadFor: string;
+                    eventPayloadBrand: boolean;
                 };
                 onChange: {
                     types: string[];
@@ -70873,6 +71165,7 @@ declare const registry: {
         "upload-drop-zone": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -70944,6 +71237,7 @@ declare const registry: {
                     types: string[];
                     description: string;
                     payloadFor: string;
+                    eventPayloadBrand: boolean;
                 };
                 onFiles: {
                     types: string[];
@@ -71012,6 +71306,7 @@ declare const registry: {
         "confetti-effect": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -71042,6 +71337,7 @@ declare const registry: {
         "infinite-scroll-sentinel": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -71058,6 +71354,7 @@ declare const registry: {
                     types: string[];
                     description: string;
                     payloadFor: string;
+                    eventPayloadBrand: boolean;
                 };
                 isLoading: {
                     types: string[];
@@ -71083,6 +71380,7 @@ declare const registry: {
         "typewriter-text": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -71252,6 +71550,7 @@ declare const registry: {
         "pull-to-refresh": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -71268,6 +71567,7 @@ declare const registry: {
                     types: string[];
                     description: string;
                     payloadFor: string;
+                    eventPayloadBrand: boolean;
                 };
                 threshold: {
                     types: string[];
@@ -71442,6 +71742,7 @@ declare const registry: {
         "stat-display": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -71576,6 +71877,7 @@ declare const registry: {
         "section-header": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -71664,6 +71966,7 @@ declare const registry: {
         "feature-grid": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -71728,6 +72031,7 @@ declare const registry: {
         "social-proof": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -71938,6 +72242,7 @@ declare const registry: {
         "edge-decoration": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -71985,6 +72290,7 @@ declare const registry: {
         "ui-slot-renderer": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -72059,6 +72365,7 @@ declare const registry: {
         "trait-frame": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -72111,6 +72418,9 @@ declare const registry: {
                                     cyclicTypeName: string;
                                 };
                             };
+                            note: {
+                                types: string[];
+                            };
                             size: {
                                 types: string[];
                             };
@@ -72218,6 +72528,7 @@ declare const registry: {
         "filter-pill": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -72292,6 +72603,7 @@ declare const registry: {
         "likert-scale": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -72368,6 +72680,7 @@ declare const registry: {
         "matrix-question": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -72457,6 +72770,7 @@ declare const registry: {
         "qr-scanner": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -72541,6 +72855,7 @@ declare const registry: {
         "vote-stack": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -72608,6 +72923,7 @@ declare const registry: {
         "branching-logic-builder": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -73053,6 +73369,7 @@ declare const registry: {
         "option-constraint-group": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -73171,6 +73488,7 @@ declare const registry: {
         "positioned-canvas": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -73938,6 +74256,7 @@ declare const registry: {
         "svg-branch": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -74004,6 +74323,7 @@ declare const registry: {
         "svg-connection": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -74075,6 +74395,7 @@ declare const registry: {
         "svg-flow": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -74135,6 +74456,7 @@ declare const registry: {
         "svg-grid": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -74213,6 +74535,7 @@ declare const registry: {
         "svg-lobe": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -74283,6 +74606,7 @@ declare const registry: {
         "svg-mesh": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -74348,6 +74672,7 @@ declare const registry: {
         "svg-morph": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -74409,6 +74734,7 @@ declare const registry: {
         "svg-node": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -74474,6 +74800,7 @@ declare const registry: {
         "svg-pulse": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -74539,6 +74866,7 @@ declare const registry: {
         "svg-ring": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -74609,6 +74937,7 @@ declare const registry: {
         "svg-shield": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -74670,6 +74999,7 @@ declare const registry: {
         "svg-stack": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -74741,6 +75071,7 @@ declare const registry: {
         "doc-breadcrumb": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -74773,6 +75104,7 @@ declare const registry: {
         "doc-pagination": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -74893,6 +75225,7 @@ declare const registry: {
         "doc-toc": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -74932,6 +75265,7 @@ declare const registry: {
         "gradient-divider": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -74951,6 +75285,7 @@ declare const registry: {
         "behavior-view": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -75156,6 +75491,7 @@ declare const registry: {
         "module-card": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -77496,6 +77832,7 @@ declare const registry: {
         "dashboard-grid": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -77609,6 +77946,7 @@ declare const registry: {
         "split-pane": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -77671,6 +78009,7 @@ declare const registry: {
         "tabbed-container": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -77738,6 +78077,7 @@ declare const registry: {
         "master-detail-layout": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -77785,6 +78125,7 @@ declare const registry: {
         sparkline: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -77834,6 +78175,7 @@ declare const registry: {
         "date-range-picker": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -77926,6 +78268,7 @@ declare const registry: {
         aside: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -77946,6 +78289,7 @@ declare const registry: {
         dialog: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -77965,6 +78309,7 @@ declare const registry: {
         "tag-input": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -78394,6 +78739,7 @@ declare const registry: {
         "stat-card": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -78587,6 +78933,7 @@ declare const registry: {
         "activation-block": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -78616,6 +78963,7 @@ declare const registry: {
         "bloom-quiz-block": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -78660,6 +79008,7 @@ declare const registry: {
         "connection-block": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -78680,6 +79029,7 @@ declare const registry: {
         "reflection-block": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -79748,6 +80098,7 @@ declare const registry: {
         vstack: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -79843,6 +80194,7 @@ declare const registry: {
                     types: string[];
                     description: string;
                     payloadFor: string;
+                    eventPayloadBrand: boolean;
                 };
                 responsive: {
                     types: string[];
@@ -79854,6 +80206,7 @@ declare const registry: {
         hstack: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -79949,6 +80302,7 @@ declare const registry: {
                     types: string[];
                     description: string;
                     payloadFor: string;
+                    eventPayloadBrand: boolean;
                 };
                 responsive: {
                     types: string[];
@@ -79960,6 +80314,7 @@ declare const registry: {
         "form-layout": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -80047,6 +80402,7 @@ declare const registry: {
         "learning-canvas": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -80406,6 +80762,7 @@ declare const registry: {
         "biology-canvas": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -81169,6 +81526,7 @@ declare const registry: {
         "chemistry-canvas": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -82583,6 +82941,7 @@ declare const registry: {
         "physics-canvas": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -83483,6 +83842,7 @@ declare const registry: {
         "state-graph": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -83565,6 +83925,7 @@ declare const registry: {
         "state-json-view": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -83627,6 +83988,7 @@ declare const registry: {
         "algorithm-canvas": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -84096,6 +84458,7 @@ declare const registry: {
         "atlas-image": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -84170,6 +84533,7 @@ declare const registry: {
         "atlas-panel": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -84237,6 +84601,7 @@ declare const registry: {
         "draw-shape": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -84793,6 +85158,7 @@ declare const registry: {
         "draw-text": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -84874,6 +85240,7 @@ declare const registry: {
         "draw-shape-layer": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -85423,6 +85790,7 @@ declare const registry: {
         "draw-text-layer": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -85942,6 +86310,7 @@ declare const registry: {
         presence: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -85967,6 +86336,7 @@ declare const registry: {
         "page-transition": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -86096,6 +86466,7 @@ declare const registry: {
         "import-progress": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -86139,6 +86510,7 @@ declare const registry: {
         "import-source-picker": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -86223,6 +86595,7 @@ declare const registry: {
         "draw-group": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -86362,6 +86735,7 @@ declare const registry: {
         "emoji-picker": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -86403,6 +86777,7 @@ declare const registry: {
         "draw-mesh": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -86689,6 +87064,7 @@ declare const registry: {
         "algo-graph-canvas": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -87017,6 +87393,7 @@ declare const registry: {
         "fx-overlay": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -87343,6 +87720,7 @@ declare const registry: {
         "rich-text-editor": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -88012,6 +88390,7 @@ declare const registry: {
         "game-audio-cue": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -88082,6 +88461,7 @@ declare const registry: {
         "ui-slot-component": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -91322,6 +91702,7 @@ declare const PATTERN_REGISTRY: {
         "search-input": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -91387,6 +91768,7 @@ declare const PATTERN_REGISTRY: {
         "filter-group": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -91779,6 +92161,13 @@ declare const PATTERN_REGISTRY: {
                         };
                         required: string[];
                     };
+                    example: ({
+                        label: string;
+                        href: string;
+                    } | {
+                        label: string;
+                        href?: undefined;
+                    })[];
                 };
                 fromNavStack: {
                     types: string[];
@@ -91813,6 +92202,7 @@ declare const PATTERN_REGISTRY: {
         "wizard-progress": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -91881,6 +92271,7 @@ declare const PATTERN_REGISTRY: {
         "wizard-navigation": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -92480,6 +92871,7 @@ declare const PATTERN_REGISTRY: {
         pagination: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -92579,6 +92971,7 @@ declare const PATTERN_REGISTRY: {
         "empty-state": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -92641,6 +93034,7 @@ declare const PATTERN_REGISTRY: {
         "loading-state": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -92669,6 +93063,7 @@ declare const PATTERN_REGISTRY: {
         "error-state": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -92708,6 +93103,7 @@ declare const PATTERN_REGISTRY: {
         notification: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -92780,6 +93176,7 @@ declare const PATTERN_REGISTRY: {
         modal: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -92863,6 +93260,7 @@ declare const PATTERN_REGISTRY: {
         drawer: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -92933,6 +93331,7 @@ declare const PATTERN_REGISTRY: {
         "confirm-dialog": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -93030,6 +93429,7 @@ declare const PATTERN_REGISTRY: {
         "master-detail": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -93155,6 +93555,7 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                     enumValues: string[];
+                    example: string;
                 };
                 paddingX: {
                     types: string[];
@@ -93191,6 +93592,7 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                     default: boolean;
+                    example: boolean;
                 };
                 rounded: {
                     types: string[];
@@ -93272,6 +93674,7 @@ declare const PATTERN_REGISTRY: {
         grid: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -93366,6 +93769,7 @@ declare const PATTERN_REGISTRY: {
         center: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -93426,6 +93830,7 @@ declare const PATTERN_REGISTRY: {
         spacer: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -93453,6 +93858,7 @@ declare const PATTERN_REGISTRY: {
         divider: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -93484,6 +93890,7 @@ declare const PATTERN_REGISTRY: {
         "runtime-debugger": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -93632,6 +94039,7 @@ declare const PATTERN_REGISTRY: {
                 label: {
                     types: string[];
                     description: string;
+                    example: string;
                 };
                 disabled: {
                     types: string[];
@@ -93750,6 +94158,7 @@ declare const PATTERN_REGISTRY: {
         avatar: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -93810,12 +94219,14 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                     payloadFor: string;
+                    eventPayloadBrand: boolean;
                 };
             };
         };
         icon: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -93866,6 +94277,7 @@ declare const PATTERN_REGISTRY: {
         card: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -93925,6 +94337,7 @@ declare const PATTERN_REGISTRY: {
         "progress-bar": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -93992,6 +94405,7 @@ declare const PATTERN_REGISTRY: {
         spinner: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -94311,6 +94725,7 @@ declare const PATTERN_REGISTRY: {
         checkbox: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -94348,6 +94763,7 @@ declare const PATTERN_REGISTRY: {
         radio: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -94402,6 +94818,7 @@ declare const PATTERN_REGISTRY: {
         switch: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -94452,6 +94869,7 @@ declare const PATTERN_REGISTRY: {
         label: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -94479,6 +94897,7 @@ declare const PATTERN_REGISTRY: {
         alert: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -94538,6 +94957,7 @@ declare const PATTERN_REGISTRY: {
         tooltip: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -94584,6 +95004,7 @@ declare const PATTERN_REGISTRY: {
         popover: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -94730,6 +95151,7 @@ declare const PATTERN_REGISTRY: {
         accordion: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -94819,6 +95241,7 @@ declare const PATTERN_REGISTRY: {
         container: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -94863,6 +95286,7 @@ declare const PATTERN_REGISTRY: {
         "simple-grid": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -95112,6 +95536,7 @@ declare const PATTERN_REGISTRY: {
         "law-reference-tooltip": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -95161,6 +95586,7 @@ declare const PATTERN_REGISTRY: {
         overlay: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -95201,6 +95627,7 @@ declare const PATTERN_REGISTRY: {
         stack: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -95302,6 +95729,7 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                     payloadFor: string;
+                    eventPayloadBrand: boolean;
                 };
                 responsive: {
                     types: string[];
@@ -95313,6 +95741,7 @@ declare const PATTERN_REGISTRY: {
         "text-highlight": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -95386,6 +95815,7 @@ declare const PATTERN_REGISTRY: {
         "theme-toggle": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -95412,6 +95842,7 @@ declare const PATTERN_REGISTRY: {
         typography: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -95628,6 +96059,7 @@ declare const PATTERN_REGISTRY: {
         flex: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -95782,6 +96214,7 @@ declare const PATTERN_REGISTRY: {
         "form-field": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -95819,6 +96252,7 @@ declare const PATTERN_REGISTRY: {
         "form-section-header": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -95992,6 +96426,7 @@ declare const PATTERN_REGISTRY: {
         "relation-select": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -96084,6 +96519,7 @@ declare const PATTERN_REGISTRY: {
         "side-panel": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -96143,6 +96579,7 @@ declare const PATTERN_REGISTRY: {
         "violation-alert": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -96228,6 +96665,7 @@ declare const PATTERN_REGISTRY: {
         "drawer-slot": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -96468,6 +96906,7 @@ declare const PATTERN_REGISTRY: {
         "modal-slot": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -96710,6 +97149,7 @@ declare const PATTERN_REGISTRY: {
         section: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -97027,6 +97467,7 @@ declare const PATTERN_REGISTRY: {
         "toast-slot": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -97125,6 +97566,7 @@ declare const PATTERN_REGISTRY: {
         "counter-template": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -97423,6 +97865,7 @@ declare const PATTERN_REGISTRY: {
         "generic-app-template": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -98264,6 +98707,7 @@ declare const PATTERN_REGISTRY: {
         "signature-pad": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -98949,6 +99393,7 @@ declare const PATTERN_REGISTRY: {
         "error-boundary": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -98983,6 +99428,7 @@ declare const PATTERN_REGISTRY: {
         skeleton: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -99019,6 +99465,7 @@ declare const PATTERN_REGISTRY: {
         "quiz-block": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -99350,11 +99797,22 @@ declare const PATTERN_REGISTRY: {
                     default: string[];
                     tier: string;
                 };
+                completions: {
+                    types: string[];
+                    description: string;
+                    callbackArgs: {
+                        name: string;
+                        type: string;
+                    }[];
+                    renderCallback: boolean;
+                    tier: string;
+                };
             };
         };
         "markdown-content": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -99381,6 +99839,7 @@ declare const PATTERN_REGISTRY: {
         "content-renderer": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -99484,6 +99943,7 @@ declare const PATTERN_REGISTRY: {
         "jazari-state-machine": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -99725,6 +100185,7 @@ declare const PATTERN_REGISTRY: {
         "scaled-diagram": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -99745,6 +100206,7 @@ declare const PATTERN_REGISTRY: {
         "day-cell": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -99778,6 +100240,7 @@ declare const PATTERN_REGISTRY: {
         "flip-container": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -99809,6 +100272,7 @@ declare const PATTERN_REGISTRY: {
         "time-slot-cell": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -99996,6 +100460,7 @@ declare const PATTERN_REGISTRY: {
         "chart-legend": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -100034,6 +100499,7 @@ declare const PATTERN_REGISTRY: {
         "date-range-selector": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -100079,6 +100545,7 @@ declare const PATTERN_REGISTRY: {
         "flip-card": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -100121,6 +100588,7 @@ declare const PATTERN_REGISTRY: {
         "graph-view": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -101033,6 +101501,7 @@ declare const PATTERN_REGISTRY: {
         "map-view": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -101302,6 +101771,7 @@ declare const PATTERN_REGISTRY: {
         "status-dot": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -101338,6 +101808,7 @@ declare const PATTERN_REGISTRY: {
         "trend-indicator": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -101382,6 +101853,7 @@ declare const PATTERN_REGISTRY: {
         lightbox: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -101451,6 +101923,7 @@ declare const PATTERN_REGISTRY: {
         "number-stepper": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -101509,6 +101982,7 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                     payloadFor: string;
+                    eventPayloadBrand: boolean;
                 };
                 className: {
                     types: string[];
@@ -101523,6 +101997,7 @@ declare const PATTERN_REGISTRY: {
         "star-rating": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -101570,6 +102045,7 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                     payloadFor: string;
+                    eventPayloadBrand: boolean;
                 };
                 onChange: {
                     types: string[];
@@ -101593,6 +102069,7 @@ declare const PATTERN_REGISTRY: {
         "upload-drop-zone": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -101664,6 +102141,7 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                     payloadFor: string;
+                    eventPayloadBrand: boolean;
                 };
                 onFiles: {
                     types: string[];
@@ -101732,6 +102210,7 @@ declare const PATTERN_REGISTRY: {
         "confetti-effect": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -101762,6 +102241,7 @@ declare const PATTERN_REGISTRY: {
         "infinite-scroll-sentinel": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -101778,6 +102258,7 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                     payloadFor: string;
+                    eventPayloadBrand: boolean;
                 };
                 isLoading: {
                     types: string[];
@@ -101803,6 +102284,7 @@ declare const PATTERN_REGISTRY: {
         "typewriter-text": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -101972,6 +102454,7 @@ declare const PATTERN_REGISTRY: {
         "pull-to-refresh": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -101988,6 +102471,7 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                     payloadFor: string;
+                    eventPayloadBrand: boolean;
                 };
                 threshold: {
                     types: string[];
@@ -102162,6 +102646,7 @@ declare const PATTERN_REGISTRY: {
         "stat-display": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -102296,6 +102781,7 @@ declare const PATTERN_REGISTRY: {
         "section-header": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -102384,6 +102870,7 @@ declare const PATTERN_REGISTRY: {
         "feature-grid": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -102448,6 +102935,7 @@ declare const PATTERN_REGISTRY: {
         "social-proof": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -102658,6 +103146,7 @@ declare const PATTERN_REGISTRY: {
         "edge-decoration": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -102705,6 +103194,7 @@ declare const PATTERN_REGISTRY: {
         "ui-slot-renderer": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -102779,6 +103269,7 @@ declare const PATTERN_REGISTRY: {
         "trait-frame": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -102831,6 +103322,9 @@ declare const PATTERN_REGISTRY: {
                                     cyclicTypeName: string;
                                 };
                             };
+                            note: {
+                                types: string[];
+                            };
                             size: {
                                 types: string[];
                             };
@@ -102938,6 +103432,7 @@ declare const PATTERN_REGISTRY: {
         "filter-pill": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -103012,6 +103507,7 @@ declare const PATTERN_REGISTRY: {
         "likert-scale": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -103088,6 +103584,7 @@ declare const PATTERN_REGISTRY: {
         "matrix-question": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -103177,6 +103674,7 @@ declare const PATTERN_REGISTRY: {
         "qr-scanner": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -103261,6 +103759,7 @@ declare const PATTERN_REGISTRY: {
         "vote-stack": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -103328,6 +103827,7 @@ declare const PATTERN_REGISTRY: {
         "branching-logic-builder": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -103773,6 +104273,7 @@ declare const PATTERN_REGISTRY: {
         "option-constraint-group": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -103891,6 +104392,7 @@ declare const PATTERN_REGISTRY: {
         "positioned-canvas": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -104658,6 +105160,7 @@ declare const PATTERN_REGISTRY: {
         "svg-branch": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -104724,6 +105227,7 @@ declare const PATTERN_REGISTRY: {
         "svg-connection": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -104795,6 +105299,7 @@ declare const PATTERN_REGISTRY: {
         "svg-flow": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -104855,6 +105360,7 @@ declare const PATTERN_REGISTRY: {
         "svg-grid": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -104933,6 +105439,7 @@ declare const PATTERN_REGISTRY: {
         "svg-lobe": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -105003,6 +105510,7 @@ declare const PATTERN_REGISTRY: {
         "svg-mesh": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -105068,6 +105576,7 @@ declare const PATTERN_REGISTRY: {
         "svg-morph": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -105129,6 +105638,7 @@ declare const PATTERN_REGISTRY: {
         "svg-node": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -105194,6 +105704,7 @@ declare const PATTERN_REGISTRY: {
         "svg-pulse": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -105259,6 +105770,7 @@ declare const PATTERN_REGISTRY: {
         "svg-ring": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -105329,6 +105841,7 @@ declare const PATTERN_REGISTRY: {
         "svg-shield": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -105390,6 +105903,7 @@ declare const PATTERN_REGISTRY: {
         "svg-stack": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -105461,6 +105975,7 @@ declare const PATTERN_REGISTRY: {
         "doc-breadcrumb": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -105493,6 +106008,7 @@ declare const PATTERN_REGISTRY: {
         "doc-pagination": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -105613,6 +106129,7 @@ declare const PATTERN_REGISTRY: {
         "doc-toc": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -105652,6 +106169,7 @@ declare const PATTERN_REGISTRY: {
         "gradient-divider": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -105671,6 +106189,7 @@ declare const PATTERN_REGISTRY: {
         "behavior-view": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -105876,6 +106395,7 @@ declare const PATTERN_REGISTRY: {
         "module-card": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -108216,6 +108736,7 @@ declare const PATTERN_REGISTRY: {
         "dashboard-grid": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -108329,6 +108850,7 @@ declare const PATTERN_REGISTRY: {
         "split-pane": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -108391,6 +108913,7 @@ declare const PATTERN_REGISTRY: {
         "tabbed-container": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -108458,6 +108981,7 @@ declare const PATTERN_REGISTRY: {
         "master-detail-layout": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -108505,6 +109029,7 @@ declare const PATTERN_REGISTRY: {
         sparkline: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -108554,6 +109079,7 @@ declare const PATTERN_REGISTRY: {
         "date-range-picker": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -108646,6 +109172,7 @@ declare const PATTERN_REGISTRY: {
         aside: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -108666,6 +109193,7 @@ declare const PATTERN_REGISTRY: {
         dialog: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -108685,6 +109213,7 @@ declare const PATTERN_REGISTRY: {
         "tag-input": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -109114,6 +109643,7 @@ declare const PATTERN_REGISTRY: {
         "stat-card": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -109307,6 +109837,7 @@ declare const PATTERN_REGISTRY: {
         "activation-block": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -109336,6 +109867,7 @@ declare const PATTERN_REGISTRY: {
         "bloom-quiz-block": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -109380,6 +109912,7 @@ declare const PATTERN_REGISTRY: {
         "connection-block": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -109400,6 +109933,7 @@ declare const PATTERN_REGISTRY: {
         "reflection-block": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -110468,6 +111002,7 @@ declare const PATTERN_REGISTRY: {
         vstack: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -110563,6 +111098,7 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                     payloadFor: string;
+                    eventPayloadBrand: boolean;
                 };
                 responsive: {
                     types: string[];
@@ -110574,6 +111110,7 @@ declare const PATTERN_REGISTRY: {
         hstack: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -110669,6 +111206,7 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                     payloadFor: string;
+                    eventPayloadBrand: boolean;
                 };
                 responsive: {
                     types: string[];
@@ -110680,6 +111218,7 @@ declare const PATTERN_REGISTRY: {
         "form-layout": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -110767,6 +111306,7 @@ declare const PATTERN_REGISTRY: {
         "learning-canvas": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -111126,6 +111666,7 @@ declare const PATTERN_REGISTRY: {
         "biology-canvas": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -111889,6 +112430,7 @@ declare const PATTERN_REGISTRY: {
         "chemistry-canvas": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -113303,6 +113845,7 @@ declare const PATTERN_REGISTRY: {
         "physics-canvas": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -114203,6 +114746,7 @@ declare const PATTERN_REGISTRY: {
         "state-graph": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -114285,6 +114829,7 @@ declare const PATTERN_REGISTRY: {
         "state-json-view": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -114347,6 +114892,7 @@ declare const PATTERN_REGISTRY: {
         "algorithm-canvas": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -114816,6 +115362,7 @@ declare const PATTERN_REGISTRY: {
         "atlas-image": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -114890,6 +115437,7 @@ declare const PATTERN_REGISTRY: {
         "atlas-panel": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -114957,6 +115505,7 @@ declare const PATTERN_REGISTRY: {
         "draw-shape": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -115513,6 +116062,7 @@ declare const PATTERN_REGISTRY: {
         "draw-text": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -115594,6 +116144,7 @@ declare const PATTERN_REGISTRY: {
         "draw-shape-layer": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -116143,6 +116694,7 @@ declare const PATTERN_REGISTRY: {
         "draw-text-layer": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -116662,6 +117214,7 @@ declare const PATTERN_REGISTRY: {
         presence: {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -116687,6 +117240,7 @@ declare const PATTERN_REGISTRY: {
         "page-transition": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -116816,6 +117370,7 @@ declare const PATTERN_REGISTRY: {
         "import-progress": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -116859,6 +117414,7 @@ declare const PATTERN_REGISTRY: {
         "import-source-picker": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -116943,6 +117499,7 @@ declare const PATTERN_REGISTRY: {
         "draw-group": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -117082,6 +117639,7 @@ declare const PATTERN_REGISTRY: {
         "emoji-picker": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -117123,6 +117681,7 @@ declare const PATTERN_REGISTRY: {
         "draw-mesh": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -117409,6 +117968,7 @@ declare const PATTERN_REGISTRY: {
         "algo-graph-canvas": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -117737,6 +118297,7 @@ declare const PATTERN_REGISTRY: {
         "fx-overlay": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -118063,6 +118624,7 @@ declare const PATTERN_REGISTRY: {
         "rich-text-editor": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -118732,6 +119294,7 @@ declare const PATTERN_REGISTRY: {
         "game-audio-cue": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
@@ -118802,6 +119365,7 @@ declare const PATTERN_REGISTRY: {
         "ui-slot-component": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;