@animus-ui/extract 0.1.19 → 0.1.21

package/dist/session.mjs

@@ -1,7 +1,7 @@
-import { B as collectExternalPackageSources, Ct as contentHash, Et as assembleStylesheet, F as findSheetAssetSpecifiers, G as isExcludedPackageRelativePath, H as extractSystemFilePackages, I as reportSurvivingAssetPlaceholders, J as unresolvableIncludesMessage, M as resolveAssetFile, O as postProcessCss, Q as sharesVolumeRoot, R as substituteSheetAssets, T as unreadableSourceDiagnostic, U as findPackageRoot, V as excludeCollectedPackages, W as firstOwners, X as createSourceIdentity, Y as walkPackageSources, Z as isPathWithinRoot, _ as runProjectAnalysis, _t as projectExternalFileOwners, a as assertNoErrorDiagnostics, ct as createExcludeMatcher, et as discoverFiles, f as serializeStaticCss, g as clearEngineCache, i as snapshotFilePlans, j as enforceExternalTokenContracts, k as resolveLightningTargets, kt as __require, lt as resolveMode, pt as createV2EngineApi, q as staleDistIncludesMessage, r as hashReplacementPlans, s as buildSystemPropsModule, t as toWatchKeys, u as loadSystemConfig, ut as resolveVerbosity, yt as DEFAULT_EXTENSIONS, z as createSourceCorpus } from "./pipeline-BuiItKT-.mjs";
+import { A as createSourceCorpus, At as contentHash, B as unresolvableIncludesMessage, Ct as noKitFilesDiagnostics, D as reportSurvivingAssetPlaceholders, E as generatedModuleCode, Et as unreadableSourceDiagnostic, F as findPackageRoot, G as createSourceIdentity, H as isJsonBlock, I as firstOwners, It as __require, K as isPathWithinRoot, L as isExcludedPackageRelativePath, M as engineImportParser, N as excludeCollectedPackages, Nt as assembleStylesheet, P as extractSystemFilePackages, S as resolveAssetFile, T as findSheetAssetSpecifiers, U as isJsonString, V as walkPackageSources, Y as discoverFiles, a as assertNoErrorDiagnostics, at as resolveVerbosity, ct as createV2EngineApi, d as serializeStaticCss, ft as projectExternalFileOwners, g as runProjectAnalysis, h as clearEngineCache, i as snapshotFilePlans, it as resolveMode, j as collectExternalPackageSources, k as substituteSheetAssets, kt as parseInternalWire, l as loadSystemConfig, mt as DEFAULT_EXTENSIONS, o as buildSystemPropsModule, q as sharesVolumeRoot, r as hashReplacementPlans, rt as createExcludeMatcher, t as toWatchKeys, v as postProcessCss, wt as surfaceManifestDiagnostics, x as enforceExternalTokenContracts, xt as isDeletedSource, y as resolveLightningTargets, z as staleDistIncludesMessage } from "./pipeline-BXY7Pf_D.mjs";
 import { randomUUID } from "crypto";
 import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, unlinkSync, watch, writeFileSync } from "fs";
