@skdx/react 0.28.0 → 0.29.0

package/dist/transfer/TransferMoveAllTrigger.d.cts

@@ -1,13 +1,14 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { TransferMoveAllTriggerProps } from './types.cjs';
 /**
- * Moves every currently visible item on one side. While `searchable`, moves
- * only filtered items, never those hidden by an active query. Disabled items
- * are excluded from both the name and the move.
+ * Moves every currently visible item on one side, excluding disabled items and any hidden by an active search query.
  *
  * @example
  * ```tsx
  * <TransferMoveAllTrigger direction="toTarget">⇒</TransferMoveAllTrigger>
  * ```
  */
-export declare const TransferMoveAllTrigger: React.ForwardRefExoticComponent<Omit<TransferMoveAllTriggerProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+export declare const TransferMoveAllTrigger: {
+    ({ direction, ref: forwardedRef, ...props }: TransferMoveAllTriggerProps): React.ReactNode;
+    displayName: string;
+};

package/dist/transfer/TransferMoveAllTrigger.d.ts

@@ -1,13 +1,14 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { TransferMoveAllTriggerProps } from './types.js';
 /**
- * Moves every currently visible item on one side. While `searchable`, moves
- * only filtered items, never those hidden by an active query. Disabled items
- * are excluded from both the name and the move.
+ * Moves every currently visible item on one side, excluding disabled items and any hidden by an active search query.
  *
  * @example
  * ```tsx
  * <TransferMoveAllTrigger direction="toTarget">⇒</TransferMoveAllTrigger>
  * ```
  */
-export declare const TransferMoveAllTrigger: React.ForwardRefExoticComponent<Omit<TransferMoveAllTriggerProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+export declare const TransferMoveAllTrigger: {
+    ({ direction, ref: forwardedRef, ...props }: TransferMoveAllTriggerProps): React.ReactNode;
+    displayName: string;
+};

package/dist/transfer/TransferMoveTrigger.d.cts

@@ -1,26 +1,14 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { TransferMoveTriggerProps } from './types.cjs';
 /**
- * The button that moves the marked items one way. A real `<button>` in the tab
- * order, named for what it does and how much of it — "Move 3 items to
- * selected", not an unnamed arrow glyph.
- *
- * With nothing marked it is **`aria-disabled`, not `disabled`**. A truly
- * disabled button is skipped by Tab, so a keyboard user exploring the widget
- * never meets the control that explains the whole interaction, and would be
- * left guessing why selecting things in a list appears to do nothing. Kept
- * focusable, it announces "Move items to selected, nothing selected" — the
- * instruction and the reason in one. Pressing it is a no-op.
- *
- * Publishes `data-direction` (the logical `'toTarget'`/`'toSource'`),
- * `data-count`, and `data-disabled`. Direction is deliberately never published
- * as left/right: under `dir="rtl"` the target list is on the left, so style the
- * glyph from `[dir='rtl'] [data-direction='toTarget']` rather than expecting a
- * physical attribute here.
+ * Button that moves the marked items one way, kept `aria-disabled` rather than `disabled` with nothing marked so it stays reachable and named, publishing `data-direction`, `data-count` and `data-disabled`.
  *
  * @example
  * ```tsx
  * <TransferMoveTrigger direction="toTarget">→</TransferMoveTrigger>
  * ```
  */
-export declare const TransferMoveTrigger: React.ForwardRefExoticComponent<Omit<TransferMoveTriggerProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+export declare const TransferMoveTrigger: {
+    ({ direction, ref: forwardedRef, ...props }: TransferMoveTriggerProps): React.ReactNode;
+    displayName: string;
+};

package/dist/transfer/TransferMoveTrigger.d.ts

