@devalok/shilp-sutra 0.36.1 → 0.37.0-next.1

package/docs/components/_header.md

@@ -6,6 +6,102 @@
 >
 > Package: @devalok/shilp-sutra
 > Version: {{VERSION}}
+>
+> **If you are an AI agent reading this file top-to-bottom:** the Setup
+> section below is authoritative. If any later per-component doc or a
+> pre-0.37 history entry shows `tailwind.config.ts` / `presets: [shilpSutra]`
+> / `@config`, that is HISTORICAL and does NOT apply on 0.37+.
+
+---
+
+## Setup (0.37.0+ — Tailwind 4 CSS-first)
+
+**The only supported setup** is TW4 CSS-first. No JS preset, no `tailwind.config.ts` required from us.
+
+```sh
+pnpm add @devalok/shilp-sutra@next framer-motion
+# Only if you render <Toaster />:
+pnpm add sonner
+```
+
+```css
+/* app/globals.css */
+@import "tailwindcss";
+@import "@devalok/shilp-sutra/css";
+
+/* Your own extensions go in the same file */
+@plugin "@tailwindcss/typography";
+@source "./app/**/*.{ts,tsx}";
+```
+
+```ts
+// next.config.ts
+transpilePackages: ['@devalok/shilp-sutra', '@devalok/shilp-sutra-brand'],
+```
+
+**Do NOT** import `@devalok/shilp-sutra/tailwind` in a `tailwind.config.ts`. That export is a deprecated no-op stub and logs a dev-mode `console.warn`. It is scheduled for removal in 0.38.
+
+### Peer dependencies (0.37.0)
+
+| Package | Role | Install when |
+|---|---|---|
+| `react`, `react-dom` | required peer | always |
+| `tailwindcss ^4.0.0` | required peer | always |
+| `framer-motion ^12.0.0` | required peer | always — module-scoped motion contexts must be single-copy |
+| `sonner ^2.0.0` | optional peer | only if you render `<Toaster />` or call `toast()` |
+| `@tabler/icons-react` | optional peer | if you use `Icon` / icon-bearing components |
+| `@tanstack/react-table`, `@tanstack/react-virtual` | optional peer | if you use `DataTable` |
+| `@tiptap/*` | optional peer | if you use `RichTextEditor` or `RichChatInput` |
+| `react-pdf`, `react-zoom-pan-pinch` | optional peer | if you use `FilePreview` |
+| `react-markdown`, `remark-gfm` | optional peer | if you use `MarkdownViewer` |
+| `date-fns` | optional peer | if you use `DatePicker` / `ScheduleView` |
+| `input-otp` | optional peer | if you use `InputOTP` |
+
+### Token namespaces exposed by our `/css` import
+
+| TW4 namespace | Generates utilities like | Our tokens |
+|---|---|---|
+| `--color-*` | `bg-*`, `text-*`, `border-*`, `ring-*` | accent-1..12, secondary-1..12, surface-*, error-*, success-*, warning-*, info-*, category-*, link-* |
+| `--spacing-ds-*` | `p-ds-03`, `m-ds-04`, `gap-ds-05`, `w-ds-md`, `h-ds-lg` | ds-namespaced to avoid collision with consumer numeric `p-4` etc. |
+| `--text-ds-*` | `text-ds-md`, `text-ds-lg` | ds-namespaced; consumer `text-lg` still works |
+| `--leading-ds-*` | `leading-ds-tight`, `leading-ds-normal` | ds-namespaced |
+| `--tracking-*` | `tracking-tight`, `tracking-normal` | standard TW namespace |
+| `--font-*`, `--font-weight-*` | `font-sans`, `font-semibold` | standard TW namespace |
+| `--radius`, `--radius-ds-*` | `rounded` (bare), `rounded-ds-lg` | unprefixed + ds-namespaced |
+| `--shadow-*` | `shadow-raised`, `shadow-overlay` | semantic names only; bare `shadow` is NOT generated (TW4 has no default scale and we don't define `--shadow`) |
+| `--ease-*` | `ease-productive-standard` | semantic names |
+| `--breakpoint-*` | `md:`, `lg:` | standard TW namespace |
+| `--animate-*` | `animate-skeleton-shimmer`, `animate-processing-ants-*` | named animations |
+
+### Utilities declared via `@utility` (not token-driven)
+
+TW4 has no `--z-*` or `--duration-*` auto-namespace, so these are explicit:
+
+- **Z-layer:** `z-base`, `z-raised`, `z-dropdown`, `z-sticky`, `z-overlay`, `z-modal`, `z-popover`, `z-toast`, `z-tooltip`
+- **Named durations:** `duration-instant`, `duration-fast-01`, `duration-fast-02`, `duration-moderate-01`, `duration-moderate-01b`, `duration-moderate-02`, `duration-slow-01`, `duration-slow-02`
+- **Typography composites:** `text-heading-{2xl|xl|lg|md|sm|xs}`, `text-body-{lg|md|sm|xs}`, `text-label-{lg|md|sm|xs}`, `text-label-plain-{lg|md|sm}`, `text-caption`, `text-overline`, `text-code`
+- **Focus rings:** `focus-ring`, `focus-ring-inset`, `focus-ring-sm`
+- **Touch target:** `touch-target` (44×44 WCAG hit area via `::before`)
+- **Safe-area insets:** `pt-safe`, `pb-safe`, `pl-safe`, `pr-safe`, `p-safe`
+- **Number formatting:** `tabular-nums`
+
+### Dark mode
+
+`.dark` class-based. The `@custom-variant dark (&:where(.dark *))` declaration means `dark:` utilities apply to **descendants** of `.dark`, not the element itself. Put `.dark` on `<html>` (standard pattern for `next-themes`) or `<body>`.
+
+### Dead in TW4 — do NOT generate these
+
+| Dead pattern | Replacement |
+|---|---|
+| `w-[--var]` | `w-(--var)` |
+| `theme(spacing.N)` inside arbitrary values | literal value |
+| `bg-gradient-to-*` | `bg-linear-to-*` |
+| bare `shadow` | `shadow-sm`, `shadow-raised`, etc. |
+| `outline-none` | `outline-hidden` |
+| `rounded-sm` | `rounded-xs` |
+| `!prefix` | `suffix!` |
+
+See `MIGRATION.md#v0370--tailwind-4-css-first-migration` (root of this package).
 
 ---
 

package/docs/rollback.md

@@ -0,0 +1,179 @@
+# Release Rollback Playbook
+
+Every scenario below is a copy-pasteable command sequence. No prose to interpret under pressure.
+
+Rule of thumb when something ships broken:
+1. **First, flip `latest` back.** That stops new installs from pulling the bad version.
+2. **Then, deprecate.** That warns consumers who already installed.
+3. **Then (within 72h only), unpublish** if the bad version is actively harmful and no consumer should keep it.
+4. **Then, patch.** Cut a fix release ASAP.
+
+Do these steps in order. Don't skip step 1 — `npm deprecate` alone does NOT remove the bad version from `latest`; new installs keep getting it.
+
+---
+
+## Scenario 1: 0.37.0 just published, it's catastrophic (bricks consumer builds)
+
+```sh
+# 1. Demote 0.37.0 from @latest. New pnpm/npm installs will resolve to 0.36.1 again.
+npm dist-tag add @devalok/shilp-sutra@0.36.1 latest
+
+# 2. Deprecate 0.37.0 so consumers who already installed see a warning.
+npm deprecate @devalok/shilp-sutra@0.37.0 \
+  "Critical issue — downgrade to 0.36.1 or await 0.37.1. See https://github.com/devalok-design/shilp-sutra/issues"
+
+# 3. Verify the flip took effect.
+npm view @devalok/shilp-sutra dist-tags
+# Should show: { latest: '0.36.1', 'latest-0.36': '0.36.1', next: '0.37.0-...' }
+
+# 4. Unpublish ONLY if actively harmful. Available for 72h after publish.
+#    This permanently removes the version from the registry. Cannot be re-published
+#    at the same version number — you'd have to go to 0.37.0-hotfix.0 or 0.37.1.
+# npm unpublish @devalok/shilp-sutra@0.37.0
+```
+
+Post-rollback: cut a 0.37.1 fix on a branch, repeat RC flow (see MIGRATION.md §RC).
+
+---
+
+## Scenario 2: RC (0.37.0-next.N) is broken, stable 0.37.0 not yet published
+
+```sh
+# No action on @latest — it still points to 0.36.1.
+# Just deprecate the bad RC and publish a new one.
+
+npm deprecate @devalok/shilp-sutra@0.37.0-next.0 \
+  "Superseded. Use @next for the current prerelease."
+
+# Then commit fix + let the Release workflow auto-publish 0.37.0-next.1.
+```
+
+---
+
+## Scenario 3: Consumer is blocked post-0.37.0 publish but bug is small
+
+Don't rollback. Cut 0.37.1 as a fast patch on the 0.37 branch.
+
+```sh
+# On your migration branch or fresh branch from 0.37.0 commit:
+pnpm changeset                    # bump patch
+# commit + push + PR + merge
+# Release workflow auto-publishes 0.37.1 to @latest within ~15 min
+```
+
+Advise the affected consumer to wait for 0.37.1 (usually faster than their rollback).
+
+---
+
+## Scenario 4: Compromised NPM_TOKEN, may have published tainted versions
+
+```sh
+# 1. IMMEDIATELY rotate the token.
+#    a. Revoke old token on npmjs.com
+#    b. Generate new Automation token (Classic, bypass 2FA)
+#    c. gh secret set NPM_TOKEN --repo devalok-design/shilp-sutra
+#       (paste new token when prompted)
+
+# 2. Audit the last N publishes.
+npm audit signatures @devalok/shilp-sutra
+
+# 3. Any version published under the old token that you cannot vouch for:
+npm unpublish @devalok/shilp-sutra@<tainted-version>    # within 72h
+npm deprecate @devalok/shilp-sutra@<tainted-version> "Compromised token — re-pull from <clean-version>"
+
+# 4. Re-publish the same content from a known-good commit under the new token.
+
+# 5. Migrate to OIDC trusted publishing so you don't have a long-lived token
+#    at risk again. See docs/plans/2026-04-19-tw4-native-migration-0.37.md §−1d.
+```
+
+---
+
+## Scenario 5: Needed to pin a consumer to an older stable while debugging
+
+Consumer can pin via the `latest-0.36` dist-tag instead of hardcoding a version number:
+
+```sh
+# In the consumer repo:
+pnpm add @devalok/shilp-sutra@latest-0.36
+# Resolves to whatever we've tagged as latest-0.36 (currently 0.36.1)
+```
+
+Confirm the tag exists:
+```sh
+npm view @devalok/shilp-sutra dist-tags
+```
+
+Maintainer tip: any time we publish a new 0.36.x patch, also bump `latest-0.36` to point at it:
+```sh
+npm dist-tag add @devalok/shilp-sutra@0.36.2 latest-0.36
+```
+
+---
+
+## Scenario 6: Accidentally published 0.37.0-next.N to @latest instead of @next
+
+(Common Changesets mistake — `pre exit` was forgotten, or someone manually ran `pnpm publish` without `--tag`.)
+
+```sh
+# 1. Flip latest back.
+npm dist-tag add @devalok/shilp-sutra@0.36.1 latest
+
+# 2. Re-tag the prerelease correctly.
+npm dist-tag add @devalok/shilp-sutra@0.37.0-next.N next
+
+# 3. Verify.
+npm view @devalok/shilp-sutra dist-tags
+```
+
+No deprecate or unpublish needed — the version is valid, it was just mis-tagged.
+
+---
+
+## Reference: npm command semantics
+
+| Command | What it does | When to use |
+|---|---|---|
+| `npm dist-tag add <pkg>@<version> <tag>` | Points `<tag>` at `<version>`. Moves the tag if it already exists. | Flipping `latest`. Setting `latest-0.36`. Moving `next`. |
+| `npm deprecate <pkg>@<spec> <msg>` | Adds install-time warning. **Does NOT remove the version.** New `@latest` installs still pull it unless the dist-tag is also flipped. | Warning consumers about a bad version. |
+| `npm unpublish <pkg>@<version>` | Permanently removes the version from the registry. Allowed **only within 72h of publish**. Cannot re-publish the same version number. | Actively harmful versions. |
+| `npm unpublish <pkg>` | Unpublishes the entire package. Almost never what you want. | Accidentally published a typosquat. |
+| `npm audit signatures` | Verifies signatures of published versions. Useful post-token-compromise. | Suspected supply-chain incident. |
+
+## What dist-tags are currently set
+
+Run `npm view @devalok/shilp-sutra dist-tags` to see the live state. The list we maintain:
+
+- `latest` — current stable.
+- `latest-0.36` — pinned to the highest 0.36.x for consumers who can't yet migrate to 0.37.
+- `next` — current prerelease (e.g., `0.37.0-next.N`).
+
+If any of those show `undefined` or an unexpected version, treat it as an incident and escalate.
+
+---
+
+## Rollback drill — what, when, who
+
+This playbook is only as good as its last rehearsal. Do a real drill BEFORE every breaking release (0.37.0, 0.38.0, 1.0.0, etc.) so the commands aren't first-run under pressure.
+
+### Drill procedure (15 min)
+
+1. Publish a throwaway RC under the `next` dist-tag:
+   ```sh
+   # On a throwaway branch, cut a changeset patch bump to e.g. 0.37.0-next.999
+   pnpm changeset version
+   # Let the Release workflow publish it to @next
+   ```
+2. Verify: `npm view @devalok/shilp-sutra@0.37.0-next.999 version` returns `0.37.0-next.999`.
+3. Walk Scenario 1 against this throwaway version — replace `0.37.0` with `0.37.0-next.999` and `0.36.1` with the current `@latest`:
+   ```sh
+   npm dist-tag add @devalok/shilp-sutra@<current-latest> latest
+   npm deprecate @devalok/shilp-sutra@0.37.0-next.999 "Drill — not a real incident"
+   npm unpublish @devalok/shilp-sutra@0.37.0-next.999    # within 72h
+   ```
+4. Confirm `npm view @devalok/shilp-sutra dist-tags` shows the expected post-drill state.
+5. Document any step where the command output surprised you, and update this file.
+
+### When to skip
+
+Never skip for breaking releases. Skippable for patches/minors of an already-drilled major, provided the drill is less than 6 months old.

package/llms-full.txt

@@ -5,7 +5,103 @@
 > All variant values and props verified from source CVA definitions.
 >
 > Package: @devalok/shilp-sutra
-> Version: 0.36.1
+> Version: 0.37.0-next.1
+>
+> **If you are an AI agent reading this file top-to-bottom:** the Setup
+> section below is authoritative. If any later per-component doc or a
+> pre-0.37 history entry shows `tailwind.config.ts` / `presets: [shilpSutra]`
+> / `@config`, that is HISTORICAL and does NOT apply on 0.37+.
+
+---
+
+## Setup (0.37.0+ — Tailwind 4 CSS-first)
+
+**The only supported setup** is TW4 CSS-first. No JS preset, no `tailwind.config.ts` required from us.
+
+```sh
+pnpm add @devalok/shilp-sutra@next framer-motion
+# Only if you render <Toaster />:
+pnpm add sonner
+```
+
+```css
+/* app/globals.css */
+@import "tailwindcss";
+@import "@devalok/shilp-sutra/css";
+
+/* Your own extensions go in the same file */
+@plugin "@tailwindcss/typography";
+@source "./app/**/*.{ts,tsx}";
+```
+
+```ts
+// next.config.ts
+transpilePackages: ['@devalok/shilp-sutra', '@devalok/shilp-sutra-brand'],
+```
+
+**Do NOT** import `@devalok/shilp-sutra/tailwind` in a `tailwind.config.ts`. That export is a deprecated no-op stub and logs a dev-mode `console.warn`. It is scheduled for removal in 0.38.
+
+### Peer dependencies (0.37.0)
+
+| Package | Role | Install when |
+|---|---|---|
+| `react`, `react-dom` | required peer | always |
+| `tailwindcss ^4.0.0` | required peer | always |
+| `framer-motion ^12.0.0` | required peer | always — module-scoped motion contexts must be single-copy |
+| `sonner ^2.0.0` | optional peer | only if you render `<Toaster />` or call `toast()` |
+| `@tabler/icons-react` | optional peer | if you use `Icon` / icon-bearing components |
+| `@tanstack/react-table`, `@tanstack/react-virtual` | optional peer | if you use `DataTable` |
+| `@tiptap/*` | optional peer | if you use `RichTextEditor` or `RichChatInput` |
+| `react-pdf`, `react-zoom-pan-pinch` | optional peer | if you use `FilePreview` |
+| `react-markdown`, `remark-gfm` | optional peer | if you use `MarkdownViewer` |
+| `date-fns` | optional peer | if you use `DatePicker` / `ScheduleView` |
+| `input-otp` | optional peer | if you use `InputOTP` |
+
+### Token namespaces exposed by our `/css` import
+
+| TW4 namespace | Generates utilities like | Our tokens |
+|---|---|---|
+| `--color-*` | `bg-*`, `text-*`, `border-*`, `ring-*` | accent-1..12, secondary-1..12, surface-*, error-*, success-*, warning-*, info-*, category-*, link-* |
+| `--spacing-ds-*` | `p-ds-03`, `m-ds-04`, `gap-ds-05`, `w-ds-md`, `h-ds-lg` | ds-namespaced to avoid collision with consumer numeric `p-4` etc. |
+| `--text-ds-*` | `text-ds-md`, `text-ds-lg` | ds-namespaced; consumer `text-lg` still works |
+| `--leading-ds-*` | `leading-ds-tight`, `leading-ds-normal` | ds-namespaced |
+| `--tracking-*` | `tracking-tight`, `tracking-normal` | standard TW namespace |
+| `--font-*`, `--font-weight-*` | `font-sans`, `font-semibold` | standard TW namespace |
+| `--radius`, `--radius-ds-*` | `rounded` (bare), `rounded-ds-lg` | unprefixed + ds-namespaced |
+| `--shadow-*` | `shadow-raised`, `shadow-overlay` | semantic names only; bare `shadow` is NOT generated (TW4 has no default scale and we don't define `--shadow`) |
+| `--ease-*` | `ease-productive-standard` | semantic names |
+| `--breakpoint-*` | `md:`, `lg:` | standard TW namespace |
+| `--animate-*` | `animate-skeleton-shimmer`, `animate-processing-ants-*` | named animations |
+
+### Utilities declared via `@utility` (not token-driven)
+
+TW4 has no `--z-*` or `--duration-*` auto-namespace, so these are explicit:
+
+- **Z-layer:** `z-base`, `z-raised`, `z-dropdown`, `z-sticky`, `z-overlay`, `z-modal`, `z-popover`, `z-toast`, `z-tooltip`
+- **Named durations:** `duration-instant`, `duration-fast-01`, `duration-fast-02`, `duration-moderate-01`, `duration-moderate-01b`, `duration-moderate-02`, `duration-slow-01`, `duration-slow-02`
+- **Typography composites:** `text-heading-{2xl|xl|lg|md|sm|xs}`, `text-body-{lg|md|sm|xs}`, `text-label-{lg|md|sm|xs}`, `text-label-plain-{lg|md|sm}`, `text-caption`, `text-overline`, `text-code`
+- **Focus rings:** `focus-ring`, `focus-ring-inset`, `focus-ring-sm`
+- **Touch target:** `touch-target` (44×44 WCAG hit area via `::before`)
+- **Safe-area insets:** `pt-safe`, `pb-safe`, `pl-safe`, `pr-safe`, `p-safe`
+- **Number formatting:** `tabular-nums`
+
+### Dark mode
+
+`.dark` class-based. The `@custom-variant dark (&:where(.dark *))` declaration means `dark:` utilities apply to **descendants** of `.dark`, not the element itself. Put `.dark` on `<html>` (standard pattern for `next-themes`) or `<body>`.
+
+### Dead in TW4 — do NOT generate these
+
+| Dead pattern | Replacement |
+|---|---|
+| `w-[--var]` | `w-(--var)` |
+| `theme(spacing.N)` inside arbitrary values | literal value |
+| `bg-gradient-to-*` | `bg-linear-to-*` |
+| bare `shadow` | `shadow-sm`, `shadow-raised`, etc. |
+| `outline-none` | `outline-hidden` |
+| `rounded-sm` | `rounded-xs` |
+| `!prefix` | `suffix!` |
+
+See `MIGRATION.md#v0370--tailwind-4-css-first-migration` (root of this package).
 
 ---
 

package/llms.txt

@@ -1,9 +1,29 @@
 # @devalok/shilp-sutra
 
-> Radix UI + Tailwind CSS + CVA design system for Devalok apps.
+> Radix UI + Tailwind 4 (CSS-first) + CVA design system for Devalok apps.
 > Built on the same primitives as shadcn/ui but with key API differences.
 > Read this file BEFORE writing any UI code. Do NOT guess from shadcn/ui knowledge.
 
+## BREAKING CHANGES (v0.37.0 — Tailwind 4 CSS-first)
+
+**Setup migration only — component APIs unchanged.** See `MIGRATION.md` at the root of this package (or https://github.com/devalok-design/shilp-sutra/blob/main/MIGRATION.md#v0370--tailwind-4-css-first-migration) for the full guide.
+
+- **No more JS preset.** `tailwind.config.ts` with `presets: [shilpSutra]` is gone. Tokens ship as TW4 `@theme` CSS via a single CSS import. Consumer setup becomes:
+  ```css
+  @import "tailwindcss";
+  @import "@devalok/shilp-sutra/css";
+  ```
+  The old `./tailwind` export is a deprecated no-op stub; importing it logs a dev-mode `console.warn` and is scheduled for removal in 0.38.
+- **framer-motion is now a required peer dep.** Previously bundled. Install: `pnpm add framer-motion`. Module-scoped React contexts (MotionConfig, LayoutGroup, AnimatePresence) must be single-copy — the peer declaration forces pnpm to dedupe against the consumer's version.
+- **sonner is now an optional peer dep.** Install only if you render `<Toaster />`: `pnpm add sonner`.
+- **tailwindcss peer tightened to `^4.0.0`.** No more `^3.4.0 || ^4.0.0`.
+- **use-sync-external-store moved to our `dependencies`** (from optional peer). Auto-installed transitively.
+- **Node engines floor dropped.** No `engines.node` declared — use any Node 18+.
+- **New export `@devalok/shilp-sutra/css`** — primary consumer entry for TW4 setup.
+- **Source class hygiene:** `w-[--var]` → `w-(--var)`, `theme(spacing.N)` → literal, `bg-gradient-to-*` → `bg-linear-to-*`, bare `shadow` → explicit like `shadow-raised`. Codemod your own code; grep: `grep -rn 'w-\[--\|bg-gradient-to-\|theme(spacing' src/`.
+- **Tokens now expose TW4 namespaces.** Spacing is `--spacing-ds-*` (so `p-ds-03`, not `p-3`). Typography uses `--text-ds-*`, `--leading-ds-*`. Radius is unprefixed (`--radius`, `--radius-ds-*`). Z-layer utilities are custom-generated (`z-popover`, `z-dropdown`, etc.).
+- **Dark mode variant:** `@custom-variant dark (&:where(.dark *))` — identical semantics to old `darkMode: 'class'`. `.dark` on `<html>` or `<body>` activates everything below.
+
 ## NEW (v0.36.0)
 
 - **Forced-colors (Windows high-contrast) support.** Every semantic color token remaps to system keywords (`Canvas`, `CanvasText`, `Highlight`, `HighlightText`, `LinkText`, `GrayText`, `Mark`, `ButtonText`, `VisitedText`) under `@media (forced-colors: active)`. Focus ring forced via `outline: 2px solid Highlight`, interactive elements get visible borders, decorative grain + skeleton shimmer suppressed. Zero runtime impact when inactive.
@@ -46,7 +66,9 @@
 - **Chart a11y:** Keyboard tooltip access on BarChart/LineChart. `ariaDescription` on ChartContainer.
 - **Dev warnings:** Token-missing CSS detection + MotionProvider hint (dev mode only).
 
-## BREAKING CHANGES (v0.33.x — Tailwind 4 + Toolchain)
+## HISTORICAL: BREAKING CHANGES (v0.33.x — Tailwind 4 + Toolchain)
+
+> **Note:** The v0.33 peer range `^3.4.0 || ^4.0.0` and `@config` directive requirement are superseded by v0.37 (TW4-only, CSS-first, no `@config`). Keep reading if you're upgrading from < 0.33; otherwise skip to v0.37 above.
 
 - **Tailwind CSS 3 → 4:** `outline-none` → `outline-hidden`, `rounded-sm` → `rounded-xs`, `backdrop-blur-sm` → `backdrop-blur-xs`, `!prefix` → `suffix!` important syntax. Consumers using our preset: add `@import "tailwindcss"` + `@config` to your CSS, replace `darkMode: 'class'` with `@variant dark (&:is(.dark *))` in CSS. Peer dep accepts both `^3.4.0 || ^4.0.0`.
 - **tailwind-merge 3.0 → 3.5:** Required for TW4 class recognition.