panelui-native 0.66.1 → 0.68.0

package/lib/typescript/src/components/message-scroller/message-scroller-math.d.ts

@@ -4,5 +4,15 @@ export declare const MESSAGE_SCROLLER_EDGE_THRESHOLD = 24;
 export declare function distanceFromMessageScrollerTarget(target: MessageScrollerTarget, contentOffsetY: number, contentHeight: number, viewportHeight: number): number;
 /** Whether the control has enough distance to its target edge to be useful. */
 export declare function isMessageScrollerTargetVisible(distance: number): boolean;
+export interface MessageScrollerIndexedItem {
+    messageId: string;
+    scrollAnchor?: boolean;
+}
+/** Index used by initial positioning and id-addressed virtualized jumps. */
+export declare function messageScrollerIndex(items: readonly MessageScrollerIndexedItem[], id: string): number | undefined;
+/** Initial target for a list; `undefined` means use the physical end. */
+export declare function initialMessageScrollerIndex(items: readonly MessageScrollerIndexedItem[], position: 'start' | 'end' | 'last-anchor'): number | undefined;
+/** Anchor at or before the first visible virtualized row. */
+export declare function messageScrollerAnchorAt(items: readonly MessageScrollerIndexedItem[], firstVisibleIndex: number): string | null;
 export {};
 //# sourceMappingURL=message-scroller-math.d.ts.map

package/lib/typescript/src/components/message-scroller/message-scroller-math.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-scroller-math.d.ts","sourceRoot":"","sources":["../../../../../src/components/message-scroller/message-scroller-math.ts"],"names":[],"mappings":"AAAA,KAAK,qBAAqB,GAAG,OAAO,GAAG,KAAK,CAAC;AAE7C,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAElD,oEAAoE;AACpE,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,qBAAqB,EAC7B,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,MAAM,CAMR;AAED,+EAA+E;AAC/E,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIxE"}
+{"version":3,"file":"message-scroller-math.d.ts","sourceRoot":"","sources":["../../../../../src/components/message-scroller/message-scroller-math.ts"],"names":[],"mappings":"AAAA,KAAK,qBAAqB,GAAG,OAAO,GAAG,KAAK,CAAC;AAE7C,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAElD,oEAAoE;AACpE,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,qBAAqB,EAC7B,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,MAAM,CAMR;AAED,+EAA+E;AAC/E,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIxE;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,0BAA0B,EAAE,EAC5C,EAAE,EAAE,MAAM,GACT,MAAM,GAAG,SAAS,CAGpB;AAED,yEAAyE;AACzE,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,SAAS,0BAA0B,EAAE,EAC5C,QAAQ,EAAE,OAAO,GAAG,KAAK,GAAG,aAAa,GACxC,MAAM,GAAG,SAAS,CAOpB;AAED,6DAA6D;AAC7D,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,0BAA0B,EAAE,EAC5C,iBAAiB,EAAE,MAAM,GACxB,MAAM,GAAG,IAAI,CAKf"}

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

