@flood-md/react 0.2.3 → 0.2.5

package/README.md

@@ -3,7 +3,7 @@
 Original React 18.3/19 components for TypeScript and Next.js App Router. Native
 HTML semantics and refs, no third-party component library or Tailwind dependency.
 
-This package documents the **0.2.3** API. Keep Flood package versions aligned and follow the guide matching
+This package documents the **0.2.5** source API. Keep Flood package versions aligned and follow the guide matching
 your installed declarations; source changes do not modify an existing npm release.
 
 ```tsx
@@ -314,11 +314,16 @@ Available in 0.2.3. Use matching installed declarations.
 
 Field and Fieldset accept hideLabel (false by default). It visually hides the real
 Label or legend, preserving its association and accessible name, while removing
-the label's layout row and spacing. The required label/legend prop remains required.
+the label's layout row and spacing while it has no focused descendants. The
+required label/legend prop remains required.
 RadioGroup, CheckboxGroup and SegmentedControl inherit hideLabel. Required native
 controls, descriptions, error/status, group names and form behavior are unchanged.
 Keep essential instructions in a visible hint/message when they are needed.
-Use textual label content; do not put interactive elements inside hidden labels.
+Prefer textual label content. Hidden labels/legends reveal while a descendant
+has focus, then hide again when focus leaves. A supporting link in a Field label
+or a control in a Fieldset first legend therefore retains visible keyboard focus;
+React child state, refs and native first-legend disabled exceptions are preserved.
+Do not nest another labelable control (button/input) inside a Field label.
 
 For Input/Textarea/Select/InputGroup apply hideLabel to their surrounding Field,
 not the native control. Input aria-label/aria-labelledby remain available when
@@ -507,3 +512,393 @@ The native nav ref is HTMLElement. This component does not fetch data or own URL
 ```
 
 All three are available in 0.2.3. Use Flood styles and FloodRoot for the neutral dark profile.
