panelui-native 0.46.0 → 0.49.0

package/lib/typescript/src/components/markdown-editor/index.d.ts

@@ -0,0 +1,102 @@
+/**
+ * MarkdownEditor — a field for writing markdown, and a way to see it rendered.
+ *
+ * ```tsx
+ * const [draft, setDraft] = useState('');
+ *
+ * <MarkdownEditor value={draft} onValueChange={setDraft} rows={12} />
+ * ```
+ *
+ * ## Writing and reading are two modes, not two panes
+ *
+ * Side by side is how this is done on a desktop, and it does not survive the
+ * trip to a phone: two columns of a phone's width are two columns too narrow to
+ * read, and the keyboard covers the bottom half of the screen exactly when the
+ * writer is using it. So there is one pane and a switch — write, or read what
+ * you wrote. The toolbar carries the switch, because the toolbar is the one
+ * thing on screen in both modes.
+ *
+ * ## The toolbar edits the selection
+ *
+ * Every button here is a function of the text and where the caret is in it, and
+ * the answer that matters is not which characters get inserted but where the
+ * caret lands afterwards. Bolding a selected phrase leaves it selected, so it
+ * can be italicised next; bolding nothing puts the caret between the new
+ * markers, where the writing is about to go; and pressing the same button again
+ * takes the markers off. Those rules live in `markdown-transforms.ts` as pure
+ * functions over `(text, selection)`, away from anything to do with a field.
+ *
+ * ## Why it renders through Response
+ *
+ * The preview is `Response`, the same reader that renders a model's answer, so
+ * markdown means the same thing everywhere in the library and there is one
+ * parser to be right rather than two to keep in step. It renders through
+ * `Typography`, `CodeBlock` and `Table`, which is to say through the app's own
+ * type and colours — a preview that looked like a document viewer would be
+ * showing the writer something they are not going to ship.
+ *
+ * Nothing here reaches for a platform markdown renderer. `Text` in SwiftUI can
+ * parse markdown and Jetpack Compose's cannot, so a platform-backed editor
+ * would render on one of the two and be a plain string on the other.
+ *
+ * Works controlled (`value` + `onValueChange`) or uncontrolled (`defaultValue`).
+ */
+import { type ReactNode } from 'react';
+import { View, type TextInput, type ViewProps } from 'react-native';
+import { type TextareaProps } from '../textarea/index.js';
+export type { EditorSelection, EditResult } from './markdown-transforms.js';
+/** Which pane the editor is showing. */
+export type MarkdownEditorMode = 'write' | 'preview';
+/** A formatting action the toolbar can offer. */
+export type MarkdownEditorAction = 'bold' | 'italic' | 'heading' | 'quote' | 'code' | 'bulletList' | 'orderedList' | 'link';
+export interface MarkdownEditorProps extends Omit<ViewProps, 'children'> {
+    className?: string;
+    /** Controlled text. Leave unset and pass `defaultValue` to run uncontrolled. */
+    value?: string;
+    /** Starting text when uncontrolled. */
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    /** Controlled pane. */
+    mode?: MarkdownEditorMode;
+    /** Starting pane when uncontrolled. */
+    defaultMode?: MarkdownEditorMode;
+    onModeChange?: (mode: MarkdownEditorMode) => void;
+    /** Stop the field being edited and the toolbar being pressed. */
+    disabled?: boolean;
+    /**
+     * The parts, in the order they should stack. Left out, the editor draws its
+     * toolbar, its field and its preview in that order — which is the whole
+     * component, and the reason it usually needs no children.
+     */
+    children?: ReactNode;
+    /** Forwarded to the field when the editor draws its own. */
+    placeholder?: string;
+    /** Height of the field, in lines. Forwarded to the field the editor draws. */
+    rows?: number;
+}
+export interface MarkdownEditorToolbarProps extends Omit<ViewProps, 'children'> {
+    className?: string;
+    /** Which formatting actions to offer, in the order given. */
+    actions?: MarkdownEditorAction[];
+    /**
+     * Show the write/preview switch. On by default — a preview nobody can reach
+     * is a pane that does not exist.
+     */
+    showModeSwitch?: boolean;
+    /** Anything else to put on the row: a word count, a save state, a submit. */
+    children?: ReactNode;
+}
+export interface MarkdownEditorInputProps extends Omit<TextareaProps, 'value' | 'onChangeText' | 'defaultValue'> {
+    className?: string;
+}
+export interface MarkdownEditorPreviewProps extends Omit<ViewProps, 'children'> {
+    className?: string;
+    /** What to show when there is nothing written yet. */
+    emptyText?: string;
+}
+export declare const MarkdownEditor: import("react").ForwardRefExoticComponent<MarkdownEditorProps & import("react").RefAttributes<View>> & {
+    Toolbar: import("react").ForwardRefExoticComponent<MarkdownEditorToolbarProps & import("react").RefAttributes<View>>;
+    Input: import("react").ForwardRefExoticComponent<MarkdownEditorInputProps & import("react").RefAttributes<TextInput>>;
+    Preview: import("react").ForwardRefExoticComponent<MarkdownEditorPreviewProps & import("react").RefAttributes<View>>;
+};
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/components/markdown-editor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/markdown-editor/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,OAAO,EAQL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EACL,IAAI,EAEJ,KAAK,SAAS,EAEd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAmBtB,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,sBAAa,CAAC;AAW3D,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,0BAAuB,CAAC;AAEzE,wCAAwC;AACxC,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAC;AAErD,iDAAiD;AACjD,MAAM,MAAM,oBAAoB,GAC5B,MAAM,GACN,QAAQ,GACR,SAAS,GACT,OAAO,GACP,MAAM,GACN,YAAY,GACZ,aAAa,GACb,MAAM,CAAC;AAwGX,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,uBAAuB;IACvB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,uCAAuC;IACvC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAClD,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA0HD,MAAM,WAAW,0BAA2B,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACjC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAmED,MAAM,WAAW,wBACf,SAAQ,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,cAAc,GAAG,cAAc,CAAC;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAoDD,MAAM,WAAW,0BAA2B,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA+BD,eAAO,MAAM,cAAc;;;;CAIzB,CAAC"}

