@soda-gql/common 0.11.9 → 0.11.11

package/dist/utils-ZCE_eqCf.mjs

@@ -0,0 +1,371 @@
+import { dirname, join, normalize, resolve } from "node:path";
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { err, ok } from "neverthrow";
+
+//#region packages/common/src/utils/path.ts
+/**
+* File extensions to try when resolving module specifiers.
+* Ordered to match TypeScript's module resolution order.
+* @see https://www.typescriptlang.org/docs/handbook/module-resolution.html
+*/
+const MODULE_EXTENSION_CANDIDATES = [
+	".ts",
+	".tsx",
+	".mts",
+	".cts",
+	".js",
+	".mjs",
+	".cjs",
+	".jsx"
+];
+/**
+* Mapping from JS extensions to their corresponding TS extensions.
+* Used for ESM-style imports where .js is written but .ts is the actual source.
+*/
+const JS_TO_TS_EXTENSION_MAP = {
+	".js": [".ts", ".tsx"],
+	".mjs": [".mts"],
+	".cjs": [".cts"],
+	".jsx": [".tsx"]
+};
+/**
+* Parse a JS extension from a specifier for ESM-style import resolution.
+* Returns the base path (without extension), the JS extension, and corresponding TS extensions.
+*
+* @param specifier - The import specifier to parse
+* @returns Object with base, jsExtension, and tsExtensions, or null if no JS extension found
+*
+* @example
+* parseJsExtension("./foo.js") // { base: "./foo", jsExtension: ".js", tsExtensions: [".ts", ".tsx"] }
+* parseJsExtension("./foo.mjs") // { base: "./foo", jsExtension: ".mjs", tsExtensions: [".mts"] }
+* parseJsExtension("./foo") // null
+* parseJsExtension("./foo.ts") // null
+*/
+const parseJsExtension = (specifier) => {
+	for (const [ext, tsExts] of Object.entries(JS_TO_TS_EXTENSION_MAP)) {
+		if (specifier.endsWith(ext)) {
+			return {
+				base: specifier.slice(0, -ext.length),
+				jsExtension: ext,
+				tsExtensions: tsExts
+			};
+		}
+	}
+	return null;
+};
+/**
+* Normalize path to use forward slashes (cross-platform).
+* Ensures consistent path handling across platforms.
+*/
+const normalizePath = (value) => normalize(value).replace(/\\/g, "/");
+/**
+* Resolve a relative import specifier to an absolute file path.
+* Tries the specifier as-is, with extensions, and as a directory with index files.
+*
+* @param from - Absolute path to the importing file
+* @param specifier - Relative module specifier (must start with '.')
+* @returns Absolute POSIX path to the resolved file, or null if not found
+*/
+const resolveRelativeImportWithExistenceCheck = ({ filePath, specifier }) => {
+	const jsExtInfo = parseJsExtension(specifier);
+	if (jsExtInfo) {
+		const baseWithoutExt = resolve(dirname(filePath), jsExtInfo.base);
+		for (const ext of jsExtInfo.tsExtensions) {
+			const candidate = `${baseWithoutExt}${ext}`;
+			if (existsSync(candidate)) {
+				return normalizePath(candidate);
+			}
+		}
+		const jsCandidate = `${baseWithoutExt}${jsExtInfo.jsExtension}`;
+		if (existsSync(jsCandidate)) {
+			try {
+				const stat = statSync(jsCandidate);
+				if (stat.isFile()) {
+					return normalizePath(jsCandidate);
+				}
+			} catch {}
+		}
+		return null;
+	}
+	const base = resolve(dirname(filePath), specifier);
+	for (const ext of MODULE_EXTENSION_CANDIDATES) {
+		const candidate = `${base}${ext}`;
+		if (existsSync(candidate)) {
+			return normalizePath(candidate);
+		}
+	}
+	for (const ext of MODULE_EXTENSION_CANDIDATES) {
+		const candidate = join(base, `index${ext}`);
+		if (existsSync(candidate)) {
+			return normalizePath(candidate);
+		}
+	}
+	if (existsSync(base)) {
+		try {
+			const stat = statSync(base);
+			if (stat.isFile()) {
+				return normalizePath(base);
+			}
+		} catch {}
+	}
+	return null;
+};
+/**
+* Resolve a relative import specifier to an absolute file path.
+* Tries the specifier as-is, with extensions, and as a directory with index files.
+*
+* @param from - Absolute path to the importing file
+* @param specifier - Relative module specifier (must start with '.')
+* @returns Absolute POSIX path to the resolved file, or null if not found
+*/
+const resolveRelativeImportWithReferences = ({ filePath, specifier, references }) => {
+	const jsExtInfo = parseJsExtension(specifier);
+	if (jsExtInfo) {
+		const baseWithoutExt = resolve(dirname(filePath), jsExtInfo.base);
+		for (const ext of jsExtInfo.tsExtensions) {
+			const candidate = `${baseWithoutExt}${ext}`;
+			if (references.has(candidate)) {
+				return normalizePath(candidate);
+			}
+		}
+		const jsCandidate = `${baseWithoutExt}${jsExtInfo.jsExtension}`;
+		if (references.has(jsCandidate)) {
+			return normalizePath(jsCandidate);
+		}
+		return null;
+	}
+	const base = resolve(dirname(filePath), specifier);
+	if (references.has(base)) {
+		return normalizePath(base);
+	}
+	for (const ext of MODULE_EXTENSION_CANDIDATES) {
+		const candidate = `${base}${ext}`;
+		if (references.has(candidate)) {
+			return normalizePath(candidate);
+		}
+	}
+	for (const ext of MODULE_EXTENSION_CANDIDATES) {
+		const candidate = join(base, `index${ext}`);
+		if (references.has(candidate)) {
+			return normalizePath(candidate);
+		}
+	}
+	return null;
+};
+/**
+* Check if a module specifier is relative (starts with '.' or '..')
+*/
+const isRelativeSpecifier = (specifier) => specifier.startsWith("./") || specifier.startsWith("../");
+/**
+* Check if a module specifier is external (package name, not relative)
+*/
+const isExternalSpecifier = (specifier) => !isRelativeSpecifier(specifier);
+
+//#endregion
+//#region packages/common/src/utils/alias-resolver.ts
+/**
+* Match a specifier against a tsconfig path pattern.
+* Returns the captured wildcard portion or null if no match.
+*
+* Pattern rules:
+* - Exact match: "@/utils" matches "@/utils" exactly, captures ""
+* - Wildcard: "@/*" matches "@/foo", captures "foo"
+* - Wildcard with suffix: "*.js" matches "foo.js", captures "foo"
+*/
+const matchPattern = (specifier, pattern) => {
+	const starIndex = pattern.indexOf("*");
+	if (starIndex === -1) {
+		return specifier === pattern ? "" : null;
+	}
+	const prefix = pattern.slice(0, starIndex);
+	const suffix = pattern.slice(starIndex + 1);
+	if (!specifier.startsWith(prefix)) {
+		return null;
+	}
+	if (suffix && !specifier.endsWith(suffix)) {
+		return null;
+	}
+	const captured = specifier.slice(prefix.length, suffix ? specifier.length - suffix.length : undefined);
+	return captured;
+};
+/**
+* Apply a captured wildcard to a target path.
+*/
+const applyCapture = (target, captured) => {
+	const starIndex = target.indexOf("*");
+	if (starIndex === -1) {
+		return target;
+	}
+	return target.slice(0, starIndex) + captured + target.slice(starIndex + 1);
+};
+/**
+* Try to resolve a path to an actual file, applying extension resolution.
+* Handles ESM-style imports with JS extensions.
+*/
+const resolveToFile = (basePath) => {
+	const jsExtInfo = parseJsExtension(basePath);
+	if (jsExtInfo) {
+		const baseWithoutExt = basePath.slice(0, -jsExtInfo.jsExtension.length);
+		for (const ext of jsExtInfo.tsExtensions) {
+			const candidate = `${baseWithoutExt}${ext}`;
+			if (existsSync(candidate)) {
+				try {
+					const stat = statSync(candidate);
+					if (stat.isFile()) {
+						return normalizePath(candidate);
+					}
+				} catch {}
+			}
+		}
+		if (existsSync(basePath)) {
+			try {
+				const stat = statSync(basePath);
+				if (stat.isFile()) {
+					return normalizePath(basePath);
+				}
+			} catch {}
+		}
+		return null;
+	}
+	if (existsSync(basePath)) {
+		try {
+			const stat = statSync(basePath);
+			if (stat.isFile()) {
+				return normalizePath(basePath);
+			}
+		} catch {}
+	}
+	for (const ext of MODULE_EXTENSION_CANDIDATES) {
+		const candidate = `${basePath}${ext}`;
+		if (existsSync(candidate)) {
+			try {
+				const stat = statSync(candidate);
+				if (stat.isFile()) {
+					return normalizePath(candidate);
+				}
+			} catch {}
+		}
+	}
+	for (const ext of MODULE_EXTENSION_CANDIDATES) {
+		const candidate = join(basePath, `index${ext}`);
+		if (existsSync(candidate)) {
+			try {
+				const stat = statSync(candidate);
+				if (stat.isFile()) {
+					return normalizePath(candidate);
+				}
+			} catch {}
+		}
+	}
+	return null;
+};
+/**
+* Create an alias resolver from tsconfig paths configuration.
+*
+* Resolution behavior:
+* 1. Try each pattern in order (first match wins per TS spec)
+* 2. For each matched pattern, try all target paths in order
+* 3. For each target, apply extension resolution
+* 4. Return first found file, or null if none found
+*/
+const createAliasResolver = (config) => {
+	const { paths } = config;
+	const patterns = Object.keys(paths);
+	return { resolve: (specifier) => {
+		for (const pattern of patterns) {
+			const captured = matchPattern(specifier, pattern);
+			if (captured === null) {
+				continue;
+			}
+			const targets = paths[pattern];
+			if (!targets) {
+				continue;
+			}
+			for (const target of targets) {
+				const resolvedTarget = applyCapture(target, captured);
+				const result = resolveToFile(resolvedTarget);
+				if (result) {
+					return result;
+				}
+			}
+		}
+		return null;
+	} };
+};
+
+//#endregion
+//#region packages/common/src/utils/cached-fn.ts
+const cachedFn = (fn) => {
+	let cached = null;
+	const ensure = () => (cached ??= { value: fn() }).value;
+	ensure.clear = () => {
+		cached = null;
+	};
+	return ensure;
+};
+
+//#endregion
+//#region packages/common/src/utils/tsconfig.ts
+/**
+* Strip JSON comments and trailing commas for parsing.
+* Handles both line comments (//) and block comments.
+*/
+const stripJsonComments = (json) => {
+	return json.replace(/\/\*[\s\S]*?\*\//g, "").replace(/\/\/.*/g, "").replace(/,(\s*[}\]])/g, "$1");
+};
+/**
+* Read and parse tsconfig.json to extract paths configuration.
+* Currently does not support `extends` - reads only the specified file.
+*
+* @param tsconfigPath - Absolute path to tsconfig.json
+* @returns Parsed paths configuration or null if no paths defined
+*/
+const readTsconfigPaths = (tsconfigPath) => {
+	let content;
+	try {
+		content = readFileSync(tsconfigPath, "utf-8");
+	} catch (error) {
+		return err({
+			code: "TSCONFIG_READ_FAILED",
+			message: `Failed to read tsconfig.json: ${error instanceof Error ? error.message : String(error)}`
+		});
+	}
+	let parsed;
+	try {
+		const cleaned = stripJsonComments(content);
+		parsed = JSON.parse(cleaned);
+	} catch (error) {
+		return err({
+			code: "TSCONFIG_PARSE_FAILED",
+			message: `Failed to parse tsconfig.json: ${error instanceof Error ? error.message : String(error)}`
+		});
+	}
+	if (typeof parsed !== "object" || parsed === null) {
+		return err({
+			code: "TSCONFIG_INVALID",
+			message: "tsconfig.json must be an object"
+		});
+	}
+	const config = parsed;
+	const compilerOptions = config.compilerOptions;
+	if (!compilerOptions?.paths) {
+		return ok(null);
+	}
+	const tsconfigDir = dirname(tsconfigPath);
+	const baseUrl = typeof compilerOptions.baseUrl === "string" ? resolve(tsconfigDir, compilerOptions.baseUrl) : tsconfigDir;
+	const rawPaths = compilerOptions.paths;
+	const resolvedPaths = {};
+	for (const [pattern, targets] of Object.entries(rawPaths)) {
+		if (Array.isArray(targets)) {
+			resolvedPaths[pattern] = targets.map((target) => resolve(baseUrl, target));
+		}
+	}
+	return ok({
+		baseUrl,
+		paths: resolvedPaths
+	});
+};
+
+//#endregion
+export { isExternalSpecifier as a, parseJsExtension as c, MODULE_EXTENSION_CANDIDATES as i, resolveRelativeImportWithExistenceCheck as l, cachedFn as n, isRelativeSpecifier as o, createAliasResolver as r, normalizePath as s, readTsconfigPaths as t, resolveRelativeImportWithReferences as u };
+//# sourceMappingURL=utils-ZCE_eqCf.mjs.map

package/dist/utils-ZCE_eqCf.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils-ZCE_eqCf.mjs","names":["JS_TO_TS_EXTENSION_MAP: Readonly<Record<string, readonly string[]>>","cached: { value: T } | null","content: string","parsed: unknown","resolvedPaths: Record<string, readonly string[]>"],"sources":["../src/utils/path.ts","../src/utils/alias-resolver.ts","../src/utils/cached-fn.ts","../src/utils/tsconfig.ts"],"sourcesContent":["import { existsSync, statSync } from \"node:fs\";\nimport { dirname, join, normalize, resolve } from \"node:path\";\n\n/**\n * File extensions to try when resolving module specifiers.\n * Ordered to match TypeScript's module resolution order.\n * @see https://www.typescriptlang.org/docs/handbook/module-resolution.html\n */\nexport const MODULE_EXTENSION_CANDIDATES = [\".ts\", \".tsx\", \".mts\", \".cts\", \".js\", \".mjs\", \".cjs\", \".jsx\"] as const;\n\n/**\n * Mapping from JS extensions to their corresponding TS extensions.\n * Used for ESM-style imports where .js is written but .ts is the actual source.\n */\nconst JS_TO_TS_EXTENSION_MAP: Readonly<Record<string, readonly string[]>> = {\n  \".js\": [\".ts\", \".tsx\"],\n  \".mjs\": [\".mts\"],\n  \".cjs\": [\".cts\"],\n  \".jsx\": [\".tsx\"],\n};\n\n/**\n * Result of parsing a JS extension from a specifier.\n */\nexport type JsExtensionInfo = {\n  /** The specifier without the JS extension */\n  readonly base: string;\n  /** The JS extension found (e.g., \".js\", \".mjs\") */\n  readonly jsExtension: string;\n  /** The corresponding TS extensions to try (e.g., [\".ts\", \".tsx\"] for \".js\") */\n  readonly tsExtensions: readonly string[];\n};\n\n/**\n * Parse a JS extension from a specifier for ESM-style import resolution.\n * Returns the base path (without extension), the JS extension, and corresponding TS extensions.\n *\n * @param specifier - The import specifier to parse\n * @returns Object with base, jsExtension, and tsExtensions, or null if no JS extension found\n *\n * @example\n * parseJsExtension(\"./foo.js\") // { base: \"./foo\", jsExtension: \".js\", tsExtensions: [\".ts\", \".tsx\"] }\n * parseJsExtension(\"./foo.mjs\") // { base: \"./foo\", jsExtension: \".mjs\", tsExtensions: [\".mts\"] }\n * parseJsExtension(\"./foo\") // null\n * parseJsExtension(\"./foo.ts\") // null\n */\nexport const parseJsExtension = (specifier: string): JsExtensionInfo | null => {\n  for (const [ext, tsExts] of Object.entries(JS_TO_TS_EXTENSION_MAP)) {\n    if (specifier.endsWith(ext)) {\n      return {\n        base: specifier.slice(0, -ext.length),\n        jsExtension: ext,\n        tsExtensions: tsExts,\n      };\n    }\n  }\n  return null;\n};\n\n/**\n * Normalize path to use forward slashes (cross-platform).\n * Ensures consistent path handling across platforms.\n */\nexport const normalizePath = (value: string): string => normalize(value).replace(/\\\\/g, \"/\");\n\n/**\n * Resolve a relative import specifier to an absolute file path.\n * Tries the specifier as-is, with extensions, and as a directory with index files.\n *\n * @param from - Absolute path to the importing file\n * @param specifier - Relative module specifier (must start with '.')\n * @returns Absolute POSIX path to the resolved file, or null if not found\n */\nexport const resolveRelativeImportWithExistenceCheck = ({\n  filePath,\n  specifier,\n}: {\n  filePath: string;\n  specifier: string;\n}): string | null => {\n  // Handle ESM-style imports with JS extensions (e.g., \"./foo.js\" -> \"./foo.ts\")\n  const jsExtInfo = parseJsExtension(specifier);\n  if (jsExtInfo) {\n    const baseWithoutExt = resolve(dirname(filePath), jsExtInfo.base);\n\n    // Try corresponding TS extensions first\n    for (const ext of jsExtInfo.tsExtensions) {\n      const candidate = `${baseWithoutExt}${ext}`;\n      if (existsSync(candidate)) {\n        return normalizePath(candidate);\n      }\n    }\n\n    // Fall back to actual JS file if it exists\n    const jsCandidate = `${baseWithoutExt}${jsExtInfo.jsExtension}`;\n    if (existsSync(jsCandidate)) {\n      try {\n        const stat = statSync(jsCandidate);\n        if (stat.isFile()) {\n          return normalizePath(jsCandidate);\n        }\n      } catch {\n        // Ignore stat errors\n      }\n    }\n\n    return null;\n  }\n\n  const base = resolve(dirname(filePath), specifier);\n\n  // Try with extensions first (most common case)\n  // This handles cases like \"./constants\" resolving to \"./constants.ts\"\n  // even when a \"./constants\" directory exists\n  for (const ext of MODULE_EXTENSION_CANDIDATES) {\n    const candidate = `${base}${ext}`;\n    if (existsSync(candidate)) {\n      return normalizePath(candidate);\n    }\n  }\n\n  // Try as directory with index files\n  for (const ext of MODULE_EXTENSION_CANDIDATES) {\n    const candidate = join(base, `index${ext}`);\n    if (existsSync(candidate)) {\n      return normalizePath(candidate);\n    }\n  }\n\n  // Try exact path last (only if it's a file, not directory)\n  if (existsSync(base)) {\n    try {\n      const stat = statSync(base);\n      if (stat.isFile()) {\n        return normalizePath(base);\n      }\n    } catch {\n      // Ignore stat errors\n    }\n  }\n\n  return null;\n};\n\n/**\n * Resolve a relative import specifier to an absolute file path.\n * Tries the specifier as-is, with extensions, and as a directory with index files.\n *\n * @param from - Absolute path to the importing file\n * @param specifier - Relative module specifier (must start with '.')\n * @returns Absolute POSIX path to the resolved file, or null if not found\n */\nexport const resolveRelativeImportWithReferences = <_>({\n  filePath,\n  specifier,\n  references,\n}: {\n  filePath: string;\n  specifier: string;\n  references: Map<string, _> | Set<string>;\n}): string | null => {\n  // Handle ESM-style imports with JS extensions (e.g., \"./foo.js\" -> \"./foo.ts\")\n  const jsExtInfo = parseJsExtension(specifier);\n  if (jsExtInfo) {\n    const baseWithoutExt = resolve(dirname(filePath), jsExtInfo.base);\n\n    // Try corresponding TS extensions first\n    for (const ext of jsExtInfo.tsExtensions) {\n      const candidate = `${baseWithoutExt}${ext}`;\n      if (references.has(candidate)) {\n        return normalizePath(candidate);\n      }\n    }\n\n    // Fall back to actual JS file if it exists in references\n    const jsCandidate = `${baseWithoutExt}${jsExtInfo.jsExtension}`;\n    if (references.has(jsCandidate)) {\n      return normalizePath(jsCandidate);\n    }\n\n    return null;\n  }\n\n  const base = resolve(dirname(filePath), specifier);\n\n  // Try exact path first\n  if (references.has(base)) {\n    return normalizePath(base);\n  }\n\n  // Try with extensions\n  for (const ext of MODULE_EXTENSION_CANDIDATES) {\n    const candidate = `${base}${ext}`;\n    if (references.has(candidate)) {\n      return normalizePath(candidate);\n    }\n  }\n\n  // Try as directory with index files\n  for (const ext of MODULE_EXTENSION_CANDIDATES) {\n    const candidate = join(base, `index${ext}`);\n    if (references.has(candidate)) {\n      return normalizePath(candidate);\n    }\n  }\n\n  return null;\n};\n\n/**\n * Check if a module specifier is relative (starts with '.' or '..')\n */\nexport const isRelativeSpecifier = (specifier: string): boolean => specifier.startsWith(\"./\") || specifier.startsWith(\"../\");\n\n/**\n * Check if a module specifier is external (package name, not relative)\n */\nexport const isExternalSpecifier = (specifier: string): boolean => !isRelativeSpecifier(specifier);\n","import { existsSync, statSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { MODULE_EXTENSION_CANDIDATES, normalizePath, parseJsExtension } from \"./path\";\nimport type { TsconfigPathsConfig } from \"./tsconfig\";\n\n/**\n * Alias resolver interface for resolving path aliases to file paths.\n */\nexport type AliasResolver = {\n  /**\n   * Resolve an alias specifier to an absolute file path.\n   * Returns null if the specifier doesn't match any alias pattern\n   * or if the resolved file doesn't exist.\n   */\n  readonly resolve: (specifier: string) => string | null;\n};\n\n/**\n * Match a specifier against a tsconfig path pattern.\n * Returns the captured wildcard portion or null if no match.\n *\n * Pattern rules:\n * - Exact match: \"@/utils\" matches \"@/utils\" exactly, captures \"\"\n * - Wildcard: \"@/*\" matches \"@/foo\", captures \"foo\"\n * - Wildcard with suffix: \"*.js\" matches \"foo.js\", captures \"foo\"\n */\nconst matchPattern = (specifier: string, pattern: string): string | null => {\n  const starIndex = pattern.indexOf(\"*\");\n\n  if (starIndex === -1) {\n    // Exact match - no wildcard\n    return specifier === pattern ? \"\" : null;\n  }\n\n  const prefix = pattern.slice(0, starIndex);\n  const suffix = pattern.slice(starIndex + 1);\n\n  if (!specifier.startsWith(prefix)) {\n    return null;\n  }\n\n  if (suffix && !specifier.endsWith(suffix)) {\n    return null;\n  }\n\n  // Extract the wildcard capture\n  const captured = specifier.slice(prefix.length, suffix ? specifier.length - suffix.length : undefined);\n\n  return captured;\n};\n\n/**\n * Apply a captured wildcard to a target path.\n */\nconst applyCapture = (target: string, captured: string): string => {\n  const starIndex = target.indexOf(\"*\");\n  if (starIndex === -1) {\n    return target;\n  }\n  return target.slice(0, starIndex) + captured + target.slice(starIndex + 1);\n};\n\n/**\n * Try to resolve a path to an actual file, applying extension resolution.\n * Handles ESM-style imports with JS extensions.\n */\nconst resolveToFile = (basePath: string): string | null => {\n  // Handle ESM-style JS extension imports\n  const jsExtInfo = parseJsExtension(basePath);\n  if (jsExtInfo) {\n    const baseWithoutExt = basePath.slice(0, -jsExtInfo.jsExtension.length);\n\n    // Try corresponding TS extensions first\n    for (const ext of jsExtInfo.tsExtensions) {\n      const candidate = `${baseWithoutExt}${ext}`;\n      if (existsSync(candidate)) {\n        try {\n          const stat = statSync(candidate);\n          if (stat.isFile()) {\n            return normalizePath(candidate);\n          }\n        } catch {\n          // Ignore stat errors\n        }\n      }\n    }\n\n    // Fall back to actual JS file\n    if (existsSync(basePath)) {\n      try {\n        const stat = statSync(basePath);\n        if (stat.isFile()) {\n          return normalizePath(basePath);\n        }\n      } catch {\n        // Ignore stat errors\n      }\n    }\n\n    return null;\n  }\n\n  // Try exact path first (for paths with explicit extension)\n  if (existsSync(basePath)) {\n    try {\n      const stat = statSync(basePath);\n      if (stat.isFile()) {\n        return normalizePath(basePath);\n      }\n    } catch {\n      // Ignore stat errors\n    }\n  }\n\n  // Try with extensions\n  for (const ext of MODULE_EXTENSION_CANDIDATES) {\n    const candidate = `${basePath}${ext}`;\n    if (existsSync(candidate)) {\n      try {\n        const stat = statSync(candidate);\n        if (stat.isFile()) {\n          return normalizePath(candidate);\n        }\n      } catch {\n        // Ignore stat errors\n      }\n    }\n  }\n\n  // Try as directory with index files\n  for (const ext of MODULE_EXTENSION_CANDIDATES) {\n    const candidate = join(basePath, `index${ext}`);\n    if (existsSync(candidate)) {\n      try {\n        const stat = statSync(candidate);\n        if (stat.isFile()) {\n          return normalizePath(candidate);\n        }\n      } catch {\n        // Ignore stat errors\n      }\n    }\n  }\n\n  return null;\n};\n\n/**\n * Create an alias resolver from tsconfig paths configuration.\n *\n * Resolution behavior:\n * 1. Try each pattern in order (first match wins per TS spec)\n * 2. For each matched pattern, try all target paths in order\n * 3. For each target, apply extension resolution\n * 4. Return first found file, or null if none found\n */\nexport const createAliasResolver = (config: TsconfigPathsConfig): AliasResolver => {\n  const { paths } = config;\n  const patterns = Object.keys(paths);\n\n  return {\n    resolve: (specifier: string): string | null => {\n      // Try each pattern in order (first match wins per TS spec)\n      for (const pattern of patterns) {\n        const captured = matchPattern(specifier, pattern);\n        if (captured === null) {\n          continue;\n        }\n\n        const targets = paths[pattern];\n        if (!targets) {\n          continue;\n        }\n\n        // Try each target path in order\n        for (const target of targets) {\n          const resolvedTarget = applyCapture(target, captured);\n          const result = resolveToFile(resolvedTarget);\n          if (result) {\n            return result;\n          }\n        }\n      }\n\n      return null;\n    },\n  };\n};\n","export const cachedFn = <T>(fn: () => T) => {\n  let cached: { value: T } | null = null;\n\n  const ensure = () => (cached ??= { value: fn() }).value;\n  ensure.clear = () => {\n    cached = null;\n  };\n\n  return ensure;\n};\n","import { readFileSync } from \"node:fs\";\nimport { dirname, resolve } from \"node:path\";\nimport { err, ok, type Result } from \"neverthrow\";\n\n/**\n * Parsed tsconfig.json paths configuration.\n * All paths are resolved to absolute paths.\n */\nexport type TsconfigPathsConfig = {\n  /** Absolute base URL for path resolution */\n  readonly baseUrl: string;\n  /** Path mappings with absolute paths */\n  readonly paths: Readonly<Record<string, readonly string[]>>;\n};\n\n/**\n * Error types for tsconfig reading.\n */\nexport type TsconfigReadError = {\n  readonly code: \"TSCONFIG_READ_FAILED\" | \"TSCONFIG_PARSE_FAILED\" | \"TSCONFIG_INVALID\";\n  readonly message: string;\n};\n\n/**\n * Strip JSON comments and trailing commas for parsing.\n * Handles both line comments (//) and block comments.\n */\nconst stripJsonComments = (json: string): string => {\n  return (\n    json\n      // Remove block comments\n      .replace(/\\/\\*[\\s\\S]*?\\*\\//g, \"\")\n      // Remove line comments\n      .replace(/\\/\\/.*/g, \"\")\n      // Remove trailing commas before } or ]\n      .replace(/,(\\s*[}\\]])/g, \"$1\")\n  );\n};\n\n/**\n * Read and parse tsconfig.json to extract paths configuration.\n * Currently does not support `extends` - reads only the specified file.\n *\n * @param tsconfigPath - Absolute path to tsconfig.json\n * @returns Parsed paths configuration or null if no paths defined\n */\nexport const readTsconfigPaths = (tsconfigPath: string): Result<TsconfigPathsConfig | null, TsconfigReadError> => {\n  // Read file\n  let content: string;\n  try {\n    content = readFileSync(tsconfigPath, \"utf-8\");\n  } catch (error) {\n    return err({\n      code: \"TSCONFIG_READ_FAILED\",\n      message: `Failed to read tsconfig.json: ${error instanceof Error ? error.message : String(error)}`,\n    });\n  }\n\n  // Parse JSON (with comment stripping)\n  let parsed: unknown;\n  try {\n    const cleaned = stripJsonComments(content);\n    parsed = JSON.parse(cleaned);\n  } catch (error) {\n    return err({\n      code: \"TSCONFIG_PARSE_FAILED\",\n      message: `Failed to parse tsconfig.json: ${error instanceof Error ? error.message : String(error)}`,\n    });\n  }\n\n  // Validate structure\n  if (typeof parsed !== \"object\" || parsed === null) {\n    return err({\n      code: \"TSCONFIG_INVALID\",\n      message: \"tsconfig.json must be an object\",\n    });\n  }\n\n  const config = parsed as Record<string, unknown>;\n  const compilerOptions = config.compilerOptions as Record<string, unknown> | undefined;\n\n  // Return null if no paths defined\n  if (!compilerOptions?.paths) {\n    return ok(null);\n  }\n\n  // Resolve baseUrl\n  const tsconfigDir = dirname(tsconfigPath);\n  const baseUrl = typeof compilerOptions.baseUrl === \"string\" ? resolve(tsconfigDir, compilerOptions.baseUrl) : tsconfigDir;\n\n  // Resolve paths to absolute paths\n  const rawPaths = compilerOptions.paths as Record<string, string[]>;\n  const resolvedPaths: Record<string, readonly string[]> = {};\n\n  for (const [pattern, targets] of Object.entries(rawPaths)) {\n    if (Array.isArray(targets)) {\n      resolvedPaths[pattern] = targets.map((target) => resolve(baseUrl, target));\n    }\n  }\n\n  return ok({\n    baseUrl,\n    paths: resolvedPaths,\n  });\n};\n"],"mappings":"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"}

