@animus-ui/extract 0.1.22 → 0.1.23

package/dist/{pipeline-D7B1z0-1.cjs → pipeline-B3JzXiSY.cjs}

@@ -131,7 +131,167 @@ function parseInternalWire(json, wire) {
 	return parsed;
 }
 //#endregion
+//#region pipeline/asset-placeholders.ts
+const ASSET_PLACEHOLDER_PREFIX = "animus-asset:";
+const URL_OPEN_RE = /url\(\s*(['"]?)/gi;
+const IMAGE_SET_OPEN_RE = /(?:-webkit-)?image-set\(/gi;
+const BARE_SPECIFIER_RE = /^[^'")\s]+/;
+/** The index of the `)` that closes the `(` at `open`, outside strings. */
+function closingParen(css, open) {
+	let depth = 0;
+	let quote = null;
+	for (let i = open; i < css.length; i += 1) {
+		const c = css[i];
+		if (quote !== null) {
+			if (c === quote) quote = null;
+		} else if (c === "\"" || c === "'") quote = c;
+		else if (c === "(") depth += 1;
+		else if (c === ")") {
+			depth -= 1;
+			if (depth === 0) return i;
+		}
+	}
+	return css.length;
+}
+function quotedReference(css, quoteAt) {
+	const start = quoteAt + 1;
+	if (!css.startsWith("animus-asset:", start)) return null;
+	const end = css.indexOf(css[quoteAt], start);
+	if (end === -1) return null;
+	return {
+		start,
+		end,
+		specifier: css.slice(start + 13, end)
+	};
+}
+function assetReferences(css) {
+	if (!css.includes("animus-asset:")) return [];
+	const references = [];
+	for (const open of css.matchAll(URL_OPEN_RE)) {
+		const at = (open.index ?? 0) + open[0].length;
+		if (open[1]) {
+			const reference = quotedReference(css, at - 1);
+			if (reference) references.push(reference);
+			continue;
+		}
+		if (!css.startsWith("animus-asset:", at)) continue;
+		const specifier = BARE_SPECIFIER_RE.exec(css.slice(at + 13))?.[0];
+		if (specifier === void 0) continue;
+		const end = at + 13 + specifier.length;
+		references.push({
+			start: at,
+			end,
+			specifier
+		});
+	}
+	for (const open of css.matchAll(IMAGE_SET_OPEN_RE)) {
+		const paren = (open.index ?? 0) + open[0].length - 1;
+		const close = closingParen(css, paren);
+		let depth = 0;
+		let candidateStart = true;
+		for (let i = paren + 1; i < close; i += 1) {
+			const c = css[i];
+			if (/\s/.test(c)) continue;
+			if (c === "\"" || c === "'") {
+				if (depth === 0 && candidateStart) {
+					const reference = quotedReference(css, i);
+					if (reference) references.push(reference);
+				}
+				const end = css.indexOf(c, i + 1);
+				i = end === -1 ? close : end;
+			} else if (c === "(") depth += 1;
+			else if (c === ")") depth -= 1;
+			else if (c === "," && depth === 0) {
+				candidateStart = true;
+				continue;
+			}
+			candidateStart = false;
+		}
+	}
+	return references.sort((a, b) => a.start - b.start);
+}
+function findAssetSpecifiers(css) {
+	return [...new Set(assetReferences(css).map((reference) => reference.specifier))];
+}
+function substituteAssetPlaceholders(css, urlBySpecifier) {
+	if (urlBySpecifier.size === 0) return css;
+	let out = css;
+	for (const reference of assetReferences(css).reverse()) {
+		const url = urlBySpecifier.get(reference.specifier);
+		if (url === void 0) continue;
+		out = out.slice(0, reference.start) + url + out.slice(reference.end);
+	}
+	return out;
+}
+/**
+* Specifiers of placeholder text anywhere inside a `url()` or `image-set()`
+* call, a reference or not: after substitution any of it is a broken load.
+*/
+function placeholdersInAssetCalls(css) {
+	if (!css.includes("animus-asset:")) return [];
+	const calls = [...css.matchAll(URL_OPEN_RE), ...css.matchAll(IMAGE_SET_OPEN_RE)].map((open) => {
+		const paren = css.indexOf("(", open.index ?? 0);
+		return [paren, closingParen(css, paren)];
+	});
+	const found = /* @__PURE__ */ new Set();
+	for (let at = css.indexOf(ASSET_PLACEHOLDER_PREFIX); at !== -1; at = css.indexOf(ASSET_PLACEHOLDER_PREFIX, at + 1)) {
+		if (!calls.some(([open, close]) => open < at && at < close)) continue;
+		found.add(/^[^'")\s,]*/.exec(css.slice(at + 13))[0]);
+	}
+	return [...found];
+}
+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 = placeholdersInAssetCalls(css);
+	if (specifiers.length === 0) return;
+	const message = `${report.prefix} asset() placeholders reached ${report.surface ?? "emitted CSS"} unsubstituted: ${specifiers.join(", ")} (${UNSUBSTITUTED_ASSET_CODE})`;
+	if (report.strict) throw new Error(message);
+	report.warn(message);
+}
+/**
+* The runtime code an analysis generates: each dynamic prop config, which the
+* shared prop map module carries, and each component's replacement. Extraction
+* lifts asset() out of them into root variables, so none should hold one.
+* Both embed values as JSON strings, so their quote and backslash escapes are
+* undone for scanning: the text is for `findAssetSpecifiers`, not to run.
+*/
+function generatedModuleCode(manifest) {
+	return [JSON.stringify(manifest.dynamic_props), ...Object.values(manifest.components).map((component) => component.replacement)].join("\n").replace(/\\(["\\])/g, "$1");
+}
+//#endregion
 //#region pipeline/manifest-diagnostics.ts
+/** `file`, then its line and column where the record has them. */
+function locationOf(diagnostic) {
+	if (diagnostic.line === void 0) return diagnostic.file;
+	if (diagnostic.column === void 0) return `${diagnostic.file}:${diagnostic.line}`;
+	return `${diagnostic.file}:${diagnostic.line}:${diagnostic.column}`;
+}
+/** A located record's `file:line:column: `; nothing for one without a line,
+*  whose message names its file. */
+function locatedPrefix(diagnostic) {
+	return diagnostic.line === void 0 ? "" : `${locationOf(diagnostic)}: `;
+}
+/** What the record dropped, when its message does not already quote it. */
+function droppedSuffix(diagnostic) {
+	return diagnostic.dropped && !diagnostic.message.includes(diagnostic.dropped) ? ` — dropped: ${diagnostic.dropped}` : "";
+}
 /** Stable code for selector forms with no substitutable subject; the
 *  extraction engine mints the same string. */
 const SELECTOR_UNSUPPORTED_SUBJECT = "animus.selector.unsupported-subject";
@@ -144,6 +304,63 @@ function isUnresolvedParentDrop(diagnostic) {
 function unresolvedParentName(diagnostic) {
 	return UNRESOLVED_PARENT_RE.exec(diagnostic.message)?.[1] ?? null;
 }
+const DIAGNOSTIC_LEVELS = /* @__PURE__ */ new Set([
+	"off",
+	"info",
+	"warn",
+	"error"
+]);
+/** The level `levels` sets for `code`: its exact entry, else the entry of
+*  the longest prefix it starts with. */
+function levelFor(code, levels) {
+	if (code === void 0 || levels === void 0) return void 0;
+	if (Object.hasOwn(levels, code)) return levels[code];
+	let longest;
+	for (const [key, level] of Object.entries(levels)) {
+		if (!key.endsWith(".*")) continue;
+		const prefix = key.slice(0, -1);
+		if (code.startsWith(prefix) && prefix.length > (longest?.length ?? -1)) longest = {
+			length: prefix.length,
+			level
+		};
+	}
+	return longest?.level;
+}
+/** The level a record prints at: the option's entry for its code, else
+*  `error` for an error-severity record under `strict`, else its own. */
+function effectiveLevel(diagnostic, policy) {
+	const level = levelFor(diagnostic.code, policy.levels);
+	if (level !== void 0) return level;
+	if (diagnostic.severity === "info") return "info";
+	return policy.strict && diagnostic.severity === "error" ? "error" : "warn";
+}
+/** Every code Animus is known to report: the engine's table, as the native
+*  module publishes it (`diagnosticCodes()`), the pipeline's, and the asset
+*  code. The system package mints vocabulary codes at run time, so a valid
+*  code can be missing. */
+function knownDiagnosticCodes(engineCodesJson) {
+	const engineCodes = engineCodesJson ? Object.keys(parseInternalWire(engineCodesJson, "diagnosticCodes (the engine code table)")) : [];
+	return /* @__PURE__ */ new Set([
+		...engineCodes,
+		...DIAGNOSTIC_SEVERITY.keys(),
+		UNSUBSTITUTED_ASSET_CODE
+	]);
+}
+/** The keys of `levels` that name no known code, exactly or as a prefix. */
+function unknownDiagnosticKeys(levels, known) {
+	return Object.keys(levels).filter((key) => {
+		if (!key.endsWith(".*")) return !known.has(key);
+		const prefix = key.slice(0, -1);
+		return ![...known].some((code) => code.startsWith(prefix));
+	});
+}
+/** The failure of diagnostics at `error` level, from `strict` or the
+*  `diagnostics` option: a host fails the build on it whatever its own
+*  strictness. It prints as the plain `Error` strict always threw. */
+var DiagnosticFailure = class extends Error {};
+/** Level options already checked against the known codes: one warning per
+*  unknown key, however often a host analyzes. */
+const checkedLevels = /* @__PURE__ */ new WeakSet();
 /** True when the selector carries at least one substitutable `&` subject
 *  outside quoted text. */
 function hasSelectorSubject(value) {
@@ -186,6 +403,9 @@ function collectSelectorAliasDiagnostics(selectorAliasesJson) {
 const UNREADABLE_SOURCE_FILE = "animus.ingestion.unreadable-source-file";
 /** A kit the system extends resolved, yet discovery found none of its files. */
 const NO_KIT_FILES = "animus.discovery.no-kit-files";
+/** A system file's `createSystem` binding that discovery could not follow to
+*  Animus's factory, so it is no root. */
+const UNPROVEN_ROOT_BINDING = "animus.discovery.unproven-root-binding";
 /** What a skipped source file costs: the analysis never sees what it
 *  renders. */
 const SKIPPED_SOURCE_COST = "skipped: its renders are not seen, so nothing is pruned and every component, variant option and state is kept until it is analyzed";
@@ -262,6 +482,7 @@ const DIAGNOSTIC_SEVERITY = /* @__PURE__ */ new Map([
 	[SELECTOR_UNSUPPORTED_SUBJECT, "error"],
 	[UNREADABLE_SOURCE_FILE, "error"],
 	[NO_KIT_FILES, "warn"],
+	[UNPROVEN_ROOT_BINDING, "warn"],
 	[VOCABULARY_COLLISION, "warn"],
 	[VOCABULARY_LEGACY_VERB, "warn"],
 	[INVALID_PROPERTY_REGISTRATION, "error"],
@@ -386,25 +607,33 @@ function tokenCollisionDiagnostics(system) {
 */
 function surfaceManifestDiagnostics(manifest, warn, policy = {}) {
 	const errors = [];
+	if (policy.levels && policy.knownCodes && !checkedLevels.has(policy.levels)) {
+		checkedLevels.add(policy.levels);
+		for (const key of unknownDiagnosticKeys(policy.levels, policy.knownCodes)) warn(`⚠ diagnostics option: '${key}' matches no Animus diagnostic code — check its spelling (a code the system package mints at run time is known only once it is reported)`);
+	}
 	const diagnostics = policy.prepend?.length ? [...policy.prepend, ...manifest.diagnostics ?? []] : manifest.diagnostics ?? [];
 	for (const diagnostic of diagnostics) {
+		const level = effectiveLevel(diagnostic, policy);
+		if (level === "off") continue;
 		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.severity === "info" ? "ℹ" : "⚠"} ${diagnostic.file}: ${diagnostic.component}: ${diagnostic.message}`;
+		const mark = level === "info" ? "ℹ" : "⚠";
+		const message = `${diagnostic.message}${droppedSuffix(diagnostic)}`;
+		if (diagnostic.kind === "bail") line = `${mark} ${locatedPrefix(diagnostic)}${diagnostic.component} not extracted: ${message}`;
+		else if (diagnostic.kind === "skip") line = `${mark} ${locatedPrefix(diagnostic)}${diagnostic.component}: skipped ${message}`;
+		else if (diagnostic.kind === "warn") line = `${mark} ${locationOf(diagnostic)}: ${diagnostic.component}: ${message}`;
 		if (line === null) continue;
 		if (diagnostic.code && !diagnostic.message.includes(diagnostic.code)) line += ` [${diagnostic.code}]`;
-		if (diagnostic.severity === "info") {
+		if (level === "info") {
 			policy.info?.(line);
 			continue;
 		}
-		if (policy.strict && diagnostic.severity === "error") {
-			errors.push(`${diagnostic.code ?? "error"} — ${diagnostic.component}: ${diagnostic.message}`);
+		if (level === "error") {
+			errors.push(`${diagnostic.code ?? "error"} — ${locatedPrefix(diagnostic)}${diagnostic.component}: ${message}`);
 			continue;
 		}
 		warn(line);
 	}
-	if (errors.length > 0) throw new Error(`[animus] strict: ${errors.length} error diagnostic(s):\n${errors.join("\n")}`);
+	if (errors.length > 0) throw new DiagnosticFailure(`[animus] strict: ${errors.length} error diagnostic(s):\n${errors.join("\n")}`);
 }
 //#endregion
 //#region pipeline/mdx-preprocessor.ts
@@ -1056,17 +1285,17 @@ const NODE_NEXT_EXTENSION_MAP = {
 	".mjs": [".mts"],
 	".cjs": [".cts"]
 };
-function resolveRelativeSource(importerPath, specifier, files) {
-	if (!specifier.startsWith(".")) return null;
+/** The paths a relative specifier can name from `importerPath`, in probe
+*  order: as written with each source suffix, then a NodeNext emitted
+*  extension's sources. Empty for a non-relative specifier. */
+function relativeSourceCandidates(importerPath, specifier) {
+	if (!specifier.startsWith(".")) return [];
 	const base = node_path.posix.normalize(node_path.posix.join(node_path.posix.dirname(canonicalResolverPath(importerPath)), specifier));
-	for (const suffix of RELATIVE_PROBE_SUFFIXES) {
-		const candidate = `${base}${suffix}`;
-		const actualPath = files.get(candidate);
-		if (actualPath !== void 0) return actualPath;
-	}
 	const explicitExtension = extension(base);
-	for (const sourceExtension of NODE_NEXT_EXTENSION_MAP[explicitExtension] ?? []) {
-		const candidate = `${base.slice(0, -explicitExtension.length)}${sourceExtension}`;
+	return [...RELATIVE_PROBE_SUFFIXES.map((suffix) => `${base}${suffix}`), ...(NODE_NEXT_EXTENSION_MAP[explicitExtension] ?? []).map((sourceExtension) => `${base.slice(0, -explicitExtension.length)}${sourceExtension}`)];
+}
+function resolveRelativeSource(importerPath, specifier, files) {
+	for (const candidate of relativeSourceCandidates(importerPath, specifier)) {
 		const actualPath = files.get(candidate);
 		if (actualPath !== void 0) return actualPath;
 	}
@@ -1412,6 +1641,7 @@ function createV2EngineApi(deps) {
 		return {
 			loadSystemModule: (...args) => native.loadSystemModule(...args),
 			extractFacts: (filesJson) => native.extractFacts(filesJson),
+			diagnosticCodes: () => native.diagnosticCodes(),
 			analyzeProject: (filesJsonRaw, scalesJson, variableMapJson, contextualVarsJson, propConfigJson, groupRegistryJson, packageResolutionJson, devMode, emitterConfigJson, selectorAliasesJson, _selectorOrderJson, globalStyleBlocksJson, pathAliasesJson, keyframesJson, staticCssJson, conditionAliasesJson, externalDirsJson, transformSourcesJson, transformProvenanceJson, declarationScalesJson, analysisContextJson) => {
 				const filesJson = deps.rehydrateFilesJson ? deps.rehydrateFilesJson(filesJsonRaw) : filesJsonRaw;
 				const sent = /* @__PURE__ */ new Map();
@@ -1477,6 +1707,10 @@ function assertNoRetiredEngineSelection(engineOption) {
 }
 //#endregion
 //#region pipeline/core-options.ts
+/**
+* One option schema shared by the Vite, Next, and CLI drivers: key semantics,
+* default exclusions, and mode authority cannot drift per driver.
+*/
 const DRIVER_NAMESPACES = [
 	"vite",
 	"next",
@@ -1510,6 +1744,7 @@ const CORE_OPTION_KEYS = /* @__PURE__ */ new Set([
 	"exclude",
 	"extensions",
 	"strict",
+	"diagnostics",
 	"verbose",
 	"prefix",
 	"prefixContextualVars",
@@ -1569,6 +1804,7 @@ const isString = (value) => Object(value) !== value && Object.prototype.toString
 const isBoolean = (value) => Object(value) !== value && Object.prototype.toString.call(value) === "[object Boolean]";
 const isVerbose = (value) => isBoolean(value) || value === "trace";
 const isStringArray = (value) => Array.isArray(value) && value.every(isString);
+const isDiagnosticLevels = (value) => Object.prototype.toString.call(value) === "[object Object]" && Object.values(Object(value)).every((level) => isString(level) && DIAGNOSTIC_LEVELS.has(level));
 const isStringOrStringArray = (value) => isString(value) || isStringArray(value);
 const CORE_VALUE_GATES = [
 	{
@@ -1591,6 +1827,11 @@ const CORE_VALUE_GATES = [
 		ok: isBoolean,
 		expected: "a boolean"
 	},
+	{
+		key: "diagnostics",
+		ok: isDiagnosticLevels,
+		expected: "an object mapping codes to 'off', 'info', 'warn' or 'error'"
+	},
 	{
 		key: "verbose",
 		ok: isVerbose,
@@ -2419,10 +2660,10 @@ function staleDistIncludesMessage(outcomes) {
 	if (stale.length === 0) return null;
 	return `[animus-extract] stale dist for include specifier(s): ${stale.join(", ")} — dist entry is older than the newest src/ file; rebuild the package(s) before extracting`;
 }
-/** The engine's own parse of a module's imports, through its
+/** The engine's own parse of a module's bindings, through its
 *  `extractFacts`; undefined for an engine without one. A parse that
-*  panicked reports no imports, so it counts as no parse. */
-function engineImportParser(engine) {
+*  panicked counts as no parse. */
+function engineModuleParser(engine) {
 	const { extractFacts } = engine;
 	if (!extractFacts) return void 0;
 	return (source, path$3) => {
@@ -2431,36 +2672,200 @@ function engineImportParser(engine) {
 				path: path$3,
 				source
 			}])), "extractFacts").files[path$3];
-			return facts && !facts.parsePanicked ? facts.imports : null;
+			return facts && !facts.parsePanicked ? {
+				imports: facts.imports,
+				exports: facts.exports
+			} : null;
 		} catch {
 			return null;
 		}
 	};
 }
+const ANIMUS_SYSTEM_SPECIFIER = /^@animus-ui\/system(?:\/.*)?$/;
+/** The file a specifier names from `importer`: a relative one by the
+*  ingestion's probe order, a bare one by the host's package resolution. */
+async function resolveModuleFile(importer, specifier, resolvePackage) {
+	if (specifier.startsWith(".")) return relativeSourceCandidates(importer, specifier).find(isFile) ?? null;
+	try {
+		return await resolvePackage?.(specifier) ?? null;
+	} catch {
+		return null;
+	}
+}
+const escapeRegExp$1 = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/**
+* Follows `name`, exported by the module `specifier` names from `importer`,
+* through re-exports to its declaration. It is Animus's factory only when
+* that is `createSystem` of `@animus-ui/system`, and another identity only
+* when a module is shown to declare it; anything discovery cannot follow is
+* unknown.
+*/
+async function exportIdentity(importer, specifier, name, following, seen) {
+	if (ANIMUS_SYSTEM_SPECIFIER.test(specifier)) return name === "createSystem" ? { kind: "animus" } : {
+		kind: "other",
+		what: `'${name}' of ${specifier}`
+	};
+	const file = await resolveModuleFile(importer, specifier, following.resolvePackage);
+	if (file === null) return {
+		kind: "unknown",
+		why: `'${specifier}' could not be resolved`
+	};
+	const key = `${file}#${name}`;
+	if (seen.has(key)) return {
+		kind: "unknown",
+		why: `'${specifier}' re-exports it in a cycle`
+	};
+	seen.add(key);
+	let source;
+	try {
+		source = (0, fs.readFileSync)(file, "utf-8");
+	} catch {
+		return {
+			kind: "unknown",
+			why: `'${specifier}' could not be read`
+		};
+	}
+	const record = following.parseModule(source, file);
+	if (record === null) return {
+		kind: "unknown",
+		why: `'${specifier}' could not be parsed`
+	};
+	const exported = record.exports.find((entry) => entry.exported === name);
+	if (exported?.source) return exportIdentity(file, exported.source, exported.original ?? name, following, seen);
+	const local = exported?.local ?? name;
+	const imported = record.imports.find((entry) => entry.local === local);
+	if (exported && imported) return exportIdentity(file, imported.source, imported.imported, following, seen);
+	if (exported || new RegExp(`\\bexport\\s+(?:async\\s+)?(?:function\\*?|class|const|let|var)\\s+${escapeRegExp$1(name)}\\b`).test(source)) return {
+		kind: "other",
+		what: `the '${name}' that '${specifier}' declares`
+	};
+	const stars = [];
+	for (const match of source.matchAll(/\bexport\s*\*\s*from\s*['"]([^'"]+)['"]/g)) stars.push(await exportIdentity(file, match[1], name, following, seen));
+	const definite = stars.filter((identity) => identity.kind !== "unknown");
+	if (definite.length === 1) return definite[0];
+	if (definite.length > 1) return {
+		kind: "unknown",
+		why: `more than one \`export *\` of '${specifier}' provides '${name}'`
+	};
+	return stars.find((identity) => identity.kind === "unknown") ?? {
+		kind: "unknown",
+		why: `'${specifier}' has no export '${name}' discovery can read`
+	};
+}
+/** 1-based line and column of `offset` in `source`. */
+function locationIn(source, offset) {
+	const before = source.slice(0, offset);
+	const lineStart = before.lastIndexOf("\n") + 1;
+	return {
+		line: before.split("\n").length,
+		column: offset - lineStart + 1
+	};
+}
+const NAMESPACE_IMPORT = /\bimport\s+(?:[a-zA-Z_$][a-zA-Z0-9_$]*\s*,\s*)?\*\s*as\s+([a-zA-Z_$][a-zA-Z0-9_$]*)\s+from\s+['"]([^'"]+)['"]/g;
+/**
+* The callees that are Animus's `createSystem` in a parsed system file. A
+* binding counts once its identity is followed to the factory: a named
+* import, through local and package re-exports; a namespace import's
+* member; or a property destructured from a namespace import, `require` or
+* `import()` of a module. A binding named `createSystem` shown to be
+* something else is no root. One whose identity discovery cannot follow
+* keeps the admission spelling gave it, so a resolution limit never drops a
+* kit. Both are reported. The bare name also anchors, as a global, unless
+* the file binds it.
+*/
+async function systemRoots(systemFilePath, source, imports, following) {
+	const roots = /* @__PURE__ */ new Set();
+	const identityOf = (specifier, name) => exportIdentity(systemFilePath, specifier, name, following, /* @__PURE__ */ new Set());
+	const called = (callee) => new RegExp(`(?<![a-zA-Z0-9_$.])${escapeRegExp$1(callee)}\\s*\\(`).test(source);
+	/** Admits a binding named `createSystem` by its identity: an unknown one
+	*  keeps `spellingAdmits`, and every unproven one is reported. */
+	const admit = (local, offset, identity, spellingAdmits) => {
+		if (identity.kind === "animus") {
+			roots.add(local);
+			return;
+		}
+		if (identity.kind === "unknown" && spellingAdmits) roots.add(local);
+		const shown = identity.kind === "other" ? `it is ${identity.what}, so it is not read as a system root` : `discovery cannot follow what it is bound to (${identity.why}), so it is ${spellingAdmits ? "still read" : "not read"} as a system root by its name alone`;
+		following.report?.({
+			file: systemFilePath,
+			component: local,
+			kind: "warn",
+			message: `'${local}' is not proven to be Animus's createSystem: ${shown} — import createSystem from '@animus-ui/system', directly or through a re-export discovery can follow`,
+			code: UNPROVEN_ROOT_BINDING,
+			severity: severityFor(UNPROVEN_ROOT_BINDING),
+			...locationIn(source, offset)
+		});
+	};
+	let bindsName = false;
+	for (const binding of imports) {
+		const named = binding.imported === "createSystem" || binding.local === "createSystem";
+		if (binding.local === "createSystem") bindsName = true;
+		if (named) {
+			const statement = new RegExp(`\\bimport\\b[^;]*?\\bfrom\\s*['"]${escapeRegExp$1(binding.source)}['"]`, "g");
+			let offset = 0;
+			for (const match of source.matchAll(statement)) {
+				const at = match[0].search(new RegExp(`(?<![a-zA-Z0-9_$])${escapeRegExp$1(binding.local)}\\b`));
+				if (at !== -1) {
+					offset = match.index + at;
+					break;
+				}
+			}
+			admit(binding.local, offset, await identityOf(binding.source, binding.imported), binding.imported === "createSystem");
+			continue;
+		}
+		if (binding.source.startsWith(".") && called(binding.local) && (await identityOf(binding.source, binding.imported)).kind === "animus") roots.add(binding.local);
+	}
+	const namespaces = /* @__PURE__ */ new Map();
+	for (const [, namespace, specifier] of source.matchAll(NAMESPACE_IMPORT)) {
+		namespaces.set(namespace, specifier);
+		const member = `${namespace}.createSystem`;
+		if (ANIMUS_SYSTEM_SPECIFIER.test(specifier) || specifier.startsWith(".") && called(member) && (await identityOf(specifier, "createSystem")).kind === "animus") roots.add(member);
+	}
+	const destructuredFrom = (initializer) => {
+		const loaded = /^\(?\s*(?:(?:await\s+)?import|require)\(\s*['"]([^'"]+)['"]\s*\)\s*\)?$/.exec(initializer);
+		if (loaded) return identityOf(loaded[1], "createSystem");
+		const namespace = namespaces.get(initializer);
+		if (namespace !== void 0) return identityOf(namespace, "createSystem");
+		return Promise.resolve({
+			kind: "unknown",
+			why: `it is destructured from '${initializer}', which is not a module namespace`
+		});
+	};
+	for (const match of source.matchAll(/\b(?:const|let|var)\s*\{([^}]*)\}\s*=\s*([^;\n]+)/g)) {
+		const [whole, pattern, initializer] = match;
+		for (const property of pattern.split(",")) {
+			const binding = /^\s*createSystem\s*(?::\s*([a-zA-Z_$][a-zA-Z0-9_$]*))?\s*(?:=[\s\S]*)?$/.exec(property);
+			if (!binding) continue;
+			const local = binding[1] ?? "createSystem";
+			if (local === "createSystem") bindsName = true;
+			admit(local, match.index + whole.indexOf("createSystem"), await destructuredFrom(initializer.trim()), local === "createSystem");
+		}
+	}
+	const declaresName = /\b(?:function\*?|class)\s+createSystem\b|\b(?:const|let|var)\s+createSystem\b/.test(source);
+	if (!bindsName && !declaresName) roots.add("createSystem");
+	return roots;
+}
 /** A pattern matching a call of any of `callees` as a whole name, or null
 *  when there is none to anchor on. */
 function rootCallPattern(callees) {
 	if (callees.length === 0) return null;
 	return `(?<![a-zA-Z0-9_$.])(?:${callees.map((callee) => callee.replace(/[.$]/g, "\\$&")).join("|")})`;
 }
-function extractSystemFilePackages(systemFilePath, parseImports) {
+async function extractSystemFilePackages(systemFilePath, parseModule, report, resolvePackage) {
 	let source;
 	try {
 		source = (0, fs.readFileSync)(systemFilePath, "utf-8");
 	} catch {
 		return [];
 	}
-	const parsed = parseImports?.(source, systemFilePath) ?? null;
-	const parsedImports = parsed && parsed.length > 0 ? parsed : null;
+	const parsed = parseModule?.(source, systemFilePath) ?? null;
+	const parsedImports = parsed && parsed.imports.length > 0 ? parsed.imports : null;
 	let rootCall = "createSystem";
-	if (parsedImports) {
-		const shadowed = parsedImports.some((binding) => binding.local === "createSystem" && binding.imported !== "createSystem") || /\b(?:function\*?|class)\s+createSystem\b|\b(?:const|let|var)\s+createSystem\b/.test(source);
-		rootCall = rootCallPattern([.../* @__PURE__ */ new Set([
-			...parsedImports.filter((binding) => binding.imported === "createSystem").map((binding) => binding.local),
-			...Array.from(source.matchAll(/\bimport\s+(?:[a-zA-Z_$][a-zA-Z0-9_$]*\s*,\s*)?\*\s*as\s+([a-zA-Z_$][a-zA-Z0-9_$]*)\s+from\s+['"]@animus-ui\/system(?:\/[^'"]*)?['"]/g), (match) => `${match[1]}.createSystem`),
-			...shadowed ? [] : ["createSystem"]
-		])]);
-	}
+	if (parseModule && parsedImports) rootCall = rootCallPattern([...await systemRoots(systemFilePath, source, parsedImports, {
+		parseModule,
+		resolvePackage,
+		report
+	})]);
 	const identifiers = /* @__PURE__ */ new Set();
 	const constructorRegex = rootCall === null ? null : new RegExp(`${rootCall}\\s*\\(\\s*\\{[^}]*?\\bincludes\\s*:\\s*\\[([^\\]]*)\\]`, "gs");
 	const chainRegex = /\.includes\s*\(\s*\[([^\]]*)\]\s*\)/gs;
@@ -2715,151 +3120,6 @@ function createSourceCorpus(host, ingestor = createSourceIngestor(host)) {
 	};
 }
 //#endregion
-//#region pipeline/asset-placeholders.ts
-const ASSET_PLACEHOLDER_PREFIX = "animus-asset:";
-const URL_OPEN_RE = /url\(\s*(['"]?)/gi;
-const IMAGE_SET_OPEN_RE = /(?:-webkit-)?image-set\(/gi;
-const BARE_SPECIFIER_RE = /^[^'")\s]+/;
-/** The index of the `)` that closes the `(` at `open`, outside strings. */
-function closingParen(css, open) {
-	let depth = 0;
-	let quote = null;
-	for (let i = open; i < css.length; i += 1) {
-		const c = css[i];
-		if (quote !== null) {
-			if (c === quote) quote = null;
-		} else if (c === "\"" || c === "'") quote = c;
-		else if (c === "(") depth += 1;
-		else if (c === ")") {
-			depth -= 1;
-			if (depth === 0) return i;
-		}
-	}
-	return css.length;
-}
-function quotedReference(css, quoteAt) {
-	const start = quoteAt + 1;
-	if (!css.startsWith("animus-asset:", start)) return null;
-	const end = css.indexOf(css[quoteAt], start);
-	if (end === -1) return null;
-	return {
-		start,
-		end,
-		specifier: css.slice(start + 13, end)
-	};
-}
-function assetReferences(css) {
-	if (!css.includes("animus-asset:")) return [];
-	const references = [];
-	for (const open of css.matchAll(URL_OPEN_RE)) {
-		const at = (open.index ?? 0) + open[0].length;
-		if (open[1]) {
-			const reference = quotedReference(css, at - 1);
-			if (reference) references.push(reference);
-			continue;
-		}
-		if (!css.startsWith("animus-asset:", at)) continue;
-		const specifier = BARE_SPECIFIER_RE.exec(css.slice(at + 13))?.[0];
-		if (specifier === void 0) continue;
-		const end = at + 13 + specifier.length;
-		references.push({
-			start: at,
-			end,
-			specifier
-		});
-	}
-	for (const open of css.matchAll(IMAGE_SET_OPEN_RE)) {
-		const paren = (open.index ?? 0) + open[0].length - 1;
-		const close = closingParen(css, paren);
-		let depth = 0;
-		let candidateStart = true;
-		for (let i = paren + 1; i < close; i += 1) {
-			const c = css[i];
-			if (/\s/.test(c)) continue;
-			if (c === "\"" || c === "'") {
-				if (depth === 0 && candidateStart) {
-					const reference = quotedReference(css, i);
-					if (reference) references.push(reference);
-				}
-				const end = css.indexOf(c, i + 1);
-				i = end === -1 ? close : end;
-			} else if (c === "(") depth += 1;
-			else if (c === ")") depth -= 1;
-			else if (c === "," && depth === 0) {
-				candidateStart = true;
-				continue;
-			}
-			candidateStart = false;
-		}
-	}
-	return references.sort((a, b) => a.start - b.start);
-}
-function findAssetSpecifiers(css) {
-	return [...new Set(assetReferences(css).map((reference) => reference.specifier))];
-}
-function substituteAssetPlaceholders(css, urlBySpecifier) {
-	if (urlBySpecifier.size === 0) return css;
-	let out = css;
-	for (const reference of assetReferences(css).reverse()) {
-		const url = urlBySpecifier.get(reference.specifier);
-		if (url === void 0) continue;
-		out = out.slice(0, reference.start) + url + out.slice(reference.end);
-	}
-	return out;
-}
-/**
-* Specifiers of placeholder text anywhere inside a `url()` or `image-set()`
-* call, a reference or not: after substitution any of it is a broken load.
-*/
-function placeholdersInAssetCalls(css) {
-	if (!css.includes("animus-asset:")) return [];
-	const calls = [...css.matchAll(URL_OPEN_RE), ...css.matchAll(IMAGE_SET_OPEN_RE)].map((open) => {
-		const paren = css.indexOf("(", open.index ?? 0);
-		return [paren, closingParen(css, paren)];
-	});
-	const found = /* @__PURE__ */ new Set();
-	for (let at = css.indexOf(ASSET_PLACEHOLDER_PREFIX); at !== -1; at = css.indexOf(ASSET_PLACEHOLDER_PREFIX, at + 1)) {
-		if (!calls.some(([open, close]) => open < at && at < close)) continue;
-		found.add(/^[^'")\s,]*/.exec(css.slice(at + 13))[0]);
-	}
-	return [...found];
-}
-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 = placeholdersInAssetCalls(css);
-	if (specifiers.length === 0) return;
-	const message = `${report.prefix} asset() placeholders reached ${report.surface ?? "emitted CSS"} unsubstituted: ${specifiers.join(", ")} (${UNSUBSTITUTED_ASSET_CODE})`;
-	if (report.strict) throw new Error(message);
-	report.warn(message);
-}
-/**
-* The runtime code an analysis generates: each dynamic prop config, which the
-* shared prop map module carries, and each component's replacement. Extraction
-* lifts asset() out of them into root variables, so none should hold one.
-* Both embed values as JSON strings, so their quote and backslash escapes are
-* undone for scanning: the text is for `findAssetSpecifiers`, not to run.
-*/
-function generatedModuleCode(manifest) {
-	return [JSON.stringify(manifest.dynamic_props), ...Object.values(manifest.components).map((component) => component.replacement)].join("\n").replace(/\\(["\\])/g, "$1");
-}
-//#endregion
 //#region pipeline/resolve-asset.ts
 /**
 * Asset resolution for hosts with no bundler hook. Host path aliases apply
@@ -3660,9 +3920,12 @@ function hasSourceThemeManifests(system) {
 const surfacedSystems = /* @__PURE__ */ new WeakSet();
 /** The loaded system's own diagnostics, the first time it is analyzed. A
 *  strict error keeps failing every analysis until the system changes. */
-function systemDiagnostics(system, strict) {
+function systemDiagnostics(system, strict, levels) {
 	const diagnostics = [...collectSelectorAliasDiagnostics(system.selectorAliasesJson), ...systemLoadDiagnostics(system)];
-	const blocking = strict === true && diagnostics.some((d) => d.severity === "error");
+	const blocking = diagnostics.some((d) => effectiveLevel(d, {
+		strict,
+		levels
+	}) === "error");
 	if (surfacedSystems.has(system) && !blocking) return [];
 	surfacedSystems.add(system);
 	return diagnostics;
@@ -3672,7 +3935,7 @@ function systemDiagnostics(system, strict) {
 * the call site (strict-mode throw vs warn).
 */
 function runProjectAnalysis(engineApi, opts) {
-	const { analyzeProject } = engineApi();
+	const { analyzeProject, diagnosticCodes } = engineApi();
 	let t = performance.now();
 	const inputs = buildAnalysisInputs(opts);
 	const serializeMs = Math.round(performance.now() - t);
@@ -3693,8 +3956,10 @@ function runProjectAnalysis(engineApi, opts) {
 	surfaceManifestDiagnostics(manifest, opts.warn, {
 		strict: opts.strict,
 		info: opts.info,
+		levels: opts.diagnostics,
+		knownCodes: opts.diagnostics ? knownDiagnosticCodes(diagnosticCodes?.()) : void 0,
 		prepend: [
-			...systemDiagnostics(opts.system, opts.strict),
+			...systemDiagnostics(opts.system, opts.strict, opts.diagnostics),
 			...propertyDiagnostics,
 			...opts.extraDiagnostics ?? []
 		]
@@ -3960,7 +4225,7 @@ function runStructuralSelfCheck(input) {
 	const failures = [];
 	if (input.componentCount === 0) failures.push("No component CSS produced — check the system file and its includes list");
 	else if (input.assembledCss !== void 0 ? !/@layer\s+anm-base\s*\{/.test(input.assembledCss) : input.componentCss.trim().length === 0) failures.push(`${input.componentCount} component(s) discovered but the emitted component CSS is empty`);
-	for (const { specifier, outcome } of input.externalOutcomes ?? []) if (outcome === "empty") failures.push(`include '${specifier}' resolved but discovered no component sources`);
+	for (const { specifier, outcome } of input.externalOutcomes ?? []) if (outcome === "empty") failures.push(`include '${specifier}' resolved but discovered no component sources [${NO_KIT_FILES}]`);
 	else if (outcome === "unresolvable") failures.push(`include '${specifier}' could not be resolved`);
 	if ((input.variableMapJson == null || Object.keys(parseInternalWire(input.variableMapJson, "variableMapJson (the theme's token → variable map)")).length > 0) && !input.variableCss.includes(":root")) failures.push("No :root variable block found in variable CSS");
 	if ((input.assembledCss ?? `${input.variableCss}\n${input.globalCss}\n${input.componentCss}`).includes("__TRANSFORM__")) failures.push("Unresolved __TRANSFORM__ placeholders found in CSS output");
@@ -4157,12 +4422,24 @@ Object.defineProperty(exports, "DEFAULT_EXTENSIONS", {
 		return DEFAULT_EXTENSIONS;
 	}
 });
+Object.defineProperty(exports, "DIAGNOSTIC_LEVELS", {
+	enumerable: true,
+	get: function() {
+		return DIAGNOSTIC_LEVELS;
+	}
+});
 Object.defineProperty(exports, "DRIVER_NAMESPACES", {
 	enumerable: true,
 	get: function() {
 		return DRIVER_NAMESPACES;
 	}
 });
+Object.defineProperty(exports, "DiagnosticFailure", {
+	enumerable: true,
+	get: function() {
+		return DiagnosticFailure;
+	}
+});
 Object.defineProperty(exports, "ENGINE_TRANSFORM_EXTENSIONS", {
 	enumerable: true,
 	get: function() {
@@ -4349,10 +4626,10 @@ Object.defineProperty(exports, "enforceExternalTokenContracts", {
 		return enforceExternalTokenContracts;
 	}
 });
-Object.defineProperty(exports, "engineImportParser", {
+Object.defineProperty(exports, "engineModuleParser", {
 	enumerable: true,
 	get: function() {
-		return engineImportParser;
+		return engineModuleParser;
 	}
 });
 Object.defineProperty(exports, "excludeCollectedPackages", {