tailwind-canonical 0.7.0 → 0.8.0

package/README.md

@@ -140,6 +140,11 @@ npx tailwind-canonical --fix --reporter json ./src
 npx tailwind-canonical --reporter sarif ./src > results.sarif
 ```
 
+Each result's `artifactLocation.uri` is relative to the git root (falling back to the working
+directory), with `uriBaseId: "%SRCROOT%"`, so Code Scanning maps it from any subdirectory.
+Results also carry `level`, a full `region` (start/end column) and line-independent
+`partialFingerprints`; `tool.driver.version` records the emitting version.
+
 **GitHub Actions integration:**
 ```yaml
 - run: npx tailwind-canonical --reporter sarif ./src > results.sarif
@@ -347,12 +352,42 @@ left-2 right-2                  → inset-x-2
 | `text-[12px]` | `text-xs` | Built-in |
 | `text-[0.75rem]` | `text-xs` | rem values |
 | `h-[64px]` | `h-16` | Spacing scale ÷4 |
+| `p-[1px]` / `gap-[1px]` | `p-px` / `gap-px` | 1px spacing step |
 | `w-[50%]` | `w-1/2` | Percentage fractions |
-| `opacity-[0.5]` | `opacity-50` | Opacity scale |
-| `text-[11px]` | `text-2xs` | Built-in extra token |
-| `text-[8px]`–`text-[10px]` | `text-3xs` | Built-in extra token |
+| `w-[100%]` / `basis-[100%]` | `w-full` / `basis-full` | Sizing, inset, translate, basis |
+| `h-[100vh]` / `w-[100vw]` | `h-screen` / `w-screen` | Axis-checked; `min-w-screen` is v4-only |
+| `h-[100dvh]` / `svh` / `lvh` | `h-dvh` / `h-svh` / `h-lvh` | v4 only |
+| `w-[auto]` / `mx-[auto]` | `w-auto` / `mx-auto` | Never negated |
+| `w-[fit-content]` / `min-content` / `max-content` | `w-fit` / `w-min` / `w-max` | |
+| `p-[0]` / `top-[0]` | `p-0` / `top-0` | Unitless zero |
+| `aspect-[16/9]` / `aspect-[1/1]` | `aspect-video` / `aspect-square` | Other ratios (`aspect-4/3`) v4 only |
+| `rounded-[9999px]` | `rounded-full` | |
+| `opacity-[0.5]` / `opacity-[.5]` | `opacity-50` | Opacity scale |
+| `border-[1px]` / `border-t-[1px]` | `border` / `border-t` | Bare = 1px; `[0/2/4/8px]` → `border-0/2/4/8` |
+| `divide-x-[1px]` | `divide-x` | Same scale as `border` |
+| `ring-[1px]` / `outline-[2px]` | `ring-1` / `outline-2` | Never bare: `ring` is 3px on v3 |
+| `duration-[200ms]` / `delay-[0.15s]` | `duration-200` / `delay-150` | ms or s |
+| `scale-[1.05]` / `scale-x-[95%]` | `scale-105` / `scale-x-95` | Factor or percentage |
+| `rotate-[45deg]` | `rotate-45` | Integer degrees |
+| `blur-[4px]` | `blur-xs` | `blur-sm` with `tailwindVersion: 3` |
+| `z-[10]` | `z-10` | Any integer on v4 |
+| `font-[700]` | `font-bold` | Weights 100–900 |
+| `leading-[24px]` / `leading-[1.5rem]` | `leading-6` | Spacing scale ÷4 |
+| `leading-[1.5]` | `leading-normal` | `none`, `tight`, `snug`, `normal`, `relaxed`, `loose` |
+| `order-[1]` / `order-[0]` | `order-1` / `order-none` | Any integer on v4 |
+| `grow-[1]` / `shrink-[0]` | `grow` / `shrink-0` | |
+| `line-clamp-[3]`, `columns-[3]` | `line-clamp-3`, `columns-3` | Any integer ≥ 1 on v4 |
+| `text-[11px]` | `text-2xs` | Requires `customTextTokens` |
+| `text-[8px]`–`text-[10px]` | `text-3xs` | Requires `customTextTokens` |
+| `hover:p-[16px]` | `hover:p-4` | Variants are preserved |
+| `!p-[16px]` / `p-[16px]!` | `!p-4` / `p-4!` | Important modifier kept in place |
+| `-mt-[8px]` / `mt-[-8px]` | `-mt-2` | Negative margin / inset / translate / space / scale / rotate / z / order only |
+
+`text-2xs` and `text-3xs` are not stock Tailwind tokens, so they are not in the built-in text size map — without config, `text-[11px]` and `text-[8px]`–`text-[10px]` are left untouched. Enable them with `customTextTokens`:
 