package/dist/utils.cjs

@@ -1,9 +1,12 @@
-const require_utils = require('./utils-CsTwS1dw.cjs');
+const require_utils = require('./utils-Rs7YbafF.cjs');
 
 exports.MODULE_EXTENSION_CANDIDATES = require_utils.MODULE_EXTENSION_CANDIDATES;
 exports.cachedFn = require_utils.cachedFn;
+exports.createAliasResolver = require_utils.createAliasResolver;
 exports.isExternalSpecifier = require_utils.isExternalSpecifier;
 exports.isRelativeSpecifier = require_utils.isRelativeSpecifier;
 exports.normalizePath = require_utils.normalizePath;
+exports.parseJsExtension = require_utils.parseJsExtension;
+exports.readTsconfigPaths = require_utils.readTsconfigPaths;
 exports.resolveRelativeImportWithExistenceCheck = require_utils.resolveRelativeImportWithExistenceCheck;
 exports.resolveRelativeImportWithReferences = require_utils.resolveRelativeImportWithReferences;

package/dist/utils.d.cts

@@ -1,2 +1,2 @@
-import { a as resolveRelativeImportWithExistenceCheck, i as normalizePath, n as isExternalSpecifier, o as resolveRelativeImportWithReferences, r as isRelativeSpecifier, s as cachedFn, t as MODULE_EXTENSION_CANDIDATES } from "./index-LaXfl_e_.cjs";
-export { MODULE_EXTENSION_CANDIDATES, cachedFn, isExternalSpecifier, isRelativeSpecifier, normalizePath, resolveRelativeImportWithExistenceCheck, resolveRelativeImportWithReferences };
+import { a as normalizePath, c as resolveRelativeImportWithReferences, d as createAliasResolver, f as TsconfigPathsConfig, i as isRelativeSpecifier, l as cachedFn, m as readTsconfigPaths, n as MODULE_EXTENSION_CANDIDATES, o as parseJsExtension, p as TsconfigReadError, r as isExternalSpecifier, s as resolveRelativeImportWithExistenceCheck, t as JsExtensionInfo, u as AliasResolver } from "./index-BMl8pzFY.cjs";
+export { AliasResolver, JsExtensionInfo, MODULE_EXTENSION_CANDIDATES, TsconfigPathsConfig, TsconfigReadError, cachedFn, createAliasResolver, isExternalSpecifier, isRelativeSpecifier, normalizePath, parseJsExtension, readTsconfigPaths, resolveRelativeImportWithExistenceCheck, resolveRelativeImportWithReferences };

