@pithyjs/ui-kit 0.1.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PithyJS
+
+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/dist/animation/animate-in.d.ts

@@ -0,0 +1,35 @@
+/** @codex
+{
+  "id": "pithy.ui-kit.animate-in",
+  "title": "Entrance Animation Helper",
+  "category": "runtime"
+}
+*/
+import { type AnimationPattern } from '@pithyjs/design-system';
+/**
+ * Apply a design-system animation to an element.
+ *
+ * Despite the name, this helper supports **all** animation patterns defined in
+ * `ANIMATION_PATTERNS` — entrance (`fade-in`, `slide-up`, …), exit (`fade-out`),
+ * and continuous (`spin`). The name `animateIn` reflects the most common usage
+ * (entrance animations); a future `applyAnimation` alias may be added.
+ *
+ * Adds the appropriate `.u-animate-*` utility class from the design system.
+ * Animations are automatically disabled when `prefers-reduced-motion: reduce`
+ * is active (handled by the design system's motion tokens, which zero out
+ * durations — no JS-level media query check is needed).
+ *
+ * @param el - The element to animate
+ * @param rawPattern - Animation pattern from design system tokens (default: `"fade-in"`)
+ * @returns A cleanup function that removes the animation class
+ *
+ * @example
+ * ```ts
+ * const cleanup = animateIn(el);
+ * // later, in destroy():
+ * cleanup();
+ * ```
+ */
+/** @codexApi {"parent":"pithy.ui-kit.animate-in","name":"animateIn","stability":"stable","signature":"(el: Element | null | undefined, pattern?: AnimationPattern) => () => void"} */
+export declare function animateIn(el: Element | null | undefined, rawPattern?: AnimationPattern): () => void;
+//# sourceMappingURL=animate-in.d.ts.map

package/dist/animation/animate-in.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animate-in.d.ts","sourceRoot":"","sources":["../../src/animation/animate-in.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAkBhC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,sLAAsL;AACtL,wBAAgB,SAAS,CACvB,EAAE,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,EAC9B,UAAU,GAAE,gBAA4B,GACvC,MAAM,IAAI,CA+BZ"}

package/dist/animation/animate-in.js

@@ -0,0 +1,71 @@
+/** @codex
+{
+  "id": "pithy.ui-kit.animate-in",
+  "title": "Entrance Animation Helper",
+  "category": "runtime"
+}
+*/
+import { ANIMATION_PATTERNS, } from '@pithyjs/design-system';
+/**
+ * Static map from animation pattern to its utility class name.
+ * Written as literals so the design-system JIT scanner can detect every
+ * class during source scanning — do NOT replace with template literals.
+ */
+const ANIMATE_CLASS = {
+    'fade-in': 'u-animate-fade-in',
+    'fade-out': 'u-animate-fade-out',
+    'fade-scale-in': 'u-animate-fade-scale-in',
+    'slide-up': 'u-animate-slide-up',
+    'slide-down': 'u-animate-slide-down',
+    'slide-left': 'u-animate-slide-left',
+    'slide-right': 'u-animate-slide-right',
+    spin: 'u-animate-spin',
+};
+/**
+ * Apply a design-system animation to an element.
+ *
+ * Despite the name, this helper supports **all** animation patterns defined in
+ * `ANIMATION_PATTERNS` — entrance (`fade-in`, `slide-up`, …), exit (`fade-out`),
+ * and continuous (`spin`). The name `animateIn` reflects the most common usage
+ * (entrance animations); a future `applyAnimation` alias may be added.
+ *
+ * Adds the appropriate `.u-animate-*` utility class from the design system.
+ * Animations are automatically disabled when `prefers-reduced-motion: reduce`
+ * is active (handled by the design system's motion tokens, which zero out
+ * durations — no JS-level media query check is needed).
+ *
+ * @param el - The element to animate
+ * @param rawPattern - Animation pattern from design system tokens (default: `"fade-in"`)
+ * @returns A cleanup function that removes the animation class
+ *
+ * @example
+ * ```ts
+ * const cleanup = animateIn(el);
+ * // later, in destroy():
+ * cleanup();
+ * ```
+ */
+/** @codexApi {"parent":"pithy.ui-kit.animate-in","name":"animateIn","stability":"stable","signature":"(el: Element | null | undefined, pattern?: AnimationPattern) => () => void"} */
+export function animateIn(el, rawPattern = 'fade-in') {
+    // Guard: no element — return no-op cleanup
+    if (!el || !(el instanceof Element)) {
+        if (import.meta.env?.DEV) {
+            console.warn(`[animateIn] Expected an Element but received ${el === null ? 'null' : typeof el}. Animation skipped.`);
+        }
+        return () => { };
+    }
+    const validPattern = ANIMATION_PATTERNS.includes(rawPattern);
+    if (import.meta.env?.DEV) {
+        if (!validPattern) {
+            const valid = ANIMATION_PATTERNS.join(', ');
+            console.warn(`[animateIn] Invalid pattern: "${rawPattern}". Expected one of: ${valid}. Falling back to "fade-in".`);
+        }
+    }
+    const pattern = validPattern ? rawPattern : 'fade-in';
+    const cls = ANIMATE_CLASS[pattern];
+    el.classList.add(cls);
+    return () => {
+        el.classList.remove(cls);
+    };
+}
+//# sourceMappingURL=animate-in.js.map

