@tollerud/ui 4.0.3 → 4.0.4

package/AGENTS.md

@@ -39,10 +39,10 @@ npm install @tollerud/footer
 ```css
 /* app/globals.css */
 @import "@tollerud/ui/globals.css";
-@source "../node_modules/@tollerud/ui/dist";
+@import "@tollerud/ui/source.css";
 ```
 
-Adjust `@source` relative to your CSS file. Without it, classes used only inside `@tollerud/ui` dist may be purged.
+`source.css` resolves `@source` inside the installed package (npm, pnpm, workspaces, Bun). Without it, classes used only inside `@tollerud/ui` dist may be purged.
 
 **Optional preset shim** — extra utilities from `@tollerud/ui/preset`:
 

package/CHANGELOG.md

@@ -7,6 +7,34 @@
      • Never write bold mid-paragraph as a heading substitute — it merges into surrounding text
 -->
 
+## 4.0.4 — 2026-06-10 — Export verification and source.css
+
+Patch release: verifies all subpath exports in CI, adds package-owned Tailwind scanning, and expands install docs.
+
+### Added
+
+- `@tollerud/ui/source.css` — package-owned `@source` for `dist` scanning (npm, pnpm, workspaces, Bun)
+- `test:subpath` now checks all 70 manifest entries (`dist/{name}.js` + `.d.ts`)
+- `test:package` runs attw against every public subpath export
+
+### Changed
+
+- Recommended Tailwind v4 setup: `@import "@tollerud/ui/source.css"` after `globals.css`
+- `GETTING_STARTED.md` — monorepo `@source` path table, footer-only minimal install
+- `tailwind.css` re-exports `source.css` for one-import convenience
+- Docs site getting-started page updated for `source.css`
+
+### Migration
+
+Replace manual `@source "../node_modules/@tollerud/ui/dist"` with:
+
+```css
+@import "@tollerud/ui/globals.css";
+@import "@tollerud/ui/source.css";
+```
+
+---
+
 ## 4.0.3 — 2026-06-09 — Publish pipeline hardening
 
 Patch release: aligns npm publish with `validate`, fixes preset export shape, enables provenance via OIDC, and fixes `@tollerud/footer` CI build.

package/GETTING_STARTED.md

@@ -2,6 +2,10 @@
 
 ## Install
 
+### Full design system
+
+Copy-paste — installs `@tollerud/ui` and all required peers:
+
 ```bash
 npm install @tollerud/ui clsx tailwind-merge tailwindcss@4 \
   @radix-ui/react-dialog @radix-ui/react-dropdown-menu @radix-ui/react-progress \
@@ -17,17 +21,54 @@ As of **v2.0.0**, Radix, Lucide, Framer Motion, and Sonner are **required peer d
 npm install @paper-design/shaders-react
 ```
 
+### Footer only (minimal)
+
+If you only need the branded footer — no Tailwind, Radix, or other design-system peers:
+
+```bash
+npm install @tollerud/footer
+```
+
+```tsx
+import { Footer } from '@tollerud/footer'
+
+<Footer />
+```
+
+`@tollerud/footer` bundles `clsx` and `tailwind-merge` as dependencies. Use `@tollerud/ui` when you need the full component set.
+
 ---
 
 ## Tailwind Setup (v4)
 
+**Recommended** — package-owned `@source` (works with npm, pnpm, Yarn workspaces, and Bun):
+
 ```css
 /* app/globals.css */
 @import "@tollerud/ui/globals.css";
+@import "@tollerud/ui/source.css";
+```
+
+`globals.css` bundles Tailwind v4, design tokens, and all component layer styles. `source.css` points Tailwind at the installed package `dist` folder so component utility classes are not purged — no fragile `../node_modules` paths.
+
+### Manual `@source` path (monorepos / custom layouts)
+
+If you prefer an explicit path, resolve it **relative to your CSS file** to `node_modules/@tollerud/ui/dist`:
+
+| Layout | Example CSS file | `@source` path |
+|--------|------------------|----------------|
+| Next.js App Router (default) | `app/globals.css` | `../node_modules/@tollerud/ui/dist` |
+| `src/` app dir | `src/app/globals.css` | `../../node_modules/@tollerud/ui/dist` |
+| Turborepo / npm workspace app | `apps/web/app/globals.css` | `../../../node_modules/@tollerud/ui/dist` |
+| pnpm (package in workspace) | `app/globals.css` | Prefer `@import "@tollerud/ui/source.css"` — hoisting varies |
+| Bun | `app/globals.css` | Prefer `@import "@tollerud/ui/source.css"` |
+
+```css
+@import "@tollerud/ui/globals.css";
 @source "../node_modules/@tollerud/ui/dist";
 ```
 
-`globals.css` bundles Tailwind v4, design tokens, and all component layer styles. Point `@source` at the package `dist` folder relative to your CSS file so component utility classes are not purged.
+If styles disappear in production, the `@source` path is wrong — switch to `@tollerud/ui/source.css` or fix the relative path.
 
 **Optional preset shim** — for extra theme tokens from `@tollerud/ui/preset` (`tollerud-preset.cjs`):
 