package/dist/utils.d.mts

@@ -1,2 +1,2 @@
-import { a as resolveRelativeImportWithExistenceCheck, i as normalizePath, n as isExternalSpecifier, o as resolveRelativeImportWithReferences, r as isRelativeSpecifier, s as cachedFn, t as MODULE_EXTENSION_CANDIDATES } from "./index-Dv8spPt0.mjs";
-export { MODULE_EXTENSION_CANDIDATES, cachedFn, isExternalSpecifier, isRelativeSpecifier, normalizePath, resolveRelativeImportWithExistenceCheck, resolveRelativeImportWithReferences };
+import { a as normalizePath, c as resolveRelativeImportWithReferences, d as createAliasResolver, f as TsconfigPathsConfig, i as isRelativeSpecifier, l as cachedFn, m as readTsconfigPaths, n as MODULE_EXTENSION_CANDIDATES, o as parseJsExtension, p as TsconfigReadError, r as isExternalSpecifier, s as resolveRelativeImportWithExistenceCheck, t as JsExtensionInfo, u as AliasResolver } from "./index-BCu9PNbZ.mjs";
+export { AliasResolver, JsExtensionInfo, MODULE_EXTENSION_CANDIDATES, TsconfigPathsConfig, TsconfigReadError, cachedFn, createAliasResolver, isExternalSpecifier, isRelativeSpecifier, normalizePath, parseJsExtension, readTsconfigPaths, resolveRelativeImportWithExistenceCheck, resolveRelativeImportWithReferences };