package/dist/animation/animate-in.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animate-in.js","sourceRoot":"","sources":["../../src/animation/animate-in.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF,OAAO,EACL,kBAAkB,GAEnB,MAAM,wBAAwB,CAAC;AAEhC;;;;GAIG;AACH,MAAM,aAAa,GAAqC;IACtD,SAAS,EAAE,mBAAmB;IAC9B,UAAU,EAAE,oBAAoB;IAChC,eAAe,EAAE,yBAAyB;IAC1C,UAAU,EAAE,oBAAoB;IAChC,YAAY,EAAE,sBAAsB;IACpC,YAAY,EAAE,sBAAsB;IACpC,aAAa,EAAE,uBAAuB;IACtC,IAAI,EAAE,gBAAgB;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,sLAAsL;AACtL,MAAM,UAAU,SAAS,CACvB,EAA8B,EAC9B,aAA+B,SAAS;IAExC,2CAA2C;IAC3C,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,YAAY,OAAO,CAAC,EAAE,CAAC;QACpC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CACV,gDAAgD,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,sBAAsB,CACvG,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,YAAY,GAAI,kBAAwC,CAAC,QAAQ,CACrE,UAAU,CACX,CAAC;IAEF,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5C,OAAO,CAAC,IAAI,CACV,iCAAiC,UAAU,uBAAuB,KAAK,8BAA8B,CACtG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACnC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAEtB,OAAO,GAAG,EAAE;QACV,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC,CAAC;AACJ,CAAC"}

package/dist/atoms/actions/_icon-control.scss

@@ -0,0 +1,53 @@
+/// Shared visual for single icon-only control buttons — the circular icon
+/// "option" used by both <IconGroup> options and the standalone <IconButton>.
+/// Keeping this in one mixin means the two render pixel-identically.
+///
+/// @group atoms/actions
+
+@use '@pithyjs/design-system/a11y/styles/mixins' as a11y;
+
+/// Circular icon button: muted by default, hover tint, primary "active" state
+/// (driven by `[data-active="true"]`), focus ring, and forced-colors handling.
+@mixin icon-control-button {
+  appearance: none;
+  margin: 0;
+  display: grid;
+  place-items: center;
+  border: 0;
+  // Pill radius keeps the icon button circular by default, but follows the
+  // design-system radius scale — the `sharp` preset sets `--radius-pill: 0`, so
+  // a square icon button is themeable rather than hard-locked to a circle.
+  // Falls back to a circle (`50%`) when the radius module isn't initialized.
+  border-radius: var(--radius-pill, 50%);
+  background: transparent;
+  color: var(--color-text-muted);
+  cursor: pointer;
+  font: inherit;
+
+  @include a11y.motion-safe {
+    transition:
+      var(--motion-transition-background), var(--motion-transition-color);
+  }
+
+  &:hover:not([data-active='true']) {
+    color: var(--color-text);
+    @include a11y.state-background(hover, var(--color-text));
+  }
+
+  &[data-active='true'] {
+    color: var(--color-primary);
+    @include a11y.state-background(selected, var(--color-primary));
+  }
+
+  &:focus-visible {
+    @include a11y.focus-ring;
+  }
+
+  @include a11y.forced-colors {
+    &[data-active='true'] {
+      forced-color-adjust: none;
+      background-color: Highlight;
+      color: HighlightText;
+    }
+  }
+}

