@usableapp/cardds 0.2.2 → 0.4.0

package/dist/cards/Card.d.ts

@@ -1,5 +1,5 @@
-import { type ComponentPropsWithoutRef } from 'react';
-export interface CardProps extends ComponentPropsWithoutRef<'article'> {
+import { type ComponentProps } from 'react';
+export interface CardProps extends ComponentProps<'article'> {
     /** the tone slot: 1 (default, light) · 2 (tinted) · 3 (dark / accent — controls invert automatically) */
     tone?: 1 | 2 | 3;
     /** compact: a small card inside a card or a sheet body (a note, a promo) */
@@ -26,74 +26,119 @@ export interface CardProps extends ComponentPropsWithoutRef<'article'> {
  */
 export declare function Card({ tone, sm, row, cover, fold, centre, band, as, className, ...rest }: CardProps): import("react").DetailedReactHTMLElement<{
     href?: string;
-    slot?: string | undefined | undefined;
+    ref?: import("react").Ref<HTMLElement> | undefined;
+    key?: import("react").Key | null | undefined;
+    defaultChecked?: boolean | undefined;
+    defaultValue?: string | number | readonly string[] | undefined;
+    suppressContentEditableWarning?: boolean | undefined;
+    suppressHydrationWarning?: boolean | undefined;
+    accessKey?: string | undefined;
+    autoCapitalize?: "off" | "none" | "on" | "sentences" | "words" | "characters" | undefined | (string & {});
+    autoFocus?: boolean | undefined;
+    contentEditable?: (boolean | "true" | "false") | "inherit" | "plaintext-only" | undefined;
+    contextMenu?: string | undefined;
+    dir?: string | undefined;
+    draggable?: (boolean | "true" | "false") | undefined;
+    enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined;
+    hidden?: boolean | undefined;
+    id?: string | undefined;
+    lang?: string | undefined;
+    nonce?: string | undefined;
+    slot?: string | undefined;
+    spellCheck?: (boolean | "true" | "false") | undefined;
     style?: import("react").CSSProperties | undefined;
-    title?: string | undefined | undefined;
-    suppressHydrationWarning?: boolean | undefined | undefined;
-    color?: string | undefined | undefined;
-    id?: string | undefined | undefined;
-    lang?: string | undefined | undefined;
-    nonce?: string | undefined | undefined;
-    part?: string | undefined | undefined;
+    tabIndex?: number | undefined;
+    title?: string | undefined;
+    translate?: "yes" | "no" | undefined;
+    radioGroup?: string | undefined;
     role?: import("react").AriaRole | undefined;
-    tabIndex?: number | undefined | undefined;
-    "aria-activedescendant"?: string | undefined | undefined;
+    about?: string | undefined;
+    content?: string | undefined;
+    datatype?: string | undefined;
+    inlist?: any;
+    prefix?: string | undefined;
+    property?: string | undefined;
+    rel?: string | undefined;
+    resource?: string | undefined;
+    rev?: string | undefined;
+    typeof?: string | undefined;
+    vocab?: string | undefined;
+    autoCorrect?: string | undefined;
+    autoSave?: string | undefined;
+    color?: string | undefined;
+    itemProp?: string | undefined;
+    itemScope?: boolean | undefined;
+    itemType?: string | undefined;
+    itemID?: string | undefined;
+    itemRef?: string | undefined;
+    results?: number | undefined;
+    security?: string | undefined;
+    unselectable?: "on" | "off" | undefined;
+    popover?: "" | "auto" | "manual" | "hint" | undefined;
+    popoverTargetAction?: "toggle" | "show" | "hide" | undefined;
+    popoverTarget?: string | undefined;
+    inert?: boolean | undefined;
+    inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined;
+    is?: string | undefined;
+    exportparts?: string | undefined;
+    part?: string | undefined;
+    "aria-activedescendant"?: string | undefined;
     "aria-atomic"?: (boolean | "true" | "false") | undefined;
-    "aria-autocomplete"?: "none" | "inline" | "list" | "both" | undefined | undefined;
-    "aria-braillelabel"?: string | undefined | undefined;
-    "aria-brailleroledescription"?: string | undefined | undefined;
+    "aria-autocomplete"?: "none" | "inline" | "list" | "both" | undefined;
+    "aria-braillelabel"?: string | undefined;
+    "aria-brailleroledescription"?: string | undefined;
     "aria-busy"?: (boolean | "true" | "false") | undefined;
-    "aria-checked"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
-    "aria-colcount"?: number | undefined | undefined;
-    "aria-colindex"?: number | undefined | undefined;
-    "aria-colindextext"?: string | undefined | undefined;
-    "aria-colspan"?: number | undefined | undefined;
-    "aria-controls"?: string | undefined | undefined;
-    "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined | undefined;
-    "aria-describedby"?: string | undefined | undefined;
-    "aria-description"?: string | undefined | undefined;
-    "aria-details"?: string | undefined | undefined;
+    "aria-checked"?: boolean | "false" | "mixed" | "true" | undefined;
+    "aria-colcount"?: number | undefined;
+    "aria-colindex"?: number | undefined;
+    "aria-colindextext"?: string | undefined;
+    "aria-colspan"?: number | undefined;
+    "aria-controls"?: string | undefined;
+    "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined;
+    "aria-describedby"?: string | undefined;
+    "aria-description"?: string | undefined;
+    "aria-details"?: string | undefined;
     "aria-disabled"?: (boolean | "true" | "false") | undefined;
-    "aria-dropeffect"?: "none" | "copy" | "execute" | "link" | "move" | "popup" | undefined | undefined;
-    "aria-errormessage"?: string | undefined | undefined;
+    "aria-dropeffect"?: "none" | "copy" | "execute" | "link" | "move" | "popup" | undefined;
+    "aria-errormessage"?: string | undefined;
     "aria-expanded"?: (boolean | "true" | "false") | undefined;
-    "aria-flowto"?: string | undefined | undefined;
+    "aria-flowto"?: string | undefined;
     "aria-grabbed"?: (boolean | "true" | "false") | undefined;
-    "aria-haspopup"?: boolean | "false" | "true" | "menu" | "listbox" | "tree" | "grid" | "dialog" | undefined | undefined;
+    "aria-haspopup"?: boolean | "false" | "true" | "menu" | "listbox" | "tree" | "grid" | "dialog" | undefined;
     "aria-hidden"?: (boolean | "true" | "false") | undefined;
-    "aria-invalid"?: boolean | "false" | "true" | "grammar" | "spelling" | undefined | undefined;
-    "aria-keyshortcuts"?: string | undefined | undefined;
-    "aria-label"?: string | undefined | undefined;
-    "aria-labelledby"?: string | undefined | undefined;
-    "aria-level"?: number | undefined | undefined;
-    "aria-live"?: "off" | "assertive" | "polite" | undefined | undefined;
+    "aria-invalid"?: boolean | "false" | "true" | "grammar" | "spelling" | undefined;
+    "aria-keyshortcuts"?: string | undefined;
+    "aria-label"?: string | undefined;
+    "aria-labelledby"?: string | undefined;
+    "aria-level"?: number | undefined;
+    "aria-live"?: "off" | "assertive" | "polite" | undefined;
     "aria-modal"?: (boolean | "true" | "false") | undefined;
     "aria-multiline"?: (boolean | "true" | "false") | undefined;
     "aria-multiselectable"?: (boolean | "true" | "false") | undefined;
-    "aria-orientation"?: "horizontal" | "vertical" | undefined | undefined;
-    "aria-owns"?: string | undefined | undefined;
-    "aria-placeholder"?: string | undefined | undefined;
-    "aria-posinset"?: number | undefined | undefined;
-    "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
+    "aria-orientation"?: "horizontal" | "vertical" | undefined;
+    "aria-owns"?: string | undefined;
+    "aria-placeholder"?: string | undefined;
+    "aria-posinset"?: number | undefined;
+    "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined;
     "aria-readonly"?: (boolean | "true" | "false") | undefined;
-    "aria-relevant"?: "additions" | "additions removals" | "additions text" | "all" | "removals" | "removals additions" | "removals text" | "text" | "text additions" | "text removals" | undefined | undefined;
+    "aria-relevant"?: "additions" | "additions removals" | "additions text" | "all" | "removals" | "removals additions" | "removals text" | "text" | "text additions" | "text removals" | undefined;
     "aria-required"?: (boolean | "true" | "false") | undefined;
-    "aria-roledescription"?: string | undefined | undefined;
-    "aria-rowcount"?: number | undefined | undefined;
-    "aria-rowindex"?: number | undefined | undefined;
-    "aria-rowindextext"?: string | undefined | undefined;
-    "aria-rowspan"?: number | undefined | undefined;
+    "aria-roledescription"?: string | undefined;
+    "aria-rowcount"?: number | undefined;
+    "aria-rowindex"?: number | undefined;
+    "aria-rowindextext"?: string | undefined;
+    "aria-rowspan"?: number | undefined;
     "aria-selected"?: (boolean | "true" | "false") | undefined;
-    "aria-setsize"?: number | undefined | undefined;
-    "aria-sort"?: "none" | "ascending" | "descending" | "other" | undefined | undefined;
-    "aria-valuemax"?: number | undefined | undefined;
-    "aria-valuemin"?: number | undefined | undefined;
-    "aria-valuenow"?: number | undefined | undefined;
-    "aria-valuetext"?: string | undefined | undefined;
-    children?: import("react").ReactNode;
+    "aria-setsize"?: number | undefined;
+    "aria-sort"?: "none" | "ascending" | "descending" | "other" | undefined;
+    "aria-valuemax"?: number | undefined;
+    "aria-valuemin"?: number | undefined;
+    "aria-valuenow"?: number | undefined;
+    "aria-valuetext"?: string | undefined;
+    children?: import("react").ReactNode | undefined;
     dangerouslySetInnerHTML?: {
         __html: string | TrustedHTML;
-    } | undefined | undefined;
+    } | undefined;
     onCopy?: import("react").ClipboardEventHandler<HTMLElement> | undefined;
     onCopyCapture?: import("react").ClipboardEventHandler<HTMLElement> | undefined;
     onCut?: import("react").ClipboardEventHandler<HTMLElement> | undefined;
@@ -262,49 +307,5 @@ export declare function Card({ tone, sm, row, cover, fold, centre, band, as, cla
     onTransitionRunCapture?: import("react").TransitionEventHandler<HTMLElement> | undefined;
     onTransitionStart?: import("react").TransitionEventHandler<HTMLElement> | undefined;
     onTransitionStartCapture?: import("react").TransitionEventHandler<HTMLElement> | undefined;
-    key?: import("react").Key | null | undefined;
-    defaultChecked?: boolean | undefined | undefined;
-    defaultValue?: string | number | readonly string[] | undefined;
-    suppressContentEditableWarning?: boolean | undefined | undefined;
-    accessKey?: string | undefined | undefined;
-    autoCapitalize?: "off" | "none" | "on" | "sentences" | "words" | "characters" | undefined | (string & {}) | undefined;
-    autoFocus?: boolean | undefined | undefined;
-    contentEditable?: (boolean | "true" | "false") | "inherit" | "plaintext-only" | undefined;
-    contextMenu?: string | undefined | undefined;
-    dir?: string | undefined | undefined;
-    draggable?: (boolean | "true" | "false") | undefined;
-    enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined | undefined;
-    hidden?: boolean | undefined | undefined;
-    spellCheck?: (boolean | "true" | "false") | undefined;
-    translate?: "yes" | "no" | undefined | undefined;
-    radioGroup?: string | undefined | undefined;
-    about?: string | undefined | undefined;
-    content?: string | undefined | undefined;
-    datatype?: string | undefined | undefined;
-    inlist?: any;
-    prefix?: string | undefined | undefined;
-    property?: string | undefined | undefined;
-    rel?: string | undefined | undefined;
-    resource?: string | undefined | undefined;
-    rev?: string | undefined | undefined;
-    typeof?: string | undefined | undefined;
-    vocab?: string | undefined | undefined;
-    autoCorrect?: string | undefined | undefined;
-    autoSave?: string | undefined | undefined;
-    itemProp?: string | undefined | undefined;
-    itemScope?: boolean | undefined | undefined;
-    itemType?: string | undefined | undefined;
-    itemID?: string | undefined | undefined;
-    itemRef?: string | undefined | undefined;
-    results?: number | undefined | undefined;
-    security?: string | undefined | undefined;
-    unselectable?: "on" | "off" | undefined | undefined;
-    popover?: "" | "auto" | "manual" | "hint" | undefined | undefined;
-    popoverTargetAction?: "toggle" | "show" | "hide" | undefined | undefined;
-    popoverTarget?: string | undefined | undefined;
-    inert?: boolean | undefined | undefined;
-    inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined | undefined;
-    is?: string | undefined | undefined;
-    exportparts?: string | undefined | undefined;
     className: string;
 }, HTMLElement>;

package/dist/cards/CardFoot.d.ts

@@ -1,5 +1,5 @@
-import type { ComponentPropsWithoutRef } from 'react';
-export interface CardFootProps extends ComponentPropsWithoutRef<'div'> {
+import type { ComponentProps } from 'react';
+export interface CardFootProps extends ComponentProps<'div'> {
 }
 /** CardFoot — the card's action buttons on one line: one takes the width, up to four share it evenly. Btns only. */
 export declare function CardFoot({ className, ...rest }: CardFootProps): import("react").JSX.Element;

package/dist/cards/CardHead.d.ts

@@ -1,5 +1,5 @@
-import type { ComponentPropsWithoutRef, ReactNode } from 'react';
-export interface CardHeadProps extends ComponentPropsWithoutRef<'div'> {
+import type { ComponentProps, ReactNode } from 'react';
+export interface CardHeadProps extends ComponentProps<'div'> {
     /** the heading (a string becomes an h2 at level `t-h2`) — wraps freely, as many lines as the words need */
     heading?: ReactNode;
     /** small caps above the heading ("Step 1 of 4", "Time bank") */

package/dist/cards/CardParts.d.ts

@@ -1,25 +1,25 @@
-import type { ComponentPropsWithoutRef } from 'react';
-export interface CardMediaProps extends ComponentPropsWithoutRef<'div'> {
+import type { ComponentProps } from 'react';
+export interface CardMediaProps extends ComponentProps<'div'> {
 }
 /** CardMedia — rounded media inside a card (a Placeholder or img); a corner TileBadge pins to it. */
 export declare function CardMedia({ className, ...rest }: CardMediaProps): import("react").JSX.Element;
-export interface CardBodyProps extends ComponentPropsWithoutRef<'div'> {
+export interface CardBodyProps extends ComponentProps<'div'> {
 }
 /** CardBody — the flexible middle of a `Card row`: a title over a caption. */
 export declare function CardBody({ className, ...rest }: CardBodyProps): import("react").JSX.Element;
-export interface CardThumbProps extends ComponentPropsWithoutRef<'span'> {
+export interface CardThumbProps extends ComponentProps<'span'> {
 }
 /** CardThumb — the small outlined square leading a `Card row` (a number, an initial, an icon). */
 export declare function CardThumb({ className, ...rest }: CardThumbProps): import("react").JSX.Element;
-export interface CardEndProps extends ComponentPropsWithoutRef<'div'> {
+export interface CardEndProps extends ComponentProps<'div'> {
 }
 /** CardEnd — the trailing value + caption, right-aligned (in a head or a row card). */
 export declare function CardEnd({ className, ...rest }: CardEndProps): import("react").JSX.Element;
-export interface CardListProps extends ComponentPropsWithoutRef<'div'> {
+export interface CardListProps extends ComponentProps<'div'> {
 }
 /** CardList — a stack of `Card row`s, each its own boundary. */
 export declare function CardList({ className, ...rest }: CardListProps): import("react").JSX.Element;
-export interface IconRowProps extends ComponentPropsWithoutRef<'span'> {
+export interface IconRowProps extends ComponentProps<'span'> {
 }
 /** IconRow — a trailing cluster of Icons in a card or stack head. */
 export declare function IconRow({ className, ...rest }: IconRowProps): import("react").JSX.Element;

package/dist/cards/Placeholder.d.ts

@@ -1,5 +1,5 @@
-import type { ComponentPropsWithoutRef } from 'react';
-export interface PlaceholderProps extends ComponentPropsWithoutRef<'div'> {
+import type { ComponentProps } from 'react';
+export interface PlaceholderProps extends ComponentProps<'div'> {
     /** sm 7.5rem · md 9rem · default 10rem tall */
     size?: 'sm' | 'md';
     /** what the image would be */

package/dist/cards/Stat.d.ts

@@ -1,15 +1,17 @@
-import type { ComponentPropsWithoutRef } from 'react';
-export interface StatProps extends ComponentPropsWithoutRef<'div'> {
+import type { ComponentProps } from 'react';
+export interface StatProps extends ComponentProps<'div'> {
     /** takes the remaining row space beside a Ring */
     grow?: boolean;
+    /** centred: the one number of a sheet or a stage, under a centred Avatar */
+    centre?: boolean;
 }
 /** Stat — an inline stat block: an overline, a big `Text level="stat"` number, a caption; StatRows put a Delta beside the label. */
-export declare function Stat({ grow, className, ...rest }: StatProps): import("react").JSX.Element;
-export interface StatRowProps extends ComponentPropsWithoutRef<'div'> {
+export declare function Stat({ grow, centre, className, ...rest }: StatProps): import("react").JSX.Element;
+export interface StatRowProps extends ComponentProps<'div'> {
 }
 /** StatRow — label left, Delta (or caption) right, inside a Stat. */
 export declare function StatRow({ className, ...rest }: StatRowProps): import("react").JSX.Element;
-export interface DeltaProps extends ComponentPropsWithoutRef<'span'> {
+export interface DeltaProps extends ComponentProps<'span'> {
     /** a drop: painted in the signal colour */
     neg?: boolean;
 }

package/dist/cards/Stat.js

@@ -1,8 +1,8 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { cx } from '../cx.js';
 /** Stat — an inline stat block: an overline, a big `Text level="stat"` number, a caption; StatRows put a Delta beside the label. */
-export function Stat({ grow, className, ...rest }) {
-    return _jsx("div", { className: cx('stat', grow && 'grow', className), ...rest });
+export function Stat({ grow, centre, className, ...rest }) {
+    return _jsx("div", { className: cx('stat', grow && 'grow', centre && 'stat--centre', className), ...rest });
 }
 /** StatRow — label left, Delta (or caption) right, inside a Stat. */
 export function StatRow({ className, ...rest }) {

package/dist/choice/Calendar.d.ts

@@ -1,13 +1,23 @@
-import type { ComponentPropsWithoutRef, ReactNode } from 'react';
-export interface CalendarProps extends Omit<ComponentPropsWithoutRef<'div'>, 'title'> {
+import { type ComponentProps, type ReactNode } from 'react';
+export interface CalendarProps extends Omit<ComponentProps<'div'>, 'title' | 'onSelect'> {
     /** the month shown ("June") */
     title: ReactNode;
     /** days in the month */
     days?: number;
     /** weekday column of the 1st (1 = first column) */
     start?: number;
-    /** the selected day */
-    selected?: number;
+    /** CONTROLLED: the picked day, or `null` for none. The app owns it — pair it with `onSelect`. (`undefined` = uncontrolled.) */
+    selected?: number | null;
+    /** UNCONTROLLED: the day picked on arrival; the calendar then keeps its own */
+    defaultSelected?: number;
+    /** a day was tapped */
+    onSelect?: (day: number) => void;
+    /** the head's two buttons: the app turns the month (it owns `title`, `days`, `start`) */
+    onPrev?: () => void;
+    onNext?: () => void;
+    /** their accessible names */
+    prevLabel?: string;
+    nextLabel?: string;
     /** softly marked days */
     marks?: number[];
     /** strongly marked days */
@@ -19,5 +29,6 @@ export interface CalendarProps extends Omit<ComponentPropsWithoutRef<'div'>, 'ti
     /** replace the default prev/next icon buttons */
     nav?: ReactNode;
 }
-/** Calendar — a month grid of 44px round cells: one accent day, optional marks; prev/next in the head. */
-export declare function Calendar({ title, days, start, selected, marks, marks2, disabled, weekdays, nav, className, ...rest }: CalendarProps): import("react").JSX.Element;
+/** Calendar — a month grid of 44px round cells: one accent day, optional marks; prev/next in the head. It shows ONE month and knows no dates:
+ *  the app owns which month (`title`, `days`, `start` + `onPrev` / `onNext`) and which day (`selected` + `onSelect`, or `defaultSelected`). */
+export declare function Calendar({ title, days, start, selected, defaultSelected, onSelect, onPrev, onNext, prevLabel, nextLabel, marks, marks2, disabled, weekdays, nav, className, ...rest }: CalendarProps): import("react").JSX.Element;

package/dist/choice/Calendar.js

@@ -1,7 +1,13 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
 import { cx } from '../cx.js';
 import { IconBtn } from '../actions/IconBtn.js';
-/** Calendar — a month grid of 44px round cells: one accent day, optional marks; prev/next in the head. */
-export function Calendar({ title, days = 30, start = 1, selected, marks = [], marks2 = [], disabled = [], weekdays = ['Su', 'Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa'], nav, className, ...rest }) {
-    return (_jsxs("div", { className: cx('calendar', className), ...rest, children: [_jsxs("div", { className: "calendar__head", children: [_jsx("span", { className: "t-title", children: title }), nav ?? (_jsxs("span", { className: "icon-row", children: [_jsx(IconBtn, { sm: true, icon: "chevron-left", label: "Previous" }), _jsx(IconBtn, { sm: true, icon: "chevron-right", label: "Next" })] }))] }), _jsxs("div", { className: "calendar__grid", children: [weekdays.map((d) => _jsx("span", { className: "calendar__wd", children: d }, d)), Array.from({ length: days }, (_, i) => i + 1).map((d) => (_jsx("button", { type: "button", className: cx('calendar__day', marks.includes(d) && 'calendar__day--mark', marks2.includes(d) && 'calendar__day--mark2'), "aria-selected": d === selected ? 'true' : undefined, disabled: disabled.includes(d), style: d === 1 ? { '--start': start } : undefined, children: d }, d)))] })] }));
+/** Calendar — a month grid of 44px round cells: one accent day, optional marks; prev/next in the head. It shows ONE month and knows no dates:
+ *  the app owns which month (`title`, `days`, `start` + `onPrev` / `onNext`) and which day (`selected` + `onSelect`, or `defaultSelected`). */
+export function Calendar({ title, days = 30, start = 1, selected, defaultSelected, onSelect, onPrev, onNext, prevLabel = 'Previous', nextLabel = 'Next', marks = [], marks2 = [], disabled = [], weekdays = ['Su', 'Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa'], nav, className, ...rest }) {
+    const [inner, setInner] = useState(defaultSelected);
+    const day = selected !== undefined ? selected : inner;
+    const pick = (d) => { if (selected === undefined)
+        setInner(d); onSelect?.(d); };
+    return (_jsxs("div", { className: cx('calendar', className), ...rest, children: [_jsxs("div", { className: "calendar__head", children: [_jsx("span", { className: "t-title", children: title }), nav ?? (_jsxs("span", { className: "icon-row", children: [_jsx(IconBtn, { sm: true, icon: "chevron-left", label: prevLabel, onClick: onPrev }), _jsx(IconBtn, { sm: true, icon: "chevron-right", label: nextLabel, onClick: onNext })] }))] }), _jsxs("div", { className: "calendar__grid", children: [weekdays.map((d) => _jsx("span", { className: "calendar__wd", children: d }, d)), Array.from({ length: days }, (_, i) => i + 1).map((d) => (_jsx("button", { type: "button", className: cx('calendar__day', marks.includes(d) && 'calendar__day--mark', marks2.includes(d) && 'calendar__day--mark2'), "aria-selected": d === day ? 'true' : undefined, onClick: () => pick(d), disabled: disabled.includes(d), style: d === 1 ? { '--start': start } : undefined, children: d }, d)))] })] }));
 }

package/dist/choice/Check.d.ts

@@ -1,5 +1,5 @@
-import type { ComponentPropsWithoutRef } from 'react';
-export interface CheckProps extends ComponentPropsWithoutRef<'input'> {
+import type { ComponentProps } from 'react';
+export interface CheckProps extends ComponentProps<'input'> {
     /** 40px instead of 48px */
     sm?: boolean;
     /** accessible name */
@@ -7,7 +7,7 @@ export interface CheckProps extends ComponentPropsWithoutRef<'input'> {
 }
 /** Check — the round check circle at a Row's end (48px); the row's label wraps it. */
 export declare function Check({ sm, label, className, ...rest }: CheckProps): import("react").JSX.Element;
-export interface ToggleProps extends ComponentPropsWithoutRef<'input'> {
+export interface ToggleProps extends ComponentProps<'input'> {
     label?: string;
 }
 /** Toggle — the big switch (64×36) at a Row's end. */

package/dist/choice/DayStrip.d.ts

@@ -1,9 +1,9 @@
-import type { ComponentPropsWithoutRef, ReactNode } from 'react';
-export interface DayStripProps extends ComponentPropsWithoutRef<'div'> {
+import type { ComponentProps, ReactNode } from 'react';
+export interface DayStripProps extends ComponentProps<'div'> {
 }
 /** DayStrip — a week of Days, one selected. */
 export declare function DayStrip({ className, ...rest }: DayStripProps): import("react").JSX.Element;
-export interface DayProps extends Omit<ComponentPropsWithoutRef<'button'>, 'name'> {
+export interface DayProps extends Omit<ComponentProps<'button'>, 'name'> {
     /** weekday name (Thu) */
     name: ReactNode;
     /** the date number */

package/dist/choice/Mood.d.ts

@@ -1,5 +1,5 @@
-import type { ComponentPropsWithoutRef } from 'react';
-export interface MoodProps extends Omit<ComponentPropsWithoutRef<'fieldset'>, 'onChange'> {
+import type { ComponentProps } from 'react';
+export interface MoodProps extends Omit<ComponentProps<'fieldset'>, 'onChange'> {
     /** the radio group name */
     name?: string;
     /** the picked dot, 1 (worst) to 5 (best) */

package/dist/choice/Slider.d.ts

@@ -1,5 +1,5 @@
-import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
-export interface SliderProps extends Omit<ComponentPropsWithoutRef<'input'>, 'className' | 'style' | 'type'> {
+import { type ComponentProps, type ReactNode } from 'react';
+export interface SliderProps extends Omit<ComponentProps<'input'>, 'className' | 'style' | 'type'> {
     /** the label row above the track (optional in a bar that already says what it does) */
     label?: ReactNode;
     /** one sample letter IN the knob, at the type size the slider sets (a text-size slider's ก) */
@@ -8,4 +8,4 @@ export interface SliderProps extends Omit<ComponentPropsWithoutRef<'input'>, 'cl
     style?: React.CSSProperties;
 }
 /** Slider — one value along a hairline rail with a 48px knob; the whole range is thumb-tall. */
-export declare function Slider({ label, glyph, className, style, ...input }: SliderProps): import("react").JSX.Element;
+export declare function Slider({ label, glyph, className, style, onInput, ...input }: SliderProps): import("react").JSX.Element;

package/dist/choice/Slider.js

@@ -2,13 +2,17 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useRef } from 'react';
 import { cx } from '../cx.js';
 /** Slider — one value along a hairline rail with a 48px knob; the whole range is thumb-tall. */
-export function Slider({ label, glyph, className, style, ...input }) {
+export function Slider({ label, glyph, className, style, onInput, ...input }) {
     const range = useRef(null);
-    // the knob's place is published by cardds.js on every input event; on mount it publishes once
-    // for the value the slider starts at, so a glyph sits on the knob before the first move
-    useEffect(() => {
-        if (glyph != null && range.current)
-            range.current.dispatchEvent(new Event('input', { bubbles: true }));
-    }, [glyph]);
-    return (_jsxs("label", { className: cx('slider', className), style: style, children: [label != null && _jsx("span", { className: "slider__label", children: label }), glyph != null && _jsx("span", { className: "slider__glyph", "aria-hidden": "true", children: glyph }), _jsx("input", { ref: range, className: "slider__range", type: "range", ...input })] }));
+    const box = useRef(null);
+    // the knob's place along the rail, 0..1, published on the slider as --slider-at so the glyph can ride the knob (choice.css)
+    const place = () => {
+        const r = range.current;
+        if (!r || !box.current)
+            return;
+        const min = Number(r.min) || 0, max = Number(r.max) || 100;
+        box.current.style.setProperty('--slider-at', String(max > min ? Math.min(1, Math.max(0, (Number(r.value) - min) / (max - min))) : 0));
+    };
+    useEffect(place); // after every render: a controlled value, a new min / max
+    return (_jsxs("label", { ref: box, className: cx('slider', className), style: style, children: [label != null && _jsx("span", { className: "slider__label", children: label }), glyph != null && _jsx("span", { className: "slider__glyph", "aria-hidden": "true", children: glyph }), _jsx("input", { ref: range, className: "slider__range", type: "range", onInput: (e) => { place(); onInput?.(e); }, ...input })] }));
 }

package/dist/forms/AddRow.d.ts

@@ -1,5 +1,5 @@
-import type { ComponentPropsWithoutRef } from 'react';
-export interface AddRowProps extends ComponentPropsWithoutRef<'button'> {
+import type { ComponentProps } from 'react';
+export interface AddRowProps extends ComponentProps<'button'> {
 }
 /** AddRow — the inline "+ add another" action under a list of fields. */
 export declare function AddRow({ className, children, ...rest }: AddRowProps): import("react").JSX.Element;

package/dist/forms/Composer.d.ts

@@ -1,5 +1,5 @@
-import type { ComponentPropsWithoutRef, ReactNode } from 'react';
-export interface ComposerProps extends Omit<ComponentPropsWithoutRef<'textarea'>, 'className' | 'style'> {
+import type { ComponentProps, ReactNode } from 'react';
+export interface ComposerProps extends Omit<ComponentProps<'textarea'>, 'className' | 'style'> {
     /** the caption between the two buttons ("Your request is born") */
     hint?: ReactNode;
     /** the left button of the bar (an IconBtn — voice) */

package/dist/forms/Field.d.ts

@@ -1,6 +1,6 @@
-import type { ComponentPropsWithoutRef, ReactNode } from 'react';
+import type { ComponentProps, ReactNode } from 'react';
 import { type IconName } from '../type/Icon.js';
-export interface FieldProps extends Omit<ComponentPropsWithoutRef<'input'>, 'className' | 'style'> {
+export interface FieldProps extends Omit<ComponentProps<'input'>, 'className' | 'style'> {
     /** a leading icon (phone-call, plane, calendar-days) */
     icon?: IconName;
     /** an action inside the field, flush right — an `IconBtn sm invert` */

package/dist/forms/FileBtn.d.ts

@@ -1,5 +1,5 @@
-import type { ComponentPropsWithoutRef, ReactNode } from 'react';
-export interface FileBtnProps extends Omit<ComponentPropsWithoutRef<'input'>, 'type' | 'className' | 'style' | 'children'> {
+import type { ComponentProps, ReactNode } from 'react';
+export interface FileBtnProps extends Omit<ComponentProps<'input'>, 'type' | 'className' | 'style' | 'children'> {
     /** the filled accent button — the one forward move */
     primary?: boolean;
     /** ink on whatever it sits on, a faint outline */

package/dist/forms/Pin.d.ts

@@ -1,19 +1,22 @@
-import { type ComponentPropsWithoutRef } from 'react';
-export interface PinProps extends Omit<ComponentPropsWithoutRef<'div'>, 'onChange'> {
+import { type ComponentProps } from 'react';
+export interface PinProps extends Omit<ComponentProps<'div'>, 'onChange' | 'defaultValue'> {
     /** how many digits (4 or 6) */
     length?: number;
-    /** digits already typed, left to right ("03") */
+    /** CONTROLLED: the digits so far, left to right ("03"). The app owns it — pair it with `onChange`. */
     value?: string;
+    /** UNCONTROLLED: the digits it starts with; the Pin then keeps its own */
+    defaultValue?: string;
     /** accessible name prefix for each cell ("Digit" → "Digit 1") */
     label?: string;
-    /** the code so far, after every keystroke; `complete` once every cell holds a digit */
+    /** the code so far, after every change; `complete` once every cell holds a digit */
     onChange?: (code: string, complete: boolean) => void;
     /** focus the first empty cell on mount */
     autoFocus?: boolean;
 }
 /**
  * Pin — big code entry, one digit per pill; a filled cell turns accent. Lives in a Sheet.
- * Typing a digit moves to the next cell, Backspace in an empty cell moves back, a pasted code fills every cell
- * (cardds.js, delegated — the cells stay plain inputs). The first cell takes the SMS one-time-code autofill.
+ * Its own behaviour, inside it: typing a digit moves to the next cell, Backspace in an empty cell moves back and clears, the
+ * arrows walk the cells, a pasted code fills them from the one it landed in; only digits stay. The first cell takes the SMS
+ * one-time-code autofill. The code is a VALUE, controlled like an input: `value` + `onChange`, or `defaultValue`.
  */
-export declare function Pin({ length, value, label, onChange, autoFocus, className, ...rest }: PinProps): import("react").JSX.Element;
+export declare function Pin({ length, value, defaultValue, label, onChange, autoFocus, className, ...rest }: PinProps): import("react").JSX.Element;