@arun-dev/tokens 0.2.0 → 0.4.0

package/README.md

@@ -74,6 +74,18 @@ writeFileSync(
 );
 ```
 
+### Output stability
+
+`createBrand()` is pure and deterministic: the same `seed` (or the same `palette`) always
+produces byte-identical CSS. It uses no randomness, no clock and nothing from the environment,
+and `name` affects only a comment in the output.
+
+That is a contract, not an implementation detail. Brand generation is normally a one-time
+step whose result is committed, so **a change to the palette algorithm restyles every consumer
+the moment they upgrade** — even though nothing in their code changed. Treat such a change as
+breaking regardless of what the version number would otherwise suggest, and say so in the
+changeset.
+
 ## `BrandSemanticContract`
 
 The TypeScript type `BrandSemanticContract` (exported from `./createBrand`) lists every semantic

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arun-dev/tokens",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Pure-CSS design tokens with white-label brand generation — primitives, brand palettes, semantic layers, and the createBrand() generator",
   "license": "MIT",
   "type": "module",
@@ -32,6 +32,7 @@
     "./components": "./src/components.css",
     "./components/chip": "./src/components/chip.css",
     "./components/badge": "./src/components/badge.css",
+    "./components/button": "./src/components/button.css",
     "./primitives/typography": "./src/primitives/typography.css",
     "./primitives/spacing": "./src/primitives/spacing.css",
     "./primitives/radius": "./src/primitives/radius.css",

package/src/components/button.css

@@ -0,0 +1,5 @@
+/* Button component tokens — map semantic tokens onto the button's styleable surfaces.
+   Override any of these to restyle buttons without moving other components. */
+:root {
+  --btn-disabled-opacity: 0.5;
+}

package/src/components/switch.css

@@ -0,0 +1,21 @@
+/* Switch component tokens — map semantic tokens onto the switch's styleable surfaces.
+   Override any of these to restyle switches without moving other components. */
+:root {
+  /* Track */
+  --switch-track-inline-size: 2.25rem;
+  --switch-track-block-size: 1.25rem;
+  --switch-track-radius: var(--radius-full);
+  --switch-track-bg: var(--color-bg-secondary);
+  --switch-track-bg-checked: var(--color-text-accent);
+  --switch-track-border-color: var(--color-border-default);
+  --switch-track-border-width: var(--space-px);
+
+  /* Thumb */
+  --switch-thumb-size: 0.875rem;
+  --switch-thumb-bg: var(--color-bg-primary);
+  --switch-thumb-inset: var(--space-2px);
+  --switch-thumb-shadow: var(--shadow-sm);
+
+  --switch-disabled-opacity: 0.5;
+  --switch-duration: var(--duration-fast);
+}

package/src/components.css

@@ -4,3 +4,5 @@
    Imported by base.css; also exported standalone as @arun-dev/tokens/components. */
 @import './components/chip.css';
 @import './components/badge.css';
+@import './components/button.css';
+@import './components/switch.css';