@homepages/template-kit 0.3.0 → 0.4.1

package/dist/cli/new/scaffold/template/theme.css

@@ -0,0 +1,24 @@
+/* Generated by `template-kit theme` from theme.ts — do not edit.
+   Re-run `template-kit theme` after changing theme.ts. */
+@theme inline {
+  --color-accent: var(--tr-color-accent);
+  --color-background: var(--tr-color-background);
+  --color-ink: var(--tr-color-ink);
+  --font-body: var(--tr-font-body);
+  --text-base: var(--tr-text-base);
+}
+
+:root {
+  --tr-color-accent: #2f6df6;
+  --tr-color-background: #ffffff;
+  --tr-color-ink: #1a1d21;
+  --tr-font-body: system-ui, -apple-system, sans-serif;
+  --tr-text-base: 1rem;
+}
+
+body {
+  font-family: var(--tr-font-body);
+  color: var(--tr-color-ink);
+  background: var(--tr-color-background);
+  font-size: var(--tr-text-base);
+}

package/dist/cli/new/scaffold/template/theme.ts

@@ -0,0 +1,27 @@
+import type { TokenTheme } from "@homepages/template-kit";
+
+// A template's design tokens. `template-kit theme` compiles this to theme.css;
+// `template-kit dev` reads it directly. The `document` refs must name declared
+// tokens (color/background → colors, font → fonts, fontSize → type).
+export const theme: TokenTheme = {
+  colors: {
+    ink: "#1a1d21",
+    background: "#ffffff",
+    accent: "#2f6df6",
+  },
+  fonts: {
+    body: "system-ui, -apple-system, sans-serif",
+  },
+  type: {
+    base: "1rem",
+  },
+  radii: {},
+  shadows: {},
+  layout: {},
+  document: {
+    font: "body",
+    color: "ink",
+    background: "background",
+    fontSize: "base",
+  },
+};

package/dist/cli/new/scaffold-assets.js

@@ -0,0 +1,20 @@
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+//#region src/cli/new/scaffold-assets.ts
+const here = dirname(fileURLToPath(import.meta.url));
+function assetsRoot() {
+	const dist = join(here, "scaffold");
+	if (existsSync(dist)) return dist;
+	return join(here, "..", "..", "..", "create-homepages-workspace", "scaffold");
+}
+function templateAssetsDir() {
+	return join(assetsRoot(), "template");
+}
+function sectionAssetsDir() {
+	return join(assetsRoot(), "section");
+}
+
+//#endregion
+export { sectionAssetsDir, templateAssetsDir };

package/dist/cli/pack/collect.js

@@ -0,0 +1,44 @@
+import { join, relative, sep } from "node:path";
+import { createHash } from "node:crypto";
+import { readFile, readdir } from "node:fs/promises";
+
+//#region src/cli/pack/collect.ts
+const toPosix = (p) => p.split(sep).join("/");
+async function walk(dir, out) {
+	for (const entry of await readdir(dir, { withFileTypes: true })) if (entry.isDirectory()) {
+		if (entry.name === "node_modules") continue;
+		await walk(join(dir, entry.name), out);
+	} else if (entry.isFile()) out.push(join(dir, entry.name));
+}
+/**
+* Reads a template's regular files into sorted, hashable entries.
+*
+* Only real files and directories are walked: `node_modules` is skipped at any
+* depth, and symlinks are omitted (a `Dirent` is neither `isFile()` nor
+* `isDirectory()`), so a symlinked source file will not appear in the pack.
+* Templates are authored as plain trees, so this is a non-issue in practice —
+* but a submission that relies on a symlinked file would pack without it.
+*/
+async function collectTemplateFiles(workspaceRoot, templateDir) {
+	const absPaths = [];
+	await walk(templateDir, absPaths);
+	const files = await Promise.all(absPaths.map(async (abs) => ({
+		archivePath: toPosix(relative(workspaceRoot, abs)),
+		templatePath: toPosix(relative(templateDir, abs)),
+		bytes: await readFile(abs)
+	})));
+	files.sort((a, b) => a.archivePath < b.archivePath ? -1 : a.archivePath > b.archivePath ? 1 : 0);
+	return files;
+}
+function contentHash(files) {
+	const ordered = [...files].sort((a, b) => a.templatePath < b.templatePath ? -1 : a.templatePath > b.templatePath ? 1 : 0);
+	const top = createHash("sha256");
+	for (const file of ordered) {
+		const inner = createHash("sha256").update(file.bytes).digest("hex");
+		top.update(file.templatePath).update("\0").update(inner).update("\n");
+	}
+	return `sha256:${top.digest("hex")}`;
+}
+
+//#endregion
+export { collectTemplateFiles, contentHash };

