panelui-native 0.14.0 → 0.19.0

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

@@ -0,0 +1,141 @@
+import { TextInput, type TextInputProps } from 'react-native';
+import { type VariantProps } from 'tailwind-variants';
+declare const otpVariants: import("tailwind-variants").TVReturnType<{
+    size: {
+        sm: {
+            cell: string;
+            char: string;
+            caret: string;
+            separator: string;
+        };
+        md: {
+            cell: string;
+            char: string;
+            caret: string;
+            separator: string;
+        };
+        lg: {
+            cell: string;
+            char: string;
+            caret: string;
+            separator: string;
+        };
+    };
+    disabled: {
+        true: {
+            row: string;
+        };
+    };
+}, {
+    container: string;
+    row: string;
+    cell: string;
+    char: string;
+    caret: string;
+    separator: string;
+    error: string;
+}, undefined, {
+    size: {
+        sm: {
+            cell: string;
+            char: string;
+            caret: string;
+            separator: string;
+        };
+        md: {
+            cell: string;
+            char: string;
+            caret: string;
+            separator: string;
+        };
+        lg: {
+            cell: string;
+            char: string;
+            caret: string;
+            separator: string;
+        };
+    };
+    disabled: {
+        true: {
+            row: string;
+        };
+    };
+}, {
+    container: string;
+    row: string;
+    cell: string;
+    char: string;
+    caret: string;
+    separator: string;
+    error: string;
+}, import("tailwind-variants").TVReturnType<{
+    size: {
+        sm: {
+            cell: string;
+            char: string;
+            caret: string;
+            separator: string;
+        };
+        md: {
+            cell: string;
+            char: string;
+            caret: string;
+            separator: string;
+        };
+        lg: {
+            cell: string;
+            char: string;
+            caret: string;
+            separator: string;
+        };
+    };
+    disabled: {
+        true: {
+            row: string;
+        };
+    };
+}, {
+    container: string;
+    row: string;
+    cell: string;
+    char: string;
+    caret: string;
+    separator: string;
+    error: string;
+}, undefined, unknown, unknown, undefined>>;
+type OtpVariantProps = VariantProps<typeof otpVariants>;
+export interface OtpInputProps extends Omit<TextInputProps, 'value' | 'defaultValue' | 'onChangeText' | 'maxLength' | 'children'>, Omit<OtpVariantProps, 'disabled'> {
+    className?: string;
+    /** Class applied to every cell — for a taller box or a different radius. */
+    cellClassName?: string;
+    /** How many cells, i.e. the length of the code. */
+    length?: number;
+    /** Controlled value. Longer strings and stray characters are trimmed to fit. */
+    value?: string;
+    /** Starting value when the field manages its own state. */
+    defaultValue?: string;
+    onChangeText?: (value: string) => void;
+    /** Fires once, the moment the last cell is filled. */
+    onComplete?: (value: string) => void;
+    /**
+     * What the keyboard offers and what the field accepts. `numeric` keeps
+     * digits only and asks for the number pad; `text` accepts any character.
+     */
+    type?: 'numeric' | 'text';
+    /** Hide each filled character behind a dot, the way a passcode field does. */
+    mask?: boolean;
+    /** A single character shown, dimmed, in every cell still waiting for input. */
+    placeholder?: string;
+    /** Draw a separator between groups of this many cells — 3 gives `xxx — xxx`. */
+    groupEvery?: number;
+    disabled?: boolean;
+    /** Tint the field in its error colour and announce it as invalid. */
+    isInvalid?: boolean;
+    /** Error line under the field. Setting it also puts the field in its invalid state. */
+    errorMessage?: string;
+    /** Announced by a screen reader as the field's name. */
+    accessibilityLabel?: string;
+}
+export declare const OtpInput: import("react").ForwardRefExoticComponent<OtpInputProps & import("react").RefAttributes<TextInput>>;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/otp-input/index.tsx"],"names":[],"mappings":"AA0BA,OAAO,EAAa,SAAS,EAAQ,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAW/E,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAS1D,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAuBf,CAAC;AAEH,KAAK,eAAe,GAAG,YAAY,CAAC,OAAO,WAAW,CAAC,CAAC;AAExD,MAAM,WAAW,aACf,SAAQ,IAAI,CACR,cAAc,EACd,OAAO,GAAG,cAAc,GAAG,cAAc,GAAG,WAAW,GAAG,UAAU,CACrE,EACD,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,sDAAsD;IACtD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAuHD,eAAO,MAAM,QAAQ,qGAqKpB,CAAC"}

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

