@aloudata/aloudata-design 3.0.20 → 3.0.21

package/dist/theme/governance/reviewGate.js

@@ -0,0 +1,116 @@
+import { formatMigrationValidationReport, validateMigrationMapping } from "./validateMigrationMapping.js";
+//#region src/theme/governance/reviewGate.ts
+function countIssues(validation, code) {
+	return validation.issues.filter((issue) => issue.code === code).length;
+}
+function createReviewGateDecision(validation) {
+	const unregisteredCount = countIssues(validation, "unregistered-legacy-variable");
+	const blockedCount = countIssues(validation, "blocked-migration-mapping");
+	const deprecatedCount = countIssues(validation, "deprecated-migration-mapping");
+	const governanceReviewCount = countIssues(validation, "governance-review-required");
+	const replaceableCount = validation.summary.replaceableUsageCount;
+	const reasons = [];
+	if (validation.summary.legacyVariableUsageCount === 0) reasons.push({
+		code: "no-legacy-variable",
+		count: 0,
+		severity: "info",
+		message: "No legacy migration variables were found."
+	});
+	if (replaceableCount > 0) reasons.push({
+		code: "replaceable-migration-mapping",
+		count: replaceableCount,
+		severity: "warning",
+		message: "Replaceable migration mappings are available, but migration review is required before replacement."
+	});
+	if (blockedCount > 0) reasons.push({
+		code: "blocked-migration-mapping",
+		count: blockedCount,
+		severity: "warning",
+		message: "Blocked migration mappings require review and must not be treated as directly replaceable."
+	});
+	if (deprecatedCount > 0) reasons.push({
+		code: "deprecated-migration-mapping",
+		count: deprecatedCount,
+		severity: "warning",
+		message: "Deprecated migration mappings require review and must not be approved silently."
+	});
+	if (governanceReviewCount > 0) reasons.push({
+		code: "governance-review-required",
+		count: governanceReviewCount,
+		severity: "warning",
+		message: "Governance-review-required mappings must not be treated as directly replaceable."
+	});
+	if (unregisteredCount > 0) reasons.push({
+		code: "unregistered-legacy-variable",
+		count: unregisteredCount,
+		severity: "error",
+		message: "Unregistered legacy variables must be added to the migration registry before review can pass."
+	});
+	const blockingCount = unregisteredCount + blockedCount + governanceReviewCount;
+	const reviewCount = replaceableCount + deprecatedCount;
+	const status = blockingCount > 0 ? "blocked" : reviewCount > 0 ? "needs-review" : "approved";
+	const issues = reasons.filter((reason) => reason.code !== "no-legacy-variable");
+	const passed = status === "approved";
+	return {
+		status,
+		passed,
+		issues,
+		summary: {
+			filesScanned: validation.summary.filesScanned,
+			legacyVariableUsageCount: validation.summary.legacyVariableUsageCount,
+			replaceableUsageCount: validation.summary.replaceableUsageCount,
+			deprecatedUsageCount: validation.summary.deprecatedUsageCount,
+			blockedUsageCount: validation.summary.blockedUsageCount,
+			governanceReviewUsageCount: validation.summary.governanceReviewUsageCount,
+			unregisteredUsageCount: validation.summary.unregisteredUsageCount,
+			issueCount: issues.length
+		},
+		canAutoReplace: replaceableCount > 0 && blockingCount === 0,
+		requiresGovernanceReview: !passed,
+		validation,
+		reasons
+	};
+}
+function runMigrationReviewGate(sources) {
+	return createReviewGateDecision(validateMigrationMapping(sources));
+}
+function formatReviewGateDecision(decision) {
+	const lines = [
+		"Migration Review Gate Decision",
+		"",
+		`Decision: ${decision.status}`,
+		`Passed: ${decision.passed ? "yes" : "no"}`,
+		`Can auto replace: ${decision.canAutoReplace ? "yes" : "no"}`,
+		`Requires governance review: ${decision.requiresGovernanceReview ? "yes" : "no"}`,
+		"",
+		"Summary:",
+		`- Files scanned: ${decision.summary.filesScanned}`,
+		`- Legacy variable usages: ${decision.summary.legacyVariableUsageCount}`,
+		`- Replaceable usages: ${decision.summary.replaceableUsageCount}`,
+		`- Deprecated usages: ${decision.summary.deprecatedUsageCount}`,
+		`- Blocked usages: ${decision.summary.blockedUsageCount}`,
+		`- Governance review usages: ${decision.summary.governanceReviewUsageCount}`,
+		`- Unregistered usages: ${decision.summary.unregisteredUsageCount}`,
+		`- Review gate issues: ${decision.summary.issueCount}`,
+		"",
+		"Reasons:"
+	];
+	if (decision.reasons.length === 0) lines.push("- none");
+	else for (const reason of decision.reasons) lines.push(`- [${reason.severity}] ${reason.code}: ${reason.count} - ${reason.message}`);
+	lines.push("", "Issues:");
+	if (decision.issues.length === 0) lines.push("- none");
+	else for (const issue of decision.issues) lines.push(`- [${issue.severity}] ${issue.code}: ${issue.count} - ${issue.message}`);
+	if (decision.validation.issues.length > 0) {
+		lines.push("", "Validation issue details:");
+		for (const issue of decision.validation.issues) {
+			const target = issue.mapping?.target ? ` -> ${issue.mapping.target}` : "";
+			lines.push(`- ${issue.usage.path}:${issue.usage.line}:${issue.usage.column} ${issue.usage.source}${target} (${issue.code})`);
+		}
+	}
+	lines.push("", formatMigrationValidationReport(decision.validation));
+	return lines.join("\n");
+}
+//#endregion
+export { createReviewGateDecision, formatReviewGateDecision, runMigrationReviewGate };
+
+//# sourceMappingURL=reviewGate.js.map