-import { basename, extname, join, relative, resolve } from "path";
+import { basename, dirname, extname, isAbsolute, join, relative, resolve } from "path";
 //#region session/session-paths.ts
 /**
 * Session artifact names, path derivations, and artifact shapes. Imports no
@@ -257,6 +257,68 @@ function collectSessionAssets(sessionDir) {
 }
 //#endregion
 //#region session/resolve-packages.ts
+/** An exports target under the `import` condition, then `default`, as the
+*  system loader reads it; an array offers its targets in order. */
+function importTarget(value) {
+	if (isJsonString(value)) return value;
+	if (Array.isArray(value)) {
+		for (const entry of value) {
+			const target = importTarget(entry);
+			if (target !== null) return target;
+		}
+		return null;
+	}
+	if (!isJsonBlock(value)) return null;
+	return importTarget(value.import) ?? importTarget(value.default);
+}
+/** The exports entry for `subpath`: an exact key answers alone; otherwise
+*  the pattern with the longest prefix, then the longest suffix, wins. */
+function exportsTarget(exports, subpath) {
+	const map = isJsonBlock(exports) && Object.keys(exports).some((k) => k.startsWith(".")) ? exports : { ".": exports };
+	if (subpath in map) return importTarget(map[subpath]);
+	let best = null;
+	for (const [pattern, value] of Object.entries(map)) {
+		const star = pattern.indexOf("*");
+		if (star === -1 || pattern.indexOf("*", star + 1) !== -1) continue;
+		const prefix = pattern.slice(0, star);
+		const suffix = pattern.slice(star + 1);
+		if (!subpath.startsWith(prefix) || !subpath.endsWith(suffix) || subpath.length < prefix.length + suffix.length) continue;
+		if (!best || prefix.length > best.prefix.length || prefix.length === best.prefix.length && suffix.length > best.suffix.length) best = {
+			prefix,
+			suffix,
+			value
+		};
+	}
+	if (!best) return null;
+	const matched = subpath.slice(best.prefix.length, subpath.length - best.suffix.length);
+	return importTarget(best.value)?.replaceAll("*", matched) ?? null;
+}
+/** The entry an ES import of `name` resolves to through the package's
+*  `exports`, under the `import` condition, then `default`: what the Vite
+*  host and the system loader resolve. Null without an `exports` field, or
+*  when no target exists. */
+function resolveImportEntry(rootDir, name) {
+	const packageName = name.split("/").slice(0, name.startsWith("@") ? 2 : 1).join("/");
+	const subpath = `.${name.slice(packageName.length)}`;
+	for (let dir = rootDir;; dir = dirname(dir)) {
+		const manifest = join(dir, "node_modules", packageName, "package.json");
+		if (existsSync(manifest)) {
+			let exports;
+			try {
+				const parsed = parseInternalWire(readFileSync(manifest, "utf-8"), `${manifest} (a package manifest)`);
+				exports = isJsonBlock(parsed) ? parsed.exports : void 0;
+			} catch {
+				return null;
+			}
+			if (exports === void 0 || exports === null) return null;
+			const target = exportsTarget(exports, subpath);
+			if (target === null) return null;
+			const entryPath = resolve(dirname(manifest), target);
+			return existsSync(entryPath) ? realpathSync(entryPath) : null;
+		}
+		if (dir === dirname(dir)) return null;
+	}
+}
 function resolvePackagesByName(rootDir, names) {
 	if (names.length === 0) return {};
 	const nameSet = new Set(names);
@@ -284,6 +346,11 @@ function resolvePackagesByName(rootDir, names) {
 	} catch {}
 	for (const name of nameSet) {
 		if (resolved.has(name)) continue;
+		const importEntry = resolveImportEntry(rootDir, name);
+		if (importEntry !== null) {
+			packageMap[name] = relative(rootDir, importEntry);
+			continue;
+		}
 		try {
 			const entryPath = __require.resolve(name, { paths: [rootDir] });
 			packageMap[name] = relative(rootDir, entryPath);
@@ -303,6 +370,7 @@ const SHARED_CSS_KEY = "__animus_shared_css__";
 const SHARED_SYSTEM_PROPS_KEY = "__animus_shared_system_props__";
 const SHARED_EXTERNAL_DIRS_KEY = "__animus_external_pkg_dirs__";
 const SHARED_EXTERNAL_ENTRIES_KEY = "__animus_external_source_entries__";
+const SHARED_EXTERNAL_SIDE_EFFECTS_KEY = "__animus_external_side_effects__";
 const ANALYZED_HASHES_KEY = "__animus_analyzed_hashes__";
 const REPLACEMENT_EPOCH_KEY = "__animus_replacement_epoch__";
 const WATCH_TRANSACTION_KEY = "__animus_watch_transaction__";
@@ -368,6 +436,14 @@ function getSharedExternalEntries() {
 function setSharedExternalEntries(entries) {
 	singletonStore[SHARED_EXTERNAL_ENTRIES_KEY] = entries;
 }
+/** Specifier → its source entry's side effects, published with the shared
+*  entries; absent leaves the bundler's own classification. */
+function getSharedExternalSideEffects() {
+	return singletonStore[SHARED_EXTERNAL_SIDE_EFFECTS_KEY] || /* @__PURE__ */ new Map();
+}
+function setSharedExternalSideEffects(sideEffects) {
+	singletonStore[SHARED_EXTERNAL_SIDE_EFFECTS_KEY] = sideEffects;
+}
 function globalSlot(key) {
 	return {
 		get: () => singletonStore[key] ?? null,
@@ -553,6 +629,7 @@ function isDiskNumber(value) {
 /** Bundler-agnostic extraction pipeline: system load, source ingestion,
 *  analysis, emission, and watch-cycle diffing. Carries no bundler types. */
 var ExtractionSession = class {
+	host;
 	/** Set by the adapter before any pipeline run. */
 	rootDir = null;
 	/** Serialized path aliases, harvested by the adapter from bundler config. */
@@ -575,6 +652,9 @@ var ExtractionSession = class {
 	externalFileOwners = {};
 	/** External package specifier → absolute source entry path. */
 	externalSourceEntries = /* @__PURE__ */ new Map();
+	/** Specifier → its source entry's side effects, from the owning package's
+	*  `sideEffects`; absent leaves the bundler's own classification. */
+	externalSourceSideEffects = /* @__PURE__ */ new Map();
 	/** SourceId authority for this generation — roots realpath'd once per
 	*  pipeline; aliases recorded while files exist so deletions resolve. */
 	sourceIdentity = null;
@@ -609,6 +689,9 @@ var ExtractionSession = class {
 	/** Configured external files that could not be read. Incremental passes
 	*  re-collect nothing, so they replay these instead of passing strict. */
 	ingestionFailureDiagnostics = [];
+	/** Whether the corpus being analyzed left a file out, whose renders the
+	*  analysis cannot see. */
+	skippedSources = [];
 	/** Full package-resolution map from the last full pipeline — replayed by
 	*  incremental passes (sourceEntries alone omits dist-resolved packages). */
 	lastPackageMap = {};
@@ -663,10 +746,16 @@ var ExtractionSession = class {
 	debouncePending = /* @__PURE__ */ new Map();
 	sessionStartHygieneDone = false;
 	lcssTargets = null;
-	constructor(options) {
+	constructor(options, host = {}) {
+		this.host = host;
 		this.options = options;
 		this.staticCssJson = serializeStaticCss(options.staticCss);
 	}
+	/** Forgets that `relPath` could not be read once an incremental pass reads
+	*  or deletes it, so its cost stops holding pruning off. */
+	clearIngestionFailure(relPath) {
+		this.ingestionFailureDiagnostics = this.ingestionFailureDiagnostics.filter((diagnostic) => diagnostic.file !== relPath);
+	}
 	get sessionDir() {
 		return sessionArtifactDir(this.rootDir, this.sessionId);
 	}
@@ -694,6 +783,10 @@ var ExtractionSession = class {
 	/** Component count of the last published analysis, null before the first —
 	*  read by drivers instead of re-parsing the manifest JSON every cycle. */
 	lastComponentCount = null;
+	/** The loaded theme's token → variable map; null before the system loads. */
+	get variableMapJson() {
+		return this.system?.variableMapJson ?? null;
+	}
 	/** When superseded asset copies leave `assets/`: `'full-pipeline'` suits a
 	*  driver serving the dir in place, `'every-cycle'` one republishing it. */
 	staleAssetPruning = "full-pipeline";
@@ -829,6 +922,7 @@ var ExtractionSession = class {
 				owningRoot = resolved.owningRoot;
 			}
 			recordPrior(key);
+			this.clearIngestionFailure(key);
 			if (this.fileCache.delete(key)) {
 				removedAny = true;
 				if (owningRoot) {
@@ -869,6 +963,7 @@ var ExtractionSession = class {
 			} catch {
 				continue;
 			}
+			this.clearIngestionFailure(relPath);
 			const rawHash = contentHash(source);
 			const cached = this.fileCache.get(relPath);
 			const hash = rawHash;
@@ -916,6 +1011,7 @@ var ExtractionSession = class {
 					externalFileOwners: this.externalFileOwners
 				});
 				this.throwOnAbortedParse(ingested);
+				this.skippedSources = ingested.skippedOriginals ?? [];
 				if (this.systemReloadOwed) {
 					this.log("system reload: publishing the reload a parse hold deferred");
 					this.resetForHmr();
@@ -1003,7 +1099,8 @@ var ExtractionSession = class {
 		this.system = loadSystemConfig(engineApi, {
 			systemPath: resolvedSystemPath,
 			rootDir,
-			prefix: this.options.prefix
+			prefix: this.options.prefix,
+			prefixContextualVars: this.options.prefixContextualVars
 		});
 		this.assetCopyCache.clear();
 		this.assetDependencyPaths.clear();
@@ -1030,22 +1127,27 @@ var ExtractionSession = class {
 		bt.fileDiscovery = this.elapsed(t);
 		t = this.now();
 		const rawEntries = [];
+		const ingestionFailures = [];
 		for (const filePath of files) {
-			const source = readFileSync(filePath, "utf-8");
 			const relPath = relative(rootDir, filePath);
-			const hash = contentHash(source);
+			let source;
+			try {
+				source = readFileSync(filePath, "utf-8");
+			} catch (err) {
+				if (!isDeletedSource(err)) ingestionFailures.push(unreadableSourceDiagnostic(relPath, err));
+				continue;
+			}
 			rawEntries.push({
 				path: relPath,
 				source,
-				hash
+				hash: contentHash(source)
 			});
 		}
 		bt.fileRead = this.elapsed(t);
 		t = this.now();
-		const packageNames = extractSystemFilePackages(resolvedSystemPath);
+		const packageNames = extractSystemFilePackages(resolvedSystemPath, engineImportParser(engineApi()));
 		const preResolved = resolvePackagesByName(rootDir, packageNames);
 		const rawExternalFiles = /* @__PURE__ */ new Map();
-		const ingestionFailures = [];
 		const collected = await collectExternalPackageSources({
 			specifiers: packageNames,
 			resolveSpecifier: (name) => preResolved[name] ? resolve(rootDir, preResolved[name]) : null,
@@ -1055,7 +1157,9 @@ var ExtractionSession = class {
 			onSourceRead: (source, _relPath, absPath) => {
 				rawExternalFiles.set(absPath, contentHash(source));
 			},
-			onUnreadable: (relPath, err) => ingestionFailures.push(unreadableSourceDiagnostic(relPath, err)),
+			onUnreadable: (relPath, err) => {
+				if (!isDeletedSource(err)) ingestionFailures.push(unreadableSourceDiagnostic(relPath, err));
+			},
 			onPackageResolved: (_specifier, packageDir) => {
 				if (!this.onExternalRootResolved) return;
 				if (!this.sharesProjectVolume(rootDir, packageDir)) return;
@@ -1068,7 +1172,7 @@ var ExtractionSession = class {
 		});
 		this.lastExternalOutcomes = collected.outcomes;
 		this.ingestionFailureDiagnostics = ingestionFailures;
-		for (const record of collected.outcomes) if (record.outcome === "empty") this.warn(`include '${record.specifier}' resolved but discovered no component sources`);
+		surfaceManifestDiagnostics({ diagnostics: noKitFilesDiagnostics(collected.outcomes) }, (message) => this.warn(message));
 		const unresolvableMessage = unresolvableIncludesMessage(collected.outcomes);
 		if (unresolvableMessage !== null) {
 			if (this.options.strict) throw new Error(unresolvableMessage);
@@ -1127,6 +1231,7 @@ var ExtractionSession = class {
 			this.externalDirOwners = firstOwners(admitted.dirOwnerSets);
 			this.externalFileOwners = admitted.fileOwners;
 			this.externalSourceEntries = admitted.sourceEntries;
+			this.externalSourceSideEffects = admitted.sourceEntrySideEffects;
 			for (const entry of admitted.entries) {
 				const hash = contentHash(entry.source);
 				rawEntries.push({
@@ -1142,6 +1247,7 @@ var ExtractionSession = class {
 			try {
 				accepted = await this.corpus.prepare(rawEntries);
 				this.throwOnAbortedParse(accepted);
+				this.skippedSources = accepted.skippedOriginals ?? [];
 			} catch (err) {
 				this.debouncePending.clear();
 				this.writeAnalysisStatus("failed", pending, String(err));
@@ -1154,6 +1260,7 @@ var ExtractionSession = class {
 			this.publishSourceIngestion(accepted);
 			setSharedExternalDirs(admitted.packageDirs);
 			setSharedExternalEntries(admitted.sourceEntries);
+			setSharedExternalSideEffects(admitted.sourceEntrySideEffects);
 			this.onExternalRootsCommitted?.(this.externalWatchRoots);
 			setOwningWatchSession(this);
 		} catch (err) {
@@ -1174,6 +1281,7 @@ var ExtractionSession = class {
 			externalDirOwners: this.externalDirOwners,
 			externalFileOwners: this.externalFileOwners,
 			externalSourceEntries: this.externalSourceEntries,
+			externalSourceSideEffects: this.externalSourceSideEffects,
 			externalPackageDirs: this.externalPackageDirs,
 			ingestionFailureDiagnostics: this.ingestionFailureDiagnostics
 		};
@@ -1340,7 +1448,12 @@ var ExtractionSession = class {
 			pathAliasesJson: this.pathAliasesJson,
 			staticCssJson: this.staticCssJson,
 			externalDirs: this.externalPackageDirs.map((dir) => relative(this.rootDir, dir)),
-			devMode: this.engineDevMode(devMode)
+			devMode: this.engineDevMode(devMode),
+			analysisContext: {
+				skippedSources: [...this.skippedSources, ...this.ingestionFailureDiagnostics.map((d) => d.file)].map((file) => isAbsolute(file) ? relative(this.rootDir, file) : file),
+				unbundledComputedImports: this.host.unbundledComputedImports,
+				packageDirs: this.externalPackageDirs.map((dir) => relative(this.rootDir, dir))
+			}
 		};
 		this.writeAnalysisStatus("analyzing", pending);
 		const result = runProjectAnalysis(engineApi, {
@@ -1394,6 +1507,12 @@ var ExtractionSession = class {
 			warn: (message) => this.warn(message),
 			prefix: `[${this.driverLabel}]`
 		});
+		reportSurvivingAssetPlaceholders(generatedModuleCode(manifest), {
+			strict: this.options.strict,
+			warn: (message) => this.warn(message),
+			prefix: `[${this.driverLabel}]`,
+			surface: "generated runtime modules"
+		});
 		setSharedCss(fullCss);
 		const systemPropsContent = buildSystemPropsModule({
 			systemPropMapJson: JSON.stringify(manifest?.system_prop_map ?? {}),
@@ -1986,4 +2105,4 @@ function startTurbopackWatcher(session, rootDir, options = {}) {
 	};
 }
 //#endregion
-export { ANIMUS_ARTIFACT_DIR, ANIMUS_CSS_MODULE_ID, CLI_COMMIT_ARTIFACT, CLI_LOCK_ARTIFACT, CLI_LOCK_HEARTBEAT_INTERVAL_MS, CLI_LOCK_STALE_AFTER_MS, ExtractionSession, MANIFEST_ARTIFACT, SESSION_ASSETS_DIR, STYLES_ARTIFACT, SYSTEM_PROPS_ARTIFACT, TURBOPACK_SYSTEM_PROPS_ID, analysisCommitPath, analysisInputsPath, analysisStatusPath, checkLockLiveness, collectSessionAssets, decodeCommitRecord, engineApi, getAnalysisStartedPromise, getAnalyzedHashes, getManifestJson, getReplacementEpoch, getSessionArtifactDir, getSharedCss, getSharedExternalDirs, getSharedExternalEntries, getSharedSystemProps, holdDirectoryClaim, isLockHolderAlive, lockRecordBytes, manifestPath, pruneStaleAssets, readCliLockRecord, readJsonEnvelope, replacementEpochPath, resetAnalysisStartedPromise, runSessionPipeline, sessionArtifactDir, setAnalysisStartedPromise, setSharedEngine, startTurbopackWatcher, stylesPath, systemPropsPath, verifyCommitRecord };
+export { ANIMUS_ARTIFACT_DIR, ANIMUS_CSS_MODULE_ID, CLI_COMMIT_ARTIFACT, CLI_LOCK_ARTIFACT, CLI_LOCK_HEARTBEAT_INTERVAL_MS, CLI_LOCK_STALE_AFTER_MS, ExtractionSession, MANIFEST_ARTIFACT, SESSION_ASSETS_DIR, STYLES_ARTIFACT, SYSTEM_PROPS_ARTIFACT, TURBOPACK_SYSTEM_PROPS_ID, analysisCommitPath, analysisInputsPath, analysisStatusPath, checkLockLiveness, collectSessionAssets, decodeCommitRecord, engineApi, getAnalysisStartedPromise, getAnalyzedHashes, getManifestJson, getReplacementEpoch, getSessionArtifactDir, getSharedCss, getSharedExternalDirs, getSharedExternalEntries, getSharedExternalSideEffects, getSharedSystemProps, holdDirectoryClaim, isLockHolderAlive, lockRecordBytes, manifestPath, pruneStaleAssets, readCliLockRecord, readJsonEnvelope, replacementEpochPath, resetAnalysisStartedPromise, runSessionPipeline, sessionArtifactDir, setAnalysisStartedPromise, setSharedEngine, startTurbopackWatcher, stylesPath, systemPropsPath, verifyCommitRecord };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-ui/extract",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "description": "Animus static CSS extraction pipeline (Rust/NAPI)",
   "keywords": [
     "animus",
@@ -55,13 +55,13 @@
     "build:v2:debug": "cd crates/extract-v2 && bunx napi build --platform --no-js"
   },
   "dependencies": {
-    "@animus-ui/properties": "0.1.19",
+    "@animus-ui/properties": "0.1.21",
     "browserslist": "^4.28.8",
     "lightningcss": "^1.33.0"
   },
   "devDependencies": {
-    "@animus-ui/assertions": "0.1.19",
-    "@animus-ui/system": "0.1.19",
+    "@animus-ui/assertions": "0.1.21",
+    "@animus-ui/system": "0.1.21",
     "@mdx-js/mdx": "3.1.1",
     "@napi-rs/cli": "^3.10.5",
     "svelte": "5.57.0"