@@ -0,0 +1,254 @@
+/**
+ * Signature — a surface you sign with a finger, and a handle for getting the
+ * result back out.
+ *
+ * ```tsx
+ * const pad = useRef<SignatureHandle>(null);
+ *
+ * <Signature ref={pad} guideline />
+ * <Button onPress={() => pad.current?.save({ filename: 'agreement' })}>
+ *   Finish signing
+ * </Button>
+ * ```
+ *
+ * ## Why the stroke never reaches React
+ *
+ * A finger produces touch events far faster than a component tree can usefully
+ * re-render, and a signature is exactly the case where the lag shows: the line
+ * trails the fingertip and the whole thing feels like drawing through syrup.
+ *
+ * So the stroke being drawn lives in a shared value and is turned into an SVG
+ * `d` string by a worklet on the UI thread — React is not involved in a single
+ * frame of it. When the finger lifts, that one finished string crosses to
+ * JavaScript once and becomes a static path. Committed strokes are ordinary
+ * elements that never animate again, so the hundredth stroke costs what the
+ * first one did.
+ *
+ * Points closer together than `minDistance` are dropped as they arrive. A slow
+ * finger otherwise emits a point per frame in the same spot, which is a longer
+ * path describing the same shape.
+ *
+ * ## Smoothing
+ *
+ * Raw touch points joined with straight lines look like a seismograph. Each
+ * segment is drawn as a quadratic curve through the midpoint between two
+ * points instead — the point itself becomes the control handle, the midpoints
+ * become the anchors, and consecutive curves meet with a shared tangent. It
+ * needs no lookahead, so a point can be appended to a stroke already on screen
+ * without redrawing what came before it differently.
+ *
+ * ## Getting it out
+ *
+ * `toSVG()` is pure string building and always works. Writing a file needs
+ * `expo-file-system`, and rasterising to PNG needs `react-native-view-shot` as
+ * well; both are optional and both are resolved lazily, so a project that only
+ * ever reads the SVG installs neither. Asking for something the missing
+ * package provides throws with its name in the message rather than failing
+ * somewhere further down.
+ */
+import { type ReactNode } from 'react';
+import { type ViewProps } from 'react-native';
+import { type VariantProps } from 'tailwind-variants';
+import { type AnimatedPressableProps } from '../../primitives/animated-pressable.js';
+/** True when a signature can be written to a file. */
+export declare const hasSignatureFileSystem: boolean;
+/** True when a signature can be rasterised to PNG. */
+export declare const hasSignatureRaster: boolean;
+declare const signatureVariants: import("tailwind-variants").TVReturnType<{
+    size: {
+        sm: {
+            root: string;
+        };
+        md: {
+            root: string;
+        };
+        lg: {
+            root: string;
+        };
+        /** Fills whatever it is given — for a full-screen signing surface. */
+        full: {
+            root: string;
+        };
+    };
+    disabled: {
+        true: {
+            root: string;
+        };
+    };
+}, {
+    root: string;
+    pad: string;
+    placeholder: string;
+    guide: string;
+    toolbar: string;
+}, undefined, {
+    size: {
+        sm: {
+            root: string;
+        };
+        md: {
+            root: string;
+        };
+        lg: {
+            root: string;
+        };
+        /** Fills whatever it is given — for a full-screen signing surface. */
+        full: {
+            root: string;
+        };
+    };
+    disabled: {
+        true: {
+            root: string;
+        };
+    };
+}, {
+    root: string;
+    pad: string;
+    placeholder: string;
+    guide: string;
+    toolbar: string;
+}, import("tailwind-variants").TVReturnType<{
+    size: {
+        sm: {
+            root: string;
+        };
+        md: {
+            root: string;
+        };
+        lg: {
+            root: string;
+        };
+        /** Fills whatever it is given — for a full-screen signing surface. */
+        full: {
+            root: string;
+        };
+    };
+    disabled: {
+        true: {
+            root: string;
+        };
+    };
+}, {
+    root: string;
+    pad: string;
+    placeholder: string;
+    guide: string;
+    toolbar: string;
+}, undefined, unknown, unknown, undefined>>;
+type SignatureVariantProps = VariantProps<typeof signatureVariants>;
+export interface SignatureProps extends Omit<ViewProps, 'children'>, Omit<SignatureVariantProps, 'disabled'> {
+    className?: string;
+    /** How tall the pad is. `full` fills its parent instead. */
+    size?: 'sm' | 'md' | 'lg' | 'full';
+    /** Ink colour. Defaults to the theme's foreground. */
+    strokeColor?: string;
+    /** Ink width in points. */
+    strokeWidth?: number;
+    /**
+     * Points closer together than this are dropped as they arrive, so a finger
+     * resting still does not add hundreds of points describing one spot.
+     */
+    minDistance?: number;
+    /** Draw the baseline and its ✕ mark, the way a paper form does. */
+    guideline?: boolean;
+    /** Caption beside the baseline. Only shown with `guideline`. */
+    guidelineLabel?: string;
+    /** Prompt shown over an empty pad. Pass `null` for none. */
+    placeholder?: ReactNode;
+    /** Take no input. The strokes already there stay visible. */
+    disabled?: boolean;
+    /** A stroke has started. */
+    onBegin?: () => void;
+    /** A stroke has finished. */
+    onEnd?: () => void;
+    /**
+     * The number of committed strokes changed — by drawing, undoing, redoing or
+     * clearing. The cheap way to enable a Save button only once something is
+     * there to save.
+     */
+    onChange?: (strokeCount: number) => void;
+    /** Class on the drawing surface inside the border. */
+    padClassName?: string;
+    /** Class on the empty-pad prompt. */
+    placeholderClassName?: string;
+    /** Class on the baseline. */
+    guideClassName?: string;
+}
+export interface SignatureSaveOptions {
+    /**
+     * Directory to write into, as a `file://` URI. Defaults to the app's own
+     * document directory, which survives restarts and is not visible to the user.
+     */
+    directory?: string;
+    /** Filename without an extension. Defaults to `signature-<timestamp>`. */
+    filename?: string;
+    /** `svg` needs no extra packages; `png` rasterises the pad. */
+    format?: 'svg' | 'png';
+    /** PNG only — pixels per point. Higher is sharper and larger. */
+    scale?: number;
+}
+export interface SignatureFile {
+    /** Where it was written, as a `file://` URI. */
+    uri: string;
+    format: 'svg' | 'png';
+    /** The pad's size in points, which is the SVG's coordinate space. */
+    width: number;
+    height: number;
+}
+export interface SignatureHandle {
+    /** Drop every stroke. */
+    clear(): void;
+    /** Remove the last stroke. Repeatable down to empty. */
+    undo(): void;
+    /** Put back the last undone stroke. Drawing again discards the redo stack. */
+    redo(): void;
+    /** True until the first stroke lands. */
+    isEmpty(): boolean;
+    /** How many strokes are on the pad. */
+    strokeCount(): number;
+    /**
+     * The signature as a standalone SVG document, sized to the pad. Pure string
+     * building — no optional package, no async, safe to call every render.
+     */
+    toSVG(): string;
+    /**
+     * A `data:` URI. `svg` is always available; `png` needs
+     * `react-native-view-shot` and throws by name without it.
+     */
+    toDataURL(format?: 'svg' | 'png'): Promise<string>;
+    /**
+     * Write the signature to a file and resolve where it went. Needs
+     * `expo-file-system`, plus `react-native-view-shot` for `png`.
+     */
+    save(options?: SignatureSaveOptions): Promise<SignatureFile>;
+}
+export interface SignatureToolbarProps extends ViewProps {
+    className?: string;
+    children?: ReactNode;
+}
+/** A row of controls under or over the pad. Purely layout. */
+declare function SignatureToolbar({ className, ...props }: SignatureToolbarProps): import("react").JSX.Element;
+declare namespace SignatureToolbar {
+    var displayName: string;
+}
+export interface SignatureButtonProps extends Omit<AnimatedPressableProps, 'children'> {
+    className?: string;
+    /** Take no input, and dim to say so. */
+    disabled?: boolean;
+    /** Replaces the default icon. */
+    children?: ReactNode;
+}
+export declare const Signature: import("react").ForwardRefExoticComponent<SignatureProps & import("react").RefAttributes<SignatureHandle>> & {
+    Toolbar: typeof SignatureToolbar;
+    Undo: {
+        ({ className, disabled, children, accessibilityLabel, ...props }: SignatureButtonProps): import("react").JSX.Element;
+        displayName: string;
+    };
+    Clear: {
+        ({ className, disabled, children, accessibilityLabel, ...props }: SignatureButtonProps): import("react").JSX.Element;
+        displayName: string;
+    };
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,91 @@
+import { type ViewProps } from 'react-native';
+import { type SharedValue } from 'react-native-reanimated';
+export type SoundwaveVariant = 'pills' | 'bars' | 'line' | 'ambient';
+export type SoundwaveState = 'idle' | 'listening' | 'thinking' | 'speaking';
+export interface SoundwaveProps extends Omit<ViewProps, 'children'> {
+    className?: string;
+    /**
+     * Which look to draw: `pills` for a few capsules over a microphone button,
+     * `bars` for a metering strip, `line` for a travelling wave, `ambient` for a
+     * glow that fills its parent.
+     */
+    variant?: SoundwaveVariant;
+    /**
+     * What the app is doing. With no `level` supplied this picks the motion the
+     * wave runs on its own; it always sets what a screen reader announces.
+     */
+    state?: SoundwaveState;
+    /**
+     * Input level, 0–1, from your own recorder's metering. Pass a `SharedValue`
+     * to keep updates off the JS thread entirely. Omit it and the wave animates
+     * plausible motion for the current `state`.
+     */
+    level?: number | SharedValue<number>;
+    /**
+     * Per-band levels, 0–1 each, for `bars` in `static` mode when the app has a
+     * real frequency analysis — or the stored shape of a finished recording.
+     * Resampled to the bar count, and drawn still rather than animated.
+     */
+    levels?: number[];
+    /**
+     * Playback position through a recording, 0–1. Bars behind it keep full ink
+     * and the rest are dimmed, which is the voice-note progress bar. `bars` only,
+     * and it goes with `levels` — a recording has a fixed shape to play through.
+     */
+    progress?: number | SharedValue<number>;
+    /** How many capsules (`pills`) or bars (`bars`) to draw. */
+    bars?: number;
+    /** Capsule width, or bar stroke width. Also the stroke width of `line`. */
+    barWidth?: number;
+    /** Gap between capsules. `bars` spaces itself evenly across the width. */
+    barGap?: number;
+    /** Drawing height. `ambient` ignores it and fills its parent. */
+    height?: number;
+    /**
+     * `static` gives every bar a band of the current level; `scrolling` keeps a
+     * history that slides across, newest at the trailing edge. `bars` only.
+     */
+    mode?: 'static' | 'scrolling';
+    /** Grow bars from the middle out rather than up from the baseline. */
+    centered?: boolean;
+    /** Fade the wave out at both ends, so it does not stop at a hard edge. */
+    fadeEdges?: boolean;
+    /** Multiplier on the incoming level, applied before it is clamped to 1. */
+    sensitivity?: number;
+    /** Multiplier on the wave's own tempo, including how fast history scrolls. */
+    speed?: number;
+    /**
+     * Ink. Takes a colour — `#f97316`, `rgba(…)` — or a **theme token name**,
+     * `color="--color-info"`, which resolves against the active theme and follows
+     * it into dark mode.
+     *
+     * Left unset, a wave inside a surface that publishes a foreground (a chat
+     * bubble, a button) is drawn in that foreground, and anywhere else in
+     * `--color-foreground` — or `--color-info` for `ambient`.
+     */
+    color?: string;
+    /**
+     * Colour across the wave instead of one flat ink: two or more colours spread
+     * left to right, or ramped up from the bottom edge for `ambient`. Literal
+     * colours only — for a themed one, resolve the tokens with `useCSSVariable`
+     * and pass the result.
+     */
+    gradient?: readonly string[];
+    /**
+     * Colour of the part of a recording that has not played yet. Defaults to the
+     * ink at low opacity, which is right for most surfaces; set it when you want
+     * the track to read as its own thing. `bars` with `progress`.
+     */
+    trackColor?: string;
+    /** Freeze on the current frame. */
+    paused?: boolean;
+    /** Corner radius `ambient` traces. Match it to the screen it sits on. */
+    radius?: number;
+    /** Overrides the per-state default announced to screen readers. */
+    accessibilityLabel?: string;
+}
+export declare function Soundwave({ className, variant, state, level, levels, progress, bars, barWidth, barGap, height, mode, centered, fadeEdges, sensitivity, speed, color, gradient, trackColor, paused, radius, accessibilityLabel, style, ...props }: SoundwaveProps): import("react").JSX.Element;
+export declare namespace Soundwave {
+    var displayName: string;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/soundwave/index.tsx"],"names":[],"mappings":"AA6CA,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAEtB,OAAiB,EAMf,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAQjC,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAErE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;AAwrB5E,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B;;;OAGG;IACH,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACxC,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC9B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,SAAS,CAAC,EACxB,SAAS,EACT,OAAiB,EACjB,KAAmB,EACnB,KAAK,EACL,MAAM,EACN,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,MAAM,EACN,IAAe,EACf,QAAe,EACf,SAAS,EACT,WAAe,EACf,KAAS,EACT,KAAK,EACL,QAAQ,EACR,UAAU,EACV,MAAc,EACd,MAAW,EACX,kBAAkB,EAClB,KAAK,EACL,GAAG,KAAK,EACT,EAAE,cAAc,+BA0JhB;yBAlLe,SAAS"}