package/dist/theme/governance/reviewGate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewGate.js","names":[],"sources":["../../../src/theme/governance/reviewGate.ts"],"sourcesContent":["import {\n  formatMigrationValidationReport,\n  validateMigrationMapping,\n  type MigrationValidationIssue,\n  type MigrationValidationReport,\n  type MigrationValidationSource,\n} from './validateMigrationMapping';\n\nexport type ReviewGateDecisionStatus = 'approved' | 'needs-review' | 'blocked';\n\nexport type ReviewGateReasonCode =\n  | 'no-legacy-variable'\n  | 'replaceable-migration-mapping'\n  | 'blocked-migration-mapping'\n  | 'deprecated-migration-mapping'\n  | 'governance-review-required'\n  | 'unregistered-legacy-variable';\n\nexport interface ReviewGateDecisionReason {\n  code: ReviewGateReasonCode;\n  count: number;\n  severity: 'info' | 'warning' | 'error';\n  message: string;\n}\n\nexport type ReviewGateDecisionIssue = ReviewGateDecisionReason;\n\nexport interface ReviewGateDecisionSummary {\n  filesScanned: number;\n  legacyVariableUsageCount: number;\n  replaceableUsageCount: number;\n  deprecatedUsageCount: number;\n  blockedUsageCount: number;\n  governanceReviewUsageCount: number;\n  unregisteredUsageCount: number;\n  issueCount: number;\n}\n\nexport interface ReviewGateDecision {\n  status: ReviewGateDecisionStatus;\n  passed: boolean;\n  issues: ReviewGateDecisionIssue[];\n  summary: ReviewGateDecisionSummary;\n  canAutoReplace: boolean;\n  requiresGovernanceReview: boolean;\n  validation: MigrationValidationReport;\n  reasons: ReviewGateDecisionReason[];\n}\n\nfunction countIssues(\n  validation: MigrationValidationReport,\n  code: MigrationValidationIssue['code'],\n) {\n  return validation.issues.filter((issue) => issue.code === code).length;\n}\n\nexport function createReviewGateDecision(\n  validation: MigrationValidationReport,\n): ReviewGateDecision {\n  const unregisteredCount = countIssues(\n    validation,\n    'unregistered-legacy-variable',\n  );\n  const blockedCount = countIssues(validation, 'blocked-migration-mapping');\n  const deprecatedCount = countIssues(\n    validation,\n    'deprecated-migration-mapping',\n  );\n  const governanceReviewCount = countIssues(\n    validation,\n    'governance-review-required',\n  );\n  const replaceableCount = validation.summary.replaceableUsageCount;\n  const reasons: ReviewGateDecisionReason[] = [];\n\n  if (validation.summary.legacyVariableUsageCount === 0) {\n    reasons.push({\n      code: 'no-legacy-variable',\n      count: 0,\n      severity: 'info',\n      message: 'No legacy migration variables were found.',\n    });\n  }\n\n  if (replaceableCount > 0) {\n    reasons.push({\n      code: 'replaceable-migration-mapping',\n      count: replaceableCount,\n      severity: 'warning',\n      message:\n        'Replaceable migration mappings are available, but migration review is required before replacement.',\n    });\n  }\n\n  if (blockedCount > 0) {\n    reasons.push({\n      code: 'blocked-migration-mapping',\n      count: blockedCount,\n      severity: 'warning',\n      message:\n        'Blocked migration mappings require review and must not be treated as directly replaceable.',\n    });\n  }\n\n  if (deprecatedCount > 0) {\n    reasons.push({\n      code: 'deprecated-migration-mapping',\n      count: deprecatedCount,\n      severity: 'warning',\n      message:\n        'Deprecated migration mappings require review and must not be approved silently.',\n    });\n  }\n\n  if (governanceReviewCount > 0) {\n    reasons.push({\n      code: 'governance-review-required',\n      count: governanceReviewCount,\n      severity: 'warning',\n      message:\n        'Governance-review-required mappings must not be treated as directly replaceable.',\n    });\n  }\n\n  if (unregisteredCount > 0) {\n    reasons.push({\n      code: 'unregistered-legacy-variable',\n      count: unregisteredCount,\n      severity: 'error',\n      message:\n        'Unregistered legacy variables must be added to the migration registry before review can pass.',\n    });\n  }\n\n  const blockingCount =\n    unregisteredCount + blockedCount + governanceReviewCount;\n  const reviewCount = replaceableCount + deprecatedCount;\n  const status: ReviewGateDecisionStatus =\n    blockingCount > 0\n      ? 'blocked'\n      : reviewCount > 0\n      ? 'needs-review'\n      : 'approved';\n  const issues = reasons.filter(\n    (reason) => reason.code !== 'no-legacy-variable',\n  );\n  const passed = status === 'approved';\n\n  return {\n    status,\n    passed,\n    issues,\n    summary: {\n      filesScanned: validation.summary.filesScanned,\n      legacyVariableUsageCount: validation.summary.legacyVariableUsageCount,\n      replaceableUsageCount: validation.summary.replaceableUsageCount,\n      deprecatedUsageCount: validation.summary.deprecatedUsageCount,\n      blockedUsageCount: validation.summary.blockedUsageCount,\n      governanceReviewUsageCount: validation.summary.governanceReviewUsageCount,\n      unregisteredUsageCount: validation.summary.unregisteredUsageCount,\n      issueCount: issues.length,\n    },\n    canAutoReplace: replaceableCount > 0 && blockingCount === 0,\n    requiresGovernanceReview: !passed,\n    validation,\n    reasons,\n  };\n}\n\nexport function runMigrationReviewGate(\n  sources: readonly MigrationValidationSource[],\n): ReviewGateDecision {\n  return createReviewGateDecision(validateMigrationMapping(sources));\n}\n\nexport function formatReviewGateDecision(decision: ReviewGateDecision): string {\n  const lines = [\n    'Migration Review Gate Decision',\n    '',\n    `Decision: ${decision.status}`,\n    `Passed: ${decision.passed ? 'yes' : 'no'}`,\n    `Can auto replace: ${decision.canAutoReplace ? 'yes' : 'no'}`,\n    `Requires governance review: ${\n      decision.requiresGovernanceReview ? 'yes' : 'no'\n    }`,\n    '',\n    'Summary:',\n    `- Files scanned: ${decision.summary.filesScanned}`,\n    `- Legacy variable usages: ${decision.summary.legacyVariableUsageCount}`,\n    `- Replaceable usages: ${decision.summary.replaceableUsageCount}`,\n    `- Deprecated usages: ${decision.summary.deprecatedUsageCount}`,\n    `- Blocked usages: ${decision.summary.blockedUsageCount}`,\n    `- Governance review usages: ${decision.summary.governanceReviewUsageCount}`,\n    `- Unregistered usages: ${decision.summary.unregisteredUsageCount}`,\n    `- Review gate issues: ${decision.summary.issueCount}`,\n    '',\n    'Reasons:',\n  ];\n\n  if (decision.reasons.length === 0) {\n    lines.push('- none');\n  } else {\n    for (const reason of decision.reasons) {\n      lines.push(\n        `- [${reason.severity}] ${reason.code}: ${reason.count} - ${reason.message}`,\n      );\n    }\n  }\n\n  lines.push('', 'Issues:');\n\n  if (decision.issues.length === 0) {\n    lines.push('- none');\n  } else {\n    for (const issue of decision.issues) {\n      lines.push(\n        `- [${issue.severity}] ${issue.code}: ${issue.count} - ${issue.message}`,\n      );\n    }\n  }\n\n  if (decision.validation.issues.length > 0) {\n    lines.push('', 'Validation issue details:');\n\n    for (const issue of decision.validation.issues) {\n      const target = issue.mapping?.target ? ` -> ${issue.mapping.target}` : '';\n      lines.push(\n        `- ${issue.usage.path}:${issue.usage.line}:${issue.usage.column} ${issue.usage.source}${target} (${issue.code})`,\n      );\n    }\n  }\n\n  lines.push('', formatMigrationValidationReport(decision.validation));\n\n  return lines.join('\\n');\n}\n"],"mappings":"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"}

