@animus-ui/layergate 0.0.0-stage → 0.1.35

package/dist/host-BGcb1rMJ.mjs

@@ -0,0 +1,169 @@
+import { t as readSheet } from "./sheet-DJGhbeYI.mjs";
+import { dirname, join, posix } from "node:path";
+import { readFileSync, realpathSync } from "node:fs";
+//#region src/host.ts
+/**
+* What every host adapter shares: file identity by realpath, which files
+* the plan owns (declared sheets, and listed dependencies by the package
+* that holds them), whether a stylesheet reaches an owned file, and how a
+* diagnostic prints.
+*/
+/** A path with forward slashes, normalized. */
+const slashes = (path) => posix.normalize(path.replace(/\\/g, "/"));
+/** A path through symlinks, with forward slashes. */
+function real(path) {
+	try {
+		return slashes(realpathSync(path));
+	} catch {
+		return slashes(path);
+	}
+}
+/** A module id's file, without its query, by realpath. */
+const fileOf = (id) => real(id.split("?")[0]);
+/** Resolves each of `specifiers`, a plan's `what` list, with `resolveOne`;
+*  one that resolves to nothing fails, naming it. */
+function resolveEach(specifiers, what, root, resolveOne) {
+	return Promise.all(specifiers.map(async (specifier) => {
+		const file = await resolveOne(specifier);
+		if (!file) throw new Error(`[layergate] ${what}: cannot resolve "${specifier}" from ${root}`);
+		return file;
+	}));
+}
+/** The nearest `package.json` above `dir`: its directory and name. */
+function packageOf(dir, cache) {
+	const visited = [];
+	let current = dir;
+	let found = null;
+	for (;;) {
+		if (cache.has(current)) {
+			found = cache.get(current);
+			break;
+		}
+		visited.push(current);
+		try {
+			const { name } = JSON.parse(readFileSync(join(current, "package.json"), "utf8"));
+			found = {
+				dir: current,
+				name: name ?? ""
+			};
+			break;
+		} catch {
+			const parent = dirname(current);
+			if (parent === current) break;
+			current = parent;
+		}
+	}
+	for (const dirVisited of visited) cache.set(dirVisited, found);
+	return found;
+}
+/** Which files a plan owns, by realpath: a declared sheet, or a file of a
+*  listed dependency, a package other than the app's (`root`'s). */
+function ownership(plan) {
+	const packages = /* @__PURE__ */ new Map();
+	let app = null;
+	let declared = [];
+	return {
+		/** Sets the app root and the declared sheets, by realpath. */
+		reset(root, sheets) {
+			app = packageOf(real(root), packages);
+			declared = sheets;
+		},
+		get declared() {
+			return declared;
+		},
+		/** Whether the plan can own anything at all. */
+		owning: () => declared.length > 0 || plan.dependencies !== false,
+		owns(file) {
+			if (declared.includes(file)) return true;
+			if (plan.dependencies === false) return false;
+			const owner = packageOf(dirname(file), packages);
+			if (!owner || owner.dir === app?.dir) return false;
+			return plan.dependencies === true || plan.dependencies.has(owner.name);
+		}
+	};
+}
+/** Whether the stylesheet `file`, whose `@import`s are `imports`, reaches
+*  an owned file: resolved only, never compiled. */
+async function reachesOwned(file, imports, options, seen = /* @__PURE__ */ new Set()) {
+	if (seen.has(file)) return false;
+	seen.add(file);
+	if (options.owns(file)) return true;
+	for (const statement of imports) {
+		const child = await options.resolve(statement.url, file);
+		if (!child) continue;
+		if (await reachesOwned(child, (options.parsed?.get(child)?.sheet ?? readSheet(await options.read(child).catch(() => ""))).imports, options, seen)) return true;
+	}
+	return false;
+}
+/**
+* What a host keeps between compiles: parsed files, the files each
+* finished stylesheet (a unit) read, and whether a stylesheet reaches an
+* owned file, each kept until a file it depends on changes.
+*/
+var Units = class {
+	/** Parsed files, for `compileUnit`'s `cache`. */
+	parsed = /* @__PURE__ */ new Map();
+	filesByUnit = /* @__PURE__ */ new Map();
+	unitsByFile = /* @__PURE__ */ new Map();
+	reached = /* @__PURE__ */ new Map();
+	realpaths = /* @__PURE__ */ new Map();
+	/** `file` by realpath, the identity ownership, opt-outs and the declared
+	*  sheets are decided by, wherever a host reads it from. */
+	canonical(file) {
+		let path = this.realpaths.get(file);
+		if (path === void 0) this.realpaths.set(file, path = real(file));
+		return path;
+	}
+	/** Records the files `unit` read. Returns the files no unit reads any
+	*  more, whose parses are forgotten. */
+	record(unit, files) {
+		const current = new Set(files);
+		const forgotten = [];
+		for (const file of this.filesByUnit.get(unit) ?? []) {
+			if (current.has(file)) continue;
+			const units = this.unitsByFile.get(file);
+			units?.delete(unit);
+			if (units?.size === 0) {
+				this.unitsByFile.delete(file);
+				this.parsed.delete(file);
+				forgotten.push(file);
+			}
+		}
+		this.filesByUnit.set(unit, current);
+		for (const file of current) {
+			let units = this.unitsByFile.get(file);
+			if (!units) this.unitsByFile.set(file, units = /* @__PURE__ */ new Set());
+			units.add(unit);
+		}
+		return forgotten;
+	}
+	/** Whether a finished stylesheet read `file`. */
+	reads(file) {
+		return this.unitsByFile.has(file);
+	}
+	/** Forgets `file`'s parse and every reach answer, and returns the units
+	*  that read it. */
+	changed(file) {
+		this.parsed.delete(file);
+		this.realpaths.delete(file);
+		this.reached.clear();
+		return this.unitsByFile.get(file) ?? /* @__PURE__ */ new Set();
+	}
+	/** `reachesOwned`, answered once per file until a file changes. */
+	async reaches(file, imports, options) {
+		let reached = this.reached.get(file);
+		if (reached === void 0) {
+			reached = await reachesOwned(file, imports, {
+				...options,
+				parsed: this.parsed
+			});
+			this.reached.set(file, reached);
+		}
+		return reached;
+	}
+};
+function formatDiagnostic(diagnostic) {
+	return `[layergate] ${diagnostic.file ? `${diagnostic.file}${diagnostic.line ? `:${diagnostic.line}:${diagnostic.column}` : ""}: ` : ""}${diagnostic.message} [${diagnostic.code}]`;
+}
+//#endregion
+export { real as a, ownership as i, fileOf as n, resolveEach as o, formatDiagnostic as r, slashes as s, Units as t };

