panelui-native 0.36.0 → 0.40.0

package/lib/module/theme/use-theme.js

@@ -19,7 +19,7 @@ import { Uniwind, useUniwind } from 'uniwind';
  *
  * ```js
  * withUniwindConfig(config, {
- *   cssEntryFile: './global.css',
+ *   cssEntryFile: './src/global.css',
  *   extraThemes: ['moon', 'moon-dark', 'grass', 'grass-dark'],
  * });
  * ```

package/lib/typescript/src/components/combobox/index.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Combobox — a text field that filters a list of options as you type.
+ *
+ * The difference from Select is where the typing happens, and it is not a
+ * detail: a Select is a button that opens a list, and its optional filter lives
+ * *inside* the list once it is open. A Combobox is the field itself. You are
+ * already typing when the options appear, which is what you want when the value
+ * is something you know the name of — a city, a repository, a tag — rather than
+ * something you expect to recognise by scrolling.
+ *
+ * ```tsx
+ * <Combobox value={framework} onValueChange={setFramework}>
+ *   <Combobox.Item value="expo" label="Expo" />
+ *   <Combobox.Item value="next" label="Next.js" />
+ * </Combobox>
+ * ```
+ *
+ * ## Two presentations, and why there is no sheet
+ *
+ * `overlay` (default) floats the list above the page through a portal, anchored
+ * under the field and flipped above it when the keyboard leaves no room below.
+ * `inline` expands the list in normal layout flow instead, which is right in a
+ * form where nothing should be covered.
+ *
+ * There is deliberately no sheet presentation. A sheet takes the bottom of the
+ * screen, which is exactly where the keyboard is, and the field you are typing
+ * into would end up behind one or the other. Select can offer a sheet because
+ * its trigger stops mattering once the list is open; a Combobox's never does.
+ *
+ * ## Filtering is yours to turn off
+ *
+ * Filtering happens here by default, matching case-insensitively on any part of
+ * an option's label. That is the whole feature for a list you already have in
+ * hand. When the options come from a server that is doing the matching itself,
+ * pass `filter={false}` and render whatever came back — the field stops second-
+ * guessing results it cannot see the query behind.
+ *
+ * ## Values it does not know about
+ *
+ * `allowCustomValue` lets the typed text become the value when it matches no
+ * option, which is how a tag field works: the list is a set of suggestions
+ * rather than the set of legal answers.
+ */
+import { type ReactNode } from 'react';
+import { type ViewProps } from 'react-native';
+export type ComboboxPresentation = 'overlay' | 'inline';
+/** Which selection shape a `mode` produces. */
+export type ComboboxMode = 'single' | 'multiple';
+export interface ComboboxSelection {
+    single: string | undefined;
+    multiple: string[];
+}
+export interface ComboboxItemProps {
+    value: string;
+    label: string;
+    /**
+     * Shows the option but refuses it. Kept in the list rather than dropped from
+     * it, because an option that vanishes reads as one that never existed.
+     */
+    disabled?: boolean;
+    /** Anything to draw before the label — an avatar, a flag, a status dot. */
+    start?: ReactNode;
+    /** A second line under the label, for what the label alone cannot say. */
+    description?: string;
+}
+/** Declarative option. Rendered inside whichever surface is presenting. */
+declare function ComboboxItem({ value, label, disabled, start, description, }: ComboboxItemProps): import("react").JSX.Element;
+declare namespace ComboboxItem {
+    var displayName: string;
+}
+export interface ComboboxGroupProps {
+    /**
+     * Heading over the run of options. Announced as a header, so a screen reader
+     * reaching the group is told what it is before walking into it.
+     */
+    label?: string;
+    /** Extra classes for the group wrapper. */
+    className?: string;
+    /** Extra classes for the heading. */
+    labelClassName?: string;
+    children: ReactNode;
+}
+/**
+ * A titled run of options.
+ *
+ * Presentational only: a grouped Combobox reports the same values a flat one
+ * would, and `Combobox.Item` needs to know nothing about being inside one.
+ */
+declare function ComboboxGroup({ label, className, labelClassName, children, }: ComboboxGroupProps): import("react").JSX.Element;
+declare namespace ComboboxGroup {
+    var displayName: string;
+}
+export interface ComboboxProps<Mode extends ComboboxMode = 'single'> extends Omit<ViewProps, 'children' | 'onLayout'> {
+    className?: string;
+    /**
+     * One value or several. `multiple` draws the chosen options as removable
+     * chips in front of the input and keeps the list open between picks.
+     */
+    mode?: Mode;
+    /** Controlled selection. Its shape follows `mode`. */
+    value?: ComboboxSelection[Mode];
+    /** Starting selection when uncontrolled. */
+    defaultValue?: ComboboxSelection[Mode];
+    onValueChange?: (value: ComboboxSelection[Mode]) => void;
+    /**
+     * Controlled query — the text actually in the field. Pair it with
+     * `onInputValueChange` when the options are fetched for it.
+     */
+    inputValue?: string;
+    /** Starting query when uncontrolled. */
+    defaultInputValue?: string;
+    onInputValueChange?: (value: string) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    /** Where the options appear. */
+    presentation?: ComboboxPresentation;
+    /**
+     * Narrow the options to the query here. `true` matches case-insensitively on
+     * any part of an option's label; pass a function to match on something else —
+     * a description, an alias list, an initialism.
+     *
+     * Pass `false` when a server is doing the matching: the options you render
+     * are then shown exactly as given, since a second filter over results the
+     * field cannot see the query behind would only remove correct answers.
+     */
+    filter?: boolean | ((option: ComboboxItemProps, query: string) => boolean);
+    /**
+     * Let the typed text become the value when it matches no option, committed on
+     * submit. Turns the list into a set of suggestions rather than the set of
+     * legal answers — which is what a tag field is.
+     */
+    allowCustomValue?: boolean;
+    /** Show a spinner in place of the list. For options still being fetched. */
+    loading?: boolean;
+    /** Shown in place of the list when nothing matches. */
+    emptyMessage?: string;
+    /** Shown in place of the list while `loading`. */
+    loadingMessage?: string;
+    /** Offer a ✕ that clears the query and the selection. */
+    clearable?: boolean;
+    /** Open the list as soon as the field takes focus, before anything is typed. */
+    openOnFocus?: boolean;
+    /** Called when the list opens or closes. */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Width of the floating list. `field` matches the field, `content` sizes to
+     * the longest option, or pass a pixel value. `overlay` only.
+     */
+    contentWidth?: 'field' | 'content' | number;
+    /** Gap between the field and the floating list. `overlay` only. */
+    offset?: number;
+    /** Extra classes for the list surface. */
+    listClassName?: string;
+    /** Accessible name for the field. */
+    accessibilityLabel?: string;
+    children: ReactNode;
+}
+declare function ComboboxRoot<Mode extends ComboboxMode = 'single'>({ className, mode, value, defaultValue, onValueChange, inputValue, defaultInputValue, onInputValueChange, placeholder, disabled, presentation, filter, allowCustomValue, loading, emptyMessage, loadingMessage, clearable, openOnFocus, onOpenChange, contentWidth, offset, listClassName, accessibilityLabel, children, ...props }: ComboboxProps<Mode>): import("react").JSX.Element;
+export declare const Combobox: typeof ComboboxRoot & {
+    Item: typeof ComboboxItem;
+    Group: typeof ComboboxGroup;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/components/combobox/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/combobox/index.tsx"],"names":[],"mappings":"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"}

package/lib/typescript/src/components/form/use-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-field.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/use-field.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAY,CAAC;AAErD,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC;IACT,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC;IAC/E,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3B,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CAChC;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACvE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAChB,IAAI,EAAE,CAAC,EACP,EAAE,QAAQ,EAAE,UAAmB,EAAE,GAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAM,GAC5D,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAgC5B"}
+{"version":3,"file":"use-field.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/use-field.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAY,CAAC;AAErD,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC;IACT,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC;IAC/E,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3B,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CAChC;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACvE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAChB,IAAI,EAAE,CAAC,EACP,EAAE,QAAQ,EAAE,UAAmB,EAAE,GAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAM,GAC5D,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAuD5B"}

package/lib/typescript/src/components/form/use-form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-form.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/use-form.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-form.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/use-form.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/components/heatmap-chart/index.d.ts

@@ -11,6 +11,7 @@
  *
  * ```tsx
  * <HeatmapChart data={weeks}>
+ *   <HeatmapChart.Header title="Contributions" value="1,204" legend />
  *   <HeatmapChart.YAxis />
  *   <HeatmapChart.XAxis />
  *   <HeatmapChart.Cells />
@@ -41,7 +42,7 @@ import { View, type ViewProps } from 'react-native';
  * composition stays a flat list of children instead of four nested slots the
  * caller has to remember the order of.
  */
-type Slot = 'cells' | 'x-axis' | 'y-axis' | 'rules' | 'tooltip' | 'legend';
+type Slot = 'cells' | 'x-axis' | 'y-axis' | 'rules' | 'tooltip' | 'legend' | 'header';
 export type HeatmapLayout = 'fluid' | 'fill';
 /** One bin inside a column — usually a single day. */
 export interface HeatmapBin {
@@ -193,15 +194,22 @@ export interface HeatmapXAxisProps {
      * derived. Return an empty string to leave the column unlabelled.
      */
     formatLabel?: (date: Date, column: number) => string;
+    /**
+     * Column labels, left to right. Overrides the month names — for a grid whose
+     * columns are not weeks, where there is no month to change and so nothing to
+     * emit a label on.
+     */
+    labels?: string[];
 }
 /**
  * Month labels above the grid.
  *
  * A label is emitted where the month changes rather than at a fixed interval,
  * because months are not the same length — spacing them evenly puts "Mar" over
- * a week in February.
+ * a week in February. A grid whose columns are not weeks has no such signal, so
+ * it passes `labels` and gets one over every column.
  */
-declare function HeatmapXAxis({ className, formatLabel }: HeatmapXAxisProps): import("react").JSX.Element;
+declare function HeatmapXAxis({ className, formatLabel, labels: given }: HeatmapXAxisProps): import("react").JSX.Element;
 declare namespace HeatmapXAxis {
     var slot: Slot;
 }
@@ -267,7 +275,47 @@ declare function HeatmapLegend({ className, lessLabel, moreLabel, swatchSize, }:
 declare namespace HeatmapLegend {
     var slot: Slot;
 }
+export interface HeatmapHeaderProps extends ViewProps {
+    className?: string;
+    /** Small line above the value — what the grid is of. */
+    title?: string;
+    /** The readout. The largest thing on the card, and the first thing read. */
+    value?: string;
+    /** One muted line under the value — a period, a total, the held cell. */
+    caption?: string;
+    /**
+     * Draw the ramp along the trailing edge, `Less ▢▢▢▢▢ More`. The key for a
+     * grid that scrolls sideways, where `HeatmapChart.Legend` under the cells
+     * would scroll away with them.
+     */
+    legend?: boolean;
+    /** Text at the low end of the ramp, when `legend` is set. */
+    lessLabel?: string;
+    /** Text at the high end. */
+    moreLabel?: string;
+    /** Trailing slot — a control, a badge, a range picker. Wins over `legend`. */
+    children?: ReactNode;
+}
+/**
+ * The strip above the grid: what the chart is of, what it currently reads, and
+ * what the shading means.
+ *
+ * It belongs to the chart rather than to the card around it because it is about
+ * the *grid* — the number changes as a finger moves across the cells, and the
+ * ramp is the scale the chart itself derived. The card's header is a caption on
+ * the tray the chart sits in; this is the chart introducing itself.
+ *
+ * The value is not derived here. Take it from `onActiveCellChange` and pass the
+ * formatted string down, so one header can show a total when nothing is held
+ * and a day's own count when something is.
+ */
+declare function HeatmapHeader({ className, title, value, caption, legend, lessLabel, moreLabel, children, ...props }: HeatmapHeaderProps): import("react").JSX.Element;
+declare namespace HeatmapHeader {
+    var displayName: string;
+    var slot: Slot;
+}
 export declare const HeatmapChart: import("react").ForwardRefExoticComponent<HeatmapChartProps & import("react").RefAttributes<View>> & {
+    Header: typeof HeatmapHeader;
     Cells: typeof HeatmapCells;
     Separator: typeof HeatmapSeparator;
     XAxis: typeof HeatmapXAxis;

package/lib/typescript/src/components/heatmap-chart/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/heatmap-chart/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/heatmap-chart/index.tsx"],"names":[],"mappings":"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"}

package/lib/typescript/src/components/input/index.d.ts

@@ -27,6 +27,13 @@
  * field, so anything centred on the component as a whole drifts upward the
  * moment a label is added.
  *
+ * Both are pressable. A button dropped in there — a clear ✕, a show-password
+ * eye — gets its own touches, while the padding around it stays transparent so
+ * a tap that misses still lands on the field and puts the caret in it. An icon
+ * that is only decoration should say so with `interactiveContent={false}`,
+ * which gives the whole field back to the caret and takes the icon out of the
+ * accessibility tree.
+ *
  * `InputGroup` is still the right answer for a decorator that is not part of
  * the field — a button attached to its end, a select bolted to its start, an
  * addon with its own background. It measures the same way; it just spans a
@@ -203,11 +210,18 @@ export interface InputProps extends TextInputProps, Omit<InputVariantProps, 'dis
     /** Content inside the field, after the text — an icon, a unit, a count. */
     endContent?: ReactNode;
     /**
-     * Let touches reach the content instead of falling through to the field.
+     * Whether touches reach the content.
+     *
+     * On by default, so a button placed in the field — a clear ✕, a
+     * show-password eye, a unit picker — is pressable without anything else
+     * being passed. Only the content itself takes those touches: the padding
+     * around it is transparent, so a tap that misses the button still lands on
+     * the field and puts the caret in it.
      *
-     * Off by default: an icon is decoration, and a tap anywhere on a field
-     * should put the caret in it rather than hitting a dead spot. Turn it on for
-     * content that does something — a clear button, a show-password toggle.
+     * Turn it off for pure decoration, where the icon should not be a target at
+     * all and every pixel of the field should focus it. That also drops the
+     * content from the accessibility tree, which is right for an icon that only
+     * restates the label.
      */
     interactiveContent?: boolean;
     /**

package/lib/typescript/src/components/input/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/input/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EAAgD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACrF,OAAO,EACL,SAAS,EAGT,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAOtB,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAoC,CAAC;AAShF,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAwEjB,CAAC;AAEH,KAAK,iBAAiB,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,CAAC;AAE5D,MAAM,WAAW,UACf,SAAQ,cAAc,EACpB,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,WAAW,CAAC;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAID,eAAO,MAAM,KAAK,kGA2NjB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/input/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,OAAO,EAAgD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACrF,OAAO,EACL,SAAS,EAGT,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAOtB,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAoC,CAAC;AAShF,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAwEjB,CAAC;AAEH,KAAK,iBAAiB,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,CAAC;AAE5D,MAAM,WAAW,UACf,SAAQ,cAAc,EACpB,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,WAAW,CAAC;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB;;;;;;;;;;;;;OAaG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAID,eAAO,MAAM,KAAK,kGA2NjB,CAAC"}

package/lib/typescript/src/components/pagination/index.d.ts

@@ -0,0 +1,285 @@
+/**
+ * Pagination — moving through a result set one page at a time.
+ *
+ * The component owns the arithmetic and nothing else. Give it how many pages
+ * there are and which one you are on, and it works out which numbers to show,
+ * where the gaps fall, and which controls are dead at the ends; it never fetches
+ * and never slices, because the data is yours.
+ *
+ * ```tsx
+ * <Pagination count={12} page={page} onPageChange={setPage} />
+ * ```
+ *
+ * Three presentations, because a phone is not a desktop:
+ *
+ * - `numbers` — the full run, with the middle folded into ellipses. Fits about
+ *   seven targets across a phone, which is what `siblings` and `boundaries`
+ *   are tuned for.
+ * - `compact` — the two arrows with `3 / 12` between them. Digits and a slash,
+ *   so there is no sentence to translate.
+ * - `simple` — labelled Previous and Next, for a flow you walk rather than
+ *   jump around in: a wizard, an article, a set of onboarding cards.
+ *
+ * Every target is at least 44pt in both axes, and the small size keeps that
+ * reach with `hitSlop` rather than by growing — the row gets denser, the
+ * fingers do not get smaller.
+ *
+ * An ellipsis is a button, not punctuation. A dead 44pt target in the middle of
+ * a row of live ones is a thing people tap and then think is broken, so tapping
+ * one jumps `pageJump` pages that way.
+ *
+ * Given children, the root becomes a row with them on the leading edge and the
+ * controls on the trailing one — which is where `Pagination.Status` goes:
+ *
+ * ```tsx
+ * <Pagination count={12} page={page} onPageChange={setPage} variant="compact">
+ *   <Pagination.Status page={page} pageSize={20} total={240} />
+ * </Pagination>
+ * ```
+ */
+import { type ReactNode } from 'react';
+import { View, type ViewProps } from 'react-native';
+import { type VariantProps } from 'tailwind-variants';
+import { type AnimatedPressableProps } from '../../primitives/animated-pressable.js';
+import { type TextProps } from '../../primitives/text.js';
+export type PaginationVariant = 'numbers' | 'compact' | 'simple';
+export type PaginationSize = 'sm' | 'default';
+declare const paginationVariants: import("tailwind-variants").TVReturnType<{
+    size: {
+        default: {
+            list: string;
+            item: string;
+            itemLabel: string;
+            ellipsis: string;
+            status: string;
+            summary: string;
+        };
+        sm: {
+            list: string;
+            item: string;
+            itemLabel: string;
+            ellipsis: string;
+            status: string;
+            summary: string;
+        };
+    };
+    /** Whether the item is the page you are on. */
+    current: {
+        true: {
+            item: string;
+            itemLabel: string;
+        };
+        false: {
+            itemLabel: string;
+        };
+    };
+    disabled: {
+        true: {
+            item: string;
+        };
+    };
+}, {
+    root: string;
+    list: string;
+    item: string;
+    itemLabel: string;
+    ellipsis: string;
+    status: string;
+    summary: string;
+}, undefined, {
+    size: {
+        default: {
+            list: string;
+            item: string;
+            itemLabel: string;
+            ellipsis: string;
+            status: string;
+            summary: string;
+        };
+        sm: {
+            list: string;
+            item: string;
+            itemLabel: string;
+            ellipsis: string;
+            status: string;
+            summary: string;
+        };
+    };
+    /** Whether the item is the page you are on. */
+    current: {
+        true: {
+            item: string;
+            itemLabel: string;
+        };
+        false: {
+            itemLabel: string;
+        };
+    };
+    disabled: {
+        true: {
+            item: string;
+        };
+    };
+}, {
+    root: string;
+    list: string;
+    item: string;
+    itemLabel: string;
+    ellipsis: string;
+    status: string;
+    summary: string;
+}, import("tailwind-variants").TVReturnType<{
+    size: {
+        default: {
+            list: string;
+            item: string;
+            itemLabel: string;
+            ellipsis: string;
+            status: string;
+            summary: string;
+        };
+        sm: {
+            list: string;
+            item: string;
+            itemLabel: string;
+            ellipsis: string;
+            status: string;
+            summary: string;
+        };
+    };
+    /** Whether the item is the page you are on. */
+    current: {
+        true: {
+            item: string;
+            itemLabel: string;
+        };
+        false: {
+            itemLabel: string;
+        };
+    };
+    disabled: {
+        true: {
+            item: string;
+        };
+    };
+}, {
+    root: string;
+    list: string;
+    item: string;
+    itemLabel: string;
+    ellipsis: string;
+    status: string;
+    summary: string;
+}, undefined, unknown, unknown, undefined>>;
+export type PaginationItemValue = number | 'start-ellipsis' | 'end-ellipsis';
+/**
+ * Which numbers to draw, and where the gaps go.
+ *
+ * The run is a fixed width rather than a sliding window: the same number of
+ * targets whichever page you are on, so the row does not reflow under the
+ * finger as you step through it and the arrow you were aiming at stays put.
+ * `boundaries` pins the ends, `siblings` pads the middle, and a gap of exactly
+ * one page is drawn as that page instead of an ellipsis — a `…` that hides a
+ * single number is longer than the number.
+ *
+ * Exported because a caller sometimes needs the same run for a control of their
+ * own, and two implementations of this would drift.
+ */
+export declare function paginationRange({ count, page, siblings, boundaries, }: {
+    count: number;
+    page: number;
+    siblings?: number;
+    boundaries?: number;
+}): PaginationItemValue[];
+export interface PaginationProps extends Omit<ViewProps, 'children'>, VariantProps<typeof paginationVariants> {
+    className?: string;
+    /**
+     * How many pages there are. Pages are numbered from 1, so this is also the
+     * last page's number.
+     */
+    count: number;
+    /** The page being shown. Pass it to control the component. */
+    page?: number;
+    /** The page to start on when the component keeps its own. Defaults to 1. */
+    defaultPage?: number;
+    /** Called with the page that was asked for, already clamped to `count`. */
+    onPageChange?: (page: number) => void;
+    /** Which presentation to draw. */
+    variant?: PaginationVariant;
+    size?: PaginationSize;
+    /**
+     * How many pages to keep either side of the current one. Raise it on a
+     * tablet, where there is room for a longer run.
+     */
+    siblings?: number;
+    /** How many pages to keep pinned at each end of the run. */
+    boundaries?: number;
+    /**
+     * Show the previous and next arrows. Turning them off leaves the numbers
+     * alone, so only do it where something else moves the page — a swipe, a
+     * scroller reaching its end.
+     */
+    controls?: boolean;
+    /** How far tapping an ellipsis jumps. */
+    pageJump?: number;
+    /** Greys out and deafens the whole row — for a page that is still loading. */
+    disabled?: boolean;
+    /** Labels the row for a screen reader. Defaults to "Pagination". */
+    accessibilityLabel?: string;
+    /** Leading content — a `Pagination.Status`, a page-size control of your own. */
+    children?: ReactNode;
+}
+export interface PaginationItemProps extends Omit<AnimatedPressableProps, 'children' | 'disabled'> {
+    className?: string;
+    /** The page this target goes to. */
+    page: number;
+    /** Styles the number. */
+    labelClassName?: string;
+    children?: ReactNode;
+}
+export interface PaginationPreviousProps extends Omit<AnimatedPressableProps, 'children'> {
+    className?: string;
+    /** Write the word beside the arrow, rather than leaving it as a glyph. */
+    label?: boolean;
+}
+export interface PaginationNextProps extends Omit<AnimatedPressableProps, 'children'> {
+    className?: string;
+    /** Write the word beside the arrow, rather than leaving it as a glyph. */
+    label?: boolean;
+}
+export interface PaginationEllipsisProps extends Omit<AnimatedPressableProps, 'children'> {
+    className?: string;
+    /** Which way the gap runs: `-1` towards page 1, `1` towards the last page. */
+    direction?: -1 | 1;
+    /** How many pages a tap covers. */
+    jump?: number;
+}
+export interface PaginationSummaryProps extends TextProps {
+    className?: string;
+}
+export interface PaginationStatusProps extends TextProps {
+    className?: string;
+    /** Which page the span is counted from. Read from the root when left out. */
+    page?: number;
+    /** How many rows a page holds. Required for the span to be worked out. */
+    pageSize?: number;
+    /** How many rows there are altogether. */
+    total?: number;
+    children?: ReactNode;
+}
+export declare const Pagination: import("react").ForwardRefExoticComponent<PaginationProps & import("react").RefAttributes<View>> & {
+    Item: import("react").ForwardRefExoticComponent<PaginationItemProps & import("react").RefAttributes<View>>;
+    Previous: {
+        ({ ...props }: PaginationPreviousProps): import("react").JSX.Element;
+        displayName: string;
+    };
+    Next: {
+        ({ ...props }: PaginationNextProps): import("react").JSX.Element;
+        displayName: string;
+    };
+    Ellipsis: import("react").ForwardRefExoticComponent<PaginationEllipsisProps & import("react").RefAttributes<View>>;
+    Summary: import("react").ForwardRefExoticComponent<PaginationSummaryProps & import("react").RefAttributes<import("react-native").Text>>;
+    Status: import("react").ForwardRefExoticComponent<PaginationStatusProps & import("react").RefAttributes<import("react-native").Text>>;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/components/pagination/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/pagination/index.tsx"],"names":[],"mappings":"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"}