panelui-native 0.66.1 → 0.71.0

package/lib/typescript/src/components/live-line-chart/live-line-lifecycle.d.ts

@@ -0,0 +1,23 @@
+import type { AppStateStatus } from 'react-native';
+export interface LiveLineReading {
+    time: number;
+    value: number;
+}
+export declare const DEFAULT_LIVE_LINE_WINDOW = 30;
+export declare const DEFAULT_LIVE_LINE_MAX_POINTS = 500;
+export declare function normalizeLiveLineWindow(seconds: number): number;
+export declare function normalizeLiveLineMaxPoints(maxPoints: number): number;
+/**
+ * Builds the one ordered, finite buffer every renderer and interaction reads.
+ * For duplicate timestamps the last input wins, matching a corrected reading
+ * arriving with the same identity as the one it replaces.
+ */
+export declare function normalizeLiveLinePoints<T extends LiveLineReading>(data: readonly T[], maxPoints: number): T[];
+export declare function liveLineClockRuns(options: {
+    paused: boolean;
+    loading: boolean;
+    reducedMotion: boolean;
+    appState: AppStateStatus;
+}): boolean;
+export declare function reconcileLiveLineActivePoint<T extends LiveLineReading>(active: T | null, points: readonly T[]): T | null;
+//# sourceMappingURL=live-line-lifecycle.d.ts.map

package/lib/typescript/src/components/live-line-chart/live-line-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-line-lifecycle.d.ts","sourceRoot":"","sources":["../../../../../src/components/live-line-chart/live-line-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIpE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,eAAe,EAC/D,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,SAAS,EAAE,MAAM,GAChB,CAAC,EAAE,CAUL;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,cAAc,CAAC;CAC1B,GAAG,OAAO,CAOV;AAED,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,eAAe,EACpE,MAAM,EAAE,CAAC,GAAG,IAAI,EAChB,MAAM,EAAE,SAAS,CAAC,EAAE,GACnB,CAAC,GAAG,IAAI,CAGV"}

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

@@ -0,0 +1,73 @@
+/**
+ * Marquee — content that travels across its container and never runs out.
+ *
+ * For a strip of logos, a ticker of prices, a row of testimonials: anything
+ * whose job is to keep moving past a boundary rather than to be scrolled.
+ *
+ * ```tsx
+ * <Marquee spacing={24} speed={40}>
+ *   <View className="flex-row gap-6">
+ *     {sponsors.map((s) => <Logo key={s.id} src={s.logo} />)}
+ *   </View>
+ * </Marquee>
+ * ```
+ *
+ * ## How it loops
+ *
+ * The content is measured once, then laid out end to end enough times to cover
+ * the container twice over. One track holds every copy and it is that track,
+ * not the copies, that moves — a single animated node for any amount of
+ * content. It travels exactly one copy-and-gap and starts over, so the state it
+ * ends on is the state it began on and the seam never shows.
+ *
+ * The travel is a linear timing driven on the UI thread, so it costs nothing
+ * per frame in JavaScript and keeps running while the thread is busy.
+ *
+ * ## Measurement needs room
+ *
+ * The copy that gets measured sits in a hidden scroller, because that is what
+ * lets the content report the width it *wants* rather than the width the
+ * container would give it. Content with no intrinsic size of its own — a child
+ * stretched to `flex-1`, an image with no dimensions — measures as nothing and
+ * the marquee will not start.
+ *
+ * ## Reading direction and reduced motion
+ *
+ * A horizontal marquee travels toward the end of the line, so it reverses in a
+ * right-to-left subtree. `reverse` flips it again from wherever it landed.
+ *
+ * With the operating system set to reduce motion the content is rendered once
+ * and held still. A ticker that never stops is the exact thing that setting is
+ * there to turn off, so this is not a shorter animation — it is none.
+ *
+ * Screen readers get one copy. The rest are duplicates of content already
+ * announced, and hearing a sponsor list four times over is not thoroughness.
+ */
+import { type ReactNode } from 'react';
+import { type ViewProps } from 'react-native';
+export type MarqueeDirection = 'horizontal' | 'vertical';
+export interface MarqueeProps extends Omit<ViewProps, 'children'> {
+    className?: string;
+    /** The content to repeat. Measured once, then tiled along the axis. */
+    children: ReactNode;
+    /**
+     * Travel speed in points per second. 40 by default, which is slow enough
+     * that a word stays readable as it crosses. The cycle time follows from this
+     * and the measured content, so longer content takes proportionally longer
+     * rather than moving faster.
+     */
+    speed?: number;
+    /** Gap between the end of one copy and the start of the next. */
+    spacing?: number;
+    /** Axis the content travels along. */
+    direction?: MarqueeDirection;
+    /**
+     * Send it the other way: toward the start of the line, or upward. Applied
+     * after the reading direction, not instead of it.
+     */
+    reverse?: boolean;
+    /** Set false to hold the content where it is. */
+    playing?: boolean;
+}
+export declare function Marquee({ className, children, speed, spacing, direction, reverse, playing, style, onLayout, ...props }: MarqueeProps): import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/marquee/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACrE,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAmBtB,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,UAAU,CAAC;AAEzD,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,OAAO,CAAC,EACtB,SAAS,EACT,QAAQ,EACR,KAAqB,EACrB,OAAW,EACX,SAAwB,EACxB,OAAe,EACf,OAAc,EACd,KAAK,EACL,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,YAAY,+BAoHd"}

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

