@almadar/core 10.73.0 → 10.74.0

package/dist/mock/index.d.ts

@@ -1,7 +1,7 @@
-import { O as OrbitalSchema } from '../schema-CDlk_DCx.js';
-export { E as EntityAccessPolicies, e as entityAccessPolicies, a as entityAccessTable } from '../entityAccess-BaGu3lyD.js';
-import { a as EntityPersistence, E as EntityField, F as FieldValue, f as EntityRow } from '../effect-B7xqqEFo.js';
-import '../trait-Cc-SAgVU.js';
+import { O as OrbitalSchema } from '../schema-DJY7OUOM.js';
+export { E as EntityAccessPolicies, e as entityAccessPolicies, a as entityAccessTable } from '../entityAccess-CpfvoNOd.js';
+import { a as EntityPersistence, E as EntityField, F as FieldValue, f as EntityRow } from '../effect-C0MRXCwF.js';
+import '../trait-D1zKrxnf.js';
 import '../expression-Fk8bQWef.js';
 import 'zod';
 

package/dist/patterns/component-mapping.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-08-29T08:05:11.231Z",
+  "exportedAt": "2026-08-29T18:15:51.642Z",
   "mappings": {
     "page-header": {
       "component": "PageHeader",

package/dist/patterns/event-contracts.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-08-29T08:05:11.231Z",
+  "exportedAt": "2026-08-29T18:15:51.642Z",
   "contracts": {
     "form": {
       "emits": [

package/dist/patterns/index.d.ts

@@ -1,10 +1,10 @@
-import { A as AnyPatternConfig, h as RenderBinding, F as FieldValue, b0 as PatternType } from '../effect-B7xqqEFo.js';
-export { aV as PATTERN_TYPES, aZ as PatternConfig, a_ as PatternProps, a$ as PatternPropsMap, cT as isValidPatternType } from '../effect-B7xqqEFo.js';
+import { A as AnyPatternConfig, h as RenderBinding, F as FieldValue, b0 as PatternType } from '../effect-C0MRXCwF.js';
+export { aV as PATTERN_TYPES, aZ as PatternConfig, a_ as PatternProps, a$ as PatternPropsMap, cT as isValidPatternType } from '../effect-C0MRXCwF.js';
 import { d as EventPayloadValue, a as EventPayload, J as JsonValue } from '../expression-Fk8bQWef.js';
 import 'zod';
 
 var version$3 = "1.0.0";
-var exportedAt$3 = "2026-08-29T08:05:11.231Z";
+var exportedAt$3 = "2026-08-29T18:15:51.642Z";
 var patterns = {
 	"entity-table": {
 		type: "entity-table",
@@ -13360,6 +13360,12 @@ var patterns = {
 				],
 				description: "Custom sidebar footer (optional). When omitted, the sidebar has no footer — apps that need Settings/etc. add them via navItems."
 			},
+			sidebarContent: {
+				types: [
+					"node"
+				],
+				description: "Optional content region rendered between the nav links and the footer — a page tree or any consumer navigation surface; scrolls independently and takes the sidebar's remaining height. Hidden in the collapsed rail."
+			},
 			currentPath: {
 				types: [
 					"string"
@@ -25442,6 +25448,23 @@ var patterns = {
 				],
 				description: "Currently selected file path"
 			},
+			selectedId: {
+				types: [
+					"string"
+				],
+				description: "Currently selected node id, in flat `items` mode: the row highlights and every ancestor auto-expands so the selection is always visible — the \"you are here\" a navigation tree needs."
+			},
+			look: {
+				types: [
+					"string"
+				],
+				description: "Visual treatment for flat `items` mode: `files` (default) keeps the monospace file-browser look; `nav` renders a sidebar navigation tree — regular font, document icons, roomier hit areas.",
+				enumValues: [
+					"files",
+					"nav"
+				],
+				"default": "files"
+			},
 			onFileSelect: {
 				types: [
 					"function"
@@ -25469,6 +25492,32 @@ var patterns = {
 				],
 				"default": ""
 			},
+			onNodeAction: {
+				types: [
+					"function"
+				],
+				description: "Called from the row's hover action button, in flat `items` mode; carries that node's id. Presence-gated: binding it renders the action.",
+				kind: "callback",
+				callbackArgs: [
+					{
+						name: "id",
+						type: "string"
+					}
+				],
+				"default": ""
+			},
+			nodeActionIcon: {
+				types: [
+					"string"
+				],
+				description: "Icon for the row hover action (default: plus)."
+			},
+			nodeActionLabel: {
+				types: [
+					"string"
+				],
+				description: "Accessible label/tooltip for the row hover action."
+			},
 			className: {
 				types: [
 					"string"
@@ -51187,7 +51236,7 @@ var integratorsRegistry = {
 };
 
 var version$1 = "1.0.0";
-var exportedAt$1 = "2026-08-29T08:05:11.231Z";
+var exportedAt$1 = "2026-08-29T18:15:51.642Z";
 var mappings = {
 	"page-header": {
 		component: "PageHeader",
@@ -52609,7 +52658,7 @@ var componentMapping = {
 };
 
 var version = "1.0.0";
-var exportedAt = "2026-08-29T08:05:11.231Z";
+var exportedAt = "2026-08-29T18:15:51.642Z";
 var contracts = {
 	form: {
 		emits: [
@@ -62464,6 +62513,10 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                sidebarContent: {
+                    types: string[];
+                    description: string;
+                };
                 currentPath: {
                     types: string[];
                     description: string;
@@ -69880,6 +69933,16 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                selectedId: {
+                    types: string[];
+                    description: string;
+                };
+                look: {
+                    types: string[];
+                    description: string;
+                    enumValues: string[];
+                    default: string;
+                };
                 onFileSelect: {
                     types: string[];
                     description: string;
@@ -69899,6 +69962,24 @@ declare const registry: {
                     }[];
                     default: string;
                 };
+                onNodeAction: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    callbackArgs: {
+                        name: string;
+                        type: string;
+                    }[];
+                    default: string;
+                };
+                nodeActionIcon: {
+                    types: string[];
+                    description: string;
+                };
+                nodeActionLabel: {
+                    types: string[];
+                    description: string;
+                };
                 className: {
                     types: string[];
                     description: string;
@@ -91693,6 +91774,10 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                sidebarContent: {
+                    types: string[];
+                    description: string;
+                };
                 currentPath: {
                     types: string[];
                     description: string;
@@ -99109,6 +99194,16 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                selectedId: {
+                    types: string[];
+                    description: string;
+                };
+                look: {
+                    types: string[];
+                    description: string;
+                    enumValues: string[];
+                    default: string;
+                };
                 onFileSelect: {
                     types: string[];
                     description: string;
@@ -99128,6 +99223,24 @@ declare const PATTERN_REGISTRY: {
                     }[];
                     default: string;
                 };
+                onNodeAction: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    callbackArgs: {
+                        name: string;
+                        type: string;
+                    }[];
+                    default: string;
+                };
+                nodeActionIcon: {
+                    types: string[];
+                    description: string;
+                };
+                nodeActionLabel: {
+                    types: string[];
+                    description: string;
+                };
                 className: {
                     types: string[];
                     description: string;

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-29T08:05:11.231Z",
+  exportedAt: "2026-08-29T18:15:51.642Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -13304,6 +13304,12 @@ var patterns_registry_default = {
           ],
           description: "Custom sidebar footer (optional). When omitted, the sidebar has no footer \u2014 apps that need Settings/etc. add them via navItems."
         },
+        sidebarContent: {
+          types: [
+            "node"
+          ],
+          description: "Optional content region rendered between the nav links and the footer \u2014 a page tree or any consumer navigation surface; scrolls independently and takes the sidebar's remaining height. Hidden in the collapsed rail."
+        },
         currentPath: {
           types: [
             "string"
@@ -25371,6 +25377,23 @@ var patterns_registry_default = {
           ],
           description: "Currently selected file path"
         },
+        selectedId: {
+          types: [
+            "string"
+          ],
+          description: 'Currently selected node id, in flat `items` mode: the row highlights and every ancestor auto-expands so the selection is always visible \u2014 the "you are here" a navigation tree needs.'
+        },
+        look: {
+          types: [
+            "string"
+          ],
+          description: "Visual treatment for flat `items` mode: `files` (default) keeps the monospace file-browser look; `nav` renders a sidebar navigation tree \u2014 regular font, document icons, roomier hit areas.",
+          enumValues: [
+            "files",
+            "nav"
+          ],
+          default: "files"
+        },
         onFileSelect: {
           types: [
             "function"
@@ -25398,6 +25421,32 @@ var patterns_registry_default = {
           ],
           default: ""
         },
+        onNodeAction: {
+          types: [
+            "function"
+          ],
+          description: "Called from the row's hover action button, in flat `items` mode; carries that node's id. Presence-gated: binding it renders the action.",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "id",
+              type: "string"
+            }
+          ],
+          default: ""
+        },
+        nodeActionIcon: {
+          types: [
+            "string"
+          ],
+          description: "Icon for the row hover action (default: plus)."
+        },
+        nodeActionLabel: {
+          types: [
+            "string"
+          ],
+          description: "Accessible label/tooltip for the row hover action."
+        },
         className: {
           types: [
             "string"
@@ -51043,7 +51092,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-08-29T08:05:11.231Z",
+  exportedAt: "2026-08-29T18:15:51.642Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -52463,7 +52512,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-08-29T08:05:11.231Z",
+  exportedAt: "2026-08-29T18:15:51.642Z",
   contracts: {
     form: {
       emits: [