package/dist/host-C4ZaMdkx.cjs

@@ -0,0 +1,210 @@
+const require_sheet = require("./sheet-BUnyt5Jt.cjs");
+let node_path = require("node:path");
+let node_fs = require("node:fs");
+//#region src/host.ts
+/**
+* What every host adapter shares: file identity by realpath, which files
+* the plan owns (declared sheets, and listed dependencies by the package
+* that holds them), whether a stylesheet reaches an owned file, and how a
+* diagnostic prints.
+*/
+/** A path with forward slashes, normalized. */
+const slashes = (path) => node_path.posix.normalize(path.replace(/\\/g, "/"));
+/** A path through symlinks, with forward slashes. */
+function real(path) {
+	try {
+		return slashes((0, node_fs.realpathSync)(path));
+	} catch {
+		return slashes(path);
+	}
+}
+/** A module id's file, without its query, by realpath. */
+const fileOf = (id) => real(id.split("?")[0]);
+/** Resolves each of `specifiers`, a plan's `what` list, with `resolveOne`;
+*  one that resolves to nothing fails, naming it. */
+function resolveEach(specifiers, what, root, resolveOne) {
+	return Promise.all(specifiers.map(async (specifier) => {
+		const file = await resolveOne(specifier);
+		if (!file) throw new Error(`[layergate] ${what}: cannot resolve "${specifier}" from ${root}`);
+		return file;
+	}));
+}
+/** The nearest `package.json` above `dir`: its directory and name. */
+function packageOf(dir, cache) {
+	const visited = [];
+	let current = dir;
+	let found = null;
+	for (;;) {
+		if (cache.has(current)) {
+			found = cache.get(current);
+			break;
+		}
+		visited.push(current);
+		try {
+			const { name } = JSON.parse((0, node_fs.readFileSync)((0, node_path.join)(current, "package.json"), "utf8"));
+			found = {
+				dir: current,
+				name: name ?? ""
+			};
+			break;
+		} catch {
+			const parent = (0, node_path.dirname)(current);
+			if (parent === current) break;
+			current = parent;
+		}
+	}
+	for (const dirVisited of visited) cache.set(dirVisited, found);
+	return found;
+}
+/** Which files a plan owns, by realpath: a declared sheet, or a file of a
+*  listed dependency, a package other than the app's (`root`'s). */
+function ownership(plan) {
+	const packages = /* @__PURE__ */ new Map();
+	let app = null;
+	let declared = [];
+	return {
+		/** Sets the app root and the declared sheets, by realpath. */
+		reset(root, sheets) {
+			app = packageOf(real(root), packages);
+			declared = sheets;
+		},
+		get declared() {
+			return declared;
+		},
+		/** Whether the plan can own anything at all. */
+		owning: () => declared.length > 0 || plan.dependencies !== false,
+		owns(file) {
+			if (declared.includes(file)) return true;
+			if (plan.dependencies === false) return false;
+			const owner = packageOf((0, node_path.dirname)(file), packages);
+			if (!owner || owner.dir === app?.dir) return false;
+			return plan.dependencies === true || plan.dependencies.has(owner.name);
+		}
+	};
+}
+/** Whether the stylesheet `file`, whose `@import`s are `imports`, reaches
+*  an owned file: resolved only, never compiled. */
+async function reachesOwned(file, imports, options, seen = /* @__PURE__ */ new Set()) {
+	if (seen.has(file)) return false;
+	seen.add(file);
+	if (options.owns(file)) return true;
+	for (const statement of imports) {
+		const child = await options.resolve(statement.url, file);
+		if (!child) continue;
+		if (await reachesOwned(child, (options.parsed?.get(child)?.sheet ?? require_sheet.readSheet(await options.read(child).catch(() => ""))).imports, options, seen)) return true;
+	}
+	return false;
+}
+/**
+* What a host keeps between compiles: parsed files, the files each
+* finished stylesheet (a unit) read, and whether a stylesheet reaches an
+* owned file, each kept until a file it depends on changes.
+*/
+var Units = class {
+	/** Parsed files, for `compileUnit`'s `cache`. */
+	parsed = /* @__PURE__ */ new Map();
+	filesByUnit = /* @__PURE__ */ new Map();
+	unitsByFile = /* @__PURE__ */ new Map();
+	reached = /* @__PURE__ */ new Map();
+	realpaths = /* @__PURE__ */ new Map();
+	/** `file` by realpath, the identity ownership, opt-outs and the declared
+	*  sheets are decided by, wherever a host reads it from. */
+	canonical(file) {
+		let path = this.realpaths.get(file);
+		if (path === void 0) this.realpaths.set(file, path = real(file));
+		return path;
+	}
+	/** Records the files `unit` read. Returns the files no unit reads any
+	*  more, whose parses are forgotten. */
+	record(unit, files) {
+		const current = new Set(files);
+		const forgotten = [];
+		for (const file of this.filesByUnit.get(unit) ?? []) {
+			if (current.has(file)) continue;
+			const units = this.unitsByFile.get(file);
+			units?.delete(unit);
+			if (units?.size === 0) {
+				this.unitsByFile.delete(file);
+				this.parsed.delete(file);
+				forgotten.push(file);
+			}
+		}
+		this.filesByUnit.set(unit, current);
+		for (const file of current) {
+			let units = this.unitsByFile.get(file);
+			if (!units) this.unitsByFile.set(file, units = /* @__PURE__ */ new Set());
+			units.add(unit);
+		}
+		return forgotten;
+	}
+	/** Whether a finished stylesheet read `file`. */
+	reads(file) {
+		return this.unitsByFile.has(file);
+	}
+	/** Forgets `file`'s parse and every reach answer, and returns the units
+	*  that read it. */
+	changed(file) {
+		this.parsed.delete(file);
+		this.realpaths.delete(file);
+		this.reached.clear();
+		return this.unitsByFile.get(file) ?? /* @__PURE__ */ new Set();
+	}
+	/** `reachesOwned`, answered once per file until a file changes. */
+	async reaches(file, imports, options) {
+		let reached = this.reached.get(file);
+		if (reached === void 0) {
+			reached = await reachesOwned(file, imports, {
+				...options,
+				parsed: this.parsed
+			});
+			this.reached.set(file, reached);
+		}
+		return reached;
+	}
+};
+function formatDiagnostic(diagnostic) {
+	return `[layergate] ${diagnostic.file ? `${diagnostic.file}${diagnostic.line ? `:${diagnostic.line}:${diagnostic.column}` : ""}: ` : ""}${diagnostic.message} [${diagnostic.code}]`;
+}
+//#endregion
+Object.defineProperty(exports, "Units", {
+	enumerable: true,
+	get: function() {
+		return Units;
+	}
+});
+Object.defineProperty(exports, "fileOf", {
+	enumerable: true,
+	get: function() {
+		return fileOf;
+	}
+});
+Object.defineProperty(exports, "formatDiagnostic", {
+	enumerable: true,
+	get: function() {
+		return formatDiagnostic;
+	}
+});
+Object.defineProperty(exports, "ownership", {
+	enumerable: true,
+	get: function() {
+		return ownership;
+	}
+});
+Object.defineProperty(exports, "real", {
+	enumerable: true,
+	get: function() {
+		return real;
+	}
+});
+Object.defineProperty(exports, "resolveEach", {
+	enumerable: true,
+	get: function() {
+		return resolveEach;
+	}
+});
+Object.defineProperty(exports, "slashes", {
+	enumerable: true,
+	get: function() {
+		return slashes;
+	}
+});

