@contractspec/bundle.workspace 1.46.1 → 1.47.0

package/dist/services/test-link/test-ref-validator.mjs

@@ -0,0 +1,50 @@
+//#region src/services/test-link/test-ref-validator.ts
+/**
+* Build a spec key from key and version.
+*/
+function makeSpecKey(key, version) {
+	return `${key}.v${version}`;
+}
+/**
+* Validate that all test references in a spec exist in the test inventory.
+*
+* @param specFile - The spec file being validated
+* @param specKey - The spec's key (for error messages)
+* @param specVersion - The spec's version (for error messages)
+* @param testRefs - Array of test references from the spec
+* @param testIndex - Map of test spec keys to their locations
+* @param options - Validation options
+* @returns Validation result with found/missing tests and errors
+*/
+function validateTestRefs(specFile, specKey, specVersion, testRefs, testIndex, options = {}) {
+	const { treatMissingAsError = true } = options;
+	if (!testRefs || testRefs.length === 0) return {
+		valid: true,
+		foundTests: [],
+		missingTests: [],
+		errors: [],
+		specFile
+	};
+	const foundTests = [];
+	const missingTests = [];
+	const errors = [];
+	for (const ref of testRefs) {
+		const testKey = makeSpecKey(ref.key, ref.version);
+		if (testIndex.has(testKey)) foundTests.push(ref);
+		else {
+			missingTests.push(ref);
+			if (treatMissingAsError) errors.push(`Spec ${specKey}.v${specVersion} references test ${ref.key}.v${ref.version} which does not exist`);
+		}
+	}
+	return {
+		valid: missingTests.length === 0,
+		foundTests,
+		missingTests,
+		errors,
+		specFile
+	};
+}
+
+//#endregion
+export { validateTestRefs };
+//# sourceMappingURL=test-ref-validator.mjs.map

package/dist/services/test-link/test-ref-validator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-ref-validator.mjs","names":[],"sources":["../../../src/services/test-link/test-ref-validator.ts"],"sourcesContent":["/**\n * Test reference validator.\n *\n * Validates that OperationSpec.tests references point to existing TestSpecs.\n */\n\nimport type { SpecLocation } from '../integrity';\nimport type { RefInfo } from '@contractspec/module.workspace';\n\n/**\n * Options for test reference validation.\n */\nexport interface TestRefValidationOptions {\n  /**\n   * Treat missing tests as errors (default: true).\n   * When false, missing tests are reported as warnings.\n   */\n  treatMissingAsError?: boolean;\n}\n\n/**\n * Result of validating test references for a spec.\n */\nexport interface TestRefValidationResult {\n  /**\n   * Whether all referenced tests are valid.\n   */\n  valid: boolean;\n\n  /**\n   * Test refs that were found and valid.\n   */\n  foundTests: RefInfo[];\n\n  /**\n   * Test refs that were not found.\n   */\n  missingTests: RefInfo[];\n\n  /**\n   * Error messages for missing tests.\n   */\n  errors: string[];\n\n  /**\n   * The source file being validated.\n   */\n  specFile: string;\n}\n\n/**\n * Build a spec key from key and version.\n */\nfunction makeSpecKey(key: string, version: string): string {\n  return `${key}.v${version}`;\n}\n\n/**\n * Validate that all test references in a spec exist in the test inventory.\n *\n * @param specFile - The spec file being validated\n * @param specKey - The spec's key (for error messages)\n * @param specVersion - The spec's version (for error messages)\n * @param testRefs - Array of test references from the spec\n * @param testIndex - Map of test spec keys to their locations\n * @param options - Validation options\n * @returns Validation result with found/missing tests and errors\n */\nexport function validateTestRefs(\n  specFile: string,\n  specKey: string,\n  specVersion: string,\n  testRefs: RefInfo[] | undefined,\n  testIndex: Map<string, SpecLocation>,\n  options: TestRefValidationOptions = {}\n): TestRefValidationResult {\n  const { treatMissingAsError = true } = options;\n\n  if (!testRefs || testRefs.length === 0) {\n    return {\n      valid: true,\n      foundTests: [],\n      missingTests: [],\n      errors: [],\n      specFile,\n    };\n  }\n\n  const foundTests: RefInfo[] = [];\n  const missingTests: RefInfo[] = [];\n  const errors: string[] = [];\n\n  for (const ref of testRefs) {\n    const testKey = makeSpecKey(ref.key, ref.version);\n\n    if (testIndex.has(testKey)) {\n      foundTests.push(ref);\n    } else {\n      missingTests.push(ref);\n      if (treatMissingAsError) {\n        errors.push(\n          `Spec ${specKey}.v${specVersion} references test ${ref.key}.v${ref.version} which does not exist`\n        );\n      }\n    }\n  }\n\n  return {\n    valid: missingTests.length === 0,\n    foundTests,\n    missingTests,\n    errors,\n    specFile,\n  };\n}\n\n/**\n * Batch validate test references for multiple specs.\n *\n * @param specs - Array of specs with their test refs\n * @param testIndex - Map of test spec keys to their locations\n * @param options - Validation options\n * @returns Array of validation results\n */\nexport function validateAllTestRefs(\n  specs: {\n    specFile: string;\n    specKey: string;\n    specVersion: string;\n    testRefs: RefInfo[] | undefined;\n  }[],\n  testIndex: Map<string, SpecLocation>,\n  options: TestRefValidationOptions = {}\n): TestRefValidationResult[] {\n  return specs.map((spec) =>\n    validateTestRefs(\n      spec.specFile,\n      spec.specKey,\n      spec.specVersion,\n      spec.testRefs,\n      testIndex,\n      options\n    )\n  );\n}\n\n/**\n * Aggregate validation results into a summary.\n */\nexport function aggregateValidationResults(\n  results: TestRefValidationResult[]\n): {\n  totalSpecs: number;\n  specsWithRefs: number;\n  totalRefs: number;\n  foundRefs: number;\n  missingRefs: number;\n  allValid: boolean;\n  allErrors: string[];\n} {\n  let specsWithRefs = 0;\n  let totalRefs = 0;\n  let foundRefs = 0;\n  let missingRefs = 0;\n  const allErrors: string[] = [];\n\n  for (const result of results) {\n    const refCount = result.foundTests.length + result.missingTests.length;\n    if (refCount > 0) {\n      specsWithRefs++;\n      totalRefs += refCount;\n      foundRefs += result.foundTests.length;\n      missingRefs += result.missingTests.length;\n      allErrors.push(...result.errors);\n    }\n  }\n\n  return {\n    totalSpecs: results.length,\n    specsWithRefs,\n    totalRefs,\n    foundRefs,\n    missingRefs,\n    allValid: missingRefs === 0,\n    allErrors,\n  };\n}\n"],"mappings":";;;;AAqDA,SAAS,YAAY,KAAa,SAAyB;AACzD,QAAO,GAAG,IAAI,IAAI;;;;;;;;;;;;;AAcpB,SAAgB,iBACd,UACA,SACA,aACA,UACA,WACA,UAAoC,EAAE,EACb;CACzB,MAAM,EAAE,sBAAsB,SAAS;AAEvC,KAAI,CAAC,YAAY,SAAS,WAAW,EACnC,QAAO;EACL,OAAO;EACP,YAAY,EAAE;EACd,cAAc,EAAE;EAChB,QAAQ,EAAE;EACV;EACD;CAGH,MAAM,aAAwB,EAAE;CAChC,MAAM,eAA0B,EAAE;CAClC,MAAM,SAAmB,EAAE;AAE3B,MAAK,MAAM,OAAO,UAAU;EAC1B,MAAM,UAAU,YAAY,IAAI,KAAK,IAAI,QAAQ;AAEjD,MAAI,UAAU,IAAI,QAAQ,CACxB,YAAW,KAAK,IAAI;OACf;AACL,gBAAa,KAAK,IAAI;AACtB,OAAI,oBACF,QAAO,KACL,QAAQ,QAAQ,IAAI,YAAY,mBAAmB,IAAI,IAAI,IAAI,IAAI,QAAQ,uBAC5E;;;AAKP,QAAO;EACL,OAAO,aAAa,WAAW;EAC/B;EACA;EACA;EACA;EACD"}