package/lib/typescript/src/components/markdown-editor/markdown-transforms.d.ts

@@ -0,0 +1,76 @@
+/**
+ * The edits a formatting toolbar makes, as functions of the text and where the
+ * caret is in it.
+ *
+ * Pure, and deliberately so. Every one of these takes `(text, selection)` and
+ * returns the text that should replace it together with where the selection
+ * should end up — no component, no ref, no input. What makes a formatting
+ * toolbar feel broken is never the characters it inserts; it is where the caret
+ * lands afterwards, and that is a property of these functions rather than of
+ * the field they are wired to.
+ *
+ * Three rules they all keep:
+ *
+ * - **Applying twice undoes it.** A toolbar button that only ever adds is a
+ *   button you can press once, and every press after that damages the text.
+ * - **A selection stays selected.** Bolding three words and then italicising
+ *   the same three has to be two presses, not a press and a re-selection.
+ * - **With nothing selected, the caret lands where the writing goes** — between
+ *   the new markers rather than after them.
+ */
+export interface EditorSelection {
+    start: number;
+    end: number;
+}
+export interface EditResult {
+    text: string;
+    selection: EditorSelection;
+}
+/**
+ * Wraps the selection in `marker`, or unwraps it if it is already wrapped.
+ *
+ * "Already wrapped" is checked both ways round: the markers may be inside the
+ * selection (the writer selected `**bold**`) or immediately outside it (they
+ * selected `bold` in the middle of `**bold**`). Both are the same intent, and a
+ * toolbar that only recognised one of them would add a second pair of asterisks
+ * to text that already had them.
+ */
+export declare function toggleWrap(text: string, selection: EditorSelection, marker: string): EditResult;
+/**
+ * Puts `prefix` on the front of every line the selection touches, or takes it
+ * off if every one of them already has it.
+ *
+ * Every one, not any one: a mixed block is a block the writer is trying to make
+ * uniform, so the useful answer there is to add rather than to remove.
+ */
+export declare function toggleLinePrefix(text: string, selection: EditorSelection, prefix: string): EditResult;
+/**
+ * Numbers the lines the selection touches, or unnumbers them.
+ *
+ * Counted from one within the block rather than continuing whatever came above
+ * it: the numbers a writer types are not the numbers that get rendered — every
+ * markdown reader renumbers an ordered list from its first item — so the useful
+ * thing is for the source to read the way the output will.
+ */
+export declare function toggleOrderedList(text: string, selection: EditorSelection): EditResult;
+/** Placeholder left where a link's target goes. */
+export declare const LINK_PLACEHOLDER = "url";
+/**
+ * Turns the selection into a link, and selects the part that still needs
+ * filling in.
+ *
+ * Which part that is depends on what was selected. With text selected, the
+ * label is written and the target is not, so the placeholder target is left
+ * selected and typing replaces it. With nothing selected there is neither, and
+ * the label comes first because it is the half the writer is thinking about.
+ */
+export declare function insertLink(text: string, selection: EditorSelection): EditResult;
+/**
+ * Puts the selected lines in a fence, or takes them out of one.
+ *
+ * A fence is the one construct that has to sit on lines of its own, so this
+ * makes room for itself: a blank line before it when it is not already at the
+ * start of a paragraph, and one after it at the end.
+ */
+export declare function toggleFence(text: string, selection: EditorSelection): EditResult;
+//# sourceMappingURL=markdown-transforms.d.ts.map