package/dist/index.cjs

@@ -0,0 +1,6 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_compile = require("./compile-C4GyCiuY.cjs");
+const require_plan = require("./plan-hvk04qzh.cjs");
+exports.LayergateConfigError = require_plan.LayergateConfigError;
+exports.compileUnit = require_compile.compileUnit;
+exports.resolvePlan = require_plan.resolvePlan;

package/dist/index.d.cts

@@ -0,0 +1,3 @@
+import { a as Severity, i as ParsedSheet, n as CompiledUnit, o as compileUnit, r as LayergateDiagnostic, t as CompileOptions } from "./compile-DZwVBjTM.cjs";
+import { i as resolvePlan, n as LayergateOptions, r as LayergatePlan, t as LayergateConfigError } from "./plan-w-y0limy.cjs";
+export { type CompileOptions, type CompiledUnit, LayergateConfigError, type LayergateDiagnostic, type LayergateOptions, type LayergatePlan, type ParsedSheet, type Severity, compileUnit, resolvePlan };

package/dist/index.d.mts

@@ -0,0 +1,3 @@
+import { a as Severity, i as ParsedSheet, n as CompiledUnit, o as compileUnit, r as LayergateDiagnostic, t as CompileOptions } from "./compile-DZwVBjTM.mjs";
+import { i as resolvePlan, n as LayergateOptions, r as LayergatePlan, t as LayergateConfigError } from "./plan-w-y0limy.mjs";
+export { type CompileOptions, type CompiledUnit, LayergateConfigError, type LayergateDiagnostic, type LayergateOptions, type LayergatePlan, type ParsedSheet, type Severity, compileUnit, resolvePlan };

