@skdx/react 0.26.0

package/dist/number-field/NumberFieldDecrement.d.ts

@@ -0,0 +1,19 @@
+import * as React from 'react';
+import type { NumberFieldDecrementProps } from './types.js';
+/**
+ * A button that lowers a {@link NumberField}'s value by one `step`. Disabled
+ * (with `data-disabled`) once the value reaches `min` or the field itself is
+ * disabled. While the field is read-only, the button stays focusable but
+ * becomes inert (`aria-disabled`, no-op press) rather than natively disabled.
+ * Holding it down (pointer) repeats the decrement after an initial delay,
+ * then at a fixed interval, until released.
+ *
+ * @example
+ * ```tsx
+ * <NumberField>
+ *   <NumberFieldDecrement>-</NumberFieldDecrement>
+ *   <NumberFieldInput />
+ * </NumberField>
+ * ```
+ */
+export declare const NumberFieldDecrement: React.ForwardRefExoticComponent<Omit<NumberFieldDecrementProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

package/dist/number-field/NumberFieldIncrement.d.cts

@@ -0,0 +1,28 @@
+import * as React from 'react';
+import type { NumberFieldIncrementProps } from './types.cjs';
+/**
+ * @internal Runs `onPress` once on press, then repeatedly while held — after a
+ * {@link REPEAT_DELAY} ms delay, at a {@link REPEAT_INTERVAL} ms cadence — until
+ * `stop` is called. No-op while `disabled`. Returns `{ start, stop }` handlers.
+ */
+export declare function useRepeatingPress(onPress: () => void, disabled: boolean): {
+    start: () => void;
+    stop: () => void;
+};
+/**
+ * A button that raises a {@link NumberField}'s value by one `step`. Disabled
+ * (with `data-disabled`) once the value reaches `max` or the field itself is
+ * disabled. While the field is read-only, the button stays focusable but
+ * becomes inert (`aria-disabled`, no-op press) rather than natively disabled.
+ * Holding it down (pointer) repeats the increment after an initial delay,
+ * then at a fixed interval, until released.
+ *
+ * @example
+ * ```tsx
+ * <NumberField>
+ *   <NumberFieldInput />
+ *   <NumberFieldIncrement>+</NumberFieldIncrement>
+ * </NumberField>
+ * ```
+ */
+export declare const NumberFieldIncrement: React.ForwardRefExoticComponent<Omit<NumberFieldIncrementProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

package/dist/number-field/NumberFieldIncrement.d.ts

@@ -0,0 +1,28 @@
+import * as React from 'react';
+import type { NumberFieldIncrementProps } from './types.js';
+/**
+ * @internal Runs `onPress` once on press, then repeatedly while held — after a
+ * {@link REPEAT_DELAY} ms delay, at a {@link REPEAT_INTERVAL} ms cadence — until
+ * `stop` is called. No-op while `disabled`. Returns `{ start, stop }` handlers.
+ */
+export declare function useRepeatingPress(onPress: () => void, disabled: boolean): {
+    start: () => void;
+    stop: () => void;
+};
+/**
+ * A button that raises a {@link NumberField}'s value by one `step`. Disabled
+ * (with `data-disabled`) once the value reaches `max` or the field itself is
+ * disabled. While the field is read-only, the button stays focusable but
+ * becomes inert (`aria-disabled`, no-op press) rather than natively disabled.
+ * Holding it down (pointer) repeats the increment after an initial delay,
+ * then at a fixed interval, until released.
+ *
+ * @example
+ * ```tsx
+ * <NumberField>
+ *   <NumberFieldInput />
+ *   <NumberFieldIncrement>+</NumberFieldIncrement>
+ * </NumberField>
+ * ```
+ */
+export declare const NumberFieldIncrement: React.ForwardRefExoticComponent<Omit<NumberFieldIncrementProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

package/dist/number-field/NumberFieldInput.d.cts

@@ -0,0 +1,25 @@
+import * as React from 'react';
+import type { NumberFieldInputProps } from './types.cjs';
+/**
+ * The text input for a {@link NumberField}. Renders `role="spinbutton"` with
+ * `aria-valuenow`/`aria-valuemin`/`aria-valuemax` from context, plus
+ * `aria-invalid`/`data-invalid` and the native `readOnly` attribute with
+ * `aria-readonly`/`data-readonly` from context. Typed text is tracked
+ * unclamped so multi-digit entry isn't fought mid-keystroke, and is
+ * clamped/committed on blur (reverting to the last committed value if left
+ * empty or non-numeric). Arrow Up/Down change the value by one `step`, and
+ * Page Up/Down by ten `step`s.
+ *
+ * With the root's `formatOptions`/`locale`, the committed value is displayed
+ * through `Intl.NumberFormat` and announced on `aria-valuetext`, while typed
+ * or pasted text is parsed back through the same options — so a currency
+ * symbol, a group separator or a `%` never reads as garbage.
+ *
+ * @example
+ * ```tsx
+ * <NumberField defaultValue={1} min={0} max={10}>
+ *   <NumberFieldInput />
+ * </NumberField>
+ * ```
+ */
+export declare const NumberFieldInput: React.ForwardRefExoticComponent<Omit<NumberFieldInputProps, "ref"> & React.RefAttributes<HTMLInputElement>>;