package/dist/utils.mjs

@@ -1,3 +1,3 @@
-import { a as resolveRelativeImportWithExistenceCheck, i as normalizePath, n as isExternalSpecifier, o as resolveRelativeImportWithReferences, r as isRelativeSpecifier, s as cachedFn, t as MODULE_EXTENSION_CANDIDATES } from "./utils-DLEgAn7q.mjs";
+import { a as isExternalSpecifier, c as parseJsExtension, i as MODULE_EXTENSION_CANDIDATES, l as resolveRelativeImportWithExistenceCheck, n as cachedFn, o as isRelativeSpecifier, r as createAliasResolver, s as normalizePath, t as readTsconfigPaths, u as resolveRelativeImportWithReferences } from "./utils-ZCE_eqCf.mjs";
 
-export { MODULE_EXTENSION_CANDIDATES, cachedFn, isExternalSpecifier, isRelativeSpecifier, normalizePath, resolveRelativeImportWithExistenceCheck, resolveRelativeImportWithReferences };
+export { MODULE_EXTENSION_CANDIDATES, cachedFn, createAliasResolver, isExternalSpecifier, isRelativeSpecifier, normalizePath, parseJsExtension, readTsconfigPaths, resolveRelativeImportWithExistenceCheck, resolveRelativeImportWithReferences };

package/dist/{zod-C_6JfuYV.cjs → zod-DjI3IUH3.cjs}