package/dist/cli/pack/guards.js

@@ -0,0 +1,57 @@
+import { readLinkMarker } from "../link/overlay.js";
+import { z } from "zod";
+import { join } from "node:path";
+import { readFile, stat } from "node:fs/promises";
+
+//#region src/cli/pack/guards.ts
+const depsSchema = z.object({
+	dependencies: z.record(z.string(), z.string()).optional(),
+	devDependencies: z.record(z.string(), z.string()).optional(),
+	optionalDependencies: z.record(z.string(), z.string()).optional()
+}).passthrough();
+async function isFile(p) {
+	try {
+		return (await stat(p)).isFile();
+	} catch {
+		return false;
+	}
+}
+function localProtocolDeps(pkg) {
+	const offenders = [];
+	for (const block of [
+		pkg.dependencies,
+		pkg.devDependencies,
+		pkg.optionalDependencies
+	]) for (const [name, spec] of Object.entries(block ?? {})) if (spec.startsWith("file:") || spec.startsWith("link:")) offenders.push(`${name} (${spec})`);
+	return offenders;
+}
+async function preflightGuards(workspaceRoot) {
+	const refusals = [];
+	if (await readLinkMarker(workspaceRoot) !== void 0) refusals.push({
+		reason: "a linked kit overlay is active in this workspace.",
+		fix: "Run `template-kit unlink` to restore the published kit, then pack."
+	});
+	if (!await isFile(join(workspaceRoot, "package-lock.json"))) refusals.push({
+		reason: "missing lockfile (package-lock.json) at workspace root.",
+		fix: "Run npm install and commit the lockfile — a submission without one cannot be reproduced."
+	});
+	let pkgJson;
+	try {
+		pkgJson = JSON.parse(await readFile(join(workspaceRoot, "package.json"), "utf8"));
+	} catch {
+		refusals.push({
+			reason: "package.json at the workspace root is missing or not valid JSON.",
+			fix: "Ensure the workspace root has a well-formed package.json before packing."
+		});
+		return refusals;
+	}
+	const parsed = depsSchema.safeParse(pkgJson);
+	if (parsed.success) for (const dep of localProtocolDeps(parsed.data)) refusals.push({
+		reason: `dependency ${dep} uses a local file:/link: protocol.`,
+		fix: "Depend on published versions only — a submission must install from the registry."
+	});
+	return refusals;
+}
+
+//#endregion
+export { preflightGuards };

package/dist/cli/pack/index.js

