@rafters/veneer 0.0.1 → 0.0.3

package/dist/bin.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/bin.mjs

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+import { i as relativeFile } from "./lint-Tvq5uHHS.mjs";
+import { t as check } from "./check-CbVCXbX6.mjs";
+import path from "node:path";
+import { existsSync, realpathSync } from "node:fs";
+import { parseArgs } from "node:util";
+import { text } from "node:stream/consumers";
+//#region src/bin.ts
+const COULD_NOT_RUN = 2;
+function parsedArguments() {
+	try {
+		const { values, positionals } = parseArgs({
+			allowPositionals: true,
+			options: { stdin: { type: "string" } }
+		});
+		const [root, ...rest] = positionals;
+		return rest.length > 0 ? void 0 : {
+			root,
+			stdinPath: values.stdin
+		};
+	} catch {
+		return;
+	}
+}
+function resolvedLinks(file) {
+	if (existsSync(file)) return realpathSync(file);
+	const parent = path.dirname(file);
+	return parent === file ? file : path.join(resolvedLinks(parent), path.basename(file));
+}
+async function run(root, stdinPath) {
+	const file = stdinPath && relativeFile(resolvedLinks(root), resolvedLinks(path.resolve(stdinPath)));
+	const unsaved = file === void 0 ? void 0 : { [file]: await text(process.stdin) };
+	const result = await check(root, { unsaved });
+	if (!result.ok) {
+		for (const { message } of result.errors) process.stderr.write(`${message}\n`);
+		return COULD_NOT_RUN;
+	}
+	process.stdout.write(result.report);
+	for (const { message } of result.notices) process.stderr.write(`${message}\n`);
+	return result.diagnostics.some(({ severity }) => severity === "error") ? 1 : 0;
+}
+const parsed = parsedArguments();
+if (parsed) try {
+	process.exitCode = await run(parsed.root ?? process.cwd(), parsed.stdinPath);
+} catch (error) {
+	process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+	process.exitCode = COULD_NOT_RUN;
+}
+else {
+	process.stderr.write("usage: rafters-check [root] [--stdin <path>]\n");
+	process.exitCode = COULD_NOT_RUN;
+}
+//#endregion
+export {};

package/dist/check-CbVCXbX6.mjs

