@contractspec/module.workspace 0.0.0-canary-20260113162409

package/dist/analysis/snapshot/types.d.ts

@@ -0,0 +1,74 @@
+import { EventRef } from "@contractspec/lib.contracts";
+
+//#region src/analysis/snapshot/types.d.ts
+
+/** Field type in a schema */
+type FieldType = 'string' | 'number' | 'boolean' | 'object' | 'array' | 'enum' | 'union' | 'literal' | 'date' | 'unknown';
+/** Schema field definition */
+interface FieldSnapshot {
+  name: string;
+  type: FieldType;
+  required: boolean;
+  nullable: boolean;
+  description?: string;
+  enumValues?: string[];
+  literalValue?: unknown;
+  items?: FieldSnapshot;
+  properties?: Record<string, FieldSnapshot>;
+  unionTypes?: FieldSnapshot[];
+}
+/** IO schema snapshot */
+interface IoSnapshot {
+  input: Record<string, FieldSnapshot>;
+  output: Record<string, FieldSnapshot>;
+}
+/** HTTP binding snapshot */
+interface HttpBindingSnapshot {
+  method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+  path: string;
+}
+/** Operation snapshot */
+interface OperationSnapshot {
+  type: 'operation';
+  key: string;
+  version: string;
+  kind: 'command' | 'query';
+  stability: string;
+  http?: HttpBindingSnapshot;
+  io: IoSnapshot;
+  authLevel?: string;
+  emittedEvents?: EventRef[];
+}
+/** Event payload snapshot */
+interface EventSnapshot {
+  type: 'event';
+  key: string;
+  version: string;
+  stability: string;
+  payload: Record<string, FieldSnapshot>;
+}
+/** Spec snapshot union type */
+type SpecSnapshot = OperationSnapshot | EventSnapshot;
+/** Full contract snapshot for a workspace */
+interface ContractSnapshot {
+  /** Schema version for forward compatibility */
+  version: '1.0.0';
+  /** Generation timestamp (ISO 8601) */
+  generatedAt: string;
+  /** Git commit SHA if available */
+  commitSha?: string;
+  /** All specs in the workspace */
+  specs: SpecSnapshot[];
+  /** Content hash for quick comparison */
+  hash: string;
+}
+/** Options for snapshot generation */
+interface SnapshotOptions {
+  /** Glob pattern for spec discovery */
+  pattern?: string;
+  /** Include only specific spec types */
+  types?: ('operation' | 'event')[];
+}
+//#endregion
+export { ContractSnapshot, EventSnapshot, FieldSnapshot, FieldType, HttpBindingSnapshot, IoSnapshot, OperationSnapshot, SnapshotOptions, SpecSnapshot };
+//# sourceMappingURL=types.d.ts.map

package/dist/analysis/snapshot/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/analysis/snapshot/types.ts"],"sourcesContent":[],"mappings":";;;;;AAgCe,KAtBH,SAAA,GAsBG,QAAA,GAAA,QAAA,GAAA,SAAA,GAAA,QAAA,GAAA,OAAA,GAAA,MAAA,GAAA,OAAA,GAAA,SAAA,GAAA,MAAA,GAAA,SAAA;;AACa,UAVX,aAAA,CAUW;EAIX,IAAA,EAAA,MAAA;EACO,IAAA,EAbhB,SAagB;EAAf,QAAA,EAAA,OAAA;EACgB,QAAA,EAAA,OAAA;EAAf,WAAA,CAAA,EAAA,MAAA;EAAM,UAAA,CAAA,EAAA,MAAA,EAAA;EAIC,YAAA,CAAA,EAAA,OAAmB;EAMnB,KAAA,CAAA,EAlBP,aAkBwB;EAMzB,UAAA,CAAA,EAvBM,MAuBN,CAAA,MAAA,EAvBqB,aAuBrB,CAAA;EACH,UAAA,CAAA,EAvBS,aAuBT,EAAA;;;AAMW,UAzBA,UAAA,CAyBa;EASlB,KAAA,EAjCH,MAiCG,CAAA,MAAY,EAjCA,aAiCG,CAAA;EAGV,MAAA,EAnCP,MAmCO,CAAA,MAAgB,EAnCR,aA2ChB,CAAA;AAMT;;UA7CiB,mBAAA;;;;;UAMA,iBAAA;;;;;;SAMR;MACH;;kBAEY;;;UAID,aAAA;;;;;WAKN,eAAe;;;KAId,YAAA,GAAe,oBAAoB;;UAG9B,gBAAA;;;;;;;;SAQR;;;;;UAMQ,eAAA"}

package/dist/analysis/spec-parser.d.ts

@@ -0,0 +1,11 @@
+import { ParsedSpec } from "../types/llm-types.js";
+
+//#region src/analysis/spec-parser.d.ts
+
+/**
+ * Load and parse specs from a source file.
+ */
+declare function loadSpecFromSource(filePath: string): Promise<ParsedSpec[]>;
+//#endregion
+export { loadSpecFromSource };
+//# sourceMappingURL=spec-parser.d.ts.map

package/dist/analysis/spec-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-parser.d.ts","names":[],"sources":["../../src/analysis/spec-parser.ts"],"sourcesContent":[],"mappings":";;;;;;;iBAoBsB,kBAAA,oBAEnB,QAAQ"}

package/dist/analysis/spec-parser.js

@@ -0,0 +1,89 @@
+import { scanAllSpecsFromSource } from "./spec-scan.js";
+import { isFeatureFile, scanFeatureSource } from "./feature-scan.js";
+import { readFile } from "node:fs/promises";
+
+//#region src/analysis/spec-parser.ts
+/**
+* Spec Parser
+*
+* Coordinates scanning of source files and mapping to ParsedSpec format
+* for LLM consumption.
+*/
+/**
+* Load and parse specs from a source file.
+*/
+async function loadSpecFromSource(filePath) {
+	try {
+		const code = await readFile(filePath, "utf-8");
+		if (isFeatureFile(filePath)) return [mapFeatureResultToParsedSpec(scanFeatureSource(code, filePath))];
+		return scanAllSpecsFromSource(code, filePath).map(mapSpecResultToParsedSpec);
+	} catch (error) {
+		console.warn(`Failed to parse spec from ${filePath}:`, error);
+		return [];
+	}
+}
+/**
+* Map FeatureScanResult to ParsedSpec.
+*/
+function mapFeatureResultToParsedSpec(result) {
+	return {
+		meta: {
+			key: result.key,
+			version: "1.0.0",
+			description: result.description,
+			stability: result.stability,
+			owners: result.owners,
+			tags: result.tags,
+			goal: result.goal,
+			context: result.context
+		},
+		specType: "feature",
+		filePath: result.filePath,
+		sourceBlock: result.sourceBlock,
+		operations: result.operations.map(mapToSpecRef),
+		events: result.events.map(mapToSpecRef),
+		presentations: result.presentations.map(mapToSpecRef)
+	};
+}
+/**
+* Map SpecScanResult to ParsedSpec.
+*/
+function mapSpecResultToParsedSpec(result) {
+	return {
+		meta: {
+			key: result.key ?? "unknown",
+			version: result.version ?? "1.0.0",
+			description: result.description,
+			stability: result.stability,
+			owners: result.owners,
+			tags: result.tags,
+			goal: result.goal,
+			context: result.context
+		},
+		specType: result.specType,
+		kind: result.kind,
+		hasIo: result.hasIo,
+		hasPolicy: result.hasPolicy,
+		hasPayload: result.hasPayload,
+		hasContent: result.hasContent,
+		hasDefinition: result.hasDefinition,
+		emittedEvents: result.emittedEvents?.map(mapToSpecRef),
+		policyRefs: result.policyRefs?.map(mapToSpecRef),
+		testRefs: result.testRefs?.map(mapToSpecRef),
+		filePath: result.filePath,
+		sourceBlock: result.sourceBlock
+	};
+}
+/**
+* Map RefInfo to SpecRef.
+*/
+function mapToSpecRef(ref) {
+	return {
+		name: ref.key,
+		version: ref.version
+	};
+}
+
+//#endregion
+export { loadSpecFromSource };
+//# sourceMappingURL=spec-parser.js.map