package/dist/theme/governance/validateMigrationMapping.d.ts

@@ -0,0 +1,50 @@
+import { LegacyCssVariableName, MigrationMappingEntry, MigrationMappingType } from './migrationMappingRegistry.js';
+export interface MigrationValidationSource {
+    path: string;
+    content: string;
+}
+export interface LegacyVariableUsage {
+    source: LegacyCssVariableName;
+    path: string;
+    line: number;
+    column: number;
+    index: number;
+    type: MigrationMappingType;
+}
+export type MigrationValidationIssueCode = 'unregistered-legacy-variable' | 'blocked-migration-mapping' | 'deprecated-migration-mapping' | 'governance-review-required';
+export type MigrationValidationSeverity = 'error' | 'warning';
+export interface MigrationValidationIssue {
+    code: MigrationValidationIssueCode;
+    severity: MigrationValidationSeverity;
+    usage: LegacyVariableUsage;
+    mapping?: MigrationMappingEntry;
+    message: string;
+}
+export interface ReplaceableMigrationUsage {
+    usage: LegacyVariableUsage;
+    mapping: MigrationMappingEntry & {
+        target: NonNullable<MigrationMappingEntry['target']>;
+    };
+}
+export interface MigrationValidationSummary {
+    filesScanned: number;
+    legacyVariableUsageCount: number;
+    uniqueLegacyVariableCount: number;
+    registeredUsageCount: number;
+    unregisteredUsageCount: number;
+    blockedUsageCount: number;
+    deprecatedUsageCount: number;
+    governanceReviewUsageCount: number;
+    replaceableUsageCount: number;
+}
+export interface MigrationValidationReport {
+    valid: boolean;
+    summary: MigrationValidationSummary;
+    usages: LegacyVariableUsage[];
+    usagesByType: Record<MigrationMappingType, LegacyVariableUsage[]>;
+    replaceableUsages: ReplaceableMigrationUsage[];
+    issues: MigrationValidationIssue[];
+}
+export declare function scanLegacyVariableUsages(sources: readonly MigrationValidationSource[]): LegacyVariableUsage[];
+export declare function validateMigrationMapping(sources: readonly MigrationValidationSource[]): MigrationValidationReport;
+export declare function formatMigrationValidationReport(report: MigrationValidationReport): string;

package/dist/theme/governance/validateMigrationMapping.js

@@ -0,0 +1,157 @@
+import { getMigrationMapping } from "./migrationMappingRegistry.js";
+//#region src/theme/governance/validateMigrationMapping.ts
+var legacyVariablePattern = /--(?:alias|interaction|non-semantic)-[a-zA-Z0-9_-]+/g;
+function getLegacyType(source) {
+	if (source.startsWith("--alias-")) return "alias";
+	if (source.startsWith("--interaction-")) return "interaction";
+	return "non-semantic";
+}
+function getLineAndColumn(content, index) {
+	const lines = content.slice(0, index).split("\n");
+	return {
+		line: lines.length,
+		column: lines[lines.length - 1].length + 1
+	};
+}
+function createIssue(code, usage, mapping) {
+	if (code === "unregistered-legacy-variable") return {
+		code,
+		severity: "error",
+		usage,
+		message: `${usage.source} is used but not registered in migrationMappingRegistry.`
+	};
+	if (code === "blocked-migration-mapping") return {
+		code,
+		severity: "warning",
+		usage,
+		mapping,
+		message: `${usage.source} is blocked and must not be treated as directly replaceable.`
+	};
+	if (code === "deprecated-migration-mapping") return {
+		code,
+		severity: "warning",
+		usage,
+		mapping,
+		message: `${usage.source} is deprecated and requires migration review before replacement.`
+	};
+	return {
+		code,
+		severity: "warning",
+		usage,
+		mapping,
+		message: `${usage.source} requires governance review and must not be treated as directly replaceable.`
+	};
+}
+function scanLegacyVariableUsages(sources) {
+	const usages = [];
+	for (const source of sources) {
+		const pattern = new RegExp(legacyVariablePattern);
+		let match;
+		while (match = pattern.exec(source.content)) {
+			const variable = match[0];
+			const index = match.index ?? 0;
+			const position = getLineAndColumn(source.content, index);
+			usages.push({
+				source: variable,
+				path: source.path,
+				line: position.line,
+				column: position.column,
+				index,
+				type: getLegacyType(variable)
+			});
+		}
+	}
+	return usages;
+}
+function validateMigrationMapping(sources) {
+	const usages = scanLegacyVariableUsages(sources);
+	const issues = [];
+	const replaceableUsages = [];
+	const usagesByType = {
+		alias: [],
+		interaction: [],
+		"non-semantic": []
+	};
+	let registeredUsageCount = 0;
+	let unregisteredUsageCount = 0;
+	let blockedUsageCount = 0;
+	let deprecatedUsageCount = 0;
+	let governanceReviewUsageCount = 0;
+	for (const usage of usages) {
+		usagesByType[usage.type].push(usage);
+		const mapping = getMigrationMapping(usage.source);
+		if (!mapping) {
+			unregisteredUsageCount += 1;
+			issues.push(createIssue("unregistered-legacy-variable", usage));
+			continue;
+		}
+		registeredUsageCount += 1;
+		if (mapping.lifecycle === "blocked") {
+			blockedUsageCount += 1;
+			issues.push(createIssue("blocked-migration-mapping", usage, mapping));
+			continue;
+		}
+		if (mapping.strategy === "governance-review-required" || !mapping.target) {
+			governanceReviewUsageCount += 1;
+			issues.push(createIssue("governance-review-required", usage, mapping));
+			continue;
+		}
+		if (mapping.lifecycle === "deprecated") {
+			deprecatedUsageCount += 1;
+			issues.push(createIssue("deprecated-migration-mapping", usage, mapping));
+			continue;
+		}
+		replaceableUsages.push({
+			usage,
+			mapping
+		});
+	}
+	return {
+		valid: !issues.some((issue) => issue.severity === "error"),
+		summary: {
+			filesScanned: sources.length,
+			legacyVariableUsageCount: usages.length,
+			uniqueLegacyVariableCount: new Set(usages.map((usage) => usage.source)).size,
+			registeredUsageCount,
+			unregisteredUsageCount,
+			blockedUsageCount,
+			deprecatedUsageCount,
+			governanceReviewUsageCount,
+			replaceableUsageCount: replaceableUsages.length
+		},
+		usages,
+		usagesByType,
+		replaceableUsages,
+		issues
+	};
+}
+function formatMigrationValidationReport(report) {
+	const lines = [
+		"Migration Mapping Validation Report",
+		"",
+		`Status: ${report.valid ? "PASS" : "FAIL"}`,
+		`Files scanned: ${report.summary.filesScanned}`,
+		`Legacy variable usages: ${report.summary.legacyVariableUsageCount}`,
+		`Unique legacy variables: ${report.summary.uniqueLegacyVariableCount}`,
+		`Registered usages: ${report.summary.registeredUsageCount}`,
+		`Unregistered usages: ${report.summary.unregisteredUsageCount}`,
+		`Blocked usages: ${report.summary.blockedUsageCount}`,
+		`Deprecated usages: ${report.summary.deprecatedUsageCount}`,
+		`Governance review usages: ${report.summary.governanceReviewUsageCount}`,
+		`Replaceable usages: ${report.summary.replaceableUsageCount}`,
+		"",
+		"Grouped by type:",
+		`- alias: ${report.usagesByType.alias.length}`,
+		`- interaction: ${report.usagesByType.interaction.length}`,
+		`- non-semantic: ${report.usagesByType["non-semantic"].length}`
+	];
+	if (report.issues.length > 0) {
+		lines.push("", "Issues:");
+		for (const issue of report.issues) lines.push(`- [${issue.severity}] ${issue.code}: ${issue.usage.source} at ${issue.usage.path}:${issue.usage.line}:${issue.usage.column}`);
+	}
+	return lines.join("\n");
+}
+//#endregion
+export { formatMigrationValidationReport, scanLegacyVariableUsages, validateMigrationMapping };
+
+//# sourceMappingURL=validateMigrationMapping.js.map