@@ -1,4 +1,4 @@
-const require_canonical_id = require('./canonical-id-CgMNOZyn.cjs');
+const require_canonical_id = require('./canonical-id-DHdeYIsT.cjs');
 let zod = require("zod");
 
 //#region packages/common/src/zod/schema-helper.ts
@@ -13,4 +13,4 @@ Object.defineProperty(exports, 'defineSchemaFor', {
     return defineSchemaFor;
   }
 });
-//# sourceMappingURL=zod-C_6JfuYV.cjs.map
+//# sourceMappingURL=zod-DjI3IUH3.cjs.map

package/dist/{zod-C_6JfuYV.cjs.map → zod-DjI3IUH3.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"zod-C_6JfuYV.cjs","names":["z"],"sources":["../src/zod/schema-helper.ts"],"sourcesContent":["import { z } from \"zod\";\n\n// biome-ignore lint/suspicious/noExplicitAny: abstract type\nexport type SchemaFor<TOutput> = z.ZodType<TOutput, any, any>;\n\nexport type ShapeFor<TOutput extends object> = { [K in keyof TOutput]-?: SchemaFor<TOutput[K]> };\n\nexport function defineSchemaFor<TOutput extends object>() {\n  return <TShape extends ShapeFor<NoInfer<TOutput>>>(shape: TShape & { [K in Exclude<keyof TShape, keyof TOutput>]: never }) =>\n    z.object(shape).strict();\n}\n"],"mappings":";;;;AAOA,SAAgB,kBAA0C;AACxD,SAAmD,UACjDA,MAAE,OAAO,MAAM,CAAC,QAAQ"}
+{"version":3,"file":"zod-DjI3IUH3.cjs","names":["z"],"sources":["../src/zod/schema-helper.ts"],"sourcesContent":["import { z } from \"zod\";\n\n// biome-ignore lint/suspicious/noExplicitAny: abstract type\nexport type SchemaFor<TOutput> = z.ZodType<TOutput, any, any>;\n\nexport type ShapeFor<TOutput extends object> = { [K in keyof TOutput]-?: SchemaFor<TOutput[K]> };\n\nexport function defineSchemaFor<TOutput extends object>() {\n  return <TShape extends ShapeFor<NoInfer<TOutput>>>(shape: TShape & { [K in Exclude<keyof TShape, keyof TOutput>]: never }) =>\n    z.object(shape).strict();\n}\n"],"mappings":";;;;AAOA,SAAgB,kBAA0C;AACxD,SAAmD,UACjDA,MAAE,OAAO,MAAM,CAAC,QAAQ"}

package/dist/zod.cjs

@@ -1,3 +1,3 @@
-const require_zod = require('./zod-C_6JfuYV.cjs');
+const require_zod = require('./zod-DjI3IUH3.cjs');
 
 exports.defineSchemaFor = require_zod.defineSchemaFor;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soda-gql/common",
-  "version": "0.11.9",
+  "version": "0.11.11",
   "description": "Shared utilities for soda-gql packages",
   "type": "module",
   "private": false,

package/dist/canonical-id-BJahCcrS.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"canonical-id-BJahCcrS.mjs","names":["CanonicalIdSchema: z.ZodType<CanonicalId>","z","scopeStack: ScopeFrame[]","frame: ScopeFrame","exportBinding: string | undefined"],"sources":["../src/canonical-id/canonical-id.ts","../src/canonical-id/path-tracker.ts"],"sourcesContent":["import { isAbsolute, resolve } from \"node:path\";\nimport z from \"zod\";\nimport { normalizePath } from \"../utils\";\n\nexport type CanonicalId = string & { readonly __brand: \"CanonicalId\" };\n\nconst canonicalIdSeparator = \"::\" as const;\n\nexport const CanonicalIdSchema: z.ZodType<CanonicalId> = z.string() as unknown as z.ZodType<CanonicalId>;\n\n// Type-safe schema for CanonicalId - validates as string but types as branded\nexport const createCanonicalId = (filePath: string, astPath: string): CanonicalId => {\n  if (!isAbsolute(filePath)) {\n    throw new Error(\"[INTERNAL] CANONICAL_ID_REQUIRES_ABSOLUTE_PATH\");\n  }\n\n  const resolved = resolve(filePath);\n  const normalized = normalizePath(resolved);\n\n  // Create a 2-part ID: {absPath}::{astPath}\n  // astPath uniquely identifies the definition's location in the AST (e.g., \"MyComponent.useQuery.def\")\n  const idParts = [normalized, astPath];\n\n  return idParts.join(canonicalIdSeparator) as CanonicalId;\n};\n\n/**\n * Parse a canonical ID into its components.\n * @param canonicalId - The canonical ID to parse (e.g., \"/app/src/user.ts::userFragment\")\n * @returns An object with filePath and astPath\n */\nexport const parseCanonicalId = (\n  canonicalId: CanonicalId | string,\n): {\n  filePath: string;\n  astPath: string;\n} => {\n  const idx = canonicalId.indexOf(canonicalIdSeparator);\n  if (idx === -1) {\n    return { filePath: canonicalId, astPath: \"\" };\n  }\n  return {\n    filePath: canonicalId.slice(0, idx),\n    astPath: canonicalId.slice(idx + canonicalIdSeparator.length),\n  };\n};\n","/**\n * Canonical path tracker for AST traversal.\n *\n * This module provides a stateful helper that tracks scope information during\n * AST traversal to generate canonical IDs. It's designed to integrate with\n * existing plugin visitor patterns (Babel, SWC, TypeScript) without requiring\n * a separate AST traversal.\n *\n * Usage pattern:\n * 1. Plugin creates tracker at file/program entry\n * 2. Plugin calls enterScope/exitScope during its traversal\n * 3. Plugin calls registerDefinition when discovering GQL definitions\n * 4. Tracker provides canonical ID information\n */\n\nimport type { CanonicalId } from \"./canonical-id\";\nimport { createCanonicalId } from \"./canonical-id\";\n\n/**\n * Scope frame for tracking AST path segments\n */\nexport type ScopeFrame = {\n  /** Name segment (e.g., \"MyComponent\", \"useQuery\", \"arrow#1\") */\n  readonly nameSegment: string;\n  /** Kind of scope */\n  readonly kind: \"function\" | \"class\" | \"variable\" | \"property\" | \"method\" | \"expression\";\n  /** Occurrence index for disambiguation */\n  readonly occurrence: number;\n};\n\n/**\n * Opaque handle for scope tracking\n */\nexport type ScopeHandle = {\n  readonly __brand: \"ScopeHandle\";\n  readonly depth: number;\n};\n\n/**\n * Canonical path tracker interface\n */\nexport interface CanonicalPathTracker {\n  /**\n   * Enter a new scope during traversal\n   * @param options Scope information\n   * @returns Handle to use when exiting the scope\n   */\n  enterScope(options: { segment: string; kind: ScopeFrame[\"kind\"]; stableKey?: string }): ScopeHandle;\n\n  /**\n   * Exit a scope during traversal\n   * @param handle Handle returned from enterScope\n   */\n  exitScope(handle: ScopeHandle): void;\n\n  /**\n   * Register a definition discovered during traversal\n   * @returns Definition metadata including astPath and canonical ID information\n   */\n  registerDefinition(): {\n    astPath: string;\n    isTopLevel: boolean;\n    exportBinding?: string;\n  };\n\n  /**\n   * Resolve a canonical ID from an astPath\n   * @param astPath AST path string\n   * @returns Canonical ID\n   */\n  resolveCanonicalId(astPath: string): CanonicalId;\n\n  /**\n   * Register an export binding\n   * @param local Local variable name\n   * @param exported Exported name\n   */\n  registerExportBinding(local: string, exported: string): void;\n\n  /**\n   * Get current scope depth\n   * @returns Current depth (0 = top level)\n   */\n  currentDepth(): number;\n}\n\n/**\n * Build AST path from scope stack (internal helper)\n */\nconst _buildAstPath = (stack: readonly ScopeFrame[]): string => {\n  return stack.map((frame) => frame.nameSegment).join(\".\");\n};\n\n/**\n * Create a canonical path tracker\n *\n * @param options Configuration options\n * @returns Tracker instance\n *\n * @example\n * ```typescript\n * // In a Babel plugin\n * const tracker = createCanonicalTracker({ filePath: state.filename });\n *\n * const visitor = {\n *   FunctionDeclaration: {\n *     enter(path) {\n *       const handle = tracker.enterScope({\n *         segment: path.node.id.name,\n *         kind: 'function'\n *       });\n *     },\n *     exit(path) {\n *       tracker.exitScope(handle);\n *     }\n *   }\n * };\n * ```\n */\nexport const createCanonicalTracker = (options: {\n  filePath: string;\n  getExportName?: (localName: string) => string | undefined;\n}): CanonicalPathTracker => {\n  const { filePath, getExportName } = options;\n\n  // Scope stack\n  const scopeStack: ScopeFrame[] = [];\n\n  // Occurrence counters for disambiguating duplicate names\n  const occurrenceCounters = new Map<string, number>();\n\n  // Used paths for ensuring uniqueness\n  const usedPaths = new Set<string>();\n\n  // Export bindings map\n  const exportBindings = new Map<string, string>();\n\n  const getNextOccurrence = (key: string): number => {\n    const current = occurrenceCounters.get(key) ?? 0;\n    occurrenceCounters.set(key, current + 1);\n    return current;\n  };\n\n  const ensureUniquePath = (basePath: string): string => {\n    let path = basePath;\n    let suffix = 0;\n    while (usedPaths.has(path)) {\n      suffix++;\n      path = `${basePath}$${suffix}`;\n    }\n    usedPaths.add(path);\n    return path;\n  };\n\n  return {\n    enterScope({ segment, kind, stableKey }): ScopeHandle {\n      const key = stableKey ?? `${kind}:${segment}`;\n      const occurrence = getNextOccurrence(key);\n\n      const frame: ScopeFrame = {\n        nameSegment: segment,\n        kind,\n        occurrence,\n      };\n\n      scopeStack.push(frame);\n\n      return {\n        __brand: \"ScopeHandle\",\n        depth: scopeStack.length - 1,\n      } as ScopeHandle;\n    },\n\n    exitScope(handle: ScopeHandle): void {\n      // Validate handle depth matches current stack\n      if (handle.depth !== scopeStack.length - 1) {\n        throw new Error(`[INTERNAL] Invalid scope exit: expected depth ${scopeStack.length - 1}, got ${handle.depth}`);\n      }\n      scopeStack.pop();\n    },\n\n    registerDefinition(): {\n      astPath: string;\n      isTopLevel: boolean;\n      exportBinding?: string;\n    } {\n      const basePath = _buildAstPath(scopeStack);\n      const astPath = ensureUniquePath(basePath);\n      const isTopLevel = scopeStack.length === 0;\n\n      // Check export binding if provided\n      let exportBinding: string | undefined;\n      if (getExportName && isTopLevel) {\n        // For top-level definitions, try to get export name\n        // This is a simplified version - real logic depends on how the definition is bound\n        exportBinding = undefined;\n      }\n\n      return {\n        astPath,\n        isTopLevel,\n        exportBinding,\n      };\n    },\n\n    resolveCanonicalId(astPath: string): CanonicalId {\n      return createCanonicalId(filePath, astPath);\n    },\n\n    registerExportBinding(local: string, exported: string): void {\n      exportBindings.set(local, exported);\n    },\n\n    currentDepth(): number {\n      return scopeStack.length;\n    },\n  };\n};\n\n/**\n * Helper to create occurrence tracker (for backward compatibility)\n */\nexport const createOccurrenceTracker = (): {\n  getNextOccurrence: (key: string) => number;\n} => {\n  const occurrenceCounters = new Map<string, number>();\n\n  return {\n    getNextOccurrence(key: string): number {\n      const current = occurrenceCounters.get(key) ?? 0;\n      occurrenceCounters.set(key, current + 1);\n      return current;\n    },\n  };\n};\n\n/**\n * Helper to create path tracker (for backward compatibility)\n */\nexport const createPathTracker = (): {\n  ensureUniquePath: (basePath: string) => string;\n} => {\n  const usedPaths = new Set<string>();\n\n  return {\n    ensureUniquePath(basePath: string): string {\n      let path = basePath;\n      let suffix = 0;\n      while (usedPaths.has(path)) {\n        suffix++;\n        path = `${basePath}$${suffix}`;\n      }\n      usedPaths.add(path);\n      return path;\n    },\n  };\n};\n\n/**\n * Build AST path from scope stack (for backward compatibility)\n */\nexport const buildAstPath = (stack: readonly ScopeFrame[]): string => {\n  return stack.map((frame) => frame.nameSegment).join(\".\");\n};\n"],"mappings":"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"}

