@animus-ui/extract 0.1.18 → 0.1.19

package/dist/{pipeline-Dr-I4Xhl.mjs → pipeline-BuiItKT-.mjs}

@@ -1166,7 +1166,7 @@ function createV2EngineApi(deps) {
 }
 //#endregion
 //#region pipeline/engine-retirement.ts
-const RETIRED_ENGINE_MESSAGE = "animus: extraction engine 'v1' was retired (openspec: retire-extract-v1) — v2 is the only engine; remove the engine option / ANIMUS_ENGINE override";
+const RETIRED_ENGINE_MESSAGE = "animus: the 'v1' extraction engine is no longer supported, and v2 is the only engine. Remove the engine option from your Animus config and unset the ANIMUS_ENGINE environment variable.";
 function assertNoRetiredEngineSelection(engineOption) {
 	if (engineOption === "v1" || process.env.ANIMUS_ENGINE === "v1") throw new Error(RETIRED_ENGINE_MESSAGE);
 }
@@ -2023,6 +2023,31 @@ function substituteAssetPlaceholders(css, urlBySpecifier) {
 	}
 	return out;
 }
+function findSheetAssetSpecifiers(sheets) {
+	return [.../* @__PURE__ */ new Set([
+		...findAssetSpecifiers(sheets.variableCss),
+		...findAssetSpecifiers(sheets.globalCss),
+		...findAssetSpecifiers(sheets.componentCss)
+	])];
+}
+/** The one substitution step every emitted sheet passes through. */
+function substituteSheetAssets(sheets, urlBySpecifier) {
+	return {
+		variableCss: substituteAssetPlaceholders(sheets.variableCss, urlBySpecifier),
+		globalCss: substituteAssetPlaceholders(sheets.globalCss, urlBySpecifier),
+		componentCss: substituteAssetPlaceholders(sheets.componentCss, urlBySpecifier)
+	};
+}
+const UNSUBSTITUTED_ASSET_CODE = "animus.asset.unsubstituted-placeholder";
+/** A placeholder in emitted CSS is a broken URL in the browser: it fails a
+*  strict build and warns otherwise. */
+function reportSurvivingAssetPlaceholders(css, report) {
+	const specifiers = findAssetSpecifiers(css);
+	if (specifiers.length === 0) return;
+	const message = `${report.prefix} asset() placeholders reached emitted CSS unsubstituted: ${specifiers.join(", ")} (${UNSUBSTITUTED_ASSET_CODE})`;
+	if (report.strict) throw new Error(message);
+	report.warn(message);
+}
 //#endregion
 //#region pipeline/resolve-asset.ts
 /**
@@ -2320,12 +2345,30 @@ const INVALID_PROPERTY_REGISTRATION = "animus.theme.invalid-property-registratio
 /** Minted when a sealed kit with registered vocabulary is consumed through
 *  the deprecated `from()`/`includes:` verbs. */
 const VOCABULARY_LEGACY_VERB = "animus.vocabulary.legacy-verb";
+/** A `var()` fallback that never applies: the property is registered with an
+*  initial value. */
+const PROPERTY_FALLBACK_SUPPRESSED = "animus.property.fallback-suppressed";
+/** The same, where the fallback heads a chain of further `var()` reads. */
+const PROPERTY_FALLBACK_CHAIN_SUPPRESSED = "animus.property.fallback-chain-suppressed";
+/** A declared property set in keyframes or transitioned without a typed
+*  registration, so it does not interpolate. */
+const PROPERTY_UNREGISTERED_ANIMATION = "animus.property.unregistered-animation";
+/** The same, where `allow-discrete` shows interpolation was intended. */
+const PROPERTY_DISCRETE_ANIMATION = "animus.property.discrete-animation";
+/** A custom property whose resolved value is `var()` of itself, which makes
+*  it invalid at computed-value time. */
+const PROPERTY_SELF_REFERENCE = "animus.property.self-reference";
 const DIAGNOSTIC_SEVERITY = /* @__PURE__ */ new Map([
 	[SELECTOR_UNSUPPORTED_SUBJECT, "error"],
 	[UNREADABLE_SOURCE_FILE, "error"],
 	[VOCABULARY_COLLISION, "warn"],
 	[VOCABULARY_LEGACY_VERB, "warn"],
-	[INVALID_PROPERTY_REGISTRATION, "error"]
+	[INVALID_PROPERTY_REGISTRATION, "error"],
+	[PROPERTY_FALLBACK_SUPPRESSED, "info"],
+	[PROPERTY_FALLBACK_CHAIN_SUPPRESSED, "warn"],
+	[PROPERTY_UNREGISTERED_ANIMATION, "info"],
+	[PROPERTY_DISCRETE_ANIMATION, "warn"],
+	[PROPERTY_SELF_REFERENCE, "warn"]
 ]);
 /** An unlisted code is `warn`: a witness kind from a newer system package
 *  must not fail the strict build of a host that predates its writer. */