package/dist/atoms/actions/button/Button.d.ts

@@ -0,0 +1,93 @@
+/** @codex
+{
+  "id": "pithy.ui-kit.button",
+  "title": "<Button> Action Component",
+  "category": "feature"
+}
+*/
+import type { ReactiveText } from '../../../shared/clickable';
+import { type ControlSize, type RadiusSize } from '@pithyjs/design-system';
+import { type ButtonVariant, type ButtonType, type ButtonTag } from '../../../shared/button';
+import { type SemanticColor } from '../../../shared/types';
+/** @codexApi {"parent":"pithy.ui-kit.button","name":"ButtonProps","stability":"stable","signature":"interface ButtonProps"} */
+export interface ButtonProps {
+    /** Visual variant (default: "solid") */
+    variant?: ButtonVariant;
+    /** Color scheme — maps to design-system semantic tokens (default: "primary") */
+    color?: SemanticColor;
+    /** Size — maps to u-control-* utilities (default: "md") */
+    size?: ControlSize;
+    /** Border-radius shape — `"xl"` reads as pill, `"none"` as square (default: `"md"`) */
+    shape?: RadiusSize;
+    /** Disabled state — static boolean or signal/computed accessor (default: false) */
+    disabled?: boolean | (() => boolean);
+    /** Loading state — static boolean or signal/computed accessor (default: false) */
+    loading?: boolean | (() => boolean);
+    /** HTML button type (default: "button") */
+    type?: ButtonType;
+    /** Screen-reader text shown during loading (default: "Loading…") */
+    loadingText?: string;
+    /** Tab index override (default: native <button> behaviour, i.e. 0) */
+    tabIndex?: number;
+    /** Stretch to full container width (default: false) */
+    fullWidth?: boolean;
+    /** Render as a different element — "a" without href becomes <a role="button">; "a" with href keeps native link semantics (default: "button") */
+    as?: ButtonTag;
+    /** href for anchor element — only used when as="a"; preserves native link semantics (no role="button") */
+    href?: string;
+    /** Click handler, guarded against disabled/loading. Prefer @click on the component tag; onClick is an alternative. */
+    onClick?: (e: MouseEvent) => void;
+    /** Accessible label — forwarded as aria-label on the root element.
+     *  Static string or signal/computed accessor.
+     *  Use when the button has no visible text (e.g. icon-only buttons). */
+    ariaLabel?: ReactiveText;
+    /** Visible button label — static string or signal/computed accessor. When set,
+     *  the label is used as the button's content and slot children are ignored.
+     *  Omit to fall back to slot content (`<Button>Click me</Button>`). */
+    text?: ReactiveText;
+    /** Icon name (from the registered sprite) rendered before the label — static or signal. */
+    iconStart?: ReactiveText;
+    /** Icon name (from the registered sprite) rendered after the label — static or signal. */
+    iconEnd?: ReactiveText;
+}
+/**
+ * Accessible, reactive button component.
+ *
+ * Renders a `<button>` by default, or `<a>` when `as="a"`.
+ * When `as="a"` with `href`, the anchor keeps native link semantics
+ * (screen reader announces "link", Enter navigates, Space scrolls).
+ * When `as="a"` without `href`, it becomes `<a role="button">` with
+ * full button keyboard emulation (Space + Enter activate).
+ * Supports reactive `disabled`/`loading` via signal accessors.
+ * For navigation links, use `<NavLink>` instead. The `link` variant is
+ * for buttons that look like hyperlinks (e.g. "Cancel" actions).
+ *
+ * @param props - Button configuration
+ * @param props.variant - Visual style: `"solid"` | `"outline"` | `"ghost"` | `"link"` (default: `"solid"`)
+ * @param props.color - Semantic color: `"primary"` | `"secondary"` | `"tertiary"` | `"success"` | `"info"` | `"warning"` | `"danger"` (default: `"primary"`)
+ * @param props.size - Control size: `"sm"` | `"md"` | `"lg"` (default: `"md"`)
+ * @param props.disabled - Disabled state, static or signal (default: `false`)
+ * @param props.loading - Loading state with spinner, static or signal (default: `false`)
+ * @param props.type - HTML button type: `"button"` | `"submit"` | `"reset"` (default: `"button"`)
+ * @param props.loadingText - Screen reader loading announcement (default: `"Loading…"`)
+ * @param props.tabIndex - Tab order override
+ * @param props.fullWidth - Stretch to 100% container width (default: `false`)
+ * @param props.as - Element tag: `"button"` | `"a"` (default: `"button"`)
+ * @param props.href - Link URL, only when `as="a"`
+ * @param props.onClick - Click handler, guarded against disabled/loading
+ * @param props.ariaLabel - Accessible label for icon-only or unlabelled buttons, static or signal
+ * @returns `{ el, destroy }` — mounted element and cleanup function
+ *
+ * @example
+ * ```html
+ * <Button variant="'solid'" color="'primary'">Save</Button>
+ * <Button variant="'outline'" loading="isLoading">Submit</Button>
+ * <Button as="'a'" href="'/docs'" variant="'ghost'">Read More</Button>
+ * ```
+ */
+/** @codexApi {"parent":"pithy.ui-kit.button","name":"Button","stability":"stable","signature":"(props?: ButtonProps) => { el: HTMLElement | DocumentFragment; destroy: () => void }"} */
+export declare function Button({ variant: rawVariant, color: rawColor, size: rawSize, shape: rawShape, disabled, loading, type: rawType, loadingText, tabIndex, fullWidth, as: rawAs, href, onClick, ariaLabel, text, iconStart, iconEnd, }?: ButtonProps): {
+    el: HTMLElement | DocumentFragment;
+    destroy: () => void;
+};
+//# sourceMappingURL=Button.d.ts.map

