{"_id":"@_linked/css","_rev":"11-df4295b1732f82f5bf73ca9816aeb4c5","name":"@_linked/css","dist-tags":{"latest":"0.3.0","next":"0.2.0-next.20260709142816"},"versions":{"0.1.0":{"name":"@_linked/css","version":"0.1.0","license":"MIT","_id":"@_linked/css@0.1.0","maintainers":[{"name":"rene_reborn","email":"email@rene.life"}],"dist":{"shasum":"86dd6f7cbcbceb08cacf48845c7cf903f0ff70e0","tarball":"https://registry.npmjs.org/@_linked/css/-/css-0.1.0.tgz","fileCount":6,"integrity":"sha512-z4ZJdtvZL8cbR6vkuUadtNyKkAEF20N4tCtjkTKLaB5M4KyqpnasovIlNjseeuinQrCphLCVKw673wRl8VzWTQ==","signatures":[{"sig":"MEUCICI/VNcR/R2/3j1ZMKX0Y867KDo36KnQQQu3WbwlVwJlAiEAwjmz+SADQ7k6Lri4x0Ags7iupd0GEAMbb/iyfzjI85U=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48549},"gitHead":"df69c60dec44793fc3d409da007e1a690986d4f9","_npmUser":{"name":"rene_reborn","email":"email@rene.life"},"_npmVersion":"10.9.2","description":"CSS variables, utilities, and theme defaults for the Linked framework","directories":{},"_nodeVersion":"22.17.1","_hasShrinkwrap":false,"packageManager":"yarn@3.6.1","_npmOperationalInternal":{"tmp":"tmp/css_0.1.0_1775469321453_0.6716514168227508","host":"s3://npm-registry-packages-npm-production"}},"0.1.1-next.20260422212130":{"name":"@_linked/css","version":"0.1.1-next.20260422212130","license":"MIT","_id":"@_linked/css@0.1.1-next.20260422212130","maintainers":[{"name":"rene_reborn","email":"email@rene.life"}],"dist":{"shasum":"656ce2e5884bce273fd2538ad146c4ed58bfcef7","tarball":"https://registry.npmjs.org/@_linked/css/-/css-0.1.1-next.20260422212130.tgz","fileCount":6,"integrity":"sha512-TZuyBkKBeuvmCZD/lZdakKhYKLTe/Kl21RvpL3+IzYlk4DgLhJpJ83n0JjvOROvioGqG14DW+t6/R6diCzfzIA==","signatures":[{"sig":"MEUCIFhgzdE/w51X3Pf+QVgHEcWgfFjqzGsUYRPI4W9+KHvuAiEAqjknSAx9CLuTJImAZQQzGDw5oXHmCasymChcTVPzL6Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48852},"gitHead":"22e36e4a4e3ea05937284360e9b8e3af5ef8af94","scripts":{"build":"echo \"@_linked/css is a pure CSS package; no build step needed.\""},"_npmUser":{"name":"rene_reborn","email":"email@rene.life"},"_npmVersion":"10.9.2","description":"CSS variables, utilities, and theme defaults for the Linked framework","directories":{},"_nodeVersion":"22.16.0","linkedPackage":true,"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"yarn@3.6.1","readmeFilename":"README.md","devDependencies":{"@changesets/cli":"^2.29.8","@changesets/changelog-github":"^0.5.2"},"_npmOperationalInternal":{"tmp":"tmp/css_0.1.1-next.20260422212130_1776892891734_0.797101465376542","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@_linked/css","version":"0.1.1","license":"MIT","_id":"@_linked/css@0.1.1","maintainers":[{"name":"rene_reborn","email":"email@rene.life"}],"dist":{"shasum":"73afb1d52db7698a153c5841768d77d4a842e5a8","tarball":"https://registry.npmjs.org/@_linked/css/-/css-0.1.1.tgz","fileCount":6,"integrity":"sha512-hccIxHttx1QzWFKtoPQkCeM+NOA/1GvHhqFgf1VJT400YJjYBbj8Y86Q5oz57ZWXizTta8zFHpA9Aqw+XvBINQ==","signatures":[{"sig":"MEQCIDD6guR/UwfB3uSJWrR9uEDJvXJWLWgVNFXt+2oxWl6zAiAbKniYSSvJY7FyoWm5KExxU4Q3AWjg2kmIxBcuBGPU9w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48832},"gitHead":"ea0389878f7b58e6aa2c9f0f6d96060399aaba73","scripts":{"build":"echo \"@_linked/css is a pure CSS package; no build step needed.\""},"_npmUser":{"name":"rene_reborn","email":"email@rene.life"},"_npmVersion":"10.9.2","description":"CSS variables, utilities, and theme defaults for the Linked framework","directories":{},"_nodeVersion":"22.16.0","linkedPackage":true,"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"yarn@3.6.1","devDependencies":{"@changesets/cli":"^2.29.8","@changesets/changelog-github":"^0.5.2"},"_npmOperationalInternal":{"tmp":"tmp/css_0.1.1_1776893328801_0.6805228557605967","host":"s3://npm-registry-packages-npm-production"}},"0.1.1-next.20260423061707":{"name":"@_linked/css","version":"0.1.1-next.20260423061707","license":"MIT","_id":"@_linked/css@0.1.1-next.20260423061707","maintainers":[{"name":"rene_reborn","email":"email@rene.life"}],"dist":{"shasum":"3a905c691392ca8a97e4e776ab5bf19df76b1e2c","tarball":"https://registry.npmjs.org/@_linked/css/-/css-0.1.1-next.20260423061707.tgz","fileCount":6,"integrity":"sha512-7SCEONjZy3KCYIopFBkXhAZmCgP9gZ6j4JhlsQSJ36bWNM7LHgdJsdrgARAn3x+GKx+I4I8678oPaef8sPhGfw==","signatures":[{"sig":"MEYCIQC2K7e7frfIIluUBJJzgO5ejehDZDKgx7X5UWd+ytZBwgIhAOxVwEbbVhne/Jrw2KrAKD/kaWp55HEk3xlJS8sICLE2","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48852},"gitHead":"ea0389878f7b58e6aa2c9f0f6d96060399aaba73","scripts":{"build":"echo \"@_linked/css is a pure CSS package; no build step needed.\""},"_npmUser":{"name":"rene_reborn","email":"email@rene.life"},"_npmVersion":"10.9.2","description":"CSS variables, utilities, and theme defaults for the Linked framework","directories":{},"_nodeVersion":"22.16.0","linkedPackage":true,"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"yarn@3.6.1","readmeFilename":"README.md","devDependencies":{"@changesets/cli":"^2.29.8","@changesets/changelog-github":"^0.5.2"},"_npmOperationalInternal":{"tmp":"tmp/css_0.1.1-next.20260423061707_1776925028644_0.9155814104036024","host":"s3://npm-registry-packages-npm-production"}},"0.1.1-next.20260423072423":{"name":"@_linked/css","version":"0.1.1-next.20260423072423","license":"MIT","_id":"@_linked/css@0.1.1-next.20260423072423","maintainers":[{"name":"rene_reborn","email":"email@rene.life"}],"dist":{"shasum":"1066e6c86636c163ddc8df11a8c3d66304f98802","tarball":"https://registry.npmjs.org/@_linked/css/-/css-0.1.1-next.20260423072423.tgz","fileCount":6,"integrity":"sha512-W/rUEwpmI3g+qhHDIkUSkoMEq/rep4wPa/kWBfqSMQyoK27aZkEOg2lRW+nBFDyW+P17TTg4C7GMA8c9J534Cw==","signatures":[{"sig":"MEUCIQD/z4D7hLZorwRHKwmcJHZOWcKXsgJj+kEmLp700hvtjQIgQr29jx8w96q8vKLyBCcZrxVdzvcYw1yLshB7m0jWeyQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48852},"gitHead":"1e8cc1203a90b3da5acba2ffe4c34f37c013ef4d","scripts":{"build":"echo \"@_linked/css is a pure CSS package; no build step needed.\""},"_npmUser":{"name":"rene_reborn","email":"email@rene.life"},"_npmVersion":"10.9.2","description":"CSS variables, utilities, and theme defaults for the Linked framework","directories":{},"_nodeVersion":"22.16.0","linkedPackage":true,"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"yarn@3.6.1","readmeFilename":"README.md","devDependencies":{"@changesets/cli":"^2.29.8","@changesets/changelog-github":"^0.5.2"},"_npmOperationalInternal":{"tmp":"tmp/css_0.1.1-next.20260423072423_1776929064760_0.46881251089813025","host":"s3://npm-registry-packages-npm-production"}},"0.1.2-next.20260423091758":{"name":"@_linked/css","version":"0.1.2-next.20260423091758","license":"MIT","_id":"@_linked/css@0.1.2-next.20260423091758","maintainers":[{"name":"rene_reborn","email":"email@rene.life"}],"dist":{"shasum":"d3f1251e989d5519e80cc4ded87aa56a68d5bcf1","tarball":"https://registry.npmjs.org/@_linked/css/-/css-0.1.2-next.20260423091758.tgz","fileCount":6,"integrity":"sha512-GRlGzfFhyTKD69cCPkIIdASJ6h9bbsYkGaiLfcrLLJ2JvhbcolvU62cpwYuHVJ3mYGUPgpGvDhQwfizvj2MDKg==","signatures":[{"sig":"MEUCIAUf0jOxZj1lFcNvCrx1QozthB/ZSMwpGQF5LD3CvO4qAiEA8p6KFayucYaTzW6cPISBfn1wVlqkej+EhcRJrrDDspk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48827},"gitHead":"d07250cae201c8ad2d3550e4db462cc96938c398","scripts":{"build":"echo \"@_linked/css is a pure CSS package; no build step needed.\""},"_npmUser":{"name":"rene_reborn","email":"email@rene.life"},"_npmVersion":"10.9.2","description":"CSS variables, utilities, and theme defaults for the Linked framework","directories":{},"_nodeVersion":"22.16.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"yarn@3.6.1","readmeFilename":"README.md","devDependencies":{"@changesets/cli":"^2.29.8","@changesets/changelog-github":"^0.5.2"},"_npmOperationalInternal":{"tmp":"tmp/css_0.1.2-next.20260423091758_1776935879356_0.7496507278067683","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-next.20260605144354":{"name":"@_linked/css","version":"0.2.0-next.20260605144354","license":"MIT","_id":"@_linked/css@0.2.0-next.20260605144354","maintainers":[{"name":"rene_reborn","email":"email@rene.life"}],"dist":{"shasum":"14fefadd114415c576fce04deac272ec5da08258","tarball":"https://registry.npmjs.org/@_linked/css/-/css-0.2.0-next.20260605144354.tgz","fileCount":8,"integrity":"sha512-Of3d/h7NkIkRV74mHPZc0xdYIB2Fhm+O4OmwsHV63XibN+/H8bcxSaIcz8qBTlDERD+5ve6KRR1lq4zwe9onwQ==","signatures":[{"sig":"MEQCIEQsRBa/3Ued7CV1qwDVCL6zEGPUrddllJoy5TVPhDy9AiBfWehGWHmfTO9zkKoychLwNsJPV4fqn5osc10AldXFqw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":51121},"gitHead":"de38f843400132f504b92bf59e13dd246868ec95","scripts":{"build":"echo \"@_linked/css is a pure CSS package; no build step needed.\""},"_npmUser":{"name":"rene_reborn","email":"email@rene.life"},"_npmVersion":"10.9.2","description":"CSS variables, utilities, and theme defaults for the Linked framework","directories":{},"_nodeVersion":"22.16.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"yarn@3.6.1","readmeFilename":"README.md","devDependencies":{"@changesets/cli":"^2.29.8","@changesets/changelog-github":"^0.5.2"},"_npmOperationalInternal":{"tmp":"tmp/css_0.2.0-next.20260605144354_1780670635169_0.48651198495362435","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@_linked/css","version":"0.2.0","license":"MIT","_id":"@_linked/css@0.2.0","maintainers":[{"name":"rene_reborn","email":"email@rene.life"}],"dist":{"shasum":"39e0acf060717808eb047de55a3bd4ca1b1129a9","tarball":"https://registry.npmjs.org/@_linked/css/-/css-0.2.0.tgz","fileCount":8,"integrity":"sha512-OUfnNQ+x2eeaJwAD4t92KL9aLuT03UsR1viJyTuTaOiNDTk4nvKM7aiHadQjeDpfqtebqtPcdK//u3jlRtejxQ==","signatures":[{"sig":"MEQCIFfVieVdJMeh26BSbAW7AqbRoYJKvM7+1VKEViXCJJzpAiAk89Rldjs8S9ATmGUaULMkCaGSgpFnBukJuP4xGwM7DA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57472},"gitHead":"a50277915110798f02f608e661923851184ae8f1","scripts":{"build":"echo \"@_linked/css is a pure CSS package; no build step needed.\""},"_npmUser":{"name":"rene_reborn","email":"email@rene.life"},"_npmVersion":"10.9.2","description":"CSS variables, utilities, and theme defaults for the Linked framework","directories":{},"_nodeVersion":"22.16.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"yarn@3.6.1","devDependencies":{"@changesets/cli":"^2.29.8","@changesets/changelog-github":"^0.5.2"},"peerDependencies":{"tailwindcss":"^4"},"_npmOperationalInternal":{"tmp":"tmp/css_0.2.0_1780830640173_0.6935364073140384","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-next.20260626150346":{"name":"@_linked/css","version":"0.2.0-next.20260626150346","license":"MIT","_id":"@_linked/css@0.2.0-next.20260626150346","maintainers":[{"name":"rene_reborn","email":"email@rene.life"}],"dist":{"shasum":"b747f94ec5daedd5e3aa6bbbca8e0d59cf36826d","tarball":"https://registry.npmjs.org/@_linked/css/-/css-0.2.0-next.20260626150346.tgz","fileCount":8,"integrity":"sha512-JB0euDeXg6ZAyEXtfKqUM+O+FAc/1VHqyfDIZgo/RctXmkAOJhiE2BMcRyU60MfZ6ATqBW0iCQ7QRxw7DJ0Dyw==","signatures":[{"sig":"MEYCIQCmFQqtbBb1f1ixE8D/8R7umMWJrxynNyKi5034lpnnGQIhAI9sKDsQY5OgHoxWm3MS51rgIIZCsxDj6kG4EVZ9v8Qz","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57492},"gitHead":"f320d006afdb2fa17d6f2c5b0c2757fb58124d88","scripts":{"build":"echo \"@_linked/css is a pure CSS package; no build step needed.\""},"_npmUser":{"name":"rene_reborn","email":"email@rene.life"},"_npmVersion":"10.9.2","description":"CSS variables, utilities, and theme defaults for the Linked framework","directories":{},"_nodeVersion":"22.16.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"yarn@3.6.1","readmeFilename":"README.md","devDependencies":{"@changesets/cli":"^2.29.8","@changesets/changelog-github":"^0.5.2"},"peerDependencies":{"tailwindcss":"^4"},"_npmOperationalInternal":{"tmp":"tmp/css_0.2.0-next.20260626150346_1782486227094_0.45681655533406373","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-next.20260709142816":{"name":"@_linked/css","version":"0.2.0-next.20260709142816","license":"MIT","_id":"@_linked/css@0.2.0-next.20260709142816","maintainers":[{"name":"rene_reborn","email":"email@rene.life"}],"dist":{"shasum":"665236c38d54c9fb0225753374bdb734135290de","tarball":"https://registry.npmjs.org/@_linked/css/-/css-0.2.0-next.20260709142816.tgz","fileCount":8,"integrity":"sha512-8kUx+dwkU2NepAjtIDr9MkJKTfc09i9eS1iISV4ldNmAHAZd3IC9ekWTtcwUsatdPMjwfWqcq5FqFh4uh9K8uQ==","signatures":[{"sig":"MEYCIQCPdacrNyE+ui8/yC1yNtS2op2nTB+RdKh8Q6ggrYQ3HgIhANAjAMfjpxIH4umCz2q1P6Yojnn/g8nAaZ6rmn04hJpN","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57492},"gitHead":"93b318d8fcd15f30fe4865630ca5bc17091a8f95","scripts":{"build":"echo \"@_linked/css is a pure CSS package; no build step needed.\""},"_npmUser":{"name":"rene_reborn","email":"email@rene.life"},"_npmVersion":"10.9.2","description":"CSS variables, utilities, and theme defaults for the Linked framework","directories":{},"_nodeVersion":"22.16.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"yarn@3.6.1","readmeFilename":"README.md","devDependencies":{"@changesets/cli":"^2.29.8","@changesets/changelog-github":"^0.5.2"},"peerDependencies":{"tailwindcss":"^4"},"_npmOperationalInternal":{"tmp":"tmp/css_0.2.0-next.20260709142816_1783607297864_0.5757693508941537","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"_id":"@_linked/css@0.3.0","bugs":{"url":"https://github.com/linked-cm/css/issues"},"dist":{"shasum":"e0176ea424a86fdbb0781322bc095974ee2a65c0","tarball":"https://registry.npmjs.org/@_linked/css/-/css-0.3.0.tgz","integrity":"sha512-omSN5aP2hHWzfAHfiK/oMX4GcSy1LQhBb/zv9ckzb3zCG+o6GQHWC0VopaWiogbenVyd8Up16cHQFmkjliqgAA==","fileCount":8,"unpackedSize":62382,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@_linked%2fcss@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDIuKuJ+H4XcD6/8b1IG4gNwzHDaalefggTmLEGkOLwGQIgEUf37XLkBqqLlVVLP+xhjRjwe9TFXKkbe70m7Nji4Sc="}]},"name":"@_linked/css","gitHead":"ec2a6d6a833528be28a1034aac05ecf1dd39e7c4","license":"MIT","scripts":{"build":"echo \"@_linked/css is a pure CSS package; no build step needed.\""},"version":"0.3.0","_npmUser":{"name":"rene_reborn","email":"email@rene.life","approver":{"name":"rene_reborn","email":"email@rene.life"}},"homepage":"https://github.com/linked-cm/css#readme","repository":{"url":"git+https://github.com/linked-cm/css.git","type":"git"},"_npmVersion":"11.19.1","description":"CSS variables, utilities, and theme defaults for the Linked framework","directories":{},"maintainers":[{"name":"rene_reborn","email":"email@rene.life"}],"_nodeVersion":"22.16.0","publishConfig":{"access":"public"},"packageManager":"yarn@3.6.1","devDependencies":{"@changesets/cli":"^2.29.8","@changesets/changelog-github":"^0.5.2"},"peerDependencies":{"tailwindcss":"^4"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/css_0.3.0_1789072382540_0.5976981327893105"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-06T09:55:21.387Z","modified":"2026-09-10T20:33:02.991Z","0.1.0":"2026-04-06T09:55:21.588Z","0.1.1-next.20260422212130":"2026-04-22T21:21:31.862Z","0.1.1":"2026-04-22T21:28:48.944Z","0.1.1-next.20260423061707":"2026-04-23T06:17:08.840Z","0.1.1-next.20260423072423":"2026-04-23T07:24:24.922Z","0.1.2-next.20260423091758":"2026-04-23T09:17:59.517Z","0.2.0-next.20260605144354":"2026-06-05T14:43:55.313Z","0.2.0":"2026-06-07T11:10:40.316Z","0.2.0-next.20260626150346":"2026-06-26T15:03:47.253Z","0.2.0-next.20260709142816":"2026-07-09T14:28:18.144Z","0.3.0":"2026-09-10T20:33:02.637Z"},"license":"MIT","description":"CSS variables, utilities, and theme defaults for the Linked framework","maintainers":[{"name":"rene_reborn","email":"email@rene.life"}],"readme":"# @_linked/css\n\nCSS variables, utilities, and theme defaults for the [Linked](https://linked.cm) framework.\n\nThis is a **CSS-only asset package** — no JavaScript, no build step. It ships the design-token vocabulary and the Tailwind v4 theme primitives that all `@_linked/*` component packages and Linked-based apps consume.\n\n---\n\n## Files\n\n| File | Purpose |\n|---|---|\n| [`preflight.css`](./preflight.css) | Tailwind-derived preflight with `:not()` exclusions to preserve inline element styles (`<span>`, `<a>`, `<b>`, `<em>`, `<code>`, etc.). Apps using `@_linked/css` typically import this *instead of* the bundled Tailwind preflight via the split-import pattern (see below). |\n| [`package.css`](./package.css) | Tailwind v4 `@theme` registration of `--spacing: 0.25rem`. Import this from any module CSS file that uses Tailwind v4's `--spacing(N)` function. |\n| [`theme-defaults.css`](./theme-defaults.css) | Component-first semantic tokens (`--card-bg`, `--popover-bg`, `--modal-shadow`, etc.) for ~15 Linked component groups + Tailwind `@theme static` palette + `@source inline()` safelists. Import this from your app theme. |\n| [`utilities.css`](./utilities.css) | Tailwind v4 `@utility` mixins for layout primitives — `surface-base`, `card-base`, `modal-base`, `popover-base`, `section-base`, `element-base`. Import this from your app theme alongside `theme-defaults.css`. |\n| [`docs/styling-and-themes.md`](./docs/styling-and-themes.md) | Long-form theming guide for app authors. |\n\n---\n\n## Recommended import order\n\nIn your app's main theme file (e.g. `src/css/theme.css`):\n\n```css\n/* 1. Tailwind v4 layers — split-import pattern to substitute the LINCD preflight */\n@layer theme, base, components, utilities;\n@import 'tailwindcss/theme.css' layer(theme);\n@import '@_linked/css/preflight.css';            /* substitutes Tailwind's bundled preflight */\n@import 'tailwindcss/utilities.css' layer(utilities);\n\n/* 2. Tailwind config (provides Linked component content paths) */\n@config \"@_linked/cli/tailwind.config.js\";\n\n/* 3. @_linked/css theme defaults + utility mixins */\n@import '@_linked/css/theme-defaults.css';\n@import '@_linked/css/utilities.css';\n\n/* 4. Your app-specific overrides — brand palette, page-level surface tokens, dark mode */\n@theme static {\n  --color-primary-500: #116d8d; /* example brand color */\n  /* ... */\n}\n\n:root {\n  --bg-page: var(--color-gray-50);\n  --bg-card: var(--color-white);\n  /* ... */\n}\n```\n\n**Why the split-import?** The shorthand `@import 'tailwindcss';` brings in Tailwind's *bundled* preflight, which uses a bare `*, ::before, ::after` reset that wipes inline element styles (`<b>`, `<em>`, `<span>`, `<a>`, `<code>`, etc.). For app shells rendering rich content (chatbot messages, ontology descriptions, markdown-derived text), that reset is too aggressive. `@_linked/css/preflight.css` is the same Tailwind preflight minus the inline-element wipe, exposed via `:not()` exclusions on the universal selector. Importing the layers separately lets us substitute the LINCD-friendly preflight in.\n\nIn a Linked component package's module CSS (e.g. `Toggle.module.css`):\n\n```css\n@import './helpers/mixins.css';\n@import '@_linked/css/package.css';\n\n.Root {\n  padding: var(--toggle-padding-y, --spacing(1)) var(--toggle-padding-x, --spacing(2));\n  /* ... */\n}\n```\n\nComponent packages typically only need `package.css` because the consuming app provides the full theme. `package.css` is intentionally minimal so it doesn't inflate component bundles.\n\n---\n\n## Naming systems\n\n`@_linked/css` uses **two intentional naming layers**, both Linked-style (neither is Tailwind-native):\n\n### State-first / generic tokens\n\nExamples: `--bg-card`, `--bg-modal`, `--bg-page`, `--spacing-card`, `--shadow-card`, `--radius-modal`.\n\nThese are page/app-surface tokens, used by `utilities.css`'s `@utility` mixins. They align with Tailwind utility class naming (`bg-*`, `shadow-*`, etc.). **Defined by the consuming app**, typically in the app's main theme file.\n\n### Component-first / specific tokens\n\nExamples: `--card-bg`, `--popover-bg`, `--modal-bg`, `--surface-bg`, `--button-primary-bg`, `--field-border`.\n\nThese are component primitives. Components reference state tokens for their defaults but expose component-specific tokens for fine-grained overrides. **Defined in `theme-defaults.css`**.\n\n### Why both\n\nComponents fall through layers:\n\n```css\n.Toggle {\n  background: var(--toggle-bg, var(--control-bg, var(--bg-active)));\n  /*          └─ component-specific  └─ component-group  └─ state */\n}\n```\n\nApps can override at any layer. The state-first layer keeps Linked variable naming aligned with Tailwind's utility conventions; the component-first layer gives component authors precise control points.\n\n### Known gap\n\n`utilities.css`'s `@utility` mixins reference state-first tokens (`--bg-card`, `--bg-modal`, `--spacing-card`, etc.) that are **not** defined in `theme-defaults.css`. The consuming app must define them. Both CN's `src/scss/theme.css` and the `@_linked/cli` app template do this. If you import `utilities.css` without app-defined state tokens, the `@utility` mixins resolve to empty values silently. See follow-up ideation: [docs/ideas/014-promote-cn-css-tokens-to-linked-css.md](https://github.com/create-now/docs) (in the `create_now` workspace).\n\n---\n\n## Tailwind v4 peer dependency\n\nThis package declares `tailwindcss: \"^4\"` as a `peerDependency`. Linked apps are built around Tailwind v4 — `theme-defaults.css` uses `@theme`, `@theme static`, `@source inline(...)`, and `--spacing()`; `utilities.css` uses `@utility`. None of these directives work without Tailwind v4. Install Tailwind v4 in your app:\n\n```bash\nyarn add tailwindcss@^4 @tailwindcss/postcss@^4\n```\n\n(Linked-CLI-based apps already ship with Tailwind v4 transitively via `@_linked/cli`.)\n\n---\n\n## Future ideas\n\n- **`--focus-*` / `--disabled-*` token namespace** — `@_linked/primitives` ships PostCSS mixins (`@define-mixin focus`, `@define-mixin disabled`) but no semantic tokens for these states beyond `--control-outline-*`. Adding `--focus-bg`, `--focus-ring-color`, `--disabled-opacity` etc. as a framework-default would let component authors share a consistent focus/disabled look without per-component re-declaration.\n- **Dark mode framework defaults** — currently apps own `[data-theme='dark']` blocks for every token. Shipping a default dark palette in `theme-defaults.css` would reduce duplication; apps could override only brand-specific dark values. See ideation [013](https://github.com/create-now/docs) D11 (deferred).\n- **Token catalogue / search UI** — interactive doc that lists every shipped token with live example. Could be auto-generated from `theme-defaults.css`.\n- **Reconcile `--bg-*` (state-first) with `--*-bg` (component-first)** — long-term, document one as deprecated or unify the naming. Tracked in follow-up [014](https://github.com/create-now/docs).\n\n---\n\n## License\n\nMIT.\n","readmeFilename":"README.md","homepage":"https://github.com/linked-cm/css#readme","repository":{"url":"git+https://github.com/linked-cm/css.git","type":"git"},"bugs":{"url":"https://github.com/linked-cm/css/issues"}}