package/dist/services/upgrade/index.d.mts

@@ -0,0 +1,10 @@
+import { ConfigUpgradeInfo, PackageUpgradeInfo, UpgradeAnalysisResult, UpgradeApplyResult, UpgradeOptions } from "./types.mjs";
+import { analyzeUpgrades, applyConfigUpgrades, getDefaultHooksConfig, getDefaultVersioningConfig, getPackageUpgradeCommand } from "./upgrade-service.mjs";
+
+//#region src/services/upgrade/index.d.ts
+declare namespace index_d_exports {
+  export { ConfigUpgradeInfo, PackageUpgradeInfo, UpgradeAnalysisResult, UpgradeApplyResult, UpgradeOptions, analyzeUpgrades, applyConfigUpgrades, getDefaultHooksConfig, getDefaultVersioningConfig, getPackageUpgradeCommand };
+}
+//#endregion
+export { index_d_exports };
+//# sourceMappingURL=index.d.mts.map

package/dist/services/upgrade/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/services/upgrade/index.ts"],"sourcesContent":[],"mappings":""}

package/dist/services/upgrade/index.mjs

@@ -0,0 +1,15 @@
+import { __exportAll } from "../../_virtual/rolldown_runtime.mjs";
+import { analyzeUpgrades, applyConfigUpgrades, getDefaultHooksConfig, getDefaultVersioningConfig, getPackageUpgradeCommand } from "./upgrade-service.mjs";
+
+//#region src/services/upgrade/index.ts
+var upgrade_exports = /* @__PURE__ */ __exportAll({
+	analyzeUpgrades: () => analyzeUpgrades,
+	applyConfigUpgrades: () => applyConfigUpgrades,
+	getDefaultHooksConfig: () => getDefaultHooksConfig,
+	getDefaultVersioningConfig: () => getDefaultVersioningConfig,
+	getPackageUpgradeCommand: () => getPackageUpgradeCommand
+});
+
+//#endregion
+export { upgrade_exports };
+//# sourceMappingURL=index.mjs.map

package/dist/services/upgrade/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/services/upgrade/index.ts"],"sourcesContent":["/**\n * Upgrade service module.\n *\n * Provides upgrade analysis and application for ContractSpec SDK and config.\n */\n\nexport * from './types';\nexport {\n  analyzeUpgrades,\n  applyConfigUpgrades,\n  getPackageUpgradeCommand,\n  getDefaultVersioningConfig,\n  getDefaultHooksConfig,\n} from './upgrade-service';\n"],"mappings":""}

package/dist/services/upgrade/types.d.mts

@@ -0,0 +1,78 @@
+//#region src/services/upgrade/types.d.ts
+/**
+ * Upgrade service types.
+ *
+ * Types for upgrading ContractSpec SDK and configuration.
+ */
+/**
+ * Options for running an upgrade.
+ */
+interface UpgradeOptions {
+  /** Root directory of the workspace. */
+  workspaceRoot: string;
+  /** Upgrade SDK packages. */
+  upgradePackages?: boolean;
+  /** Upgrade configuration. */
+  upgradeConfig?: boolean;
+  /** Preview changes without applying. */
+  dryRun?: boolean;
+  /** Use @latest tag instead of caret range. */
+  useLatest?: boolean;
+}
+/**
+ * Result of a package upgrade check.
+ */
+interface PackageUpgradeInfo {
+  /** Package name. */
+  name: string;
+  /** Current version. */
+  currentVersion: string;
+  /** Latest available version (if known). */
+  latestVersion?: string;
+  /** Whether this is a dev dependency. */
+  isDevDependency: boolean;
+}
+/**
+ * Result of a config upgrade check.
+ */
+interface ConfigUpgradeInfo {
+  /** Config key that needs upgrading. */
+  key: string;
+  /** Current value (if any). */
+  currentValue?: unknown;
+  /** Suggested new value. */
+  suggestedValue: unknown;
+  /** Whether this is a new key. */
+  isNew: boolean;
+}
+/**
+ * Result of the upgrade analysis.
+ */
+interface UpgradeAnalysisResult {
+  /** Detected package manager. */
+  packageManager: string;
+  /** Packages that can be upgraded. */
+  packages: PackageUpgradeInfo[];
+  /** Config sections that need upgrading. */
+  configUpgrades: ConfigUpgradeInfo[];
+  /** Whether any upgrades are available. */
+  hasUpgrades: boolean;
+}
+/**
+ * Result of applying an upgrade.
+ */
+interface UpgradeApplyResult {
+  /** Whether the upgrade was successful. */
+  success: boolean;
+  /** Number of packages upgraded. */
+  packagesUpgraded: number;
+  /** Number of config sections upgraded. */
+  configSectionsUpgraded: number;
+  /** Error message if failed. */
+  error?: string;
+  /** Summary message. */
+  summary: string;
+}
+//#endregion
+export { ConfigUpgradeInfo, PackageUpgradeInfo, UpgradeAnalysisResult, UpgradeApplyResult, UpgradeOptions };
+//# sourceMappingURL=types.d.mts.map

