@homepages/template-kit 0.0.0

package/README.md

@@ -0,0 +1,76 @@
+# @homepages/template-kit
+
+The authoring surface for HomePages marketing-section templates: schema system,
+contract primitives, theme tokens, and the `template-kit` CLI.
+
+**Status: 0.0.x — package skeleton.** The authoring surface is still being
+extracted, and the CLI commands are not implemented yet. What exists today is
+the published package boundary and its hygiene gates.
+
+## Install
+
+```bash
+npm install @homepages/template-kit react react-dom
+```
+
+React 19 is a **peer dependency** — the kit never bundles its own copy.
+
+## Exports
+
+| Entry | Use |
+|---|---|
+| `@homepages/template-kit` | Authoring API (schema, primitives) |
+| `@homepages/template-kit/styles.css` | Tailwind v4 theme tokens + kit source registration |
+| `@homepages/template-kit/eslint` | ESLint flat-config preset |
+| `@homepages/template-kit/tsconfig` | tsconfig preset (`"extends"`) |
+
+The CSS entry does **not** import Tailwind. Import it *after* Tailwind in your entry:
+
+```css
+@import "tailwindcss";
+@import "@homepages/template-kit/styles.css";
+```
+
+Two `@import "tailwindcss"` in one graph double-emits preflight.
+
+## Development
+
+```bash
+npm install
+npm run check     # typecheck + lint + test + build + publint + attw + consumer gate
+```
+
+`npm run verify:consumer` is the boundary gate: it packs the kit, installs the
+tarball into a scratch project, and asserts that types resolve, that Tailwind's
+cross-package `@source` scan reaches the shipped `dist`, and that only one React
+ends up in the tree. Run it before every release.
+
+## Releasing
+
+Versioning and changelogs go through [changesets](https://github.com/changesets/changesets).
+Publishing runs from CI via npm **trusted publishing (OIDC)** — there is no npm
+token anywhere, and adding one would silently disable OIDC.
+
+1. **Describe your change** on the feature branch:
+   ```bash
+   npm run changeset
+   ```
+   Pick the bump (patch / minor / major) and write a human-readable summary —
+   it becomes the changelog entry that template authors read. Commit the
+   generated file in `.changeset/`.
+
+2. **Merge to `main`.** The release workflow opens (or updates) a
+   **"Version Packages"** PR that consumes the changeset files, bumps
+   `package.json`, and writes `CHANGELOG.md`.
+
+3. **Merge the Version Packages PR.** That merge publishes to npm.
+
+Semver contract: the platform vocabulary (slot types, sources, transforms,
+tokens) is closed and versioned. A breaking change to it is a **major**; a new
+optional capability is a **minor**.
+
+### Bumping the version by hand
+
+Don't. `KIT_VERSION` in `src/index.ts` is asserted against `package.json` by the
+test suite, and changesets owns `package.json`'s version — so a hand-bump fails
+CI. Update `KIT_VERSION` only in the Version Packages PR, alongside the bump.

package/dist/cli.d.ts

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

package/dist/cli.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+import { t as KIT_VERSION } from "./src-CrdHXijV.js";
+
+//#region src/cli/index.ts
+/**
+* Commands the CLI will grow, declared now so they exit 1 with a real message
+* instead of "unknown command". Deliberately carries no issue IDs: this text is
+* 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",
+	"check",
+	"pack",
+	"link",
+	"unlink",
+	"status"
+]);
+const USAGE = `template-kit ${KIT_VERSION}
+
+Usage: template-kit <command>
+
+Commands:
+  dev       Local preview server                 (not implemented yet)
+  check     Typecheck, lint, and validate        (not implemented yet)
+  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)
+
+Options:
+  -v, --version   Print the kit version
+  -h, --help      Print this message
+`;
+function main(argv) {
+	const cmd = argv[0];
+	if (cmd === "--version" || cmd === "-v") {
+		process.stdout.write(`${KIT_VERSION}\n`);
+		return 0;
+	}
+	if (cmd === void 0 || cmd === "--help" || cmd === "-h") {
+		process.stdout.write(USAGE);
+		return 0;
+	}
+	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;
+	}
+	process.stderr.write(`template-kit: unknown command '${cmd}'\n\n${USAGE}`);
+	return 1;
+}
+process.exit(main(process.argv.slice(2)));
+
+//#endregion

package/dist/eslint.d.ts

@@ -0,0 +1,10 @@
+import { Linter } from "eslint";
+//#region src/eslint.d.ts
+/**
+ * The HomePages template-authoring ESLint preset.
+ * Rules arrive with the surface they govern (schema, primitives, determinism bans).
+ * Shipped now, empty, so a workspace's flat config can reference it from 0.0.x.
+ */
+declare const templateKitConfig: Linter.Config[];
+//#endregion
+export { templateKitConfig as default, templateKitConfig };

package/dist/eslint.js

@@ -0,0 +1,13 @@
+//#region src/eslint.ts
+/**
+* The HomePages template-authoring ESLint preset.
+* Rules arrive with the surface they govern (schema, primitives, determinism bans).
+* Shipped now, empty, so a workspace's flat config can reference it from 0.0.x.
+*/
+const templateKitConfig = [{
+	name: "@homepages/template-kit/base",
+	rules: {}
+}];
+
+//#endregion
+export { templateKitConfig as default, templateKitConfig };

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+//#region src/kit-smoke.d.ts
+/**
+ * Boundary probe, not authoring surface. Its only job is to make the package
+ * boundary testable: React stays a peer, types resolve, and Tailwind's
+ * cross-package @source scan reaches this file's compiled output.
+ * Removed when the real contract primitives land.
+ */
+declare function KitSmoke({ label }: {
+  label: string;
+}): import("react").JSX.Element;
+//#endregion
+//#region src/index.d.ts
+/** The published version of this kit. Kept in sync with package.json by src/index.test.tsx. */
+declare const KIT_VERSION = "0.0.0";
+//#endregion
+export { KIT_VERSION, KitSmoke };

package/dist/index.js

@@ -0,0 +1,3 @@
+import { n as KitSmoke, t as KIT_VERSION } from "./src-CrdHXijV.js";
+
+export { KIT_VERSION, KitSmoke };

package/dist/src-CrdHXijV.js

@@ -0,0 +1,23 @@
+import { jsx } from "react/jsx-runtime";
+
+//#region src/kit-smoke.tsx
+/**
+* Boundary probe, not authoring surface. Its only job is to make the package
+* boundary testable: React stays a peer, types resolve, and Tailwind's
+* cross-package @source scan reaches this file's compiled output.
+* Removed when the real contract primitives land.
+*/
+function KitSmoke({ label }) {
+	return /* @__PURE__ */ jsx("span", {
+		className: "bg-kit-smoke uppercase tracking-[0.4275em]",
+		children: label
+	});
+}
+
+//#endregion
+//#region src/index.ts
+/** The published version of this kit. Kept in sync with package.json by src/index.test.tsx. */
+const KIT_VERSION = "0.0.0";
+
+//#endregion
+export { KitSmoke as n, KIT_VERSION as t };

package/dist/styles.css

@@ -0,0 +1,16 @@
+/*
+ * @homepages/template-kit — theme tokens + kit source registration.
+ *
+ * Consumers import this AFTER `@import "tailwindcss";` in their own entry.
+ * This file must NOT import Tailwind itself: two imports in one graph
+ * double-emit preflight.
+ *
+ * The @source below is resolved relative to THIS FILE'S SHIPPED LOCATION
+ * (dist/styles.css), registering the kit's compiled JS for class scanning.
+ * It also overrides Tailwind's default node_modules exclusion.
+ */
+@source "./**/*.js";
+
+@theme {
+  --color-kit-smoke: oklch(0.55 0.2 275);
+}

package/docs/INDEX.md

@@ -0,0 +1,19 @@
+---
+purpose: Router for the docs corpus that ships inside the @homepages/template-kit npm package.
+status: living
+related: []
+updated: 2026-07-13
+---
+# template-kit docs — router
+
+This tree **ships in the npm tarball** (`docs/` is listed in `package.json`'s
+`files`), so it is written for an outside audience: template authors and their
+LLM agents, reading it from inside `node_modules`. Keep it free of internal-only
+detail.
+
+Cross-service contracts, product, and data model live in `../../docs/` (umbrella)
+and are not shipped.
+
+| Doc | What it covers | Read when you're touching... |
+|---|---|---|
+| `llms.txt` | Machine-readable index of this corpus for an agent working inside an installed kit | orienting an agent in a consuming workspace |

package/docs/llms.txt

@@ -0,0 +1,13 @@
+# @homepages/template-kit
+
+> The authoring kit for HomePages marketing-section templates. This corpus ships
+> inside the npm package so an agent can read it locally, versioned in lockstep
+> with the code it describes.
+
+Status: 0.0.x package skeleton. The authoring corpus (task recipes, rule-id
+reference, vocabulary) arrives with the surface it documents: the schema system,
+the contract primitives and theme tokens, and the `check` command's rule-ids.
+
+## Docs
+
+- [README](../README.md): install, exports, and the release flow.

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@homepages/template-kit",
+  "version": "0.0.0",
+  "description": "Authoring kit for HomePages marketing-section templates: schema system, contract primitives, theme tokens, and the template-kit CLI.",
+  "license": "UNLICENSED",
+  "type": "module",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/falktravis/template-kit.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "docs",
+    "tsconfig.json"
+  ],
+  "bin": {
+    "template-kit": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./eslint": {
+      "types": "./dist/eslint.d.ts",
+      "default": "./dist/eslint.js"
+    },
+    "./styles.css": "./dist/styles.css",
+    "./tsconfig": "./tsconfig.json",
+    "./package.json": "./package.json"
+  },
+  "sideEffects": [
+    "*.css"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "test": "node --import tsx --test src/*.test.tsx src/cli/*.test.ts",
+    "lint:pkg": "publint --strict && attw --pack . --profile esm-only --exclude-entrypoints styles.css",
+    "verify:consumer": "node scripts/verify-consumer.mjs",
+    "check": "npm run typecheck && npm run lint && npm run build && npm run test && npm run lint:pkg && npm run verify:consumer",
+    "changeset": "changeset",
+    "release": "changeset publish"
+  },
+  "peerDependencies": {
+    "eslint": "^9.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "eslint": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.5",
+    "@changesets/cli": "^2.29.8",
+    "@eslint/js": "^9.39.4",
+    "@tailwindcss/cli": "^4.3.0",
+    "@types/node": "^20.17.10",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "eslint": "^9.39.4",
+    "publint": "^0.3.21",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tailwindcss": "^4.3.0",
+    "tsdown": "0.22.7",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.60.1"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2022", "DOM"],
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "isolatedModules": true,
+    "resolveJsonModule": true,
+    "forceConsistentCasingInFileNames": true,
+    "noEmit": true
+  },
+  "exclude": ["node_modules", "dist"]
+}