@almadar/core 10.31.0 → 10.33.0

package/dist/patterns/component-mapping.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-07-21T09:54:57.379Z",
+  "exportedAt": "2026-07-24T05:10:33.187Z",
   "mappings": {
     "page-header": {
       "component": "PageHeader",

package/dist/patterns/event-contracts.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-07-21T09:54:57.379Z",
+  "exportedAt": "2026-07-24T05:10:33.187Z",
   "contracts": {
     "form": {
       "emits": [
@@ -1137,6 +1137,19 @@
       ],
       "requires": [],
       "entityAware": false
+    },
+    "data-grid": {
+      "emits": [
+        {
+          "event": "NAVIGATE",
+          "trigger": "action",
+          "payload": {
+            "type": "object"
+          }
+        }
+      ],
+      "requires": [],
+      "entityAware": true
     }
   }
 }

package/dist/patterns/index.d.ts

@@ -1,10 +1,10 @@
-import { F as FieldValue, ao as PatternType, J as JsonValue } from '../pattern-types-VDIr2TkX.js';
-export { A as AnyPatternConfig, ah as PATTERN_TYPES, al as PatternConfig, am as PatternProps, an as PatternPropsMap, bf as isValidPatternType } from '../pattern-types-VDIr2TkX.js';
-import { d as EventPayloadValue, E as EventPayload } from '../expression-CB9R3KWk.js';
+import { A as AnyPatternConfig, b1 as RenderBinding, F as FieldValue, aW as PatternType, J as JsonValue } from '../effect-D9WY6JgN.js';
+export { aP as PATTERN_TYPES, aT as PatternConfig, aU as PatternProps, aV as PatternPropsMap, cJ as isValidPatternType } from '../effect-D9WY6JgN.js';
+import { d as EventPayloadValue, a as EventPayload } from '../expression-DpAj1RzP.js';
 import 'zod';
 
 var version$3 = "1.0.0";
-var exportedAt$3 = "2026-07-21T09:54:57.379Z";
+var exportedAt$3 = "2026-07-24T05:10:33.187Z";
 var patterns = {
 	"entity-table": {
 		type: "entity-table",
@@ -3512,7 +3512,8 @@ var patterns = {
 				types: [
 					"string"
 				],
-				description: "Event name to dispatch on search (schema metadata, wired by trait) This is metadata used by the trait generator, not by the component."
+				description: "Declarative search event — emits UI:{event} via eventBus on query submit (alongside canonical UI:SEARCH)",
+				kind: "event"
 			},
 			entity: {
 				types: [
@@ -3672,6 +3673,20 @@ var patterns = {
 					"inline-column-header"
 				],
 				"default": "toolbar"
+			},
+			event: {
+				types: [
+					"string"
+				],
+				description: "Declarative filter event — emits UI:{event} via eventBus on filter change (alongside canonical UI:FILTER)",
+				kind: "event"
+			},
+			clearEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative clear event — emits UI:{clearEvent} via eventBus on clear-all (alongside canonical UI:CLEAR_FILTERS)",
+				kind: "event"
 			}
 		}
 	},
@@ -5751,9 +5766,9 @@ var patterns = {
 			},
 			title: {
 				types: [
-					"string"
+					"node"
 				],
-				description: "Drawer title"
+				description: "Drawer title (text or any node, e.g. a brand logo + name)."
 			},
 			children: {
 				types: [
@@ -9773,8 +9788,9 @@ var patterns = {
 				types: [
 					"string"
 				],
-				description: "Font weight override",
+				description: "Font weight override — `none` = no override, the variant's baked weight applies",
 				enumValues: [
+					"none",
 					"light",
 					"normal",
 					"medium",
@@ -9788,6 +9804,7 @@ var patterns = {
 				],
 				description: "Font size override",
 				enumValues: [
+					"none",
 					"xs",
 					"sm",
 					"md",
@@ -15281,37 +15298,7 @@ var patterns = {
 				types: [
 					"string"
 				],
-				description: "Programming language for syntax highlighting",
-				enumValues: [
-					"text",
-					"json",
-					"javascript",
-					"js",
-					"typescript",
-					"ts",
-					"jsx",
-					"tsx",
-					"css",
-					"markdown",
-					"md",
-					"bash",
-					"shell",
-					"sh",
-					"yaml",
-					"yml",
-					"rust",
-					"python",
-					"py",
-					"sql",
-					"diff",
-					"toml",
-					"go",
-					"graphql",
-					"html",
-					"xml",
-					"orb",
-					"lolo"
-				],
+				description: "Programming language for syntax highlighting (any Prism id; loaded on demand if not pre-registered)",
 				"default": "text"
 			},
 			showCopyButton: {
@@ -15512,6 +15499,58 @@ var patterns = {
 								"graphql",
 								"html",
 								"xml",
+								"clojure",
+								"clj",
+								"edn",
+								"haskell",
+								"hs",
+								"lisp",
+								"scheme",
+								"scala",
+								"elixir",
+								"ex",
+								"exs",
+								"erlang",
+								"erl",
+								"elm",
+								"fsharp",
+								"fs",
+								"fsx",
+								"ocaml",
+								"ml",
+								"java",
+								"c",
+								"cpp",
+								"c++",
+								"cc",
+								"cxx",
+								"hpp",
+								"h",
+								"csharp",
+								"cs",
+								"objectivec",
+								"objc",
+								"php",
+								"ruby",
+								"rb",
+								"swift",
+								"kotlin",
+								"kt",
+								"lua",
+								"r",
+								"dart",
+								"julia",
+								"fortran",
+								"f90",
+								"f95",
+								"perl",
+								"pl",
+								"powershell",
+								"ps1",
+								"makefile",
+								"make",
+								"nginx",
+								"ini",
 								"orb",
 								"lolo"
 							]
@@ -17168,6 +17207,11 @@ var patterns = {
 								"string"
 							]
 						},
+						navigatesTo: {
+							types: [
+								"string"
+							]
+						},
 						icon: {
 							types: [
 								"icon",
@@ -17187,8 +17231,7 @@ var patterns = {
 						}
 					},
 					required: [
-						"label",
-						"event"
+						"label"
 					]
 				}
 			},
@@ -17328,7 +17371,7 @@ var patterns = {
 				types: [
 					"function"
 				],
-				description: "Render prop for custom per-card content. When provided, `fields` and `itemActions` are ignored.",
+				description: "Render prop for custom per-card content. When provided, `fields` are ignored; `itemActions` render as a footer beneath the custom content.",
 				kind: "callback",
 				callbackArgs: [
 					{
@@ -34100,22 +34143,6 @@ var patterns = {
 				items: {
 					types: [
 						"object"
-					],
-					properties: {
-						type: {
-							types: [
-								"unknown"
-							]
-						},
-						content: {
-							types: [
-								"string"
-							]
-						}
-					},
-					required: [
-						"type",
-						"content"
 					]
 				}
 			},
@@ -34135,34 +34162,7 @@ var patterns = {
 				types: [
 					"object"
 				],
-				description: "User progress for restoring activation/reflection state",
-				properties: {
-					activationResponse: {
-						types: [
-							"string"
-						]
-					},
-					reflectionNotes: {
-						types: [
-							"array"
-						],
-						items: {
-							types: [
-								"string"
-							]
-						}
-					},
-					bloomAnswered: {
-						types: [
-							"object"
-						],
-						mapValue: {
-							types: [
-								"boolean"
-							]
-						}
-					}
-				}
+				description: "User progress for restoring activation/reflection state"
 			},
 			onRunCodeSimulation: {
 				types: [
@@ -34191,7 +34191,7 @@ var patterns = {
 				callbackArgs: [
 					{
 						name: "type",
-						type: "string"
+						type: "object"
 					},
 					{
 						name: "description",
@@ -41119,7 +41119,7 @@ var integratorsRegistry = {
 };
 
 var version$1 = "1.0.0";
-var exportedAt$1 = "2026-07-21T09:54:57.379Z";
+var exportedAt$1 = "2026-07-24T05:10:33.187Z";
 var mappings = {
 	"page-header": {
 		component: "PageHeader",
@@ -42486,7 +42486,7 @@ var componentMapping = {
 };
 
 var version = "1.0.0";
-var exportedAt = "2026-07-21T09:54:57.379Z";
+var exportedAt = "2026-07-24T05:10:33.187Z";
 var contracts = {
 	form: {
 		emits: [
@@ -43672,6 +43672,20 @@ var contracts = {
 		requires: [
 		],
 		entityAware: false
+	},
+	"data-grid": {
+		emits: [
+			{
+				event: "NAVIGATE",
+				trigger: "action",
+				payload: {
+					type: "object"
+				}
+			}
+		],
+		requires: [
+		],
+		entityAware: true
 	}
 };
 var eventContracts = {
@@ -43680,6 +43694,38 @@ var eventContracts = {
 	contracts: contracts
 };
 
+/**
+ * Content-grade classification of render-ui patterns — the single owner of
+ * "is this pattern a content body", so the wiring lint, the slot layer, and
+ * future consumers never grow private lists.
+ *
+ * Registry-derived, not a name list: a pattern TYPE is a content body when
+ * its registry entry declares a data inlet — a propsSchema prop stamped
+ * `kind: 'entity'` by pattern-sync from the prop's `EntityRecord<T>` /
+ * `EntityCollection<T>` type identity (the declared signal that replaces
+ * name-matching; see PropKind in `./types.js`). A pattern INSTANCE is a
+ * content body when it is a bound body tree (`@config.denseBodyContent`),
+ * a composite with children, or of a content-body type. Chrome (icons,
+ * buttons, nav, inputs) declares no inlet, so it needs no enumeration.
+ *
+ * Declared-coverage boundary: viz patterns whose data props are not
+ * `EntityRecord`-typed (`chart`, `stat-display`, `stats-grid`, `graph-view`)
+ * carry no `kind: 'entity'` inlet today, so a BARE viz write (no children)
+ * classifies as chrome. In practice dashboards compose viz under a parent
+ * with children, which the composite branch catches. Stamping those props
+ * is a pattern-sync/core decision, not a consumer list.
+ */
+
+/** The third element of a `render-ui` effect tuple. */
+type RenderUiPayload = AnyPatternConfig | RenderBinding | null;
+/** True when the pattern type declares a data inlet — any propsSchema prop
+ *  stamped `kind: 'entity'` from the prop's `EntityRecord`/`EntityCollection`
+ *  type identity. Declared in the registry, never name-matched. */
+declare function isContentBodyPatternType(patternType: string): boolean;
+declare function isContentBodyPattern(pattern: RenderUiPayload): boolean;
+/** Type guard for a `['render-ui', 'main', payload]` effect tuple. */
+declare function isMainSlotRenderUi(effect: unknown): effect is ['render-ui', 'main', RenderUiPayload];
+
 /**
  * Shared types for @almadar/patterns
  *
@@ -46291,6 +46337,7 @@ declare const registry: {
                 event: {
                     types: string[];
                     description: string;
+                    kind: string;
                 };
                 entity: {
                     types: string[];
@@ -46388,6 +46435,16 @@ declare const registry: {
                     enumValues: string[];
                     default: string;
                 };
+                event: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                };
+                clearEvent: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                };
             };
         };
         tabs: {
@@ -53488,7 +53545,6 @@ declare const registry: {
                 language: {
                     types: string[];
                     description: string;
-                    enumValues: string[];
                     default: string;
                 };
                 showCopyButton: {
@@ -54651,6 +54707,9 @@ declare const registry: {
                             event: {
                                 types: string[];
                             };
+                            navigatesTo: {
+                                types: string[];
+                            };
                             icon: {
                                 types: string[];
                             };
@@ -65050,15 +65109,6 @@ declare const registry: {
                     required: boolean;
                     items: {
                         types: string[];
-                        properties: {
-                            type: {
-                                types: string[];
-                            };
-                            content: {
-                                types: string[];
-                            };
-                        };
-                        required: string[];
                     };
                 };
                 className: {
@@ -65072,23 +65122,6 @@ declare const registry: {
                 userProgress: {
                     types: string[];
                     description: string;
-                    properties: {
-                        activationResponse: {
-                            types: string[];
-                        };
-                        reflectionNotes: {
-                            types: string[];
-                            items: {
-                                types: string[];
-                            };
-                        };
-                        bloomAnswered: {
-                            types: string[];
-                            mapValue: {
-                                types: string[];
-                            };
-                        };
-                    };
                 };
                 onRunCodeSimulation: {
                     types: string[];
@@ -70968,6 +71001,7 @@ declare const PATTERN_REGISTRY: {
                 event: {
                     types: string[];
                     description: string;
+                    kind: string;
                 };
                 entity: {
                     types: string[];
@@ -71065,6 +71099,16 @@ declare const PATTERN_REGISTRY: {
                     enumValues: string[];
                     default: string;
                 };
+                event: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                };
+                clearEvent: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                };
             };
         };
         tabs: {
@@ -78165,7 +78209,6 @@ declare const PATTERN_REGISTRY: {
                 language: {
                     types: string[];
                     description: string;
-                    enumValues: string[];
                     default: string;
                 };
                 showCopyButton: {
@@ -79328,6 +79371,9 @@ declare const PATTERN_REGISTRY: {
                             event: {
                                 types: string[];
                             };
+                            navigatesTo: {
+                                types: string[];
+                            };
                             icon: {
                                 types: string[];
                             };
@@ -89727,15 +89773,6 @@ declare const PATTERN_REGISTRY: {
                     required: boolean;
                     items: {
                         types: string[];
-                        properties: {
-                            type: {
-                                types: string[];
-                            };
-                            content: {
-                                types: string[];
-                            };
-                        };
-                        required: string[];
                     };
                 };
                 className: {
@@ -89749,23 +89786,6 @@ declare const PATTERN_REGISTRY: {
                 userProgress: {
                     types: string[];
                     description: string;
-                    properties: {
-                        activationResponse: {
-                            types: string[];
-                        };
-                        reflectionNotes: {
-                            types: string[];
-                            items: {
-                                types: string[];
-                            };
-                        };
-                        bloomAnswered: {
-                            types: string[];
-                            mapValue: {
-                                types: string[];
-                            };
-                        };
-                    };
                 };
                 onRunCodeSimulation: {
                     types: string[];
@@ -96118,6 +96138,17 @@ declare const EVENT_CONTRACTS: {
             requires: never[];
             entityAware: boolean;
         };
+        "data-grid": {
+            emits: {
+                event: string;
+                trigger: string;
+                payload: {
+                    type: string;
+                };
+            }[];
+            requires: never[];
+            entityAware: boolean;
+        };
     };
 };
 
@@ -96190,4 +96221,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, 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 };
+export { AnyPatternConfig, 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 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 };