@@ -31,8 +31,8 @@
  * Needs a bounded height — from `flex-1` in a column, or an explicit one.
  * Given an unbounded parent it grows to fit its content and never scrolls.
  */
-import { type ReactNode } from 'react';
-import { type ViewProps } from 'react-native';
+import { type ReactElement, type ReactNode } from 'react';
+import { type FlatListProps, type ListRenderItemInfo, type ViewProps } from 'react-native';
 import { type AnimatedScrollViewProps } from 'react-native-reanimated';
 export type MessageScrollerPosition = 'start' | 'end' | 'last-anchor';
 /** Scroll commands, for a control that lives outside the viewport. */
@@ -93,6 +93,33 @@ declare function MessageScrollerViewport({ className, children, ...props }: Mess
 declare namespace MessageScrollerViewport {
     var displayName: string;
 }
+export interface MessageScrollerListItem {
+    /** Stable id used by `scrollToMessage` and as the default React key. */
+    messageId: string;
+    /** Marks the start of a turn for `last-anchor` and visibility reporting. */
+    scrollAnchor?: boolean;
+}
+export interface MessageScrollerListProps<T extends MessageScrollerListItem = MessageScrollerListItem> extends Omit<FlatListProps<T>, 'data' | 'renderItem' | 'keyExtractor' | 'onScroll' | 'onContentSizeChange' | 'onViewableItemsChanged' | 'maintainVisibleContentPosition' | 'onScrollToIndexFailed' | 'onScrollEndDrag' | 'onMomentumScrollEnd' | 'CellRendererComponent'> {
+    className?: string;
+    /** Classes on the virtualized list's padded transcript column. */
+    contentContainerClassName?: string;
+    /**
+     * The complete transcript. Rows outside the native render window stay
+     * unmounted; each item therefore carries its stable navigation metadata.
+     */
+    data: readonly T[];
+    /** Draw one turn from the native list window. */
+    renderItem: (info: ListRenderItemInfo<T>) => ReactElement | null;
+}
+/**
+ * The real virtualized transcript path. Only its render window mounts; native
+ * visible-content maintenance keeps prepends still without measuring offscreen
+ * rows in JavaScript.
+ */
+declare function MessageScrollerList<T extends MessageScrollerListItem>({ className, contentContainerClassName, data, renderItem, initialNumToRender, maxToRenderPerBatch, windowSize, ...props }: MessageScrollerListProps<T>): import("react").JSX.Element;
+declare namespace MessageScrollerList {
+    var displayName: string;
+}
 export interface MessageScrollerContentProps extends ViewProps {
     className?: string;
     children?: ReactNode;
@@ -142,6 +169,7 @@ declare namespace MessageScrollerButton {
 }
 export declare const MessageScroller: typeof MessageScrollerRoot & {
     Viewport: typeof MessageScrollerViewport;
+    List: typeof MessageScrollerList;
     Content: typeof MessageScrollerContent;
     Item: typeof MessageScrollerItem;
     Button: typeof MessageScrollerButton;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/message-scroller/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,EAQL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAiB,EAQf,KAAK,uBAAuB,EAC7B,MAAM,yBAAyB,CAAC;AAmBjC,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,KAAK,GAAG,aAAa,CAAC;AAsCtE,sEAAsE;AACtE,wBAAgB,kBAAkB;6BAlBP,OAAO,KAAK,IAAI;+BACd,OAAO,KAAK,IAAI;0BACrB,MAAM,aAAa,OAAO,KAAK,IAAI;EAmB1D;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B;;;EAG3C;AAED,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,uBAAuB,CAAC;IAChD,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,iBAAS,mBAAmB,CAAC,EAC3B,SAAS,EACT,UAAkB,EAClB,uBAA8B,EAC9B,qBAA6B,EAC7B,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,oBAAoB,+BAoGtB;kBA3GQ,mBAAmB;;;AA8G5B;;;;;GAKG;AACH,MAAM,WAAW,4BACf,SAAQ,IAAI,CACV,uBAAuB,EACvB,UAAU,GAAG,iBAAiB,GAAG,qBAAqB,GAAG,qBAAqB,CAC/E;IACD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;GAGG;AACH,iBAAS,uBAAuB,CAAC,EAC/B,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,4BAA4B,+BA6J9B;kBAjKQ,uBAAuB;;;AAoLhC,MAAM,WAAW,2BAA4B,SAAQ,SAAS;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,6EAA6E;AAC7E,iBAAS,sBAAsB,CAAC,EAC9B,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,2BAA2B,+BAY7B;kBAhBQ,sBAAsB;;;AAmB/B,MAAM,WAAW,wBAAyB,SAAQ,SAAS;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;GAIG;AACH,iBAAS,mBAAmB,CAAC,EAC3B,SAAS,EACT,SAAS,EACT,YAAoB,EACpB,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,wBAAwB,+BAe1B;kBArBQ,mBAAmB;;;AAwB5B,MAAM,WAAW,0BAA2B,SAAQ,SAAS;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,MAAM,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;GAKG;AACH,iBAAS,qBAAqB,CAAC,EAC7B,SAAS,EACT,MAAc,EACd,kBAAkB,EAClB,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,0BAA0B,+BAsD5B;kBA5DQ,qBAAqB;;;AA+D9B,eAAO,MAAM,eAAe;;;;;CAK1B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/message-scroller/index.tsx"],"names":[],"mappings":"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"}

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,273 @@
+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. Values outside the scale are clamped to its ends. */
+    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. Non-finite
+     * `from` values are ignored.
+     *
+     * 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.
+     *
+     * Fractional counts round down and counts above 100 clamp to 100. Invalid,
+     * non-positive, or sub-one counts use the continuous bar. 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;AAavB,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,yEAAyE;IACzE,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;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B;;;;;;;;;;OAUG;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,6FA6IjB,CAAC;AAIF,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC"}

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

@@ -0,0 +1,96 @@
+/**
+ * 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;
+}
+/** A bounded block count keeps malformed input from allocating without limit. */
+export declare const MAX_METER_SEGMENTS = 100;
+export interface MeterScale {
+    min: number;
+    max: number;
+    value: number;
+    fraction: number;
+}
+/**
+ * Make a public scale safe for layout, animation and native accessibility.
+ * Invalid bounds fall back to their documented defaults; if those still do
+ * not produce a positive span, the scale honestly collapses at its floor.
+ */
+export declare function normalizeScale(value: number, min: number, max: number): MeterScale;
+/** Positive counts are whole and bounded; zero means the continuous meter. */
+export declare function normalizeSegments(segments: number | undefined): number;
+/** `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;
+/**
+ * The meter's single spoken contract. Visual treatments such as segments,
+ * thresholds and motion do not belong here: they do not change the reading.
+ */
+export declare function meterSemantics({ value, fraction, minValue, maxValue, label, accessibilityLabel, valueLabel, formatOptions, }: {
+    value: number;
+    fraction: number;
+    minValue: number;
+    maxValue: number;
+    label?: string;
+    accessibilityLabel?: string;
+    valueLabel?: string;
+    formatOptions?: Intl.NumberFormatOptions;
+}): {
+    label: string | undefined;
+    text: string;
+    value: {
+        min: number;
+        max: number;
+        now: number;
+        text: 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,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAuBlF;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,UAG7D;AAED,gFAAgF;AAChF,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,UAE5D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,UAEjE;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,UAAU,GAAG,SAAS,EAC5B,UAAU,EAAE,cAAc,EAAE,GAAG,SAAS,0BAUzC;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAK7D;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;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,kBAAkB,EAClB,UAAU,EACV,aAAa,GACd,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC;CAC1C;;;;;;;;;EAOA"}