package/dist/atoms/actions/button/Button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../../src/atoms/actions/button/Button.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAIF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,uBAAuB,CAAC;AAE/B,+HAA+H;AAC/H,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,gFAAgF;IAChF,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,uFAAuF;IACvF,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;IACrC,kFAAkF;IAClF,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;IACpC,2CAA2C;IAC3C,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gJAAgJ;IAChJ,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,0GAA0G;IAC1G,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sHAAsH;IACtH,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IAClC;;4EAEwE;IACxE,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB;;2EAEuE;IACvE,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,2FAA2F;IAC3F,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,yLAAyL;AACzL,wBAAgB,MAAM,CAAC,EACrB,OAAO,EAAE,UAAoB,EAC7B,KAAK,EAAE,QAAoB,EAC3B,IAAI,EAAE,OAAc,EACpB,KAAK,EAAE,QAAe,EACtB,QAAgB,EAChB,OAAe,EACf,IAAI,EAAE,OAAkB,EACxB,WAA6B,EAC7B,QAAoB,EACpB,SAAiB,EACjB,EAAE,EAAE,KAAgB,EACpB,IAAgB,EAChB,OAAmB,EACnB,SAAqB,EACrB,IAAgB,EAChB,SAAqB,EACrB,OAAmB,GACpB,GAAE,WAAgB,GAAG;IACpB,EAAE,EAAE,WAAW,GAAG,gBAAgB,CAAC;IACnC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAmUA"}