package/dist/number-field/NumberFieldInput.d.ts

@@ -0,0 +1,25 @@
+import * as React from 'react';
+import type { NumberFieldInputProps } from './types.js';
+/**
+ * The text input for a {@link NumberField}. Renders `role="spinbutton"` with
+ * `aria-valuenow`/`aria-valuemin`/`aria-valuemax` from context, plus
+ * `aria-invalid`/`data-invalid` and the native `readOnly` attribute with
+ * `aria-readonly`/`data-readonly` from context. Typed text is tracked
+ * unclamped so multi-digit entry isn't fought mid-keystroke, and is
+ * clamped/committed on blur (reverting to the last committed value if left
+ * empty or non-numeric). Arrow Up/Down change the value by one `step`, and
+ * Page Up/Down by ten `step`s.
+ *
+ * With the root's `formatOptions`/`locale`, the committed value is displayed
+ * through `Intl.NumberFormat` and announced on `aria-valuetext`, while typed
+ * or pasted text is parsed back through the same options — so a currency
+ * symbol, a group separator or a `%` never reads as garbage.
+ *
+ * @example
+ * ```tsx
+ * <NumberField defaultValue={1} min={0} max={10}>
+ *   <NumberFieldInput />
+ * </NumberField>
+ * ```
+ */
+export declare const NumberFieldInput: React.ForwardRefExoticComponent<Omit<NumberFieldInputProps, "ref"> & React.RefAttributes<HTMLInputElement>>;

package/dist/number-field/index.d.cts

@@ -0,0 +1,5 @@
+export * from './NumberField.cjs';
+export { NumberFieldInput } from './NumberFieldInput.cjs';
+export { NumberFieldIncrement } from './NumberFieldIncrement.cjs';
+export { NumberFieldDecrement } from './NumberFieldDecrement.cjs';
+export type { NumberFieldProps, NumberFieldHandle, NumberFieldInputProps, NumberFieldIncrementProps, NumberFieldDecrementProps, } from './types.cjs';

package/dist/number-field/index.d.ts

@@ -0,0 +1,5 @@
+export * from './NumberField.js';
+export { NumberFieldInput } from './NumberFieldInput.js';
+export { NumberFieldIncrement } from './NumberFieldIncrement.js';
+export { NumberFieldDecrement } from './NumberFieldDecrement.js';
+export type { NumberFieldProps, NumberFieldHandle, NumberFieldInputProps, NumberFieldIncrementProps, NumberFieldDecrementProps, } from './types.js';

package/dist/number-field/types.d.cts

@@ -0,0 +1,113 @@
+import type { FormValidityHandle } from '../utils/formControl.cjs';
+import type { PrimitivePropsWithRef } from '../utils/primitive.cjs';
+/** @internal Shared state distributed from {@link NumberField} to its parts via context. Not part of the public API. */
+export interface NumberFieldContextValue {
+    value: number;
+    min: number;
+    max: number;
+    step: number;
+    disabled: boolean;
+    invalid: boolean;
+    readOnly: boolean;
+    formatOptions?: Intl.NumberFormatOptions;
+    locale?: string;
+    setValue: (next: number) => void;
+    /** Commits without clamping — used while typing so out-of-range prefixes don't fight keystrokes. */
+    setValueUnclamped: (next: number) => void;
+    /** Steps the value by `steps × step` with decimal-precise arithmetic, then clamps. */
+    stepBy: (steps: number) => void;
+}
+/** Props for the {@link NumberField} root. */
+export interface NumberFieldProps extends Omit<PrimitivePropsWithRef<'div'>, 'defaultValue' | 'onChange'> {
+    /**
+     * Current value, for controlled usage. Pair with `onValueChange`.
+     * @default undefined — uncontrolled, tracks its own value internally.
+     */
+    value?: number;
+    /**
+     * Initial value, for uncontrolled usage. Clamped to `min`/`max` on mount.
+     * @default 0
+     */
+    defaultValue?: number;
+    /**
+     * Fires with the new (clamped) value whenever it changes, controlled or not.
+     * @default undefined — no-op if omitted.
+     */
+    onValueChange?: (value: number) => void;
+    /**
+     * Lower bound the value is clamped to, including via increment/decrement
+     * and arrow keys.
+     * @default -Infinity
+     */
+    min?: number;
+    /**
+     * Upper bound the value is clamped to, including via increment/decrement
+     * and arrow keys.
+     * @default Infinity
+     */
+    max?: number;
+    /**
+     * Amount `NumberFieldIncrement`/`NumberFieldDecrement` and Arrow Up/Down
+     * change the value by (Page Up/Down uses 10x this).
+     * @default 1
+     */
+    step?: number;
+    /**
+     * Disables the field, its input, and both step buttons.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Marks the field as invalid, exposed as `data-invalid` on the root and
+     * `aria-invalid`/`data-invalid` on the input.
+     * @default false
+     */
+    invalid?: boolean;
+    /**
+     * Makes the input read-only (native `readOnly`, plus `aria-readonly` and
+     * `data-readonly` on the root and input) and makes the increment/decrement
+     * buttons inert — they stay focusable but no longer change the value.
+     * @default false
+     */
+    readOnly?: boolean;
+    /**
+     * `Intl.NumberFormat` options used to display the value (currency, percent,
+     * unit, grouping). Typed text is parsed back through the same options, and
+     * the formatted string is announced via `aria-valuetext`. `min`/`max`/`step`
+     * always operate on the numeric value, never the formatted string — with
+     * `{ style: 'percent' }` the value is the fraction, so `0.5` shows as `50%`.
+     * @default undefined — the value is displayed as `String(value)`.
+     */
+    formatOptions?: Intl.NumberFormatOptions;
+    /**
+     * BCP-47 locale used for formatting and parsing (decimal/group separators).
+     * @default undefined — the runtime's default locale.
+     */
+    locale?: string;
+    /**
+     * Form field name. With it, a visually-hidden native input submits the
+     * committed number as `String(value)` — the raw number, never
+     * `NumberFieldInput`'s formatted display text, so `{ style: 'currency' }`
+     * still submits `1234.5` rather than `$1,234.50`. A form reset restores
+     * `defaultValue`. The value is always clamped into `[min, max]` and can
+     * never be empty, so there is no constraint to violate and
+     * `checkValidity()` always passes.
+     * @default undefined — submits nothing.
+     */
+    name?: string;
+}
+/**
+ * What {@link NumberField}'s forwarded ref carries: the root `<div>` plus the
+ * two constraint-validation methods. Type your ref as this to call them —
+ * `React.useRef<NumberFieldHandle>(null)`.
+ */
+export type NumberFieldHandle = HTMLDivElement & FormValidityHandle;
+/** Props for {@link NumberFieldInput}, the text input driven by `NumberField`'s context. */
+export interface NumberFieldInputProps extends Omit<PrimitivePropsWithRef<'input'>, 'value' | 'defaultValue' | 'type'> {
+}
+/** Props for {@link NumberFieldIncrement}, a button that raises the value by one `step`. */
+export interface NumberFieldIncrementProps extends PrimitivePropsWithRef<'button'> {
+}
+/** Props for {@link NumberFieldDecrement}, a button that lowers the value by one `step`. */
+export interface NumberFieldDecrementProps extends PrimitivePropsWithRef<'button'> {
+}

