@almadar/core 10.29.0 → 10.30.0

package/dist/patterns/index.js

@@ -1,7 +1,7 @@
 // src/patterns/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-13T15:27:57.365Z",
+  exportedAt: "2026-07-16T19:33:37.203Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -706,7 +706,7 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: "renderItem prop",
+          description: "Render function for each item. In .lolo: renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.",
           kind: "callback",
           callbackArgs: [
             {
@@ -876,15 +876,6 @@ var patterns_registry_default = {
       ],
       typicalSize: "medium",
       propsSchema: {
-        entity: {
-          types: [
-            "object",
-            "array"
-          ],
-          description: "Entity record or array of records \u2014 pre-resolved by the trait via render-ui after a fetch emit",
-          kind: "entity",
-          cardinality: "collection"
-        },
         className: {
           types: [
             "string"
@@ -988,6 +979,15 @@ var patterns_registry_default = {
             ]
           }
         },
+        entity: {
+          types: [
+            "object",
+            "array"
+          ],
+          description: "Entity data (single record or collection).",
+          kind: "entity",
+          cardinality: "collection"
+        },
         minCardWidth: {
           types: [
             "number"
@@ -4223,7 +4223,7 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Declarative step click event \u2014 emits UI:{stepClickEvent} with { stepIndex }",
+          description: "Declarative step click event \u2014 emits UI:{stepClickEvent} with { stepIndex }. Setting it requires declaring that event (with a `{ stepIndex }` payload) and a transition handling it in the same trait; omit this prop for non-clickable progress indicators.",
           kind: "event-ref",
           emitPayloadSchema: [
             {
@@ -7672,7 +7672,7 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Input type - supports 'select' and 'textarea' in addition to standard types",
+          description: "Input type \u2014 selects the field's data mode. Use 'password' for masked credentials / secret / passphrase entry (there is no separate password pattern); 'email', 'tel', 'url', 'number', 'search', 'date', and 'time' for their respective values; and 'select' / 'textarea' for choice and multi-line entry in addition to the standard single-line types.",
           enumValues: [
             "text",
             "email",
@@ -8950,7 +8950,7 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: "Render function for each item",
+          description: "Render function for each item. In .lolo: renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.",
           required: true,
           kind: "callback",
           callbackArgs: [
@@ -10386,7 +10386,7 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Input type - supports 'select' and 'textarea' in addition to standard types",
+          description: "Input type \u2014 selects the field's data mode. Use 'password' for masked credentials / secret / passphrase entry (there is no separate password pattern); 'email', 'tel', 'url', 'number', 'search', 'date', and 'time' for their respective values; and 'select' / 'textarea' for choice and multi-line entry in addition to the standard single-line types.",
           enumValues: [
             "text",
             "email",
@@ -14489,6 +14489,11 @@ var patterns_registry_default = {
                   "number"
                 ]
               },
+              badge: {
+                types: [
+                  "number"
+                ]
+              },
               x: {
                 types: [
                   "number"
@@ -14509,7 +14514,7 @@ var patterns_registry_default = {
           types: [
             "array"
           ],
-          description: "Graph edges",
+          description: "Graph edges (the only rendered links)",
           items: {
             types: [
               "object"
@@ -14547,6 +14552,39 @@ var patterns_registry_default = {
             ]
           }
         },
+        similarity: {
+          types: [
+            "array"
+          ],
+          description: "All-pairs similarity (cosine 0\u20131) used ONLY for layout, never drawn. It is the secondary macro-layout: non-connected pairs get a weak spring (higher cosine \u21D2 closer) so clusters arrange relative to each other; drawn `edges` stay the primary tight structure. When omitted, edges alone drive the layout.",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              source: {
+                types: [
+                  "string"
+                ]
+              },
+              target: {
+                types: [
+                  "string"
+                ]
+              },
+              weight: {
+                types: [
+                  "number"
+                ]
+              }
+            },
+            required: [
+              "source",
+              "target",
+              "weight"
+            ]
+          }
+        },
         height: {
           types: [
             "number"
@@ -14656,6 +14694,11 @@ var patterns_registry_default = {
                       "number"
                     ]
                   },
+                  badge: {
+                    types: [
+                      "number"
+                    ]
+                  },
                   x: {
                     types: [
                       "number"
@@ -14714,6 +14757,74 @@ var patterns_registry_default = {
                       "number"
                     ]
                   },
+                  badge: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  x: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  y: {
+                    types: [
+                      "number"
+                    ]
+                  }
+                },
+                required: [
+                  "id"
+                ]
+              }
+            }
+          ]
+        },
+        onBadgeClick: {
+          types: [
+            "function"
+          ],
+          description: "On node badge click (e.g. to expand a merged cluster).",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "node",
+              type: "object",
+              schema: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  id: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  label: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  group: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  color: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  size: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  badge: {
+                    types: [
+                      "number"
+                    ]
+                  },
                   x: {
                     types: [
                       "number"
@@ -16729,7 +16840,7 @@ var patterns_registry_default = {
           types: [
             "array"
           ],
-          description: "Field definitions for rendering each card. The pattern contract in `@almadar/patterns` documents `columns` as the wire-format alias the compiler emits \u2014 both names resolve to the same shape here. Pass either.",
+          description: "Field definitions for rendering each card. The pattern contract in `@almadar/core/patterns` documents `columns` as the wire-format alias the compiler emits \u2014 both names resolve to the same shape here. Pass either.",
           items: {
             types: [
               "object"
@@ -17061,7 +17172,7 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: 'Per-item render function (schema-level alias for children render prop). In .orb schemas: ["fn", "item", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop.',
+          description: 'Per-item render function (schema-level alias for children render prop). In .orb schemas: ["fn", "item", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop. In .lolo, author the per-item renderer as renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.',
           kind: "callback",
           callbackArgs: [
             {
@@ -17174,7 +17285,7 @@ var patterns_registry_default = {
           types: [
             "array"
           ],
-          description: "Field definitions for rendering each row. The pattern contract in `@almadar/patterns` documents `columns` as the wire-format alias the compiler emits \u2014 both names resolve to the same shape here. Pass either.",
+          description: "Field definitions for rendering each row. The pattern contract in `@almadar/core/patterns` documents `columns` as the wire-format alias the compiler emits \u2014 both names resolve to the same shape here. Pass either.",
           items: {
             types: [
               "object"
@@ -17578,7 +17689,7 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: 'Per-item render function (schema-level alias for children render prop). In .orb schemas: ["fn", "item", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop.',
+          description: 'Per-item render function (schema-level alias for children render prop). In .orb schemas: ["fn", "item", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop. In .lolo, author the per-item renderer as renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.',
           kind: "callback",
           callbackArgs: [
             {
@@ -18608,6 +18719,12 @@ var patterns_registry_default = {
           ],
           description: "Text to display after the number"
         },
+        format: {
+          types: [
+            "string"
+          ],
+          description: `Display format: "number" (locale grouping), "currency" ($x.xx), "percent" (rounded %). Unset preserves the value's own decimals.`
+        },
         className: {
           types: [
             "string"
@@ -18794,7 +18911,7 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: "Render function for each slide",
+          description: "Render function for each slide. In .lolo: renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.",
           kind: "callback",
           callbackArgs: [
             {
@@ -18967,7 +19084,7 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: "renderItem prop",
+          description: "Render function for each item. In .lolo: renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.",
           required: true,
           kind: "callback",
           callbackArgs: [
@@ -32989,7 +33106,7 @@ var patterns_registry_default = {
           types: [
             "function"
           ],
-          description: 'Per-row render function (schema alias). In .orb: ["fn","item",{...}]. The compiler converts this to the children render prop.',
+          description: 'Per-row render function (schema alias). In .orb: ["fn","item",{...}]. The compiler converts this to the children render prop. In .lolo, author the per-row renderer as renderItem: (fn item <Component \u2026={@item.field}/>), binding per-item fields via @item.field.',
           kind: "callback",
           callbackArgs: [
             {
@@ -38595,31 +38712,31 @@ var patterns_registry_default = {
           types: [
             "number"
           ],
-          description: "Rect width in px."
+          description: "Rect width in world units (fractions of `projector.tileWidth`)."
         },
         height: {
           types: [
             "number"
           ],
-          description: "Rect height in px."
+          description: "Rect height in world units (fractions of `projector.tileWidth`)."
         },
         radiusX: {
           types: [
             "number"
           ],
-          description: "Ellipse horizontal radius in px."
+          description: "Ellipse horizontal radius in world units (fractions of `projector.tileWidth`)."
         },
         radiusY: {
           types: [
             "number"
           ],
-          description: "Ellipse vertical radius in px; omitted \u2192 `radiusX` (a circle)."
+          description: "Ellipse vertical radius in world units; omitted \u2192 `radiusX` (a circle)."
         },
         offsetX: {
           types: [
             "number"
           ],
-          description: "Fine px nudge from the anchor point (e.g. a disc drawn at `groundY - 8*scale`)."
+          description: "Fine nudge from the anchor point in world units."
         },
         offsetY: {
           types: [
@@ -38631,7 +38748,7 @@ var patterns_registry_default = {
           types: [
             "array"
           ],
-          description: "Poly vertices as px offsets relative to the cell's projected top-left.",
+          description: "Poly vertices as world-unit offsets relative to the cell's projected top-left.",
           items: {
             types: [
               "object"
@@ -40449,7 +40566,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-13T15:27:57.365Z",
+  exportedAt: "2026-07-16T19:33:37.203Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -41804,7 +41921,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-13T15:27:57.365Z",
+  exportedAt: "2026-07-16T19:33:37.203Z",
   contracts: {
     form: {
       emits: [
@@ -43291,10 +43408,13 @@ var ORB_ALLOWED_ENTITY_PATTERNS = /* @__PURE__ */ new Set([
   "data-grid",
   "search-input",
   "form-section",
-  "meter"
+  "meter",
+  "table-view",
+  "filter-group",
+  "timeline",
+  "media-gallery"
 ]);
 var ORB_EXCLUDED_CATEGORIES = /* @__PURE__ */ new Set([
-  "game",
   "debug",
   "template"
 ]);
@@ -43375,6 +43495,40 @@ function getOrbAllowedPatternsFiltered(patternNames) {
   return lines.join("\n");
 }
 
+// src/types/json.ts
+function isJsonObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isJsonArray(value) {
+  return Array.isArray(value);
+}
+
+// src/patterns/helpers/render-ui-pattern-types.ts
+function collectPatternTypeTokens(node, out) {
+  if (!isJsonObject(node)) return;
+  const type = node["type"];
+  if (typeof type === "string" && !type.startsWith("@")) out.add(type);
+  const children = node["children"];
+  if (isJsonArray(children)) {
+    for (const child of children) collectPatternTypeTokens(child, out);
+  }
+}
+function collectRenderUiPatternTypes(ir, out) {
+  if (isJsonArray(ir)) {
+    if (ir.length >= 3 && ir[0] === "render-ui" && typeof ir[1] === "string") {
+      collectPatternTypeTokens(ir[2], out);
+    }
+    for (const item of ir) collectRenderUiPatternTypes(item, out);
+  } else if (isJsonObject(ir)) {
+    for (const value of Object.values(ir)) collectRenderUiPatternTypes(value, out);
+  }
+}
+function renderUiPatternTypesOf(ir) {
+  const out = /* @__PURE__ */ new Set();
+  collectRenderUiPatternTypes(ir, out);
+  return out;
+}
+
 // src/patterns/helpers/pattern-recommender.ts
 var DOMAIN_KEYWORDS = {
   business: ["admin panels", "data-dense views", "list pages", "data entry", "comparisons"],
@@ -43628,6 +43782,6 @@ function propHostsDrawables(schema) {
   return false;
 }
 
-export { COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, buildRecommendationContext, 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, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isValidPatternType, patterns_registry_default as patternsRegistry, recommendPatterns, registry };
+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, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isValidPatternType, patterns_registry_default as patternsRegistry, recommendPatterns, registry, renderUiPatternTypesOf };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map