@pantoken/utils 1.2.0 → 1.3.0

package/dist/example-targets.d.mts

@@ -0,0 +1,12 @@
+//#region src/example-targets.d.ts
+/** Consumer supported by a cssdoc example's audience flag. */
+export type ExampleAudience = "automatica11y" | "canvas-rce" | "docs";
+/** Example indexes selected for each cssdoc consumer. */
+export interface ExampleTargetSelection {
+  automatica11y: number[];
+  canvasRce: number[];
+  docs: number[];
+}
+/** Resolve example indexes for each consumer while preserving the pre-flag defaults. */
+export declare function resolveExampleTargets(examples: readonly string[]): ExampleTargetSelection;
+//#endregion

package/dist/example-targets.mjs

@@ -0,0 +1,43 @@
+//#region src/example-targets.ts
+const AUDIENCE_FLAGS = /* @__PURE__ */ new Map([
+	["-automatica11y", "automatica11y"],
+	["-canvas-rce", "canvas-rce"],
+	["-docs", "docs"]
+]);
+function audienceFlags(example) {
+	const fenceStart = example.indexOf("```");
+	const metadata = fenceStart < 0 ? example : example.slice(0, fenceStart);
+	const fenceInfo = fenceStart < 0 ? "" : example.slice(fenceStart + 3).split(/\r?\n/u, 1)[0] ?? "";
+	const metadataTokens = metadata.trim().split(/\s+/u).filter(Boolean);
+	const metadataIsFlags = metadataTokens.every((token) => /^-[a-z][a-z0-9-]*$/u.test(token));
+	const flags = /* @__PURE__ */ new Set();
+	for (const token of [...metadataIsFlags ? metadataTokens : [], ...fenceInfo.split(/\s+/u)]) {
+		const audience = AUDIENCE_FLAGS.get(token);
+		if (audience) flags.add(audience);
+	}
+	return flags;
+}
+/** Resolve example indexes for each consumer while preserving the pre-flag defaults. */
+function resolveExampleTargets(examples) {
+	const flags = examples.map(audienceFlags);
+	const explicit = (audience) => flags.flatMap((exampleFlags, index) => exampleFlags.has(audience) ? [index] : []);
+	const automatica11y = explicit("automatica11y");
+	const canvasRce = explicit("canvas-rce");
+	const docs = explicit("docs");
+	if (automatica11y.length + canvasRce.length + docs.length === 0) return {
+		automatica11y: [],
+		canvasRce: examples.length === 0 ? [] : [0],
+		docs: examples.map((_, index) => index)
+	};
+	const unassigned = flags.flatMap((exampleFlags, index) => exampleFlags.size === 0 ? [index] : []);
+	const fallbackCanvas = canvasRce.length === 0 ? unassigned.slice(0, 1) : [];
+	const assignedCanvas = canvasRce.length > 0 ? canvasRce : fallbackCanvas;
+	const fallbackDocs = docs.length > 0 ? [] : unassigned.filter((index) => !fallbackCanvas.includes(index));
+	return {
+		automatica11y,
+		canvasRce: assignedCanvas,
+		docs: docs.length > 0 ? docs : fallbackDocs
+	};
+}
+//#endregion
+export { resolveExampleTargets };

package/dist/index.mjs

@@ -132,6 +132,28 @@ const VAR_RE = regex(VAR_SOURCE, "g");
 /** A `light-dark(<light>, <dark>)` value; capture groups 1 and 2 are the two branches. */
 const LIGHT_DARK_RE = regex(LIGHT_DARK_SOURCE);
 const MAX_DEPTH = 12;
+function lightDarkBranches(value) {
+	const trimmed = value.trim();
+	if (!trimmed.startsWith("light-dark(") || !trimmed.endsWith(")")) return void 0;
+	const content = trimmed.slice(11, -1);
+	let depth = 0;
+	let separator = -1;
+	for (let index = 0; index < content.length; index += 1) {
+		const char = content[index];
+		if (char === "(") depth += 1;
+		else if (char === ")") {
+			depth -= 1;
+			if (depth < 0) return void 0;
+		} else if (char === "," && depth === 0) {
+			if (separator !== -1) return void 0;
+			separator = index;
+		}
+	}
+	if (depth !== 0 || separator === -1) return void 0;
+	const light = content.slice(0, separator).trim();
+	const dark = content.slice(separator + 1).trim();
+	return light && dark ? [light, dark] : void 0;
+}
 /**
 * Build a resolver that expands `var(--x)` references to concrete leaf values against `base` (plus
 * any `overrides`). With `mode` it collapses `light-dark()` to that branch; without, it leaves
@@ -191,8 +213,8 @@ function makeResolver(base, options = {}) {
 	for (const t of options.overrides ?? []) map.set(t.name, t.flatValue ?? t.value);
 	const pickMode = (value) => {
 		if (!options.mode) return value;
-		const m = LIGHT_DARK_RE.exec(value.trim());
-		return m ? options.mode === "light" ? m[1] : m[2] : value;
+		const branches = lightDarkBranches(value);
+		return branches ? branches[options.mode === "light" ? 0 : 1] : value;
 	};
 	const expand = (value, depth) => {
 		const picked = pickMode(value);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pantoken/utils",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Shared pantoken helpers: token reference resolver, typed regexes (arkregex), name-case, and hex-colour parsing.",
   "homepage": "https://pantoken.app",
   "bugs": "https://github.com/thedannywahl/pantoken/issues",
@@ -18,6 +18,7 @@
   "exports": {
     ".": "./dist/index.mjs",
     "./token-syntax": "./dist/token-syntax.mjs",
+    "./example-targets": "./dist/example-targets.mjs",
     "./scope": "./dist/scope.mjs",
     "./package.json": "./package.json"
   },
@@ -27,15 +28,15 @@
   },
   "dependencies": {
     "@pantoken/model": "0.5.0",
-    "arkregex": "^0.0.8",
+    "arkregex": "^0.0.12",
     "css-tree": "^3.2.1"
   },
   "devDependencies": {
     "@types/css-tree": "^3.2.0",
-    "@types/node": "^26.6.3",
+    "@types/node": "^26.6.5",
     "typescript": "^7.0.2",
-    "vite": "npm:@voidzero-dev/vite-plus-core@1.0.0-rc.0",
-    "vite-plus": "1.0.0-rc.0"
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.2.0",
+    "vite-plus": "1.2.0"
   },
   "engines": {
     "node": ">=22.18.0"