@almadar/core 10.72.0 → 10.74.0

package/dist/mock/index.d.ts

@@ -1,7 +1,7 @@
-import { O as OrbitalSchema } from '../schema-8n8qR2Rb.js';
-export { E as EntityAccessPolicies, e as entityAccessPolicies, a as entityAccessTable } from '../entityAccess-OcrfCefK.js';
-import { a as EntityPersistence, E as EntityField, F as FieldValue, f as EntityRow } from '../effect-BftJTKJZ.js';
-import '../trait-BRv7XO6_.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-28T23:51:47.246Z",
+  "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-28T23:51:47.246Z",
+  "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-BftJTKJZ.js';
-export { aV as PATTERN_TYPES, aZ as PatternConfig, a_ as PatternProps, a$ as PatternPropsMap, cT as isValidPatternType } from '../effect-BftJTKJZ.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-28T23:51:47.246Z";
+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"
@@ -47907,6 +47956,19 @@ var patterns = {
 				],
 				description: "Muted byline under the title; hidden when empty"
 			},
+			coverImage: {
+				types: [
+					"string"
+				],
+				description: "Cover/hero image URL painted as a full-bleed banner above the header row (Notion/article-hero shape); hidden when empty"
+			},
+			icon: {
+				types: [
+					"icon",
+					"string"
+				],
+				description: "Document icon rendered beside the title (a file glyph, a domain icon); hidden when empty"
+			},
 			value: {
 				types: [
 					"string"
@@ -48071,6 +48133,7 @@ var patterns = {
 		family: "core",
 		description: "DocumentDetails — the document's metadata as a compact settings card for the rail beside a DocumentPanel, each property committing in place.",
 		capabilities: "document settings, page details, post settings sidebar, metadata panel, document properties, publish settings",
+		fieldsContract: "display",
 		suggestedFor: [
 			"document",
 			"details",
@@ -48130,7 +48193,8 @@ var patterns = {
 								"text",
 								"boolean",
 								"select",
-								"readonly"
+								"readonly",
+								"image"
 							]
 						},
 						options: {
@@ -48154,6 +48218,11 @@ var patterns = {
 								"boolean",
 								"percent"
 							]
+						},
+						type: {
+							types: [
+								"string"
+							]
 						}
 					}
 				}
@@ -48177,6 +48246,30 @@ var patterns = {
 					}
 				]
 			},
