@passui/react 0.1.17 → 0.1.19

package/dist/types/src/components/toast/toaster.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Toasts drop from the top centre like an island: a small pill carrying the
+ * icon, out of which the message flows. Both shapes sit under an SVG "goo"
+ * filter, so where they meet looks liquid while they grow, morph between
+ * states and shrink away. Text is drawn above the filter to stay crisp.
+ */
+export declare function Toaster({ className, label, }: {
+    className?: string;
+    label?: string;
+}): import("react").JSX.Element;

package/dist/types/src/components/toggle/toggle.d.ts

@@ -0,0 +1,17 @@
+export type ToggleStyle = "switch" | "checkbox";
+export interface ToggleProps {
+    /** Current on or off state. */
+    checked: boolean;
+    /** Called with the next checked state. */
+    onChange: (checked: boolean) => void;
+    /** Accessible name, including when the visible label is hidden. */
+    label: string;
+    disabled?: boolean;
+    /** `switch` for a setting, `checkbox` for a selection. @default "switch" */
+    style?: ToggleStyle;
+    /** Reports a mixed selection to assistive technology. @default false */
+    mixed?: boolean;
+    /** Keeps the accessible name while hiding the visible label. @default false */
+    labelHidden?: boolean;
+}
+export declare function Toggle({ checked, onChange, label, disabled, style, mixed, labelHidden, }: ToggleProps): import("react").JSX.Element;

package/dist/types/src/components/tooltip/tooltip-host.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Tooltips for any element with `data-tooltip`, on devices that can hover.
+ * One listener for the whole app: a short delay before the first, then
+ * instant while moving between controls, as on macOS.
+ */
+export declare function TooltipHost(): import("react").JSX.Element;

package/dist/types/src/components/view-controller/index.d.ts

@@ -0,0 +1 @@
+export * from "./view-controller";

package/dist/types/src/components/view-controller/view-controller.d.ts

@@ -0,0 +1,21 @@
+import type { PropsWithChildren, ReactNode } from "react";
+type ViewControllerProps = PropsWithChildren<{
+    heading: ReactNode;
+    className?: string;
+}>;
+type HeadingProps = {
+    title: ReactNode;
+    description?: ReactNode;
+    action?: ReactNode;
+    size?: keyof typeof titleSizes;
+};
+declare const titleSizes: {
+    readonly default: "text-3xl md:text-4xl";
+    readonly compact: "text-[1.75rem] font-semibold tracking-tight";
+};
+export declare function ViewController({ heading, className, children }: ViewControllerProps): import("react").JSX.Element;
+export declare namespace ViewController {
+    export { Heading };
+}
+declare function Heading({ title, description, action, size }: HeadingProps): import("react").JSX.Element;
+export {};

package/dist/types/src/hooks/scroll/minimize-decision.d.ts

@@ -0,0 +1,2 @@
+/** Programmatic restoration does not collapse chrome; reaching the top always restores it. */
+export declare function minimizeDecision(top: number, anchor: number, userDriven: boolean): boolean | null;

package/dist/types/src/hooks/use-anchored-placement.d.ts

@@ -0,0 +1,7 @@
+import { type AnchoredPlacement } from "../lib/anchored-placement";
+/**
+ * Places a panel of `width` and `needed` height under its anchor and
+ * keeps it there: re-places while the viewport resizes or anything
+ * scrolls, so it never hangs off the screen.
+ */
+export declare function useAnchoredPlacement(anchor: HTMLElement, width: number, needed: number): AnchoredPlacement;

package/dist/types/src/hooks/use-dismiss.d.ts

@@ -0,0 +1,9 @@
+import { type RefObject } from "react";
+/** Marks a floating layer (a pop-up list, a menu) whose clicks belong to what opened it. */
+export { FLOATING_LAYER } from "../lib/floating-layers";
+/**
+ * Calls `onDismiss` when the user presses Escape or clicks outside `ref`
+ * while `active`, for menus, popovers and sheets. Clicks in a floating
+ * layer opened from inside, such as a pop-up button's list, don't count.
+ */
+export declare function useDismiss(ref: RefObject<HTMLElement | null>, active: boolean, onDismiss: () => void): void;

package/dist/types/src/hooks/use-floating-dismiss.d.ts

@@ -0,0 +1,3 @@
+import { type RefObject } from "react";
+/** Dismiss an anchored portal without stealing focus from outside pointer interactions. */
+export declare function useFloatingDismiss(surface: RefObject<HTMLElement | null>, anchor: HTMLElement, onDismiss: (restoreFocus: boolean) => void): void;

package/dist/types/src/hooks/use-media-query.d.ts

@@ -0,0 +1,21 @@
+declare const BREAKPOINTS: {
+    readonly "2xl": 1536;
+    readonly "3xl": 1600;
+    readonly "4xl": 2000;
+    readonly lg: 1024;
+    readonly md: 800;
+    readonly sm: 640;
+    readonly xl: 1280;
+};
+export type Breakpoint = keyof typeof BREAKPOINTS;
+export type BreakpointQuery = Breakpoint | `max-${Breakpoint}` | `${Breakpoint}:max-${Breakpoint}`;
+export type MediaQueryInput = {
+    min?: Breakpoint | number;
+    max?: Breakpoint | number;
+    /** Touch-like input (finger). Use "fine" for mouse/trackpad. */
+    pointer?: PointerPrecision;
+};
+export type PointerPrecision = "coarse" | "fine";
+export declare function useMediaQuery(query: BreakpointQuery | MediaQueryInput | (string & {})): boolean;
+export declare function useIsMobile(): boolean;
+export {};

package/dist/types/src/hooks/use-minimize-on-scroll.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Minimized while you scroll down through content, restored when you scroll
+ * back up or reach the top: iOS 26's `tabBarMinimizeBehavior(.onScrollDown)`.
+ * Listens to every scroll container, since each screen scrolls its own pane.
+ */
+export declare function useMinimizeOnScroll(): readonly [boolean, import("react").Dispatch<import("react").SetStateAction<boolean>>];

package/dist/types/src/hooks/use-visual-viewport.d.ts

@@ -0,0 +1,4 @@
+import type { ViewportMetrics } from "./viewport/types";
+export type { ViewportMetrics } from "./viewport/types";
+/** Measures once per frame, including Android resize and Safari viewport panning. */
+export declare function useVisualViewport(): ViewportMetrics | null;

package/dist/types/src/hooks/viewport/types.d.ts

@@ -0,0 +1,19 @@
+export type ViewportInput = {
+    width: number;
+    height: number;
+    top: number;
+    left: number;
+    layoutHeight: number;
+    editing: boolean;
+};
+export type ViewportMetrics = {
+    width: number;
+    height: number;
+    top: number;
+    left: number;
+    keyboardOpen: boolean;
+};
+export type ViewportBaseline = {
+    width: number;
+    height: number;
+};

package/dist/types/src/hooks/viewport/viewport-metrics.d.ts

@@ -0,0 +1,3 @@
+import type { ViewportBaseline, ViewportInput, ViewportMetrics } from "./types";
+/** A resized WebView and Safari's overlaid keyboard share one visible rectangle. */
+export declare function viewportMetrics(input: ViewportInput, baseline: ViewportBaseline): ViewportMetrics;