@bamboocss/parser 1.47.0 → 1.48.0

package/dist/index.cjs

@@ -1691,6 +1691,24 @@ var Project = class {
 	sourcePreparations = /* @__PURE__ */ new Map();
 	/** Paths explicitly removed through this wrapper, until an add/create observes them again. */
 	removedSourcePaths = /* @__PURE__ */ new Set();
+	/**
+	* Sources a bundler transform owns, rather than members of the checkout.
+	*
+	* A compiler which shares this Project has to park bundler-transformed text somewhere, and
+	* it cannot be the file's own path — that is the canonical source every other reader
+	* resolves through. It parses under a sibling path instead, and that parse resolves its
+	* imports like any other, so the ledger gains an importer no watcher will ever report a
+	* change for. Left in, those facts reach the incremental extraction pass: an auxiliary
+	* importer would be selected as a dependent of the file it shadows and ordered against
+	* inventory members that do not import it.
+	*
+	* Excluded from exactly the three queries that decide what a rebuild re-extracts —
+	* the ledger, the dependent walk and the unresolved-importer set — and from nothing else.
+	* Resolution itself is deliberately untouched: an auxiliary parse must still see the same
+	* modules the real one would, and its forward edges are what a bundler registers as watch
+	* files.
+	*/
+	auxiliarySources = /* @__PURE__ */ new Set();
 	/** File-tree changes invalidate even successful resolutions (extension precedence can move). */
 	#fileTreeRevision = 0;
 	resolutionWork = {
@@ -1709,6 +1727,7 @@ var Project = class {
 		this.resolutionsByImporter = /* @__PURE__ */ new Map();
 		this.sourcePreparations = /* @__PURE__ */ new Map();
 		this.removedSourcePaths = /* @__PURE__ */ new Set();
+		this.auxiliarySources = /* @__PURE__ */ new Set();
 		this.resolutionWork = {
 			moduleResolutionsAttempted: 0,
 			sourceFilesAdded: 0,
@@ -1718,12 +1737,12 @@ var Project = class {
 	/** Files whose imports may resolve differently after a local file appears. */
 	getUnresolvedImporters = () => {
 		this.#assertNotLoading();
-		return [...this.unresolvedImporters].sort();
+		return [...this.unresolvedImporters].filter((importer) => !this.auxiliarySources.has(importer)).sort();
 	};
 	/** @internal Immutable resolution facts in importer/AST order. */
 	getResolutionLedger = () => {
 		this.#assertNotLoading();
-		return Object.freeze([...this.resolutionsByImporter.entries()].sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0).flatMap(([, entry]) => entry.facts));
+		return Object.freeze([...this.resolutionsByImporter.entries()].filter(([importer]) => !this.auxiliarySources.has(importer)).sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0).flatMap(([, entry]) => entry.facts));
 	};
 	/** @internal Every distinct local target represented by the current ledger. */
 	getResolvedSourceFiles = () => {
@@ -2052,7 +2071,7 @@ var Project = class {
 	* downstream edges the ledger records. The transaction is published only after the AST and
 	* its facts agree. A failed or re-entered attempt restores the input AST and can be retried.
 	*/
-	prepareEffectiveSource = (filePath, sourceFile) => {
+	prepareEffectiveSource = (filePath, sourceFile, hookFilePath = filePath) => {
 		this.#assertNotLoading();
 		const sourcePath = this.normalizePath(sourceFile.getFilePath());
 		const currentText = sourceFile.getFullText();
@@ -2087,7 +2106,7 @@ var Project = class {
 		const options = {};
 		try {
 			const custom = this.options.hooks["parser:before"]?.({
-				filePath,
+				filePath: hookFilePath,
 				content: currentText,
 				configure(next) {
 					const { matchTag, matchTagMode, matchTagProp } = next;
@@ -2097,7 +2116,7 @@ var Project = class {
 				}
 			});
 			assertTransaction(currentText);
-			const transformed = custom ?? this.transformFile(filePath, currentText);
+			const transformed = custom ?? this.transformFile(hookFilePath, currentText);
 			assertTransaction(currentText);
 			if (currentText !== transformed) sourceFile.replaceWithText(transformed);
 			assertTransaction(transformed);
@@ -2161,6 +2180,7 @@ var Project = class {
 			const importers = new Set([...this.dependents.get(current) ?? [], ...this.removedDependents.get(current) ?? []]);
 			for (const importer of [...importers].sort()) {
 				if (importer === start || seen.has(importer)) continue;
+				if (this.auxiliarySources.has(importer)) continue;
 				seen.add(importer);
 				queue.push(importer);
 			}
@@ -2298,7 +2318,7 @@ var Project = class {
 			if (error?.code !== "ENOENT") throw error;
 		}
 	};
-	addSourceFile = (filePath, content) => {
+	addSourceFile = (filePath, content, options = {}) => {
 		this.#assertNotLoading();
 		this.#ensureSourceFiles();
 		const existing = filePath.includes("/") ? this.project.getSourceFile(filePath) : void 0;
@@ -2324,14 +2344,25 @@ var Project = class {
 		* may have replaced this file's text through a `parser:before` hook. Such a file no longer
 		* matches its own source, falls through, and is overwritten exactly as before.
 		*/
-		if (existing && existing.getFullText() === content) return existing;
+		if (existing && existing.getFullText() === content) {
+			this.markAuxiliary(existing.getFilePath(), options.auxiliary);
+			return existing;
+		}
 		this.invalidateSourcePreparation(filePath, existing);
 		this.removedSourcePaths.delete(this.normalizePath(filePath));
 		this.invalidate(!existing, existing?.getFilePath());
-		return this.project.createSourceFile(filePath, content, {
+		const sourceFile = this.project.createSourceFile(filePath, content, {
 			overwrite: true,
 			scriptKind: scriptKindFor(filePath)
 		});
+		this.markAuxiliary(sourceFile.getFilePath(), options.auxiliary);
+		return sourceFile;
+	};
+	/** Claim or release compiler ownership of one source, in the ledger's own spelling. */
+	markAuxiliary = (filePath, auxiliary) => {
+		const normalized = this.normalizePath(filePath);
+		if (auxiliary) this.auxiliarySources.add(normalized);
+		else this.auxiliarySources.delete(normalized);
 	};
 	removeSourceFile = (filePath) => {
 		this.#assertNotLoading();
@@ -2342,6 +2373,7 @@ var Project = class {
 			this.invalidateSourcePreparation(filePath, sourceFile);
 			this.markTargetRemoved(this.normalizePath(sourceFile.getFilePath()), sourceFile);
 			this.options.parserOptions.encoder.releaseFile(sourceFile.getFilePath());
+			this.auxiliarySources.delete(this.normalizePath(sourceFile.getFilePath()));
 			return this.project.removeSourceFile(sourceFile);
 		}
 		return false;
@@ -2394,23 +2426,35 @@ var Project = class {
 		this.#assertNotLoading();
 		return this.options.getFiles;
 	}
-	parseJson = (filePath) => {
+	/**
+	* A dumped encoder is a parse result like any other, so it belongs to whichever encoder the
+	* caller named.
+	*
+	* Restoring into `parserOptions.encoder` regardless is the one place a supplied encoder was
+	* silently ignored, and it stops being a formality once a bundler transform and the
+	* extraction pass share one Project: the transform's parses go to a private clone precisely
+	* so they cannot add rules to the sheet, and a `.json` module in its graph would have
+	* pinned an entire safelist into the emitted encoder from a pass that emits nothing.
+	*/
+	parseJson = (filePath, encoder) => {
 		this.#assertNotLoading();
 		const { readFile, parserOptions } = this.options;
+		const target = encoder ?? parserOptions.encoder;
 		const content = readFile(filePath);
-		parserOptions.encoder.fromJSON(JSON.parse(content));
-		return new ParserResult(parserOptions).setFilePath(filePath);
+		target.fromJSON(JSON.parse(content));
+		return new ParserResult(parserOptions, encoder).setFilePath(filePath);
 	};
-	parseSourceFile = (filePath, encoder) => {
+	parseSourceFile = (filePath, encoder, options = {}) => {
 		this.#assertNotLoading();
 		const { hooks } = this.options;
-		if (filePath.endsWith(".json")) return this.parseJson(filePath);
+		const hookFilePath = options.hookFilePath ?? filePath;
+		if (filePath.endsWith(".json")) return this.parseJson(filePath, encoder);
 		const sourceFile = this.project.getSourceFile(filePath);
 		if (!sourceFile) return;
-		const { options } = this.prepareEffectiveSource(filePath, sourceFile);
-		const result = (encoder ?? this.options.parserOptions.encoder).withOwner("parse", sourceFile.getFilePath(), () => this.parser(sourceFile, encoder, options, this.resolveModule))?.setFilePath(filePath);
+		const { options: parserOptions } = this.prepareEffectiveSource(filePath, sourceFile, hookFilePath);
+		const result = (encoder ?? this.options.parserOptions.encoder).withOwner("parse", sourceFile.getFilePath(), () => this.parser(sourceFile, encoder, parserOptions, this.resolveModule))?.setFilePath(filePath);
 		hooks["parser:after"]?.({
-			filePath,
+			filePath: hookFilePath,
 			result
 		});
 		return result;

package/dist/index.d.cts

@@ -6,7 +6,7 @@ import { ResolveModule } from "@bamboocss/extractor";
 //#region ../generator/dist/index.d.cts
 //#region src/generator.d.ts
 interface SplitCssArtifact {
-  type: 'layer' | 'recipe' | 'theme';
+  type: 'layer' | 'theme';
   name: string;
   file: string;
   code: string;
@@ -16,12 +16,8 @@ interface SplitCssArtifact {
 interface SplitCssResult {
   /** Layer CSS files (reset, global, tokens, utilities) */
   layers: SplitCssArtifact[];
-  /** Recipe CSS files */
-  recipes: SplitCssArtifact[];
   /** Theme CSS files (not auto-imported) */
   themes: SplitCssArtifact[];
-  /** Content for recipes.css */
-  recipesIndex: string;
   /** Content for main styles.css */
   index: string;
 }
@@ -30,7 +26,11 @@ declare class Generator extends Context {
   getArtifacts: (ids?: ArtifactId[] | undefined) => import("@bamboocss/types").Artifact[];
   appendCssOfType: (type: CssArtifactType, sheet: Stylesheet) => void;
   appendLayerParams: (sheet: Stylesheet) => void;
-  appendBaselineCss: (sheet: Stylesheet) => void;
+  appendBaselineCss: (sheet: Stylesheet, {
+    atomizeRecipes
+  }?: {
+    atomizeRecipes?: boolean;
+  }) => void;
   appendParserCss: (sheet: Stylesheet) => void;
   /**
    * Drop token css variables nothing can reach. Call this only once the sheet holds the
@@ -199,23 +199,11 @@ declare class Generator extends Context {
    * Get CSS for a specific layer from the stylesheet
    */
   getLayerCss: (sheet: Stylesheet, layer: "reset" | "base" | "tokens" | "recipes" | "utilities") => string;
-  /**
-   * Get CSS for a specific recipe
-   */
-  getRecipeCss: (recipeName: string) => string;
-  /**
-   * Get all recipe names from the decoder
-   */
-  getRecipeNames: () => string[];
   /**
    * Get all split CSS artifacts for the stylesheet
    * Used when --splitting flag is enabled
    */
-  getSplitCssArtifacts: (sheet: Stylesheet, {
-    includeRecipes
-  }?: {
-    includeRecipes?: boolean;
-  }) => SplitCssResult;
+  getSplitCssArtifacts: (sheet: Stylesheet) => SplitCssResult;
   getSpec: () => SpecFile[];
   getSpecOfType: <T extends SpecType>(type: T) => T extends "color-palette" | "themes" ? SpecTypeMap[T] | undefined : SpecTypeMap[T];
 } //#endregion
@@ -439,6 +427,19 @@ interface ResolutionFact {
   readonly kind: 'import' | 'export';
   readonly ordinal: number;
 }
+/** @internal How one explicitly supplied source relates to the checkout it is added to. */
+interface AddSourceFileOptions {
+  /**
+   * This text belongs to a bundler transform rather than to the file at this path.
+   *
+   * @see `Project.auxiliarySources`
+   */
+  auxiliary?: boolean;
+}
+/** @internal Logical identity for hooks when a bundler source needs a synthetic AST path. */
+interface ParseSourceFileOptions {
+  hookFilePath?: string;
+}
 /** @internal Exact semantic closure plus missing local paths which can redirect it. */
 interface ResolutionReadSet {
   readonly dependencies: readonly string[];
@@ -508,6 +509,24 @@ declare class Project {
   private sourcePreparations;
   /** Paths explicitly removed through this wrapper, until an add/create observes them again. */
   private removedSourcePaths;
+  /**
+   * Sources a bundler transform owns, rather than members of the checkout.
+   *
+   * A compiler which shares this Project has to park bundler-transformed text somewhere, and
+   * it cannot be the file's own path — that is the canonical source every other reader
+   * resolves through. It parses under a sibling path instead, and that parse resolves its
+   * imports like any other, so the ledger gains an importer no watcher will ever report a
+   * change for. Left in, those facts reach the incremental extraction pass: an auxiliary
+   * importer would be selected as a dependent of the file it shadows and ordered against
+   * inventory members that do not import it.
+   *
+   * Excluded from exactly the three queries that decide what a rebuild re-extracts —
+   * the ledger, the dependent walk and the unresolved-importer set — and from nothing else.
+   * Resolution itself is deliberately untouched: an auxiliary parse must still see the same
+   * modules the real one would, and its forward edges are what a bundler registers as watch
+   * files.
+   */
+  private auxiliarySources;
   private resolutionWork;
   private resetResolutionState;
   /** Files whose imports may resolve differently after a local file appears. */
@@ -600,7 +619,9 @@ declare class Project {
   getResolutionConfigurationFiles: (filePath: string, targets?: Iterable<string>, previous?: Iterable<string>) => readonly string[];
   createSourceFile: (filePath: string) => SourceFile;
   createSourceFiles: () => void;
-  addSourceFile: (filePath: string, content: string) => SourceFile;
+  addSourceFile: (filePath: string, content: string, options?: AddSourceFileOptions) => SourceFile;
+  /** Claim or release compiler ownership of one source, in the ledger's own spelling. */
+  private markAuxiliary;
   removeSourceFile: (filePath: string) => boolean;
   /**
    * The current digest of one exported value, for read verification.
@@ -613,10 +634,20 @@ declare class Project {
   reloadSourceFiles: () => void;
   get readFile(): (filePath: string) => string;
   get getFiles(): () => string[];
-  parseJson: (filePath: string) => ParserResult;
-  parseSourceFile: (filePath: string, encoder?: ParserOptions["encoder"]) => ParserResult | undefined;
+  /**
+   * A dumped encoder is a parse result like any other, so it belongs to whichever encoder the
+   * caller named.
+   *
+   * Restoring into `parserOptions.encoder` regardless is the one place a supplied encoder was
+   * silently ignored, and it stops being a formality once a bundler transform and the
+   * extraction pass share one Project: the transform's parses go to a private clone precisely
+   * so they cannot add rules to the sheet, and a `.json` module in its graph would have
+   * pinned an entire safelist into the emitted encoder from a pass that emits nothing.
+   */
+  parseJson: (filePath: string, encoder?: ParserOptions["encoder"]) => ParserResult;
+  parseSourceFile: (filePath: string, encoder?: ParserOptions["encoder"], options?: ParseSourceFileOptions) => ParserResult | undefined;
   transformFile: (_filePath: string, content: string) => string;
   classify: (fileMap: Map<string, ParserResultInterface>) => import("@bamboocss/types").ClassifyReport;
 }
 //#endregion
-export { ParserResult, Project, ProjectOptions, ResolutionFact, ResolutionReadSet, ResolutionWork, type UnresolvedStyle, findUnresolvedStyles };
+export { AddSourceFileOptions, ParseSourceFileOptions, ParserResult, Project, ProjectOptions, ResolutionFact, ResolutionReadSet, ResolutionWork, type UnresolvedStyle, findUnresolvedStyles };

package/dist/index.d.mts

@@ -6,7 +6,7 @@ import { ArtifactId, BambooHooks, ConfigTsOptions, CssArtifactType, LoadConfigRe
 //#region ../generator/dist/index.d.cts
 //#region src/generator.d.ts
 interface SplitCssArtifact {
-  type: 'layer' | 'recipe' | 'theme';
+  type: 'layer' | 'theme';
   name: string;
   file: string;
   code: string;
@@ -16,12 +16,8 @@ interface SplitCssArtifact {
 interface SplitCssResult {
   /** Layer CSS files (reset, global, tokens, utilities) */
   layers: SplitCssArtifact[];
-  /** Recipe CSS files */
-  recipes: SplitCssArtifact[];
   /** Theme CSS files (not auto-imported) */
   themes: SplitCssArtifact[];
-  /** Content for recipes.css */
-  recipesIndex: string;
   /** Content for main styles.css */
   index: string;
 }
@@ -30,7 +26,11 @@ declare class Generator extends Context {
   getArtifacts: (ids?: ArtifactId[] | undefined) => import("@bamboocss/types").Artifact[];
   appendCssOfType: (type: CssArtifactType, sheet: Stylesheet) => void;
   appendLayerParams: (sheet: Stylesheet) => void;
-  appendBaselineCss: (sheet: Stylesheet) => void;
+  appendBaselineCss: (sheet: Stylesheet, {
+    atomizeRecipes
+  }?: {
+    atomizeRecipes?: boolean;
+  }) => void;
   appendParserCss: (sheet: Stylesheet) => void;
   /**
    * Drop token css variables nothing can reach. Call this only once the sheet holds the
@@ -199,23 +199,11 @@ declare class Generator extends Context {
    * Get CSS for a specific layer from the stylesheet
    */
   getLayerCss: (sheet: Stylesheet, layer: "reset" | "base" | "tokens" | "recipes" | "utilities") => string;
-  /**
-   * Get CSS for a specific recipe
-   */
-  getRecipeCss: (recipeName: string) => string;
-  /**
-   * Get all recipe names from the decoder
-   */
-  getRecipeNames: () => string[];
   /**
    * Get all split CSS artifacts for the stylesheet
    * Used when --splitting flag is enabled
    */
-  getSplitCssArtifacts: (sheet: Stylesheet, {
-    includeRecipes
-  }?: {
-    includeRecipes?: boolean;
-  }) => SplitCssResult;
+  getSplitCssArtifacts: (sheet: Stylesheet) => SplitCssResult;
   getSpec: () => SpecFile[];
   getSpecOfType: <T extends SpecType>(type: T) => T extends "color-palette" | "themes" ? SpecTypeMap[T] | undefined : SpecTypeMap[T];
 } //#endregion
@@ -439,6 +427,19 @@ interface ResolutionFact {
   readonly kind: 'import' | 'export';
   readonly ordinal: number;
 }
+/** @internal How one explicitly supplied source relates to the checkout it is added to. */
+interface AddSourceFileOptions {
+  /**
+   * This text belongs to a bundler transform rather than to the file at this path.
+   *
+   * @see `Project.auxiliarySources`
+   */
+  auxiliary?: boolean;
+}
+/** @internal Logical identity for hooks when a bundler source needs a synthetic AST path. */
+interface ParseSourceFileOptions {
+  hookFilePath?: string;
+}
 /** @internal Exact semantic closure plus missing local paths which can redirect it. */
 interface ResolutionReadSet {
   readonly dependencies: readonly string[];
@@ -508,6 +509,24 @@ declare class Project {
   private sourcePreparations;
   /** Paths explicitly removed through this wrapper, until an add/create observes them again. */
   private removedSourcePaths;
+  /**
+   * Sources a bundler transform owns, rather than members of the checkout.
+   *
+   * A compiler which shares this Project has to park bundler-transformed text somewhere, and
+   * it cannot be the file's own path — that is the canonical source every other reader
+   * resolves through. It parses under a sibling path instead, and that parse resolves its
+   * imports like any other, so the ledger gains an importer no watcher will ever report a
+   * change for. Left in, those facts reach the incremental extraction pass: an auxiliary
+   * importer would be selected as a dependent of the file it shadows and ordered against
+   * inventory members that do not import it.
+   *
+   * Excluded from exactly the three queries that decide what a rebuild re-extracts —
+   * the ledger, the dependent walk and the unresolved-importer set — and from nothing else.
+   * Resolution itself is deliberately untouched: an auxiliary parse must still see the same
+   * modules the real one would, and its forward edges are what a bundler registers as watch
+   * files.
+   */
+  private auxiliarySources;
   private resolutionWork;
   private resetResolutionState;
   /** Files whose imports may resolve differently after a local file appears. */
@@ -600,7 +619,9 @@ declare class Project {
   getResolutionConfigurationFiles: (filePath: string, targets?: Iterable<string>, previous?: Iterable<string>) => readonly string[];
   createSourceFile: (filePath: string) => SourceFile;
   createSourceFiles: () => void;
-  addSourceFile: (filePath: string, content: string) => SourceFile;
+  addSourceFile: (filePath: string, content: string, options?: AddSourceFileOptions) => SourceFile;
+  /** Claim or release compiler ownership of one source, in the ledger's own spelling. */
+  private markAuxiliary;
   removeSourceFile: (filePath: string) => boolean;
   /**
    * The current digest of one exported value, for read verification.
@@ -613,10 +634,20 @@ declare class Project {
   reloadSourceFiles: () => void;
   get readFile(): (filePath: string) => string;
   get getFiles(): () => string[];
-  parseJson: (filePath: string) => ParserResult;
-  parseSourceFile: (filePath: string, encoder?: ParserOptions["encoder"]) => ParserResult | undefined;
+  /**
+   * A dumped encoder is a parse result like any other, so it belongs to whichever encoder the
+   * caller named.
+   *
+   * Restoring into `parserOptions.encoder` regardless is the one place a supplied encoder was
+   * silently ignored, and it stops being a formality once a bundler transform and the
+   * extraction pass share one Project: the transform's parses go to a private clone precisely
+   * so they cannot add rules to the sheet, and a `.json` module in its graph would have
+   * pinned an entire safelist into the emitted encoder from a pass that emits nothing.
+   */
+  parseJson: (filePath: string, encoder?: ParserOptions["encoder"]) => ParserResult;
+  parseSourceFile: (filePath: string, encoder?: ParserOptions["encoder"], options?: ParseSourceFileOptions) => ParserResult | undefined;
   transformFile: (_filePath: string, content: string) => string;
   classify: (fileMap: Map<string, ParserResultInterface>) => import("@bamboocss/types").ClassifyReport;
 }
 //#endregion
-export { ParserResult, Project, ProjectOptions, ResolutionFact, ResolutionReadSet, ResolutionWork, type UnresolvedStyle, findUnresolvedStyles };
+export { AddSourceFileOptions, ParseSourceFileOptions, ParserResult, Project, ProjectOptions, ResolutionFact, ResolutionReadSet, ResolutionWork, type UnresolvedStyle, findUnresolvedStyles };

package/dist/index.mjs

@@ -1690,6 +1690,24 @@ var Project = class {
 	sourcePreparations = /* @__PURE__ */ new Map();
 	/** Paths explicitly removed through this wrapper, until an add/create observes them again. */
 	removedSourcePaths = /* @__PURE__ */ new Set();
+	/**
+	* Sources a bundler transform owns, rather than members of the checkout.
+	*
+	* A compiler which shares this Project has to park bundler-transformed text somewhere, and
+	* it cannot be the file's own path — that is the canonical source every other reader
+	* resolves through. It parses under a sibling path instead, and that parse resolves its
+	* imports like any other, so the ledger gains an importer no watcher will ever report a
+	* change for. Left in, those facts reach the incremental extraction pass: an auxiliary
+	* importer would be selected as a dependent of the file it shadows and ordered against
+	* inventory members that do not import it.
+	*
+	* Excluded from exactly the three queries that decide what a rebuild re-extracts —
+	* the ledger, the dependent walk and the unresolved-importer set — and from nothing else.
+	* Resolution itself is deliberately untouched: an auxiliary parse must still see the same
+	* modules the real one would, and its forward edges are what a bundler registers as watch
+	* files.
+	*/
+	auxiliarySources = /* @__PURE__ */ new Set();
 	/** File-tree changes invalidate even successful resolutions (extension precedence can move). */
 	#fileTreeRevision = 0;
 	resolutionWork = {
@@ -1708,6 +1726,7 @@ var Project = class {
 		this.resolutionsByImporter = /* @__PURE__ */ new Map();
 		this.sourcePreparations = /* @__PURE__ */ new Map();
 		this.removedSourcePaths = /* @__PURE__ */ new Set();
+		this.auxiliarySources = /* @__PURE__ */ new Set();
 		this.resolutionWork = {
 			moduleResolutionsAttempted: 0,
 			sourceFilesAdded: 0,
@@ -1717,12 +1736,12 @@ var Project = class {
 	/** Files whose imports may resolve differently after a local file appears. */
 	getUnresolvedImporters = () => {
 		this.#assertNotLoading();
-		return [...this.unresolvedImporters].sort();
+		return [...this.unresolvedImporters].filter((importer) => !this.auxiliarySources.has(importer)).sort();
 	};
 	/** @internal Immutable resolution facts in importer/AST order. */
 	getResolutionLedger = () => {
 		this.#assertNotLoading();
-		return Object.freeze([...this.resolutionsByImporter.entries()].sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0).flatMap(([, entry]) => entry.facts));
+		return Object.freeze([...this.resolutionsByImporter.entries()].filter(([importer]) => !this.auxiliarySources.has(importer)).sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0).flatMap(([, entry]) => entry.facts));
 	};
 	/** @internal Every distinct local target represented by the current ledger. */
 	getResolvedSourceFiles = () => {
@@ -2051,7 +2070,7 @@ var Project = class {
 	* downstream edges the ledger records. The transaction is published only after the AST and
 	* its facts agree. A failed or re-entered attempt restores the input AST and can be retried.
 	*/
-	prepareEffectiveSource = (filePath, sourceFile) => {
+	prepareEffectiveSource = (filePath, sourceFile, hookFilePath = filePath) => {
 		this.#assertNotLoading();
 		const sourcePath = this.normalizePath(sourceFile.getFilePath());
 		const currentText = sourceFile.getFullText();
@@ -2086,7 +2105,7 @@ var Project = class {
 		const options = {};
 		try {
 			const custom = this.options.hooks["parser:before"]?.({
-				filePath,
+				filePath: hookFilePath,
 				content: currentText,
 				configure(next) {
 					const { matchTag, matchTagMode, matchTagProp } = next;
@@ -2096,7 +2115,7 @@ var Project = class {
 				}
 			});
 			assertTransaction(currentText);
-			const transformed = custom ?? this.transformFile(filePath, currentText);
+			const transformed = custom ?? this.transformFile(hookFilePath, currentText);
 			assertTransaction(currentText);
 			if (currentText !== transformed) sourceFile.replaceWithText(transformed);
 			assertTransaction(transformed);
@@ -2160,6 +2179,7 @@ var Project = class {
 			const importers = new Set([...this.dependents.get(current) ?? [], ...this.removedDependents.get(current) ?? []]);
 			for (const importer of [...importers].sort()) {
 				if (importer === start || seen.has(importer)) continue;
+				if (this.auxiliarySources.has(importer)) continue;
 				seen.add(importer);
 				queue.push(importer);
 			}
@@ -2297,7 +2317,7 @@ var Project = class {
 			if (error?.code !== "ENOENT") throw error;
 		}
 	};
-	addSourceFile = (filePath, content) => {
+	addSourceFile = (filePath, content, options = {}) => {
 		this.#assertNotLoading();
 		this.#ensureSourceFiles();
 		const existing = filePath.includes("/") ? this.project.getSourceFile(filePath) : void 0;
@@ -2323,14 +2343,25 @@ var Project = class {
 		* may have replaced this file's text through a `parser:before` hook. Such a file no longer
 		* matches its own source, falls through, and is overwritten exactly as before.
 		*/
-		if (existing && existing.getFullText() === content) return existing;
+		if (existing && existing.getFullText() === content) {
+			this.markAuxiliary(existing.getFilePath(), options.auxiliary);
+			return existing;
+		}
 		this.invalidateSourcePreparation(filePath, existing);
 		this.removedSourcePaths.delete(this.normalizePath(filePath));
 		this.invalidate(!existing, existing?.getFilePath());
-		return this.project.createSourceFile(filePath, content, {
+		const sourceFile = this.project.createSourceFile(filePath, content, {
 			overwrite: true,
 			scriptKind: scriptKindFor(filePath)
 		});
+		this.markAuxiliary(sourceFile.getFilePath(), options.auxiliary);
+		return sourceFile;
+	};
+	/** Claim or release compiler ownership of one source, in the ledger's own spelling. */
+	markAuxiliary = (filePath, auxiliary) => {
+		const normalized = this.normalizePath(filePath);
+		if (auxiliary) this.auxiliarySources.add(normalized);
+		else this.auxiliarySources.delete(normalized);
 	};
 	removeSourceFile = (filePath) => {
 		this.#assertNotLoading();
@@ -2341,6 +2372,7 @@ var Project = class {
 			this.invalidateSourcePreparation(filePath, sourceFile);
 			this.markTargetRemoved(this.normalizePath(sourceFile.getFilePath()), sourceFile);
 			this.options.parserOptions.encoder.releaseFile(sourceFile.getFilePath());
+			this.auxiliarySources.delete(this.normalizePath(sourceFile.getFilePath()));
 			return this.project.removeSourceFile(sourceFile);
 		}
 		return false;
@@ -2393,23 +2425,35 @@ var Project = class {
 		this.#assertNotLoading();
 		return this.options.getFiles;
 	}
-	parseJson = (filePath) => {
+	/**
+	* A dumped encoder is a parse result like any other, so it belongs to whichever encoder the
+	* caller named.
+	*
+	* Restoring into `parserOptions.encoder` regardless is the one place a supplied encoder was
+	* silently ignored, and it stops being a formality once a bundler transform and the
+	* extraction pass share one Project: the transform's parses go to a private clone precisely
+	* so they cannot add rules to the sheet, and a `.json` module in its graph would have
+	* pinned an entire safelist into the emitted encoder from a pass that emits nothing.
+	*/
+	parseJson = (filePath, encoder) => {
 		this.#assertNotLoading();
 		const { readFile, parserOptions } = this.options;
+		const target = encoder ?? parserOptions.encoder;
 		const content = readFile(filePath);
-		parserOptions.encoder.fromJSON(JSON.parse(content));
-		return new ParserResult(parserOptions).setFilePath(filePath);
+		target.fromJSON(JSON.parse(content));
+		return new ParserResult(parserOptions, encoder).setFilePath(filePath);
 	};
-	parseSourceFile = (filePath, encoder) => {
+	parseSourceFile = (filePath, encoder, options = {}) => {
 		this.#assertNotLoading();
 		const { hooks } = this.options;
-		if (filePath.endsWith(".json")) return this.parseJson(filePath);
+		const hookFilePath = options.hookFilePath ?? filePath;
+		if (filePath.endsWith(".json")) return this.parseJson(filePath, encoder);
 		const sourceFile = this.project.getSourceFile(filePath);
 		if (!sourceFile) return;
-		const { options } = this.prepareEffectiveSource(filePath, sourceFile);
-		const result = (encoder ?? this.options.parserOptions.encoder).withOwner("parse", sourceFile.getFilePath(), () => this.parser(sourceFile, encoder, options, this.resolveModule))?.setFilePath(filePath);
+		const { options: parserOptions } = this.prepareEffectiveSource(filePath, sourceFile, hookFilePath);
+		const result = (encoder ?? this.options.parserOptions.encoder).withOwner("parse", sourceFile.getFilePath(), () => this.parser(sourceFile, encoder, parserOptions, this.resolveModule))?.setFilePath(filePath);
 		hooks["parser:after"]?.({
-			filePath,
+			filePath: hookFilePath,
 			result
 		});
 		return result;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bamboocss/parser",
-  "version": "1.47.0",
+  "version": "1.48.0",
   "description": "The static parser for bamboo css",
   "homepage": "https://bamboocss.com",
   "license": "MIT",
@@ -34,18 +34,18 @@
   "dependencies": {
     "ts-morph": "28.0.0",
     "ts-pattern": "5.9.0",
-    "@bamboocss/config": "^1.47.0",
-    "@bamboocss/core": "^1.47.0",
-    "@bamboocss/extractor": "1.47.0",
-    "@bamboocss/logger": "1.47.0",
-    "@bamboocss/shared": "1.47.0",
-    "@bamboocss/types": "1.47.0"
+    "@bamboocss/config": "^1.48.0",
+    "@bamboocss/core": "^1.48.0",
+    "@bamboocss/extractor": "1.48.0",
+    "@bamboocss/logger": "1.48.0",
+    "@bamboocss/shared": "1.48.0",
+    "@bamboocss/types": "1.48.0"
   },
   "devDependencies": {
     "@typescript/api": "npm:typescript@7.1.0-dev.20260819.1",
-    "@bamboocss/generator": "1.47.0",
-    "@bamboocss/plugin-svelte": "1.47.0",
-    "@bamboocss/plugin-vue": "1.47.0"
+    "@bamboocss/generator": "1.48.0",
+    "@bamboocss/plugin-svelte": "1.48.0",
+    "@bamboocss/plugin-vue": "1.48.0"
   },
   "scripts": {
     "build": "tsdown src/index.ts --format=esm,cjs --dts",