@@ -0,0 +1,157 @@
+import { a as resolveComponents, c as readConfig, n as report, o as ProjectError, r as compareCodePoints, s as openProject, t as lint } from "./lint-Tvq5uHHS.mjs";
+import path from "node:path";
+import { mkdir, rename, rm, writeFile } from "node:fs/promises";
+import { lstatSync } from "node:fs";
+//#region src/docs.ts
+function propLine(prop) {
+	return {
+		name: prop.name,
+		type: prop.type,
+		optional: prop.optional,
+		...prop.default !== void 0 && { default: prop.default },
+		...prop.values !== void 0 && { values: prop.values },
+		...prop.doc !== void 0 && { doc: prop.doc },
+		file: prop.file,
+		line: prop.line,
+		column: prop.column
+	};
+}
+function componentLine(component) {
+	return {
+		kind: "component",
+		name: component.name,
+		file: component.file,
+		resolved: component.resolved,
+		...component.reason !== void 0 && { reason: component.reason },
+		...component.description !== void 0 && { description: component.description },
+		tags: component.tags,
+		props: component.props.map(propLine),
+		inherited: component.inherited,
+		inheritedDefaults: component.inheritedDefaults
+	};
+}
+function docsText(intent, components) {
+	return [{
+		kind: "project",
+		intent
+	}, ...components.map(componentLine)].map((line) => `${JSON.stringify(line)}\n`).join("");
+}
+async function writeWhole(docsPath, text) {
+	const temporary = `${docsPath}.tmp`;
+	await mkdir(path.dirname(docsPath), { recursive: true });
+	try {
+		await rm(temporary, { force: true });
+		await writeFile(temporary, text, { flag: "wx" });
+		await rename(temporary, docsPath);
+	} catch (error) {
+		await rm(temporary, { force: true });
+		throw error;
+	}
+}
+async function openOrError(root, unsaved) {
+	try {
+		return await openProject(root, { unsaved });
+	} catch (error) {
+		if (error instanceof ProjectError && error.code === "tsconfig-missing") return {
+			code: error.code,
+			message: error.message
+		};
+		throw error;
+	}
+}
+function outputSymlinkError(root) {
+	const symlink = [".rafters", ".rafters/veneer"].find((folder) => lstatSync(path.join(root, folder), { throwIfNoEntry: false })?.isSymbolicLink());
+	if (!symlink) return void 0;
+	return {
+		code: "output-symlink",
+		message: `${symlink} is a symbolic link; veneer writes only inside the project`
+	};
+}
+function sortedNotices(notices) {
+	return notices.toSorted((a, b) => compareCodePoints(a.code, b.code) || compareCodePoints(a.message, b.message));
+}
+async function writeDocsFrom(project, config) {
+	const { components, notices } = await resolveComponents(project, config.componentFolders);
+	const docsPath = path.join(project.root, ".rafters/veneer/docs.jsonl");
+	await writeWhole(docsPath, docsText(config.intent, components));
+	return {
+		docsPath,
+		notices: sortedNotices([...config.notices, ...notices])
+	};
+}
+async function writeDocs(projectRoot) {
+	const root = path.resolve(projectRoot);
+	const config = await readConfig(root);
+	if (!config.ok) return {
+		ok: false,
+		errors: config.errors
+	};
+	const symlink = outputSymlinkError(root);
+	if (symlink) return {
+		ok: false,
+		errors: [symlink]
+	};
+	const project = await openOrError(root);
+	if ("code" in project) return {
+		ok: false,
+		errors: [project]
+	};
+	try {
+		return {
+			ok: true,
+			...await writeDocsFrom(project, config)
+		};
+	} finally {
+		project.close();
+	}
+}
+//#endregion
+//#region src/check.ts
+function outsideProgram(file) {
+	return {
+		code: "outside-program",
+		message: `${file} is not in the tsconfig's files, so it was not checked`
+	};
+}
+async function check(projectRoot, options = {}) {
+	const root = path.resolve(projectRoot);
+	const config = await readConfig(root);
+	if (!config.ok) return {
+		ok: false,
+		errors: config.errors
+	};
+	const unsaved = options.unsaved ?? {};
+	const unsavedFiles = Object.keys(unsaved);
+	const isSave = options.save === true && unsavedFiles.length === 0;
+	const symlink = isSave ? outputSymlinkError(root) : void 0;
+	if (symlink) return {
+		ok: false,
+		errors: [symlink]
+	};
+	const project = await openOrError(root, unsaved);
+	if ("code" in project) return {
+		ok: false,
+		errors: [project]
+	};
+	try {
+		const roots = project.checker.getRootFileNames();
+		const outside = unsavedFiles.filter((file) => !roots.includes(path.join(root, file)));
+		const asked = options.paths ?? (unsavedFiles.length > 0 ? unsavedFiles : void 0);
+		const diagnostics = await lint(project, {
+			componentFolders: config.componentFolders,
+			scan: config.scan,
+			files: isSave ? void 0 : asked?.filter((file) => !outside.includes(file))
+		});
+		const written = isSave ? await writeDocsFrom(project, config) : void 0;
+		return {
+			ok: true,
+			diagnostics,
+			report: report(diagnostics),
+			...written ?? { notices: sortedNotices([...config.notices, ...outside.map(outsideProgram)]) }
+		};
+	} finally {
+		project.close();
+	}
+}
+//#endregion
+export { writeDocs as n, check as t };

package/dist/index.d.mts

@@ -1,6 +1,8 @@
 import { AstroCheck, Diagnostic as Diagnostic$1 } from "@astrojs/language-server";
 import * as TypeScript from "typescript";
 //#region src/config.d.ts