@@ -0,0 +1,66 @@
+import { findWorkspaceRoot, selectTemplates, templateFromCwd } from "../check/workspace.js";
+import { runCheck } from "../check/index.js";
+import { collectTemplateFiles, contentHash } from "./collect.js";
+import { preflightGuards } from "./guards.js";
+import { buildPackManifest } from "./manifest.js";
+import { buildZip } from "./zip.js";
+import { join } from "node:path";
+import { parseArgs } from "node:util";
+import { readFile, writeFile } from "node:fs/promises";
+
+//#region src/cli/pack/index.ts
+function refusal(lines) {
+	return {
+		code: 1,
+		output: `template-kit pack: cannot pack.\n${lines.join("\n")}\n`
+	};
+}
+async function runPack(argv, cwd) {
+	const { positionals } = parseArgs({
+		args: argv,
+		allowPositionals: true
+	});
+	const root = await findWorkspaceRoot(cwd);
+	const template = (await selectTemplates(root, positionals[0] ?? templateFromCwd(root, cwd), false, "pack"))[0];
+	if (template === void 0) return refusal(["  this workspace has no template to pack: templates/ holds no template folder."]);
+	const preflight = await preflightGuards(root);
+	if (preflight.length > 0) return refusal(preflight.map((r) => `  ${r.reason}\n    fix: ${r.fix}`));
+	const { code: checkCode, output: checkOut } = await runCheck([template.key], cwd);
+	if (checkCode !== 0) return {
+		code: 1,
+		output: `template-kit pack: \`check\` must pass before packing.\n\n${checkOut}`
+	};
+	const files = await collectTemplateFiles(root, template.dir);
+	const hash = contentHash(files);
+	const manifest = buildPackManifest({
+		template: template.key,
+		contentHash: hash,
+		packedAt: (/* @__PURE__ */ new Date()).toISOString()
+	});
+	const entries = [
+		{
+			path: "pack-manifest.json",
+			bytes: Buffer.from(`${JSON.stringify(manifest, null, 2)}\n`, "utf8")
+		},
+		{
+			path: "package.json",
+			bytes: await readFile(join(root, "package.json"))
+		},
+		{
+			path: "package-lock.json",
+			bytes: await readFile(join(root, "package-lock.json"))
+		},
+		...files.map((f) => ({
+			path: f.archivePath,
+			bytes: f.bytes
+		}))
+	];
+	await writeFile(join(root, `${template.key}.zip`), buildZip(entries));
+	return {
+		code: 0,
+		output: `template-kit pack\n  wrote ${template.key}.zip\n  ${hash}\n  kit ${manifest.kitVersion}`
+	};
+}
+
+//#endregion
+export { runPack };

package/dist/cli/pack/manifest.js

@@ -0,0 +1,15 @@
+import { KIT_VERSION } from "../../index.js";
+
+//#region src/cli/pack/manifest.ts
+function buildPackManifest(input) {
+	return {
+		kitVersion: KIT_VERSION,
+		template: input.template,
+		contentHash: input.contentHash,
+		packedAt: input.packedAt,
+		check: { ok: true }
+	};
+}
+
+//#endregion
+export { buildPackManifest };

package/dist/cli/pack/zip.js