@@ -2390,9 +2433,13 @@ function surfaceManifestDiagnostics(manifest, warn, policy = {}) {
 		let line = null;
 		if (diagnostic.kind === "bail") line = `⚠ ${diagnostic.component} not extracted: ${diagnostic.message}`;
 		else if (diagnostic.kind === "skip") line = `⚠ ${diagnostic.component}: skipped ${diagnostic.message}`;
-		else if (diagnostic.kind === "warn") line = `⚠ ${diagnostic.file}: ${diagnostic.component}: ${diagnostic.message}`;
+		else if (diagnostic.kind === "warn") line = `${diagnostic.severity === "info" ? "ℹ" : "⚠"} ${diagnostic.file}: ${diagnostic.component}: ${diagnostic.message}`;
 		if (line === null) continue;
 		if (diagnostic.code && !diagnostic.message.includes(diagnostic.code)) line += ` [${diagnostic.code}]`;
+		if (diagnostic.severity === "info") {
+			policy.info?.(line);
+			continue;
+		}
 		if (policy.strict && diagnostic.severity === "error") {
 			errors.push(`${diagnostic.code ?? "error"} — ${diagnostic.component}: ${diagnostic.message}`);
 			continue;
@@ -2402,6 +2449,315 @@ function surfaceManifestDiagnostics(manifest, warn, policy = {}) {
 	if (errors.length > 0) throw new Error(`[animus] strict: ${errors.length} error diagnostic(s):\n${errors.join("\n")}`);
 }
 //#endregion
+//#region pipeline/property-registrations.ts
+const PROPERTY_RULE = /@property\s+(--[\w-]+)\s*\{[^}]*\}\n?/g;
+/** The data types a registration's `syntax` may name. */
+const SYNTAX_TYPES = /* @__PURE__ */ new Set([
+	"angle",
+	"color",
+	"custom-ident",
+	"image",
+	"integer",
+	"length",
+	"length-percentage",
+	"number",
+	"percentage",
+	"resolution",
+	"string",
+	"time",
+	"transform-function",
+	"transform-list",
+	"url"
+]);
+const SYNTAX_COMPONENT = /^(?:<([a-z-]+)>[+#]?|-?[a-zA-Z_][\w-]*)$/;
+/** The syntax types whose values can carry a font- or container-relative
+*  unit, which makes a typed initial value depend on context. */
+const DIMENSION_TYPES = /* @__PURE__ */ new Set([
+	"image",
+	"length",
+	"length-percentage",
+	"transform-function",
+	"transform-list"
+]);
+const RELATIVE_UNIT = /(?:\d|\.)(?:r?em|r?ex|r?cap|r?ch|r?ic|r?lh|cq(?:w|h|i|b|min|max))\b/i;
+const SUBSTITUTION = /\b(?:var|env|attr)\(/i;
+/** Quoted strings and `url()` hold text, never units or substitutions. */
+const LITERAL_TEXT = /"(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*'|url\([^)]*\)/gi;
+/**
+* Removes the `@property` rules browsers would ignore — an unknown syntax
+* component, a syntax other than `*` without an initial value, an initial
+* value that depends on context, or one the syntax does not accept.
+* Minifying a stylesheet that contains such a rule can also fail.
+*/
+function splitInvalidPropertyRegistrations(css) {
+	const invalid = [];
+	return {
+		css: css.replace(PROPERTY_RULE, (rule, name) => {
+			const reason = registrationFailure(rule);
+			if (reason === null) return rule;
+			invalid.push({
+				name,
+				reason
+			});
+			return "";
+		}),
+		invalid
+	};
+}
+/** The registrations in `css`, by custom-property name. */
+function propertyRegistrations(css) {
+	const registrations = /* @__PURE__ */ new Map();
+	for (const match of css.matchAll(PROPERTY_RULE)) registrations.set(match[1], readRegistration(match[0]));
+	return registrations;
+}
+function readRegistration(rule) {
+	return {
+		syntax: /syntax:\s*"([^"]*)"/.exec(rule)?.[1]?.trim() ?? "",
+		initialValue: /initial-value\s*:\s*([^;}]*)/.exec(rule)?.[1]?.trim()
+	};
+}
+function registrationFailure(rule) {
+	const { syntax, initialValue } = readRegistration(rule);
+	if (syntax !== "*") {
+		const components = syntax.split("|").map((component) => ({
+			text: component.trim(),
+			match: SYNTAX_COMPONENT.exec(component.trim())
+		}));
+		const unknown = components.find(({ match }) => match === null || match[1] !== void 0 && !SYNTAX_TYPES.has(match[1]));
+		if (unknown !== void 0) return `syntax "${syntax}" has the unknown component "${unknown.text}"`;
+		if (initialValue === void 0) return `syntax "${syntax}" needs an initialValue`;
+		const dimensional = components.some(({ match }) => match?.[1] !== void 0 && DIMENSION_TYPES.has(match[1]));
+		const value = initialValue.replace(LITERAL_TEXT, "");
+		if (SUBSTITUTION.test(value) || dimensional && RELATIVE_UNIT.test(value)) return `initialValue "${initialValue}" depends on context; font- and container-relative units and var(), env() and attr() are not allowed`;
+	}
+	try {
+		transform({
+			filename: "animus-registrations.css",
+			code: Buffer.from(rule)
+		});
+		return null;
+	} catch (error) {
+		const detail = error instanceof Error ? error.message : String(error);
+		return `the CSS parser rejects \`${rule.trim()}\` (${detail})`;
+	}
+}
+//#endregion
+//#region pipeline/property-diagnostics.ts
+/**
+* Reports custom properties that will not behave as their CSS suggests: a
+* property that refers to itself and, once the system emits an `@property`
+* rule, a fallback an initial value suppresses and an animated property that
+* cannot interpolate. The CSS itself is never changed.
+*/
+function checkCustomProperties(input) {
+	const registered = propertyRegistrations(input.system.variableCss);
+	const declared = declaredProperties(input.system.contextualVarsJson);
+	const findings = [];
+	const sheets = [{
+		css: input.componentCss,
+		owner: componentOwner(input.manifest)
+	}, {
+		css: input.globalCss,
+		owner: globalOwner
+	}];
+	for (const { css, owner } of sheets) {
+		const parsed = declarations(css);
+		const discreteRules = new Set(parsed.filter((d) => d.property === "transition-behavior" && /\ballow-discrete\b/.test(d.value)).map((d) => d.rule));
+		for (const declaration of parsed) {
+			const found = (code, property, message) => findings.push({
+				code,
+				property,
+				message,
+				owner: owner(declaration)
+			});
+			if (isSelfReference(declaration)) {
+				found(PROPERTY_SELF_REFERENCE, declaration.property, `${declaration.property} resolves to var(${declaration.property}), a reference to itself, so it is invalid at computed-value time. Give it a value other than its own name`);
+				continue;
+			}
+			if (registered.size === 0) continue;
+			for (const read of varReads(declaration.value)) {
+				const registration = registered.get(read.name);
+				if (read.fallback === void 0 || registration?.initialValue === void 0) continue;
+				const chain = read.fallback.startsWith("var(");
+				found(chain ? PROPERTY_FALLBACK_CHAIN_SUPPRESSED : PROPERTY_FALLBACK_SUPPRESSED, read.name, chain ? `var(${read.name}, ${read.fallback}) never reads its fallback chain: ${read.name} is registered with initial-value ${registration.initialValue}, which applies whenever it is unset. Remove the initial value or reorder the chain` : `var(${read.name}, ${read.fallback}) never uses its fallback: ${read.name} is registered with initial-value ${registration.initialValue}, which applies whenever it is unset`);
+			}
+			for (const animated of animatedProperties(declaration, discreteRules)) {
+				if (!declared.has(animated.name)) continue;
+				const reason = interpolationGap(registered.get(animated.name));
+				if (reason === null) continue;
+				if (animated.discrete) found(PROPERTY_DISCRETE_ANIMATION, animated.name, `${animated.name} is transitioned with allow-discrete but ${reason}, so it flips at the midpoint instead of interpolating. Register it with a typed syntax`);
+				else found(PROPERTY_UNREGISTERED_ANIMATION, animated.name, `${animated.name} is ${animated.how} but ${reason}, so it changes in one step instead of interpolating. Register it with a typed syntax to animate it`);
+			}
+		}
+	}
+	return toDiagnostics(findings);
+}
+function declaredProperties(contextualVarsJson) {
+	if (!contextualVarsJson) return /* @__PURE__ */ new Set();
+	const byScale = parseInternalWire(contextualVarsJson, "contextualVarsJson (the theme's contextual variable names)");
+	return new Set(Object.values(byScale).flatMap((names) => names.map((name) => `--${name}`)));
+}
+/** Declarations in engine-emitted CSS: one `property: value` per `;`. */
+function declarations(css) {
+	const found = [];
+	const stack = [];
+	let rules = 0;
+	let segment = 0;
+	let parens = 0;
+	let quote = null;
+	const take = (end) => {
+		const text = css.slice(segment, end);
+		const colon = text.indexOf(":");
+		const current = stack[stack.length - 1];
+		if (current === void 0 || colon <= 0) return;
+		found.push({
+			property: text.slice(0, colon).trim(),
+			value: text.slice(colon + 1).replace(/;$/, "").trim(),
+			start: segment + (text.length - text.trimStart().length),
+			end,
+			rule: current.rule,
+			context: stack.map((entry) => entry.prelude)
+		});
+	};
+	for (let i = 0; i < css.length; i += 1) {
+		const c = css[i];
+		if (quote !== null) {
+			if (c === "\\") i += 1;
+			else if (c === quote) quote = null;
+			continue;
+		}
+		if (c === "\"" || c === "'") quote = c;
+		else if (c === "(") parens += 1;
+		else if (c === ")") parens -= 1;
+		else if (parens === 0 && c === "{") {
+			stack.push({
+				prelude: css.slice(segment, i).trim(),
+				rule: rules
+			});
+			rules += 1;
+			segment = i + 1;
+		} else if (parens === 0 && c === ";") {
+			take(i + 1);
+			segment = i + 1;
+		} else if (parens === 0 && c === "}") {
+			take(i);
+			stack.pop();
+			segment = i + 1;
+		}
+	}
+	return found;
+}
+function isSelfReference(declaration) {
+	return declaration.property.startsWith("--") && declaration.value.replace(/\s+/g, "") === `var(${declaration.property})`;
+}
+/** Every `var()` read in `value`, nested fallbacks included. */
+function varReads(value) {
+	const reads = [];
+	for (const match of value.matchAll(/var\(\s*(--[\w-]+)\s*/g)) {
+		const after = (match.index ?? 0) + match[0].length;
+		if (value[after] !== ",") {
+			reads.push({
+				name: match[1],
+				fallback: void 0
+			});
+			continue;
+		}
+		let depth = 1;
+		let close = after + 1;
+		for (; close < value.length && depth > 0; close += 1) if (value[close] === "(") depth += 1;
+		else if (value[close] === ")") depth -= 1;
+		reads.push({
+			name: match[1],
+			fallback: value.slice(after + 1, close - 1).trim()
+		});
+	}
+	return reads;
+}
+/** Custom properties this declaration sets in a keyframe or names in a
+*  transition. */
+function animatedProperties(declaration, discreteRules) {
+	const keyframes = declaration.context.find((prelude) => prelude.startsWith("@keyframes"));
+	if (keyframes !== void 0 && declaration.property.startsWith("--")) return [{
+		name: declaration.property,
+		how: `set in ${keyframes}`,
+		discrete: false
+	}];
+	if (declaration.property !== "transition" && declaration.property !== "transition-property") return [];
+	return topLevelItems(declaration.value).flatMap((item) => {
+		const property = item.trim().split(/\s+/)[0] ?? "";
+		return property.startsWith("--") ? [{
+			name: property,
+			how: "transitioned",
+			discrete: /\ballow-discrete\b/.test(item) || discreteRules.has(declaration.rule)
+		}] : [];
+	});
+}
+function topLevelItems(value) {
+	const items = [];
+	let depth = 0;
+	let start = 0;
+	for (let i = 0; i < value.length; i += 1) if (value[i] === "(") depth += 1;
+	else if (value[i] === ")") depth -= 1;
+	else if (value[i] === "," && depth === 0) {
+		items.push(value.slice(start, i));
+		start = i + 1;
+	}
+	items.push(value.slice(start));
+	return items;
+}
+/** Why a property cannot interpolate, or `null` when it can. */
+function interpolationGap(registration) {
+	if (registration === void 0) return "it is not registered";
+	if (registration.syntax === "*") return "it is registered with the universal syntax \"*\"";
+	return null;
+}
+function componentOwner(manifest) {
+	const components = Object.values(manifest.components);
+	return (declaration) => {
+		const selector = [...declaration.context].reverse().find((prelude) => !prelude.startsWith("@"));
+		const classes = (selector ?? "").match(/\.-?[_a-zA-Z][\w-]*/g) ?? [];
+		for (const dotted of classes) {
+			const name = dotted.slice(1);
+			const owner = components.find((component) => name === component.class_name || name.startsWith(`${component.class_name}--`) || component.replacement.includes(`"${name}"`));
+			if (owner) return {
+				file: owner.file,
+				component: owner.binding
+			};
+		}
+		return {
+			file: "styles",
+			component: selector ?? "stylesheet"
+		};
+	};
+}
+function globalOwner(declaration) {
+	const keyframes = declaration.context.find((prelude) => prelude.startsWith("@keyframes"));
+	const selector = [...declaration.context].reverse().find((prelude) => !prelude.startsWith("@"));
+	return {
+		file: "system",
+		component: keyframes ?? selector ?? "global styles"
+	};
+}
+/** One diagnostic per code, property and owner. */
+function toDiagnostics(findings) {
+	const seen = /* @__PURE__ */ new Set();
+	const diagnostics = [];
+	for (const finding of findings) {
+		const key = `${finding.code}|${finding.property}|${finding.owner.file}|${finding.owner.component}`;
+		if (seen.has(key)) continue;
+		seen.add(key);
+		diagnostics.push({
+			file: finding.owner.file,
+			component: finding.owner.component,
+			kind: "warn",
+			message: `${finding.message} (${finding.code})`,
+			code: finding.code,
+			severity: severityFor(finding.code)
+		});
+	}
+	return diagnostics;
+}
+//#endregion
 //#region pipeline/unit-fallback.ts
 /** A digit run after one of these continues a word (`#b1b1b7`, `ss01`,
 *  `U+0025`), so it is not a bare number. The extractor predicts this pass
@@ -2498,11 +2854,19 @@ function runProjectAnalysis(engineApi, opts) {
 	const extractMs = Math.round(performance.now() - t);
 	t = performance.now();
 	const manifest = JSON.parse(manifestJson);
+	const propertyDiagnostics = checkCustomProperties({
+		system: opts.system,
+		manifest,
+		componentCss: applyUnitFallback(manifest.css),
+		globalCss: manifest.sheets.global
+	});
 	surfaceManifestDiagnostics(manifest, opts.warn, {
 		strict: opts.strict,
+		info: opts.info,
 		prepend: [
 			...collectSelectorAliasDiagnostics(opts.system.selectorAliasesJson),
 			...systemLoadDiagnostics(opts.system),
+			...propertyDiagnostics,
 			...opts.extraDiagnostics ?? []
 		]
 	});
@@ -2597,88 +2961,6 @@ function applyPrefix(prefix, variableMapJson, variableCss, themeJson, contextual
 	return result;
 }
 //#endregion
-//#region pipeline/property-registrations.ts
-const PROPERTY_RULE = /@property\s+(--[\w-]+)\s*\{[^}]*\}\n?/g;
-/** The data types a registration's `syntax` may name. */
-const SYNTAX_TYPES = /* @__PURE__ */ new Set([
-	"angle",
-	"color",
-	"custom-ident",
-	"image",
-	"integer",
-	"length",
-	"length-percentage",
-	"number",
-	"percentage",
-	"resolution",
-	"string",
-	"time",
-	"transform-function",
-	"transform-list",
-	"url"
-]);
-const SYNTAX_COMPONENT = /^(?:<([a-z-]+)>[+#]?|-?[a-zA-Z_][\w-]*)$/;
-/** The syntax types whose values can carry a font- or container-relative
-*  unit, which makes a typed initial value depend on context. */
-const DIMENSION_TYPES = /* @__PURE__ */ new Set([
-	"image",
-	"length",
-	"length-percentage",
-	"transform-function",
-	"transform-list"
-]);
-const RELATIVE_UNIT = /(?:\d|\.)(?:r?em|r?ex|r?cap|r?ch|r?ic|r?lh|cq(?:w|h|i|b|min|max))\b/i;
-const SUBSTITUTION = /\b(?:var|env|attr)\(/i;
-/** Quoted strings and `url()` hold text, never units or substitutions. */
-const LITERAL_TEXT = /"(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*'|url\([^)]*\)/gi;
-/**
-* Removes the `@property` rules browsers would ignore — an unknown syntax
-* component, a syntax other than `*` without an initial value, an initial
-* value that depends on context, or one the syntax does not accept.
-* Minifying a stylesheet that contains such a rule can also fail.
-*/
-function splitInvalidPropertyRegistrations(css) {
-	const invalid = [];
-	return {
-		css: css.replace(PROPERTY_RULE, (rule, name) => {
-			const reason = registrationFailure(rule);
-			if (reason === null) return rule;
-			invalid.push({
-				name,
-				reason
-			});
-			return "";
-		}),
-		invalid
-	};
-}
-function registrationFailure(rule) {
-	const syntax = /syntax:\s*"([^"]*)"/.exec(rule)?.[1]?.trim() ?? "";
-	const initialValue = /initial-value\s*:\s*([^;}]*)/.exec(rule)?.[1]?.trim();
-	if (syntax !== "*") {
-		const components = syntax.split("|").map((component) => ({
-			text: component.trim(),
-			match: SYNTAX_COMPONENT.exec(component.trim())
-		}));
-		const unknown = components.find(({ match }) => match === null || match[1] !== void 0 && !SYNTAX_TYPES.has(match[1]));
-		if (unknown !== void 0) return `syntax "${syntax}" has the unknown component "${unknown.text}"`;
-		if (initialValue === void 0) return `syntax "${syntax}" needs an initialValue`;
-		const dimensional = components.some(({ match }) => match?.[1] !== void 0 && DIMENSION_TYPES.has(match[1]));
-		const value = initialValue.replace(LITERAL_TEXT, "");
-		if (SUBSTITUTION.test(value) || dimensional && RELATIVE_UNIT.test(value)) return `initialValue "${initialValue}" depends on context; font- and container-relative units and var(), env() and attr() are not allowed`;
-	}
-	try {
-		transform({
-			filename: "animus-registrations.css",
-			code: Buffer.from(rule)
-		});
-		return null;
-	} catch (error) {
-		const detail = error instanceof Error ? error.message : String(error);
-		return `the CSS parser rejects \`${rule.trim()}\` (${detail})`;
-	}
-}
-//#endregion
 //#region pipeline/system-config.ts
 /**
 * Load and normalize a SystemInstance; `prefix` namespaces every CSS
@@ -2719,6 +3001,7 @@ function loadSystemConfig(engineApi, opts) {
 		sourceThemeManifestsJson: config.sourceThemeManifests || null
 	};
 	if (declarationScalesJson) system.declarationScalesJson = declarationScalesJson;
+	if (config.propertyRecordsJson) system.propertyRecordsJson = config.propertyRecordsJson;
 	if (registrations.invalid.length > 0) system.invalidPropertyRegistrations = registrations.invalid;
 	return system;
 }
@@ -2803,31 +3086,6 @@ function buildSystemPropsModule(opts) {
 	return `export const systemPropMap = ${opts.systemPropMapJson};\nexport const systemPropGroups = ${opts.groupRegistryJson};\nexport const dynamicPropConfig = ${JSON.stringify(dynamicPropConfig)};\nexport const transforms = ${transformsSource(opts.admittedTransforms)};\n` + (opts.typedSystemProps.length > 0 ? `export const typedSystemProps = ${JSON.stringify(opts.typedSystemProps)};\n` : "");
 }
 //#endregion
-//#region pipeline/timing-waterfall.ts
-const RUST_TIMING_PHASES = [
-	["parseAndWalk", "parse+walk"],
-	["importResolution", "imports"],
-	["extensionProvenance", "provenance"],
-	["topologicalSort", "topo-sort"],
-	["chainEvaluation", "chains"],
-	["jsxScanning", "jsx-scan"],
-	["systemPropAggregation", "sys-props"],
-	["usageLedger", "usage"],
-	["reconciliation", "reconcile"],
-	["cssGeneration", "css-gen"],
-	["manifestSerialization", "serialize"]
-];
-function formatRustTimingWaterfall(timing, opts) {
-	const lines = [];
-	for (const [key, label] of RUST_TIMING_PHASES) {
-		const ms = timing[key] ?? 0;
-		const pad = " ".repeat(Math.max(0, opts.labelWidth - label.length));
-		const extra = key === "parseAndWalk" ? `  (${timing.fileCount ?? 0} files, ${timing.cacheHits ?? 0} cached)` : "";
-		lines.push(`${opts.indent}${label}${pad}${String(ms).padStart(5)}ms${extra}`);
-	}
-	return lines;
-}
-//#endregion
 //#region pipeline/tsconfig-paths.ts
 /**
 * tsconfig `paths` → alias pairs, for drivers with no live bundler config.
@@ -3094,4 +3352,4 @@ function realpathThroughNearestExistingAncestor(path) {
 	}
 }
 //#endregion
-export { AnimusConfigError as $, resolveLightningTargets as A, extractSystemFilePackages as B, isUnresolvedParentDrop as C, ANIMUS_LAYERS as Ct, unresolvedParentName as D, __require as Dt, unreadableSourceDiagnostic as E, validateLayerOrder as Et, findAssetSpecifiers as F, staleDistIncludesMessage as G, firstOwners as H, substituteAssetPlaceholders as I, createSourceIdentity as J, unresolvableIncludesMessage as K, createSourceCorpus as L, enforceExternalTokenContracts as M, resolveAssetFile as N, vocabularyWitnessDiagnostics as O, resolveThroughPathAliases as P, discoverFiles as Q, collectExternalPackageSources as R, VOCABULARY_LEGACY_VERB as S, buildAnalyzeProjectArgs as St, systemLoadDiagnostics as T, stripLeadingLayerDeclaration as Tt, isExcludedPackageRelativePath as U, findPackageRoot as V, resolveAbsolutePathSpecifier as W, sharesVolumeRoot as X, isPathWithinRoot as Y, compareDiscoveryOrder as Z, clearEngineCache as _, DEFAULT_EXTENSIONS as _t, assertNoErrorDiagnostics as a, assertKnownOptionKeys as at, INVALID_PROPERTY_REGISTRATION as b, preprocessMdx as bt, buildSystemPropsModule as c, resolveVerbosity as ct, loadSystemConfig as d, createV2EngineApi as dt, CORE_OPTION_KEYS as et, applyPrefix as f, ingestSourceEntries as ft, buildAnalysisInputs as g, adaptSvelteSource as gt, stableStringify as h, projectExternalFileOwners as ht, snapshotFilePlans as i, STRUCTURAL_EXCLUDE as it, buildPathAliasesJson as j, postProcessCss as k, buildDynamicPropConfig as l, RETIRED_ENGINE_MESSAGE as lt, camelToKebab as m, parseFilesJson as mt, diffFilePlans as n, DRIVER_NAMESPACES as nt, readTsconfigAliasPairs as o, createExcludeMatcher as ot, serializeStaticCss as p, isAdvisorySourceDiagnostic as pt, walkPackageSources as q, hashReplacementPlans as r, REPLACEABLE_DEFAULT_EXCLUDE as rt, formatRustTimingWaterfall as s, resolveMode as st, toWatchKeys as t, DEFAULT_EXCLUDE as tt, runStructuralSelfCheck as u, assertNoRetiredEngineSelection as ut, runProjectAnalysis as v, ENGINE_TRANSFORM_EXTENSIONS as vt, surfaceManifestDiagnostics as w, assembleStylesheet as wt, VOCABULARY_COLLISION as x, contentHash as xt, applyUnitFallback as y, isEngineTransformExtension as yt, excludeCollectedPackages as z };
+export { compareDiscoveryOrder as $, buildPathAliasesJson as A, collectExternalPackageSources as B, surfaceManifestDiagnostics as C, contentHash as Ct, vocabularyWitnessDiagnostics as D, stripLeadingLayerDeclaration as Dt, unresolvedParentName as E, assembleStylesheet as Et, findSheetAssetSpecifiers as F, isExcludedPackageRelativePath as G, extractSystemFilePackages as H, reportSurvivingAssetPlaceholders as I, unresolvableIncludesMessage as J, resolveAbsolutePathSpecifier as K, substituteAssetPlaceholders as L, resolveAssetFile as M, resolveThroughPathAliases as N, postProcessCss as O, validateLayerOrder as Ot, findAssetSpecifiers as P, sharesVolumeRoot as Q, substituteSheetAssets as R, isUnresolvedParentDrop as S, preprocessMdx as St, unreadableSourceDiagnostic as T, ANIMUS_LAYERS as Tt, findPackageRoot as U, excludeCollectedPackages as V, firstOwners as W, createSourceIdentity as X, walkPackageSources as Y, isPathWithinRoot as Z, runProjectAnalysis as _, projectExternalFileOwners as _t, assertNoErrorDiagnostics as a, REPLACEABLE_DEFAULT_EXCLUDE as at, VOCABULARY_COLLISION as b, ENGINE_TRANSFORM_EXTENSIONS as bt, buildDynamicPropConfig as c, createExcludeMatcher as ct, applyPrefix as d, RETIRED_ENGINE_MESSAGE as dt, discoverFiles as et, serializeStaticCss as f, assertNoRetiredEngineSelection as ft, clearEngineCache as g, parseFilesJson as gt, buildAnalysisInputs as h, isAdvisorySourceDiagnostic as ht, snapshotFilePlans as i, DRIVER_NAMESPACES as it, enforceExternalTokenContracts as j, resolveLightningTargets as k, __require as kt, runStructuralSelfCheck as l, resolveMode as lt, stableStringify as m, ingestSourceEntries as mt, diffFilePlans as n, CORE_OPTION_KEYS as nt, readTsconfigAliasPairs as o, STRUCTURAL_EXCLUDE as ot, camelToKebab as p, createV2EngineApi as pt, staleDistIncludesMessage as q, hashReplacementPlans as r, DEFAULT_EXCLUDE as rt, buildSystemPropsModule as s, assertKnownOptionKeys as st, toWatchKeys as t, AnimusConfigError as tt, loadSystemConfig as u, resolveVerbosity as ut, applyUnitFallback as v, adaptSvelteSource as vt, systemLoadDiagnostics as w, buildAnalyzeProjectArgs as wt, VOCABULARY_LEGACY_VERB as x, isEngineTransformExtension as xt, INVALID_PROPERTY_REGISTRATION as y, DEFAULT_EXTENSIONS as yt, createSourceCorpus as z };