@phcdevworks/spectre-tokens 2.6.0 → 2.8.0

package/README.md

@@ -1,21 +1,23 @@
 # @phcdevworks/spectre-tokens
 
 [![npm version](https://img.shields.io/npm/v/@phcdevworks/spectre-tokens)](https://www.npmjs.com/package/@phcdevworks/spectre-tokens)
-[![CI](https://img.shields.io/github/actions/workflow/status/phcdevworks/spectre-tokens/ci.yml?branch=main&label=CI)](https://github.com/phcdevworks/spectre-tokens/actions/workflows/ci.yml)
-[![License](https://img.shields.io/github/license/phcdevworks/spectre-tokens)](LICENSE)
-[![Node](https://img.shields.io/badge/node-%5E22.12.0%20%7C%7C%20%3E%3D24.0.0-brightgreen)](https://nodejs.org)
+[![CI](https://github.com/phcdevworks/spectre-tokens/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/phcdevworks/spectre-tokens/actions/workflows/ci.yml)
+[![License](https://img.shields.io/npm/l/@phcdevworks/spectre-tokens)](LICENSE)
+[![Node](https://img.shields.io/node/v/@phcdevworks/spectre-tokens)](https://nodejs.org)
 
-`@phcdevworks/spectre-tokens` is the design-token package of the Spectre system
-for downstream Spectre packages and compatible applications.
+`@phcdevworks/spectre-tokens` is the design-token package of the Spectre system.
+It provides a complete, UI-ready token surface for downstream Spectre packages
+and compatible applications.
 
 Maintained by PHCDevworks, it defines the visual language, semantic roles, and
-token contracts consumed downstream. It keeps visual meaning centralized in
-token data while downstream UI packages define structure and adapter packages
-translate those contracts for specific frameworks and runtimes.
+token contracts that downstream consumers can rely on without filling gaps with
+raw palette values or local token inventions. Downstream UI packages define
+structure; adapter packages translate Spectre contracts for specific frameworks
+and runtimes.
 
-[Contributing](CONTRIBUTING.md) | [Changelog](CHANGELOG.md) |
-[Token Contract](TOKEN_CONTRACT.md) | [Roadmap](ROADMAP.md) |
-[Security Policy](SECURITY.md)
+[Contributing](CONTRIBUTING.md) | [Code of Conduct](CODE_OF_CONDUCT.md) |
+[Changelog](CHANGELOG.md) | [Token Contract](TOKEN_CONTRACT.md) |
+[Roadmap](ROADMAP.md) | [Security Policy](SECURITY.md)
 
 ## Source of truth
 
@@ -425,14 +427,14 @@ npm install
 npm run check
 ```
 
-This project expects Node.js `^22.12.0 || >=24.0.0` and npm `11.14.1`.
+This project expects Node.js `^22.12.0 || >=24.0.0` and npm `11.16.0`.
 
 ### Common commands
 
 | Command | What it does |
 |---|---|
 | `npm run build` | Regenerate all outputs — run after any token source change |
-| `npm run check` | Full validation gate — all 14 steps must pass before commit |
+| `npm run check` | Full validation gate — all 15 steps must pass before commit |
 | `npm run lint` | Run ESLint against all source files |
 | `npm run format` | Apply Prettier formatting to all files |
 | `npm run generate` | Regenerate `src/generated/tokens.ts` from token sources only |

package/dist/index.cjs

@@ -134,7 +134,8 @@ var coreTokens = {
       "bgDisabled": "{colors.error.200}",
       "text": "{colors.white}",
       "textDisabled": "{colors.neutral.400}",
-      "focusRing": "{colors.error.500} / 0.4"
+      "focusRing": "{colors.error.500} / 0.4",
+      "focusVisible": "{colors.error.500} / 0.4"
     },
     "success": {
       "bg": "{colors.success.700}",
@@ -143,7 +144,8 @@ var coreTokens = {
       "bgDisabled": "{colors.success.200}",
       "text": "{colors.white}",
       "textDisabled": "{colors.neutral.400}",
-      "focusRing": "{colors.success.500} / 0.4"
+      "focusRing": "{colors.success.500} / 0.4",
+      "focusVisible": "{colors.success.500} / 0.4"
     },
     "cta": {
       "bg": "{colors.brand.600}",
@@ -329,7 +331,7 @@ var coreTokens = {
         "badge": {
           "neutralBg": "{colors.neutral.700}",
           "neutralBgHover": "{colors.neutral.600}",
-          "neutralText": "{colors.neutral.100}",
+          "neutralText": "{colors.neutral.50}",
           "infoBg": "{colors.info.800}",
           "infoBgHover": "{colors.info.700}",
           "infoText": "{colors.info.100}",
@@ -472,26 +474,33 @@ var coreTokens = {
       "600": "#6f3fd7"
     },
     "focus": {
-      "primary": "#336df4",
-      "error": "#ef4444",
-      "info": "#0369a1"
+      "primary": "{colors.brand.500}",
+      "error": "{colors.error.500}",
+      "info": "{colors.info.600}"
     },
     "white": "#ffffff",
     "black": "#000000"
   },
   "space": {
     "0": "0rem",
+    "1": "0.0625rem",
+    "2": "0.125rem",
     "4": "0.25rem",
+    "6": "0.375rem",
     "8": "0.5rem",
+    "10": "0.625rem",
     "12": "0.75rem",
+    "14": "0.875rem",
     "16": "1rem",
     "20": "1.25rem",
     "24": "1.5rem",
+    "28": "1.75rem",
     "32": "2rem",
     "40": "2.5rem",
     "48": "3rem",
     "56": "3.5rem",
     "64": "4rem",
+    "72": "4.5rem",
     "80": "5rem",
     "96": "6rem"
   },
@@ -500,13 +509,19 @@ var coreTokens = {
     "sm": "2px",
     "md": "4px",
     "lg": "8px",
+    "xl": "12px",
+    "2xl": "16px",
+    "3xl": "24px",
+    "4xl": "32px",
     "pill": "999px"
   },
   "shadows": {
     "none": "none",
     "sm": "0 1px 2px 0 {colors.black} / 0.06",
     "md": "0 2px 6px -1px {colors.black} / 0.08",
-    "lg": "0 6px 16px -4px {colors.black} / 0.12"
+    "lg": "0 6px 16px -4px {colors.black} / 0.12",
+    "xl": "0 12px 24px -6px {colors.black} / 0.15",
+    "2xl": "0 20px 48px -12px {colors.black} / 0.20"
   },
   "breakpoints": {
     "sm": "640px",
@@ -523,64 +538,69 @@ var coreTokens = {
     "overlay": "1300",
     "modal": "1400",
     "popover": "1500",
-    "tooltip": "1600"
+    "tooltip": "1600",
+    "toast": "1700"
   },
   "transitions": {
     "duration": {
       "instant": "75ms",
       "fast": "150ms",
       "base": "200ms",
+      "relaxed": "250ms",
       "moderate": "300ms",
       "slow": "500ms",
-      "slower": "700ms"
+      "slower": "700ms",
+      "long": "1000ms",
+      "slowest": "1200ms"
     },
     "easing": {
       "linear": "linear",
       "in": "cubic-bezier(0.4, 0, 1, 1)",
       "out": "cubic-bezier(0, 0, 0.2, 1)",
       "inOut": "cubic-bezier(0.4, 0, 0.2, 1)",
-      "spring": "cubic-bezier(0.4, 0, 0.2, 1)"
+      "spring": "cubic-bezier(0.4, 0, 0.2, 1)",
+      "overshoot": "cubic-bezier(0.34, 1.56, 0.64, 1)"
     }
   },
   "animations": {
     "fadeIn": {
-      "duration": "200ms",
-      "easing": "cubic-bezier(0, 0, 0.2, 1)",
+      "duration": "{transitions.duration.base}",
+      "easing": "{transitions.easing.out}",
       "keyframes": "fade-in"
     },
     "fadeOut": {
-      "duration": "150ms",
-      "easing": "cubic-bezier(0.4, 0, 1, 1)",
+      "duration": "{transitions.duration.fast}",
+      "easing": "{transitions.easing.in}",
       "keyframes": "fade-out"
     },
     "slideUp": {
-      "duration": "300ms",
-      "easing": "cubic-bezier(0, 0, 0.2, 1)",
+      "duration": "{transitions.duration.moderate}",
+      "easing": "{transitions.easing.out}",
       "keyframes": "slide-up"
     },
     "slideDown": {
-      "duration": "300ms",
-      "easing": "cubic-bezier(0, 0, 0.2, 1)",
+      "duration": "{transitions.duration.moderate}",
+      "easing": "{transitions.easing.out}",
       "keyframes": "slide-down"
     },
     "scaleIn": {
-      "duration": "200ms",
-      "easing": "cubic-bezier(0.34, 1.56, 0.64, 1)",
+      "duration": "{transitions.duration.base}",
+      "easing": "{transitions.easing.overshoot}",
       "keyframes": "scale-in"
     },
     "bounce": {
-      "duration": "300ms",
-      "easing": "cubic-bezier(0.4, 0, 0.2, 1)",
+      "duration": "{transitions.duration.moderate}",
+      "easing": "{transitions.easing.spring}",
       "keyframes": "bounce"
     },
     "shake": {
-      "duration": "250ms",
-      "easing": "cubic-bezier(0.4, 0, 0.2, 1)",
+      "duration": "{transitions.duration.relaxed}",
+      "easing": "{transitions.easing.spring}",
       "keyframes": "shake"
     },
     "pulse": {
-      "duration": "1200ms",
-      "easing": "cubic-bezier(0.4, 0, 0.2, 1)",
+      "duration": "{transitions.duration.slowest}",
+      "easing": "{transitions.easing.spring}",
       "keyframes": "pulse"
     }
   },
@@ -588,6 +608,7 @@ var coreTokens = {
     "disabled": "0.38",
     "hover": "0.92",
     "active": "0.84",
+    "loading": "0.6",
     "focus": "1",
     "overlay": "0.5",
     "tooltip": "0.95"
@@ -595,6 +616,7 @@ var coreTokens = {
   "aspectRatios": {
     "square": "1/1",
     "video": "16/9",
+    "classic": "3/2",
     "portrait": "3/4",
     "landscape": "4/3",
     "ultrawide": "21/9",
@@ -620,8 +642,15 @@ var coreTokens = {
   },
   "border": {
     "width": {
+      "none": "0",
       "base": "1px",
       "thick": "2px"
+    },
+    "style": {
+      "none": "none",
+      "solid": "solid",
+      "dashed": "dashed",
+      "dotted": "dotted"
     }
   },
   "surface": {
@@ -685,47 +714,56 @@ var coreTokens = {
     "sm": {
       "size": "0.875rem",
       "lineHeight": "1.5rem",
-      "weight": 400
+      "weight": 400,
+      "letterSpacing": "0em"
     },
     "md": {
       "size": "1rem",
       "lineHeight": "1.75rem",
-      "weight": 500
+      "weight": 500,
+      "letterSpacing": "0em"
     },
     "lg": {
       "size": "1.25rem",
       "lineHeight": "2rem",
-      "weight": 600
+      "weight": 600,
+      "letterSpacing": "0em"
     },
     "xl": {
       "size": "1.5rem",
       "lineHeight": "2.125rem",
-      "weight": 600
+      "weight": 600,
+      "letterSpacing": "0em"
     },
     "2xl": {
       "size": "1.875rem",
       "lineHeight": "2.5rem",
-      "weight": 700
+      "weight": 700,
+      "letterSpacing": "0em"
     },
     "3xl": {
       "size": "2.25rem",
       "lineHeight": "2.75rem",
-      "weight": 700
+      "weight": 700,
+      "letterSpacing": "0em"
     },
     "4xl": {
       "size": "3rem",
       "lineHeight": "3.5rem",
-      "weight": 800
+      "weight": 800,
+      "letterSpacing": "0em"
     },
     "5xl": {
       "size": "3.75rem",
       "lineHeight": "4.25rem",
-      "weight": 800
+      "weight": 800,
+      "letterSpacing": "0em"
     },
     "6xl": {
       "size": "4.5rem",
       "lineHeight": "5rem",
-      "weight": 900
+      "weight": 900,
+      "letterSpacing": "0em"
     }
   },
   "typography": {
@@ -744,47 +782,56 @@ var coreTokens = {
       "sm": {
         "fontSize": "0.875rem",
         "lineHeight": "1.5rem",
-        "fontWeight": 400
+        "fontWeight": 400,
+        "letterSpacing": "0em"
       },
       "md": {
         "fontSize": "1rem",
         "lineHeight": "1.75rem",
-        "fontWeight": 500
+        "fontWeight": 500,
+        "letterSpacing": "0em"
       },
       "lg": {
         "fontSize": "1.25rem",
         "lineHeight": "2rem",
-        "fontWeight": 600
+        "fontWeight": 600,
+        "letterSpacing": "0em"
       },
       "xl": {
         "fontSize": "1.5rem",
         "lineHeight": "2.125rem",
-        "fontWeight": 600
+        "fontWeight": 600,
+        "letterSpacing": "0em"
       },
       "2xl": {
         "fontSize": "1.875rem",
         "lineHeight": "2.5rem",
-        "fontWeight": 700
+        "fontWeight": 700,
+        "letterSpacing": "0em"
       },
       "3xl": {
         "fontSize": "2.25rem",
         "lineHeight": "2.75rem",
-        "fontWeight": 700
+        "fontWeight": 700,
+        "letterSpacing": "0em"
       },
       "4xl": {
         "fontSize": "3rem",
         "lineHeight": "3.5rem",
-        "fontWeight": 800
+        "fontWeight": 800,
+        "letterSpacing": "0em"
       },
       "5xl": {
         "fontSize": "3.75rem",
         "lineHeight": "4.25rem",
-        "fontWeight": 800
+        "fontWeight": 800,
+        "letterSpacing": "0em"
       },
       "6xl": {
         "fontSize": "4.5rem",
         "lineHeight": "5rem",
-        "fontWeight": 900
+        "fontWeight": 900,
+        "letterSpacing": "0em"
       }
     }
   }
@@ -927,6 +974,11 @@ var createCssVariableMap = (tokens2, options = {}) => {
       assign(toVariableName(prefix, "border", "width", key), value);
     });
   }
+  if (border?.style) {
+    Object.entries(border.style).forEach(([key, value]) => {
+      assign(toVariableName(prefix, "border", "style", key), value);
+    });
+  }
   Object.entries(baseTokens.radii).forEach(([key, value]) => {
     assign(toVariableName(prefix, "radius", key), value);
   });
@@ -952,27 +1004,6 @@ var createCssVariableMap = (tokens2, options = {}) => {
     const scaleEntry = entry;
     assign(toVariableName(prefix, "font", key, "letter-spacing"), scaleEntry.letterSpacing);
   });
-  assign(toVariableName(prefix, "text", "on", "page", "default"), tokens2.text.onPage.default);
-  assign(toVariableName(prefix, "text", "on", "page", "muted"), tokens2.text.onPage.muted);
-  assign(toVariableName(prefix, "text", "on", "page", "subtle"), tokens2.text.onPage.subtle);
-  assign(toVariableName(prefix, "text", "on", "page", "meta"), tokens2.text.onPage.meta);
-  assign(toVariableName(prefix, "text", "on", "surface", "default"), tokens2.text.onSurface.default);
-  assign(toVariableName(prefix, "text", "on", "surface", "muted"), tokens2.text.onSurface.muted);
-  assign(toVariableName(prefix, "text", "on", "surface", "subtle"), tokens2.text.onSurface.subtle);
-  assign(toVariableName(prefix, "text", "on", "surface", "meta"), tokens2.text.onSurface.meta);
-  const badge = tokens2.component?.badge;
-  if (badge) {
-    BADGE_VARIANTS.forEach(({ variant, bgKey, textKey }) => {
-      assign(toVariableName(prefix, "badge", variant, "bg"), badge[bgKey]);
-      assign(toVariableName(prefix, "badge", variant, "text"), badge[textKey]);
-    });
-  }
-  const iconBox = tokens2.component?.iconBox;
-  if (iconBox) {
-    ICON_BOX_FIELDS.forEach(({ name, tokenKey }) => {
-      assign(toVariableName(prefix, "icon-box", name), iconBox[tokenKey]);
-    });
-  }
   Object.entries(baseTokens.shadows).forEach(([key, value]) => {
     assign(toVariableName(prefix, "shadow", key), value);
   });