-`text-2xs` (11px) and `text-3xs` (8–10px) are part of the built-in text size map — they convert with no config. Override or extend the map via `customTextTokens`.
+```ts
+export default { customTextTokens: { 8: '3xs', 9: '3xs', 10: '3xs', 11: '2xs' } }
+```
 
 Non-divisible values (`h-[22px]`, `px-[7px]`) are left untouched.
 
@@ -384,14 +419,36 @@ scale differs per utility, not just per family:
 | `top-[20%]` | `top-1/5` | untouched — v3.3 stops at quarters here |
 | `top-[25%]` | `top-1/4` | `top-1/4` |
 | `w-[8.333333%]` | `w-1/12` | `w-1/12` — `w` carries the full set |
+| `duration-[250ms]` | `duration-250` | untouched — not on the v3 scale |
+| `scale-[1.15]` | `scale-115` | untouched — not on the v3 scale |
+| `rotate-[30deg]` | `rotate-30` | untouched — not on the v3 scale |
+| `blur-[4px]` | `blur-xs` | `blur-sm` — v3 names are one step lower |
+| `blur-[8px]` | `blur-sm` | `blur` |
+| `z-[15]` | `z-15` | untouched — v3 stops at `0`–`50` in tens |
+| `leading-[44px]` | `leading-11` | untouched — v3 ships `leading-3`–`leading-10` |
+| `order-[13]` | `order-13` | untouched — v3 ships `1`–`12` |
+| `grow-[2]` | `grow-2` | untouched — v3 ships `grow` and `grow-0` |
+| `line-clamp-[7]` | `line-clamp-7` | untouched — v3 ships `1`–`6` |
+| `columns-[13]` | `columns-13` | untouched — v3 ships `1`–`12` |
 
 Spacing steps: `size-*` has no numeric scale in v3.3, and `min-w-*`, `max-w-*`
 and `min-h-*` only ship the zero step — they gained the scale afterwards.
 Fractions: `w` carries all thirteen, `h` stops at sixths, `inset`/`top`/`left`/
 `right`/`bottom`/`translate-x`/`translate-y` only have halves, thirds and
 quarters, and `min-w`/`max-w`/`min-h`/`max-h` have none.
-
-`text-*`, `rounded-*` and `opacity-*` are identical in both majors and are
+`duration-*`/`delay-*` stop at 0, 75, 100, 150, 200, 300, 500, 700 and 1000;
+`scale-*` at 0, 50, 75, 90, 95, 100, 105, 110, 125 and 150; `rotate-*` at 0, 1,
+2, 3, 6, 12, 45, 90 and 180. v4 accepts any integer for all four.
+
+`*-px` follows the same per-utility gating: `size-px`, `min-w-px`, `max-w-px`
+and `min-h-px` are left untouched on v3.
+
+`rounded-*` follows each major's radius scale: v4 renamed the small end, so
+`rounded-[2px]` → `rounded-xs` and `rounded-[4px]` → `rounded-sm` on v4, but
+`rounded-sm` and bare `rounded` on v3; `rounded-[32px]` → `rounded-4xl` is
+v4-only. `text-*`, `opacity-*`, `font-*` weights, the `leading-*`
+keywords and the `border`/`divide`/`ring`/`outline`
+widths are identical in both majors and are
 never gated. `customSpacingTokens` stays your decision and is applied in both
 modes. All of the above was measured against `tailwindcss@3.3.7`, the
 advertised floor.

package/dist/cli/cli.d.ts

@@ -1,13 +1,5 @@
-export type Sink = {
-    log: (s: string) => void;
-    error: (s: string) => void;
-    write: (s: string) => void;
-};
-export type RunResult = {
-    exitCode: number;
-    watching?: boolean;
-};
-type Reporter = 'text' | 'json' | 'sarif';
+import type { Reporter, RunResult, Sink } from './types.js';
+export type { RunResult, Sink } from './types.js';
 type Flags = {
     fix: boolean;
     merge: boolean;
@@ -37,4 +29,3 @@ export declare function parseArgs(argv: string[]): Flags;
  */
 export declare function flagWarnings(flags: Flags): string[];
 export declare function run(argv: string[], cwd: string, sink?: Sink): Promise<RunResult>;
-export {};