@almadar/core 10.110.0 → 10.112.0

package/dist/patterns/index.d.ts

@@ -1,11 +1,11 @@
-import { A as AnyPatternConfig, l as RenderBinding, F as FieldValue, bF as PatternType, c as Effect } from '../effect-2JoKc8Zj.js';
-export { by as PATTERN_TYPES, h as PatternConfig, bD as PatternProps, bE as PatternPropsMap, dW as isValidPatternType } from '../effect-2JoKc8Zj.js';
-import { a as EventPayloadValue, b as EventPayload, p as SExprObject, S as SExpr } from '../expression-DhTTuu2W.js';
+import { A as AnyPatternConfig, l as RenderBinding, F as FieldValue, bF as PatternType, c as Effect } from '../effect-B9nMpTKN.js';
+export { by as PATTERN_TYPES, h as PatternConfig, bD as PatternProps, bE as PatternPropsMap, dW as isValidPatternType } from '../effect-B9nMpTKN.js';
+import { a as EventPayloadValue, b as EventPayload, p as SExprObject, S as SExpr } from '../expression-Dz84kipC.js';
 import { J as JsonValue } from '../json-D8gmyK3l.js';
 import 'zod';
 
 var version$3 = "1.0.0";
-var exportedAt$3 = "2026-09-28T12:49:04.761Z";
+var exportedAt$3 = "2026-09-30T15:57:56.420Z";
 var patterns = {
 	"entity-table": {
 		type: "entity-table",
@@ -287,6 +287,12 @@ var patterns = {
 							types: [
 								"function"
 							]
+						},
+						when: {
+							types: [
+								"sexpr",
+								"function"
+							]
 						}
 					},
 					required: [
@@ -402,6 +408,12 @@ var patterns = {
 								"string"
 							],
 							kind: "event"
+						},
+						when: {
+							types: [
+								"sexpr",
+								"function"
+							]
 						}
 					},
 					required: [
@@ -723,6 +735,12 @@ var patterns = {
 							types: [
 								"function"
 							]
+						},
+						when: {
+							types: [
+								"sexpr",
+								"function"
+							]
 						}
 					},
 					required: [
@@ -1220,6 +1238,12 @@ var patterns = {
 							types: [
 								"string"
 							]
+						},
+						when: {
+							types: [
+								"sexpr",
+								"function"
+							]
 						}
 					},
 					required: [
@@ -1557,6 +1581,12 @@ var patterns = {
 								"ghost",
 								"danger"
 							]
+						},
+						when: {
+							types: [
+								"sexpr",
+								"function"
+							]
 						}
 					},
 					required: [
@@ -1614,6 +1644,12 @@ var patterns = {
 							"ghost",
 							"danger"
 						]
+					},
+					when: {
+						types: [
+							"sexpr",
+							"function"
+						]
 					}
 				},
 				propertyRequired: [
@@ -1827,6 +1863,13 @@ var patterns = {
 				],
 				description: "Page title - accepts string or number from generated code accessing dynamic entity data"
 			},