@@ -0,0 +1,270 @@
+import { View, type ViewProps } from 'react-native';
+import { type VariantProps } from 'tailwind-variants';
+import { type MeterColor, type MeterThreshold } from './meter-scale.js';
+declare const meterVariants: import("tailwind-variants").TVReturnType<{
+    color: {
+        primary: {
+            track: string;
+            indicator: string;
+            segment: string;
+        };
+        success: {
+            track: string;
+            indicator: string;
+            segment: string;
+        };
+        warning: {
+            track: string;
+            indicator: string;
+            segment: string;
+        };
+        destructive: {
+            track: string;
+            indicator: string;
+            segment: string;
+        };
+        info: {
+            track: string;
+            indicator: string;
+            segment: string;
+        };
+        muted: {
+            track: string;
+            indicator: string;
+            segment: string;
+        };
+    };
+    size: {
+        sm: {
+            track: string;
+            segments: string;
+            segment: string;
+        };
+        md: {
+            track: string;
+            segments: string;
+            segment: string;
+        };
+        lg: {
+            track: string;
+            segments: string;
+            segment: string;
+        };
+    };
+}, {
+    root: string;
+    header: string;
+    track: string;
+    indicator: string;
+    segments: string;
+    segment: string;
+}, undefined, {
+    color: {
+        primary: {
+            track: string;
+            indicator: string;
+            segment: string;
+        };
+        success: {
+            track: string;
+            indicator: string;
+            segment: string;
+        };
+        warning: {
+            track: string;
+            indicator: string;
+            segment: string;
+        };
+        destructive: {
+            track: string;
+            indicator: string;
+            segment: string;
+        };
+        info: {
+            track: string;
+            indicator: string;
+            segment: string;
+        };
+        muted: {
+            track: string;
+            indicator: string;
+            segment: string;
+        };
+    };
+    size: {
+        sm: {
+            track: string;
+            segments: string;
+            segment: string;
+        };
+        md: {
+            track: string;
+            segments: string;
+            segment: string;
+        };
+        lg: {
+            track: string;
+            segments: string;
+            segment: string;
+        };
+    };
+}, {
+    root: string;
+    header: string;
+    track: string;
+    indicator: string;
+    segments: string;
+    segment: string;
+}, import("tailwind-variants").TVReturnType<{
+    color: {
+        primary: {
+            track: string;
+            indicator: string;
+            segment: string;
+        };
+        success: {
+            track: string;
+            indicator: string;
+            segment: string;
+        };
+        warning: {
+            track: string;
+            indicator: string;
+            segment: string;
+        };
+        destructive: {
+            track: string;
+            indicator: string;
+            segment: string;
+        };
+        info: {
+            track: string;
+            indicator: string;
+            segment: string;
+        };
+        muted: {
+            track: string;
+            indicator: string;
+            segment: string;
+        };
+    };
+    size: {
+        sm: {
+            track: string;
+            segments: string;
+            segment: string;
+        };
+        md: {
+            track: string;
+            segments: string;
+            segment: string;
+        };
+        lg: {
+            track: string;
+            segments: string;
+            segment: string;
+        };
+    };
+}, {
+    root: string;
+    header: string;
+    track: string;
+    indicator: string;
+    segments: string;
+    segment: string;
+}, undefined, unknown, unknown, undefined>>;
+type MeterVariantProps = VariantProps<typeof meterVariants>;
+export interface MeterProps extends Omit<ViewProps, 'children'>, MeterVariantProps {
+    className?: string;
+    /** The measurement, somewhere between `minValue` and `maxValue`. */
+    value: number;
+    /**
+     * The bottom of the scale — the value at which the bar reads as empty.
+     * Defaults to `0`.
+     */
+    minValue?: number;
+    /**
+     * The top of the scale — the value at which the bar reads as full. Defaults
+     * to `100`, so a bare percentage needs neither bound set.
+     */
+    maxValue?: number;
+    /**
+     * What is being measured. Also the accessibility label, and a meter without
+     * one announces a number with nothing attached to it — "seventy-five
+     * percent" of what is not an answer. Pass `accessibilityLabel` instead only
+     * where the caption is drawn some other way.
+     */
+    label?: string;
+    /** Draw the value above the track, opposite the label. */
+    showValueLabel?: boolean;
+    /**
+     * Text for the value label. Overrides the formatted value — use it for a
+     * word where a number reads worse: `Strong`, `Almost full`.
+     *
+     * It is spoken whether or not it is drawn, so it can give a screen reader
+     * better words than the caption without changing the caption. Pair it with
+     * `showValueLabel` to draw it too.
+     */
+    valueLabel?: string;
+    /**
+     * How to write the value, through `Intl.NumberFormat`. A `percent` style
+     * formats how far up the scale the value sits; every other style formats
+     * the value itself, so `{ style: 'unit', unit: 'gigabyte' }` against a
+     * `maxValue` of `256` reads `64 GB` rather than a percentage of it. Falls
+     * back to a rounded percent when omitted.
+     */
+    formatOptions?: Intl.NumberFormatOptions;
+    /**
+     * Points on the scale where the colour changes, each `{ from, color }`. The
+     * highest one the reading has reached wins, so the order you list them in
+     * does not matter; below all of them the `color` prop applies.
+     *
+     * This is the difference between a meter and a bar: the colour is a
+     * judgement about the reading. Which direction is bad is yours to say —
+     * thresholds climbing to `destructive` suit a disk filling up, thresholds
+     * falling to it suit a battery running down.
+     */
+    thresholds?: MeterThreshold[];
+    /**
+     * Draw the scale as this many discrete blocks instead of one continuous
+     * bar. Blocks are all or nothing, which is the point of them: four blocks
+     * say "three out of four" where a bar says "about seventy percent", and a
+     * password is not seventy percent strong.
+     *
+     * Any value above the floor lights at least one block, so a reading that
+     * is not empty never looks it.
+     */
+    segments?: number;
+    /** Extra classes for the fill, or for a lit segment. */
+    indicatorClassName?: string;
+    /** Extra classes for the label + value row. */
+    headerClassName?: string;
+}
+/**
+ * A measurement on a fixed scale: disk used, battery left, a score, a password's
+ * strength. The fill is driven on the UI thread, so a value change costs one
+ * render and nothing per frame.
+ *
+ * A meter is not a progress bar. Progress is a task moving towards an end that
+ * finishing is the point of; a meter is a reading that happens to sit where it
+ * sits, and may go back down. Reach for
+ * [Progress](/docs/components/progress) when something is completing.
+ *
+ * `thresholds` paint the bar by where the reading falls, and `segments` draws
+ * the scale as discrete blocks for readings that are counted rather than
+ * measured.
+ *
+ * The value is read against `minValue` / `maxValue`, which default to 0 and
+ * 100 — so a percentage needs neither. Set them and the meter speaks in
+ * whatever is being measured: bytes, degrees, points. Nothing has to be
+ * converted to a percent on the way in, and the screen reader is told the real
+ * scale rather than a derived one.
+ *
+ * React Native has no meter role, so this announces as a progress bar with its
+ * value, range and unit attached. That is the closest the platform offers, and
+ * it is why `label` matters: the role will not distinguish a reading from a
+ * task, and the name is what does.
+ */
+export declare const Meter: import("react").ForwardRefExoticComponent<MeterProps & import("react").RefAttributes<View>>;
+export type { MeterColor, MeterThreshold };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/meter/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAA0B,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAS5E,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EAML,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,kBAAe,CAAC;AAQvB,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAoCjB,CAAC;AAEH,KAAK,iBAAiB,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,CAAC;AAE5D,MAAM,WAAW,UACf,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EACjC,iBAAiB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC;IACzC;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AA2BD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,KAAK,6FA8HjB,CAAC;AAIF,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC"}

