@generaltranslation/vue-extractor 0.0.0 → 0.1.0-iris.0

package/LICENSE.md

@@ -1,105 +1,21 @@
-# Functional Source License, Version 1.1, ALv2 Future License
-
-## Abbreviation
-
-FSL-1.1-ALv2
-
-## Notice
+MIT License
 
 Copyright 2026 General Translation, Inc.
 
-## Terms and Conditions
-
-### Licensor ("We")
-
-The party offering the Software under these Terms and Conditions.
-
-### The Software
-
-The "Software" is each version of the software that we make available under
-these Terms and Conditions, as indicated by our inclusion of these Terms and
-Conditions with the Software.
-
-### License Grant
-
-Subject to your compliance with this License Grant and the Patents,
-Redistribution and Trademark clauses below, we hereby grant you the right to
-use, copy, modify, create derivative works, publicly perform, publicly display
-and redistribute the Software for any Permitted Purpose identified below.
-
-### Permitted Purpose
-
-A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
-means making the Software available to others in a commercial product or
-service that:
-
-1. substitutes for the Software;
-
-2. substitutes for any other product or service we offer using the Software
-   that exists as of the date we make the Software available; or
-
-3. offers the same or substantially similar functionality as the Software.
-
-Permitted Purposes specifically include using the Software:
-
-1. for your internal use and access;
-
-2. for non-commercial education;
-
-3. for non-commercial research; and
-
-4. in connection with professional services that you provide to a licensee
-   using the Software in accordance with these Terms and Conditions.
-
-### Patents
-
-To the extent your use for a Permitted Purpose would necessarily infringe our
-patents, the license grant above includes a license under our patents. If you
-make a claim against any party that the Software infringes or contributes to
-the infringement of any patent, then your patent license to the Software ends
-immediately.
-
-### Redistribution
-
-The Terms and Conditions apply to all copies, modifications and derivatives of
-the Software.
-
-If you redistribute any copies, modifications or derivatives of the Software,
-you must include a copy of or a link to these Terms and Conditions and not
-remove any copyright notices provided in or with the Software.
-
-### Disclaimer
-
-THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
-PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
-
-IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
-SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
-EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
-
-### Trademarks
-
-Except for displaying the License Details and identifying us as the origin of
-the Software, you have no right under these Terms and Conditions to use our
-trademarks, trade names, service marks or product names.
-
-## Grant of Future License
-
-We hereby irrevocably grant you an additional license to use the Software under
-the Apache License, Version 2.0 that is effective on the second anniversary of
-the date we make the Software available. On or after that date, you may use the
-Software under the Apache License, Version 2.0, in which case the following
-will apply:
-
-Licensed under the Apache License, Version 2.0 (the "License"); you may not use
-this file except in compliance with the License.
-
-You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software distributed
-under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
-CONDITIONS OF ANY KIND, either express or implied. See the License for the
-specific language governing permissions and limitations under the License.
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/detect.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Detects declared or publicly re-exported gt-vue ownership without loading
+ * the Vue compiler.
+ *
+ * Local wrapper packages are parsed only to prove their public provenance.
+ * The full template and project extractor remains behind the `project` export.
+ */
+export { detectVueProject } from './internal/project/detectVueProject.js';

package/dist/detect.js

@@ -0,0 +1,2 @@
+import { detectVueProject } from "./internal/project/detectVueProject.js";
+export { detectVueProject };

package/dist/index.d.ts

@@ -1,2 +1,4 @@
 export { extractFromVueSource } from './internal/extractFromVueSource.js';
-export type { VueCompilerOptions, VueCompiler, VueExtractionMetadata, VueExtractionOptions, VueExtractionOutput, VueExtractionResult, VueSourceCode, } from './types.js';
+export { planVueExtraction } from './integration.js';
+export type { InlineExtractionOutput, PrimaryInlineExtractor, VueExtractionPlan, VueExtractionPlannerOptions, VueExtractionRunOptions, } from './integration.js';
+export type { VueCompilerOptions, VueCompiler, VueExtractionMetadata, VueExtractionOptions, VueExtractionOutput, VueExtractionResult, VueBranchSource, VueGTProp, VueJsxChild, VueJsxChildren, VueJsxElement, VueProjectExtractionOptions, VueProjectExtractionOutput, VueProjectExtractionResult, VueProjectInspection, VueSourceCode, } from './types.js';