package/dist/theme/governance/validateMigrationMapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateMigrationMapping.js","names":[],"sources":["../../../src/theme/governance/validateMigrationMapping.ts"],"sourcesContent":["import {\n  getMigrationMapping,\n  type LegacyCssVariableName,\n  type MigrationMappingEntry,\n  type MigrationMappingType,\n} from './migrationMappingRegistry';\n\nexport interface MigrationValidationSource {\n  path: string;\n  content: string;\n}\n\nexport interface LegacyVariableUsage {\n  source: LegacyCssVariableName;\n  path: string;\n  line: number;\n  column: number;\n  index: number;\n  type: MigrationMappingType;\n}\n\nexport type MigrationValidationIssueCode =\n  | 'unregistered-legacy-variable'\n  | 'blocked-migration-mapping'\n  | 'deprecated-migration-mapping'\n  | 'governance-review-required';\n\nexport type MigrationValidationSeverity = 'error' | 'warning';\n\nexport interface MigrationValidationIssue {\n  code: MigrationValidationIssueCode;\n  severity: MigrationValidationSeverity;\n  usage: LegacyVariableUsage;\n  mapping?: MigrationMappingEntry;\n  message: string;\n}\n\nexport interface ReplaceableMigrationUsage {\n  usage: LegacyVariableUsage;\n  mapping: MigrationMappingEntry & {\n    target: NonNullable<MigrationMappingEntry['target']>;\n  };\n}\n\nexport interface MigrationValidationSummary {\n  filesScanned: number;\n  legacyVariableUsageCount: number;\n  uniqueLegacyVariableCount: number;\n  registeredUsageCount: number;\n  unregisteredUsageCount: number;\n  blockedUsageCount: number;\n  deprecatedUsageCount: number;\n  governanceReviewUsageCount: number;\n  replaceableUsageCount: number;\n}\n\nexport interface MigrationValidationReport {\n  valid: boolean;\n  summary: MigrationValidationSummary;\n  usages: LegacyVariableUsage[];\n  usagesByType: Record<MigrationMappingType, LegacyVariableUsage[]>;\n  replaceableUsages: ReplaceableMigrationUsage[];\n  issues: MigrationValidationIssue[];\n}\n\nconst legacyVariablePattern =\n  /--(?:alias|interaction|non-semantic)-[a-zA-Z0-9_-]+/g;\n\nfunction getLegacyType(source: LegacyCssVariableName): MigrationMappingType {\n  if (source.startsWith('--alias-')) return 'alias';\n  if (source.startsWith('--interaction-')) return 'interaction';\n  return 'non-semantic';\n}\n\nfunction getLineAndColumn(content: string, index: number) {\n  const before = content.slice(0, index);\n  const lines = before.split('\\n');\n\n  return {\n    line: lines.length,\n    column: lines[lines.length - 1].length + 1,\n  };\n}\n\nfunction createIssue(\n  code: MigrationValidationIssueCode,\n  usage: LegacyVariableUsage,\n  mapping?: MigrationMappingEntry,\n): MigrationValidationIssue {\n  if (code === 'unregistered-legacy-variable') {\n    return {\n      code,\n      severity: 'error',\n      usage,\n      message: `${usage.source} is used but not registered in migrationMappingRegistry.`,\n    };\n  }\n\n  if (code === 'blocked-migration-mapping') {\n    return {\n      code,\n      severity: 'warning',\n      usage,\n      mapping,\n      message: `${usage.source} is blocked and must not be treated as directly replaceable.`,\n    };\n  }\n\n  if (code === 'deprecated-migration-mapping') {\n    return {\n      code,\n      severity: 'warning',\n      usage,\n      mapping,\n      message: `${usage.source} is deprecated and requires migration review before replacement.`,\n    };\n  }\n\n  return {\n    code,\n    severity: 'warning',\n    usage,\n    mapping,\n    message: `${usage.source} requires governance review and must not be treated as directly replaceable.`,\n  };\n}\n\nexport function scanLegacyVariableUsages(\n  sources: readonly MigrationValidationSource[],\n): LegacyVariableUsage[] {\n  const usages: LegacyVariableUsage[] = [];\n\n  for (const source of sources) {\n    const pattern = new RegExp(legacyVariablePattern);\n    let match: RegExpExecArray | null;\n\n    while ((match = pattern.exec(source.content))) {\n      const variable = match[0] as LegacyCssVariableName;\n      const index = match.index ?? 0;\n      const position = getLineAndColumn(source.content, index);\n\n      usages.push({\n        source: variable,\n        path: source.path,\n        line: position.line,\n        column: position.column,\n        index,\n        type: getLegacyType(variable),\n      });\n    }\n  }\n\n  return usages;\n}\n\nexport function validateMigrationMapping(\n  sources: readonly MigrationValidationSource[],\n): MigrationValidationReport {\n  const usages = scanLegacyVariableUsages(sources);\n  const issues: MigrationValidationIssue[] = [];\n  const replaceableUsages: ReplaceableMigrationUsage[] = [];\n  const usagesByType: Record<MigrationMappingType, LegacyVariableUsage[]> = {\n    alias: [],\n    interaction: [],\n    'non-semantic': [],\n  };\n\n  let registeredUsageCount = 0;\n  let unregisteredUsageCount = 0;\n  let blockedUsageCount = 0;\n  let deprecatedUsageCount = 0;\n  let governanceReviewUsageCount = 0;\n\n  for (const usage of usages) {\n    usagesByType[usage.type].push(usage);\n\n    const mapping = getMigrationMapping(usage.source);\n\n    if (!mapping) {\n      unregisteredUsageCount += 1;\n      issues.push(createIssue('unregistered-legacy-variable', usage));\n      continue;\n    }\n\n    registeredUsageCount += 1;\n\n    if (mapping.lifecycle === 'blocked') {\n      blockedUsageCount += 1;\n      issues.push(createIssue('blocked-migration-mapping', usage, mapping));\n      continue;\n    }\n\n    if (mapping.strategy === 'governance-review-required' || !mapping.target) {\n      governanceReviewUsageCount += 1;\n      issues.push(createIssue('governance-review-required', usage, mapping));\n      continue;\n    }\n\n    if (mapping.lifecycle === 'deprecated') {\n      deprecatedUsageCount += 1;\n      issues.push(createIssue('deprecated-migration-mapping', usage, mapping));\n      continue;\n    }\n\n    replaceableUsages.push({\n      usage,\n      mapping: mapping as ReplaceableMigrationUsage['mapping'],\n    });\n  }\n\n  const hasError = issues.some((issue) => issue.severity === 'error');\n\n  return {\n    valid: !hasError,\n    summary: {\n      filesScanned: sources.length,\n      legacyVariableUsageCount: usages.length,\n      uniqueLegacyVariableCount: new Set(usages.map((usage) => usage.source))\n        .size,\n      registeredUsageCount,\n      unregisteredUsageCount,\n      blockedUsageCount,\n      deprecatedUsageCount,\n      governanceReviewUsageCount,\n      replaceableUsageCount: replaceableUsages.length,\n    },\n    usages,\n    usagesByType,\n    replaceableUsages,\n    issues,\n  };\n}\n\nexport function formatMigrationValidationReport(\n  report: MigrationValidationReport,\n): string {\n  const lines = [\n    'Migration Mapping Validation Report',\n    '',\n    `Status: ${report.valid ? 'PASS' : 'FAIL'}`,\n    `Files scanned: ${report.summary.filesScanned}`,\n    `Legacy variable usages: ${report.summary.legacyVariableUsageCount}`,\n    `Unique legacy variables: ${report.summary.uniqueLegacyVariableCount}`,\n    `Registered usages: ${report.summary.registeredUsageCount}`,\n    `Unregistered usages: ${report.summary.unregisteredUsageCount}`,\n    `Blocked usages: ${report.summary.blockedUsageCount}`,\n    `Deprecated usages: ${report.summary.deprecatedUsageCount}`,\n    `Governance review usages: ${report.summary.governanceReviewUsageCount}`,\n    `Replaceable usages: ${report.summary.replaceableUsageCount}`,\n    '',\n    'Grouped by type:',\n    `- alias: ${report.usagesByType.alias.length}`,\n    `- interaction: ${report.usagesByType.interaction.length}`,\n    `- non-semantic: ${report.usagesByType['non-semantic'].length}`,\n  ];\n\n  if (report.issues.length > 0) {\n    lines.push('', 'Issues:');\n\n    for (const issue of report.issues) {\n      lines.push(\n        `- [${issue.severity}] ${issue.code}: ${issue.usage.source} at ${issue.usage.path}:${issue.usage.line}:${issue.usage.column}`,\n      );\n    }\n  }\n\n  return lines.join('\\n');\n}\n"],"mappings":"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"}

