{"_id":"@arkaes/tokens","_rev":"5-f050c8e247103e74f9cee10e19fcc34e","name":"@arkaes/tokens","dist-tags":{"latest":"1.1.0"},"versions":{"0.1.0":{"name":"@arkaes/tokens","version":"0.1.0","keywords":["design-tokens","css-custom-properties","design-system","theme","arkaes"],"author":{"name":"Ahmad Naufal"},"license":"MIT","_id":"@arkaes/tokens@0.1.0","maintainers":[{"name":"ahmadnaufal","email":"ahmadnaufal611@gmail.com"}],"homepage":"https://github.com/ahmadnaufal-f/arkaes/tree/main/packages/tokens#readme","bugs":{"url":"https://github.com/ahmadnaufal-f/arkaes/issues"},"dist":{"shasum":"d0be7e796efd490f78ff52633888e9c77962eccc","tarball":"https://registry.npmjs.org/@arkaes/tokens/-/tokens-0.1.0.tgz","fileCount":12,"integrity":"sha512-WrOvraZ8T5z20HM4m0+LO0/bp390PExGdc54O+VatTDu7X1Q5RLxFjIS1JOfH6gsJGmJw2Gz0uP+9TcPvJZLSA==","signatures":[{"sig":"MEYCIQD4vWhHV3vubCzeou81Wkf9M1LBCw9QAcrKSFnb+YzSEgIhAJHQjRS32yNVv34y3UyUFEjSVajF+T1+NsND5GLs3kva","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":21352},"type":"module","exports":{".":{"types":"./src/index.ts","default":"./src/index.ts"},"./css":"./src/styles/index.css","./reset.css":"./src/styles/reset.css","./theme.css":"./src/styles/theme.css","./tokens.css":"./src/styles/tokens.css","./typography.css":"./src/styles/typography.css","./styles/reset.css":"./src/styles/reset.css","./styles/theme.css":"./src/styles/theme.css","./styles/tokens.css":"./src/styles/tokens.css","./styles/typography.css":"./src/styles/typography.css"},"gitHead":"5408bed974ef9032f85f7a37fb4090225669fbb9","scripts":{"lint":"eslint src --max-warnings=0","build":"tsdown","check":"tsc -p tsconfig.json --noEmit"},"_npmUser":{"name":"ahmadnaufal","email":"ahmadnaufal611@gmail.com"},"repository":{"url":"git+https://github.com/ahmadnaufal-f/arkaes.git","type":"git","directory":"packages/tokens"},"_npmVersion":"11.12.1","description":"Readability-first design tokens for the Arkaes portfolio and UI system.","directories":{},"sideEffects":["**/*.css"],"_nodeVersion":"24.15.0","publishConfig":{"main":"./dist/index.js","types":"./dist/index.d.ts","access":"public","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./css":"./dist/styles/index.css","./reset.css":"./dist/styles/reset.css","./theme.css":"./dist/styles/theme.css","./tokens.css":"./dist/styles/tokens.css","./typography.css":"./dist/styles/typography.css","./styles/reset.css":"./dist/styles/reset.css","./styles/theme.css":"./dist/styles/theme.css","./styles/tokens.css":"./dist/styles/tokens.css","./styles/typography.css":"./dist/styles/typography.css"}},"_hasShrinkwrap":false,"devDependencies":{"tsdown":"^0.22.3"},"_npmOperationalInternal":{"tmp":"tmp/tokens_0.1.0_1782018868540_0.34238104997782104","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"name":"@arkaes/tokens","version":"1.0.0","keywords":["design-tokens","css-custom-properties","design-system","theme","arkaes"],"author":{"name":"Ahmad Naufal"},"license":"MIT","_id":"@arkaes/tokens@1.0.0","maintainers":[{"name":"ahmadnaufal","email":"ahmadnaufal611@gmail.com"}],"homepage":"https://github.com/ahmadnaufal-f/arkaes/tree/main/packages/tokens#readme","bugs":{"url":"https://github.com/ahmadnaufal-f/arkaes/issues"},"dist":{"shasum":"a69b864b12e5889270ad274479feeca14b7c2b80","tarball":"https://registry.npmjs.org/@arkaes/tokens/-/tokens-1.0.0.tgz","fileCount":12,"integrity":"sha512-DLQ+A/7VGuEOqlkRYd9vSpivwvlKOaViTB37Q3RHx3h7ocbprBuHMpJepBY0kL/5OnM5ldvn/8UUQsVqdsH9UA==","signatures":[{"sig":"MEUCIQDeuu/rL/PVEdtlY3T/O4t4Dk3cvw9YQFKBA1WsRX96WQIgV+jMihmK/AO5m3kQuaskmI4r2MkVAPaCWE9Dt2XO4b8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20762},"main":"./dist/index.js","type":"module","_from":"file:arkaes-tokens-1.0.0.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./css":"./dist/styles/index.css","./reset.css":"./dist/styles/reset.css","./theme.css":"./dist/styles/theme.css","./tokens.css":"./dist/styles/tokens.css","./typography.css":"./dist/styles/typography.css","./styles/reset.css":"./dist/styles/reset.css","./styles/theme.css":"./dist/styles/theme.css","./styles/tokens.css":"./dist/styles/tokens.css","./styles/typography.css":"./dist/styles/typography.css"},"scripts":{"lint":"eslint src --max-warnings=0","build":"tsdown","check":"tsc -p tsconfig.json --noEmit"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:3911c8dc-acc6-4d87-aceb-05cf69e093ad"}},"_resolved":"/tmp/330e7bd38e6c996afa762ee17e2de019/arkaes-tokens-1.0.0.tgz","_integrity":"sha512-DLQ+A/7VGuEOqlkRYd9vSpivwvlKOaViTB37Q3RHx3h7ocbprBuHMpJepBY0kL/5OnM5ldvn/8UUQsVqdsH9UA==","repository":{"url":"git+https://github.com/ahmadnaufal-f/arkaes.git","type":"git","directory":"packages/tokens"},"_npmVersion":"11.17.0","description":"Readability-first design tokens for the Arkaes portfolio and UI system.","directories":{},"sideEffects":["**/*.css"],"_nodeVersion":"24.16.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsdown":"^0.22.3"},"_npmOperationalInternal":{"tmp":"tmp/tokens_1.0.0_1782019849953_0.8587313460071919","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@arkaes/tokens","version":"1.0.1","keywords":["design-tokens","css-custom-properties","design-system","theme","arkaes"],"author":{"name":"Ahmad Naufal"},"license":"MIT","_id":"@arkaes/tokens@1.0.1","maintainers":[{"name":"ahmadnaufal","email":"ahmadnaufal611@gmail.com"}],"homepage":"https://github.com/ahmadnaufal-f/arkaes/tree/main/packages/tokens#readme","bugs":{"url":"https://github.com/ahmadnaufal-f/arkaes/issues"},"dist":{"shasum":"6b7b1ff54aafb99ffcaba6a6822ec86134580beb","tarball":"https://registry.npmjs.org/@arkaes/tokens/-/tokens-1.0.1.tgz","fileCount":12,"integrity":"sha512-4U5yyy9k8Os/x01K8y7u+69n4VzZgbprBXoV0//u74gze70CYESrs3ENGuwbxAIURLArT5OwbsO1tsgLnUEiGg==","signatures":[{"sig":"MEQCIBcp3rn3d/KlgZE33GMVUwdUGxkbJGE8Hnjq3ao6ADS2AiAwRamnKSnEsYcON/ukA4Uhj18J6B9IlUMwJhV2oBiZ1Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@arkaes%2ftokens@1.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":21033},"main":"./dist/index.js","type":"module","_from":"file:arkaes-tokens-1.0.1.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./css":"./dist/styles/index.css","./reset.css":"./dist/styles/reset.css","./theme.css":"./dist/styles/theme.css","./tokens.css":"./dist/styles/tokens.css","./typography.css":"./dist/styles/typography.css","./styles/reset.css":"./dist/styles/reset.css","./styles/theme.css":"./dist/styles/theme.css","./styles/tokens.css":"./dist/styles/tokens.css","./styles/typography.css":"./dist/styles/typography.css"},"scripts":{"lint":"eslint src --max-warnings=0","build":"tsdown","check":"tsc -p tsconfig.json --noEmit"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:3911c8dc-acc6-4d87-aceb-05cf69e093ad"}},"_resolved":"/tmp/2ba796f16ce2e0d07d36de21ce83d63a/arkaes-tokens-1.0.1.tgz","_integrity":"sha512-4U5yyy9k8Os/x01K8y7u+69n4VzZgbprBXoV0//u74gze70CYESrs3ENGuwbxAIURLArT5OwbsO1tsgLnUEiGg==","repository":{"url":"git+https://github.com/ahmadnaufal-f/arkaes.git","type":"git","directory":"packages/tokens"},"_npmVersion":"11.18.0","description":"Readability-first design tokens for the Arkaes portfolio and UI system.","directories":{},"sideEffects":["**/*.css"],"_nodeVersion":"24.18.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsdown":"^0.22.3"},"_npmOperationalInternal":{"tmp":"tmp/tokens_1.0.1_1783009750681_0.04943528707659195","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@arkaes/tokens","version":"1.0.2","keywords":["design-tokens","css-custom-properties","design-system","theme","arkaes"],"author":{"name":"Ahmad Naufal"},"license":"MIT","_id":"@arkaes/tokens@1.0.2","maintainers":[{"name":"ahmadnaufal","email":"ahmadnaufal611@gmail.com"}],"homepage":"https://github.com/ahmadnaufal-f/arkaes/tree/main/packages/tokens#readme","bugs":{"url":"https://github.com/ahmadnaufal-f/arkaes/issues"},"dist":{"shasum":"5cb5ee82813393507dbce9c431b1ea7b7db44aea","tarball":"https://registry.npmjs.org/@arkaes/tokens/-/tokens-1.0.2.tgz","fileCount":19,"integrity":"sha512-+yHcbNSTsD6Np8kig/QgKjTP+xpcNg6YtzrwiQiz4IkYhTVH+ZCEE1KdzvgKxVLx5dYe+M/6wPKSu0TbdefASw==","signatures":[{"sig":"MEUCIQDLQLIbEdM/Dqxj3dlpzvylwnINkpiKkOKN5wRZeKVuCQIgXliSt28g6aBPZ0xT5YS+u4NtblxLlk3nPFuCDK32IV0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@arkaes%2ftokens@1.0.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":48653},"main":"./dist/index.js","type":"module","_from":"file:arkaes-tokens-1.0.2.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./css":"./dist/styles/index.css","./fonts.css":"./dist/styles/fonts.css","./generated":{"types":"./dist/generated/tokens.d.ts","default":"./dist/generated/tokens.js"},"./reset.css":"./dist/styles/reset.css","./theme.css":"./dist/styles/theme.css","./tokens.css":"./dist/styles/tokens.css","./tokens.json":"./dist/tokens.json","./typography.css":"./dist/styles/typography.css","./styles/reset.css":"./dist/styles/reset.css","./styles/theme.css":"./dist/styles/theme.css","./styles/tokens.css":"./dist/styles/tokens.css","./styles/typography.css":"./dist/styles/typography.css"},"scripts":{"lint":"eslint src --max-warnings=0","build":"pnpm generate && tsdown","check":"tsc -p tsconfig.json --noEmit","generate":"node scripts/build-tokens.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:3911c8dc-acc6-4d87-aceb-05cf69e093ad"}},"_resolved":"/tmp/28a69d6e1fbca68d450478c77cf76c5d/arkaes-tokens-1.0.2.tgz","_integrity":"sha512-+yHcbNSTsD6Np8kig/QgKjTP+xpcNg6YtzrwiQiz4IkYhTVH+ZCEE1KdzvgKxVLx5dYe+M/6wPKSu0TbdefASw==","repository":{"url":"git+https://github.com/ahmadnaufal-f/arkaes.git","type":"git","directory":"packages/tokens"},"_npmVersion":"12.0.2","description":"Readability-first design tokens for the Arkaes portfolio and UI system.","directories":{},"sideEffects":["**/*.css"],"_nodeVersion":"24.18.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsdown":"^0.22.3","style-dictionary":"^5.5.0"},"_npmOperationalInternal":{"tmp":"tmp/tokens_1.0.2_1785676736487_0.43161694637171144","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@arkaes/tokens","version":"1.1.0","description":"Readability-first design tokens for the Arkaes portfolio and UI system.","license":"MIT","author":{"name":"Ahmad Naufal"},"homepage":"https://github.com/ahmadnaufal-f/arkaes/tree/main/packages/tokens#readme","repository":{"type":"git","url":"git+https://github.com/ahmadnaufal-f/arkaes.git","directory":"packages/tokens"},"bugs":{"url":"https://github.com/ahmadnaufal-f/arkaes/issues"},"keywords":["design-tokens","css-custom-properties","design-system","theme","arkaes"],"type":"module","sideEffects":["**/*.css"],"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./css":"./dist/styles/index.css","./fonts.css":"./dist/styles/fonts.css","./tokens.css":"./dist/styles/tokens.css","./theme.css":"./dist/styles/theme.css","./reset.css":"./dist/styles/reset.css","./typography.css":"./dist/styles/typography.css","./styles/tokens.css":"./dist/styles/tokens.css","./styles/theme.css":"./dist/styles/theme.css","./styles/reset.css":"./dist/styles/reset.css","./styles/typography.css":"./dist/styles/typography.css","./generated":{"types":"./dist/generated/tokens.d.ts","default":"./dist/generated/tokens.js"},"./tokens.json":"./dist/tokens.json"},"publishConfig":{"access":"public"},"devDependencies":{"style-dictionary":"^5.5.0","tsdown":"^0.22.3"},"scripts":{"generate":"node scripts/build-tokens.mjs","build":"pnpm generate && tsdown","check":"tsc -p tsconfig.json --noEmit","lint":"eslint src --max-warnings=0"},"main":"./dist/index.js","types":"./dist/index.d.ts","_id":"@arkaes/tokens@1.1.0","_integrity":"sha512-6NMYi7EBqQIMX65yAD+kP2cVfHpB6BSf0fQyCkkp4z/oBCG1Sx9Eml26tdTePwPwSwC0rppzlkzouAFRbAPp7Q==","_resolved":"/tmp/4e3b45c6c3651e0fcb91fc5db43dee91/arkaes-tokens-1.1.0.tgz","_from":"file:arkaes-tokens-1.1.0.tgz","_nodeVersion":"24.18.0","_npmVersion":"12.0.2","dist":{"integrity":"sha512-6NMYi7EBqQIMX65yAD+kP2cVfHpB6BSf0fQyCkkp4z/oBCG1Sx9Eml26tdTePwPwSwC0rppzlkzouAFRbAPp7Q==","shasum":"17fe14479eebbb4b4287e061791b2f1253877e3d","tarball":"https://registry.npmjs.org/@arkaes/tokens/-/tokens-1.1.0.tgz","fileCount":19,"unpackedSize":54712,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@arkaes%2ftokens@1.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDFyp7grzKOPqpnmjpymC8LAni9TpK+b+a3CGrHSefc9AiAocF3TmXpoTrgs2XMKXpdzB3llmbrYkw642515Q5+xEw=="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:3911c8dc-acc6-4d87-aceb-05cf69e093ad"}},"directories":{},"maintainers":[{"name":"ahmadnaufal","email":"ahmadnaufal611@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/tokens_1.1.0_1786189214940_0.3206115638920781"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-21T05:14:28.415Z","modified":"2026-08-08T11:40:15.423Z","0.1.0":"2026-06-21T05:14:28.668Z","1.0.0":"2026-06-21T05:30:50.082Z","1.0.1":"2026-07-02T16:29:10.872Z","1.0.2":"2026-08-02T13:18:56.621Z","1.1.0":"2026-08-08T11:40:15.066Z"},"bugs":{"url":"https://github.com/ahmadnaufal-f/arkaes/issues"},"author":{"name":"Ahmad Naufal"},"license":"MIT","homepage":"https://github.com/ahmadnaufal-f/arkaes/tree/main/packages/tokens#readme","keywords":["design-tokens","css-custom-properties","design-system","theme","arkaes"],"repository":{"type":"git","url":"git+https://github.com/ahmadnaufal-f/arkaes.git","directory":"packages/tokens"},"description":"Readability-first design tokens for the Arkaes portfolio and UI system.","maintainers":[{"name":"ahmadnaufal","email":"ahmadnaufal611@gmail.com"}],"readme":"# @arkaes/tokens\n\nReadability-first design tokens for the Arkaes portfolio and UI system.\n\n## What changed\n\nThis version improves text clarity by:\n\n- using a readable sans-serif stack for body text\n- reserving decorative serif/display fonts for large headings only\n- increasing muted-text contrast\n- adding better line-height defaults\n- adding reading measure tokens\n- adding `.ark-readable` for case studies and long-form content\n- improving dark-mode text contrast\n\n## Use in Astro\n\n```astro\n---\nimport \"@arkaes/tokens/css\";\n---\n```\n\n## Design token pipeline (color + spacing)\n\nColor and spacing tokens are **generated** from [DTCG](https://tr.designtokens.org/)\nJSON sources with [Style Dictionary](https://styledictionary.com/). They are the\nsingle source of truth — do not hand-edit the generated CSS.\n\nSources live in `tokens/`, in three tiers:\n\n- `tokens/primitive/` — raw values (color ramps, the spacing scale)\n- `tokens/semantic/` — intent colors referencing primitives via `{color.neutral-700}`\n- `tokens/component/` — component/legacy aliases referencing semantics\n\nEach token uses the DTCG keys `$value`, `$type` (`color` or `dimension`), and\n`$description`.\n\nGeneration runs automatically on `pnpm install` (via the root `postinstall`) and\nas the first step of `pnpm build`, so the generated CSS is always present before\nany app builds — including standalone app builds on Vercel that bypass\nTurborepo. Run it manually with:\n\n```sh\npnpm --filter @arkaes/tokens generate\n```\n\nOutputs (all git-ignored — regenerate rather than hand-edit):\n\n| Output | Path | Consumer |\n| --- | --- | --- |\n| CSS custom properties | `src/styles/tokens.generated.css` | imported by `tokens.css` → `@arkaes/tokens/css` |\n| Flat JSON | `src/generated/tokens.json` → `@arkaes/tokens/tokens.json` | machine-readable (path, value, type, tier, reference, description) |\n| Typed TS | `src/generated/tokens.ts` → `@arkaes/tokens/generated` | programmatic token access |\n\n`outputReferences` is enabled, so the tier structure survives into the CSS as\n`var()` chains and all tiers land in a single `:root` block.\n\nIn the flat JSON, `value` is fully dereferenced. Two fields preserve what that\nflattening loses: `tier` is the source directory (`primitive` / `semantic` /\n`component`), and `reference` is the value as authored, kept only while it still\ncontains an `{alias}` — so `color.surface` carries `value: \"#fafaf9\"` alongside\n`reference: \"{color.neutral-0}\"`.\n\nEvery color token is listed visually in Storybook under **Foundations → Color**,\nrendered from this JSON rather than a hand-maintained list.\n\n> Typography, radius, shadow, and motion tokens are still hand-authored in\n> `src/styles/tokens.css` — a later migration will move them into this pipeline.\n\n## Token-compliance check\n\nCI runs `pnpm lint:tokens` (`scripts/token-lint.mjs`), which fails the build if\n`@arkaes/ui` source hard-codes a raw hex color, or a px/rem value that matches a\n`--ark-space-*` token used in a spacing property (`padding`/`margin`/`gap`/`inset`).\nLayout dimensions and font sizes with no token equivalent are not flagged. The\nspacing values it checks are read from the generated `tokens.json`, so adding a\nstep to the scale automatically extends what the linter enforces.\n\nFor a genuine one-off, add an escape-hatch comment on the offending line:\n\n```ts\nwidth: 3px; /* token-lint-disable-line: hairline divider, no 3px token */\n```\n\nPre-existing occurrences are recorded in `scripts/token-lint-baseline.json` so the\ncheck is green today but fails on any new raw value. After an intentional,\nreviewed change to those values, refresh the baseline with\n`node scripts/token-lint.mjs --update-baseline`.\n\n## Recommended typography usage\n\n```html\n<h1 class=\"ark-heading-display\">Architecture meets aesthetics.</h1>\n<p class=\"ark-text-lead\">\n  Frontend engineering for polished, performance-minded interfaces.\n</p>\n\n<article class=\"ark-readable\">\n  <h2 class=\"ark-heading-section\">Case study</h2>\n  <p>\n    Long-form content should use readable spacing, strong contrast, and a comfortable line length.\n  </p>\n</article>\n```\n\n## Typography rule\n\n```txt\nDisplay serif = brand expression\nSans-serif = reading clarity\n```\n\nAvoid using decorative serif typography for body text, labels, cards, and descriptions.\n","readmeFilename":"README.md"}