@forthtilliath/forth-ui 0.4.1 → 0.5.0

package/README.md

@@ -300,29 +300,28 @@ base file overrides the default colors via normal CSS cascade:
 ```css
 @import "@forthtilliath/shadcn-ui/styles/globals-static.css";
 @import "@forthtilliath/shadcn-ui/styles/themes/rose.css";
-
-@source "../node_modules/@forthtilliath/*/dist/**/*.js";
+@import "@forthtilliath/forth-ui/styles/sources.css";
 ```
 
 Don't add your own `@import "tailwindcss";` — `globals-static.css` already
 does that internally.
 
-**What that `@source` line does, and why it's needed:** Tailwind only
-generates CSS for class names it can actually find, as literal text, in
-the files it scans — by default your own project source, honoring
-`.gitignore` (which is why `node_modules` is skipped: scanning every
-dependency would be slow and mostly pointless). But forth-ui and shadcn-ui
-ship pre-built, and their component code — the literal `"bg-primary"`,
-`"rounded-md"`, etc. strings — only exists inside their already-compiled
-`node_modules/@forthtilliath/*/dist/**/*.js` files. Without pointing
-Tailwind at them explicitly, none of those classes would be generated and
-every forth-ui/shadcn-ui component would render completely unstyled. This
-one line, with a wildcard for the package name, covers both packages (and
-any other `@forthtilliath/*` package added later) — confirmed to produce
-the exact same generated CSS as listing each package's path separately.
-This isn't a workaround specific to forth-ui: it's the
-[documented, standard way](https://tailwindcss.com/docs/detecting-classes-in-source-files#explicitly-registering-sources)
-Tailwind v4 expects any npm-distributed component library to be consumed.
+**What `sources.css` does, and why it's needed:** Tailwind only generates
+CSS for class names it can actually find, as literal text, in the files it
+scans — by default your own project source, honoring `.gitignore` (which is
+why `node_modules` is skipped). But forth-ui and shadcn-ui ship pre-built:
+their component code — the literal `"bg-primary"`, `"rounded-md"`, etc.
+strings — only exists in their compiled `dist/` files. Without registering
+them explicitly, none of those classes would be generated and the
+components would render unstyled. `sources.css` does that with
+[`@source`](https://tailwindcss.com/docs/detecting-classes-in-source-files#explicitly-registering-sources)
+for forth-ui's components and, through shadcn-ui's own `sources.css`, for
+the shadcn-ui ones they're built on.
+
+Its paths are relative to the package itself, so it works whatever the
+`node_modules` layout. Don't write the `@source` yourself with a glob such as
+`../node_modules/@forthtilliath/*/dist/**/*.js`: under pnpm (packages are
+symlinks — junctions on Windows) that pattern silently matches nothing.
 
 ### Available themes
 

package/dist/styles/sources.css

@@ -0,0 +1,8 @@
+/* Registers forth-ui's components, and the shadcn-ui ones they're built on,
+   with the consumer's Tailwind build: import this file from your CSS entry
+   point. The path is relative to this file, so it holds both in src/ (this
+   monorepo) and in the published dist/styles/, whatever the node_modules
+   layout (npm, or pnpm symlinks). Copied to dist/ by `build:css`. */
+@import "@forthtilliath/shadcn-ui/styles/sources.css";
+
+@source "../components";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forthtilliath/forth-ui",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "type": "module",
   "sideEffects": [
     "*.css"
@@ -28,8 +28,8 @@
     "lucide-react": "^1.31.0",
     "qrcode": "^1.5.4",
     "shiki": "^4.4.3",
+    "@forthtilliath/shadcn-ui": "^0.4.0",
     "@forthtilliath/react-kit": "^0.6.0",
-    "@forthtilliath/shadcn-ui": "^0.3.0",
     "@forthtilliath/ts-types": "^0.3.0"
   },
   "peerDependencies": {
@@ -68,7 +68,8 @@
   "exports": {
     "./components/*": "./dist/components/*/index.js",
     "./locale": "./dist/locale/index.js",
-    "./styles/globals.css": "./dist/globals.css"
+    "./styles/globals.css": "./dist/globals.css",
+    "./styles/sources.css": "./dist/styles/sources.css"
   },
   "size-limit": [
     {
@@ -89,9 +90,10 @@
     "dev": "concurrently \"pnpm:dev:ts\" \"pnpm:dev:tw\"",
     "dev:ts": "tsc --watch",
     "dev:tw": "pnpm run build:tw --watch",
-    "build": "pnpm run clean && pnpm run build:ts && pnpm run build:tw",
+    "build": "pnpm run clean && pnpm run build:ts && pnpm run build:tw && pnpm run build:css",
     "build:ts": "tsc",
     "build:tw": "tailwindcss -i ./src/styles/globals.css -o ./dist/globals.css",
+    "build:css": "node -e \"require('node:fs').cpSync('src/styles/sources.css', 'dist/styles/sources.css')\"",
     "size": "size-limit"
   }
 }