+declare const SCANS: readonly ["system", "format", "all"];
+type Scan = (typeof SCANS)[number];
 interface Notice {
   code: string;
   message: string;
@@ -47,6 +49,7 @@ interface LintDiagnostic extends Diagnostic {
 }
 export declare function lint(project: Project, options: {
   componentFolders: string[];
+  scan?: Scan;
   files?: string[];
 }): Promise<LintDiagnostic[]>;
 export declare function report(diagnostics: LintDiagnostic[]): string;

package/dist/index.mjs

@@ -1,156 +1,3 @@
-import { a as ProjectError, i as resolveComponents, n as report, o as openProject, r as compareCodePoints, s as readConfig, t as lint } from "./lint-BabXVYQJ.mjs";
-import path from "node:path";
-import { mkdir, rename, rm, writeFile } from "node:fs/promises";
-import { lstatSync } from "node:fs";
-//#region src/docs.ts
-function propLine(prop) {
-	return {
-		name: prop.name,
-		type: prop.type,
-		optional: prop.optional,
-		...prop.default !== void 0 && { default: prop.default },
-		...prop.values !== void 0 && { values: prop.values },
-		...prop.doc !== void 0 && { doc: prop.doc },
-		file: prop.file,
-		line: prop.line,
-		column: prop.column
-	};
-}
-function componentLine(component) {
-	return {
-		kind: "component",
-		name: component.name,
-		file: component.file,
-		resolved: component.resolved,
-		...component.reason !== void 0 && { reason: component.reason },
-		...component.description !== void 0 && { description: component.description },
-		tags: component.tags,
-		props: component.props.map(propLine),
-		inherited: component.inherited,
-		inheritedDefaults: component.inheritedDefaults
-	};
-}
-function docsText(intent, components) {
-	return [{
-		kind: "project",
-		intent
-	}, ...components.map(componentLine)].map((line) => `${JSON.stringify(line)}\n`).join("");
-}
-async function writeWhole(docsPath, text) {
-	const temporary = `${docsPath}.tmp`;
-	await mkdir(path.dirname(docsPath), { recursive: true });
-	try {
-		await rm(temporary, { force: true });
-		await writeFile(temporary, text, { flag: "wx" });
-		await rename(temporary, docsPath);
-	} catch (error) {
-		await rm(temporary, { force: true });
-		throw error;
-	}
-}
-async function openOrError(root, unsaved) {
-	try {
-		return await openProject(root, { unsaved });
-	} catch (error) {
-		if (error instanceof ProjectError && error.code === "tsconfig-missing") return {
-			code: error.code,
-			message: error.message
-		};
-		throw error;
-	}
-}
-function outputSymlinkError(root) {
-	const symlink = [".rafters", ".rafters/veneer"].find((folder) => lstatSync(path.join(root, folder), { throwIfNoEntry: false })?.isSymbolicLink());
-	if (!symlink) return void 0;
-	return {
-		code: "output-symlink",
-		message: `${symlink} is a symbolic link; veneer writes only inside the project`
-	};
-}
-function sortedNotices(notices) {
-	return notices.toSorted((a, b) => compareCodePoints(a.code, b.code) || compareCodePoints(a.message, b.message));
-}
-async function writeDocsFrom(project, config) {
-	const { components, notices } = await resolveComponents(project, config.componentFolders);
-	const docsPath = path.join(project.root, ".rafters/veneer/docs.jsonl");
-	await writeWhole(docsPath, docsText(config.intent, components));
-	return {
-		docsPath,
-		notices: sortedNotices([...config.notices, ...notices])
-	};
-}
-async function writeDocs(projectRoot) {
-	const root = path.resolve(projectRoot);
-	const config = await readConfig(root);
-	if (!config.ok) return {
-		ok: false,
-		errors: config.errors
-	};
-	const symlink = outputSymlinkError(root);
-	if (symlink) return {
-		ok: false,
-		errors: [symlink]
-	};
-	const project = await openOrError(root);
-	if ("code" in project) return {
-		ok: false,
-		errors: [project]
-	};
-	try {
-		return {
-			ok: true,
-			...await writeDocsFrom(project, config)
-		};
-	} finally {
-		project.close();
-	}
-}
-//#endregion
-//#region src/check.ts
-function outsideProgram(file) {
-	return {
-		code: "outside-program",
-		message: `${file} is not in the tsconfig's files, so it was not checked`
-	};
-}
-async function check(projectRoot, options = {}) {
-	const root = path.resolve(projectRoot);
-	const config = await readConfig(root);
-	if (!config.ok) return {
-		ok: false,
-		errors: config.errors
-	};
-	const unsaved = options.unsaved ?? {};
-	const unsavedFiles = Object.keys(unsaved);
-	const isSave = options.save === true && unsavedFiles.length === 0;
-	const symlink = isSave ? outputSymlinkError(root) : void 0;
-	if (symlink) return {
-		ok: false,
-		errors: [symlink]
-	};
-	const project = await openOrError(root, unsaved);
-	if ("code" in project) return {
-		ok: false,
-		errors: [project]
-	};
-	try {
-		const roots = project.checker.getRootFileNames();
-		const outside = unsavedFiles.filter((file) => !roots.includes(path.join(root, file)));
-		const asked = options.paths ?? (unsavedFiles.length > 0 ? unsavedFiles : void 0);
-		const diagnostics = await lint(project, {
-			componentFolders: config.componentFolders,
-			files: isSave ? void 0 : asked?.filter((file) => !outside.includes(file))
-		});
-		const written = isSave ? await writeDocsFrom(project, config) : void 0;
-		return {
-			ok: true,
-			diagnostics,
-			report: report(diagnostics),
-			...written ?? { notices: sortedNotices([...config.notices, ...outside.map(outsideProgram)]) }
-		};
-	} finally {
-		project.close();
-	}
-}
-//#endregion
+import { n as report, o as ProjectError, s as openProject, t as lint } from "./lint-Tvq5uHHS.mjs";
+import { n as writeDocs, t as check } from "./check-CbVCXbX6.mjs";
 export { ProjectError, check, lint, openProject, report, writeDocs };

package/dist/{lint-BabXVYQJ.mjs → lint-Tvq5uHHS.mjs}

@@ -6,6 +6,12 @@ import { format } from "node:util";
 import { AstroCheck } from "@astrojs/language-server";
 //#region src/config.ts
 const CONFIG_FILE = ".rafters/config.rafters.json";
+const SCANS = [
+	"system",
+	"format",
+	"all"
+];
+const isScan = (value) => SCANS.some((scan) => scan === value);
 function isObject(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -98,7 +104,10 @@ async function readConfig(root) {
 	}
 	if (intent !== void 0 && typeof intent !== "string") errors.push(fieldError("intent", "expected a string", intent));
 	if (veneer !== void 0 && !isObject(veneer)) errors.push(fieldError("veneer", "expected an object", veneer));
-	else if (veneer?.mdxPath !== void 0 && typeof veneer.mdxPath !== "string") errors.push(fieldError("veneer.mdxPath", "expected a string", veneer.mdxPath));
+	else {
+		if (veneer?.mdxPath !== void 0 && typeof veneer.mdxPath !== "string") errors.push(fieldError("veneer.mdxPath", "expected a string", veneer.mdxPath));
+		if (veneer?.scan !== void 0 && !isScan(veneer.scan)) errors.push(fieldError("veneer.scan", `expected one of ${SCANS.join(", ")}`, veneer.scan));
+	}
 	if (errors.length > 0) return {
 		ok: false,
 		errors
@@ -107,6 +116,7 @@ async function readConfig(root) {
 		ok: true,
 		intent: typeof intent === "string" ? intent : null,
 		componentFolders,
+		scan: isObject(veneer) && isScan(veneer.scan) ? veneer.scan : "format",
 		notices
 	};
 }
@@ -669,7 +679,15 @@ function ownPropNames(reader, component, sourceFile) {
 	if (!signature) return [];
 	return propsOfSignature(reader, signature, sourceFile, /* @__PURE__ */ new Map()).props.map(({ name }) => name);
 }
-function intelligenceBlock(reader, sourceFile) {
+const INTELLIGENCE_TAGS = [
+	"cognitive-load",
+	"attention-economics",
+	"trust-building",
+	"accessibility",
+	"semantic-meaning",
+	"usage-patterns"
+];
+function placedBlocks(reader, sourceFile) {
 	const { ts } = reader;
 	const blocks = [];
 	const visit = (node) => {
@@ -684,7 +702,16 @@ function intelligenceBlock(reader, sourceFile) {
 			block,
 			at
 		}];
-	}).sort((a, b) => a.at - b.at)[0]?.block;
+	});
+}
+function intelligenceBlock(reader, sourceFile) {
+	return placedBlocks(reader, sourceFile).sort((a, b) => a.at - b.at)[0]?.block;
+}
+function holdsAllIntelligenceTags(reader, sourceFile) {
+	return placedBlocks(reader, sourceFile).some(({ block }) => {
+		const names = new Set(block.tags?.map((tag) => tag.tagName.text));
+		return INTELLIGENCE_TAGS.every((tag) => names.has(tag));
+	});
 }
 function intelligence(reader, sourceFile) {
 	const { ts } = reader;
@@ -785,6 +812,12 @@ const CLASS_ATTRIBUTES = /* @__PURE__ */ new Set([
 ]);
 const MAX_RESOLVE_STEPS = 8;
 const realPath = (file) => existsSync(file) ? realpathSync(file) : file;
+function qualifies(reader, sourceFile) {
+	const { fileName } = sourceFile;
+	const stem = fileName.replace(/\.(tsx|astro)$/, "");
+	const { sys } = reader.ts;
+	return stem !== fileName && sys.fileExists(`${stem}.behavior.ts`) && sys.fileExists(`${stem}.classes.ts`) && holdsAllIntelligenceTags(reader, sourceFile);
+}
 function offsetAt(text, line, column) {
 	const breaks = /\r\n|\r|\n/g;
 	let start = 0;
@@ -817,8 +850,8 @@ function elementUsing(ts, node) {
 	const element = tag.parent;
 	return ts.isJsxOpeningLikeElement(element) && element.tagName === tag ? element : void 0;
 }
-function resolveTag({ ts, tc }, { tagName }) {
-	let symbol = tc.getSymbolAtLocation(ts.isPropertyAccessExpression(tagName) ? tagName.name : tagName);
+function resolveSymbol({ ts, tc }, start) {
+	let symbol = start;
 	for (let step = 0; symbol && step < MAX_RESOLVE_STEPS; step += 1) {
 		const declaration = symbol.valueDeclaration;
 		if (symbol.flags & ts.SymbolFlags.Alias) symbol = tc.getAliasedSymbol(symbol);
@@ -826,6 +859,10 @@ function resolveTag({ ts, tc }, { tagName }) {
 		else return symbol;
 	}
 }
+function resolveTag(reader, { tagName }) {
+	const { ts, tc } = reader;
+	return resolveSymbol(reader, tc.getSymbolAtLocation(ts.isPropertyAccessExpression(tagName) ? tagName.name : tagName));
+}
 function deprecatedText({ ts, tc }, element, name) {
 	const parameter = tc.getResolvedSignature(element)?.parameters[0];
 	const tag = (parameter && tc.getTypeOfSymbol(parameter).getProperty(name))?.getJsDocTags(tc).find((found) => found.name === "deprecated");
@@ -842,46 +879,60 @@ function utilityOf(className) {
 	}
 	return className.slice(start);
 }
-function classLiterals(ts, node) {
-	if (ts.isStringLiteralLike(node)) return [node];
-	if (ts.isJsxExpression(node) || ts.isParenthesizedExpression(node)) return node.expression ? classLiterals(ts, node.expression) : [];
-	if (ts.isArrayLiteralExpression(node)) return node.elements.flatMap((element) => classLiterals(ts, element));
-	if (ts.isObjectLiteralExpression(node)) return node.properties.flatMap((property) => ts.isPropertyAssignment(property) && ts.isStringLiteral(property.name) ? [property.name] : []);
-	return [];
+function constString(reader, identifier) {
+	const { ts, tc } = reader;
+	const declaration = resolveSymbol(reader, tc.getSymbolAtLocation(identifier))?.valueDeclaration;
+	if (!declaration || !ts.isVariableDeclaration(declaration) || !(ts.getCombinedNodeFlags(declaration) & ts.NodeFlags.Const) || !declaration.initializer) return;
+	return ts.isStringLiteralLike(declaration.initializer) ? declaration.initializer : void 0;
+}
+function collectClassStrings(reader, sourceFile, isOwnSource, node, found) {
+	const { ts } = reader;
+	if (ts.isStringLiteralLike(node)) found.set(node, node);
+	else if (ts.isIdentifier(node)) {
+		const literal = constString(reader, node);
+		const declaredIn = literal?.getSourceFile();
+		if (!literal || !declaredIn) return;
+		if (declaredIn === sourceFile) found.set(literal, literal);
+		else if (isOwnSource(declaredIn.fileName)) found.set(node, literal);
+	} else ts.forEachChild(node, (child) => {
+		collectClassStrings(reader, sourceFile, isOwnSource, child, found);
+	});
 }
-function bracketsInLiteral(reader, file, sourceFile, literal) {
-	return [...literal.getText(sourceFile).slice(1, -1).matchAll(/\S+/g)].flatMap((match) => {
+function bracketsInLiteral(reader, file, sourceFile, at, literal) {
+	return [...literal.getText(literal.getSourceFile()).slice(1, -1).matchAll(/\S+/g)].flatMap((match) => {
 		const [className] = match;
 		if (!utilityOf(className).includes("[")) return [];
-		const position = positionOf(reader, sourceFile, literal.getStart(sourceFile) + 1 + match.index);
+		const inLiteral = at === literal;
+		const position = positionOf(reader, sourceFile, at.getStart(sourceFile) + (inLiteral ? 1 + match.index : 0));
 		if (!position) return [];
 		return [{
 			file,
 			line: position.line,
 			column: position.column,
 			endLine: position.line,
-			endColumn: position.column + className.length,
+			endColumn: position.column + (inLiteral ? className.length : at.getWidth(sourceFile)),
 			severity: "error",
 			code: "rafters(arbitrary-value)",
 			message: `${className} is an arbitrary value`
 		}];
 	});
 }
-function bracketValues(reader, file, sourceFile) {
+function bracketValues(reader, file, sourceFile, isOwnSource) {
 	const { ts } = reader;
-	const found = [];
+	const strings = /* @__PURE__ */ new Map();
 	const visit = (node) => {
 		if (ts.isJsxAttribute(node) && node.initializer) {
 			const { name } = node;
 			const attribute = ts.isJsxNamespacedName(name) ? `${name.namespace.text}:${name.name.text}` : name.text;
-			if (CLASS_ATTRIBUTES.has(attribute)) for (const literal of classLiterals(ts, node.initializer)) found.push(...bracketsInLiteral(reader, file, sourceFile, literal));
-		}
+			if (CLASS_ATTRIBUTES.has(attribute)) collectClassStrings(reader, sourceFile, isOwnSource, node.initializer, strings);
+		} else if (ts.isCallExpression(node) && ts.isIdentifier(node.expression) && node.expression.text === "classy") for (const argument of node.arguments) collectClassStrings(reader, sourceFile, isOwnSource, argument, strings);
 		ts.forEachChild(node, visit);
 	};
 	visit(sourceFile);
-	return found;
+	return [...strings].flatMap(([at, literal]) => bracketsInLiteral(reader, file, sourceFile, at, literal));
 }
 const FILL_WORD = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
+const FILL_TOKEN = /^bg-fill-[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
 const FILL_ALPHA = /^(100|[1-9]?[0-9])$/;
 const AUTHORED_FILL = "a fill the designer authors, fill=\"bg-fill-<name>\"";
 const isFillStop = (stop) => {
@@ -901,17 +952,17 @@ async function loadSurfaces(root) {
 		return { failure: error instanceof Error ? error.message : String(error) };
 	}
 }
-function fillLiteral(ts, node) {
+function valueLiteral(ts, node) {
 	const { initializer } = node;
 	if (!initializer) return void 0;
 	if (ts.isStringLiteral(initializer)) return initializer;
 	const inner = ts.isJsxExpression(initializer) ? initializer.expression : void 0;
 	return inner && ts.isStringLiteralLike(inner) ? inner : void 0;
 }
-function fillAttributes({ ts }, sourceFile) {
+function valueAttributes({ ts }, sourceFile) {
 	const found = [];
 	const visit = (node) => {
-		if (ts.isJsxAttribute(node) && ts.isIdentifier(node.name) && node.name.text === "fill") found.push(node);
+		if (ts.isJsxAttribute(node) && ts.isIdentifier(node.name) && (node.name.text === "fill" || node.name.text === "surface")) found.push(node);
 		ts.forEachChild(node, visit);
 	};
 	visit(sourceFile);
@@ -933,6 +984,17 @@ async function lint(project, options) {
 		const real = realPath(file);
 		return folders.some((folder) => real.startsWith(folder));
 	};
+	const scan = options.scan ?? "format";
+	const projectRoot = realPath(project.root);
+	const isOwnSource = (file) => {
+		const [first, ...rest] = path.relative(projectRoot, realPath(file)).split(path.sep);
+		return first !== ".." && first !== "node_modules" && !rest.includes("node_modules");
+	};
+	const isExempt = (sourceFile) => isUnderFolder(sourceFile.fileName) || qualifies(reader, sourceFile);
+	const isCheckedUse = (declaredIn) => {
+		if (scan === "system") return isUnderFolder(declaredIn.fileName);
+		return isExempt(declaredIn) || scan === "all" && isOwnSource(declaredIn.fileName);
+	};
 	const propsHelp = /* @__PURE__ */ new Map();
 	const reportedUse = (sourceFile, diagnostic) => {
 		const offset = programOffset(reader, sourceFile, diagnostic);
@@ -943,7 +1005,7 @@ async function lint(project, options) {
 		const declaration = component?.valueDeclaration ?? component?.declarations?.[0];
 		if (!element || !component || !declaration) return void 0;
 		const declaredIn = declaration.getSourceFile();
-		if (!isUnderFolder(declaredIn.fileName)) return void 0;
+		if (!isCheckedUse(declaredIn)) return void 0;
 		let help;
 		if (diagnostic.code === "ts(6385)") help = deprecatedText(reader, element, node.getText(sourceFile));
 		else {
@@ -966,15 +1028,44 @@ async function lint(project, options) {
 		if ("failure" in loaded) return `the project's tokens could not be loaded, so no replacement is named: ${loaded.failure}`;
 		return loaded.words.has(value) ? `surface="${value}"` : AUTHORED_FILL;
 	};
-	const retiredFills = async (file, sourceFile) => {
+	const fillFinding = async (value) => {
+		if (value === "" || FILL_TOKEN.test(value)) return void 0;
+		const form = retiredFillForm(value);
+		if (!form) return {
+			code: "rafters(invalid-fill)",
+			message: `fill="${value}" is not exactly one bg-fill-* token`
+		};
+		return {
+			code: "rafters(retired-fill)",
+			message: `fill="${value}" is a retired fill value`,
+			help: await replacement(value, form)
+		};
+	};
+	const surfaceFinding = async (value) => {
+		if (value === "") return void 0;
+		surfaces ??= loadSurfaces(project.root);
+		const loaded = await surfaces;
+		if ("failure" in loaded) return {
+			code: "rafters(unknown-surface)",
+			message: `surface="${value}" could not be checked`,
+			help: `the project's tokens could not be loaded, so no surface is named: ${loaded.failure}`
+		};
+		if (loaded.words.has(value)) return void 0;
+		return {
+			code: "rafters(unknown-surface)",
+			message: `surface="${value}" is not a surface in the project's tokens`
+		};
+	};
+	const badValues = async (file, sourceFile) => {
 		const flagged = [];
-		for (const attribute of fillAttributes(reader, sourceFile)) {
-			const literal = fillLiteral(ts, attribute);
-			const form = literal && retiredFillForm(literal.text);
-			if (!literal || !form) continue;
+		for (const attribute of valueAttributes(reader, sourceFile)) {
+			const literal = valueLiteral(ts, attribute);
+			if (!literal) continue;
 			const component = resolveTag(reader, attribute.parent.parent);
 			const declaration = component?.valueDeclaration ?? component?.declarations?.[0];
-			if (!declaration || !isUnderFolder(declaration.getSourceFile().fileName)) continue;
+			if (!declaration || !isCheckedUse(declaration.getSourceFile())) continue;
+			const finding = await (attribute.name.getText(sourceFile) === "fill" ? fillFinding(literal.text) : surfaceFinding(literal.text));
+			if (!finding) continue;
 			const start = positionOf(reader, sourceFile, attribute.getStart(sourceFile));
 			const end = positionOf(reader, sourceFile, attribute.end);
 			if (!start || !end) continue;
@@ -985,9 +1076,7 @@ async function lint(project, options) {
 				endLine: end.line,
 				endColumn: end.column,
 				severity: "error",
-				code: "rafters(retired-fill)",
-				message: `fill="${literal.text}" is a retired fill value`,
-				help: await replacement(literal.text, form)
+				...finding
 			});
 		}
 		return flagged;
@@ -1001,9 +1090,9 @@ async function lint(project, options) {
 			const reported = reportedUse(sourceFile, diagnostic);
 			if (reported) found.push(reported);
 		}
-		if (!isUnderFolder(absolute)) {
-			found.push(...bracketValues(reader, file, sourceFile));
-			found.push(...await retiredFills(file, sourceFile));
+		if (!isExempt(sourceFile)) {
+			found.push(...bracketValues(reader, file, sourceFile, isOwnSource));
+			found.push(...await badValues(file, sourceFile));
 		}
 	}
 	return found.sort((a, b) => compareCodePoints(a.file, b.file) || a.line - b.line || a.column - b.column);
@@ -1021,4 +1110,4 @@ function report(diagnostics) {
 	return lines.map((line) => `${line}\n`).join("");
 }
 //#endregion
-export { ProjectError as a, resolveComponents as i, report as n, openProject as o, compareCodePoints as r, readConfig as s, lint as t };
+export { resolveComponents as a, readConfig as c, relativeFile as i, report as n, ProjectError as o, compareCodePoints as r, openProject as s, lint as t };

package/dist/worker.mjs

@@ -1,4 +1,4 @@
-import { o as openProject, s as readConfig, t as lint } from "./lint-BabXVYQJ.mjs";
+import { c as readConfig, s as openProject, t as lint } from "./lint-Tvq5uHHS.mjs";
 import path from "node:path";
 import { existsSync } from "node:fs";
 import { promisify } from "node:util";
@@ -30,7 +30,7 @@ process.stdout.write(JSON.stringify(await check(${JSON.stringify(root)}, { save:
 async function serve(root) {
 	const config = await readConfig(root);
 	if (!config.ok) throw new Error(messages(config.errors));
-	const { componentFolders } = config;
+	const { componentFolders, scan } = config;
 	let project = await openProject(root);
 	const unsaved = /* @__PURE__ */ new Map();
 	const outside = /* @__PURE__ */ new Set();
@@ -57,6 +57,7 @@ async function serve(root) {
 		}
 		return lint(project, {
 			componentFolders,
+			scan,
 			files: [file]
 		});
 	};

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "@rafters/veneer",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Docs, rafters check and the composite compile for rafters projects",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/rafters-studio/veneer"
   },
+  "bin": {
+    "rafters-check": "./dist/bin.mjs"
+  },
   "files": [
     "dist"
   ],