package/dist/number-field/types.d.ts

@@ -0,0 +1,113 @@
+import type { FormValidityHandle } from '../utils/formControl.js';
+import type { PrimitivePropsWithRef } from '../utils/primitive.js';
+/** @internal Shared state distributed from {@link NumberField} to its parts via context. Not part of the public API. */
+export interface NumberFieldContextValue {
+    value: number;
+    min: number;
+    max: number;
+    step: number;
+    disabled: boolean;
+    invalid: boolean;
+    readOnly: boolean;
+    formatOptions?: Intl.NumberFormatOptions;
+    locale?: string;
+    setValue: (next: number) => void;
+    /** Commits without clamping — used while typing so out-of-range prefixes don't fight keystrokes. */
+    setValueUnclamped: (next: number) => void;
+    /** Steps the value by `steps × step` with decimal-precise arithmetic, then clamps. */
+    stepBy: (steps: number) => void;
+}
+/** Props for the {@link NumberField} root. */
+export interface NumberFieldProps extends Omit<PrimitivePropsWithRef<'div'>, 'defaultValue' | 'onChange'> {
+    /**
+     * Current value, for controlled usage. Pair with `onValueChange`.
+     * @default undefined — uncontrolled, tracks its own value internally.
+     */
+    value?: number;
+    /**
+     * Initial value, for uncontrolled usage. Clamped to `min`/`max` on mount.
+     * @default 0
+     */
+    defaultValue?: number;
+    /**
+     * Fires with the new (clamped) value whenever it changes, controlled or not.
+     * @default undefined — no-op if omitted.
+     */
+    onValueChange?: (value: number) => void;
+    /**
+     * Lower bound the value is clamped to, including via increment/decrement
+     * and arrow keys.
+     * @default -Infinity
+     */
+    min?: number;
+    /**
+     * Upper bound the value is clamped to, including via increment/decrement
+     * and arrow keys.
+     * @default Infinity
+     */
+    max?: number;
+    /**
+     * Amount `NumberFieldIncrement`/`NumberFieldDecrement` and Arrow Up/Down
+     * change the value by (Page Up/Down uses 10x this).
+     * @default 1
+     */
+    step?: number;
+    /**
+     * Disables the field, its input, and both step buttons.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Marks the field as invalid, exposed as `data-invalid` on the root and
+     * `aria-invalid`/`data-invalid` on the input.
+     * @default false
+     */
+    invalid?: boolean;
+    /**
+     * Makes the input read-only (native `readOnly`, plus `aria-readonly` and
+     * `data-readonly` on the root and input) and makes the increment/decrement
+     * buttons inert — they stay focusable but no longer change the value.
+     * @default false
+     */
+    readOnly?: boolean;
+    /**
+     * `Intl.NumberFormat` options used to display the value (currency, percent,
+     * unit, grouping). Typed text is parsed back through the same options, and
+     * the formatted string is announced via `aria-valuetext`. `min`/`max`/`step`
+     * always operate on the numeric value, never the formatted string — with
+     * `{ style: 'percent' }` the value is the fraction, so `0.5` shows as `50%`.
+     * @default undefined — the value is displayed as `String(value)`.
+     */
+    formatOptions?: Intl.NumberFormatOptions;
+    /**
+     * BCP-47 locale used for formatting and parsing (decimal/group separators).
+     * @default undefined — the runtime's default locale.
+     */
+    locale?: string;
+    /**
+     * Form field name. With it, a visually-hidden native input submits the
+     * committed number as `String(value)` — the raw number, never
+     * `NumberFieldInput`'s formatted display text, so `{ style: 'currency' }`
+     * still submits `1234.5` rather than `$1,234.50`. A form reset restores
+     * `defaultValue`. The value is always clamped into `[min, max]` and can
+     * never be empty, so there is no constraint to violate and
+     * `checkValidity()` always passes.
+     * @default undefined — submits nothing.
+     */
+    name?: string;
+}
+/**
+ * What {@link NumberField}'s forwarded ref carries: the root `<div>` plus the
+ * two constraint-validation methods. Type your ref as this to call them —
+ * `React.useRef<NumberFieldHandle>(null)`.
+ */
+export type NumberFieldHandle = HTMLDivElement & FormValidityHandle;
+/** Props for {@link NumberFieldInput}, the text input driven by `NumberField`'s context. */
+export interface NumberFieldInputProps extends Omit<PrimitivePropsWithRef<'input'>, 'value' | 'defaultValue' | 'type'> {
+}
+/** Props for {@link NumberFieldIncrement}, a button that raises the value by one `step`. */
+export interface NumberFieldIncrementProps extends PrimitivePropsWithRef<'button'> {
+}
+/** Props for {@link NumberFieldDecrement}, a button that lowers the value by one `step`. */
+export interface NumberFieldDecrementProps extends PrimitivePropsWithRef<'button'> {
+}