+			icon: {
+				types: [
+					"icon",
+					"string"
+				],
+				description: "Icon shown before the title."
+			},
 			subtitle: {
 				types: [
 					"string",
@@ -3921,6 +3964,7 @@ var patterns = {
 		tier: "molecules",
 		family: "core",
 		description: "Search input with events",
+		minUsableWidth: 160,
 		suggestedFor: [
 			"search functionality",
 			"quick filters"
@@ -6448,6 +6492,13 @@ var patterns = {
 					"full-screen"
 				],
 				"default": "centered-card"
+			},
+			contained: {
+				types: [
+					"boolean"
+				],
+				description: "Render inside the nearest positioned ancestor (a preview frame) instead of portaling over the whole window; page scroll is left alone.",
+				"default": false
 			}
 		}
 	},
@@ -6472,6 +6523,22 @@ var patterns = {
 				description: "Whether the drawer is open (defaults to true when rendered by slot wrapper)",
 				"default": true
 			},
+			onExited: {
+				types: [
+					"function"
+				],
+				description: "Fires after the exit animation completes (the drawer is about to unmount).",
+				kind: "callback",
+				callbackArgs: [
+				]
+			},
+			contained: {
+				types: [
+					"boolean"
+				],
+				description: "Render inside the nearest positioned ancestor (a preview frame) instead of over the window.",
+				"default": false
+			},
 			onClose: {
 				types: [
 					"function"
@@ -6583,6 +6650,15 @@ var patterns = {
 				callbackArgs: [
 				]
 			},
+			onExited: {
+				types: [
+					"function"
+				],
+				description: "Fires after the exit animation completes (the dialog is about to unmount).",
+				kind: "callback",
+				callbackArgs: [
+				]
+			},
 			onConfirm: {
 				types: [
 					"function"
@@ -14558,225 +14634,238 @@ var patterns = {
 				description: "Format X-axis labels as time (ISO date in → \"Mar 2026\"-style label out)",
 				"default": false
 			},
-			drillEvent: {
-				types: [
-					"string"
-				],
-				description: "Event name emitted as `UI:{drillEvent}` with `{ label, value, seriesLabel? }` on data-point click"
-			},
-			actions: {
-				types: [
-					"array"
-				],
-				description: "Top-level chart actions (export, refresh, etc.)",
-				kind: "event-list",
-				eventField: "event",
-				items: {
-					types: [
-						"object"
-					],
-					properties: {
-						label: {
-							types: [
-								"string"
-							]
-						},
-						event: {
-							types: [
-								"string"
-							],
-							kind: "event"
-						},
-						navigatesTo: {
-							types: [
-								"string"
-							]
-						},
-						variant: {
-							types: [
-								"string"
-							],
-							enumValues: [
-								"primary",
-								"secondary",
-								"ghost"
-							]
-						}
-					},
-					required: [
-						"label"
-					]
-				}
-			},
-			isLoading: {
-				types: [
-					"boolean"
-				],
-				description: "Loading state",
-				"default": false
-			},
-			error: {
-				types: [
-					"object"
-				],
-				description: "Error state",
-				properties: {
-					message: {
-						types: [
-							"string"
-						]
-					},
-					name: {
-						types: [
-							"string"
-						]
-					},
-					code: {
-						types: [
-							"string"
-						]
-					},
-					stack: {
-						types: [
-							"string"
-						]
-					}
-				},
-				propertyRequired: [
-					"message"
-				]
-			},
-			className: {
+			period: {
 				types: [
 					"string"
 				],
-				description: "Additional CSS classes"
-			}
-		}
-	},
-	meter: {
-		type: "meter",
-		category: "visualization",
-		sourceFile: "components/core/molecules/Meter.tsx",
-		tier: "molecules",
-		family: "core",
-		description: "Gauge/meter component for displaying a value within a range with thresholds",
-		suggestedFor: [
-			"dashboards",
-			"progress tracking",
-			"credit/quota displays",
-			"KPI indicators"
-		],
-		typicalSize: "small",
-		propsSchema: {
-			value: {
-				types: [
-					"number"
-				],
-				description: "Current value",
-				required: true
-			},
-			min: {
-				types: [
-					"number"
-				],
-				description: "Minimum value",
-				"default": 0
-			},
-			max: {
-				types: [
-					"number"
-				],
-				description: "Maximum value",
-				"default": 100
-			},
-			label: {
-				types: [
-					"string"
-				],
-				description: "Display label"
-			},
-			unit: {
-				types: [
-					"string"
-				],
-				description: "Unit suffix (e.g., '%', 'MB', 'credits')"
-			},
-			variant: {
-				types: [
-					"string"
-				],
-				description: "Display variant",
+				description: "Bucket granularity of a time axis — labels read \"Oct 2\", \"Week of Sep 28\", \"Oct 2026\", \"Q4 2026\" or \"2026\"",
 				enumValues: [
-					"linear",
-					"radial",
-					"segmented"
-				],
-				"default": "linear"
-			},
-			thresholds: {
-				types: [
-					"array"
-				],
-				description: "Color thresholds",
-				items: {
-					types: [
-						"object"
-					],
-					properties: {
-						value: {
-							types: [
-								"number"
-							]
-						},
-						color: {
-							types: [
-								"string"
-							]
-						},
-						label: {
-							types: [
-								"string"
-							]
-						}
-					},
-					required: [
-						"value",
-						"color"
-					]
-				}
-			},
-			segments: {
-				types: [
-					"number"
-				],
-				description: "Number of segments (for segmented variant)",
-				"default": 5
-			},
-			showValue: {
-				types: [
-					"boolean"
-				],
-				description: "Show value text",
-				"default": true
+					"day",
+					"week",
+					"month",
+					"quarter",
+					"year"
+				]
 			},
-			size: {
+			drillEvent: {
 				types: [
 					"string"
 				],
-				description: "Size (for radial variant)",
-				enumValues: [
-					"sm",
-					"md",
-					"lg"
-				],
-				"default": "md"
+				description: "Event name emitted as `UI:{drillEvent}` with `{ label, value, seriesLabel? }` on data-point click"
 			},
 			actions: {
 				types: [
 					"array"
 				],
-				description: "Actions",
+				description: "Top-level chart actions (export, refresh, etc.)",
+				kind: "event-list",
+				eventField: "event",
+				items: {
+					types: [
+						"object"
+					],
+					properties: {
+						label: {
+							types: [
+								"string"
+							]
+						},
+						event: {
+							types: [
+								"string"
+							],
+							kind: "event"
+						},
+						navigatesTo: {
+							types: [
+								"string"
+							]
+						},
+						variant: {
+							types: [
+								"string"
+							],
+							enumValues: [
+								"primary",
+								"secondary",
+								"ghost"
+							]
+						}
+					},
+					required: [
+						"label"
+					]
+				}
+			},
+			isLoading: {
+				types: [
+					"boolean"
+				],
+				description: "Loading state",
+				"default": false
+			},
+			error: {
+				types: [
+					"object"
+				],
+				description: "Error state",
+				properties: {
+					message: {
+						types: [
+							"string"
+						]
+					},
+					name: {
+						types: [
+							"string"
+						]
+					},
+					code: {
+						types: [
+							"string"
+						]
+					},
+					stack: {
+						types: [
+							"string"
+						]
+					}
+				},
+				propertyRequired: [
+					"message"
+				]
+			},
+			className: {
+				types: [
+					"string"
+				],
+				description: "Additional CSS classes"
+			}
+		}
+	},
+	meter: {
+		type: "meter",
+		category: "visualization",
+		sourceFile: "components/core/molecules/Meter.tsx",
+		tier: "molecules",
+		family: "core",
+		description: "Gauge/meter component for displaying a value within a range with thresholds",
+		suggestedFor: [
+			"dashboards",
+			"progress tracking",
+			"credit/quota displays",
+			"KPI indicators"
+		],
+		typicalSize: "small",
+		propsSchema: {
+			value: {
+				types: [
+					"number"
+				],
+				description: "Current value",
+				required: true
+			},
+			min: {
+				types: [
+					"number"
+				],
+				description: "Minimum value",
+				"default": 0
+			},
+			max: {
+				types: [
+					"number"
+				],
+				description: "Maximum value",
+				"default": 100
+			},
+			label: {
+				types: [
+					"string"
+				],
+				description: "Display label"
+			},
+			unit: {
+				types: [
+					"string"
+				],
+				description: "Unit suffix (e.g., '%', 'MB', 'credits')"
+			},
+			variant: {
+				types: [
+					"string"
+				],
+				description: "Display variant",
+				enumValues: [
+					"linear",
+					"radial",
+					"segmented"
+				],
+				"default": "linear"
+			},
+			thresholds: {
+				types: [
+					"array"
+				],
+				description: "Color thresholds",
+				items: {
+					types: [
+						"object"
+					],
+					properties: {
+						value: {
+							types: [
+								"number"
+							]
+						},
+						color: {
+							types: [
+								"string"
+							]
+						},
+						label: {
+							types: [
+								"string"
+							]
+						}
+					},
+					required: [
+						"value",
+						"color"
+					]
+				}
+			},
+			segments: {
+				types: [
+					"number"
+				],
+				description: "Number of segments (for segmented variant)",
+				"default": 5
+			},
+			showValue: {
+				types: [
+					"boolean"
+				],
+				description: "Show value text",
+				"default": true
+			},
+			size: {
+				types: [
+					"string"
+				],
+				description: "Size (for radial variant)",
+				enumValues: [
+					"sm",
+					"md",
+					"lg"
+				],
+				"default": "md"
+			},
+			actions: {
+				types: [
+					"array"
+				],
+				description: "Actions",
 				kind: "event-list",
 				eventField: "event",
 				items: {
@@ -17887,6 +17976,52 @@ var patterns = {
 					}
 				]
 			},
+			onTransitionClick: {
+				types: [
+					"function"
+				],
+				description: "Direct transition-click callback, for React hosts (e.g. a canvas node).",
+				kind: "callback",
+				callbackArgs: [
+					{
+						name: "transition",
+						type: "object",
+						schema: {
+							types: [
+								"object"
+							],
+							properties: {
+								index: {
+									types: [
+										"number"
+									]
+								},
+								event: {
+									types: [
+										"string"
+									]
+								},
+								from: {
+									types: [
+										"string"
+									]
+								},
+								to: {
+									types: [
+										"string"
+									]
+								}
+							},
+							required: [
+								"index",
+								"event",
+								"from",
+								"to"
+							]
+						}
+					}
+				]
+			},
 			selectedState: {
 				types: [
 					"string"
@@ -19172,6 +19307,7 @@ var patterns = {
 		description: "DataGrid — structured records grid rendering rows over configurable columns, with sort, select, and drag-reorder.",
 		capabilities: "admin table, records grid, user list, CRUD list, manage-records view, spreadsheet-style data grid, sortable columns",
 		fieldsContract: "display",
+		minUsableWidth: 200,
 		suggestedFor: [
 			"data",
 			"grid",
@@ -19227,6 +19363,47 @@ var patterns = {
 				],
 				description: "Mark this container as the DnD root for its subtree — descendant zones share one DndContext (cross-container drag). Use on an outer container whose own items are not draggable."
 			},
+			emptyIcon: {
+				types: [
+					"icon",
+					"string"
+				],
+				description: "Domain icon for the empty state."
+			},
+			emptyTitle: {
+				types: [
+					"string"
+				],
+				description: "Specific title (\"No orders yet\")."
+			},
+			emptyDescription: {
+				types: [
+					"string"
+				],
+				description: "What will appear here once rows exist."
+			},
+			emptyAction: {
+				types: [
+					"object"
+				],
+				description: "Create-the-first-item action.",
+				properties: {
+					label: {
+						types: [
+							"string"
+						]
+					},
+					event: {
+						types: [
+							"string"
+						],
+						kind: "event"
+					}
+				},
+				propertyRequired: [
+					"label"
+				]
+			},
 			entity: {
 				types: [
 					"object",
@@ -19417,6 +19594,12 @@ var patterns = {
 								"ghost",
 								"danger"
 							]
+						},
+						when: {
+							types: [
+								"sexpr",
+								"function"
+							]
 						}
 					},
 					required: [
@@ -19680,6 +19863,7 @@ var patterns = {
 		family: "core",
 		description: "DataList component",
 		fieldsContract: "display",
+		minUsableWidth: 200,
 		suggestedFor: [
 			"data",
 			"list",
@@ -19736,6 +19920,47 @@ var patterns = {
 				],
 				description: "Mark this container as the DnD root for its subtree — descendant zones share one DndContext (cross-container drag). Use on an outer container whose own items are not draggable."
 			},
+			emptyIcon: {
+				types: [
+					"icon",
+					"string"
+				],
+				description: "Domain icon for the empty state."
+			},
+			emptyTitle: {
+				types: [
+					"string"
+				],
+				description: "Specific title (\"No orders yet\")."
+			},
+			emptyDescription: {
+				types: [
+					"string"
+				],
+				description: "What will appear here once rows exist."
+			},
+			emptyAction: {
+				types: [
+					"object"
+				],
+				description: "Create-the-first-item action.",
+				properties: {
+					label: {
+						types: [
+							"string"
+						]
+					},
+					event: {
+						types: [
+							"string"
+						],
+						kind: "event"
+					}
+				},
+				propertyRequired: [
+					"label"
+				]
+			},
 			entity: {
 				types: [
 					"object",
@@ -19901,6 +20126,12 @@ var patterns = {
 								"ghost",
 								"danger"
 							]
+						},
+						when: {
+							types: [
+								"sexpr",
+								"function"
+							]
 						}
 					},
 					required: [
@@ -21930,15 +22161,19 @@ var patterns = {
 							],
 							eventPayloadBrand: true,
 							payloadFor: "event"
+						},
+						when: {
+							types: [
+								"sexpr",
+								"function"
+							]
 						}
 					},
 					required: [
 						"label",
 						"event"
 					]
-				},
-				"default": [
-				]
+				}
 			},
 			rightActions: {
 				types: [
@@ -21986,15 +22221,19 @@ var patterns = {
 							],
 							eventPayloadBrand: true,
 							payloadFor: "event"
+						},
+						when: {
+							types: [
+								"sexpr",
+								"function"
+							]
 						}
 					},
 					required: [
 						"label",
 						"event"
 					]
-				},
-				"default": [
-				]
+				}
 			},
 			threshold: {
 				types: [
@@ -23031,6 +23270,12 @@ var patterns = {
 				propertyRequired: [
 					"enabled"
 				]
+			},
+			pageKey: {
+				types: [
+					"string"
+				],
+				description: "The current page (path or name). When set, the main slot's content animates in on every page change (`PageTransition`); a layout's own content region claims the transition so its chrome stays still."
 			}
 		}
 	},
@@ -33570,6 +33815,7 @@ var patterns = {
 		description: "TableView — sortable, selectable data table rendering rows over configurable columns, with inline row actions and grouping.",
 		capabilities: "admin console table, records list, CRUD data table, user list, manage-users grid, sortable columns, row selection with bulk actions, grouped list view",
 		fieldsContract: "display",
+		minUsableWidth: 240,
 		suggestedFor: [
 			"table",
 			"view",
@@ -33625,6 +33871,47 @@ var patterns = {
 				],
 				description: "Mark this container as the DnD root for its subtree — descendant zones share one DndContext (cross-container drag). Use on an outer container whose own items are not draggable."
 			},
+			emptyIcon: {
+				types: [
+					"icon",
+					"string"
+				],
+				description: "Domain icon for the empty state."
+			},
+			emptyTitle: {
+				types: [
+					"string"
+				],
+				description: "Specific title (\"No orders yet\")."
+			},
+			emptyDescription: {
+				types: [
+					"string"
+				],
+				description: "What will appear here once rows exist."
+			},
+			emptyAction: {
+				types: [
+					"object"
+				],
+				description: "Create-the-first-item action.",
+				properties: {
+					label: {
+						types: [
+							"string"
+						]
+					},
+					event: {
+						types: [
+							"string"
+						],
+						kind: "event"
+					}
+				},
+				propertyRequired: [
+					"label"
+				]
+			},
 			entity: {
 				types: [
 					"object",
@@ -33854,6 +34141,12 @@ var patterns = {
 								"ghost",
 								"danger"
 							]
+						},
+						when: {
+							types: [
+								"sexpr",
+								"function"
+							]
 						}
 					},
 					required: [
@@ -46982,6 +47275,38 @@ var patterns = {
 		],
 		typicalSize: "small",
 		propsSchema: {
+			animation: {
+				types: [
+					"string"
+				],
+				description: "Which motion preset to use (maps to `animate-<name>-in/out`).",
+				required: true,
+				enumValues: [
+					"modal",
+					"overlay",
+					"slide-up",
+					"drawer",
+					"popover",
+					"toast",
+					"fade",
+					"page"
+				]
+			},
+			animate: {
+				types: [
+					"boolean"
+				],
+				description: "Per-instance opt-out. Global opt-out is `--motion-enable` / reduced-motion. @default true"
+			},
+			onExited: {
+				types: [
+					"function"
+				],
+				description: "Fired after the exit animation completes (before unmount).",
+				kind: "callback",
+				callbackArgs: [
+				]
+			},
 			show: {
 				types: [
 					"boolean"
@@ -47022,7 +47347,7 @@ var patterns = {
 				types: [
 					"string"
 				],
-				description: "Value that changes on navigation (e.g. `location.pathname`).",
+				description: "Value that changes on navigation (a page path).",
 				required: true
 			},
 			children: {
@@ -50565,9 +50890,10 @@ var patterns = {
 			},
 			children: {
 				types: [
-					"node"
+					"node",
+					"function"
 				],
-				description: "Compiled mode: render children directly instead of resolving from context"
+				description: "Compiled mode: render children directly instead of resolving from context. A function receives the slot's presence — compiled self-overlaying content (Modal / ConfirmDialog) takes it as `isOpen`/`onExited` to play its exit."
 			},
 			pattern: {
 				types: [
@@ -51819,14 +52145,15 @@ var patterns = {
 				types: [
 					"string"
 				],
-				description: "What made this version (a user save, an agent turn, a restore, an undo/redo, a snapshot).",
+				description: "What made this version (a user save, an agent turn, a restore, an undo/redo, a snapshot, a merge of a teammate's work).",
 				enumValues: [
 					"user",
 					"agent",
 					"restore",
 					"undo",
 					"redo",
-					"snapshot"
+					"snapshot",
+					"merge"
 				]
 			},
 			additions: {
@@ -52259,6 +52586,52 @@ var patterns = {
 					}
 				]
 			},
+			onTransitionClick: {
+				types: [
+					"function"
+				],
+				description: "Direct transition-click callback, for React hosts (e.g. a canvas node).",
+				kind: "callback",
+				callbackArgs: [
+					{
+						name: "transition",
+						type: "object",
+						schema: {
+							types: [
+								"object"
+							],
+							properties: {
+								index: {
+									types: [
+										"number"
+									]
+								},
+								event: {
+									types: [
+										"string"
+									]
+								},
+								from: {
+									types: [
+										"string"
+									]
+								},
+								to: {
+									types: [
+										"string"
+									]
+								}
+							},
+							required: [
+								"index",
+								"event",
+								"from",
+								"to"
+							]
+						}
+					}
+				]
+			},
 			selectedState: {
 				types: [
 					"string"
@@ -56470,7 +56843,7 @@ var integratorsRegistry = {
 };
 
 var version$1 = "1.0.0";
-var exportedAt$1 = "2026-09-28T12:49:04.761Z";
+var exportedAt$1 = "2026-09-30T15:57:56.420Z";
 var mappings = {
 	"page-header": {
 		component: "PageHeader",
@@ -57782,7 +58155,7 @@ var componentMapping = {
 };
 
 var version = "1.0.0";
-var exportedAt = "2026-09-28T12:49:04.761Z";
+var exportedAt = "2026-09-30T15:57:56.420Z";
 var contracts = {
 	form: {
 		emits: [
@@ -59749,6 +60122,9 @@ declare const registry: {
                             onClick: {
                                 types: string[];
                             };
+                            when: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
@@ -59821,6 +60197,9 @@ declare const registry: {
                                 types: string[];
                                 kind: string;
                             };
+                            when: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
@@ -60017,6 +60396,9 @@ declare const registry: {
                             onClick: {
                                 types: string[];
                             };
+                            when: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
@@ -60323,6 +60705,9 @@ declare const registry: {
                             variant: {
                                 types: string[];
                             };
+                            when: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
@@ -60528,6 +60913,9 @@ declare const registry: {
                                 types: string[];
                                 enumValues: string[];
                             };
+                            when: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
@@ -60561,6 +60949,9 @@ declare const registry: {
                             types: string[];
                             enumValues: string[];
                         };
+                        when: {
+                            types: string[];
+                        };
                     };
                     propertyRequired: string[];
                 };
@@ -60691,6 +61082,10 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                icon: {
+                    types: string[];
+                    description: string;
+                };
                 subtitle: {
                     types: string[];
                     description: string;
@@ -61951,6 +62346,7 @@ declare const registry: {
             tier: string;
             family: string;
             description: string;
+            minUsableWidth: number;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -63500,6 +63896,11 @@ declare const registry: {
                     enumValues: string[];
                     default: string;
                 };
+                contained: {
+                    types: string[];
+                    description: string;
+                    default: boolean;
+                };
             };
         };
         drawer: {
@@ -63517,6 +63918,17 @@ declare const registry: {
                     description: string;
                     default: boolean;
                 };
+                onExited: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    callbackArgs: never[];
+                };
+                contained: {
+                    types: string[];
+                    description: string;
+                    default: boolean;
+                };
                 onClose: {
                     types: string[];
                     description: string;
@@ -63594,6 +64006,12 @@ declare const registry: {
                     kind: string;
                     callbackArgs: never[];
                 };
+                onExited: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    callbackArgs: never[];
+                };
                 onConfirm: {
                     types: string[];
                     description: string;
@@ -68441,6 +68859,11 @@ declare const registry: {
                     description: string;
                     default: boolean;
                 };
+                period: {
+                    types: string[];
+                    description: string;
+                    enumValues: string[];
+                };
                 drillEvent: {
                     types: string[];
                     description: string;
@@ -70395,6 +70818,33 @@ declare const registry: {
                         required: boolean;
                     }[];
                 };
+                onTransitionClick: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    callbackArgs: {
+                        name: string;
+                        type: string;
+                        schema: {
+                            types: string[];
+                            properties: {
+                                index: {
+                                    types: string[];
+                                };
+                                event: {
+                                    types: string[];
+                                };
+                                from: {
+                                    types: string[];
+                                };
+                                to: {
+                                    types: string[];
+                                };
+                            };
+                            required: string[];
+                        };
+                    }[];
+                };
                 selectedState: {
                     types: string[];
                     description: string;
@@ -71227,6 +71677,7 @@ declare const registry: {
             description: string;
             capabilities: string;
             fieldsContract: string;
+            minUsableWidth: number;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -71262,6 +71713,32 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                emptyIcon: {
+                    types: string[];
+                    description: string;
+                };
+                emptyTitle: {
+                    types: string[];
+                    description: string;
+                };
+                emptyDescription: {
+                    types: string[];
+                    description: string;
+                };
+                emptyAction: {
+                    types: string[];
+                    description: string;
+                    properties: {
+                        label: {
+                            types: string[];
+                        };
+                        event: {
+                            types: string[];
+                            kind: string;
+                        };
+                    };
+                    propertyRequired: string[];
+                };
                 entity: {
                     types: string[];
                     description: string;
@@ -71360,6 +71837,9 @@ declare const registry: {
                                 types: string[];
                                 enumValues: string[];
                             };
+                            when: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
@@ -71520,6 +72000,7 @@ declare const registry: {
             family: string;
             description: string;
             fieldsContract: string;
+            minUsableWidth: number;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -71556,6 +72037,32 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                emptyIcon: {
+                    types: string[];
+                    description: string;
+                };
+                emptyTitle: {
+                    types: string[];
+                    description: string;
+                };
+                emptyDescription: {
+                    types: string[];
+                    description: string;
+                };
+                emptyAction: {
+                    types: string[];
+                    description: string;
+                    properties: {
+                        label: {
+                            types: string[];
+                        };
+                        event: {
+                            types: string[];
+                            kind: string;
+                        };
+                    };
+                    propertyRequired: string[];
+                };
                 entity: {
                     types: string[];
                     description: string;
@@ -71639,6 +72146,9 @@ declare const registry: {
                                 types: string[];
                                 enumValues: string[];
                             };
+                            when: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
@@ -72942,10 +73452,12 @@ declare const registry: {
                                 eventPayloadBrand: boolean;
                                 payloadFor: string;
                             };
+                            when: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
-                    default: never[];
                 };
                 rightActions: {
                     types: string[];
@@ -72974,10 +73486,12 @@ declare const registry: {
                                 eventPayloadBrand: boolean;
                                 payloadFor: string;
                             };
+                            when: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
-                    default: never[];
                 };
                 threshold: {
                     types: string[];
@@ -73622,6 +74136,10 @@ declare const registry: {
                     };
                     propertyRequired: string[];
                 };
+                pageKey: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         "trait-frame": {
@@ -79805,6 +80323,7 @@ declare const registry: {
             description: string;
             capabilities: string;
             fieldsContract: string;
+            minUsableWidth: number;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -79840,6 +80359,32 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                emptyIcon: {
+                    types: string[];
+                    description: string;
+                };
+                emptyTitle: {
+                    types: string[];
+                    description: string;
+                };
+                emptyDescription: {
+                    types: string[];
+                    description: string;
+                };
+                emptyAction: {
+                    types: string[];
+                    description: string;
+                    properties: {
+                        label: {
+                            types: string[];
+                        };
+                        event: {
+                            types: string[];
+                            kind: string;
+                        };
+                    };
+                    propertyRequired: string[];
+                };
                 entity: {
                     types: string[];
                     description: string;
@@ -79961,6 +80506,9 @@ declare const registry: {
                                 types: string[];
                                 enumValues: string[];
                             };
+                            when: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
@@ -87702,6 +88250,22 @@ declare const registry: {
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
+                animation: {
+                    types: string[];
+                    description: string;
+                    required: boolean;
+                    enumValues: string[];
+                };
+                animate: {
+                    types: string[];
+                    description: string;
+                };
+                onExited: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    callbackArgs: never[];
+                };
                 show: {
                     types: string[];
                     description: string;
@@ -90856,6 +91420,33 @@ declare const registry: {
                         required: boolean;
                     }[];
                 };
+                onTransitionClick: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    callbackArgs: {
+                        name: string;
+                        type: string;
+                        schema: {
+                            types: string[];
+                            properties: {
+                                index: {
+                                    types: string[];
+                                };
+                                event: {
+                                    types: string[];
+                                };
+                                from: {
+                                    types: string[];
+                                };
+                                to: {
+                                    types: string[];
+                                };
+                            };
+                            required: string[];
+                        };
+                    }[];
+                };
                 selectedState: {
                     types: string[];
                     description: string;
@@ -91133,6 +91724,9 @@ declare const PATTERN_REGISTRY: {
                             onClick: {
                                 types: string[];
                             };
+                            when: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
@@ -91205,6 +91799,9 @@ declare const PATTERN_REGISTRY: {
                                 types: string[];
                                 kind: string;
                             };
+                            when: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
@@ -91401,6 +91998,9 @@ declare const PATTERN_REGISTRY: {
                             onClick: {
                                 types: string[];
                             };
+                            when: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
@@ -91707,6 +92307,9 @@ declare const PATTERN_REGISTRY: {
                             variant: {
                                 types: string[];
                             };
+                            when: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
@@ -91912,6 +92515,9 @@ declare const PATTERN_REGISTRY: {
                                 types: string[];
                                 enumValues: string[];
                             };
+                            when: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
@@ -91945,6 +92551,9 @@ declare const PATTERN_REGISTRY: {
                             types: string[];
                             enumValues: string[];
                         };
+                        when: {
+                            types: string[];
+                        };
                     };
                     propertyRequired: string[];
                 };
@@ -92075,6 +92684,10 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                icon: {
+                    types: string[];
+                    description: string;
+                };
                 subtitle: {
                     types: string[];
                     description: string;
@@ -93335,6 +93948,7 @@ declare const PATTERN_REGISTRY: {
             tier: string;
             family: string;
             description: string;
+            minUsableWidth: number;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -94884,6 +95498,11 @@ declare const PATTERN_REGISTRY: {
                     enumValues: string[];
                     default: string;
                 };
+                contained: {
+                    types: string[];
+                    description: string;
+                    default: boolean;
+                };
             };
         };
         drawer: {
@@ -94901,6 +95520,17 @@ declare const PATTERN_REGISTRY: {
                     description: string;
                     default: boolean;
                 };
+                onExited: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    callbackArgs: never[];
+                };
+                contained: {
+                    types: string[];
+                    description: string;
+                    default: boolean;
+                };
                 onClose: {
                     types: string[];
                     description: string;
@@ -94978,6 +95608,12 @@ declare const PATTERN_REGISTRY: {
                     kind: string;
                     callbackArgs: never[];
                 };
+                onExited: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    callbackArgs: never[];
+                };
                 onConfirm: {
                     types: string[];
                     description: string;
@@ -99825,6 +100461,11 @@ declare const PATTERN_REGISTRY: {
                     description: string;
                     default: boolean;
                 };
+                period: {
+                    types: string[];
+                    description: string;
+                    enumValues: string[];
+                };
                 drillEvent: {
                     types: string[];
                     description: string;
@@ -101779,6 +102420,33 @@ declare const PATTERN_REGISTRY: {
                         required: boolean;
                     }[];
                 };
+                onTransitionClick: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    callbackArgs: {
+                        name: string;
+                        type: string;
+                        schema: {
+                            types: string[];
+                            properties: {
+                                index: {
+                                    types: string[];
+                                };
+                                event: {
+                                    types: string[];
+                                };
+                                from: {
+                                    types: string[];
+                                };
+                                to: {
+                                    types: string[];
+                                };
+                            };
+                            required: string[];
+                        };
+                    }[];
+                };
                 selectedState: {
                     types: string[];
                     description: string;
@@ -102611,6 +103279,7 @@ declare const PATTERN_REGISTRY: {
             description: string;
             capabilities: string;
             fieldsContract: string;
+            minUsableWidth: number;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -102646,6 +103315,32 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                emptyIcon: {
+                    types: string[];
+                    description: string;
+                };
+                emptyTitle: {
+                    types: string[];
+                    description: string;
+                };
+                emptyDescription: {
+                    types: string[];
+                    description: string;
+                };
+                emptyAction: {
+                    types: string[];
+                    description: string;
+                    properties: {
+                        label: {
+                            types: string[];
+                        };
+                        event: {
+                            types: string[];
+                            kind: string;
+                        };
+                    };
+                    propertyRequired: string[];
+                };
                 entity: {
                     types: string[];
                     description: string;
@@ -102744,6 +103439,9 @@ declare const PATTERN_REGISTRY: {
                                 types: string[];
                                 enumValues: string[];
                             };
+                            when: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
@@ -102904,6 +103602,7 @@ declare const PATTERN_REGISTRY: {
             family: string;
             description: string;
             fieldsContract: string;
+            minUsableWidth: number;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -102940,6 +103639,32 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                emptyIcon: {
+                    types: string[];
+                    description: string;
+                };
+                emptyTitle: {
+                    types: string[];
+                    description: string;
+                };
+                emptyDescription: {
+                    types: string[];
+                    description: string;
+                };
+                emptyAction: {
+                    types: string[];
+                    description: string;
+                    properties: {
+                        label: {
+                            types: string[];
+                        };
+                        event: {
+                            types: string[];
+                            kind: string;
+                        };
+                    };
+                    propertyRequired: string[];
+                };
                 entity: {
                     types: string[];
                     description: string;
@@ -103023,6 +103748,9 @@ declare const PATTERN_REGISTRY: {
                                 types: string[];
                                 enumValues: string[];
                             };
+                            when: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
@@ -104326,10 +105054,12 @@ declare const PATTERN_REGISTRY: {
                                 eventPayloadBrand: boolean;
                                 payloadFor: string;
                             };
+                            when: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
-                    default: never[];
                 };
                 rightActions: {
                     types: string[];
@@ -104358,10 +105088,12 @@ declare const PATTERN_REGISTRY: {
                                 eventPayloadBrand: boolean;
                                 payloadFor: string;
                             };
+                            when: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
-                    default: never[];
                 };
                 threshold: {
                     types: string[];
@@ -105006,6 +105738,10 @@ declare const PATTERN_REGISTRY: {
                     };
                     propertyRequired: string[];
                 };
+                pageKey: {
+                    types: string[];
+                    description: string;
+                };
             };
         };
         "trait-frame": {
@@ -111189,6 +111925,7 @@ declare const PATTERN_REGISTRY: {
             description: string;
             capabilities: string;
             fieldsContract: string;
+            minUsableWidth: number;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -111224,6 +111961,32 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                emptyIcon: {
+                    types: string[];
+                    description: string;
+                };
+                emptyTitle: {
+                    types: string[];
+                    description: string;
+                };
+                emptyDescription: {
+                    types: string[];
+                    description: string;
+                };
+                emptyAction: {
+                    types: string[];
+                    description: string;
+                    properties: {
+                        label: {
+                            types: string[];
+                        };
+                        event: {
+                            types: string[];
+                            kind: string;
+                        };
+                    };
+                    propertyRequired: string[];
+                };
                 entity: {
                     types: string[];
                     description: string;
@@ -111345,6 +112108,9 @@ declare const PATTERN_REGISTRY: {
                                 types: string[];
                                 enumValues: string[];
                             };
+                            when: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
@@ -119086,6 +119852,22 @@ declare const PATTERN_REGISTRY: {
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
+                animation: {
+                    types: string[];
+                    description: string;
+                    required: boolean;
+                    enumValues: string[];
+                };
+                animate: {
+                    types: string[];
+                    description: string;
+                };
+                onExited: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    callbackArgs: never[];
+                };
                 show: {
                     types: string[];
                     description: string;
@@ -122240,6 +123022,33 @@ declare const PATTERN_REGISTRY: {
                         required: boolean;
                     }[];
                 };
+                onTransitionClick: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    callbackArgs: {
+                        name: string;
+                        type: string;
+                        schema: {
+                            types: string[];
+                            properties: {
+                                index: {
+                                    types: string[];
+                                };
+                                event: {
+                                    types: string[];
+                                };
+                                from: {
+                                    types: string[];
+                                };
+                                to: {
+                                    types: string[];
+                                };
+                            };
+                            required: string[];
+                        };
+                    }[];
+                };
                 selectedState: {
                     types: string[];
                     description: string;
@@ -127849,6 +128658,9 @@ type PatternEntry = {
      *  ({key, header} + typed meta). THE capability every enrichment consumer
      *  keys on — never a hardcoded pattern-name list. */
     fieldsContract?: 'form' | 'display';
+    /** Narrowest rendered width (px) the component stays usable at, from its
+     *  `@minWidth` JSDoc tag. The layout check reports narrower instances. */
+    minUsableWidth?: number;
 };
 declare function getPatternDefinition(patternType: string): PatternEntry | null;
 declare function getComponentForPattern(patternType: string): string | null;
@@ -127921,6 +128733,8 @@ declare function eventListPropsOf(patternType: string): ReadonlyMap<string, stri
  * baked registry) — all key on THIS declaration, never on pattern names.
  */
 declare function getPatternFieldsContract(patternType: string): 'form' | 'display' | undefined;
+/** Every pattern's declared `minUsableWidth` (`@minWidth` on the component). */
+declare function getPatternMinUsableWidths(): Map<string, number>;
 declare function isDrawablePattern(patternType: string): boolean;
 /**
  * Check if a pattern is a canvas DRAW-HOST — a component that paints authored
@@ -127939,4 +128753,4 @@ declare function isDrawablePattern(patternType: string): boolean;
  */
 declare function isDrawHostPattern(patternType: string): boolean;
 
-export { AnyPatternConfig, COMPONENT_MAPPING, EVENT_CONTRACTS, type EmojiPickPayload, type FormSubmitPayload, INTEGRATORS_REGISTRY, type ItemActionPayload, type LoadMoreRequestPayload, PATTERN_REGISTRY, PROP_KINDS, type PatternCallbackArg, type PatternEntry, type PatternPayloadField, type PatternPropDef, type PatternPropTypeSchema, type PatternRecommendation, type PatternSwapGate, PatternType, type PropKind, type RecommendationContext, type RenderUiEntry, type RenderUiPayload, SELF_OVERLAY_PATTERN_TYPES, type SelectionChangePayload, buildRecommendationContext, collectRenderUiPatternTypes, componentMapping, eventContracts, eventKeyPropsOf, eventListPropsOf, findCompatiblePatterns, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getEmittedEvents, getEntityCardinality, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternFieldsContract, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integratorsRegistry, isContentBodyPattern, isContentBodyPatternType, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isMainSlotRenderUi, isValueInputPattern, patternsRegistry, recommendPatterns, registry, renderUiEntriesOf, renderUiPatternTypesOf };
+export { AnyPatternConfig, COMPONENT_MAPPING, EVENT_CONTRACTS, type EmojiPickPayload, type FormSubmitPayload, INTEGRATORS_REGISTRY, type ItemActionPayload, type LoadMoreRequestPayload, PATTERN_REGISTRY, PROP_KINDS, type PatternCallbackArg, type PatternEntry, type PatternPayloadField, type PatternPropDef, type PatternPropTypeSchema, type PatternRecommendation, type PatternSwapGate, PatternType, type PropKind, type RecommendationContext, type RenderUiEntry, type RenderUiPayload, SELF_OVERLAY_PATTERN_TYPES, type SelectionChangePayload, buildRecommendationContext, collectRenderUiPatternTypes, componentMapping, eventContracts, eventKeyPropsOf, eventListPropsOf, findCompatiblePatterns, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getEmittedEvents, getEntityCardinality, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternFieldsContract, getPatternMetadata, getPatternMinUsableWidths, getPatternPropsCompact, getPatternsGroupedByCategory, integratorsRegistry, isContentBodyPattern, isContentBodyPatternType, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isMainSlotRenderUi, isValueInputPattern, patternsRegistry, recommendPatterns, registry, renderUiEntriesOf, renderUiPatternTypesOf };