package/dist/index.mjs

@@ -0,0 +1,3 @@
+import { t as compileUnit } from "./compile-Cu_GFS3l.mjs";
+import { n as resolvePlan, t as LayergateConfigError } from "./plan-Bsn_yxS9.mjs";
+export { LayergateConfigError, compileUnit, resolvePlan };

package/dist/plan-Bsn_yxS9.mjs

@@ -0,0 +1,29 @@
+//#region src/plan.ts
+/** A layer name: identifiers joined by dots. */
+const LAYER_NAME = /^-?[_a-zA-Z][\w-]*(?:\.-?[_a-zA-Z][\w-]*)*$/;
+var LayergateConfigError = class extends Error {
+	name = "LayergateConfigError";
+};
+/** The plan `options` describe, or a `LayergateConfigError`. */
+function resolvePlan(options = {}) {
+	const layer = options.layer ?? "vendor";
+	if (!LAYER_NAME.test(layer)) throw new LayergateConfigError(`layer "${layer}" is not a layer name`);
+	const order = options.order ?? [layer];
+	for (const name of order) if (!LAYER_NAME.test(name)) throw new LayergateConfigError(`order: "${name}" is not a layer name`);
+	const duplicate = order.find((name, index) => order.indexOf(name) !== index);
+	if (duplicate) throw new LayergateConfigError(`order: "${duplicate}" appears twice`);
+	if (!order.includes(layer)) throw new LayergateConfigError(`order must include the quarantine layer "${layer}"`);
+	const optOut = options.optOut ?? [];
+	const glob = optOut.find((entry) => /[*?[\]{}]/.test(entry));
+	if (glob) throw new LayergateConfigError(`optOut: "${glob}" is a pattern; list exact files`);
+	const dependencies = options.dependencies ?? false;
+	return {
+		layer,
+		order,
+		sheets: options.sheets ?? [],
+		dependencies: dependencies === true || dependencies === false ? dependencies : new Set(dependencies),
+		optOut
+	};
+}
+//#endregion
+export { resolvePlan as n, LayergateConfigError as t };