package/dist/theme/index.d.ts

@@ -1,5 +1,16 @@
-export { createTheme } from './createTheme.js';
-export { defaultTheme } from './defaultTheme.js';
-export { initAldTheme } from './initAldTheme.js';
-export { themeToCssVars } from './themeToCssVars.js';
-export type { AldThemeConfig, AldThemeCssVars, AldThemeToken, ResolvedAldTheme, } from './types.js';
+export { createTheme } from './runtime/createTheme.js';
+export { defaultTheme } from './runtime/defaultTheme.js';
+export { initAldTheme } from './runtime/initAldTheme.js';
+export { aldColorValueModeDataAttribute, aldColorValueModeStyleElementId, applyAldColorValueMode, buildAldColorValueModeCss, } from './runtime/colorValueMode.js';
+export { aldColorValueModes, createAldV3ColorValueModeVars, getAldColorValueModeDefinition, getAldColorValueModeDefinitions, } from './runtime/colorValueMode/registry.js';
+export type { AldColorValueMode, AldColorValueModeDefinition, AldColorValueModeLifecycle, } from './runtime/colorValueMode/registry.js';
+export { assertOneWayMigrationMapping, getMigrationMapping, getPublishedMigrationMappings, migrationMappingRegistry, migrationMappingTableByType, } from './governance/migrationMappingRegistry.js';
+export type { LegacyCssVariableName, MigrationMappingEntry, MigrationMappingLifecycle, MigrationMappingStrategy, MigrationMappingType, TokenOutputVariableName, } from './governance/migrationMappingRegistry.js';
+export { createReviewGateDecision, formatReviewGateDecision, runMigrationReviewGate, } from './governance/reviewGate.js';
+export type { ReviewGateDecision, ReviewGateDecisionIssue, ReviewGateDecisionReason, ReviewGateDecisionSummary, ReviewGateDecisionStatus, ReviewGateReasonCode, } from './governance/reviewGate.js';
+export { getCanonicalTokenOutputContractEntries, getCompatibilityTokenOutputContractEntries, getTokenOutputContractEntries, getTokenOutputContractEntriesByGroup, getTokenOutputContractEntry, isTokenOutputContractName, tokenOutputContractEntries, validateTokenOutputContract, } from './contract/tokenOutputContract.js';
+export type { TokenOutputContractCompatibility, TokenOutputContractDeliveryKind, TokenOutputContractEntry, TokenOutputContractGroup, TokenOutputContractLifecycle, TokenOutputContractValidationIssue, TokenOutputContractValidationIssueCode, TokenOutputContractValidationReport, } from './contract/tokenOutputContract.js';
+export { themeToCssVars } from './runtime/themeToCssVars.js';
+export type { AldThemeConfig, AldThemeCssVars, AldThemeToken, ResolvedAldTheme, } from './runtime/types.js';
+export { formatMigrationValidationReport, scanLegacyVariableUsages, validateMigrationMapping, } from './governance/validateMigrationMapping.js';
+export type { LegacyVariableUsage, MigrationValidationIssue, MigrationValidationIssueCode, MigrationValidationReport, MigrationValidationSeverity, MigrationValidationSource, MigrationValidationSummary, ReplaceableMigrationUsage, } from './governance/validateMigrationMapping.js';