+			relationEvent: {
+				types: [
+					"string"
+				],
+				description: "Makes relation chips clickable: emitted with { field, id, name } when a hydrated relation value (or one row of a many-relation) is clicked — the host routes it to the linked record's own surface.",
+				kind: "event-ref",
+				emitPayloadSchema: [
+					{
+						name: "field",
+						type: "string",
+						required: true
+					},
+					{
+						name: "id",
+						type: "string",
+						required: true
+					},
+					{
+						name: "name",
+						type: "string",
+						required: true
+					}
+				]
+			},
 			title: {
 				types: [
 					"string"
@@ -48218,7 +48311,7 @@ var patternsRegistry = {
 };
 
 var version$2 = "1.0.0";
-var exportedAt$2 = "2026-08-23T09:11:28.111Z";
+var exportedAt$2 = "2026-08-29T08:09:09.100Z";
 var integrators = {
 	github: {
 		name: "github",
@@ -50010,6 +50103,40 @@ var integrators = {
 					url: "string"
 				}
 			},
+			{
+				name: "uploadMany",
+				description: "",
+				params: [
+					{
+						name: "bucket",
+						type: "string",
+						required: true,
+						description: ""
+					},
+					{
+						name: "files",
+						type: "array",
+						required: true,
+						description: ""
+					},
+					{
+						name: "acl",
+						type: "'public' | 'private'",
+						required: false,
+						description: ""
+					},
+					{
+						name: "maxSize",
+						type: "number",
+						required: false,
+						description: ""
+					}
+				],
+				responseShape: {
+					items: "array",
+					count: "number"
+				}
+			},
 			{
 				name: "download",
 				description: "",
@@ -51109,7 +51236,7 @@ var integratorsRegistry = {
 };
 
 var version$1 = "1.0.0";
-var exportedAt$1 = "2026-08-28T23:51:47.246Z";
+var exportedAt$1 = "2026-08-29T18:15:51.642Z";
 var mappings = {
 	"page-header": {
 		component: "PageHeader",
@@ -52531,7 +52658,7 @@ var componentMapping = {
 };
 
 var version = "1.0.0";
-var exportedAt = "2026-08-28T23:51:47.246Z";
+var exportedAt = "2026-08-29T18:15:51.642Z";
 var contracts = {
 	form: {
 		emits: [
@@ -62386,6 +62513,10 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                sidebarContent: {
+                    types: string[];
+                    description: string;
+                };
                 currentPath: {
                     types: string[];
                     description: string;
@@ -69802,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;
@@ -69821,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;
@@ -83298,6 +83457,14 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                coverImage: {
+                    types: string[];
+                    description: string;
+                };
+                icon: {
+                    types: string[];
+                    description: string;
+                };
                 value: {
                     types: string[];
                     description: string;
@@ -83405,6 +83572,7 @@ declare const registry: {
             family: string;
             description: string;
             capabilities: string;
+            fieldsContract: string;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -83449,6 +83617,9 @@ declare const registry: {
                                 types: string[];
                                 enumValues: string[];
                             };
+                            type: {
+                                types: string[];
+                            };
                         };
                     };
                 };
@@ -83462,6 +83633,16 @@ declare const registry: {
                         required: boolean;
                     }[];
                 };
+                relationEvent: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    emitPayloadSchema: {
+                        name: string;
+                        type: string;
+                        required: boolean;
+                    }[];
+                };
                 title: {
                     types: string[];
                     description: string;
@@ -91593,6 +91774,10 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                sidebarContent: {
+                    types: string[];
+                    description: string;
+                };
                 currentPath: {
                     types: string[];
                     description: string;
@@ -99009,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;
@@ -99028,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;
@@ -112505,6 +112718,14 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                coverImage: {
+                    types: string[];
+                    description: string;
+                };
+                icon: {
+                    types: string[];
+                    description: string;
+                };
                 value: {
                     types: string[];
                     description: string;
@@ -112612,6 +112833,7 @@ declare const PATTERN_REGISTRY: {
             family: string;
             description: string;
             capabilities: string;
+            fieldsContract: string;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
@@ -112656,6 +112878,9 @@ declare const PATTERN_REGISTRY: {
                                 types: string[];
                                 enumValues: string[];
                             };
+                            type: {
+                                types: string[];
+                            };
                         };
                     };
                 };
@@ -112669,6 +112894,16 @@ declare const PATTERN_REGISTRY: {
                         required: boolean;
                     }[];
                 };
+                relationEvent: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    emitPayloadSchema: {
+                        name: string;
+                        type: string;
+                        required: boolean;
+                    }[];
+                };
                 title: {
                     types: string[];
                     description: string;
@@ -113821,6 +114056,35 @@ declare const INTEGRATORS_REGISTRY: {
                     etag: string;
                     id: string;
                     url: string;
+                    items?: undefined;
+                    count?: undefined;
+                    content?: undefined;
+                    contentType?: undefined;
+                    metadata?: undefined;
+                    keys?: undefined;
+                    truncated?: undefined;
+                    nextToken?: undefined;
+                    deleted?: undefined;
+                    expiresAt?: undefined;
+                };
+            } | {
+                name: string;
+                description: string;
+                params: {
+                    name: string;
+                    type: string;
+                    required: boolean;
+                    description: string;
+                }[];
+                responseShape: {
+                    items: string;
+                    count: string;
+                    key?: undefined;
+                    bucket?: undefined;
+                    size?: undefined;
+                    etag?: undefined;
+                    id?: undefined;
+                    url?: undefined;
                     content?: undefined;
                     contentType?: undefined;
                     metadata?: undefined;
@@ -113849,6 +114113,8 @@ declare const INTEGRATORS_REGISTRY: {
                     etag?: undefined;
                     id?: undefined;
                     url?: undefined;
+                    items?: undefined;
+                    count?: undefined;
                     keys?: undefined;
                     truncated?: undefined;
                     nextToken?: undefined;
@@ -113874,6 +114140,8 @@ declare const INTEGRATORS_REGISTRY: {
                     etag?: undefined;
                     id?: undefined;
                     url?: undefined;
+                    items?: undefined;
+                    count?: undefined;
                     content?: undefined;
                     contentType?: undefined;
                     metadata?: undefined;
@@ -113897,6 +114165,8 @@ declare const INTEGRATORS_REGISTRY: {
                     etag?: undefined;
                     id?: undefined;
                     url?: undefined;
+                    items?: undefined;
+                    count?: undefined;
                     content?: undefined;
                     contentType?: undefined;
                     metadata?: undefined;
@@ -113922,6 +114192,8 @@ declare const INTEGRATORS_REGISTRY: {
                     size?: undefined;
                     etag?: undefined;
                     id?: undefined;
+                    items?: undefined;
+                    count?: undefined;
                     content?: undefined;
                     contentType?: undefined;
                     metadata?: undefined;