package/dist/pagination/Pagination.cjs

@@ -0,0 +1 @@
+"use strict";var pi=Object.create;var l=Object.defineProperty;var gi=Object.getOwnPropertyDescriptor;var li=Object.getOwnPropertyNames;var fi=Object.getPrototypeOf,ci=Object.prototype.hasOwnProperty;var di=(i,a)=>{for(var t in a)l(i,t,{get:a[t],enumerable:!0})},u=(i,a,t,o)=>{if(a&&typeof a=="object"||typeof a=="function")for(let n of li(a))!ci.call(i,n)&&n!==t&&l(i,n,{get:()=>a[n],enumerable:!(o=gi(a,n))||o.enumerable});return i};var m=(i,a,t)=>(t=i!=null?pi(fi(i)):{},u(a||!i||!i.__esModule?l(t,"default",{value:i,enumerable:!0}):t,i)),xi=i=>u(l({},"__esModule",{value:!0}),i);var Ri={};di(Ri,{Pagination:()=>S,PaginationEllipsis:()=>b,PaginationFirst:()=>E,PaginationItem:()=>N,PaginationLast:()=>M,PaginationLink:()=>r,PaginationList:()=>v,PaginationNext:()=>h,PaginationPrevious:()=>y,PaginationProvider:()=>I,getPaginationRange:()=>f,usePaginationContext:()=>e});module.exports=xi(Ri);var c=m(require("react"),1),w=require("../utils/createContext.cjs"),H=require("../utils/part.cjs"),d=require("../utils/primitive.cjs"),T=require("../utils/useControllableState.cjs"),F=require("../utils/useRovingFocus.cjs");function R(i,a){return Array.from({length:Math.max(a-i+1,0)},(t,o)=>i+o)}function f({page:i,pageCount:a,siblingCount:t=1,boundaryCount:o=1}){let n=R(1,Math.min(o,a)),s=R(Math.max(a-o+1,o+1),a),g=Math.max(Math.min(i-t,a-o-t*2-1),o+2),P=Math.min(Math.max(i+t,o+t*2+2),s.length>0?s[0]-2:a-1),L=g>o+2?["ellipsis"]:o+1<a-o?[o+1]:[],p=P<a-o-1?["ellipsis"]:a-o>o?[a-o]:[];return[...n,...L,...R(g,P),...p,...s]}var k=require("react/jsx-runtime"),Li="[data-skdx-pagination-item]",[I,e]=(0,w.createSafeContext)("Pagination"),S=c.forwardRef(({pageCount:i,page:a,defaultPage:t=1,onPageChange:o,siblingCount:n=1,boundaryCount:s=1,"aria-label":g="Pagination",...P},L)=>{let[p=1,si]=(0,T.useControllableState)({prop:a,defaultProp:t,onChange:o}),mi=c.useMemo(()=>f({page:p,pageCount:i,siblingCount:n,boundaryCount:s}),[p,i,n,s]),Pi=(0,F.useRovingFocus)({orientation:"horizontal",loop:!1,itemSelector:Li});return(0,k.jsx)(I,{page:p,pageCount:i,pages:mi,onPageChange:si,children:(0,k.jsx)(d.Primitive.nav,{"aria-label":g,...P,...(0,H.skdxPart)("pagination","root",P.className),ref:L,onKeyDown:(0,d.composeEventHandlers)(P.onKeyDown,Pi)})})});S.displayName="Pagination";var B=m(require("react"),1),G=require("../utils/part.cjs"),O=require("../utils/primitive.cjs"),D=require("react/jsx-runtime"),v=B.forwardRef((i,a)=>(0,D.jsx)(O.Primitive.ul,{...i,...(0,G.skdxPart)("pagination","list",i.className),ref:a}));v.displayName="PaginationList";var K=m(require("react"),1),V=require("../utils/part.cjs"),_=require("../utils/primitive.cjs"),z=require("react/jsx-runtime"),N=K.forwardRef((i,a)=>(0,z.jsx)(_.Primitive.li,{...i,...(0,V.skdxPart)("pagination","item",i.className),ref:a}));N.displayName="PaginationItem";var A=m(require("react"),1),U=require("../utils/part.cjs"),x=require("../utils/primitive.cjs");var q=require("react/jsx-runtime"),r=A.forwardRef(({page:i,isActive:a,...t},o)=>{let n=e("PaginationLink"),s=a??n.page===i;return(0,q.jsx)(x.Primitive.button,{type:"button","data-skdx-pagination-item":"","aria-current":s?"page":void 0,"data-state":s?"active":void 0,"data-disabled":t.disabled?"":void 0,...t,...(0,U.skdxPart)("pagination","link",t.className),ref:o,onClick:(0,x.composeEventHandlers)(t.onClick,()=>{t.disabled||n.onPageChange(i)}),children:t.children??i})});r.displayName="PaginationLink";var J=m(require("react"),1),Q=require("../utils/part.cjs");var W=require("react/jsx-runtime"),y=J.forwardRef((i,a)=>{let t=e("PaginationPrevious"),o=t.page<=1;return(0,W.jsx)(r,{page:t.page-1,"aria-label":"Go to previous page",disabled:o,...i,...(0,Q.skdxPart)("pagination","previous",i.className),ref:a,children:i.children??"Previous"})});y.displayName="PaginationPrevious";var X=m(require("react"),1),Y=require("../utils/part.cjs");var Z=require("react/jsx-runtime"),h=X.forwardRef((i,a)=>{let t=e("PaginationNext"),o=t.page>=t.pageCount;return(0,Z.jsx)(r,{page:t.page+1,"aria-label":"Go to next page",disabled:o,...i,...(0,Y.skdxPart)("pagination","next",i.className),ref:a,children:i.children??"Next"})});h.displayName="PaginationNext";var $=m(require("react"),1),C=require("../utils/part.cjs");var j=require("react/jsx-runtime"),E=$.forwardRef((i,a)=>{let o=e("PaginationFirst").page<=1;return(0,j.jsx)(r,{page:1,"aria-label":"Go to first page",disabled:o,...i,...(0,C.skdxPart)("pagination","first",i.className),ref:a,children:i.children??"First"})});E.displayName="PaginationFirst";var ii=m(require("react"),1),ai=require("../utils/part.cjs");var ti=require("react/jsx-runtime"),M=ii.forwardRef((i,a)=>{let t=e("PaginationLast"),o=t.page>=t.pageCount;return(0,ti.jsx)(r,{page:t.pageCount,"aria-label":"Go to last page",disabled:o,...i,...(0,ai.skdxPart)("pagination","last",i.className),ref:a,children:i.children??"Last"})});M.displayName="PaginationLast";var oi=m(require("react"),1),ni=require("../utils/part.cjs"),ei=require("../utils/primitive.cjs"),ri=require("react/jsx-runtime"),b=oi.forwardRef(({children:i,...a},t)=>(0,ri.jsx)(ei.Primitive.span,{role:"presentation","aria-hidden":"true",...a,...(0,ni.skdxPart)("pagination","ellipsis",a.className),ref:t,children:i??"\u2026"}));b.displayName="PaginationEllipsis";0&&(module.exports={Pagination,PaginationEllipsis,PaginationFirst,PaginationItem,PaginationLast,PaginationLink,PaginationList,PaginationNext,PaginationPrevious,PaginationProvider,getPaginationRange,usePaginationContext});

