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

package/dist/cli/dev/build-css.js

@@ -1,97 +0,0 @@
-import { compileThemeToCss } from "../../design-system/theme.js";
-import { loadEsbuild } from "../check/resolve-tool.js";
-import { ASSET_LOADERS, ASSET_NAMES, ASSET_PUBLIC_PATH, sectionCssFiles } from "../check/css.js";
-import { runTailwind } from "./tailwind.js";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { basename, join, relative } from "node:path";
-
-//#region src/cli/dev/build-css.ts
-/**
-* The Tailwind entry owns `@import "tailwindcss"` exactly once; `source(none)`
-* disables auto content-detection so only the enumerated section @sources are
-* scanned; the kit's styles.css brings the token preamble and opts its own
-* primitives back in. Every path is emitted relative to `entryDir` (where the
-* entry is written) so it resolves from that location.
-*/
-function buildTailwindEntry(entryDir, sectionDirs, themePartialPath) {
-	const rel = (target) => {
-		const path = relative(entryDir, target);
-		return path.startsWith(".") ? path : `./${path}`;
-	};
-	return [
-		`@import "tailwindcss" source(none);`,
-		`@import "@homepages/template-kit/styles.css";`,
-		`@import "${rel(themePartialPath)}";`,
-		...sectionDirs.map((d) => `@source "${rel(d)}/**/*.tsx";`),
-		""
-	].join("\n");
-}
-async function compileUtilities(root, theme, sectionDirs) {
-	const cacheDir = join(root, ".tk-dev-cache");
-	await mkdir(cacheDir, { recursive: true });
-	const input = join(cacheDir, "tw-entry.css");
-	const themePath = join(cacheDir, "tw-theme.css");
-	const output = join(cacheDir, "tw-out.css");
-	await writeFile(themePath, compileThemeToCss({
-		...theme,
-		fontFaces: void 0
-	}), "utf8");
-	await writeFile(input, buildTailwindEntry(cacheDir, sectionDirs, themePath), "utf8");
-	await runTailwind(root, {
-		input,
-		output
-	});
-	return readFile(output, "utf8");
-}
-/**
-* Bundle every section's hand-written CSS through esbuild's `file` loader, so
-* each `url()` asset ref is rewritten to `/section-assets/<name>-<hash>.<ext>`
-* (production's form) and the referenced bytes are captured. CSS files are
-* concatenated in `sectionCssFiles` order (styles.css first). Assets are keyed
-* by emitted filename, which is content-hashed — so the same asset referenced
-* from two sections dedupes to one entry.
-*/
-async function compileSectionHandCss(root, sectionDirs) {
-	const { build } = await loadEsbuild(root);
-	const assets = /* @__PURE__ */ new Map();
-	const parts = [];
-	for (const dir of sectionDirs) for (const cssFile of await sectionCssFiles(dir)) {
-		const result = await build({
-			entryPoints: [cssFile],
-			bundle: true,
-			write: false,
-			outdir: "dist",
-			loader: {
-				".css": "css",
-				...ASSET_LOADERS
-			},
-			publicPath: ASSET_PUBLIC_PATH,
-			assetNames: ASSET_NAMES,
-			absWorkingDir: root,
-			logLevel: "silent"
-		});
-		for (const file of result.outputFiles ?? []) if (file.path.endsWith(".css")) parts.push(file.text);
-		else assets.set(basename(file.path), file.contents);
-	}
-	return {
-		css: parts.join("\n"),
-		assets
-	};
-}
-/** theme :root/@theme custom props, the compiled Tailwind utilities, then each
-* section's hand-CSS with its `url()` asset refs rewritten to servable paths. */
-async function assembleTemplateCss(root, theme, sectionDirs) {
-	const utilities = await compileUtilities(root, theme, sectionDirs);
-	const sections = await compileSectionHandCss(root, sectionDirs);
-	return {
-		css: [
-			theme.fontFaces,
-			utilities,
-			sections.css
-		].filter(Boolean).join("\n"),
-		assets: sections.assets
-	};
-}
-
-//#endregion
-export { assembleTemplateCss, buildTailwindEntry };

package/dist/cli/dev/catalog.js

