@auldrant/ui 0.0.0

package/CHANGELOG.md

@@ -0,0 +1,58 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/),
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [0.4.0] - 2026-02-26
+
+### Added
+
+- **feat(test)**: add axe-core a11y test suite (19 files, setup helpers, 18 test files) ([#20](https://github.com/coloneljade/auldrant-ui/pull/20))
+- **refactor(test)**: migrate a11y assertions out of behavioral tests (cleanup + deletions) ([#20](https://github.com/coloneljade/auldrant-ui/pull/20))
+- **docs(rules)**: mandate AAA comments and WCAG SC references in tests ([#20](https://github.com/coloneljade/auldrant-ui/pull/20))
+
+## [0.3.0] - 2026-02-25
+
+### Added
+
+- Configure Vite, TypeScript, Biome, devcontainer, and test setup ([#7](https://github.com/coloneljade/auldrant-ui/pull/7))
+- Add routing and title signals for SPA navigation ([#7](https://github.com/coloneljade/auldrant-ui/pull/7))
+- Shared types, utilities, and composable CSS classes ([#7](https://github.com/coloneljade/auldrant-ui/pull/7))
+- Semantic HTML-first — native elements before ARIA ([#7](https://github.com/coloneljade/auldrant-ui/pull/7))
+- CSS Grid layout, em-based spacing, CSS modules ([#7](https://github.com/coloneljade/auldrant-ui/pull/7))
+- Accessible form field management (`FormField` wrapper) ([#7](https://github.com/coloneljade/auldrant-ui/pull/7))
+- SkipLink and Nav for keyboard navigation ([#7](https://github.com/coloneljade/auldrant-ui/pull/7))
+- Type-safe component props (TypeScript strict mode) ([#7](https://github.com/coloneljade/auldrant-ui/pull/7))
+- Comprehensive test coverage (114 tests) ([#7](https://github.com/coloneljade/auldrant-ui/pull/7))
+- Pit of success design principle for component APIs ([#7](https://github.com/coloneljade/auldrant-ui/pull/7))
+- Binary tools principle (Biome fixes, not manual edits) ([#7](https://github.com/coloneljade/auldrant-ui/pull/7))
+- Mandatory skills workflow (staging, pushing, PRs) ([#7](https://github.com/coloneljade/auldrant-ui/pull/7))
+- Import aliases (`@components`, `@scripts`, `@signals`, `@styles`) ([#7](https://github.com/coloneljade/auldrant-ui/pull/7))
+- **Head component** — meta/document head management (issue #18) ([#7](https://github.com/coloneljade/auldrant-ui/pull/7))
+- **Form data typing** — generic type parameter for typed onSubmit (issue #8) ([#7](https://github.com/coloneljade/auldrant-ui/pull/7))
+
+## [0.2.0] - 2026-02-24
+
+### Added
+
+- Remove CJS output and UMD name — ESM-only library ([#6](https://github.com/coloneljade/auldrant-ui/pull/6))
+- Fix CI publish failure by skipping lefthook in CI environment ([#6](https://github.com/coloneljade/auldrant-ui/pull/6))
+- Add `@components` and `@styles` import path aliases (tsconfig + vite) ([#6](https://github.com/coloneljade/auldrant-ui/pull/6))
+- Add GitHub CLI feature and YAML extension to devcontainer ([#6](https://github.com/coloneljade/auldrant-ui/pull/6))
+- Create VSCode tasks for all project scripts (test, build, check, typecheck, storybook) ([#6](https://github.com/coloneljade/auldrant-ui/pull/6))
+- Add component base types (BaseProps, FieldProps) and cx() class utility ([#6](https://github.com/coloneljade/auldrant-ui/pull/6))
+
+## [0.1.0] - 2026-02-24
+
+### Added
+
+- Remove CJS output and UMD name — ESM-only library ([#6](https://github.com/coloneljade/auldrant-ui/pull/6))
+- Fix CI publish failure by skipping lefthook in CI environment ([#6](https://github.com/coloneljade/auldrant-ui/pull/6))
+- Add `@components` and `@styles` import path aliases (tsconfig + vite) ([#6](https://github.com/coloneljade/auldrant-ui/pull/6))
+- Add GitHub CLI feature and YAML extension to devcontainer ([#6](https://github.com/coloneljade/auldrant-ui/pull/6))
+- Create VSCode tasks for all project scripts (test, build, check, typecheck, storybook) ([#6](https://github.com/coloneljade/auldrant-ui/pull/6))
+- Add component base types (BaseProps, FieldProps) and cx() class utility ([#6](https://github.com/coloneljade/auldrant-ui/pull/6))
+
+## [Unreleased]

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Colonel Jade
+
+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

@@ -0,0 +1,178 @@
+# @auldrant/ui
+
+Accessible Preact component library with design tokens and CSS modules.
+
+## Installation
+
+```bash
+bun add @auldrant/ui preact @preact/signals
+```
+
+Import the stylesheet in your app entry point:
+
+```ts
+import '@auldrant/ui/styles';
+```
+
+## Quick Start
+
+```tsx
+import { Button, Form, Theme } from '@auldrant/ui';
+import '@auldrant/ui/styles';
+
+function App() {
+  return (
+    <Theme class="my-theme">
+      <Form onSubmit={(data) => console.log(data)}>
+        <Button label="Submit" type="submit" />
+      </Form>
+    </Theme>
+  );
+}
+```
+
+## Components
+
+### Form Controls
+
+| Component | Description | Key Props |
+|-----------|-------------|-----------|
+| `Button` | Standard button with configurable type and click handler | `label`, `onClick?`, `type?` |
+| `Checkbox` | Checkbox with label | `label`, `checked?`, `onChange?` |
+| `Form` | Form with submit/reset buttons. Prevents default and provides FormData | `onSubmit`, `children`, `submitLabel?` |
+| `Input` | Text input with label | `type?`, `value?`, `onInput?` |
+| `NumberInput` | Numeric input with label | `min?`, `max?`, `onInput?` |
+| `PasswordInput` | Password input with show/hide toggle | `purpose` (`'current'` \| `'new'`), `value?`, `onInput?` |
+| `RadioGroup` | Radio button group inside a fieldset | `legend`, `name`, `options` |
+| `Select` | Select dropdown with label | `options`, `value?`, `onChange?` |
+| `Textarea` | Textarea with character counter | `maxChars`, `value?`, `onInput?` |
+
+### Layout
+
+| Component | Description | Key Props |
+|-----------|-------------|-----------|
+| `Card` | Visual surface container | `children` |
+| `Section` | Semantic `<section>` with configurable heading level | `title`, `level?`, `children` |
+| `Table` | Accessible data table with required headers | `headers`, `data` |
+| `Theme` | Scopes `--aui-*` custom properties to its subtree | `children` |
+| `VisuallyHidden` | Screen-reader-only content | `children` |
+
+### Navigation
+
+| Component | Description | Key Props |
+|-----------|-------------|-----------|
+| `Link` | Auto-detects internal vs external URLs | `href`, `children`, `external?` |
+| `DownloadLink` | Download link using `<a download>` | `href`, `fileName`, `label` |
+| `Nav` | Semantic `<nav>` wrapper with optional title | `title?`, `children` |
+| `Route` | Renders children when location matches path | `path`, `children` |
+| `SkipLink` | Skip navigation link, hidden until focused | `target?`, `label?` |
+
+All components extend `IBaseProps` which includes `class?` and `id?`. Form controls extend `IFieldProps` which adds `label`, `name?`, `required?`, and `disabled?`. Full prop types are available in the `.d.ts` files.
+
+## Theming
+
+Wrap your app in `<Theme>` and define `--aui-*` custom properties in your CSS:
+
+```css
+.my-theme {
+  --aui-color-text: #1a1a1a;
+  --aui-color-text-muted: #6b7280;
+  --aui-color-background: #ffffff;
+  --aui-color-surface: #f9fafb;
+  --aui-color-border: #d1d5db;
+  --aui-color-primary: #2563eb;
+  --aui-color-primary-hover: #1d4ed8;
+  --aui-color-focus-ring: #3b82f6;
+  --aui-color-error: #dc2626;
+}
+```
+
+```tsx
+<Theme class="my-theme">
+  <App />
+</Theme>
+```
+
+| Token | Purpose |
+|-------|---------|
+| `--aui-color-text` | Body text |
+| `--aui-color-text-muted` | Placeholder text, secondary content |
+| `--aui-color-background` | Input and page backgrounds |
+| `--aui-color-background-hover` | Hover state for interactive backgrounds |
+| `--aui-color-surface` | Card and container backgrounds |
+| `--aui-color-border` | Borders on inputs, cards, tables |
+| `--aui-color-primary` | Buttons, links, accents |
+| `--aui-color-primary-hover` | Hover state for buttons and links |
+| `--aui-color-focus-ring` | Focus indicator outline |
+| `--aui-color-error` | Validation error text |
+
+Themes are nestable for sub-themes (e.g. dark mode sections).
+
+## Routing & Signals
+
+Built-in routing uses Preact signals and the History API:
+
+```tsx
+import { location, hash, navigate, title, Route, Link } from '@auldrant/ui';
+
+// Read current path
+console.log(location.value); // "/about"
+console.log(hash.value);     // "section-1"
+
+// Navigate programmatically
+navigate('/dashboard');
+navigate('/login', { replace: true });
+
+// Set document title reactively
+title.value = 'My Page';
+
+// Declarative routing
+<Route path="/about">
+  <AboutPage />
+</Route>
+
+<Link href="/about">About</Link>
+```
+
+## Utilities
+
+### `cx(...classes)`
+
+Combine CSS class names, filtering out falsy values:
+
+```tsx
+import { cx } from '@auldrant/ui';
+
+cx('btn', isActive && 'active');          // "btn active" or "btn"
+cx(styles.card, props.class);             // handles undefined class prop
+```
+
+## Development
+
+### Prerequisites
+
+- [Bun](https://bun.sh/) >= 1.0.0
+- Or use the included DevContainer
+
+### Setup
+
+```bash
+bun install
+```
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `bun run build` | Build the library |
+| `bun run check` | Lint and format check (Biome) |
+| `bun run check:fix` | Auto-fix lint and format issues |
+| `bun run typecheck` | TypeScript type checking |
+| `bun run test` | Run tests |
+| `bun run test:watch` | Run tests in watch mode |
+| `bun run storybook` | Start Storybook dev server |
+| `bun run build-storybook` | Build static Storybook |
+
+## License
+
+[MIT](LICENSE)

package/dist/auldrant-ui.css

@@ -0,0 +1 @@
+._button_4gn7y_1{padding:.5em 1em;border:1px solid var(--aui-color-border);border-radius:.25em;background:var(--aui-color-primary);color:var(--aui-color-background);font:inherit;cursor:pointer}._button_4gn7y_1:hover{background:var(--aui-color-primary-hover)}._card_awzw5_1{display:grid;gap:.5em;padding:1em;border:1px solid var(--aui-color-border);border-radius:.25em;background:var(--aui-color-surface)}._field_sfa1d_1{display:grid;grid-template-columns:auto 1fr;align-items:center;gap:.5em}._form_rchcx_1{display:grid;gap:1em}._actions_rchcx_6{display:grid;grid-auto-flow:column;justify-content:start;gap:.5em}._field_18ejg_1{display:grid;grid-template-columns:auto 1fr;align-items:start;gap:.5em}._label_18ejg_8{padding-top:.25em}._required_18ejg_12{color:var(--aui-color-error)}._nav_778nl_1{display:grid;gap:.5em}._title_778nl_6{font-weight:700}._wrapper_1mu6v_1{display:grid;grid-template-columns:1fr auto}._input_1mu6v_6{border-top-right-radius:0;border-bottom-right-radius:0;border-right:none}._toggle_1mu6v_13{padding:.375em .75em;border:1px solid var(--aui-color-border);border-top-right-radius:.25em;border-bottom-right-radius:.25em;background:var(--aui-color-background);color:var(--aui-color-text);font:inherit;font-size:.875em;cursor:pointer}._toggle_1mu6v_13:hover:not(:disabled){background:var(--aui-color-background-hover, var(--aui-color-background))}._fieldset_19vke_1{border:none;padding:0}._legend_19vke_6{font-weight:700;margin-bottom:.5em}._option_19vke_11{display:grid;grid-template-columns:auto 1fr;align-items:center;gap:.5em;margin-bottom:.25em}._section_4nogy_1{display:grid;gap:1em}._skip_xbsul_1{position:absolute;top:-100%;left:0;padding:.5em 1em;background:var(--aui-color-background);color:var(--aui-color-primary);z-index:1000}._skip_xbsul_1:focus{top:0}._table_roeo7_1{width:100%;border-collapse:collapse}._table_roeo7_1 th,._table_roeo7_1 td{padding:.5em;text-align:left;border-bottom:1px solid var(--aui-color-border)}._table_roeo7_1 th{font-weight:700;color:var(--aui-color-text)}._table_roeo7_1 td{color:var(--aui-color-text)}._wrapper_1kyv1_1{display:grid;gap:.25em}._textarea_1kyv1_6{resize:vertical}._counter_1kyv1_11{justify-self:end;font-size:.875em;color:var(--aui-color-text-muted)}._theme_13mb7_1{display:contents}._focus-ring_4m0e1_3:focus-visible{outline:2px solid var(--aui-color-focus-ring);outline-offset:2px}._disabled_4m0e1_8:disabled{opacity:.5;cursor:not-allowed}._text-input_4m0e1_13{padding:.375em .5em;border:1px solid var(--aui-color-border);border-radius:.25em;background:var(--aui-color-background);color:var(--aui-color-text);font:inherit}._link_4m0e1_22{color:var(--aui-color-primary);text-decoration:underline;cursor:pointer}._link_4m0e1_22:hover{color:var(--aui-color-primary-hover)}._check-input_4m0e1_32{accent-color:var(--aui-color-primary)}._visually-hidden_4m0e1_36{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}

package/dist/auldrant-ui.js

@@ -0,0 +1,424 @@
+import { jsx as a, jsxs as _, Fragment as T } from "preact/jsx-runtime";
+import { useId as b } from "preact/hooks";
+import { signal as $, useSignal as j, effect as D } from "@preact/signals";
+function h(...t) {
+  return t.filter(Boolean).join(" ");
+}
+const E = "_button_4gn7y_1 _focus-ring_4m0e1_3 _disabled_4m0e1_8", B = {
+  button: E
+}, I = (t) => {
+  const { label: e, onClick: l, type: n = "button", disabled: s, class: c } = t;
+  return /* @__PURE__ */ a("button", { type: n, class: h(B.button, c), onClick: l, disabled: s, children: e });
+}, H = "_card_awzw5_1", O = {
+  card: H
+}, Te = (t) => {
+  const { children: e, class: l } = t;
+  return /* @__PURE__ */ a("div", { class: h(O.card, l), children: e });
+}, R = "_field_sfa1d_1", G = "_input_sfa1d_8 _check-input_4m0e1_32 _focus-ring_4m0e1_3 _disabled_4m0e1_8", C = {
+  field: R,
+  input: G
+}, De = (t) => {
+  const { label: e, name: l, checked: n, required: s, disabled: c, onChange: o, class: d } = t, u = b();
+  return /* @__PURE__ */ _("div", { class: h(C.field, d), children: [
+    /* @__PURE__ */ a(
+      "input",
+      {
+        id: u,
+        class: C.input,
+        type: "checkbox",
+        name: l,
+        checked: n,
+        required: s,
+        disabled: c,
+        onChange: o && ((m) => o(m.target.checked))
+      }
+    ),
+    /* @__PURE__ */ a("label", { for: u, children: e })
+  ] });
+}, W = "_link_7wgic_1 _link_4m0e1_22 _focus-ring_4m0e1_3", z = {
+  link: W
+}, Ee = (t) => {
+  const { href: e, fileName: l, label: n, class: s } = t;
+  return /* @__PURE__ */ a("a", { href: e, download: l, class: h(z.link, s), children: n });
+}, A = "_form_rchcx_1", M = "_actions_rchcx_6", q = {
+  form: A,
+  actions: M
+}, Be = (t) => {
+  const { onSubmit: e, submitLabel: l = "Submit", resetLabel: n, children: s, class: c } = t;
+  return /* @__PURE__ */ _(
+    "form",
+    {
+      class: h(q.form, c),
+      onSubmit: (o) => {
+        o.preventDefault();
+        const d = new FormData(o.currentTarget);
+        e(d);
+      },
+      children: [
+        s,
+        /* @__PURE__ */ _("div", { class: q.actions, children: [
+          /* @__PURE__ */ a(I, { type: "submit", label: l }),
+          n && /* @__PURE__ */ a(I, { type: "reset", label: n })
+        ] })
+      ]
+    }
+  );
+}, U = "_field_18ejg_1", V = "_label_18ejg_8", J = "_required_18ejg_12", x = {
+  field: U,
+  label: V,
+  required: J
+}, g = (t) => {
+  const { for: e, label: l, required: n, children: s, class: c } = t;
+  return /* @__PURE__ */ _("div", { class: h(x.field, c), children: [
+    /* @__PURE__ */ _("label", { class: x.label, for: e, children: [
+      l,
+      ":",
+      n && /* @__PURE__ */ _("span", { class: x.required, "aria-hidden": "true", children: [
+        " ",
+        "*"
+      ] })
+    ] }),
+    s
+  ] });
+}, K = "_input_1j10x_1 _text-input_4m0e1_13 _focus-ring_4m0e1_3 _disabled_4m0e1_8", Q = {
+  input: K
+}, X = {
+  email: "email",
+  tel: "tel",
+  url: "url"
+}, He = (t) => {
+  const {
+    label: e,
+    name: l,
+    type: n = "text",
+    value: s,
+    placeholder: c,
+    maxLength: o,
+    autocomplete: d,
+    readOnly: u,
+    pattern: m,
+    required: r,
+    disabled: i,
+    onInput: p,
+    class: f
+  } = t, v = b();
+  return /* @__PURE__ */ a(g, { label: e, for: v, required: r, class: f, children: /* @__PURE__ */ a(
+    "input",
+    {
+      id: v,
+      class: Q.input,
+      type: n,
+      name: l,
+      value: s,
+      placeholder: c,
+      maxLength: o,
+      autoComplete: d ?? X[n],
+      readOnly: u,
+      pattern: m,
+      required: r,
+      disabled: i,
+      onInput: p && ((P) => p(P.target.value))
+    }
+  ) });
+}, N = $(window.location.pathname), F = $(window.location.hash.slice(1));
+function Y(t) {
+  const e = t.indexOf("#");
+  let l = "", n = t;
+  e >= 0 && (l = t.slice(e + 1), n = t.slice(0, e));
+  const s = n.indexOf("?");
+  let c = "", o = n;
+  return s >= 0 && (c = n.slice(s), o = n.slice(0, s)), { pathname: o || "/", search: c, hash: l };
+}
+function Z(t, e) {
+  const { pathname: l, search: n, hash: s } = Y(t), c = l + n + (s ? `#${s}` : "");
+  e?.replace ? history.replaceState(null, "", c) : history.pushState(null, "", c), N.value = l, F.value = s;
+}
+window.addEventListener("popstate", () => {
+  N.value = window.location.pathname, F.value = window.location.hash.slice(1);
+});
+const ee = "_link_7wgic_1 _link_4m0e1_22 _focus-ring_4m0e1_3", S = {
+  link: ee
+};
+function te(t) {
+  try {
+    return new URL(t, window.location.href).origin !== window.location.origin;
+  } catch {
+    return !1;
+  }
+}
+const Oe = (t) => {
+  const { href: e, children: l, external: n, class: s } = t;
+  return n ?? te(e) ? /* @__PURE__ */ a("a", { href: e, class: h(S.link, s), rel: "noopener noreferrer", children: l }) : /* @__PURE__ */ a(
+    "a",
+    {
+      href: e,
+      class: h(S.link, s),
+      onClick: (o) => {
+        o.preventDefault(), Z(e);
+      },
+      children: l
+    }
+  );
+}, se = "_nav_778nl_1", ne = "_title_778nl_6", L = {
+  nav: se,
+  title: ne
+}, Re = (t) => {
+  const { title: e, children: l, class: n } = t, s = b();
+  return /* @__PURE__ */ _("nav", { class: h(L.nav, n), "aria-labelledby": e ? s : void 0, children: [
+    e && /* @__PURE__ */ a("h2", { id: s, class: L.title, children: e }),
+    l
+  ] });
+}, le = "_input_1j10x_1 _text-input_4m0e1_13 _focus-ring_4m0e1_3 _disabled_4m0e1_8", ae = {
+  input: le
+}, Ge = (t) => {
+  const {
+    label: e,
+    name: l,
+    min: n,
+    max: s,
+    step: c,
+    value: o,
+    placeholder: d,
+    required: u,
+    disabled: m,
+    onInput: r,
+    class: i
+  } = t, p = b();
+  return /* @__PURE__ */ a(g, { label: e, for: p, required: u, class: i, children: /* @__PURE__ */ a(
+    "input",
+    {
+      id: p,
+      class: ae.input,
+      type: "number",
+      name: l,
+      min: n,
+      max: s,
+      step: c,
+      value: o,
+      placeholder: d,
+      required: u,
+      disabled: m,
+      onInput: r && ((f) => r(f.target.valueAsNumber))
+    }
+  ) });
+}, ce = "_wrapper_1mu6v_1", oe = "_input_1mu6v_6 _text-input_4m0e1_13 _focus-ring_4m0e1_3 _disabled_4m0e1_8", ie = "_toggle_1mu6v_13 _focus-ring_4m0e1_3 _disabled_4m0e1_8", y = {
+  wrapper: ce,
+  input: oe,
+  toggle: ie
+}, re = {
+  current: "current-password",
+  new: "new-password"
+}, We = (t) => {
+  const {
+    label: e,
+    name: l,
+    purpose: n,
+    value: s,
+    placeholder: c,
+    required: o,
+    disabled: d,
+    onInput: u,
+    class: m
+  } = t, r = b(), i = j(!1);
+  return /* @__PURE__ */ a(g, { label: e, for: r, required: o, class: m, children: /* @__PURE__ */ _("div", { class: y.wrapper, children: [
+    /* @__PURE__ */ a(
+      "input",
+      {
+        id: r,
+        class: y.input,
+        type: i.value ? "text" : "password",
+        name: l,
+        value: s,
+        placeholder: c,
+        autoComplete: re[n],
+        required: o,
+        disabled: d,
+        onInput: u && ((p) => u(p.target.value))
+      }
+    ),
+    /* @__PURE__ */ a(
+      "button",
+      {
+        type: "button",
+        class: y.toggle,
+        disabled: d,
+        onClick: () => {
+          i.value = !i.value;
+        },
+        children: i.value ? "Hide password" : "Show password"
+      }
+    )
+  ] }) });
+}, de = "_fieldset_19vke_1", ue = "_legend_19vke_6", _e = "_option_19vke_11", pe = "_input_19vke_19 _check-input_4m0e1_32 _focus-ring_4m0e1_3", w = {
+  fieldset: de,
+  legend: ue,
+  option: _e,
+  input: pe
+}, ze = (t) => {
+  const { legend: e, name: l, options: n, value: s, required: c, disabled: o, onChange: d, class: u } = t, m = b();
+  return /* @__PURE__ */ _("fieldset", { class: h(w.fieldset, u), children: [
+    /* @__PURE__ */ a("legend", { class: w.legend, children: e }),
+    n.map((r) => {
+      const i = `${m}-${r.value}`;
+      return /* @__PURE__ */ _("div", { class: w.option, children: [
+        /* @__PURE__ */ a(
+          "input",
+          {
+            id: i,
+            class: w.input,
+            type: "radio",
+            name: l,
+            value: r.value,
+            checked: s === r.value,
+            required: c,
+            disabled: o,
+            onChange: d && (() => d(r.value))
+          }
+        ),
+        /* @__PURE__ */ a("label", { for: i, children: r.label })
+      ] }, r.value);
+    })
+  ] });
+}, Ae = (t) => {
+  const { path: e, children: l } = t, n = N.value;
+  if (e.endsWith("/*")) {
+    const s = e.slice(0, -1);
+    if (!n.startsWith(s) && n !== s.slice(0, -1))
+      return null;
+  } else if (n !== e)
+    return null;
+  return /* @__PURE__ */ a(T, { children: l });
+}, he = "_section_4nogy_1", me = {
+  section: he
+}, Me = (t) => {
+  const { title: e, level: l = 2, children: n, class: s } = t, c = b(), o = `h${l}`;
+  return /* @__PURE__ */ _("section", { class: h(me.section, s), "aria-labelledby": c, children: [
+    /* @__PURE__ */ a(o, { id: c, children: e }),
+    n
+  ] });
+}, be = "_select_1cxnx_1 _text-input_4m0e1_13 _focus-ring_4m0e1_3 _disabled_4m0e1_8", fe = {
+  select: be
+}, ve = (t) => "options" in t, Ue = (t) => {
+  const {
+    label: e,
+    name: l,
+    value: n,
+    placeholder: s,
+    options: c,
+    required: o,
+    disabled: d,
+    onChange: u,
+    class: m
+  } = t, r = b();
+  return /* @__PURE__ */ a(g, { label: e, for: r, required: o, class: m, children: /* @__PURE__ */ _(
+    "select",
+    {
+      id: r,
+      class: fe.select,
+      name: l,
+      value: n,
+      required: o,
+      disabled: d,
+      onChange: u && ((i) => u(i.target.value)),
+      children: [
+        s && /* @__PURE__ */ a("option", { value: "", disabled: !0, children: s }),
+        c.map(
+          (i) => ve(i) ? /* @__PURE__ */ a("optgroup", { label: i.label, children: i.options.map((p) => /* @__PURE__ */ a("option", { value: p.value, children: p.label }, p.value)) }, i.label) : /* @__PURE__ */ a("option", { value: i.value, children: i.label }, i.value)
+        )
+      ]
+    }
+  ) });
+}, ge = "_skip_xbsul_1 _focus-ring_4m0e1_3", we = {
+  skip: ge
+}, Ve = (t) => {
+  const { target: e = "#main", label: l = "Skip to main content", class: n } = t;
+  return /* @__PURE__ */ a("a", { href: e, class: h(we.skip, n), children: l });
+}, xe = "_table_roeo7_1", ye = {
+  table: xe
+}, Je = (t) => {
+  const { headers: e, data: l, class: n } = t;
+  return /* @__PURE__ */ _("table", { class: h(ye.table, n), children: [
+    /* @__PURE__ */ a("thead", { children: /* @__PURE__ */ a("tr", { children: e.map((s, c) => /* @__PURE__ */ a("th", { scope: "col", children: s }, `${s}-${c}`)) }) }),
+    /* @__PURE__ */ a("tbody", { children: l.map((s, c) => /* @__PURE__ */ a("tr", { children: s.map((o, d) => /* @__PURE__ */ a("td", { children: o }, `${e[d]}-${c}-${d}`)) }, c)) })
+  ] });
+}, ke = "_wrapper_1kyv1_1", $e = "_textarea_1kyv1_6 _text-input_4m0e1_13 _focus-ring_4m0e1_3 _disabled_4m0e1_8", Ne = "_counter_1kyv1_11", k = {
+  wrapper: ke,
+  textarea: $e,
+  counter: Ne
+}, Ke = (t) => {
+  const {
+    label: e,
+    name: l,
+    maxChars: n,
+    value: s,
+    placeholder: c,
+    required: o,
+    disabled: d,
+    onInput: u,
+    class: m
+  } = t, r = b(), i = `${r}-counter`, p = j(s?.length ?? 0);
+  return /* @__PURE__ */ a(g, { label: e, for: r, required: o, class: m, children: /* @__PURE__ */ _("div", { class: k.wrapper, children: [
+    /* @__PURE__ */ a(
+      "textarea",
+      {
+        id: r,
+        class: k.textarea,
+        name: l,
+        maxLength: n,
+        placeholder: c,
+        required: o,
+        disabled: d,
+        "aria-describedby": i,
+        onInput: (f) => {
+          const v = f.target.value;
+          p.value = v.length, u?.(v);
+        },
+        children: s
+      }
+    ),
+    /* @__PURE__ */ _("span", { id: i, class: k.counter, children: [
+      p,
+      " / ",
+      n
+    ] })
+  ] }) });
+}, Ie = "_theme_13mb7_1", Ce = {
+  theme: Ie
+}, Qe = (t) => {
+  const { children: e, class: l } = t;
+  return /* @__PURE__ */ a("div", { class: h(Ce.theme, l), children: e });
+}, qe = "_hidden_19nib_1 _visually-hidden_4m0e1_36", Se = {
+  hidden: qe
+}, Xe = (t) => {
+  const { children: e } = t;
+  return /* @__PURE__ */ a("span", { class: Se.hidden, children: e });
+}, Le = $(document.title);
+D(() => {
+  document.title = Le.value;
+});
+export {
+  I as Button,
+  Te as Card,
+  De as Checkbox,
+  Ee as DownloadLink,
+  Be as Form,
+  He as Input,
+  Oe as Link,
+  Re as Nav,
+  Ge as NumberInput,
+  We as PasswordInput,
+  ze as RadioGroup,
+  Ae as Route,
+  Me as Section,
+  Ue as Select,
+  Ve as SkipLink,
+  Je as Table,
+  Ke as Textarea,
+  Qe as Theme,
+  Xe as VisuallyHidden,
+  h as cx,
+  F as hash,
+  N as location,
+  Z as navigate,
+  Le as title
+};

package/dist/components/Button.d.ts

@@ -0,0 +1,16 @@
+import { IBaseProps } from '../scripts/types';
+import { FunctionComponent } from 'preact';
+/** Props for {@link Button}. */
+interface IButtonProps extends IBaseProps {
+    /** Visible button text. */
+    label: string;
+    /** Click handler. */
+    onClick?: () => void;
+    /** HTML button type. Defaults to `'button'`. */
+    type?: 'button' | 'submit' | 'reset';
+    /** Whether the button is disabled. */
+    disabled?: boolean;
+}
+/** Standard button with configurable type and click handler. */
+declare const Button: FunctionComponent<IButtonProps>;
+export default Button;

package/dist/components/Card.d.ts

@@ -0,0 +1,10 @@
+import { IBaseProps } from '../scripts/types';
+import { ComponentChildren, FunctionComponent } from 'preact';
+/** Props for {@link Card}. */
+interface ICardProps extends IBaseProps {
+    /** Card body content. */
+    children: ComponentChildren;
+}
+/** Visual surface container. Consumers provide their own headings as children. */
+declare const Card: FunctionComponent<ICardProps>;
+export default Card;

package/dist/components/Checkbox.d.ts

@@ -0,0 +1,12 @@
+import { IFieldProps } from '../scripts/types';
+import { FunctionComponent } from 'preact';
+/** Props for {@link Checkbox}. */
+interface ICheckboxProps extends IFieldProps {
+    /** Whether the checkbox is checked. */
+    checked?: boolean;
+    /** Called with the new checked state on change. */
+    onChange?: (checked: boolean) => void;
+}
+/** Checkbox with label. Layout: input before label, no colon suffix. */
+declare const Checkbox: FunctionComponent<ICheckboxProps>;
+export default Checkbox;

package/dist/components/DownloadLink.d.ts

@@ -0,0 +1,14 @@
+import { IBaseProps } from '../scripts/types';
+import { FunctionComponent } from 'preact';
+/** Props for {@link DownloadLink}. */
+interface IDownloadLinkProps extends IBaseProps {
+    /** URL of the file to download. */
+    href: string;
+    /** Filename for the downloaded file. */
+    fileName: string;
+    /** Visible link text. */
+    label: string;
+}
+/** Download link using `<a download>` for file downloads. */
+declare const DownloadLink: FunctionComponent<IDownloadLinkProps>;
+export default DownloadLink;

package/dist/components/Form.d.ts

@@ -0,0 +1,16 @@
+import { IBaseProps } from '../scripts/types';
+import { ComponentChildren, FunctionComponent } from 'preact';
+/** Props for {@link Form}. */
+interface IFormProps extends IBaseProps {
+    /** Called with FormData when the form is submitted. */
+    onSubmit: (data: FormData) => void;
+    /** Label for the submit button. Defaults to `'Submit'`. */
+    submitLabel?: string;
+    /** Label for the optional reset button. Omit to hide. */
+    resetLabel?: string;
+    /** Form field children. */
+    children: ComponentChildren;
+}
+/** Form with submit/reset buttons. Prevents default and provides FormData. */
+declare const Form: FunctionComponent<IFormProps>;
+export default Form;

package/dist/components/FormField.d.ts

@@ -0,0 +1,19 @@
+import { IBaseProps } from '../scripts/types';
+import { ComponentChildren, FunctionComponent } from 'preact';
+/** Props for {@link FormField}. */
+interface IFormFieldProps extends IBaseProps {
+    /** Visible label text. */
+    label: string;
+    /** ID of the input element this label is for. */
+    for: string;
+    /** Whether the field shows a required indicator. Accepts `undefined` for prop forwarding. */
+    required?: boolean | undefined;
+    /** Field input element(s). */
+    children: ComponentChildren;
+}
+/**
+ * Internal layout component for form fields.
+ * Renders a CSS Grid row with label (colon suffix) and input.
+ */
+declare const FormField: FunctionComponent<IFormFieldProps>;
+export default FormField;

package/dist/components/Input.d.ts

@@ -0,0 +1,26 @@
+import { IFieldProps } from '../scripts/types';
+import { FunctionComponent } from 'preact';
+/** Input types supported by the {@link Input} component. */
+export type InputType = 'text' | 'email' | 'url' | 'tel' | 'date' | 'time' | 'datetime-local';
+/** Props for {@link Input}. */
+interface IInputProps extends IFieldProps {
+    /** HTML input type. Defaults to `'text'`. */
+    type?: InputType;
+    /** Current input value. */
+    value?: string;
+    /** Placeholder text. */
+    placeholder?: string;
+    /** Maximum character length. */
+    maxLength?: number;
+    /** Autocomplete hint. Defaults automatically for `email`, `tel`, and `url` types. */
+    autocomplete?: string;
+    /** Whether the field is read-only (focusable, submitted, copyable — distinct from disabled). */
+    readOnly?: boolean;
+    /** Validation pattern (regex string). */
+    pattern?: string;
+    /** Called with the new value on input. */
+    onInput?: (value: string) => void;
+}
+/** Text input with label, wrapped in FormField for layout. */
+declare const Input: FunctionComponent<IInputProps>;
+export default Input;

package/dist/components/Link.d.ts

@@ -0,0 +1,18 @@
+import { IBaseProps } from '../scripts/types';
+import { ComponentChildren, FunctionComponent } from 'preact';
+/** Props for {@link Link}. */
+interface ILinkProps extends IBaseProps {
+    /** URL to navigate to. */
+    href: string;
+    /** Link content. */
+    children: ComponentChildren;
+    /** Force external behavior (same tab, rel attributes). */
+    external?: boolean;
+}
+/**
+ * Link that auto-detects internal vs external URLs.
+ * Internal links use the routing signal's `navigate()`.
+ * External links render a plain `<a>` in the same tab.
+ */
+declare const Link: FunctionComponent<ILinkProps>;
+export default Link;

package/dist/components/Nav.d.ts

@@ -0,0 +1,15 @@
+import { IBaseProps } from '../scripts/types';
+import { ComponentChildren, FunctionComponent } from 'preact';
+/** Props for {@link Nav}. */
+interface INavProps extends IBaseProps {
+    /** Optional title shown as a heading above the nav. */
+    title?: string;
+    /** Navigation links. */
+    children: ComponentChildren;
+}
+/**
+ * Semantic `<nav>` wrapper with optional title heading.
+ * When a title is provided, `aria-labelledby` links the landmark to the heading.
+ */
+declare const Nav: FunctionComponent<INavProps>;
+export default Nav;

package/dist/components/NumberInput.d.ts

@@ -0,0 +1,20 @@
+import { IFieldProps } from '../scripts/types';
+import { FunctionComponent } from 'preact';
+/** Props for {@link NumberInput}. */
+interface INumberInputProps extends IFieldProps {
+    /** Minimum allowed value. */
+    min?: number;
+    /** Maximum allowed value. */
+    max?: number;
+    /** Step increment. */
+    step?: number;
+    /** Current numeric value. */
+    value?: number;
+    /** Placeholder text. */
+    placeholder?: string;
+    /** Called with the new numeric value on input. Returns `NaN` for empty input. */
+    onInput?: (value: number) => void;
+}
+/** Numeric input with label, wrapped in FormField for layout. */
+declare const NumberInput: FunctionComponent<INumberInputProps>;
+export default NumberInput;

package/dist/components/PasswordInput.d.ts

@@ -0,0 +1,16 @@
+import { IFieldProps } from '../scripts/types';
+import { FunctionComponent } from 'preact';
+/** Props for {@link PasswordInput}. */
+interface IPasswordInputProps extends IFieldProps {
+    /** Whether this is for the current password or a new one. Drives `autocomplete` automatically. */
+    purpose: 'current' | 'new';
+    /** Current input value. */
+    value?: string;
+    /** Placeholder text. */
+    placeholder?: string;
+    /** Called with the new value on input. */
+    onInput?: (value: string) => void;
+}
+/** Password input with show/hide toggle, wrapped in FormField for layout. */
+declare const PasswordInput: FunctionComponent<IPasswordInputProps>;
+export default PasswordInput;

package/dist/components/RadioGroup.d.ts

@@ -0,0 +1,29 @@
+import { IBaseProps } from '../scripts/types';
+import { FunctionComponent } from 'preact';
+/** A single option in a {@link RadioGroup}. */
+export interface IRadioOption {
+    /** Visible label text. */
+    label: string;
+    /** Form value when selected. */
+    value: string;
+}
+/** Props for {@link RadioGroup}. */
+interface IRadioGroupProps extends IBaseProps {
+    /** Fieldset legend text. */
+    legend: string;
+    /** Field name attribute for form submission. */
+    name: string;
+    /** Available radio options. */
+    options: IRadioOption[];
+    /** Currently selected value. */
+    value?: string;
+    /** Whether a selection is required. */
+    required?: boolean;
+    /** Whether the group is disabled. */
+    disabled?: boolean;
+    /** Called with the selected value on change. */
+    onChange?: (value: string) => void;
+}
+/** Radio button group inside a fieldset with legend. */
+declare const RadioGroup: FunctionComponent<IRadioGroupProps>;
+export default RadioGroup;

package/dist/components/Route.d.ts

@@ -0,0 +1,14 @@
+import { ComponentChildren, FunctionComponent } from 'preact';
+/** Props for {@link Route}. */
+interface IRouteProps {
+    /** URL path pattern. Supports trailing wildcard (`/users/*`). */
+    path: string;
+    /** Content to render when the route matches. */
+    children: ComponentChildren;
+}
+/**
+ * Renders children when the current location matches the path pattern.
+ * Supports exact matches and trailing wildcard (`/users/*`).
+ */
+declare const Route: FunctionComponent<IRouteProps>;
+export default Route;

package/dist/components/Section.d.ts

@@ -0,0 +1,17 @@
+import { IBaseProps } from '../scripts/types';
+import { ComponentChildren, FunctionComponent } from 'preact';
+/** Props for {@link Section}. */
+interface ISectionProps extends IBaseProps {
+    /** Section heading text. */
+    title: string;
+    /** Heading level. Defaults to `2`. */
+    level?: 2 | 3 | 4 | 5 | 6;
+    /** Section body content. */
+    children: ComponentChildren;
+}
+/**
+ * Semantic `<section>` with configurable heading level (defaults to h2).
+ * `aria-labelledby` links the region landmark to its heading.
+ */
+declare const Section: FunctionComponent<ISectionProps>;
+export default Section;

package/dist/components/Select.d.ts

@@ -0,0 +1,30 @@
+import { IFieldProps } from '../scripts/types';
+import { FunctionComponent } from 'preact';
+/** A single option in a {@link Select}. */
+export interface ISelectOption {
+    /** Visible label text. */
+    label: string;
+    /** Form value when selected. */
+    value: string;
+}
+/** A labeled group of options in a {@link Select}. */
+export interface ISelectGroup {
+    /** Group label shown as the optgroup heading. */
+    label: string;
+    /** Options within this group. */
+    options: ISelectOption[];
+}
+/** Props for {@link Select}. */
+interface ISelectProps extends IFieldProps {
+    /** Current selected value. */
+    value?: string;
+    /** Placeholder text shown as a disabled first option. Omit to hide. */
+    placeholder?: string;
+    /** Available options — flat, grouped, or mixed. */
+    options: (ISelectOption | ISelectGroup)[];
+    /** Called with the new value on change. */
+    onChange?: (value: string) => void;
+}
+/** Select dropdown with label, wrapped in FormField for layout. */
+declare const Select: FunctionComponent<ISelectProps>;
+export default Select;

package/dist/components/SkipLink.d.ts

@@ -0,0 +1,15 @@
+import { IBaseProps } from '../scripts/types';
+import { FunctionComponent } from 'preact';
+/** Props for {@link SkipLink}. */
+interface ISkipLinkProps extends IBaseProps {
+    /** Target element ID (including `#`). Defaults to `'#main'`. */
+    target?: string;
+    /** Visible link text. Defaults to `'Skip to main content'`. */
+    label?: string;
+}
+/**
+ * Skip navigation link. Hidden until focused via keyboard Tab.
+ * Targets `#main` by default.
+ */
+declare const SkipLink: FunctionComponent<ISkipLinkProps>;
+export default SkipLink;

package/dist/components/Table.d.ts

@@ -0,0 +1,15 @@
+import { IBaseProps } from '../scripts/types';
+import { ComponentChildren, FunctionComponent } from 'preact';
+/** Props for {@link Table}. */
+interface ITableProps extends IBaseProps {
+    /** Column header labels. */
+    headers: string[];
+    /** Row data as a 2D array of renderable content. */
+    data: ComponentChildren[][];
+}
+/**
+ * Accessible data table with required headers.
+ * Headers render as `<th scope="col">`, data auto-formats into `<tbody>`/`<td>`.
+ */
+declare const Table: FunctionComponent<ITableProps>;
+export default Table;

package/dist/components/Textarea.d.ts

@@ -0,0 +1,16 @@
+import { IFieldProps } from '../scripts/types';
+import { FunctionComponent } from 'preact';
+/** Props for {@link Textarea}. */
+interface ITextareaProps extends IFieldProps {
+    /** Maximum character limit. Sets `maxLength` on the textarea. */
+    maxChars: number;
+    /** Current textarea value. */
+    value?: string;
+    /** Placeholder text. */
+    placeholder?: string;
+    /** Called with the new value on input. */
+    onInput?: (value: string) => void;
+}
+/** Textarea with label and character counter, wrapped in FormField for layout. */
+declare const Textarea: FunctionComponent<ITextareaProps>;
+export default Textarea;

package/dist/components/Theme.d.ts

@@ -0,0 +1,32 @@
+import { IBaseProps } from '../scripts/types';
+import { ComponentChildren, FunctionComponent } from 'preact';
+/** Props for {@link Theme}. */
+interface IThemeProps extends IBaseProps {
+    /** Content to theme. */
+    children: ComponentChildren;
+}
+/**
+ * Theme wrapper that scopes `--aui-*` custom properties to its subtree.
+ *
+ * The consumer defines the custom properties in their own CSS class:
+ *
+ * ```css
+ * .my-theme {
+ *   --aui-color-text: #1a1a1a;
+ *   --aui-color-background: #ffffff;
+ *   --aui-color-primary: #2563eb;
+ * }
+ * ```
+ *
+ * Then wrap your app:
+ *
+ * ```tsx
+ * <Theme class="my-theme">
+ *   <App />
+ * </Theme>
+ * ```
+ *
+ * Nestable for sub-themes (e.g. dark mode sections).
+ */
+declare const Theme: FunctionComponent<IThemeProps>;
+export default Theme;

package/dist/components/VisuallyHidden.d.ts

@@ -0,0 +1,12 @@
+import { ComponentChildren, FunctionComponent } from 'preact';
+/** Props for {@link VisuallyHidden}. */
+interface IVisuallyHiddenProps {
+    /** Content visible to assistive technology only. */
+    children: ComponentChildren;
+}
+/**
+ * CSS-only screen-reader utility. Content is hidden visually
+ * but remains accessible to assistive technology.
+ */
+declare const VisuallyHidden: FunctionComponent<IVisuallyHiddenProps>;
+export default VisuallyHidden;

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export { default as Button } from './components/Button';
+export { default as Card } from './components/Card';
+export { default as Checkbox } from './components/Checkbox';
+export { default as DownloadLink } from './components/DownloadLink';
+export { default as Form } from './components/Form';
+export { default as Input } from './components/Input';
+export { default as Link } from './components/Link';
+export { default as Nav } from './components/Nav';
+export { default as NumberInput } from './components/NumberInput';
+export { default as PasswordInput } from './components/PasswordInput';
+export type { IRadioOption } from './components/RadioGroup';
+export { default as RadioGroup } from './components/RadioGroup';
+export { default as Route } from './components/Route';
+export { default as Section } from './components/Section';
+export type { ISelectGroup, ISelectOption } from './components/Select';
+export { default as Select } from './components/Select';
+export { default as SkipLink } from './components/SkipLink';
+export { default as Table } from './components/Table';
+export { default as Textarea } from './components/Textarea';
+export { default as Theme } from './components/Theme';
+export { default as VisuallyHidden } from './components/VisuallyHidden';
+export { cx } from './scripts/utils';
+export { title } from './signals/head';
+export { hash, location, navigate } from './signals/routing';

package/dist/scripts/types.d.ts

@@ -0,0 +1,16 @@
+/** Base props shared by all components. */
+export interface IBaseProps {
+    /** CSS class name for custom styling. Accepts `undefined` for prop forwarding. */
+    class?: string | undefined;
+}
+/** Props for form field components that render a label. */
+export interface IFieldProps extends IBaseProps {
+    /** Visible label text for the field. */
+    label: string;
+    /** Field name attribute for form submission. */
+    name: string;
+    /** Whether the field is required. Adds a visual asterisk to the label. */
+    required?: boolean;
+    /** Whether the field is disabled. */
+    disabled?: boolean;
+}

package/dist/scripts/utils.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Combine CSS class names, filtering out falsy values.
+ *
+ * The type accepts `false` and `undefined` because those are the two falsy
+ * values that naturally appear when building class lists:
+ *
+ * - **`false`** — from the `&&` short-circuit pattern:
+ *   ```ts
+ *   cx(styles.button, isActive && styles.active)
+ *   //                 ^^^^^^^^^^^^^^^^^^^^^^^^^ → string | false
+ *   ```
+ *
+ * - **`undefined`** — from optional props like `class?`:
+ *   ```ts
+ *   cx(styles.card, className)
+ *   //              ^^^^^^^^^ → string | undefined
+ *   ```
+ *
+ * @example
+ * // Static classes
+ * cx(styles.button, styles.primary)  // "btn_x1 primary_x2"
+ *
+ * @example
+ * // Conditional class via &&
+ * cx(styles.button, disabled && styles.disabled)
+ *
+ * @example
+ * // Forwarding an optional class prop
+ * cx(styles.card, props.class)
+ *
+ * @param classes - Class names to combine. `false` and `undefined` values are
+ *   filtered out; only truthy strings are joined.
+ * @returns Space-separated class string, or empty string if no truthy values.
+ */
+export declare function cx(...classes: (string | false | undefined)[]): string;

package/dist/signals/head.d.ts

@@ -0,0 +1,2 @@
+/** Document title signal. Changes are synced to `document.title`. */
+export declare const title: import('@preact/signals-core').Signal<string>;

package/dist/signals/routing.d.ts

@@ -0,0 +1,11 @@
+/** Current URL pathname. */
+export declare const location: import('@preact/signals-core').Signal<string>;
+/** Current URL hash (without the `#` prefix). */
+export declare const hash: import('@preact/signals-core').Signal<string>;
+/**
+ * Navigate to a new URL path using the History API.
+ * Updates all routing signals accordingly.
+ */
+export declare function navigate(path: string, options?: {
+    replace?: boolean;
+}): void;

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@auldrant/ui",
+  "version": "0.0.0",
+  "type": "module",
+  "description": "Accessible Preact component library with design tokens and CSS modules",
+  "author": "Colonel Jade",
+  "license": "MIT",
+  "keywords": ["preact", "components", "ui", "component-library", "accessibility", "a11y", "css-modules", "design-tokens", "typescript"],
+  "publishConfig": { "access": "public" },
+  "module": "./dist/auldrant-ui.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/auldrant-ui.js"
+    },
+    "./styles": "./dist/auldrant-ui.css"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "check": "biome check .",
+    "check:fix": "biome check --fix .",
+    "format": "biome format --fix .",
+    "lint": "biome lint .",
+    "test": "bun test",
+    "test:a11y": "bun test tests/a11y/",
+    "test:watch": "bun test --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build",
+    "storybook": "storybook dev -p 6006",
+    "build-storybook": "storybook build",
+    "prepare": "test -n \"$CI\" || lefthook install"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.4",
+    "@happy-dom/global-registrator": "^20.7.0",
+    "@preact/preset-vite": "^2.10.3",
+    "@preact/signals": "^2.8.1",
+    "@storybook/preact-vite": "^10.2.10",
+    "@testing-library/preact": "^3.2.4",
+    "@types/bun": "latest",
+    "axe-core": "^4.11.1",
+    "lefthook": "^2.1.1",
+    "preact": "^10.28.4",
+    "storybook": "^10.2.10",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vite-plugin-dts": "^4.5.4"
+  },
+  "peerDependencies": {
+    "@preact/signals": "^2.8.1",
+    "preact": "^10.28.4"
+  }
+}