panelui-native 0.28.1 → 0.32.0

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

@@ -0,0 +1,274 @@
+/**
+ * Table — rows and columns that stay lined up.
+ *
+ * React Native has no table layout: no `<table>`, no column model, nothing that
+ * makes the third cell of one row the same width as the third cell of the next.
+ * A table here is therefore a stack of flex rows, and the columns exist only
+ * because every row divides its width the same way. That is the one rule the
+ * component cannot enforce for you — `flex` and `width` on a `Table.Head` and
+ * on the `Table.Cell` beneath it have to agree, or the column drifts.
+ *
+ * Everything else it does own: the hairlines between rows and the missing one
+ * under the last, the muted header and footer, the striping, the alignment of a
+ * numeric column, and the sort arrow that turns over rather than swapping.
+ *
+ * ```tsx
+ * <Table variant="outline">
+ *   <Table.Header>
+ *     <Table.Row>
+ *       <Table.Head flex={2}>Invoice</Table.Head>
+ *       <Table.Head align="end" sortDirection="desc" onPress={toggleSort}>
+ *         Amount
+ *       </Table.Head>
+ *     </Table.Row>
+ *   </Table.Header>
+ *   <Table.Body>
+ *     <Table.Row>
+ *       <Table.Cell flex={2}>INV-001</Table.Cell>
+ *       <Table.Cell align="end">$250.00</Table.Cell>
+ *     </Table.Row>
+ *   </Table.Body>
+ * </Table>
+ * ```
+ *
+ * `Table.Frame` is the same table in a widget shell, with the column headings
+ * lifted onto the tray above the card. It takes the whole table and does the
+ * lift itself, so the columns are still declared once.
+ *
+ * A table wider than the phone belongs in a horizontal scroller with a
+ * `minWidth` on the table, not squeezed until the columns are unreadable — wrap
+ * it in `ScrollFade` and the cut edge tells you there is more to the right.
+ *
+ * Long tables belong in a `FlatList` rather than in `Table.Body`, which renders
+ * every row it is given. `Table.Row` takes `index` and `last` directly for that
+ * case, since a virtualised row has no parent to read them from.
+ */
+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';
+type TableSize = 'default' | 'sm';
+type CellAlign = 'start' | 'center' | 'end';
+export type TableSortDirection = 'asc' | 'desc';
+declare const tableVariants: import("tailwind-variants").TVReturnType<{
+    variant: {
+        /** Hairlines only — the table sits directly on the page. */
+        default: {};
+        /** Framed and clipped, for a table that reads as its own card. */
+        outline: {
+            root: string;
+        };
+    };
+    size: {
+        default: {
+            row: string;
+            headLabel: string;
+            cellLabel: string;
+            caption: string;
+        };
+        sm: {
+            row: string;
+            headLabel: string;
+            cellLabel: string;
+            caption: string;
+        };
+    };
+}, {
+    root: string;
+    row: string;
+    head: string;
+    headLabel: string;
+    cell: string;
+    cellLabel: string;
+    caption: string;
+}, undefined, {
+    variant: {
+        /** Hairlines only — the table sits directly on the page. */
+        default: {};
+        /** Framed and clipped, for a table that reads as its own card. */
+        outline: {
+            root: string;
+        };
+    };
+    size: {
+        default: {
+            row: string;
+            headLabel: string;
+            cellLabel: string;
+            caption: string;
+        };
+        sm: {
+            row: string;
+            headLabel: string;
+            cellLabel: string;
+            caption: string;
+        };
+    };
+}, {
+    root: string;
+    row: string;
+    head: string;
+    headLabel: string;
+    cell: string;
+    cellLabel: string;
+    caption: string;
+}, import("tailwind-variants").TVReturnType<{
+    variant: {
+        /** Hairlines only — the table sits directly on the page. */
+        default: {};
+        /** Framed and clipped, for a table that reads as its own card. */
+        outline: {
+            root: string;
+        };
+    };
+    size: {
+        default: {
+            row: string;
+            headLabel: string;
+            cellLabel: string;
+            caption: string;
+        };
+        sm: {
+            row: string;
+            headLabel: string;
+            cellLabel: string;
+            caption: string;
+        };
+    };
+}, {
+    root: string;
+    row: string;
+    head: string;
+    headLabel: string;
+    cell: string;
+    cellLabel: string;
+    caption: string;
+}, undefined, unknown, unknown, undefined>>;
+export interface TableProps extends ViewProps, VariantProps<typeof tableVariants> {
+    className?: string;
+    /**
+     * Row density. `Table.Row`, `Table.Head` and `Table.Cell` follow it, so it
+     * only needs setting here.
+     */
+    size?: TableSize;
+    /**
+     * Tint every other body row. Helps the eye track across a wide row; drop it
+     * for a short table, where the stripes are louder than the data.
+     */
+    striped?: boolean;
+    children?: ReactNode;
+}
+export interface TableHeaderProps extends ViewProps {
+    className?: string;
+    children?: ReactNode;
+}
+export interface TableBodyProps extends ViewProps {
+    className?: string;
+    children?: ReactNode;
+}
+export interface TableFooterProps extends ViewProps {
+    className?: string;
+    children?: ReactNode;
+}
+export interface TableRowProps extends Omit<AnimatedPressableProps, 'children' | 'disabled'> {
+    className?: string;
+    /** Marks the row as the chosen one — for a table you pick from. */
+    selected?: boolean;
+    disabled?: boolean;
+    /**
+     * Position in the section, for a row rendered outside `Table.Body` — a
+     * `FlatList` item, say. Decides which rows a striped table tints.
+     */
+    index?: number;
+    /**
+     * Whether this is the section's final row, for a row rendered outside
+     * `Table.Body`. The last row drops its hairline so it does not double up with
+     * the table's own bottom edge.
+     */
+    last?: boolean;
+    children?: ReactNode;
+}
+export interface TableHeadProps extends Omit<ViewProps, 'children'> {
+    className?: string;
+    /**
+     * Share of the leftover width, relative to the other cells in the row.
+     * Defaults to 1, so columns divide the row evenly. Must match the `flex` on
+     * the cells beneath it.
+     */
+    flex?: number;
+    /**
+     * Fixed width in pixels, for a column that must not move — an icon, a state
+     * dot. Must match the `width` on the cells beneath it.
+     */
+    width?: number;
+    /**
+     * Which edge the column's content sits against. Use `end` for numbers: a
+     * money column reads as a column only when the digits line up.
+     */
+    align?: CellAlign;
+    /**
+     * Show the sort arrow without committing to a direction — the column can be
+     * sorted, but is not the one being sorted by. Implied by `sortDirection`.
+     */
+    sortable?: boolean;
+    /** The direction this column is currently sorted in. Turns the arrow over. */
+    sortDirection?: TableSortDirection;
+    /** Called on a tap. Supplying it makes the header a button. */
+    onPress?: AnimatedPressableProps['onPress'];
+    /** Styles the header's text. */
+    labelClassName?: string;
+    children?: ReactNode;
+}
+export interface TableCellProps extends ViewProps {
+    className?: string;
+    /**
+     * Share of the leftover width, relative to the other cells in the row.
+     * Defaults to 1. Must match the `flex` on the head above it.
+     */
+    flex?: number;
+    /**
+     * Fixed width in pixels, for a column that must not move. Must match the
+     * `width` on the head above it.
+     */
+    width?: number;
+    /** Which edge the cell's content sits against. Match the head above it. */
+    align?: CellAlign;
+    /** Styles the cell's text. */
+    labelClassName?: string;
+    children?: ReactNode;
+}
+export interface TableCaptionProps extends TextProps {
+    className?: string;
+}
+export interface TableEmptyProps extends ViewProps {
+    className?: string;
+    children?: ReactNode;
+}
+export interface TableFrameProps extends Omit<ViewProps, 'children'> {
+    className?: string;
+    /** Caption on the tray, above the column headings. */
+    title?: ReactNode;
+    /** Trailing slot on the title row — a button, a badge, a menu. */
+    action?: ReactNode;
+    /** A line under the title, for what the table is counting. */
+    description?: ReactNode;
+    /** Row density, as on `Table`. */
+    size?: TableSize;
+    /** Tint every other body row, as on `Table`. */
+    striped?: boolean;
+    children?: ReactNode;
+}
+export declare const Table: import("react").ForwardRefExoticComponent<TableProps & import("react").RefAttributes<View>> & {
+    Frame: import("react").ForwardRefExoticComponent<TableFrameProps & import("react").RefAttributes<View>>;
+    Header: import("react").ForwardRefExoticComponent<TableHeaderProps & import("react").RefAttributes<View>>;
+    Body: import("react").ForwardRefExoticComponent<TableBodyProps & import("react").RefAttributes<View>>;
+    Footer: import("react").ForwardRefExoticComponent<TableFooterProps & import("react").RefAttributes<View>>;
+    Row: import("react").ForwardRefExoticComponent<TableRowProps & import("react").RefAttributes<View>>;
+    Head: import("react").ForwardRefExoticComponent<TableHeadProps & import("react").RefAttributes<View>>;
+    Cell: import("react").ForwardRefExoticComponent<TableCellProps & import("react").RefAttributes<View>>;
+    Caption: import("react").ForwardRefExoticComponent<TableCaptionProps & import("react").RefAttributes<import("react-native").Text>>;
+    Empty: import("react").ForwardRefExoticComponent<TableEmptyProps & import("react").RefAttributes<View>>;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,103 @@
+/**
+ * Task — one step an agent took, and what it did while it was there.
+ *
+ * The header is the step; the body is the detail nobody reads unless something
+ * went wrong. Open by default, because a task that is running is the thing the
+ * reader is watching — and it stays open afterwards rather than folding itself
+ * away, because unlike a reasoning trace the steps are the record of what
+ * happened and are worth scrolling back through.
+ *
+ * ```tsx
+ * <Task status="running">
+ *   <Task.Trigger title="Searching the codebase" />
+ *   <Task.Content>
+ *     <Task.Item>
+ *       Read <Task.File>calendar/index.tsx</Task.File>
+ *     </Task.Item>
+ *   </Task.Content>
+ * </Task>
+ * ```
+ *
+ * ## Where the props come from
+ *
+ * With the AI SDK a task is a tool-call part: `part.type` is `tool-<name>` and
+ * `part.state` runs `input-streaming` → `input-available` → `output-available`
+ * or `output-error`. Those map onto `status` as pending, running, complete and
+ * error; `part.input` is usually what the body should say.
+ */
+import { type ReactNode } from 'react';
+import { type PressableProps, type ViewProps } from 'react-native';
+export type TaskStatus = 'pending' | 'running' | 'complete' | 'error';
+export interface TaskProps extends Omit<ViewProps, 'children'> {
+    className?: string;
+    /**
+     * Where the step has got to. Drives the leading glyph, and puts a shimmer on
+     * the title while it is `running`.
+     */
+    status?: TaskStatus;
+    /** Controlled open state. */
+    open?: boolean;
+    /** Initial state when uncontrolled. Open — the steps are the record. */
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    children?: ReactNode;
+}
+declare function TaskRoot({ className, status, open: openProp, defaultOpen, onOpenChange, children, ...props }: TaskProps): import("react").JSX.Element;
+declare namespace TaskRoot {
+    var displayName: string;
+}
+export interface TaskTriggerProps extends Omit<PressableProps, 'children' | 'style'> {
+    className?: string;
+    /** What the step is. Shimmers while the status is `running`. */
+    title?: string;
+    /** Leading glyph. Derived from `status` when not given. */
+    icon?: ReactNode;
+    /** Replaces the whole row. */
+    children?: ReactNode;
+}
+declare function TaskTrigger({ className, title, icon, children, onPress, ...props }: TaskTriggerProps): import("react").JSX.Element;
+declare namespace TaskTrigger {
+    var displayName: string;
+}
+export interface TaskContentProps extends Omit<ViewProps, 'children'> {
+    className?: string;
+    children?: ReactNode;
+}
+declare function TaskContent({ className, children, ...props }: TaskContentProps): import("react").JSX.Element;
+declare namespace TaskContent {
+    var displayName: string;
+}
+export interface TaskItemProps extends Omit<ViewProps, 'children'> {
+    className?: string;
+    children?: ReactNode;
+}
+/** One line of what the step did. */
+declare function TaskItem({ className, children, ...props }: TaskItemProps): import("react").JSX.Element;
+declare namespace TaskItem {
+    var displayName: string;
+}
+export interface TaskFileProps extends Omit<ViewProps, 'children'> {
+    className?: string;
+    /** A glyph for the file's kind, drawn before the name. */
+    icon?: ReactNode;
+    children?: ReactNode;
+}
+/**
+ * A filename inside a line, drawn as a chip.
+ *
+ * Bordered rather than merely monospaced, because a path in the middle of a
+ * sentence is otherwise indistinguishable from the sentence — and the paths
+ * are the part of a task line anyone actually scans for.
+ */
+declare function TaskFile({ className, icon, children, ...props }: TaskFileProps): import("react").JSX.Element;
+declare namespace TaskFile {
+    var displayName: string;
+}
+export declare const Task: typeof TaskRoot & {
+    Trigger: typeof TaskTrigger;
+    Content: typeof TaskContent;
+    Item: typeof TaskItem;
+    File: typeof TaskFile;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/task/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAAmB,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAqBpF,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;AA8CtE,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wEAAwE;IACxE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,iBAAS,QAAQ,CAAC,EAChB,SAAS,EACT,MAAmB,EACnB,IAAI,EAAE,QAAQ,EACd,WAAkB,EAClB,YAAY,EACZ,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,SAAS,+BAuBX;kBA/BQ,QAAQ;;;AAkCjB,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,cAAc,EAAE,UAAU,GAAG,OAAO,CAAC;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,iBAAS,WAAW,CAAC,EACnB,SAAS,EACT,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,GAAG,KAAK,EACT,EAAE,gBAAgB,+BAgDlB;kBAvDQ,WAAW;;;AA+FpB,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,+BASvE;kBATQ,WAAW;;;AAWpB,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,qCAAqC;AACrC,iBAAS,QAAQ,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,+BAUjE;kBAVQ,QAAQ;;;AAYjB,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;GAMG;AACH,iBAAS,QAAQ,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,+BAWvE;kBAXQ,QAAQ;;;AAkBjB,eAAO,MAAM,IAAI;;;;;CAKf,CAAC"}

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

@@ -0,0 +1,175 @@
+import { TextInput, type TextInputProps } from 'react-native';
+import { type VariantProps } from 'tailwind-variants';
+import type { KeyboardAvoidanceMode } from '../../hooks/use-keyboard-avoidance.js';
+declare const textareaVariants: import("tailwind-variants").TVReturnType<{
+    variant: {
+        outline: {
+            field: string;
+        };
+        filled: {
+            field: string;
+        };
+    };
+    size: {
+        sm: {
+            field: string;
+        };
+        md: {
+            field: string;
+        };
+        lg: {
+            field: string;
+        };
+    };
+    disabled: {
+        true: {
+            field: string;
+        };
+    };
+    /** Past the limit the counter is the error, so it is tinted like one. */
+    over: {
+        true: {
+            count: string;
+        };
+    };
+}, {
+    container: string;
+    field: string;
+    footer: string;
+    description: string;
+    error: string;
+    count: string;
+}, undefined, {
+    variant: {
+        outline: {
+            field: string;
+        };
+        filled: {
+            field: string;
+        };
+    };
+    size: {
+        sm: {
+            field: string;
+        };
+        md: {
+            field: string;
+        };
+        lg: {
+            field: string;
+        };
+    };
+    disabled: {
+        true: {
+            field: string;
+        };
+    };
+    /** Past the limit the counter is the error, so it is tinted like one. */
+    over: {
+        true: {
+            count: string;
+        };
+    };
+}, {
+    container: string;
+    field: string;
+    footer: string;
+    description: string;
+    error: string;
+    count: string;
+}, import("tailwind-variants").TVReturnType<{
+    variant: {
+        outline: {
+            field: string;
+        };
+        filled: {
+            field: string;
+        };
+    };
+    size: {
+        sm: {
+            field: string;
+        };
+        md: {
+            field: string;
+        };
+        lg: {
+            field: string;
+        };
+    };
+    disabled: {
+        true: {
+            field: string;
+        };
+    };
+    /** Past the limit the counter is the error, so it is tinted like one. */
+    over: {
+        true: {
+            count: string;
+        };
+    };
+}, {
+    container: string;
+    field: string;
+    footer: string;
+    description: string;
+    error: string;
+    count: string;
+}, undefined, unknown, unknown, undefined>>;
+type TextareaVariantProps = VariantProps<typeof textareaVariants>;
+export interface TextareaProps extends Omit<TextInputProps, 'multiline' | 'numberOfLines'>, Omit<TextareaVariantProps, 'disabled' | 'over'> {
+    className?: string;
+    containerClassName?: string;
+    label?: string;
+    description?: string;
+    /** Error message. When set, the field renders in its invalid state. */
+    errorMessage?: string;
+    /** Marks the field required — an asterisk on the label, and the a11y state. */
+    isRequired?: boolean;
+    disabled?: boolean;
+    /** How many lines of text the field is tall before it scrolls or grows. */
+    rows?: number;
+    /**
+     * Grow with the text, one line at a time, up to `maxRows` — after which the
+     * field holds its height and scrolls instead. Without it the field stays at
+     * `rows` and scrolls from the first line past it.
+     */
+    autoGrow?: boolean;
+    /** The tallest `autoGrow` will go. Ignored without it. */
+    maxRows?: number;
+    /**
+     * Show how much of `maxLength` is used, under the field. Needs `maxLength`;
+     * a counter with no limit to count towards says nothing.
+     */
+    showCount?: boolean;
+    /**
+     * Keep the field clear of the software keyboard. Moves by exactly the
+     * overlap, and not at all when the field is already clear — or when the
+     * keyboard belongs to a different field. The overlap is re-read every frame
+     * while the field is focused, so the field keeps its place in the page as it
+     * scrolls under and back out of the keyboard.
+     *
+     * Install `react-native-keyboard-controller` for this to behave on Android.
+     *
+     * Do not toggle this at runtime — it changes which component renders the
+     * container, which would remount the field and drop focus.
+     */
+    avoidKeyboard?: boolean;
+    /**
+     * How the field gets clear. `lift` moves it up by its overlap and follows
+     * the scroll — right for a field in the flow of a page. `dock` makes it
+     * travel with the keyboard, for a composer already pinned near the bottom
+     * edge; pair it with `keyboardBottomInset`.
+     */
+    keyboardMode?: KeyboardAvoidanceMode;
+    /** Gap kept between the field and the keyboard. `keyboardMode="lift"` only. */
+    keyboardOffset?: number;
+    /**
+     * How far above the bottom edge the field already sits — usually the safe
+     * area inset. `keyboardMode="dock"` only.
+     */
+    keyboardBottomInset?: number;
+}
+export declare const Textarea: import("react").ForwardRefExoticComponent<TextareaProps & import("react").RefAttributes<TextInput>>;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/textarea/index.tsx"],"names":[],"mappings":"AAsBA,OAAO,EACL,SAAS,EAIT,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAOtB,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAoC,CAAC;AAsBhF,QAAA,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;IA8BlB,yEAAyE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAAzE,yEAAyE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAAzE,yEAAyE;;;;;;;;;;;;;2CAS3E,CAAC;AAEH,KAAK,oBAAoB,GAAG,YAAY,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAElE,MAAM,WAAW,aACf,SAAQ,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,eAAe,CAAC,EACzD,IAAI,CAAC,oBAAoB,EAAE,UAAU,GAAG,MAAM,CAAC;IACjD,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,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;;;;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,QAAQ,qGA0NpB,CAAC"}

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

@@ -3,9 +3,15 @@
  *
  * A popover is a panel you open and deal with; a tooltip is a whisper. It
  * carries a word or two about what a control does, appears without taking the
- * screen, and goes away on its own. That is why it is inverted rather than
- * surface-coloured, why it is not dismissible with a scrim, and why it closes
- * after a beat instead of waiting to be told.
+ * screen, and goes away on its own. That is why it is inverted by default, why
+ * it is not dismissible with a scrim, and why it closes after a beat instead of
+ * waiting to be told.
+ *
+ * The inversion is a default rather than a rule, because the whisper has a
+ * larger sibling: a tooltip that carries a heading and a sentence stops reading
+ * as a different layer and starts reading as a panel with the wrong colours.
+ * `variant="surface"` makes it one, and the sizing props — `width`,
+ * `minWidth`, `maxHeight`, `scrollable` — are what let it hold that much.
  *
  * On touch there is no hover to open it, so the gesture is a long press by
  * default — the platform's own "tell me more" gesture — with `openOn="press"`
@@ -33,6 +39,7 @@ import { type ViewProps } from 'react-native';
 import { type TextProps } from '../../primitives/text.js';
 export type TooltipPlacement = 'top' | 'bottom' | 'left' | 'right';
 export type TooltipAlign = 'start' | 'center' | 'end';
+export type TooltipVariant = 'inverted' | 'surface';
 export type TooltipOpenOn = 'longPress' | 'press';
 export interface TooltipProps {
     children: ReactNode;
@@ -98,9 +105,58 @@ export interface TooltipContentProps extends ViewProps {
     offset?: number;
     /** Nudge along the alignment axis, in pixels. */
     alignOffset?: number;
+    /**
+     * Which set of colours the panel, its arrow and its text draw from.
+     *
+     * `inverted` is the default and right for a label: a whisper over the page
+     * should read as a different layer rather than as another panel of it.
+     * `surface` matches the popover — reach for it once the tooltip carries a
+     * heading and a sentence, where the inversion stops reading as a whisper.
+     */
+    variant?: TooltipVariant;
+    /**
+     * `content-fit` sizes to the content, `trigger` matches the trigger's width,
+     * `full` spans the safe area, and a number is that many pixels. Worth setting
+     * for anything longer than a label, which would otherwise run to whatever
+     * width the sentence happens to want.
+     */
+    width?: number | 'trigger' | 'full' | 'content-fit';
+    /** Floor for the panel's width, in pixels. */
+    minWidth?: number;
+    /**
+     * Ceiling for the panel's height, in pixels. Always clamped to the room
+     * inside the safe area, which is also the default.
+     */
+    maxHeight?: number;
+    /**
+     * Scroll the body when it is taller than `maxHeight`. Off by default — a
+     * label has nothing to scroll, and a scroller around one only adds a bounce.
+     */
+    scrollable?: boolean;
     children?: ReactNode;
 }
-declare function TooltipContent({ className, placement, align, offset, alignOffset, children, onLayout: onLayoutProp, style, ...props }: TooltipContentProps): import("react").JSX.Element | null;
+declare function TooltipContent({ className, placement, align, offset, alignOffset, variant, width, minWidth, maxHeight, scrollable, children, onLayout: onLayoutProp, style, ...props }: TooltipContentProps): import("react").JSX.Element | null;
+/** The label's default text, coloured to whatever the panel is made of. */
+declare function TooltipText({ className, ...props }: TextProps): import("react").JSX.Element;
+declare namespace TooltipText {
+    var displayName: string;
+}
+export interface TooltipTitleProps extends TextProps {
+    className?: string;
+}
+/** A heading, for a tooltip carrying more than a label. */
+declare function TooltipTitle({ className, ...props }: TooltipTitleProps): import("react").JSX.Element;
+declare namespace TooltipTitle {
+    var displayName: string;
+}
+export interface TooltipDescriptionProps extends TextProps {
+    className?: string;
+}
+/** The sentence under a `Tooltip.Title`, in the panel's secondary colour. */
+declare function TooltipDescription({ className, ...props }: TooltipDescriptionProps): import("react").JSX.Element;
+declare namespace TooltipDescription {
+    var displayName: string;
+}
 export interface TooltipArrowProps extends ViewProps {
     className?: string;
 }
@@ -116,10 +172,9 @@ export declare const Tooltip: typeof TooltipRoot & {
     Trigger: typeof TooltipTrigger;
     Content: typeof TooltipContent;
     Arrow: typeof TooltipArrow;
-    Text: {
-        ({ className, ...props }: TextProps): import("react").JSX.Element;
-        displayName: string;
-    };
+    Title: typeof TooltipTitle;
+    Description: typeof TooltipDescription;
+    Text: typeof TooltipText;
 };
 export {};
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/tooltip/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,EAWL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAWtB,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,0BAAuB,CAAC;AAY7D,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AACnE,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AA2BtD,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,OAAO,CAAC;AAYlD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,SAAS,CAAC;IACpB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,uCAAuC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,iBAAS,WAAW,CAAC,EACnB,QAAQ,EACR,IAAI,EACJ,YAAY,EACZ,WAAmB,EACnB,MAAoB,EACpB,QAA2B,EAC3B,KAAK,GACN,EAAE,YAAY,+BA+Cd;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;QACrB,OAAO,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QACvC,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QAC3C,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC,CAAC;CACJ;AAED;;;;;;;;;;;;;GAaG;AACH,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,mBAAmB,+BAgDnE;AAED,MAAM,WAAW,mBAAoB,SAAQ,SAAS;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,2DAA2D;IAC3D,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,iBAAS,cAAc,CAAC,EACtB,SAAS,EACT,SAAiB,EACjB,KAAgB,EAChB,MAAuB,EACvB,WAAe,EACf,QAAQ,EACR,QAAQ,EAAE,YAAY,EACtB,KAAK,EACL,GAAG,KAAK,EACT,EAAE,mBAAmB,sCA4JrB;AAQD,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,iBAAS,YAAY,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,sCAiCtE;AAmGD,eAAO,MAAM,OAAO;;;;;kCApJ0B,SAAS;;;CAyJrD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/tooltip/index.tsx"],"names":[],"mappings":"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"}