@@ -1,35 +0,0 @@
-import { VERIFICATION_WIDTHS } from "../../design-system/breakpoints.js";
-import { loadSectionBundle } from "../../ssr.js";
-import { discoverSections } from "./discover.js";
-import { join } from "node:path";
-
-//#region src/cli/dev/catalog.ts
-async function buildCatalog(vite, workspace) {
-	const load = (dir, file) => vite.ssrLoadModule(join(dir, file));
-	const templates = [];
-	for (const template of workspace.templates) {
-		const sections = [];
-		for (const section of await discoverSections(template.dir)) try {
-			const { invariantFixtures } = await loadSectionBundle(section.dir, load);
-			sections.push({
-				key: section.name,
-				fixtures: invariantFixtures.map((f) => ({
-					id: f.id,
-					label: f.label
-				}))
-			});
-		} catch {}
-		templates.push({
-			key: template.key,
-			sections
-		});
-	}
-	return {
-		templates,
-		breakpoints: [...VERIFICATION_WIDTHS],
-		defaultTemplate: workspace.cwdTemplate
-	};
-}
-
-//#endregion
-export { buildCatalog };

package/dist/cli/dev/compose-template.js

@@ -1,39 +0,0 @@
-import { ATTR_SECTION_INSTANCE_ID } from "../../contracts/markers.js";
-import { buildSectionIslandMap } from "./island-map.js";
-import { resolveManifestInstances } from "./manifest-instances.js";
-import { renderSection } from "./render-section.js";
-import { wrapSectionHtml } from "./section-page.js";
-
-//#region src/cli/dev/compose-template.ts
-function escapeAttr(value) {
-	return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-}
-function wrapInstance(instanceId, label, html) {
-	return `<div ${ATTR_SECTION_INSTANCE_ID}="${escapeAttr(instanceId)}" data-section-label="${escapeAttr(label)}">${html}</div>`;
-}
-async function composeTemplatePage(vite, args) {
-	const { workspace, template, islandBootstrapUrl, canvasIslandBootstrapUrl, canvas = false } = args;
-	const instances = await resolveManifestInstances(template);
-	const bodies = [];
-	const islands = {};
-	for (const inst of instances) {
-		const { html } = await renderSection(vite, {
-			sectionDir: inst.sectionDir,
-			fixture: inst.fixture,
-			override: Object.keys(inst.options).length > 0 ? { options: inst.options } : void 0
-		});
-		bodies.push(canvas ? wrapInstance(inst.instanceId, inst.section, html) : html);
-		Object.assign(islands, await buildSectionIslandMap(workspace.root, workspace.templatesDir, inst.sectionDir));
-	}
-	return wrapSectionHtml({
-		sectionHtml: bodies.join("\n"),
-		cssRev: "0",
-		template: template.key,
-		section: "",
-		islands,
-		bootstrapUrl: canvas ? canvasIslandBootstrapUrl : islandBootstrapUrl
-	});
-}
-
-//#endregion
-export { composeTemplatePage };

package/dist/cli/dev/content-override.js

@@ -1,58 +0,0 @@
-import { z } from "zod";
-
-//#region src/cli/dev/content-override.ts
-const MAX_URL_OVERRIDE_BYTES = 16 * 1024;
-const ContentOverrideSchema = z.object({
-	slots: z.record(z.string(), z.unknown()).optional(),
-	options: z.record(z.string(), z.unknown()).optional(),
-	nav: z.object({
-		selfAnchor: z.string().optional(),
-		anchors: z.record(z.string(), z.unknown()).optional()
-	}).strict().optional(),
-	variants: z.record(z.string(), z.string()).optional()
-}).strict();
-function isPlainObject(v) {
-	return typeof v === "object" && v !== null && !Array.isArray(v);
-}
-/**
-* Merge `patch` onto `base`: plain objects recurse key-by-key; anything else
-* (scalar, array, or `null`) replaces. Keys absent from `patch` keep the `base`
-* value. Pure — never mutates its inputs.
-*/
-function deepMerge(base, patch) {
-	if (!isPlainObject(base) || !isPlainObject(patch)) return patch;
-	const out = { ...base };
-	for (const [k, v] of Object.entries(patch)) out[k] = k in base ? deepMerge(base[k], v) : v;
-	return out;
-}
-/** Deep-merge an override onto resolved props. `undefined` returns `base` as-is. */
-function applyContentOverride(base, override) {
-	if (!override) return base;
-	return {
-		slots: deepMerge(base.slots, override.slots ?? {}),
-		options: deepMerge(base.options, override.options ?? {}),
-		nav: deepMerge(base.nav, override.nav ?? {}),
-		variants: deepMerge(base.variants, override.variants ?? {})
-	};
-}
-/** Validate untrusted input into a `ContentOverride`. `undefined`/absent → `undefined`. */
-function parseContentOverride(input) {
-	if (input === void 0 || input === null) return void 0;
-	return ContentOverrideSchema.parse(input);
-}
-/** Decode a base64 `?overrides=` URL param, enforce the URL ceiling, and validate. */
-function decodeUrlOverride(raw) {
-	if (!raw) return void 0;
-	const text = Buffer.from(raw, "base64").toString("utf8");
-	if (Buffer.byteLength(text, "utf8") > 16384) throw new Error(`overrides payload exceeds ${MAX_URL_OVERRIDE_BYTES} bytes`);
-	let json;
-	try {
-		json = JSON.parse(text);
-	} catch (err) {
-		throw new Error(`invalid overrides payload: ${err instanceof Error ? err.message : String(err)}`);
-	}
-	return parseContentOverride(json);
-}
-
-//#endregion
-export { MAX_URL_OVERRIDE_BYTES, applyContentOverride, decodeUrlOverride, deepMerge, parseContentOverride };

