@almadar/core 10.29.0 → 10.30.0

package/dist/patterns/index.d.ts

@@ -1,10 +1,11 @@
-import { F as FieldValue, a2 as PatternType } from '../pattern-types-JZordBZv.js';
-export { A as AnyPatternConfig, _ as PATTERN_TYPES, $ as PatternConfig, a0 as PatternProps, a1 as PatternPropsMap, av as isValidPatternType } from '../pattern-types-JZordBZv.js';
+import { F as FieldValue, al as PatternType } from '../pattern-types-CLcOXOmW.js';
+export { A as AnyPatternConfig, ae as PATTERN_TYPES, ai as PatternConfig, aj as PatternProps, ak as PatternPropsMap, b9 as isValidPatternType } from '../pattern-types-CLcOXOmW.js';
 import { d as EventPayloadValue, E as EventPayload } from '../expression-CB9R3KWk.js';
+import { J as JsonValue } from '../json-DOTchoRS.js';
 import 'zod';
 
 var version$3 = "1.0.0";
-var exportedAt$3 = "2026-07-13T15:27:57.365Z";
+var exportedAt$3 = "2026-07-16T19:33:37.203Z";
 var patterns = {
 	"entity-table": {
 		type: "entity-table",
@@ -711,7 +712,7 @@ var patterns = {
 				types: [
 					"function"
 				],
-				description: "renderItem prop",
+				description: "Render function for each item. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.",
 				kind: "callback",
 				callbackArgs: [
 					{
@@ -881,15 +882,6 @@ var patterns = {
 		],
 		typicalSize: "medium",
 		propsSchema: {
-			entity: {
-				types: [
-					"object",
-					"array"
-				],
-				description: "Entity record or array of records — pre-resolved by the trait via render-ui after a fetch emit",
-				kind: "entity",
-				cardinality: "collection"
-			},
 			className: {
 				types: [
 					"string"
@@ -993,6 +985,15 @@ var patterns = {
 					]
 				}
 			},
+			entity: {
+				types: [
+					"object",
+					"array"
+				],
+				description: "Entity data (single record or collection).",
+				kind: "entity",
+				cardinality: "collection"
+			},
 			minCardWidth: {
 				types: [
 					"number"
@@ -4236,7 +4237,7 @@ var patterns = {
 				types: [
 					"string"
 				],
-				description: "Declarative step click event — emits UI:{stepClickEvent} with { stepIndex }",
+				description: "Declarative step click event — 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: [
 					{
@@ -7704,7 +7705,7 @@ var patterns = {
 				types: [
 					"string"
 				],
-				description: "Input type - supports 'select' and 'textarea' in addition to standard types",
+				description: "Input type — 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",
@@ -8984,7 +8985,7 @@ var patterns = {
 				types: [
 					"function"
 				],
-				description: "Render function for each item",
+				description: "Render function for each item. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.",
 				required: true,
 				kind: "callback",
 				callbackArgs: [
@@ -10426,7 +10427,7 @@ var patterns = {
 				types: [
 					"string"
 				],
-				description: "Input type - supports 'select' and 'textarea' in addition to standard types",
+				description: "Input type — 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",
@@ -14549,6 +14550,11 @@ var patterns = {
 								"number"
 							]
 						},
+						badge: {
+							types: [
+								"number"
+							]
+						},
 						x: {
 							types: [
 								"number"
@@ -14569,7 +14575,7 @@ var patterns = {
 				types: [
 					"array"
 				],
-				description: "Graph edges",
+				description: "Graph edges (the only rendered links)",
 				items: {
 					types: [
 						"object"
@@ -14607,6 +14613,39 @@ var patterns = {
 					]
 				}
 			},
+			similarity: {
+				types: [
+					"array"
+				],
+				description: "All-pairs similarity (cosine 0–1) used ONLY for layout, never drawn. It is the secondary macro-layout: non-connected pairs get a weak spring (higher cosine ⇒ 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"
@@ -14716,6 +14755,11 @@ var patterns = {
 										"number"
 									]
 								},
+								badge: {
+									types: [
+										"number"
+									]
+								},
 								x: {
 									types: [
 										"number"
@@ -14774,6 +14818,74 @@ var patterns = {
 										"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"
@@ -16794,7 +16906,7 @@ var patterns = {
 				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 — 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 — both names resolve to the same shape here. Pass either.",
 				items: {
 					types: [
 						"object"
@@ -17126,7 +17238,7 @@ var patterns = {
 				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 …={@item.field}/>), binding per-item fields via @item.field.",
 				kind: "callback",
 				callbackArgs: [
 					{
@@ -17239,7 +17351,7 @@ var patterns = {
 				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 — 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 — both names resolve to the same shape here. Pass either.",
 				items: {
 					types: [
 						"object"
@@ -17643,7 +17755,7 @@ var patterns = {
 				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 …={@item.field}/>), binding per-item fields via @item.field.",
 				kind: "callback",
 				callbackArgs: [
 					{
@@ -18677,6 +18789,12 @@ var patterns = {
 				],
 				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"
@@ -18864,7 +18982,7 @@ var patterns = {
 				types: [
 					"function"
 				],
-				description: "Render function for each slide",
+				description: "Render function for each slide. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.",
 				kind: "callback",
 				callbackArgs: [
 					{
@@ -19037,7 +19155,7 @@ var patterns = {
 				types: [
 					"function"
 				],
-				description: "renderItem prop",
+				description: "Render function for each item. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.",
 				required: true,
 				kind: "callback",
 				callbackArgs: [
@@ -33071,7 +33189,7 @@ var patterns = {
 				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 …={@item.field}/>), binding per-item fields via @item.field.",
 				kind: "callback",
 				callbackArgs: [
 					{
@@ -38699,31 +38817,31 @@ var patterns = {
 				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 → `radiusX` (a circle)."
+				description: "Ellipse vertical radius in world units; omitted → `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: [
@@ -38735,7 +38853,7 @@ var patterns = {
 				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"
@@ -40677,7 +40795,7 @@ var integratorsRegistry = {
 };
 
 var version$1 = "1.0.0";
-var exportedAt$1 = "2026-07-13T15:27:57.365Z";
+var exportedAt$1 = "2026-07-16T19:33:37.203Z";
 var mappings = {
 	"page-header": {
 		component: "PageHeader",
@@ -42034,7 +42152,7 @@ var componentMapping = {
 };
 
 var version = "1.0.0";
-var exportedAt = "2026-07-13T15:27:57.365Z";
+var exportedAt = "2026-07-16T19:33:37.203Z";
 var contracts = {
 	form: {
 		emits: [
@@ -43539,8 +43657,9 @@ declare function getPatternMetadata(patternType: string): PatternEntry$1 | null;
  * Get patterns allowed in .orb render-ui trees.
  *
  * Returns all non-entity patterns (atoms/molecules) plus the allowed
- * entity-aware exceptions (data-list, data-grid, search-input, form-section, meter).
- * Excludes game-specific, debug, and template patterns.
+ * entity-aware exceptions (data-list, data-grid, search-input, form-section,
+ * meter, table-view, filter-group, timeline, media-gallery).
+ * Excludes debug and template categories, plus any 3D-named patterns.
  *
  * Grouped by registry category with description and key props.
  */
@@ -43567,6 +43686,24 @@ declare function getOrbAllowedPatternsSlim(): string;
  */
 declare function getOrbAllowedPatternsFiltered(patternNames: string[]): string;
 
+/**
+ * Render-ui pattern-type collection over `.orb` IR — the ONE home for the
+ * walk both the free-mode coherence filter (rabit) and the facet ingest
+ * (calibrate) derive a behavior's rendered `type:` vocabulary from.
+ *
+ * Pure JSON traversal: no fs, no caching, no policy. `@`-prefixed type
+ * values (e.g. `@config.viewPattern`) are call-site config bindings resolved
+ * at compose time, not literal pattern types, and are skipped.
+ */
+
+/**
+ * Walk an `.orb` IR value collecting every `["render-ui", <slot>, <node>]`
+ * pattern node's literal `type:` tokens (including nested `children`).
+ */
+declare function collectRenderUiPatternTypes(ir: JsonValue, out: Set<string>): void;
+/** Convenience form: the distinct render-ui `type:` tokens of one `.orb` IR. */
+declare function renderUiPatternTypesOf(ir: JsonValue): ReadonlySet<string>;
+
 /**
  * Pattern Recommender
  *
@@ -44220,12 +44357,6 @@ declare const registry: {
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
-                entity: {
-                    types: string[];
-                    description: string;
-                    kind: string;
-                    cardinality: string;
-                };
                 className: {
                     types: string[];
                     description: string;
@@ -44291,6 +44422,12 @@ declare const registry: {
                         types: string[];
                     };
                 };
+                entity: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    cardinality: string;
+                };
                 minCardWidth: {
                     types: string[];
                     description: string;
@@ -52521,6 +52658,9 @@ declare const registry: {
                             size: {
                                 types: string[];
                             };
+                            badge: {
+                                types: string[];
+                            };
                             x: {
                                 types: string[];
                             };
@@ -52556,6 +52696,25 @@ declare const registry: {
                         required: string[];
                     };
                 };
+                similarity: {
+                    types: string[];
+                    description: string;
+                    items: {
+                        types: string[];
+                        properties: {
+                            source: {
+                                types: string[];
+                            };
+                            target: {
+                                types: string[];
+                            };
+                            weight: {
+                                types: string[];
+                            };
+                        };
+                        required: string[];
+                    };
+                };
                 height: {
                     types: string[];
                     description: string;
@@ -52624,6 +52783,9 @@ declare const registry: {
                                 size: {
                                     types: string[];
                                 };
+                                badge: {
+                                    types: string[];
+                                };
                                 x: {
                                     types: string[];
                                 };
@@ -52660,6 +52822,48 @@ declare const registry: {
                                 size: {
                                     types: string[];
                                 };
+                                badge: {
+                                    types: string[];
+                                };
+                                x: {
+                                    types: string[];
+                                };
+                                y: {
+                                    types: string[];
+                                };
+                            };
+                            required: string[];
+                        };
+                    }[];
+                };
+                onBadgeClick: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    callbackArgs: {
+                        name: string;
+                        type: string;
+                        schema: {
+                            types: string[];
+                            properties: {
+                                id: {
+                                    types: string[];
+                                };
+                                label: {
+                                    types: string[];
+                                };
+                                group: {
+                                    types: string[];
+                                };
+                                color: {
+                                    types: string[];
+                                };
+                                size: {
+                                    types: string[];
+                                };
+                                badge: {
+                                    types: string[];
+                                };
                                 x: {
                                     types: string[];
                                 };
@@ -55069,6 +55273,10 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                format: {
+                    types: string[];
+                    description: string;
+                };
                 className: {
                     types: string[];
                     description: string;
@@ -68451,12 +68659,6 @@ declare const PATTERN_REGISTRY: {
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
-                entity: {
-                    types: string[];
-                    description: string;
-                    kind: string;
-                    cardinality: string;
-                };
                 className: {
                     types: string[];
                     description: string;
@@ -68522,6 +68724,12 @@ declare const PATTERN_REGISTRY: {
                         types: string[];
                     };
                 };
+                entity: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    cardinality: string;
+                };
                 minCardWidth: {
                     types: string[];
                     description: string;
@@ -76752,6 +76960,9 @@ declare const PATTERN_REGISTRY: {
                             size: {
                                 types: string[];
                             };
+                            badge: {
+                                types: string[];
+                            };
                             x: {
                                 types: string[];
                             };
@@ -76787,6 +76998,25 @@ declare const PATTERN_REGISTRY: {
                         required: string[];
                     };
                 };
+                similarity: {
+                    types: string[];
+                    description: string;
+                    items: {
+                        types: string[];
+                        properties: {
+                            source: {
+                                types: string[];
+                            };
+                            target: {
+                                types: string[];
+                            };
+                            weight: {
+                                types: string[];
+                            };
+                        };
+                        required: string[];
+                    };
+                };
                 height: {
                     types: string[];
                     description: string;
@@ -76855,6 +77085,9 @@ declare const PATTERN_REGISTRY: {
                                 size: {
                                     types: string[];
                                 };
+                                badge: {
+                                    types: string[];
+                                };
                                 x: {
                                     types: string[];
                                 };
@@ -76891,6 +77124,48 @@ declare const PATTERN_REGISTRY: {
                                 size: {
                                     types: string[];
                                 };
+                                badge: {
+                                    types: string[];
+                                };
+                                x: {
+                                    types: string[];
+                                };
+                                y: {
+                                    types: string[];
+                                };
+                            };
+                            required: string[];
+                        };
+                    }[];
+                };
+                onBadgeClick: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    callbackArgs: {
+                        name: string;
+                        type: string;
+                        schema: {
+                            types: string[];
+                            properties: {
+                                id: {
+                                    types: string[];
+                                };
+                                label: {
+                                    types: string[];
+                                };
+                                group: {
+                                    types: string[];
+                                };
+                                color: {
+                                    types: string[];
+                                };
+                                size: {
+                                    types: string[];
+                                };
+                                badge: {
+                                    types: string[];
+                                };
                                 x: {
                                     types: string[];
                                 };
@@ -79300,6 +79575,10 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                format: {
+                    types: string[];
+                    description: string;
+                };
                 className: {
                     types: string[];
                     description: string;
@@ -94810,4 +95089,4 @@ declare function isDrawablePattern(patternType: string): boolean;
  */
 declare function isDrawHostPattern(patternType: string): boolean;
 
-export { COMPONENT_MAPPING, EVENT_CONTRACTS, 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 SelectionChangePayload, buildRecommendationContext, componentMapping, eventContracts, findCompatiblePatterns, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getEmittedEvents, getEntityCardinality, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integratorsRegistry, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, patternsRegistry, recommendPatterns, registry };
+export { COMPONENT_MAPPING, EVENT_CONTRACTS, 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 SelectionChangePayload, buildRecommendationContext, collectRenderUiPatternTypes, componentMapping, eventContracts, findCompatiblePatterns, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getEmittedEvents, getEntityCardinality, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integratorsRegistry, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, patternsRegistry, recommendPatterns, registry, renderUiPatternTypesOf };