@homepages/template-kit 0.9.0-dev-20260719224319 → 0.9.0

package/dist/cli/check/stages/size.js

@@ -1,274 +0,0 @@
-import { loadEsbuild } from "../resolve-tool.js";
-import { ASSET_LOADERS, ASSET_NAMES, ASSET_PUBLIC_PATH, compileSectionPackageCss, sectionCssFiles } from "../css.js";
-import { CHECK_CONFIG } from "../config.js";
-import { findSectionIslands } from "../../../islands/discover.js";
-import { readFile } from "node:fs/promises";
-import { basename, join, relative } from "node:path";
-import { existsSync } from "node:fs";
-import { gzipSync } from "node:zlib";
-
-//#region src/cli/check/stages/size.ts
-const RESOLVING = Symbol("size-stub:resolving");
-/**
-* A CSS-only stub, local to this file and NOT `loader.ts`'s `cssStub`: that
-* plugin marks *every* bare specifier external (right for evaluating a
-* section — it must resolve the workspace's real React and real kit
-* primitives, not a second copy), which is exactly wrong for measurement,
-* where an npm package's bundled weight is the entire point of the gate.
-* Only CSS is stubbed here; everything else is left to the `build()` call's
-* own `external` option (see `measureRendererBundle`) plus esbuild's default
-* bundling.
-*
-* Detects a CSS import by resolving the specifier and inspecting the
-* *resolved path's* extension — not by pattern-matching the specifier text.
-* A CSS-only package need not say so in its specifier (`@fontsource/inter`
-* has no `.css` suffix and no `css` path segment; `swiper/css` has no `.css`
-* suffix either), so only real resolution tells the two apart. `pluginData`
-* is the standard recursion guard for `build.resolve()` re-entering this same
-* hook (esbuild docs' own example for this pattern) — mirrors `loader.ts`'s
-* `cssStub`, which learned this the hard way.
-*/
-const sizeStub = {
-	name: "size-stub",
-	setup(b) {
-		b.onResolve({ filter: /.*/ }, async (args) => {
-			if (args.pluginData === RESOLVING) return null;
-			const resolved = await b.resolve(args.path, {
-				importer: args.importer,
-				namespace: args.namespace,
-				resolveDir: args.resolveDir,
-				kind: args.kind,
-				pluginData: RESOLVING
-			});
-			if (resolved.errors.length === 0 && resolved.path !== "" && resolved.path.endsWith(".css")) return {
-				path: resolved.path,
-				namespace: "size-stub"
-			};
-			return null;
-		});
-		b.onLoad({
-			filter: /.*/,
-			namespace: "size-stub"
-		}, () => ({
-			contents: "",
-			loader: "js"
-		}));
-	}
-};
-/**
-* Gzipped bytes of a section's renderer bundle, its own code *and every npm
-* package it imports* — the published bundle's actual shape. React alone is
-* excluded: it is a peer the platform supplies at render time, never bundled
-* into a section. Everything else, including `@homepages/template-kit`
-* itself (its primitives are ordinary React components that ship inside the
-* section bundle, not a peer), is bundled and counted — that is the entire
-* point of this budget. esbuilds `Renderer.tsx` alone (not the other three
-* contract files — schema, fill-spec and fixtures never reach the browser).
-*
-* `external` is deliberately the five React entry points a section can
-* actually reach, not `packages: "external"`: the latter would externalize
-* every bare specifier — including the icon library or schema library this
-* gate exists to catch — reproducing the exact bug this function fixes. Do
-* not "simplify" this back to `packages: "external"`.
-*
-* `platform: "browser"`, not `"neutral"`: `neutral` defaults `mainFields` to
-* `[]`, which cannot resolve a CommonJS-only package's `main` field — and
-* real sections import such packages (an icon library, for instance). With
-* `neutral` the measurement simply fails for those sections; `browser`'s
-* default `mainFields` resolves them.
-*/
-async function measureRendererBundle(workspaceRoot, section) {
-	const { build } = await loadEsbuild(workspaceRoot);
-	const js = (await build({
-		entryPoints: [join(section.dir, "Renderer.tsx")],
-		bundle: true,
-		minify: true,
-		format: "esm",
-		platform: "browser",
-		jsx: "automatic",
-		write: false,
-		outfile: "renderer.js",
-		external: [
-			"react",
-			"react-dom",
-			"react-dom/server",
-			"react/jsx-runtime",
-			"react/jsx-dev-runtime"
-		],
-		plugins: [sizeStub],
-		absWorkingDir: workspaceRoot,
-		logLevel: "silent"
-	})).outputFiles.find((f) => f.path.endsWith(".js"));
-	if (!js) throw new Error(`esbuild produced no JS output for ${section.dir}`);
-	return gzipSync(js.contents).byteLength;
-}
-/**
-* Gzipped bytes of a section's stylesheet: its hand-written CSS
-* (`sectionCssFiles`, published order) concatenated with the package CSS its
-* code pulls in (`compileSectionPackageCss`). A package's `url()`-referenced
-* fonts and icons no longer inline into this text — they resolve to
-* `/section-assets/` references (see css.ts), and their bytes are measured
-* separately by `measureAssetBytes`, the `size-assets` dimension below.
-*/
-async function measureSectionCss(workspaceRoot, section) {
-	const ownFiles = await sectionCssFiles(section.dir);
-	const own = (await Promise.all(ownFiles.map((f) => readFile(f, "utf8")))).join("\n");
-	const packageCss = await compileSectionPackageCss(workspaceRoot, section.dir);
-	return gzipSync(Buffer.from(`${own}\n${packageCss}`)).byteLength;
-}
-/**
-* Raw bytes of a section's static assets — the fourth size dimension. Fonts and
-* images are already compressed, so this is RAW bytes, not gzip. Two esbuild
-* passes with the file loader capture every asset the published section emits:
-*   1. Renderer.tsx (bundled) — assets imported in JS AND assets url()-referenced
-*      by the package CSS the renderer pulls in.
-*   2. each hand-written stylesheet — its @font-face / url() assets (the author's
-*      own styles.css is read raw by the CSS budget, never bundled, so its assets
-*      surface only here).
-* Deduped by emitted (content-hashed) filename, so an asset referenced twice or
-* from both a stylesheet and JS is counted once.
-*/
-async function measureAssetBytes(workspaceRoot, section) {
-	const { build } = await loadEsbuild(workspaceRoot);
-	const byName = /* @__PURE__ */ new Map();
-	const collect = (outputFiles) => {
-		for (const f of outputFiles) {
-			if (/\.(?:js|css|map)$/i.test(f.path)) continue;
-			byName.set(basename(f.path), f.contents.byteLength);
-		}
-	};
-	collect((await build({
-		entryPoints: [join(section.dir, "Renderer.tsx")],
-		bundle: true,
-		write: false,
-		format: "esm",
-		platform: "browser",
-		jsx: "automatic",
-		outdir: "dist",
-		external: [
-			"react",
-			"react-dom",
-			"react-dom/server",
-			"react/jsx-runtime",
-			"react/jsx-dev-runtime"
-		],
-		loader: { ...ASSET_LOADERS },
-		publicPath: "/section-assets",
-		assetNames: "[name]-[hash]",
-		absWorkingDir: workspaceRoot,
-		logLevel: "silent"
-	})).outputFiles ?? []);
-	for (const cssFile of await sectionCssFiles(section.dir)) collect((await build({
-		entryPoints: [cssFile],
-		bundle: true,
-		write: false,
-		outdir: "dist",
-		loader: {
-			".css": "css",
-			...ASSET_LOADERS
-		},
-		publicPath: "/section-assets",
-		assetNames: "[name]-[hash]",
-		absWorkingDir: workspaceRoot,
-		logLevel: "silent"
-	})).outputFiles ?? []);
-	return [...byName.values()].reduce((sum, n) => sum + n, 0);
-}
-/**
-* Gzipped bytes of a section's largest island (browser) bundle. Each "use client"
-* component is bundled as its own browser entry, React external (the runtime chunk
-* provides it), everything else bundled — the shape ci/static-assets.ts uploads.
-* Returns 0 for a section with no islands. Uses `sizeStub` (React-only external),
-* NOT the loader's cssStub — see the file header.
-*/
-async function measureIslandBundle(workspaceRoot, section) {
-	const islands = await findSectionIslands(section.dir);
-	if (islands.length === 0) return 0;
-	const { build } = await loadEsbuild(workspaceRoot);
-	let max = 0;
-	for (const entry of islands) {
-		const js = (await build({
-			entryPoints: [entry],
-			bundle: true,
-			minify: true,
-			format: "esm",
-			platform: "browser",
-			jsx: "automatic",
-			write: false,
-			outfile: "island.js",
-			external: [
-				"react",
-				"react-dom",
-				"react-dom/client",
-				"react/jsx-runtime",
-				"react/jsx-dev-runtime"
-			],
-			plugins: [sizeStub],
-			absWorkingDir: workspaceRoot,
-			logLevel: "silent"
-		})).outputFiles.find((f) => f.path.endsWith(".js"));
-		if (js) max = Math.max(max, gzipSync(js.contents).byteLength);
-	}
-	return max;
-}
-function kb(bytes) {
-	const value = bytes / 1024;
-	return `${Number.isInteger(value) ? value.toString() : value.toFixed(1)} KB`;
-}
-function cssDiagnosticFile(workspaceRoot, section) {
-	const stylesCss = join(section.dir, "styles.css");
-	return relative(workspaceRoot, existsSync(stylesCss) ? stylesCss : section.dir);
-}
-async function sizeStage(workspaceRoot, template) {
-	const diagnostics = [];
-	for (const section of template.sections) {
-		let rendererBytes;
-		let cssBytes;
-		let islandBytes;
-		let assetBytes;
-		try {
-			rendererBytes = await measureRendererBundle(workspaceRoot, section);
-			cssBytes = await measureSectionCss(workspaceRoot, section);
-			islandBytes = await measureIslandBundle(workspaceRoot, section);
-			assetBytes = await measureAssetBytes(workspaceRoot, section);
-		} catch {
-			continue;
-		}
-		if (rendererBytes > CHECK_CONFIG.size.rendererBundleGzip) diagnostics.push({
-			ruleId: "template-kit/size-renderer-bundle",
-			template: template.key,
-			section: section.name,
-			file: `templates/${template.key}/sections/${section.name}/Renderer.tsx`,
-			message: `renderer bundle is ${kb(rendererBytes)} gzip — over the ${kb(CHECK_CONFIG.size.rendererBundleGzip)} budget`,
-			fix: "Trim what the renderer pulls in. A whole icon library imported for two icons is the usual cause — import only the icons you use, or inline them as SVG."
-		});
-		if (cssBytes > CHECK_CONFIG.size.sectionCssGzip) diagnostics.push({
-			ruleId: "template-kit/size-section-css",
-			template: template.key,
-			section: section.name,
-			file: cssDiagnosticFile(workspaceRoot, section),
-			message: `section stylesheet is ${kb(cssBytes)} gzip — over the ${kb(CHECK_CONFIG.size.sectionCssGzip)} budget`,
-			fix: "Trim the stylesheet. Pulling in a package's full 'everything' CSS bundle when you use a few of its modules is the usual cause — import only the modules you use. (A url()-referenced font or icon set is measured separately, under size-assets.)"
-		});
-		if (islandBytes > CHECK_CONFIG.size.islandBundleGzip) diagnostics.push({
-			ruleId: "template-kit/size-island-bundle",
-			template: template.key,
-			section: section.name,
-			file: `templates/${template.key}/sections/${section.name}`,
-			message: `an island bundle is ${kb(islandBytes)} gzip — over the ${kb(CHECK_CONFIG.size.islandBundleGzip)} budget`,
-			fix: "Trim what the client component pulls in. A whole UI/icon library imported for one widget is the usual cause — import only what you use, or split the island."
-		});
-		if (assetBytes > CHECK_CONFIG.size.assets) diagnostics.push({
-			ruleId: "template-kit/size-assets",
-			template: template.key,
-			section: section.name,
-			file: `templates/${template.key}/sections/${section.name}`,
-			message: `static assets are ${kb(assetBytes)} — over the ${kb(CHECK_CONFIG.size.assets)} budget`,
-			fix: "Shrink or subset the asset (a full font family or an unoptimized image is the usual cause), or drop assets the section does not use."
-		});
-	}
-	return diagnostics;
-}
-
-//#endregion
-export { measureAssetBytes, measureIslandBundle, measureRendererBundle, measureSectionCss, sizeStage };

