@almadar/core 10.105.0 → 10.107.0

package/dist/patterns/patterns-registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-09-25T03:49:13.459Z",
+  "exportedAt": "2026-09-27T02:12:25.691Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -9440,6 +9440,11 @@
                 ],
                 "kind": "event"
               },
+              "href": {
+                "types": [
+                  "string"
+                ]
+              },
               "url": {
                 "types": [
                   "string"
@@ -12082,6 +12087,7 @@
     "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.",
@@ -12150,6 +12156,18 @@
                 "types": [
                   "boolean"
                 ]
+              },
+              "children": {
+                "types": [
+                  "array"
+                ],
+                "items": {
+                  "types": [
+                    "object"
+                  ],
+                  "cyclic": true,
+                  "cyclicTypeName": "HeaderNavigationItem"
+                }
               }
             },
             "required": [
@@ -23989,9 +24007,11 @@
     "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 — 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",
@@ -24005,7 +24025,6 @@
             "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"
@@ -24044,6 +24063,70 @@
             ]
           }
         },
+        "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"
@@ -24060,7 +24143,7 @@
           "types": [
             "string"
           ],
-          "description": "Display mode.",
+          "description": "Display mode to start in; the toggle switches it.",
           "enumValues": [
             "side-by-side",
             "inline"
@@ -48856,6 +48939,7 @@
     "dock-layout": {
       "type": "dock-layout",
       "category": "layout",
+      "sourceFile": "components/core/organisms/layout/DockLayout.tsx",
       "tier": "organisms",
       "family": "core",
       "description": "DockLayout component",
@@ -48907,8 +48991,7 @@
           "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": [
@@ -48921,8 +49004,7 @@
           "types": [
             "boolean"
           ],
-          "description": "Whether `sidebar` is collapsed. @default false",
-          "default": false
+          "description": "Whether `sidebar` is collapsed. @default false"
         },
         "onSidebarCollapsedChange": {
           "types": [
@@ -48968,8 +49050,7 @@
           "types": [
             "boolean"
           ],
-          "description": "Whether `bottomPanel` is collapsed. @default false",
-          "default": false
+          "description": "Whether `bottomPanel` is collapsed. @default false"
         },
         "onBottomPanelCollapsedChange": {
           "types": [
@@ -49015,8 +49096,7 @@
           "types": [
             "boolean"
           ],
-          "description": "Whether `secondarySidebar` is collapsed. @default false",
-          "default": false
+          "description": "Whether `secondarySidebar` is collapsed. @default false"
         },
         "onSecondarySidebarCollapsedChange": {
           "types": [
@@ -49031,6 +49111,44 @@
             }
           ]
         },
+        "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"
@@ -50301,6 +50419,531 @@
           "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 — 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 — 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 — 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 — 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"
+        }
+      }
     }
   },
   "categories": [