{"_id":"@candlelight-ds/tokens","_rev":"2-28c831676591395e7c8f3ba44491c99c","name":"@candlelight-ds/tokens","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@candlelight-ds/tokens","version":"0.1.0","keywords":["design-tokens","design-system","css","tailwind","candlelight"],"license":"MIT","_id":"@candlelight-ds/tokens@0.1.0","maintainers":[{"name":"tommygeoco","email":"tomgeoco@gmail.com"}],"homepage":"https://github.com/tommygeoco/candlelight#readme","bugs":{"url":"https://github.com/tommygeoco/candlelight/issues"},"dist":{"shasum":"ebe71fe5e19e5b867e8175cbf1a2eb7727b1b2e8","tarball":"https://registry.npmjs.org/@candlelight-ds/tokens/-/tokens-0.1.0.tgz","fileCount":6,"integrity":"sha512-SV1V1PLzaJa9xE8KDKs73+0nrHM4IdK6eSZDOI3vMB8L4E1Zwm9hUGhrZKMLdMODNSKW3ITsNUng3bqKNucyaQ==","signatures":[{"sig":"MEUCIQCu8fCWjFouZSVOfL3sGy3Uo7Yr22sqmfQSKyf90KaKEgIgVclfNGsBugmVDsEzS9cyTck0sxFWfGPrRMkNaR9v88M=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20428},"style":"./index.css","exports":{".":"./index.css","./index.css":"./index.css","./tokens.css":"./tokens.css","./package.json":"./package.json","./tailwind.css":"./tailwind.css","./structural.css":"./structural.css"},"gitHead":"2db0eafc58b3517323c399f778cf589478fbf162","scripts":{"test":"node --test"},"_npmUser":{"name":"tommygeoco","email":"tomgeoco@gmail.com"},"repository":{"url":"git+https://github.com/tommygeoco/candlelight.git","type":"git","directory":"packages/tokens"},"_npmVersion":"11.17.0","description":"The Candlelight token sheet — stage/ink ladders, voice colors, the fill ramp, structure, motion, physicality — as plain CSS custom properties, with an optional Tailwind v4 theme layer.","directories":{},"_nodeVersion":"26.4.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/tokens_0.1.0_1783840826936_0.8982539078850651","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@candlelight-ds/tokens","version":"0.2.0","description":"The Candlelight token sheet — stage/ink ladders, voice colors, the fill ramp, structure, motion, physicality — as plain CSS custom properties, with an optional Tailwind v4 theme layer.","license":"MIT","repository":{"type":"git","url":"git+https://github.com/tommygeoco/candlelight.git","directory":"packages/tokens"},"keywords":["design-tokens","design-system","css","tailwind","candlelight"],"publishConfig":{"access":"public"},"style":"./index.css","exports":{".":"./index.css","./index.css":"./index.css","./tokens.css":"./tokens.css","./structural.css":"./structural.css","./tailwind.css":"./tailwind.css","./metrics":{"types":"./metrics.d.ts","default":"./metrics.mjs"},"./package.json":"./package.json"},"scripts":{"test":"node --test"},"gitHead":"fed40079fe6fb88ef56d593285a7c407593e07be","_id":"@candlelight-ds/tokens@0.2.0","bugs":{"url":"https://github.com/tommygeoco/candlelight/issues"},"homepage":"https://github.com/tommygeoco/candlelight#readme","_nodeVersion":"26.4.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-QISqhN0DrBTYG2rvgCuYoxnvV2JXPHbmlORJKpZGyAK+J7CquUMMRuQ7cva4oGsTU9XWlX1bY5jTj502kOgEKw==","shasum":"b47231db29fe9ba4ab4d6e4ebd32088d89940e90","tarball":"https://registry.npmjs.org/@candlelight-ds/tokens/-/tokens-0.2.0.tgz","fileCount":8,"unpackedSize":26383,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQD3z9LomKO2CwHs+rZRNltvmsSuUiP4osqaAvkCForwWgIgaYuibIByfk+G0pTcps23WJkjyPkpvy5DrVy5q/iESh4="}]},"_npmUser":{"name":"tommygeoco","email":"tomgeoco@gmail.com"},"directories":{},"maintainers":[{"name":"tommygeoco","email":"tomgeoco@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/tokens_0.2.0_1783844041257_0.6170947274552148"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-12T07:20:26.804Z","modified":"2026-07-12T08:14:01.517Z","0.1.0":"2026-07-12T07:20:27.069Z","0.2.0":"2026-07-12T08:14:01.388Z"},"bugs":{"url":"https://github.com/tommygeoco/candlelight/issues"},"license":"MIT","homepage":"https://github.com/tommygeoco/candlelight#readme","keywords":["design-tokens","design-system","css","tailwind","candlelight"],"repository":{"type":"git","url":"git+https://github.com/tommygeoco/candlelight.git","directory":"packages/tokens"},"description":"The Candlelight token sheet — stage/ink ladders, voice colors, the fill ramp, structure, motion, physicality — as plain CSS custom properties, with an optional Tailwind v4 theme layer.","maintainers":[{"name":"tommygeoco","email":"tomgeoco@gmail.com"}],"readme":"# @candlelight-ds/tokens\n\nThe [Candlelight](https://github.com/tommygeoco/candlelight) token sheet —\nstage/ink ladders, voice colors, the fill ramp, structure, motion, and\nmachined physicality — as plain CSS custom properties, with an optional\nTailwind v4 theme layer.\n\nTokens are the part of Candlelight you do **not** copy in and own: they are\nlaw. The fill-ramp alphas, radii/shadow/z scales, durations, and the one ease\nare the system (spec §2.9); this package exists so they arrive exact and stay\nexact. The package's tests fail if a value drifts.\n\n## Install\n\n```bash\npnpm add @candlelight-ds/tokens\n```\n\n## Use — Tailwind v4\n\n```css\n/* your global stylesheet */\n@import \"tailwindcss\";\n@import \"@candlelight-ds/tokens/tailwind.css\";\n```\n\nYou get the tokens, the structural/motion physics, and the utility API —\nthe utility *names* are the system's API, and every scale is a closed set:\n\n- **Color:** `bg-stage`, `bg-surface-2`, `text-ink`, `text-ink-mute`,\n  `border-hairline`, `bg-fill-hover`, `bg-fill-selected`, `text-brass`, …\n- **Radius (closed):** `rounded-cap` (4px chamfer) · `rounded-sm` (8px\n  controls) · `rounded-md` (16px panels) · `rounded-lg` (24px shell).\n  Tailwind's default radius steps are wiped; `rounded-[Npx]` is lint-banned.\n- **Type (closed):** `text-nano` 9 · `text-micro` 10 · `text-eyebrow` 11 ·\n  `text-tooltip` 11.5 · `text-meta` 12 · `text-body` 13 · `text-body-lg` 14 ·\n  `text-title` 15 · `text-overlay-title` 18 · `text-heading` 20 ·\n  `text-heading-lg` 28 · `text-marquee` 68 (bundled: weight 400,\n  −0.04em, lh 1). Sizes only — weight/leading/case stay at the call site.\n- **Tracking:** `tracking-chip` 0.16em · `tracking-label` 0.18em ·\n  `tracking-eyebrow` 0.22em · `tracking-title` −0.01em.\n- **Z ladder:** `z-surface` / `z-rail` / `z-float` / `z-overlay` /\n  `z-announce`. 999 does not exist.\n- **Motion:** `duration-instant` 120 · `duration-ui` 150 · `duration-sheet`\n  150 · `duration-scene` 2500 · `ease-stage`.\n- **Elevation:** `shadow-raise` / `shadow-float` / `shadow-stage`.\n\nChanging a token in this package cascades through every consumer of these\nnames; `@candlelight-ds/eslint-plugin` bans the arbitrary-literal escape\nhatches (`rounded-[…]`, `z-[…]`, `text-[Npx]`, `tracking-[…]`,\n`duration-[…]`) so the scales stay closed.\n\nSet the type family (one family, every role — spec §2.6) by defining\n`--font-inter`, e.g. with `next/font`:\n\n```ts\nconst inter = Inter({ variable: \"--font-inter\", subsets: [\"latin\"] });\n```\n\n## Use — any other stack\n\n```css\n@import \"@candlelight-ds/tokens\"; /* tokens.css + structural.css */\n```\n\nPlain CSS custom properties (`var(--stage)`, `var(--fill-hover)`, …) plus the\nnormative structural classes (`.animate-stage-rise`, `.skeleton`, `.key-cue`,\n`.sheet-panel`, …). Reproduce the Tailwind utility names in your styling\nsystem; the names are the contract components are written against.\n\n## Re-theming (spec §2.9)\n\nMay change: the accent triad's hue (keep the ΔL relationships between\nbase/hot/deep), the `--live`/`--ready`/`--warn` hues (keep contrast against\nsurfaces). Must not change: everything else — stage/ink lightness\nrelationships, fill-ramp alphas, radii/shadow/z scales, durations/ease,\nspacing scale (4/8/12/16/20/24/32).\n\nFull specification: the [Candlelight spec](https://github.com/tommygeoco/candlelight/blob/main/docs/spec.md).\n","readmeFilename":"README.md"}