package/dist/canonical-id-CgMNOZyn.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"canonical-id-CgMNOZyn.cjs","names":["CanonicalIdSchema: z.ZodType<CanonicalId>","z","normalizePath","scopeStack: ScopeFrame[]","frame: ScopeFrame","exportBinding: string | undefined"],"sources":["../src/canonical-id/canonical-id.ts","../src/canonical-id/path-tracker.ts"],"sourcesContent":["import { isAbsolute, resolve } from \"node:path\";\nimport z from \"zod\";\nimport { normalizePath } from \"../utils\";\n\nexport type CanonicalId = string & { readonly __brand: \"CanonicalId\" };\n\nconst canonicalIdSeparator = \"::\" as const;\n\nexport const CanonicalIdSchema: z.ZodType<CanonicalId> = z.string() as unknown as z.ZodType<CanonicalId>;\n\n// Type-safe schema for CanonicalId - validates as string but types as branded\nexport const createCanonicalId = (filePath: string, astPath: string): CanonicalId => {\n  if (!isAbsolute(filePath)) {\n    throw new Error(\"[INTERNAL] CANONICAL_ID_REQUIRES_ABSOLUTE_PATH\");\n  }\n\n  const resolved = resolve(filePath);\n  const normalized = normalizePath(resolved);\n\n  // Create a 2-part ID: {absPath}::{astPath}\n  // astPath uniquely identifies the definition's location in the AST (e.g., \"MyComponent.useQuery.def\")\n  const idParts = [normalized, astPath];\n\n  return idParts.join(canonicalIdSeparator) as CanonicalId;\n};\n\n/**\n * Parse a canonical ID into its components.\n * @param canonicalId - The canonical ID to parse (e.g., \"/app/src/user.ts::userFragment\")\n * @returns An object with filePath and astPath\n */\nexport const parseCanonicalId = (\n  canonicalId: CanonicalId | string,\n): {\n  filePath: string;\n  astPath: string;\n} => {\n  const idx = canonicalId.indexOf(canonicalIdSeparator);\n  if (idx === -1) {\n    return { filePath: canonicalId, astPath: \"\" };\n  }\n  return {\n    filePath: canonicalId.slice(0, idx),\n    astPath: canonicalId.slice(idx + canonicalIdSeparator.length),\n  };\n};\n","/**\n * Canonical path tracker for AST traversal.\n *\n * This module provides a stateful helper that tracks scope information during\n * AST traversal to generate canonical IDs. It's designed to integrate with\n * existing plugin visitor patterns (Babel, SWC, TypeScript) without requiring\n * a separate AST traversal.\n *\n * Usage pattern:\n * 1. Plugin creates tracker at file/program entry\n * 2. Plugin calls enterScope/exitScope during its traversal\n * 3. Plugin calls registerDefinition when discovering GQL definitions\n * 4. Tracker provides canonical ID information\n */\n\nimport type { CanonicalId } from \"./canonical-id\";\nimport { createCanonicalId } from \"./canonical-id\";\n\n/**\n * Scope frame for tracking AST path segments\n */\nexport type ScopeFrame = {\n  /** Name segment (e.g., \"MyComponent\", \"useQuery\", \"arrow#1\") */\n  readonly nameSegment: string;\n  /** Kind of scope */\n  readonly kind: \"function\" | \"class\" | \"variable\" | \"property\" | \"method\" | \"expression\";\n  /** Occurrence index for disambiguation */\n  readonly occurrence: number;\n};\n\n/**\n * Opaque handle for scope tracking\n */\nexport type ScopeHandle = {\n  readonly __brand: \"ScopeHandle\";\n  readonly depth: number;\n};\n\n/**\n * Canonical path tracker interface\n */\nexport interface CanonicalPathTracker {\n  /**\n   * Enter a new scope during traversal\n   * @param options Scope information\n   * @returns Handle to use when exiting the scope\n   */\n  enterScope(options: { segment: string; kind: ScopeFrame[\"kind\"]; stableKey?: string }): ScopeHandle;\n\n  /**\n   * Exit a scope during traversal\n   * @param handle Handle returned from enterScope\n   */\n  exitScope(handle: ScopeHandle): void;\n\n  /**\n   * Register a definition discovered during traversal\n   * @returns Definition metadata including astPath and canonical ID information\n   */\n  registerDefinition(): {\n    astPath: string;\n    isTopLevel: boolean;\n    exportBinding?: string;\n  };\n\n  /**\n   * Resolve a canonical ID from an astPath\n   * @param astPath AST path string\n   * @returns Canonical ID\n   */\n  resolveCanonicalId(astPath: string): CanonicalId;\n\n  /**\n   * Register an export binding\n   * @param local Local variable name\n   * @param exported Exported name\n   */\n  registerExportBinding(local: string, exported: string): void;\n\n  /**\n   * Get current scope depth\n   * @returns Current depth (0 = top level)\n   */\n  currentDepth(): number;\n}\n\n/**\n * Build AST path from scope stack (internal helper)\n */\nconst _buildAstPath = (stack: readonly ScopeFrame[]): string => {\n  return stack.map((frame) => frame.nameSegment).join(\".\");\n};\n\n/**\n * Create a canonical path tracker\n *\n * @param options Configuration options\n * @returns Tracker instance\n *\n * @example\n * ```typescript\n * // In a Babel plugin\n * const tracker = createCanonicalTracker({ filePath: state.filename });\n *\n * const visitor = {\n *   FunctionDeclaration: {\n *     enter(path) {\n *       const handle = tracker.enterScope({\n *         segment: path.node.id.name,\n *         kind: 'function'\n *       });\n *     },\n *     exit(path) {\n *       tracker.exitScope(handle);\n *     }\n *   }\n * };\n * ```\n */\nexport const createCanonicalTracker = (options: {\n  filePath: string;\n  getExportName?: (localName: string) => string | undefined;\n}): CanonicalPathTracker => {\n  const { filePath, getExportName } = options;\n\n  // Scope stack\n  const scopeStack: ScopeFrame[] = [];\n\n  // Occurrence counters for disambiguating duplicate names\n  const occurrenceCounters = new Map<string, number>();\n\n  // Used paths for ensuring uniqueness\n  const usedPaths = new Set<string>();\n\n  // Export bindings map\n  const exportBindings = new Map<string, string>();\n\n  const getNextOccurrence = (key: string): number => {\n    const current = occurrenceCounters.get(key) ?? 0;\n    occurrenceCounters.set(key, current + 1);\n    return current;\n  };\n\n  const ensureUniquePath = (basePath: string): string => {\n    let path = basePath;\n    let suffix = 0;\n    while (usedPaths.has(path)) {\n      suffix++;\n      path = `${basePath}$${suffix}`;\n    }\n    usedPaths.add(path);\n    return path;\n  };\n\n  return {\n    enterScope({ segment, kind, stableKey }): ScopeHandle {\n      const key = stableKey ?? `${kind}:${segment}`;\n      const occurrence = getNextOccurrence(key);\n\n      const frame: ScopeFrame = {\n        nameSegment: segment,\n        kind,\n        occurrence,\n      };\n\n      scopeStack.push(frame);\n\n      return {\n        __brand: \"ScopeHandle\",\n        depth: scopeStack.length - 1,\n      } as ScopeHandle;\n    },\n\n    exitScope(handle: ScopeHandle): void {\n      // Validate handle depth matches current stack\n      if (handle.depth !== scopeStack.length - 1) {\n        throw new Error(`[INTERNAL] Invalid scope exit: expected depth ${scopeStack.length - 1}, got ${handle.depth}`);\n      }\n      scopeStack.pop();\n    },\n\n    registerDefinition(): {\n      astPath: string;\n      isTopLevel: boolean;\n      exportBinding?: string;\n    } {\n      const basePath = _buildAstPath(scopeStack);\n      const astPath = ensureUniquePath(basePath);\n      const isTopLevel = scopeStack.length === 0;\n\n      // Check export binding if provided\n      let exportBinding: string | undefined;\n      if (getExportName && isTopLevel) {\n        // For top-level definitions, try to get export name\n        // This is a simplified version - real logic depends on how the definition is bound\n        exportBinding = undefined;\n      }\n\n      return {\n        astPath,\n        isTopLevel,\n        exportBinding,\n      };\n    },\n\n    resolveCanonicalId(astPath: string): CanonicalId {\n      return createCanonicalId(filePath, astPath);\n    },\n\n    registerExportBinding(local: string, exported: string): void {\n      exportBindings.set(local, exported);\n    },\n\n    currentDepth(): number {\n      return scopeStack.length;\n    },\n  };\n};\n\n/**\n * Helper to create occurrence tracker (for backward compatibility)\n */\nexport const createOccurrenceTracker = (): {\n  getNextOccurrence: (key: string) => number;\n} => {\n  const occurrenceCounters = new Map<string, number>();\n\n  return {\n    getNextOccurrence(key: string): number {\n      const current = occurrenceCounters.get(key) ?? 0;\n      occurrenceCounters.set(key, current + 1);\n      return current;\n    },\n  };\n};\n\n/**\n * Helper to create path tracker (for backward compatibility)\n */\nexport const createPathTracker = (): {\n  ensureUniquePath: (basePath: string) => string;\n} => {\n  const usedPaths = new Set<string>();\n\n  return {\n    ensureUniquePath(basePath: string): string {\n      let path = basePath;\n      let suffix = 0;\n      while (usedPaths.has(path)) {\n        suffix++;\n        path = `${basePath}$${suffix}`;\n      }\n      usedPaths.add(path);\n      return path;\n    },\n  };\n};\n\n/**\n * Build AST path from scope stack (for backward compatibility)\n */\nexport const buildAstPath = (stack: readonly ScopeFrame[]): string => {\n  return stack.map((frame) => frame.nameSegment).join(\".\");\n};\n"],"mappings":"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"}

