@generaltranslation/vue-extractor 0.0.0

package/dist/internal/vueCompiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vueCompiler.js","names":[],"sources":["../../src/internal/vueCompiler.ts"],"sourcesContent":["import { createRequire } from 'node:module';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport type { parse as parseVueTemplate } from '@vue/compiler-dom';\nimport type * as VueCompilerModule from '@vue/compiler-sfc';\nimport type { TemplateCompiler } from '@vue/compiler-sfc';\nimport type { VueCompiler } from '../types.js';\n\n/** Whitespace test used by Vue when it constructs an implicit default slot. */\nexport type ImplicitSlotWhitespace = 'ecmascript' | 'html';\n\nexport type ResolvedVueCompiler = {\n  compiler: ExactVueCompiler;\n  implicitSlotWhitespace: ImplicitSlotWhitespace;\n  parseTemplate?: typeof parseVueTemplate;\n  templateCompiler?: TemplateCompiler;\n  templateParseOptionsSupported: boolean;\n  version: string;\n};\n\ntype CompilerResolution =\n  | { ok: true; value: ResolvedVueCompiler }\n  | { ok: false; details: string };\n\nconst resolvedCompilers = new Map<string, CompilerResolution>();\nconst inspectedCompilers = new WeakMap<object, CompilerResolution>();\n\ntype ExactVueCompiler = Pick<\n  typeof VueCompilerModule,\n  'compileTemplate' | 'parse' | 'version'\n> & {\n  parseTemplate?: typeof parseVueTemplate;\n};\n\n/**\n * Resolves the exact Vue compiler selected by the consuming source file.\n *\n * The `vue/compiler-sfc` export is version-locked to that installation's Vue\n * runtime. Resolving from the SFC first is important in workspaces where apps\n * intentionally use different Vue versions.\n */\nexport function resolveVueCompiler(\n  file: string,\n  projectRoot: string\n): CompilerResolution {\n  const absoluteFile = path.isAbsolute(file)\n    ? file\n    : path.resolve(projectRoot, file);\n  const anchors = [absoluteFile, path.join(projectRoot, 'package.json')];\n\n  for (const anchor of anchors) {\n    const requireFromConsumer = createRequire(anchor);\n    let vueManifestPath: string;\n    try {\n      vueManifestPath = requireFromConsumer.resolve('vue/package.json');\n    } catch (error) {\n      if (isMissingModule(error)) continue;\n      return {\n        ok: false,\n        details: formatResolutionError(error),\n      };\n    }\n\n    let compilerPath: string;\n    try {\n      compilerPath = requireFromConsumer.resolve('vue/compiler-sfc');\n    } catch (error) {\n      return {\n        ok: false,\n        details: `Resolved the app's Vue package at ${vueManifestPath}, but its compiler-sfc export could not be loaded: ${formatResolutionError(error)}`,\n      };\n    }\n\n    const cached = resolvedCompilers.get(compilerPath);\n    if (cached) return cached;\n\n    const resolution = loadCompiler(\n      requireFromConsumer,\n      compilerPath,\n      vueManifestPath,\n      readVueVersion(requireFromConsumer, vueManifestPath)\n    );\n    resolvedCompilers.set(compilerPath, resolution);\n    return resolution;\n  }\n\n  const declaredVersion = findDeclaredVueVersion(absoluteFile, projectRoot);\n  if (declaredVersion) {\n    return {\n      ok: false,\n      details: `The project declares Vue ${JSON.stringify(declaredVersion)} but vue/compiler-sfc could not be resolved from ${absoluteFile}.`,\n    };\n  }\n\n  return {\n    ok: false,\n    details: `Could not resolve vue/compiler-sfc from ${absoluteFile}.`,\n  };\n}\n\n/** Validates an explicitly supplied compiler before extraction uses it. */\nexport function inspectVueCompiler(compiler: VueCompiler): CompilerResolution {\n  if (!compiler || typeof compiler !== 'object') {\n    return {\n      ok: false,\n      details: 'The supplied Vue compiler is not an object.',\n    };\n  }\n  const cached = inspectedCompilers.get(compiler);\n  if (cached) return cached;\n  const exactCompiler = compiler as ExactVueCompiler;\n  const resolution = isVueCompiler(compiler)\n    ? inspectCompiler(exactCompiler, exactCompiler.parseTemplate)\n    : {\n        ok: false as const,\n        details:\n          'The supplied object does not expose the Vue compiler-sfc API.',\n      };\n  inspectedCompilers.set(compiler, resolution);\n  return resolution;\n}\n\nfunction loadCompiler(\n  requireFromConsumer: NodeRequire,\n  compilerPath: string,\n  vueManifestPath: string,\n  vueVersion: string | undefined\n): CompilerResolution {\n  try {\n    const loaded = requireFromConsumer(compilerPath) as unknown;\n    const defaultExport = readDefaultExport(loaded);\n    const compiler = isVueCompiler(loaded)\n      ? (loaded as ExactVueCompiler)\n      : isVueCompiler(defaultExport)\n        ? (defaultExport as ExactVueCompiler)\n        : undefined;\n    if (!compiler) {\n      return {\n        ok: false,\n        details: `The module at ${compilerPath} does not expose the Vue compiler-sfc API.`,\n      };\n    }\n    if (vueVersion && compiler.version !== vueVersion) {\n      return {\n        ok: false,\n        details: `The app resolves Vue ${vueVersion} but vue/compiler-sfc ${compiler.version}. Install one matching Vue package version.`,\n      };\n    }\n    if (!isSupportedVueVersion(compiler.version)) {\n      return {\n        ok: false,\n        details: `Resolved Vue compiler version ${JSON.stringify(compiler.version)}; gt-vue supports Vue 3.3 through Vue 3.x.`,\n      };\n    }\n    const requireFromCompiler = createRequire(compilerPath);\n    const compilerDomPath = requireFromCompiler.resolve('@vue/compiler-dom');\n    const compilerDom = requireFromCompiler(compilerDomPath) as {\n      compile?: TemplateCompiler['compile'];\n      parse?: typeof parseVueTemplate;\n    };\n    const compilerDomVersion = readVueVersion(\n      requireFromCompiler,\n      requireFromCompiler.resolve('@vue/compiler-dom/package.json')\n    );\n    if (compilerDomVersion !== compiler.version) {\n      return {\n        ok: false,\n        details: `vue/compiler-sfc ${compiler.version} resolves @vue/compiler-dom ${String(compilerDomVersion)}. Install matching Vue compiler packages.`,\n      };\n    }\n    if (typeof compilerDom.parse !== 'function') {\n      return {\n        ok: false,\n        details: `The template compiler at ${compilerDomPath} does not expose parse().`,\n      };\n    }\n    if (typeof compilerDom.compile !== 'function') {\n      return {\n        ok: false,\n        details: `The template compiler at ${compilerDomPath} does not expose compile().`,\n      };\n    }\n    return inspectCompiler(compiler, compilerDom.parse, {\n      compile: compilerDom.compile,\n      parse: compilerDom.parse,\n    });\n  } catch (error) {\n    const bunResolution = loadBunCompiler(\n      requireFromConsumer,\n      vueManifestPath,\n      vueVersion\n    );\n    if (bunResolution) return bunResolution;\n    return { ok: false, details: formatResolutionError(error) };\n  }\n}\n\n/** Loads exact, self-contained Vue browser compilers in a compiled Bun CLI. */\nfunction loadBunCompiler(\n  requireFromConsumer: NodeRequire,\n  vueManifestPath: string,\n  vueVersion: string | undefined\n): CompilerResolution | undefined {\n  if (typeof process.versions.bun !== 'string') return undefined;\n\n  try {\n    const compilerSfcRoot = findInstalledPackageRoot(\n      vueManifestPath,\n      '@vue/compiler-sfc'\n    );\n    const compilerDomRoot = findInstalledPackageRoot(\n      vueManifestPath,\n      '@vue/compiler-dom'\n    );\n    if (!compilerSfcRoot || !compilerDomRoot) {\n      return {\n        ok: false,\n        details:\n          'The Vue installation does not contain its compiler-sfc and compiler-dom dependencies.',\n      };\n    }\n\n    const compilerPath = path.join(\n      compilerSfcRoot,\n      'dist/compiler-sfc.esm-browser.js'\n    );\n    const compilerDomPath = path.join(\n      compilerDomRoot,\n      'dist/compiler-dom.esm-browser.js'\n    );\n    const loaded = requireFromConsumer(compilerPath) as unknown;\n    const defaultExport = readDefaultExport(loaded);\n    const compiler = isVueCompiler(loaded)\n      ? (loaded as ExactVueCompiler)\n      : isVueCompiler(defaultExport)\n        ? (defaultExport as ExactVueCompiler)\n        : undefined;\n    if (!compiler) {\n      return {\n        ok: false,\n        details: `The module at ${compilerPath} does not expose the Vue compiler-sfc API.`,\n      };\n    }\n    if (vueVersion && compiler.version !== vueVersion) {\n      return {\n        ok: false,\n        details: `The app resolves Vue ${vueVersion} but vue/compiler-sfc ${compiler.version}. Install one matching Vue package version.`,\n      };\n    }\n    if (!isSupportedVueVersion(compiler.version)) {\n      return {\n        ok: false,\n        details: `Resolved Vue compiler version ${JSON.stringify(compiler.version)}; gt-vue supports Vue 3.3 through Vue 3.x.`,\n      };\n    }\n\n    const compilerDom = requireFromConsumer(compilerDomPath) as {\n      compile?: TemplateCompiler['compile'];\n      parse?: typeof parseVueTemplate;\n    };\n    const compilerDomVersion = readPackageVersion(compilerDomRoot);\n    if (compilerDomVersion !== compiler.version) {\n      return {\n        ok: false,\n        details: `vue/compiler-sfc ${compiler.version} resolves @vue/compiler-dom ${String(compilerDomVersion)}. Install matching Vue compiler packages.`,\n      };\n    }\n    if (typeof compilerDom.parse !== 'function') {\n      return {\n        ok: false,\n        details: `The template compiler at ${compilerDomPath} does not expose parse().`,\n      };\n    }\n    if (typeof compilerDom.compile !== 'function') {\n      return {\n        ok: false,\n        details: `The template compiler at ${compilerDomPath} does not expose compile().`,\n      };\n    }\n    return inspectCompiler(compiler, compilerDom.parse, {\n      compile: compilerDom.compile,\n      parse: compilerDom.parse,\n    });\n  } catch (error) {\n    return { ok: false, details: formatResolutionError(error) };\n  }\n}\n\n/** Finds one dependency relative to the physical Vue installation on disk. */\nfunction findInstalledPackageRoot(\n  vueManifestPath: string,\n  packageName: string\n): string | undefined {\n  const packageSegments = packageName.split('/');\n  let directory = path.dirname(vueManifestPath);\n  while (true) {\n    const candidate =\n      path.basename(directory) === 'node_modules'\n        ? path.join(directory, ...packageSegments)\n        : path.join(directory, 'node_modules', ...packageSegments);\n    if (fs.existsSync(path.join(candidate, 'package.json'))) return candidate;\n    const parent = path.dirname(directory);\n    if (parent === directory) return undefined;\n    directory = parent;\n  }\n}\n\nfunction readPackageVersion(packageRoot: string): string | undefined {\n  try {\n    const manifest = JSON.parse(\n      fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8')\n    ) as { version?: unknown };\n    return typeof manifest.version === 'string' ? manifest.version : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction readVueVersion(\n  requireFromConsumer: NodeRequire,\n  manifestPath: string\n): string | undefined {\n  try {\n    const manifest = requireFromConsumer(manifestPath) as { version?: unknown };\n    return typeof manifest.version === 'string' ? manifest.version : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Finds an installed-but-missing declaration that bundled fallback could hide. */\nfunction findDeclaredVueVersion(\n  absoluteFile: string,\n  projectRoot: string\n): string | undefined {\n  const stop = path.resolve(projectRoot);\n  let directory = path.dirname(absoluteFile);\n  while (true) {\n    const version = readDeclaredVueVersion(\n      path.join(directory, 'package.json')\n    );\n    if (version) return version;\n    if (directory === stop || directory === path.dirname(directory)) break;\n    directory = path.dirname(directory);\n  }\n  return readDeclaredVueVersion(path.join(stop, 'package.json'));\n}\n\nfunction readDeclaredVueVersion(manifestPath: string): string | undefined {\n  try {\n    const manifest = JSON.parse(\n      fs.readFileSync(manifestPath, 'utf8')\n    ) as Record<string, unknown>;\n    for (const section of [\n      'dependencies',\n      'devDependencies',\n      'peerDependencies',\n      'optionalDependencies',\n    ]) {\n      const dependencies = manifest[section];\n      if (\n        dependencies &&\n        typeof dependencies === 'object' &&\n        'vue' in dependencies\n      ) {\n        const version = (dependencies as Record<string, unknown>).vue;\n        return typeof version === 'string' ? version : 'an unknown version';\n      }\n    }\n  } catch (error) {\n    if (\n      !error ||\n      typeof error !== 'object' ||\n      !('code' in error) ||\n      error.code !== 'ENOENT'\n    ) {\n      throw error;\n    }\n  }\n  return undefined;\n}\n\nfunction inspectCompiler(\n  compiler: ExactVueCompiler,\n  parseTemplate?: typeof parseVueTemplate,\n  templateCompiler?: TemplateCompiler\n): CompilerResolution {\n  const version = compiler.version;\n  if (!isSupportedVueVersion(version)) {\n    return {\n      ok: false,\n      details: `Resolved Vue compiler version ${JSON.stringify(version)}; gt-vue supports Vue 3.3 through Vue 3.x.`,\n    };\n  }\n\n  try {\n    const templateParseOptionsSupported =\n      supportsTemplateParseOptions(compiler);\n    if (!parseTemplate && !templateParseOptionsSupported) {\n      return {\n        ok: false,\n        details:\n          'The supplied compiler does not expose exact template parser options. Let the extractor resolve vue/compiler-sfc from the consuming app instead.',\n      };\n    }\n    return {\n      ok: true,\n      value: {\n        compiler,\n        implicitSlotWhitespace: detectImplicitSlotWhitespace(compiler),\n        parseTemplate,\n        templateCompiler,\n        templateParseOptionsSupported,\n        version,\n      },\n    };\n  } catch (error) {\n    return { ok: false, details: formatResolutionError(error) };\n  }\n}\n\n/** Detects the SFC parser option added after Vue 3.4. */\nfunction supportsTemplateParseOptions(compiler: ExactVueCompiler): boolean {\n  const source = '<template><Probe>First\\n  second</Probe></template>';\n  const parseText = (whitespace: 'condense' | 'preserve') => {\n    const result = compiler.parse(source, {\n      templateParseOptions: { whitespace },\n    });\n    return collectText(result.descriptor.template?.ast);\n  };\n  return parseText('condense') !== parseText('preserve');\n}\n\nfunction collectText(value: unknown): string {\n  if (!value || typeof value !== 'object') return '';\n  let output = '';\n  if ('type' in value && value.type === 2 && 'content' in value) {\n    output += String(value.content);\n  }\n  if ('children' in value && Array.isArray(value.children)) {\n    for (const child of value.children) output += collectText(child);\n  }\n  return output;\n}\n\n/**\n * Detects the compiler's slot-whitespace semantics instead of inferring them\n * from a semver range. Vue 3.3/3.4 use ECMAScript `trim()`, while Vue 3.5 uses\n * the HTML parser's ASCII whitespace set. A behavior probe remains exact if a\n * later Vue 3.x release backports or revises that implementation.\n */\nfunction detectImplicitSlotWhitespace(\n  compiler: ExactVueCompiler\n): ImplicitSlotWhitespace {\n  const result = compiler.compileTemplate({\n    filename: 'gt-vue-compiler-probe.vue',\n    id: 'gt-vue-compiler-probe',\n    source: '<Probe><template #named>x</template>&nbsp;</Probe>',\n  });\n  if (result.errors.length > 0) {\n    throw new Error(\n      `The Vue compiler compatibility probe failed: ${result.errors.map(String).join('; ')}`\n    );\n  }\n\n  const component = result.ast?.children.find(\n    (node) =>\n      typeof node === 'object' &&\n      node !== null &&\n      'tag' in node &&\n      node.tag === 'Probe'\n  );\n  const codegen =\n    component && 'codegenNode' in component ? component.codegenNode : undefined;\n  const children =\n    codegen &&\n    typeof codegen === 'object' &&\n    'children' in codegen &&\n    codegen.children &&\n    typeof codegen.children === 'object'\n      ? codegen.children\n      : undefined;\n  const properties =\n    children && 'properties' in children && Array.isArray(children.properties)\n      ? children.properties\n      : undefined;\n  if (!properties) {\n    throw new Error(\n      'The Vue compiler compatibility probe returned an unknown slot AST.'\n    );\n  }\n\n  const hasImplicitDefault = properties.some((property) => {\n    if (!property || typeof property !== 'object' || !('key' in property)) {\n      return false;\n    }\n    const key = property.key;\n    return (\n      key != null &&\n      typeof key === 'object' &&\n      'content' in key &&\n      key.content === 'default'\n    );\n  });\n  return hasImplicitDefault ? 'html' : 'ecmascript';\n}\n\nfunction isVueCompiler(value: unknown): value is VueCompiler {\n  if (!value || typeof value !== 'object') return false;\n  return (\n    'compileTemplate' in value &&\n    typeof value.compileTemplate === 'function' &&\n    'parse' in value &&\n    typeof value.parse === 'function' &&\n    'version' in value &&\n    typeof value.version === 'string'\n  );\n}\n\n/** Reads a possible CommonJS-interoperability default export. */\nfunction readDefaultExport(value: unknown): unknown {\n  return value && typeof value === 'object' && 'default' in value\n    ? value.default\n    : undefined;\n}\n\nfunction isSupportedVueVersion(version: string): boolean {\n  const match = /^(\\d+)\\.(\\d+)(?:\\.|$)/.exec(version);\n  if (!match) return false;\n  const major = Number(match[1]);\n  const minor = Number(match[2]);\n  return major === 3 && minor >= 3;\n}\n\nfunction isMissingModule(error: unknown): boolean {\n  return (\n    !!error &&\n    typeof error === 'object' &&\n    'code' in error &&\n    error.code === 'MODULE_NOT_FOUND'\n  );\n}\n\nfunction formatResolutionError(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n"],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,80 @@
+import type { JsxChildren } from '@generaltranslation/format/types';
+/**
+ * Version-neutral Vue compiler surface accepted by programmatic extraction.
+ *
+ * Vue's compiler AST types are nominally incompatible across even patch
+ * releases. Keeping the callable members opaque lets an app pass its exact
+ * `vue/compiler-sfc` module while runtime validation protects the boundary.
+ */
+export type VueCompiler = {
+    /** Compiles one Vue SFC template. */
+    compileTemplate: (...args: never[]) => unknown;
+    /** Parses one Vue single-file component. */
+    parse: (...args: never[]) => unknown;
+    /** Optional exact compiler-dom parser for older Vue 3 releases. */
+    parseTemplate?: (...args: never[]) => unknown;
+    /** Exact Vue compiler release. */
+    version: string;
+};
+/** Vue template compiler options that can change extracted source hashes. */
+export type VueCompilerOptions = {
+    /** Controls how Vue normalizes whitespace between template children. */
+    whitespace?: 'condense' | 'preserve';
+    /** Replaces Vue's default `{{` and `}}` interpolation delimiters. */
+    delimiters?: [string, string];
+};
+/** Source lines captured around an extracted translation. */
+export type VueSourceCode = {
+    before: string;
+    target: string;
+    after: string;
+};
+/** Metadata attached to an extracted Vue translation. */
+export type VueExtractionMetadata = {
+    context?: string;
+    filePaths?: string[];
+    sourceCode?: Record<string, VueSourceCode[]>;
+};
+/** A translation extracted from Vue source code before CLI post-processing. */
+export type VueExtractionResult = {
+    dataFormat: 'JSX';
+    source: JsxChildren;
+    metadata: VueExtractionMetadata;
+} | {
+    dataFormat: 'STRING';
+    source: string;
+    metadata: VueExtractionMetadata;
+};
+/** Options that control extraction from one Vue source file. */
+export type VueExtractionOptions = {
+    /** Exact compiler used by the consuming Vue application. */
+    compiler?: VueCompiler;
+    /** Vue compiler options used by the consuming application. */
+    compilerOptions?: VueCompilerOptions;
+    /** Includes surrounding source lines in result metadata. */
+    includeSourceCodeContext?: boolean;
+    /** Root used to make metadata file paths relative. Defaults to `process.cwd()`. */
+    projectRoot?: string;
+    /**
+     * Resolves a static module specifier to a source file without loading or
+     * executing that module. Relative source files and index barrels are
+     * resolved automatically; provide this hook for aliases or workspace
+     * package exports that use application-specific resolution rules.
+     *
+     * The hook is consulted first for every specifier, including relative ones,
+     * so a project can preserve its compiler's source-over-build precedence.
+     *
+     * Returning `undefined` leaves the import unresolved and makes GT-shaped
+     * uses fail closed. The returned path must identify a readable local source
+     * file.
+     */
+    resolveModule?: (specifier: string, importer: string) => string | undefined;
+    /** Number of source lines captured before and after a translation. */
+    surroundingLineCount?: number;
+};
+/** Extraction output for one Vue single-file component or script. */
+export type VueExtractionOutput = {
+    results: VueExtractionResult[];
+    errors: string[];
+    warnings: string[];
+};

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@generaltranslation/vue-extractor",
+  "version": "0.0.0",
+  "description": "Vue source code extraction for General Translation",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "sideEffects": false,
+  "imports": {
+    "#vue-compiler-sfc": {
+      "bun": "@vue/compiler-sfc/dist/compiler-sfc.esm-browser.js",
+      "default": "@vue/compiler-sfc"
+    }
+  },
+  "author": "General Translation, Inc.",
+  "license": "FSL-1.1-ALv2",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./config": {
+      "import": "./dist/config.js",
+      "types": "./dist/config.d.ts"
+    },
+    "./types": {
+      "import": "./dist/types.js",
+      "types": "./dist/types.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/generaltranslation/gt.git"
+  },
+  "keywords": [
+    "vue",
+    "extraction",
+    "translation",
+    "i18n"
+  ],
+  "dependencies": {
+    "@babel/parser": "^7.25.7",
+    "@babel/traverse": "^7.25.7",
+    "@babel/types": "^7.25.7",
+    "@vue/shared": "^3.5.0",
+    "@generaltranslation/format": "0.1.4",
+    "generaltranslation": "9.1.1"
+  },
+  "devDependencies": {
+    "@types/babel__traverse": "^7.20.6",
+    "@types/node": "^22.13.5",
+    "@vue/compiler-dom": "^3.5.0",
+    "@vue/compiler-sfc": "^3.5.0",
+    "tsdown": "^0.21.10",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "emit-types": "sh ../../scripts/emit-types.sh",
+    "transpile": "tsdown && pnpm run emit-types",
+    "build": "pnpm run transpile",
+    "build:watch": "tsdown --watch",
+    "build:clean": "sh ../../scripts/clean.sh && pnpm run build",
+    "build:release": "pnpm run build:clean",
+    "format": "oxfmt src",
+    "patch": "pnpm version patch",
+    "release": "pnpm run build:clean && pnpm publish",
+    "release:alpha": "pnpm run build:clean && pnpm publish --tag alpha",
+    "release:beta": "pnpm run build:clean && pnpm publish --tag beta",
+    "release:latest": "pnpm run build:clean && pnpm publish --tag latest",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}