package/dist/services/upgrade/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/services/upgrade/types.ts"],"sourcesContent":[],"mappings":";;AAaA;AAgBA;AAcA;AAcA;AAcA;;;UA1DiB,cAAA;;;;;;;;;;;;;;;UAgBA,kBAAA;;;;;;;;;;;;;UAcA,iBAAA;;;;;;;;;;;;;UAcA,qBAAA;;;;YAIL;;kBAEM;;;;;;;UAQD,kBAAA"}

package/dist/services/upgrade/upgrade-service.d.mts

@@ -0,0 +1,38 @@
+import { FsAdapter } from "../../ports/fs.mjs";
+import { LoggerAdapter } from "../../ports/logger.mjs";
+import { PackageUpgradeInfo, UpgradeAnalysisResult, UpgradeApplyResult, UpgradeOptions } from "./types.mjs";
+
+//#region src/services/upgrade/upgrade-service.d.ts
+
+interface ServiceAdapters {
+  fs: FsAdapter;
+  logger: LoggerAdapter;
+}
+/**
+ * Analyze what upgrades are available.
+ */
+declare function analyzeUpgrades(adapters: ServiceAdapters, options: UpgradeOptions): Promise<UpgradeAnalysisResult>;
+/**
+ * Apply configuration upgrades.
+ *
+ * Note: Package upgrades must be applied by the app layer (CLI, VSCode)
+ * since they require running npm/bun/yarn commands which is platform-specific.
+ */
+declare function applyConfigUpgrades(adapters: ServiceAdapters, options: UpgradeOptions): Promise<UpgradeApplyResult>;
+/**
+ * Get the command to upgrade packages.
+ *
+ * Returns the shell command string that the app layer should execute.
+ */
+declare function getPackageUpgradeCommand(packageManager: string, packages: PackageUpgradeInfo[], useLatest: boolean): string;
+/**
+ * Get default versioning configuration.
+ */
+declare function getDefaultVersioningConfig(): Record<string, unknown>;
+/**
+ * Get default hooks configuration.
+ */
+declare function getDefaultHooksConfig(): Record<string, string[]>;
+//#endregion
+export { analyzeUpgrades, applyConfigUpgrades, getDefaultHooksConfig, getDefaultVersioningConfig, getPackageUpgradeCommand };
+//# sourceMappingURL=upgrade-service.d.mts.map

package/dist/services/upgrade/upgrade-service.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-service.d.mts","names":[],"sources":["../../../src/services/upgrade/upgrade-service.ts"],"sourcesContent":[],"mappings":";;;;;;UAmCU,eAAA,CAeA;EAoJY,EAAA,EAlKhB,SAkKgB;EACV,MAAA,EAlKF,aAkKE;;;;;AA4FI,iBApPM,eAAA,CAoPkB,QAE5B,EArPA,eAqPkB,EAAA,OAAA,EApPnB,cAoPmB,CAAA,EAnP3B,OAmP2B,CAnPnB,qBAmPmB,CAAA;AA0B9B;AAeA;;;;;iBAxIsB,mBAAA,WACV,0BACD,iBACR,QAAQ;;;;;;iBA0FK,wBAAA,mCAEJ;;;;iBA0BI,0BAAA,CAAA,GAA8B;;;;iBAe9B,qBAAA,CAAA,GAAyB"}

package/dist/services/upgrade/upgrade-service.mjs