+
+
+## Badge, Spinner, Skeleton and Avatar · 0.2.4
+
+These original primitives are compatible additions in the 0.2.4.
+Import Flood CSS and use FloodRoot. Verify registry publication before installing.
+Native span props and refs target their roots; className/style remain host overrides.
+
+Badge is a noninteractive span: size sm/md/lg, tone neutral/accent/error/warning/
+success/info and variant subtle/outline. Its text carries the meaning; color is
+supplementary. It has no selection, dismissal, click-action or live-region model.
+Use a separate named action when needed instead of treating it as a button.
+
+Spinner defaults to size md and label="Loading". Localize label for standalone
+status. decorative hides it and its label from assistive technology. Button
+loading uses the same Spinner decoratively, inherits its icon size and retains
+its accessible button name and aria-busy. Announcements belong at the appropriate
+host level; do not create one live region for each decorative loading graphic.
+Reduced motion stops rotation. This indicator does not measure completion.
+
+Skeleton is always aria-hidden. shape is text/rounded/circle; width and height
+accept CSS dimensions (numbers are React CSS pixels), and style overrides them.
+Prefer relative dimensions. For a circle supply equal dimensions. animate defaults
+true; reduced motion and forced colors stop animation. Match the final geometry;
+Skeleton does not fetch, detect loading or announce changes. The host owns busy
+state, loading text and replacement with real content. Do not add interactive children.
+
+Avatar requires name, accepts src, fallback text, size sm/md/lg, shape circle/
+rounded and decorative. The root exposes one named image; the internal image has
+empty alt and is hidden from assistive technology. Use decorative beside an
+already visible equivalent name. Defaults use the first letters of the first two
+whitespace-separated name parts; override fallback for your locale or naming rules.
+The image overlays the fallback only after successful load; an error retains the
+fallback. A new src remounts the image load state, including returning to an earlier
+source. The root stays the same size. This API does not upload or crop images.
+
+```tsx
+<Badge tone="success">Active</Badge>
+<Spinner label="Loading workspace" />
+<Skeleton width="12rem" />
+<Avatar name="Alex Morgan" src="/team/alex.webp" />
+```
+
+
+## Progress, Meter and Alert · 0.2.4
+
+Progress describes task completion. label is required; max defaults to 100 and
+value is a finite number in 0..max. Omit value for indeterminate progress; its
+progressbar then omits aria-valuenow. Meter describes a measurement in a bounded
+range, such as storage or battery. It requires value, with min=0 and max=100 by
+default. Require finite min < max, a finite range span, and min <= value <= max.
+Invalid ranges/values throw RangeError; they are not silently clamped.
+
+Both support size sm/md/lg, semantic tone, hideLabel and valueText. Tone defaults
+to accent for Progress and neutral for Meter. valueText supplies localized,
+human-readable units; it also appears beside the caption. hideLabel visually
+hides the caption while retaining the accessible name and valueText. The bar's
+role is progressbar or meter; neither becomes a live region. Native div props,
+className/style and HTMLDivElement ref target the wrapper; the internal bar owns
+its ARIA range and label associations. Wrapper ARIA props stay on the wrapper; use valueText for range-specific wording. No keyboard model,
+threshold calculation, fetching, timers or task cancellation is built in.
+Reduced motion stops indeterminate movement and value transitions. Forced colors
+preserves the track boundary and fill. Use a host loading message when needed.
+
+Alert is an inline message, with optional plain-text title and React children.
+Tones are neutral/info/success/warning/error; info is the default. Meaning must
+remain in the text. Original decorative status glyphs are included; icon accepts
+noninteractive host artwork, and icon={null} removes it without an empty column.
+The title is message content, not the root's HTML title tooltip or a document heading.
+Native div props/className/style/ref target the root.
+
+announcement defaults to off for static messages. polite uses role=status;
+assertive uses role=alert. Choose urgency deliberately for dynamically inserted
+content. Announcements depend on actual assistive technology; initial static
+markup is not guaranteed to be read aloud. No focus movement, auto-dismiss,
+timeout or built-in close/action button is supplied. Compose named host actions
+inside children when needed. Alert is separate from Dialog and future Toast.
+
+See the [WAI Meter pattern](https://www.w3.org/WAI/ARIA/apg/patterns/meter/),
+[Alert pattern](https://www.w3.org/WAI/ARIA/apg/patterns/alert/) and
+[progressbar definition](https://www.w3.org/TR/wai-aria-1.2/#progressbar).
+
+```tsx
+<Progress label="Uploading files" value={60} valueText="60%" />
+<Progress label="Preparing workspace" />
+<Meter label="Storage used" min={0} max={100} value={75} valueText="75 of 100 GB" />
+<Alert tone="warning" title="Storage is almost full">
+  Free some space before your next upload.
+</Alert>
+```
+
+
+## DescriptionList and Table · 0.2.4
+
+DescriptionList renders native dl groups, each with dt and dd. items is a readonly
+array of {id, term, description}; IDs must be unique and nonempty, and are React
+keys rather than DOM anchors. term is text and description is ReactNode, so a
+value can include a Badge, Link or other meaningful content. The host formats
+values and supplies fallback text for missing data. An empty items array stays
+an empty list, without invented placeholder content. Native dl props,
+className/style and HTMLDListElement ref target the list.
+
+layout defaults inline: term and value share a row. It becomes stacked below a
+22rem component container width, independently of viewport width. layout=stacked
+always puts the value below its term. Density defaults compact; comfortable adds
+space between pairs, without inflating the term/value relationship. dividers is
+false by default and adds quiet separators when enabled. This is not an editable
+form and its terms do not label controls; use Field/Fieldset for form inputs.
+
+Table wraps an actual HTML table in Flood's horizontal ScrollArea. caption is
+required and must be meaningful; hideCaption visually hides it without removing
+the accessible table name. children owns native thead/tbody/tfoot/colgroup markup
+and th/td associations. Supply scope=col or scope=row for simple headers, and
+explicit id/headers associations for complex spanning headers. Do not add another
+caption child. See [WAI table guidance](https://www.w3.org/WAI/tutorials/tables/).
+
+Table density defaults comfortable; compact reduces vertical cell padding.
+striped is false by default. Native tfoot rows use a quiet tinted background and
+medium-weight text to distinguish summaries; the top separator stays decorative.
+data-numeric on a th or td uses logical end alignment,
+tabular figures and no wrapping for numbers. data-align=start/center/end overrides
+alignment explicitly. Text cells wrap; set style.minWidth to preserve room for a
+wide table, and the containing ScrollArea handles overflow. The host owns dates,
+units, totals, empty rows/colSpan and any cell actions. Avoid interactive whole rows.
+
+Native table props, className/style and HTMLTableElement ref target the table,
+not its viewport. dir/lang/hidden also govern the containing scroll area.
+scrollLabel names that viewport independently and defaults to caption. The native
+table keeps its own caption; viewport keyboard scrolling does not turn it into a
+grid widget. Keep action controls inside cells normally focusable. No sorting,
+selection, data fetching, pagination, sticky header or virtualization is implied.
+This is the compositional table primitive, not a DataTable engine.
+
+```tsx
+<DescriptionList items={[
+  {id:"project",term:"Project",description:"Flood"},
+  {id:"version",term:"Version",description:"0.2.4"},
+]} />
+<Table caption="Workspace projects" style={{minWidth:"32rem"}}>
+  <thead><tr><th scope="col">Project</th><th scope="col" data-numeric>Members</th></tr></thead>
+  <tbody><tr><th scope="row">Flood</th><td data-numeric>12</td></tr></tbody>
+</Table>
+```
+
+
+## Menu · 0.2.4
+
+Menu is an original action menu using Flood's positioning/layer stack and the
+native Popover API. label names the menu; there is no extra visible caption.
+trigger is a render function receiving OverlayTriggerProps: forward all props
+and ref to one persistent Button/IconButton/native button, and compose existing
+handlers rather than replacing the supplied ones. The trigger exposes
+aria-haspopup=menu, aria-expanded and aria-controls. disabled affects the trigger,
+not actions inside a menu the controlled host keeps open.
+
+items is a readonly array of action items {id,label,icon?,shortcut?,disabled?,tone?}
+or separators {id,type:"separator"}. IDs must be unique and nonempty, action
+labels nonempty, and at least one action must exist. The optional item type is
+item. Icons must be decorative, noninteractive artwork. shortcut is display-only,
+not an installed keyboard binding or part of the accessible action name. Destructive
+actions use tone=danger; that visual treatment does not perform confirmation or
+execute any business operation. Disabled items remain focusable with aria-disabled,
+but neither pointer nor keyboard activation calls onAction or closes the menu.
+
+Enter/Space/ArrowDown open at the first action; ArrowUp opens at the last.
+Inside: Up/Down wrap, Home/End choose edges, printable label-prefix typeahead
+matches items (repeated characters cycle). Separators are not focusable. Enter
+or Space activates through a native button. Escape closes the top menu and
+returns focus. Tab moves to the next focusable control after the trigger;
+Shift+Tab returns to the trigger. The menu does not trap focus. Outside pointer
+or focus departure requests dismissal and preserves deliberately moved focus.
+
+open/onOpenChange is controlled, or use defaultOpen for initial local state.
+The host may refuse a close request. onAction(id) requests closing before calling
+the host; the host owns business logic, asynchronous work and errors. If it moves
+focus elsewhere or opens a Dialog, normal focus restoration must not steal it.
+Actions mount while open and unmount on close. The persistent popup ref and native
+div props/className/style target its panel. Engine-owned coordinates and available
+space variables belong to positioning; side/align follow Popover conventions.
+controlSize is sm/md/lg/xl (sm default); pointer-coarse targets retain touch size.
+
+The popup uses Flood ScrollArea for long action lists, bounded to the available
+viewport. Its inner corners follow shell padding and border geometry. Focus is
+inset to stay visible. There is no href/navigation-item, submenu, checkbox/radio,
+context-menu trigger or menubar contract in this first action-menu component.
+Use ordinary Link for ordinary navigation; keep different selection models separate.
+
+See [WAI Menu Button](https://www.w3.org/WAI/ARIA/apg/patterns/menu-button/) and
+[Menu keyboard patterns](https://www.w3.org/WAI/ARIA/apg/patterns/menubar/).
+
+```tsx
+<Menu label="Project actions"
+  trigger={props => <Button {...props}>Project actions</Button>}
+  items={[{id:"rename",label:"Rename…"},{id:"divider",type:"separator"},
+    {id:"delete",label:"Delete project",tone:"danger"}]}
+  onAction={id => chooseProjectAction(id)}
+/>
+```
+
+### Toolbar and Kbd (0.2.4)
+
+Toolbar groups Button, IconButton, Toggle, native buttons/links and Menu triggers
+under one named action panel. After hydration it uses one Tab entry, directional
+arrows, Home/End and optional looping. Disabled/hidden actions are skipped. Arrows
+move focus, not activation. Horizontal order follows writing direction. In vertical
+toolbars open Menu with Enter/Space; horizontal menus retain Up/Down opening.
+Keep text inputs and independent selection widgets outside this action-only API.
+Native child handlers and refs remain attached; Toolbar owns their tabIndex while
+mounted and restores original attributes on cleanup. Without JavaScript, native
+child Tab order remains available. Use a meaningful required label.
+
+Kbd renders native kbd markup with sm/md/lg sizes and relative keycap heights.
+It displays a key or combination; the host implements real shortcuts. It is not
+interactive. Menu shortcut hints reuse Kbd and remain hidden from item names.
+
+```tsx
+<Toolbar label="Editor actions">
+  <Button variant="ghost">Undo</Button>
+  <Toggle variant="ghost">Bold</Toggle>
+  <Button variant="ghost">Share</Button>
+</Toolbar>
+<Kbd>Ctrl</Kbd> + <Kbd>K</Kbd>
+```
+
+### Card (0.2.4)
+
+Card composes Surface into a header, body and footer. Optional title, description,
+actions and footer accept React content; children are the body. Missing slots
+create no empty section. Use Surface when only a background/padding is needed.
+
+Card is a noninteractive div. Put Button, Link or Menu in actions/footer and keep
+its container out of the Tab order. Do not make the entire card clickable around
+nested controls. Native div props, styles and HTMLDivElement ref target the root.
+The title prop is heading content, not an HTML tooltip; supply phrasing content.
+headingLevel defaults to 2; choose the correct hierarchy for the host page.
+
+Compact/comfortable density controls existing spacing tokens. Header actions wrap
+without clipping menus or focus indicators. Footer uses a quiet separator; a
+footer-only card has no redundant separator. Elevation is default or raised.
+No data access, selection or interactive-card behavior is implied.
+
+```tsx
+<Card title="Project details" description="Keep your team in sync."
+  footer={<Button variant="subtle">Open project</Button>}>
+  <Text as="p" size="compact">A calm place for the next idea.</Text>
+</Card>
+```
+
+## Structural, media and accessible primitives · 0.2.4
+
+Container centers a max-width box with logical gutters. size sm/md/lg uses
+40/64/80rem bounds including padding; full removes the max. gutter uses Space.
+Grid defaults to auto-fit with a16rem semantic minimum clamped to available
+width. gap uses Space. minItemWidth overrides the auto minimum; explicit columns
+(1/2/3/4/6/12) remain fixed. Grid is ordinary layout, never an ARIA grid widget.
+
+VisuallyHidden preserves content in the accessibility tree using span/div. Default
+is for noninteractive content. Use focusable for a skip link: focus-within reveals
+its wrapper; style the actual link's focus. This is different from aria-hidden or
+conditional rendering. Native captions/legends may use the same hiding utility
+without an invalid generic wrapper. Spinner and hidden indicator captions compose
+VisuallyHidden.
+
+AspectRatio reserves responsive media geometry before loading, accepting a finite
+positive ratio (16/9 default). Direct img/video/iframe children fill its box. It
+does not clip focus or make arbitrary long content fit; the host owns alternative
+text, captions, media controls and deliberate cropping. Image is a native img
+with required alt (empty for decorative content), cover/contain fit and preserved
+srcSet/sizes/loading/decoding/dimensions/events/ref. No optimizer, fetch engine or
+fallback is implied. Avatar composes Image for its own loading lifecycle. Supply
+image dimensions or AspectRatio to reserve space.
+
+List renders native ul/ol with native li children and token gap. ordered selects
+ol; start/reversed apply there. start must be a safe integer. marker=false retains
+explicit list semantics for platforms that drop lists without visible markers.
+This is content, not ListBox selection or arrow navigation.
+
+EmptyState composes Stack, Heading, Text, IconSlot and Inline. Required title,
+optional description, decorative icon and actions explain absent content; choose
+headingLevel for the host hierarchy. It is static, with no automatic focus or
+announcement. compact/comfortable density controls padding. The host implements
+real actions and decides whether asynchronously changed results need announcing.
+
+Checkbox adds indeterminate for a host-controlled mixed presentation after
+hydration. checked independently determines form submission; mixed does not mean
+a third submitted value. The host owns aggregate/select-all values. Native reset
+and ref access remain available. Radio and Switch do not expose indeterminate.
+
+ButtonGroup/ToggleGroup retain their keyboard contracts and locally scroll when
+a connected row cannot fit. InputGroup actions keep words intact and can wrap to
+a new row while the input retains usable space. Plain string adornments are bidi
+isolated; for protocols/phones with explicit direction pass a bdi dir=ltr node.
+Keep very long addon content concise. Hidden native choices hide their label too.
+
+Dark foundations bundle both normal and italic Inter, including Cyrillic, with
+original OFL notices. Color alone never communicates validation or progress.
+
+CodeSnippet codeDirection defaults to ltr independently of RTL parent action layout; choose rtl/auto explicitly for content that needs it. Native dir still applies to the wrapper. Protected ScrollArea reveals focused descendants fully when needed, composes the host focus handler and avoids scrolling to nested top-layer controls.
+
+Checkbox, Radio and Switch apply native hidden/dir/lang to their visible label wrapper as well as the input, so a component-local language/direction applies to its whole choice.
+
+
+0.2.5 adds NumberInput (native numeric editing and integrated step actions) and Slider (one value or an ordered pair). Use matching declarations and the numeric controls guide in docs/base-components.md. Registry publication is separate from source availability.
+
+Combobox adds editable single selection in 0.2.5. Reuse Field for the
+label, use options with stable value/label pairs, and observe onValueChange for
+the selected ID. Search query text is not form data. See docs/base-components.md
+for reset, required, read-only, localized messages and native Popover requirements.
+
+Tag and MultiSelect are compatible additions in 0.2.5.
+Tag labels an item and optionally requests host-owned removal. MultiSelect uses
+arrays of stable option IDs and composes those tags with the shared searchable
+selection model. See docs/base-components.md for keyboard behavior, locked values,
+readonly/required forms, focus recovery and relative nested geometry. Existing
+Combobox continues to accept and return a single string.
+
+
+SearchInput and PasswordInput join 0.2.5. Both compose
+InputGroup with native input props, Field feedback, ref, sizes and form ownership.
+SearchInput uses type=search and a decorative leading icon; clearable defaults to
+true and clearLabel names its sole suffix action. Clearing dispatches native input
+editing, restores input focus and respects read-only/disabled. The host owns search
+results and submission. PasswordInput keeps one visibility action; use
+visible/onVisibleChange or defaultVisible, and localize showPasswordLabel and
+hidePasswordLabel. Revealing retains the value and caret; read-only permits reveal.
+Use autocomplete appropriate to the host form. Both accept accessible names via
+Field, aria-label or aria-labelledby. These controls add no authentication logic.
+
+
+FileInput (0.2.5) composes a native file input with Flood field geometry,
+IconSlot and one optional clear IconButton. Pass Field's render props for its
+accessible name/description/status. Native name, form, required, accept, multiple,
+capture and input ref remain available. onChange is a native React change handler;
+onFilesChange receives a new readonly File array for selection and clear. Do not
+pass value/defaultValue/readOnly; FileList belongs to the browser. Uncontrolled
+form reset clears the summary; cancelling the chooser keeps its prior selection.
+Localize placeholder and clearLabel. Long names truncate visually, and the host
+owns upload, file validation and progress. accept only guides the chooser.
+
+
+FileInput multiple selection exposes a collapsible file list with full names and
+localized file sizes (lang controls number formatting), and a count in the picker.
+Translate selectionLabel and removeFileLabel. Individual removal updates the native
+FileList through DataTransfer, then emits the same change callbacks as selection.
+Focus moves to the next/previous remove action, or back to the input when empty.
+clearable=false disables individual and global removal UI. In multiple mode, picking again appends files to the current selection; cancel
+preserves it. Repeated files are deduplicated by name, size, type, lastModified and
+relative path, without reading their contents. Single mode replaces its selection. The host remains responsible for upload.
+
+
+AlertDialog (0.2.5) is a concise confirmation, composed from Flood's
+native modal layer and Button. Supply title, description, trigger and onConfirm.
+Cancel receives initial focus; Escape cancels; outside clicks do not dismiss.
+Tab containment, background inertness, scroll lock and return focus reuse Dialog.
+Translate confirmLabel/cancelLabel. onConfirm runs before requesting close, while
+onCancel covers Cancel/Escape. Use open/onOpenChange for controlled state and
+confirmDisabled to disable confirmation. Callbacks are not awaited; the host owns
+async requests, pending UI and errors. Use Dialog for forms/complex content.
+
+
+Drawer (0.2.5) reuses Dialog's modal behavior with an edge-panel layout.
+side is logical start/end (default end) or top/bottom; size sm/md/lg sets the
+cross-axis extent to 20/26/34rem within the viewport. Vertical panels fill height,
+horizontal panels fill width. Use footer for host-owned actions; only body content
+scrolls with Flood ScrollArea. Header/close action/footer remain visible. Native
+ref, controlled open/onOpenChange, outside dismissal and initialFocusRef match
+Dialog. Translate closeLabel/title/description; reduced motion disables entry
+animation. Closing is immediate. There is no swipe/drag gesture or auto-save logic.
+
+
+The 0.2.5 separates floating surfaces from modal surfaces.
+Nine additional semantic roles bring the dark profile to 193 roles; previous token
+values remain intact. surface.floating is the opaque fallback;
+surface.floating-translucent, border.floating, selection.floating, shadow.floating
+and effect.floating blur/saturation/shadow-offset/shadow-blur define the floating
+material. Select, Combobox, MultiSelect, Menu, Popover and Tooltip share it; Dialog
+and Drawer retain surface.overlay. Backdrop filtering is progressive enhancement;
+reduced transparency uses the opaque fill and forced colors use system colors.
+Keep text opaque and evaluate it against the actual composited background.
+
+
+The 0.2.5 component expansion adds native content/typography,
+collection/form controls, navigation/layout and clipboard/notification primitives.
+See docs/base-components.md and the per-component catalog for contracts and limits.
+The CSS build assembles the original component styles into the shared stylesheet.
+
+
+Section headingLevel controls native h2–h6 semantics. Its independent headingSize
+uses the existing Heading roles (section/page/large/display), defaulting to section.
+Keep document hierarchy meaningful when changing visual emphasis.

package/dist/alert-dialog.d.ts

@@ -0,0 +1,2 @@
+import type { AlertDialogProps } from "./index.js";
+export declare const ConfirmationDialog: import("react").ForwardRefExoticComponent<AlertDialogProps & import("react").RefAttributes<HTMLDialogElement>>;

package/dist/alert-dialog.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef, useRef, useState } from "react";
+import { Button } from "./index.js";
+import { ModalOverlay } from "./overlays.js";
+export const ConfirmationDialog = forwardRef(function ConfirmationDialog({ open: controlled, defaultOpen = false, onOpenChange, onConfirm, onCancel, confirmLabel = "Continue", cancelLabel = "Cancel", confirmDisabled = false, className, ...props }, ref) {
+    const [local, setLocal] = useState(defaultOpen);
+    const cancel = useRef(null);
+    const request = (next) => {
+        if (controlled === undefined)
+            setLocal(next);
+        onOpenChange?.(next);
+    };
+    const dismiss = () => { onCancel?.(); request(false); };
+    return _jsx(ModalOverlay, { ...props, ref: ref, role: "alertdialog", open: controlled ?? local, onOpenChange: next => { if (next)
+            request(true);
+        else
+            dismiss(); }, closeOnOutsideClick: false, showCloseButton: false, initialFocusRef: cancel, className: ["flood-alert-dialog", className].filter(Boolean).join(" "), children: _jsxs("div", { className: "flood-alert-dialog__actions", children: [_jsx(Button, { ref: cancel, type: "button", variant: "subtle", onClick: dismiss, children: cancelLabel }), _jsx(Button, { type: "button", disabled: confirmDisabled, onClick: () => {
+                        if (confirmDisabled)
+                            return;
+                        onConfirm();
+                        request(false);
+                    }, children: confirmLabel })] }) });
+});

package/dist/avatar.d.ts

@@ -0,0 +1,5 @@
+/** Keyed by src in Avatar so each source starts with its own load lifecycle. */
+export declare function AvatarArtwork({ src, fallback }: {
+    src?: string;
+    fallback: string;
+}): import("react").JSX.Element;

package/dist/avatar.js

@@ -0,0 +1,8 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { Image } from "./index.js";
+/** Keyed by src in Avatar so each source starts with its own load lifecycle. */
+export function AvatarArtwork({ src, fallback }) {
+    const [state, setState] = useState("loading");
+    return _jsxs(_Fragment, { children: [_jsx("span", { className: "flood-avatar__fallback", "aria-hidden": "true", children: fallback }), src && state !== "error" && _jsx(Image, { src: src, alt: "", "aria-hidden": "true", decoding: "async", className: "flood-avatar__image", "data-ready": state === "ready", onLoad: () => setState("ready"), onError: () => setState("error") })] });
+}

package/dist/checkbox.d.ts

@@ -0,0 +1,4 @@
+import { type InputHTMLAttributes } from "react";
+export declare const MixedCheckbox: import("react").ForwardRefExoticComponent<InputHTMLAttributes<HTMLInputElement> & {
+    indeterminate: boolean;
+} & import("react").RefAttributes<HTMLInputElement>>;

package/dist/checkbox.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef, useEffect, useImperativeHandle, useLayoutEffect, useRef } from "react";
+const useBrowserLayoutEffect = typeof window === "undefined" ? useEffect : useLayoutEffect;
+export const MixedCheckbox = forwardRef(function MixedCheckbox({ indeterminate, onChange, ...props }, ref) {
+    const node = useRef(null), mixed = useRef(indeterminate);
+    useImperativeHandle(ref, () => node.current, []);
+    useBrowserLayoutEffect(() => { mixed.current = indeterminate; if (node.current)
+        node.current.indeterminate = indeterminate; });
+    return _jsx("input", { ...props, ref: node, type: "checkbox", className: "flood-check", "aria-checked": indeterminate ? "mixed" : props["aria-checked"], onChange: event => { const control = event.currentTarget; try {
+            onChange?.(event);
+        }
+        finally {
+            control.indeterminate = mixed.current;
+        } } });
+});

package/dist/combobox.d.ts

@@ -0,0 +1,11 @@
+import { type ComboboxProps } from "./index.js";
+interface SearchSelectionProps extends Omit<ComboboxProps, "value" | "defaultValue" | "onValueChange"> {
+    selectedValues?: readonly string[];
+    initialValues: readonly string[];
+    onSelectionChange?: (value: string[]) => void;
+    multiple?: boolean;
+    removeItemLabel?: string;
+}
+/** Shared search/layer model. Public single and multiple value contracts stay distinct. */
+export declare const SearchSelection: import("react").ForwardRefExoticComponent<SearchSelectionProps & import("react").RefAttributes<HTMLInputElement>>;
+export {};