package/dist/analysis/spec-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-parser.js","names":[],"sources":["../../src/analysis/spec-parser.ts"],"sourcesContent":["/**\n * Spec Parser\n *\n * Coordinates scanning of source files and mapping to ParsedSpec format\n * for LLM consumption.\n */\n\nimport { readFile } from 'node:fs/promises';\nimport { isFeatureFile, scanFeatureSource } from './feature-scan';\nimport { scanAllSpecsFromSource } from './spec-scan';\nimport type { ParsedSpec, ParsedSpecMeta, SpecRef } from '../types/llm-types';\nimport type {\n  FeatureScanResult,\n  RefInfo,\n  SpecScanResult,\n} from '../types/analysis-types';\n\n/**\n * Load and parse specs from a source file.\n */\nexport async function loadSpecFromSource(\n  filePath: string\n): Promise<ParsedSpec[]> {\n  try {\n    const code = await readFile(filePath, 'utf-8');\n\n    if (isFeatureFile(filePath)) {\n      const featureResult = scanFeatureSource(code, filePath);\n      return [mapFeatureResultToParsedSpec(featureResult)];\n    }\n\n    const specResults = scanAllSpecsFromSource(code, filePath);\n    return specResults.map(mapSpecResultToParsedSpec);\n  } catch (error) {\n    // Return empty array if file reading fails\n    console.warn(`Failed to parse spec from ${filePath}:`, error);\n    return [];\n  }\n}\n\n/**\n * Map FeatureScanResult to ParsedSpec.\n */\nfunction mapFeatureResultToParsedSpec(result: FeatureScanResult): ParsedSpec {\n  const meta: ParsedSpecMeta = {\n    key: result.key,\n    version: '1.0.0', // Default for features if not specified\n    description: result.description,\n    stability: result.stability,\n    owners: result.owners,\n    tags: result.tags,\n    goal: result.goal,\n    context: result.context,\n  };\n\n  return {\n    meta,\n    specType: 'feature',\n    filePath: result.filePath,\n    sourceBlock: result.sourceBlock,\n    operations: result.operations.map(mapToSpecRef),\n    events: result.events.map(mapToSpecRef),\n    presentations: result.presentations.map(mapToSpecRef),\n  };\n}\n\n/**\n * Map SpecScanResult to ParsedSpec.\n */\nfunction mapSpecResultToParsedSpec(result: SpecScanResult): ParsedSpec {\n  const meta: ParsedSpecMeta = {\n    key: result.key ?? 'unknown',\n    version: result.version ?? '1.0.0',\n    description: result.description,\n    stability: result.stability,\n    owners: result.owners,\n    tags: result.tags,\n    goal: result.goal,\n    context: result.context,\n  };\n\n  return {\n    meta,\n    specType: result.specType,\n    kind: result.kind,\n    hasIo: result.hasIo,\n    hasPolicy: result.hasPolicy,\n    hasPayload: result.hasPayload,\n    hasContent: result.hasContent,\n    hasDefinition: result.hasDefinition,\n    emittedEvents: result.emittedEvents?.map(mapToSpecRef),\n    policyRefs: result.policyRefs?.map(mapToSpecRef),\n    testRefs: result.testRefs?.map(mapToSpecRef),\n    filePath: result.filePath,\n    sourceBlock: result.sourceBlock,\n  };\n}\n\n/**\n * Map RefInfo to SpecRef.\n */\nfunction mapToSpecRef(ref: RefInfo): SpecRef {\n  return {\n    name: ref.key,\n    version: ref.version,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAoBA,eAAsB,mBACpB,UACuB;AACvB,KAAI;EACF,MAAM,OAAO,MAAM,SAAS,UAAU,QAAQ;AAE9C,MAAI,cAAc,SAAS,CAEzB,QAAO,CAAC,6BADc,kBAAkB,MAAM,SAAS,CACJ,CAAC;AAItD,SADoB,uBAAuB,MAAM,SAAS,CACvC,IAAI,0BAA0B;UAC1C,OAAO;AAEd,UAAQ,KAAK,6BAA6B,SAAS,IAAI,MAAM;AAC7D,SAAO,EAAE;;;;;;AAOb,SAAS,6BAA6B,QAAuC;AAY3E,QAAO;EACL,MAZ2B;GAC3B,KAAK,OAAO;GACZ,SAAS;GACT,aAAa,OAAO;GACpB,WAAW,OAAO;GAClB,QAAQ,OAAO;GACf,MAAM,OAAO;GACb,MAAM,OAAO;GACb,SAAS,OAAO;GACjB;EAIC,UAAU;EACV,UAAU,OAAO;EACjB,aAAa,OAAO;EACpB,YAAY,OAAO,WAAW,IAAI,aAAa;EAC/C,QAAQ,OAAO,OAAO,IAAI,aAAa;EACvC,eAAe,OAAO,cAAc,IAAI,aAAa;EACtD;;;;;AAMH,SAAS,0BAA0B,QAAoC;AAYrE,QAAO;EACL,MAZ2B;GAC3B,KAAK,OAAO,OAAO;GACnB,SAAS,OAAO,WAAW;GAC3B,aAAa,OAAO;GACpB,WAAW,OAAO;GAClB,QAAQ,OAAO;GACf,MAAM,OAAO;GACb,MAAM,OAAO;GACb,SAAS,OAAO;GACjB;EAIC,UAAU,OAAO;EACjB,MAAM,OAAO;EACb,OAAO,OAAO;EACd,WAAW,OAAO;EAClB,YAAY,OAAO;EACnB,YAAY,OAAO;EACnB,eAAe,OAAO;EACtB,eAAe,OAAO,eAAe,IAAI,aAAa;EACtD,YAAY,OAAO,YAAY,IAAI,aAAa;EAChD,UAAU,OAAO,UAAU,IAAI,aAAa;EAC5C,UAAU,OAAO;EACjB,aAAa,OAAO;EACrB;;;;;AAMH,SAAS,aAAa,KAAuB;AAC3C,QAAO;EACL,MAAM,IAAI;EACV,SAAS,IAAI;EACd"}

package/dist/analysis/spec-parsing-utils.d.ts

@@ -0,0 +1,26 @@
+//#region src/analysis/spec-parsing-utils.d.ts
+
+/**
+ * Extract test target from a TestSpec source.
+ * Parses the `target: { type: 'operation', key, version }` field OR
+ * the nested format `target: { type: 'operation', operation: { key, version } }`.
+ */
+declare function extractTestTarget(code: string): {
+  type: 'operation' | 'workflow';
+  key: string;
+  version: string | undefined;
+} | undefined;
+/**
+ * Extract test coverage info from a TestSpec source.
+ * Checks for presence of success (expectOutput) and failure (expectError) scenarios.
+ * Supports both formats:
+ * - New: `expectOutput: {}` and `expectError: {}`
+ * - Old: `{ type: 'expectOutput', ... }` and `{ type: 'expectError', ... }`
+ */
+declare function extractTestCoverage(code: string): {
+  hasSuccess: boolean;
+  hasError: boolean;
+};
+//#endregion
+export { extractTestCoverage, extractTestTarget };
+//# sourceMappingURL=spec-parsing-utils.d.ts.map

package/dist/analysis/spec-parsing-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-parsing-utils.d.ts","names":[],"sources":["../../src/analysis/spec-parsing-utils.ts"],"sourcesContent":[],"mappings":";;;;;;;iBA0EgB,iBAAA;;;;;;;;;;;;iBAiEA,mBAAA"}

package/dist/analysis/spec-parsing-utils.js

@@ -0,0 +1,98 @@
+import { escapeRegex, findMatchingDelimiter, matchStringField, matchVersionField } from "./utils/matchers.js";
+
+//#region src/analysis/spec-parsing-utils.ts
+function parsePolicy(code) {
+	const policyBlock = code.match(/policy\s*:\s*\{([\s\S]*?)\}/);
+	if (!policyBlock?.[1]) return [];
+	return extractRefList(policyBlock[1], "policies") ?? [];
+}
+function extractRefList(code, field) {
+	const regex = /* @__PURE__ */ new RegExp(`${escapeRegex(field)}\\s*:\\s*\\[([\\s\\S]*?)\\]`);
+	const match = code.match(regex);
+	if (!match?.[1]) return void 0;
+	const inner = match[1];
+	const items = [];
+	const parts = inner.match(/\{[\s\S]*?\}/g);
+	if (parts) for (const part of parts) {
+		const k = matchStringField(part, "key");
+		const v = matchVersionField(part, "version");
+		if (k) items.push({
+			key: k,
+			version: v ?? "1.0.0"
+		});
+	}
+	return items.length > 0 ? items : void 0;
+}
+function extractTestRefs(code) {
+	const regex = /* @__PURE__ */ new RegExp(`testRefs\\s*:\\s*\\[([\\s\\S]*?)\\]`);
+	const match = code.match(regex);
+	if (!match?.[1]) return void 0;
+	const inner = match[1];
+	const items = [];
+	const parts = inner.match(/\{[\s\S]*?\}/g);
+	if (parts) for (const part of parts) {
+		const k = matchStringField(part, "key");
+		const v = matchVersionField(part, "version");
+		const t = matchStringField(part, "type");
+		if (k) items.push({
+			key: k,
+			version: v ?? "1.0.0",
+			type: t === "error" ? "error" : "success"
+		});
+	}
+	return items.length > 0 ? items : void 0;
+}
+/**
+* Extract test target from a TestSpec source.
+* Parses the `target: { type: 'operation', key, version }` field OR
+* the nested format `target: { type: 'operation', operation: { key, version } }`.
+*/
+function extractTestTarget(code) {
+	const targetStartMatch = code.match(/target\s*:\s*\{/);
+	if (!targetStartMatch || targetStartMatch.index === void 0) return void 0;
+	const openBraceIndex = targetStartMatch.index + targetStartMatch[0].length - 1;
+	const closeBraceIndex = findMatchingDelimiter(code, openBraceIndex, "{", "}");
+	if (closeBraceIndex === -1) return void 0;
+	const targetBlock = code.substring(openBraceIndex + 1, closeBraceIndex);
+	const typeMatch = targetBlock.match(/type\s*:\s*['"](\w+)['"]/);
+	if (!typeMatch?.[1]) return void 0;
+	const type = typeMatch[1];
+	if (type !== "operation" && type !== "workflow") return void 0;
+	const flatKey = matchStringField(targetBlock, "key");
+	if (flatKey) return {
+		type,
+		key: flatKey,
+		version: matchVersionField(targetBlock, "version")
+	};
+	const refBlockMatch = targetBlock.match(/* @__PURE__ */ new RegExp(`${type}\\s*:\\s*\\{([\\s\\S]*?)\\}`));
+	if (!refBlockMatch?.[1]) return void 0;
+	const refBlock = refBlockMatch[1];
+	const key = matchStringField(refBlock, "key");
+	if (!key) return void 0;
+	return {
+		type,
+		key,
+		version: matchVersionField(refBlock, "version")
+	};
+}
+/**
+* Extract test coverage info from a TestSpec source.
+* Checks for presence of success (expectOutput) and failure (expectError) scenarios.
+* Supports both formats:
+* - New: `expectOutput: {}` and `expectError: {}`
+* - Old: `{ type: 'expectOutput', ... }` and `{ type: 'expectError', ... }`
+*/
+function extractTestCoverage(code) {
+	const hasSuccessNew = /expectOutput\s*:/.test(code);
+	const hasErrorNew = /expectError\s*:/.test(code);
+	const hasSuccessOld = /(['"]?)type\1\s*:\s*['"]expectOutput['"]/.test(code);
+	const hasErrorOld = /(['"]?)type\1\s*:\s*['"]expectError['"]/.test(code);
+	return {
+		hasSuccess: hasSuccessNew || hasSuccessOld,
+		hasError: hasErrorNew || hasErrorOld
+	};
+}
+
+//#endregion
+export { extractRefList, extractTestCoverage, extractTestRefs, extractTestTarget, parsePolicy };
+//# sourceMappingURL=spec-parsing-utils.js.map

package/dist/analysis/spec-parsing-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-parsing-utils.js","names":[],"sources":["../../src/analysis/spec-parsing-utils.ts"],"sourcesContent":["import {\n  escapeRegex,\n  matchStringField,\n  matchVersionField,\n  findMatchingDelimiter,\n} from './utils/matchers';\n\nexport function parsePolicy(code: string): { key: string; version: string }[] {\n  const policyBlock = code.match(/policy\\s*:\\s*\\{([\\s\\S]*?)\\}/);\n  if (!policyBlock?.[1]) return [];\n\n  return extractRefList(policyBlock[1], 'policies') ?? [];\n}\n\nexport function extractRefList(\n  code: string,\n  field: string\n): { key: string; version: string }[] | undefined {\n  const regex = new RegExp(`${escapeRegex(field)}\\\\s*:\\\\s*\\\\[([\\\\s\\\\S]*?)\\\\]`);\n  const match = code.match(regex);\n  if (!match?.[1]) return undefined;\n\n  const inner = match[1];\n  const items: { key: string; version: string }[] = [];\n\n  const parts = inner.match(/\\{[\\s\\S]*?\\}/g);\n  if (parts) {\n    for (const part of parts) {\n      const k = matchStringField(part, 'key');\n      const v = matchVersionField(part, 'version');\n      if (k) {\n        items.push({ key: k, version: v ?? '1.0.0' });\n      }\n    }\n  }\n\n  return items.length > 0 ? items : undefined;\n}\n\nexport function extractTestRefs(\n  code: string\n): { key: string; version: string; type: 'success' | 'error' }[] | undefined {\n  const regex = new RegExp(`testRefs\\\\s*:\\\\s*\\\\[([\\\\s\\\\S]*?)\\\\]`);\n  const match = code.match(regex);\n  if (!match?.[1]) return undefined;\n\n  const inner = match[1];\n  const items: { key: string; version: string; type: 'success' | 'error' }[] =\n    [];\n\n  const parts = inner.match(/\\{[\\s\\S]*?\\}/g);\n  if (parts) {\n    for (const part of parts) {\n      const k = matchStringField(part, 'key');\n      const v = matchVersionField(part, 'version');\n      const t = matchStringField(part, 'type');\n      if (k) {\n        items.push({\n          key: k,\n          version: v ?? '1.0.0',\n          type: t === 'error' ? 'error' : 'success',\n        });\n      }\n    }\n  }\n\n  return items.length > 0 ? items : undefined;\n}\n\n/**\n * Extract test target from a TestSpec source.\n * Parses the `target: { type: 'operation', key, version }` field OR\n * the nested format `target: { type: 'operation', operation: { key, version } }`.\n */\nexport function extractTestTarget(\n  code: string\n):\n  | { type: 'operation' | 'workflow'; key: string; version: string | undefined }\n  | undefined {\n  // Find target block start\n  const targetStartMatch = code.match(/target\\s*:\\s*\\{/);\n  if (!targetStartMatch || targetStartMatch.index === undefined)\n    return undefined;\n\n  const openBraceIndex =\n    targetStartMatch.index + targetStartMatch[0].length - 1;\n  const closeBraceIndex = findMatchingDelimiter(code, openBraceIndex, '{', '}');\n\n  if (closeBraceIndex === -1) return undefined;\n\n  const targetBlock = code.substring(openBraceIndex + 1, closeBraceIndex);\n\n  // Extract the type\n  const typeMatch = targetBlock.match(/type\\s*:\\s*['\"](\\w+)['\"]/);\n  if (!typeMatch?.[1]) return undefined;\n\n  const type = typeMatch[1];\n  if (type !== 'operation' && type !== 'workflow') return undefined;\n\n  // Try flat format first: { type: 'operation', key: '...', version: '...' }\n  const flatKey = matchStringField(targetBlock, 'key');\n  if (flatKey) {\n    const flatVersion = matchVersionField(targetBlock, 'version');\n    return {\n      type,\n      key: flatKey,\n      version: flatVersion,\n    };\n  }\n\n  // Try nested format: { type: 'operation', operation: { key: '...', version: '...' } }\n  const refBlockMatch = targetBlock.match(\n    new RegExp(`${type}\\\\s*:\\\\s*\\\\{([\\\\s\\\\S]*?)\\\\}`)\n  );\n\n  if (!refBlockMatch?.[1]) return undefined;\n\n  const refBlock = refBlockMatch[1];\n\n  // Extract key and version from the ref block\n  const key = matchStringField(refBlock, 'key');\n  if (!key) return undefined;\n\n  const version = matchVersionField(refBlock, 'version');\n\n  return {\n    type,\n    key,\n    version,\n  };\n}\n\n/**\n * Extract test coverage info from a TestSpec source.\n * Checks for presence of success (expectOutput) and failure (expectError) scenarios.\n * Supports both formats:\n * - New: `expectOutput: {}` and `expectError: {}`\n * - Old: `{ type: 'expectOutput', ... }` and `{ type: 'expectError', ... }`\n */\nexport function extractTestCoverage(code: string): {\n  hasSuccess: boolean;\n  hasError: boolean;\n} {\n  // Check new format: expectOutput: or expectError: as keys\n  const hasSuccessNew = /expectOutput\\s*:/.test(code);\n  const hasErrorNew = /expectError\\s*:/.test(code);\n\n  // Check old format: { type: 'expectOutput' } or { type: 'expectError' }\n  const hasSuccessOld = /(['\"]?)type\\1\\s*:\\s*['\"]expectOutput['\"]/.test(code);\n  const hasErrorOld = /(['\"]?)type\\1\\s*:\\s*['\"]expectError['\"]/.test(code);\n\n  return {\n    hasSuccess: hasSuccessNew || hasSuccessOld,\n    hasError: hasErrorNew || hasErrorOld,\n  };\n}\n"],"mappings":";;;AAOA,SAAgB,YAAY,MAAkD;CAC5E,MAAM,cAAc,KAAK,MAAM,8BAA8B;AAC7D,KAAI,CAAC,cAAc,GAAI,QAAO,EAAE;AAEhC,QAAO,eAAe,YAAY,IAAI,WAAW,IAAI,EAAE;;AAGzD,SAAgB,eACd,MACA,OACgD;CAChD,MAAM,wBAAQ,IAAI,OAAO,GAAG,YAAY,MAAM,CAAC,6BAA6B;CAC5E,MAAM,QAAQ,KAAK,MAAM,MAAM;AAC/B,KAAI,CAAC,QAAQ,GAAI,QAAO;CAExB,MAAM,QAAQ,MAAM;CACpB,MAAM,QAA4C,EAAE;CAEpD,MAAM,QAAQ,MAAM,MAAM,gBAAgB;AAC1C,KAAI,MACF,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,IAAI,iBAAiB,MAAM,MAAM;EACvC,MAAM,IAAI,kBAAkB,MAAM,UAAU;AAC5C,MAAI,EACF,OAAM,KAAK;GAAE,KAAK;GAAG,SAAS,KAAK;GAAS,CAAC;;AAKnD,QAAO,MAAM,SAAS,IAAI,QAAQ;;AAGpC,SAAgB,gBACd,MAC2E;CAC3E,MAAM,wBAAQ,IAAI,OAAO,sCAAsC;CAC/D,MAAM,QAAQ,KAAK,MAAM,MAAM;AAC/B,KAAI,CAAC,QAAQ,GAAI,QAAO;CAExB,MAAM,QAAQ,MAAM;CACpB,MAAM,QACJ,EAAE;CAEJ,MAAM,QAAQ,MAAM,MAAM,gBAAgB;AAC1C,KAAI,MACF,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,IAAI,iBAAiB,MAAM,MAAM;EACvC,MAAM,IAAI,kBAAkB,MAAM,UAAU;EAC5C,MAAM,IAAI,iBAAiB,MAAM,OAAO;AACxC,MAAI,EACF,OAAM,KAAK;GACT,KAAK;GACL,SAAS,KAAK;GACd,MAAM,MAAM,UAAU,UAAU;GACjC,CAAC;;AAKR,QAAO,MAAM,SAAS,IAAI,QAAQ;;;;;;;AAQpC,SAAgB,kBACd,MAGY;CAEZ,MAAM,mBAAmB,KAAK,MAAM,kBAAkB;AACtD,KAAI,CAAC,oBAAoB,iBAAiB,UAAU,OAClD,QAAO;CAET,MAAM,iBACJ,iBAAiB,QAAQ,iBAAiB,GAAG,SAAS;CACxD,MAAM,kBAAkB,sBAAsB,MAAM,gBAAgB,KAAK,IAAI;AAE7E,KAAI,oBAAoB,GAAI,QAAO;CAEnC,MAAM,cAAc,KAAK,UAAU,iBAAiB,GAAG,gBAAgB;CAGvE,MAAM,YAAY,YAAY,MAAM,2BAA2B;AAC/D,KAAI,CAAC,YAAY,GAAI,QAAO;CAE5B,MAAM,OAAO,UAAU;AACvB,KAAI,SAAS,eAAe,SAAS,WAAY,QAAO;CAGxD,MAAM,UAAU,iBAAiB,aAAa,MAAM;AACpD,KAAI,QAEF,QAAO;EACL;EACA,KAAK;EACL,SAJkB,kBAAkB,aAAa,UAAU;EAK5D;CAIH,MAAM,gBAAgB,YAAY,sBAChC,IAAI,OAAO,GAAG,KAAK,6BAA6B,CACjD;AAED,KAAI,CAAC,gBAAgB,GAAI,QAAO;CAEhC,MAAM,WAAW,cAAc;CAG/B,MAAM,MAAM,iBAAiB,UAAU,MAAM;AAC7C,KAAI,CAAC,IAAK,QAAO;AAIjB,QAAO;EACL;EACA;EACA,SALc,kBAAkB,UAAU,UAAU;EAMrD;;;;;;;;;AAUH,SAAgB,oBAAoB,MAGlC;CAEA,MAAM,gBAAgB,mBAAmB,KAAK,KAAK;CACnD,MAAM,cAAc,kBAAkB,KAAK,KAAK;CAGhD,MAAM,gBAAgB,2CAA2C,KAAK,KAAK;CAC3E,MAAM,cAAc,0CAA0C,KAAK,KAAK;AAExE,QAAO;EACL,YAAY,iBAAiB;EAC7B,UAAU,eAAe;EAC1B"}

package/dist/analysis/spec-scan.d.ts

@@ -0,0 +1,20 @@
+import { SpecScanResult } from "../types/analysis-types.js";
+import { extractTestCoverage, extractTestTarget } from "./spec-parsing-utils.js";
+
+//#region src/analysis/spec-scan.d.ts
+
+/**
+ * Scan all specs from a single source file.
+ */
+declare function scanAllSpecsFromSource(code: string, filePath: string): SpecScanResult[];
+/**
+ * Scan a single spec source string.
+ */
+declare function scanSpecSource(code: string, filePath: string): SpecScanResult;
+/**
+ * Infer spec type from file path convention.
+ */
+declare function inferSpecTypeFromFilePath(filePath: string): SpecScanResult['specType'] | 'feature' | 'unknown';
+//#endregion
+export { inferSpecTypeFromFilePath, scanAllSpecsFromSource, scanSpecSource };
+//# sourceMappingURL=spec-scan.d.ts.map

package/dist/analysis/spec-scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-scan.d.ts","names":[],"sources":["../../src/analysis/spec-scan.ts"],"sourcesContent":[],"mappings":";;;;;;;;iBAiCgB,sBAAA,kCAGb;;;;iBAsDa,cAAA,kCAAgD;;;;iBAsGhD,yBAAA,oBAEb"}

package/dist/analysis/spec-scan.js

@@ -0,0 +1,141 @@
+import { findMatchingDelimiter, isStability, matchStringArrayField, matchStringField, matchVersionField } from "./utils/matchers.js";
+import { extractArrayConstants, resolveVariablesInBlock } from "./utils/variables.js";
+import { extractRefList, extractTestCoverage, extractTestRefs, extractTestTarget, parsePolicy } from "./spec-parsing-utils.js";
+
+//#region src/analysis/spec-scan.ts
+/**
+* Scan all specs from a single source file.
+*/
+function scanAllSpecsFromSource(code, filePath) {
+	const results = [];
+	const variables = extractArrayConstants(code);
+	const definitionRegex = /export\s+const\s+(\w+)\s*=\s*define(Command|Query|Event|Presentation|Capability|Policy|Type|Example|AppConfig|Integration|Workflow|TestSpec|Feature)\s*\(/g;
+	let match;
+	while ((match = definitionRegex.exec(code)) !== null) {
+		const start = match.index;
+		const end = findMatchingDelimiter(code, start + match[0].length - 1, "(", ")");
+		if (end === -1) continue;
+		let finalEnd = end;
+		if (code[finalEnd + 1] === ";") finalEnd++;
+		const resolvedBlock = resolveVariablesInBlock(code.substring(start, finalEnd + 1), variables);
+		const result = scanSpecSource(resolvedBlock, filePath);
+		if (result) results.push({
+			...result,
+			sourceBlock: resolvedBlock
+		});
+	}
+	if (results.length === 0 && filePath.includes(".spec.")) {
+		if (scanSpecSource(code, filePath).key !== "unknown") {
+			const result = scanSpecSource(resolveVariablesInBlock(code, variables), filePath);
+			results.push(result);
+		}
+	}
+	return results;
+}
+/**
+* Scan a single spec source string.
+*/
+function scanSpecSource(code, filePath) {
+	const key = (code.match(/key\s*:\s*['"]([^'"]+)['"]/) ?? code.match(/export\s+const\s+(\w+)\s*=/))?.[1] ?? "unknown";
+	const version = matchVersionField(code, "version");
+	const description = matchStringField(code, "description") ?? void 0;
+	const goal = matchStringField(code, "goal") ?? void 0;
+	const context = matchStringField(code, "context") ?? void 0;
+	const stabilityRaw = matchStringField(code, "stability");
+	const stability = isStability(stabilityRaw) ? stabilityRaw : void 0;
+	const owners = matchStringArrayField(code, "owners");
+	const tags = matchStringArrayField(code, "tags");
+	let specType = "unknown";
+	let kind;
+	if (code.includes("defineCommand")) {
+		specType = "operation";
+		kind = "command";
+	} else if (code.includes("defineQuery")) {
+		specType = "operation";
+		kind = "query";
+	} else if (code.includes("defineEvent")) {
+		specType = "event";
+		kind = "event";
+	} else if (code.includes("definePresentation")) {
+		specType = "presentation";
+		kind = "presentation";
+	} else if (code.includes("definePolicy")) {
+		specType = "policy";
+		kind = "policy";
+	} else if (code.includes("defineCapability")) {
+		specType = "capability";
+		kind = "capability";
+	} else if (code.includes("defineExample")) {
+		specType = "example";
+		kind = "example";
+	} else if (code.includes("defineAppConfig")) {
+		specType = "app-config";
+		kind = "app-config";
+	} else if (code.includes("defineIntegration")) {
+		specType = "integration";
+		kind = "integration";
+	} else if (code.includes("defineWorkflow")) {
+		specType = "workflow";
+		kind = "workflow";
+	} else if (code.includes("defineTestSpec")) {
+		specType = "test-spec";
+		kind = "test-spec";
+	} else if (code.includes("defineFeature")) {
+		specType = "feature";
+		kind = "feature";
+	}
+	const hasMeta = /meta\s*:\s*\{/.test(code);
+	const hasIo = /io\s*:\s*\{/.test(code);
+	const hasPolicy = /policy\s*:\s*\{/.test(code);
+	const hasPayload = /payload\s*:\s*\{/.test(code);
+	const hasContent = /content\s*:\s*\{/.test(code);
+	const hasDefinition = /definition\s*:\s*\{/.test(code);
+	const emittedEvents = extractRefList(code, "emits") ?? extractRefList(code, "emittedEvents");
+	const testRefs = extractTestRefs(code);
+	const policyRefs = hasPolicy ? parsePolicy(code) : void 0;
+	return {
+		filePath,
+		key,
+		version,
+		specType,
+		kind,
+		description,
+		goal,
+		context,
+		stability,
+		owners,
+		tags,
+		hasMeta,
+		hasIo,
+		hasPolicy,
+		hasPayload,
+		hasContent,
+		hasDefinition,
+		emittedEvents,
+		policyRefs,
+		testRefs,
+		testTarget: extractTestTarget(code),
+		testCoverage: extractTestCoverage(code),
+		sourceBlock: code
+	};
+}
+/**
+* Infer spec type from file path convention.
+*/
+function inferSpecTypeFromFilePath(filePath) {
+	if (filePath.includes(".contracts.") || /\/operations?\//.test(filePath)) return "operation";
+	if (filePath.includes(".event.") || /\/events?\//.test(filePath)) return "event";
+	if (filePath.includes(".presentation.") || /\/presentations?\//.test(filePath)) return "presentation";
+	if (filePath.includes(".policy.") || /\/policies?\//.test(filePath)) return "policy";
+	if (filePath.includes(".feature.") || /\/features?\//.test(filePath)) return "feature";
+	if (filePath.includes(".type.") || /\/types?\//.test(filePath)) return "type";
+	if (filePath.includes(".example.") || /\/examples?\//.test(filePath)) return "example";
+	if (filePath.includes(".app-config.")) return "app-config";
+	if (filePath.includes(".workflow.") || /\/workflows?\//.test(filePath)) return "workflow";
+	if (filePath.includes(".integration.") || /\/integrations?\//.test(filePath)) return "integration";
+	return "unknown";
+}
+
+//#endregion
+export { inferSpecTypeFromFilePath, scanAllSpecsFromSource, scanSpecSource };
+//# sourceMappingURL=spec-scan.js.map

package/dist/analysis/spec-scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-scan.js","names":[],"sources":["../../src/analysis/spec-scan.ts"],"sourcesContent":["/**\n * Spec scanning utilities.\n *\n * Scans source code to extract spec definitions and metadata without execution.\n */\n\nimport type { SpecScanResult } from '../types/analysis-types';\nimport {\n  extractArrayConstants,\n  resolveVariablesInBlock,\n} from './utils/variables';\n\nimport {\n  findMatchingDelimiter,\n  isStability,\n  matchStringArrayField,\n  matchStringField,\n  matchVersionField,\n} from './utils/matchers';\n\nimport {\n  parsePolicy,\n  extractRefList,\n  extractTestRefs,\n  extractTestCoverage,\n  extractTestTarget,\n} from './spec-parsing-utils';\n\nexport { extractTestTarget, extractTestCoverage } from './spec-parsing-utils';\n\n/**\n * Scan all specs from a single source file.\n */\nexport function scanAllSpecsFromSource(\n  code: string,\n  filePath: string\n): SpecScanResult[] {\n  const results: SpecScanResult[] = [];\n\n  // Pre-scan for variables available in file scope\n  const variables = extractArrayConstants(code);\n\n  // Match export definitions: export const X = defineXXX calls\n  const definitionRegex =\n    /export\\s+const\\s+(\\w+)\\s*=\\s*define(Command|Query|Event|Presentation|Capability|Policy|Type|Example|AppConfig|Integration|Workflow|TestSpec|Feature)\\s*\\(/g;\n  let match;\n\n  while ((match = definitionRegex.exec(code)) !== null) {\n    const start = match.index;\n    const openParenIndex = start + match[0].length - 1;\n    const end = findMatchingDelimiter(code, openParenIndex, '(', ')');\n    if (end === -1) continue;\n\n    // Optional: include trailing semicolon\n    let finalEnd = end;\n    if (code[finalEnd + 1] === ';') {\n      finalEnd++;\n    }\n\n    const block = code.substring(start, finalEnd + 1);\n\n    // Resolve variables in the block\n    const resolvedBlock = resolveVariablesInBlock(block, variables);\n\n    const result = scanSpecSource(resolvedBlock, filePath);\n    if (result) {\n      results.push({\n        ...result,\n        sourceBlock: resolvedBlock, // Ensure the result has the resolved block\n      });\n    }\n  }\n\n  // Fallback: legacy file scan if no explicit exports found\n  if (results.length === 0 && filePath.includes('.spec.')) {\n    const result = scanSpecSource(code, filePath);\n    if (result.key !== 'unknown') {\n      // Try to resolve globally even for fallback (though scope is harder)\n      const resolvedBlock = resolveVariablesInBlock(code, variables);\n      const result = scanSpecSource(resolvedBlock, filePath);\n      results.push(result);\n    }\n  }\n\n  return results;\n}\n\n/**\n * Scan a single spec source string.\n */\nexport function scanSpecSource(code: string, filePath: string): SpecScanResult {\n  const keyMatch =\n    code.match(/key\\s*:\\s*['\"]([^'\"]+)['\"]/) ??\n    code.match(/export\\s+const\\s+(\\w+)\\s*=/);\n  const key = keyMatch?.[1] ?? 'unknown';\n\n  const version = matchVersionField(code, 'version');\n  const description = matchStringField(code, 'description') ?? undefined;\n  const goal = matchStringField(code, 'goal') ?? undefined;\n  const context = matchStringField(code, 'context') ?? undefined;\n  const stabilityRaw = matchStringField(code, 'stability');\n  const stability = isStability(stabilityRaw) ? stabilityRaw : undefined;\n  const owners = matchStringArrayField(code, 'owners');\n  const tags = matchStringArrayField(code, 'tags');\n\n  // Determine type\n  let specType: SpecScanResult['specType'] = 'unknown';\n  let kind: string | undefined;\n\n  if (code.includes('defineCommand')) {\n    specType = 'operation';\n    kind = 'command';\n  } else if (code.includes('defineQuery')) {\n    specType = 'operation';\n    kind = 'query';\n  } else if (code.includes('defineEvent')) {\n    specType = 'event';\n    kind = 'event';\n  } else if (code.includes('definePresentation')) {\n    specType = 'presentation';\n    kind = 'presentation';\n  } else if (code.includes('definePolicy')) {\n    specType = 'policy';\n    kind = 'policy';\n  } else if (code.includes('defineCapability')) {\n    specType = 'capability';\n    kind = 'capability';\n  } else if (code.includes('defineExample')) {\n    specType = 'example';\n    kind = 'example';\n  } else if (code.includes('defineAppConfig')) {\n    specType = 'app-config';\n    kind = 'app-config';\n  } else if (code.includes('defineIntegration')) {\n    specType = 'integration';\n    kind = 'integration';\n  } else if (code.includes('defineWorkflow')) {\n    specType = 'workflow';\n    kind = 'workflow';\n  } else if (code.includes('defineTestSpec')) {\n    specType = 'test-spec';\n    kind = 'test-spec';\n  } else if (code.includes('defineFeature')) {\n    specType = 'feature';\n    kind = 'feature';\n  }\n\n  // Check feature flags/sections\n  const hasMeta = /meta\\s*:\\s*\\{/.test(code);\n  const hasIo = /io\\s*:\\s*\\{/.test(code);\n  const hasPolicy = /policy\\s*:\\s*\\{/.test(code);\n  const hasPayload = /payload\\s*:\\s*\\{/.test(code);\n  const hasContent = /content\\s*:\\s*\\{/.test(code);\n  const hasDefinition = /definition\\s*:\\s*\\{/.test(code);\n\n  // References\n  const emittedEvents =\n    extractRefList(code, 'emits') ?? extractRefList(code, 'emittedEvents');\n  const testRefs = extractTestRefs(code);\n\n  const policyRefs = hasPolicy ? parsePolicy(code) : undefined;\n\n  return {\n    filePath,\n    key,\n    version,\n    specType,\n    kind: kind as SpecScanResult['kind'],\n    description,\n    goal,\n    context,\n    stability,\n    owners,\n    tags,\n    hasMeta,\n    hasIo,\n    hasPolicy,\n    hasPayload,\n    hasContent,\n    hasDefinition,\n    emittedEvents,\n    policyRefs,\n    testRefs,\n    testTarget: extractTestTarget(code),\n    testCoverage: extractTestCoverage(code),\n    sourceBlock: code,\n  };\n}\n\n/**\n * Infer spec type from file path convention.\n */\nexport function inferSpecTypeFromFilePath(\n  filePath: string\n): SpecScanResult['specType'] | 'feature' | 'unknown' {\n  if (filePath.includes('.contracts.') || /\\/operations?\\//.test(filePath)) {\n    return 'operation';\n  }\n  if (filePath.includes('.event.') || /\\/events?\\//.test(filePath)) {\n    return 'event';\n  }\n  if (\n    filePath.includes('.presentation.') ||\n    /\\/presentations?\\//.test(filePath)\n  ) {\n    return 'presentation';\n  }\n  if (filePath.includes('.policy.') || /\\/policies?\\//.test(filePath)) {\n    return 'policy';\n  }\n  if (filePath.includes('.feature.') || /\\/features?\\//.test(filePath)) {\n    return 'feature';\n  }\n  if (filePath.includes('.type.') || /\\/types?\\//.test(filePath)) {\n    return 'type';\n  }\n  if (filePath.includes('.example.') || /\\/examples?\\//.test(filePath)) {\n    return 'example';\n  }\n  if (filePath.includes('.app-config.')) {\n    return 'app-config';\n  }\n  if (filePath.includes('.workflow.') || /\\/workflows?\\//.test(filePath)) {\n    return 'workflow';\n  }\n  if (\n    filePath.includes('.integration.') ||\n    /\\/integrations?\\//.test(filePath)\n  ) {\n    return 'integration';\n  }\n  return 'unknown';\n}\n"],"mappings":"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"}

package/dist/analysis/utils/matchers.js

@@ -0,0 +1,77 @@
+//#region src/analysis/utils/matchers.ts
+/**
+* Escape regex special characters.
+*/
+function escapeRegex(value) {
+	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+* Match a string field in source code.
+*/
+function matchStringField(code, field) {
+	const regex = /* @__PURE__ */ new RegExp(`${escapeRegex(field)}\\s*:\\s*['"]([^'"]+)['"]`);
+	return code.match(regex)?.[1] ?? null;
+}
+/**
+* Match a string field within a limited scope.
+*/
+function matchStringFieldIn(code, field) {
+	return matchStringField(code, field);
+}
+/**
+* Match a version field which can be a string or number.
+*/
+function matchVersionField(code, field) {
+	const regex = /* @__PURE__ */ new RegExp(`${escapeRegex(field)}\\s*:\\s*(?:['"]([^'"]+)['"]|(\\d+(?:\\.\\d+)*))`);
+	const match = code.match(regex);
+	if (match?.[1]) return match[1];
+	if (match?.[2]) return match[2];
+}
+/**
+* Match a string array field in source code.
+*/
+function matchStringArrayField(code, field) {
+	const regex = /* @__PURE__ */ new RegExp(`${escapeRegex(field)}\\s*:\\s*\\[([\\s\\S]*?)\\]`);
+	const match = code.match(regex);
+	if (!match?.[1]) return void 0;
+	const inner = match[1];
+	const items = Array.from(inner.matchAll(/['"]([^'"]+)['"]/g)).map((m) => m[1]).filter((value) => typeof value === "string" && value.length > 0);
+	return items.length > 0 ? items : void 0;
+}
+/**
+* Check if a value is a valid stability.
+*/
+function isStability(value) {
+	return value === "experimental" || value === "beta" || value === "stable" || value === "deprecated";
+}
+/**
+* Find matching closing delimiter for an opening delimiter.
+* Returns the index of the closing delimiter or -1 if not found.
+*/
+function findMatchingDelimiter(code, startIndex, openChar, closeChar) {
+	let depth = 0;
+	let inString = false;
+	let stringChar = "";
+	for (let i = startIndex; i < code.length; i++) {
+		const char = code[i];
+		const prevChar = i > 0 ? code[i - 1] : "";
+		if ((char === "\"" || char === "'" || char === "`") && prevChar !== "\\") {
+			if (!inString) {
+				inString = true;
+				stringChar = char;
+			} else if (char === stringChar) inString = false;
+			continue;
+		}
+		if (inString) continue;
+		if (char === openChar) depth++;
+		else if (char === closeChar) {
+			depth--;
+			if (depth === 0) return i;
+		}
+	}
+	return -1;
+}
+
+//#endregion
+export { escapeRegex, findMatchingDelimiter, isStability, matchStringArrayField, matchStringField, matchStringFieldIn, matchVersionField };
+//# sourceMappingURL=matchers.js.map

package/dist/analysis/utils/matchers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchers.js","names":[],"sources":["../../../src/analysis/utils/matchers.ts"],"sourcesContent":["/**\n * Shared regex matchers and parsing utilities for spec scanning.\n */\n\nimport type { Stability } from '../../types/spec-types';\n\n/**\n * Escape regex special characters.\n */\nexport function escapeRegex(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/**\n * Match a string field in source code.\n */\nexport function matchStringField(code: string, field: string): string | null {\n  const regex = new RegExp(`${escapeRegex(field)}\\\\s*:\\\\s*['\"]([^'\"]+)['\"]`);\n  const match = code.match(regex);\n  return match?.[1] ?? null;\n}\n\n/**\n * Match a string field within a limited scope.\n */\nexport function matchStringFieldIn(code: string, field: string): string | null {\n  return matchStringField(code, field);\n}\n\n/**\n * Match a version field which can be a string or number.\n */\nexport function matchVersionField(\n  code: string,\n  field: string\n): string | undefined {\n  const regex = new RegExp(\n    `${escapeRegex(field)}\\\\s*:\\\\s*(?:['\"]([^'\"]+)['\"]|(\\\\d+(?:\\\\.\\\\d+)*))`\n  );\n  const match = code.match(regex);\n  if (match?.[1]) return match[1];\n  if (match?.[2]) return match[2];\n  return undefined;\n}\n\n/**\n * Match a string array field in source code.\n */\nexport function matchStringArrayField(\n  code: string,\n  field: string\n): string[] | undefined {\n  const regex = new RegExp(`${escapeRegex(field)}\\\\s*:\\\\s*\\\\[([\\\\s\\\\S]*?)\\\\]`);\n  const match = code.match(regex);\n  if (!match?.[1]) return undefined;\n\n  const inner = match[1];\n  const items = Array.from(inner.matchAll(/['\"]([^'\"]+)['\"]/g))\n    .map((m) => m[1])\n    .filter(\n      (value): value is string => typeof value === 'string' && value.length > 0\n    );\n\n  return items.length > 0 ? items : undefined;\n}\n\n/**\n * Check if a value is a valid stability.\n */\nexport function isStability(value: string | null): value is Stability {\n  return (\n    value === 'experimental' ||\n    value === 'beta' ||\n    value === 'stable' ||\n    value === 'deprecated'\n  );\n}\n\n/**\n * Find matching closing delimiter for an opening delimiter.\n * Returns the index of the closing delimiter or -1 if not found.\n */\nexport function findMatchingDelimiter(\n  code: string,\n  startIndex: number,\n  openChar: string,\n  closeChar: string\n): number {\n  let depth = 0;\n  let inString = false;\n  let stringChar = '';\n\n  for (let i = startIndex; i < code.length; i++) {\n    const char = code[i];\n    const prevChar = i > 0 ? code[i - 1] : '';\n\n    // Handle string literals\n    if ((char === '\"' || char === \"'\" || char === '`') && prevChar !== '\\\\') {\n      if (!inString) {\n        inString = true;\n        stringChar = char;\n      } else if (char === stringChar) {\n        inString = false;\n      }\n      continue;\n    }\n\n    if (inString) continue;\n\n    if (char === openChar) {\n      depth++;\n    } else if (char === closeChar) {\n      depth--;\n      if (depth === 0) {\n        return i;\n      }\n    }\n  }\n\n  return -1;\n}\n\n/**\n * Find matching closing brace for an opening brace.\n * Returns the index of the closing brace or -1 if not found.\n */\nexport function findMatchingBrace(code: string, startIndex: number): number {\n  return findMatchingDelimiter(code, startIndex, '{', '}');\n}\n"],"mappings":";;;;AASA,SAAgB,YAAY,OAAuB;AACjD,QAAO,MAAM,QAAQ,uBAAuB,OAAO;;;;;AAMrD,SAAgB,iBAAiB,MAAc,OAA8B;CAC3E,MAAM,wBAAQ,IAAI,OAAO,GAAG,YAAY,MAAM,CAAC,2BAA2B;AAE1E,QADc,KAAK,MAAM,MAAM,GAChB,MAAM;;;;;AAMvB,SAAgB,mBAAmB,MAAc,OAA8B;AAC7E,QAAO,iBAAiB,MAAM,MAAM;;;;;AAMtC,SAAgB,kBACd,MACA,OACoB;CACpB,MAAM,wBAAQ,IAAI,OAChB,GAAG,YAAY,MAAM,CAAC,kDACvB;CACD,MAAM,QAAQ,KAAK,MAAM,MAAM;AAC/B,KAAI,QAAQ,GAAI,QAAO,MAAM;AAC7B,KAAI,QAAQ,GAAI,QAAO,MAAM;;;;;AAO/B,SAAgB,sBACd,MACA,OACsB;CACtB,MAAM,wBAAQ,IAAI,OAAO,GAAG,YAAY,MAAM,CAAC,6BAA6B;CAC5E,MAAM,QAAQ,KAAK,MAAM,MAAM;AAC/B,KAAI,CAAC,QAAQ,GAAI,QAAO;CAExB,MAAM,QAAQ,MAAM;CACpB,MAAM,QAAQ,MAAM,KAAK,MAAM,SAAS,oBAAoB,CAAC,CAC1D,KAAK,MAAM,EAAE,GAAG,CAChB,QACE,UAA2B,OAAO,UAAU,YAAY,MAAM,SAAS,EACzE;AAEH,QAAO,MAAM,SAAS,IAAI,QAAQ;;;;;AAMpC,SAAgB,YAAY,OAA0C;AACpE,QACE,UAAU,kBACV,UAAU,UACV,UAAU,YACV,UAAU;;;;;;AAQd,SAAgB,sBACd,MACA,YACA,UACA,WACQ;CACR,IAAI,QAAQ;CACZ,IAAI,WAAW;CACf,IAAI,aAAa;AAEjB,MAAK,IAAI,IAAI,YAAY,IAAI,KAAK,QAAQ,KAAK;EAC7C,MAAM,OAAO,KAAK;EAClB,MAAM,WAAW,IAAI,IAAI,KAAK,IAAI,KAAK;AAGvC,OAAK,SAAS,QAAO,SAAS,OAAO,SAAS,QAAQ,aAAa,MAAM;AACvE,OAAI,CAAC,UAAU;AACb,eAAW;AACX,iBAAa;cACJ,SAAS,WAClB,YAAW;AAEb;;AAGF,MAAI,SAAU;AAEd,MAAI,SAAS,SACX;WACS,SAAS,WAAW;AAC7B;AACA,OAAI,UAAU,EACZ,QAAO;;;AAKb,QAAO"}