@@ -0,0 +1,86 @@
+import { deflateRawSync } from "node:zlib";
+
+//#region src/cli/pack/zip.ts
+const DOS_DATE = 33;
+const DOS_TIME = 0;
+const CRC_TABLE = (() => {
+	const table = /* @__PURE__ */ new Uint32Array(256);
+	for (let n = 0; n < 256; n++) {
+		let c = n;
+		for (let k = 0; k < 8; k++) c = (c & 1) !== 0 ? 3988292384 ^ c >>> 1 : c >>> 1;
+		table[n] = c >>> 0;
+	}
+	return table;
+})();
+function crc32(bytes) {
+	let c = 4294967295;
+	for (const byte of bytes) c = CRC_TABLE[(c ^ byte) & 255] ^ c >>> 8;
+	return (c ^ 4294967295) >>> 0;
+}
+/** A standard DEFLATE zip built from `entries`, in order. No zip64 — pack inputs
+* are source files, far under the 4 GiB per-entry limit. */
+function buildZip(entries) {
+	const locals = [];
+	const centrals = [];
+	let offset = 0;
+	for (const entry of entries) {
+		const name = Buffer.from(entry.path, "utf8");
+		const source = Buffer.from(entry.bytes);
+		const crc = crc32(source);
+		const compressed = deflateRawSync(source);
+		const local = Buffer.alloc(30 + name.length);
+		local.writeUInt32LE(67324752, 0);
+		local.writeUInt16LE(20, 4);
+		local.writeUInt16LE(2048, 6);
+		local.writeUInt16LE(8, 8);
+		local.writeUInt16LE(DOS_TIME, 10);
+		local.writeUInt16LE(DOS_DATE, 12);
+		local.writeUInt32LE(crc, 14);
+		local.writeUInt32LE(compressed.length, 18);
+		local.writeUInt32LE(source.length, 22);
+		local.writeUInt16LE(name.length, 26);
+		local.writeUInt16LE(0, 28);
+		name.copy(local, 30);
+		locals.push(local, compressed);
+		const central = Buffer.alloc(46 + name.length);
+		central.writeUInt32LE(33639248, 0);
+		central.writeUInt16LE(788, 4);
+		central.writeUInt16LE(20, 6);
+		central.writeUInt16LE(2048, 8);
+		central.writeUInt16LE(8, 10);
+		central.writeUInt16LE(DOS_TIME, 12);
+		central.writeUInt16LE(DOS_DATE, 14);
+		central.writeUInt32LE(crc, 16);
+		central.writeUInt32LE(compressed.length, 20);
+		central.writeUInt32LE(source.length, 24);
+		central.writeUInt16LE(name.length, 28);
+		central.writeUInt16LE(0, 30);
+		central.writeUInt16LE(0, 32);
+		central.writeUInt16LE(0, 34);
+		central.writeUInt16LE(0, 36);
+		central.writeUInt32LE(33188 << 16 >>> 0, 38);
+		central.writeUInt32LE(offset, 42);
+		name.copy(central, 46);
+		centrals.push(central);
+		offset += local.length + compressed.length;
+	}
+	const localData = Buffer.concat(locals);
+	const centralDir = Buffer.concat(centrals);
+	const eocd = Buffer.alloc(22);
+	eocd.writeUInt32LE(101010256, 0);
+	eocd.writeUInt16LE(0, 4);
+	eocd.writeUInt16LE(0, 6);
+	eocd.writeUInt16LE(entries.length, 8);
+	eocd.writeUInt16LE(entries.length, 10);
+	eocd.writeUInt32LE(centralDir.length, 12);
+	eocd.writeUInt32LE(localData.length, 16);
+	eocd.writeUInt16LE(0, 20);
+	return Buffer.concat([
+		localData,
+		centralDir,
+		eocd
+	]);
+}
+
+//#endregion
+export { buildZip };

package/dist/cli.js

@@ -1,6 +1,11 @@
 #!/usr/bin/env node
 import { KIT_VERSION } from "./index.js";
 import { runCheck } from "./cli/check/index.js";
+import { runDev } from "./cli/dev/index.js";
+import { rebuildOverlay, runLinkOnce, runStatus, runUnlink } from "./cli/link/index.js";
+import { watchAndRebuild } from "./cli/link/watch.js";
+import { runNew, runNewSection } from "./cli/new/index.js";
+import { runPack } from "./cli/pack/index.js";
 import { runTheme } from "./cli/theme/index.js";
 
 //#region src/cli/index.ts
@@ -10,25 +15,21 @@ import { runTheme } from "./cli/theme/index.js";
 * printed to template authors outside HomePages. The command → issue map is in
 * CLAUDE.md, which does not ship in the tarball.
 */
