@design-token-kit/core 0.2.1 → 0.3.0

package/lib/index.js

@@ -1,11 +1,216 @@
-import { readFile, readdir, writeFile } from "node:fs/promises";
 import { existsSync } from "node:fs";
+import { readFile, readdir, writeFile } from "node:fs/promises";
 import { randomUUID } from "node:crypto";
 import path from "node:path";
 import { tmpdir } from "node:os";
+import { parse, parseAllDocuments } from "yaml";
 import Ajv from "ajv";
 import addFormats from "ajv-formats";
 import { fileURLToPath } from "node:url";
+//#region src/core/model/DtcgList.ts
+/**
+* An ordered collection of DTCG documents representing a base token set and its theme overrides.
+*
+* The base document defines all tokens. Each theme document overrides a subset of them.
+* When validating a theme, references are resolved against the theme first, then the base.
+*
+* @see https://tr.designtokens.org/format/#file-format
+*/
+var DtcgList = class {
+	base;
+	themes;
+	constructor(base, themes) {
+		this.base = base;
+		this.themes = themes ?? /* @__PURE__ */ new Map();
+	}
+	validate() {
+		const issues = this.base.validate();
+		for (const theme of this.themes.values()) issues.push(...theme.validate(this.base));
+		return issues;
+	}
+};
+//#endregion
+//#region src/core/io/Format.ts
+/**
+* Token formats.
+*/
+var Format = /* @__PURE__ */ function(Format) {
+	/**
+	* DTCG (Design Tokens Community Group) JSON token format.
+	*
+	* @see https://tr.designtokens.org/format/
+	*/
+	Format["DTCG"] = "dtcg";
+	/**
+	* HRDT (Human-Readable Design Tokens) YAML token format.
+	*/
+	Format["HRDT"] = "hrdt";
+	/**
+	* CSS custom properties.
+	*/
+	Format["CSS"] = "css";
+	return Format;
+}({});
+//#endregion
+//#region src/core/io/FormatDetector.ts
+/**
+* Detects the token format from raw content by inspecting the content
+* structure rather than relying on file extensions.
+*
+* Supported formats: {@link Format.DTCG} (JSON), {@link Format.HRDT} (YAML),
+* and {@link Format.CSS}.
+*/
+var FormatDetector = class FormatDetector {
+	/**
+	* Detects the format of the given content.
+	*
+	* Detection rules:
+	* - If content starts with `{` and is valid JSON it is treated as DTCG.
+	* - If content contains CSS-specific patterns (`:root`, custom properties,
+	*   `@layer`) it is treated as CSS.
+	* - Otherwise it is treated as HRDT.
+	*/
+	static detect(content) {
+		const trimmed = content.trimStart();
+		if (trimmed.length === 0) return Format.HRDT;
+		if (FormatDetector.isDtcg(trimmed)) return Format.DTCG;
+		if (FormatDetector.isCss(trimmed)) return Format.CSS;
+		return Format.HRDT;
+	}
+	/**
+	* Returns `true` when the content looks like a DTCG JSON document.
+	*
+	* The check is structural: content must start with `{` and be parseable
+	* as JSON.
+	*/
+	static isDtcg(content) {
+		if (!content.startsWith("{")) return false;
+		try {
+			JSON.parse(content);
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	/**
+	* Returns `true` when the content looks like CSS.
+	*
+	* Detects the presence of CSS custom properties (`--name:`),
+	* {@code :root} selector, or {@code @layer} at-rules.
+	*/
+	static isCss(content) {
+		return /(^|\s)--[a-zA-Z0-9_-]+\s*:/.test(content) || /(^|\s):root\b/.test(content) || /(^|\s)@layer\b/.test(content);
+	}
+};
+//#endregion
+//#region src/core/Stdin.ts
+/**
+* Singleton reader for {@code process.stdin}.
+*
+* The underlying stream can only be consumed once per process.
+* After the first call to {@link get} the content is cached and
+* subsequent calls return the cached buffer.
+*/
+var Stdin = class {
+	#buffer;
+	/**
+	* Returns the cached stdin content, or reads the stream on the first
+	* call.
+	*
+	* @throws Error if stdin is a TTY (no data piped).
+	*/
+	async get() {
+		if (this.#buffer === void 0) this.#buffer = await this.#read();
+		return this.#buffer;
+	}
+	/**
+	* Returns {@code true} when stdin is piped (not a TTY) and data is
+	* available to read.
+	*/
+	hasData() {
+		return !process.stdin.isTTY;
+	}
+	async #read() {
+		if (!this.hasData()) throw new Error("Cannot read from stdin: no input. Pipe data via '< file' or provide file arguments.");
+		const chunks = [];
+		for await (const chunk of process.stdin) chunks.push(typeof chunk === "string" ? Buffer.from(chunk, "utf8") : chunk);
+		if (chunks.length === 0) throw new Error("Cannot read from stdin: stream ended without data");
+		return Buffer.concat(chunks).toString("utf8");
+	}
+};
+var stdin = new Stdin();
+//#endregion
+//#region src/core/Source.ts
+var SourceType = /* @__PURE__ */ function(SourceType) {
+	SourceType["URL"] = "url";
+	SourceType["FILE"] = "file";
+	SourceType["CONTENT"] = "content";
+	SourceType["STDIN"] = "stdin";
+	return SourceType;
+}(SourceType || {});
+/**
+* Data source.
+* Wraps URL, File, stdin ({@code "-"}) or raw content.
+*
+* Allows returning any of these data sources as a file.
+* Used in tool implementations to simplify the interface.
+*/
+var Source = class Source {
+	#type;
+	#input;
+	#content;
+	#format;
+	#filePath;
+	constructor(input) {
+		this.#input = input;
+		if (input === "-") this.#type = SourceType.STDIN;
+		else if (Source.#isUrl(input)) this.#type = SourceType.URL;
+		else if (existsSync(input)) this.#type = SourceType.FILE;
+		else this.#type = SourceType.CONTENT;
+	}
+	static #isUrl(value) {
+		try {
+			new URL(value);
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	getInput() {
+		return this.#input;
+	}
+	getType() {
+		return this.#type;
+	}
+	async getFormat() {
+		if (this.#format === void 0) this.#format = FormatDetector.detect(await this.getContent());
+		return this.#format;
+	}
+	async getContent() {
+		if (this.#content !== void 0) return this.#content;
+		if (this.#type === SourceType.STDIN) this.#content = await stdin.get();
+		else if (this.#type === SourceType.FILE) this.#content = await readFile(this.#input, "utf8");
+		else if (this.#type === SourceType.URL) {
+			const response = await fetch(this.#input);
+			if (!response.ok) throw new Error(`Unable to fetch "${this.#input}": HTTP ${response.status}`);
+			this.#content = await response.text();
+		} else if (this.#type === SourceType.CONTENT) this.#content = this.#input;
+		else throw new Error(`Unsupported source type "${this.#type}: ${this.#input}"`);
+		return this.#content;
+	}
+	async getFile() {
+		if (this.#filePath !== void 0) return this.#filePath;
+		if (this.#type === SourceType.FILE) this.#filePath = this.#input;
+		else this.#filePath = await Source.#writeTemp(await this.getContent());
+		return this.#filePath;
+	}
+	static async #writeTemp(content) {
+		const filePath = path.join(tmpdir(), `designtokens-${randomUUID()}.tmp`);
+		await writeFile(filePath, content, "utf8");
+		return filePath;
+	}
+};
+//#endregion
 //#region src/core/model/TokenGroup.ts
 /**
 * A named container for tokens and nested groups.
@@ -253,14 +458,28 @@ var TypographyValue = class {
 */
 var Dtcg = class {
 	#root;
-	constructor(root) {
+	/**
+	* The origin of this token document.
+	*
+	* Can be a file path ({@code "tokens.json"}), a URL, or
+	* {@code "-"} for stdin.
+	* Used in validation diagnostics as the {@code sourcePath}.
+	*/
+	source;
+	constructor(root, source) {
 		this.#root = root;
+		this.source = source;
 	}
-	/** Returns the top-level child token or group with the given name, or undefined. */
+	/**
+	* Returns the top-level child token or group with the given name,
+	* or undefined.
+	*/
 	get(name) {
 		return this.#root.get(name);
 	}
-	/** Returns all top-level child names in insertion order. */
+	/**
+	* Returns all top-level child names in insertion order.
+	*/
 	keys() {
 		return this.#root.keys();
 	}
@@ -282,6 +501,10 @@ var Dtcg = class {
 		const issues = [];
 		const seen = /* @__PURE__ */ new Set();
 		this.#validateGroup(this.#root, [], issues, seen, base);
+		for (const issue of issues) {
+			issue.name = "internal";
+			if (this.source !== void 0) issue.sourcePath = this.source;
+		}
 		return issues;
 	}
 	#push(issues, seen, severity, tokenPath, message) {
@@ -291,7 +514,7 @@ var Dtcg = class {
 		issues.push({
 			tokenPath,
 			severity,
-			message
+			message: message.includes(tokenPath) ? message : `${tokenPath}: ${message}`
 		});
 	}
 	#validateGroup(group, path, issues, seen, base) {
@@ -672,408 +895,75 @@ var DurationValue = class {
 	}
 };
 //#endregion
-//#region src/core/io/HrdtTokenReader.ts
-var DIMENSION_RE = /^(-?\d+(?:\.\d+)?)(px|rem)$/;
-var DURATION_RE = /^(-?\d+(?:\.\d+)?)(ms|s)$/;
-var HEX_RE = /^#([0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
-var REFERENCE_RE = /^\{[^{}]+\}$/;
-var TOKEN_TYPES = new Set([
-	"color",
-	"dimension",
-	"fontFamily",
-	"fontWeight",
-	"duration",
-	"cubicBezier",
-	"number",
-	"strokeStyle",
-	"border",
-	"transition",
-	"shadow",
-	"gradient",
-	"typography"
+//#region src/core/io/DtcgJsonReader.ts
+var GROUP_KEYS = new Set([
+	"$type",
+	"$description",
+	"$extensions",
+	"$deprecated",
+	"$extends",
+	"$root",
+	"$schema"
 ]);
 /**
-* Reads an HRDT token file and parses it directly into a {@link Dtcg} model.
+* Parses a DTCG 2025.10 JSON document into a {@link Dtcg}.
 *
-* The HRDT format uses YAML syntax and group path to infer token types
-* (e.g. `primitive.color.*` -> color tokens). Non-primitive groups
-* contain alias references to primitive tokens.
+* A child object is treated as a token when it contains `$value` or `$ref`,
+* and as a group otherwise.
+*
+* @see https://tr.designtokens.org/format/
 */
-var HrdtTokenReader = class {
-	parseRaw(hrdtContent) {
-		return new SimpleHrdtParser(hrdtContent).parse();
-	}
-	parse(hrdtContent) {
-		return new Dtcg(this.#parseRoot(new SimpleHrdtParser(hrdtContent).parse()));
-	}
-	async parseFile(filePath) {
-		return this.parse(await readFile(filePath, "utf8"));
+var DtcgJsonReader = class {
+	parse(content, source) {
+		const raw = JSON.parse(content);
+		return new Dtcg(this.#parseGroup(raw, void 0), source);
 	}
-	#parseRoot(raw) {
+	#parseGroup(raw, inheritedType) {
+		const type = this.#resolveType(raw["$type"], inheritedType);
+		const description = typeof raw["$description"] === "string" ? raw["$description"] : void 0;
+		const deprecated = this.#parseDeprecated(raw["$deprecated"]);
+		const extensions = this.#parseExtensions(raw["$extensions"]);
+		const extendsRef = this.#parseExtendsRef(raw["$extends"]);
+		const root = raw["$root"] != null ? this.#parseToken(raw["$root"], type) : void 0;
 		const children = /* @__PURE__ */ new Map();
 		for (const [key, value] of Object.entries(raw)) {
-			if (key === "$schema") continue;
-			if (!this.#isObject(value)) continue;
-			if (key === "primitive") children.set(key, this.#parsePrimitiveRoot(value));
-			else children.set(key, this.#parseReferenceGroup(value));
-		}
-		return new TokenGroup({ children });
-	}
-	#parsePrimitiveRoot(raw) {
-		const children = /* @__PURE__ */ new Map();
-		for (const [typeName, tokens] of Object.entries(raw)) {
-			if (!TOKEN_TYPES.has(typeName)) throw new HrdtTokenReaderError(`Unknown primitive token type: "${typeName}"`);
-			const tokenType = typeName;
-			children.set(typeName, this.#parsePrimitiveTypeGroup(tokens, tokenType));
+			if (GROUP_KEYS.has(key)) continue;
+			if (typeof value !== "object" || value === null || Array.isArray(value)) continue;
+			const child = value;
+			if (this.#isToken(child)) children.set(key, this.#parseToken(child, type));
+			else children.set(key, this.#parseGroup(child, type));
 		}
-		return new TokenGroup({ children });
-	}
-	#parsePrimitiveTypeGroup(raw, tokenType) {
-		const children = /* @__PURE__ */ new Map();
-		for (const [name, value] of Object.entries(raw)) children.set(name, this.#parsePrimitiveToken(value, tokenType));
 		return new TokenGroup({
-			type: tokenType,
+			type,
+			description,
+			deprecated,
+			extensions,
+			extends: extendsRef,
+			root,
 			children
 		});
 	}
-	#parsePrimitiveToken(value, tokenType) {
-		if (typeof value === "string" && REFERENCE_RE.test(value)) return new AliasToken(new TokenReference(value.slice(1, -1)));
-		switch (tokenType) {
-			case "color": return new ColorToken(this.#parseColor(value));
-			case "dimension": return new DimensionToken(this.#parseDimension(value));
-			case "fontFamily": return new FontFamilyToken(this.#parseFontFamily(value));
-			case "fontWeight": return new FontWeightToken(this.#parseFontWeight(value));
-			case "number": return new NumberToken(this.#parseNumber(value));
-			case "duration": return new DurationToken(this.#parseDuration(value));
-			case "cubicBezier": return new CubicBezierToken(this.#parseCubicBezier(value));
-			case "strokeStyle": return new StrokeStyleToken(this.#parseStrokeStyle(value));
-			case "border": return new BorderToken(this.#parseBorder(value));
-			case "transition": return new TransitionToken(this.#parseTransition(value));
-			case "shadow": return new ShadowToken(this.#parseShadow(value));
-			case "gradient": return new GradientToken(this.#parseGradient(value));
-			case "typography": return new TypographyToken(this.#parseTypography(value));
-		}
+	#isToken(raw) {
+		return "$value" in raw || "$ref" in raw;
 	}
-	#parseReferenceGroup(raw) {
-		const children = /* @__PURE__ */ new Map();
-		for (const [key, value] of Object.entries(raw)) if (this.#isLeaf(value)) children.set(key, this.#parseReferenceToken(value));
-		else children.set(key, this.#parseReferenceGroup(value));
-		return new TokenGroup({ children });
-	}
-	#isLeaf(value) {
-		return !this.#isObject(value) || Array.isArray(value);
-	}
-	#parseReferenceToken(value) {
-		if (typeof value === "string" && REFERENCE_RE.test(value)) return new AliasToken(new TokenReference(value.slice(1, -1)));
-		throw new HrdtTokenReaderError(`Expected a reference in non-primitive group, got: ${JSON.stringify(value)}`);
-	}
-	#parseColor(value) {
-		if (typeof value !== "string" || !HEX_RE.test(value)) throw new HrdtTokenReaderError(`Expected hex color, got: ${JSON.stringify(value)}`);
-		const normalized = value.toLowerCase();
-		const hex = normalized.slice(0, 7);
-		const r = parseInt(normalized.slice(1, 3), 16);
-		const g = parseInt(normalized.slice(3, 5), 16);
-		const b = parseInt(normalized.slice(5, 7), 16);
-		const alpha = normalized.length === 9 ? this.#round(parseInt(normalized.slice(7, 9), 16) / 255) : 1;
-		return new ColorValue("srgb", [
-			this.#round(r / 255),
-			this.#round(g / 255),
-			this.#round(b / 255)
-		], alpha, hex);
-	}
-	#parseDimension(value) {
-		if (typeof value !== "string") throw new HrdtTokenReaderError(`Expected dimension string, got: ${JSON.stringify(value)}`);
-		const match = value.match(DIMENSION_RE);
-		if (!match) throw new HrdtTokenReaderError(`Expected dimension with px/rem unit, got: "${value}"`);
-		return new DimensionValue(Number(match[1]), match[2]);
-	}
-	#parseFontFamily(value) {
-		if (typeof value === "string") return value;
-		if (Array.isArray(value) && value.every((v) => typeof v === "string")) return value;
-		throw new HrdtTokenReaderError(`Expected fontFamily string or array, got: ${JSON.stringify(value)}`);
-	}
-	#parseFontWeight(value) {
-		if (typeof value === "string" || typeof value === "number") return value;
-		throw new HrdtTokenReaderError(`Expected fontWeight string or number, got: ${JSON.stringify(value)}`);
-	}
-	#parseNumber(value) {
-		if (typeof value !== "number") throw new HrdtTokenReaderError(`Expected number, got: ${JSON.stringify(value)}`);
-		return value;
-	}
-	#parseDuration(value) {
-		if (typeof value !== "string") throw new HrdtTokenReaderError(`Expected duration string, got: ${JSON.stringify(value)}`);
-		const match = value.match(DURATION_RE);
-		if (!match) throw new HrdtTokenReaderError(`Expected duration with ms/s unit, got: "${value}"`);
-		return new DurationValue(Number(match[1]), match[2]);
-	}
-	#parseCubicBezier(value) {
-		if (!Array.isArray(value) || value.length !== 4 || !value.every((v) => typeof v === "number")) throw new HrdtTokenReaderError(`Expected cubicBezier [n, n, n, n], got: ${JSON.stringify(value)}`);
-		return new CubicBezierValue(value[0], value[1], value[2], value[3]);
-	}
-	#parseStrokeStyle(value) {
-		if (typeof value === "string") return value;
-		if (this.#isObject(value)) {
-			const obj = value;
-			return new StrokeStyleObject(obj["dashArray"].map((d) => this.#parseDimension(d)), obj["lineCap"]);
-		}
-		throw new HrdtTokenReaderError(`Expected strokeStyle, got: ${JSON.stringify(value)}`);
-	}
-	#parseBorder(value) {
-		if (!this.#isObject(value)) throw new HrdtTokenReaderError(`Expected border object, got: ${JSON.stringify(value)}`);
-		const obj = value;
-		return new BorderValue(this.#parseColor(obj["color"]), this.#parseDimension(obj["width"]), this.#parseStrokeStyle(obj["style"]));
-	}
-	#parseTransition(value) {
-		if (!this.#isObject(value)) throw new HrdtTokenReaderError(`Expected transition object, got: ${JSON.stringify(value)}`);
-		const obj = value;
-		return new TransitionValue(this.#parseDuration(obj["duration"]), this.#parseDuration(obj["delay"]), this.#parseCubicBezier(obj["timingFunction"]));
-	}
-	#parseShadow(value) {
-		if (Array.isArray(value)) return value.map((item) => this.#parseShadowLayer(item));
-		return this.#parseShadowLayer(value);
-	}
-	#parseShadowLayer(value) {
-		if (!this.#isObject(value)) throw new HrdtTokenReaderError(`Expected shadow layer object, got: ${JSON.stringify(value)}`);
-		const obj = value;
-		return new ShadowLayer(this.#parseColor(obj["color"]), this.#parseDimension(obj["offsetX"]), this.#parseDimension(obj["offsetY"]), this.#parseDimension(obj["blur"]), this.#parseDimension(obj["spread"]));
-	}
-	#parseGradient(value) {
-		if (!Array.isArray(value)) throw new HrdtTokenReaderError(`Expected gradient stops array, got: ${JSON.stringify(value)}`);
-		return value.map((item) => {
-			if (!this.#isObject(item)) throw new HrdtTokenReaderError(`Expected gradient stop object, got: ${JSON.stringify(item)}`);
-			const obj = item;
-			return new GradientStop(this.#parseColor(obj["color"]), this.#parseNumber(obj["position"]));
-		});
-	}
-	#parseTypography(value) {
-		if (!this.#isObject(value)) throw new HrdtTokenReaderError(`Expected typography object, got: ${JSON.stringify(value)}`);
-		const obj = value;
-		return new TypographyValue(this.#parseFontFamily(obj["fontFamily"]), this.#parseDimension(obj["fontSize"]), this.#parseFontWeight(obj["fontWeight"]), this.#parseDimension(obj["letterSpacing"]), this.#parseNumber(obj["lineHeight"]));
-	}
-	#isObject(value) {
-		return typeof value === "object" && value !== null && !Array.isArray(value);
-	}
-	#round(value) {
-		return Number(value.toFixed(3));
-	}
-};
-/**
-* Thrown when the YAML content does not conform to the HRDT token format.
-*/
-var HrdtTokenReaderError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "HrdtTokenReaderError";
-	}
-};
-var SimpleHrdtParser = class {
-	#lines;
-	#index = 0;
-	constructor(content) {
-		this.#lines = content.replace(/^/, "").split(/\r?\n/g).map((line) => line.replace(/\s+$/u, "")).filter((line) => line.trim().length > 0 && !line.trimStart().startsWith("#")).map((line) => ({
-			indent: line.length - line.trimStart().length,
-			text: line.trimStart()
-		}));
-	}
-	parse() {
-		const result = this.#parseBlock(0);
-		if (typeof result !== "object" || result === null || Array.isArray(result)) throw new HrdtTokenReaderError("YAML root must be an object.");
-		return result;
-	}
-	#parseBlock(indent) {
-		const line = this.#current();
-		if (!line || line.indent < indent) return {};
-		return line.text.startsWith("- ") ? this.#parseSequence(indent) : this.#parseMapping(indent);
-	}
-	#parseMapping(indent) {
-		const output = {};
-		while (this.#index < this.#lines.length) {
-			const line = this.#current();
-			if (line.indent < indent) break;
-			if (line.indent > indent) throw new HrdtTokenReaderError(`Unexpected indentation near "${line.text}".`);
-			if (line.text.startsWith("- ")) break;
-			const { key, value } = this.#parseKeyValue(line.text);
-			this.#index += 1;
-			output[key] = value === void 0 ? this.#parseBlock(this.#nextIndent(indent)) : this.#parseScalar(value);
-		}
-		return output;
-	}
-	#parseSequence(indent) {
-		const output = [];
-		while (this.#index < this.#lines.length) {
-			const line = this.#current();
-			if (line.indent < indent) break;
-			if (line.indent !== indent || !line.text.startsWith("- ")) break;
-			const itemText = line.text.slice(2).trim();
-			this.#index += 1;
-			if (itemText.includes(":")) {
-				const { key, value } = this.#parseKeyValue(itemText);
-				const item = {};
-				item[key] = value === void 0 ? this.#parseBlock(this.#nextIndent(indent)) : this.#parseScalar(value);
-				if (this.#current()?.indent === indent + 2 && !this.#current()?.text.startsWith("- ")) Object.assign(item, this.#parseMapping(indent + 2));
-				output.push(item);
-			} else output.push(this.#parseScalar(itemText));
-		}
-		return output;
-	}
-	#parseKeyValue(text) {
-		const delimiter = text.indexOf(":");
-		if (delimiter < 0) throw new HrdtTokenReaderError(`Expected key-value pair, got "${text}".`);
-		const rawKey = text.slice(0, delimiter).trim();
-		if (!rawKey) throw new HrdtTokenReaderError(`Expected non-empty key in "${text}".`);
-		const value = text.slice(delimiter + 1).trim();
-		const key = rawKey.startsWith("\"") && rawKey.endsWith("\"") || rawKey.startsWith("'") && rawKey.endsWith("'") ? this.#unquote(rawKey) : rawKey;
-		return value.length === 0 ? { key } : {
-			key,
-			value
-		};
-	}
-	#parseScalar(value) {
-		if (value.startsWith("[") && value.endsWith("]")) return this.#parseInlineArray(value);
-		if (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'")) return this.#unquote(value);
-		if (value === "true") return true;
-		if (value === "false") return false;
-		if (value === "null") return null;
-		if (/^-?\d+(?:\.\d+)?$/.test(value)) return Number(value);
-		return value;
-	}
-	#parseInlineArray(value) {
-		const inner = value.slice(1, -1).trim();
-		if (!inner) return [];
-		return this.#splitInlineArray(inner).map((item) => this.#parseScalar(item.trim()));
-	}
-	#splitInlineArray(value) {
-		const items = [];
-		let current = "";
-		let quote;
-		for (let i = 0; i < value.length; i++) {
-			const char = value[i];
-			if (quote) {
-				current += char;
-				if (char === quote && value[i - 1] !== "\\") quote = void 0;
-				continue;
-			}
-			if (char === "\"" || char === "'") {
-				quote = char;
-				current += char;
-				continue;
-			}
-			if (char === ",") {
-				items.push(current);
-				current = "";
-				continue;
-			}
-			current += char;
-		}
-		items.push(current);
-		return items;
-	}
-	#unquote(value) {
-		if (value.startsWith("\"")) return JSON.parse(value);
-		return value.slice(1, -1).replace(/''/g, "'");
-	}
-	#current() {
-		return this.#lines[this.#index];
-	}
-	#nextIndent(currentIndent) {
-		const nextLine = this.#current();
-		if (!nextLine || nextLine.indent <= currentIndent) return currentIndent + 2;
-		return nextLine.indent;
-	}
-};
-//#endregion
-//#region src/core/model/DtcgList.ts
-/**
-* An ordered collection of DTCG documents representing a base token set and its theme overrides.
-*
-* The base document defines all tokens. Each theme document overrides a subset of them.
-* When validating a theme, references are resolved against the theme first, then the base.
-*
-* @see https://tr.designtokens.org/format/#file-format
-*/
-var DtcgList = class {
-	base;
-	themes;
-	constructor(base, themes) {
-		this.base = base;
-		this.themes = themes ?? /* @__PURE__ */ new Map();
-	}
-	validate() {
-		const issues = this.base.validate();
-		for (const theme of this.themes.values()) issues.push(...theme.validate(this.base));
-		return issues;
-	}
-};
-//#endregion
-//#region src/core/io/DtcgJsonReader.ts
-var GROUP_KEYS = new Set([
-	"$type",
-	"$description",
-	"$extensions",
-	"$deprecated",
-	"$extends",
-	"$root",
-	"$schema"
-]);
-/**
-* Parses a DTCG 2025.10 JSON document into a {@link Dtcg}.
-*
-* A child object is treated as a token when it contains `$value` or `$ref`,
-* and as a group otherwise.
-*
-* @see https://tr.designtokens.org/format/
-*/
-var DtcgJsonReader = class {
-	parse(content) {
-		const raw = JSON.parse(content);
-		return new Dtcg(this.#parseGroup(raw, void 0));
-	}
-	#parseGroup(raw, inheritedType) {
-		const type = this.#resolveType(raw["$type"], inheritedType);
-		const description = typeof raw["$description"] === "string" ? raw["$description"] : void 0;
-		const deprecated = this.#parseDeprecated(raw["$deprecated"]);
-		const extensions = this.#parseExtensions(raw["$extensions"]);
-		const extendsRef = this.#parseExtendsRef(raw["$extends"]);
-		const root = raw["$root"] != null ? this.#parseToken(raw["$root"], type) : void 0;
-		const children = /* @__PURE__ */ new Map();
-		for (const [key, value] of Object.entries(raw)) {
-			if (GROUP_KEYS.has(key)) continue;
-			if (typeof value !== "object" || value === null || Array.isArray(value)) continue;
-			const child = value;
-			if (this.#isToken(child)) children.set(key, this.#parseToken(child, type));
-			else children.set(key, this.#parseGroup(child, type));
-		}
-		return new TokenGroup({
-			type,
-			description,
-			deprecated,
-			extensions,
-			extends: extendsRef,
-			root,
-			children
-		});
-	}
-	#isToken(raw) {
-		return "$value" in raw || "$ref" in raw;
-	}
-	#parseToken(raw, inheritedType) {
-		const type = this.#resolveType(raw["$type"], inheritedType);
-		const description = typeof raw["$description"] === "string" ? raw["$description"] : void 0;
-		const deprecated = this.#parseDeprecated(raw["$deprecated"]);
-		const extensions = this.#parseExtensions(raw["$extensions"]);
-		if ("$ref" in raw) {
-			const ref = raw["$ref"];
-			if (typeof ref !== "string") throw new DtcgJsonReaderError("$ref must be a string");
-			return this.#makeToken(type, new TokenReference(ref), description, deprecated, extensions);
-		}
-		const rawValue = raw["$value"];
-		if (typeof rawValue === "string" && /^\{[^{}]+\}$/.test(rawValue)) {
-			const ref = new TokenReference(rawValue.slice(1, -1));
-			return this.#makeToken(type, ref, description, deprecated, extensions);
-		}
-		if (type == null) throw new DtcgJsonReaderError(`Token has no $type and no inherited type: ${JSON.stringify(raw)}`);
-		const value = this.#parseValue(type, rawValue);
-		return this.#makeToken(type, value, description, deprecated, extensions);
+	#parseToken(raw, inheritedType) {
+		const type = this.#resolveType(raw["$type"], inheritedType);
+		const description = typeof raw["$description"] === "string" ? raw["$description"] : void 0;
+		const deprecated = this.#parseDeprecated(raw["$deprecated"]);
+		const extensions = this.#parseExtensions(raw["$extensions"]);
+		if ("$ref" in raw) {
+			const ref = raw["$ref"];
+			if (typeof ref !== "string") throw new DtcgJsonReaderError("$ref must be a string");
+			return this.#makeToken(type, new TokenReference(ref), description, deprecated, extensions);
+		}
+		const rawValue = raw["$value"];
+		if (typeof rawValue === "string" && /^\{[^{}]+\}$/.test(rawValue)) {
+			const ref = new TokenReference(rawValue.slice(1, -1));
+			return this.#makeToken(type, ref, description, deprecated, extensions);
+		}
+		if (type == null) throw new DtcgJsonReaderError(`Token has no $type and no inherited type: ${JSON.stringify(raw)}`);
+		const value = this.#parseValue(type, rawValue);
+		return this.#makeToken(type, value, description, deprecated, extensions);
 	}
 	#makeToken(type, value, description, deprecated, extensions) {
 		switch (type) {
@@ -1233,92 +1123,445 @@ var DtcgJsonReader = class {
 	#parseExtensions(raw) {
 		if (typeof raw === "object" && raw !== null && !Array.isArray(raw)) return raw;
 	}
-	#parseExtendsRef(raw) {
-		if (typeof raw !== "string") return void 0;
-		if (/^\{[^{}]+\}$/.test(raw)) return new TokenReference(raw.slice(1, -1));
-		return raw;
+	#parseExtendsRef(raw) {
+		if (typeof raw !== "string") return void 0;
+		if (/^\{[^{}]+\}$/.test(raw)) return new TokenReference(raw.slice(1, -1));
+		return raw;
+	}
+};
+/**
+* Thrown when the input JSON does not conform to the expected DTCG structure.
+*/
+var DtcgJsonReaderError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "DtcgJsonReaderError";
+	}
+};
+//#endregion
+//#region src/core/io/HrdtTokenReader.ts
+var DIMENSION_RE = /^(-?\d+(?:\.\d+)?)(px|rem)$/;
+var DURATION_RE = /^(-?\d+(?:\.\d+)?)(ms|s)$/;
+var HEX_RE = /^#([0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+var REFERENCE_RE = /^\{[^{}]+\}$/;
+var TOKEN_TYPES = new Set([
+	"color",
+	"dimension",
+	"fontFamily",
+	"fontWeight",
+	"duration",
+	"cubicBezier",
+	"number",
+	"strokeStyle",
+	"border",
+	"transition",
+	"shadow",
+	"gradient",
+	"typography"
+]);
+/**
+* Reads an HRDT token file and parses it directly into a {@link Dtcg} model.
+*
+* The HRDT format uses YAML syntax and group path to infer token types
+* (e.g. `primitive.color.*` -> color tokens). Non-primitive groups
+* contain alias references to primitive tokens.
+*/
+var HrdtTokenReader = class {
+	parseRaw(hrdtContent) {
+		return parse(hrdtContent);
+	}
+	parse(hrdtContent, source) {
+		const raw = parse(hrdtContent);
+		if (typeof raw !== "object" || raw === null || Array.isArray(raw)) throw new HrdtTokenReaderError("YAML root must be an object.");
+		return new Dtcg(this.#parseRoot(raw), source);
+	}
+	/**
+	* Parses a YAML string that may contain multiple documents separated by
+	* {@code ---} and returns a {@link Dtcg} for each document.
+	*
+	* If the content contains a single document the result is a single-element
+	* array.
+	*/
+	parseAll(hrdtContent, source) {
+		const documents = parseAllDocuments(hrdtContent);
+		if ("length" in documents === false) throw new HrdtTokenReaderError("Failed to parse YAML document.");
+		return documents.map((doc) => {
+			const raw = doc.toJS();
+			if (typeof raw !== "object" || raw === null || Array.isArray(raw)) throw new HrdtTokenReaderError("YAML document root must be an object.");
+			return new Dtcg(this.#parseRoot(raw), source);
+		});
+	}
+	async parseFile(filePath) {
+		return this.parse(await readFile(filePath, "utf8"));
+	}
+	#parseRoot(raw) {
+		const children = /* @__PURE__ */ new Map();
+		for (const [key, value] of Object.entries(raw)) {
+			if (key === "$schema") continue;
+			if (!this.#isObject(value)) continue;
+			if (key === "primitive") children.set(key, this.#parsePrimitiveRoot(value));
+			else children.set(key, this.#parseReferenceGroup(value));
+		}
+		return new TokenGroup({ children });
+	}
+	#parsePrimitiveRoot(raw) {
+		const children = /* @__PURE__ */ new Map();
+		for (const [typeName, tokens] of Object.entries(raw)) {
+			if (!TOKEN_TYPES.has(typeName)) throw new HrdtTokenReaderError(`Unknown primitive token type: "${typeName}"`);
+			const tokenType = typeName;
+			children.set(typeName, this.#parsePrimitiveTypeGroup(tokens, tokenType));
+		}
+		return new TokenGroup({ children });
+	}
+	#parsePrimitiveTypeGroup(raw, tokenType) {
+		const children = /* @__PURE__ */ new Map();
+		for (const [name, value] of Object.entries(raw)) children.set(name, this.#parsePrimitiveToken(value, tokenType));
+		return new TokenGroup({
+			type: tokenType,
+			children
+		});
+	}
+	#parsePrimitiveToken(value, tokenType) {
+		if (typeof value === "string" && REFERENCE_RE.test(value)) return new AliasToken(new TokenReference(value.slice(1, -1)));
+		switch (tokenType) {
+			case "color": return new ColorToken(this.#parseColor(value));
+			case "dimension": return new DimensionToken(this.#parseDimension(value));
+			case "fontFamily": return new FontFamilyToken(this.#parseFontFamily(value));
+			case "fontWeight": return new FontWeightToken(this.#parseFontWeight(value));
+			case "number": return new NumberToken(this.#parseNumber(value));
+			case "duration": return new DurationToken(this.#parseDuration(value));
+			case "cubicBezier": return new CubicBezierToken(this.#parseCubicBezier(value));
+			case "strokeStyle": return new StrokeStyleToken(this.#parseStrokeStyle(value));
+			case "border": return new BorderToken(this.#parseBorder(value));
+			case "transition": return new TransitionToken(this.#parseTransition(value));
+			case "shadow": return new ShadowToken(this.#parseShadow(value));
+			case "gradient": return new GradientToken(this.#parseGradient(value));
+			case "typography": return new TypographyToken(this.#parseTypography(value));
+		}
+	}
+	#parseReferenceGroup(raw) {
+		const children = /* @__PURE__ */ new Map();
+		for (const [key, value] of Object.entries(raw)) if (this.#isLeaf(value)) children.set(key, this.#parseReferenceToken(value));
+		else children.set(key, this.#parseReferenceGroup(value));
+		return new TokenGroup({ children });
+	}
+	#isLeaf(value) {
+		return !this.#isObject(value) || Array.isArray(value);
+	}
+	#parseReferenceToken(value) {
+		if (typeof value === "string" && REFERENCE_RE.test(value)) return new AliasToken(new TokenReference(value.slice(1, -1)));
+		throw new HrdtTokenReaderError(`Expected a reference in non-primitive group, got: ${JSON.stringify(value)}`);
+	}
+	#parseColor(value) {
+		if (typeof value !== "string" || !HEX_RE.test(value)) throw new HrdtTokenReaderError(`Expected hex color, got: ${JSON.stringify(value)}`);
+		const normalized = value.toLowerCase();
+		const hex = normalized.slice(0, 7);
+		const r = parseInt(normalized.slice(1, 3), 16);
+		const g = parseInt(normalized.slice(3, 5), 16);
+		const b = parseInt(normalized.slice(5, 7), 16);
+		const alpha = normalized.length === 9 ? this.#round(parseInt(normalized.slice(7, 9), 16) / 255) : 1;
+		return new ColorValue("srgb", [
+			this.#round(r / 255),
+			this.#round(g / 255),
+			this.#round(b / 255)
+		], alpha, hex);
+	}
+	#parseDimension(value) {
+		if (typeof value !== "string") throw new HrdtTokenReaderError(`Expected dimension string, got: ${JSON.stringify(value)}`);
+		const match = value.match(DIMENSION_RE);
+		if (!match) throw new HrdtTokenReaderError(`Expected dimension with px/rem unit, got: "${value}"`);
+		return new DimensionValue(Number(match[1]), match[2]);
+	}
+	#parseFontFamily(value) {
+		if (typeof value === "string") return value;
+		if (Array.isArray(value) && value.every((v) => typeof v === "string")) return value;
+		throw new HrdtTokenReaderError(`Expected fontFamily string or array, got: ${JSON.stringify(value)}`);
+	}
+	#parseFontWeight(value) {
+		if (typeof value === "string" || typeof value === "number") return value;
+		throw new HrdtTokenReaderError(`Expected fontWeight string or number, got: ${JSON.stringify(value)}`);
+	}
+	#parseNumber(value) {
+		if (typeof value !== "number") throw new HrdtTokenReaderError(`Expected number, got: ${JSON.stringify(value)}`);
+		return value;
+	}
+	#parseDuration(value) {
+		if (typeof value !== "string") throw new HrdtTokenReaderError(`Expected duration string, got: ${JSON.stringify(value)}`);
+		const match = value.match(DURATION_RE);
+		if (!match) throw new HrdtTokenReaderError(`Expected duration with ms/s unit, got: "${value}"`);
+		return new DurationValue(Number(match[1]), match[2]);
+	}
+	#parseCubicBezier(value) {
+		if (!Array.isArray(value) || value.length !== 4 || !value.every((v) => typeof v === "number")) throw new HrdtTokenReaderError(`Expected cubicBezier [n, n, n, n], got: ${JSON.stringify(value)}`);
+		return new CubicBezierValue(value[0], value[1], value[2], value[3]);
+	}
+	#parseStrokeStyle(value) {
+		if (typeof value === "string") return value;
+		if (this.#isObject(value)) {
+			const obj = value;
+			return new StrokeStyleObject(obj["dashArray"].map((d) => this.#parseDimension(d)), obj["lineCap"]);
+		}
+		throw new HrdtTokenReaderError(`Expected strokeStyle, got: ${JSON.stringify(value)}`);
+	}
+	#parseBorder(value) {
+		if (!this.#isObject(value)) throw new HrdtTokenReaderError(`Expected border object, got: ${JSON.stringify(value)}`);
+		const obj = value;
+		return new BorderValue(this.#parseColor(obj["color"]), this.#parseDimension(obj["width"]), this.#parseStrokeStyle(obj["style"]));
+	}
+	#parseTransition(value) {
+		if (!this.#isObject(value)) throw new HrdtTokenReaderError(`Expected transition object, got: ${JSON.stringify(value)}`);
+		const obj = value;
+		return new TransitionValue(this.#parseDuration(obj["duration"]), this.#parseDuration(obj["delay"]), this.#parseCubicBezier(obj["timingFunction"]));
+	}
+	#parseShadow(value) {
+		if (Array.isArray(value)) return value.map((item) => this.#parseShadowLayer(item));
+		return this.#parseShadowLayer(value);
+	}
+	#parseShadowLayer(value) {
+		if (!this.#isObject(value)) throw new HrdtTokenReaderError(`Expected shadow layer object, got: ${JSON.stringify(value)}`);
+		const obj = value;
+		return new ShadowLayer(this.#parseColor(obj["color"]), this.#parseDimension(obj["offsetX"]), this.#parseDimension(obj["offsetY"]), this.#parseDimension(obj["blur"]), this.#parseDimension(obj["spread"]));
+	}
+	#parseGradient(value) {
+		if (!Array.isArray(value)) throw new HrdtTokenReaderError(`Expected gradient stops array, got: ${JSON.stringify(value)}`);
+		return value.map((item) => {
+			if (!this.#isObject(item)) throw new HrdtTokenReaderError(`Expected gradient stop object, got: ${JSON.stringify(item)}`);
+			const obj = item;
+			return new GradientStop(this.#parseColor(obj["color"]), this.#parseNumber(obj["position"]));
+		});
+	}
+	#parseTypography(value) {
+		if (!this.#isObject(value)) throw new HrdtTokenReaderError(`Expected typography object, got: ${JSON.stringify(value)}`);
+		const obj = value;
+		return new TypographyValue(this.#parseFontFamily(obj["fontFamily"]), this.#parseDimension(obj["fontSize"]), this.#parseFontWeight(obj["fontWeight"]), this.#parseDimension(obj["letterSpacing"]), this.#parseNumber(obj["lineHeight"]));
+	}
+	#isObject(value) {
+		return typeof value === "object" && value !== null && !Array.isArray(value);
+	}
+	#round(value) {
+		return Number(value.toFixed(3));
+	}
+};
+/**
+* Thrown when the YAML content does not conform to the HRDT token format.
+*/
+var HrdtTokenReaderError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "HrdtTokenReaderError";
+	}
+};
+//#endregion
+//#region src/core/validation/dtcg/DtcgSchemaValidator.ts
+var FORMAT_SCHEMA_ID = "https://www.designtokens.org/schemas/2025.10/format.json";
+/**
+* Validates DTCG JSON sources against the official DTCG JSON Schema.
+* Accepts DTCG JSON sources only.
+*/
+var DtcgSchemaValidator = class {
+	name = "dtcg";
+	async validate(sources) {
+		const validator = (await this.#createAjv()).getSchema(FORMAT_SCHEMA_ID);
+		if (!validator) throw new Error(`AJV schema "${FORMAT_SCHEMA_ID}" was not loaded.`);
+		const issues = [];
+		for (const source of sources) {
+			const content = await new Source(source).getContent();
+			if (validator(JSON.parse(content))) continue;
+			const errors = validator.errors ?? [];
+			for (const error of errors) issues.push(this.#toValidationIssue(source, error));
+		}
+		return issues;
+	}
+	async #createAjv() {
+		const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+		const schemaDir = path.resolve(moduleDir, "schemas/2025.10");
+		const ajv = new Ajv({
+			allErrors: true,
+			strict: false
+		});
+		addFormats(ajv);
+		for (const schemaFilePath of await listJsonFiles(schemaDir)) {
+			const rawSchema = await readFile(schemaFilePath, "utf8");
+			const schema = JSON.parse(rawSchema);
+			ajv.addSchema(schema, schema.$id ?? schemaFilePath);
+		}
+		return ajv;
+	}
+	#toValidationIssue(sourcePath, error) {
+		const instancePath = error.instancePath || "/";
+		const message = error.message ?? "Validation error.";
+		return {
+			name: this.name,
+			sourcePath,
+			severity: "error",
+			message: `${instancePath}: ${message}`,
+			raw: error
+		};
+	}
+};
+async function listJsonFiles(directoryPath) {
+	const entries = await readdir(directoryPath, { withFileTypes: true });
+	const files = [];
+	for (const entry of entries) {
+		const entryPath = path.join(directoryPath, entry.name);
+		if (entry.isDirectory()) files.push(...await listJsonFiles(entryPath));
+		else if (entry.isFile() && entry.name.toLowerCase().endsWith(".json")) files.push(entryPath);
+	}
+	return files;
+}
+//#endregion
+//#region src/core/validation/hrdt/HrdtTokenValidator.ts
+var SCHEMA_ID = "https://designtokens.local/schemas/hrdt-tokens.json";
+/**
+* Validator based on AJV and JSON Schema.
+* Accepts HRDT sources only.
+*/
+var HrdtTokenValidator = class {
+	name = "hrdt";
+	async validate(sources) {
+		const validator = (await this.#createAjv()).getSchema(SCHEMA_ID);
+		if (!validator) throw new Error(`AJV schema "${SCHEMA_ID}" was not loaded.`);
+		const issues = [];
+		for (const source of sources) {
+			const content = await new Source(source).getContent();
+			if (validator(new HrdtTokenReader().parseRaw(content))) continue;
+			const errors = validator.errors ?? [];
+			for (const error of errors) issues.push(this.#toValidationIssue(source, error));
+		}
+		return issues;
+	}
+	async #createAjv() {
+		const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+		const schemaPath = path.resolve(moduleDir, "schemas/hrdt-tokens.json");
+		const ajv = new Ajv({
+			allErrors: true,
+			strict: false
+		});
+		addFormats(ajv);
+		const rawSchema = await readFile(schemaPath, "utf8");
+		const schema = JSON.parse(rawSchema);
+		ajv.addSchema(schema, schema.$id ?? schemaPath);
+		return ajv;
 	}
-};
-/**
-* Thrown when the input JSON does not conform to the expected DTCG structure.
-*/
-var DtcgJsonReaderError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "DtcgJsonReaderError";
+	#toValidationIssue(sourcePath, error) {
+		const instancePath = error.instancePath || "/";
+		const message = error.message ?? "Validation error.";
+		return {
+			name: this.name,
+			sourcePath,
+			severity: "error",
+			message: `${instancePath}: ${message}`,
+			raw: error
+		};
 	}
 };
 //#endregion
-//#region src/core/Source.ts
-var SourceType = /* @__PURE__ */ function(SourceType) {
-	SourceType["URL"] = "url";
-	SourceType["FILE"] = "file";
-	SourceType["CONTENT"] = "content";
-	return SourceType;
-}(SourceType || {});
+//#region src/core/io/DtcgListLoader.ts
 /**
-* Data source.
-* Wraps URL, File or content.
+* Loads and validates token sources, assembling a {@link DtcgList}.
 *
-* Allows returning any of these data sources as a file.
-* Used in tool implementations to simplify the interface.
+* The first document is the base token set, subsequent documents are theme
+* overrides.
+*
+* Sources in different formats may be mixed.
 */
-var Source = class Source {
-	#type;
-	#input;
-	#filePath;
-	constructor(input) {
-		this.#input = input;
-		if (Source.#isHttpUrl(input)) this.#type = SourceType.URL;
-		else if (existsSync(input)) this.#type = SourceType.FILE;
-		else this.#type = SourceType.CONTENT;
-	}
-	static #isHttpUrl(value) {
-		try {
-			const url = new URL(value);
-			return url.protocol === "http:" || url.protocol === "https:";
-		} catch {
-			return false;
+var DtcgListLoader = class {
+	#validators = new Map([[Format.HRDT, new HrdtTokenValidator()], [Format.DTCG, new DtcgSchemaValidator()]]);
+	#parsers = new Map([[Format.HRDT, async (source) => new HrdtTokenReader().parseAll(await source.getContent(), source.getInput())], [Format.DTCG, async (source) => [new DtcgJsonReader().parse(await source.getContent(), source.getInput())]]]);
+	/**
+	* Validates and loads all sources into a {@link DtcgList}.
+	*
+	* @param sources - Paths to token files or {@code "-"} for stdin.
+	* @param forcedFormat - When set, all sources are treated as this
+	*   format instead of auto-detecting from content.
+	* @throws TokenSyntaxError when schema validation fails.
+	*/
+	async load(sources, forcedFormat) {
+		const sourceList = sources.map((s) => new Source(s));
+		const issues = await this.#validate(sourceList, forcedFormat);
+		if (issues.length > 0) throw new TokenSyntaxError(issues);
+		const allDocs = await this.#parse(sourceList, forcedFormat);
+		return this.#buildDtcgList(allDocs);
+	}
+	async #validate(sourceList, forcedFormat) {
+		const issues = [];
+		for (const source of sourceList) {
+			const format = forcedFormat ?? await source.getFormat();
+			const validator = this.#validators.get(format);
+			issues.push(...await validator.validate([source.getInput()]));
 		}
+		return issues;
 	}
-	getInput() {
-		return this.#input;
-	}
-	getType() {
-		return this.#type;
+	async #parse(sourceList, forcedFormat) {
+		const allDocs = new Array();
+		for (const source of sourceList) {
+			const format = forcedFormat ?? await source.getFormat();
+			const parser = this.#parsers.get(format);
+			for (const doc of await parser(source)) allDocs.push({
+				source: source.getInput(),
+				doc
+			});
+		}
+		return allDocs;
 	}
-	async getContent() {
-		if (this.#type === SourceType.FILE) return readFile(this.#input, "utf8");
-		else if (this.#type === SourceType.URL) {
-			const response = await fetch(this.#input);
-			if (!response.ok) throw new Error(`Unable to fetch "${this.#input}": HTTP ${response.status}`);
-			return response.text();
-		} else if (this.#type === SourceType.CONTENT) return this.#input;
-		else throw new Error(`Unsupported source type "${this.#type}: ${this.#input}"`);
+	#buildDtcgList(allDocs) {
+		const [baseEntry, ...themeEntries] = allDocs;
+		const themes = new Map(themeEntries.map((entry, i) => [extractThemeName(entry.source, i), entry.doc]));
+		return new DtcgList(baseEntry.doc, themes);
 	}
-	async getFile() {
-		if (this.#filePath !== void 0) return this.#filePath;
-		if (this.#type === SourceType.FILE) this.#filePath = this.#input;
-		else if (this.#type === SourceType.URL) {
-			const response = await fetch(this.#input);
-			if (!response.ok) throw new Error(`Unable to fetch "${this.#input}": HTTP ${response.status}`);
-			this.#filePath = await Source.#writeTemp(await response.text());
-		} else this.#filePath = await Source.#writeTemp(this.#input);
-		return this.#filePath;
+};
+/**
+* Thrown by {@link DtcgListLoader.load} when schema validation fails.
+*
+* The {@link issues} field contains individual validation diagnostics.
+*/
+var TokenSyntaxError = class extends Error {
+	issues;
+	constructor(issues) {
+		super("Schema validation failed");
+		this.name = "TokenSyntaxError";
+		this.issues = issues;
 	}
-	static async #writeTemp(content) {
-		const filePath = path.join(tmpdir(), `designtokens-${randomUUID()}.tmp`);
-		await writeFile(filePath, content, "utf8");
-		return filePath;
+	formatIssues() {
+		return this.issues.map((i) => `[${i.name}] ${i.sourcePath} - ${i.message}`).join("\n");
 	}
 };
-//#endregion
-//#region src/core/css/DtcgTokenCssConverter.ts
-function extractThemeName$1(filePath) {
-	const withoutExt = (filePath.split("/").at(-1)?.split("\\").at(-1) ?? filePath).replace(/\.json$/i, "");
+function extractThemeName(source, index) {
+	if (source === "-") return index !== void 0 ? `stdin-${index + 1}` : "stdin";
+	const withoutExt = (source.split("/").at(-1)?.split("\\").at(-1) ?? source).replace(/\.(json|ya?ml)$/i, "");
 	const dotIndex = withoutExt.lastIndexOf(".");
 	return dotIndex > 0 ? withoutExt.slice(dotIndex + 1) : withoutExt;
 }
+//#endregion
+//#region src/core/css/DtcgTokenCssConverter.ts
+/**
+* Converts token documents in any supported format to CSS custom properties.
+*
+* The first document is treated as the base token set, all subsequent
+* documents as theme overrides.
+* Base tokens are emitted under {@code :root}.
+* Theme tokens are emitted under {@code :root[data-theme="name"]}.
+*/
+var DtcgTokenCssConverter = class {
+	#loader = new DtcgListLoader();
+	async convert(sources) {
+		const list = await this.#loader.load(sources);
+		return this.convertList(list);
+	}
+	convertDocument(doc) {
+		return this.convertList(new DtcgList(doc, /* @__PURE__ */ new Map()));
+	}
+	convertList(list) {
+		const blocks = [];
+		const baseBlock = renderBlock(":root", collectFromDoc(list.base));
+		if (baseBlock) blocks.push(baseBlock);
+		for (const [themeName, theme] of list.themes) {
+			const block = renderBlock(`:root[data-theme="${themeName}"]`, collectFromDoc(theme));
+			if (block) blocks.push(block);
+		}
+		return blocks.join("\n\n");
+	}
+};
 function tokenPathToCssVar(path) {
 	return `--${path.replace(/\./g, "-")}`;
 }
@@ -1394,33 +1637,6 @@ function renderBlock(selector, declarations) {
 	if (declarations.length === 0) return "";
 	return `${selector} {\n${declarations.map(([prop, val]) => `  ${prop}: ${val};`).join("\n")}\n}`;
 }
-async function readDoc$1(source) {
-	const content = await new Source(source).getContent();
-	return /\.(ya?ml)$/i.test(source) ? new HrdtTokenReader().parse(content) : new DtcgJsonReader().parse(content);
-}
-async function loadDtcgList(sources) {
-	const [base, ...rest] = await Promise.all(sources.map(readDoc$1));
-	return new DtcgList(base, new Map(rest.map((doc, i) => [extractThemeName$1(sources[i + 1]), doc])));
-}
-var DtcgTokenCssConverter = class {
-	async convert(sources) {
-		const list = await loadDtcgList(sources);
-		return this.convertList(list);
-	}
-	convertDocument(doc) {
-		return this.convertList(new DtcgList(doc, /* @__PURE__ */ new Map()));
-	}
-	convertList(list) {
-		const blocks = [];
-		const baseBlock = renderBlock(":root", collectFromDoc(list.base));
-		if (baseBlock) blocks.push(baseBlock);
-		for (const [themeName, theme] of list.themes) {
-			const block = renderBlock(`:root[data-theme="${themeName}"]`, collectFromDoc(theme));
-			if (block) blocks.push(block);
-		}
-		return blocks.join("\n\n");
-	}
-};
 //#endregion
 //#region src/core/showcase/CssTokenParser.ts
 /**
@@ -4101,8 +4317,8 @@ var TokenHtmlShowcaseBuilder = class {
 	async showcase(sources) {
 		if (sources.length === 0) throw new Error("No token sources provided");
 		if (sources.length === 1) {
-			const sourceContent = await readFile(sources[0], "utf8");
-			if (this.#isCssContent(sourceContent)) return this.#renderCss(sourceContent);
+			const source = new Source(sources[0]);
+			if (await source.getFormat() === Format.CSS) return this.#renderCss(await source.getContent());
 		}
 		return this.#showcaseFromSources(sources);
 	}
@@ -4121,147 +4337,28 @@ var TokenHtmlShowcaseBuilder = class {
 	#formatValidationIssues(issues) {
 		return issues.filter((issue) => issue.severity === "error").map((issue) => `[${issue.name}] ${issue.sourcePath} - ${issue.message}`).join("\n");
 	}
-	#isCssContent(content) {
-		return /(^|\s)--[a-zA-Z0-9_-]+\s*:/.test(content) || /(^|\s):root\b/.test(content) || /(^|\s)@layer\b/.test(content);
-	}
-};
-//#endregion
-//#region src/core/validation/dtcg/DtcgSchemaValidator.ts
-var FORMAT_SCHEMA_ID = "https://www.designtokens.org/schemas/2025.10/format.json";
-/**
-* Validates DTCG JSON sources against the official DTCG JSON Schema.
-* Accepts DTCG JSON sources only.
-*/
-var DtcgSchemaValidator = class {
-	name = "dtcg";
-	async validate(sources) {
-		const validator = (await this.#createAjv()).getSchema(FORMAT_SCHEMA_ID);
-		if (!validator) throw new Error(`AJV schema "${FORMAT_SCHEMA_ID}" was not loaded.`);
-		const issues = [];
-		for (const source of sources) {
-			const content = await new Source(source).getContent();
-			if (validator(JSON.parse(content))) continue;
-			const errors = validator.errors ?? [];
-			for (const error of errors) issues.push(this.#toValidationIssue(source, error));
-		}
-		return issues;
-	}
-	async #createAjv() {
-		const moduleDir = path.dirname(fileURLToPath(import.meta.url));
-		const schemaDir = path.resolve(moduleDir, "schemas/2025.10");
-		const ajv = new Ajv({
-			allErrors: true,
-			strict: false
-		});
-		addFormats(ajv);
-		for (const schemaFilePath of await listJsonFiles(schemaDir)) {
-			const rawSchema = await readFile(schemaFilePath, "utf8");
-			const schema = JSON.parse(rawSchema);
-			ajv.addSchema(schema, schema.$id ?? schemaFilePath);
-		}
-		return ajv;
-	}
-	#toValidationIssue(sourcePath, error) {
-		const instancePath = error.instancePath || "/";
-		const message = error.message ?? "Validation error.";
-		return {
-			name: this.name,
-			sourcePath,
-			severity: "error",
-			message: `${instancePath}: ${message}`,
-			raw: error
-		};
-	}
-};
-async function listJsonFiles(directoryPath) {
-	const entries = await readdir(directoryPath, { withFileTypes: true });
-	const files = [];
-	for (const entry of entries) {
-		const entryPath = path.join(directoryPath, entry.name);
-		if (entry.isDirectory()) files.push(...await listJsonFiles(entryPath));
-		else if (entry.isFile() && entry.name.toLowerCase().endsWith(".json")) files.push(entryPath);
-	}
-	return files;
-}
-//#endregion
-//#region src/core/validation/hrdt/HrdtTokenValidator.ts
-var SCHEMA_ID = "https://designtokens.local/schemas/hrdt-tokens.json";
-/**
-* Validator based on AJV and JSON Schema.
-* Accepts HRDT sources only.
-*/
-var HrdtTokenValidator = class {
-	name = "hrdt";
-	async validate(sources) {
-		const validator = (await this.#createAjv()).getSchema(SCHEMA_ID);
-		if (!validator) throw new Error(`AJV schema "${SCHEMA_ID}" was not loaded.`);
-		const issues = [];
-		for (const source of sources) {
-			const content = await new Source(source).getContent();
-			if (validator(new HrdtTokenReader().parseRaw(content))) continue;
-			const errors = validator.errors ?? [];
-			for (const error of errors) issues.push(this.#toValidationIssue(source, error));
-		}
-		return issues;
-	}
-	async #createAjv() {
-		const moduleDir = path.dirname(fileURLToPath(import.meta.url));
-		const schemaPath = path.resolve(moduleDir, "schemas/hrdt-tokens.json");
-		const ajv = new Ajv({
-			allErrors: true,
-			strict: false
-		});
-		addFormats(ajv);
-		const rawSchema = await readFile(schemaPath, "utf8");
-		const schema = JSON.parse(rawSchema);
-		ajv.addSchema(schema, schema.$id ?? schemaPath);
-		return ajv;
-	}
-	#toValidationIssue(sourcePath, error) {
-		const instancePath = error.instancePath || "/";
-		const message = error.message ?? "Validation error.";
-		return {
-			name: this.name,
-			sourcePath,
-			severity: "error",
-			message: `${instancePath}: ${message}`,
-			raw: error
-		};
-	}
 };
 //#endregion
 //#region src/core/validation/DtcgTokenValidator.ts
-function extractThemeName(source) {
-	const withoutExt = (source.split("/").at(-1)?.split("\\").at(-1) ?? source).replace(/\.(json|ya?ml)$/i, "");
-	const dotIndex = withoutExt.lastIndexOf(".");
-	return dotIndex > 0 ? withoutExt.slice(dotIndex + 1) : withoutExt;
-}
-async function readDoc(source) {
-	const content = await new Source(source).getContent();
-	return /\.(ya?ml)$/i.test(source) ? new HrdtTokenReader().parse(content) : new DtcgJsonReader().parse(content);
-}
 /**
 * Validates DTCG JSON or HRDT token files using the internal model.
 *
 * Accepts one base file plus optional theme files. Validates references,
 * cycles, type mismatches, and deprecated token usage.
+*
+* Format is detected from content, not from file extension.
+* HRDT sources may contain multiple YAML documents separated by {@code ---}.
+* The first document is the base, subsequent documents are themes.
 */
 var DtcgTokenValidator = class {
-	#name = "internal";
+	#loader = new DtcgListLoader();
 	async validate(sources) {
-		const hrdtSources = sources.filter((s) => /\.(ya?ml)$/i.test(s));
-		const hrdtIssues = hrdtSources.length > 0 ? await new HrdtTokenValidator().validate(hrdtSources) : [];
-		if (hrdtIssues.some((i) => i.severity === "error")) return hrdtIssues;
-		const jsonSources = sources.filter((s) => !/\.(ya?ml)$/i.test(s));
-		const schemaIssues = jsonSources.length > 0 ? await new DtcgSchemaValidator().validate(jsonSources) : [];
-		if (schemaIssues.some((i) => i.severity === "error")) return schemaIssues;
-		const [base, ...rest] = await Promise.all(sources.map(readDoc));
-		return new DtcgList(base, new Map(rest.map((doc, i) => [extractThemeName(sources[i + 1]), doc]))).validate().map((issue) => ({
-			name: this.#name,
-			sourcePath: sources.join(", "),
-			message: `${issue.tokenPath}: ${issue.message}`,
-			severity: issue.severity
-		}));
+		try {
+			return (await this.#loader.load(sources)).validate();
+		} catch (error) {
+			if (error instanceof TokenSyntaxError) return error.issues;
+			throw error;
+		}
 	}
 };
 //#endregion
@@ -4616,6 +4713,9 @@ var HrdtTokenWriter = class {
 		return String(value);
 	}
 	#serializeColor(color) {
+		return `"${this.#colorToHex(color)}"`;
+	}
+	#colorToHex(color) {
 		if (color.hex) {
 			if (color.alpha === 1) return color.hex;
 			const alphaHex = Math.round(color.alpha * 255).toString(16).padStart(2, "0");
@@ -4704,7 +4804,7 @@ var HrdtTokenWriter = class {
 		return lines;
 	}
 	#serializeColorOrRef(value) {
-		return value instanceof TokenReference ? value.toString() : this.#serializeColor(value);
+		return value instanceof TokenReference ? value.toString() : this.#colorToHex(value);
 	}
 	#serializeDimensionOrRef(value) {
 		return value instanceof TokenReference ? `"${value}"` : this.#serializeDimension(value);
@@ -4734,4 +4834,4 @@ function createTokenHtmlShowcase() {
 	return new TokenHtmlShowcaseBuilder(new DtcgTokenValidator(), new DtcgTokenCssConverter());
 }
 //#endregion
-export { DesignToken, DesignTokens, Dtcg, DtcgJsonReader, DtcgJsonReaderError, DtcgJsonWriter, DtcgList, DtcgSchemaValidator, DtcgTokenCssConverter, DtcgTokenValidator, HrdtTokenReader, HrdtTokenReaderError, HrdtTokenValidator, HrdtTokenWriter, Source, TokenGroup, TokenHtmlShowcaseBuilder, TokenNode, TokenReference, createTokenCssConverter, createTokenHtmlShowcase };
+export { DesignToken, DesignTokens, Dtcg, DtcgJsonReader, DtcgJsonReaderError, DtcgJsonWriter, DtcgList, DtcgListLoader, DtcgSchemaValidator, DtcgTokenCssConverter, DtcgTokenValidator, Format, FormatDetector, HrdtTokenReader, HrdtTokenReaderError, HrdtTokenValidator, HrdtTokenWriter, Source, TokenGroup, TokenHtmlShowcaseBuilder, TokenNode, TokenReference, TokenSyntaxError, createTokenCssConverter, createTokenHtmlShowcase };