@bamboocss/parser 1.54.1 → 1.55.0

package/dist/index.cjs

@@ -983,6 +983,7 @@ var ParserResult = class {
 	/** The call site of `result`, when the encoder is recording them. */
 	originOf = (result) => {
 		if (!this.origins || !this.encoder.recordOrigins) return void 0;
+		if (result.atomOrigin) return result.atomOrigin;
 		const node = result.box?.getNode();
 		const sourceFile = node?.getSourceFile();
 		if (!node || !sourceFile) return void 0;
@@ -1749,6 +1750,8 @@ var Project = class {
 	* files.
 	*/
 	auxiliarySources = /* @__PURE__ */ new Set();
+	/** Bytes explicitly supplied by a caller rather than read from disk. */
+	overriddenSources = /* @__PURE__ */ new Map();
 	/** File-tree changes invalidate even successful resolutions (extension precedence can move). */
 	#fileTreeRevision = 0;
 	resolutionWork = {
@@ -1768,6 +1771,7 @@ var Project = class {
 		this.sourcePreparations = /* @__PURE__ */ new Map();
 		this.removedSourcePaths = /* @__PURE__ */ new Set();
 		this.auxiliarySources = /* @__PURE__ */ new Set();
+		this.overriddenSources = /* @__PURE__ */ new Map();
 		this.resolutionWork = {
 			moduleResolutionsAttempted: 0,
 			sourceFilesAdded: 0,
@@ -1796,6 +1800,22 @@ var Project = class {
 		this.#assertNotLoading();
 		return Object.freeze({ ...this.resolutionWork });
 	};
+	/** @internal Whether an operation has crossed into the TypeScript-backed API. */
+	hasMaterializedCompiler = () => this.#sourceFiles.project !== void 0;
+	/** Source bytes from overlays, virtual filesystems, or disk, without creating a compiler. */
+	getSourceText = (filePath) => {
+		const override = this.overriddenSources.get(this.normalizePath(filePath));
+		if (override !== void 0) return override;
+		try {
+			return this.options.readFile(filePath);
+		} catch {
+			return;
+		}
+	};
+	/** Whether that same compiler-free source view can read a path. */
+	sourceExists = (filePath) => this.overriddenSources.has(this.normalizePath(filePath)) || (this.options.fileExists?.(filePath) ?? this.getSourceText(filePath) !== void 0);
+	/** Whether a caller supplied bytes that can differ from the path on disk. */
+	sourceIsOverridden = (filePath) => this.overriddenSources.has(this.normalizePath(filePath));
 	getSourceFile = (filePath) => {
 		this.#assertNotLoading();
 		if (!this.project.has(filePath)) return void 0;
@@ -2527,6 +2547,7 @@ var Project = class {
 		*/
 		if (existing && existing.getFullText() === content) {
 			this.markAuxiliary((0, _bamboocss_ts_ast.pathOf)(existing), options.auxiliary);
+			this.overriddenSources.set(this.normalizePath((0, _bamboocss_ts_ast.pathOf)(existing)), content);
 			return existing;
 		}
 		this.invalidateSourcePreparation(filePath, existing);
@@ -2535,6 +2556,7 @@ var Project = class {
 		const sourceFile = this.project.createSourceFile(filePath, content, { scriptKind: scriptKindFor(filePath) });
 		if (!sourceFile) throw new Error(`bamboo: could not add ${filePath} to the project`);
 		this.markAuxiliary((0, _bamboocss_ts_ast.pathOf)(sourceFile), options.auxiliary);
+		this.overriddenSources.set(this.normalizePath((0, _bamboocss_ts_ast.pathOf)(sourceFile)), content);
 		return sourceFile;
 	};
 	/** Claim or release compiler ownership of one source, in the ledger's own spelling. */
@@ -2553,8 +2575,10 @@ var Project = class {
 			this.markTargetRemoved(this.normalizePath((0, _bamboocss_ts_ast.pathOf)(sourceFile)), sourceFile);
 			this.options.parserOptions.encoder.releaseFile((0, _bamboocss_ts_ast.pathOf)(sourceFile));
 			this.auxiliarySources.delete(this.normalizePath((0, _bamboocss_ts_ast.pathOf)(sourceFile)));
+			this.overriddenSources.delete(this.normalizePath((0, _bamboocss_ts_ast.pathOf)(sourceFile)));
 			return this.project.removeSourceFile((0, _bamboocss_ts_ast.pathOf)(sourceFile));
 		}
+		this.overriddenSources.delete(this.normalizePath(filePath));
 		return false;
 	};
 	/**
@@ -2573,7 +2597,11 @@ var Project = class {
 		this.#ensureSourceFiles();
 		const sourceFile = this.getSourceFile(filePath);
 		this.invalidate(false, (0, _bamboocss_ts_ast.pathOf)(sourceFile));
-		if (!sourceFile) return;
+		if (!sourceFile) {
+			this.overriddenSources.delete(this.normalizePath(filePath));
+			return;
+		}
+		this.overriddenSources.delete(this.normalizePath((0, _bamboocss_ts_ast.pathOf)(sourceFile)));
 		this.invalidateSourcePreparation(filePath, sourceFile);
 		return this.project.reloadSourceFile(filePath);
 	};
@@ -2583,6 +2611,7 @@ var Project = class {
 		const files = this.getFiles();
 		this.invalidate();
 		for (const file of files) {
+			this.overriddenSources.delete(this.normalizePath(file));
 			const source = this.getSourceFile(file);
 			if (source) {
 				this.invalidateSourcePreparation(file, source);

package/dist/index.d.cts

@@ -458,6 +458,7 @@ interface ProjectOptions extends ProjectOptions$1 {
    */
   deferInitialSourceFiles?: boolean;
   readFile: Runtime['fs']['readFileSync'];
+  fileExists?: Runtime['fs']['existsSync'];
   getFiles(): string[];
   hooks: Partial<BambooHooks>;
   parserOptions: ParserOptions;
@@ -586,6 +587,8 @@ declare class Project {
    * files.
    */
   private auxiliarySources;
+  /** Bytes explicitly supplied by a caller rather than read from disk. */
+  private overriddenSources;
   private resolutionWork;
   private resetResolutionState;
   /** Files whose imports may resolve differently after a local file appears. */
@@ -596,6 +599,14 @@ declare class Project {
   getResolvedSourceFiles: () => readonly string[];
   /** @internal Deterministic resolver/add/read work, for regression assertions. */
   getResolutionWork: () => ResolutionWork;
+  /** @internal Whether an operation has crossed into the TypeScript-backed API. */
+  hasMaterializedCompiler: () => boolean;
+  /** Source bytes from overlays, virtual filesystems, or disk, without creating a compiler. */
+  getSourceText: (filePath: string) => string | undefined;
+  /** Whether that same compiler-free source view can read a path. */
+  sourceExists: (filePath: string) => boolean;
+  /** Whether a caller supplied bytes that can differ from the path on disk. */
+  sourceIsOverridden: (filePath: string) => boolean;
   getSourceFile: (filePath: string) => SourceFile | undefined;
   /**
    * How many syntax errors this file's parse produced.

package/dist/index.d.mts

@@ -458,6 +458,7 @@ interface ProjectOptions extends ProjectOptions$1 {
    */
   deferInitialSourceFiles?: boolean;
   readFile: Runtime['fs']['readFileSync'];
+  fileExists?: Runtime['fs']['existsSync'];
   getFiles(): string[];
   hooks: Partial<BambooHooks>;
   parserOptions: ParserOptions;
@@ -586,6 +587,8 @@ declare class Project {
    * files.
    */
   private auxiliarySources;
+  /** Bytes explicitly supplied by a caller rather than read from disk. */
+  private overriddenSources;
   private resolutionWork;
   private resetResolutionState;
   /** Files whose imports may resolve differently after a local file appears. */
@@ -596,6 +599,14 @@ declare class Project {
   getResolvedSourceFiles: () => readonly string[];
   /** @internal Deterministic resolver/add/read work, for regression assertions. */
   getResolutionWork: () => ResolutionWork;
+  /** @internal Whether an operation has crossed into the TypeScript-backed API. */
+  hasMaterializedCompiler: () => boolean;
+  /** Source bytes from overlays, virtual filesystems, or disk, without creating a compiler. */
+  getSourceText: (filePath: string) => string | undefined;
+  /** Whether that same compiler-free source view can read a path. */
+  sourceExists: (filePath: string) => boolean;
+  /** Whether a caller supplied bytes that can differ from the path on disk. */
+  sourceIsOverridden: (filePath: string) => boolean;
   getSourceFile: (filePath: string) => SourceFile | undefined;
   /**
    * How many syntax errors this file's parse produced.

package/dist/index.mjs

@@ -982,6 +982,7 @@ var ParserResult = class {
 	/** The call site of `result`, when the encoder is recording them. */
 	originOf = (result) => {
 		if (!this.origins || !this.encoder.recordOrigins) return void 0;
+		if (result.atomOrigin) return result.atomOrigin;
 		const node = result.box?.getNode();
 		const sourceFile = node?.getSourceFile();
 		if (!node || !sourceFile) return void 0;
@@ -1748,6 +1749,8 @@ var Project = class {
 	* files.
 	*/
 	auxiliarySources = /* @__PURE__ */ new Set();
+	/** Bytes explicitly supplied by a caller rather than read from disk. */
+	overriddenSources = /* @__PURE__ */ new Map();
 	/** File-tree changes invalidate even successful resolutions (extension precedence can move). */
 	#fileTreeRevision = 0;
 	resolutionWork = {
@@ -1767,6 +1770,7 @@ var Project = class {
 		this.sourcePreparations = /* @__PURE__ */ new Map();
 		this.removedSourcePaths = /* @__PURE__ */ new Set();
 		this.auxiliarySources = /* @__PURE__ */ new Set();
+		this.overriddenSources = /* @__PURE__ */ new Map();
 		this.resolutionWork = {
 			moduleResolutionsAttempted: 0,
 			sourceFilesAdded: 0,
@@ -1795,6 +1799,22 @@ var Project = class {
 		this.#assertNotLoading();
 		return Object.freeze({ ...this.resolutionWork });
 	};
+	/** @internal Whether an operation has crossed into the TypeScript-backed API. */
+	hasMaterializedCompiler = () => this.#sourceFiles.project !== void 0;
+	/** Source bytes from overlays, virtual filesystems, or disk, without creating a compiler. */
+	getSourceText = (filePath) => {
+		const override = this.overriddenSources.get(this.normalizePath(filePath));
+		if (override !== void 0) return override;
+		try {
+			return this.options.readFile(filePath);
+		} catch {
+			return;
+		}
+	};
+	/** Whether that same compiler-free source view can read a path. */
+	sourceExists = (filePath) => this.overriddenSources.has(this.normalizePath(filePath)) || (this.options.fileExists?.(filePath) ?? this.getSourceText(filePath) !== void 0);
+	/** Whether a caller supplied bytes that can differ from the path on disk. */
+	sourceIsOverridden = (filePath) => this.overriddenSources.has(this.normalizePath(filePath));
 	getSourceFile = (filePath) => {
 		this.#assertNotLoading();
 		if (!this.project.has(filePath)) return void 0;
@@ -2526,6 +2546,7 @@ var Project = class {
 		*/
 		if (existing && existing.getFullText() === content) {
 			this.markAuxiliary(pathOf(existing), options.auxiliary);
+			this.overriddenSources.set(this.normalizePath(pathOf(existing)), content);
 			return existing;
 		}
 		this.invalidateSourcePreparation(filePath, existing);
@@ -2534,6 +2555,7 @@ var Project = class {
 		const sourceFile = this.project.createSourceFile(filePath, content, { scriptKind: scriptKindFor(filePath) });
 		if (!sourceFile) throw new Error(`bamboo: could not add ${filePath} to the project`);
 		this.markAuxiliary(pathOf(sourceFile), options.auxiliary);
+		this.overriddenSources.set(this.normalizePath(pathOf(sourceFile)), content);
 		return sourceFile;
 	};
 	/** Claim or release compiler ownership of one source, in the ledger's own spelling. */
@@ -2552,8 +2574,10 @@ var Project = class {
 			this.markTargetRemoved(this.normalizePath(pathOf(sourceFile)), sourceFile);
 			this.options.parserOptions.encoder.releaseFile(pathOf(sourceFile));
 			this.auxiliarySources.delete(this.normalizePath(pathOf(sourceFile)));
+			this.overriddenSources.delete(this.normalizePath(pathOf(sourceFile)));
 			return this.project.removeSourceFile(pathOf(sourceFile));
 		}
+		this.overriddenSources.delete(this.normalizePath(filePath));
 		return false;
 	};
 	/**
@@ -2572,7 +2596,11 @@ var Project = class {
 		this.#ensureSourceFiles();
 		const sourceFile = this.getSourceFile(filePath);
 		this.invalidate(false, pathOf(sourceFile));
-		if (!sourceFile) return;
+		if (!sourceFile) {
+			this.overriddenSources.delete(this.normalizePath(filePath));
+			return;
+		}
+		this.overriddenSources.delete(this.normalizePath(pathOf(sourceFile)));
 		this.invalidateSourcePreparation(filePath, sourceFile);
 		return this.project.reloadSourceFile(filePath);
 	};
@@ -2582,6 +2610,7 @@ var Project = class {
 		const files = this.getFiles();
 		this.invalidate();
 		for (const file of files) {
+			this.overriddenSources.delete(this.normalizePath(file));
 			const source = this.getSourceFile(file);
 			if (source) {
 				this.invalidateSourcePreparation(file, source);

package/package.json

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