@almadar/core 10.106.0 → 10.107.0

package/dist/patterns/index.d.ts

@@ -1,11 +1,11 @@
-import { A as AnyPatternConfig, l as RenderBinding, F as FieldValue, bs as PatternType, c as Effect } from '../effect-DtAf51pB.js';
-export { bl as PATTERN_TYPES, h as PatternConfig, bq as PatternProps, br as PatternPropsMap, dv as isValidPatternType } from '../effect-DtAf51pB.js';
+import { A as AnyPatternConfig, l as RenderBinding, F as FieldValue, bs as PatternType, c as Effect } from '../effect-CXEHwilA.js';
+export { bl as PATTERN_TYPES, h as PatternConfig, bq as PatternProps, br as PatternPropsMap, dv as isValidPatternType } from '../effect-CXEHwilA.js';
 import { a as EventPayloadValue, b as EventPayload, n as SExprObject, S as SExpr } from '../expression-CfeHdS-f.js';
 import { J as JsonValue } from '../json-D8gmyK3l.js';
 import 'zod';
 
 var version$3 = "1.0.0";
-var exportedAt$3 = "2026-09-26T10:53:57.077Z";
+var exportedAt$3 = "2026-09-27T02:12:25.691Z";
 var patterns = {
 	"entity-table": {
 		type: "entity-table",
@@ -24084,9 +24084,11 @@ var patterns = {
 	"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",
@@ -24100,7 +24102,6 @@ var patterns = {
 					"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"
@@ -24139,6 +24140,70 @@ var patterns = {
 					]
 				}
 			},
+			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"
@@ -24155,7 +24220,7 @@ var patterns = {
 				types: [
 					"string"
 				],
-				description: "Display mode.",
+				description: "Display mode to start in; the toggle switches it.",
 				enumValues: [
 					"side-by-side",
 					"inline"
@@ -50804,6 +50869,219 @@ var patterns = {
 				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"
+			}
+		}
 	}
 };
 var categories$1 = [
@@ -50832,7 +51110,7 @@ var patternsRegistry = {
 };
 
 var version$2 = "1.0.0";
-var exportedAt$2 = "2026-09-12T17:27:32.966Z";
+var exportedAt$2 = "2026-09-27T02:05:16.940Z";
 var integrators = {
 	github: {
 		name: "github",
@@ -53700,13 +53978,13 @@ var integrators = {
 		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",
@@ -53719,6 +53997,12 @@ var integrators = {
 						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: {
@@ -53741,13 +54025,21 @@ var integrators = {
 						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"
 				}
 			},
 			{
@@ -54843,7 +55135,7 @@ var integratorsRegistry = {
 };
 
 var version$1 = "1.0.0";
-var exportedAt$1 = "2026-09-26T10:53:57.077Z";
+var exportedAt$1 = "2026-09-27T02:12:25.691Z";
 var mappings = {
 	"page-header": {
 		component: "PageHeader",
@@ -56126,6 +56418,16 @@ var mappings = {
 		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"
 	}
 };
 var componentMapping = {
@@ -56135,7 +56437,7 @@ var componentMapping = {
 };
 
 var version = "1.0.0";
-var exportedAt = "2026-09-26T10:53:57.077Z";
+var exportedAt = "2026-09-27T02:12:25.691Z";
 var contracts = {
 	form: {
 		emits: [
@@ -72599,16 +72901,17 @@ declare const registry: {
         "version-diff": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
+            capabilities: string;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
                 revisions: {
                     types: string[];
                     description: string;
-                    required: boolean;
                     items: {
                         types: string[];
                         properties: {
@@ -72631,6 +72934,41 @@ declare const registry: {
                         required: string[];
                     };
                 };
+                hunks: {
+                    types: string[];
+                    description: string;
+                    items: {
+                        types: string[];
+                        properties: {
+                            header: {
+                                types: string[];
+                            };
+                            lines: {
+                                types: string[];
+                                items: {
+                                    types: string[];
+                                    properties: {
+                                        type: {
+                                            types: string[];
+                                            enumValues: string[];
+                                        };
+                                        beforeLineNumber: {
+                                            types: string[];
+                                        };
+                                        afterLineNumber: {
+                                            types: string[];
+                                        };
+                                        content: {
+                                            types: string[];
+                                        };
+                                    };
+                                    required: string[];
+                                };
+                            };
+                        };
+                        required: string[];
+                    };
+                };
                 beforeId: {
                     types: string[];
                     description: string;
@@ -88463,6 +88801,144 @@ declare const registry: {
                 };
             };
         };
+        "change-list": {
+            type: string;
+            category: string;
+            sourceFile: string;
+            tier: string;
+            family: string;
+            description: string;
+            capabilities: string;
+            suggestedFor: string[];
+            typicalSize: string;
+            propsSchema: {
+                changes: {
+                    types: string[];
+                    description: string;
+                    required: boolean;
+                    items: {
+                        types: string[];
+                        properties: {
+                            type: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            title: {
+                                types: string[];
+                            };
+                            description: {
+                                types: string[];
+                            };
+                            before: {
+                                types: string[];
+                            };
+                            after: {
+                                types: string[];
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                inspectEvent: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    emitPayloadSchema: ({
+                        name: string;
+                        type: string;
+                        required: boolean;
+                        enumValues?: undefined;
+                    } | {
+                        name: string;
+                        type: string;
+                        required: boolean;
+                        enumValues: string[];
+                    })[];
+                };
+                className: {
+                    types: string[];
+                    description: string;
+                };
+            };
+        };
+        "commit-row": {
+            type: string;
+            category: string;
+            sourceFile: string;
+            tier: string;
+            family: string;
+            description: string;
+            capabilities: string;
+            suggestedFor: string[];
+            typicalSize: string;
+            propsSchema: {
+                sha: {
+                    types: string[];
+                    description: string;
+                    required: boolean;
+                };
+                message: {
+                    types: string[];
+                    description: string;
+                    required: boolean;
+                };
+                author: {
+                    types: string[];
+                    description: string;
+                };
+                timestamp: {
+                    types: string[];
+                    description: string;
+                };
+                kind: {
+                    types: string[];
+                    description: string;
+                    enumValues: string[];
+                };
+                additions: {
+                    types: string[];
+                    description: string;
+                };
+                deletions: {
+                    types: string[];
+                    description: string;
+                };
+                selected: {
+                    types: string[];
+                    description: string;
+                    default: boolean;
+                };
+                current: {
+                    types: string[];
+                    description: string;
+                    default: boolean;
+                };
+                selectEvent: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    emitPayloadSchema: {
+                        name: string;
+                        type: string;
+                        required: boolean;
+                    }[];
+                };
+                restoreEvent: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    emitPayloadSchema: {
+                        name: string;
+                        type: string;
+                        required: boolean;
+                    }[];
+                };
+                className: {
+                    types: string[];
+                    description: string;
+                };
+            };
+        };
     };
     categories: string[];
 };
@@ -103145,16 +103621,17 @@ declare const PATTERN_REGISTRY: {
         "version-diff": {
             type: string;
             category: string;
+            sourceFile: string;
             tier: string;
             family: string;
             description: string;
+            capabilities: string;
             suggestedFor: string[];
             typicalSize: string;
             propsSchema: {
                 revisions: {
                     types: string[];
                     description: string;
-                    required: boolean;
                     items: {
                         types: string[];
                         properties: {
@@ -103177,6 +103654,41 @@ declare const PATTERN_REGISTRY: {
                         required: string[];
                     };
                 };
+                hunks: {
+                    types: string[];
+                    description: string;
+                    items: {
+                        types: string[];
+                        properties: {
+                            header: {
+                                types: string[];
+                            };
+                            lines: {
+                                types: string[];
+                                items: {
+                                    types: string[];
+                                    properties: {
+                                        type: {
+                                            types: string[];
+                                            enumValues: string[];
+                                        };
+                                        beforeLineNumber: {
+                                            types: string[];
+                                        };
+                                        afterLineNumber: {
+                                            types: string[];
+                                        };
+                                        content: {
+                                            types: string[];
+                                        };
+                                    };
+                                    required: string[];
+                                };
+                            };
+                        };
+                        required: string[];
+                    };
+                };
                 beforeId: {
                     types: string[];
                     description: string;
@@ -119009,6 +119521,144 @@ declare const PATTERN_REGISTRY: {
                 };
             };
         };
+        "change-list": {
+            type: string;
+            category: string;
+            sourceFile: string;
+            tier: string;
+            family: string;
+            description: string;
+            capabilities: string;
+            suggestedFor: string[];
+            typicalSize: string;
+            propsSchema: {
+                changes: {
+                    types: string[];
+                    description: string;
+                    required: boolean;
+                    items: {
+                        types: string[];
+                        properties: {
+                            type: {
+                                types: string[];
+                                enumValues: string[];
+                            };
+                            title: {
+                                types: string[];
+                            };
+                            description: {
+                                types: string[];
+                            };
+                            before: {
+                                types: string[];
+                            };
+                            after: {
+                                types: string[];
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                inspectEvent: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    emitPayloadSchema: ({
+                        name: string;
+                        type: string;
+                        required: boolean;
+                        enumValues?: undefined;
+                    } | {
+                        name: string;
+                        type: string;
+                        required: boolean;
+                        enumValues: string[];
+                    })[];
+                };
+                className: {
+                    types: string[];
+                    description: string;
+                };
+            };
+        };
+        "commit-row": {
+            type: string;
+            category: string;
+            sourceFile: string;
+            tier: string;
+            family: string;
+            description: string;
+            capabilities: string;
+            suggestedFor: string[];
+            typicalSize: string;
+            propsSchema: {
+                sha: {
+                    types: string[];
+                    description: string;
+                    required: boolean;
+                };
+                message: {
+                    types: string[];
+                    description: string;
+                    required: boolean;
+                };
+                author: {
+                    types: string[];
+                    description: string;
+                };
+                timestamp: {
+                    types: string[];
+                    description: string;
+                };
+                kind: {
+                    types: string[];
+                    description: string;
+                    enumValues: string[];
+                };
+                additions: {
+                    types: string[];
+                    description: string;
+                };
+                deletions: {
+                    types: string[];
+                    description: string;
+                };
+                selected: {
+                    types: string[];
+                    description: string;
+                    default: boolean;
+                };
+                current: {
+                    types: string[];
+                    description: string;
+                    default: boolean;
+                };
+                selectEvent: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    emitPayloadSchema: {
+                        name: string;
+                        type: string;
+                        required: boolean;
+                    }[];
+                };
+                restoreEvent: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    emitPayloadSchema: {
+                        name: string;
+                        type: string;
+                        required: boolean;
+                    }[];
+                };
+                className: {
+                    types: string[];
+                    description: string;
+                };
+            };
+        };
     };
     categories: string[];
 };
@@ -121392,6 +122042,8 @@ declare const INTEGRATORS_REGISTRY: {
                     refreshToken?: undefined;
                     expiresIn?: undefined;
                     tokenType?: undefined;
+                    scope?: undefined;
+                    subject?: undefined;
                     revoked?: undefined;
                     sub?: undefined;
                     email?: undefined;
@@ -121412,6 +122064,8 @@ declare const INTEGRATORS_REGISTRY: {
                     refreshToken: string;
                     expiresIn: string;
                     tokenType: string;
+                    scope: string;
+                    subject: string;
                     authUrl?: undefined;
                     state?: undefined;
                     revoked?: undefined;
@@ -121436,6 +122090,8 @@ declare const INTEGRATORS_REGISTRY: {
                     state?: undefined;
                     refreshToken?: undefined;
                     tokenType?: undefined;
+                    scope?: undefined;
+                    subject?: undefined;
                     revoked?: undefined;
                     sub?: undefined;
                     email?: undefined;
@@ -121459,6 +122115,8 @@ declare const INTEGRATORS_REGISTRY: {
                     refreshToken?: undefined;
                     expiresIn?: undefined;
                     tokenType?: undefined;
+                    scope?: undefined;
+                    subject?: undefined;
                     sub?: undefined;
                     email?: undefined;
                     name?: undefined;
@@ -121484,6 +122142,8 @@ declare const INTEGRATORS_REGISTRY: {
                     refreshToken?: undefined;
                     expiresIn?: undefined;
                     tokenType?: undefined;
+                    scope?: undefined;
+                    subject?: undefined;
                     revoked?: undefined;
                 };
             })[];
@@ -123836,6 +124496,16 @@ declare const COMPONENT_MAPPING: {
             importPath: string;
             category: string;
         };
+        "change-list": {
+            component: string;
+            importPath: string;
+            category: string;
+        };
+        "commit-row": {
+            component: string;
+            importPath: string;
+            category: string;
+        };
     };
 };
 declare const EVENT_CONTRACTS: {