@cognitap/radiant 0.0.0-stage → 0.0.2

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+See the [release policy](RELEASE_POLICY.md) for versioning and migration rules.
+
+## Unreleased
+
+## 0.0.2
+
+- Documentation and maintainer tooling cleanup. The Button API, styles and
+  dependency requirements are unchanged; no migration is needed.
+- Still experimental, with a single native Button. Automated package checks do
+  not replace manual keyboard, focus and screen reader verification.
+
+## 0.0.1
+
+- Public package identity for the first, `0.0.1` release. Do not expect granular updates until package is mature enough to be used by third parties.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cserei Zoltán
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -1,3 +1,107 @@
-# Temporary Holding Version
+# Radiant
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+React interaction components and presentation primitives, published as
+[`@cognitap/radiant`](https://www.npmjs.com/package/@cognitap/radiant) under the
+[MIT license](LICENSE). Radiant is experimental: `0.0.2` contains a single native
+Button.
+
+## Usage
+
+```sh
+pnpm add --save-exact @cognitap/radiant@0.0.2
+```
+
+Import the stylesheet once in your application. It needs no Tailwind and only
+styles Radiant components:
+
+```tsx
+import '@cognitap/radiant/styles.css'
+import { Button } from '@cognitap/radiant'
+
+<Button onClick={handleContinue}>Continue</Button>
+<Button disabled>Unavailable</Button>
+<Button type="submit">Save</Button>
+```
+
+For a global reset (Tailwind Preflight), also import `@cognitap/radiant/reset.css`
+before `styles.css`. React 19.3+ is a peer dependency.
+
+`Button` takes native button props, including `ref`, `aria-*` and form attributes,
+and defaults to `type="button"`. Give every button an accessible name through its
+text or `aria-label`, and use a link for navigation. There are no variants, sizes,
+or loading state yet.
+
+Components use semantic tokens such as `bg-primary` and `rounded-control`.
+Override their CSS variables to theme an application or a subtree; the defaults
+are a light theme. Unlayered application CSS takes precedence over Radiant's
+styles.
+
+### With Tailwind
+
+Applications on Tailwind 4.3.3+ can import the source entry instead of
+`styles.css`, so their own build generates Radiant's utilities. Use one route,
+not both, or the utilities are duplicated:
+
+```css
+@import 'tailwindcss';
+@import '@cognitap/radiant/tailwind.css';
+```
+
+To skip Preflight, replace `@import 'tailwindcss'` with
+[Tailwind's separate imports](https://tailwindcss.com/docs/preflight#disabling-preflight).
+Utilities passed in `className` replace matching defaults, including `hover:` and
+`disabled:` variants: `<Button className="rounded-full hover:bg-red-500">`.
+
+## Development
+
+Use the Node.js version in `.nvmrc`. Any recent pnpm switches itself to the version
+pinned in `package.json`:
+
+```sh
+nvm install && nvm use
+npm install --global pnpm
+pnpm install --frozen-lockfile
+pnpm storybook
+```
+
+Storybook runs at [localhost:6006](http://localhost:6006) and needs no Cognitap
+checkout.
+
+| Command                | Purpose                                                         |
+| ---------------------- | --------------------------------------------------------------- |
+| `pnpm storybook`       | Develop components in Storybook.                                |
+| `pnpm build`           | Build JavaScript, declarations, and CSS into `dist/library`.    |
+| `pnpm watch`           | Rebuild on change, except `reset.css` (run `pnpm build` first). |
+| `pnpm build:storybook` | Build static Storybook into `dist/storybook`.                   |
+| `pnpm lint`            | Run Oxlint, including accessibility rules.                      |
+| `pnpm format`          | Format with Oxfmt (`format:check` to check only).               |
+| `pnpm typecheck`       | Check TypeScript.                                               |
+| `pnpm test`            | Run style tests and verify the packed, installed package.       |
+| `pnpm test:package`    | Verify the packed, installed package only.                      |
+| `pnpm check`           | Run formatting, lint, types, tests, and builds, as CI does.     |
+| `pnpm release:prepare` | Pack and verify a release candidate, then dry-run publishing.   |
+
+Package verification installs the archive with npm, so it needs network access.
+A Husky pre-commit hook formats staged files with Oxfmt.
+[CI](.github/workflows/ci.yml) runs `pnpm check`.
+
+Modules must stay free of import-time side effects, and client-dependent modules
+need their own `use client` directive. Add `*.stories.tsx` next to each component,
+like `src/Button.stories.tsx`. Storybook's Accessibility panel runs axe checks on
+every story, but automated checks cover only part of WCAG, so still test keyboard,
+focus, and screen reader behavior by hand.
+
+## Live development in Cognitap
+
+With this checkout at `../radiant` and its dependencies installed, `pnpm dev` in
+Cognitap builds and watches it, points both apps at it, and starts this Storybook.
+Cognitap's installed package, manifests, and lockfile stay untouched. See
+[Cognitap's guide](https://github.com/cognitap/cognitap#live-radiant-development)
+for other checkouts and type checking.
+
+## Further reading
+
+- [Release policy](RELEASE_POLICY.md): versioning, compatibility, and the release workflow
+- [Changelog](CHANGELOG.md): consumer-facing changes per release
+- [CONTRIBUTING.md](CONTRIBUTING.md): maintainer workflow and bug reports
+- [AGENTS.md](AGENTS.md): component and styling conventions

package/RELEASE_POLICY.md

@@ -0,0 +1,82 @@
+# Radiant release policy
+
+Radiant releases independently of Cognitap deployments.
+
+## Versions
+
+Releases follow [SemVer](https://semver.org/). `0.x` releases are experimental
+and publish under `latest`; say so in the README and release notes. `1.0.0`
+follows once the full catalog, its documentation, and accessibility
+and compatibility verification are complete.
+
+Use the largest applicable bump. A fix that requires consumers to adapt is
+breaking, even for accessibility or security. Published versions are immutable.
+Prereleases use a version suffix and their own npm tag, never `latest`.
+
+## Public contract
+
+The contract covers documented props and types, package exports, behavior,
+semantic tokens, named parts, state attributes and functional CSS requirements.
+Breaking changes include incompatible changes to any of these, sizing or layout
+changes consumers must adapt to, raised peer dependency ranges and narrowed
+environment support.
+
+## Support
+
+Only the latest release is maintained: the latest `0.x` before `1.0.0`, then the
+current major. There are no backports or response deadlines.
+
+Every published version gets a changelog entry covering consumer-facing changes
+and known verification gaps. Mark breaking changes and include migration steps.
+From `1.0.0`, deprecate in a minor before removing in a major; during `0.x`,
+direct removal is allowed.
+
+## Release workflow
+
+Releases use native pnpm versioning and reviewed changelog notes. In a pull
+request, run `pnpm version patch --no-git-tag-version` (or `minor`, following
+the rules above), move the applicable Unreleased notes under a `## <version>`
+heading in `CHANGELOG.md` and commit both. The first release keeps `0.0.1`.
+
+From a clean checkout, `pnpm release:prepare` checks the version and notes,
+builds and packs once, runs the installed consumer check against that archive
+and dry-runs its publication. It writes `dist/release/radiant.tgz` and a
+`release.json` receipt recording the version, source commit and SHA-512
+integrity. Source checks are left to CI, which must pass before merging to
+`main`.
+
+Only experimental `0.x` versions are accepted. Enabling `1.0.0` requires a
+reviewed change to the release script backed by the complete catalog,
+documentation and accessibility/compatibility audit.
+
+The manual **Release Radiant** workflow prepares and uploads a candidate. With
+`publish` selected on `main`, a separate job holding npm OIDC permission
+publishes that same archive and checks that npm's integrity matches the
+receipt. Preparation refuses to publish while the manifest is `private`.
+
+### First publication (DEV-94)
+
+Confirm the npm account can publish to the `@cognitap` scope and recheck the MIT
+notice, then remove `private` in a reviewed change. Publish the first candidate
+manually, since trusted publishing needs an existing package. When the next
+release is ready, add an npm trusted publisher for repository
+`cognitap/radiant`, workflow `release.yml` and environment `npm`, enable direct
+publishing, restrict that GitHub environment to `main`, and publish through it
+within two days before the unused configuration expires. Published versions cannot be republished to test
+the setup. Later releases publish from the workflow with provenance and no
+stored token; the first authenticated local publication has no CI provenance.
+
+### Failed publication and fixes
+
+Fix the cause, such as scope access or trusted-publisher configuration, and
+rerun the failed publish job; it reuses the original candidate. Never change
+source or regenerate a candidate to retry. After a timeout, check whether npm
+accepted the upload before retrying:
+
+```sh
+pnpm view @cognitap/radiant@<version> dist.integrity
+```
+
+If it matches the receipt, the release succeeded; if it differs, stop and
+investigate. Published versions are immutable, so fixes ship as a new version
+with new notes.

package/dist/library/Button.d.ts

@@ -0,0 +1,4 @@
+import type { ComponentProps } from 'react';
+export type ButtonProps = ComponentProps<'button'>;
+export declare function Button({ type, className, ...props }: ButtonProps): import("react").JSX.Element;
+//# sourceMappingURL=Button.d.ts.map

package/dist/library/Button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../src/Button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAG3C,MAAM,MAAM,WAAW,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;AAElD,wBAAgB,MAAM,CAAC,EAAE,IAAe,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,WAAW,+BAe3E"}

package/dist/library/Button.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cn } from './cn.js';
+export function Button({ type = 'button', className, ...props }) {
+    return (_jsx("button", { type: type, className: cn('box-border inline-flex min-h-11 items-center justify-center rounded-control border border-solid border-transparent bg-primary px-5 py-2.5 text-center font-[family-name:inherit] text-[length:inherit] font-semibold leading-6 text-primary-foreground', 'cursor-pointer hover:bg-primary-hover active:bg-primary-active', 'focus-visible:outline-3 focus-visible:outline-offset-3 focus-visible:outline-focus', 'disabled:cursor-not-allowed disabled:bg-disabled disabled:text-disabled-foreground', 'forced-colors:border-[ButtonText] forced-colors:disabled:border-[GrayText] forced-colors:disabled:text-[GrayText]', className), ...props }));
+}
+//# sourceMappingURL=Button.js.map

package/dist/library/Button.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Button.js","sourceRoot":"","sources":["../../src/Button.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAI5B,MAAM,UAAU,MAAM,CAAC,EAAE,IAAI,GAAG,QAAQ,EAAE,SAAS,EAAE,GAAG,KAAK,EAAe;IAC1E,OAAO,CACL,iBACE,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,EAAE,CACX,wPAAwP,EACxP,gEAAgE,EAChE,oFAAoF,EACpF,oFAAoF,EACpF,mHAAmH,EACnH,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC","sourcesContent":["import type { ComponentProps } from 'react'\nimport { cn } from './cn.js'\n\nexport type ButtonProps = ComponentProps<'button'>\n\nexport function Button({ type = 'button', className, ...props }: ButtonProps) {\n  return (\n    <button\n      type={type}\n      className={cn(\n        'box-border inline-flex min-h-11 items-center justify-center rounded-control border border-solid border-transparent bg-primary px-5 py-2.5 text-center font-[family-name:inherit] text-[length:inherit] font-semibold leading-6 text-primary-foreground',\n        'cursor-pointer hover:bg-primary-hover active:bg-primary-active',\n        'focus-visible:outline-3 focus-visible:outline-offset-3 focus-visible:outline-focus',\n        'disabled:cursor-not-allowed disabled:bg-disabled disabled:text-disabled-foreground',\n        'forced-colors:border-[ButtonText] forced-colors:disabled:border-[GrayText] forced-colors:disabled:text-[GrayText]',\n        className\n      )}\n      {...props}\n    />\n  )\n}\n"]}

package/dist/library/cn.d.ts

@@ -0,0 +1,3 @@
+import type { CnFunction } from 'cn';
+export declare const cn: CnFunction;
+//# sourceMappingURL=cn.d.ts.map

package/dist/library/cn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.d.ts","sourceRoot":"","sources":["../../src/cn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAA;AAGpC,eAAO,MAAM,EAAE,EAAE,UAMf,CAAA"}

package/dist/library/cn.js

@@ -0,0 +1,9 @@
+import { createCn } from 'cn/config';
+export const cn = createCn({
+    extend: {
+        classGroups: {
+            rounded: ['rounded-control']
+        }
+    }
+});
+//# sourceMappingURL=cn.js.map

package/dist/library/cn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.js","sourceRoot":"","sources":["../../src/cn.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC,MAAM,CAAC,MAAM,EAAE,GAAe,QAAQ,CAAC;IACrC,MAAM,EAAE;QACN,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,iBAAiB,CAAC;SAC7B;KACF;CACF,CAAC,CAAA","sourcesContent":["import type { CnFunction } from 'cn'\nimport { createCn } from 'cn/config'\n\nexport const cn: CnFunction = createCn({\n  extend: {\n    classGroups: {\n      rounded: ['rounded-control']\n    }\n  }\n})\n"]}

package/dist/library/index.d.ts

@@ -0,0 +1,3 @@
+export { Button } from './Button.js';
+export type { ButtonProps } from './Button.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/library/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA"}

package/dist/library/index.js

@@ -0,0 +1,2 @@
+export { Button } from './Button.js';
+//# sourceMappingURL=index.js.map

package/dist/library/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA","sourcesContent":["export { Button } from './Button.js'\nexport type { ButtonProps } from './Button.js'\n"]}

package/dist/library/reset.css

@@ -0,0 +1,2 @@
+/*! tailwindcss v4.3.3 | MIT License | https://tailwindcss.com */
+@layer theme;@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;tab-size:4;font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent;font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica Neue,Noto Sans,Arial,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji;line-height:1.5}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-feature-settings:normal;font-variation-settings:normal;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring:where(:not(iframe)){outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1}@supports (not ((-webkit-appearance:-apple-pay-button))) or (contain-intrinsic-size:1px){::placeholder{color:currentColor}@supports (color:color-mix(in lab, red, red)){::placeholder{color:color-mix(in oklab, currentcolor 50%, transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}::-webkit-calendar-picker-indicator{line-height:1}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){appearance:button}::file-selector-button{appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}}@layer components,utilities;

package/dist/library/styles.css

@@ -0,0 +1,2 @@
+/*! tailwindcss v4.3.3 | MIT License | https://tailwindcss.com */
+@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-border-style:solid;--tw-leading:initial;--tw-font-weight:initial;--tw-outline-style:solid}}}@layer theme{:root,:host{--spacing:.25rem;--font-weight-semibold:600;--color-background:#fff;--color-foreground:#0f172a;--color-border:#cbd5e1;--color-primary:#1e293b;--color-primary-hover:#0f172a;--color-primary-active:#020617;--color-primary-foreground:#fff;--color-disabled:#e2e8f0;--color-disabled-foreground:#475569;--color-focus:#2563eb;--radius-control:.5rem}}@layer base,components;@layer utilities{.box-border{box-sizing:border-box}.inline-flex{display:inline-flex}.min-h-11{min-height:calc(var(--spacing) * 11)}.cursor-pointer{cursor:pointer}.items-center{align-items:center}.justify-center{justify-content:center}.rounded{border-radius:.25rem}.rounded-control{border-radius:var(--radius-control)}.border{border-style:var(--tw-border-style);border-width:1px}.border-solid{--tw-border-style:solid;border-style:solid}.border-transparent{border-color:#0000}.bg-primary{background-color:var(--color-primary)}.px-5{padding-inline:calc(var(--spacing) * 5)}.py-2\.5{padding-block:calc(var(--spacing) * 2.5)}.text-center{text-align:center}.font-\[family-name\:inherit\]{font-family:inherit}.text-\[length\:inherit\]{font-size:inherit}.leading-6{--tw-leading:calc(var(--spacing) * 6);line-height:calc(var(--spacing) * 6)}.font-semibold{--tw-font-weight:var(--font-weight-semibold);font-weight:var(--font-weight-semibold)}.text-primary-foreground{color:var(--color-primary-foreground)}@media (hover:hover){.hover\:bg-primary-hover:hover{background-color:var(--color-primary-hover)}}.focus-visible\:outline-3:focus-visible{outline-style:var(--tw-outline-style);outline-width:3px}.focus-visible\:outline-offset-3:focus-visible{outline-offset:3px}.focus-visible\:outline-focus:focus-visible{outline-color:var(--color-focus)}.active\:bg-primary-active:active{background-color:var(--color-primary-active)}.disabled\:cursor-not-allowed:disabled{cursor:not-allowed}.disabled\:bg-disabled:disabled{background-color:var(--color-disabled)}.disabled\:text-disabled-foreground:disabled{color:var(--color-disabled-foreground)}@media (forced-colors:active){.forced-colors\:border-\[ButtonText\]{border-color:buttontext}.forced-colors\:disabled\:border-\[GrayText\]:disabled{border-color:graytext}.forced-colors\:disabled\:text-\[GrayText\]:disabled{color:graytext}}}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-leading{syntax:"*";inherits:false}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-outline-style{syntax:"*";inherits:false;initial-value:solid}

package/package.json

@@ -1,6 +1,101 @@
 {
   "name": "@cognitap/radiant",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.2",
+  "description": "React interaction components and presentation primitives",
+  "homepage": "https://github.com/cognitap/radiant#readme",
+  "bugs": {
+    "url": "https://github.com/cognitap/radiant/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cognitap/radiant.git"
+  },
+  "files": [
+    "LICENSE",
+    "CHANGELOG.md",
+    "RELEASE_POLICY.md",
+    "dist/library",
+    "src/**/*.ts",
+    "src/**/*.tsx",
+    "src/styles.css",
+    "!src/**/*.stories.*",
+    "!src/**/*.test.*"
+  ],
+  "type": "module",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/library/index.d.ts",
+      "default": "./dist/library/index.js"
+    },
+    "./styles.css": "./dist/library/styles.css",
+    "./reset.css": "./dist/library/reset.css",
+    "./tailwind.css": "./src/styles.css"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "tag": "latest"
+  },
+  "dependencies": {
+    "cn": "0.4.0"
+  },
+  "devDependencies": {
+    "@storybook/addon-a11y": "10.6.1",
+    "@storybook/addon-docs": "10.6.1",
+    "@storybook/react-vite": "10.6.1",
+    "@tailwindcss/cli": "4.3.3",
+    "@tailwindcss/vite": "4.3.3",
+    "@types/node": "26.6.5",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
+    "husky": "9.1.7",
+    "lint-staged": "17.6.0",
+    "oxfmt": "0.72.0",
+    "oxlint": "1.87.0",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "rimraf": "6.1.3",
+    "storybook": "10.6.1",
+    "tailwindcss": "4.3.3",
+    "typescript": "6.0.3",
+    "vite": "8.3.4"
+  },
+  "peerDependencies": {
+    "react": "^19.3.0",
+    "tailwindcss": "^4.3.3"
+  },
+  "peerDependenciesMeta": {
+    "tailwindcss": {
+      "optional": true
+    }
+  },
+  "devEngines": {
+    "runtime": {
+      "name": "node",
+      "version": "26.11.1",
+      "onFail": "download"
+    }
+  },
+  "scripts": {
+    "storybook": "storybook dev --host 127.0.0.1 --port 6006 --no-open --disable-telemetry",
+    "build": "rimraf dist/library && pnpm build:js && pnpm build:css",
+    "build:js": "tsc -p tsconfig.build.json",
+    "build:css": "tailwindcss -i styles/library.css -o dist/library/styles.css --minify && tailwindcss -i styles/reset.css -o dist/library/reset.css --minify",
+    "watch": "pnpm run --parallel '/^watch:/'",
+    "watch:js": "tsc -p tsconfig.build.json --watch --preserveWatchOutput",
+    "watch:styles": "tailwindcss -i styles/library.css -o dist/library/styles.css --watch=always",
+    "build:storybook": "storybook build --output-dir dist/storybook --disable-telemetry",
+    "test": "pnpm build && node --test tests/*.test.mjs && node scripts/verify-package.mjs",
+    "test:package": "pnpm build && node scripts/verify-package.mjs",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint --deny-warnings",
+    "format": "oxfmt",
+    "format:check": "oxfmt --check",
+    "check": "pnpm format:check && pnpm lint && pnpm typecheck && pnpm test && pnpm build:storybook",
+    "release:prepare": "node scripts/prepare-release.mjs"
+  }
 }

package/src/Button.tsx

@@ -0,0 +1,21 @@
+import type { ComponentProps } from 'react'
+import { cn } from './cn.js'
+
+export type ButtonProps = ComponentProps<'button'>
+
+export function Button({ type = 'button', className, ...props }: ButtonProps) {
+  return (
+    <button
+      type={type}
+      className={cn(
+        'box-border inline-flex min-h-11 items-center justify-center rounded-control border border-solid border-transparent bg-primary px-5 py-2.5 text-center font-[family-name:inherit] text-[length:inherit] font-semibold leading-6 text-primary-foreground',
+        'cursor-pointer hover:bg-primary-hover active:bg-primary-active',
+        'focus-visible:outline-3 focus-visible:outline-offset-3 focus-visible:outline-focus',
+        'disabled:cursor-not-allowed disabled:bg-disabled disabled:text-disabled-foreground',
+        'forced-colors:border-[ButtonText] forced-colors:disabled:border-[GrayText] forced-colors:disabled:text-[GrayText]',
+        className
+      )}
+      {...props}
+    />
+  )
+}

package/src/cn.ts

@@ -0,0 +1,10 @@
+import type { CnFunction } from 'cn'
+import { createCn } from 'cn/config'
+
+export const cn: CnFunction = createCn({
+  extend: {
+    classGroups: {
+      rounded: ['rounded-control']
+    }
+  }
+})

package/src/index.ts

@@ -0,0 +1,2 @@
+export { Button } from './Button.js'
+export type { ButtonProps } from './Button.js'

package/src/styles.css

@@ -0,0 +1,17 @@
+@source '.';
+@source not './**/*.stories.*';
+@source not './**/*.test.*';
+
+@theme static {
+  --color-background: #fff;
+  --color-foreground: #0f172a;
+  --color-border: #cbd5e1;
+  --color-primary: #1e293b;
+  --color-primary-hover: #0f172a;
+  --color-primary-active: #020617;
+  --color-primary-foreground: #fff;
+  --color-disabled: #e2e8f0;
+  --color-disabled-foreground: #475569;
+  --color-focus: #2563eb;
+  --radius-control: 0.5rem;
+}

package/src/styles.d.ts

@@ -0,0 +1 @@
+declare module '*.css' {}