@almadar/core 10.105.0 → 10.107.0

package/dist/factory/index.js

@@ -10360,6 +10360,11 @@ var patterns_registry_default = {
                 ],
                 kind: "event"
               },
+              href: {
+                types: [
+                  "string"
+                ]
+              },
               url: {
                 types: [
                   "string"
@@ -13002,6 +13007,7 @@ var patterns_registry_default = {
     header: {
       type: "header",
       category: "header",
+      sourceFile: "components/core/molecules/Header.tsx",
       tier: "molecules",
       family: "core",
       description: "Header Organism Component  A header component for mobile/responsive layouts with menu toggle, brand, and user avatar. Styled to match the main Layout component's mobile header.",
@@ -13070,6 +13076,18 @@ var patterns_registry_default = {
                 types: [
                   "boolean"
                 ]
+              },
+              children: {
+                types: [
+                  "array"
+                ],
+                items: {
+                  types: [
+                    "object"
+                  ],
+                  cyclic: true,
+                  cyclicTypeName: "HeaderNavigationItem"
+                }
               }
             },
             required: [
@@ -24909,9 +24927,11 @@ var patterns_registry_default = {
     "version-diff": {
       type: "version-diff",
       category: "display",
+      sourceFile: "components/core/molecules/VersionDiff.tsx",
       tier: "molecules",
       family: "core",
-      description: "VersionDiff component",
+      description: "A line diff between two versions \u2014 two whole texts, or a pre-computed diff such as one commit.",
+      capabilities: "version diff, compare revisions, what changed, before and after, code diff, commit diff, revision comparison",
       suggestedFor: [
         "version",
         "diff",
@@ -24925,7 +24945,6 @@ var patterns_registry_default = {
             "object"
           ],
           description: "All available revisions (at least 2). Accepts either a typed array (direct consumers) or the runtime payload shape from a render-ui binding (`@payload.revisions`). Narrowed to `[]` internally when the value isn't an array.",
-          required: true,
           items: {
             types: [
               "object"
@@ -24964,6 +24983,70 @@ var patterns_registry_default = {
             ]
           }
         },
+        hunks: {
+          types: [
+            "array"
+          ],
+          description: "A pre-computed diff to render instead of diffing `revisions` (no revision pickers).",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              header: {
+                types: [
+                  "string"
+                ]
+              },
+              lines: {
+                types: [
+                  "array"
+                ],
+                items: {
+                  types: [
+                    "object"
+                  ],
+                  properties: {
+                    type: {
+                      types: [
+                        "string"
+                      ],
+                      enumValues: [
+                        "added",
+                        "removed",
+                        "unchanged",
+                        "context"
+                      ]
+                    },
+                    beforeLineNumber: {
+                      types: [
+                        "number"
+                      ]
+                    },
+                    afterLineNumber: {
+                      types: [
+                        "number"
+                      ]
+                    },
+                    content: {
+                      types: [
+                        "string"
+                      ]
+                    }
+                  },
+                  required: [
+                    "type",
+                    "content"
+                  ]
+                }
+              }
+            },
+            required: [
+              "header",
+              "lines"
+            ]
+          }
+        },
         beforeId: {
           types: [
             "string"
@@ -24980,7 +25063,7 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Display mode.",
+          description: "Display mode to start in; the toggle switches it.",
           enumValues: [
             "side-by-side",
             "inline"
@@ -49776,6 +49859,7 @@ var patterns_registry_default = {
     "dock-layout": {
       type: "dock-layout",
       category: "layout",
+      sourceFile: "components/core/organisms/layout/DockLayout.tsx",
       tier: "organisms",
       family: "core",
       description: "DockLayout component",
@@ -49827,8 +49911,7 @@ var patterns_registry_default = {
           types: [
             "number"
           ],
-          description: "Width of `rail` in pixels. @default 56",
-          default: 56
+          description: "Width of `rail` in pixels; the rail sizes the column itself when omitted."
         },
         secondarySidebarWidth: {
           types: [
@@ -49841,8 +49924,7 @@ var patterns_registry_default = {
           types: [
             "boolean"
           ],
-          description: "Whether `sidebar` is collapsed. @default false",
-          default: false
+          description: "Whether `sidebar` is collapsed. @default false"
         },
         onSidebarCollapsedChange: {
           types: [
@@ -49888,8 +49970,7 @@ var patterns_registry_default = {
           types: [
             "boolean"
           ],
-          description: "Whether `bottomPanel` is collapsed. @default false",
-          default: false
+          description: "Whether `bottomPanel` is collapsed. @default false"
         },
         onBottomPanelCollapsedChange: {
           types: [
@@ -49935,8 +50016,7 @@ var patterns_registry_default = {
           types: [
             "boolean"
           ],
-          description: "Whether `secondarySidebar` is collapsed. @default false",
-          default: false
+          description: "Whether `secondarySidebar` is collapsed. @default false"
         },
         onSecondarySidebarCollapsedChange: {
           types: [
@@ -49951,6 +50031,44 @@ var patterns_registry_default = {
             }
           ]
         },
+        compact: {
+          types: [
+            "boolean"
+          ],
+          description: "The mobile variant; decided by the viewport (narrower than 1024px) when omitted."
+        },
+        secondarySidebarLabel: {
+          types: [
+            "string"
+          ],
+          description: 'Compact: the top-bar button that opens `secondarySidebar` (e.g. "Inspector", "Chat").'
+        },
+        secondarySidebarIcon: {
+          types: [
+            "icon",
+            "string"
+          ],
+          description: "secondarySidebarIcon prop"
+        },
+        bottomPanelLabel: {
+          types: [
+            "string"
+          ],
+          description: "Compact: the top-bar button that opens `bottomPanel`."
+        },
+        bottomPanelIcon: {
+          types: [
+            "icon",
+            "string"
+          ],
+          description: "bottomPanelIcon prop"
+        },
+        topBarActions: {
+          types: [
+            "node"
+          ],
+          description: "Compact: the host's own actions at the end of the top bar (e.g. Run)."
+        },
         className: {
           types: [
             "string"
@@ -51221,6 +51339,531 @@ var patterns_registry_default = {
           description: "className prop"
         }
       }
+    },
+    "icon-button": {
+      type: "icon-button",
+      category: "component",
+      sourceFile: "components/core/molecules/IconButton.tsx",
+      tier: "molecules",
+      family: "core",
+      description: "IconButton component",
+      suggestedFor: [
+        "icon",
+        "button",
+        "icon button"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes applied to the root element."
+        },
+        variant: {
+          types: [
+            "string"
+          ],
+          description: "variant prop",
+          enumValues: [
+            "primary",
+            "secondary",
+            "ghost",
+            "danger",
+            "success",
+            "warning",
+            "default",
+            "link"
+          ],
+          default: "ghost"
+        },
+        size: {
+          types: [
+            "string"
+          ],
+          description: "size prop",
+          enumValues: [
+            "sm",
+            "md",
+            "lg"
+          ],
+          default: "sm"
+        },
+        isLoading: {
+          types: [
+            "boolean"
+          ],
+          description: "isLoading prop"
+        },
+        iconAsset: {
+          types: [
+            "object"
+          ],
+          description: "Asset image rendered as the leading icon; takes precedence over icon/leftIcon when provided.",
+          properties: {
+            url: {
+              types: [
+                "asset"
+              ]
+            },
+            role: {
+              types: [
+                "string"
+              ]
+            },
+            category: {
+              types: [
+                "string"
+              ]
+            },
+            animations: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            style: {
+              types: [
+                "string"
+              ],
+              enumValues: [
+                "pixel",
+                "vector",
+                "hd",
+                "1-bit",
+                "isometric"
+              ]
+            },
+            variant: {
+              types: [
+                "string"
+              ]
+            },
+            dimension: {
+              types: [
+                "string"
+              ],
+              enumValues: [
+                "2d",
+                "3d"
+              ]
+            },
+            aspect: {
+              types: [
+                "string"
+              ],
+              enumValues: [
+                "1:1",
+                "16:9",
+                "5:7",
+                "8:1",
+                "4:1",
+                "5:3",
+                "1:2"
+              ]
+            },
+            atlas: {
+              types: [
+                "asset"
+              ]
+            },
+            sprite: {
+              types: [
+                "string"
+              ]
+            },
+            name: {
+              types: [
+                "string"
+              ]
+            },
+            thumbnailUrl: {
+              types: [
+                "string"
+              ]
+            }
+          },
+          propertyRequired: [
+            "url",
+            "role",
+            "category"
+          ]
+        },
+        action: {
+          types: [
+            "string"
+          ],
+          description: "Declarative event name \u2014 emits UI:{action} via eventBus on click",
+          kind: "event"
+        },
+        actionPayload: {
+          types: [
+            "object"
+          ],
+          description: "Payload to include with the action event",
+          payloadFor: "action",
+          eventPayloadBrand: true
+        },
+        disabled: {
+          types: [
+            "boolean"
+          ],
+          description: "Disable the button (greys out, blocks click events)"
+        },
+        href: {
+          types: [
+            "string"
+          ],
+          description: "Makes the button a link: `#anchor` scrolls, an absolute URL loads, a path navigates in-app"
+        },
+        "data-testid": {
+          types: [
+            "string"
+          ],
+          description: "Test identifier for automated tests"
+        },
+        icon: {
+          types: [
+            "icon",
+            "string"
+          ],
+          description: "icon prop",
+          required: true
+        },
+        label: {
+          types: [
+            "string"
+          ],
+          description: "What the button does \u2014 its accessible name and its tooltip.",
+          required: true
+        },
+        tooltipPosition: {
+          types: [
+            "string"
+          ],
+          description: "Where the tooltip opens.",
+          enumValues: [
+            "top",
+            "bottom",
+            "left",
+            "right"
+          ],
+          default: "right"
+        }
+      }
+    },
+    "top-nav-item": {
+      type: "top-nav-item",
+      category: "navigation",
+      sourceFile: "components/core/molecules/TopNavItem.tsx",
+      tier: "molecules",
+      family: "core",
+      description: "TopNavItem component",
+      suggestedFor: [
+        "top",
+        "nav",
+        "item",
+        "top nav item"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        item: {
+          types: [
+            "object"
+          ],
+          description: "item prop",
+          required: true,
+          properties: {
+            label: {
+              types: [
+                "string"
+              ]
+            },
+            href: {
+              types: [
+                "string"
+              ]
+            },
+            icon: {
+              types: [
+                "icon",
+                "string"
+              ]
+            },
+            badge: {
+              types: [
+                "string",
+                "number"
+              ]
+            },
+            active: {
+              types: [
+                "boolean"
+              ]
+            },
+            onClick: {
+              types: [
+                "function"
+              ]
+            },
+            children: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "object"
+                ],
+                cyclic: true,
+                cyclicTypeName: "TopNavItemData"
+              }
+            }
+          },
+          propertyRequired: [
+            "label"
+          ]
+        },
+        activeHref: {
+          types: [
+            "string"
+          ],
+          description: "The href of the active page, used to mark the item (or its parent) active."
+        },
+        tone: {
+          types: [
+            "string"
+          ],
+          description: "Active styling: `solid` fills with the primary colour (dashboard top bar); `soft` tints it (site header).",
+          enumValues: [
+            "solid",
+            "soft"
+          ],
+          default: "solid"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "className prop"
+        }
+      }
+    },
+    "change-list": {
+      type: "change-list",
+      category: "display",
+      sourceFile: "components/core/molecules/ChangeList.tsx",
+      tier: "molecules",
+      family: "core",
+      description: "The plain-language changes in one version (added / modified / removed).",
+      capabilities: "change summary, what changed, version changes, diff summary, release notes list, modification list",
+      suggestedFor: [
+        "change",
+        "list",
+        "change list"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        changes: {
+          types: [
+            "array",
+            "object"
+          ],
+          description: "The changes. Accepts a typed list or a render-ui payload binding.",
+          required: true,
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              type: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "added",
+                  "modified",
+                  "removed"
+                ]
+              },
+              title: {
+                types: [
+                  "string"
+                ]
+              },
+              description: {
+                types: [
+                  "string"
+                ]
+              },
+              before: {
+                types: [
+                  "string"
+                ]
+              },
+              after: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            required: [
+              "type",
+              "title"
+            ]
+          }
+        },
+        inspectEvent: {
+          types: [
+            "string"
+          ],
+          description: "Emitted by a change's Inspect button. Payload: { title, type }.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "title",
+              type: "string",
+              required: true
+            },
+            {
+              name: "type",
+              type: "string",
+              required: true,
+              enumValues: [
+                "added",
+                "modified",
+                "removed"
+              ]
+            }
+          ]
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "className prop"
+        }
+      }
+    },
+    "commit-row": {
+      type: "commit-row",
+      category: "component",
+      sourceFile: "components/core/molecules/CommitRow.tsx",
+      tier: "molecules",
+      family: "core",
+      description: "One version in a history list \u2014 a commit row with select and restore.",
+      capabilities: "version history row, commit entry, revision list item, change log entry, restore point, undo history item",
+      suggestedFor: [
+        "commit",
+        "row",
+        "commit row"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        sha: {
+          types: [
+            "string"
+          ],
+          description: "Commit id; the first 7 characters are shown, the whole id on hover.",
+          required: true
+        },
+        message: {
+          types: [
+            "string"
+          ],
+          description: "Commit message.",
+          required: true
+        },
+        author: {
+          types: [
+            "string"
+          ],
+          description: "author prop"
+        },
+        timestamp: {
+          types: [
+            "string"
+          ],
+          description: 'Display time (already formatted, e.g. "2 min ago").'
+        },
+        kind: {
+          types: [
+            "string"
+          ],
+          description: "What made this version (a user save, an agent turn, a restore, an undo/redo, a snapshot).",
+          enumValues: [
+            "user",
+            "agent",
+            "restore",
+            "undo",
+            "redo",
+            "snapshot"
+          ]
+        },
+        additions: {
+          types: [
+            "number"
+          ],
+          description: "additions prop"
+        },
+        deletions: {
+          types: [
+            "number"
+          ],
+          description: "deletions prop"
+        },
+        selected: {
+          types: [
+            "boolean"
+          ],
+          description: "The row the user picked (shows its detail).",
+          default: false
+        },
+        current: {
+          types: [
+            "boolean"
+          ],
+          description: "The version the app is at now \u2014 it cannot be restored to.",
+          default: false
+        },
+        selectEvent: {
+          types: [
+            "string"
+          ],
+          description: "Emitted when the row is picked. Payload: { sha }.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "sha",
+              type: "string",
+              required: true
+            }
+          ]
+        },
+        restoreEvent: {
+          types: [
+            "string"
+          ],
+          description: "Emitted by the Restore button. Payload: { sha }.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "sha",
+              type: "string",
+              required: true
+            }
+          ]
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "className prop"
+        }
+      }
     }
   }};
 var JsonValueSchema = z.lazy(