@@ -42,7 +83,7 @@ export default { presets: [tollerudPreset] }
 @config "./tailwind.config.ts";
 @import "@tollerud/ui/tokens.css";
 @import "@tollerud/ui/globals-layers.css";
-@source "../node_modules/@tollerud/ui/dist";
+@import "@tollerud/ui/source.css";
 ```
 
 ### Tailwind v3 (legacy)

package/README.md

@@ -42,14 +42,14 @@ As of **v2.0.0**, Radix primitives, Lucide, Framer Motion, and Sonner are **peer
 npm install @paper-design/shaders-react
 ```
 
-**CSS** — one import in `app/globals.css` (Tailwind v4 + tokens + component classes):
+**CSS** — two imports in `app/globals.css` (Tailwind v4 + tokens + component class scanning):
 
 ```css
 @import '@tollerud/ui/globals.css';
-@source '../node_modules/@tollerud/ui/dist';
+@import '@tollerud/ui/source.css';
 ```
 
-Adjust the `@source` path relative to your CSS file so it resolves to `node_modules/@tollerud/ui/dist`.
+`source.css` resolves `@source` inside the installed package — works with npm, pnpm, Yarn workspaces, and Bun. See [GETTING_STARTED.md](GETTING_STARTED.md) for manual `@source` paths in monorepos.
 
 **Optional preset shim** — if you need utilities from `@tollerud/ui/preset` beyond what `tokens.css` provides:
 
@@ -64,7 +64,7 @@ export default { presets: [tollerudPreset] }
 @config './tailwind.config.ts';
 @import '@tollerud/ui/tokens.css';
 @import '@tollerud/ui/globals-layers.css';
-@source '../node_modules/@tollerud/ui/dist';
+@import '@tollerud/ui/source.css';
 ```
 
 **Tailwind v3 (legacy)** — preset in `tailwind.config.ts` plus `@tollerud/ui/globals-v3.css`:

package/SKILL.md

@@ -27,7 +27,7 @@ Apply the Tailwind preset when you need extra utilities from `@tollerud/ui/prese
 ```css
 /* app/globals.css — Tailwind v4 (default) */
 @import "@tollerud/ui/globals.css";
-@source "../node_modules/@tollerud/ui/dist";
+@import "@tollerud/ui/source.css";
 ```
 
 As of **v1.4.0**, charts (`BarChart`, `AreaChart`, `Donut`, `Sparkline`) and marketing blocks (`HeroBlock`, `FeatureCard`, `CTABand`) ship in the package. As of **v1.3.0**, `@tollerud/ui/globals.css` is the Tailwind v4 entry. Tailwind colors are under `tollerud.*` only (`text-tollerud-yellow`, `bg-tollerud-surface-raised`, etc.) — not `tia-*`.

package/globals.css

@@ -4,7 +4,7 @@
    Usage in app/globals.css:
 
      @import '@tollerud/ui/globals.css';
-     @source '../node_modules/@tollerud/ui/dist';
+     @import '@tollerud/ui/source.css';
 
    Optional preset shim (extra theme tokens from tollerud-preset.cjs):
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tollerud/ui",
-  "version": "4.0.3",
+  "version": "4.0.4",
   "description": "Tollerud User Interface — dark, monochrome + yellow accent. Noir aesthetic meets modern utility.",
   "private": false,
   "type": "module",
@@ -32,6 +32,7 @@
     "./globals-v3.css": "./globals-v3.css",
     "./globals-layers.css": "./globals-layers.css",
     "./tailwind.css": "./tailwind.css",
+    "./source.css": "./source.css",
     "./tokens.css": "./tokens.css",
     "./preset": "./tollerud-preset.cjs",
     "./brand/tollerud-logo.svg": "./brand/tollerud-logo.svg",
@@ -52,6 +53,7 @@
     "globals-v3.css",
     "globals-layers.css",
     "tailwind.css",
+    "source.css",
     "tokens.css",
     "tollerud-preset.cjs",
     "GETTING_STARTED.md",

package/source.css

@@ -0,0 +1,12 @@
+/**
+ * Tailwind v4 — scan @tollerud/ui dist for component utility classes.
+ *
+ * Import in app/globals.css after globals.css:
+ *
+ *   @import "@tollerud/ui/globals.css";
+ *   @import "@tollerud/ui/source.css";
+ *
+ * Paths resolve inside the installed package — works with npm, pnpm, Yarn
+ * workspaces, and Bun without fragile ../node_modules relative paths.
+ */
+@source "./dist";

package/tailwind.css

@@ -1,9 +1,6 @@
 /**
  * Convenience entry for Tailwind v4 consumers.
- * Re-exports globals + documents the @source path for class scanning.
+ * Re-exports globals + source scanning in one import.
  */
 @import "./globals.css";
-
-/* In your app globals.css, add after this import:
-@source "../node_modules/@tollerud/ui/dist";
-*/
+@import "./source.css";