@skdx/react 0.28.0 → 0.30.0

package/dist/slider/SliderAnatomy.d.ts

@@ -1,15 +1,13 @@
 import * as React from 'react';
 import type { SliderMarkData } from './types.js';
 /**
- * The anatomy a {@link Slider} draws when given no children: a `SliderTrack`
- * holding a `SliderRange`, one `SliderThumb` per entry in the current values — with a
- * `skdx-slider__tooltip` child showing its live value when `showTooltip` is
- * set, positioned by the skin, not by this component — and one `SliderMark` per
- * entry in `marks`.
+ * The anatomy a {@link Slider} draws when given no children: a `SliderTrack`, one `SliderThumb` per value, and marks.
  *
  * @internal
  */
-export declare const SliderAnatomy: ({ marks, showTooltip, }: {
-    marks?: readonly SliderMarkData[];
-    showTooltip?: boolean;
+export declare const SliderAnatomy: ({ marks, showTooltip, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, }: {
+    marks?: readonly SliderMarkData[] | undefined;
+    showTooltip?: boolean | undefined;
+    "aria-label"?: string | undefined;
+    "aria-labelledby"?: string | undefined;
 }) => React.JSX.Element;

package/dist/slider/SliderMark.d.cts

@@ -1,9 +1,7 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { SliderMarkProps } from './types.cjs';
 /**
- * Optional tick at declared `value` — positioned to align with thumb in both writing directions.
- *
- * Computed positioning avoids RTL bugs; children are the label, tick drawn by skin's `::before`.
+ * Optional tick at a declared `value`, positioned to align with the thumb in both writing directions.
  *
  * @example
  * ```tsx
@@ -17,4 +15,7 @@ import type { SliderMarkProps } from './types.cjs';
  * </Slider>
  * ```
  */
-export declare const SliderMark: React.ForwardRefExoticComponent<Omit<SliderMarkProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+export declare const SliderMark: {
+    ({ value, ref: forwardedRef, ...props }: SliderMarkProps): React.ReactNode;
+    displayName: string;
+};

package/dist/slider/SliderMark.d.ts

@@ -1,9 +1,7 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { SliderMarkProps } from './types.js';
 /**
- * Optional tick at declared `value` — positioned to align with thumb in both writing directions.
- *
- * Computed positioning avoids RTL bugs; children are the label, tick drawn by skin's `::before`.
+ * Optional tick at a declared `value`, positioned to align with the thumb in both writing directions.
  *
  * @example
  * ```tsx
@@ -17,4 +15,7 @@ import type { SliderMarkProps } from './types.js';
  * </Slider>
  * ```
  */
-export declare const SliderMark: React.ForwardRefExoticComponent<Omit<SliderMarkProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+export declare const SliderMark: {
+    ({ value, ref: forwardedRef, ...props }: SliderMarkProps): React.ReactNode;
+    displayName: string;
+};

package/dist/slider/SliderRange.d.cts

@@ -1,10 +1,7 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { SliderRangeProps } from './types.cjs';
 /**
- * The filled portion of the track, spanning from lowest to highest selected
- * value. Positioned with logical `inset-inline-*` (horizontal) or physical
- * `bottom`/`top` (vertical) using percentages from the current values.
- * Logical axis respects `dir="rtl"`.
+ * The filled portion of the track, spanning from lowest to highest selected value.
  *
  * @example
  * ```tsx
@@ -13,4 +10,7 @@ import type { SliderRangeProps } from './types.cjs';
  * </SliderTrack>
  * ```
  */
-export declare const SliderRange: React.ForwardRefExoticComponent<Omit<SliderRangeProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+export declare const SliderRange: {
+    ({ ref: forwardedRef, ...props }: SliderRangeProps): React.ReactNode;
+    displayName: string;
+};

package/dist/slider/SliderRange.d.ts

@@ -1,10 +1,7 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { SliderRangeProps } from './types.js';
 /**
- * The filled portion of the track, spanning from lowest to highest selected
- * value. Positioned with logical `inset-inline-*` (horizontal) or physical
- * `bottom`/`top` (vertical) using percentages from the current values.
- * Logical axis respects `dir="rtl"`.
+ * The filled portion of the track, spanning from lowest to highest selected value.
  *
  * @example
  * ```tsx
@@ -13,4 +10,7 @@ import type { SliderRangeProps } from './types.js';
  * </SliderTrack>
  * ```
  */
-export declare const SliderRange: React.ForwardRefExoticComponent<Omit<SliderRangeProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+export declare const SliderRange: {
+    ({ ref: forwardedRef, ...props }: SliderRangeProps): React.ReactNode;
+    displayName: string;
+};

package/dist/slider/SliderThumb.d.cts

@@ -1,13 +1,7 @@
 import * as React from 'react';
 import type { SliderThumbProps } from './types.cjs';
 /**
- * A single draggable handle on a {@link Slider}, positioned by `index` (or by render order).
- * Renders `role="slider"` with `aria-valuemin`/`aria-valuemax`/`aria-valuenow`,
- * `aria-orientation`, `aria-disabled`, `data-orientation`, `data-disabled`,
- * plus `data-dragging` while pointer moves it and `aria-valuetext` when given.
- * Keyboard-operable: Arrow keys step by `step`, Shift+Arrow and PageUp/PageDown by `largeStep`
- * (1/10th of range by default), Home/End jump to `min`/`max`.
- * Renders visually-hidden native `<input type="number">` for form submission when slider has `name`.
+ * A single draggable handle on a {@link Slider}, keyboard-operable with Arrow keys, Shift+Arrow, and Home/End.
  *
  * @example
  * ```tsx
@@ -20,4 +14,7 @@ import type { SliderThumbProps } from './types.cjs';
  * </Slider>
  * ```
  */
-export declare const SliderThumb: React.ForwardRefExoticComponent<Omit<SliderThumbProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+export declare const SliderThumb: {
+    ({ index: indexProp, valueText, ref: forwardedRef, ...props }: SliderThumbProps): React.ReactNode;
+    displayName: string;
+};

package/dist/slider/SliderThumb.d.ts

@@ -1,13 +1,7 @@
 import * as React from 'react';
 import type { SliderThumbProps } from './types.js';
 /**
- * A single draggable handle on a {@link Slider}, positioned by `index` (or by render order).
- * Renders `role="slider"` with `aria-valuemin`/`aria-valuemax`/`aria-valuenow`,
- * `aria-orientation`, `aria-disabled`, `data-orientation`, `data-disabled`,
- * plus `data-dragging` while pointer moves it and `aria-valuetext` when given.
- * Keyboard-operable: Arrow keys step by `step`, Shift+Arrow and PageUp/PageDown by `largeStep`
- * (1/10th of range by default), Home/End jump to `min`/`max`.
- * Renders visually-hidden native `<input type="number">` for form submission when slider has `name`.
+ * A single draggable handle on a {@link Slider}, keyboard-operable with Arrow keys, Shift+Arrow, and Home/End.
  *
  * @example
  * ```tsx
@@ -20,4 +14,7 @@ import type { SliderThumbProps } from './types.js';
  * </Slider>
  * ```
  */
-export declare const SliderThumb: React.ForwardRefExoticComponent<Omit<SliderThumbProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+export declare const SliderThumb: {
+    ({ index: indexProp, valueText, ref: forwardedRef, ...props }: SliderThumbProps): React.ReactNode;
+    displayName: string;
+};

package/dist/slider/SliderTrack.d.cts

@@ -1,7 +1,7 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { SliderTrackProps } from './types.cjs';
 /**
- * Full-length background bar for a {@link Slider}. Purely presentational; pointer interaction is handled by the `Slider` root.
+ * Full-length background bar for a {@link Slider}, purely presentational.
  *
  * @example
  * ```tsx
@@ -13,4 +13,7 @@ import type { SliderTrackProps } from './types.cjs';
  * </Slider>
  * ```
  */
-export declare const SliderTrack: React.ForwardRefExoticComponent<Omit<SliderTrackProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+export declare const SliderTrack: {
+    ({ ref: forwardedRef, ...props }: SliderTrackProps): React.ReactNode;
+    displayName: string;
+};

package/dist/slider/SliderTrack.d.ts

@@ -1,7 +1,7 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { SliderTrackProps } from './types.js';
 /**
- * Full-length background bar for a {@link Slider}. Purely presentational; pointer interaction is handled by the `Slider` root.
+ * Full-length background bar for a {@link Slider}, purely presentational.
  *
  * @example
  * ```tsx
@@ -13,4 +13,7 @@ import type { SliderTrackProps } from './types.js';
  * </Slider>
  * ```
  */
-export declare const SliderTrack: React.ForwardRefExoticComponent<Omit<SliderTrackProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+export declare const SliderTrack: {
+    ({ ref: forwardedRef, ...props }: SliderTrackProps): React.ReactNode;
+    displayName: string;
+};

package/dist/slider/primitives.d.cts

@@ -1,6 +1,5 @@
 /**
- * Advanced primitives for `Slider` — the parts the recipe composes. Use
- * for full manual composition.
+ * Advanced primitives for `Slider` — the parts the recipe composes.
  *
  * @example
  * ```tsx

package/dist/slider/primitives.d.ts

@@ -1,6 +1,5 @@
 /**
- * Advanced primitives for `Slider` — the parts the recipe composes. Use
- * for full manual composition.
+ * Advanced primitives for `Slider` — the parts the recipe composes.
  *
  * @example
  * ```tsx

package/dist/slider/types.d.cts

@@ -2,9 +2,7 @@ import type * as React from 'react';
 import type { Direction } from '../utils/direction.cjs';
 import type { PrimitivePropsWithRef } from '../utils/primitive.cjs';
 /**
- * Payload of `onValueChange`. `reason` discriminates four change sources
- * (track press, drag, keyboard, or programmatic). `previousValue` is included
- * because consumers usually need both ends; `null` only when there was no prior value.
+ * Payload of `onValueChange`: the new values, previous values, and what drove the change.
  */
 export interface SliderValueChangeDetail {
     /** The values the slider settled on, one per thumb. */
@@ -12,12 +10,11 @@ export interface SliderValueChangeDetail {
     /** The values held before this change, or `null` when there were none. */
     previousValue: number[] | null;
     /**
-     * What drove the change. `'pointer'` covers both a track press and a drag
-     * frame — which of the two it was is readable off the originating event.
+     * What drove the change; `'pointer'` covers both a track press and a drag frame.
      */
     reason: 'keyboard' | 'pointer' | 'programmatic';
 }
-/** @internal Shared state distributed from {@link Slider} to its parts via context. Not part of the public API. */
+/** @internal Shared state distributed from {@link Slider} to its parts via context. */
 export interface SliderContextValue {
     values: number[];
     min: number;
@@ -25,8 +22,7 @@ export interface SliderContextValue {
     disabled: boolean;
     orientation: 'horizontal' | 'vertical';
     /**
-     * Resolved once on root so all parts agree on track start. Used to map pointer
-     * and position thumbs.
+     * Resolved once on root so all parts agree on track start, used to map pointer and position thumbs.
      */
     direction: Direction;
     thumbIndexRef: React.RefObject<number>;
@@ -38,9 +34,9 @@ export interface SliderContextValue {
     step: number;
     /** Already resolved: the `largeStep` prop, or the derived tenth-of-range fallback. */
     largeStep: number;
-    name?: string;
-    form?: string;
-    thumbLabels?: readonly string[];
+    name?: string | undefined;
+    form?: string | undefined;
+    thumbLabels?: readonly string[] | undefined;
 }
 /** Props for the {@link Slider} root. */
 export interface SliderProps extends Omit<PrimitivePropsWithRef<'span'>, 'defaultValue' | 'onChange'> {
@@ -48,107 +44,101 @@ export interface SliderProps extends Omit<PrimitivePropsWithRef<'span'>, 'defaul
      * Selected values, one per thumb, for controlled usage. Pair with `onValueChange`.
      * @default undefined
      */
-    value?: number[];
+    value?: number[] | undefined;
     /**
      * Initial values, one per thumb, for uncontrolled usage. A single-element
      * array renders a simple slider; two elements render a range slider.
      * @default [0]
      */
-    defaultValue?: number[];
+    defaultValue?: number[] | undefined;
     /**
-     * Fires on every change during a drag or key press, with the new values, the
-     * values held before them, and the reason the change happened. A change that
-     * resolves to the values already held emits nothing.
+     * Fires on every change with the new values, previous values, and reason; a no-op change emits nothing.
      * @default undefined
      */
-    onValueChange?: (detail: SliderValueChangeDetail) => void;
+    onValueChange?: ((detail: SliderValueChangeDetail) => void) | undefined;
     /**
      * Fires once with final values when drag ends, suppressed if values unchanged
      * (bare click already in place).
      * @default undefined
      */
-    onValueCommit?: (value: number[]) => void;
+    onValueCommit?: ((value: number[]) => void) | undefined;
     /**
      * Minimum value of the range the slider can select.
      * @default 0
      */
-    min?: number;
+    min?: number | undefined;
     /**
      * Maximum value of the range the slider can select.
      * @default 100
      */
-    max?: number;
+    max?: number | undefined;
     /**
      * Increment values are rounded to, for both pointer and keyboard interaction.
      * @default 1
      */
-    step?: number;
+    step?: number | undefined;
     /**
      * Disables pointer and keyboard interaction on all thumbs.
      * @default false
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
     /**
      * Layout axis, exposed as `data-orientation` and used to map pointer
      * position and Arrow keys to a value.
      * @default 'horizontal'
      */
-    orientation?: 'horizontal' | 'vertical';
+    orientation?: 'horizontal' | 'vertical' | undefined;
     /**
-     * Increment PageUp/PageDown and Shift+Arrow move the focused thumb by.
-     * Defaults to a tenth of the range, floored at one step — the increment
-     * those keys already moved before this prop existed.
+     * Increment PageUp/PageDown and Shift+Arrow move the focused thumb by; defaults to a tenth of the range, floored at one step.
      * @default Math.max((max - min) / 10, step)
      */
-    largeStep?: number;
+    largeStep?: number | undefined;
     /**
-     * Minimum gap, counted in steps, that adjacent values must keep. At `0` two
-     * thumbs may be dragged onto the same value; at `1` the neighbour is pushed
-     * one step away, so a range can never collapse to nothing.
+     * Minimum gap, counted in steps, that adjacent values must keep; at `0` two thumbs may share a value.
      * @default 0
      */
-    minStepsBetweenValues?: number;
+    minStepsBetweenValues?: number | undefined;
     /**
      * Name for native form participation; each thumb renders its own hidden input.
      * @default undefined
      */
-    name?: string;
+    name?: string | undefined;
     /**
      * Id of the `<form>` the slider submits into, forwarded to every thumb's
      * hidden input, so a slider can live outside the form it belongs to.
      * @default undefined
      */
-    form?: string;
+    form?: string | undefined;
     /**
      * Ticks rendered along the track, one derived `SliderMark` part each.
      * Ignored when `children` is given.
      * @default undefined — no marks are rendered.
      */
-    marks?: readonly SliderMarkData[];
+    marks?: readonly SliderMarkData[] | undefined;
     /**
-     * Shows the focused/dragged thumb's current value in a derived
-     * `skdx-slider__tooltip` element beside the thumb, positioned by the skin.
-     * Ignored when `children` is given.
+     * Shows the focused/dragged thumb's current value in a derived tooltip, positioned by the skin; ignored when `children` is given.
      * @default false
      */
-    showTooltip?: boolean;
+    showTooltip?: boolean | undefined;
     /**
-     * Accessible names for derived thumbs, one per value (e.g. `["Minimum", "Maximum"]`).
-     * Multi-thumb sliders need these so each thumb announces distinctly; `role="slider"`
-     * takes no name from content. Ignored when `children` is given with its own `aria-label`.
+     * Accessible names for derived thumbs, one per value; needed since `role="slider"` takes no name from content.
      * @default undefined
      */
-    thumbLabels?: readonly string[];
+    thumbLabels?: readonly string[] | undefined;
+    /**
+     * Size rung the skin scales the track and thumbs by, mirrored to `data-size`.
+     * @default undefined — the skin's own default size.
+     */
+    size?: 'md' | 'sm' | 'lg' | (string & {}) | undefined;
 }
 /**
- * Entry of {@link SliderProps.marks} — a tick with optional label. Named `Data`
- * to avoid collision with the `SliderMark` part component.
+ * Entry of {@link SliderProps.marks} — a tick with optional label.
  */
 export interface SliderMarkData {
     /** The value on the track this mark sits at. */
     value: number;
     /** Text rendered inside the derived mark. */
-    label?: string;
+    label?: string | undefined;
 }
 /** Props for the {@link SliderTrack}, the full-length background bar. */
 export interface SliderTrackProps extends PrimitivePropsWithRef<'span'> {
@@ -159,28 +149,25 @@ export interface SliderRangeProps extends PrimitivePropsWithRef<'span'> {
 /** Props for a {@link SliderThumb} handle. */
 export interface SliderThumbProps extends PrimitivePropsWithRef<'span'> {
     /**
-     * Which value in the array this thumb controls. Defaults to its render
-     * order among sibling `SliderThumb`s (0 for the first, 1 for the second, ...).
+     * Which value in the array this thumb controls; defaults to its render order among siblings.
      * @default undefined
      */
-    index?: number;
+    index?: number | undefined;
     /**
-     * Announcement for this thumb's value, written to `aria-valuetext`. Supply when
-     * the raw number doesn't match what the user chose (e.g. `"£20"` for price).
+     * Announcement for this thumb's value, written to `aria-valuetext`, when the raw number doesn't match.
      * @default undefined
      */
-    valueText?: string;
+    valueText?: string | undefined;
     /**
      * Accessible name for this thumb, since it has no visible text content.
      * @default undefined
      */
-    'aria-label'?: string;
+    'aria-label'?: string | undefined;
 }
 /** Props for a {@link SliderMark} tick. */
 export interface SliderMarkProps extends PrimitivePropsWithRef<'span'> {
     /**
-     * The value on the track this mark sits at. Positioned with the same
-     * logical inline offset the thumb uses, so it mirrors under `dir="rtl"`.
+     * The value on the track this mark sits at, positioned with the same logical offset the thumb uses.
      */
     value: number;
 }

package/dist/slider/types.d.ts

@@ -2,9 +2,7 @@ import type * as React from 'react';
 import type { Direction } from '../utils/direction.js';
 import type { PrimitivePropsWithRef } from '../utils/primitive.js';
 /**
- * Payload of `onValueChange`. `reason` discriminates four change sources
- * (track press, drag, keyboard, or programmatic). `previousValue` is included
- * because consumers usually need both ends; `null` only when there was no prior value.
+ * Payload of `onValueChange`: the new values, previous values, and what drove the change.
  */
 export interface SliderValueChangeDetail {
     /** The values the slider settled on, one per thumb. */
@@ -12,12 +10,11 @@ export interface SliderValueChangeDetail {
     /** The values held before this change, or `null` when there were none. */
     previousValue: number[] | null;
     /**
-     * What drove the change. `'pointer'` covers both a track press and a drag
-     * frame — which of the two it was is readable off the originating event.
+     * What drove the change; `'pointer'` covers both a track press and a drag frame.
      */
     reason: 'keyboard' | 'pointer' | 'programmatic';
 }
-/** @internal Shared state distributed from {@link Slider} to its parts via context. Not part of the public API. */
+/** @internal Shared state distributed from {@link Slider} to its parts via context. */
 export interface SliderContextValue {
     values: number[];
     min: number;
@@ -25,8 +22,7 @@ export interface SliderContextValue {
     disabled: boolean;
     orientation: 'horizontal' | 'vertical';
     /**
-     * Resolved once on root so all parts agree on track start. Used to map pointer
-     * and position thumbs.
+     * Resolved once on root so all parts agree on track start, used to map pointer and position thumbs.
      */
     direction: Direction;
     thumbIndexRef: React.RefObject<number>;
@@ -38,9 +34,9 @@ export interface SliderContextValue {
     step: number;
     /** Already resolved: the `largeStep` prop, or the derived tenth-of-range fallback. */
     largeStep: number;
-    name?: string;
-    form?: string;
-    thumbLabels?: readonly string[];
+    name?: string | undefined;
+    form?: string | undefined;
+    thumbLabels?: readonly string[] | undefined;
 }
 /** Props for the {@link Slider} root. */
 export interface SliderProps extends Omit<PrimitivePropsWithRef<'span'>, 'defaultValue' | 'onChange'> {
@@ -48,107 +44,101 @@ export interface SliderProps extends Omit<PrimitivePropsWithRef<'span'>, 'defaul
      * Selected values, one per thumb, for controlled usage. Pair with `onValueChange`.
      * @default undefined
      */
-    value?: number[];
+    value?: number[] | undefined;
     /**
      * Initial values, one per thumb, for uncontrolled usage. A single-element
      * array renders a simple slider; two elements render a range slider.
      * @default [0]
      */
-    defaultValue?: number[];
+    defaultValue?: number[] | undefined;
     /**
-     * Fires on every change during a drag or key press, with the new values, the
-     * values held before them, and the reason the change happened. A change that
-     * resolves to the values already held emits nothing.
+     * Fires on every change with the new values, previous values, and reason; a no-op change emits nothing.
      * @default undefined
      */
-    onValueChange?: (detail: SliderValueChangeDetail) => void;
+    onValueChange?: ((detail: SliderValueChangeDetail) => void) | undefined;
     /**
      * Fires once with final values when drag ends, suppressed if values unchanged
      * (bare click already in place).
      * @default undefined
      */
-    onValueCommit?: (value: number[]) => void;
+    onValueCommit?: ((value: number[]) => void) | undefined;
     /**
      * Minimum value of the range the slider can select.
      * @default 0
      */
-    min?: number;
+    min?: number | undefined;
     /**
      * Maximum value of the range the slider can select.
      * @default 100
      */
-    max?: number;
+    max?: number | undefined;
     /**
      * Increment values are rounded to, for both pointer and keyboard interaction.
      * @default 1
      */
-    step?: number;
+    step?: number | undefined;
     /**
      * Disables pointer and keyboard interaction on all thumbs.
      * @default false
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
     /**
      * Layout axis, exposed as `data-orientation` and used to map pointer
      * position and Arrow keys to a value.
      * @default 'horizontal'
      */
-    orientation?: 'horizontal' | 'vertical';
+    orientation?: 'horizontal' | 'vertical' | undefined;
     /**
-     * Increment PageUp/PageDown and Shift+Arrow move the focused thumb by.
-     * Defaults to a tenth of the range, floored at one step — the increment
-     * those keys already moved before this prop existed.
+     * Increment PageUp/PageDown and Shift+Arrow move the focused thumb by; defaults to a tenth of the range, floored at one step.
      * @default Math.max((max - min) / 10, step)
      */
-    largeStep?: number;
+    largeStep?: number | undefined;
     /**
-     * Minimum gap, counted in steps, that adjacent values must keep. At `0` two
-     * thumbs may be dragged onto the same value; at `1` the neighbour is pushed
-     * one step away, so a range can never collapse to nothing.
+     * Minimum gap, counted in steps, that adjacent values must keep; at `0` two thumbs may share a value.
      * @default 0
      */
-    minStepsBetweenValues?: number;
+    minStepsBetweenValues?: number | undefined;
     /**
      * Name for native form participation; each thumb renders its own hidden input.
      * @default undefined
      */
-    name?: string;
+    name?: string | undefined;
     /**
      * Id of the `<form>` the slider submits into, forwarded to every thumb's
      * hidden input, so a slider can live outside the form it belongs to.
      * @default undefined
      */
-    form?: string;
+    form?: string | undefined;
     /**
      * Ticks rendered along the track, one derived `SliderMark` part each.
      * Ignored when `children` is given.
      * @default undefined — no marks are rendered.
      */
-    marks?: readonly SliderMarkData[];
+    marks?: readonly SliderMarkData[] | undefined;
     /**
-     * Shows the focused/dragged thumb's current value in a derived
-     * `skdx-slider__tooltip` element beside the thumb, positioned by the skin.
-     * Ignored when `children` is given.
+     * Shows the focused/dragged thumb's current value in a derived tooltip, positioned by the skin; ignored when `children` is given.
      * @default false
      */
-    showTooltip?: boolean;
+    showTooltip?: boolean | undefined;
     /**
-     * Accessible names for derived thumbs, one per value (e.g. `["Minimum", "Maximum"]`).
-     * Multi-thumb sliders need these so each thumb announces distinctly; `role="slider"`
-     * takes no name from content. Ignored when `children` is given with its own `aria-label`.
+     * Accessible names for derived thumbs, one per value; needed since `role="slider"` takes no name from content.
      * @default undefined
      */
-    thumbLabels?: readonly string[];
+    thumbLabels?: readonly string[] | undefined;
+    /**
+     * Size rung the skin scales the track and thumbs by, mirrored to `data-size`.
+     * @default undefined — the skin's own default size.
+     */
+    size?: 'md' | 'sm' | 'lg' | (string & {}) | undefined;
 }
 /**
- * Entry of {@link SliderProps.marks} — a tick with optional label. Named `Data`
- * to avoid collision with the `SliderMark` part component.
+ * Entry of {@link SliderProps.marks} — a tick with optional label.
  */
 export interface SliderMarkData {
     /** The value on the track this mark sits at. */
     value: number;
     /** Text rendered inside the derived mark. */
-    label?: string;
+    label?: string | undefined;
 }
 /** Props for the {@link SliderTrack}, the full-length background bar. */
 export interface SliderTrackProps extends PrimitivePropsWithRef<'span'> {
@@ -159,28 +149,25 @@ export interface SliderRangeProps extends PrimitivePropsWithRef<'span'> {
 /** Props for a {@link SliderThumb} handle. */
 export interface SliderThumbProps extends PrimitivePropsWithRef<'span'> {
     /**
-     * Which value in the array this thumb controls. Defaults to its render
-     * order among sibling `SliderThumb`s (0 for the first, 1 for the second, ...).
+     * Which value in the array this thumb controls; defaults to its render order among siblings.
      * @default undefined
      */
-    index?: number;
+    index?: number | undefined;
     /**
-     * Announcement for this thumb's value, written to `aria-valuetext`. Supply when
-     * the raw number doesn't match what the user chose (e.g. `"£20"` for price).
+     * Announcement for this thumb's value, written to `aria-valuetext`, when the raw number doesn't match.
      * @default undefined
      */
-    valueText?: string;
+    valueText?: string | undefined;
     /**
      * Accessible name for this thumb, since it has no visible text content.
      * @default undefined
      */
-    'aria-label'?: string;
+    'aria-label'?: string | undefined;
 }
 /** Props for a {@link SliderMark} tick. */
 export interface SliderMarkProps extends PrimitivePropsWithRef<'span'> {
     /**
-     * The value on the track this mark sits at. Positioned with the same
-     * logical inline offset the thumb uses, so it mirrors under `dir="rtl"`.
+     * The value on the track this mark sits at, positioned with the same logical offset the thumb uses.
      */
     value: number;
 }