package/lib/typescript/src/components/meter/meter-scale.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Where a reading sits on a meter's scale, and what colour it has earned.
+ *
+ * Kept apart from the component because it is the part that can be wrong
+ * without looking wrong: a threshold picked in the wrong order, or a segment
+ * count that rounds a real reading down to nothing, is a meter that lies
+ * quietly. None of it touches React, so it can be tested on its own.
+ */
+/** The token a meter can be painted with. */
+export type MeterColor = 'primary' | 'success' | 'warning' | 'destructive' | 'info' | 'muted';
+/**
+ * A point on the scale, and the colour the meter takes from there upwards.
+ *
+ * `from` is in the same units as `value` — not a percentage of the range — so
+ * a threshold on a 0–8 GB meter is written in gigabytes.
+ */
+export interface MeterThreshold {
+    /** The value at which this colour takes over. */
+    from: number;
+    /** What the bar is painted with at or above `from`. */
+    color: MeterColor;
+}
+/** `value` held inside the scale, so a stray number cannot escape the track. */
+export declare function clamp(value: number, min: number, max: number): number;
+/**
+ * How far up the scale the value sits, 0–1. An empty or inverted range has no
+ * meaningful position in it, so it reads as empty rather than dividing by zero.
+ */
+export declare function fractionOf(value: number, min: number, max: number): number;
+/**
+ * The colour the reading has earned: the highest threshold at or below the
+ * value, or the base colour when it has reached none of them.
+ *
+ * Highest-wins rather than first-wins, so the caller can list thresholds in
+ * any order and get the same answer. A rule that depended on the order would
+ * make a reordered array a silent behaviour change.
+ */
+export declare function colorFor(value: number, base: MeterColor | undefined, thresholds: MeterThreshold[] | undefined): MeterColor | undefined;
+/**
+ * How many blocks of a segmented meter are lit.
+ *
+ * Rounded up, so any reading above the floor lights at least one. Rounding
+ * down would leave the whole first block of a four-block meter dark, and "a
+ * little" looking like "none" is the reading a meter can least afford to get
+ * wrong.
+ */
+export declare function litSegments(fraction: number, segments: number): number;
+/**
+ * The value caption: an explicit override, an `Intl` rendering, or a rounded
+ * percent.
+ *
+ * A `percent` style is given the fraction, because that is what a percentage
+ * of the scale means; every other style is given the value, because a byte
+ * count or a score is a quantity and not a proportion.
+ */
+export declare function formatValue(value: number, fraction: number, valueLabel?: string, formatOptions?: Intl.NumberFormatOptions): string;
+//# sourceMappingURL=meter-scale.d.ts.map

