@almadar/core 10.49.0 → 10.51.0

package/dist/patterns/component-mapping.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-08-01T09:06:41.875Z",
+  "exportedAt": "2026-08-02T09:00:22.243Z",
   "mappings": {
     "page-header": {
       "component": "PageHeader",

package/dist/patterns/event-contracts.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-08-01T09:06:41.875Z",
+  "exportedAt": "2026-08-02T09:00:22.243Z",
   "contracts": {
     "form": {
       "emits": [

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-DjMRX8sI.js';
-export { aR as PATTERN_TYPES, aV as PatternConfig, aW as PatternProps, aX as PatternPropsMap, cL as isValidPatternType } from '../effect-DjMRX8sI.js';
+import { A as AnyPatternConfig, h as RenderBinding, F as FieldValue, aY as PatternType } from '../effect-CqTo1gAF.js';
+export { aR as PATTERN_TYPES, aV as PatternConfig, aW as PatternProps, aX as PatternPropsMap, cO as isValidPatternType } from '../effect-CqTo1gAF.js';
 import { d as EventPayloadValue, a as EventPayload, J as JsonValue } from '../expression-Yf7qvvOs.js';
 import 'zod';
 
 var version$3 = "1.0.0";
-var exportedAt$3 = "2026-08-01T09:06:41.875Z";
+var exportedAt$3 = "2026-08-02T09:00:22.243Z";
 var patterns = {
 	"entity-table": {
 		type: "entity-table",
@@ -8626,6 +8626,11 @@ var patterns = {
 								"string"
 							]
 						},
+						url: {
+							types: [
+								"string"
+							]
+						},
 						variant: {
 							types: [
 								"string"
@@ -40040,7 +40045,13 @@ var patterns = {
 				types: [
 					"string"
 				],
-				description: "Named GLB animation clip to play (3D backend only; the 2D painter animates via `frame`). Matched case-insensitively against the model's clips."
+				description: "Animation to play. 3D backend: a named GLB clip (matched case-insensitively). 2D painter: when `asset.atlas` resolves to a `SpriteSheetAtlas` manifest, the canonical row of that name (idle/walk/attack/hit/death) plays off the host paint clock; an explicit `frame` rect overrides."
+			},
+			loop: {
+				types: [
+					"boolean"
+				],
+				description: "Override the sheet row's loop flag. The paint clock is wall-time, so one-shot rows hold their final frame — preview pages set `true` to cycle attack/hit/death continuously."
 			},
 			flipX: {
 				types: [
@@ -40892,6 +40903,11 @@ var patterns = {
 								"string"
 							]
 						},
+						loop: {
+							types: [
+								"boolean"
+							]
+						},
 						flipX: {
 							types: [
 								"boolean"
@@ -42276,6 +42292,22 @@ var patterns = {
 					}
 				}
 			},
+			uvs: {
+				types: [
+					"array"
+				],
+				description: "`polyhedron` only: per-vertex `[u, v]` texture coordinates parallel to `vertices`, glTF convention (`v` grows DOWN from the image's top-left). Pairs with `material.map`.",
+				items: {
+					types: [
+						"array"
+					],
+					items: {
+						types: [
+							"number"
+						]
+					}
+				}
+			},
 			skin: {
 				types: [
 					"object"
@@ -42437,6 +42469,11 @@ var patterns = {
 							"back",
 							"double"
 						]
+					},
+					map: {
+						types: [
+							"string"
+						]
 					}
 				}
 			},
@@ -43502,7 +43539,7 @@ var integratorsRegistry = {
 };
 
 var version$1 = "1.0.0";
-var exportedAt$1 = "2026-08-01T09:06:41.875Z";
+var exportedAt$1 = "2026-08-02T09:00:22.243Z";
 var mappings = {
 	"page-header": {
 		component: "PageHeader",
@@ -44899,7 +44936,7 @@ var componentMapping = {
 };
 
 var version = "1.0.0";
-var exportedAt = "2026-08-01T09:06:41.875Z";
+var exportedAt = "2026-08-02T09:00:22.243Z";
 var contracts = {
 	form: {
 		emits: [
@@ -51863,6 +51900,9 @@ declare const registry: {
                             event: {
                                 types: string[];
                             };
+                            url: {
+                                types: string[];
+                            };
                             variant: {
                                 types: string[];
                                 enumValues: string[];
@@ -71066,6 +71106,10 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                loop: {
+                    types: string[];
+                    description: string;
+                };
                 flipX: {
                     types: string[];
                     description: string;
@@ -71559,6 +71603,9 @@ declare const registry: {
                             animation: {
                                 types: string[];
                             };
+                            loop: {
+                                types: string[];
+                            };
                             flipX: {
                                 types: string[];
                             };
@@ -72421,6 +72468,16 @@ declare const registry: {
                         };
                     };
                 };
+                uvs: {
+                    types: string[];
+                    description: string;
+                    items: {
+                        types: string[];
+                        items: {
+                            types: string[];
+                        };
+                    };
+                };
                 skin: {
                     types: string[];
                     description: string;
@@ -72512,6 +72569,9 @@ declare const registry: {
                             types: string[];
                             enumValues: string[];
                         };
+                        map: {
+                            types: string[];
+                        };
                     };
                 };
                 outline: {
@@ -77836,6 +77896,9 @@ declare const PATTERN_REGISTRY: {
                             event: {
                                 types: string[];
                             };
+                            url: {
+                                types: string[];
+                            };
                             variant: {
                                 types: string[];
                                 enumValues: string[];
@@ -97039,6 +97102,10 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                loop: {
+                    types: string[];
+                    description: string;
+                };
                 flipX: {
                     types: string[];
                     description: string;
@@ -97532,6 +97599,9 @@ declare const PATTERN_REGISTRY: {
                             animation: {
                                 types: string[];
                             };
+                            loop: {
+                                types: string[];
+                            };
                             flipX: {
                                 types: string[];
                             };
@@ -98394,6 +98464,16 @@ declare const PATTERN_REGISTRY: {
                         };
                     };
                 };
+                uvs: {
+                    types: string[];
+                    description: string;
+                    items: {
+                        types: string[];
+                        items: {
+                            types: string[];
+                        };
+                    };
+                };
                 skin: {
                     types: string[];
                     description: string;
@@ -98485,6 +98565,9 @@ declare const PATTERN_REGISTRY: {
                             types: string[];
                             enumValues: string[];
                         };
+                        map: {
+                            types: string[];
+                        };
                     };
                 };
                 outline: {
@@ -101384,6 +101467,28 @@ declare function getComponentForPattern(patternType: string): string | null;
  * @returns true if the pattern is entity-aware
  */
 declare function isEntityAwarePattern(patternType: string): boolean;
+/**
+ * Prop names of `patternType` whose value is a single declared event key
+ * (`kind: "event" | "event-ref" | "callback"`) — `action`, `cancelEvent`,
+ * `retryEvent`, `onRetry`, and every future sibling, straight from the
+ * registry rather than a hand-maintained key list that silently drifts.
+ *
+ * The consumer is the wiring lint: an affordance prop bound to a lifecycle
+ * event key is a control that does nothing when clicked.
+ *
+ * @param patternType - Pattern type to inspect
+ * @returns the declared event-key prop names (empty for an unknown pattern)
+ */
+declare function eventKeyPropsOf(patternType: string): ReadonlySet<string>;
+/**
+ * Prop names of `patternType` carrying `kind: "event-list"` action-descriptor
+ * arrays, each mapped to the field inside an item that holds the event key
+ * (`eventField`, defaulting to `"event"` per {@link PatternPropDef.eventField}).
+ *
+ * @param patternType - Pattern type to inspect
+ * @returns prop name → event field (empty for an unknown pattern)
+ */
+declare function eventListPropsOf(patternType: string): ReadonlyMap<string, string>;
 /**
  * Check if a pattern is a neutral DRAWABLE — a descriptor the canvas draw-host
  * paints (draw-sprite / draw-shape / draw-text / draw-sprite-layer /
@@ -101417,4 +101522,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, findCompatiblePatterns, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getEmittedEvents, getEntityCardinality, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integratorsRegistry, isContentBodyPattern, isContentBodyPatternType, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isMainSlotRenderUi, 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, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integratorsRegistry, isContentBodyPattern, isContentBodyPatternType, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isMainSlotRenderUi, patternsRegistry, recommendPatterns, registry, renderUiPatternTypesOf };

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-01T09:06:41.875Z",
+  exportedAt: "2026-08-02T09:00:22.243Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -8593,6 +8593,11 @@ var patterns_registry_default = {
                   "string"
                 ]
               },
+              url: {
+                types: [
+                  "string"
+                ]
+              },
               variant: {
                 types: [
                   "string"
@@ -39937,7 +39942,13 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Named GLB animation clip to play (3D backend only; the 2D painter animates via `frame`). Matched case-insensitively against the model's clips."
+          description: "Animation to play. 3D backend: a named GLB clip (matched case-insensitively). 2D painter: when `asset.atlas` resolves to a `SpriteSheetAtlas` manifest, the canonical row of that name (idle/walk/attack/hit/death) plays off the host paint clock; an explicit `frame` rect overrides."
+        },
+        loop: {
+          types: [
+            "boolean"
+          ],
+          description: "Override the sheet row's loop flag. The paint clock is wall-time, so one-shot rows hold their final frame \u2014 preview pages set `true` to cycle attack/hit/death continuously."
         },
         flipX: {
           types: [
@@ -40789,6 +40800,11 @@ var patterns_registry_default = {
                   "string"
                 ]
               },
+              loop: {
+                types: [
+                  "boolean"
+                ]
+              },
               flipX: {
                 types: [
                   "boolean"
@@ -42169,6 +42185,22 @@ var patterns_registry_default = {
             }
           }
         },
+        uvs: {
+          types: [
+            "array"
+          ],
+          description: "`polyhedron` only: per-vertex `[u, v]` texture coordinates parallel to `vertices`, glTF convention (`v` grows DOWN from the image's top-left). Pairs with `material.map`.",
+          items: {
+            types: [
+              "array"
+            ],
+            items: {
+              types: [
+                "number"
+              ]
+            }
+          }
+        },
         skin: {
           types: [
             "object"
@@ -42330,6 +42362,11 @@ var patterns_registry_default = {
                 "back",
                 "double"
               ]
+            },
+            map: {
+              types: [
+                "string"
+              ]
             }
           }
         },
@@ -43389,7 +43426,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-08-01T09:06:41.875Z",
+  exportedAt: "2026-08-02T09:00:22.243Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -44784,7 +44821,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-08-01T09:06:41.875Z",
+  exportedAt: "2026-08-02T09:00:22.243Z",
   contracts: {
     form: {
       emits: [
@@ -46651,6 +46688,31 @@ function isEntityAwarePattern(patternType) {
   if (!propsSchema) return false;
   return "entity" in propsSchema;
 }
+var EVENT_OUTLET_KINDS = /* @__PURE__ */ new Set(["event", "event-ref", "callback"]);
+var eventKeyPropsCache = /* @__PURE__ */ new Map();
+var eventListPropsCache = /* @__PURE__ */ new Map();
+function eventKeyPropsOf(patternType) {
+  const cached = eventKeyPropsCache.get(patternType);
+  if (cached) return cached;
+  const propsSchema = getPatternDefinition(patternType)?.propsSchema;
+  const out = /* @__PURE__ */ new Set();
+  for (const [prop, def] of Object.entries(propsSchema ?? {})) {
+    if (def.kind && EVENT_OUTLET_KINDS.has(def.kind)) out.add(prop);
+  }
+  eventKeyPropsCache.set(patternType, out);
+  return out;
+}
+function eventListPropsOf(patternType) {
+  const cached = eventListPropsCache.get(patternType);
+  if (cached) return cached;
+  const propsSchema = getPatternDefinition(patternType)?.propsSchema;
+  const out = /* @__PURE__ */ new Map();
+  for (const [prop, def] of Object.entries(propsSchema ?? {})) {
+    if (def.kind === "event-list") out.set(prop, def.eventField ?? "event");
+  }
+  eventListPropsCache.set(patternType, out);
+  return out;
+}
 function isDrawablePattern(patternType) {
   const definition = getPatternDefinition(patternType);
   if (!definition) return false;
@@ -46690,6 +46752,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, 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, 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, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integrators_registry_default as integratorsRegistry, isContentBodyPattern, isContentBodyPatternType, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isMainSlotRenderUi, isValidPatternType, patterns_registry_default as patternsRegistry, recommendPatterns, registry, renderUiPatternTypesOf };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map