@@ -1,26 +1,14 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { TransferMoveTriggerProps } from './types.js';
 /**
- * The button that moves the marked items one way. A real `<button>` in the tab
- * order, named for what it does and how much of it — "Move 3 items to
- * selected", not an unnamed arrow glyph.
- *
- * With nothing marked it is **`aria-disabled`, not `disabled`**. A truly
- * disabled button is skipped by Tab, so a keyboard user exploring the widget
- * never meets the control that explains the whole interaction, and would be
- * left guessing why selecting things in a list appears to do nothing. Kept
- * focusable, it announces "Move items to selected, nothing selected" — the
- * instruction and the reason in one. Pressing it is a no-op.
- *
- * Publishes `data-direction` (the logical `'toTarget'`/`'toSource'`),
- * `data-count`, and `data-disabled`. Direction is deliberately never published
- * as left/right: under `dir="rtl"` the target list is on the left, so style the
- * glyph from `[dir='rtl'] [data-direction='toTarget']` rather than expecting a
- * physical attribute here.
+ * Button that moves the marked items one way, kept `aria-disabled` rather than `disabled` with nothing marked so it stays reachable and named, publishing `data-direction`, `data-count` and `data-disabled`.
  *
  * @example
  * ```tsx
  * <TransferMoveTrigger direction="toTarget">→</TransferMoveTrigger>
  * ```
  */
-export declare const TransferMoveTrigger: React.ForwardRefExoticComponent<Omit<TransferMoveTriggerProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+export declare const TransferMoveTrigger: {
+    ({ direction, ref: forwardedRef, ...props }: TransferMoveTriggerProps): React.ReactNode;
+    displayName: string;
+};

package/dist/transfer/index.d.cts

@@ -1,2 +1,2 @@
 export { Transfer } from './Transfer.cjs';
-export type { TransferDirection, TransferFilterMatchMode, TransferItemData, TransferListScrollDetail, TransferMoveDetail, TransferProps, TransferSearchResultsDetail, TransferTargetOrder, TransferTitles, } from './types.cjs';
+export type { TransferDirection, TransferFilterMatchMode, TransferItemData, TransferListScrollDetail, TransferMoveDetail, TransferMoveEventDetail, TransferProps, TransferSearchResultsDetail, TransferTargetOrder, TransferTitles, } from './types.cjs';

package/dist/transfer/index.d.ts

@@ -1,2 +1,2 @@
 export { Transfer } from './Transfer.js';
-export type { TransferDirection, TransferFilterMatchMode, TransferItemData, TransferListScrollDetail, TransferMoveDetail, TransferProps, TransferSearchResultsDetail, TransferTargetOrder, TransferTitles, } from './types.js';
+export type { TransferDirection, TransferFilterMatchMode, TransferItemData, TransferListScrollDetail, TransferMoveDetail, TransferMoveEventDetail, TransferProps, TransferSearchResultsDetail, TransferTargetOrder, TransferTitles, } from './types.js';

package/dist/transfer/types.d.cts

