@almadar/core 10.61.0 → 10.63.0

package/dist/patterns/index.d.ts

@@ -1,10 +1,10 @@
-import { A as AnyPatternConfig, h as RenderBinding, F as FieldValue, aY as PatternType } from '../effect-a1W_hXyG.js';
-export { aR as PATTERN_TYPES, aV as PatternConfig, aW as PatternProps, aX as PatternPropsMap, cO as isValidPatternType } from '../effect-a1W_hXyG.js';
+import { A as AnyPatternConfig, h as RenderBinding, F as FieldValue, a_ as PatternType } from '../effect-CgDrWfKW.js';
+export { aT as PATTERN_TYPES, aX as PatternConfig, aY as PatternProps, aZ as PatternPropsMap, cR as isValidPatternType } from '../effect-CgDrWfKW.js';
 import { d as EventPayloadValue, a as EventPayload, J as JsonValue } from '../expression-Fk8bQWef.js';
 import 'zod';
 
 var version$3 = "1.0.0";
-var exportedAt$3 = "2026-08-19T03:03:56.666Z";
+var exportedAt$3 = "2026-08-20T23:14:19.545Z";
 var patterns = {
 	"entity-table": {
 		type: "entity-table",
@@ -1242,6 +1242,7 @@ var patterns = {
 		tier: "organisms",
 		family: "core",
 		description: "Detail view panel for drawers/sidebars",
+		fieldsContract: "display",
 		suggestedFor: [
 			"drawer content",
 			"side panels",
@@ -1523,6 +1524,54 @@ var patterns = {
 					]
 				}
 			},
+			backAction: {
+				types: [
+					"object"
+				],
+				description: "Navigation-back affordance. Renders top-LEFT before the title (OS/back convention — Almadar_UX §8.4), spatially separated from the right-aligned action buttons + close X. Never inferred from actions[] labels.",
+				properties: {
+					label: {
+						types: [
+							"string"
+						]
+					},
+					icon: {
+						types: [
+							"icon",
+							"string"
+						]
+					},
+					onClick: {
+						types: [
+							"function"
+						]
+					},
+					event: {
+						types: [
+							"string"
+						]
+					},
+					navigatesTo: {
+						types: [
+							"string"
+						]
+					},
+					variant: {
+						types: [
+							"string"
+						],
+						enumValues: [
+							"primary",
+							"secondary",
+							"ghost",
+							"danger"
+						]
+					}
+				},
+				propertyRequired: [
+					"label"
+				]
+			},
 			footer: {
 				types: [
 					"node"
@@ -1557,6 +1606,26 @@ var patterns = {
 							types: [
 								"string"
 							]
+						},
+						type: {
+							types: [
+								"string"
+							]
+						},
+						values: {
+							types: [
+								"array"
+							],
+							items: {
+								types: [
+									"string"
+								]
+							}
+						},
+						relation: {
+							types: [
+								"string"
+							]
 						}
 					},
 					required: [
@@ -1621,6 +1690,48 @@ var patterns = {
 					"boolean"
 				],
 				description: "Show actions flag"
+			},
+			relationsData: {
+				types: [
+					"object"
+				],
+				description: "Relation display data: { fieldName: [{value, label}] } — injected server-side by the runtime (relation-option injection) or bound by compiled codegen; resolves stored foreign ids to display names.",
+				mapValue: {
+					types: [
+						"array"
+					],
+					items: {
+						types: [
+							"object"
+						],
+						properties: {
+							value: {
+								types: [
+									"string"
+								]
+							},
+							label: {
+								types: [
+									"string"
+								]
+							},
+							description: {
+								types: [
+									"string"
+								]
+							},
+							disabled: {
+								types: [
+									"boolean"
+								]
+							}
+						},
+						required: [
+							"value",
+							"label"
+						]
+					}
+				}
 			}
 		}
 	},
@@ -1696,9 +1807,10 @@ var patterns = {
 			},
 			status: {
 				types: [
-					"object"
+					"object",
+					"string"
 				],
-				description: "Status badge",
+				description: "Status badge — a bare string (an entity's status field bound directly, e.g. `status: @entity.status`) renders as a default-variant badge",
 				properties: {
 					label: {
 						types: [
@@ -1893,6 +2005,7 @@ var patterns = {
 		tier: "organisms",
 		family: "core",
 		description: "Complete form with fields and actions",
+		fieldsContract: "form",
 		suggestedFor: [
 			"create forms",
 			"edit forms",
@@ -2125,6 +2238,11 @@ var patterns = {
 							types: [
 								"boolean"
 							]
+						},
+						hint: {
+							types: [
+								"string"
+							]
 						}
 					}
 				}
@@ -2279,6 +2397,42 @@ var patterns = {
 				"default": {
 				}
 			},
+			fieldOverrides: {
+				types: [
+					"array"
+				],
+				description: "Per-field display-copy overrides (label/placeholder/hint), merged by field name over the schema-enriched fields.",
+				items: {
+					types: [
+						"object"
+					],
+					properties: {
+						name: {
+							types: [
+								"string"
+							]
+						},
+						label: {
+							types: [
+								"string"
+							]
+						},
+						placeholder: {
+							types: [
+								"string"
+							]
+						},
+						hint: {
+							types: [
+								"string"
+							]
+						}
+					},
+					required: [
+						"name"
+					]
+				}
+			},
 			conditionalFields: {
 				types: [
 					"object",
@@ -2405,7 +2559,12 @@ var patterns = {
 					formValues: {
 						types: [
 							"object"
-						]
+						],
+						mapValue: {
+							types: [
+								"object"
+							]
+						}
 					},
 					globalVariables: {
 						types: [
@@ -2432,7 +2591,12 @@ var patterns = {
 					entity: {
 						types: [
 							"object"
-						]
+						],
+						mapValue: {
+							types: [
+								"object"
+							]
+						}
 					}
 				},
 				propertyRequired: [
@@ -2621,6 +2785,11 @@ var patterns = {
 										types: [
 											"boolean"
 										]
+									},
+									hint: {
+										types: [
+											"string"
+										]
 									}
 								}
 							}
@@ -2705,6 +2874,7 @@ var patterns = {
 		tier: "organisms",
 		family: "core",
 		description: "Alias for form — Complete form with fields and actions",
+		fieldsContract: "form",
 		suggestedFor: [
 			"create forms",
 			"edit forms",
@@ -2937,6 +3107,11 @@ var patterns = {
 							types: [
 								"boolean"
 							]
+						},
+						hint: {
+							types: [
+								"string"
+							]
 						}
 					}
 				}
@@ -3091,6 +3266,42 @@ var patterns = {
 				"default": {
 				}
 			},
+			fieldOverrides: {
+				types: [
+					"array"
+				],
+				description: "Per-field display-copy overrides (label/placeholder/hint), merged by field name over the schema-enriched fields.",
+				items: {
+					types: [
+						"object"
+					],
+					properties: {
+						name: {
+							types: [
+								"string"
+							]
+						},
+						label: {
+							types: [
+								"string"
+							]
+						},
+						placeholder: {
+							types: [
+								"string"
+							]
+						},
+						hint: {
+							types: [
+								"string"
+							]
+						}
+					},
+					required: [
+						"name"
+					]
+				}
+			},
 			conditionalFields: {
 				types: [
 					"object",
@@ -3217,7 +3428,12 @@ var patterns = {
 					formValues: {
 						types: [
 							"object"
-						]
+						],
+						mapValue: {
+							types: [
+								"object"
+							]
+						}
 					},
 					globalVariables: {
 						types: [
@@ -3244,7 +3460,12 @@ var patterns = {
 					entity: {
 						types: [
 							"object"
-						]
+						],
+						mapValue: {
+							types: [
+								"object"
+							]
+						}
 					}
 				},
 				propertyRequired: [
@@ -3433,6 +3654,11 @@ var patterns = {
 										types: [
 											"boolean"
 										]
+									},
+									hint: {
+										types: [
+											"string"
+										]
 									}
 								}
 							}
@@ -12870,7 +13096,7 @@ var patterns = {
 				types: [
 					"object"
 				],
-				description: "Current user info (optional - auto-populated from auth context if not provided)",
+				description: "Current user info (optional - auto-populated from auth context if not provided). Accepts `null` as well as `undefined`: the `.lolo` substrate's signed-out spelling is `(if @config.viewerName {…} null)`, and the compiled path passes that `null` through verbatim.",
 				properties: {
 					name: {
 						types: [
@@ -12889,8 +13115,7 @@ var patterns = {
 					}
 				},
 				propertyRequired: [
-					"name",
-					"email"
+					"name"
 				]
 			},
 			headerActions: {
@@ -40159,6 +40384,28 @@ var patterns = {
 					}
 				]
 			},
+			keyMap: {
+				types: [
+					"object"
+				],
+				description: "Maps a keydown `e.code` → the board's SEMANTIC event (device-agnostic input), emitted as `UI:{event}` — same contract as the game canvas keyMap.",
+				mapValue: {
+					types: [
+						"string"
+					]
+				}
+			},
+			keyUpMap: {
+				types: [
+					"object"
+				],
+				description: "Maps a keyup `e.code` → the board's SEMANTIC event.",
+				mapValue: {
+					types: [
+						"string"
+					]
+				}
+			},
 			isLoading: {
 				types: [
 					"boolean"
@@ -46899,6 +47146,566 @@ var patterns = {
 				]
 			}
 		}
+	},
+	"fx-overlay": {
+		type: "fx-overlay",
+		category: "container",
+		tier: "molecules",
+		family: "core",
+		description: "FxOverlay component",
+		suggestedFor: [
+			"overlay",
+			"fx overlay"
+		],
+		typicalSize: "medium",
+		propsSchema: {
+			items: {
+				types: [
+					"array"
+				],
+				description: "Live screen-space fx entries (the mechanic's fx list filtered to `space == \"screen\"`); mount starts each item's animation, ttl decay unmounts it.",
+				required: true,
+				items: {
+					types: [
+						"object"
+					],
+					properties: {
+						id: {
+							types: [
+								"string"
+							]
+						},
+						type: {
+							types: [
+								"string"
+							]
+						},
+						effect: {
+							types: [
+								"string"
+							],
+							enumValues: [
+								"confetti",
+								"flash",
+								"shake",
+								"sparkle",
+								"float-text",
+								"streak-glow"
+							]
+						},
+						message: {
+							types: [
+								"string"
+							]
+						},
+						color: {
+							types: [
+								"string"
+							]
+						},
+						size: {
+							types: [
+								"number"
+							]
+						},
+						x: {
+							types: [
+								"number"
+							]
+						},
+						z: {
+							types: [
+								"number"
+							]
+						},
+						y: {
+							types: [
+								"number"
+							]
+						},
+						ttl: {
+							types: [
+								"number"
+							]
+						},
+						maxTtl: {
+							types: [
+								"number"
+							]
+						},
+						bornAt: {
+							types: [
+								"number"
+							]
+						},
+						space: {
+							types: [
+								"string"
+							],
+							enumValues: [
+								"world",
+								"screen"
+							]
+						},
+						particleCount: {
+							types: [
+								"number"
+							]
+						},
+						vx: {
+							types: [
+								"number"
+							]
+						},
+						vy: {
+							types: [
+								"number"
+							]
+						},
+						vz: {
+							types: [
+								"number"
+							]
+						}
+					},
+					required: [
+						"id",
+						"type",
+						"ttl"
+					]
+				}
+			},
+			tickMs: {
+				types: [
+					"number"
+				],
+				description: "The fx mechanic's decay tick period in ms; per-item animation duration = maxTtl × tickMs. Default 500."
+			},
+			children: {
+				types: [
+					"node"
+				],
+				description: "Wrapped content — the `shake` target and the overlay's bounds."
+			},
+			className: {
+				types: [
+					"string"
+				],
+				description: "Additional class names on the outermost element."
+			}
+		}
+	},
+	"draw-fx-layer": {
+		type: "draw-fx-layer",
+		category: "game",
+		tier: "molecules",
+		family: "game",
+		description: "DrawFxLayer component",
+		suggestedFor: [
+			"draw",
+			"layer",
+			"draw fx layer"
+		],
+		typicalSize: "medium",
+		propsSchema: {
+			id: {
+				types: [
+					"string"
+				],
+				description: "Optional source-tagged hit-test handle — the host indexes the drawable's ScenePos→id so a pointer/raycast at that cell resolves to this id (unit/entity click). No id → the host emits only the coordinate (tile click)."
+			},
+			type: {
+				types: [
+					"unknown"
+				],
+				description: "type prop",
+				required: true
+			},
+			items: {
+				types: [
+					"array"
+				],
+				description: "The live fx entries — the mechanic's `@entity.fx` list passed whole; `space: \"screen\"` entries are skipped (the overlay owns those).",
+				required: true,
+				items: {
+					types: [
+						"object"
+					],
+					properties: {
+						id: {
+							types: [
+								"string"
+							]
+						},
+						type: {
+							types: [
+								"string"
+							]
+						},
+						position: {
+							types: [
+								"object"
+							],
+							scenePos: true,
+							properties: {
+								x: {
+									types: [
+										"number"
+									]
+								},
+								y: {
+									types: [
+										"number"
+									]
+								},
+								z: {
+									types: [
+										"number"
+									]
+								}
+							},
+							required: [
+								"x",
+								"y"
+							]
+						},
+						x: {
+							types: [
+								"number"
+							]
+						},
+						z: {
+							types: [
+								"number"
+							]
+						},
+						y: {
+							types: [
+								"number"
+							]
+						},
+						message: {
+							types: [
+								"string"
+							]
+						},
+						ttl: {
+							types: [
+								"number"
+							]
+						},
+						maxTtl: {
+							types: [
+								"number"
+							]
+						},
+						bornAt: {
+							types: [
+								"number"
+							]
+						},
+						space: {
+							types: [
+								"string"
+							],
+							enumValues: [
+								"world",
+								"screen"
+							]
+						},
+						effect: {
+							types: [
+								"string"
+							],
+							enumValues: [
+								"confetti",
+								"flash",
+								"shake",
+								"sparkle",
+								"float-text",
+								"streak-glow"
+							]
+						},
+						color: {
+							types: [
+								"string"
+							]
+						},
+						size: {
+							types: [
+								"number"
+							]
+						},
+						vx: {
+							types: [
+								"number"
+							]
+						},
+						vy: {
+							types: [
+								"number"
+							]
+						},
+						vz: {
+							types: [
+								"number"
+							]
+						},
+						particleCount: {
+							types: [
+								"number"
+							]
+						}
+					},
+					required: [
+						"id",
+						"type",
+						"x",
+						"ttl"
+					]
+				}
+			},
+			presets: {
+				types: [
+					"array"
+				],
+				description: "Consumer-declared effect vocabulary — one row per fx `type` (look + recipe). Unknown types fall back to a neutral spark burst.",
+				items: {
+					types: [
+						"object"
+					],
+					properties: {
+						type: {
+							types: [
+								"string"
+							]
+						},
+						color: {
+							types: [
+								"string"
+							]
+						},
+						color2: {
+							types: [
+								"string"
+							]
+						},
+						size: {
+							types: [
+								"number"
+							]
+						},
+						shape: {
+							types: [
+								"string"
+							],
+							enumValues: [
+								"spark",
+								"ring",
+								"puff",
+								"streak"
+							]
+						},
+						count: {
+							types: [
+								"number"
+							]
+						},
+						glow: {
+							types: [
+								"number"
+							]
+						},
+						gravity: {
+							types: [
+								"number"
+							]
+						},
+						vx: {
+							types: [
+								"number"
+							]
+						},
+						vy: {
+							types: [
+								"number"
+							]
+						},
+						vz: {
+							types: [
+								"number"
+							]
+						},
+						space: {
+							types: [
+								"string"
+							],
+							enumValues: [
+								"world",
+								"screen"
+							]
+						},
+						effect: {
+							types: [
+								"string"
+							],
+							enumValues: [
+								"confetti",
+								"flash",
+								"shake",
+								"sparkle",
+								"float-text",
+								"streak-glow"
+							]
+						},
+						particleCount: {
+							types: [
+								"number"
+							]
+						}
+					},
+					required: [
+						"type"
+					]
+				}
+			},
+			art: {
+				types: [
+					"object"
+				],
+				description: "Vector art per fx type (an asset-art map: type → anim-state → drawables); a type's `idle` state wins over sprites/procedural.",
+				mapValue: {
+					types: [
+						"object"
+					],
+					mapValue: {
+						types: [
+							"array"
+						],
+						items: {
+							types: [
+								"object"
+							],
+							drawableSlot: true
+						}
+					}
+				}
+			},
+			sprites: {
+				types: [
+					"object"
+				],
+				description: "Sprite asset per fx type (an asset-manifest effects map) — used when no vector art matches.",
+				mapValue: {
+					types: [
+						"object"
+					],
+					properties: {
+						url: {
+							types: [
+								"asset"
+							]
+						},
+						role: {
+							types: [
+								"string"
+							]
+						},
+						category: {
+							types: [
+								"string"
+							]
+						},
+						animations: {
+							types: [
+								"array"
+							],
+							items: {
+								types: [
+									"string"
+								]
+							}
+						},
+						style: {
+							types: [
+								"string"
+							],
+							enumValues: [
+								"pixel",
+								"vector",
+								"hd",
+								"1-bit",
+								"isometric"
+							]
+						},
+						variant: {
+							types: [
+								"string"
+							]
+						},
+						dimension: {
+							types: [
+								"string"
+							],
+							enumValues: [
+								"2d",
+								"3d"
+							]
+						},
+						aspect: {
+							types: [
+								"string"
+							],
+							enumValues: [
+								"1:1",
+								"16:9",
+								"5:7",
+								"8:1"
+							]
+						},
+						atlas: {
+							types: [
+								"asset"
+							]
+						},
+						sprite: {
+							types: [
+								"string"
+							]
+						},
+						name: {
+							types: [
+								"string"
+							]
+						},
+						thumbnailUrl: {
+							types: [
+								"string"
+							]
+						}
+					},
+					required: [
+						"url",
+						"role",
+						"category"
+					]
+				}
+			},
+			tickMs: {
+				types: [
+					"number"
+				],
+				description: "The fx mechanic's decay tick period in ms; lifetime = maxTtl × tickMs. Default 500."
+			},
+			textColor: {
+				types: [
+					"string"
+				],
+				description: "Floating-message text color when an item declares none. Default `#ffe066`."
+			}
+		},
+		drawable: true,
+		drawHost: true
 	}
 };
 var categories$1 = [
@@ -47889,7 +48696,7 @@ var integratorsRegistry = {
 };
 
 var version$1 = "1.0.0";
-var exportedAt$1 = "2026-08-19T03:03:56.666Z";
+var exportedAt$1 = "2026-08-20T23:14:19.545Z";
 var mappings = {
 	"page-header": {
 		component: "PageHeader",
@@ -49282,6 +50089,16 @@ var mappings = {
 		component: "AlgoGraphCanvas",
 		importPath: "@/components/learning/molecules/AlgoGraphCanvas",
 		category: "learning"
+	},
+	"fx-overlay": {
+		component: "FxOverlay",
+		importPath: "@/components/core/molecules/FxOverlay",
+		category: "container"
+	},
+	"draw-fx-layer": {
+		component: "DrawFxLayer",
+		importPath: "@/components/game/molecules/DrawFxLayer",
+		category: "game"
 	}
 };
 var componentMapping = {
@@ -49291,7 +50108,7 @@ var componentMapping = {
 };
 
 var version = "1.0.0";
-var exportedAt = "2026-08-19T03:03:56.666Z";
+var exportedAt = "2026-08-20T23:14:19.545Z";
 var contracts = {
 	form: {
 		emits: [
@@ -51791,6 +52608,7 @@ declare const registry: {
             tier: string;
             family: string;
             description: string;
+            fieldsContract: string;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -51956,6 +52774,32 @@ declare const registry: {
                         required: string[];
                     };
                 };
+                backAction: {
+                    types: string[];
+                    description: string;
+                    properties: {
+                        label: {
+                            types: string[];
+                        };
+                        icon: {
+                            types: string[];
+                        };
+                        onClick: {
+                            types: string[];
+                        };
+                        event: {
+                            types: string[];
+                        };
+                        navigatesTo: {
+                            types: string[];
+                        };
+                        variant: {
+                            types: string[];
+                            enumValues: string[];
+                        };
+                    };
+                    propertyRequired: string[];
+                };
                 footer: {
                     types: string[];
                     description: string;
@@ -51978,6 +52822,18 @@ declare const registry: {
                             header: {
                                 types: string[];
                             };
+                            type: {
+                                types: string[];
+                            };
+                            values: {
+                                types: string[];
+                                items: {
+                                    types: string[];
+                                };
+                            };
+                            relation: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
@@ -52019,6 +52875,31 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                relationsData: {
+                    types: string[];
+                    description: string;
+                    mapValue: {
+                        types: string[];
+                        items: {
+                            types: string[];
+                            properties: {
+                                value: {
+                                    types: string[];
+                                };
+                                label: {
+                                    types: string[];
+                                };
+                                description: {
+                                    types: string[];
+                                };
+                                disabled: {
+                                    types: string[];
+                                };
+                            };
+                            required: string[];
+                        };
+                    };
+                };
             };
         };
         "page-header": {
@@ -52186,6 +53067,7 @@ declare const registry: {
             tier: string;
             family: string;
             description: string;
+            fieldsContract: string;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -52323,6 +53205,9 @@ declare const registry: {
                             disabled: {
                                 types: string[];
                             };
+                            hint: {
+                                types: string[];
+                            };
                         };
                     };
                 };
@@ -52423,6 +53308,28 @@ declare const registry: {
                     };
                     default: {};
                 };
+                fieldOverrides: {
+                    types: string[];
+                    description: string;
+                    items: {
+                        types: string[];
+                        properties: {
+                            name: {
+                                types: string[];
+                            };
+                            label: {
+                                types: string[];
+                            };
+                            placeholder: {
+                                types: string[];
+                            };
+                            hint: {
+                                types: string[];
+                            };
+                        };
+                        required: string[];
+                    };
+                };
                 conditionalFields: {
                     types: string[];
                     description: string;
@@ -52493,6 +53400,9 @@ declare const registry: {
                     properties: {
                         formValues: {
                             types: string[];
+                            mapValue: {
+                                types: string[];
+                            };
                         };
                         globalVariables: {
                             types: string[];
@@ -52510,6 +53420,9 @@ declare const registry: {
                         };
                         entity: {
                             types: string[];
+                            mapValue: {
+                                types: string[];
+                            };
                         };
                     };
                     propertyRequired: string[];
@@ -52622,6 +53535,9 @@ declare const registry: {
                                         disabled: {
                                             types: string[];
                                         };
+                                        hint: {
+                                            types: string[];
+                                        };
                                     };
                                 };
                             };
@@ -52676,6 +53592,7 @@ declare const registry: {
             tier: string;
             family: string;
             description: string;
+            fieldsContract: string;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -52813,6 +53730,9 @@ declare const registry: {
                             disabled: {
                                 types: string[];
                             };
+                            hint: {
+                                types: string[];
+                            };
                         };
                     };
                 };
@@ -52913,6 +53833,28 @@ declare const registry: {
                     };
                     default: {};
                 };
+                fieldOverrides: {
+                    types: string[];
+                    description: string;
+                    items: {
+                        types: string[];
+                        properties: {
+                            name: {
+                                types: string[];
+                            };
+                            label: {
+                                types: string[];
+                            };
+                            placeholder: {
+                                types: string[];
+                            };
+                            hint: {
+                                types: string[];
+                            };
+                        };
+                        required: string[];
+                    };
+                };
                 conditionalFields: {
                     types: string[];
                     description: string;
@@ -52983,6 +53925,9 @@ declare const registry: {
                     properties: {
                         formValues: {
                             types: string[];
+                            mapValue: {
+                                types: string[];
+                            };
                         };
                         globalVariables: {
                             types: string[];
@@ -53000,6 +53945,9 @@ declare const registry: {
                         };
                         entity: {
                             types: string[];
+                            mapValue: {
+                                types: string[];
+                            };
                         };
                     };
                     propertyRequired: string[];
@@ -53112,6 +54060,9 @@ declare const registry: {
                                         disabled: {
                                             types: string[];
                                         };
+                                        hint: {
+                                            types: string[];
+                                        };
                                     };
                                 };
                             };
@@ -75474,6 +76425,20 @@ declare const registry: {
                         };
                     }[];
                 };
+                keyMap: {
+                    types: string[];
+                    description: string;
+                    mapValue: {
+                        types: string[];
+                    };
+                };
+                keyUpMap: {
+                    types: string[];
+                    description: string;
+                    mapValue: {
+                        types: string[];
+                    };
+                };
                 isLoading: {
                     types: string[];
                     description: string;
@@ -79481,6 +80446,324 @@ declare const registry: {
                 };
             };
         };
+        "fx-overlay": {
+            type: string;
+            category: string;
+            tier: string;
+            family: string;
+            description: string;
+            suggestedFor: string[];
+            typicalSize: string;
+            propsSchema: {
+                items: {
+                    types: string[];
+                    description: string;
+                    required: boolean;
+                    items: {
+                        types: string[];
+                        properties: {
+                            id: {
+                                types: string[];
+                            };
+                            type: {
+                                types: string[];
+                            };
+                            effect: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            message: {
+                                types: string[];
+                            };
+                            color: {
+                                types: string[];
+                            };
+                            size: {
+                                types: string[];
+                            };
+                            x: {
+                                types: string[];
+                            };
+                            z: {
+                                types: string[];
+                            };
+                            y: {
+                                types: string[];
+                            };
+                            ttl: {
+                                types: string[];
+                            };
+                            maxTtl: {
+                                types: string[];
+                            };
+                            bornAt: {
+                                types: string[];
+                            };
+                            space: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            particleCount: {
+                                types: string[];
+                            };
+                            vx: {
+                                types: string[];
+                            };
+                            vy: {
+                                types: string[];
+                            };
+                            vz: {
+                                types: string[];
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                tickMs: {
+                    types: string[];
+                    description: string;
+                };
+                children: {
+                    types: string[];
+                    description: string;
+                };
+                className: {
+                    types: string[];
+                    description: string;
+                };
+            };
+        };
+        "draw-fx-layer": {
+            type: string;
+            category: string;
+            tier: string;
+            family: string;
+            description: string;
+            suggestedFor: string[];
+            typicalSize: string;
+            propsSchema: {
+                id: {
+                    types: string[];
+                    description: string;
+                };
+                type: {
+                    types: string[];
+                    description: string;
+                    required: boolean;
+                };
+                items: {
+                    types: string[];
+                    description: string;
+                    required: boolean;
+                    items: {
+                        types: string[];
+                        properties: {
+                            id: {
+                                types: string[];
+                            };
+                            type: {
+                                types: string[];
+                            };
+                            position: {
+                                types: string[];
+                                scenePos: boolean;
+                                properties: {
+                                    x: {
+                                        types: string[];
+                                    };
+                                    y: {
+                                        types: string[];
+                                    };
+                                    z: {
+                                        types: string[];
+                                    };
+                                };
+                                required: string[];
+                            };
+                            x: {
+                                types: string[];
+                            };
+                            z: {
+                                types: string[];
+                            };
+                            y: {
+                                types: string[];
+                            };
+                            message: {
+                                types: string[];
+                            };
+                            ttl: {
+                                types: string[];
+                            };
+                            maxTtl: {
+                                types: string[];
+                            };
+                            bornAt: {
+                                types: string[];
+                            };
+                            space: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            effect: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            color: {
+                                types: string[];
+                            };
+                            size: {
+                                types: string[];
+                            };
+                            vx: {
+                                types: string[];
+                            };
+                            vy: {
+                                types: string[];
+                            };
+                            vz: {
+                                types: string[];
+                            };
+                            particleCount: {
+                                types: string[];
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                presets: {
+                    types: string[];
+                    description: string;
+                    items: {
+                        types: string[];
+                        properties: {
+                            type: {
+                                types: string[];
+                            };
+                            color: {
+                                types: string[];
+                            };
+                            color2: {
+                                types: string[];
+                            };
+                            size: {
+                                types: string[];
+                            };
+                            shape: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            count: {
+                                types: string[];
+                            };
+                            glow: {
+                                types: string[];
+                            };
+                            gravity: {
+                                types: string[];
+                            };
+                            vx: {
+                                types: string[];
+                            };
+                            vy: {
+                                types: string[];
+                            };
+                            vz: {
+                                types: string[];
+                            };
+                            space: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            effect: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            particleCount: {
+                                types: string[];
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                art: {
+                    types: string[];
+                    description: string;
+                    mapValue: {
+                        types: string[];
+                        mapValue: {
+                            types: string[];
+                            items: {
+                                types: string[];
+                                drawableSlot: boolean;
+                            };
+                        };
+                    };
+                };
+                sprites: {
+                    types: string[];
+                    description: string;
+                    mapValue: {
+                        types: string[];
+                        properties: {
+                            url: {
+                                types: string[];
+                            };
+                            role: {
+                                types: string[];
+                            };
+                            category: {
+                                types: string[];
+                            };
+                            animations: {
+                                types: string[];
+                                items: {
+                                    types: string[];
+                                };
+                            };
+                            style: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            variant: {
+                                types: string[];
+                            };
+                            dimension: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            aspect: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            atlas: {
+                                types: string[];
+                            };
+                            sprite: {
+                                types: string[];
+                            };
+                            name: {
+                                types: string[];
+                            };
+                            thumbnailUrl: {
+                                types: string[];
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                tickMs: {
+                    types: string[];
+                    description: string;
+                };
+                textColor: {
+                    types: string[];
+                    description: string;
+                };
+            };
+            drawable: boolean;
+            drawHost: boolean;
+        };
     };
     categories: string[];
 };
@@ -80240,6 +81523,7 @@ declare const PATTERN_REGISTRY: {
             tier: string;
             family: string;
             description: string;
+            fieldsContract: string;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -80405,6 +81689,32 @@ declare const PATTERN_REGISTRY: {
                         required: string[];
                     };
                 };
+                backAction: {
+                    types: string[];
+                    description: string;
+                    properties: {
+                        label: {
+                            types: string[];
+                        };
+                        icon: {
+                            types: string[];
+                        };
+                        onClick: {
+                            types: string[];
+                        };
+                        event: {
+                            types: string[];
+                        };
+                        navigatesTo: {
+                            types: string[];
+                        };
+                        variant: {
+                            types: string[];
+                            enumValues: string[];
+                        };
+                    };
+                    propertyRequired: string[];
+                };
                 footer: {
                     types: string[];
                     description: string;
@@ -80427,6 +81737,18 @@ declare const PATTERN_REGISTRY: {
                             header: {
                                 types: string[];
                             };
+                            type: {
+                                types: string[];
+                            };
+                            values: {
+                                types: string[];
+                                items: {
+                                    types: string[];
+                                };
+                            };
+                            relation: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
@@ -80468,6 +81790,31 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                relationsData: {
+                    types: string[];
+                    description: string;
+                    mapValue: {
+                        types: string[];
+                        items: {
+                            types: string[];
+                            properties: {
+                                value: {
+                                    types: string[];
+                                };
+                                label: {
+                                    types: string[];
+                                };
+                                description: {
+                                    types: string[];
+                                };
+                                disabled: {
+                                    types: string[];
+                                };
+                            };
+                            required: string[];
+                        };
+                    };
+                };
             };
         };
         "page-header": {
@@ -80635,6 +81982,7 @@ declare const PATTERN_REGISTRY: {
             tier: string;
             family: string;
             description: string;
+            fieldsContract: string;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -80772,6 +82120,9 @@ declare const PATTERN_REGISTRY: {
                             disabled: {
                                 types: string[];
                             };
+                            hint: {
+                                types: string[];
+                            };
                         };
                     };
                 };
@@ -80872,6 +82223,28 @@ declare const PATTERN_REGISTRY: {
                     };
                     default: {};
                 };
+                fieldOverrides: {
+                    types: string[];
+                    description: string;
+                    items: {
+                        types: string[];
+                        properties: {
+                            name: {
+                                types: string[];
+                            };
+                            label: {
+                                types: string[];
+                            };
+                            placeholder: {
+                                types: string[];
+                            };
+                            hint: {
+                                types: string[];
+                            };
+                        };
+                        required: string[];
+                    };
+                };
                 conditionalFields: {
                     types: string[];
                     description: string;
@@ -80942,6 +82315,9 @@ declare const PATTERN_REGISTRY: {
                     properties: {
                         formValues: {
                             types: string[];
+                            mapValue: {
+                                types: string[];
+                            };
                         };
                         globalVariables: {
                             types: string[];
@@ -80959,6 +82335,9 @@ declare const PATTERN_REGISTRY: {
                         };
                         entity: {
                             types: string[];
+                            mapValue: {
+                                types: string[];
+                            };
                         };
                     };
                     propertyRequired: string[];
@@ -81071,6 +82450,9 @@ declare const PATTERN_REGISTRY: {
                                         disabled: {
                                             types: string[];
                                         };
+                                        hint: {
+                                            types: string[];
+                                        };
                                     };
                                 };
                             };
@@ -81125,6 +82507,7 @@ declare const PATTERN_REGISTRY: {
             tier: string;
             family: string;
             description: string;
+            fieldsContract: string;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -81262,6 +82645,9 @@ declare const PATTERN_REGISTRY: {
                             disabled: {
                                 types: string[];
                             };
+                            hint: {
+                                types: string[];
+                            };
                         };
                     };
                 };
@@ -81362,6 +82748,28 @@ declare const PATTERN_REGISTRY: {
                     };
                     default: {};
                 };
+                fieldOverrides: {
+                    types: string[];
+                    description: string;
+                    items: {
+                        types: string[];
+                        properties: {
+                            name: {
+                                types: string[];
+                            };
+                            label: {
+                                types: string[];
+                            };
+                            placeholder: {
+                                types: string[];
+                            };
+                            hint: {
+                                types: string[];
+                            };
+                        };
+                        required: string[];
+                    };
+                };
                 conditionalFields: {
                     types: string[];
                     description: string;
@@ -81432,6 +82840,9 @@ declare const PATTERN_REGISTRY: {
                     properties: {
                         formValues: {
                             types: string[];
+                            mapValue: {
+                                types: string[];
+                            };
                         };
                         globalVariables: {
                             types: string[];
@@ -81449,6 +82860,9 @@ declare const PATTERN_REGISTRY: {
                         };
                         entity: {
                             types: string[];
+                            mapValue: {
+                                types: string[];
+                            };
                         };
                     };
                     propertyRequired: string[];
@@ -81561,6 +82975,9 @@ declare const PATTERN_REGISTRY: {
                                         disabled: {
                                             types: string[];
                                         };
+                                        hint: {
+                                            types: string[];
+                                        };
                                     };
                                 };
                             };
@@ -103923,6 +105340,20 @@ declare const PATTERN_REGISTRY: {
                         };
                     }[];
                 };
+                keyMap: {
+                    types: string[];
+                    description: string;
+                    mapValue: {
+                        types: string[];
+                    };
+                };
+                keyUpMap: {
+                    types: string[];
+                    description: string;
+                    mapValue: {
+                        types: string[];
+                    };
+                };
                 isLoading: {
                     types: string[];
                     description: string;
@@ -107930,6 +109361,324 @@ declare const PATTERN_REGISTRY: {
                 };
             };
         };
+        "fx-overlay": {
+            type: string;
+            category: string;
+            tier: string;
+            family: string;
+            description: string;
+            suggestedFor: string[];
+            typicalSize: string;
+            propsSchema: {
+                items: {
+                    types: string[];
+                    description: string;
+                    required: boolean;
+                    items: {
+                        types: string[];
+                        properties: {
+                            id: {
+                                types: string[];
+                            };
+                            type: {
+                                types: string[];
+                            };
+                            effect: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            message: {
+                                types: string[];
+                            };
+                            color: {
+                                types: string[];
+                            };
+                            size: {
+                                types: string[];
+                            };
+                            x: {
+                                types: string[];
+                            };
+                            z: {
+                                types: string[];
+                            };
+                            y: {
+                                types: string[];
+                            };
+                            ttl: {
+                                types: string[];
+                            };
+                            maxTtl: {
+                                types: string[];
+                            };
+                            bornAt: {
+                                types: string[];
+                            };
+                            space: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            particleCount: {
+                                types: string[];
+                            };
+                            vx: {
+                                types: string[];
+                            };
+                            vy: {
+                                types: string[];
+                            };
+                            vz: {
+                                types: string[];
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                tickMs: {
+                    types: string[];
+                    description: string;
+                };
+                children: {
+                    types: string[];
+                    description: string;
+                };
+                className: {
+                    types: string[];
+                    description: string;
+                };
+            };
+        };
+        "draw-fx-layer": {
+            type: string;
+            category: string;
+            tier: string;
+            family: string;
+            description: string;
+            suggestedFor: string[];
+            typicalSize: string;
+            propsSchema: {
+                id: {
+                    types: string[];
+                    description: string;
+                };
+                type: {
+                    types: string[];
+                    description: string;
+                    required: boolean;
+                };
+                items: {
+                    types: string[];
+                    description: string;
+                    required: boolean;
+                    items: {
+                        types: string[];
+                        properties: {
+                            id: {
+                                types: string[];
+                            };
+                            type: {
+                                types: string[];
+                            };
+                            position: {
+                                types: string[];
+                                scenePos: boolean;
+                                properties: {
+                                    x: {
+                                        types: string[];
+                                    };
+                                    y: {
+                                        types: string[];
+                                    };
+                                    z: {
+                                        types: string[];
+                                    };
+                                };
+                                required: string[];
+                            };
+                            x: {
+                                types: string[];
+                            };
+                            z: {
+                                types: string[];
+                            };
+                            y: {
+                                types: string[];
+                            };
+                            message: {
+                                types: string[];
+                            };
+                            ttl: {
+                                types: string[];
+                            };
+                            maxTtl: {
+                                types: string[];
+                            };
+                            bornAt: {
+                                types: string[];
+                            };
+                            space: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            effect: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            color: {
+                                types: string[];
+                            };
+                            size: {
+                                types: string[];
+                            };
+                            vx: {
+                                types: string[];
+                            };
+                            vy: {
+                                types: string[];
+                            };
+                            vz: {
+                                types: string[];
+                            };
+                            particleCount: {
+                                types: string[];
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                presets: {
+                    types: string[];
+                    description: string;
+                    items: {
+                        types: string[];
+                        properties: {
+                            type: {
+                                types: string[];
+                            };
+                            color: {
+                                types: string[];
+                            };
+                            color2: {
+                                types: string[];
+                            };
+                            size: {
+                                types: string[];
+                            };
+                            shape: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            count: {
+                                types: string[];
+                            };
+                            glow: {
+                                types: string[];
+                            };
+                            gravity: {
+                                types: string[];
+                            };
+                            vx: {
+                                types: string[];
+                            };
+                            vy: {
+                                types: string[];
+                            };
+                            vz: {
+                                types: string[];
+                            };
+                            space: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            effect: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            particleCount: {
+                                types: string[];
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                art: {
+                    types: string[];
+                    description: string;
+                    mapValue: {
+                        types: string[];
+                        mapValue: {
+                            types: string[];
+                            items: {
+                                types: string[];
+                                drawableSlot: boolean;
+                            };
+                        };
+                    };
+                };
+                sprites: {
+                    types: string[];
+                    description: string;
+                    mapValue: {
+                        types: string[];
+                        properties: {
+                            url: {
+                                types: string[];
+                            };
+                            role: {
+                                types: string[];
+                            };
+                            category: {
+                                types: string[];
+                            };
+                            animations: {
+                                types: string[];
+                                items: {
+                                    types: string[];
+                                };
+                            };
+                            style: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            variant: {
+                                types: string[];
+                            };
+                            dimension: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            aspect: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            atlas: {
+                                types: string[];
+                            };
+                            sprite: {
+                                types: string[];
+                            };
+                            name: {
+                                types: string[];
+                            };
+                            thumbnailUrl: {
+                                types: string[];
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                tickMs: {
+                    types: string[];
+                    description: string;
+                };
+                textColor: {
+                    types: string[];
+                    description: string;
+                };
+            };
+            drawable: boolean;
+            drawHost: boolean;
+        };
     };
     categories: string[];
 };
@@ -110067,6 +111816,16 @@ declare const COMPONENT_MAPPING: {
             importPath: string;
             category: string;
         };
+        "fx-overlay": {
+            component: string;
+            importPath: string;
+            category: string;
+        };
+        "draw-fx-layer": {
+            component: string;
+            importPath: string;
+            category: string;
+        };
     };
 };
 declare const EVENT_CONTRACTS: {
@@ -110776,6 +112535,12 @@ type PatternEntry = {
      *  identity (not a name/signal); UISlotRenderer routes the host's authored
      *  `children` into its `drawables` prop (painted) instead of DOM-wrapping them. */
     drawHost?: boolean;
+    /** Declared fields-consumption contract from the component's
+     *  `@fieldsContract` JSDoc tag: `form` = editable SchemaFields (schema
+     *  enrichment + relationsData), `display` = read-only display fields
+     *  ({key, header} + typed meta). THE capability every enrichment consumer
+     *  keys on — never a hardcoded pattern-name list. */
+    fieldsContract?: 'form' | 'display';
 };
 declare function getPatternDefinition(patternType: string): PatternEntry | null;
 declare function getComponentForPattern(patternType: string): string | null;
@@ -110840,6 +112605,14 @@ declare function eventListPropsOf(patternType: string): ReadonlyMap<string, stri
  * @param patternType - Pattern type to check
  * @returns true if the pattern is a drawable
  */
+/**
+ * The pattern's declared fields-consumption contract (`@fieldsContract` on
+ * the owning component), or undefined for patterns without entity-bound
+ * field lists. Consumers: UISlotRenderer's schema enrichment, the server
+ * runtime's relation-option injection, and orbital-rust codegen (via the
+ * baked registry) — all key on THIS declaration, never on pattern names.
+ */
+declare function getPatternFieldsContract(patternType: string): 'form' | 'display' | undefined;
 declare function isDrawablePattern(patternType: string): boolean;
 /**
  * Check if a pattern is a canvas DRAW-HOST — a component that paints authored
@@ -110858,4 +112631,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, type PatternCallbackArg, type PatternEntry, type PatternPayloadField, type PatternPropDef, type PatternRecommendation, type PatternSwapGate, PatternType, type PropKind, type RecommendationContext, type RenderUiPayload, type SelectionChangePayload, buildRecommendationContext, collectRenderUiPatternTypes, componentMapping, eventContracts, eventKeyPropsOf, eventListPropsOf, findCompatiblePatterns, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getEmittedEvents, getEntityCardinality, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integratorsRegistry, isContentBodyPattern, isContentBodyPatternType, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isMainSlotRenderUi, isValueInputPattern, patternsRegistry, recommendPatterns, registry, renderUiPatternTypesOf };
+export { AnyPatternConfig, COMPONENT_MAPPING, EVENT_CONTRACTS, type EmojiPickPayload, type FormSubmitPayload, INTEGRATORS_REGISTRY, type ItemActionPayload, type LoadMoreRequestPayload, PATTERN_REGISTRY, type PatternCallbackArg, type PatternEntry, type PatternPayloadField, type PatternPropDef, type PatternRecommendation, type PatternSwapGate, PatternType, type PropKind, type RecommendationContext, type RenderUiPayload, 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, renderUiPatternTypesOf };