package/lib/typescript/src/components/markdown-editor/markdown-transforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-transforms.d.ts","sourceRoot":"","sources":["../../../../../src/components/markdown-editor/markdown-transforms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,eAAe,CAAC;CAC5B;AAaD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,MAAM,GACb,UAAU,CAmCZ;AAiCD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,MAAM,GACb,UAAU,CASZ;AAKD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,eAAe,GACzB,UAAU,CAQZ;AAMD,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AAEtC;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,UAAU,CAY/E;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,UAAU,CAiBhF"}

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

@@ -0,0 +1,336 @@
+/**
+ * Questionnaire — one question at a time, with progress, validation and a way
+ * back.
+ *
+ * Unlike `Steps`, which reflects a flow the app owns, Questionnaire *owns* the
+ * flow: it holds the answers, decides which question is current, gates the way
+ * forward on the current one being answered, and reports the whole set back
+ * when it is done. The caller supplies the questions and does something with
+ * the answers; everything between those two points belongs here.
+ *
+ * ```tsx
+ * <Questionnaire items={items} onSubmit={(answers) => save(answers)}>
+ *   <Questionnaire.Title>Project setup</Questionnaire.Title>
+ *   <Questionnaire.Progress />
+ *   <Questionnaire.Item name="direction" required>
+ *     <Questionnaire.Question>What should we build next?</Questionnaire.Question>
+ *     <Questionnaire.Description>Choose one, or write your own.</Questionnaire.Description>
+ *     <Questionnaire.Choices>
+ *       <Questionnaire.Choice value="delegation" label="Delegation" />
+ *       <Questionnaire.Choice value="prompts" label="Question prompts" />
+ *       <Questionnaire.Input placeholder="Type another answer…" />
+ *     </Questionnaire.Choices>
+ *     <Questionnaire.Error />
+ *   </Questionnaire.Item>
+ *   <Questionnaire.Footer>
+ *     <Questionnaire.Back />
+ *     <Questionnaire.Next />
+ *     <Questionnaire.Submit />
+ *   </Questionnaire.Footer>
+ * </Questionnaire>
+ * ```
+ *
+ * ## Why it draws its own Frame
+ *
+ * A survey is a widget, not a paragraph: it wants a boundary, a title strip and
+ * a footer that stays put while the middle changes. That is exactly `Frame`, so
+ * the root renders one rather than leaving every caller to assemble the same
+ * shell. `Frame.Panel`'s `overflow-hidden` also does the clipping the sliding
+ * question needs, for free. Pass `frame={false}` to drop it — for a
+ * questionnaire inside a `BottomSheet` or a card that already draws a border.
+ *
+ * ## Why the root reads its children instead of collecting registrations
+ *
+ * Only the active question is mounted, so an unmounted one cannot report that
+ * it exists — and without knowing the full set there is no total to count
+ * against, no "is this the last one", and no way to disable a question the
+ * user has not reached. So the root inspects its children once per render and
+ * reads `name`, `required`, `multiple` and `disabled` straight off the
+ * elements. React elements carry their props before anything renders them,
+ * which makes the whole set knowable without mounting any of it.
+ *
+ * That same pass sorts the parts into the shell: the title and progress go to
+ * the header strip, the footer to a section at the bottom of the panel, and
+ * everything else is a question.
+ *
+ * ## Answers are one record, the way a form would submit them
+ *
+ * `answers[name]` is a string for a single-answer question and an array for a
+ * `multiple` one. A freeform answer lands under the same name — it is another
+ * answer to the same question, not a separate field — which is why the text
+ * input shows whatever value does not match one of the question's own choices.
+ * Picking a choice and typing therefore replace each other, without either one
+ * having to know the other exists.
+ *
+ * ## What blocks the way forward
+ *
+ * A required question blocks until it has an answer. An optional one never
+ * blocks. `Questionnaire.Skip` does not unblock anything, then — it *records*
+ * that the question was deliberately left out, moving its status from
+ * `unanswered` to `skipped` so the app can tell the two apart. Making an
+ * optional question demand an explicit skip would trap anyone who did not
+ * render the Skip button, and a question that cannot be ignored is not
+ * optional.
+ */
+import { type ReactNode } from 'react';
+import { View, type TextInput, type ViewProps } from 'react-native';
+import { type ButtonProps } from '../button/index.js';
+import { type InputProps } from '../input/index.js';
+/** Where a question stands: never touched, answered, or deliberately left out. */
+export type QuestionnaireItemStatus = 'unanswered' | 'answered' | 'skipped';
+/** Which key each answer is badged with. */
+export type QuestionnaireShortcutMode = 'letters' | 'numbers';
+/** Every answer given so far, keyed by question name. */
+export type QuestionnaireAnswers = Record<string, string | string[]>;
+/**
+ * A question, described rather than rendered. Pass these as `items` so the
+ * questionnaire knows its full set before any of it mounts — which is what
+ * makes a conditional question countable and a total meaningful.
+ */
+export interface QuestionnaireItemDefinition {
+    /** Unique name — the key this question's answer is stored under. */
+    name: string;
+    /** Blocks the way forward until it has an answer. */
+    required?: boolean;
+    /** Accepts more than one answer, so its answer is an array. */
+    multiple?: boolean;
+    /** Left out of the count and never navigated to. */
+    disabled?: boolean;
+}
+export interface QuestionnaireProps extends Omit<ViewProps, 'children'> {
+    className?: string;
+    /**
+     * The full set of questions, in order. Optional: without it the order and
+     * the totals come from the `Questionnaire.Item` children instead. Pass it
+     * when a question is conditional, since a question the user has not reached
+     * still has to be counted — or not counted, if it no longer applies.
+     */
+    items?: readonly QuestionnaireItemDefinition[];
+    /** Controlled active question, by name. */
+    item?: string;
+    /** Which question to open on. Defaults to the first enabled one. */
+    defaultItem?: string;
+    /** Called with the name of the question being moved to. */
+    onItemChange?: (name: string) => void;
+    /** Controlled answers. */
+    answers?: QuestionnaireAnswers;
+    /** Answers to start with — for resuming a part-finished questionnaire. */
+    defaultAnswers?: QuestionnaireAnswers;
+    /** Called with the whole set every time any answer changes. */
+    onAnswersChange?: (answers: QuestionnaireAnswers) => void;
+    /** Called with every answer once the last question validates. */
+    onSubmit?: (answers: QuestionnaireAnswers) => void;
+    /**
+     * Badge every answer with a letter (`A`, `B`, `C`) or a number (`1`, `2`,
+     * `3`). Disabled answers are skipped rather than taking a badge with them.
+     *
+     * The badge is an affordance, not a binding: React Native surfaces hardware
+     * key events only to a focused text field, so nothing here can listen for
+     * the key itself.
+     */
+    shortcuts?: QuestionnaireShortcutMode;
+    /**
+     * Let a horizontal drag move between questions. Going forward is gated on
+     * the same answer the button is, so a swipe off an unanswered required
+     * question springs back and shows its error.
+     */
+    swipeable?: boolean;
+    /**
+     * Draw the surrounding `Frame`. Turn it off to place the questionnaire in a
+     * sheet, a dialog or a card that already draws its own boundary.
+     */
+    frame?: boolean;
+    children?: ReactNode;
+}
+declare function QuestionnaireRoot({ className, items, item: itemProp, defaultItem, onItemChange, answers: answersProp, defaultAnswers, onAnswersChange, onSubmit, shortcuts, swipeable, frame, children, ...props }: QuestionnaireProps): import("react").JSX.Element;
+declare namespace QuestionnaireRoot {
+    var displayName: string;
+}
+export interface QuestionnaireTitleProps extends ViewProps {
+    className?: string;
+    children?: ReactNode;
+}
+/**
+ * Names the questionnaire as a whole, in the frame's header strip. The
+ * current question's own prompt is `Questionnaire.Question`.
+ */
+declare function QuestionnaireTitle({ className, children, ...props }: QuestionnaireTitleProps): import("react").JSX.Element;
+declare namespace QuestionnaireTitle {
+    var displayName: string;
+}
+/** What a custom progress indicator is told about where the reader is. */
+export interface QuestionnaireProgressState {
+    /** One-based position of the active question. */
+    current: number;
+    /** How many questions are enabled. */
+    total: number;
+    first: boolean;
+    last: boolean;
+}
+/** How the position is drawn. */
+export type QuestionnaireProgressVariant = 'pips' | 'numbers' | 'count';
+export interface QuestionnaireProgressProps {
+    className?: string;
+    /**
+     * `pips` is a bar per question, filled up to the one being asked and widened
+     * on it. `numbers` counts them out instead, which is what you want when the
+     * reader will be sent back to a particular question. `count` is the plain
+     * `Question 2 of 5`.
+     *
+     * `pips` and `numbers` fall back to `count` past eight questions, where
+     * neither is countable at a glance any more.
+     */
+    variant?: QuestionnaireProgressVariant;
+    /**
+     * Replace the indicator entirely. Given a function, it is called with the
+     * position — for a bar, a row of dots, or a percentage.
+     */
+    children?: ReactNode | ((state: QuestionnaireProgressState) => ReactNode);
+}
+/** Where the reader is in the set, announced as a progress bar. */
+declare function QuestionnaireProgress({ className, variant, children, }: QuestionnaireProgressProps): import("react").JSX.Element;
+declare namespace QuestionnaireProgress {
+    var displayName: string;
+}
+export interface QuestionnaireItemProps extends Omit<ViewProps, 'children'> {
+    className?: string;
+    /** Unique name — the key this question's answer is stored under. */
+    name: string;
+    /** Blocks the way forward until it has an answer. */
+    required?: boolean;
+    /** Accepts more than one answer, so its answer is an array. */
+    multiple?: boolean;
+    /** Left out of the count and never navigated to. */
+    disabled?: boolean;
+    /** Mark the question at fault from a validator of your own. */
+    invalid?: boolean;
+    /** Called whenever this question moves between unanswered, answered and skipped. */
+    onStatusChange?: (status: QuestionnaireItemStatus) => void;
+    children?: ReactNode;
+}
+/**
+ * One question. Only the active one is mounted, so anything it holds is built
+ * when it is reached and thrown away when it is left.
+ */
+declare function QuestionnaireItem({ className, name, required, multiple, invalid: invalidProp, children, disabled: _disabled, onStatusChange: _onStatusChange, ...props }: QuestionnaireItemProps): import("react").JSX.Element;
+declare namespace QuestionnaireItem {
+    var displayName: string;
+}
+export interface QuestionnaireQuestionProps extends ViewProps {
+    className?: string;
+    children?: ReactNode;
+}
+/** The question being asked. */
+declare function QuestionnaireQuestion({ className, children, ...props }: QuestionnaireQuestionProps): import("react").JSX.Element;
+declare namespace QuestionnaireQuestion {
+    var displayName: string;
+}
+export interface QuestionnaireDescriptionProps extends ViewProps {
+    className?: string;
+    children?: ReactNode;
+}
+/** A line under the question — what to consider, or that it can be skipped. */
+declare function QuestionnaireDescription({ className, children, ...props }: QuestionnaireDescriptionProps): import("react").JSX.Element;
+declare namespace QuestionnaireDescription {
+    var displayName: string;
+}
+export interface QuestionnaireChoicesProps extends Omit<ViewProps, 'children'> {
+    className?: string;
+    children?: ReactNode;
+}
+/**
+ * The answers to a question. It hands each choice its shortcut badge, counting
+ * only the ones that can be picked so a disabled answer does not take a letter
+ * out of the sequence with it.
+ */
+declare function QuestionnaireChoices({ className, children, ...props }: QuestionnaireChoicesProps): import("react").JSX.Element;
+declare namespace QuestionnaireChoices {
+    var displayName: string;
+}
+export interface QuestionnaireChoiceProps {
+    className?: string;
+    /** The value recorded when this answer is picked. */
+    value: string;
+    /** The answer itself. */
+    label?: string;
+    /** A line under the label, for an answer that needs explaining. */
+    description?: string;
+    disabled?: boolean;
+    children?: ReactNode;
+}
+export interface QuestionnaireInputProps extends Omit<InputProps, 'value' | 'onChangeText' | 'errorMessage'> {
+    className?: string;
+}
+export interface QuestionnaireErrorProps extends ViewProps {
+    className?: string;
+    /** Replace the default message. */
+    children?: ReactNode;
+}
+/** Why the way forward is closed. Nothing until the question fails to pass. */
+declare function QuestionnaireError({ className, children, ...props }: QuestionnaireErrorProps): import("react").JSX.Element | null;
+declare namespace QuestionnaireError {
+    var displayName: string;
+}
+export interface QuestionnaireFooterProps extends ViewProps {
+    className?: string;
+    children?: ReactNode;
+}
+/**
+ * The action row, in its own section at the foot of the panel. It stays put
+ * while the question above it changes, which is what keeps the button under
+ * the thumb where it was.
+ */
+declare function QuestionnaireFooter({ className, children, ...props }: QuestionnaireFooterProps): import("react").JSX.Element;
+declare namespace QuestionnaireFooter {
+    var displayName: string;
+}
+/** What a navigation button is told about the question it is acting on. */
+export interface QuestionnaireActionState {
+    /** Whether the action applies to the active question at all. */
+    visible: boolean;
+    /** Where the active question stands. */
+    status: QuestionnaireItemStatus;
+}
+export interface QuestionnaireActionProps extends Omit<ButtonProps, 'children'> {
+    /** Replace the label. Given a function, it is called with the question's state. */
+    children?: ReactNode | ((state: QuestionnaireActionState) => ReactNode);
+}
+/**
+ * A flexible gap for the footer, so the trailing buttons sit against the
+ * trailing edge whether or not `Questionnaire.Back` is showing.
+ */
+declare function QuestionnaireSpacer({ className, ...props }: ViewProps): import("react").JSX.Element;
+declare namespace QuestionnaireSpacer {
+    var displayName: string;
+}
+export declare const Questionnaire: typeof QuestionnaireRoot & {
+    Title: typeof QuestionnaireTitle;
+    Progress: typeof QuestionnaireProgress;
+    Item: typeof QuestionnaireItem;
+    Question: typeof QuestionnaireQuestion;
+    Description: typeof QuestionnaireDescription;
+    Choices: typeof QuestionnaireChoices;
+    Choice: import("react").ForwardRefExoticComponent<QuestionnaireChoiceProps & import("react").RefAttributes<View>>;
+    Input: import("react").ForwardRefExoticComponent<QuestionnaireInputProps & import("react").RefAttributes<TextInput>>;
+    Error: typeof QuestionnaireError;
+    Footer: typeof QuestionnaireFooter;
+    Spacer: typeof QuestionnaireSpacer;
+    Back: {
+        ({ children, variant, className, ...props }: QuestionnaireActionProps): import("react").JSX.Element | null;
+        displayName: string;
+    };
+    Skip: {
+        ({ children, variant, className, ...props }: QuestionnaireActionProps): import("react").JSX.Element | null;
+        displayName: string;
+    };
+    Next: {
+        ({ children, variant, className, ...props }: QuestionnaireActionProps): import("react").JSX.Element | null;
+        displayName: string;
+    };
+    Submit: {
+        ({ children, variant, className, ...props }: QuestionnaireActionProps): import("react").JSX.Element | null;
+        displayName: string;
+    };
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -58,6 +58,15 @@ export interface TabsProps extends ViewProps {
      * already wants a horizontal drag — a carousel, a slider, a row that swipes
      * open — and the two cannot both have it. Turn it on for panels of ordinary
      * scrolling content, where it is the gesture people try first.
+     *
+     * **It does not change what is mounted.** Only `keepMounted` decides that,
+     * with or without this — a swipe animates between two panels of which one is
+     * being unmounted and the other mounted for the first time, exactly as a
+     * press does. What it does change is that the mount now happens *while
+     * something is moving*, so a panel that is slow to build stops being a pause
+     * before it appears and starts being a stutter in the movement. If a swipe
+     * feels heavier than a press on the same tab set, the panel is expensive to
+     * mount; `keepMounted` is the answer, not turning this off.
      */
     swipeable?: boolean;
     children: ReactNode;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/tabs/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAQL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAsFtB,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAsI3E,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,iBAAS,QAAQ,CAAC,EAChB,SAAS,EACT,KAAK,EACL,aAAa,EACb,YAAY,EACZ,OAAqB,EACrB,WAAmB,EACnB,SAAiB,EACjB,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,SAAS,+BAkIX;AAqCD,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,iBAAS,QAAQ,CAAC,EAAE,SAAS,EAAE,UAAkB,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,+BA6CrF;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,iBAAS,WAAW,CAAC,EACnB,SAAS,EACT,KAAK,EACL,IAAI,EACJ,KAAK,EACL,QAAgB,EAChB,QAAQ,GACT,EAAE,gBAAgB,+BA8DlB;AA0ID,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,sCAuJrF;AAED,eAAO,MAAM,IAAI;;;;CAIf,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/tabs/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAQL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAML,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAgGtB,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAsI3E,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,iBAAS,QAAQ,CAAC,EAChB,SAAS,EACT,KAAK,EACL,aAAa,EACb,YAAY,EACZ,OAAqB,EACrB,WAAmB,EACnB,SAAiB,EACjB,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,SAAS,+BA6IX;AAqCD,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,iBAAS,QAAQ,CAAC,EAAE,SAAS,EAAE,UAAkB,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,+BA6CrF;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,iBAAS,WAAW,CAAC,EACnB,SAAS,EACT,KAAK,EACL,IAAI,EACJ,KAAK,EACL,QAAgB,EAChB,QAAQ,GACT,EAAE,gBAAgB,+BA8DlB;AA0ID,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,sCAgMrF;AAED,eAAO,MAAM,IAAI;;;;CAIf,CAAC"}

package/lib/typescript/src/components/time-picker/index.d.ts

@@ -50,6 +50,14 @@ export type { HourCycle, TimeValue };
 export type TimePickerLayout = 'wheel' | 'clock' | 'ruler';
 /** How the panel gets onto the screen. */
 export type TimePickerPresentation = 'popover' | 'dialog' | 'bottom-sheet' | 'inline';
+/**
+ * How loudly the ruler face states the time it is on.
+ *
+ * `default` is the big centred number, right when the scale is the only thing
+ * on the panel. `compact` steps it down to sit under something that outranks
+ * it, and `none` drops it for a caller that writes the time itself.
+ */
+export type TimePickerReadout = 'default' | 'compact' | 'none';
 export interface TimePickerProps {
     /** Controlled selection, as `{ hour, minute }` on a 24-hour clock. */
     value?: TimeValue;
@@ -80,6 +88,16 @@ export interface TimePickerProps {
     format?: (value: TimeValue) => string;
     /** BCP 47 tag for the time's text and the meridiem labels. */
     locale?: string;
+    /**
+     * How loudly the `ruler` face states the time it is on. The other two faces
+     * spell the time out in their own columns and hands, and ignore this.
+     *
+     * The big centred number is right when the scale is the only thing on the
+     * panel. Under something that outranks it — a calendar, a form row — it is
+     * the largest text on screen for the smaller half of the answer, so step it
+     * down with `compact` or take it over yourself with `none`.
+     */
+    readout?: TimePickerReadout;
     /** Stop the trigger opening it, and the faces from being scrolled. */
     disabled?: boolean;
     className?: string;
@@ -94,7 +112,7 @@ export interface TimePickerProps {
         onPress?: () => void;
     }> | ReactNode;
 }
-declare function TimePickerRoot({ value: valueProp, defaultValue, onValueChange, layout, presentation, open: openProp, onOpenChange, hourCycle, minuteStep, minTime, maxTime, placeholder, format, locale, disabled, className, children, }: TimePickerProps): import("react").JSX.Element;
+declare function TimePickerRoot({ value: valueProp, defaultValue, onValueChange, layout, presentation, open: openProp, onOpenChange, hourCycle, minuteStep, minTime, maxTime, placeholder, format, locale, readout, disabled, className, children, }: TimePickerProps): import("react").JSX.Element;
 declare namespace TimePickerRoot {
     var displayName: string;
 }

package/lib/typescript/src/components/time-picker/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/time-picker/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,OAAO,EAML,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAuBf,OAAO,EAYL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,qBAAkB,CAAC;AAK1B,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAErC,kCAAkC;AAClC,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3D,0CAA0C;AAC1C,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,QAAQ,GAAG,cAAc,GAAG,QAAQ,CAAC;AA+nBtF,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC3C,kCAAkC;IAClC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,+EAA+E;IAC/E,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,0CAA0C;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,yCAAyC;IACzC,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,MAAM,CAAC;IACtC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;CAC/D;AASD,iBAAS,cAAc,CAAC,EACtB,KAAK,EAAE,SAAS,EAChB,YAAY,EACZ,aAAa,EACb,MAAgB,EAChB,YAAwB,EACxB,IAAI,EAAE,QAAQ,EACd,YAAY,EACZ,SAAc,EACd,UAAU,EACV,OAAO,EACP,OAAO,EACP,WAAiC,EACjC,MAAM,EACN,MAAM,EACN,QAAgB,EAChB,SAAS,EACT,QAAQ,GACT,EAAE,eAAe,+BA6JjB;kBA/KQ,cAAc;;;AAkLvB,eAAO,MAAM,UAAU;;CAErB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/time-picker/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,OAAO,EAML,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAuBf,OAAO,EAYL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,qBAAkB,CAAC;AAK1B,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAErC,kCAAkC;AAClC,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3D,0CAA0C;AAC1C,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,QAAQ,GAAG,cAAc,GAAG,QAAQ,CAAC;AAiBtF;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AA+nB/D,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC3C,kCAAkC;IAClC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,+EAA+E;IAC/E,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,0CAA0C;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,yCAAyC;IACzC,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,MAAM,CAAC;IACtC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;CAC/D;AASD,iBAAS,cAAc,CAAC,EACtB,KAAK,EAAE,SAAS,EAChB,YAAY,EACZ,aAAa,EACb,MAAgB,EAChB,YAAwB,EACxB,IAAI,EAAE,QAAQ,EACd,YAAY,EACZ,SAAc,EACd,UAAU,EACV,OAAO,EACP,OAAO,EACP,WAAiC,EACjC,MAAM,EACN,MAAM,EACN,OAAmB,EACnB,QAAgB,EAChB,SAAS,EACT,QAAQ,GACT,EAAE,eAAe,+BA8JjB;kBAjLQ,cAAc;;;AAoLvB,eAAO,MAAM,UAAU;;CAErB,CAAC"}