@@ -0,0 +1,201 @@
+import { detectPackageManager, findWorkspaceRoot } from "../../adapters/workspace.mjs";
+
+//#region src/services/upgrade/upgrade-service.ts
+const LATEST_SCHEMA_URL = `https://${process.env["CONTRACTSPEC_API_HOST"] ?? "api.contractspec.io"}/schemas/contractsrc.json`;
+/**
+* Analyze what upgrades are available.
+*/
+async function analyzeUpgrades(adapters, options) {
+	const { fs, logger } = adapters;
+	const workspaceRoot = findWorkspaceRoot(options.workspaceRoot);
+	const packageManager = detectPackageManager(workspaceRoot);
+	logger.info("Analyzing available upgrades...", {
+		workspaceRoot,
+		packageManager
+	});
+	const packages = await analyzePackages(fs, workspaceRoot);
+	const configUpgrades = await analyzeConfig(fs, workspaceRoot);
+	return {
+		packageManager,
+		packages,
+		configUpgrades,
+		hasUpgrades: packages.length > 0 || configUpgrades.length > 0
+	};
+}
+/**
+* Analyze installed packages for potential updates.
+* Checks for all packages in the workspace that match ContractSpec patterns.
+*/
+async function analyzePackages(fs, workspaceRoot) {
+	const packageJsonPath = fs.join(workspaceRoot, "package.json");
+	if (!await fs.exists(packageJsonPath)) return [];
+	try {
+		const content = await fs.readFile(packageJsonPath);
+		const packageJson = JSON.parse(content);
+		const deps = packageJson.dependencies ?? {};
+		const devDeps = packageJson.devDependencies ?? {};
+		const packages = [];
+		const allDeps = {
+			...deps,
+			...devDeps
+		};
+		for (const [name, version] of Object.entries(allDeps)) if (name.startsWith("@contractspec/") || name === "contractspec" || name.startsWith("@lssm/")) packages.push({
+			name,
+			currentVersion: version,
+			isDevDependency: !!devDeps[name]
+		});
+		return packages;
+	} catch {
+		return [];
+	}
+}
+/**
+* Analyze configuration for upgrade opportunities.
+*/
+async function analyzeConfig(fs, workspaceRoot) {
+	const configPath = fs.join(workspaceRoot, ".contractsrc.json");
+	if (!await fs.exists(configPath)) return [];
+	try {
+		const content = await fs.readFile(configPath);
+		const config = JSON.parse(content);
+		const upgrades = [];
+		const currentSchema = config["$schema"];
+		if (!currentSchema || currentSchema !== LATEST_SCHEMA_URL) upgrades.push({
+			key: "$schema",
+			currentValue: currentSchema,
+			suggestedValue: LATEST_SCHEMA_URL,
+			isNew: !currentSchema
+		});
+		if (!config["versioning"]) upgrades.push({
+			key: "versioning",
+			currentValue: void 0,
+			suggestedValue: getDefaultVersioningConfig(),
+			isNew: true
+		});
+		else if (config["versioning"]["integrateWithChangesets"] === void 0) upgrades.push({
+			key: "versioning.integrateWithChangesets",
+			currentValue: void 0,
+			suggestedValue: false,
+			isNew: true
+		});
+		if (!config["hooks"]) upgrades.push({
+			key: "hooks",
+			currentValue: void 0,
+			suggestedValue: getDefaultHooksConfig(),
+			isNew: true
+		});
+		return upgrades;
+	} catch {
+		return [];
+	}
+}
+/**
+* Apply configuration upgrades.
+*
+* Note: Package upgrades must be applied by the app layer (CLI, VSCode)
+* since they require running npm/bun/yarn commands which is platform-specific.
+*/
+async function applyConfigUpgrades(adapters, options) {
+	const { fs, logger } = adapters;
+	const workspaceRoot = findWorkspaceRoot(options.workspaceRoot);
+	if (options.dryRun) logger.info("Dry run - no changes will be made");
+	const configPath = fs.join(workspaceRoot, ".contractsrc.json");
+	if (!await fs.exists(configPath)) return {
+		success: false,
+		packagesUpgraded: 0,
+		configSectionsUpgraded: 0,
+		error: "No .contractsrc.json found",
+		summary: "No configuration file to upgrade"
+	};
+	try {
+		const content = await fs.readFile(configPath);
+		const config = JSON.parse(content);
+		let sectionsUpgraded = 0;
+		const currentSchema = config["$schema"];
+		if (!currentSchema || currentSchema !== LATEST_SCHEMA_URL) {
+			config["$schema"] = LATEST_SCHEMA_URL;
+			sectionsUpgraded++;
+		}
+		if (!config["versioning"]) {
+			config["versioning"] = getDefaultVersioningConfig();
+			sectionsUpgraded++;
+		} else {
+			const versioning = config["versioning"];
+			if (versioning["integrateWithChangesets"] === void 0) {
+				versioning["integrateWithChangesets"] = false;
+				sectionsUpgraded++;
+			}
+		}
+		if (!config["hooks"]) {
+			config["hooks"] = getDefaultHooksConfig();
+			sectionsUpgraded++;
+		}
+		if (sectionsUpgraded === 0) return {
+			success: true,
+			packagesUpgraded: 0,
+			configSectionsUpgraded: 0,
+			summary: "Configuration is already up to date"
+		};
+		if (!options.dryRun) {
+			await fs.writeFile(configPath, JSON.stringify(config, null, 2) + "\n");
+			logger.info("Configuration upgraded", { sectionsUpgraded });
+		}
+		return {
+			success: true,
+			packagesUpgraded: 0,
+			configSectionsUpgraded: sectionsUpgraded,
+			summary: options.dryRun ? `Would upgrade ${sectionsUpgraded} config section(s)` : `Upgraded ${sectionsUpgraded} config section(s)`
+		};
+	} catch (error) {
+		const msg = error instanceof Error ? error.message : String(error);
+		return {
+			success: false,
+			packagesUpgraded: 0,
+			configSectionsUpgraded: 0,
+			error: msg,
+			summary: `Failed to upgrade config: ${msg}`
+		};
+	}
+}
+/**
+* Get the command to upgrade packages.
+*
+* Returns the shell command string that the app layer should execute.
+*/
+function getPackageUpgradeCommand(packageManager, packages, useLatest) {
+	const pkgList = useLatest ? packages.map((p) => `${p.name}@latest`).join(" ") : packages.map((p) => p.name).join(" ");
+	switch (packageManager) {
+		case "bun": return `bun add ${pkgList}`;
+		case "pnpm": return `pnpm add ${pkgList}`;
+		case "yarn": return `yarn add ${pkgList}`;
+		default: return `npm install ${pkgList}`;
+	}
+}
+/**
+* Get default versioning configuration.
+*/
+function getDefaultVersioningConfig() {
+	return {
+		autoBump: false,
+		bumpStrategy: "impact",
+		changelogTiers: [
+			"spec",
+			"library",
+			"monorepo"
+		],
+		format: "keep-a-changelog",
+		commitChanges: false,
+		createTags: false,
+		integrateWithChangesets: true
+	};
+}
+/**
+* Get default hooks configuration.
+*/
+function getDefaultHooksConfig() {
+	return { "pre-commit": ["contractspec validate", "contractspec integrity check"] };
+}
+
+//#endregion
+export { analyzeUpgrades, applyConfigUpgrades, getDefaultHooksConfig, getDefaultVersioningConfig, getPackageUpgradeCommand };
+//# sourceMappingURL=upgrade-service.mjs.map