package/dist/index.js

@@ -1,2 +1,3 @@
 import { extractFromVueSource } from "./internal/extractFromVueSource.js";
-export { extractFromVueSource };
+import { planVueExtraction } from "./integration.js";
+export { extractFromVueSource, planVueExtraction };

package/dist/inspect.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Inspects root and workspace Vue ownership without loading the Vue compiler
+ * or full source analyzer.
+ *
+ * Pass the returned plan to `extractFromVueProject` to avoid repeating
+ * workspace traversal during mixed-framework extraction.
+ */
+export { inspectVueProject, inspectVueProjectAsync, partitionVueSourcePatterns, readVueSfcExclusionPatterns, } from './internal/project/inspectVueProject.js';
+export type { VueProjectInspection } from './types.js';

package/dist/inspect.js

@@ -0,0 +1,2 @@
+import { inspectVueProject, inspectVueProjectAsync, partitionVueSourcePatterns, readVueSfcExclusionPatterns } from "./internal/project/inspectVueProject.js";
+export { inspectVueProject, inspectVueProjectAsync, partitionVueSourcePatterns, readVueSfcExclusionPatterns };

package/dist/integration.d.ts

@@ -0,0 +1,69 @@
+import type { VueCompilerOptions } from './types.js';
+import type { InlineExtractionOutput } from './internal/project/mergeVueProjectExtraction.js';
+/**
+ * Framework-neutral inline extractor supplied by a host CLI.
+ *
+ * The planner calls this function at most once. When no explicit source
+ * partition is necessary, it receives the caller's original pattern value
+ * before the planner performs asynchronous Vue work.
+ */
+export type PrimaryInlineExtractor = (filePatterns: string[] | undefined) => Promise<InlineExtractionOutput>;
+/** Options captured while deciding whether a project needs Vue extraction. */
+export type VueExtractionPlannerOptions = {
+    /** Inline runtime selected by the host CLI. */
+    library: string;
+    /** Absolute or caller-relative project root captured before any async work. */
+    projectRoot: string;
+    /** Explicit source patterns. `undefined` retains framework defaults. */
+    filePatterns?: string[];
+    /** Includes surrounding source lines in extracted update metadata. */
+    includeSourceCodeContext?: boolean;
+    /** Package export conditions used by static local-module resolution. */
+    conditionNames?: string[];
+    /** Explicit hash-affecting Vue compiler options. */
+    vueCompilerOptions?: VueCompilerOptions;
+    /** Explicit Vite config path relative to the captured project root. */
+    viteConfigPath?: string;
+    /**
+     * Explicit tsconfig.json or jsconfig.json path relative to the captured
+     * project root. When omitted, the nearest config is discovered per importer.
+     */
+    tsconfigPath?: string;
+    /** Number of source lines captured before and after a translation. */
+    surroundingLineCount?: number;
+};
+/** Host callbacks used only after a plan has proven Vue ownership. */
+export type VueExtractionRunOptions = {
+    /** Existing React, Node, or Python extraction to preserve and merge. */
+    extractPrimary?: PrimaryInlineExtractor;
+};
+/** A synchronous decision that leaves non-Vue projects completely untouched. */
+export type VueExtractionPlan = {
+    /** The root has no direct Vue extraction ownership. */
+    readonly handled: false;
+} | {
+    /** The selected runtime or root manifest directly owns gt-vue. */
+    readonly handled: true;
+    /** Executes package-owned Vue inspection, extraction, and merging. */
+    run(options?: VueExtractionRunOptions): Promise<InlineExtractionOutput>;
+};
+/**
+ * Returns whether a package manifest directly enables gt-vue extraction.
+ *
+ * Only production and development dependencies establish ownership. An
+ * optional declaration is authoritative and vetoes a matching declaration in
+ * either field, while peer dependencies never establish ownership.
+ */
+export declare function manifestDirectlyDeclaresGTVue(manifest: unknown): boolean;
+/**
+ * Plans Vue extraction without changing historical framework behavior.
+ *
+ * Activation is intentionally narrow: only an explicitly selected `gt-vue`
+ * runtime or a non-optional root `package.json` dependency/devDependency can
+ * handle the project. An optional declaration vetoes manifest ownership; peer,
+ * workspace-child, wrapper, source, and transitive evidence is ignored. The
+ * false branch is synchronous and performs no source scan, workspace traversal,
+ * dynamic import, or asynchronous work.
+ */
+export declare function planVueExtraction(options: VueExtractionPlannerOptions): VueExtractionPlan;
+export type { InlineExtractionOutput } from './internal/project/mergeVueProjectExtraction.js';

