@almadar/core 10.106.0 → 10.107.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-09-26T10:53:57.077Z",
+  exportedAt: "2026-09-27T02:12:25.691Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -24010,9 +24010,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",
@@ -24026,7 +24028,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"
@@ -24065,6 +24066,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"
@@ -24081,7 +24146,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"
@@ -50669,6 +50734,219 @@ var patterns_registry_default = {
           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"
+        }
+      }
     }
   },
   categories: [
@@ -50694,7 +50972,7 @@ var patterns_registry_default = {
 // src/patterns/integrators-registry.json
 var integrators_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-12T17:27:32.966Z",
+  exportedAt: "2026-09-27T02:05:16.940Z",
   integrators: {
     github: {
       name: "github",
@@ -53560,13 +53838,13 @@ var integrators_registry_default = {
       actions: [
         {
           name: "authorize",
-          description: "Build the provider authorization URL (PKCE + state) for an OAuth/OIDC login redirect; real OIDC discovery when OAUTH_CLIENT_ID/SECRET are configured, an in-memory mock otherwise.",
+          description: "Build the provider authorization URL (PKCE + state) for an OAuth/OIDC login redirect; OIDC discovery (Google) or static OAuth 2 metadata (GitHub) when OAUTH_CLIENT_ID/SECRET are configured, an in-memory mock otherwise.",
           params: [
             {
               name: "provider",
               type: "'google' | 'github' | 'auth0'",
               required: true,
-              description: "Identity provider; OIDC issuer defaults to Google unless OIDC_ISSUER_URL overrides it."
+              description: "Identity provider; OIDC issuer defaults to Google unless OIDC_ISSUER_URL overrides it; GitHub uses its OAuth 2 endpoints."
             },
             {
               name: "scopes",
@@ -53579,6 +53857,12 @@ var integrators_registry_default = {
               type: "string",
               required: true,
               description: "Callback URL the provider redirects back to after consent."
+            },
+            {
+              name: "subject",
+              type: "string",
+              required: false,
+              description: "Opaque id of whoever started the flow (the verified user); `token` returns it so the host can refuse anyone else completing."
             }
           ],
           responseShape: {
@@ -53601,13 +53885,21 @@ var integrators_registry_default = {
               type: "string",
               required: true,
               description: "The `state` value returned by `authorize`."
+            },
+            {
+              name: "subject",
+              type: "string",
+              required: false,
+              description: "Who is completing; must equal the `subject` bound at `authorize`, checked before the code is exchanged."
             }
           ],
           responseShape: {
             accessToken: "string",
             refreshToken: "string",
             expiresIn: "number",
-            tokenType: "'bearer'"
+            tokenType: "'bearer'",
+            scope: "string[]",
+            subject: "string"
           }
         },
         {
@@ -54694,7 +54986,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-26T10:53:57.077Z",
+  exportedAt: "2026-09-27T02:12:25.691Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -55977,6 +56269,16 @@ var component_mapping_default = {
       component: "TopNavItem",
       importPath: "@/components/core/molecules/TopNavItem",
       category: "navigation"
+    },
+    "change-list": {
+      component: "ChangeList",
+      importPath: "@/components/core/molecules/ChangeList",
+      category: "display"
+    },
+    "commit-row": {
+      component: "CommitRow",
+      importPath: "@/components/core/molecules/CommitRow",
+      category: "component"
     }
   }
 };
@@ -55984,7 +56286,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-26T10:53:57.077Z",
+  exportedAt: "2026-09-27T02:12:25.691Z",
   contracts: {
     form: {
       emits: [
@@ -57111,6 +57413,7 @@ var PATTERN_TYPES = [
   "card",
   "carousel",
   "center",
+  "change-list",
   "chart",
   "chart-legend",
   "chat-bar",
@@ -57120,6 +57423,7 @@ var PATTERN_TYPES = [
   "code-block",
   "code-runner-panel",
   "command-palette",
+  "commit-row",
   "conditional-wrapper",
   "confetti-effect",
   "confirm-dialog",