@animus-ui/extract 0.1.22 → 0.1.23

package/dist/{pipeline-BXY7Pf_D.mjs → pipeline-kA3VEMgt.mjs}

@@ -111,7 +111,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";
@@ -124,6 +284,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) {
@@ -166,6 +383,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";
@@ -242,6 +462,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"],
@@ -366,25 +587,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
@@ -1036,17 +1265,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 = posix.normalize(posix.join(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;
 	}
@@ -1392,6 +1621,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();
@@ -1457,6 +1687,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",
@@ -1490,6 +1724,7 @@ const CORE_OPTION_KEYS = /* @__PURE__ */ new Set([
 	"exclude",
 	"extensions",
 	"strict",
+	"diagnostics",
 	"verbose",
 	"prefix",
 	"prefixContextualVars",
@@ -1549,6 +1784,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 = [
 	{
@@ -1571,6 +1807,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,
@@ -2399,10 +2640,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) => {
@@ -2411,36 +2652,200 @@ function engineImportParser(engine) {
 				path,
 				source
 			}])), "extractFacts").files[path];
-			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 = 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 = 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;
@@ -2695,151 +3100,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
@@ -3640,9 +3900,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;
@@ -3652,7 +3915,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);
@@ -3673,8 +3936,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 ?? []
 		]
@@ -3940,7 +4205,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");
@@ -4107,4 +4372,4 @@ function realpathThroughNearestExistingAncestor(path) {
 	}
 }
 //#endregion