package/dist/plan-hvk04qzh.cjs

@@ -0,0 +1,40 @@
+//#region src/plan.ts
+/** A layer name: identifiers joined by dots. */
+const LAYER_NAME = /^-?[_a-zA-Z][\w-]*(?:\.-?[_a-zA-Z][\w-]*)*$/;
+var LayergateConfigError = class extends Error {
+	name = "LayergateConfigError";
+};
+/** The plan `options` describe, or a `LayergateConfigError`. */
+function resolvePlan(options = {}) {
+	const layer = options.layer ?? "vendor";
+	if (!LAYER_NAME.test(layer)) throw new LayergateConfigError(`layer "${layer}" is not a layer name`);
+	const order = options.order ?? [layer];
+	for (const name of order) if (!LAYER_NAME.test(name)) throw new LayergateConfigError(`order: "${name}" is not a layer name`);
+	const duplicate = order.find((name, index) => order.indexOf(name) !== index);
+	if (duplicate) throw new LayergateConfigError(`order: "${duplicate}" appears twice`);
+	if (!order.includes(layer)) throw new LayergateConfigError(`order must include the quarantine layer "${layer}"`);
+	const optOut = options.optOut ?? [];
+	const glob = optOut.find((entry) => /[*?[\]{}]/.test(entry));
+	if (glob) throw new LayergateConfigError(`optOut: "${glob}" is a pattern; list exact files`);
+	const dependencies = options.dependencies ?? false;
+	return {
+		layer,
+		order,
+		sheets: options.sheets ?? [],
+		dependencies: dependencies === true || dependencies === false ? dependencies : new Set(dependencies),
+		optOut
+	};
+}
+//#endregion
+Object.defineProperty(exports, "LayergateConfigError", {
+	enumerable: true,
+	get: function() {
+		return LayergateConfigError;
+	}
+});
+Object.defineProperty(exports, "resolvePlan", {
+	enumerable: true,
+	get: function() {
+		return resolvePlan;
+	}
+});

package/dist/plan-w-y0limy.d.cts