package/dist/cli/dev/diagnostics.js

@@ -1,68 +0,0 @@
-import { promisify } from "node:util";
-import { execFile } from "node:child_process";
-
-//#region src/cli/dev/diagnostics.ts
-const exec = promisify(execFile);
-const MAX_BUFFER = 1024 * 1024;
-const TIMEOUT_MS = 15e3;
-async function runDiagnostics(cmd, args) {
-	if (cmd === null) return { available: false };
-	const parts = cmd.trim().split(/\s+/);
-	const program = parts[0];
-	if (!program) return { available: false };
-	const baseArgs = parts.slice(1);
-	let stdout;
-	try {
-		stdout = (await exec(program, [
-			...baseArgs,
-			"--template",
-			args.template,
-			"--section",
-			args.section
-		], {
-			maxBuffer: MAX_BUFFER,
-			timeout: TIMEOUT_MS
-		})).stdout;
-	} catch (err) {
-		return {
-			available: true,
-			error: err instanceof Error ? err.message : String(err)
-		};
-	}
-	return parseViolations(stdout);
-}
-function parseViolations(stdout) {
-	let parsed;
-	try {
-		parsed = JSON.parse(stdout);
-	} catch {
-		return {
-			available: true,
-			error: `diagnostics command did not print valid JSON: ${stdout.slice(0, 200)}`
-		};
-	}
-	const body = parsed;
-	if (typeof parsed !== "object" || parsed === null || !Array.isArray(body.violations)) return {
-		available: true,
-		error: `diagnostics command JSON is missing a "violations" array`
-	};
-	const violations = [];
-	for (const raw of body.violations) {
-		if (typeof raw !== "object" || raw === null) continue;
-		const v = raw;
-		if (typeof v.rule !== "string" || typeof v.message !== "string") continue;
-		violations.push({
-			rule: v.rule,
-			message: v.message,
-			...typeof v.file === "string" ? { file: v.file } : {},
-			...typeof v.line === "number" ? { line: v.line } : {}
-		});
-	}
-	return {
-		available: true,
-		violations
-	};
-}
-
-//#endregion
-export { runDiagnostics };

package/dist/cli/dev/discover.js

@@ -1,35 +0,0 @@
-import { readdir } from "node:fs/promises";
-import { join } from "node:path";
-import { existsSync } from "node:fs";
-
-//#region src/cli/dev/discover.ts
-const REQUIRED_SECTION_FILES = [
-	"Renderer.tsx",
-	"schema.ts",
-	"fill-spec.ts",
-	"fixtures.ts"
-];
-/**
-* Every subdirectory of `<templateDir>/sections` that carries all four contract
-* files, sorted by name. A folder missing any of the four is not a section and
-* is skipped (not an error — it may be a work in progress).
-*/
-async function discoverSections(templateDir) {
-	const sectionsDir = join(templateDir, "sections");
-	if (!existsSync(sectionsDir)) return [];
-	const entries = await readdir(sectionsDir, { withFileTypes: true });
-	const out = [];
-	for (const entry of entries) {
-		if (!entry.isDirectory()) continue;
-		const dir = join(sectionsDir, entry.name);
-		if (REQUIRED_SECTION_FILES.every((file) => existsSync(join(dir, file)))) out.push({
-			name: entry.name,
-			dir
-		});
-	}
-	out.sort((a, b) => a.name.localeCompare(b.name));
-	return out;
-}
-
-//#endregion
-export { REQUIRED_SECTION_FILES, discoverSections };

