@nativele/ts-dom 0.4.0 → 0.5.0

package/dist/{a11y-Bn9pDvWV.mjs → a11y-wWL9rie7.mjs}

@@ -227,6 +227,14 @@ function rootElementType(html) {
 	const el = elements[0];
 	return el.namespaceURI === HTML_NS ? `El<${JSON.stringify(el.tagName)}>` : "SVGElement";
 }
+/** The whitespace mode an existing generated module was written with; "preserve" when there is none. */
+function recordedWhitespace(out) {
+	try {
+		return readFileSync(out, "utf8").split("\n", 3).includes(COLLAPSE_MARK) ? "collapse" : "preserve";
+	} catch {
+		return "preserve";
+	}
+}
 function globToRegExp(glob) {
 	let re = "";
 	for (let i = 0; i < glob.length; i++) {
@@ -302,8 +310,9 @@ function generateModule(html, options = {}, imports = [], defs = []) {
   events: ${union(a.events)};
 }`;
 	const needsEl = type.includes("El<");
-	return `// Generated by ts-dom. Do not edit.
-${imports.map((i) => `import ${q(i)};\n`).join("")}import { template } from ${q(runtime)};
+	const side = imports.map((i) => `import ${q(i)};\n`).join("");
+	return `// Generated by ts-dom. Do not edit.${options.whitespace === "collapse" ? `\n${COLLAPSE_MARK}` : ""}
+${side}import { template } from ${q(runtime)};
 ${needsEl ? `import type { El } from ${q(runtime)};\n` : ""}export default template<${type}>(${JSON.stringify(toNodes(parseFragment(html), options.whitespace === "collapse"))});
 `;
 }
@@ -320,21 +329,31 @@ function formatDiagnostics(file, ds) {
 	return ds.map((d) => `${file}:${d.line}:${d.col} ${d.severity} [${d.rule}] ${d.message}`).join("\n");
 }
 var CodegenError = class extends Error {};
-/**
-* Generate a single `x.html.ts`; throws CodegenError (and writes nothing) when there are error diagnostics.
-* `defs` is either a directory to scan or a precomputed scan result: custom elements used by the template
-* are imported automatically from the modules that define them.
-*/
-function generateFile(htmlPath, options = {}, defs) {
+/** What `generateFile` would write for a template, without writing it; throws CodegenError when the template has error diagnostics. */
+function renderFile(htmlPath, options = {}, defs) {
 	const html = readFileSync(htmlPath, "utf8");
+	if (options.whitespace === void 0) options = {
+		...options,
+		whitespace: recordedWhitespace(modulePathFor(htmlPath))
+	};
 	const analysis = analyze(html);
 	const errors = analysis.diagnostics.filter((d) => d.severity === "error");
 	if (errors.length) throw new CodegenError(formatDiagnostics(htmlPath, errors));
 	const known = typeof defs === "string" ? scanDefines(defs) : defs ?? [];
 	const here = dirname(htmlPath);
 	const imports = [...new Set(known.filter((d) => analysis.customTags.has(d.tag)).map((d) => relImport(here, d.file)))].sort();
-	const out = modulePathFor(htmlPath);
-	const next = generateModule(html, options, imports, known);
+	return {
+		out: modulePathFor(htmlPath),
+		next: generateModule(html, options, imports, known)
+	};
+}
+/**
+* Generate a single `x.html.ts`; throws CodegenError (and writes nothing) when there are error diagnostics.
+* `defs` is either a directory to scan or a precomputed scan result: custom elements used by the template
+* are imported automatically from the modules that define them.
+*/
+function generateFile(htmlPath, options = {}, defs) {
+	const { out, next } = renderFile(htmlPath, options, defs);
 	let prev = "";
 	try {
 		prev = readFileSync(out, "utf8");
@@ -345,7 +364,7 @@ function generateFile(htmlPath, options = {}, defs) {
 function listHtml(dir) {
 	const out = [];
 	for (const name of readdirSync(dir)) {
-		if (name === "node_modules") continue;
+		if (name === "node_modules" || name === "dist") continue;
 		const full = join(dir, name);
 		if (statSync(full).isDirectory()) out.push(...listHtml(full));
 		else if (name.endsWith(".html") && !isFullPage(readFileSync(full, "utf8"))) out.push(full);
@@ -354,6 +373,7 @@ function listHtml(dir) {
 }
 const TAGS_FILE = "ts-dom-tags.ts";
 const TAGS_HEADER = "// Generated by ts-dom. Do not edit.";
+const COLLAPSE_MARK = "// whitespace: collapse";
 function listTs(dir) {
 	const out = [];
 	for (const name of readdirSync(dir)) {
@@ -431,6 +451,20 @@ function scanTags(dir) {
 * so that `refs.x` for `<tag data-ref="x">` in a template is fully typed (props, methods and emitted events).
 */
 function generateTags(dir) {
+	const { out, next } = renderTags(dir);
+	if (next === null) {
+		if (existsSync(out) && readFileSync(out, "utf8").startsWith(TAGS_HEADER)) unlinkSync(out);
+		return null;
+	}
+	let prev = "";
+	try {
+		prev = readFileSync(out, "utf8");
+	} catch {}
+	if (prev !== next) writeFileSync(out, next);
+	return out;
+}
+/** What `generateTags` would write, without writing it; `next` is null when the directory defines no exported component. */
+function renderTags(dir) {
 	const defs = scanTags(dir);
 	const out = join(dir, TAGS_FILE);
 	const seen = /* @__PURE__ */ new Map();
@@ -439,19 +473,86 @@ function generateTags(dir) {
 		if (prev && (prev.from !== d.from || prev.className !== d.className)) throw new CodegenError(`${dir}: [duplicate-define] the tag <${d.tag}> is defined more than once (${prev.from} and ${d.from}). Fix: each custom element name can be defined only once; rename one of them.`);
 		seen.set(d.tag, d);
 	}
-	if (!defs.length) {
-		if (existsSync(out) && readFileSync(out, "utf8").startsWith(TAGS_HEADER)) unlinkSync(out);
-		return null;
-	}
+	if (!defs.length) return {
+		out,
+		next: null
+	};
 	const alias = (d) => `Tag${[...seen.keys()].indexOf(d.tag)}`;
 	const imports = [...seen.values()].map((d) => `import type { ${d.isDefault ? "default" : d.className} as ${alias(d)} } from ${JSON.stringify(d.from)};`);
 	const entries = [...seen.values()].map((d) => `    ${JSON.stringify(d.tag)}: ${alias(d)};`);
-	const next = `${TAGS_HEADER}\n${imports.join("\n")}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n${entries.join("\n")}\n  }\n}\n\nexport {};\n`;
-	let prev = "";
+	return {
+		out,
+		next: `${TAGS_HEADER}\n${imports.join("\n")}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n${entries.join("\n")}\n  }\n}\n\nexport {};\n`
+	};
+}
+/**
+* Everything `generateAll` would write for a directory, in memory: generated path to content, or null for a file that should not exist.
+* Templates with error diagnostics are left out and their messages returned in `errors`.
+*/
+function planGenerated(dir, options = {}) {
+	const files = /* @__PURE__ */ new Map();
+	const errors = [];
+	const defs = scanDefines(dir);
+	for (const f of listHtml(dir)) {
+		if (!isSelected(dir, f, options)) continue;
+		try {
+			const { out, next } = renderFile(f, options, defs);
+			files.set(out, next);
+		} catch (e) {
+			if (e instanceof CodegenError) errors.push(e.message);
+			else throw e;
+		}
+	}
 	try {
-		prev = readFileSync(out, "utf8");
-	} catch {}
-	if (prev !== next) writeFileSync(out, next);
+		const tags = renderTags(dir);
+		files.set(tags.out, tags.next);
+	} catch (e) {
+		if (e instanceof CodegenError) errors.push(e.message);
+		else throw e;
+	}
+	for (const f of listGenerated(dir)) if (!files.has(f) && !existsSync(f.slice(0, -3))) files.set(f, null);
+	return {
+		files,
+		errors
+	};
+}
+/** Generated files under `dir` that differ from what `ts-dom gen` would write now. */
+function staleGenerated(dir, options = {}) {
+	return checkGenerated(dir, options).stale;
+}
+/** `staleGenerated`, plus the errors that would make `ts-dom gen` fail (template diagnostics, a tag defined twice). */
+function checkGenerated(dir, options = {}) {
+	const plan = planGenerated(dir, options);
+	const out = [];
+	for (const [file, next] of plan.files) {
+		const prev = existsSync(file) ? readFileSync(file, "utf8") : null;
+		if (next === null) {
+			if (prev !== null && prev.startsWith(TAGS_HEADER)) out.push({
+				file,
+				reason: file.endsWith(".html.ts") ? "orphan" : "outdated"
+			});
+		} else if (prev === null) out.push({
+			file,
+			reason: "missing"
+		});
+		else if (prev !== next) out.push({
+			file,
+			reason: "outdated"
+		});
+	}
+	return {
+		stale: out.sort((a, b) => a.file.localeCompare(b.file)),
+		errors: plan.errors
+	};
+}
+function listGenerated(dir) {
+	const out = [];
+	for (const name of readdirSync(dir)) {
+		if (name === "node_modules") continue;
+		const full = join(dir, name);
+		if (statSync(full).isDirectory()) out.push(...listGenerated(full));
+		else if (name.endsWith(".html.ts") && readFileSync(full, "utf8").startsWith(TAGS_HEADER)) out.push(full);
+	}
 	return out;
 }
 /** Generate every `x.html.ts` (and the tag map) under a directory; collects all errors and throws them together. */
@@ -475,6 +576,7 @@ function generateAll(dir, options = {}) {
 		if (e instanceof CodegenError) errors.push(e.message);
 		else throw e;
 	}
+	for (const f of listGenerated(dir)) if (!existsSync(f.slice(0, -3))) unlinkSync(f);
 	if (errors.length) throw new CodegenError(errors.join("\n"));
 	return written;
 }
@@ -712,4 +814,4 @@ function checkA11y(html, ignore = []) {
 	for (const { id, el } of labelFor) if (!ids.has(id)) report("label-for", el, `<label for="${id}"> points to an id that does not exist in this template. Fix: add id="${id}" to the control, or wrap the control in the label.`);
 	return out.sort((a, b) => a.line - b.line || a.col - b.col);
 }
-export { analyze as a, generateFile as c, listHtml as d, scanDefines as f, CodegenError as i, isFullPage as l, checkA11y as n, formatDiagnostics as o, watchAll as p, CODEGEN_RULES as r, generateAll as s, A11Y_RULES as t, isSelected as u };
+export { watchAll as _, analyze as a, generateAll as c, isSelected as d, listHtml as f, staleGenerated as g, scanDefines as h, CodegenError as i, generateFile as l, renderTags as m, checkA11y as n, checkGenerated as o, listTs as p, CODEGEN_RULES as r, formatDiagnostics as s, A11Y_RULES as t, isFullPage as u };