@@ -18,7 +18,7 @@ export interface TransferItemData {
      * Excludes item from selection, navigation, and moves.
      * @default undefined — item behaves normally.
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
 }
 /** @internal Shared state distributed from {@link Transfer} to its parts via context. Not part of the public API. */
 export interface TransferContextValue {
@@ -39,19 +39,26 @@ export interface TransferContextValue {
     active: Record<TransferSide, string | null>;
     setActive: (side: TransferSide, value: string | null) => void;
     /** Range-selection anchor per side (last option marked without Shift). */
-    anchor: React.MutableRefObject<Record<TransferSide, string | null>>;
+    anchorRef: React.RefObject<Record<TransferSide, string | null>>;
     /** Whether `TransferListHeader` is mounted (decides `aria-labelledby` vs `aria-label`). */
     labelled: Record<TransferSide, boolean>;
     registerHeader: (side: TransferSide, present: boolean) => void;
     registerList: (side: TransferSide, node: HTMLDivElement | null) => void;
     /** Flag to suppress `focusin` being mistaken for external Tab after programmatic focus. */
-    suppressFocusIn: React.MutableRefObject<boolean>;
+    suppressFocusInRef: React.RefObject<boolean>;
     /** Moves values, announces outcome, and re-places focus; silently drops disabled items. */
     move: (direction: TransferDirection, values: string[]) => void;
     /** Accessible name for move triggers (from `getMoveLabel` or built-in English). */
     moveLabel: (count: number, direction: TransferDirection, all: boolean) => string;
     emitListScroll: (side: TransferSide, list: HTMLElement) => void;
 }
+/** The payload {@link TransferProps.onMove} receives: the items that moved and which way they went. */
+export interface TransferMoveEventDetail {
+    /** The items that actually moved; disabled ones are dropped before the move. */
+    items: TransferItemData[];
+    /** Which way they went. */
+    direction: TransferDirection;
+}
 /** Move outcome, handed to {@link TransferProps.getMoveAnnouncement} for wording. */
 export interface TransferMoveDetail {
     /** How many items moved (disabled items never counted). */
@@ -92,118 +99,133 @@ export interface TransferProps extends Omit<PrimitivePropsWithRef<'div'>, 'onCha
      * Manually-composed parts; omitted, derives headed searchable lists from `titles` and `renderItem`.
      * @default undefined — derives anatomy.
      */
-    children?: React.ReactNode;
+    children?: React.ReactNode | undefined;
     /** Entire collection; both sides are derived from this plus `value`. */
     items: TransferItemData[];
     /**
      * Target-side ids for controlled usage; pair with `onValueChange`.
      * @default undefined — uncontrolled.
      */
-    value?: string[];
+    value?: string[] | undefined;
     /**
      * Initial target-side ids for uncontrolled usage.
      * @default undefined — all items start on source.
      */
-    defaultValue?: string[];
+    defaultValue?: string[] | undefined;
     /**
      * Fires with new target-side ids whenever items move.
      * @default undefined — no-op.
      */
-    onValueChange?: (value: string[]) => void;
+    onValueChange?: ((value: string[]) => void) | undefined;
     /**
-     * Fires alongside `onValueChange` with moved items and direction.
+     * Fires alongside `onValueChange` with the moved items and which way they went.
      * @default undefined — no-op.
      */
-    onMove?: (items: TransferItemData[], direction: TransferDirection) => void;
+    onMove?: ((detail: TransferMoveEventDetail) => void) | undefined;
     /**
      * Disables both lists and all move triggers; individual items have their own `disabled`.
      * @default false
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
     /**
      * Form field name; target-side ids submit as separate entries (not joined).
      * @default undefined — submits nothing.
      */
-    name?: string;
+    name?: string | undefined;
     /**
      * Form id for the submitted entries when Transfer is outside the form.
      * @default undefined — entries belong to nearest ancestor form.
      */
-    form?: string;
+    form?: string | undefined;
     /**
      * Enables per-list filtering; while false, `TransferListSearch` renders nothing.
      * @default false
      */
-    searchable?: boolean;
+    searchable?: boolean | undefined;
     /**
      * Custom filter; returns true if item survives query. Only consulted when `searchable`.
      * @default undefined — case-insensitive substring match.
      */
-    filter?: (item: TransferItemData, query: string) => boolean;
+    filter?: ((item: TransferItemData, query: string) => boolean) | undefined;
     /**
      * How built-in matcher compares queries to labels; ignored if `filter` is given.
      * @default 'contains'
      */
-    filterMatchMode?: TransferFilterMatchMode;
+    filterMatchMode?: TransferFilterMatchMode | undefined;
     /**
      * Words move-trigger accessible names (count is items to move, including zero).
      * @default undefined — built-in English.
      */
-    getMoveLabel?: (count: number, direction: TransferDirection, all: boolean) => string;
+    getMoveLabel?: ((count: number, direction: TransferDirection, all: boolean) => string) | undefined;
     /**
      * Words the polite live-region announcement after moves (return empty string to silence).
      * @default undefined — built-in English.
      */
-    getMoveAnnouncement?: (detail: TransferMoveDetail) => string;
+    getMoveAnnouncement?: ((detail: TransferMoveDetail) => string) | undefined;
     /**
      * Words the polite live-region announcement when search settles per side (return empty to silence).
      * @default undefined — built-in English.
      */
-    getSearchResultsAnnouncement?: (detail: TransferSearchResultsDetail) => string;
+    getSearchResultsAnnouncement?: ((detail: TransferSearchResultsDetail) => string) | undefined;
     /**
      * Where items land on target: `'items'` keeps collection order; `'append'` / `'prepend'` follow moves.
      * @default 'items'
      */
-    targetOrder?: TransferTargetOrder;
+    targetOrder?: TransferTargetOrder | undefined;
     /**
      * Fires on either list scroll with geometry for infinite-scroll loading.
      * @default undefined — no-op.
      */
-    onListScroll?: (detail: TransferListScrollDetail) => void;
+    onListScroll?: ((detail: TransferListScrollDetail) => void) | undefined;
     /**
      * Heading text for derived `TransferListHeader`s. Ignored when `children` given.
      * @default { source: 'Available items', target: 'Selected items' }
      */
-    titles?: TransferTitles;
+    titles?: TransferTitles | undefined;
     /**
      * Text for derived `TransferEmpty` states (`{query}` replaced with search text).
      * @default { empty: 'Nothing here.', noMatch: 'No match for "{query}".' }
      */
-    emptyText?: TransferEmptyText;
+    emptyText?: TransferEmptyText | undefined;
     /**
      * Whether derived `TransferControls` include a move-all trigger (off by default due to destructiveness).
      * @default false
      */
-    showMoveAll?: boolean;
+    showMoveAll?: boolean | undefined;
     /**
      * Renders derived `TransferItem` content instead of `label`. Ignored when `children` given.
      * @default undefined — each item renders its `label`.
      */
-    renderItem?: (item: TransferItemData) => React.ReactNode;
+    renderItem?: ((item: TransferItemData) => React.ReactNode) | undefined;
+    /**
+     * Spacing rung the skin packs the rows by, fed to both derived lists.
+     * @default undefined — the skin's own default spacing.
+     */
+    density?: 'compact' | (string & {}) | undefined;
+    /**
+     * Corner rung the skin rounds the lists by, fed to both derived lists.
+     * @default undefined — the skin's own default corner.
+     */
+    shape?: 'square' | 'rounded' | (string & {}) | undefined;
+    /**
+     * Size rung the skin scales the lists by, fed to both derived lists.
+     * @default undefined — the skin's own default size.
+     */
+    size?: 'sm' | 'lg' | (string & {}) | undefined;
 }
 /** Text for empty states. See {@link TransferProps.emptyText}. */
 export interface TransferEmptyText {
     /** Shown when side holds no items. @default 'Nothing here.' */
-    empty?: string;
+    empty?: string | undefined;
     /** Shown when search filters all items (`{query}` replaced). @default 'No match for "{query}".' */
-    noMatch?: string;
+    noMatch?: string | undefined;
 }
 /** List headings for derived anatomy. See {@link TransferProps.titles}. */
 export interface TransferTitles {
     /** Source (available) list heading. @default 'Available items' */
-    source?: string;
+    source?: string | undefined;
     /** Target (selected) list heading. @default 'Selected items' */
-    target?: string;
+    target?: string | undefined;
 }
 /** @internal Wiring passed from a {@link TransferList} to the {@link TransferItem}s inside it. Not part of the public API. */
 export interface TransferListContextValue {
@@ -217,12 +239,27 @@ export interface TransferListProps extends Omit<PrimitivePropsWithRef<'div'>, 'o
      * Renders derived `TransferItem` content instead of `label`. Ignored when `children` given.
      * @default undefined — each item renders its `label`.
      */
-    renderItem?: (item: TransferItemData) => React.ReactNode;
+    renderItem?: ((item: TransferItemData) => React.ReactNode) | undefined;
     /**
      * Custom `TransferItem`s to override the default rendering of items.
      * @default undefined — one `TransferItem` per visible item, using `label` as content.
      */
-    children?: React.ReactNode;
+    children?: React.ReactNode | undefined;
+    /**
+     * Spacing rung the skin packs this list by, mirrored to `data-density`.
+     * @default undefined — the skin's own default spacing.
+     */
+    density?: 'compact' | (string & {}) | undefined;
+    /**
+     * Corner rung the skin rounds this list by, mirrored to `data-shape`.
+     * @default undefined — the skin's own default corner.
+     */
+    shape?: 'square' | 'rounded' | (string & {}) | undefined;
+    /**
+     * Size rung the skin scales this list by, mirrored to `data-size`.
+     * @default undefined — the skin's own default size.
+     */
+    size?: 'sm' | 'lg' | (string & {}) | undefined;
 }
 /** Props for {@link TransferListHeader}, the heading naming one list. */
 export interface TransferListHeaderProps extends PrimitivePropsWithRef<'div'> {
@@ -242,12 +279,12 @@ export interface TransferItemProps extends PrimitivePropsWithRef<'div'> {
      * Excludes option from marking, navigation, and moves.
      * @default false
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
     /**
      * Text typeahead matches against, published as `data-text-value`.
      * @default undefined — falls back to rendered text content.
      */
-    textValue?: string;
+    textValue?: string | undefined;
 }
 /** Props for {@link TransferControls}, the named group holding the move triggers. */
 export interface TransferControlsProps extends PrimitivePropsWithRef<'div'> {
@@ -270,5 +307,5 @@ export interface TransferEmptyProps extends Omit<PrimitivePropsWithRef<'div'>, '
      * Message; pass function to differentiate empty vs no-results (published as `data-reason` / `data-query`).
      * @default undefined — renders element only.
      */
-    children?: React.ReactNode | ((context: TransferEmptyContext) => React.ReactNode);
+    children?: React.ReactNode | ((context: TransferEmptyContext) => React.ReactNode) | undefined;
 }

package/dist/transfer/types.d.ts

@@ -18,7 +18,7 @@ export interface TransferItemData {
      * Excludes item from selection, navigation, and moves.
      * @default undefined — item behaves normally.
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
 }
 /** @internal Shared state distributed from {@link Transfer} to its parts via context. Not part of the public API. */
 export interface TransferContextValue {
@@ -39,19 +39,26 @@ export interface TransferContextValue {
     active: Record<TransferSide, string | null>;
     setActive: (side: TransferSide, value: string | null) => void;
     /** Range-selection anchor per side (last option marked without Shift). */
-    anchor: React.MutableRefObject<Record<TransferSide, string | null>>;
+    anchorRef: React.RefObject<Record<TransferSide, string | null>>;
     /** Whether `TransferListHeader` is mounted (decides `aria-labelledby` vs `aria-label`). */
     labelled: Record<TransferSide, boolean>;
     registerHeader: (side: TransferSide, present: boolean) => void;
     registerList: (side: TransferSide, node: HTMLDivElement | null) => void;
     /** Flag to suppress `focusin` being mistaken for external Tab after programmatic focus. */
-    suppressFocusIn: React.MutableRefObject<boolean>;
+    suppressFocusInRef: React.RefObject<boolean>;
     /** Moves values, announces outcome, and re-places focus; silently drops disabled items. */
     move: (direction: TransferDirection, values: string[]) => void;
     /** Accessible name for move triggers (from `getMoveLabel` or built-in English). */
     moveLabel: (count: number, direction: TransferDirection, all: boolean) => string;
     emitListScroll: (side: TransferSide, list: HTMLElement) => void;
 }
+/** The payload {@link TransferProps.onMove} receives: the items that moved and which way they went. */
+export interface TransferMoveEventDetail {
+    /** The items that actually moved; disabled ones are dropped before the move. */
+    items: TransferItemData[];
+    /** Which way they went. */
+    direction: TransferDirection;
+}
 /** Move outcome, handed to {@link TransferProps.getMoveAnnouncement} for wording. */
 export interface TransferMoveDetail {
     /** How many items moved (disabled items never counted). */
@@ -92,118 +99,133 @@ export interface TransferProps extends Omit<PrimitivePropsWithRef<'div'>, 'onCha
      * Manually-composed parts; omitted, derives headed searchable lists from `titles` and `renderItem`.
      * @default undefined — derives anatomy.
      */
-    children?: React.ReactNode;
+    children?: React.ReactNode | undefined;
     /** Entire collection; both sides are derived from this plus `value`. */
     items: TransferItemData[];
     /**
      * Target-side ids for controlled usage; pair with `onValueChange`.
      * @default undefined — uncontrolled.
      */
-    value?: string[];
+    value?: string[] | undefined;
     /**
      * Initial target-side ids for uncontrolled usage.
      * @default undefined — all items start on source.
      */
-    defaultValue?: string[];
+    defaultValue?: string[] | undefined;
     /**
      * Fires with new target-side ids whenever items move.
      * @default undefined — no-op.
      */
-    onValueChange?: (value: string[]) => void;
+    onValueChange?: ((value: string[]) => void) | undefined;
     /**
-     * Fires alongside `onValueChange` with moved items and direction.
+     * Fires alongside `onValueChange` with the moved items and which way they went.
      * @default undefined — no-op.
      */
-    onMove?: (items: TransferItemData[], direction: TransferDirection) => void;
+    onMove?: ((detail: TransferMoveEventDetail) => void) | undefined;
     /**
      * Disables both lists and all move triggers; individual items have their own `disabled`.
      * @default false
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
     /**
      * Form field name; target-side ids submit as separate entries (not joined).
      * @default undefined — submits nothing.
      */
-    name?: string;
+    name?: string | undefined;
     /**
      * Form id for the submitted entries when Transfer is outside the form.
      * @default undefined — entries belong to nearest ancestor form.
      */
-    form?: string;
+    form?: string | undefined;
     /**
      * Enables per-list filtering; while false, `TransferListSearch` renders nothing.
      * @default false
      */
-    searchable?: boolean;
+    searchable?: boolean | undefined;
     /**
      * Custom filter; returns true if item survives query. Only consulted when `searchable`.
      * @default undefined — case-insensitive substring match.
      */
-    filter?: (item: TransferItemData, query: string) => boolean;
+    filter?: ((item: TransferItemData, query: string) => boolean) | undefined;
     /**
      * How built-in matcher compares queries to labels; ignored if `filter` is given.
      * @default 'contains'
      */
-    filterMatchMode?: TransferFilterMatchMode;
+    filterMatchMode?: TransferFilterMatchMode | undefined;
     /**
      * Words move-trigger accessible names (count is items to move, including zero).
      * @default undefined — built-in English.
      */
-    getMoveLabel?: (count: number, direction: TransferDirection, all: boolean) => string;
+    getMoveLabel?: ((count: number, direction: TransferDirection, all: boolean) => string) | undefined;
     /**
      * Words the polite live-region announcement after moves (return empty string to silence).
      * @default undefined — built-in English.
      */
-    getMoveAnnouncement?: (detail: TransferMoveDetail) => string;
+    getMoveAnnouncement?: ((detail: TransferMoveDetail) => string) | undefined;
     /**
      * Words the polite live-region announcement when search settles per side (return empty to silence).
      * @default undefined — built-in English.
      */
-    getSearchResultsAnnouncement?: (detail: TransferSearchResultsDetail) => string;
+    getSearchResultsAnnouncement?: ((detail: TransferSearchResultsDetail) => string) | undefined;
     /**
      * Where items land on target: `'items'` keeps collection order; `'append'` / `'prepend'` follow moves.
      * @default 'items'
      */
-    targetOrder?: TransferTargetOrder;
+    targetOrder?: TransferTargetOrder | undefined;
     /**
      * Fires on either list scroll with geometry for infinite-scroll loading.
      * @default undefined — no-op.
      */
-    onListScroll?: (detail: TransferListScrollDetail) => void;
+    onListScroll?: ((detail: TransferListScrollDetail) => void) | undefined;
     /**
      * Heading text for derived `TransferListHeader`s. Ignored when `children` given.
      * @default { source: 'Available items', target: 'Selected items' }
      */
-    titles?: TransferTitles;
+    titles?: TransferTitles | undefined;
     /**
      * Text for derived `TransferEmpty` states (`{query}` replaced with search text).
      * @default { empty: 'Nothing here.', noMatch: 'No match for "{query}".' }
      */
-    emptyText?: TransferEmptyText;
+    emptyText?: TransferEmptyText | undefined;
     /**
      * Whether derived `TransferControls` include a move-all trigger (off by default due to destructiveness).
      * @default false
      */
-    showMoveAll?: boolean;
+    showMoveAll?: boolean | undefined;
     /**
      * Renders derived `TransferItem` content instead of `label`. Ignored when `children` given.
      * @default undefined — each item renders its `label`.
      */
-    renderItem?: (item: TransferItemData) => React.ReactNode;
+    renderItem?: ((item: TransferItemData) => React.ReactNode) | undefined;
+    /**
+     * Spacing rung the skin packs the rows by, fed to both derived lists.
+     * @default undefined — the skin's own default spacing.
+     */
+    density?: 'compact' | (string & {}) | undefined;
+    /**
+     * Corner rung the skin rounds the lists by, fed to both derived lists.
+     * @default undefined — the skin's own default corner.
+     */
+    shape?: 'square' | 'rounded' | (string & {}) | undefined;
+    /**
+     * Size rung the skin scales the lists by, fed to both derived lists.
+     * @default undefined — the skin's own default size.
+     */
+    size?: 'sm' | 'lg' | (string & {}) | undefined;
 }
 /** Text for empty states. See {@link TransferProps.emptyText}. */
 export interface TransferEmptyText {
     /** Shown when side holds no items. @default 'Nothing here.' */
-    empty?: string;
+    empty?: string | undefined;
     /** Shown when search filters all items (`{query}` replaced). @default 'No match for "{query}".' */
-    noMatch?: string;
+    noMatch?: string | undefined;
 }
 /** List headings for derived anatomy. See {@link TransferProps.titles}. */
 export interface TransferTitles {
     /** Source (available) list heading. @default 'Available items' */
-    source?: string;
+    source?: string | undefined;
     /** Target (selected) list heading. @default 'Selected items' */
-    target?: string;
+    target?: string | undefined;
 }
 /** @internal Wiring passed from a {@link TransferList} to the {@link TransferItem}s inside it. Not part of the public API. */
 export interface TransferListContextValue {
@@ -217,12 +239,27 @@ export interface TransferListProps extends Omit<PrimitivePropsWithRef<'div'>, 'o
      * Renders derived `TransferItem` content instead of `label`. Ignored when `children` given.
      * @default undefined — each item renders its `label`.
      */
-    renderItem?: (item: TransferItemData) => React.ReactNode;
+    renderItem?: ((item: TransferItemData) => React.ReactNode) | undefined;
     /**
      * Custom `TransferItem`s to override the default rendering of items.
      * @default undefined — one `TransferItem` per visible item, using `label` as content.
      */
-    children?: React.ReactNode;
+    children?: React.ReactNode | undefined;
+    /**
+     * Spacing rung the skin packs this list by, mirrored to `data-density`.
+     * @default undefined — the skin's own default spacing.
+     */
+    density?: 'compact' | (string & {}) | undefined;
+    /**
+     * Corner rung the skin rounds this list by, mirrored to `data-shape`.
+     * @default undefined — the skin's own default corner.
+     */
+    shape?: 'square' | 'rounded' | (string & {}) | undefined;
+    /**
+     * Size rung the skin scales this list by, mirrored to `data-size`.
+     * @default undefined — the skin's own default size.
+     */
+    size?: 'sm' | 'lg' | (string & {}) | undefined;
 }
 /** Props for {@link TransferListHeader}, the heading naming one list. */
 export interface TransferListHeaderProps extends PrimitivePropsWithRef<'div'> {
@@ -242,12 +279,12 @@ export interface TransferItemProps extends PrimitivePropsWithRef<'div'> {
      * Excludes option from marking, navigation, and moves.
      * @default false
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
     /**
      * Text typeahead matches against, published as `data-text-value`.
      * @default undefined — falls back to rendered text content.
      */
-    textValue?: string;
+    textValue?: string | undefined;
 }
 /** Props for {@link TransferControls}, the named group holding the move triggers. */
 export interface TransferControlsProps extends PrimitivePropsWithRef<'div'> {
@@ -270,5 +307,5 @@ export interface TransferEmptyProps extends Omit<PrimitivePropsWithRef<'div'>, '
      * Message; pass function to differentiate empty vs no-results (published as `data-reason` / `data-query`).
      * @default undefined — renders element only.
      */
-    children?: React.ReactNode | ((context: TransferEmptyContext) => React.ReactNode);
+    children?: React.ReactNode | ((context: TransferEmptyContext) => React.ReactNode) | undefined;
 }