@vitrine-kit/vitrine 0.3.1 → 0.4.0

package/dist/index.js

@@ -121,25 +121,36 @@ function loadProject(root) {
 }
 
 // src/registry.ts
-import { existsSync as existsSync4 } from "fs";
-import { dirname as dirname3, join as join4, resolve as resolve4 } from "path";
+import { existsSync as existsSync5 } from "fs";
+import { dirname as dirname4, join as join5, resolve as resolve4 } from "path";
 import { featureManifestSchema } from "@vitrine-kit/contracts";
 
+// src/bundled-kit.ts
+import { existsSync as existsSync3 } from "fs";
+import { dirname as dirname3, join as join3 } from "path";
+import { fileURLToPath } from "url";
+function bundledKitRoot() {
+  const distDir = dirname3(fileURLToPath(import.meta.url));
+  const candidate = join3(distDir, "..", "kit");
+  if (existsSync3(join3(candidate, "registry", "_index.json"))) return candidate;
+  return null;
+}
+
 // src/cache.ts
-import { cpSync, existsSync as existsSync3, rmSync } from "fs";
-import { join as join3, resolve as resolve3 } from "path";
+import { cpSync, existsSync as existsSync4, rmSync } from "fs";
+import { join as join4, resolve as resolve3 } from "path";
 function vitrineHome() {
   if (process.env.VITRINE_HOME) return resolve3(process.env.VITRINE_HOME);
   const home = process.env.USERPROFILE ?? process.env.HOME;
   if (!home) throw new Error("[vitrine] could not determine the home directory (HOME/USERPROFILE)");
-  return join3(home, ".vitrine");
+  return join4(home, ".vitrine");
 }
 function cachePaths(home = vitrineHome()) {
   return {
     root: home,
-    registry: join3(home, "registry"),
-    templates: join3(home, "templates"),
-    meta: join3(home, "kit.json")
+    registry: join4(home, "registry"),
+    templates: join4(home, "templates"),
+    meta: join4(home, "kit.json")
   };
 }
 function readKitMeta(home = vitrineHome()) {
@@ -151,7 +162,7 @@ function writeKitMeta(home, meta) {
 `);
 }
 function readIndex(registryRoot) {
-  const file = join3(registryRoot, "_index.json");
+  const file = join4(registryRoot, "_index.json");
   return exists(file) ? readJson(file) : null;
 }
 function computeChangelog(oldIndex, newIndex) {
@@ -180,16 +191,16 @@ function formatChangelog(entries) {
 }
 function populateCache(fromDir, opts = {}) {
   const home = opts.home ?? vitrineHome();
-  const srcRegistry = join3(fromDir, "registry");
-  const srcTemplates = join3(fromDir, "templates");
-  if (!existsSync3(join3(srcRegistry, "_index.json"))) {
+  const srcRegistry = join4(fromDir, "registry");
+  const srcTemplates = join4(fromDir, "templates");
+  if (!existsSync4(join4(srcRegistry, "_index.json"))) {
     throw new Error(`[vitrine] "${fromDir}" has no registry/_index.json \u2014 not a kit tree`);
   }
   const paths = cachePaths(home);
   const oldIndex = readIndex(paths.registry);
   rmSync(paths.registry, { recursive: true, force: true });
   cpSync(srcRegistry, paths.registry, { recursive: true });
-  if (existsSync3(srcTemplates)) {
+  if (existsSync4(srcTemplates)) {
     rmSync(paths.templates, { recursive: true, force: true });
     cpSync(srcTemplates, paths.templates, { recursive: true });
   }
@@ -207,9 +218,9 @@ function populateCache(fromDir, opts = {}) {
 function findUpRegistry(start) {
   let dir = resolve4(start);
   for (; ; ) {
-    const candidate = join4(dir, "registry");
-    if (existsSync4(join4(candidate, "_index.json"))) return candidate;
-    const parent = dirname3(dir);
+    const candidate = join5(dir, "registry");
+    if (existsSync5(join5(candidate, "_index.json"))) return candidate;
+    const parent = dirname4(dir);
     if (parent === dir) return null;
     dir = parent;
   }
@@ -224,60 +235,62 @@ function resolveRegistryRoot(explicit) {
     home = null;
   }
   if (home) {
-    const cache = join4(home, "registry");
-    if (existsSync4(join4(cache, "_index.json"))) return cache;
+    const cache = join5(home, "registry");
+    if (existsSync5(join5(cache, "_index.json"))) return cache;
   }
   const dev = findUpRegistry(process.cwd());
   if (dev) return dev;
+  const bundled = bundledKitRoot();
+  if (bundled) return join5(bundled, "registry");
   throw new Error('[vitrine] registry not found. Run "vitrine kit update" or pass --registry.');
 }
 function createRegistrySource(explicitRoot) {
   const root = resolveRegistryRoot(explicitRoot);
   const cache = /* @__PURE__ */ new Map();
-  const featureDir = (name) => join4(root, name);
-  const hasFeature = (name) => existsSync4(join4(featureDir(name), "feature.json"));
+  const featureDir = (name) => join5(root, name);
+  const hasFeature = (name) => existsSync5(join5(featureDir(name), "feature.json"));
   const loadManifest = (name) => {
     const cached = cache.get(name);
     if (cached) return cached;
-    const file = join4(featureDir(name), "feature.json");
-    if (!existsSync4(file)) throw new Error(`[vitrine] feature "${name}" not found in the registry`);
+    const file = join5(featureDir(name), "feature.json");
+    if (!existsSync5(file)) throw new Error(`[vitrine] feature "${name}" not found in the registry`);
     const manifest = featureManifestSchema.parse(JSON.parse(readText(file)));
     cache.set(name, manifest);
     return manifest;
   };
   const listFeatures2 = () => {
-    const index = JSON.parse(readText(join4(root, "_index.json")));
+    const index = JSON.parse(readText(join5(root, "_index.json")));
     return Object.keys(index.features ?? {});
   };
   return { root, featureDir, hasFeature, loadManifest, listFeatures: listFeatures2 };
 }
 
 // src/install.ts
-import { join as join6 } from "path";
+import { join as join7 } from "path";
 
 // src/transaction.ts
-import { existsSync as existsSync5, mkdirSync as mkdirSync2, readFileSync as readFileSync2, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "fs";
-import { dirname as dirname4 } from "path";
+import { existsSync as existsSync6, mkdirSync as mkdirSync2, readFileSync as readFileSync2, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "fs";
+import { dirname as dirname5 } from "path";
 var FsTransaction = class {
   backups = [];
   snapshot(path) {
     if (this.backups.some((b) => b.path === path)) return;
-    if (existsSync5(path)) this.backups.push({ path, existed: true, prev: readFileSync2(path, "utf8") });
+    if (existsSync6(path)) this.backups.push({ path, existed: true, prev: readFileSync2(path, "utf8") });
     else this.backups.push({ path, existed: false });
   }
   write(path, content) {
     this.snapshot(path);
-    mkdirSync2(dirname4(path), { recursive: true });
+    mkdirSync2(dirname5(path), { recursive: true });
     writeFileSync2(path, content, "utf8");
   }
   remove(path) {
     this.snapshot(path);
-    if (existsSync5(path)) rmSync2(path);
+    if (existsSync6(path)) rmSync2(path);
   }
   rollback() {
     for (const b of [...this.backups].reverse()) {
       if (b.existed) writeFileSync2(b.path, b.prev, "utf8");
-      else if (existsSync5(b.path)) rmSync2(b.path);
+      else if (existsSync6(b.path)) rmSync2(b.path);
     }
     this.backups = [];
   }
@@ -340,9 +353,11 @@ function renderSlotsFile(features) {
   const calls = withSlots.map((f) => `  register${pascalCase(f.name)}Slots();`);
   return [
     "// vitrine:generated \u2014 slot registration for installed features. Do not edit by hand.",
+    "import { slotRegistry } from '@vitrine-kit/core';",
     ...imports,
     "",
     "export function registerSlots(): void {",
+    "  slotRegistry.clear();",
     ...calls.length ? calls : ["  // no slot features"],
     "}",
     ""
@@ -357,9 +372,11 @@ function renderPaymentsFile(features) {
   const calls = withPayment.map((f) => `  register${pascalCase(f.name)}Provider();`);
   return [
     "// vitrine:generated \u2014 payment-provider registration for installed features. Do not edit by hand.",
+    "import { payments } from '@vitrine-kit/core';",
     ...imports,
     "",
     "export function registerPayments(): void {",
+    "  payments.clear();",
     ...calls.length ? calls : ["  // no payment features"],
     "}",
     ""
@@ -448,14 +465,14 @@ function renderNeutralTheme() {
 }
 
 // src/feature-files.ts
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 function* eachFeatureFile(featDir, map) {
-  const src = join5(featDir, map.from);
+  const src = join6(featDir, map.from);
   if (!exists(src)) return;
   const rels = isDir(src) ? walkRelFiles(src) : [""];
   for (const rel of rels) {
-    const srcAbs = rel ? join5(src, rel) : src;
-    const repoRel = rel ? join5(map.to, rel) : map.to;
+    const srcAbs = rel ? join6(src, rel) : src;
+    const repoRel = rel ? join6(map.to, rel) : map.to;
     yield { srcAbs, repoRel, toRel: toPosix(repoRel) };
   }
 }
@@ -491,9 +508,9 @@ function validate(name, manifest, project) {
 }
 function copyFeatureFiles(project, name, manifest, registry, tx) {
   const featDir = registry.featureDir(name);
-  const originalsBase = join6(projectPaths(project.root).originals, `${name}@${manifest.kitVersion}`);
+  const originalsBase = join7(projectPaths(project.root).originals, `${name}@${manifest.kitVersion}`);
   for (const map of manifest.files) {
-    if (!exists(join6(featDir, map.from))) {
+    if (!exists(join7(featDir, map.from))) {
       throw new Error(`[vitrine] feature "${name}": no source "${map.from}"`);
     }
     for (const file of eachFeatureFile(featDir, map)) {
@@ -593,7 +610,7 @@ function removeFeature(project, name, registry) {
       throw new Error(`[vitrine] cannot remove "${name}": "${other}" depends on it`);
     }
   }
-  const originalsDir = join6(projectPaths(project.root).originals, `${name}@${removed.version}`);
+  const originalsDir = join7(projectPaths(project.root).originals, `${name}@${removed.version}`);
   const featDir = registry.featureDir(name);
   const targets = /* @__PURE__ */ new Set();
   if (isDir(originalsDir)) for (const rel of walkRelFiles(originalsDir)) targets.add(rel);
@@ -616,21 +633,21 @@ function removeFeature(project, name, registry) {
 
 // src/design.ts
 import { spawnSync } from "child_process";
-import { existsSync as existsSync6, readdirSync as readdirSync2 } from "fs";
-import { delimiter, join as join7 } from "path";
+import { existsSync as existsSync7, readdirSync as readdirSync2 } from "fs";
+import { delimiter, join as join8 } from "path";
 import { TOKEN_CSS_VARS as TOKEN_CSS_VARS2 } from "@vitrine-kit/contracts";
 var DESIGN_HEADING = "## INSTRUCTION: apply the design from /design";
 function findClaudeBin(explicit) {
   const pinned = explicit ?? process.env.VITRINE_CLAUDE_BIN;
   if (pinned) {
-    if (existsSync6(pinned)) return pinned;
+    if (existsSync7(pinned)) return pinned;
     throw new Error(`[vitrine] Claude Code not found at path "${pinned}"`);
   }
   const names = process.platform === "win32" ? ["claude.cmd", "claude.exe", "claude.ps1", "claude"] : ["claude"];
   for (const dir of (process.env.PATH ?? "").split(delimiter).filter(Boolean)) {
     for (const name of names) {
-      const full = join7(dir, name);
-      if (existsSync6(full)) return full;
+      const full = join8(dir, name);
+      if (existsSync7(full)) return full;
     }
   }
   throw new Error(
@@ -638,8 +655,8 @@ function findClaudeBin(explicit) {
   );
 }
 function designHasInput(root) {
-  const dir = join7(root, "design");
-  if (!existsSync6(dir)) return false;
+  const dir = join8(root, "design");
+  if (!existsSync7(dir)) return false;
   return readdirSync2(dir).some((entry) => !/^readme\.md$/i.test(entry));
 }
 function extractDesignInstruction(claudeMd) {
@@ -649,7 +666,7 @@ function extractDesignInstruction(claudeMd) {
   return claudeMd.slice(start, next === -1 ? void 0 : next).trim();
 }
 function buildDesignPrompt(project) {
-  const claudeMd = existsSync6(join7(project.root, "CLAUDE.md")) ? readText(join7(project.root, "CLAUDE.md")) : "";
+  const claudeMd = existsSync7(join8(project.root, "CLAUDE.md")) ? readText(join8(project.root, "CLAUDE.md")) : "";
   const instruction = extractDesignInstruction(claudeMd) ?? DESIGN_HEADING;
   const tokens = TOKEN_CSS_VARS2.map((v) => `  ${v}`).join("\n");
   return [
@@ -691,7 +708,7 @@ function designApply(project, opts = {}, runner = defaultRunner) {
 }
 
 // src/doctor.ts
-import { join as join8 } from "path";
+import { join as join9 } from "path";
 function runDoctor(project, registry) {
   const paths = projectPaths(project.root);
   const issues = [];
@@ -733,7 +750,7 @@ function runDoctor(project, registry) {
     const featDir = registry.featureDir(name);
     for (const map of manifest.files) {
       for (const file of eachFeatureFile(featDir, map)) {
-        if (!exists(join8(project.root, file.repoRel))) {
+        if (!exists(join9(project.root, file.repoRel))) {
           add({
             severity: "error",
             scope,
@@ -783,7 +800,7 @@ function runDoctor(project, registry) {
 
 // src/update.ts
 import { rmSync as rmSync3 } from "fs";
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 
 // src/merge.ts
 function splitLines(s) {
@@ -927,13 +944,13 @@ function planUpdate(project, name, registry) {
   const fromVersion = pin.version;
   const toVersion = manifest.kitVersion;
   const featDir = registry.featureDir(name);
-  const originalsBase = join9(projectPaths(project.root).originals, `${name}@${fromVersion}`);
+  const originalsBase = join10(projectPaths(project.root).originals, `${name}@${fromVersion}`);
   const files = [];
   for (const map of manifest.files) {
     for (const file of eachFeatureFile(featDir, map)) {
       const theirs = readText(file.srcAbs);
-      const oursPath = join9(project.root, file.repoRel);
-      const basePath = join9(originalsBase, file.repoRel);
+      const oursPath = join10(project.root, file.repoRel);
+      const basePath = join10(originalsBase, file.repoRel);
       const ours = exists(oursPath) ? readText(oursPath) : null;
       const base = exists(basePath) ? readText(basePath) : null;
       if (ours === null) {
@@ -961,8 +978,8 @@ function applyUpdate(project, plan, registry) {
   const manifest = registry.loadManifest(plan.feature);
   const featDir = registry.featureDir(plan.feature);
   const paths = projectPaths(project.root);
-  const newOriginals = join9(paths.originals, `${plan.feature}@${plan.toVersion}`);
-  const oldOriginals = join9(paths.originals, `${plan.feature}@${plan.fromVersion}`);
+  const newOriginals = join10(paths.originals, `${plan.feature}@${plan.toVersion}`);
+  const oldOriginals = join10(paths.originals, `${plan.feature}@${plan.fromVersion}`);
   const tx = new FsTransaction();
   try {
     for (const f of plan.files) {
@@ -1037,32 +1054,34 @@ function diffFeatureCmd(name, registryRoot) {
 
 // src/init.ts
 import { readdirSync as readdirSync3 } from "fs";
-import { join as join11 } from "path";
+import { join as join12 } from "path";
 
-// src/kit.ts
-var KIT_VERSION = "0.0.0";
+// src/kit-versions.generated.ts
+var KIT_VERSION = "0.4.0";
 var CONTRACTS_VERSION = "1.0.0";
 var CONTRACTS_RANGE = "^1.0.0";
-var CORE_RANGE = "^0.1.0";
-var BLUEPRINT_RANGE = "^0.1.0";
+var CORE_RANGE = "^0.2.0";
+var BLUEPRINT_RANGE = "^0.2.0";
+
+// src/kit.ts
 var REACT_RANGE = "^18.3.1";
 var CLIENT_REACT_RANGE = "^19.0.0";
 var NEXT_RANGE = "^15.1.0";
 var PAYLOAD_RANGE = "^3.0.0";
 
 // src/templates.ts
-import { existsSync as existsSync7 } from "fs";
-import { dirname as dirname5, join as join10 } from "path";
+import { existsSync as existsSync8 } from "fs";
+import { dirname as dirname6, join as join11 } from "path";
 function templatesRoot(registryRoot) {
-  return join10(dirname5(registryRoot), "templates");
+  return join11(dirname6(registryRoot), "templates");
 }
 function hasTemplate(root, name) {
-  return existsSync7(join10(root, name, "files"));
+  return existsSync8(join11(root, name, "files"));
 }
 function copyTemplate(root, name, destRoot) {
-  const filesDir = join10(root, name, "files");
+  const filesDir = join11(root, name, "files");
   const rels = walkRelFiles(filesDir);
-  for (const rel of rels) writeText(join10(destRoot, rel), readText(join10(filesDir, rel)));
+  for (const rel of rels) writeText(join11(destRoot, rel), readText(join11(filesDir, rel)));
   return rels;
 }
 
@@ -1077,7 +1096,7 @@ var PAYMENT_PROVIDER_FEATURES = [
 ];
 function suggestFeatures(tier, registry, backend = defaultBackend(tier)) {
   const core = ["catalog", "product-page", "seo"];
-  const shop = backend === "vendure" ? ["cart"] : ["cart", "checkout-stripe", "reviews"];
+  const shop = backend === "vendure" ? ["cart"] : ["cart", "checkout-stripe"];
   const desired = tier === "catalog" ? core : [...core, ...shop];
   return desired.filter((name) => registry.hasFeature(name));
 }
@@ -1254,8 +1273,8 @@ ${run}
 
 \`\`\`bash
 vitrine list             # installed + available
-vitrine add reviews      # copy a feature: flag, slots, blueprint, env
-vitrine remove reviews   # remove (if the feature is removable)
+vitrine add cart         # copy a feature: flag, slots, blueprint, env
+vitrine remove cart      # remove (if the feature is removable)
 vitrine design apply     # style the new feature
 \`\`\`
 
@@ -1294,10 +1313,10 @@ function scaffoldBase(opts) {
   const backendTemplate = `backend-${backend}`;
   if (hasTemplate(tRoot, backendTemplate)) copyTemplate(tRoot, backendTemplate, root);
   if (!baseCopied) {
-    writeText(join11(root, ".gitignore"), "node_modules/\n.next/\ndist/\n.env\n.env.local\n.vitrine/\n");
+    writeText(join12(root, ".gitignore"), "node_modules/\n.next/\ndist/\n.env\n.env.local\n.vitrine/\n");
   }
   writeText(
-    join11(root, "vitrine.json"),
+    join12(root, "vitrine.json"),
     `${JSON.stringify(
       { kitVersion: KIT_VERSION, contracts: CONTRACTS_VERSION, backend, tier, features: {} },
       null,
@@ -1306,7 +1325,7 @@ function scaffoldBase(opts) {
 `
   );
   writeText(
-    join11(root, "site.config.ts"),
+    join12(root, "site.config.ts"),
     `import type { SiteConfig } from '@vitrine-kit/contracts';
 
 export const siteConfig: SiteConfig = {
@@ -1327,7 +1346,7 @@ export default siteConfig;
 `
   );
   writeText(
-    join11(root, "CLAUDE.md"),
+    join12(root, "CLAUDE.md"),
     `# ${name}
 
 A Vitrine project. Backend: \`${backend}\`, tier: \`${tier}\`.
@@ -1393,12 +1412,12 @@ The step is idempotent: re-running converges and doesn't accumulate cruft.
 - **The user makes commits** \u2014 don't run \`git commit\`/\`git push\` without an explicit request.
 `
   );
-  writeText(join11(root, "README.md"), clientReadme(name, backend, tier));
-  writeText(join11(root, "lib", "slots.ts"), renderSlotsFile([]));
-  writeText(join11(root, "lib", "blueprint.ts"), renderBlueprintFile([]));
-  writeText(join11(root, "theme", "client.css"), renderNeutralTheme());
-  writeText(join11(root, ".env.example"), clientEnvExample(backend));
-  writeText(join11(root, "package.json"), `${JSON.stringify(clientPackageJson(name, backend), null, 2)}
+  writeText(join12(root, "README.md"), clientReadme(name, backend, tier));
+  writeText(join12(root, "lib", "slots.ts"), renderSlotsFile([]));
+  writeText(join12(root, "lib", "blueprint.ts"), renderBlueprintFile([]));
+  writeText(join12(root, "theme", "client.css"), renderNeutralTheme());
+  writeText(join12(root, ".env.example"), clientEnvExample(backend));
+  writeText(join12(root, "package.json"), `${JSON.stringify(clientPackageJson(name, backend), null, 2)}
 `);
 }
 function initProject(opts) {
@@ -1412,9 +1431,9 @@ function initProject(opts) {
 
 // src/kit-update.ts
 import { spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync8, mkdtempSync, readdirSync as readdirSync4, statSync as statSync2 } from "fs";
+import { existsSync as existsSync9, mkdtempSync, readdirSync as readdirSync4, statSync as statSync2 } from "fs";
 import { tmpdir } from "os";
-import { join as join12, resolve as resolve5 } from "path";
+import { join as join13, resolve as resolve5 } from "path";
 var REPO = "vitrine-kit/vitrine";
 function hasBin(bin) {
   const probe = process.platform === "win32" ? "where" : "which";
@@ -1427,7 +1446,7 @@ function acquireFromGh(version) {
   if (!hasBin("tar")) {
     throw new Error("[vitrine] unpacking needs tar, or pass --from <dir>");
   }
-  const tmp = mkdtempSync(join12(tmpdir(), "vitrine-kit-"));
+  const tmp = mkdtempSync(join13(tmpdir(), "vitrine-kit-"));
   const dl = spawnSync2(
     "gh",
     ["release", "download", ...version ? [version] : [], "--repo", REPO, "--archive=tar.gz", "--dir", tmp, "--clobber"],
@@ -1438,10 +1457,10 @@ function acquireFromGh(version) {
   }
   const tarball = readdirSync4(tmp).find((f) => f.endsWith(".tar.gz"));
   if (!tarball) throw new Error("[vitrine] release tarball not found after download");
-  if (spawnSync2("tar", ["-xzf", join12(tmp, tarball), "-C", tmp], { stdio: "inherit" }).status !== 0) {
+  if (spawnSync2("tar", ["-xzf", join13(tmp, tarball), "-C", tmp], { stdio: "inherit" }).status !== 0) {
     throw new Error("[vitrine] tarball extraction failed");
   }
-  const root = readdirSync4(tmp).map((f) => join12(tmp, f)).find((p2) => statSync2(p2).isDirectory() && existsSync8(join12(p2, "registry", "_index.json")));
+  const root = readdirSync4(tmp).map((f) => join13(tmp, f)).find((p2) => statSync2(p2).isDirectory() && existsSync9(join13(p2, "registry", "_index.json")));
   if (!root) throw new Error("[vitrine] the unpacked tarball has no registry/_index.json");
   return root;
 }
@@ -1451,7 +1470,7 @@ function kitUpdate(opts = {}) {
 }
 function kitStatus(home = vitrineHome()) {
   const meta = readKitMeta(home);
-  const idxFile = join12(cachePaths(home).registry, "_index.json");
+  const idxFile = join13(cachePaths(home).registry, "_index.json");
   const idx = exists(idxFile) ? readJson(idxFile) : null;
   return {
     cached: meta !== null,

package/kit/registry/README.md

@@ -0,0 +1,9 @@
+# registry/ — copy-in feature registry
+
+The source for `vitrine init` / `vitrine add`. Each feature = a folder with `feature.json` (manifest) + `files/` (sources). On install the files are **copied** into the client repository (the client owns the code).
+
+`_index.json` is the registry manifest: the list of all features + the kit version.
+
+**Rule (spec §4, §13):** the registry holds only what varies per client (UI, sections, wiring). No critical logic — that lives in `@vitrine-kit/core`. A new feature must depend **only on the contracts**.
+
+**Typecheck in the monorepo:** `pnpm typecheck:registry` (components + lib) and `pnpm typecheck:registry-routes` (Next API route glue via `stubs/route-glue.d.ts`). Full Next/Payload pages are checked when the client is instantiated.

package/kit/registry/_index.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "../schemas/registry-index.schema.json",
+  "kitVersion": "0.4.0",
+  "contracts": "1.0.0",
+  "features": {
+    "catalog": {
+      "title": "Product catalog",
+      "kitVersion": "0.4.0",
+      "tier": [
+        "catalog",
+        "simple-store",
+        "full-store"
+      ]
+    },
+    "product-page": {
+      "title": "Product page",
+      "kitVersion": "0.4.0",
+      "tier": [
+        "catalog",
+        "simple-store",
+        "full-store"
+      ]
+    },
+    "seo": {
+      "title": "SEO — metadata and JSON-LD",
+      "kitVersion": "0.4.0",
+      "tier": [
+        "catalog",
+        "simple-store",
+        "full-store"
+      ]
+    },
+    "cart": {
+      "title": "Cart",
+      "kitVersion": "0.4.0",
+      "tier": [
+        "simple-store",
+        "full-store"
+      ]
+    },
+    "checkout": {
+      "title": "Checkout",
+      "kitVersion": "0.4.0",
+      "tier": [
+        "simple-store",
+        "full-store"
+      ]
+    },
+    "checkout-stripe": {
+      "title": "Payment — Stripe",
+      "kitVersion": "0.4.0",
+      "tier": [
+        "simple-store",
+        "full-store"
+      ]
+    },
+    "checkout-paddle": {
+      "title": "Payment — Paddle",
+      "kitVersion": "0.4.0",
+      "tier": [
+        "simple-store",
+        "full-store"
+      ]
+    },
+    "checkout-yookassa": {
+      "title": "Payment — YooKassa",
+      "kitVersion": "0.4.0",
+      "tier": [
+        "simple-store",
+        "full-store"
+      ]
+    }
+  }
+}

package/kit/registry/cart/docs/cart.md

@@ -0,0 +1,13 @@
+# Feature: cart
+
+The cart for the `simple-store` / `full-store` tiers. Depends only on the contracts:
+data goes through `CommerceBackend`, the arithmetic lives in `@vitrine-kit/core` (critical logic).
+
+- **Components:** `CartView`, `CartLineItem`, `CartSummary` (hosts the `cart.summary` slot),
+  `AddToCart` (client component, `product.purchase` slot), `CartIndicator` (`global.header-actions` slot).
+- **Routes/API (Next glue):** `/cart` (page), `POST/PATCH/DELETE /api/cart`
+  (cart id in an httpOnly cookie, mutations via `CommerceBackend`).
+- **Slots:** `product.purchase` → `AddToCart`; `global.header-actions` → `CartIndicator`;
+  hosts `cart.summary` (where checkout-stripe places the checkout button).
+
+Styled with tokens; the AI design step doesn't touch behavior.

package/kit/registry/cart/feature.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "../../schemas/feature.schema.json",
+  "name": "cart",
+  "title": "Cart",
+  "kitVersion": "0.4.0",
+  "requiresContracts": ">=1.0.0 <2.0.0",
+  "tier": [
+    "simple-store",
+    "full-store"
+  ],
+  "registryDependencies": [],
+  "corePackages": {
+    "@vitrine-kit/core": ">=0.1.0"
+  },
+  "npm": [],
+  "files": [
+    {
+      "from": "files/components/cart/",
+      "to": "components/cart/"
+    },
+    {
+      "from": "files/lib/cart/",
+      "to": "lib/cart/"
+    },
+    {
+      "from": "files/app/",
+      "to": "app/"
+    }
+  ],
+  "config": {
+    "set": {
+      "features.cart": true
+    }
+  },
+  "slots": [
+    {
+      "slot": "product.purchase",
+      "component": "AddToCart",
+      "order": 10
+    },
+    {
+      "slot": "global.header-actions",
+      "component": "CartIndicator",
+      "order": 20
+    }
+  ],
+  "env": [],
+  "claudeDoc": "docs/cart.md",
+  "conflicts": [],
+  "removable": true
+}

package/kit/registry/cart/files/app/(frontend)/cart/page.tsx

@@ -0,0 +1,21 @@
+// Cart page. The cart id is stored in a cookie; data comes via the CommerceBackend
+// contract (the backend adapter in lib/adapter). Not typechecked in the monorepo
+// (Next glue), verified when the client is instantiated.
+import { cookies } from 'next/headers';
+import { emptyCart } from '@vitrine-kit/core';
+import { getCommerceBackend } from '@/lib/adapter';
+import { CartView } from '@/components/cart/CartView';
+import { siteConfig } from '@/site.config';
+
+export default async function CartPage() {
+  const cartId = (await cookies()).get('vitrine_cart')?.value;
+  const commerce = await getCommerceBackend();
+  const cart = cartId ? await commerce.getCart(cartId) : null;
+
+  return (
+    <section className="flex flex-col gap-section">
+      <h1 className="font-heading text-fg">Cart</h1>
+      <CartView cart={cart ?? emptyCart('', siteConfig.i18n.currency)} />
+    </section>
+  );
+}