-const NOT_IMPLEMENTED = /* @__PURE__ */ new Set([
-	"dev",
-	"pack",
-	"link",
-	"unlink",
-	"status"
-]);
+const NOT_IMPLEMENTED = /* @__PURE__ */ new Set();
 const USAGE = `template-kit ${KIT_VERSION}
 
 Usage: template-kit <command>
 
 Commands:
-  dev       Local preview server                 (not implemented yet)
-  check     Typecheck, lint, and validate a template
-  theme     Generate a template's theme CSS from its theme.ts
-  pack      Build the submission artifact        (not implemented yet)
-  link      Overlay a local kit build            (not implemented yet)
-  unlink    Remove the overlay                   (not implemented yet)
-  status    Show overlay state                   (not implemented yet)
+  dev          Start the local preview server
+  check        Typecheck, lint, and validate a template
+  new          Add a template to the workspace
+  new-section  Add a section to a template
+  theme        Generate a template's theme CSS from its theme.ts
+  pack         Build a template's submission zip
+  link         Overlay a local kit build into a consumer (kit devs)
+  unlink       Restore the registry install              (kit devs)
+  status       Show overlay state                        (kit devs)
 
 Options:
   -v, --version   Print the kit version
@@ -52,6 +53,12 @@ async function main(argv) {
 		process.stderr.write(`template-kit check: ${cause instanceof Error ? cause.message : String(cause)}\n`);
 		return 1;
 	}
+	if (cmd === "dev") try {
+		return await runDev(argv.slice(1), process.cwd());
+	} catch (cause) {
+		process.stderr.write(`template-kit dev: ${cause instanceof Error ? cause.message : String(cause)}\n`);
+		return 1;
+	}
 	if (cmd === "theme") try {
 		const { code, output } = await runTheme(argv.slice(1), process.cwd());
 		process.stdout.write(output.endsWith("\n") ? output : `${output}\n`);
@@ -60,6 +67,65 @@ async function main(argv) {
 		process.stderr.write(`template-kit theme: ${cause instanceof Error ? cause.message : String(cause)}\n`);
 		return 1;
 	}
+	if (cmd === "pack") try {
+		const { code, output } = await runPack(argv.slice(1), process.cwd());
+		process.stdout.write(output.endsWith("\n") ? output : `${output}\n`);
+		return code;
+	} catch (cause) {
+		process.stderr.write(`template-kit pack: ${cause instanceof Error ? cause.message : String(cause)}\n`);
+		return 1;
+	}
+	if (cmd === "status" || cmd === "unlink") {
+		const run = cmd === "status" ? runStatus : runUnlink;
+		try {
+			const { code, output } = await run(argv.slice(1), process.cwd());
+			process.stdout.write(output.endsWith("\n") ? output : `${output}\n`);
+			return code;
+		} catch (cause) {
+			process.stderr.write(`template-kit ${cmd}: ${cause instanceof Error ? cause.message : String(cause)}\n`);
+			return 1;
+		}
+	}
+	if (cmd === "link") try {
+		const result = await runLinkOnce(argv.slice(1), process.cwd());
+		process.stdout.write(`${result.output}\n`);
+		const { kitSrcDir, kitRoot, workspaceRoot } = result.watch;
+		process.stdout.write("  watching for kit changes — Ctrl-C to stop\n");
+		let watchFailed = false;
+		await new Promise((resolvePromise) => {
+			const stop = watchAndRebuild(kitSrcDir, () => {
+				rebuildOverlay(kitRoot, workspaceRoot).then(() => process.stdout.write("  rebuilt + recopied\n"), (err) => process.stderr.write(`  rebuild failed: ${err instanceof Error ? err.message : String(err)}\n`));
+			}, (err) => {
+				watchFailed = true;
+				process.stderr.write(`  watch error — stopping: ${err instanceof Error ? err.message : String(err)}\n`);
+				resolvePromise();
+			});
+			process.on("SIGINT", () => {
+				stop();
+				resolvePromise();
+			});
+		});
+		return watchFailed ? 1 : 0;
+	} catch (cause) {
+		process.stderr.write(`template-kit link: ${cause instanceof Error ? cause.message : String(cause)}\n`);
+		return 1;
+	}
+	if (cmd === "new") try {
+		const { code, output } = await runNew(argv.slice(1), process.cwd());
+		process.stdout.write(output.endsWith("\n") ? output : `${output}\n`);
+		return code;
+	} catch (cause) {
+		process.stderr.write(`template-kit new: ${cause instanceof Error ? cause.message : String(cause)}\n`);
+		return 1;
+	}
+	if (cmd === "new-section") try {
+		const { code, output } = await runNewSection(argv.slice(1), process.cwd());
+		process.stdout.write(output.endsWith("\n") ? output : `${output}\n`);
+		return code;
+	} catch (cause) {
+		process.stderr.write(`template-kit new-section: ${cause instanceof Error ? cause.message : String(cause)}\n`);
+		return 1;
+	}
 	if (NOT_IMPLEMENTED.has(cmd)) {
 		process.stderr.write(`template-kit ${cmd}: not implemented yet.\nThis 0.0.x release ships the package skeleton only.\n`);
 		return 1;

package/dist/dev-client/assets/index-DfEfrp6P.css

@@ -0,0 +1 @@
+*{box-sizing:border-box}html,body,#root{margin:0;padding:0;height:100%;background:#0f1115;color:#e6e7eb;font:14px/1.5 ui-sans-serif,system-ui,-apple-system,Segoe UI,Helvetica,Arial,sans-serif}a{color:inherit;text-decoration:none}button,select,input,textarea{font:inherit;color:inherit;background:#1a1d24;border:1px solid #2c313a;border-radius:4px;padding:6px 10px}button{cursor:pointer}button:hover{background:#232831}button:disabled{opacity:.4;cursor:default}.empty{padding:40px;color:#9ca0a8;text-align:center}.boot-error{padding:24px;color:#ff8b8b;font:13px/1.5 ui-monospace,Menlo,monospace;white-space:pre-wrap}.canvas-mirror{display:flex;flex-direction:column;height:100%;min-height:0}.canvas-toolbar{display:flex;gap:8px;padding:6px 10px;border-bottom:1px solid #e2e5ea;background:#fafbfc}.canvas-toolbar button{font:12px system-ui,sans-serif;padding:3px 8px;border:1px solid #cbd2dc;border-radius:5px;background:#fff;cursor:pointer}.canvas-iframe{flex:1 1 auto;width:100%;border:0;background:#fff;min-height:0}.home{max-width:880px;margin:0 auto;padding:40px 24px}.home-header{margin-bottom:28px}.home-title{font-size:15px;font-weight:600}.home-tagline{font-size:13px;color:#9ca0a8;margin-top:4px}.home-template{display:inline-flex;align-items:center;gap:8px;font-size:12px;color:#9ca0a8;margin-bottom:24px}.home-template select{min-width:160px}.home-tools{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:16px}.tool-card{display:flex;flex-direction:column;gap:12px;background:#14171c;border:1px solid #21252d;border-radius:8px;padding:20px}.tool-card h2{font-size:14px;font-weight:600;margin:0}.tool-card p{font-size:13px;color:#9ca0a8;margin:0;line-height:1.5}.tool-card .controls{display:flex;flex-direction:column;gap:8px}.tool-card label{display:flex;align-items:center;justify-content:space-between;gap:8px;font-size:12px;color:#9ca0a8}.tool-card label select{min-width:140px}.open-btn{margin-top:auto;text-align:center;padding:8px 12px;border:1px solid #2c313a;border-radius:6px;background:#1a1d24;color:inherit;cursor:pointer}.open-btn:hover{background:#232831}.open-btn:disabled{opacity:.4;cursor:default}.home-hint{font-size:12px;color:#6b7280}.home-link{font-weight:600;color:#1a1d24}.canvas-toolbar .spacer{flex:1}.canvas-mirror__stage{display:flex;min-height:0;flex:1}.canvas-mirror__stage .canvas-iframe{flex:1}.instance-panel{width:340px;flex:none;overflow-y:auto;border-left:1px solid #e5e7eb;padding:12px;background:#fff;font:13px system-ui,sans-serif;display:flex;flex-direction:column;gap:10px}.instance-panel__head{display:flex;flex-direction:column;gap:8px}.instance-panel__slot{display:flex;align-items:center;gap:8px}.instance-panel__type{color:#6b7280}.instance-panel__fill{margin-left:auto;padding:1px 7px;border-radius:999px;font-size:11px}.instance-panel__fill--filled{background:#dcfce7;color:#166534}.instance-panel__fill--empty{background:#f3f4f6;color:#6b7280}.instance-panel__fill--missing{background:#fee2e2;color:#991b1b}.instance-panel__fixture{display:flex;flex-direction:column;gap:3px;color:#6b7280}.instance-panel__json{width:100%;min-height:180px;font:12px ui-monospace,monospace;resize:vertical}.instance-panel__error{color:#b91c1c;white-space:pre-wrap}.instance-panel__actions{display:flex;gap:8px}.instance-panel__note{color:#9ca3af;font-size:11px}