package/dist/theme/index.js

@@ -1,4 +1,10 @@
-import "./defaultTheme.js";
-import "./createTheme.js";
-import "./themeToCssVars.js";
-import "./initAldTheme.js";
+import "./runtime/defaultTheme.js";
+import "./runtime/createTheme.js";
+import "./runtime/themeToCssVars.js";
+import "./runtime/initAldTheme.js";
+import "./runtime/colorValueMode/registry.js";
+import "./runtime/colorValueMode/index.js";
+import "./governance/migrationMappingRegistry.js";
+import "./governance/validateMigrationMapping.js";
+import "./governance/reviewGate.js";
+import "./contract/tokenOutputContract.js";

package/dist/theme/runtime/colorValueMode/index.d.ts

@@ -0,0 +1,5 @@
+import { AldColorValueMode } from './registry.js';
+export declare const aldColorValueModeStyleElementId = "ald-color-value-mode-runtime";
+export declare const aldColorValueModeDataAttribute = "data-ald-color-value-mode";
+export declare function buildAldColorValueModeCss(mode: unknown): string;
+export declare function applyAldColorValueMode(mode: unknown): AldColorValueMode;

package/dist/theme/runtime/colorValueMode/index.js

@@ -0,0 +1,49 @@
+import { themeStyleElementId } from "../tokenMap.js";
+import { getAldColorValueModeDefinition, isAldColorValueMode } from "./registry.js";
+//#region src/theme/runtime/colorValueMode/index.ts
+var aldColorValueModeStyleElementId = "ald-color-value-mode-runtime";
+var aldColorValueModeDataAttribute = "data-ald-color-value-mode";
+function buildAldColorValueModeCss(mode) {
+	const definition = getAldColorValueModeDefinition(mode);
+	const entries = Object.entries(definition.vars);
+	if (entries.length === 0) return "";
+	const declarations = entries.sort(([a], [b]) => a.localeCompare(b)).map(([name, value]) => `  ${name}: ${value};`).join("\n");
+	return `:root[${aldColorValueModeDataAttribute}="${definition.mode}"] {\n${declarations}\n}\n`;
+}
+function removeAldColorValueModeLayer() {
+	document.getElementById(aldColorValueModeStyleElementId)?.remove();
+}
+function appendBeforeTenantTheme(style) {
+	const tenantThemeStyle = document.getElementById(themeStyleElementId);
+	if (tenantThemeStyle) {
+		document.head.insertBefore(style, tenantThemeStyle);
+		return;
+	}
+	document.head.appendChild(style);
+}
+function injectAldColorValueModeLayer(mode) {
+	const cssText = buildAldColorValueModeCss(mode);
+	let style = document.getElementById(aldColorValueModeStyleElementId);
+	if (!cssText) {
+		removeAldColorValueModeLayer();
+		return;
+	}
+	if (!style) {
+		style = document.createElement("style");
+		style.id = aldColorValueModeStyleElementId;
+		appendBeforeTenantTheme(style);
+	}
+	style.setAttribute(aldColorValueModeDataAttribute, mode);
+	if (style.textContent !== cssText) style.textContent = cssText;
+}
+function applyAldColorValueMode(mode) {
+	if (typeof document === "undefined") return "legacy";
+	const normalizedMode = isAldColorValueMode(mode) ? mode : "legacy";
+	document.documentElement.setAttribute(aldColorValueModeDataAttribute, normalizedMode);
+	injectAldColorValueModeLayer(normalizedMode);
+	return normalizedMode;
+}
+//#endregion
+export { aldColorValueModeDataAttribute, aldColorValueModeStyleElementId, applyAldColorValueMode, buildAldColorValueModeCss };
+
+//# sourceMappingURL=index.js.map