package/dist/atoms/actions/button/Button.js

@@ -0,0 +1,332 @@
+/** @codex
+{
+  "id": "pithy.ui-kit.button",
+  "title": "<Button> Action Component",
+  "category": "feature"
+}
+*/
+import { renderChildren } from '@pithyjs/core';
+import { effect } from '@pithyjs/signals';
+import { RADIUS_SIZES, } from '@pithyjs/design-system';
+import { Icon } from '../../content/icon/Icon';
+import { BUTTON_VARIANTS, BUTTON_TYPES, BUTTON_TAGS, } from '../../../shared/button';
+import { CONTROL_CLASS } from '../../../shared/common';
+import { SEMANTIC_COLORS, CONTROL_SIZES, } from '../../../shared/types';
+/**
+ * Accessible, reactive button component.
+ *
+ * Renders a `<button>` by default, or `<a>` when `as="a"`.
+ * When `as="a"` with `href`, the anchor keeps native link semantics
+ * (screen reader announces "link", Enter navigates, Space scrolls).
+ * When `as="a"` without `href`, it becomes `<a role="button">` with
+ * full button keyboard emulation (Space + Enter activate).
+ * Supports reactive `disabled`/`loading` via signal accessors.
+ * For navigation links, use `<NavLink>` instead. The `link` variant is
+ * for buttons that look like hyperlinks (e.g. "Cancel" actions).
+ *
+ * @param props - Button configuration
+ * @param props.variant - Visual style: `"solid"` | `"outline"` | `"ghost"` | `"link"` (default: `"solid"`)
+ * @param props.color - Semantic color: `"primary"` | `"secondary"` | `"tertiary"` | `"success"` | `"info"` | `"warning"` | `"danger"` (default: `"primary"`)
+ * @param props.size - Control size: `"sm"` | `"md"` | `"lg"` (default: `"md"`)
+ * @param props.disabled - Disabled state, static or signal (default: `false`)
+ * @param props.loading - Loading state with spinner, static or signal (default: `false`)
+ * @param props.type - HTML button type: `"button"` | `"submit"` | `"reset"` (default: `"button"`)
+ * @param props.loadingText - Screen reader loading announcement (default: `"Loading…"`)
+ * @param props.tabIndex - Tab order override
+ * @param props.fullWidth - Stretch to 100% container width (default: `false`)
+ * @param props.as - Element tag: `"button"` | `"a"` (default: `"button"`)
+ * @param props.href - Link URL, only when `as="a"`
+ * @param props.onClick - Click handler, guarded against disabled/loading
+ * @param props.ariaLabel - Accessible label for icon-only or unlabelled buttons, static or signal
+ * @returns `{ el, destroy }` — mounted element and cleanup function
+ *
+ * @example
+ * ```html
+ * <Button variant="'solid'" color="'primary'">Save</Button>
+ * <Button variant="'outline'" loading="isLoading">Submit</Button>
+ * <Button as="'a'" href="'/docs'" variant="'ghost'">Read More</Button>
+ * ```
+ */
+/** @codexApi {"parent":"pithy.ui-kit.button","name":"Button","stability":"stable","signature":"(props?: ButtonProps) => { el: HTMLElement | DocumentFragment; destroy: () => void }"} */
+export function Button({ variant: rawVariant = 'solid', color: rawColor = 'primary', size: rawSize = 'md', shape: rawShape = 'md', disabled = false, loading = false, type: rawType = 'button', loadingText = 'Loading\u2026', tabIndex = undefined, fullWidth = false, as: rawAs = 'button', href = undefined, onClick = undefined, ariaLabel = undefined, text = undefined, iconStart = undefined, iconEnd = undefined, } = {}) {
+    const validVariant = BUTTON_VARIANTS.includes(rawVariant);
+    const validColor = SEMANTIC_COLORS.includes(rawColor);
+    const validSize = CONTROL_SIZES.includes(rawSize);
+    const validShape = RADIUS_SIZES.includes(rawShape);
+    const validType = BUTTON_TYPES.includes(rawType);
+    const validAs = BUTTON_TAGS.includes(rawAs);
+    if (import.meta.env?.DEV) {
+        if (!validVariant) {
+            const valid = BUTTON_VARIANTS.join(', ');
+            console.warn(`[<Button>] Invalid variant: "${rawVariant}". Expected one of: ${valid}. Falling back to "solid".`);
+        }
+        if (!validColor) {
+            const valid = SEMANTIC_COLORS.join(', ');
+            console.warn(`[<Button>] Invalid color: "${rawColor}". Expected one of: ${valid}. Falling back to "primary".`);
+        }
+        if (!validSize) {
+            const valid = CONTROL_SIZES.join(', ');
+            console.warn(`[<Button>] Invalid size: "${rawSize}". Expected one of: ${valid}. Falling back to "md".`);
+        }
+        if (!validShape) {
+            const valid = RADIUS_SIZES.join(', ');
+            console.warn(`[<Button>] Invalid shape: "${rawShape}". Expected one of: ${valid}. Falling back to "md".`);
+        }
+        if (!validType) {
+            const valid = BUTTON_TYPES.join(', ');
+            console.warn(`[<Button>] Invalid type: "${rawType}". Expected one of: ${valid}. Falling back to "button".`);
+        }
+        if (!validAs) {
+            const valid = BUTTON_TAGS.join(', ');
+            console.warn(`[<Button>] Invalid as: "${rawAs}". Expected one of: ${valid}. Falling back to "button".`);
+        }
+    }
+    const variant = validVariant ? rawVariant : 'solid';
+    const color = validColor ? rawColor : 'primary';
+    const size = validSize ? rawSize : 'md';
+    const shape = validShape ? rawShape : 'md';
+    const type = validType ? rawType : 'button';
+    const tag = validAs ? rawAs : 'button';
+    // Create element — <button> or <a role="button">
+    const el = document.createElement(tag);
+    // Classes
+    // Link variant is inline text, not a sized control — skip u-control-* class
+    // Radius is driven by data-shape attribute (see button.scss), not a class,
+    // for consistency with the data-variant/data-color/data-size pattern.
+    el.classList.add('ui-button', 'u-focus-ring');
+    if (variant !== 'link') {
+        el.classList.add(CONTROL_CLASS[size]);
+    }
+    // fullWidth
+    if (fullWidth) {
+        el.setAttribute('data-full-width', '');
+    }
+    // Attributes
+    el.setAttribute('data-variant', variant);
+    el.setAttribute('data-color', color);
+    el.setAttribute('data-size', size);
+    el.setAttribute('data-shape', shape);
+    const isAriaLabelFn = typeof ariaLabel === 'function';
+    const applyAriaLabel = (value) => {
+        const trimmed = value?.trim();
+        if (trimmed) {
+            el.setAttribute('aria-label', trimmed);
+        }
+        else {
+            el.removeAttribute('aria-label');
+            if (!isAriaLabelFn && value != null && import.meta.env?.DEV) {
+                console.warn(`[<Button>] ariaLabel was provided but is empty or whitespace-only; aria-label was not set.`);
+            }
+        }
+    };
+    const cleanupAriaLabelEffect = isAriaLabelFn
+        ? effect(() => applyAriaLabel(ariaLabel()))
+        : (applyAriaLabel(ariaLabel), undefined);
+    let keydownHandler;
+    let keyupHandler;
+    if (tag === 'button') {
+        el.type = type;
+    }
+    else if (href != null) {
+        // <a> with href: keep native link semantics (no role override).
+        // Screen reader announces "link" — correct since it navigates.
+        // Enter activates natively; Space scrolls (standard link behaviour).
+        el.setAttribute('href', href);
+    }
+    else {
+        // <a> without href: true button-as-anchor pattern.
+        // Add role="button", ensure focusability, and emulate button keyboard.
+        el.setAttribute('role', 'button');
+        if (tabIndex == null) {
+            el.tabIndex = 0;
+        }
+        // Keyboard support for <a role="button">:
+        // Space: keydown preventDefault on ALL events including repeats
+        //        (prevents page scroll while held), keyup activates once
+        // Enter: activate on first keydown only (ignore repeats to match
+        //        native <button> which fires once, not repeatedly)
+        keydownHandler = ((e) => {
+            if (e.key === ' ') {
+                e.preventDefault();
+            }
+            if (e.key === 'Enter' && !e.repeat) {
+                el.click();
+            }
+        });
+        keyupHandler = ((e) => {
+            if (e.key === ' ') {
+                el.click();
+            }
+        });
+        el.addEventListener('keydown', keydownHandler);
+        el.addEventListener('keyup', keyupHandler);
+    }
+    // tabIndex override
+    if (tabIndex != null) {
+        el.tabIndex = tabIndex;
+    }
+    // Visually-hidden live region for loading announcements.
+    // Hidden from the accessibility tree until loading activates it —
+    // prevents empty role="status" from polluting the a11y tree on every button.
+    const liveSpan = document.createElement('span');
+    liveSpan.className = 'u-sr-only ui-button-live';
+    liveSpan.setAttribute('role', 'status');
+    liveSpan.setAttribute('aria-live', 'polite');
+    liveSpan.setAttribute('aria-hidden', 'true');
+    el.appendChild(liveSpan);
+    // Click handler — guarded against disabled and loading states
+    // Uses aria-disabled instead of el.disabled so the button stays in the
+    // tab order and remains discoverable by screen reader users
+    // (native disabled removes the element from the tab order entirely)
+    const readDisabled = () => typeof disabled === 'function' ? disabled() : disabled;
+    const readLoading = () => typeof loading === 'function' ? loading() : loading;
+    const clickHandler = ((e) => {
+        if (readDisabled() || readLoading()) {
+            e.preventDefault();
+            e.stopImmediatePropagation();
+            return;
+        }
+        onClick?.(e);
+    });
+    el.addEventListener('click', clickHandler);
+    // Reactive disabled + loading state
+    // Uses typeof check (not isSignal) because template compilation wraps
+    // signal reads in arrow functions: () => mySignal() — which are not
+    // signals themselves but still need effect() tracking.
+    const isReactive = typeof disabled === 'function' || typeof loading === 'function';
+    const applyState = () => {
+        const isDisabled = readDisabled();
+        const isLoading = readLoading();
+        // aria-disabled: set when disabled OR loading (keeps button focusable)
+        const blocked = isDisabled || isLoading;
+        if (blocked) {
+            el.setAttribute('aria-disabled', 'true');
+        }
+        else {
+            el.removeAttribute('aria-disabled');
+        }
+        // Prevent implicit form submission while disabled/loading:
+        // aria-disabled doesn't stop the browser from using a submit/reset button
+        // for implicit form submission (e.g. Enter in a text input).
+        // Temporarily switch type to "button" to neutralise this.
+        if (tag === 'button') {
+            el.type = blocked ? 'button' : type;
+        }
+        // Loading — reveal the live region to AT only while loading
+        el.classList.toggle('ui-button-loading', isLoading);
+        if (isLoading) {
+            el.setAttribute('aria-busy', 'true');
+            liveSpan.removeAttribute('aria-hidden');
+            liveSpan.textContent = loadingText;
+        }
+        else {
+            el.removeAttribute('aria-busy');
+            liveSpan.setAttribute('aria-hidden', 'true');
+            liveSpan.textContent = '';
+        }
+    };
+    // If props are signals, wrap in effect for auto-tracking; otherwise run once
+    const cleanupEffect = isReactive
+        ? effect(applyState)
+        : (applyState(), undefined);
+    // Icons inherit button size; they're decorative when paired with text (use `ariaLabel` for icon-only).
+    const iconSize = size;
+    const isTextFn = typeof text === 'function';
+    const isIconStartFn = typeof iconStart === 'function';
+    const isIconEndFn = typeof iconEnd === 'function';
+    const readText = () => isTextFn
+        ? text()
+        : text;
+    const readIconStart = () => isIconStartFn
+        ? iconStart()
+        : iconStart;
+    const readIconEnd = () => isIconEndFn
+        ? iconEnd()
+        : iconEnd;
+    // `text` prop wins over slot content. A function `text` always uses a text node
+    // (so the signal can update it later); a static `undefined` `text` falls
+    // through to slot children. A static `""` keeps the button intentionally empty.
+    let textNode;
+    let destroyChildren;
+    const staticText = isTextFn ? undefined : readText();
+    if (isTextFn) {
+        textNode = document.createTextNode('');
+        el.appendChild(textNode);
+    }
+    else if (typeof staticText === 'string') {
+        textNode = document.createTextNode(staticText);
+        el.appendChild(textNode);
+    }
+    else {
+        const { el: childFragment, destroy } = renderChildren();
+        destroyChildren = destroy;
+        el.appendChild(childFragment);
+    }
+    let iconStartHandle;
+    const remountIconStart = (name) => {
+        if (iconStartHandle) {
+            iconStartHandle.destroy();
+            iconStartHandle.el.parentNode?.removeChild(iconStartHandle.el);
+            iconStartHandle = undefined;
+        }
+        if (typeof name === 'string' && name.length > 0) {
+            const handle = Icon({ name, size: iconSize, decorative: true });
+            iconStartHandle = handle;
+            el.insertBefore(handle.el, liveSpan.nextSibling);
+        }
+    };
+    let iconEndHandle;
+    const remountIconEnd = (name) => {
+        if (iconEndHandle) {
+            iconEndHandle.destroy();
+            iconEndHandle.el.parentNode?.removeChild(iconEndHandle.el);
+            iconEndHandle = undefined;
+        }
+        if (typeof name === 'string' && name.length > 0) {
+            const handle = Icon({ name, size: iconSize, decorative: true });
+            iconEndHandle = handle;
+            el.appendChild(handle.el);
+        }
+    };
+    const cleanupTextEffect = isTextFn
+        ? effect(() => {
+            const v = readText();
+            if (textNode)
+                textNode.nodeValue = typeof v === 'string' ? v : '';
+        })
+        : undefined;
+    const cleanupIconStartEffect = isIconStartFn
+        ? effect(() => remountIconStart(readIconStart()))
+        : (remountIconStart(readIconStart()), undefined);
+    const cleanupIconEndEffect = isIconEndFn
+        ? effect(() => remountIconEnd(readIconEnd()))
+        : (remountIconEnd(readIconEnd()), undefined);
+    // Skip when text/ariaLabel is a signal: initially-empty reactive labels would false-positive.
+    if (import.meta.env?.DEV &&
+        !isTextFn &&
+        !isAriaLabelFn &&
+        !el.hasAttribute('aria-label') &&
+        (el.textContent ?? '').trim().length === 0) {
+        console.warn(`[<Button>] Button has no accessible name. Provide \`text\`/slot content or set \`ariaLabel\` for icon-only buttons.`);
+    }
+    return {
+        el,
+        destroy: () => {
+            cleanupEffect?.();
+            cleanupAriaLabelEffect?.();
+            cleanupTextEffect?.();
+            cleanupIconStartEffect?.();
+            cleanupIconEndEffect?.();
+            el.removeEventListener('click', clickHandler);
+            if (keydownHandler)
+                el.removeEventListener('keydown', keydownHandler);
+            if (keyupHandler)
+                el.removeEventListener('keyup', keyupHandler);
+            iconStartHandle?.destroy();
+            iconEndHandle?.destroy();
+            destroyChildren?.();
+            el.replaceChildren();
+        },
+    };
+}
+//# sourceMappingURL=Button.js.map

package/dist/atoms/actions/button/Button.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Button.js","sourceRoot":"","sources":["../../../../src/atoms/actions/button/Button.ts"],"names":[],"mappings":"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"}