package/dist/services/upgrade/upgrade-service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-service.mjs","names":[],"sources":["../../../src/services/upgrade/upgrade-service.ts"],"sourcesContent":["/**\n * Upgrade service.\n *\n * Analyzes and applies upgrades to ContractSpec SDK packages and configuration.\n * This service is platform-agnostic and can be used by CLI, VSCode, or other apps.\n *\n * @module services/upgrade\n */\n\nimport type { FsAdapter } from '../../ports/fs';\nimport type { LoggerAdapter } from '../../ports/logger';\nimport {\n  detectPackageManager,\n  findWorkspaceRoot,\n} from '../../adapters/workspace';\nimport type {\n  UpgradeOptions,\n  UpgradeAnalysisResult,\n  UpgradeApplyResult,\n  PackageUpgradeInfo,\n  ConfigUpgradeInfo,\n} from './types';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Constants\n// ─────────────────────────────────────────────────────────────────────────────\n\n/** Latest schema URL. */\nconst API_HOST = process.env['CONTRACTSPEC_API_HOST'] ?? 'api.contractspec.io';\nconst LATEST_SCHEMA_URL = `https://${API_HOST}/schemas/contractsrc.json`;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Adapters Type\n// ─────────────────────────────────────────────────────────────────────────────\n\ninterface ServiceAdapters {\n  fs: FsAdapter;\n  logger: LoggerAdapter;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Analysis\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Analyze what upgrades are available.\n */\nexport async function analyzeUpgrades(\n  adapters: ServiceAdapters,\n  options: UpgradeOptions\n): Promise<UpgradeAnalysisResult> {\n  const { fs, logger } = adapters;\n  const workspaceRoot = findWorkspaceRoot(options.workspaceRoot);\n  const packageManager = detectPackageManager(workspaceRoot);\n\n  logger.info('Analyzing available upgrades...', {\n    workspaceRoot,\n    packageManager,\n  });\n\n  const packages = await analyzePackages(fs, workspaceRoot);\n  const configUpgrades = await analyzeConfig(fs, workspaceRoot);\n\n  const hasUpgrades = packages.length > 0 || configUpgrades.length > 0;\n\n  return {\n    packageManager,\n    packages,\n    configUpgrades,\n    hasUpgrades,\n  };\n}\n\n/**\n * Analyze installed packages for potential updates.\n * Checks for all packages in the workspace that match ContractSpec patterns.\n */\nasync function analyzePackages(\n  fs: FsAdapter,\n  workspaceRoot: string\n): Promise<PackageUpgradeInfo[]> {\n  const packageJsonPath = fs.join(workspaceRoot, 'package.json');\n\n  if (!(await fs.exists(packageJsonPath))) {\n    return [];\n  }\n\n  try {\n    const content = await fs.readFile(packageJsonPath);\n    const packageJson = JSON.parse(content) as {\n      dependencies?: Record<string, string>;\n      devDependencies?: Record<string, string>;\n    };\n\n    const deps = packageJson.dependencies ?? {};\n    const devDeps = packageJson.devDependencies ?? {};\n\n    const packages: PackageUpgradeInfo[] = [];\n    const allDeps = { ...deps, ...devDeps };\n\n    for (const [name, version] of Object.entries(allDeps)) {\n      // Check for ContractSpec related packages\n      // Matches @contractspec/*, contractspec, @lssm/* (if internal)\n      if (\n        name.startsWith('@contractspec/') ||\n        name === 'contractspec' ||\n        name.startsWith('@lssm/')\n      ) {\n        packages.push({\n          name,\n          currentVersion: version,\n          isDevDependency: !!devDeps[name],\n        });\n      }\n    }\n\n    return packages;\n  } catch {\n    return [];\n  }\n}\n\n/**\n * Analyze configuration for upgrade opportunities.\n */\nasync function analyzeConfig(\n  fs: FsAdapter,\n  workspaceRoot: string\n): Promise<ConfigUpgradeInfo[]> {\n  const configPath = fs.join(workspaceRoot, '.contractsrc.json');\n\n  if (!(await fs.exists(configPath))) {\n    return [];\n  }\n\n  try {\n    const content = await fs.readFile(configPath);\n    const config = JSON.parse(content) as Record<string, unknown>;\n\n    const upgrades: ConfigUpgradeInfo[] = [];\n\n    // Check $schema\n    const currentSchema = config['$schema'] as string | undefined;\n    if (!currentSchema || currentSchema !== LATEST_SCHEMA_URL) {\n      upgrades.push({\n        key: '$schema',\n        currentValue: currentSchema,\n        suggestedValue: LATEST_SCHEMA_URL,\n        isNew: !currentSchema,\n      });\n    }\n\n    // Check versioning\n    if (!config['versioning']) {\n      upgrades.push({\n        key: 'versioning',\n        currentValue: undefined,\n        suggestedValue: getDefaultVersioningConfig(),\n        isNew: true,\n      });\n    } else {\n      const versioning = config['versioning'] as Record<string, unknown>;\n      if (versioning['integrateWithChangesets'] === undefined) {\n        upgrades.push({\n          key: 'versioning.integrateWithChangesets',\n          currentValue: undefined,\n          suggestedValue: false,\n          isNew: true,\n        });\n      }\n    }\n\n    // Check hooks\n    if (!config['hooks']) {\n      upgrades.push({\n        key: 'hooks',\n        currentValue: undefined,\n        suggestedValue: getDefaultHooksConfig(),\n        isNew: true,\n      });\n    }\n\n    return upgrades;\n  } catch {\n    return [];\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Apply Upgrades\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Apply configuration upgrades.\n *\n * Note: Package upgrades must be applied by the app layer (CLI, VSCode)\n * since they require running npm/bun/yarn commands which is platform-specific.\n */\nexport async function applyConfigUpgrades(\n  adapters: ServiceAdapters,\n  options: UpgradeOptions\n): Promise<UpgradeApplyResult> {\n  const { fs, logger } = adapters;\n  const workspaceRoot = findWorkspaceRoot(options.workspaceRoot);\n\n  if (options.dryRun) {\n    logger.info('Dry run - no changes will be made');\n  }\n\n  const configPath = fs.join(workspaceRoot, '.contractsrc.json');\n\n  if (!(await fs.exists(configPath))) {\n    return {\n      success: false,\n      packagesUpgraded: 0,\n      configSectionsUpgraded: 0,\n      error: 'No .contractsrc.json found',\n      summary: 'No configuration file to upgrade',\n    };\n  }\n\n  try {\n    const content = await fs.readFile(configPath);\n    const config = JSON.parse(content) as Record<string, unknown>;\n\n    let sectionsUpgraded = 0;\n\n    // Update $schema\n    const currentSchema = config['$schema'] as string | undefined;\n    if (!currentSchema || currentSchema !== LATEST_SCHEMA_URL) {\n      config['$schema'] = LATEST_SCHEMA_URL;\n      sectionsUpgraded++;\n    }\n\n    // Add versioning if missing\n    if (!config['versioning']) {\n      config['versioning'] = getDefaultVersioningConfig();\n      sectionsUpgraded++;\n    } else {\n      const versioning = config['versioning'] as Record<string, unknown>;\n      if (versioning['integrateWithChangesets'] === undefined) {\n        versioning['integrateWithChangesets'] = false;\n        sectionsUpgraded++;\n      }\n    }\n\n    // Add hooks if missing\n    if (!config['hooks']) {\n      config['hooks'] = getDefaultHooksConfig();\n      sectionsUpgraded++;\n    }\n\n    if (sectionsUpgraded === 0) {\n      return {\n        success: true,\n        packagesUpgraded: 0,\n        configSectionsUpgraded: 0,\n        summary: 'Configuration is already up to date',\n      };\n    }\n\n    if (!options.dryRun) {\n      await fs.writeFile(configPath, JSON.stringify(config, null, 2) + '\\n');\n      logger.info('Configuration upgraded', { sectionsUpgraded });\n    }\n\n    return {\n      success: true,\n      packagesUpgraded: 0,\n      configSectionsUpgraded: sectionsUpgraded,\n      summary: options.dryRun\n        ? `Would upgrade ${sectionsUpgraded} config section(s)`\n        : `Upgraded ${sectionsUpgraded} config section(s)`,\n    };\n  } catch (error) {\n    const msg = error instanceof Error ? error.message : String(error);\n    return {\n      success: false,\n      packagesUpgraded: 0,\n      configSectionsUpgraded: 0,\n      error: msg,\n      summary: `Failed to upgrade config: ${msg}`,\n    };\n  }\n}\n\n/**\n * Get the command to upgrade packages.\n *\n * Returns the shell command string that the app layer should execute.\n */\nexport function getPackageUpgradeCommand(\n  packageManager: string,\n  packages: PackageUpgradeInfo[],\n  useLatest: boolean\n): string {\n  const pkgList = useLatest\n    ? packages.map((p) => `${p.name}@latest`).join(' ')\n    : packages.map((p) => p.name).join(' ');\n\n  switch (packageManager) {\n    case 'bun':\n      return `bun add ${pkgList}`;\n    case 'pnpm':\n      return `pnpm add ${pkgList}`;\n    case 'yarn':\n      return `yarn add ${pkgList}`;\n    default:\n      return `npm install ${pkgList}`;\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Default Configs\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Get default versioning configuration.\n */\nexport function getDefaultVersioningConfig(): Record<string, unknown> {\n  return {\n    autoBump: false,\n    bumpStrategy: 'impact',\n    changelogTiers: ['spec', 'library', 'monorepo'],\n    format: 'keep-a-changelog',\n    commitChanges: false,\n    createTags: false,\n    integrateWithChangesets: true,\n  };\n}\n\n/**\n * Get default hooks configuration.\n */\nexport function getDefaultHooksConfig(): Record<string, string[]> {\n  return {\n    'pre-commit': ['contractspec validate', 'contractspec integrity check'],\n  };\n}\n"],"mappings":"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"}

