@almadar/core 10.72.0 → 10.74.0

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-28T23:51:47.246Z",
+  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"
@@ -47775,6 +47824,19 @@ var patterns_registry_default = {
           ],
           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"
@@ -47939,6 +48001,7 @@ var patterns_registry_default = {
       family: "core",
       description: "DocumentDetails \u2014 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",
@@ -47998,7 +48061,8 @@ var patterns_registry_default = {
                   "text",
                   "boolean",
                   "select",
-                  "readonly"
+                  "readonly",
+                  "image"
                 ]
               },
               options: {
@@ -48022,6 +48086,11 @@ var patterns_registry_default = {
                   "boolean",
                   "percent"
                 ]
+              },
+              type: {
+                types: [
+                  "string"
+                ]
               }
             }
           }
@@ -48045,6 +48114,30 @@ var patterns_registry_default = {
             }
           ]
         },
+        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 \u2014 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"
@@ -48083,7 +48176,7 @@ var patterns_registry_default = {
 // src/patterns/integrators-registry.json
 var integrators_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-08-23T09:11:28.111Z",
+  exportedAt: "2026-08-29T08:09:09.100Z",
   integrators: {
     github: {
       name: "github",
@@ -49873,6 +49966,40 @@ var integrators_registry_default = {
             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: "",
@@ -50965,7 +51092,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-08-28T23:51:47.246Z",
+  exportedAt: "2026-08-29T18:15:51.642Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -52385,7 +52512,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-08-28T23:51:47.246Z",
+  exportedAt: "2026-08-29T18:15:51.642Z",
   contracts: {
     form: {
       emits: [