package/dist/cli/check/stages/tree.js

@@ -1,206 +0,0 @@
-import { ASSET_LOADERS, findImportLine, sectionCssFiles } from "../css.js";
-import { CONTRACT_FILES, loadSection } from "../loader.js";
-import { flattenLayout } from "../../../schema/rows.js";
-import { referencedSectionAssets } from "../section-assets.js";
-import { readFile, readdir } from "node:fs/promises";
-import { extname, join, relative } from "node:path";
-
-//#region src/cli/check/stages/tree.ts
-const ASSET_EXTENSIONS = new Set(Object.keys(ASSET_LOADERS));
-async function isBinaryFile(file) {
-	return (await readFile(file)).subarray(0, 4096).includes(0);
-}
-/** Every authored file in the bundle, recursive. `snapshots/` and `node_modules/` are skipped — generated or foreign, never authored. */
-async function bundleFiles(dir) {
-	const out = [];
-	for (const entry of await readdir(dir, { withFileTypes: true })) {
-		const full = join(dir, entry.name);
-		if (entry.isDirectory()) {
-			if (entry.name === "snapshots" || entry.name === "node_modules") continue;
-			out.push(...await bundleFiles(full));
-		} else if (entry.isFile()) out.push(full);
-	}
-	return out.sort();
-}
-/**
-* The bundle's authored JSX surface: every `.tsx` except tests. An author may
-* put markup anywhere in the folder (components/, hooks/, …), so the marker
-* rules scan all of these, not just Renderer.tsx. Tests are excluded
-* deliberately — a test's expected-markup assertion must not satisfy a slot
-* marker, and fixtures legitimately write raw markup.
-*/
-async function bundleJsxFiles(dir) {
-	return (await bundleFiles(dir)).filter((f) => f.endsWith(".tsx") && !/\.test\.tsx$/.test(f));
-}
-function escapeRegExp(s) {
-	return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-const CSS_REASON = /css-reason:/;
-function opensWithCssReason(text) {
-	const lead = text.match(/^\s*\/\*([\s\S]*?)\*\//);
-	return lead != null && CSS_REASON.test(lead[1] ?? "");
-}
-async function checkBundleAnatomy(workspaceRoot, template, section) {
-	const out = [];
-	const entries = await readdir(section.dir, { withFileTypes: true });
-	for (const f of CONTRACT_FILES) {
-		if (entries.some((entry) => entry.isFile() && entry.name === f)) continue;
-		out.push({
-			ruleId: "template-kit/bundle-incomplete",
-			template: template.key,
-			section: section.name,
-			file: relative(workspaceRoot, join(section.dir, f)),
-			line: 1,
-			message: `Section "${section.name}" is missing the required contract file \`${f}\`.`,
-			fix: "Every section needs Renderer.tsx, schema.ts, fill-spec.ts and fixtures.ts. Add the missing file."
-		});
-	}
-	return out;
-}
-/** A section-folder file that is an asset by extension or by a NUL-byte sniff. */
-async function sectionAssetFiles(dir) {
-	const out = [];
-	for (const abs of await bundleFiles(dir)) if (ASSET_EXTENSIONS.has(extname(abs).toLowerCase()) || await isBinaryFile(abs)) out.push(abs);
-	return out;
-}
-async function checkOrphanAssets(workspaceRoot, template, section) {
-	const candidates = await sectionAssetFiles(section.dir);
-	if (candidates.length === 0) return [];
-	let referenced;
-	try {
-		referenced = await referencedSectionAssets(workspaceRoot, section);
-	} catch {
-		return [];
-	}
-	const out = [];
-	for (const abs of candidates) {
-		if (referenced.has(abs)) continue;
-		const rel = relative(workspaceRoot, abs);
-		out.push({
-			ruleId: "template-kit/bundle-binary-asset",
-			template: template.key,
-			section: section.name,
-			file: rel,
-			line: 1,
-			message: `Static asset \`${rel}\` sits in the section folder but nothing references it.`,
-			fix: "Reference it (import it in Renderer.tsx, or url() it from the section's CSS), or delete it. An unreferenced binary bloats the section's content hash and is never served."
-		});
-	}
-	return out;
-}
-function asSchema(loaded) {
-	return typeof loaded.schema === "object" && loaded.schema !== null ? loaded.schema : {};
-}
-function checkSlotMarkers(workspaceRoot, template, section, loaded, jsxFiles) {
-	const slots = asSchema(loaded).slots ?? {};
-	const out = [];
-	const rendererFile = relative(workspaceRoot, join(section.dir, "Renderer.tsx"));
-	for (const [slot, spec] of Object.entries(slots)) {
-		if (spec.editable_by_user === false) continue;
-		const re = new RegExp(`(<Slot\\s+(?:[^>]*\\s+)?id|data-slot-id|slotId)\\s*=\\s*["']${escapeRegExp(slot)}["']`);
-		if (jsxFiles.some((f) => re.test(f.text))) continue;
-		out.push({
-			ruleId: "template-kit/missing-slot-marker",
-			template: template.key,
-			section: section.name,
-			file: rendererFile,
-			message: `Slot "${slot}" (editable_by_user: true) declared in schema.ts has no matching \`data-slot-id="${slot}"\` or \`slotId="${slot}"\` marker anywhere in the bundle.`,
-			fix: `Mark the slot in Renderer.tsx: <Slot id="${slot}">. The id must be a string literal.`
-		});
-	}
-	return out;
-}
-function checkSlotGroupMarkers(workspaceRoot, template, section, loaded, jsxFiles) {
-	const groups = asSchema(loaded).meta?.groups ?? [];
-	const out = [];
-	const rendererFile = relative(workspaceRoot, join(section.dir, "Renderer.tsx"));
-	for (const group of groups) {
-		if (flattenLayout(group.members).length < 2) continue;
-		const re = new RegExp(`<SlotGroup\\s+(?:[^>]*\\s+)?id\\s*=\\s*["']${escapeRegExp(group.id)}["']`);
-		if (jsxFiles.some((f) => re.test(f.text))) continue;
-		out.push({
-			ruleId: "template-kit/slot-group-marker",
-			template: template.key,
-			section: section.name,
-			file: rendererFile,
-			message: `Group "${group.id}" in schema.ts has no matching <SlotGroup id="${group.id}"> anywhere in the bundle.`,
-			fix: `Wrap the group's slots in <SlotGroup id="${group.id}"> so the editor can present them together.`
-		});
-	}
-	return out;
-}
-async function checkSectionCss(workspaceRoot, template, section) {
-	const out = [];
-	for (const cssFile of await sectionCssFiles(section.dir)) {
-		const rel = relative(workspaceRoot, cssFile);
-		const text = await readFile(cssFile, "utf8");
-		if (!opensWithCssReason(text)) out.push({
-			ruleId: "template-kit/css-reason",
-			template: template.key,
-			section: section.name,
-			file: rel,
-			line: 1,
-			message: `${rel} must open with a \`css-reason:\` comment justifying the hand-CSS.`,
-			fix: "Open the file with a comment saying why it exists: /* css-reason: … */"
-		});
-		for (const m of text.matchAll(/\/\*\s*unlayered:\s*([^*]*)\*\//g)) {
-			if ((m[1] ?? "").trim() !== "") continue;
-			out.push({
-				ruleId: "template-kit/unlayered-fence",
-				template: template.key,
-				section: section.name,
-				file: rel,
-				line: text.slice(0, m.index).split("\n").length,
-				message: `${rel}: an \`/* unlayered: */\` fence must state why it escapes the cascade layers.`,
-				fix: "Give the fence a reason (/* unlayered: … */) and close it with /* endunlayered */."
-			});
-		}
-		const opens = (text.match(/\/\*\s*unlayered:\s*[^*]*\*\//g) ?? []).length;
-		const closes = (text.match(/\/\*\s*endunlayered\s*\*\//g) ?? []).length;
-		if (opens !== closes) out.push({
-			ruleId: "template-kit/unlayered-fence",
-			template: template.key,
-			section: section.name,
-			file: rel,
-			line: 1,
-			message: `${rel}: each \`/* unlayered: <reason> */\` needs a matching \`/* endunlayered */\` (found ${String(opens)} open, ${String(closes)} close).`,
-			fix: "Give the fence a reason (/* unlayered: … */) and close it with /* endunlayered */."
-		});
-		const importLine = findImportLine(text);
-		if (importLine !== void 0) out.push({
-			ruleId: "template-kit/no-bare-css-import",
-			template: template.key,
-			section: section.name,
-			file: rel,
-			line: importLine,
-			message: `${rel}:${String(importLine)} — @import is not allowed in hand-CSS; the browser drops it silently and the rules never reach the page.`,
-			fix: "Import package CSS from the code that needs it: import \"swiper/css\" in Renderer.tsx, and the build routes it into this layer for you."
-		});
-	}
-	return out;
-}
-/** The tree-level rules for one template: every static, cross-file section-folder invariant ESLint cannot express. */
-async function treeStage(workspaceRoot, template) {
-	const diagnostics = [];
-	for (const section of template.sections) {
-		diagnostics.push(...await checkBundleAnatomy(workspaceRoot, template, section));
-		diagnostics.push(...await checkOrphanAssets(workspaceRoot, template, section));
-		let loaded;
-		try {
-			loaded = await loadSection(workspaceRoot, section);
-		} catch {
-			loaded = void 0;
-		}
-		const jsxPaths = await bundleJsxFiles(section.dir);
-		if (loaded !== void 0 && jsxPaths.length > 0) {
-			const jsxFiles = await Promise.all(jsxPaths.map(async (abs) => ({ text: await readFile(abs, "utf8") })));
-			diagnostics.push(...checkSlotMarkers(workspaceRoot, template, section, loaded, jsxFiles));
-			diagnostics.push(...checkSlotGroupMarkers(workspaceRoot, template, section, loaded, jsxFiles));
-		}
-		diagnostics.push(...await checkSectionCss(workspaceRoot, template, section));
-	}
-	return diagnostics;
-}
-
-//#endregion
-export { treeStage };

package/dist/cli/check/stages/typecheck.js

@@ -1,46 +0,0 @@
-import { resolveFromWorkspace } from "../resolve-tool.js";
-import { isUnder, sectionOf } from "../paths.js";
-import { relativizePaths } from "../relativize.js";
-import { join, relative } from "node:path";
-
-//#region src/cli/check/stages/typecheck.ts
-const CONFIG_FIX_HINT = "Fix tsconfig.json. It must extend the kit preset: \"extends\": \"@homepages/template-kit/tsconfig\".";
-async function typecheckStage(workspaceRoot, template) {
-	const ts = await resolveFromWorkspace(workspaceRoot, "typescript");
-	const configPath = join(workspaceRoot, "tsconfig.json");
-	const configFile = ts.readConfigFile(configPath, (file) => ts.sys.readFile(file));
-	if (configFile.error) throw new Error(`could not read ${configPath}: ${ts.flattenDiagnosticMessageText(configFile.error.messageText, " ")}`);
-	const parsed = ts.parseJsonConfigFileContent(configFile.config, ts.sys, workspaceRoot);
-	const out = [];
-	for (const configError of parsed.errors) out.push({
-		ruleId: "template-kit/typecheck",
-		template: template.key,
-		file: relative(workspaceRoot, configPath),
-		message: relativizePaths(ts.flattenDiagnosticMessageText(configError.messageText, " "), workspaceRoot),
-		fix: CONFIG_FIX_HINT
-	});
-	const program = ts.createProgram({
-		rootNames: parsed.fileNames,
-		options: parsed.options,
-		configFileParsingDiagnostics: parsed.errors
-	});
-	const tsDiagnostics = [...program.getSyntacticDiagnostics(), ...program.getSemanticDiagnostics()];
-	for (const diagnostic of tsDiagnostics) {
-		if (!diagnostic.file) continue;
-		const fileName = diagnostic.file.fileName;
-		if (!isUnder(template.dir, fileName)) continue;
-		out.push({
-			ruleId: "template-kit/typecheck",
-			template: template.key,
-			section: sectionOf(template, fileName),
-			file: relative(workspaceRoot, fileName),
-			line: diagnostic.start === void 0 ? void 0 : ts.getLineAndCharacterOfPosition(diagnostic.file, diagnostic.start).line + 1,
-			message: relativizePaths(ts.flattenDiagnosticMessageText(diagnostic.messageText, " "), workspaceRoot),
-			fix: "Fix the type error. Section props are derived from schema.ts — never hand-written."
-		});
-	}
-	return out;
-}
-
-//#endregion
-export { typecheckStage };

package/dist/cli/check/stages/validate/catalog-exhaustiveness.js

@@ -1,18 +0,0 @@
-import { SLOT_TYPES } from "../../../../contracts/slot-catalog.js";
-import { SlotDef } from "../../../../schema/slot-types.js";
-
-//#region src/cli/check/stages/validate/catalog-exhaustiveness.ts
-function assertCatalogExhaustiveness() {
-	const unionTypes = /* @__PURE__ */ new Set();
-	const union = SlotDef._def.getter?.() ?? SlotDef;
-	for (const option of union.options) {
-		const typeSchema = option.shape.type;
-		unionTypes.add(typeSchema.value);
-	}
-	const catalog = new Set(SLOT_TYPES);
-	for (const t of catalog) if (!unionTypes.has(t)) throw new Error(`slot-catalog SLOT_TYPES has "${t}" but section-schema SlotDef has no matching Zod variant.`);
-	for (const t of unionTypes) if (!catalog.has(t)) throw new Error(`section-schema SlotDef has a "${t}" variant not in slot-catalog SLOT_TYPES.`);
-}
-
-//#endregion
-export { assertCatalogExhaustiveness };

package/dist/cli/check/stages/validate/facts.js

@@ -1,19 +0,0 @@
-//#region src/cli/check/stages/validate/facts.ts
-const FACTS_ARRAY_FIELDS = /* @__PURE__ */ new Set([
-	"units",
-	"photos",
-	"videos",
-	"floor_plans",
-	"pois",
-	"contacts"
-]);
-const FACTS_READABLE = /* @__PURE__ */ new Set([
-	"extras",
-	"tours",
-	"floor_plans",
-	"photos",
-	"pois"
-]);
-
-//#endregion
-export { FACTS_ARRAY_FIELDS, FACTS_READABLE };

package/dist/cli/check/stages/validate/formatter-contract.js

@@ -1,14 +0,0 @@
-import { FORMATTER_NAMES } from "../../../../contracts/slot-catalog.js";
-
-//#region src/cli/check/stages/validate/formatter-contract.ts
-function assertFormatterContract(schema) {
-	for (const [name, slot] of Object.entries(schema.slots)) {
-		const fmt = slot.format;
-		if (fmt == null) continue;
-		const fn = typeof fmt === "string" ? fmt : fmt.fn;
-		if (typeof fn !== "string" || !FORMATTER_NAMES.includes(fn)) throw new Error(`${schema.key}.${name}: unknown formatter "${String(fn)}" (allowed: ${FORMATTER_NAMES.join(", ")})`);
-	}
-}
-
-//#endregion
-export { assertFormatterContract };

package/dist/cli/check/stages/validate/group-contract.js

@@ -1,21 +0,0 @@
-import { flattenLayout } from "../../../../schema/rows.js";
-
-//#region src/cli/check/stages/validate/group-contract.ts
-function assertGroupContract(schema, sectionKey) {
-	const groups = schema.groups;
-	if (!groups || groups.length === 0) return;
-	const seenIds = /* @__PURE__ */ new Set();
-	const seenSlots = /* @__PURE__ */ new Set();
-	for (const group of groups) {
-		if (seenIds.has(group.id)) throw new Error(`Section "${sectionKey}": duplicate group id "${group.id}".`);
-		seenIds.add(group.id);
-		for (const member of flattenLayout(group.members)) {
-			if (!(member in schema.slots)) throw new Error(`Section "${sectionKey}": group "${group.id}" names unknown slot "${member}".`);
-			if (seenSlots.has(member)) throw new Error(`Section "${sectionKey}": slot "${member}" appears in more than one group.`);
-			seenSlots.add(member);
-		}
-	}
-}
-
-//#endregion
-export { assertGroupContract };

package/dist/cli/check/stages/validate/index.js

@@ -1,66 +0,0 @@
-import { MissingContractFile, MissingSectionExport, loadSection } from "../../loader.js";
-import { relativizePaths } from "../../relativize.js";
-import { validateFixtureModule, validateOneSection, validateTemplateManifest } from "./orchestrator.js";
-import { join } from "node:path";
-import { existsSync } from "node:fs";
-
-//#region src/cli/check/stages/validate/index.ts
-async function validateStage(workspaceRoot, template) {
-	const diagnostics = [];
-	for (const section of template.sections) {
-		const sectionFile = (name) => `templates/${template.key}/sections/${section.name}/${name}`;
-		let loaded;
-		try {
-			loaded = await loadSection(workspaceRoot, section);
-		} catch (cause) {
-			if (cause instanceof MissingContractFile) continue;
-			diagnostics.push({
-				ruleId: "template-kit/schema-invalid",
-				template: template.key,
-				section: section.name,
-				file: cause instanceof MissingSectionExport ? cause.file : sectionFile("schema.ts"),
-				message: relativizePaths(cause instanceof Error ? cause.message : String(cause), workspaceRoot),
-				fix: "The section's contract files could not be loaded or parsed. Fix the error above."
-			});
-			continue;
-		}
-		for (const message of validateOneSection(section.name, loaded)) diagnostics.push({
-			ruleId: "template-kit/schema-invalid",
-			template: template.key,
-			section: section.name,
-			file: sectionFile("schema.ts"),
-			message,
-			fix: "Fix the schema, fill-spec or fixtures declaration this message names."
-		});
-		for (const message of validateFixtureModule(section.name, loaded)) diagnostics.push({
-			ruleId: "template-kit/fixtures-invalid",
-			template: template.key,
-			section: section.name,
-			file: sectionFile("fixtures.ts"),
-			message,
-			fix: "Fix the fixtures module: it must default-export { base: { slots: { … } } }, plus the optional option_matrix and states blocks."
-		});
-	}
-	if (!existsSync(join(template.dir, "manifest.json"))) {
-		diagnostics.push({
-			ruleId: "template-kit/manifest-invalid",
-			template: template.key,
-			file: `templates/${template.key}/manifest.json`,
-			line: 1,
-			message: `Template "${template.key}" has no manifest.json.`,
-			fix: "Add manifest.json to the template folder: a template needs one to declare its section composition — which sections it is built from, in what order."
-		});
-		return diagnostics;
-	}
-	for (const message of await validateTemplateManifest(workspaceRoot, template)) diagnostics.push({
-		ruleId: "template-kit/manifest-invalid",
-		template: template.key,
-		file: `templates/${template.key}/manifest.json`,
-		message,
-		fix: "Fix the manifest entry this message names."
-	});
-	return diagnostics;
-}
-
-//#endregion
-export { validateStage };