package/dist/integration.js

@@ -0,0 +1,162 @@
+import fs from "node:fs";
+import path from "node:path";
+//#region src/integration.ts
+const GT_VUE_PACKAGE = "gt-vue";
+const UNHANDLED_PLAN = Object.freeze({ handled: false });
+/**
+* Returns whether a package manifest directly enables gt-vue extraction.
+*
+* Only production and development dependencies establish ownership. An
+* optional declaration is authoritative and vetoes a matching declaration in
+* either field, while peer dependencies never establish ownership.
+*/
+function manifestDirectlyDeclaresGTVue(manifest) {
+	if (!isRecord(manifest)) return false;
+	if (hasOwnDependency(manifest.optionalDependencies, GT_VUE_PACKAGE)) return false;
+	return hasOwnDependency(manifest.dependencies, GT_VUE_PACKAGE) || hasOwnDependency(manifest.devDependencies, GT_VUE_PACKAGE);
+}
+/**
+* Plans Vue extraction without changing historical framework behavior.
+*
+* Activation is intentionally narrow: only an explicitly selected `gt-vue`
+* runtime or a non-optional root `package.json` dependency/devDependency can
+* handle the project. An optional declaration vetoes manifest ownership; peer,
+* workspace-child, wrapper, source, and transitive evidence is ignored. The
+* false branch is synchronous and performs no source scan, workspace traversal,
+* dynamic import, or asynchronous work.
+*/
+function planVueExtraction(options) {
+	const captured = capturePlannerOptions(options);
+	if (captured.library !== GT_VUE_PACKAGE && !rootDirectlyDeclaresGTVue(captured.projectRoot)) return UNHANDLED_PLAN;
+	return Object.freeze({
+		handled: true,
+		run: (runOptions = {}) => runVueExtraction(captured, runOptions)
+	});
+}
+/** Resolves the root immediately so later cwd changes cannot retarget work. */
+function capturePlannerOptions(options) {
+	const absoluteRoot = path.resolve(options.projectRoot);
+	let projectRoot = absoluteRoot;
+	try {
+		projectRoot = fs.realpathSync(absoluteRoot);
+	} catch {}
+	return {
+		...options,
+		projectRoot
+	};
+}
+/** Reads the root manifest fields that determine effective direct ownership. */
+function rootDirectlyDeclaresGTVue(projectRoot) {
+	let manifest;
+	try {
+		manifest = JSON.parse(fs.readFileSync(path.join(projectRoot, "package.json"), "utf8"));
+	} catch {
+		return false;
+	}
+	return manifestDirectlyDeclaresGTVue(manifest);
+}
+function hasOwnDependency(value, packageName) {
+	return isRecord(value) && Object.hasOwn(value, packageName);
+}
+/**
+* Runs the handled branch while preserving primary extractor timing.
+*
+* With framework-default patterns, the primary extractor starts synchronously
+* and receives the exact original `undefined` value before the first await.
+* Explicit patterns wait for package-owned SFC partitioning; if another task
+* changes `process.cwd()` in the meantime, only relative primary patterns are
+* anchored back to the captured project root.
+*/
+async function runVueExtraction(options, { extractPrimary }) {
+	const filePatterns = options.filePatterns;
+	if (filePatterns === void 0) {
+		if (extractPrimary) {
+			const primaryPromise = extractPrimary(filePatterns);
+			let primaryRejected = false;
+			let primaryError;
+			const observedPrimaryPromise = primaryPromise.catch((error) => {
+				primaryRejected = true;
+				primaryError = error;
+				throw error;
+			});
+			const vuePromise = afterCurrentTurn(async () => {
+				if (primaryRejected) throw primaryError;
+				const { inspection, project } = await loadVueExtractionContext(options);
+				return {
+					project,
+					vue: await project.extractFromVueProject(createProjectExtractionOptions(options, inspection, filePatterns))
+				};
+			});
+			const [primary, { project, vue }] = await Promise.all([observedPrimaryPromise, vuePromise]);
+			return project.mergeVueProjectExtraction(primary, vue);
+		}
+		const { project, inspection } = await loadVueExtractionContext(options);
+		return adaptVueOnlyExtraction(project, await project.extractFromVueProject(createProjectExtractionOptions(options, inspection, filePatterns)));
+	}
+	const { inspectionModule, project, inspection } = await loadVueExtractionContext(options);
+	if (!extractPrimary) return adaptVueOnlyExtraction(project, await project.extractFromVueProject(createProjectExtractionOptions(options, inspection, filePatterns)));
+	const partition = inspection.hasVueScopes ? inspectionModule.partitionVueSourcePatterns(inspection, filePatterns) : {
+		primaryExclusionPatterns: [],
+		vueExclusionPatterns: []
+	};
+	const stablePrimaryPatterns = process.cwd() === options.projectRoot ? filePatterns : await anchorFilePatterns(options.projectRoot, filePatterns);
+	const primaryPatterns = partition.primaryExclusionPatterns.length === 0 ? stablePrimaryPatterns : [...stablePrimaryPatterns, ...partition.primaryExclusionPatterns];
+	const vuePatterns = partition.vueExclusionPatterns.length === 0 ? filePatterns : [...filePatterns, ...partition.vueExclusionPatterns];
+	const primaryPromise = extractPrimary(primaryPatterns);
+	const vuePromise = project.extractFromVueProject(createProjectExtractionOptions(options, inspection, vuePatterns));
+	const [primary, vue] = await Promise.all([primaryPromise, vuePromise]);
+	return project.mergeVueProjectExtraction(primary, vue);
+}
+/** Lets an already-settled primary extractor reach the host before Vue loads. */
+function afterCurrentTurn(callback) {
+	return new Promise((resolve) => setImmediate(resolve)).then(callback);
+}
+/** Adapts accurate Vue wire types at the legacy host-CLI Updates boundary. */
+function adaptVueOnlyExtraction(project, vue) {
+	return project.mergeVueProjectExtraction({
+		updates: [],
+		errors: [],
+		warnings: []
+	}, vue);
+}
+/** Loads the lazy Vue modules and performs package-owned project inspection. */
+async function loadVueExtractionContext(options) {
+	const [inspectionModule, project] = await Promise.all([import("./internal/project/inspectVueProject.js"), import("./project.js")]);
+	return {
+		inspectionModule,
+		project,
+		inspection: await inspectionModule.inspectVueProjectForRuntime(options.projectRoot, options.library === GT_VUE_PACKAGE)
+	};
+}
+function createProjectExtractionOptions(options, inspection, filePatterns) {
+	return {
+		cwd: options.projectRoot,
+		inspection,
+		filePatterns,
+		includeSourceCodeContext: options.includeSourceCodeContext,
+		conditionNames: options.conditionNames,
+		vueCompilerOptions: options.vueCompilerOptions,
+		viteConfigPath: options.viteConfigPath,
+		tsconfigPath: options.tsconfigPath,
+		surroundingLineCount: options.surroundingLineCount
+	};
+}
+/** Anchors relative globs without changing absolute or negative patterns. */
+async function anchorFilePatterns(projectRoot, filePatterns) {
+	const { default: fg } = await import("fast-glob");
+	const rootPattern = fg.convertPathToPattern(projectRoot).replace(/\/$/, "");
+	return filePatterns.map((pattern) => {
+		const negative = pattern.startsWith("!") && pattern[1] !== "(";
+		const positivePattern = negative ? pattern.slice(1) : pattern;
+		if (path.isAbsolute(positivePattern)) return pattern;
+		const anchoredPattern = `${rootPattern}/${positivePattern.startsWith("./") ? positivePattern.slice(2) : positivePattern}`;
+		return negative ? `!${anchoredPattern}` : anchoredPattern;
+	});
+}
+function isRecord(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//#endregion
+export { manifestDirectlyDeclaresGTVue, planVueExtraction };
+
+//# sourceMappingURL=integration.js.map

package/dist/integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.js","names":[],"sources":["../src/integration.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport type {\n  VueCompilerOptions,\n  VueProjectExtractionOutput,\n} from './types.js';\nimport type { InlineExtractionOutput } from './internal/project/mergeVueProjectExtraction.js';\n\nconst GT_VUE_PACKAGE = 'gt-vue';\n\n/**\n * Framework-neutral inline extractor supplied by a host CLI.\n *\n * The planner calls this function at most once. When no explicit source\n * partition is necessary, it receives the caller's original pattern value\n * before the planner performs asynchronous Vue work.\n */\nexport type PrimaryInlineExtractor = (\n  filePatterns: string[] | undefined\n) => Promise<InlineExtractionOutput>;\n\n/** Options captured while deciding whether a project needs Vue extraction. */\nexport type VueExtractionPlannerOptions = {\n  /** Inline runtime selected by the host CLI. */\n  library: string;\n  /** Absolute or caller-relative project root captured before any async work. */\n  projectRoot: string;\n  /** Explicit source patterns. `undefined` retains framework defaults. */\n  filePatterns?: string[];\n  /** Includes surrounding source lines in extracted update metadata. */\n  includeSourceCodeContext?: boolean;\n  /** Package export conditions used by static local-module resolution. */\n  conditionNames?: string[];\n  /** Explicit hash-affecting Vue compiler options. */\n  vueCompilerOptions?: VueCompilerOptions;\n  /** Explicit Vite config path relative to the captured project root. */\n  viteConfigPath?: string;\n  /**\n   * Explicit tsconfig.json or jsconfig.json path relative to the captured\n   * project root. When omitted, the nearest config is discovered per importer.\n   */\n  tsconfigPath?: string;\n  /** Number of source lines captured before and after a translation. */\n  surroundingLineCount?: number;\n};\n\n/** Host callbacks used only after a plan has proven Vue ownership. */\nexport type VueExtractionRunOptions = {\n  /** Existing React, Node, or Python extraction to preserve and merge. */\n  extractPrimary?: PrimaryInlineExtractor;\n};\n\n/** A synchronous decision that leaves non-Vue projects completely untouched. */\nexport type VueExtractionPlan =\n  | {\n      /** The root has no direct Vue extraction ownership. */\n      readonly handled: false;\n    }\n  | {\n      /** The selected runtime or root manifest directly owns gt-vue. */\n      readonly handled: true;\n      /** Executes package-owned Vue inspection, extraction, and merging. */\n      run(options?: VueExtractionRunOptions): Promise<InlineExtractionOutput>;\n    };\n\ntype CapturedPlannerOptions = Omit<\n  VueExtractionPlannerOptions,\n  'projectRoot'\n> & {\n  projectRoot: string;\n};\n\nconst UNHANDLED_PLAN = Object.freeze({ handled: false } as const);\n\n/**\n * Returns whether a package manifest directly enables gt-vue extraction.\n *\n * Only production and development dependencies establish ownership. An\n * optional declaration is authoritative and vetoes a matching declaration in\n * either field, while peer dependencies never establish ownership.\n */\nexport function manifestDirectlyDeclaresGTVue(manifest: unknown): boolean {\n  if (!isRecord(manifest)) return false;\n  if (hasOwnDependency(manifest.optionalDependencies, GT_VUE_PACKAGE)) {\n    return false;\n  }\n  return (\n    hasOwnDependency(manifest.dependencies, GT_VUE_PACKAGE) ||\n    hasOwnDependency(manifest.devDependencies, GT_VUE_PACKAGE)\n  );\n}\n\n/**\n * Plans Vue extraction without changing historical framework behavior.\n *\n * Activation is intentionally narrow: only an explicitly selected `gt-vue`\n * runtime or a non-optional root `package.json` dependency/devDependency can\n * handle the project. An optional declaration vetoes manifest ownership; peer,\n * workspace-child, wrapper, source, and transitive evidence is ignored. The\n * false branch is synchronous and performs no source scan, workspace traversal,\n * dynamic import, or asynchronous work.\n */\nexport function planVueExtraction(\n  options: VueExtractionPlannerOptions\n): VueExtractionPlan {\n  const captured = capturePlannerOptions(options);\n  if (\n    captured.library !== GT_VUE_PACKAGE &&\n    !rootDirectlyDeclaresGTVue(captured.projectRoot)\n  ) {\n    return UNHANDLED_PLAN;\n  }\n\n  return Object.freeze({\n    handled: true as const,\n    run: (runOptions: VueExtractionRunOptions = {}) =>\n      runVueExtraction(captured, runOptions),\n  });\n}\n\n/** Resolves the root immediately so later cwd changes cannot retarget work. */\nfunction capturePlannerOptions(\n  options: VueExtractionPlannerOptions\n): CapturedPlannerOptions {\n  const absoluteRoot = path.resolve(options.projectRoot);\n  let projectRoot = absoluteRoot;\n  try {\n    projectRoot = fs.realpathSync(absoluteRoot);\n  } catch {\n    // A missing root is still captured absolutely; activation will remain\n    // inert unless the runtime was selected explicitly.\n  }\n  return {\n    ...options,\n    projectRoot,\n  };\n}\n\n/** Reads the root manifest fields that determine effective direct ownership. */\nfunction rootDirectlyDeclaresGTVue(projectRoot: string): boolean {\n  let manifest: unknown;\n  try {\n    manifest = JSON.parse(\n      fs.readFileSync(path.join(projectRoot, 'package.json'), 'utf8')\n    );\n  } catch {\n    return false;\n  }\n  return manifestDirectlyDeclaresGTVue(manifest);\n}\n\nfunction hasOwnDependency(value: unknown, packageName: string): boolean {\n  return isRecord(value) && Object.hasOwn(value, packageName);\n}\n\n/**\n * Runs the handled branch while preserving primary extractor timing.\n *\n * With framework-default patterns, the primary extractor starts synchronously\n * and receives the exact original `undefined` value before the first await.\n * Explicit patterns wait for package-owned SFC partitioning; if another task\n * changes `process.cwd()` in the meantime, only relative primary patterns are\n * anchored back to the captured project root.\n */\nasync function runVueExtraction(\n  options: CapturedPlannerOptions,\n  { extractPrimary }: VueExtractionRunOptions\n): Promise<InlineExtractionOutput> {\n  const filePatterns = options.filePatterns;\n  if (filePatterns === undefined) {\n    if (extractPrimary) {\n      const primaryPromise = extractPrimary(filePatterns);\n      let primaryRejected = false;\n      let primaryError: unknown;\n      const observedPrimaryPromise = primaryPromise.catch((error: unknown) => {\n        primaryRejected = true;\n        primaryError = error;\n        throw error;\n      });\n      // Observe both branches immediately. This lets an already-rejected\n      // primary extractor retain its error identity before Node starts the\n      // comparatively expensive lazy Vue imports. Successful primary work and\n      // Vue inspection still overlap after the current event-loop turn.\n      const vuePromise = afterCurrentTurn(async () => {\n        if (primaryRejected) throw primaryError;\n        const { inspection, project } = await loadVueExtractionContext(options);\n        return {\n          project,\n          vue: await project.extractFromVueProject(\n            createProjectExtractionOptions(options, inspection, filePatterns)\n          ),\n        };\n      });\n      const [primary, { project, vue }] = await Promise.all([\n        observedPrimaryPromise,\n        vuePromise,\n      ]);\n      return project.mergeVueProjectExtraction(primary, vue);\n    }\n\n    const { project, inspection } = await loadVueExtractionContext(options);\n    return adaptVueOnlyExtraction(\n      project,\n      await project.extractFromVueProject(\n        createProjectExtractionOptions(options, inspection, filePatterns)\n      )\n    );\n  }\n\n  const vueContextPromise = loadVueExtractionContext(options);\n  const { inspectionModule, project, inspection } = await vueContextPromise;\n\n  if (!extractPrimary) {\n    return adaptVueOnlyExtraction(\n      project,\n      await project.extractFromVueProject(\n        createProjectExtractionOptions(options, inspection, filePatterns)\n      )\n    );\n  }\n\n  const partition = inspection.hasVueScopes\n    ? inspectionModule.partitionVueSourcePatterns(inspection, filePatterns)\n    : { primaryExclusionPatterns: [], vueExclusionPatterns: [] };\n  const stablePrimaryPatterns =\n    process.cwd() === options.projectRoot\n      ? filePatterns\n      : await anchorFilePatterns(options.projectRoot, filePatterns);\n  const primaryPatterns =\n    partition.primaryExclusionPatterns.length === 0\n      ? stablePrimaryPatterns\n      : [...stablePrimaryPatterns, ...partition.primaryExclusionPatterns];\n  const vuePatterns =\n    partition.vueExclusionPatterns.length === 0\n      ? filePatterns\n      : [...filePatterns, ...partition.vueExclusionPatterns];\n\n  // Calling before constructing/awaiting Vue extraction preserves the\n  // historical extractor's synchronous process.cwd() observation.\n  const primaryPromise = extractPrimary(primaryPatterns);\n  const vuePromise = project.extractFromVueProject(\n    createProjectExtractionOptions(options, inspection, vuePatterns)\n  );\n  const [primary, vue] = await Promise.all([primaryPromise, vuePromise]);\n  return project.mergeVueProjectExtraction(primary, vue);\n}\n\n/** Lets an already-settled primary extractor reach the host before Vue loads. */\nfunction afterCurrentTurn<T>(callback: () => Promise<T>): Promise<T> {\n  return new Promise<void>((resolve) => setImmediate(resolve)).then(callback);\n}\n\n/** Adapts accurate Vue wire types at the legacy host-CLI Updates boundary. */\nfunction adaptVueOnlyExtraction(\n  project: typeof import('./project.js'),\n  vue: VueProjectExtractionOutput\n): InlineExtractionOutput {\n  return project.mergeVueProjectExtraction(\n    { updates: [], errors: [], warnings: [] },\n    vue\n  );\n}\n\n/** Loads the lazy Vue modules and performs package-owned project inspection. */\nasync function loadVueExtractionContext(options: CapturedPlannerOptions) {\n  const [inspectionModule, project] = await Promise.all([\n    import('./internal/project/inspectVueProject.js'),\n    import('./project.js'),\n  ]);\n  const inspection = await inspectionModule.inspectVueProjectForRuntime(\n    options.projectRoot,\n    options.library === GT_VUE_PACKAGE\n  );\n  return { inspectionModule, project, inspection };\n}\n\nfunction createProjectExtractionOptions(\n  options: CapturedPlannerOptions,\n  inspection: import('./types.js').VueProjectInspection,\n  filePatterns: string[] | undefined\n): import('./types.js').VueProjectExtractionOptions {\n  return {\n    cwd: options.projectRoot,\n    inspection,\n    filePatterns,\n    includeSourceCodeContext: options.includeSourceCodeContext,\n    conditionNames: options.conditionNames,\n    vueCompilerOptions: options.vueCompilerOptions,\n    viteConfigPath: options.viteConfigPath,\n    tsconfigPath: options.tsconfigPath,\n    surroundingLineCount: options.surroundingLineCount,\n  };\n}\n\n/** Anchors relative globs without changing absolute or negative patterns. */\nasync function anchorFilePatterns(\n  projectRoot: string,\n  filePatterns: readonly string[]\n): Promise<string[]> {\n  const { default: fg } = await import('fast-glob');\n  const rootPattern = fg.convertPathToPattern(projectRoot).replace(/\\/$/, '');\n  return filePatterns.map((pattern) => {\n    const negative = pattern.startsWith('!') && pattern[1] !== '(';\n    const positivePattern = negative ? pattern.slice(1) : pattern;\n    if (path.isAbsolute(positivePattern)) return pattern;\n    const relativePattern = positivePattern.startsWith('./')\n      ? positivePattern.slice(2)\n      : positivePattern;\n    const anchoredPattern = `${rootPattern}/${relativePattern}`;\n    return negative ? `!${anchoredPattern}` : anchoredPattern;\n  });\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\nexport type { InlineExtractionOutput } from './internal/project/mergeVueProjectExtraction.js';\n"],"mappings":"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"}

package/dist/internal/config/configFiles.d.ts

@@ -0,0 +1,6 @@
+/** Vite's standard config filenames in lookup precedence order. */
+export declare const VITE_CONFIG_FILES: readonly ["vite.config.js", "vite.config.mjs", "vite.config.ts", "vite.config.cjs", "vite.config.mts", "vite.config.cts"];
+/** Nuxt's standard config filenames in lookup precedence order. */
+export declare const NUXT_CONFIG_FILES: readonly ["nuxt.config.js", "nuxt.config.ts", "nuxt.config.mjs", "nuxt.config.cjs", "nuxt.config.mts", "nuxt.config.cts"];
+/** JavaScript and TypeScript extensions accepted for an explicit Vite config. */
+export declare const VITE_CONFIG_EXTENSIONS: Set<string>;

package/dist/internal/config/configFiles.js

@@ -0,0 +1,34 @@
+//#region src/internal/config/configFiles.ts
+/** Vite's standard config filenames in lookup precedence order. */
+const VITE_CONFIG_FILES = [
+	"vite.config.js",
+	"vite.config.mjs",
+	"vite.config.ts",
+	"vite.config.cjs",
+	"vite.config.mts",
+	"vite.config.cts"
+];
+/** Nuxt's standard config filenames in lookup precedence order. */
+const NUXT_CONFIG_FILES = [
+	"nuxt.config.js",
+	"nuxt.config.ts",
+	"nuxt.config.mjs",
+	"nuxt.config.cjs",
+	"nuxt.config.mts",
+	"nuxt.config.cts"
+];
+/** JavaScript and TypeScript extensions accepted for an explicit Vite config. */
+const VITE_CONFIG_EXTENSIONS = new Set([
+	".js",
+	".jsx",
+	".mjs",
+	".cjs",
+	".ts",
+	".tsx",
+	".mts",
+	".cts"
+]);
+//#endregion
+export { NUXT_CONFIG_FILES, VITE_CONFIG_EXTENSIONS, VITE_CONFIG_FILES };
+
+//# sourceMappingURL=configFiles.js.map

package/dist/internal/config/configFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configFiles.js","names":[],"sources":["../../../src/internal/config/configFiles.ts"],"sourcesContent":["/** Vite's standard config filenames in lookup precedence order. */\nexport const VITE_CONFIG_FILES = [\n  'vite.config.js',\n  'vite.config.mjs',\n  'vite.config.ts',\n  'vite.config.cjs',\n  'vite.config.mts',\n  'vite.config.cts',\n] as const;\n\n/** Nuxt's standard config filenames in lookup precedence order. */\nexport const NUXT_CONFIG_FILES = [\n  'nuxt.config.js',\n  'nuxt.config.ts',\n  'nuxt.config.mjs',\n  'nuxt.config.cjs',\n  'nuxt.config.mts',\n  'nuxt.config.cts',\n] as const;\n\n/** JavaScript and TypeScript extensions accepted for an explicit Vite config. */\nexport const VITE_CONFIG_EXTENSIONS = new Set([\n  '.js',\n  '.jsx',\n  '.mjs',\n  '.cjs',\n  '.ts',\n  '.tsx',\n  '.mts',\n  '.cts',\n]);\n"],"mappings":";;AACA,MAAa,oBAAoB;CAC/B;CACA;CACA;CACA;CACA;CACA;CACD;;AAGD,MAAa,oBAAoB;CAC/B;CACA;CACA;CACA;CACA;CACA;CACD;;AAGD,MAAa,yBAAyB,IAAI,IAAI;CAC5C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC"}

package/dist/internal/config/resolveVueCompilerOptions.d.ts

@@ -10,6 +10,12 @@ export type VueCompilerOptionsResolution = {
 export type VueCompilerOptionsResolverOptions = {
     /** A single explicit Vite config path, resolved relative to the project root. */
     viteConfigPath?: string;
+    /**
+     * Whether caller-supplied source globs already cover custom Nuxt layouts.
+     * This relaxes only layout validation; discovered config remains mandatory
+     * to read and parse successfully.
+     */
+    sourceDiscoveryIsExplicit?: boolean;
 };
 /**
  * Resolves hash-affecting Vue template compiler options without executing