pixelize-native-library 1.2.0 → 1.3.0

package/lib/typescript/modules/charts/LineChartProps.d.ts

@@ -0,0 +1,40 @@
+import type { LayoutStyle } from "../../core/style";
+import type { SeriesShape } from "./Charts.variants";
+/** One point; `x` is spaced evenly by position, not by its own value. */
+export interface LineChartDatum {
+    readonly x: string | number;
+    readonly y: number;
+}
+/** One line; non-finite `y` samples are dropped before spacing points evenly. */
+export interface LineChartSeries {
+    readonly name: string;
+    readonly data: LineChartDatum[];
+    /** Defaults to the categorical ramp color at this series' index. */
+    readonly color?: string;
+    /** Overrides the shape this series' markers (and its legend glyph) take; defaults by index. */
+    readonly shape?: SeriesShape;
+}
+/** Multi-series svg line chart with axes, optional area fill and curve smoothing. */
+export interface LineChartProps {
+    series: LineChartSeries[];
+    /** Defaults to 200. */
+    height?: number;
+    /** Defaults to true. */
+    showGrid?: boolean;
+    /** Defaults to true. */
+    showDots?: boolean;
+    /** Fills the area under each line. Defaults to false. */
+    showArea?: boolean;
+    /** Catmull-Rom-to-bezier smoothing; straight segments when false. Defaults to false. */
+    curved?: boolean;
+    /** Text legend naming each series. Only drawn for 2+ series — one line needs no key. */
+    showLegend?: boolean;
+    /** Defaults to a plain number formatter. */
+    yAxisFormatter?: (value: number) => string;
+    /** Defaults to `String(value)`. */
+    xAxisFormatter?: (value: string | number) => string;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=LineChartProps.d.ts.map

package/lib/typescript/modules/charts/PieChart.d.ts

@@ -1,18 +1,3 @@
-import type { LayoutStyle } from "../../core/style";
-export interface PieChartSegment {
-    readonly label: string;
-    readonly value: number;
-    readonly color?: string;
-}
-export interface PieChartProps {
-    segments: PieChartSegment[];
-    size?: number;
-    showLegend?: boolean;
-    showPercentages?: boolean;
-    onPressSegment?: (segment: PieChartSegment, index: number) => void;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { PieChartProps } from "./PieChartProps";
 export declare const PieChart: import("react").NamedExoticComponent<PieChartProps>;
 //# sourceMappingURL=PieChart.d.ts.map

package/lib/typescript/modules/charts/PieChartProps.d.ts

@@ -0,0 +1,24 @@
+import type { LayoutStyle } from "../../core/style";
+/** One wedge; non-finite or non-positive values are dropped before rendering. */
+export interface PieChartSegment {
+    readonly label: string;
+    readonly value: number;
+    /** Defaults to the categorical ramp color at this wedge's index. */
+    readonly color?: string;
+}
+/** Svg filled wedges with a legend — the filled sibling of `DonutChart`'s ring. */
+export interface PieChartProps {
+    segments: PieChartSegment[];
+    /** Defaults to 180. */
+    size?: number;
+    /** Defaults to true. */
+    showLegend?: boolean;
+    /** Controls only the legend row text, never on-wedge labels. Defaults to true. */
+    showPercentages?: boolean;
+    /** `index` is into the filtered, rendered wedge list — not the raw `segments` array. */
+    onPressSegment?: (segment: PieChartSegment, index: number) => void;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=PieChartProps.d.ts.map

package/lib/typescript/modules/charts/Sparkline.d.ts

@@ -1,13 +1,3 @@
-import type { LayoutStyle } from "../../core/style";
-import type { SparklineTone } from "./Charts.variants";
-export interface SparklineProps {
-    data: number[];
-    width?: number;
-    height?: number;
-    tone?: SparklineTone;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { SparklineProps } from "./SparklineProps";
 export declare const Sparkline: import("react").NamedExoticComponent<SparklineProps>;
 //# sourceMappingURL=Sparkline.d.ts.map

package/lib/typescript/modules/charts/SparklineProps.d.ts

@@ -0,0 +1,17 @@
+import type { LayoutStyle } from "../../core/style";
+import type { SparklineTone } from "./Charts.variants";
+/** Svg line and filled area under it, with a tone-driven stroke color. */
+export interface SparklineProps {
+    /** Non-finite samples are dropped; a single sample draws a flat line. */
+    data: number[];
+    /** Defaults to 120. */
+    width?: number;
+    /** Defaults to 32. */
+    height?: number;
+    /** Defaults to "accent"; a decorative stroke color, not a status signal on its own. */
+    tone?: SparklineTone;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=SparklineProps.d.ts.map

package/lib/typescript/modules/charts/index.d.ts

@@ -4,16 +4,16 @@
  * props, never by importing its internals.
  */
 export { BarList } from "./BarList";
-export type { BarListProps, BarListItem } from "./BarList";
+export type { BarListProps, BarListItem } from "./BarListProps";
 export { DonutChart } from "./DonutChart";
-export type { DonutChartProps, DonutChartSegment } from "./DonutChart";
+export type { DonutChartProps, DonutChartSegment } from "./DonutChartProps";
 export { Sparkline } from "./Sparkline";
-export type { SparklineProps } from "./Sparkline";
+export type { SparklineProps } from "./SparklineProps";
 export { BarChart } from "./BarChart";
-export type { BarChartProps, BarChartDatum, BarChartSeries } from "./BarChart";
+export type { BarChartProps, BarChartDatum, BarChartSeries } from "./BarChartProps";
 export { LineChart } from "./LineChart";
-export type { LineChartProps, LineChartDatum, LineChartSeries } from "./LineChart";
+export type { LineChartProps, LineChartDatum, LineChartSeries } from "./LineChartProps";
 export { PieChart } from "./PieChart";
-export type { PieChartProps, PieChartSegment } from "./PieChart";
+export type { PieChartProps, PieChartSegment } from "./PieChartProps";
 export type { SparklineTone } from "./Charts.variants";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/checkbox/Checkbox.d.ts

@@ -7,39 +7,7 @@
  * Motion comes from `core/motion`: the row takes `usePressMotion`, the glyph scales in when the box
  * fills, and the focus ring crossfades. All three collapse to their end state under reduce-motion.
  */
-import type { LayoutStyle } from "../../core/style";
-import type { CheckboxSize } from "./Checkbox.variants";
-interface CheckboxBaseProps {
-    checked: boolean;
-    onCheckedChange: (checked: boolean) => void;
-    /**
-     * Renders the "minus" glyph in place of "check", and reports `aria-checked` as
-     * `"mixed"` — regardless of `checked` (the usual pairing is `checked={false}`, but indeterminate
-     * always wins the glyph/state either way). Toggling still flips `checked` via `onCheckedChange`.
-     */
-    indeterminate?: boolean;
-    disabled?: boolean;
-    size?: CheckboxSize;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
-/** A checkbox with a visible label. `accessibilityLabel` defaults to `label`. Pressing the label
- * toggles too — it lives inside the same `Pressable` row as the box. */
-interface LabelledCheckboxProps extends CheckboxBaseProps {
-    label: string;
-    accessibilityLabel?: string;
-}
-/**
- * A checkbox with no visible label (e.g. a table row's select-all box). It has no visible text, so
- * `accessibilityLabel` is REQUIRED at the type level — the same trap `Button`'s icon-only shape
- * closes. `label?: never` makes the two shapes mutually exclusive.
- */
-interface UnlabelledCheckboxProps extends CheckboxBaseProps {
-    label?: never;
-    accessibilityLabel: string;
-}
-export type CheckboxProps = LabelledCheckboxProps | UnlabelledCheckboxProps;
+import type { CheckboxProps } from "./CheckboxProps";
 declare function CheckboxImpl(props: CheckboxProps): import("react").JSX.Element;
 export declare const Checkbox: import("react").MemoExoticComponent<typeof CheckboxImpl>;
 export {};

package/lib/typescript/modules/checkbox/Checkbox.variants.d.ts

@@ -16,13 +16,14 @@
  * Free of `lucide` and of any React tree, so the WCAG + behaviour tests import it directly (mocking
  * only `react-native`'s `StyleSheet`, as `core/style` and `Button.variants.ts` do).
  */
+import { MIN_TOUCH_TARGET } from "../../core/a11y/touchTarget";
 import type { RoleColors, Theme } from "../../theme/hooks";
+export { MIN_TOUCH_TARGET };
 export type CheckboxSize = "sm" | "md";
 /**
  * Same touch-target floor as `Button` (44dp, WCAG 2.5.5 AAA). Duplicated rather than imported —
  * modules never import across `src/modules/*` — so this is the component's own copy.
  */
-export declare const MIN_TOUCH_TARGET = 44;
 export interface CheckboxSizeSpec {
     /** Visual box side, in dp. */
     readonly boxSize: number;

package/lib/typescript/modules/checkbox/CheckboxProps.d.ts

@@ -0,0 +1,27 @@
+import type { LayoutStyle } from "../../core/style";
+import type { CheckboxSize } from "./Checkbox.variants";
+interface CheckboxBaseProps {
+    checked: boolean;
+    onCheckedChange: (checked: boolean) => void;
+    /** Shows a "minus" glyph and `aria-checked="mixed"`, regardless of `checked`. */
+    indeterminate?: boolean;
+    disabled?: boolean;
+    size?: CheckboxSize;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+/** Visible-label checkbox; `accessibilityLabel` defaults to `label`, and pressing the label toggles too. */
+interface LabelledCheckboxProps extends CheckboxBaseProps {
+    label: string;
+    accessibilityLabel?: string;
+}
+/** No visible label (e.g. select-all); `accessibilityLabel` is required at the type level. */
+interface UnlabelledCheckboxProps extends CheckboxBaseProps {
+    label?: never;
+    accessibilityLabel: string;
+}
+/** Labelled or unlabelled; an unlabelled box requires `accessibilityLabel`. */
+export type CheckboxProps = LabelledCheckboxProps | UnlabelledCheckboxProps;
+export {};
+//# sourceMappingURL=CheckboxProps.d.ts.map

package/lib/typescript/modules/checkbox/index.d.ts

@@ -5,6 +5,6 @@
  * internals.
  */
 export { Checkbox } from "./Checkbox";
-export type { CheckboxProps } from "./Checkbox";
+export type { CheckboxProps } from "./CheckboxProps";
 export type { CheckboxSize } from "./Checkbox.variants";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/chip/Chip.d.ts

@@ -6,33 +6,6 @@
  * selectable tags, and removable tokens — always `accessibilityRole="button"`, always a 44dp touch
  * target, never icon-only (`label` is required).
  */
-import type { IconName } from "../../core/icon";
-import type { LayoutStyle } from "../../core/style";
-import type { ChipSize, ChipTone, ChipVariant } from "./Chip.variants";
-export interface ChipProps {
-    /** A chip is never icon-only — this is its whole accessible name. */
-    label: string;
-    variant?: ChipVariant;
-    tone?: ChipTone;
-    size?: ChipSize;
-    /** Renders the filled/accented look regardless of `variant`. Only added to
-     *  `accessibilityState` when passed — see `resolveChipAccessibility`. */
-    selected?: boolean;
-    onPress?: () => void;
-    /** Provided → a trailing "x" `Pressable` that is a SIBLING of the chip's own press target, with
-     *  its own accessible name and its own 44dp hit target, so removing never fires `onPress` and a
-     *  screen reader can reach it. Omitted → no remove affordance renders. */
-    onRemove?: () => void;
-    /** Leading glyph. Ignored when `avatarUri` is also given — see `avatarUri`. */
-    icon?: IconName;
-    /** Leading circular image. Wins over `icon` when both are passed: an identity photo is a more
-     *  specific signal than a generic glyph, the same "most specific wins" precedent `Select`'s own
-     *  `leading` slot documents for the image-over-glyph case. */
-    avatarUri?: string;
-    disabled?: boolean;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { ChipProps } from "./ChipProps";
 export declare const Chip: import("react").NamedExoticComponent<ChipProps>;
 //# sourceMappingURL=Chip.d.ts.map

package/lib/typescript/modules/chip/Chip.variants.d.ts

@@ -10,16 +10,21 @@
  * Free of React and of any lucide/Pressable import, so the WCAG + behaviour tests import it directly
  * (mocking only `react-native`'s `StyleSheet`, as `core/style` does).
  */
+import { MIN_TOUCH_TARGET } from "../../core/a11y/touchTarget";
 import type { RoleColors, StatusRole, Theme } from "../../theme/hooks";
+export { MIN_TOUCH_TARGET };
 export type ChipVariant = "solid" | "outline" | "subtle";
 /** `accent`/`neutral` are brand-driven emphasis; the rest mirror the theme's status roles — same
  *  shape `Badge`'s own `BadgeTone` uses. */
-export type ChipTone = "accent" | "neutral" | StatusRole;
+export type ChipTone = "accent" | "neutral" | StatusRole | "custom";
+export type CustomToneColors = {
+    readonly bg: string;
+    readonly fg: string;
+};
 export type ChipSize = "sm" | "md";
 export type ChipGroupGap = "sm" | "md";
 /** Same touch-target floor as every interactive control in this library (44dp — Apple HIG minimum,
  *  WCAG 2.5.5 AAA). */
-export declare const MIN_TOUCH_TARGET = 44;
 export interface ChipSizeSpec {
     /** Visual height in dp. */
     readonly height: number;
@@ -83,7 +88,7 @@ export interface ChipColors {
  * pair `variant="solid"` reads — so "selected outline chip" and "solid chip" render identically
  * instead of introducing a third, separately-measured filled pairing.
  */
-export declare function resolveChipColors(colors: RoleColors, tone: ChipTone, variant: ChipVariant, selected: boolean): ChipColors;
+export declare function resolveChipColors(colors: RoleColors, tone: ChipTone, variant: ChipVariant, selected: boolean, customColors?: CustomToneColors): ChipColors;
 /** Whether a (variant, selected) combination renders the filled/accented look — the same predicate
  *  `resolveChipColors` and `Chip.tsx`'s own press-feedback branch both key off. */
 export declare function isChipFilled(variant: ChipVariant, selected: boolean): boolean;

package/lib/typescript/modules/chip/ChipGroup.d.ts

@@ -4,19 +4,6 @@
  * removal stay on each `Chip`'s own `onPress`/`onRemove`, the same "props in, events out" stance
  * every layout-only wrapper in this library takes.
  */
-import type { ReactNode } from "react";
-import type { LayoutStyle } from "../../core/style";
-import type { ChipGroupGap } from "./Chip.variants";
-export interface ChipGroupProps {
-    children: ReactNode;
-    /** Ignored when `scrollable` is true — a horizontal rail never wraps. */
-    wrap?: boolean;
-    gap?: ChipGroupGap;
-    /** Horizontal `ScrollView` (no wrap), for a filter rail that scrolls instead of wrapping. */
-    scrollable?: boolean;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { ChipGroupProps } from "./ChipGroupProps";
 export declare const ChipGroup: import("react").NamedExoticComponent<ChipGroupProps>;
 //# sourceMappingURL=ChipGroup.d.ts.map

package/lib/typescript/modules/chip/ChipGroupProps.d.ts

@@ -0,0 +1,16 @@
+import type { ReactNode } from "react";
+import type { LayoutStyle } from "../../core/style";
+import type { ChipGroupGap } from "./Chip.variants";
+/** Layout wrapper for a row of `Chip`s — owns no selection/removal state of its own. */
+export interface ChipGroupProps {
+    children: ReactNode;
+    /** Ignored when `scrollable` is true — a horizontal rail never wraps. */
+    wrap?: boolean;
+    gap?: ChipGroupGap;
+    /** Horizontal `ScrollView` (no wrap), for a filter rail that scrolls instead of wrapping. */
+    scrollable?: boolean;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=ChipGroupProps.d.ts.map

package/lib/typescript/modules/chip/ChipProps.d.ts

@@ -0,0 +1,27 @@
+import type { IconName } from "../../core/icon";
+import type { LayoutStyle } from "../../core/style";
+import type { ChipSize, ChipTone, ChipVariant, CustomToneColors } from "./Chip.variants";
+/** An interactive token: press to select/toggle, with an optional trailing remove control. */
+export interface ChipProps {
+    /** A chip is never icon-only — this is its whole accessible name. */
+    label: string;
+    variant?: ChipVariant;
+    tone?: ChipTone;
+    /** Required when `tone="custom"`. */
+    customColors?: CustomToneColors;
+    size?: ChipSize;
+    /** Renders the filled/accented look regardless of `variant`. */
+    selected?: boolean;
+    onPress?: () => void;
+    /** Adds a trailing remove button; omitted, no remove affordance renders. */
+    onRemove?: () => void;
+    /** Leading glyph; ignored when `avatarUri` is also given. */
+    icon?: IconName;
+    /** Leading circular image; wins over `icon` when both are passed. */
+    avatarUri?: string;
+    disabled?: boolean;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=ChipProps.d.ts.map

package/lib/typescript/modules/chip/index.d.ts

@@ -4,9 +4,9 @@
  * consumer configures a Chip through its props, never by importing its internals.
  */
 export { Chip } from "./Chip";
-export type { ChipProps } from "./Chip";
+export type { ChipProps } from "./ChipProps";
 export { ChipGroup } from "./ChipGroup";
-export type { ChipGroupProps } from "./ChipGroup";
-export type { ChipGroupGap, ChipSize, ChipTone, ChipVariant } from "./Chip.variants";
+export type { ChipGroupProps } from "./ChipGroupProps";
+export type { ChipGroupGap, ChipSize, ChipTone, ChipVariant, CustomToneColors } from "./Chip.variants";
 export type { IconName } from "../../core/icon";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/combobox/Combobox.d.ts

@@ -30,52 +30,9 @@
  * a border swap AND a ring would double-signal the same state, so the trigger border here is
  * `error`-driven only (see `Combobox.variants.ts`).
  */
-import type { LayoutStyle } from "../../core/style";
 import type { ComboboxOption } from "./Combobox.variants";
+import type { ComboboxProps } from "./ComboboxProps";
 export type { ComboboxOption };
-interface ComboboxCommonProps {
-    options: ComboboxOption[];
-    placeholder?: string;
-    searchPlaceholder?: string;
-    label?: string;
-    disabled?: boolean;
-    /** Shown below the field; announced on both platforms via `useAnnounce`. */
-    error?: string;
-    /** Shows an "x" on the field once something is selected. */
-    clearable?: boolean;
-    /** Swaps the option list for a centered `Spinner` — the list area, not the search field. */
-    loading?: boolean;
-    emptyMessage?: string;
-    /**
-     * Presence signals SERVER-side filtering: once provided, `Combobox` renders `options` verbatim and
-     * never filters locally, even if `filterFn` is also passed. Absent (the default) means local
-     * filtering. Debounced by `SEARCH_DEBOUNCE_MS`. This is the prop most likely to be misused —
-     * passing it does not add server-side filtering on top of local filtering, it REPLACES it.
-     */
-    onSearchChange?: (query: string) => void;
-    /** Overrides local filtering. Ignored entirely when `onSearchChange` is set. Default is
-     *  `defaultComboboxFilter` (case- and diacritic-insensitive substring match on `label`). */
-    filterFn?: (option: ComboboxOption, query: string) => boolean;
-    maxHeight?: number;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
-export interface ComboboxSingleProps extends ComboboxCommonProps {
-    multiple?: false;
-    value: string | null;
-    onChange: (value: string | null) => void;
-}
-export interface ComboboxMultipleProps extends ComboboxCommonProps {
-    multiple: true;
-    values: string[];
-    onValuesChange: (values: string[]) => void;
-}
-/**
- * A discriminated union, not one flat interface with every field optional: `multiple: true` requires
- * `values`/`onValuesChange`, the default (`multiple` absent/`false`) requires `value`/`onChange` — a
- * caller can never wire the wrong pair for the active mode and have it silently do nothing.
- */
-export type ComboboxProps = ComboboxSingleProps | ComboboxMultipleProps;
+export type { ComboboxSingleProps, ComboboxMultipleProps, ComboboxProps } from "./ComboboxProps";
 export declare const Combobox: import("react").NamedExoticComponent<ComboboxProps>;
 //# sourceMappingURL=Combobox.d.ts.map

package/lib/typescript/modules/combobox/Combobox.variants.d.ts

@@ -22,6 +22,7 @@
  * Free of React and of any `Modal`/`Pressable`/`TextInput` import, so the WCAG + logic tests import
  * this directly (mocking only `react-native`'s `StyleSheet`, as `core/style` does).
  */
+import { MIN_TOUCH_TARGET } from "../../core/a11y/touchTarget";
 import type { AccessibilityRole } from "react-native";
 import type { RoleColors, Theme } from "../../theme/hooks";
 import type { IconName } from "../../core/icon";
@@ -30,10 +31,10 @@ export interface ComboboxOption {
     readonly label: string;
     readonly icon?: IconName;
     readonly description?: string;
+    /** Blocks selection and dims the row; the option still appears in the list. */
     readonly disabled?: boolean;
 }
 /** Same touch-target floor as Button/Select/Input (44dp — Apple HIG minimum, WCAG 2.5.5 AAA). */
-export declare const MIN_TOUCH_TARGET = 44;
 /** No `size` prop (unlike Select/MultiSelect) — not part of this module's spec, and a search sheet's
  *  proportions don't benefit from the sm/lg range those triggers offer. One fixed box, sized exactly
  *  like Input's/Select's `md`, so a Combobox lines up with either in the same form. */
@@ -64,6 +65,7 @@ export declare const FILTER_DEBOUNCE_MS = 140;
  * Strips combining diacritical marks after Unicode NFD decomposition, so "José" and "jose" match the
  * same query. Lowercased last so the comparison is also case-insensitive.
  */
+export { MIN_TOUCH_TARGET };
 export declare function normalizeForSearch(value: string): string;
 /**
  * The option list's container role — what makes `aria-activedescendant` on the search field mean
@@ -73,6 +75,15 @@ export declare function normalizeForSearch(value: string): string;
  * `role` verbatim, and native maps roles it doesn't know to nothing.
  */
 export declare const COMBOBOX_LISTBOX_ROLE: AccessibilityRole;
+/**
+ * Each option row's role. `aria-selected` is only valid ARIA on `option`/`row`/`tab`/`gridcell`/
+ * `treeitem` — the row sits inside a `COMBOBOX_LISTBOX_ROLE` container, so `option` is the
+ * textbook-correct pairing (2026-08 sweep fixed the row from the invalid `menuitem`+`aria-selected`
+ * combination — a followup to `select/Select.tsx`'s identical fix, both listbox/option/aria-selected
+ * per the ARIA 1.2 combobox-with-listbox-popup pattern). Same type gap as `COMBOBOX_LISTBOX_ROLE`:
+ * RN 0.86's `AccessibilityRole` union has no `option` either.
+ */
+export declare const COMBOBOX_OPTION_ROLE: AccessibilityRole;
 /**
  * The DOM id of one option row. `aria-activedescendant` and `nativeID` must agree exactly, and
  * every `aria-*` prop is UNCHECKED by TypeScript on an RN component (hyphenated JSX attributes are
@@ -136,6 +147,8 @@ export interface ComboboxRowColors {
     /** The option `description` line, the search placeholder, and the empty-state message — all the
      *  muted-text pairings, sharing one measured rung. */
     readonly muted: string;
+    /** Hint ink for the row's own field — a hint, not body copy. */
+    readonly placeholder: string;
     /** Leading option icon, the search glyph, and the clear-row icon. */
     readonly icon: string;
     /** The selected row's "check" glyph. Same value as `text`: if the label clears the stricter 4.5:1
@@ -171,7 +184,7 @@ export interface ComboboxRowAccessibilityInput {
     readonly disabled: boolean;
 }
 export interface ComboboxRowAccessibilityProps {
-    readonly accessibilityRole: "menuitem";
+    readonly accessibilityRole: AccessibilityRole;
     /** Flat, never `accessibilityState`: react-native-web discards the object form (see
      *  `docs/PLATFORM-A11Y-PROPS.md`). Quoted keys so the compiler still checks the prop names. */
     readonly "aria-selected": boolean;
@@ -179,9 +192,11 @@ export interface ComboboxRowAccessibilityProps {
     readonly disabled: boolean;
 }
 /**
- * Every row is `menuitem` (matching this library's `Menu`), in BOTH single and multiple mode — the
- * spec this module was built against fixes this role regardless of mode, unlike `MultiSelect`'s own
- * `checkbox` rows. Selection state rides `aria-selected`, never `aria-checked`.
+ * Every row is `option` (2026-08 sweep — was `menuitem`, which made `aria-selected` invalid ARIA;
+ * the row sits inside `COMBOBOX_LISTBOX_ROLE`, so `option` is the textbook-correct pairing), in BOTH
+ * single and multiple mode: this module's `aria-activedescendant` pattern is one listbox regardless
+ * of mode, unlike `MultiSelect`'s own separate `checkbox` rows. Selection state rides `aria-selected`,
+ * never `aria-checked`.
  */
 export declare function resolveComboboxRowAccessibility(input: ComboboxRowAccessibilityInput): ComboboxRowAccessibilityProps;
 /**

package/lib/typescript/modules/combobox/ComboboxProps.d.ts

@@ -0,0 +1,40 @@
+import type { LayoutStyle } from "../../core/style";
+import type { ComboboxOption } from "./Combobox.variants";
+interface ComboboxCommonProps {
+    options: ComboboxOption[];
+    placeholder?: string;
+    searchPlaceholder?: string;
+    label?: string;
+    disabled?: boolean;
+    /** Shown below the field; announced on both platforms via `useAnnounce`. */
+    error?: string;
+    /** Shows an "x" on the field once something is selected. */
+    clearable?: boolean;
+    /** Swaps the option list for a centered `Spinner`, not the search field. */
+    loading?: boolean;
+    emptyMessage?: string;
+    /** Signals server-side filtering — REPLACES local filtering, not added on top of it. */
+    onSearchChange?: (query: string) => void;
+    /** Ignored once `onSearchChange` is set; overrides the default local substring filter. */
+    filterFn?: (option: ComboboxOption, query: string) => boolean;
+    maxHeight?: number;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+/** Single-select mode — `value` is one option value. */
+export interface ComboboxSingleProps extends ComboboxCommonProps {
+    multiple?: false;
+    value: string | null;
+    onChange: (value: string | null) => void;
+}
+/** Multi-select mode — `value` is the array of selected option values. */
+export interface ComboboxMultipleProps extends ComboboxCommonProps {
+    multiple: true;
+    values: string[];
+    onValuesChange: (values: string[]) => void;
+}
+/** Discriminated union — `multiple: true` requires `values`/`onValuesChange`, not `value`/`onChange`. */
+export type ComboboxProps = ComboboxSingleProps | ComboboxMultipleProps;
+export {};
+//# sourceMappingURL=ComboboxProps.d.ts.map

package/lib/typescript/modules/combobox/index.d.ts

@@ -5,7 +5,7 @@
  * internals.
  */
 export { Combobox } from "./Combobox";
-export type { ComboboxProps, ComboboxSingleProps, ComboboxMultipleProps } from "./Combobox";
+export type { ComboboxProps, ComboboxSingleProps, ComboboxMultipleProps } from "./ComboboxProps";
 export type { ComboboxOption } from "./Combobox.variants";
 export type { IconName } from "../../core/icon";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/composer/Composer.d.ts

@@ -6,23 +6,6 @@
  * a `border.focus` ring a small gap outside the field, on the canvas, where that token is the one
  * proven ≥ 3:1.
  */
-import type { LayoutStyle } from "../../core/style";
-export interface ComposerProps {
-    value: string;
-    onChangeText: (text: string) => void;
-    onSend: () => void;
-    placeholder?: string;
-    /**
-     * The field's accessible name. Defaults to `placeholder`, which is the only text this component
-     * renders — but a placeholder is not a label (it disappears the moment there is a value), so a
-     * caller with more than one composer on screen needs to be able to name them apart.
-     */
-    accessibilityLabel?: string;
-    disabled?: boolean;
-    sending?: boolean;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { ComposerProps } from "./ComposerProps";
 export declare const Composer: import("react").NamedExoticComponent<ComposerProps>;
 //# sourceMappingURL=Composer.d.ts.map

package/lib/typescript/modules/composer/ComposerProps.d.ts

@@ -0,0 +1,20 @@
+import type { LayoutStyle } from "../../core/style";
+/** Chat message input row with a multiline field and send button. */
+export interface ComposerProps {
+    value: string;
+    onChangeText: (text: string) => void;
+    /** Only invoked when the trimmed `value` is non-empty and the field is editable. */
+    onSend: () => void;
+    /** Defaults to "Message". */
+    placeholder?: string;
+    /** Defaults to `placeholder`, which disappears once there is a value. */
+    accessibilityLabel?: string;
+    /** Disables the input and send button. */
+    disabled?: boolean;
+    /** Shows a spinner in place of the send icon and disables the field. */
+    sending?: boolean;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=ComposerProps.d.ts.map

package/lib/typescript/modules/composer/index.d.ts

@@ -1,3 +1,3 @@
 export { Composer } from "./Composer";
-export type { ComposerProps } from "./Composer";
+export type { ComposerProps } from "./ComposerProps";
 //# sourceMappingURL=index.d.ts.map