package/dist/services/validate/blueprint-validator.d.mts

@@ -0,0 +1,23 @@
+import { FsAdapter } from "../../ports/fs.mjs";
+import { AppBlueprintSpec, validateBlueprint } from "@contractspec/lib.contracts";
+
+//#region src/services/validate/blueprint-validator.d.ts
+
+/**
+ * Result of blueprint validation.
+ */
+interface BlueprintValidationResult {
+  spec?: AppBlueprintSpec;
+  report?: ReturnType<typeof validateBlueprint>;
+  valid: boolean;
+  errors: string[];
+}
+/**
+ * Validate a blueprint spec file.
+ */
+declare function validateBlueprint$1(blueprintPath: string, adapters: {
+  fs: FsAdapter;
+}): Promise<BlueprintValidationResult>;
+//#endregion
+export { BlueprintValidationResult, validateBlueprint$1 as validateBlueprint };
+//# sourceMappingURL=blueprint-validator.d.mts.map

package/dist/services/validate/blueprint-validator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint-validator.d.mts","names":[],"sources":["../../../src/services/validate/blueprint-validator.ts"],"sourcesContent":[],"mappings":";;;;;;;AAWA;AACS,UADQ,yBAAA,CACR;EACoB,IAAA,CAAA,EADpB,gBACoB;EAAlB,MAAA,CAAA,EAAA,UAAA,CAAA,OAAkB,iBAAlB,CAAA;EAAU,KAAA,EAAA,OAAA;EAQC,MAAA,EAAA,MAAA,EAAA;;;;;iBAAA,mBAAA;MAEJ;IACf,QAAQ"}

package/dist/services/validate/blueprint-validator.mjs

@@ -0,0 +1,50 @@
+import { resolve } from "path";
+import { pathToFileURL } from "url";
+import { validateBlueprint } from "@contractspec/lib.contracts";
+
+//#region src/services/validate/blueprint-validator.ts
+/**
+* Validate a blueprint spec file.
+*/
+async function validateBlueprint$1(blueprintPath, adapters) {
+	const { fs } = adapters;
+	const resolvedPath = resolve(process.cwd(), blueprintPath);
+	if (!await fs.exists(resolvedPath)) return {
+		valid: false,
+		errors: [`Blueprint file not found: ${resolvedPath}`]
+	};
+	try {
+		const spec = extractBlueprintSpec(await loadModule(resolvedPath));
+		const report = validateBlueprint(spec);
+		return {
+			spec,
+			report,
+			valid: report.valid,
+			errors: report.errors.map((e) => `[${e.code}] ${e.path}: ${e.message}`)
+		};
+	} catch (error) {
+		return {
+			valid: false,
+			errors: [error instanceof Error ? error.message : String(error)]
+		};
+	}
+}
+async function loadModule(modulePath) {
+	try {
+		return await import(pathToFileURL(modulePath).href);
+	} catch (error) {
+		throw new Error(`Failed to load module at ${modulePath}: ${error}`);
+	}
+}
+function extractBlueprintSpec(mod) {
+	const candidates = Object.values(mod).filter(isBlueprintSpec);
+	if (candidates.length === 0) throw new Error("Blueprint module does not export an AppBlueprintSpec.");
+	return candidates[0];
+}
+function isBlueprintSpec(value) {
+	return typeof value === "object" && value !== null && "meta" in value && typeof value.meta?.key === "string" && typeof value.meta?.version === "string";
+}
+
+//#endregion
+export { validateBlueprint$1 as validateBlueprint };
+//# sourceMappingURL=blueprint-validator.mjs.map

