@cognitap/radiant 0.0.0-stage → 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+See the [release policy](RELEASE_POLICY.md) for versioning and migration rules.
+
+## Unreleased
+
+## 0.0.1
+
+- Compiled `styles.css` for consumers without Tailwind, an optional compiled
+  `reset.css` and a source `tailwind.css` customization entry. Tailwind is now
+  an optional peer dependency.
+- Button inherits application fonts and sets its own box sizing and border
+  style, so its default appearance does not require a global reset.
+- Migration for Tailwind consumers: replace the old source `styles.css` import
+  with `tailwind.css` alongside your own Tailwind entry. Ordinary consumers
+  retain the `styles.css` import. Choose one route to avoid duplicate utilities;
+  import `reset.css` separately if you want Preflight.
+- Public source under MIT, with the copyright notice naming Zoltán Cserei and
+  a documented maintainer workflow and public bug/accessibility reporting.
+- Initial experimental Button with ESM JavaScript, TypeScript declarations and
+  source maps.
+- Public package identity, release policy and publishing metadata prepared for
+  the first `0.0.1` release.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zoltán Cserei
+
+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,275 @@
-# 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.
+Reusable React interaction components and presentation primitives, maintained in
+this standalone repository.
+
+Radiant's source is available under the [MIT license](LICENSE). The library is
+experimental: version `0.0.1` is a native Button proof of concept. The build
+includes standalone component CSS, a separate optional reset and a Tailwind
+customization entry.
+See the
+[release policy](RELEASE_POLICY.md) for identity, compatibility, support and
+publication requirements, and the [changelog](CHANGELOG.md) for release changes.
+
+Install the experimental package in a React application:
+
+```sh
+pnpm add --save-exact @cognitap/radiant@0.0.1
+```
+
+Import `@cognitap/radiant/styles.css` once; see [Button](#button) for usage.
+
+## Getting started
+
+Use the Node version in `.nvmrc` and the pnpm version in `package.json`:
+
+```sh
+nvm install
+nvm use
+npm install --global "$(node -p 'require("./package.json").packageManager')"
+pnpm install --frozen-lockfile
+pnpm storybook
+```
+
+Open [Storybook](http://localhost:6006) for the primary component development
+loop. No Cognitap checkout or private configuration is required.
+
+| Command                                     | Purpose                                                      |
+| ------------------------------------------- | ------------------------------------------------------------ |
+| `pnpm storybook`                            | Edit components in the local workshop                        |
+| `pnpm build`                                | Build library JavaScript, declarations, maps and CSS         |
+| `pnpm watch`                                | Watch JavaScript, declarations and compiled component styles |
+| `pnpm build:storybook`                      | Build the separate static workshop                           |
+| `pnpm typecheck`                            | Check source and Storybook types                             |
+| `pnpm test`                                 | Verify builds and an independently installed archive         |
+| `pnpm test:package`                         | Build, pack and verify an isolated installed package         |
+| `pnpm lint`                                 | Check correctness and accessibility lint rules               |
+| `pnpm fmt`                                  | Format repository files                                      |
+| `pnpm fmt:check`                            | Check formatting                                             |
+| `pnpm check`                                | Run all checks, including the Storybook build                |
+| `pnpm release:prepare`                      | Pack and verify a release candidate; dry-run publication     |
+| `pnpm pack --pack-destination dist/package` | Create a package archive locally                             |
+
+CI installs the pinned dependencies with the committed lockfile and runs
+`pnpm check` and package creation. Installing dependencies registers the
+pre-commit hook, which formats staged files. See
+[CONTRIBUTING.md](CONTRIBUTING.md) for the maintainer workflow.
+
+Releases are independent of Cognitap; see the
+[release workflow](RELEASE_POLICY.md#release-workflow).
+
+## Library build
+
+From the repository root:
+
+```sh
+pnpm build
+```
+
+The build removes `dist/library`, compiles JavaScript and declarations with
+`tsc`, and compiles the two stylesheets with the Tailwind CLI. These are
+development tools; ordinary consumers need only React and the packaged CSS.
+
+TypeScript emits separate ES2022 ESM modules, `.d.ts` declarations, JavaScript
+maps with embedded source, and declaration maps into `dist/library`. Keeping
+modules separate preserves `use client` directives and external runtime imports:
+React is a peer dependency and `cn` is a runtime dependency. Relative source
+imports use `.js` extensions so emitted JavaScript and declarations work in Node
+and bundlers, following [TypeScript's library guidance](https://www.typescriptlang.org/docs/handbook/modules/guides/choosing-compiler-options#im-writing-a-library).
+
+The package root and three stylesheet entries are public exports. JavaScript,
+types, component styles and the reset resolve to compiled artifacts. Sources ship for editor
+navigation through declaration maps; stories, tests and Storybook output stay
+out of the archive. Rebuilding cleans only `dist/library`.
+
+JavaScript modules must remain free of import-time side effects. Bundlers can
+discard unused modules; CSS is explicitly marked as having side effects so
+stylesheet imports are retained. Browser interactions belong in the component's
+lifecycle, and client-dependent modules need their own `use client` directive.
+
+`pnpm test` builds the library, checks the Tailwind customization route locally,
+and verifies the public package through an isolated installation.
+
+### Installed archive verification
+
+`pnpm test:package` builds Radiant, packs it into a temporary directory and
+installs the archive there with npm. The small `tests/consumer` fixture owns
+the public import/SSR, CSS, map, metadata and React-peer checks, plus independent
+NodeNext and bundler declaration checks. It uses the repository's pinned React
+and TypeScript versions, with no Tailwind or source aliases. Public package
+checks run once, against installed artifacts. The directory and archive are
+removed after success or failure.
+
+`pnpm test` and `pnpm check` include this verification; npm and registry access
+are required. Use `node scripts/verify-package.mjs /absolute/path/to/candidate.tgz`
+to verify an existing release candidate without rebuilding or repacking it.
+Browser interaction/hydration evidence and registry publication remain separate.
+
+Storybook reads component source directly for rapid editing. `pnpm watch` uses
+TypeScript and Tailwind's native watchers to update JavaScript, declarations and
+the compiled component stylesheet. Run `pnpm build` first when using the watcher
+on its own. The initial build also generates the optional reset; rerun
+`pnpm build:css` after editing `styles/reset.css`. The watcher does not start Storybook.
+
+For live integration, install dependencies in this checkout and Cognitap once,
+then run `pnpm dev` from Cognitap. It automatically selects a sibling `../radiant`
+checkout when present; `pnpm dev /path/to/radiant` selects another location, and
+`pnpm dev --installed` selects the installed dependency explicitly. Without a
+sibling checkout, development uses the installed dependency.
+
+Cognitap builds the selected package, then starts its watchers and Storybook,
+both frontend apps and Trantor together through Nx. The frontend processes resolve
+this checkout's public exports through temporary aliases. The apps consume
+compiled JavaScript and the documented Tailwind entry. Local Next.js development
+uses Webpack for external package watching; ordinary development keeps Turbopack.
+`Ctrl+C` stops the session.
+Installed dependencies, manifests and lockfiles stay unchanged; ordinary Cognitap
+checks and builds use its installed dependency even during a local session.
+
+Run `pnpm dev --typecheck [checkout-path]` from Cognitap to refresh JavaScript,
+declarations and maps with the `build:js` helper and check both apps against the
+public declarations. The helper preserves the output directory and compiled
+stylesheets during a watch session. Local commands select temporary type
+configurations; editors normally read the ordinary app configurations, so use
+this command to validate new public types. See
+[Cognitap's development guide](https://github.com/cognitap/cognitap#live-radiant-development)
+for the full workflow and Trantor setup.
+
+Independent Storybook development needs no Cognitap checkout. Live integration
+complements installed-archive and registry verification; it does not replace them.
+
+## Button
+
+```tsx
+import { Button } from '@cognitap/radiant'
+
+<Button onClick={handleContinue}>Continue</Button>
+<Button disabled>Unavailable</Button>
+<Button type="submit">Save</Button>
+```
+
+`Button` accepts native React button props (`ButtonProps`), including `ref`,
+`className`, `aria-*`, and form attributes. It defaults to `type="button"` to
+avoid accidental form submission. Import its stylesheet once in your application:
+
+```tsx
+import '@cognitap/radiant/styles.css'
+```
+
+This route needs no Tailwind installation or CSS compiler. Components do not
+import CSS themselves. The stylesheet contains component utilities and tokens;
+it does not reset headings, body margins or unrelated native controls. Button
+sets its own border style and box sizing and inherits the application's font.
+
+The optional reset is a separate, application-wide choice:
+
+```tsx
+import '@cognitap/radiant/reset.css'
+import '@cognitap/radiant/styles.css'
+```
+
+`reset.css` contains Tailwind Preflight, compiled and self-contained. It changes
+global element defaults; importing it is not required for Radiant components.
+
+Native button semantics provide keyboard activation and disabled behavior. Give
+every button an accessible name through its text or `aria-label`. Focus indicators
+and forced-colors borders are included. Use a link for navigation.
+
+This PoC has one visual treatment, with no variants, sizes, loading state, or
+polymorphic rendering. The consumer owns actions and state. React 19.3+ is a peer
+dependency.
+
+## Tailwind customization
+
+For an application with Tailwind 4.3.3+, use the source customization entry
+instead of the compiled component sheet. It provides the semantic theme and
+registers Radiant's shipped component sources for scanning; your application
+generates the utilities once with its own Tailwind integration:
+
+```css
+@import 'tailwindcss';
+@import '@cognitap/radiant/tailwind.css';
+```
+
+The application's `tailwindcss` import includes Preflight. To keep the reset
+disabled, use [Tailwind's separate imports](https://tailwindcss.com/docs/preflight#disabling-preflight):
+
+```css
+@layer theme, base, components, utilities;
+@import 'tailwindcss/theme.css' layer(theme);
+@import 'tailwindcss/utilities.css' layer(utilities);
+@import '@cognitap/radiant/tailwind.css';
+```
+
+Choose one component-style route: compiled `styles.css` or generated
+`tailwind.css`. Combining them duplicates the component utilities. The source
+entry does not import Tailwind or generate a second utility sheet. Its `@source`
+is relative to the installed source entry, so library scanning works inside
+`node_modules`; stories and tests are excluded. Application scanning belongs to
+your Tailwind setup. Configure its source base or add an application-relative
+`@source` when automatic scanning does not cover your files. See
+[Tailwind's source detection guide](https://tailwindcss.com/docs/detecting-classes-in-source-files).
+
+Tokens provide background, foreground, border, primary action states and foreground,
+disabled background and foreground, focus color, and control radius. Components
+use semantic utilities such as `bg-primary`, `text-primary-foreground`, and
+`rounded-control`. Override the corresponding CSS variables to theme an application
+or a subtree; these defaults currently define a light theme.
+
+`src/cn.ts` registers the semantic control radius with `cn` so it participates in
+class conflict resolution. Components merge classes with this helper, passing the
+caller's `className` last so matching utilities override defaults. In a Tailwind app, for example,
+`<Button className="rounded-full px-8 hover:bg-red-500">Continue</Button>` replaces
+the default corner radius, horizontal padding, and hover color. Disabled
+overrides use the same prefix, such as `disabled:bg-slate-300`. The compiled
+sheet only includes utilities used by library components; arbitrary caller
+utilities need your own generated CSS. Without Tailwind, use ordinary CSS
+classes or override the semantic variables. Unlayered application CSS takes
+precedence over Radiant's layered utilities.
+
+## Storybook
+
+Storybook uses React and Vite and lives in this package. From the repository root:
+
+```sh
+pnpm storybook
+```
+
+Open http://localhost:6006. The server binds to localhost.
+
+Build a static site:
+
+```sh
+pnpm build:storybook
+```
+
+Output goes to `dist/storybook`, separate from the library build.
+`pnpm check` validates both the library and the static workshop. Each build
+preserves the other's output.
+
+### Accessibility checks
+
+Start Storybook, open a story under **Components → Button** (including **Disabled**),
+and select the **Accessibility** panel. The official `@storybook/addon-a11y` addon
+runs axe-core checks automatically for each story, including new stories. Use
+**Rerun accessibility scan** after changing controls to check the updated state.
+
+Review **Violations** for detected issues, **Passes** for successful checks, and
+**Inconclusive** for checks that need human judgment. Expand a result to see the
+rule, affected elements, and guidance; highlighting elements helps locate them
+in the canvas. A disabled button may be exempt from checks such as color contrast.
+
+Automated checks cover only part of WCAG. A clean result does not establish WCAG
+conformance: manually review keyboard navigation, focus visibility, screen reader
+behavior, and interaction states in the consuming application as well.
+See [Storybook's accessibility testing guide](https://storybook.js.org/docs/writing-tests/accessibility-testing).
+
+## Adding stories
+
+Add `*.stories.tsx` beside a component in `src/`. Import `Meta` and `StoryObj`
+from `@storybook/react-vite`, define metadata with `satisfies Meta<typeof Component>`,
+and export a `StoryObj<typeof meta>` for each supported state. Preview configuration
+enables generated documentation globally. Use `fn()` from `storybook/test` for
+callback args, so interactions appear in the Actions panel.
+
+`src/Button.stories.tsx` demonstrates the real Button in enabled and disabled states.

package/RELEASE_POLICY.md

@@ -0,0 +1,154 @@
+# Radiant release policy
+
+Confirmed in DEV-84 on 13 October 2026. Radiant releases independently of Cognitap
+deployments; the owner and trusted maintainers control development and merges.
+
+## Identity and licensing
+
+This repository is the authoritative Radiant source. Its selected GitHub identity
+is `cognitap/radiant`; the npm package is `@cognitap/radiant`.
+
+The source is licensed under MIT. [LICENSE](LICENSE) contains the complete text
+and names Zoltán Cserei as the copyright holder. Corporate formation is not a
+prerequisite for source opening or npm publication. This decision supersedes
+DEV-84's initial incorporation gate.
+
+Keep `private: true` in the package manifest until npm publication prerequisites
+pass. This prevents package publication while public source development proceeds.
+
+## Versions
+
+Start with ordinary `0.0.1` and publish experimental `0.x` releases under
+`latest`. Make experimental status clear in the README and release notes.
+The first stable release is `1.0.0`, after the complete 31-family catalog,
+documentation and agreed accessibility and compatibility verification pass.
+
+| Change                                              | During `0.x` | From `1.0.0` |
+| --------------------------------------------------- | ------------ | ------------ |
+| Compatible correction                               | Patch        | Patch        |
+| Compatible addition, cosmetic change or deprecation | Minor        | Minor        |
+| Breaking change                                     | Minor        | Major        |
+
+Use the largest applicable bump. A correction that requires consumers to adapt
+is breaking, including accessibility or security corrections. Pure internal
+changes can use a patch when they preserve the public contract. Published
+versions are immutable; follow-up fixes receive a new version.
+
+Future previews can use prerelease suffixes and separate tags without replacing
+the ordinary release under `latest`. Version numbers follow
+[SemVer](https://semver.org/); [npm tags](https://docs.npmjs.com/cli/v11/commands/npm-dist-tag/)
+select distribution channels independently.
+
+## Compatibility and consumer requirements
+
+The public contract includes documented props and types, exports, behavior,
+semantic tokens, named parts, state attributes and functional CSS requirements.
+Incompatible changes to these, or sizing/layout changes requiring consumer
+adaptation, are breaking.
+
+Raising consumer dependency requirements or narrowing the declared environment
+support policy is also breaking. Versions aging out of an unchanged rolling
+browser or OS support target do not themselves require a breaking release.
+Record tested combinations separately from support targets.
+
+Generated utility strings and foundation internals remain private. Package
+exports define the supported import surface; shipping source for editor
+navigation does not make internal imports supported.
+
+React remains a peer dependency. Keep the current range initially; changes need
+installed-package verification. The [package manifest](package.json) declares
+current peer ranges and runtime dependencies. Contributor Node, pnpm and
+TypeScript pins belong to development configuration and do not establish
+consumer runtime or declaration requirements.
+
+Ordinary consumers use compiled `styles.css` without Tailwind. The optional
+`reset.css` is a separate, global opt-in; importing components loads neither
+stylesheet automatically. Tailwind belongs to the optional `tailwind.css`
+customization route, which registers the library theme and sources for the
+application's own CSS generation. Choose one component stylesheet route.
+
+Cognitap pins exact published versions after its migration. Optional local
+development watches this package's public build and selects its exports through
+process-only aliases. The apps use compiled JavaScript/types and the supported
+Tailwind entry. Installed dependencies stay unchanged, so stopping needs no
+restore step. Normal consumption after migration requires
+only the published package. Local updates complement archive and registry
+verification and do not replace publication readiness checks.
+
+## Support and upgrades
+
+Maintain the current stable major through its latest minor and patch releases.
+Before `1.0.0`, fixes land in the latest experimental release. There is no
+standing commitment to older release branches or response deadlines.
+
+Every published version has a changelog entry describing its consumer-facing
+changes and relevant verification limits. Identify breaking changes and include
+actionable migration instructions. After `1.0.0`, normally deprecate in a minor
+before removal in a major, without a fixed waiting period. During `0.x`, direct
+removal is allowed with migration guidance.
+
+## Publication readiness
+
+Public source opening requires the finalized MIT notice, repository control and
+verified standalone tooling. Initial npm publication additionally
+requires scope permissions, compiled CSS, verified installed archives and an
+independent release workflow.
+
+Archives include the public build, stylesheet, editor-navigation sources, README,
+LICENSE, changelog and this policy; exclude tests, stories and Storybook output.
+The manifest's allowlist and exports define what ships and what is public.
+
+The selected publishing configuration uses public npm access and `latest`.
+Keep publication disabled until its prerequisites pass. Neither public source
+nor an experimental package establishes stable catalog readiness or conformance
+for an entire consumer application.
+
+## 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 table 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.1",
+  "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",
+    "fmt": "oxfmt",
+    "fmt:check": "oxfmt --check",
+    "check": "pnpm fmt: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' {}