-export { DRIVER_NAMESPACES as $, createSourceCorpus as A, contentHash as At, unresolvableIncludesMessage as B, resolveThroughPathAliases as C, noKitFilesDiagnostics as Ct, reportSurvivingAssetPlaceholders as D, unresolvedParentName as Dt, generatedModuleCode as E, unreadableSourceDiagnostic as Et, findPackageRoot as F, validateLayerOrder as Ft, createSourceIdentity as G, isJsonBlock as H, firstOwners as I, __require as It, compareDiscoveryOrder as J, isPathWithinRoot as K, isExcludedPackageRelativePath as L, engineImportParser as M, ANIMUS_LAYERS as Mt, excludeCollectedPackages as N, assembleStylesheet as Nt, substituteAssetPlaceholders as O, vocabularyWitnessDiagnostics as Ot, extractSystemFilePackages as P, stripLeadingLayerDeclaration as Pt, DEFAULT_EXCLUDE as Q, resolveAbsolutePathSpecifier as R, resolveAssetFile as S, isUnresolvedParentDrop as St, findSheetAssetSpecifiers as T, systemLoadDiagnostics as Tt, isJsonString as U, walkPackageSources as V, readTsconfigAliasPairs as W, AnimusConfigError as X, discoverFiles as Y, CORE_OPTION_KEYS as Z, applyUnitFallback as _, preprocessMdx as _t, assertNoErrorDiagnostics as a, resolveVerbosity as at, buildPathAliasesJson as b, VOCABULARY_LEGACY_VERB as bt, runStructuralSelfCheck as c, createV2EngineApi as ct, serializeStaticCss as d, parseFilesJson as dt, REPLACEABLE_DEFAULT_EXCLUDE as et, camelToKebab as f, projectExternalFileOwners as ft, runProjectAnalysis as g, isEngineTransformExtension as gt, clearEngineCache as h, ENGINE_TRANSFORM_EXTENSIONS as ht, snapshotFilePlans as i, resolveMode as it, collectExternalPackageSources as j, buildAnalyzeProjectArgs as jt, substituteSheetAssets as k, parseInternalWire as kt, loadSystemConfig as l, ingestSourceEntries as lt, buildAnalysisInputs as m, DEFAULT_EXTENSIONS as mt, diffFilePlans as n, assertKnownOptionKeys as nt, buildSystemPropsModule as o, RETIRED_ENGINE_MESSAGE as ot, stableStringify as p, adaptSvelteSource as pt, sharesVolumeRoot as q, hashReplacementPlans as r, createExcludeMatcher as rt, buildDynamicPropConfig as s, assertNoRetiredEngineSelection as st, toWatchKeys as t, STRUCTURAL_EXCLUDE as tt, applyPrefix as u, isAdvisorySourceDiagnostic as ut, postProcessCss as v, INVALID_PROPERTY_REGISTRATION as vt, findAssetSpecifiers as w, surfaceManifestDiagnostics as wt, enforceExternalTokenContracts as x, isDeletedSource as xt, resolveLightningTargets as y, VOCABULARY_COLLISION as yt, staleDistIncludesMessage as z };
+export { resolveVerbosity as $, firstOwners as A, substituteSheetAssets as At, isPathWithinRoot as B, resolveThroughPathAliases as C, unresolvedParentName as Ct, excludeCollectedPackages as D, generatedModuleCode as Dt, engineModuleParser as E, findSheetAssetSpecifiers as Et, walkPackageSources as F, assembleStylesheet as Ft, CORE_OPTION_KEYS as G, compareDiscoveryOrder as H, isJsonBlock as I, stripLeadingLayerDeclaration as It, REPLACEABLE_DEFAULT_EXCLUDE as J, DEFAULT_EXCLUDE as K, isJsonString as L, validateLayerOrder as Lt, resolveAbsolutePathSpecifier as M, contentHash as Mt, staleDistIncludesMessage as N, buildAnalyzeProjectArgs as Nt, extractSystemFilePackages as O, reportSurvivingAssetPlaceholders as Ot, unresolvableIncludesMessage as P, ANIMUS_LAYERS as Pt, resolveMode as Q, readTsconfigAliasPairs as R, __require as Rt, resolveAssetFile as S, unreadableSourceDiagnostic as St, collectExternalPackageSources as T, findAssetSpecifiers as Tt, discoverFiles as U, sharesVolumeRoot as V, AnimusConfigError as W, assertKnownOptionKeys as X, STRUCTURAL_EXCLUDE as Y, createExcludeMatcher as Z, applyUnitFallback as _, isDeletedSource as _t, assertNoErrorDiagnostics as a, parseFilesJson as at, buildPathAliasesJson as b, surfaceManifestDiagnostics as bt, runStructuralSelfCheck as c, DEFAULT_EXTENSIONS as ct, serializeStaticCss as d, preprocessMdx as dt, RETIRED_ENGINE_MESSAGE as et, camelToKebab as f, DIAGNOSTIC_LEVELS as ft, runProjectAnalysis as g, VOCABULARY_LEGACY_VERB as gt, clearEngineCache as h, VOCABULARY_COLLISION as ht, snapshotFilePlans as i, isAdvisorySourceDiagnostic as it, isExcludedPackageRelativePath as j, parseInternalWire as jt, findPackageRoot as k, substituteAssetPlaceholders as kt, loadSystemConfig as l, ENGINE_TRANSFORM_EXTENSIONS as lt, buildAnalysisInputs as m, INVALID_PROPERTY_REGISTRATION as mt, diffFilePlans as n, createV2EngineApi as nt, buildSystemPropsModule as o, projectExternalFileOwners as ot, stableStringify as p, DiagnosticFailure as pt, DRIVER_NAMESPACES as q, hashReplacementPlans as r, ingestSourceEntries as rt, buildDynamicPropConfig as s, adaptSvelteSource as st, toWatchKeys as t, assertNoRetiredEngineSelection as tt, applyPrefix as u, isEngineTransformExtension as ut, postProcessCss as v, isUnresolvedParentDrop as vt, createSourceCorpus as w, vocabularyWitnessDiagnostics as wt, enforceExternalTokenContracts as x, systemLoadDiagnostics as xt, resolveLightningTargets as y, noKitFilesDiagnostics as yt, createSourceIdentity as z };