@almadar/core 10.61.0 → 10.62.0

package/dist/patterns/index.js

@@ -3,7 +3,7 @@ import { z } from 'zod';
 // src/patterns/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-08-19T03:03:56.666Z",
+  exportedAt: "2026-08-20T06:39:15.858Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -1239,6 +1239,7 @@ var patterns_registry_default = {
       tier: "organisms",
       family: "core",
       description: "Detail view panel for drawers/sidebars",
+      fieldsContract: "display",
       suggestedFor: [
         "drawer content",
         "side panels",
@@ -1520,6 +1521,54 @@ var patterns_registry_default = {
             ]
           }
         },
+        backAction: {
+          types: [
+            "object"
+          ],
+          description: "Navigation-back affordance. Renders top-LEFT before the title (OS/back convention \u2014 Almadar_UX \xA78.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"
@@ -1554,6 +1603,26 @@ var patterns_registry_default = {
                 types: [
                   "string"
                 ]
+              },
+              type: {
+                types: [
+                  "string"
+                ]
+              },
+              values: {
+                types: [
+                  "array"
+                ],
+                items: {
+                  types: [
+                    "string"
+                  ]
+                }
+              },
+              relation: {
+                types: [
+                  "string"
+                ]
               }
             },
             required: [
@@ -1618,6 +1687,48 @@ var patterns_registry_default = {
             "boolean"
           ],
           description: "Show actions flag"
+        },
+        relationsData: {
+          types: [
+            "object"
+          ],
+          description: "Relation display data: { fieldName: [{value, label}] } \u2014 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"
+              ]
+            }
+          }
         }
       }
     },
@@ -1889,6 +2000,7 @@ var patterns_registry_default = {
       tier: "organisms",
       family: "core",
       description: "Complete form with fields and actions",
+      fieldsContract: "form",
       suggestedFor: [
         "create forms",
         "edit forms",
@@ -2121,6 +2233,11 @@ var patterns_registry_default = {
                 types: [
                   "boolean"
                 ]
+              },
+              hint: {
+                types: [
+                  "string"
+                ]
               }
             }
           }
@@ -2273,6 +2390,42 @@ var patterns_registry_default = {
           },
           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",
@@ -2615,6 +2768,11 @@ var patterns_registry_default = {
                       types: [
                         "boolean"
                       ]
+                    },
+                    hint: {
+                      types: [
+                        "string"
+                      ]
                     }
                   }
                 }
@@ -2698,6 +2856,7 @@ var patterns_registry_default = {
       tier: "organisms",
       family: "core",
       description: "Alias for form \u2014 Complete form with fields and actions",
+      fieldsContract: "form",
       suggestedFor: [
         "create forms",
         "edit forms",
@@ -2930,6 +3089,11 @@ var patterns_registry_default = {
                 types: [
                   "boolean"
                 ]
+              },
+              hint: {
+                types: [
+                  "string"
+                ]
               }
             }
           }
@@ -3082,6 +3246,42 @@ var patterns_registry_default = {
           },
           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",
@@ -3424,6 +3624,11 @@ var patterns_registry_default = {
                       types: [
                         "boolean"
                       ]
+                    },
+                    hint: {
+                      types: [
+                        "string"
+                      ]
                     }
                   }
                 }
@@ -40055,6 +40260,28 @@ var patterns_registry_default = {
             }
           ]
         },
+        keyMap: {
+          types: [
+            "object"
+          ],
+          description: "Maps a keydown `e.code` \u2192 the board's SEMANTIC event (device-agnostic input), emitted as `UI:{event}` \u2014 same contract as the game canvas keyMap.",
+          mapValue: {
+            types: [
+              "string"
+            ]
+          }
+        },
+        keyUpMap: {
+          types: [
+            "object"
+          ],
+          description: "Maps a keyup `e.code` \u2192 the board's SEMANTIC event.",
+          mapValue: {
+            types: [
+              "string"
+            ]
+          }
+        },
         isLoading: {
           types: [
             "boolean"
@@ -47751,7 +47978,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-08-19T03:03:56.666Z",
+  exportedAt: "2026-08-20T06:39:15.858Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -49151,7 +49378,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-08-19T03:03:56.666Z",
+  exportedAt: "2026-08-20T06:39:15.858Z",
   contracts: {
     form: {
       emits: [
@@ -51056,6 +51283,9 @@ function eventListPropsOf(patternType) {
   eventListPropsCache.set(patternType, out);
   return out;
 }
+function getPatternFieldsContract(patternType) {
+  return getPatternDefinition(patternType)?.fieldsContract;
+}
 function isDrawablePattern(patternType) {
   const definition = getPatternDefinition(patternType);
   if (!definition) return false;
@@ -51095,6 +51325,6 @@ function propHostsDrawables(schema) {
   return false;
 }
 
-export { COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, buildRecommendationContext, collectRenderUiPatternTypes, component_mapping_default as componentMapping, event_contracts_default as eventContracts, eventKeyPropsOf, eventListPropsOf, findCompatiblePatterns, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getEmittedEvents, getEntityCardinality, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integrators_registry_default as integratorsRegistry, isContentBodyPattern, isContentBodyPatternType, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isMainSlotRenderUi, isValidPatternType, isValueInputPattern, patterns_registry_default as patternsRegistry, recommendPatterns, registry, renderUiPatternTypesOf };
+export { COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, buildRecommendationContext, collectRenderUiPatternTypes, component_mapping_default as componentMapping, event_contracts_default as eventContracts, eventKeyPropsOf, eventListPropsOf, findCompatiblePatterns, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getEmittedEvents, getEntityCardinality, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternFieldsContract, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integrators_registry_default as integratorsRegistry, isContentBodyPattern, isContentBodyPatternType, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isMainSlotRenderUi, isValidPatternType, isValueInputPattern, patterns_registry_default as patternsRegistry, recommendPatterns, registry, renderUiPatternTypesOf };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map