torch-glare 2.5.0 → 2.5.1

package/dist/src/shared/wireStylesheet.js

@@ -0,0 +1,92 @@
+import fs from "fs";
+import path from "path";
+/**
+ * Where an entry stylesheet lives, in the order projects usually put it.
+ * Next.js app router first, then pages/Vite, then a `styles/` convention.
+ */
+const CANDIDATES = [
+    "app/globals.css",
+    "src/app/globals.css",
+    "src/index.css",
+    "styles/globals.css",
+    "src/styles/globals.css",
+    "app/global.css",
+    "src/styles/index.css",
+];
+/** The marker that tells us the block is already there. */
+const MARKER = "glare-torch-mode";
+/**
+ * Tailwind v4 registers the design system through the CSS file itself.
+ *
+ * The order matters and is not cosmetic: CSS requires every `@import` to precede other at-rules, so
+ * an `@import "tailwindcss"` placed *after* the `@plugin` lines is silently dropped by the bundler.
+ * That takes every `--color-*` registration with it and leaves every `bg-background-presentation-*`
+ * utility rendering as nothing — with no build error to explain it.
+ */
+const V4_BLOCK = `@import "tailwindcss";
+@import "mapping-color-system-v4/tailwindVars.css";
+@plugin "glare-torch-mode";
+@plugin "tailwind-scrollbar-hide";
+@plugin "tailwindcss-animate";
+@plugin "glare-typography";
+@plugin "mapping-color-system-v4";
+`;
+/** For v3 the plugins belong in `tailwind.config.*`, which is user-owned JS we do not rewrite. */
+const V3_SNIPPET = `plugins: [
+  require("glare-torch-mode"),
+  require("tailwind-scrollbar-hide"),
+  require("tailwindcss-animate"),
+  require("glare-typography"),
+  require("mapping-color-system"),
+  require("@tailwindcss/container-queries"),
+]`;
+export function findStylesheet(cwd = process.cwd()) {
+    for (const candidate of CANDIDATES) {
+        const full = path.join(cwd, candidate);
+        if (fs.existsSync(full))
+            return full;
+    }
+    return null;
+}
+/**
+ * Put the design system into the project's stylesheet.
+ *
+ * `init` used to install the five Tailwind packages and stop, leaving the wiring as a manual step
+ * buried in the docs — so a project would build cleanly and render every component unstyled. This
+ * closes that gap, and is a no-op when the block is already present, so re-running `init` is safe.
+ *
+ * @returns what happened, so the caller can report it truthfully.
+ */
+export function wireStylesheet(isV3, cwd = process.cwd()) {
+    // v3's plugins go in tailwind.config.*, whose shape is arbitrary user JS. A wrong edit there is
+    // worse than a printed instruction, so print and let the developer place it.
+    if (isV3) {
+        console.log("ℹ️ Tailwind v3 detected. Add these plugins to your `tailwind.config.*`:\n");
+        console.log(V3_SNIPPET + "\n");
+        return { status: "manual" };
+    }
+    const file = findStylesheet(cwd);
+    if (!file) {
+        console.log("⚠️ No entry stylesheet found (looked for " +
+            CANDIDATES.slice(0, 4).join(", ") +
+            ").\n   Add this to yours, keeping `@import \"tailwindcss\"` first:\n");
+        console.log(V4_BLOCK);
+        return { status: "not-found" };
+    }
+    const current = fs.readFileSync(file, "utf-8");
+    if (current.includes(MARKER)) {
+        console.log(`✅ ${path.relative(cwd, file)} is already wired — left alone.`);
+        return { status: "already", file };
+    }
+    // Replace the project's own `@import "tailwindcss"` rather than adding a second one; if there
+    // is none, the block goes at the very top, which is where the import has to be anyway.
+    const existing = /^[ \t]*@import\s+["']tailwindcss["'];?[ \t]*\r?\n/m;
+    const next = existing.test(current)
+        ? current.replace(existing, V4_BLOCK)
+        : V4_BLOCK + "\n" + current;
+    fs.writeFileSync(file, next);
+    console.log(`✅ Wired ${path.relative(cwd, file)} with the TORCH Glare design system.`);
+    return { status: "written", file };
+}
+export { V4_BLOCK, MARKER, CANDIDATES };
+//# sourceMappingURL=wireStylesheet.js.map

package/dist/src/shared/wireStylesheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wireStylesheet.js","sourceRoot":"","sources":["../../../cli/src/shared/wireStylesheet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;GAGG;AACH,MAAM,UAAU,GAAG;IACf,iBAAiB;IACjB,qBAAqB;IACrB,eAAe;IACf,oBAAoB;IACpB,wBAAwB;IACxB,gBAAgB;IAChB,sBAAsB;CACzB,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,GAAG,kBAAkB,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,QAAQ,GAAG;;;;;;;CAOhB,CAAC;AAEF,kGAAkG;AAClG,MAAM,UAAU,GAAG;;;;;;;EAOjB,CAAC;AAEH,MAAM,UAAU,cAAc,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACtD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACvC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IACzC,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC1B,IAAa,EACb,MAAc,OAAO,CAAC,GAAG,EAAE;IAE3B,gGAAgG;IAChG,6EAA6E;IAC7E,IAAI,IAAI,EAAE,CAAC;QACP,OAAO,CAAC,GAAG,CAAC,2EAA2E,CAAC,CAAC;QACzF,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;QAC/B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,OAAO,CAAC,GAAG,CACP,2CAA2C;YACvC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACjC,sEAAsE,CAC7E,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACnC,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/C,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAC5E,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IAED,8FAA8F;IAC9F,uFAAuF;IACvF,MAAM,QAAQ,GAAG,oDAAoD,CAAC;IACtE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC;QAC/B,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC;QACrC,CAAC,CAAC,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC;IAEhC,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACvF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC;AAED,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC"}

package/dist/src/types/main.d.ts

@@ -20,6 +20,12 @@ export interface RegistryItem {
 export interface Registry {
     version: string;
     generatedBy: string;
+    /**
+     * The version range the library builds each package against, e.g.
+     * `{"@tanstack/react-table": "^8.21.3"}`. Installing unpinned means an upstream major can
+     * break copied source the day it lands.
+     */
+    npmVersions?: Record<string, string>;
     items: RegistryItem[];
 }
 /** Fully resolved set of work needed to install one item. */

package/dist/src/types/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../cli/src/types/main.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACnB,IAAI,EAAE,MAAM,CAAC;CAEhB;AAED,MAAM,WAAW,gBAAgB;IAC7B,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChD;AAED,gDAAgD;AAChD,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,IAAI,EAAE,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;IACjE,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,+DAA+D;IAC/D,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,QAAQ;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IACxB,wEAAwE;IACxE,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,8CAA8C;IAC9C,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAChC"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../cli/src/types/main.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACnB,IAAI,EAAE,MAAM,CAAC;CAEhB;AAED,MAAM,WAAW,gBAAgB;IAC7B,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChD;AAED,gDAAgD;AAChD,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,IAAI,EAAE,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;IACjE,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,+DAA+D;IAC/D,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,QAAQ;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,KAAK,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IACxB,wEAAwE;IACxE,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,8CAA8C;IAC9C,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAChC"}

package/docs/reference/cli.md

@@ -23,7 +23,7 @@ Run a command **without** a name to pick from an interactive list.
 
 | Command | Description |
 | --- | --- |
-| `init` | Create `glare.json` and set up Tailwind. Run once per project. |
+| `init` | Create `glare.json`, install the Tailwind packages, **and wire your stylesheet**. Run once per project. |
 | `add [Component]` | Copy a component **and its dependencies** into your project. |
 | `hook [hook]` | Copy a hook (usually pulled in automatically as a dependency). |
 | `util [util]` | Copy a utility (e.g. `cn`, usually pulled in automatically). |
@@ -32,6 +32,8 @@ Run a command **without** a name to pick from an interactive list.
 | `update` | Re-sync everything already installed with the latest templates. |
 
 Component names are **case-sensitive PascalCase** — `add DatePicker`, not `add datepicker`.
+Every command takes a **bare name** — `hook useDragDrop`, not `hook useDragDrop.tsx` — and every one
+accepts `-f, --force`.
 
 ## `init`
 
@@ -39,7 +41,23 @@ Component names are **case-sensitive PascalCase** — `add DatePicker`, not `add
 npx torch-glare@latest init
 ```
 
-Creates `glare.json` and configures Tailwind. `glare.json` controls where files are copied:
+Three things, in order:
+
+1. Creates `glare.json`.
+2. Installs the Tailwind packages the design system needs, using your detected package manager.
+3. **Wires your entry stylesheet** — `app/globals.css`, `src/app/globals.css`, `src/index.css`,
+   `styles/globals.css` — with the `@import`/`@plugin` block. Re-running is safe: if the block is
+   already there it says so and changes nothing.
+
+On Tailwind v3 the plugins belong in `tailwind.config.*` instead. `init` prints the snippet rather
+than editing that file, since its shape is yours.
+
+> Without step 3 the project builds cleanly and renders every component **unstyled** — the design
+> tokens simply resolve to nothing. If that happens, check that `@import "tailwindcss"` is the
+> first line: CSS requires imports to precede other at-rules, so an import placed after a `@plugin`
+> is silently dropped.
+
+`glare.json` controls where files are copied:
 
 ```json
 {
@@ -68,7 +86,14 @@ export function Example() {
 }
 ```
 
-Existing files are never overwritten; use `update` to re-sync.
+It ends with a summary — `✅ DataViews → ./: 56 installed (56 items).` — so a partial install is
+visible rather than something you discover at build time.
+
+Dependencies come from the generated `registry.json`, resolved in one pass, so each item is copied
+exactly once however many things import it.
+
+Existing files are never overwritten. Use `--force` to re-copy — it applies to **the whole
+dependency closure**, not just the component you named — or `update` to re-sync everything.
 
 ## `update`
 

package/docs/tutorials/getting-started.md

@@ -32,6 +32,13 @@ Before you begin, make sure you have:
 
 ---
 
+> **If you plan to build forms**, add the validation packages the guides use — no component
+> imports them, so the CLI does not install them for you:
+>
+> ```bash
+> npm install zod @hookform/resolvers
+> ```
+
 ## Step 1: Initialize TORCH Glare
 
 Run the following command to initialize your project:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "torch-glare",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "type": "module",
   "license": "MIT",
   "description": "A copy-in React component library (TypeScript + Radix UI + Tailwind CSS). Its CLI copies component source directly into your project — you own the code.",