package/dist/pagination/Pagination.d.cts

@@ -0,0 +1,44 @@
+import * as React from 'react';
+import type { PaginationContextValue, PaginationProps } from './types.cjs';
+export declare const PaginationProvider: {
+    (props: PaginationContextValue & {
+        children: React.ReactNode;
+    }): React.JSX.Element;
+    displayName: string;
+}, usePaginationContext: (consumerName: string) => PaginationContextValue;
+/**
+ * Root of a pagination control: owns the current page and hands it down to
+ * `PaginationLink` / `PaginationPrevious` / `PaginationNext` via context.
+ * Renders a `<nav>` labelled `"Pagination"` by default (override via
+ * `aria-label`) with roving-focus arrow-key navigation (horizontal,
+ * non-looping) across items marked `data-skdx-pagination-item`.
+ *
+ * Works controlled (`page` + `onPageChange`) or uncontrolled (`defaultPage`).
+ *
+ * The root also publishes the collapsed page model — `siblingCount` pages
+ * either side of the current one, `boundaryCount` at each end, `'ellipsis'` for
+ * every collapsed run — on its context as `pages`, so the strip is a `map()`
+ * rather than hand-placed `PaginationEllipsis` elements. Read it with
+ * `usePaginationContext`, or compute it yourself with `getPaginationRange`.
+ *
+ * @example
+ * ```tsx
+ * <Pagination pageCount={10} defaultPage={1}>
+ *   <PaginationList>
+ *     <PaginationItem>
+ *       <PaginationPrevious />
+ *     </PaginationItem>
+ *     <PaginationItem>
+ *       <PaginationLink page={1} isActive>1</PaginationLink>
+ *     </PaginationItem>
+ *     <PaginationItem>
+ *       <PaginationEllipsis />
+ *     </PaginationItem>
+ *     <PaginationItem>
+ *       <PaginationNext />
+ *     </PaginationItem>
+ *   </PaginationList>
+ * </Pagination>
+ * ```
+ */
+export declare const Pagination: React.ForwardRefExoticComponent<Omit<PaginationProps, "ref"> & React.RefAttributes<HTMLElement>>;