package/lib/typescript/src/components/meter/meter-scale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meter-scale.d.ts","sourceRoot":"","sources":["../../../../../src/components/meter/meter-scale.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6CAA6C;AAC7C,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,SAAS,GACT,SAAS,GACT,aAAa,GACb,MAAM,GACN,OAAO,CAAC;AAEZ;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,gFAAgF;AAChF,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,UAI5D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,UAIjE;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,UAAU,GAAG,SAAS,EAC5B,UAAU,EAAE,cAAc,EAAE,GAAG,SAAS,0BASzC;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAG7D;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,IAAI,CAAC,mBAAmB,UAazC"}

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

@@ -0,0 +1,274 @@
+/**
+ * Planner — a month of days, each carrying what falls on it.
+ *
+ * ```tsx
+ * const [month, setMonth] = useState(new Date());
+ *
+ * <Planner
+ *   month={month}
+ *   onMonthChange={setMonth}
+ *   entries={renewals}
+ *   categories={[
+ *     { id: 'monthly', label: 'Monthly' },
+ *     { id: 'yearly', label: 'Yearly', colorIndex: 4 },
+ *   ]}
+ * >
+ *   <Planner.Header>
+ *     <Planner.Title />
+ *     <Planner.Today />
+ *     <Planner.Nav />
+ *   </Planner.Header>
+ *   <Planner.Grid />
+ *   <Planner.Legend />
+ *   <Planner.Details>
+ *     {(date, entries) => <Text>{entries.length} on {date.toDateString()}</Text>}
+ *   </Planner.Details>
+ * </Planner>
+ * ```
+ *
+ * ## How it differs from Calendar
+ *
+ * `Calendar` picks a date and answers with one. This shows what is already on
+ * the days and answers with the day you asked about — the selection exists to
+ * open something, not to be submitted.
+ *
+ * ## Why it draws its own Frame
+ *
+ * A month at a glance is a widget: a boundary, a strip along the top carrying
+ * the month and the way through it, and a footer that holds still while the
+ * middle changes. That is `Frame`, so the root renders one instead of leaving
+ * every caller to assemble the same shell. Pass `frame={false}` to drop it,
+ * for a planner in a sheet or a card that already draws its own edge.
+ *
+ * ## Why the grid is always six weeks
+ *
+ * A month can span five weeks or six. Drawn at its natural height the panel
+ * jumps as you page through the year and the days appear to move under your
+ * thumb, so the grid is always six rows and the last one is sometimes all
+ * next month. `Calendar` fixes its height for the same reason.
+ *
+ * ## Why a day says more than its date
+ *
+ * The marker on a day is a coloured dot, and colour is a signal that does not
+ * reach everyone looking at it. So the legend prints its label beside every
+ * swatch, and a day is spoken as its date, how many entries it carries and
+ * which categories they belong to. Neither is decoration: between them they
+ * are the whole content of the grid for somebody who cannot see it.
+ */
+import { type ReactNode } from 'react';
+import { View, type ViewProps } from 'react-native';
+import { type TextProps } from '../../primitives/text.js';
+import { type CalendarSystem, type DateLocale } from '../../utils/date.js';
+import { type PlannerCountedCategory } from './planner-entries.js';
+/** One thing that falls on a day. */
+export interface PlannerEntry {
+    /** Stable across renders; it keys the cell's contents. */
+    id: string;
+    /** When it falls. The time of day is kept but not read by the grid. */
+    date: Date;
+    /** Named in the dialog and, through its category, in the day's spoken label. */
+    label: string;
+    /** Matches a `PlannerCategory` id. Without one the entry is still counted. */
+    category?: string;
+    /** Drawn in the cell — a brand mark, an avatar, a glyph. */
+    icon?: ReactNode;
+}
+/** A group of entries: the key to a colour, and a line in the legend. */
+export interface PlannerCategory {
+    id: string;
+    /** Printed beside the swatch, and spoken as part of a day that carries it. */
+    label: string;
+    /**
+     * Which `--color-chart-*` token the dot takes, 1 to 5. Categories without
+     * one are numbered in the order they are declared.
+     */
+    colorIndex?: number;
+    /** An explicit colour, for a brand that is not the theme's to choose. */
+    color?: string;
+}
+export interface PlannerProps extends Omit<ViewProps, 'children'> {
+    className?: string;
+    /** The month on show. Leave it out for an uncontrolled planner. */
+    month?: Date;
+    defaultMonth?: Date;
+    onMonthChange?: (month: Date) => void;
+    /** Everything the planner knows about, in any order and any month. */
+    entries?: PlannerEntry[];
+    /** The colour key. Declaration order is legend order and palette order. */
+    categories?: PlannerCategory[];
+    /** The open day. `null` is none. Leave it out for an uncontrolled planner. */
+    selected?: Date | null;
+    defaultSelected?: Date | null;
+    onSelectedChange?: (date: Date | null) => void;
+    /** Runs before the selection moves, whether or not `Details` is present. */
+    onDayPress?: (date: Date, entries: PlannerEntry[]) => void;
+    /** How many entries a cell draws before it counts the rest. Default `2`. */
+    entryLimit?: number;
+    /** First day of the week, 0 is Sunday. Defaults to the locale's. */
+    weekStartsOn?: number | 'auto';
+    locale?: DateLocale;
+    calendar?: CalendarSystem;
+    /** Draw the surrounding `Frame`. Off for a planner in a sheet or a card. */
+    frame?: boolean;
+    children?: ReactNode;
+}
+export interface PlannerHeaderProps {
+    children?: ReactNode;
+}
+/**
+ * The strip along the top of the frame. Put `Title`, `Today` and `Nav` in it.
+ *
+ * The strip has two ends rather than an even spread. What the month *is* —
+ * its name, and the way back to today — reads from the leading edge; what
+ * *moves* it sits at the trailing edge, under the thumb that reaches for it.
+ * Spaced evenly across a full-width strip they read as three unrelated
+ * controls instead of a label and a pair of buttons.
+ */
+declare function PlannerHeader({ children }: PlannerHeaderProps): import("react").JSX.Element;
+declare namespace PlannerHeader {
+    var displayName: string;
+}
+export interface PlannerTitleProps extends Omit<TextProps, 'children'> {
+    /** Replaces the month name, for a title that says something else. */
+    children?: ReactNode;
+}
+/** The month on show, in the calendar system and locale the grid uses. */
+declare function PlannerTitle({ children, className, ...props }: PlannerTitleProps): import("react").JSX.Element;
+declare namespace PlannerTitle {
+    var displayName: string;
+}
+export interface PlannerTodayProps {
+    /** Replaces the word on the pill. */
+    children?: ReactNode;
+}
+/** Jumps back to the month today is in, and selects nothing. */
+declare function PlannerToday({ children }: PlannerTodayProps): import("react").JSX.Element;
+declare namespace PlannerToday {
+    var displayName: string;
+}
+export interface PlannerNavProps {
+    className?: string;
+}
+/** Back and forward a month. */
+declare function PlannerNav({ className }: PlannerNavProps): import("react").JSX.Element;
+declare namespace PlannerNav {
+    var displayName: string;
+}
+export interface PlannerActionProps {
+    children?: ReactNode;
+}
+/** The trailing end of the header strip, for a button of the caller's. */
+declare function PlannerAction({ children }: PlannerActionProps): import("react").JSX.Element;
+declare namespace PlannerAction {
+    var displayName: string;
+}
+/** What a custom cell is handed. Everything the default cell draws from. */
+export interface PlannerDayState {
+    date: Date;
+    entries: PlannerEntry[];
+    isToday: boolean;
+    isSelected: boolean;
+    isInMonth: boolean;
+}
+export type PlannerDayRenderer = (state: PlannerDayState) => ReactNode;
+export interface PlannerGridProps {
+    className?: string;
+    /** Draws a cell yourself. It is handed the day and what falls on it. */
+    renderDay?: PlannerDayRenderer;
+}
+/**
+ * The weekday row and the six weeks below it.
+ *
+ * React Native has no per-cell grid vocabulary — no `gridcell`, no `row` — so
+ * a screen reader never hears "row three, column five" and cannot fall back on
+ * position for context. Every day therefore carries its own full date, and the
+ * weekday headings are hidden rather than read out 42 times over.
+ */
+declare function PlannerGrid({ className, renderDay }: PlannerGridProps): import("react").JSX.Element;
+declare namespace PlannerGrid {
+    var displayName: string;
+}
+export interface PlannerDayProps {
+    date: Date;
+    renderDay?: PlannerDayRenderer;
+}
+/** One cell. Pressing it selects the day and opens whatever is bound to it. */
+declare function PlannerDay({ date, renderDay }: PlannerDayProps): import("react").JSX.Element;
+declare namespace PlannerDay {
+    var displayName: string;
+}
+export interface PlannerLegendProps {
+    className?: string;
+    /** Print each category's count for the month beside its label. */
+    counts?: boolean;
+    /** Sits at the trailing end — a total, a currency, whatever the month adds to. */
+    children?: ReactNode;
+}
+/**
+ * The key to the dots.
+ *
+ * It prints the label beside every swatch, because a column of coloured dots
+ * with nothing to read them against is a quiz.
+ */
+declare function PlannerLegend({ className, counts, children }: PlannerLegendProps): import("react").JSX.Element;
+declare namespace PlannerLegend {
+    var displayName: string;
+}
+export interface PlannerSummaryProps extends Omit<TextProps, 'children'> {
+    /** Replaces the count, for a total that is money rather than entries. */
+    children?: ReactNode;
+}
+/** What the month adds up to. Counts this month only, never the days either side. */
+declare function PlannerSummary({ children, ...props }: PlannerSummaryProps): import("react").JSX.Element;
+declare namespace PlannerSummary {
+    var displayName: string;
+}
+export interface PlannerFooterProps {
+    className?: string;
+    children?: ReactNode;
+}
+/** The strip along the bottom, for tools that act on the month. */
+declare function PlannerFooter({ className, children }: PlannerFooterProps): import("react").JSX.Element;
+declare namespace PlannerFooter {
+    var displayName: string;
+}
+export interface PlannerDetailsProps {
+    className?: string;
+    /** Title above the children. Defaults to the day's full date. */
+    title?: ReactNode;
+    /**
+     * The line under the title. Defaults to how many entries the day carries,
+     * so the dialog answers "how much of this is there" before it is read.
+     * Pass `null` to drop it.
+     */
+    description?: ReactNode;
+    /** Given the open day and what falls on it. */
+    children: (date: Date, entries: PlannerEntry[]) => ReactNode;
+}
+/**
+ * A dialog bound to the open day.
+ *
+ * The planner owns the grid and the binding; what the dialog says is the
+ * application's, because the contents of a day are its data and not the
+ * component's. Leave it out and `onDayPress` is still called — a planner that
+ * pushes a screen instead of opening a dialog wants that and nothing else.
+ */
+declare function PlannerDetails({ className, title, description, children }: PlannerDetailsProps): import("react").JSX.Element;
+declare namespace PlannerDetails {
+    var displayName: string;
+}
+export declare const Planner: import("react").ForwardRefExoticComponent<PlannerProps & import("react").RefAttributes<View>> & {
+    Header: typeof PlannerHeader;
+    Title: typeof PlannerTitle;
+    Today: typeof PlannerToday;
+    Nav: typeof PlannerNav;
+    Action: typeof PlannerAction;
+    Grid: typeof PlannerGrid;
+    Day: typeof PlannerDay;
+    Legend: typeof PlannerLegend;
+    Summary: typeof PlannerSummary;
+    Footer: typeof PlannerFooter;
+    Details: typeof PlannerDetails;
+};
+export type { PlannerCountedCategory };
+//# sourceMappingURL=index.d.ts.map

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

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