package/dist/index-B424kKYS.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-B424kKYS.d.mts","names":[],"sources":["../src/portable/fs.ts","../src/portable/hash.ts","../src/portable/id.ts","../src/portable/runtime.ts","../src/portable/spawn.ts"],"sourcesContent":[],"mappings":";;AAMA;;AAE4C,UAF3B,UAAA,CAE2B;EAKM,QAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EANxB,OAMwB,CAAA,MAAA,CAAA;EAC1B,SAAA,CAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA,CAAA,EANoB,OAMpB,CAAA,IAAA,CAAA;EACe;;;;EAWf,eAAA,CAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA,CAAA,EAb0B,OAa1B,CAAA,IAAA,CAAA;EAAO,MAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EAZP,OAYO,CAAA,OAAA,CAAA;EAmEf,IAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EA9EM,OA8EU,CAAA;IA2OhB,KAAA,EAzTuB,IAyTvB;IAWA,IAAA,EAAA,MAAA;;4CAnU4B;6BCR3B;IAFL,SAAA,CAAA,EAAa,OAAA;EAER,CAAA,CAAA,EDSyC,OCTzC,CAAA,IAAA,CAAc;EAWf;AAqChB;AAWA;;;;ACzDA;;wBFgBwB;;AGtBxB;AASA;EAiBgB,UAAA,CAAA,IAAA,EAAA,MAAA,CAAqB,EAAA,IAAA;;;;ECxBpB,YAAA,CAAA,IAAY,EAAA,MAAA,CAAA,EAGrB,MAAM;AAGd;AAMsB,iBJ2EN,gBAAA,CAAA,CI3EW,EJ2ES,UI3ET;AAAU,iBJsTrB,aAAA,CAAA,CItTqB,EJsTJ,UItTI;;;;;iBJiUrB,yBAAA,CAAA;;;;AA7UhB;;AAE4C,KCFhC,aAAA,GDEgC,QAAA,GAAA,QAAA;AAKM,UCLjC,cAAA,CDKiC;EAC1B,IAAA,CAAA,OAAA,EAAA,MAAA,EAAA,SAAA,CAAA,ECLY,aDKZ,CAAA,EAAA,MAAA;;AACF,iBCIN,oBAAA,CAAA,CDJM,ECIkB,cDJlB;AACsB,iBCwC5B,iBAAA,CAAA,CDxC4B,ECwCP,cDxCO;;;;AA6E5C;AA2OgB,iBCrQA,6BAAA,CAAA,CDqQ2B,EAAA,IAAA;;;;AAlU3C;;;;;;AASsB,iBELN,UAAA,CAAA,CFKM,EAAA,MAAA;;;;AATtB;;AAE4C,cGJ/B,OHI+B,EAAA;EAKM,SAAA,KAAA,EAAA,OAAA;EAC1B,SAAA,MAAA,EAAA,OAAA;EACe,SAAA,iBAAA,EAAA,OAAA;CAAjB;;;;AAWS,iBGbf,IHae,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,GAAA,GGbG,CHaH,CAAA,EAAA,GAAA,GGba,CHab;AAmE/B;AA2OA;AAWA;;iBGrTgB,qBAAA,CAAA;;;;AHxBhB;;AAE4C,UIF3B,YAAA,CJE2B;EAKM,GAAA,EAAA,MAAA,EAAA;EAC1B,GAAA,CAAA,EAAA,MAAA;EACe,GAAA,CAAA,EIN/B,MJM+B,CAAA,MAAA,EAAA,MAAA,CAAA;;AACK,UIJ3B,WAAA,CJI2B;EACc,MAAA,EAAA,MAAA;EASlC,MAAA,EAAA,MAAA;EAAO,QAAA,EAAA,MAAA;AAmE/B;AA2OgB,iBItTM,KAAA,CJsTO,OAAI,EItTI,YJsTM,CAAA,EItTS,OJsTT,CItTiB,WJsTjB,CAAA"}

package/dist/index-CPpVc8Id.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-CPpVc8Id.d.mts","names":[],"sources":["../src/canonical-id/canonical-id.ts","../src/canonical-id/path-tracker.ts"],"sourcesContent":[],"mappings":";;;KAIY,WAAA;;AAAZ,CAAA;AAIa,cAAA,iBAA6B,EAAV,GAAA,CAAE,OAAF,CAAU,WAAD,CAAA;AAG5B,cAAA,iBAAyD,EAAA,CAAA,QAarE,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA,EAAA,GAbqE,WAarE;AAOD;;;;ACVA;AAYY,cDFC,gBCEU,EAAA,CAAA,WAAA,EDDR,WCCQ,GAAA,MAAA,EAAA,GAAA;EAQN,QAAA,EAAA,MAAA;EAM8B,OAAA,EAAA,MAAA;CAA2C;;;;;;;AAwE7E,KAlGD,UAAA,GAkGC;EAuGA;EAiBA,SAAA,WAiBZ,EAAA,MAAA;EAKY;;;;;;;;KApOD,WAAA;;;;;;;UAQK,oBAAA;;;;;;;;UAM8B;;MAA2C;;;;;oBAMtE;;;;;;;;;;;;;;;uCAiBmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAiD1B;;;MAGT;;;;cAoGS;;;;;;cAiBA;;;;;;cAsBA,+BAAgC"}