package/dist/cli/dev/fill-state.js

@@ -1,77 +0,0 @@
-//#region src/cli/dev/fill-state.ts
-const LIST_TYPES = /* @__PURE__ */ new Set([
-	"list",
-	"poi_list",
-	"image_collection",
-	"video_collection",
-	"object_list"
-]);
-const ASSET_TYPES = /* @__PURE__ */ new Set(["image", "video"]);
-/** Whether a resolved slot value carries real content for its type. */
-function slotHasContent(value, type) {
-	if (value === null || value === void 0) return false;
-	if (LIST_TYPES.has(type)) return Array.isArray(value) && value.length > 0;
-	if (ASSET_TYPES.has(type)) return typeof value === "object" && Boolean(value.url);
-	if (typeof value === "string") return value.trim().length > 0;
-	return true;
-}
-/** Every `data-slot-id` in the rendered tree. */
-function collectRenderedSlotIds(root) {
-	const ids = /* @__PURE__ */ new Set();
-	const walk = (node) => {
-		if (node.slotId) ids.add(node.slotId);
-		node.children.forEach(walk);
-	};
-	walk(root);
-	return ids;
-}
-/**
-* Best-effort line number (1-based) of each `<slotId>:` declaration inside the
-* `slots:` block of a section's schema.ts source. A slot not located is omitted.
-*/
-function schemaSlotLines(source, slotIds) {
-	const lines = source.split("\n");
-	const slotsAt = lines.findIndex((l) => /(^|\s)slots\s*:/.test(l));
-	const out = {};
-	if (slotsAt < 0) return out;
-	for (const id of slotIds) {
-		const re = new RegExp(`^\\s*${id}\\s*:`);
-		const idx = lines.findIndex((l, i) => i > slotsAt && re.test(l));
-		if (idx >= 0) out[id] = idx + 1;
-	}
-	return out;
-}
-function truncate(s, n = 80) {
-	return s.length > n ? s.slice(0, n) + "…" : s;
-}
-function valuePreview(value, type) {
-	if (LIST_TYPES.has(type)) return Array.isArray(value) ? `[${value.length} items]` : void 0;
-	if (ASSET_TYPES.has(type)) {
-		const url = value?.url;
-		return url ? `${type}:${truncate(url)}` : void 0;
-	}
-	if (typeof value === "string") return truncate(value);
-	if (typeof value === "number" || typeof value === "boolean") return String(value);
-}
-function computeSlotFills(args) {
-	const { declaredSlots, resolvedSlots, renderedSlotIds, slotLines } = args;
-	return Object.entries(declaredSlots).map(([id, def]) => {
-		const required = def.required ?? false;
-		const has = slotHasContent(resolvedSlots[id], def.type);
-		const fillState = has ? "filled" : required ? "missing" : "empty";
-		const preview = has ? valuePreview(resolvedSlots[id], def.type) : void 0;
-		const line = slotLines[id];
-		return {
-			id,
-			type: def.type,
-			required,
-			fillState,
-			rendered: renderedSlotIds.has(id),
-			...preview !== void 0 ? { value: preview } : {},
-			at: line ? `schema.ts:${line}` : "schema.ts"
-		};
-	});
-}
-
-//#endregion
-export { collectRenderedSlotIds, computeSlotFills, schemaSlotLines, slotHasContent };

package/dist/cli/dev/index.js

