@almadar/core 10.61.0 → 10.62.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-M22diOHo.js';
+export { aT as PATTERN_TYPES, aX as PatternConfig, aY as PatternProps, aZ as PatternPropsMap, cR as isValidPatternType } from '../effect-M22diOHo.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-20T06:39:15.858Z";
 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"
+						]
+					}
+				}
 			}
 		}
 	},
@@ -1893,6 +2004,7 @@ var patterns = {
 		tier: "organisms",
 		family: "core",
 		description: "Complete form with fields and actions",
+		fieldsContract: "form",
 		suggestedFor: [
 			"create forms",
 			"edit forms",
@@ -2125,6 +2237,11 @@ var patterns = {
 							types: [
 								"boolean"
 							]
+						},
+						hint: {
+							types: [
+								"string"
+							]
 						}
 					}
 				}
@@ -2279,6 +2396,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",
@@ -2621,6 +2774,11 @@ var patterns = {
 										types: [
 											"boolean"
 										]
+									},
+									hint: {
+										types: [
+											"string"
+										]
 									}
 								}
 							}
@@ -2705,6 +2863,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 +3096,11 @@ var patterns = {
 							types: [
 								"boolean"
 							]
+						},
+						hint: {
+							types: [
+								"string"
+							]
 						}
 					}
 				}
@@ -3091,6 +3255,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",
@@ -3433,6 +3633,11 @@ var patterns = {
 										types: [
 											"boolean"
 										]
+									},
+									hint: {
+										types: [
+											"string"
+										]
 									}
 								}
 							}
@@ -40159,6 +40364,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"
@@ -47889,7 +48116,7 @@ var integratorsRegistry = {
 };
 
 var version$1 = "1.0.0";
-var exportedAt$1 = "2026-08-19T03:03:56.666Z";
+var exportedAt$1 = "2026-08-20T06:39:15.858Z";
 var mappings = {
 	"page-header": {
 		component: "PageHeader",
@@ -49291,7 +49518,7 @@ var componentMapping = {
 };
 
 var version = "1.0.0";
-var exportedAt = "2026-08-19T03:03:56.666Z";
+var exportedAt = "2026-08-20T06:39:15.858Z";
 var contracts = {
 	form: {
 		emits: [
@@ -51791,6 +52018,7 @@ declare const registry: {
             tier: string;
             family: string;
             description: string;
+            fieldsContract: string;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -51956,6 +52184,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 +52232,18 @@ declare const registry: {
                             header: {
                                 types: string[];
                             };
+                            type: {
+                                types: string[];
+                            };
+                            values: {
+                                types: string[];
+                                items: {
+                                    types: string[];
+                                };
+                            };
+                            relation: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
@@ -52019,6 +52285,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 +52477,7 @@ declare const registry: {
             tier: string;
             family: string;
             description: string;
+            fieldsContract: string;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -52323,6 +52615,9 @@ declare const registry: {
                             disabled: {
                                 types: string[];
                             };
+                            hint: {
+                                types: string[];
+                            };
                         };
                     };
                 };
@@ -52423,6 +52718,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;
@@ -52622,6 +52939,9 @@ declare const registry: {
                                         disabled: {
                                             types: string[];
                                         };
+                                        hint: {
+                                            types: string[];
+                                        };
                                     };
                                 };
                             };
@@ -52676,6 +52996,7 @@ declare const registry: {
             tier: string;
             family: string;
             description: string;
+            fieldsContract: string;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -52813,6 +53134,9 @@ declare const registry: {
                             disabled: {
                                 types: string[];
                             };
+                            hint: {
+                                types: string[];
+                            };
                         };
                     };
                 };
@@ -52913,6 +53237,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;
@@ -53112,6 +53458,9 @@ declare const registry: {
                                         disabled: {
                                             types: string[];
                                         };
+                                        hint: {
+                                            types: string[];
+                                        };
                                     };
                                 };
                             };
@@ -75474,6 +75823,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;
@@ -80240,6 +80603,7 @@ declare const PATTERN_REGISTRY: {
             tier: string;
             family: string;
             description: string;
+            fieldsContract: string;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -80405,6 +80769,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 +80817,18 @@ declare const PATTERN_REGISTRY: {
                             header: {
                                 types: string[];
                             };
+                            type: {
+                                types: string[];
+                            };
+                            values: {
+                                types: string[];
+                                items: {
+                                    types: string[];
+                                };
+                            };
+                            relation: {
+                                types: string[];
+                            };
                         };
                         required: string[];
                     };
@@ -80468,6 +80870,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 +81062,7 @@ declare const PATTERN_REGISTRY: {
             tier: string;
             family: string;
             description: string;
+            fieldsContract: string;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -80772,6 +81200,9 @@ declare const PATTERN_REGISTRY: {
                             disabled: {
                                 types: string[];
                             };
+                            hint: {
+                                types: string[];
+                            };
                         };
                     };
                 };
@@ -80872,6 +81303,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;
@@ -81071,6 +81524,9 @@ declare const PATTERN_REGISTRY: {
                                         disabled: {
                                             types: string[];
                                         };
+                                        hint: {
+                                            types: string[];
+                                        };
                                     };
                                 };
                             };
@@ -81125,6 +81581,7 @@ declare const PATTERN_REGISTRY: {
             tier: string;
             family: string;
             description: string;
+            fieldsContract: string;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -81262,6 +81719,9 @@ declare const PATTERN_REGISTRY: {
                             disabled: {
                                 types: string[];
                             };
+                            hint: {
+                                types: string[];
+                            };
                         };
                     };
                 };
@@ -81362,6 +81822,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;
@@ -81561,6 +82043,9 @@ declare const PATTERN_REGISTRY: {
                                         disabled: {
                                             types: string[];
                                         };
+                                        hint: {
+                                            types: string[];
+                                        };
                                     };
                                 };
                             };
@@ -103923,6 +104408,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;
@@ -110776,6 +111275,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 +111345,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 +111371,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 };