package/dist/services/validate/blueprint-validator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint-validator.mjs","names":["validateBlueprint","validateBlueprintSpec"],"sources":["../../../src/services/validate/blueprint-validator.ts"],"sourcesContent":["import { resolve } from 'path';\nimport { pathToFileURL } from 'url';\nimport {\n  validateBlueprint as validateBlueprintSpec,\n  type AppBlueprintSpec,\n} from '@contractspec/lib.contracts';\nimport type { FsAdapter } from '../../ports/fs';\n\n/**\n * Result of blueprint validation.\n */\nexport interface BlueprintValidationResult {\n  spec?: AppBlueprintSpec;\n  report?: ReturnType<typeof validateBlueprintSpec>;\n  valid: boolean;\n  errors: string[];\n}\n\n/**\n * Validate a blueprint spec file.\n */\nexport async function validateBlueprint(\n  blueprintPath: string,\n  adapters: { fs: FsAdapter }\n): Promise<BlueprintValidationResult> {\n  const { fs } = adapters;\n  const resolvedPath = resolve(process.cwd(), blueprintPath);\n\n  if (!(await fs.exists(resolvedPath))) {\n    return {\n      valid: false,\n      errors: [`Blueprint file not found: ${resolvedPath}`],\n    };\n  }\n\n  try {\n    const mod = await loadModule(resolvedPath);\n    const spec = extractBlueprintSpec(mod);\n    const report = validateBlueprintSpec(spec);\n\n    return {\n      spec,\n      report,\n      valid: report.valid,\n      errors: report.errors.map((e) => `[${e.code}] ${e.path}: ${e.message}`),\n    };\n  } catch (error) {\n    return {\n      valid: false,\n      errors: [error instanceof Error ? error.message : String(error)],\n    };\n  }\n}\n\nasync function loadModule(\n  modulePath: string\n): Promise<Record<string, unknown>> {\n  try {\n    const url = pathToFileURL(modulePath).href;\n    // Using native import which works with Bun and Node (if configured)\n    const mod = await import(url);\n    return mod;\n  } catch (error) {\n    throw new Error(`Failed to load module at ${modulePath}: ${error}`);\n  }\n}\n\nfunction extractBlueprintSpec(mod: Record<string, unknown>): AppBlueprintSpec {\n  const candidates = Object.values(mod).filter(isBlueprintSpec);\n  if (candidates.length === 0) {\n    throw new Error('Blueprint module does not export an AppBlueprintSpec.');\n  }\n  return candidates[0] as AppBlueprintSpec;\n}\n\nfunction isBlueprintSpec(value: unknown): value is AppBlueprintSpec {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'meta' in value &&\n    typeof (value as AppBlueprintSpec).meta?.key === 'string' &&\n    typeof (value as AppBlueprintSpec).meta?.version === 'string'\n  );\n}\n"],"mappings":";;;;;;;;AAqBA,eAAsBA,oBACpB,eACA,UACoC;CACpC,MAAM,EAAE,OAAO;CACf,MAAM,eAAe,QAAQ,QAAQ,KAAK,EAAE,cAAc;AAE1D,KAAI,CAAE,MAAM,GAAG,OAAO,aAAa,CACjC,QAAO;EACL,OAAO;EACP,QAAQ,CAAC,6BAA6B,eAAe;EACtD;AAGH,KAAI;EAEF,MAAM,OAAO,qBADD,MAAM,WAAW,aAAa,CACJ;EACtC,MAAM,SAASC,kBAAsB,KAAK;AAE1C,SAAO;GACL;GACA;GACA,OAAO,OAAO;GACd,QAAQ,OAAO,OAAO,KAAK,MAAM,IAAI,EAAE,KAAK,IAAI,EAAE,KAAK,IAAI,EAAE,UAAU;GACxE;UACM,OAAO;AACd,SAAO;GACL,OAAO;GACP,QAAQ,CAAC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC;GACjE;;;AAIL,eAAe,WACb,YACkC;AAClC,KAAI;AAIF,SADY,MAAM,OAFN,cAAc,WAAW,CAAC;UAI/B,OAAO;AACd,QAAM,IAAI,MAAM,4BAA4B,WAAW,IAAI,QAAQ;;;AAIvE,SAAS,qBAAqB,KAAgD;CAC5E,MAAM,aAAa,OAAO,OAAO,IAAI,CAAC,OAAO,gBAAgB;AAC7D,KAAI,WAAW,WAAW,EACxB,OAAM,IAAI,MAAM,wDAAwD;AAE1E,QAAO,WAAW;;AAGpB,SAAS,gBAAgB,OAA2C;AAClE,QACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,OAAQ,MAA2B,MAAM,QAAQ,YACjD,OAAQ,MAA2B,MAAM,YAAY"}

package/dist/services/validate/implementation-agent-validator.d.mts

@@ -0,0 +1,20 @@
+import { FsAdapter } from "../../ports/fs.mjs";
+import { Config } from "../../types/config.mjs";
+
+//#region src/services/validate/implementation-agent-validator.d.ts
+interface ImplementationValidatorOptions {
+  implementationPath?: string;
+}
+interface ImplementationValidationResult {
+  success: boolean;
+  errors: string[];
+  warnings: string[];
+  suggestions: string[];
+  report?: string;
+}
+declare function validateImplementationWithAgent(specFile: string, specCode: string, config: Config, options: ImplementationValidatorOptions, adapters: {
+  fs: FsAdapter;
+}): Promise<ImplementationValidationResult>;
+//#endregion
+export { ImplementationValidationResult, ImplementationValidatorOptions, validateImplementationWithAgent };
+//# sourceMappingURL=implementation-agent-validator.d.mts.map

package/dist/services/validate/implementation-agent-validator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"implementation-agent-validator.d.mts","names":[],"sources":["../../../src/services/validate/implementation-agent-validator.ts"],"sourcesContent":[],"mappings":";;;;UAKiB,8BAAA;;AAAjB;AAIiB,UAAA,8BAAA,CAA8B;EAQzB,OAAA,EAAA,OAAA;EAGZ,MAAA,EAAA,MAAA,EAAA;EACC,QAAA,EAAA,MAAA,EAAA;EACO,WAAA,EAAA,MAAA,EAAA;EACP,MAAA,CAAA,EAAA,MAAA;;AAAD,iBANY,+BAAA,CAMZ,QAAA,EAAA,MAAA,EAAA,QAAA,EAAA,MAAA,EAAA,MAAA,EAHA,MAGA,EAAA,OAAA,EAFC,8BAED,EAAA,QAAA,EAAA;MADQ;IACf,QAAQ"}

package/dist/services/validate/implementation-agent-validator.mjs

@@ -0,0 +1,42 @@
+import { AgentOrchestrator } from "../../ai/agents/orchestrator.mjs";
+import { basename, dirname, join } from "path";
+
+//#region src/services/validate/implementation-agent-validator.ts
+async function validateImplementationWithAgent(specFile, specCode, config, options, adapters) {
+	const { fs } = adapters;
+	let implementationPath = options.implementationPath;
+	if (!implementationPath) {
+		const specDir = dirname(specFile);
+		const specBaseName = basename(specFile, ".ts");
+		const possiblePaths = [
+			join(specDir, specBaseName.replace(".contracts", ".handler") + ".ts"),
+			join(specDir, specBaseName.replace(".presentation", "") + ".tsx"),
+			join(specDir, specBaseName.replace(".form", ".form") + ".tsx"),
+			join(dirname(specDir), "handlers", specBaseName.replace(".contracts", ".handler") + ".ts"),
+			join(dirname(specDir), "components", specBaseName.replace(".presentation", "") + ".tsx")
+		];
+		for (const path$1 of possiblePaths) if (await fs.exists(path$1)) {
+			implementationPath = path$1;
+			break;
+		}
+	}
+	if (!implementationPath || !await fs.exists(implementationPath)) return {
+		success: true,
+		errors: [],
+		warnings: ["Implementation file not found. Specify with --implementation-path"],
+		suggestions: []
+	};
+	const implementationCode = await fs.readFile(implementationPath);
+	const result = await new AgentOrchestrator(config).validate(specCode, implementationCode);
+	return {
+		success: result.success,
+		errors: result.errors || [],
+		warnings: result.warnings || [],
+		suggestions: result.suggestions || [],
+		report: result.code
+	};
+}
+
+//#endregion
+export { validateImplementationWithAgent };
+//# sourceMappingURL=implementation-agent-validator.mjs.map

package/dist/services/validate/implementation-agent-validator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"implementation-agent-validator.mjs","names":["path"],"sources":["../../../src/services/validate/implementation-agent-validator.ts"],"sourcesContent":["import type { FsAdapter } from '../../ports/fs';\nimport { dirname, basename, join } from 'path';\nimport { AgentOrchestrator } from '../../ai/agents/orchestrator';\nimport type { Config } from '../../types/config';\n\nexport interface ImplementationValidatorOptions {\n  implementationPath?: string;\n}\n\nexport interface ImplementationValidationResult {\n  success: boolean;\n  errors: string[];\n  warnings: string[];\n  suggestions: string[];\n  report?: string;\n}\n\nexport async function validateImplementationWithAgent(\n  specFile: string,\n  specCode: string,\n  config: Config,\n  options: ImplementationValidatorOptions,\n  adapters: { fs: FsAdapter }\n): Promise<ImplementationValidationResult> {\n  const { fs } = adapters;\n\n  // Find implementation file\n  let implementationPath = options.implementationPath;\n\n  if (!implementationPath) {\n    // Try to infer from spec file path\n    const specDir = dirname(specFile);\n    const specBaseName = basename(specFile, '.ts');\n\n    // Try common patterns\n    const possiblePaths = [\n      join(specDir, specBaseName.replace('.contracts', '.handler') + '.ts'),\n      join(specDir, specBaseName.replace('.presentation', '') + '.tsx'),\n      join(specDir, specBaseName.replace('.form', '.form') + '.tsx'),\n      join(\n        dirname(specDir),\n        'handlers',\n        specBaseName.replace('.contracts', '.handler') + '.ts'\n      ),\n      join(\n        dirname(specDir),\n        'components',\n        specBaseName.replace('.presentation', '') + '.tsx'\n      ),\n    ];\n\n    for (const path of possiblePaths) {\n      if (await fs.exists(path)) {\n        implementationPath = path;\n        break;\n      }\n    }\n  }\n\n  if (!implementationPath || !(await fs.exists(implementationPath))) {\n    return {\n      success: true, // Not an error if file not found, just nothing to validate\n      errors: [],\n      warnings: [\n        'Implementation file not found. Specify with --implementation-path',\n      ],\n      suggestions: [],\n    };\n  }\n\n  const implementationCode = await fs.readFile(implementationPath);\n\n  // Use agent orchestrator to validate\n  const orchestrator = new AgentOrchestrator(config);\n  const result = await orchestrator.validate(specCode, implementationCode);\n\n  return {\n    success: result.success,\n    errors: result.errors || [],\n    warnings: result.warnings || [],\n    suggestions: result.suggestions || [],\n    report: result.code,\n  };\n}\n"],"mappings":";;;;AAiBA,eAAsB,gCACpB,UACA,UACA,QACA,SACA,UACyC;CACzC,MAAM,EAAE,OAAO;CAGf,IAAI,qBAAqB,QAAQ;AAEjC,KAAI,CAAC,oBAAoB;EAEvB,MAAM,UAAU,QAAQ,SAAS;EACjC,MAAM,eAAe,SAAS,UAAU,MAAM;EAG9C,MAAM,gBAAgB;GACpB,KAAK,SAAS,aAAa,QAAQ,cAAc,WAAW,GAAG,MAAM;GACrE,KAAK,SAAS,aAAa,QAAQ,iBAAiB,GAAG,GAAG,OAAO;GACjE,KAAK,SAAS,aAAa,QAAQ,SAAS,QAAQ,GAAG,OAAO;GAC9D,KACE,QAAQ,QAAQ,EAChB,YACA,aAAa,QAAQ,cAAc,WAAW,GAAG,MAClD;GACD,KACE,QAAQ,QAAQ,EAChB,cACA,aAAa,QAAQ,iBAAiB,GAAG,GAAG,OAC7C;GACF;AAED,OAAK,MAAMA,UAAQ,cACjB,KAAI,MAAM,GAAG,OAAOA,OAAK,EAAE;AACzB,wBAAqBA;AACrB;;;AAKN,KAAI,CAAC,sBAAsB,CAAE,MAAM,GAAG,OAAO,mBAAmB,CAC9D,QAAO;EACL,SAAS;EACT,QAAQ,EAAE;EACV,UAAU,CACR,oEACD;EACD,aAAa,EAAE;EAChB;CAGH,MAAM,qBAAqB,MAAM,GAAG,SAAS,mBAAmB;CAIhE,MAAM,SAAS,MADM,IAAI,kBAAkB,OAAO,CAChB,SAAS,UAAU,mBAAmB;AAExE,QAAO;EACL,SAAS,OAAO;EAChB,QAAQ,OAAO,UAAU,EAAE;EAC3B,UAAU,OAAO,YAAY,EAAE;EAC/B,aAAa,OAAO,eAAe,EAAE;EACrC,QAAQ,OAAO;EAChB"}