package/dist/theme/runtime/colorValueMode/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/theme/runtime/colorValueMode/index.ts"],"sourcesContent":["import {\n  getAldColorValueModeDefinition,\n  isAldColorValueMode,\n  type AldColorValueMode,\n} from './registry';\nimport { themeStyleElementId } from '../tokenMap';\n\nexport const aldColorValueModeStyleElementId = 'ald-color-value-mode-runtime';\nexport const aldColorValueModeDataAttribute = 'data-ald-color-value-mode';\n\nexport function buildAldColorValueModeCss(mode: unknown) {\n  const definition = getAldColorValueModeDefinition(mode);\n  const entries = Object.entries(definition.vars);\n\n  if (entries.length === 0) return '';\n\n  const declarations = entries\n    .sort(([a], [b]) => a.localeCompare(b))\n    .map(([name, value]) => `  ${name}: ${value};`)\n    .join('\\n');\n\n  return `:root[${aldColorValueModeDataAttribute}=\"${definition.mode}\"] {\\n${declarations}\\n}\\n`;\n}\n\nfunction removeAldColorValueModeLayer() {\n  document.getElementById(aldColorValueModeStyleElementId)?.remove();\n}\n\nfunction appendBeforeTenantTheme(style: HTMLStyleElement) {\n  const tenantThemeStyle = document.getElementById(themeStyleElementId);\n\n  if (tenantThemeStyle) {\n    document.head.insertBefore(style, tenantThemeStyle);\n    return;\n  }\n\n  document.head.appendChild(style);\n}\n\nfunction injectAldColorValueModeLayer(mode: AldColorValueMode) {\n  const cssText = buildAldColorValueModeCss(mode);\n  let style = document.getElementById(\n    aldColorValueModeStyleElementId,\n  ) as HTMLStyleElement | null;\n\n  if (!cssText) {\n    removeAldColorValueModeLayer();\n    return;\n  }\n\n  if (!style) {\n    style = document.createElement('style');\n    style.id = aldColorValueModeStyleElementId;\n    appendBeforeTenantTheme(style);\n  }\n\n  style.setAttribute(aldColorValueModeDataAttribute, mode);\n\n  if (style.textContent !== cssText) {\n    style.textContent = cssText;\n  }\n}\n\nexport function applyAldColorValueMode(mode: unknown): AldColorValueMode {\n  if (typeof document === 'undefined') return 'legacy';\n\n  const normalizedMode = isAldColorValueMode(mode) ? mode : 'legacy';\n\n  document.documentElement.setAttribute(\n    aldColorValueModeDataAttribute,\n    normalizedMode,\n  );\n  injectAldColorValueModeLayer(normalizedMode);\n\n  return normalizedMode;\n}\n"],"mappings":";;;AAOA,IAAa,kCAAkC;AAC/C,IAAa,iCAAiC;AAE9C,SAAgB,0BAA0B,MAAe;CACvD,MAAM,aAAa,+BAA+B,KAAK;CACvD,MAAM,UAAU,OAAO,QAAQ,WAAW,KAAK;AAE/C,KAAI,QAAQ,WAAW,EAAG,QAAO;CAEjC,MAAM,eAAe,QAClB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC,CACtC,KAAK,CAAC,MAAM,WAAW,KAAK,KAAK,IAAI,MAAM,GAAG,CAC9C,KAAK,KAAK;AAEb,QAAO,SAAS,+BAA+B,IAAI,WAAW,KAAK,QAAQ,aAAa;;AAG1F,SAAS,+BAA+B;AACtC,UAAS,eAAe,gCAAgC,EAAE,QAAQ;;AAGpE,SAAS,wBAAwB,OAAyB;CACxD,MAAM,mBAAmB,SAAS,eAAe,oBAAoB;AAErE,KAAI,kBAAkB;AACpB,WAAS,KAAK,aAAa,OAAO,iBAAiB;AACnD;;AAGF,UAAS,KAAK,YAAY,MAAM;;AAGlC,SAAS,6BAA6B,MAAyB;CAC7D,MAAM,UAAU,0BAA0B,KAAK;CAC/C,IAAI,QAAQ,SAAS,eACnB,gCACD;AAED,KAAI,CAAC,SAAS;AACZ,gCAA8B;AAC9B;;AAGF,KAAI,CAAC,OAAO;AACV,UAAQ,SAAS,cAAc,QAAQ;AACvC,QAAM,KAAK;AACX,0BAAwB,MAAM;;AAGhC,OAAM,aAAa,gCAAgC,KAAK;AAExD,KAAI,MAAM,gBAAgB,QACxB,OAAM,cAAc;;AAIxB,SAAgB,uBAAuB,MAAkC;AACvE,KAAI,OAAO,aAAa,YAAa,QAAO;CAE5C,MAAM,iBAAiB,oBAAoB,KAAK,GAAG,OAAO;AAE1D,UAAS,gBAAgB,aACvB,gCACA,eACD;AACD,8BAA6B,eAAe;AAE5C,QAAO"}

package/dist/theme/runtime/colorValueMode/registry.d.ts

@@ -0,0 +1,29 @@
+import { AldThemeCssVars } from '../types';
+export type AldColorValueModeLifecycle = 'stable' | 'experimental' | 'deprecated';
+export interface AldColorValueModeDefinition<Mode extends string = string> {
+    mode: Mode;
+    title: string;
+    lifecycle: AldColorValueModeLifecycle;
+    vars: AldThemeCssVars;
+}
+declare const colorValueModeRegistry: {
+    readonly legacy: {
+        readonly mode: "legacy";
+        readonly title: "Legacy compatibility values";
+        readonly lifecycle: "stable";
+        readonly vars: {};
+    };
+    readonly v3: {
+        readonly mode: "v3";
+        readonly title: "ALD V3 values";
+        readonly lifecycle: "stable";
+        readonly vars: AldThemeCssVars;
+    };
+};
+export type AldColorValueMode = keyof typeof colorValueModeRegistry;
+export declare const aldColorValueModes: readonly ("legacy" | "v3")[];
+export declare function isAldColorValueMode(value: unknown): value is AldColorValueMode;
+export declare function getAldColorValueModeDefinition(mode: unknown): AldColorValueModeDefinition<AldColorValueMode>;
+export declare function getAldColorValueModeDefinitions(): Array<AldColorValueModeDefinition<AldColorValueMode>>;
+export declare function createAldV3ColorValueModeVars(): AldThemeCssVars;
+export {};

package/dist/theme/runtime/colorValueMode/registry.js

@@ -0,0 +1,39 @@
+import { aldV3ColorValueModeVars } from "./v3.js";
+//#region src/theme/runtime/colorValueMode/registry.ts
+var colorValueModeRegistry = {
+	legacy: {
+		mode: "legacy",
+		title: "Legacy compatibility values",
+		lifecycle: "stable",
+		vars: {}
+	},
+	v3: {
+		mode: "v3",
+		title: "ALD V3 values",
+		lifecycle: "stable",
+		vars: aldV3ColorValueModeVars
+	}
+};
+var aldColorValueModes = Object.freeze(Object.keys(colorValueModeRegistry));
+function isAldColorValueMode(value) {
+	return typeof value === "string" && Object.prototype.hasOwnProperty.call(colorValueModeRegistry, value);
+}
+function copyDefinition(definition) {
+	return {
+		...definition,
+		vars: { ...definition.vars }
+	};
+}
+function getAldColorValueModeDefinition(mode) {
+	return copyDefinition(colorValueModeRegistry[isAldColorValueMode(mode) ? mode : "legacy"]);
+}
+function getAldColorValueModeDefinitions() {
+	return aldColorValueModes.map((mode) => getAldColorValueModeDefinition(mode));
+}
+function createAldV3ColorValueModeVars() {
+	return { ...aldV3ColorValueModeVars };
+}
+//#endregion
+export { aldColorValueModes, createAldV3ColorValueModeVars, getAldColorValueModeDefinition, getAldColorValueModeDefinitions, isAldColorValueMode };
+
+//# sourceMappingURL=registry.js.map