@@ -0,0 +1,35 @@
+//#region src/plan.d.ts
+/** What layergate owns and how it layers it, as configured. */
+interface LayergateOptions {
+  /** The cascade layer each owned stylesheet's own rules go into. Default
+   *  `vendor`. */
+  layer?: string;
+  /** The full layer order every finished stylesheet declares first; it must
+   *  include `layer`. Default: `[layer]`. */
+  order?: readonly string[];
+  /** Stylesheets `virtual:layergate` delivers, in this order, whether or
+   *  not anything else imports them: package specifiers or paths relative
+   *  to the Vite root. */
+  sheets?: readonly string[];
+  /** Also own `.css` a JS module imports from a package other than the app:
+   *  `true` for every package, or the package names. Default: none. */
+  dependencies?: boolean | readonly string[];
+  /** Files inside an owned graph whose own rules stay outside the layer:
+   *  exact package specifiers or paths, never globs. */
+  optOut?: readonly string[];
+}
+interface LayergatePlan {
+  layer: string;
+  order: readonly string[];
+  sheets: readonly string[];
+  dependencies: boolean | ReadonlySet<string>;
+  optOut: readonly string[];
+}
+declare class LayergateConfigError extends Error {
+  name: string;
+}
+/** The plan `options` describe, or a `LayergateConfigError`. */
+declare function resolvePlan(options?: LayergateOptions): LayergatePlan;
+//#endregion
+export { resolvePlan as i, LayergateOptions as n, LayergatePlan as r, LayergateConfigError as t };
+//# sourceMappingURL=plan-w-y0limy.d.cts.map

package/dist/plan-w-y0limy.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-w-y0limy.d.cts","names":[],"sources":["../src/plan.ts"],"mappings":";;UACiB;;;EAGf;;;EAGA;;;;EAIA;;;EAGA;;;EAGA;;UAGe;EACf;EACA;EACA;EACA,wBAAwB;EACxB;;cAMW,6BAA6B;EAC/B;;;iBAIK,YAAY,UAAS,mBAAwB"}

package/dist/plan-w-y0limy.d.mts

@@ -0,0 +1,35 @@
+//#region src/plan.d.ts
+/** What layergate owns and how it layers it, as configured. */
+interface LayergateOptions {
+  /** The cascade layer each owned stylesheet's own rules go into. Default
+   *  `vendor`. */
+  layer?: string;
+  /** The full layer order every finished stylesheet declares first; it must
+   *  include `layer`. Default: `[layer]`. */
+  order?: readonly string[];
+  /** Stylesheets `virtual:layergate` delivers, in this order, whether or
+   *  not anything else imports them: package specifiers or paths relative
+   *  to the Vite root. */
+  sheets?: readonly string[];
+  /** Also own `.css` a JS module imports from a package other than the app:
+   *  `true` for every package, or the package names. Default: none. */
+  dependencies?: boolean | readonly string[];
+  /** Files inside an owned graph whose own rules stay outside the layer:
+   *  exact package specifiers or paths, never globs. */
+  optOut?: readonly string[];
+}
+interface LayergatePlan {
+  layer: string;
+  order: readonly string[];
+  sheets: readonly string[];
+  dependencies: boolean | ReadonlySet<string>;
+  optOut: readonly string[];
+}
+declare class LayergateConfigError extends Error {
+  name: string;
+}
+/** The plan `options` describe, or a `LayergateConfigError`. */
+declare function resolvePlan(options?: LayergateOptions): LayergatePlan;
+//#endregion
+export { resolvePlan as i, LayergateOptions as n, LayergatePlan as r, LayergateConfigError as t };
+//# sourceMappingURL=plan-w-y0limy.d.mts.map

package/dist/plan-w-y0limy.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-w-y0limy.d.mts","names":[],"sources":["../src/plan.ts"],"mappings":";;UACiB;;;EAGf;;;EAGA;;;;EAIA;;;EAGA;;;EAGA;;UAGe;EACf;EACA;EACA;EACA,wBAAwB;EACxB;;cAMW,6BAA6B;EAC/B;;;iBAIK,YAAY,UAAS,mBAAwB"}