jig-ui 0.6.0 → 0.7.1

package/dist/index.js

@@ -2975,7 +2975,7 @@ function check(opts) {
 }
 
 // src/commands/init.ts
-import { existsSync as existsSync13, mkdirSync as mkdirSync5, readdirSync as readdirSync9, readFileSync as readFileSync18, writeFileSync as writeFileSync4 } from "fs";
+import { existsSync as existsSync13, mkdirSync as mkdirSync5, readdirSync as readdirSync9, readFileSync as readFileSync18, rmSync as rmSync2, writeFileSync as writeFileSync4 } from "fs";
 import { dirname as dirname6, isAbsolute, join as join23, resolve as resolve2, sep as sep3 } from "path";
 
 // src/init/detect.ts
@@ -3547,6 +3547,11 @@ function wireBarrel(absPath, barrelImport) {
 async function init(opts) {
   const log = opts.log ?? ((line) => console.log(line));
   const prompt = opts.prompt ?? defaultPrompt;
+  if (!opts.yes && !opts.prompt && !process.stdin.isTTY) {
+    throw new Error(
+      "'jig init' asks questions and stdin is not a terminal, so it cannot. Re-run with --yes to accept the derived defaults, or run it in a terminal. (To choose the mode without a terminal, write jig.config.json first \u2014 init honours it.)"
+    );
+  }
   const migrateLegacy = async (report, describe) => {
     if (!report.present) return;
     for (const line of describe(report)) log(line);
@@ -3642,7 +3647,24 @@ Brand colour adjusted to clear the 4.5:1 contrast floor: l:${originalL}% \u2192
   // a project holding a legacy token layer must keep it rather than gain a
   // second one somewhere else.
   legacyBrandFile(opts.projectRoot);
-  const brandRelPath = configuredBrand.path ?? priorBrand ?? relKey(...defaultTokenDir(detection), brandFileName(projectSlug));
+  let relocateTo = null;
+  const currentBrand = configuredBrand.path ?? priorBrand;
+  if (currentBrand) {
+    const wouldBe = relKey(...defaultTokenDir(detection), currentBrand.split("/").pop());
+    const currentDir = currentBrand.split("/").slice(0, -1).join("/");
+    if (wouldBe !== currentBrand && findWireTarget(detection)) {
+      log(`
+The token layer is at ${currentDir}/, and this project's layout suggests ${wouldBe.split("/").slice(0, -1).join("/")}/.`);
+      if (opts.yes) {
+        log("  Re-run without --yes to be offered the move, or set `brand` in jig.config.json yourself.");
+      } else {
+        const answer = (await prompt("  Move the token layer there? [y/N]: ")).toLowerCase();
+        if (answer === "y" || answer === "yes") relocateTo = wouldBe;
+        else log("  Left it where it is.");
+      }
+    }
+  }
+  const brandRelPath = relocateTo ?? configuredBrand.path ?? priorBrand ?? relKey(...defaultTokenDir(detection), brandFileName(projectSlug));
   const brandAbsPath = join23(opts.projectRoot, ...brandRelPath.split("/"));
   const tokensRelDir = brandRelPath.split("/").slice(0, -1);
   log(
@@ -3682,6 +3704,18 @@ ${configRelPath} already exists and was not created by 'jig init' (or has been e
     writeFileSync4(brandAbsPath, content, "utf8");
     files[brandRelPath] = checksum(content);
   }
+  if (relocateTo && configAction !== "written") {
+    try {
+      const existing = JSON.parse(readFileSync18(configAbsPath, "utf8"));
+      const content = `${JSON.stringify({ ...existing, brand: brandRelPath }, null, 2)}
+`;
+      writeFileSync4(configAbsPath, content, "utf8");
+      files[configRelPath] = checksum(content);
+      log(`  Updated ${configRelPath} to point at the new location.`);
+    } catch {
+      log(`  Could not update ${configRelPath} \u2014 set \`brand\` to ${brandRelPath} yourself.`);
+    }
+  }
   if (configAction === "written") {
     const config = { brand: brandRelPath, surfaces };
     const content = `${JSON.stringify(config, null, 2)}
@@ -3753,6 +3787,23 @@ ${configRelPath} already exists and was not created by 'jig init' (or has been e
     }
   }
   writeInitManifest(opts.projectRoot, { version: opts.version, modes: declaredModes, files });
+  if (relocateTo && currentBrand) {
+    const oldDir = currentBrand.split("/").slice(0, -1);
+    const oldAbsDir = join23(opts.projectRoot, ...oldDir);
+    if (existsSync13(oldAbsDir)) {
+      for (const name of readdirSync9(oldAbsDir).filter((f) => f.endsWith(".css"))) {
+        const rel = relKey(...oldDir, name);
+        const abs = join23(oldAbsDir, name);
+        const state = fileState(opts.projectRoot, abs, rel, initManifest);
+        if (!state.tracked || state.modified) {
+          log(`  ${rel} was edited \u2014 left in place. Delete it yourself once you have moved anything you need.`);
+          continue;
+        }
+        rmSync2(abs, { force: true });
+        delete files[rel];
+      }
+    }
+  }
   const wireTarget = findWireTarget(detection);
   let wiring;
   if (wireTarget) {
@@ -3763,6 +3814,13 @@ ${configRelPath} already exists and was not created by 'jig init' (or has been e
     );
     const snippet = `@import "${barrelImport}";`;
     try {
+      if (relocateTo && currentBrand) {
+        const abs = join23(opts.projectRoot, wireTarget);
+        const oldDirName = currentBrand.split("/").slice(0, -1).join("/");
+        const before = existsSync13(abs) ? readFileSync18(abs, "utf8") : "";
+        const after = before.split("\n").filter((l) => !(l.includes("@import") && l.includes(oldDirName))).join("\n");
+        if (after !== before) writeFileSync4(abs, after, "utf8");
+      }
       const outcome = wireBarrel(join23(opts.projectRoot, wireTarget), barrelImport);
       wiring = { target: wireTarget, status: outcome.status, snippet };
       const verb = outcome.status === "wired" ? "Wired" : outcome.status === "rewired" ? "Rewired" : "Already present in";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jig-ui",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "A design system for coding agents. 104 numbered UI rules, brand x mode design tokens, and an installer for Claude Code, Codex, Cursor and opencode.",
   "license": "Apache-2.0",
   "type": "module",

package/rules/02-tokens.md

@@ -19,13 +19,24 @@ tokens/
 
 A surface loads **exactly one brand file and exactly one mode file**.
 
-**Tokens live at `.jig/tokens/`.** That is the only location, in every scope and
-every project — `jig install` puts them there, `jig update` refreshes them there,
-and nothing relocates them. Import from that path and it stays correct.
+**The token layer's location follows the project.** `init` writes it beside the
+stylesheet it wires and prints the path it chose — `src/styles/jig/` where the CSS
+lives in `src/styles/`, `app/assets/stylesheets/jig/` in a Rails app. Set `brand`
+in `jig.config.json` to put it elsewhere. Projects set up before 0.7.0 keep their
+`.jig/tokens/` layout; `update` does not move them.
 
+So **never hardcode that path**. `init` writes one barrel per surface, `theme.css`,
+which imports the brand and the mode in the right order — import the barrel, and
+relocating the layer changes one line instead of every stylesheet:
+
+```css
+/* src/styles/jig/theme.css — written by init */
+@import "./brand.acme.css";
+@import "./mode.operator.css";
+```
 ```css
-@import ".jig/tokens/brand.acme.css";
-@import ".jig/tokens/mode.operator.css";
+/* your stylesheet */
+@import "./jig/theme.css";
 ```
 
 Three separate mode files rather than one file with variants. The trade: a surface cannot switch modes at runtime, and shared values are duplicated across three files. In exchange each surface ships only the tokens it uses, the files are independently readable, and there is no cascade to reason about. For a system where mode is a routing decision rather than a user preference, that is the right trade.
@@ -369,8 +380,7 @@ In dark, elevated surfaces get **lighter**, not shadowed. Border-led elevation s
 
 **Plain CSS, any framework**
 ```css
-@import ".jig/tokens/brand.default.css";
-@import ".jig/tokens/mode.product.css";
+@import "./jig/theme.css";
 
 .card {
   background: var(--color-bg-raised);