package/dist/pagination/Pagination.d.ts

@@ -0,0 +1,44 @@
+import * as React from 'react';
+import type { PaginationContextValue, PaginationProps } from './types.js';
+export declare const PaginationProvider: {
+    (props: PaginationContextValue & {
+        children: React.ReactNode;
+    }): React.JSX.Element;
+    displayName: string;
+}, usePaginationContext: (consumerName: string) => PaginationContextValue;
+/**
+ * Root of a pagination control: owns the current page and hands it down to
+ * `PaginationLink` / `PaginationPrevious` / `PaginationNext` via context.
+ * Renders a `<nav>` labelled `"Pagination"` by default (override via
+ * `aria-label`) with roving-focus arrow-key navigation (horizontal,
+ * non-looping) across items marked `data-skdx-pagination-item`.
+ *
+ * Works controlled (`page` + `onPageChange`) or uncontrolled (`defaultPage`).
+ *
+ * The root also publishes the collapsed page model — `siblingCount` pages
+ * either side of the current one, `boundaryCount` at each end, `'ellipsis'` for
+ * every collapsed run — on its context as `pages`, so the strip is a `map()`
+ * rather than hand-placed `PaginationEllipsis` elements. Read it with
+ * `usePaginationContext`, or compute it yourself with `getPaginationRange`.
+ *
+ * @example
+ * ```tsx
+ * <Pagination pageCount={10} defaultPage={1}>
+ *   <PaginationList>
+ *     <PaginationItem>
+ *       <PaginationPrevious />
+ *     </PaginationItem>
+ *     <PaginationItem>
+ *       <PaginationLink page={1} isActive>1</PaginationLink>
+ *     </PaginationItem>
+ *     <PaginationItem>
+ *       <PaginationEllipsis />
+ *     </PaginationItem>
+ *     <PaginationItem>
+ *       <PaginationNext />
+ *     </PaginationItem>
+ *   </PaginationList>
+ * </Pagination>
+ * ```
+ */
+export declare const Pagination: React.ForwardRefExoticComponent<Omit<PaginationProps, "ref"> & React.RefAttributes<HTMLElement>>;

package/dist/pagination/Pagination.js

