@phcdevworks/spectre-tokens 2.1.1 → 2.1.2

package/README.md

@@ -18,8 +18,8 @@ translate those contracts for specific frameworks and runtimes.
 ## Key capabilities
 
 - Uses `tokens/` as the source of truth for design-token data
-- Generates JavaScript, TypeScript, Tailwind, and CSS outputs from shared token
-  sources
+- Generates JavaScript, TypeScript, CSS, and Tailwind theme exports from shared
+  token sources
 - Defines semantic token contracts for surfaces, text, components, buttons,
   forms, and modes
 - Exposes primitives and semantic roles for downstream packages and compatible
@@ -80,8 +80,8 @@ access is appropriate.
 
 - Visual language expressed as token data in `tokens/`
 - Semantic roles and token contracts consumed downstream
-- Generated token outputs for JavaScript, TypeScript, Tailwind, and CSS
-  variables
+- Generated token outputs for JavaScript, TypeScript, CSS variables, and
+  Tailwind theme exports
 - Theme and mode definitions used by downstream consumers
 
 ### Token model
@@ -181,7 +181,7 @@ Regenerate package outputs:
 npm run build
 ```
 
-Run validation checks:
+Run the full validation and release gate:
 
 ```bash
 npm run check
@@ -195,6 +195,10 @@ Key source areas:
 - `scripts/` for build and validation scripts
 - `example/` for usage examples
 
+The files in `example/` are illustrative token demos only. They help explain
+the token contract, but they are not the package contract itself and should not
+be treated as downstream UI primitives.
+
 ## Contributing
 
 PHCDevworks maintains this package as part of the Spectre system.
@@ -204,7 +208,9 @@ When contributing:
 - treat `tokens/` as the source of truth
 - keep generated outputs derived from source data
 - avoid breaking token contracts without an intentional major-version change
-- run `npm run build` and `npm run check` before opening a pull request
+- run `npm run build` to regenerate outputs when sources change
+- run `npm run check` as the full validation gate before opening a pull request
+- do not modify locked semantic color families without explicit approval
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for the full workflow.
 

package/dist/index.cjs

