@usableapp/cardds 0.7.72 → 0.7.74

package/dist/choice/Calendar.d.ts

@@ -12,11 +12,13 @@ export interface CalendarProps extends Omit<ComponentProps<'div'>, 'title' | 'on
     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`) */
+    /** the previous-month button was tapped: the app turns the month (it owns `title`, `days`, `start`) */
     onPrev?: () => void;
+    /** the next-month button was tapped: the app turns the month, as with `onPrev` */
     onNext?: () => void;
-    /** their accessible names */
+    /** the previous button's accessible name — cardds names it in the page's language (`<html lang>`); pass it only for different words */
     prevLabel?: string;
+    /** the next button's accessible name — cardds names it in the page's language (`<html lang>`); pass it only for different words */
     nextLabel?: string;
     /** softly marked days */
     marks?: number[];

package/dist/choice/DayStrip.d.ts

@@ -8,6 +8,7 @@ export interface DayProps extends Omit<ComponentProps<'button'>, 'name'> {
     name: ReactNode;
     /** the date number */
     num: ReactNode;
+    /** this day is the picked one (aria-selected; the app keeps which) */
     selected?: boolean;
     /** a mark under the number (something is on) */
     dot?: boolean;

package/dist/choice/Mood.d.ts

@@ -7,6 +7,7 @@ export interface MoodProps extends Omit<ComponentProps<'fieldset'>, 'onChange' |
     value?: MoodValue;
     /** UNCONTROLLED: the dot picked on arrival; the Mood then keeps its own */
     defaultValue?: MoodValue;
+    /** the group's accessible name (default "Mood", by `<html lang>`) */
     label?: string;
     /** the dot the member tapped */
     onChange?: (value: MoodValue) => void;

package/dist/choice/Slider.d.ts

@@ -4,7 +4,9 @@ export interface SliderProps extends Omit<ComponentProps<'input'>, 'className' |
     label?: ReactNode;
     /** one sample letter IN the knob, at the type size the slider sets (a text-size slider's ก) */
     glyph?: ReactNode;
+    /** classes for the slider's label wrapper — the range input itself takes none */
     className?: string;
+    /** inline style for the label wrapper, not the range input */
     style?: React.CSSProperties;
 }
 /** Slider — one value along a hairline rail with a 48px knob; the whole range is thumb-tall. */

package/dist/forms/Composer.d.ts

@@ -6,7 +6,9 @@ export interface ComposerProps extends Omit<ComponentProps<'textarea'>, 'classNa
     lead?: ReactNode;
     /** the right button of the bar (an `IconBtn invert` — send) */
     send?: ReactNode;
+    /** classes for the composer's wrapper, not the textarea */
     className?: string;
+    /** inline style for the wrapper, not the textarea */
     style?: React.CSSProperties;
 }
 /** Composer — a big write-in area (display type) with a bottom bar: icon · hint · send. The write-in step's sheet content. */

package/dist/forms/Field.d.ts

@@ -24,7 +24,9 @@ export interface FieldProps extends Omit<ComponentProps<'input'>, 'className' |
      *  → 081-234-5678). Only digits are kept; a mark comes only once a digit follows it, so Backspace never sticks on a dash. The
      *  app's `onChange` reads the shaped value (the digits alone: `value.replace(/\D/g, '')`). Lh 2026-09-25 */
     mask?: string;
+    /** classes for the field's label wrapper, not the input */
     className?: string;
+    /** inline style for the label wrapper, not the input */
     style?: React.CSSProperties;
 }
 /** the digits of `v`, written into `mask`; a mark is written only when a digit comes after it */

package/dist/forms/FileBtn.d.ts

@@ -8,6 +8,7 @@ export interface FileBtnProps extends Omit<ComponentProps<'input'>, 'type' | 'cl
     block?: boolean;
     /** the button's words (and an Icon, if any) */
     children?: ReactNode;
+    /** classes for the button (the label around the hidden file input) */
     className?: string;
 }
 /**

package/dist/journey/NoteRow.d.ts

@@ -1,6 +1,7 @@
 import type { ComponentProps } from 'react';
 import { type IconName } from '../type/Icon.js';
 export interface NoteRowProps extends ComponentProps<'div'> {
+    /** the icon before the words (default clock) */
     icon?: IconName;
 }
 /** NoteRow — icon + caption: transit hints, fine print. */

package/dist/journey/Route.d.ts

@@ -9,7 +9,9 @@ export interface RoutePoint {
     time: ReactNode;
 }
 export interface RouteProps extends ComponentProps<'div'> {
+    /** where it starts: place · code · time */
     from: RoutePoint;
+    /** where it ends: place · code · time */
     to: RoutePoint;
     /** the icon on the dotted connector (plane by default) */
     via?: IconName;

package/dist/layover/Callout.d.ts

@@ -1,9 +1,12 @@
 import type { ComponentProps, ReactNode } from 'react';
 export interface CalloutProps extends Omit<ComponentProps<'div'>, 'title'> {
+    /** the callout's first line (a place, a name) */
     title: ReactNode;
+    /** a second, smaller line under the title */
     sub?: ReactNode;
-    /** position over the stage background (CSS lengths / percentages) */
+    /** the callout's top edge, over the stage background (a CSS length / percentage) */
     top?: string;
+    /** the callout's centre line, from the left of the stage background (a CSS length / percentage) */
     left?: string;
 }
 /** Callout — a small card with a tail, pinned over a map or a media. */

package/dist/lists/Kv.d.ts

@@ -19,8 +19,11 @@ export interface KvGridProps extends ComponentProps<'div'> {
 /** KvGrid — value-over-label cells split by a rule (Sex | Weight); children are KVCells. */
 export declare function KvGrid({ className, ...rest }: KvGridProps): import("react").JSX.Element;
 export interface KvCellProps extends ComponentProps<'div'> {
+    /** an icon before the value */
     icon?: IconName;
+    /** the big value */
     value: ReactNode;
+    /** the caption under the value */
     label: ReactNode;
 }
 /** KvCell — an icon, a big value, a caption label. */

package/dist/lists/Row.d.ts

@@ -13,8 +13,9 @@ export interface RowProps extends Omit<ComponentProps<'div'>, 'title'> {
     body?: ReactNode;
     /** the trailing control: an IconBtn, a Chip, a Check, a Toggle, a caption */
     end?: ReactNode;
-    /** a trailing value + caption, right-aligned */
+    /** a trailing value, right-aligned (title type) */
     endValue?: ReactNode;
+    /** the muted caption under `endValue` */
     endCaption?: ReactNode;
     /** menu row: more air, a bigger title */
     lg?: boolean;
@@ -22,6 +23,7 @@ export interface RowProps extends Omit<ComponentProps<'div'>, 'title'> {
     done?: boolean;
     /** div (default), a link, a label wrapping a Check/Toggle, li */
     as?: 'div' | 'a' | 'label' | 'li';
+    /** makes the row a link (an `a`); not with `more`, whose row is a summary */
     href?: string;
     /** what the row EXPANDS to show under itself (who liked, the rest of a list): the row becomes a `<details>`' summary */
     more?: ReactNode;

package/dist/media/Mosaic.d.ts

@@ -1,10 +1,12 @@
 import type { ComponentProps } from 'react';
 export interface MosaicProps extends ComponentProps<'div'> {
+    /** the photos' one accessible name — the mosaic is a single `img` (default "Photos", by `<html lang>`) */
     label?: string;
 }
 /** Mosaic — one big photo + two small in a card (three Placeholders or imgs). */
 export declare function Mosaic({ label, className, ...rest }: MosaicProps): import("react").JSX.Element;
 export interface WaveProps extends ComponentProps<'span'> {
+    /** the waveform's accessible name (default "Voice note", by `<html lang>`) */
     label?: string;
     /** the bars' heights, 0–1, left to right — a real recording's levels; default: a mock-up shape */
     levels?: number[];

package/dist/media/Postcard.d.ts

@@ -2,6 +2,7 @@ import { type ComponentProps, type ReactNode } from 'react';
 export interface PostcardProps extends ComponentProps<'div'> {
     /** the photo on the front; none = the wireframe box */
     photo?: string | null;
+    /** the photo's alt text; with no photo, the wireframe box's accessible name */
     alt?: string;
     /** whose card it is — the big line of the band */
     name: ReactNode;
@@ -21,8 +22,11 @@ export interface PostcardProps extends ComponentProps<'div'> {
     liked?: boolean;
     /** the heart was tapped: the state it asks for. No `liked` and no `onLike` = no heart */
     onLike?: (liked: boolean) => void;
+    /** the heart's accessible name (default "ถูกใจ") */
     likeLabel?: string;
+    /** the accessible name of the front's turn-over button (default "พลิกดูด้านหลัง") */
     frontLabel?: string;
+    /** the accessible name of the back's turn-over button (default "พลิกดูด้านหน้า") */
     backLabel?: string;
 }
 /**

package/dist/media/Tile.d.ts

@@ -3,6 +3,7 @@ import { type IconName } from '../type/Icon.js';
 export interface TileGridProps extends ComponentProps<'div'> {
     /** three across on a phone (attachments, upload kinds) */
     cols3?: boolean;
+    /** the grid takes the card's side padding back and runs to its edges (`.bleed`, card.css) */
     bleed?: boolean;
 }
 /** TileGrid — big square Tiles in a responsive grid. */
@@ -18,10 +19,15 @@ export interface TileProps extends Omit<ComponentProps<'div'>, 'onChange'> {
     sub?: ReactNode;
     /** a pick tile: a checkbox (or radio) inside, filled when checked */
     pick?: boolean;
+    /** what the pick tile's input is: checkbox (default) for pick-many, radio for pick-one */
     type?: 'checkbox' | 'radio';
+    /** the input's name (a pick tile): the radios of one choice share it (that is what makes them one group); a checkbox's is its form field */
     name?: string;
+    /** CONTROLLED: picked (a pick tile). The app owns it — pair it with `onChange` */
     checked?: boolean;
+    /** UNCONTROLLED: picked on arrival; the input then keeps its own */
     defaultChecked?: boolean;
+    /** the native input's change event: the tile was picked, or (checkbox) toggled */
     onChange?: React.ChangeEventHandler<HTMLInputElement>;
     /** filled accent (a static "on" tile) */
     on?: boolean;

package/dist/numbers/Bars.d.ts

@@ -6,6 +6,7 @@ export interface BarsProps extends ComponentProps<'div'> {
 /** Bars — three or four bars with a count on top, the glance chart; children are Bar. */
 export declare function Bars({ max, className, style, ...rest }: BarsProps): import("react").JSX.Element;
 export interface BarProps extends ComponentProps<'div'> {
+    /** the bar's height, against `Bars max` (the tallest bar's value) */
     value: number;
     /** the highlighted bar (accent, its count in a pill) */
     on?: boolean;

package/dist/numbers/DotGrid.d.ts

@@ -6,6 +6,7 @@ export interface DotGridProps extends ComponentProps<'div'> {
     done: number;
     /** dots per row (12) */
     cols?: number;
+    /** the grid's accessible name (default "{done} of {total}") */
     label?: string;
 }
 /** DotGrid — progress over time as a grid of dots, one element and three numbers (`--total`, `--done`, `--cols`). */

package/dist/numbers/Picker.d.ts

@@ -8,6 +8,7 @@ export interface PickerProps extends Omit<ComponentProps<'div'>, 'onChange' | 'd
     onChange?: (value: string) => void;
     /** the unit under the rail ("hours") */
     unit?: ReactNode;
+    /** the picker's accessible name (aria-label) */
     label?: string;
 }
 /**

package/dist/numbers/Track.d.ts

@@ -1,5 +1,6 @@
 import type { ComponentProps } from 'react';
 export interface TrackProps extends ComponentProps<'ol'> {
+    /** the track's accessible name (default "Progress", by `<html lang>`) */
     label?: string;
 }
 /** Track — step progress in a dark pill: done · done · todo; children are TrackSteps holding an Icon each. */

package/dist/people/Avatar.d.ts

@@ -15,10 +15,13 @@ export interface AvatarProps extends ComponentProps<'span'> {
     center?: boolean;
     /** a photo instead of initials */
     src?: string;
+    /** the photo's alt text; empty (the default) = decorative */
     alt?: string;
     /** an icon instead of initials */
     icon?: IconName;
+    /** the element: span (default), a when it has an `href`, or button for a tap target */
     as?: 'span' | 'a' | 'button';
+    /** makes the avatar a link (an `a`) */
     href?: string;
     /** the initials */
     children?: ReactNode;
@@ -310,6 +313,8 @@ export declare function Avatar({ size, outline, add, on, halo, center, src, alt,
     className: string;
 }, HTMLSpanElement>;
 export interface AvatarStackProps extends ComponentProps<'span'> {
+    /** the count that trails the stack ("+9"): plain text, no round, no fill, in title type — it reads at arm's length. Use it for a stack of Stamps or when the count is the point; a count that should look like one more head is `<Avatar size="sm" on>+7</Avatar>` as the last child */
+    more?: ReactNode;
 }
-/** AvatarStack — overlapping small Avatars with an optional `on` "+N" tail. */
-export declare function AvatarStack({ className, ...rest }: AvatarStackProps): import("react").JSX.Element;
+/** AvatarStack — overlapping small Avatars, or small Stamps (`bare`), side by side; a trailing count is `more` (or an `on` Avatar as the last child). */
+export declare function AvatarStack({ more, className, children, ...rest }: AvatarStackProps): import("react").JSX.Element;

package/dist/people/Avatar.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { createElement } from 'react';
 import { cx } from '../cx.js';
 import { Icon } from '../type/Icon.js';
@@ -7,7 +7,7 @@ export function Avatar({ size, outline, add, on, halo, center, src, alt = '', ic
     const el = as ?? (href ? 'a' : 'span');
     return createElement(el, { href, type: el === 'button' ? 'button' : undefined, className: cx('avatar', size && `avatar--${size}`, outline && 'avatar--outline', add && 'avatar--add', on && 'avatar--on', halo && 'avatar--halo', center && 'avatar--center', className), ...rest }, src ? _jsx("img", { src: src, alt: alt }) : icon ? _jsx(Icon, { name: icon }) : children);
 }
-/** AvatarStack — overlapping small Avatars with an optional `on` "+N" tail. */
-export function AvatarStack({ className, ...rest }) {
-    return _jsx("span", { className: cx('avatar-stack', className), ...rest });
+/** AvatarStack — overlapping small Avatars, or small Stamps (`bare`), side by side; a trailing count is `more` (or an `on` Avatar as the last child). */
+export function AvatarStack({ more, className, children, ...rest }) {
+    return (_jsxs("span", { className: cx('avatar-stack', className), ...rest, children: [children, more != null && _jsx("span", { className: "avatar-stack__more", children: more })] }));
 }

package/dist/people/AvatarPick.d.ts

@@ -2,6 +2,7 @@ import type { ComponentProps, ReactNode } from 'react';
 export interface AvatarPickProps extends ComponentProps<'div'> {
     /** run the strip to the card's edges */
     bleed?: boolean;
+    /** the strip's accessible name (aria-label) */
     label?: string;
 }
 /** AvatarPick — the chooser row: big heads with name and role under, scrolling sideways; children are AvatarPickItems. */

package/dist/post/PostLetter.d.ts

@@ -32,14 +32,15 @@ export interface PostLetterProps extends ComponentProps<'div'> {
     sign?: ReactNode;
     /** one line under the card: the trip it made */
     journey?: ReactNode;
-    /** the tab's words while the picture is in front (default: cardds's own, by `<html lang>`) */
+    /** the tab's words while the picture is in front — cardds names it in the page's language (`<html lang>`); pass it only for different words */
     backLabel?: string;
-    /** the tab's words while the back is in front */
+    /** the tab's words while the back is in front — named by cardds like `backLabel`; pass it only for different words */
     pictureLabel?: string;
-    /** the play control's names */
+    /** the play control's name while the note is paused — named by cardds in the page's language (`<html lang>`); pass it only for different words */
     playLabel?: string;
+    /** the play control's name while the note plays — named by cardds like `playLabel`; pass it only for different words */
     pauseLabel?: string;
-    /** the small word before the name (default "To", by `<html lang>`) */
+    /** the small word before the name — named by cardds in the page's language (`<html lang>`); pass it only for different words */
     toLabel?: ReactNode;
 }
 /**

package/dist/scaffold/LayerHistory.d.ts

@@ -14,6 +14,7 @@ export interface LayerHistoryProps {
     replace: (state: EntryState, search?: LayerSearch) => void;
     /** back by this many entries (`navigate(-entries)`) */
     back: (entries: number) => void;
+    /** the app's screens: whatever calls `useLayer` / `useLayers` stands under it */
     children?: ReactNode;
 }
 /**

package/dist/scaffold/Screen.d.ts

@@ -5,6 +5,7 @@ export interface ScreenProps extends ComponentProps<'div'> {
     fill?: boolean;
     /** a colour preset from palette.css; omit for the black-and-white wireframe */
     palette?: Palette;
+    /** the element: div (default), main for the page's landmark, or section */
     as?: 'div' | 'main' | 'section';
     /** TOP: a `TopBar` / `AppBar`, or `"lead"` — no bar, the content starts `--screen-lead` (15% of the screen) down */
     top?: ReactNode | 'lead';

package/dist/sheets/Drawer.d.ts

@@ -15,7 +15,7 @@ export interface ModalProps extends ComponentProps<'article'> {
  * out below while the lift moves up.
  * A COMPONENT, not a wiring: it does not know its buttons. They are plain `IconBtn`s / `Btn`s with the app's `onClick` — the app
  * records the answer and sets `open={false}`; the modal's one behaviour is how it leaves. `onDismiss` asks to leave unanswered (a tap on
- * the scrim, Esc).
+ * the scrim, Esc). When it has arrived, cardds puts the cursor in the field marked `data-autofocus`, else the first field, else the question — write no focus code.
  */
 export declare function Modal({ open, onClosed, onDismiss, className, ...rest }: ModalProps): import("react").JSX.Element;
 export interface LiftProps extends ComponentProps<'div'> {

package/dist/sheets/Drawer.js

@@ -8,7 +8,7 @@ import { cx } from '../cx.js';
  * out below while the lift moves up.
  * A COMPONENT, not a wiring: it does not know its buttons. They are plain `IconBtn`s / `Btn`s with the app's `onClick` — the app
  * records the answer and sets `open={false}`; the modal's one behaviour is how it leaves. `onDismiss` asks to leave unanswered (a tap on
- * the scrim, Esc).
+ * the scrim, Esc). When it has arrived, cardds puts the cursor in the field marked `data-autofocus`, else the first field, else the question — write no focus code.
  */
 export function Modal({ open = true, onClosed, onDismiss, className, ...rest }) {
     const ref = useRef(null);

package/dist/sheets/Sheet.d.ts

@@ -19,7 +19,7 @@ export interface SheetProps extends Omit<ComponentProps<'article'>, 'onChange'>
     onSettled?: (state: SheetState) => void;
     /** the states a drag snaps to and a reveal may climb through — "peek half full", or an array (default all four) */
     states?: string | readonly Resting[];
-    /** the grab handle; `false` for a sheet with no handle, a string sets its accessible name */
+    /** the grab handle; `false` for a sheet with no handle. cardds names it in the page's language (`<html lang>`) — a string is for different words only */
     handle?: boolean | string;
     /** the grab mark. `line` (default) or `dots`: both sit in the card's top padding, the same distance from the edge, so the title does not move */
     mark?: 'line' | 'dots';
@@ -50,5 +50,6 @@ export interface SheetProps extends Omit<ComponentProps<'article'>, 'onChange'>
  * fixed habit of every sheet. A sheet asked up in the same box meanwhile waits for it: "one left, another came", never two sheets
  * crossing and never one continuous move, whatever the app's wiring (both states set in one render, or the next raised from the
  * first's `onSettled`) — the app adds no timer.
+ * The CURSOR is cardds's too: once it has come up it waits in the field marked `data-autofocus`, else the first field, else the heading — write no `autoFocus` or `.focus()` for it.
  */
 export declare function Sheet({ state, defaultState, onStateChange, onSettled, states, handle, mark, refreshing, tone, paper, className, children, onFocus, ...rest }: SheetProps): import("react").JSX.Element;

package/dist/sheets/Sheet.js

@@ -37,6 +37,7 @@ function markLong(node, long) {
  * fixed habit of every sheet. A sheet asked up in the same box meanwhile waits for it: "one left, another came", never two sheets
  * crossing and never one continuous move, whatever the app's wiring (both states set in one render, or the next raised from the
  * first's `onSettled`) — the app adds no timer.
+ * The CURSOR is cardds's too: once it has come up it waits in the field marked `data-autofocus`, else the first field, else the heading — write no `autoFocus` or `.focus()` for it.
  */
 export function Sheet({ state, defaultState = 'half', onStateChange, onSettled, states, handle = true, mark = 'line', refreshing, tone, paper, className, children, onFocus, ...rest }) {
     const [current, request] = useControlled(state, defaultState, onStateChange);

package/dist/sheets/SheetStack.d.ts

@@ -38,5 +38,6 @@ export interface SheetStackProps extends ComponentProps<'div'> {
  * the phone's back button can open and close a section. WHAT the sheet does with that, and with `refreshing`, lives on the card (`stack`):
  * the place classes, the grip, the pull. The stack only says which index. Sheets are rigid — the open one slides up, the ones after it leave
  * below, the ones before tuck under nearest-first; closing reverses in two beats. Only `translate` (stack.css); never a size.
+ * The CURSOR is cardds's: a sheet that opens takes it in the field marked `data-autofocus`, else the first field, else the heading — write no `autoFocus` or `.focus()` for it.
  */
 export declare function SheetStack({ mode, open, defaultOpen, onOpenChange, onRefresh, refreshing, mark, fanned, closed, rise, base, className, children, onClickCapture, onPointerDownCapture, ref: passed, ...rest }: SheetStackProps): import("react").JSX.Element;

package/dist/sheets/SheetStack.js

@@ -55,6 +55,7 @@ function stamp(child, place) {
  * the phone's back button can open and close a section. WHAT the sheet does with that, and with `refreshing`, lives on the card (`stack`):
  * the place classes, the grip, the pull. The stack only says which index. Sheets are rigid — the open one slides up, the ones after it leave
  * below, the ones before tuck under nearest-first; closing reverses in two beats. Only `translate` (stack.css); never a size.
+ * The CURSOR is cardds's: a sheet that opens takes it in the field marked `data-autofocus`, else the first field, else the heading — write no `autoFocus` or `.focus()` for it.
  */
 export function SheetStack({ mode = 'tap', open, defaultOpen = null, onOpenChange, onRefresh, refreshing = null, mark = 'dots', fanned, closed, rise = 'under', base, className, children, onClickCapture, onPointerDownCapture, ref: passed, ...rest }) {
     const [current, request] = useControlled(open, defaultOpen, onOpenChange);

package/dist/sheets/SheetSteps.d.ts

@@ -40,7 +40,7 @@ export interface SheetStepProps extends Omit<ComponentProps<'li'>, 'title'> {
     summary?: ReactNode;
     /** the member may pass this step without doing it: a small link at its end moves on (reason `skip`) */
     skippable?: boolean;
-    /** the skip link's words (default "Skip") */
+    /** the skip link's words — cardds names it in the page's language (`<html lang>`); pass it only for different words */
     skipLabel?: ReactNode;
     /** what went wrong, in words — one line UNDER the step's button (an alert icon, `--signal-error`, read out at once): the number
      *  is not a phone number, no signal, the code could not be sent, the two PINs differ. The step stays where it is; to send the
@@ -50,5 +50,5 @@ export interface SheetStepProps extends Omit<ComponentProps<'li'>, 'title'> {
      *  step's buttons take no taps meanwhile. The app moves `at` when the answer is good, or sets `error`. */
     busy?: ReactNode;
 }
-/** SheetStep — one step of a SheetSteps: its title, then what the member does (a Field, a Pin, a Toggle, the step's own Btn). */
+/** SheetStep — one step of a SheetSteps: its title, then what the member does (a Field, a Pin, a Toggle, the step's own Btn). When it opens, cardds puts the cursor in the field marked `data-autofocus`, else the first field, else the title — write no focus code. */
 export declare function SheetStep({ title, summary, skippable, skipLabel, error, busy, className, children, ...rest }: SheetStepProps): import("react").JSX.Element;

package/dist/sheets/SheetSteps.js

@@ -201,7 +201,7 @@ function useStepChecks(off, park) {
     };
     return { note, group, press };
 }
-/** SheetStep — one step of a SheetSteps: its title, then what the member does (a Field, a Pin, a Toggle, the step's own Btn). */
+/** SheetStep — one step of a SheetSteps: its title, then what the member does (a Field, a Pin, a Toggle, the step's own Btn). When it opens, cardds puts the cursor in the field marked `data-autofocus`, else the first field, else the title — write no focus code. */
 export function SheetStep({ title, summary, skippable, skipLabel = word('skip'), error, busy, className, children, ...rest }) {
     const ctx = useContext(StepCtx);
     if (!ctx)

package/dist/sheets/StackSheet.d.ts

@@ -23,11 +23,13 @@ export interface StackSheetProps extends Omit<ComponentProps<'article'>, 'title'
     tabs?: StackSheetTab[];
     /** CONTROLLED: the tab shown (its id) — with `onTabChange`; or `defaultTab` (default: the first) */
     tab?: string;
+    /** UNCONTROLLED: the tab shown first (its id, default the first); the sheet then keeps its own. Pair of `tab` */
     defaultTab?: string;
+    /** a tab was tapped: its id */
     onTabChange?: (tab: string) => void;
     /** the SHEET FOOT: the CTA at the sheet's bottom (one row) */
     foot?: ReactNode;
-    /** the back button's label (shown once the sheet is open) */
+    /** the back button's label (shown once the sheet is open) — cardds names it in the page's language (`<html lang>`); pass it only for different words */
     backLabel?: string;
     /** where the back button stands: `none` (default — hidden for now, Lh 2026-09-29: not used in real work yet; a tap on the open sheet's title folds it) ·
      *  `end` (after the tabs, chevron DOWN: the sheet folds down) · `start` (before the title, chevron left) */
@@ -40,6 +42,6 @@ export interface StackSheetProps extends Omit<ComponentProps<'article'>, 'title'
  * SHEET BODY (the children; scrolls) · SHEET FOOT (`foot`, the CTA) at the bottom. Its tabs are icon buttons. The chosen one is filled
  * only while this sheet is open — a closed home shows every icon plain; the disc fades in with the rise and out with the fold.
  * A count shows as a small circle over its icon. The body is the app's: render the page of the chosen tab (and nothing while the sheet
- * is closed — see `Home`). A direct child of `SheetStack`.
+ * is closed — see `Home`). A direct child of `SheetStack`. Once open, cardds puts the cursor in the field marked `data-autofocus`, else the first field, else the heading — write no focus code.
  */
 export declare function StackSheet({ title, tone, paper, icon, tabs, tab: tabProp, defaultTab, onTabChange, foot, backLabel, backAt, stack, className, children, ...rest }: StackSheetProps): import("react").JSX.Element;

package/dist/sheets/StackSheet.js

@@ -17,7 +17,7 @@ import { word } from '../words.js';
  * SHEET BODY (the children; scrolls) · SHEET FOOT (`foot`, the CTA) at the bottom. Its tabs are icon buttons. The chosen one is filled
  * only while this sheet is open — a closed home shows every icon plain; the disc fades in with the rise and out with the fold.
  * A count shows as a small circle over its icon. The body is the app's: render the page of the chosen tab (and nothing while the sheet
- * is closed — see `Home`). A direct child of `SheetStack`.
+ * is closed — see `Home`). A direct child of `SheetStack`. Once open, cardds puts the cursor in the field marked `data-autofocus`, else the first field, else the heading — write no focus code.
  */
 export function StackSheet({ title, tone, paper, icon, tabs, tab: tabProp, defaultTab, onTabChange, foot, backLabel = word('back'), backAt = 'none', stack, className, children, ...rest }) {
     const [tab, pick] = useControlled(tabProp, defaultTab ?? tabs?.[0]?.id, onTabChange);

package/dist/stamp/StampBook.d.ts

@@ -4,9 +4,11 @@ export interface StampBookProps extends ComponentProps<'div'> {
     places?: number;
     /** ONE line of small stamps that scrolls sideways, no ground — the tray a member picks from */
     strip?: boolean;
+    /** the page with NO ground — no fill, no padding, no round: three stamps across fill the whole width of what holds the book, each the full width of its third (the Stamp's width cap is lifted) with the least gap that keeps them apart. Put the name INSIDE the stamp (`Stamp name`), not under it */
+    bare?: boolean;
 }
 /** StampBook — the album page: StampCells three across on an album ground, the free places drawn empty up to `places`. */
-export declare function StampBook({ places, strip, className, children, ...rest }: StampBookProps): import("react").JSX.Element;
+export declare function StampBook({ places, strip, bare, className, children, ...rest }: StampBookProps): import("react").JSX.Element;
 export interface StampCellProps extends Omit<ComponentProps<'span'>, 'onClick'> {
     /** a short line under the stamp — who it is from */
     label?: ReactNode;

package/dist/stamp/StampBook.js

@@ -4,9 +4,9 @@ import { cx } from '../cx.js';
 import { Icon } from '../type/Icon.js';
 import { StampPlace } from './Stamp.js';
 /** StampBook — the album page: StampCells three across on an album ground, the free places drawn empty up to `places`. */
-export function StampBook({ places = 0, strip, className, children, ...rest }) {
+export function StampBook({ places = 0, strip, bare, className, children, ...rest }) {
     const free = Math.max(0, places - Children.count(children));
-    return (_jsxs("div", { className: cx('stamp-book', strip && 'stamp-book--strip', className), ...rest, children: [children, Array.from({ length: free }, (_, i) => _jsx(StampPlace, { faint: true, "aria-hidden": "true" }, i))] }));
+    return (_jsxs("div", { className: cx('stamp-book', strip && 'stamp-book--strip', bare && 'stamp-book--bare', className), ...rest, children: [children, Array.from({ length: free }, (_, i) => _jsx(StampPlace, { faint: true, "aria-hidden": "true" }, i))] }));
 }
 /** StampCell — one place of a StampBook: a Stamp (the child) and a short label under it. */
 export function StampCell({ label, onClick, on, className, children, ...rest }) {

package/dist/templates/CallSheet.d.ts

@@ -10,7 +10,7 @@ export interface CallSheetSheet {
     foot?: ReactNode;
     /** a small link UNDER that button (a `Link sm`, e.g. details for developers) */
     footLink?: ReactNode;
-    /** this sheet's handle — its accessible name (a string), or `false` for none; overrides the CallSheet's `handle` */
+    /** this sheet's handle: `false` for none, a string only for words different from cardds's own (named in the page's language, `<html lang>`); overrides the CallSheet's `handle` */
     handle?: SheetProps['handle'];
 }
 /** one way in: its button and the sheet it calls */
@@ -39,11 +39,13 @@ export interface CallSheetProps extends Omit<ComponentProps<typeof Screen>, 'chi
     ways?: CallSheetWay[];
     /** CONTROLLED: which way's sheet is up — an index, or null for none (`true` = the first); with `onOpenChange`; or `defaultOpen` */
     open?: number | boolean | null;
+    /** UNCONTROLLED: the way whose sheet is up on arrival (an index, `true` = the first, null = none); the template then keeps its own. Pair of `open` */
     defaultOpen?: number | boolean | null;
+    /** a sheet came up or went away: whether one is up, and which way's (its index, or null) */
     onOpenChange?: (open: boolean, way: number | null) => void;
     /** the sheets' resting states once up (default "peek full") */
     states?: string;
-    /** every sheet's handle: its accessible name in the app's language (a string — default "Resize"), or `false` for none. A sheet's own `handle` wins */
+    /** every sheet's handle: `false` for none; cardds names it in the page's language (`<html lang>`), so pass a string only for different words. A sheet's own `handle` wins */
     handle?: SheetProps['handle'];
     /** layers over the screen */
     children?: ReactNode;

package/dist/templates/Home.d.ts

@@ -29,7 +29,9 @@ export interface HomeProps extends Omit<ComponentProps<typeof Screen>, 'children
     sheets: HomeSheet[];
     /** CONTROLLED: the open sheet's index, or null — with `onOpenChange`; or `defaultOpen` */
     open?: number | null;
+    /** UNCONTROLLED: the sheet open on arrival (its index), or null for none; the Home then keeps its own. Pair of `open` */
     defaultOpen?: number | null;
+    /** a sheet asks to come up or fold: the index it asks for, or null for none */
     onOpenChange?: (open: number | null) => void;
     /** the open sheet's scroller was already at the top and the finger pulled down past the commit. The stack asks with that index. It does not fetch. Omit it and a pull in the body only scrolls */
     onRefresh?: (index: number) => void;
@@ -44,7 +46,7 @@ export interface HomeProps extends Omit<ComponentProps<typeof Screen>, 'children
     base?: ReactNode;
     /** keep a sheet's body mounted after it closes (it opens again at once, scrolled where it was); default: dropped */
     keep?: boolean;
-    /** the open sheet's back button label */
+    /** the open sheet's back button label — cardds names it in the page's language (`<html lang>`); pass it only for different words */
     backLabel?: string;
     /** the open sheet's back button — see `StackSheet backAt` (default `none`: hidden for now) */
     backAt?: StackSheetProps['backAt'];

package/dist/templates/Walkthrough.d.ts

@@ -15,10 +15,13 @@ export interface WalkthroughCta {
     go: (to: number) => void;
 }
 export interface WalkthroughProps extends Omit<ComponentProps<typeof Screen>, 'children' | 'fill' | 'top' | 'bottom'> {
+    /** the pages in order — a picture, a heading and the words each */
     pages: WalkthroughPage[];
     /** the page shown (0-based), controlled — with `onAtChange`; or `defaultAt` */
     at?: number;
+    /** UNCONTROLLED: the page shown on arrival (0-based, default 0); the walk then keeps its own. Pair of `at` */
     defaultAt?: number;
+    /** a page was turned to: its index */
     onAtChange?: (at: number) => void;
     /** the ONE row of the bottom panel. Omitted: the round pager (back · next). A function gets `{ at, count, go }`,
      *  e.g. the pager until the last page, then one wide Btn. */
@@ -29,8 +32,9 @@ export interface WalkthroughProps extends Omit<ComponentProps<typeof Screen>, 'c
     ctaLink?: ReactNode;
     /** layers over the screen: the app's `SheetStage dim` + `Modal` that a link or button opens (the app wires it) */
     children?: ReactNode;
-    /** the pager's labels */
+    /** the pager's back button name — cardds names it in the page's language (`<html lang>`); pass it only for different words */
     backLabel?: string;
+    /** the pager's next button name — cardds names it in the page's language (`<html lang>`); pass it only for different words */
     nextLabel?: string;
 }
 /**