@@ -0,0 +1 @@
+import*as g from"react";import{createSafeContext as B}from"../utils/createContext.js";import{skdxPart as G}from"../utils/part.js";import{composeEventHandlers as O,Primitive as D}from"../utils/primitive.js";import{useControllableState as K}from"../utils/useControllableState.js";import{useRovingFocus as V}from"../utils/useRovingFocus.js";function f(i,a){return Array.from({length:Math.max(a-i+1,0)},(t,o)=>i+o)}function c({page:i,pageCount:a,siblingCount:t=1,boundaryCount:o=1}){let s=f(1,Math.min(o,a)),r=f(Math.max(a-o+1,o+1),a),p=Math.max(Math.min(i-t,a-o-t*2-1),o+2),m=Math.min(Math.max(i+t,o+t*2+2),r.length>0?r[0]-2:a-1),l=p>o+2?["ellipsis"]:o+1<a-o?[o+1]:[],P=m<a-o-1?["ellipsis"]:a-o>o?[a-o]:[];return[...s,...l,...f(p,m),...P,...r]}import{jsx as d}from"react/jsx-runtime";var _="[data-skdx-pagination-item]",[z,n]=B("Pagination"),A=g.forwardRef(({pageCount:i,page:a,defaultPage:t=1,onPageChange:o,siblingCount:s=1,boundaryCount:r=1,"aria-label":p="Pagination",...m},l)=>{let[P=1,F]=K({prop:a,defaultProp:t,onChange:o}),I=g.useMemo(()=>c({page:P,pageCount:i,siblingCount:s,boundaryCount:r}),[P,i,s,r]),S=V({orientation:"horizontal",loop:!1,itemSelector:_});return d(z,{page:P,pageCount:i,pages:I,onPageChange:F,children:d(D.nav,{"aria-label":p,...m,...G("pagination","root",m.className),ref:l,onKeyDown:O(m.onKeyDown,S)})})});A.displayName="Pagination";import*as x from"react";import{skdxPart as U}from"../utils/part.js";import{Primitive as q}from"../utils/primitive.js";import{jsx as J}from"react/jsx-runtime";var L=x.forwardRef((i,a)=>J(q.ul,{...i,...U("pagination","list",i.className),ref:a}));L.displayName="PaginationList";import*as R from"react";import{skdxPart as Q}from"../utils/part.js";import{Primitive as W}from"../utils/primitive.js";import{jsx as X}from"react/jsx-runtime";var k=R.forwardRef((i,a)=>X(W.li,{...i,...Q("pagination","item",i.className),ref:a}));k.displayName="PaginationItem";import*as v from"react";import{skdxPart as Y}from"../utils/part.js";import{composeEventHandlers as Z,Primitive as $}from"../utils/primitive.js";import{jsx as C}from"react/jsx-runtime";var e=v.forwardRef(({page:i,isActive:a,...t},o)=>{let s=n("PaginationLink"),r=a??s.page===i;return C($.button,{type:"button","data-skdx-pagination-item":"","aria-current":r?"page":void 0,"data-state":r?"active":void 0,"data-disabled":t.disabled?"":void 0,...t,...Y("pagination","link",t.className),ref:o,onClick:Z(t.onClick,()=>{t.disabled||s.onPageChange(i)}),children:t.children??i})});e.displayName="PaginationLink";import*as N from"react";import{skdxPart as j}from"../utils/part.js";import{jsx as ii}from"react/jsx-runtime";var y=N.forwardRef((i,a)=>{let t=n("PaginationPrevious"),o=t.page<=1;return ii(e,{page:t.page-1,"aria-label":"Go to previous page",disabled:o,...i,...j("pagination","previous",i.className),ref:a,children:i.children??"Previous"})});y.displayName="PaginationPrevious";import*as h from"react";import{skdxPart as ai}from"../utils/part.js";import{jsx as ti}from"react/jsx-runtime";var E=h.forwardRef((i,a)=>{let t=n("PaginationNext"),o=t.page>=t.pageCount;return ti(e,{page:t.page+1,"aria-label":"Go to next page",disabled:o,...i,...ai("pagination","next",i.className),ref:a,children:i.children??"Next"})});E.displayName="PaginationNext";import*as M from"react";import{skdxPart as oi}from"../utils/part.js";import{jsx as ni}from"react/jsx-runtime";var b=M.forwardRef((i,a)=>{let o=n("PaginationFirst").page<=1;return ni(e,{page:1,"aria-label":"Go to first page",disabled:o,...i,...oi("pagination","first",i.className),ref:a,children:i.children??"First"})});b.displayName="PaginationFirst";import*as u from"react";import{skdxPart as ei}from"../utils/part.js";import{jsx as ri}from"react/jsx-runtime";var w=u.forwardRef((i,a)=>{let t=n("PaginationLast"),o=t.page>=t.pageCount;return ri(e,{page:t.pageCount,"aria-label":"Go to last page",disabled:o,...i,...ei("pagination","last",i.className),ref:a,children:i.children??"Last"})});w.displayName="PaginationLast";import*as H from"react";import{skdxPart as si}from"../utils/part.js";import{Primitive as mi}from"../utils/primitive.js";import{jsx as Pi}from"react/jsx-runtime";var T=H.forwardRef(({children:i,...a},t)=>Pi(mi.span,{role:"presentation","aria-hidden":"true",...a,...si("pagination","ellipsis",a.className),ref:t,children:i??"\u2026"}));T.displayName="PaginationEllipsis";export{A as Pagination,T as PaginationEllipsis,b as PaginationFirst,k as PaginationItem,w as PaginationLast,e as PaginationLink,L as PaginationList,E as PaginationNext,y as PaginationPrevious,z as PaginationProvider,c as getPaginationRange,n as usePaginationContext};

package/dist/pagination/PaginationEllipsis.d.cts

@@ -0,0 +1,15 @@
+import * as React from 'react';
+import type { PaginationEllipsisProps } from './types.cjs';
+/**
+ * Placeholder standing in for a run of collapsed page numbers: renders a
+ * `<span>` with `role="presentation"` and `aria-hidden="true"`. Defaults to
+ * `…`; pass `children` to override.
+ *
+ * @example
+ * ```tsx
+ * <PaginationItem>
+ *   <PaginationEllipsis />
+ * </PaginationItem>
+ * ```
+ */
+export declare const PaginationEllipsis: React.ForwardRefExoticComponent<Omit<PaginationEllipsisProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;

package/dist/pagination/PaginationEllipsis.d.ts