@@ -33,18 +33,30 @@ var coreTokens = {
   "component": {
     "card": {
       "text": {
-        "value": "{colors.neutral.900}"
+        "value": "{colors.neutral.900}",
+        "metadata": {
+          "pair": "surface.card"
+        }
       },
       "textMuted": {
-        "value": "{colors.neutral.500}"
+        "value": "{colors.neutral.500}",
+        "metadata": {
+          "pair": "surface.card"
+        }
       }
     },
     "input": {
       "text": {
-        "value": "{colors.neutral.900}"
+        "value": "{colors.neutral.900}",
+        "metadata": {
+          "pair": "surface.input"
+        }
       },
       "placeholder": {
-        "value": "{colors.neutral.400}"
+        "value": "{colors.neutral.500}",
+        "metadata": {
+          "pair": "forms.default.bg"
+        }
       }
     },
     "button": {
@@ -134,13 +146,19 @@ var coreTokens = {
     },
     "iconBox": {
       "bg": {
-        "value": "{colors.white}"
+        "value": "{colors.white}",
+        "metadata": {
+          "pair": "component.iconBox.iconDefault"
+        }
       },
       "border": {
         "value": "{colors.neutral.200}"
       },
       "iconDefault": {
-        "value": "{colors.info.600}"
+        "value": "{colors.info.600}",
+        "metadata": {
+          "pair": "component.iconBox.bg"
+        }
       },
       "iconSuccess": {
         "value": "{colors.success.600}"
@@ -154,19 +172,31 @@ var coreTokens = {
     },
     "testimonial": {
       "bg": {
-        "value": "{colors.white}"
+        "value": "{colors.white}",
+        "metadata": {
+          "pair": "component.testimonial.text"
+        }
       },
       "border": {
         "value": "{colors.neutral.200}"
       },
       "text": {
-        "value": "{colors.neutral.700}"
+        "value": "{colors.neutral.700}",
+        "metadata": {
+          "pair": "component.testimonial.bg"
+        }
       },
       "authorName": {
-        "value": "{colors.neutral.900}"
+        "value": "{colors.neutral.900}",
+        "metadata": {
+          "pair": "component.testimonial.bg"
+        }
       },
       "authorTitle": {
-        "value": "{colors.neutral.500}"
+        "value": "{colors.neutral.500}",
+        "metadata": {
+          "pair": "component.testimonial.bg"
+        }
       },
       "quoteMark": {
         "value": "{colors.neutral.300}"
@@ -175,7 +205,9 @@ var coreTokens = {
     "pricingCard": {
       "bg": {
         "value": "{colors.white}",
-        "metadata": {}
+        "metadata": {
+          "pair": "component.pricingCard.price"
+        }
       },
       "border": {
         "value": "{colors.neutral.200}",
@@ -203,11 +235,15 @@ var coreTokens = {
       },
       "price": {
         "value": "{colors.neutral.900}",
-        "metadata": {}
+        "metadata": {
+          "pair": "component.pricingCard.bg"
+        }
       },
       "priceDescription": {
         "value": "{colors.neutral.500}",
-        "metadata": {}
+        "metadata": {
+          "pair": "component.pricingCard.bg"
+        }
       }
     },
     "rating": {
@@ -218,7 +254,10 @@ var coreTokens = {
         "value": "{colors.neutral.200}"
       },
       "text": {
-        "value": "{colors.neutral.500}"
+        "value": "{colors.neutral.500}",
+        "metadata": {
+          "pair": "surface.card"
+        }
       }
     }
   },
@@ -466,7 +505,10 @@ var coreTokens = {
         "value": "{colors.neutral.900}"
       },
       "placeholder": {
-        "value": "{colors.neutral.400}"
+        "value": "{colors.neutral.500}",
+        "metadata": {
+          "pair": "forms.default.bg"
+        }
       }
     },
     "hover": {
@@ -625,18 +667,30 @@ var coreTokens = {
       "component": {
         "card": {
           "text": {
-            "value": "{colors.neutral.900}"
+            "value": "{colors.neutral.900}",
+            "metadata": {
+              "pair": "modes.default.surface.card"
+            }
           },
           "textMuted": {
-            "value": "{colors.neutral.500}"
+            "value": "{colors.neutral.500}",
+            "metadata": {
+              "pair": "modes.default.surface.card"
+            }
           }
         },
         "input": {
           "text": {
-            "value": "{colors.neutral.900}"
+            "value": "{colors.neutral.900}",
+            "metadata": {
+              "pair": "modes.default.surface.input"
+            }
           },
           "placeholder": {
-            "value": "{colors.neutral.400}"
+            "value": "{colors.neutral.500}",
+            "metadata": {
+              "pair": "modes.default.surface.input"
+            }
           }
         },
         "button": {
@@ -654,6 +708,12 @@ var coreTokens = {
               "pair": "modes.default.component.badge.neutralText"
             }
           },
+          "neutralBgHover": {
+            "value": "{colors.neutral.200}",
+            "metadata": {
+              "pair": "modes.default.component.badge.neutralText"
+            }
+          },
           "neutralText": {
             "value": "{colors.neutral.700}",
             "metadata": {}
@@ -664,6 +724,12 @@ var coreTokens = {
               "pair": "modes.default.component.badge.infoText"
             }
           },
+          "infoBgHover": {
+            "value": "{colors.info.200}",
+            "metadata": {
+              "pair": "modes.default.component.badge.infoText"
+            }
+          },
           "infoText": {
             "value": "{colors.info.700}",
             "metadata": {}
@@ -702,7 +768,9 @@ var coreTokens = {
         "iconBox": {
           "bg": {
             "value": "{colors.white}",
-            "metadata": {}
+            "metadata": {
+              "pair": "modes.default.component.iconBox.iconDefault"
+            }
           },
           "border": {
             "value": "{colors.neutral.200}",
@@ -710,7 +778,9 @@ var coreTokens = {
           },
           "iconDefault": {
             "value": "{colors.info.600}",
-            "metadata": {}
+            "metadata": {
+              "pair": "modes.default.component.iconBox.bg"
+            }
           },
           "iconSuccess": {
             "value": "{colors.success.600}",
@@ -722,7 +792,9 @@ var coreTokens = {
           },
           "iconDanger": {
             "value": "{colors.error.600}",
-            "metadata": {}
+            "metadata": {
+              "pair": "modes.default.component.iconBox.bg"
+            }
           }
         },
         "testimonial": {
@@ -814,7 +886,9 @@ var coreTokens = {
           },
           "text": {
             "value": "{colors.neutral.500}",
-            "metadata": {}
+            "metadata": {
+              "pair": "modes.default.surface.card"
+            }
           }
         }
       }
@@ -861,19 +935,19 @@ var coreTokens = {
             }
           },
           "muted": {
-            "value": "{colors.neutral.200}",
+            "value": "{colors.neutral.300}",
             "metadata": {
               "pair": "modes.dark.surface.page"
             }
           },
           "subtle": {
-            "value": "{colors.neutral.300}",
+            "value": "{colors.neutral.400}",
             "metadata": {
               "pair": "modes.dark.surface.page"
             }
           },
           "meta": {
-            "value": "{colors.neutral.300}",
+            "value": "{colors.neutral.400}",
             "metadata": {
               "pair": "modes.dark.surface.page"
             }
@@ -893,19 +967,19 @@ var coreTokens = {
             }
           },
           "muted": {
-            "value": "{colors.neutral.200}",
+            "value": "{colors.neutral.300}",
             "metadata": {
               "pair": "modes.dark.surface.card"
             }
           },
           "subtle": {
-            "value": "{colors.neutral.300}",
+            "value": "{colors.neutral.400}",
             "metadata": {
               "pair": "modes.dark.surface.card"
             }
           },
           "meta": {
-            "value": "{colors.neutral.300}",
+            "value": "{colors.neutral.400}",
             "metadata": {
               "pair": "modes.dark.surface.card"
             }
@@ -927,7 +1001,7 @@ var coreTokens = {
             }
           },
           "textMuted": {
-            "value": "{colors.neutral.200}",
+            "value": "{colors.neutral.300}",
             "metadata": {
               "pair": "modes.dark.surface.card"
             }
@@ -935,10 +1009,16 @@ var coreTokens = {
         },
         "input": {
           "text": {
-            "value": "{colors.neutral.100}"
+            "value": "{colors.neutral.100}",
+            "metadata": {
+              "pair": "modes.dark.surface.input"
+            }
           },
           "placeholder": {
-            "value": "{colors.neutral.400}"
+            "value": "{colors.neutral.300}",
+            "metadata": {
+              "pair": "modes.dark.surface.input"
+            }
           }
         },
         "button": {
@@ -967,7 +1047,7 @@ var coreTokens = {
             "metadata": {}
           },
           "infoBg": {
-            "value": "{colors.info.900}",
+            "value": "{colors.info.800}",
             "metadata": {
               "pair": "modes.dark.component.badge.infoText"
             }
@@ -1034,7 +1114,9 @@ var coreTokens = {
         "iconBox": {
           "bg": {
             "value": "{colors.neutral.800}",
-            "metadata": {}
+            "metadata": {
+              "pair": "modes.dark.component.iconBox.iconDefault"
+            }
           },
           "border": {
             "value": "{colors.neutral.700}",
@@ -1042,19 +1124,27 @@ var coreTokens = {
           },
           "iconDefault": {
             "value": "{colors.info.300}",
-            "metadata": {}
+            "metadata": {
+              "pair": "modes.dark.component.iconBox.bg"
+            }
           },
           "iconSuccess": {
             "value": "{colors.success.400}",
-            "metadata": {}
+            "metadata": {
+              "pair": "modes.dark.component.iconBox.bg"
+            }
           },
           "iconWarning": {
             "value": "{colors.warning.400}",
-            "metadata": {}
+            "metadata": {
+              "pair": "modes.dark.component.iconBox.bg"
+            }
           },
           "iconDanger": {
             "value": "{colors.error.400}",
-            "metadata": {}
+            "metadata": {
+              "pair": "modes.dark.component.iconBox.bg"
+            }
           }
         },
         "testimonial": {
@@ -1081,7 +1171,7 @@ var coreTokens = {
             }
           },
           "authorTitle": {
-            "value": "{colors.neutral.300}",
+            "value": "{colors.neutral.400}",
             "metadata": {
               "pair": "modes.dark.component.testimonial.bg"
             }
@@ -1129,7 +1219,7 @@ var coreTokens = {
             }
           },
           "priceDescription": {
-            "value": "{colors.neutral.300}",
+            "value": "{colors.neutral.400}",
             "metadata": {
               "pair": "modes.dark.component.pricingCard.bg"
             }
@@ -1146,7 +1236,9 @@ var coreTokens = {
           },
           "text": {
             "value": "{colors.neutral.400}",
-            "metadata": {}
+            "metadata": {
+              "pair": "modes.dark.surface.card"
+            }
           }
         }
       }