@@ -1,42 +0,0 @@
-import { startDevServer } from "./server.js";
-
-//#region src/cli/dev/index.ts
-const DEFAULT_PORT = 5180;
-async function runDev(argv, cwd) {
-	const port = parsePort(argv) ?? DEFAULT_PORT;
-	const diagnosticsCmd = parseDiagnosticsCmd(argv);
-	const server = await startDevServer({
-		cwd,
-		port,
-		diagnosticsCmd
-	});
-	process.stdout.write(`template-kit dev — ${server.workspace.templates.length} template(s) at ${server.url}\n`);
-	for (const template of server.workspace.templates) process.stdout.write(`  ${template.key}: ${server.url}/sections/${template.key}/<section>/<fixture>\n`);
-	if (diagnosticsCmd) process.stdout.write(`  diagnostics: ${diagnosticsCmd}\n`);
-	await new Promise((resolve) => {
-		const stop = () => {
-			server.close().then(resolve);
-		};
-		process.once("SIGINT", stop);
-		process.once("SIGTERM", stop);
-	});
-	return 0;
-}
-function parsePort(argv) {
-	const i = argv.indexOf("--port");
-	if (i >= 0) {
-		const raw = argv[i + 1];
-		const n = raw !== void 0 ? Number(raw) : NaN;
-		if (Number.isInteger(n) && n > 0) return n;
-	}
-	return null;
-}
-function parseDiagnosticsCmd(argv) {
-	const i = argv.indexOf("--diagnostics-cmd");
-	if (i < 0) return null;
-	const value = argv[i + 1];
-	return typeof value === "string" ? value : null;
-}
-
-//#endregion
-export { parseDiagnosticsCmd, runDev };

package/dist/cli/dev/inspect.js

@@ -1,38 +0,0 @@
-import { renderSection } from "./render-section.js";
-import { collectRenderedSlotIds, computeSlotFills, schemaSlotLines } from "./fill-state.js";
-import { summarizeHtml } from "./structure-summary.js";
-import { readFile } from "node:fs/promises";
-import { join } from "node:path";
-
-//#region src/cli/dev/inspect.ts
-async function inspectSection(vite, args) {
-	const result = await renderSection(vite, {
-		sectionDir: args.sectionDir,
-		fixture: args.fixture,
-		override: args.override
-	});
-	const { tree, text } = summarizeHtml(result.html);
-	const schemaSource = await readFile(join(args.sectionDir, "schema.ts"), "utf8");
-	const slots = computeSlotFills({
-		declaredSlots: result.schemaSlots,
-		resolvedSlots: result.resolvedProps.slots,
-		renderedSlotIds: collectRenderedSlotIds(tree),
-		slotLines: schemaSlotLines(schemaSource, Object.keys(result.schemaSlots))
-	});
-	return {
-		target: {
-			template: args.template,
-			section: args.section,
-			fixture: args.fixture,
-			schemaFile: `sections/${args.section}/schema.ts`
-		},
-		slots,
-		options: result.resolvedProps.options,
-		variants: result.resolvedProps.variants,
-		nullCorpus: result.nullCorpus,
-		...args.withOutline ? { outline: text } : {}
-	};
-}
-
-//#endregion
-export { inspectSection };

package/dist/cli/dev/island-bootstrap.js

@@ -1,38 +0,0 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import { join } from "node:path";
-
-//#region src/cli/dev/island-bootstrap.ts
-const CACHE_DIR = ".tk-dev-cache";
-const BOOTSTRAP_FILE = "island-bootstrap.js";
-const BOOTSTRAP_SOURCE = `import { hydrateIslands } from "@homepages/template-kit/island-runtime";
-
-const modules = import.meta.glob("/templates/**/*.{tsx,jsx}");
-const map = window.__TR_ISLAND_MAP || {};
-
-hydrateIslands({
-  load: (key) => {
-    const url = map[key];
-    const importer = url ? modules[url] : undefined;
-    if (!importer) return Promise.reject(new Error("template-kit dev: no island module for " + key));
-    return importer();
-  },
-  onError: (error, ctx) => {
-    console.error("template-kit dev: island failed to hydrate:", ctx.key, error);
-  },
-});
-`;
-/**
-* Write the shared bootstrap into the workspace cache dir and return the URL the
-* page loads it from. It lives under the root so Vite serves + transforms it (the
-* bare `island-runtime` import and the glob), reached via Vite's `/@fs/` prefix.
-*/
-async function writeIslandBootstrap(root) {
-	const dir = join(root, CACHE_DIR);
-	await mkdir(dir, { recursive: true });
-	const abs = join(dir, BOOTSTRAP_FILE);
-	await writeFile(abs, BOOTSTRAP_SOURCE, "utf8");
-	return `/@fs/${abs}`;
-}
-
-//#endregion
-export { writeIslandBootstrap };