package/dist/theme/runtime/colorValueMode/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":[],"sources":["../../../../src/theme/runtime/colorValueMode/registry.ts"],"sourcesContent":["import { aldV3ColorValueModeVars } from './v3';\nimport type { AldThemeCssVars } from '../types';\n\nexport type AldColorValueModeLifecycle =\n  | 'stable'\n  | 'experimental'\n  | 'deprecated';\n\nexport interface AldColorValueModeDefinition<Mode extends string = string> {\n  mode: Mode;\n  title: string;\n  lifecycle: AldColorValueModeLifecycle;\n  vars: AldThemeCssVars;\n}\n\nconst colorValueModeRegistry = {\n  legacy: {\n    mode: 'legacy',\n    title: 'Legacy compatibility values',\n    lifecycle: 'stable',\n    vars: {},\n  },\n  v3: {\n    mode: 'v3',\n    title: 'ALD V3 values',\n    lifecycle: 'stable',\n    vars: aldV3ColorValueModeVars,\n  },\n} as const satisfies Record<string, AldColorValueModeDefinition>;\n\nexport type AldColorValueMode = keyof typeof colorValueModeRegistry;\n\nexport const aldColorValueModes = Object.freeze(\n  Object.keys(colorValueModeRegistry) as AldColorValueMode[],\n);\n\nexport function isAldColorValueMode(\n  value: unknown,\n): value is AldColorValueMode {\n  return (\n    typeof value === 'string' &&\n    Object.prototype.hasOwnProperty.call(colorValueModeRegistry, value)\n  );\n}\n\nfunction copyDefinition(\n  definition: AldColorValueModeDefinition<AldColorValueMode>,\n): AldColorValueModeDefinition<AldColorValueMode> {\n  return {\n    ...definition,\n    vars: { ...definition.vars },\n  };\n}\n\nexport function getAldColorValueModeDefinition(\n  mode: unknown,\n): AldColorValueModeDefinition<AldColorValueMode> {\n  const normalizedMode = isAldColorValueMode(mode) ? mode : 'legacy';\n\n  return copyDefinition(\n    colorValueModeRegistry[\n      normalizedMode\n    ] as AldColorValueModeDefinition<AldColorValueMode>,\n  );\n}\n\nexport function getAldColorValueModeDefinitions(): Array<\n  AldColorValueModeDefinition<AldColorValueMode>\n> {\n  return aldColorValueModes.map((mode) => getAldColorValueModeDefinition(mode));\n}\n\nexport function createAldV3ColorValueModeVars(): AldThemeCssVars {\n  return { ...aldV3ColorValueModeVars };\n}\n"],"mappings":";;AAeA,IAAM,yBAAyB;CAC7B,QAAQ;EACN,MAAM;EACN,OAAO;EACP,WAAW;EACX,MAAM,EAAE;EACT;CACD,IAAI;EACF,MAAM;EACN,OAAO;EACP,WAAW;EACX,MAAM;EACP;CACF;AAID,IAAa,qBAAqB,OAAO,OACvC,OAAO,KAAK,uBAAuB,CACpC;AAED,SAAgB,oBACd,OAC4B;AAC5B,QACE,OAAO,UAAU,YACjB,OAAO,UAAU,eAAe,KAAK,wBAAwB,MAAM;;AAIvE,SAAS,eACP,YACgD;AAChD,QAAO;EACL,GAAG;EACH,MAAM,EAAE,GAAG,WAAW,MAAM;EAC7B;;AAGH,SAAgB,+BACd,MACgD;AAGhD,QAAO,eACL,uBAHqB,oBAAoB,KAAK,GAAG,OAAO,UAMzD;;AAGH,SAAgB,kCAEd;AACA,QAAO,mBAAmB,KAAK,SAAS,+BAA+B,KAAK,CAAC;;AAG/E,SAAgB,gCAAiD;AAC/D,QAAO,EAAE,GAAG,yBAAyB"}

package/dist/theme/runtime/colorValueMode/v3.d.ts

@@ -0,0 +1,98 @@
+import { AldThemeCssVars } from '../types';
+export declare const aldV3ColorValueModePalette: {
+    readonly neutral: {
+        readonly 0: "#FDFEFF";
+        readonly 25: "#F6F9FB";
+        readonly 50: "#EEF1F5";
+        readonly 100: "#E3E7EC";
+        readonly 200: "#D1D6DC";
+        readonly 300: "#B4B9C1";
+        readonly 400: "#8D939B";
+        readonly 500: "#6D747C";
+        readonly 600: "#484F58";
+        readonly 700: "#313740";
+        readonly 800: "#1D232C";
+        readonly 900: "#12181F";
+        readonly 950: "#060A10";
+        readonly 1000: "#010103";
+    };
+    readonly brand: {
+        readonly 50: "#F4F8FF";
+        readonly 100: "#E7F0FF";
+        readonly 200: "#C7DBFA";
+        readonly 300: "#94B7F2";
+        readonly 400: "#6B96E8";
+        readonly 500: "#4A79DE";
+        readonly 600: "#3162D4";
+        readonly 700: "#284FAF";
+        readonly 800: "#223F8C";
+        readonly 900: "#1B336D";
+        readonly 950: "#14244A";
+    };
+    readonly blue: {
+        readonly 50: "#F2F8FF";
+        readonly 100: "#E1F0FF";
+        readonly 200: "#BFE0FF";
+        readonly 300: "#8EC8F6";
+        readonly 400: "#56A9E9";
+        readonly 500: "#2D8BD6";
+        readonly 600: "#1F72B6";
+        readonly 700: "#1B5C95";
+        readonly 800: "#1A4774";
+        readonly 900: "#173A5E";
+        readonly 950: "#0F243D";
+    };
+    readonly green: {
+        readonly 50: "#F2FBF7";
+        readonly 100: "#E3F7ED";
+        readonly 200: "#C2EBD7";
+        readonly 300: "#91D8B6";
+        readonly 400: "#5FC08F";
+        readonly 500: "#35A873";
+        readonly 600: "#25895D";
+        readonly 700: "#1F6F4D";
+        readonly 800: "#1A583F";
+        readonly 900: "#154633";
+        readonly 950: "#0D2B20";
+    };
+    readonly yellow: {
+        readonly 50: "#FFFBEB";
+        readonly 100: "#FFF4C2";
+        readonly 200: "#FFE68A";
+        readonly 300: "#F8CF48";
+        readonly 400: "#E9B323";
+        readonly 500: "#C89313";
+        readonly 600: "#9F710E";
+        readonly 700: "#7E590F";
+        readonly 800: "#64460F";
+        readonly 900: "#4B340C";
+        readonly 950: "#2F2108";
+    };
+    readonly orange: {
+        readonly 50: "#FFF7ED";
+        readonly 100: "#FFEAD2";
+        readonly 200: "#FFD0A3";
+        readonly 300: "#FFB06B";
+        readonly 400: "#F28D3A";
+        readonly 500: "#D46F1F";
+        readonly 600: "#B25516";
+        readonly 700: "#8F4215";
+        readonly 800: "#713516";
+        readonly 900: "#572A14";
+        readonly 950: "#34180B";
+    };
+    readonly red: {
+        readonly 50: "#FFF5F5";
+        readonly 100: "#FFE5E7";
+        readonly 200: "#FFC9D0";
+        readonly 300: "#F59AA7";
+        readonly 400: "#E86A7A";
+        readonly 500: "#D54355";
+        readonly 600: "#B93243";
+        readonly 700: "#982838";
+        readonly 800: "#7A2130";
+        readonly 900: "#611B28";
+        readonly 950: "#3B1018";
+    };
+};
+export declare const aldV3ColorValueModeVars: AldThemeCssVars;