@@ -0,0 +1,15 @@
+import * as React from 'react';
+import type { PaginationEllipsisProps } from './types.js';
+/**
+ * Placeholder standing in for a run of collapsed page numbers: renders a
+ * `<span>` with `role="presentation"` and `aria-hidden="true"`. Defaults to
+ * `…`; pass `children` to override.
+ *
+ * @example
+ * ```tsx
+ * <PaginationItem>
+ *   <PaginationEllipsis />
+ * </PaginationItem>
+ * ```
+ */
+export declare const PaginationEllipsis: React.ForwardRefExoticComponent<Omit<PaginationEllipsisProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;

package/dist/pagination/PaginationFirst.d.cts

@@ -0,0 +1,14 @@
+import * as React from 'react';
+import type { PaginationFirstProps } from './types.cjs';
+/**
+ * A {@link PaginationLink} preconfigured for page 1, labelled `"Go to first
+ * page"` and automatically disabled while it is already the current page.
+ *
+ * @example
+ * ```tsx
+ * <PaginationItem>
+ *   <PaginationFirst />
+ * </PaginationItem>
+ * ```
+ */
+export declare const PaginationFirst: React.ForwardRefExoticComponent<Omit<PaginationFirstProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

package/dist/pagination/PaginationFirst.d.ts

@@ -0,0 +1,14 @@
+import * as React from 'react';
+import type { PaginationFirstProps } from './types.js';
+/**
+ * A {@link PaginationLink} preconfigured for page 1, labelled `"Go to first
+ * page"` and automatically disabled while it is already the current page.
+ *
+ * @example
+ * ```tsx
+ * <PaginationItem>
+ *   <PaginationFirst />
+ * </PaginationItem>
+ * ```
+ */
+export declare const PaginationFirst: React.ForwardRefExoticComponent<Omit<PaginationFirstProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

package/dist/pagination/PaginationItem.d.cts

@@ -0,0 +1,15 @@
+import * as React from 'react';
+import type { PaginationItemProps } from './types.cjs';
+/**
+ * A single `<li>` wrapper around a {@link PaginationLink},
+ * {@link PaginationPrevious}, {@link PaginationNext}, or
+ * {@link PaginationEllipsis}.
+ *
+ * @example
+ * ```tsx
+ * <PaginationItem>
+ *   <PaginationLink page={2}>2</PaginationLink>
+ * </PaginationItem>
+ * ```
+ */
+export declare const PaginationItem: React.ForwardRefExoticComponent<Omit<PaginationItemProps, "ref"> & React.RefAttributes<HTMLLIElement>>;

package/dist/pagination/PaginationItem.d.ts

@@ -0,0 +1,15 @@
+import * as React from 'react';
+import type { PaginationItemProps } from './types.js';
+/**
+ * A single `<li>` wrapper around a {@link PaginationLink},
+ * {@link PaginationPrevious}, {@link PaginationNext}, or
+ * {@link PaginationEllipsis}.
+ *
+ * @example
+ * ```tsx
+ * <PaginationItem>
+ *   <PaginationLink page={2}>2</PaginationLink>
+ * </PaginationItem>
+ * ```
+ */
+export declare const PaginationItem: React.ForwardRefExoticComponent<Omit<PaginationItemProps, "ref"> & React.RefAttributes<HTMLLIElement>>;

package/dist/pagination/PaginationLast.d.cts

@@ -0,0 +1,14 @@
+import * as React from 'react';
+import type { PaginationLastProps } from './types.cjs';
+/**
+ * A {@link PaginationLink} preconfigured for the last page, labelled `"Go to
+ * last page"` and automatically disabled while it is already the current page.
+ *
+ * @example
+ * ```tsx
+ * <PaginationItem>
+ *   <PaginationLast />
+ * </PaginationItem>
+ * ```
+ */
+export declare const PaginationLast: React.ForwardRefExoticComponent<Omit<PaginationLastProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

package/dist/pagination/PaginationLast.d.ts

@@ -0,0 +1,14 @@
+import * as React from 'react';
+import type { PaginationLastProps } from './types.js';
+/**
+ * A {@link PaginationLink} preconfigured for the last page, labelled `"Go to
+ * last page"` and automatically disabled while it is already the current page.
+ *
+ * @example
+ * ```tsx
+ * <PaginationItem>
+ *   <PaginationLast />
+ * </PaginationItem>
+ * ```
+ */
+export declare const PaginationLast: React.ForwardRefExoticComponent<Omit<PaginationLastProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

package/dist/pagination/PaginationLink.d.cts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+import type { PaginationLinkProps } from './types.cjs';
+/**
+ * A page button: renders a `<button type="button">` marked with
+ * `data-skdx-pagination-item` (so the root's roving focus can find it),
+ * `aria-current="page"` and `data-state="active"` when `isActive`, and
+ * `data-disabled` when disabled. Clicking it calls the root's
+ * `onPageChange` with its `page`. Defaults its label to `page` if no
+ * children are given.
+ *
+ * @example
+ * ```tsx
+ * <PaginationLink page={3} isActive>3</PaginationLink>
+ * ```
+ */
+export declare const PaginationLink: React.ForwardRefExoticComponent<Omit<PaginationLinkProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;