package/dist/index-Cm2Zwk9m.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-Cm2Zwk9m.d.cts","names":[],"sources":["../src/canonical-id/canonical-id.ts","../src/canonical-id/path-tracker.ts"],"sourcesContent":[],"mappings":";;;KAIY,WAAA;;AAAZ,CAAA;AAIa,cAAA,iBAA6B,EAAV,GAAA,CAAE,OAAF,CAAU,WAAD,CAAA;AAG5B,cAAA,iBAAyD,EAAA,CAAA,QAarE,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA,EAAA,GAbqE,WAarE;AAOD;;;;ACVA;AAYY,cDFC,gBCEU,EAAA,CAAA,WAAA,EDDR,WCCQ,GAAA,MAAA,EAAA,GAAA;EAQN,QAAA,EAAA,MAAA;EAM8B,OAAA,EAAA,MAAA;CAA2C;;;;;;;AAwE7E,KAlGD,UAAA,GAkGC;EAuGA;EAiBA,SAAA,WAiBZ,EAAA,MAAA;EAKY;;;;;;;;KApOD,WAAA;;;;;;;UAQK,oBAAA;;;;;;;;UAM8B;;MAA2C;;;;;oBAMtE;;;;;;;;;;;;;;;uCAiBmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAiD1B;;;MAGT;;;;cAoGS;;;;;;cAiBA;;;;;;cAsBA,+BAAgC"}

package/dist/index-D1tzB3W5.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-D1tzB3W5.d.cts","names":[],"sources":["../src/portable/fs.ts","../src/portable/hash.ts","../src/portable/id.ts","../src/portable/runtime.ts","../src/portable/spawn.ts"],"sourcesContent":[],"mappings":";;AAMA;;AAE4C,UAF3B,UAAA,CAE2B;EAKM,QAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EANxB,OAMwB,CAAA,MAAA,CAAA;EAC1B,SAAA,CAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA,CAAA,EANoB,OAMpB,CAAA,IAAA,CAAA;EACe;;;;EAWf,eAAA,CAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA,CAAA,EAb0B,OAa1B,CAAA,IAAA,CAAA;EAAO,MAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EAZP,OAYO,CAAA,OAAA,CAAA;EAmEf,IAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EA9EM,OA8EU,CAAA;IA2OhB,KAAA,EAzTuB,IAyTvB;IAWA,IAAA,EAAA,MAAA;;4CAnU4B;6BCR3B;IAFL,SAAA,CAAA,EAAa,OAAA;EAER,CAAA,CAAA,EDSyC,OCTzC,CAAA,IAAA,CAAc;EAWf;AAqChB;AAWA;;;;ACzDA;;wBFgBwB;;AGtBxB;AASA;EAiBgB,UAAA,CAAA,IAAA,EAAA,MAAA,CAAqB,EAAA,IAAA;;;;ECxBpB,YAAA,CAAA,IAAY,EAAA,MAAA,CAAA,EAGrB,MAAM;AAGd;AAMsB,iBJ2EN,gBAAA,CAAA,CI3EW,EJ2ES,UI3ET;AAAU,iBJsTrB,aAAA,CAAA,CItTqB,EJsTJ,UItTI;;;;;iBJiUrB,yBAAA,CAAA;;;;AA7UhB;;AAE4C,KCFhC,aAAA,GDEgC,QAAA,GAAA,QAAA;AAKM,UCLjC,cAAA,CDKiC;EAC1B,IAAA,CAAA,OAAA,EAAA,MAAA,EAAA,SAAA,CAAA,ECLY,aDKZ,CAAA,EAAA,MAAA;;AACF,iBCIN,oBAAA,CAAA,CDJM,ECIkB,cDJlB;AACsB,iBCwC5B,iBAAA,CAAA,CDxC4B,ECwCP,cDxCO;;;;AA6E5C;AA2OgB,iBCrQA,6BAAA,CAAA,CDqQ2B,EAAA,IAAA;;;;AAlU3C;;;;;;AASsB,iBELN,UAAA,CAAA,CFKM,EAAA,MAAA;;;;AATtB;;AAE4C,cGJ/B,OHI+B,EAAA;EAKM,SAAA,KAAA,EAAA,OAAA;EAC1B,SAAA,MAAA,EAAA,OAAA;EACe,SAAA,iBAAA,EAAA,OAAA;CAAjB;;;;AAWS,iBGbf,IHae,CAAA,CAAA,CAAA,CAAA,EAAA,EAAA,GAAA,GGbG,CHaH,CAAA,EAAA,GAAA,GGba,CHab;AAmE/B;AA2OA;AAWA;;iBGrTgB,qBAAA,CAAA;;;;AHxBhB;;AAE4C,UIF3B,YAAA,CJE2B;EAKM,GAAA,EAAA,MAAA,EAAA;EAC1B,GAAA,CAAA,EAAA,MAAA;EACe,GAAA,CAAA,EIN/B,MJM+B,CAAA,MAAA,EAAA,MAAA,CAAA;;AACK,UIJ3B,WAAA,CJI2B;EACc,MAAA,EAAA,MAAA;EASlC,MAAA,EAAA,MAAA;EAAO,QAAA,EAAA,MAAA;AAmE/B;AA2OgB,iBItTM,KAAA,CJsTO,OAAI,EItTI,YJsTM,CAAA,EItTS,OJsTT,CItTiB,WJsTjB,CAAA"}

package/dist/index-Dv8spPt0.d.mts

@@ -1,61 +0,0 @@
-//#region packages/common/src/utils/cached-fn.d.ts
-declare const cachedFn: <T>(fn: () => T) => {
-  (): T;
-  clear(): void;
-};
-//#endregion
-//#region packages/common/src/utils/path.d.ts
-/**
- * File extensions to try when resolving module specifiers.
- * Ordered to match TypeScript's module resolution order.
- * @see https://www.typescriptlang.org/docs/handbook/module-resolution.html
- */
-declare const MODULE_EXTENSION_CANDIDATES: readonly [".ts", ".tsx", ".mts", ".cts", ".js", ".mjs", ".cjs", ".jsx"];
-/**
- * Normalize path to use forward slashes (cross-platform).
- * Ensures consistent path handling across platforms.
- */
-declare const normalizePath: (value: string) => string;
-/**
- * Resolve a relative import specifier to an absolute file path.
- * Tries the specifier as-is, with extensions, and as a directory with index files.
- *
- * @param from - Absolute path to the importing file
- * @param specifier - Relative module specifier (must start with '.')
- * @returns Absolute POSIX path to the resolved file, or null if not found
- */
-declare const resolveRelativeImportWithExistenceCheck: ({
-  filePath,
-  specifier
-}: {
-  filePath: string;
-  specifier: string;
-}) => string | null;
-/**
- * Resolve a relative import specifier to an absolute file path.
- * Tries the specifier as-is, with extensions, and as a directory with index files.
- *
- * @param from - Absolute path to the importing file
- * @param specifier - Relative module specifier (must start with '.')
- * @returns Absolute POSIX path to the resolved file, or null if not found
- */
-declare const resolveRelativeImportWithReferences: <_>({
-  filePath,
-  specifier,
-  references
-}: {
-  filePath: string;
-  specifier: string;
-  references: Map<string, _> | Set<string>;
-}) => string | null;
-/**
- * Check if a module specifier is relative (starts with '.' or '..')
- */
-declare const isRelativeSpecifier: (specifier: string) => boolean;
-/**
- * Check if a module specifier is external (package name, not relative)
- */
-declare const isExternalSpecifier: (specifier: string) => boolean;
-//#endregion
-export { resolveRelativeImportWithExistenceCheck as a, normalizePath as i, isExternalSpecifier as n, resolveRelativeImportWithReferences as o, isRelativeSpecifier as r, cachedFn as s, MODULE_EXTENSION_CANDIDATES as t };
-//# sourceMappingURL=index-Dv8spPt0.d.mts.map

package/dist/index-Dv8spPt0.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-Dv8spPt0.d.mts","names":[],"sources":["../src/utils/cached-fn.ts","../src/utils/path.ts"],"sourcesContent":[],"mappings":";cAAa,wBAAyB;EAAzB,EAAA,EAAyB,CAAzB;;;;;;AAAb;;;;ACQa,cAAA,2BAAqG,EAAA,SAAA,CAAA,KAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,KAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA;AAMlH;AAUA;AAkDA;;AAAuD,cA5D1C,aA4D0C,EAAA,CAAA,KAAA,EAAA,MAAA,EAAA,GAAA,MAAA;;;;;;AAsCvD;AAKA;;cA7Fa;;;;;;;;;;;;;;;cAkDA;;;;;;;cAOC,YAAY,KAAK;;;;;cA+BlB;;;;cAKA"}