@refraction-ui/react 0.4.2 → 0.5.0

package/dist/internal/feedback-dialog/index.d.cts

@@ -0,0 +1,55 @@
+import { AccessibilityProps } from '../shared/index.cjs';
+import { DialogAPI } from '../dialog/index.cjs';
+
+type FeedbackType = 'text' | 'video' | 'general';
+interface FeedbackDialogProps {
+    /** Whether the dialog is open (controlled) */
+    open?: boolean;
+    /** Callback when open state changes */
+    onOpenChange?: (open: boolean) => void;
+    /** Callback when feedback is submitted */
+    onSubmit?: (data: FeedbackData) => void | Promise<void>;
+    /** Feedback type */
+    type?: FeedbackType;
+}
+interface FeedbackData {
+    comment: string;
+    email?: string;
+    type: FeedbackType;
+    selectedText?: string;
+}
+interface FeedbackFormState {
+    comment: string;
+    email: string;
+    honeypot: string;
+}
+interface FeedbackDialogState {
+    open: boolean;
+    isSubmitting: boolean;
+    isSubmitted: boolean;
+}
+interface FeedbackDialogAPI {
+    /** Current state */
+    state: FeedbackDialogState;
+    /** Dialog props from the underlying createDialog */
+    dialogProps: DialogAPI;
+    /** Form field values */
+    formState: FeedbackFormState;
+    /** Set a form field value */
+    setField(field: keyof FeedbackFormState, value: string): void;
+    /** Submit the feedback form */
+    submit(): Promise<void>;
+    /** Reset form to initial state */
+    reset(): void;
+    /** ARIA props for the feedback dialog */
+    ariaProps: Partial<AccessibilityProps> & Record<string, unknown>;
+}
+declare function createFeedbackDialog(props?: FeedbackDialogProps): FeedbackDialogAPI;
+
+declare const feedbackDialogVariants: (props?: ({
+    type?: "text" | "video" | "general" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+
+export { type FeedbackData, type FeedbackDialogAPI, type FeedbackDialogProps, type FeedbackDialogState, type FeedbackFormState, type FeedbackType, createFeedbackDialog, feedbackDialogVariants };

package/dist/internal/feedback-dialog/index.d.ts

@@ -0,0 +1,55 @@
+import { AccessibilityProps } from '../shared/index.js';
+import { DialogAPI } from '../dialog/index.js';
+
+type FeedbackType = 'text' | 'video' | 'general';
+interface FeedbackDialogProps {
+    /** Whether the dialog is open (controlled) */
+    open?: boolean;
+    /** Callback when open state changes */
+    onOpenChange?: (open: boolean) => void;
+    /** Callback when feedback is submitted */
+    onSubmit?: (data: FeedbackData) => void | Promise<void>;
+    /** Feedback type */
+    type?: FeedbackType;
+}
+interface FeedbackData {
+    comment: string;
+    email?: string;
+    type: FeedbackType;
+    selectedText?: string;
+}
+interface FeedbackFormState {
+    comment: string;
+    email: string;
+    honeypot: string;
+}
+interface FeedbackDialogState {
+    open: boolean;
+    isSubmitting: boolean;
+    isSubmitted: boolean;
+}
+interface FeedbackDialogAPI {
+    /** Current state */
+    state: FeedbackDialogState;
+    /** Dialog props from the underlying createDialog */
+    dialogProps: DialogAPI;
+    /** Form field values */
+    formState: FeedbackFormState;
+    /** Set a form field value */
+    setField(field: keyof FeedbackFormState, value: string): void;
+    /** Submit the feedback form */
+    submit(): Promise<void>;
+    /** Reset form to initial state */
+    reset(): void;
+    /** ARIA props for the feedback dialog */
+    ariaProps: Partial<AccessibilityProps> & Record<string, unknown>;
+}
+declare function createFeedbackDialog(props?: FeedbackDialogProps): FeedbackDialogAPI;
+
+declare const feedbackDialogVariants: (props?: ({
+    type?: "text" | "video" | "general" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+
+export { type FeedbackData, type FeedbackDialogAPI, type FeedbackDialogProps, type FeedbackDialogState, type FeedbackFormState, type FeedbackType, createFeedbackDialog, feedbackDialogVariants };

package/dist/internal/file-upload/index.d.cts

@@ -0,0 +1,91 @@
+import { AccessibilityProps } from '../shared/index.cjs';
+
+type FileStatus = 'pending' | 'uploading' | 'complete' | 'error';
+interface FileEntry {
+    /** Unique ID for this file entry */
+    id: string;
+    /** Original file name */
+    name: string;
+    /** File size in bytes */
+    size: number;
+    /** MIME type */
+    type: string;
+    /** Upload progress 0-100 */
+    progress: number;
+    /** Current status */
+    status: FileStatus;
+    /** Error message if status is 'error' */
+    error?: string;
+}
+interface FileUploadProps {
+    /** Accepted file types (e.g., 'image/*,.pdf') */
+    accept?: string;
+    /** Max file size in bytes */
+    maxSize?: number;
+    /** Max number of files */
+    maxFiles?: number;
+    /** Allow multiple file selection */
+    multiple?: boolean;
+    /** Callback when files are selected/added */
+    onFilesSelected?: (files: FileEntry[]) => void;
+    /** Callback when a validation error occurs */
+    onError?: (errors: FileUploadError[]) => void;
+}
+interface FileUploadError {
+    file: string;
+    code: 'type' | 'size' | 'count';
+    message: string;
+}
+interface FileUploadState {
+    files: FileEntry[];
+    isDragging: boolean;
+}
+interface FileUploadAPI {
+    /** Current state */
+    state: FileUploadState;
+    /** Add files (validates type, size, count) */
+    addFiles(files: Array<{
+        name: string;
+        size: number;
+        type: string;
+    }>): void;
+    /** Remove a file by ID */
+    removeFile(id: string): void;
+    /** Update a file's progress */
+    updateProgress(id: string, progress: number): void;
+    /** Set a file's status */
+    setStatus(id: string, status: FileStatus, error?: string): void;
+    /** ARIA props for the drop zone */
+    dropZoneProps: Partial<AccessibilityProps> & Record<string, unknown>;
+    /** ARIA props for the file input */
+    inputProps: Record<string, unknown>;
+    /** Drag event handlers (for headless use) */
+    dragHandlers: {
+        onDragEnter(): void;
+        onDragLeave(): void;
+        onDragOver(): void;
+        onDrop(): void;
+    };
+    /** Generated IDs */
+    ids: {
+        dropZone: string;
+        input: string;
+        label: string;
+        fileList: string;
+    };
+}
+declare function formatFileSize(bytes: number): string;
+declare function createFileUpload(props?: FileUploadProps): FileUploadAPI;
+
+declare const fileUploadDropZoneVariants: (props?: ({
+    state?: "idle" | "dragging" | "disabled" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+declare const fileUploadFileListStyles = "mt-4 space-y-2";
+declare const fileUploadFileItemStyles = "flex items-center gap-3 rounded-md border p-3 text-sm";
+declare const fileUploadProgressStyles = "h-1.5 w-full rounded-full bg-secondary overflow-hidden";
+declare const fileUploadProgressBarStyles = "h-full rounded-full bg-primary transition-all duration-300";
+declare const fileUploadRemoveButtonStyles = "ml-auto text-muted-foreground hover:text-foreground cursor-pointer";
+
+export { type FileEntry, type FileStatus, type FileUploadAPI, type FileUploadError, type FileUploadProps, type FileUploadState, createFileUpload, fileUploadDropZoneVariants, fileUploadFileItemStyles, fileUploadFileListStyles, fileUploadProgressBarStyles, fileUploadProgressStyles, fileUploadRemoveButtonStyles, formatFileSize };

package/dist/internal/file-upload/index.d.ts

@@ -0,0 +1,91 @@
+import { AccessibilityProps } from '../shared/index.js';
+
+type FileStatus = 'pending' | 'uploading' | 'complete' | 'error';
+interface FileEntry {
+    /** Unique ID for this file entry */
+    id: string;
+    /** Original file name */
+    name: string;
+    /** File size in bytes */
+    size: number;
+    /** MIME type */
+    type: string;
+    /** Upload progress 0-100 */
+    progress: number;
+    /** Current status */
+    status: FileStatus;
+    /** Error message if status is 'error' */
+    error?: string;
+}
+interface FileUploadProps {
+    /** Accepted file types (e.g., 'image/*,.pdf') */
+    accept?: string;
+    /** Max file size in bytes */
+    maxSize?: number;
+    /** Max number of files */
+    maxFiles?: number;
+    /** Allow multiple file selection */
+    multiple?: boolean;
+    /** Callback when files are selected/added */
+    onFilesSelected?: (files: FileEntry[]) => void;
+    /** Callback when a validation error occurs */
+    onError?: (errors: FileUploadError[]) => void;
+}
+interface FileUploadError {
+    file: string;
+    code: 'type' | 'size' | 'count';
+    message: string;
+}
+interface FileUploadState {
+    files: FileEntry[];
+    isDragging: boolean;
+}
+interface FileUploadAPI {
+    /** Current state */
+    state: FileUploadState;
+    /** Add files (validates type, size, count) */
+    addFiles(files: Array<{
+        name: string;
+        size: number;
+        type: string;
+    }>): void;
+    /** Remove a file by ID */
+    removeFile(id: string): void;
+    /** Update a file's progress */
+    updateProgress(id: string, progress: number): void;
+    /** Set a file's status */
+    setStatus(id: string, status: FileStatus, error?: string): void;
+    /** ARIA props for the drop zone */
+    dropZoneProps: Partial<AccessibilityProps> & Record<string, unknown>;
+    /** ARIA props for the file input */
+    inputProps: Record<string, unknown>;
+    /** Drag event handlers (for headless use) */
+    dragHandlers: {
+        onDragEnter(): void;
+        onDragLeave(): void;
+        onDragOver(): void;
+        onDrop(): void;
+    };
+    /** Generated IDs */
+    ids: {
+        dropZone: string;
+        input: string;
+        label: string;
+        fileList: string;
+    };
+}
+declare function formatFileSize(bytes: number): string;
+declare function createFileUpload(props?: FileUploadProps): FileUploadAPI;
+
+declare const fileUploadDropZoneVariants: (props?: ({
+    state?: "idle" | "dragging" | "disabled" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+declare const fileUploadFileListStyles = "mt-4 space-y-2";
+declare const fileUploadFileItemStyles = "flex items-center gap-3 rounded-md border p-3 text-sm";
+declare const fileUploadProgressStyles = "h-1.5 w-full rounded-full bg-secondary overflow-hidden";
+declare const fileUploadProgressBarStyles = "h-full rounded-full bg-primary transition-all duration-300";
+declare const fileUploadRemoveButtonStyles = "ml-auto text-muted-foreground hover:text-foreground cursor-pointer";
+
+export { type FileEntry, type FileStatus, type FileUploadAPI, type FileUploadError, type FileUploadProps, type FileUploadState, createFileUpload, fileUploadDropZoneVariants, fileUploadFileItemStyles, fileUploadFileListStyles, fileUploadProgressBarStyles, fileUploadProgressStyles, fileUploadRemoveButtonStyles, formatFileSize };

package/dist/internal/footer/index.d.cts

@@ -0,0 +1,30 @@
+interface SocialLink {
+    label: string;
+    href: string;
+    icon?: string;
+}
+interface FooterColumn {
+    title: string;
+    links: {
+        label: string;
+        href: string;
+    }[];
+}
+interface FooterProps {
+    copyright?: string;
+    socialLinks?: SocialLink[];
+    columns?: FooterColumn[];
+}
+interface FooterAPI {
+    ariaProps: Record<string, string>;
+    copyrightText: string;
+}
+declare function createFooter(props?: FooterProps): FooterAPI;
+
+declare const footerVariants: (props?: ({
+    [x: string]: string | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+
+export { type FooterAPI, type FooterColumn, type FooterProps, type SocialLink, createFooter, footerVariants };

package/dist/internal/footer/index.d.ts

@@ -0,0 +1,30 @@
+interface SocialLink {
+    label: string;
+    href: string;
+    icon?: string;
+}
+interface FooterColumn {
+    title: string;
+    links: {
+        label: string;
+        href: string;
+    }[];
+}
+interface FooterProps {
+    copyright?: string;
+    socialLinks?: SocialLink[];
+    columns?: FooterColumn[];
+}
+interface FooterAPI {
+    ariaProps: Record<string, string>;
+    copyrightText: string;
+}
+declare function createFooter(props?: FooterProps): FooterAPI;
+
+declare const footerVariants: (props?: ({
+    [x: string]: string | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+
+export { type FooterAPI, type FooterColumn, type FooterProps, type SocialLink, createFooter, footerVariants };

package/dist/internal/inline-editor/index.d.cts

@@ -0,0 +1,52 @@
+interface InlineEditorProps {
+    /** Current value */
+    value: string;
+    /** Callback when saving */
+    onSave?: (value: string) => void;
+    /** Callback when cancelling */
+    onCancel?: () => void;
+}
+interface ToolbarAction {
+    name: string;
+    syntax: string;
+}
+interface InlineEditorState {
+    isEditing: boolean;
+    value: string;
+    preview: string;
+}
+interface InlineEditorAPI {
+    /** Current editor state */
+    state: InlineEditorState;
+    /** Enter editing mode */
+    startEditing(): void;
+    /** Cancel editing, revert to original value */
+    cancel(): void;
+    /** Save the current value */
+    save(): void;
+    /** Update the editing value */
+    updateValue(value: string): void;
+    /** Insert syntax at cursor position */
+    insertAtCursor(syntax: string): void;
+    /** Available toolbar actions */
+    toolbarActions: ToolbarAction[];
+}
+declare function createInlineEditor(props: InlineEditorProps): InlineEditorAPI;
+
+declare const editorVariants: (props?: ({
+    state?: "viewing" | "editing" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+declare const toolbarVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+declare const previewVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+
+export { type InlineEditorAPI, type InlineEditorProps, type InlineEditorState, type ToolbarAction, createInlineEditor, editorVariants, previewVariants, toolbarVariants };

package/dist/internal/inline-editor/index.d.ts

@@ -0,0 +1,52 @@
+interface InlineEditorProps {
+    /** Current value */
+    value: string;
+    /** Callback when saving */
+    onSave?: (value: string) => void;
+    /** Callback when cancelling */
+    onCancel?: () => void;
+}
+interface ToolbarAction {
+    name: string;
+    syntax: string;
+}
+interface InlineEditorState {
+    isEditing: boolean;
+    value: string;
+    preview: string;
+}
+interface InlineEditorAPI {
+    /** Current editor state */
+    state: InlineEditorState;
+    /** Enter editing mode */
+    startEditing(): void;
+    /** Cancel editing, revert to original value */
+    cancel(): void;
+    /** Save the current value */
+    save(): void;
+    /** Update the editing value */
+    updateValue(value: string): void;
+    /** Insert syntax at cursor position */
+    insertAtCursor(syntax: string): void;
+    /** Available toolbar actions */
+    toolbarActions: ToolbarAction[];
+}
+declare function createInlineEditor(props: InlineEditorProps): InlineEditorAPI;
+
+declare const editorVariants: (props?: ({
+    state?: "viewing" | "editing" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+declare const toolbarVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+declare const previewVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+
+export { type InlineEditorAPI, type InlineEditorProps, type InlineEditorState, type ToolbarAction, createInlineEditor, editorVariants, previewVariants, toolbarVariants };

package/dist/internal/input/index.d.cts

@@ -0,0 +1,38 @@
+import { AccessibilityProps } from '../shared/index.cjs';
+
+type InputType = 'text' | 'password' | 'email' | 'number' | 'tel' | 'url' | 'search';
+interface InputProps {
+    type?: InputType;
+    disabled?: boolean;
+    readOnly?: boolean;
+    required?: boolean;
+    placeholder?: string;
+    'aria-invalid'?: boolean;
+}
+interface InputAPI {
+    /** ARIA attributes to spread on the element */
+    ariaProps: Partial<AccessibilityProps> & {
+        'aria-invalid'?: boolean;
+        'aria-required'?: boolean;
+    };
+    /** Data attributes for CSS styling hooks */
+    dataAttributes: Record<string, string>;
+}
+declare function createInput(props?: InputProps): InputAPI;
+declare function getInputAriaProps(state: {
+    disabled?: boolean;
+    readOnly?: boolean;
+    required?: boolean;
+    invalid?: boolean;
+}): Partial<AccessibilityProps> & {
+    'aria-invalid'?: boolean;
+    'aria-required'?: boolean;
+};
+
+declare const inputVariants: (props?: ({
+    size?: "sm" | "default" | "lg" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+
+export { type InputAPI, type InputProps, type InputType, createInput, getInputAriaProps, inputVariants };

package/dist/internal/input/index.d.ts

@@ -0,0 +1,38 @@
+import { AccessibilityProps } from '../shared/index.js';
+
+type InputType = 'text' | 'password' | 'email' | 'number' | 'tel' | 'url' | 'search';
+interface InputProps {
+    type?: InputType;
+    disabled?: boolean;
+    readOnly?: boolean;
+    required?: boolean;
+    placeholder?: string;
+    'aria-invalid'?: boolean;
+}
+interface InputAPI {
+    /** ARIA attributes to spread on the element */
+    ariaProps: Partial<AccessibilityProps> & {
+        'aria-invalid'?: boolean;
+        'aria-required'?: boolean;
+    };
+    /** Data attributes for CSS styling hooks */
+    dataAttributes: Record<string, string>;
+}
+declare function createInput(props?: InputProps): InputAPI;
+declare function getInputAriaProps(state: {
+    disabled?: boolean;
+    readOnly?: boolean;
+    required?: boolean;
+    invalid?: boolean;
+}): Partial<AccessibilityProps> & {
+    'aria-invalid'?: boolean;
+    'aria-required'?: boolean;
+};
+
+declare const inputVariants: (props?: ({
+    size?: "sm" | "default" | "lg" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+
+export { type InputAPI, type InputProps, type InputType, createInput, getInputAriaProps, inputVariants };

package/dist/internal/input-group/index.d.cts

@@ -0,0 +1,35 @@
+import { AccessibilityProps, TokenContract } from '../shared/index.cjs';
+
+type InputGroupOrientation = 'horizontal' | 'vertical';
+interface InputGroupProps {
+    orientation?: InputGroupOrientation;
+    id?: string;
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+}
+interface InputGroupAPI {
+    /** ARIA attributes to spread on the group container */
+    ariaProps: Partial<AccessibilityProps>;
+    /** Data attributes for CSS styling hooks */
+    dataAttributes: Record<string, string>;
+}
+declare function createInputGroup(props?: InputGroupProps): InputGroupAPI;
+
+declare const inputGroupTokens: TokenContract;
+declare const inputGroupVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+declare const inputGroupAddonVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+declare const inputGroupButtonVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+
+export { type InputGroupAPI, type InputGroupOrientation, type InputGroupProps, createInputGroup, inputGroupAddonVariants, inputGroupButtonVariants, inputGroupTokens, inputGroupVariants };

package/dist/internal/input-group/index.d.ts

@@ -0,0 +1,35 @@
+import { AccessibilityProps, TokenContract } from '../shared/index.js';
+
+type InputGroupOrientation = 'horizontal' | 'vertical';
+interface InputGroupProps {
+    orientation?: InputGroupOrientation;
+    id?: string;
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+}
+interface InputGroupAPI {
+    /** ARIA attributes to spread on the group container */
+    ariaProps: Partial<AccessibilityProps>;
+    /** Data attributes for CSS styling hooks */
+    dataAttributes: Record<string, string>;
+}
+declare function createInputGroup(props?: InputGroupProps): InputGroupAPI;
+
+declare const inputGroupTokens: TokenContract;
+declare const inputGroupVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+declare const inputGroupAddonVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+declare const inputGroupButtonVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+
+export { type InputGroupAPI, type InputGroupOrientation, type InputGroupProps, createInputGroup, inputGroupAddonVariants, inputGroupButtonVariants, inputGroupTokens, inputGroupVariants };

package/dist/internal/install-prompt/index.d.cts

@@ -0,0 +1,36 @@
+interface StorageAdapter {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+}
+interface InstallPromptProps {
+    /** Delay in ms before showing prompt. Default: 3000 */
+    delay?: number;
+    /** Key used to persist dismissed state. Default: 'rfr-install-dismissed' */
+    storageKey?: string;
+}
+interface InstallPromptState {
+    canShow: boolean;
+    isDismissed: boolean;
+}
+interface InstallPromptAPI {
+    state: InstallPromptState;
+    /** Mark the prompt as showable (call after delay + event fire) */
+    show(): void;
+    /** Dismiss and persist */
+    dismiss(): void;
+    /** Trigger the browser install prompt */
+    install(promptEvent?: {
+        prompt(): void;
+    }): void;
+    /** ARIA attributes for the banner */
+    ariaProps: Record<string, string>;
+}
+declare function createInstallPrompt(props?: InstallPromptProps, storage?: StorageAdapter): InstallPromptAPI;
+
+declare const installPromptVariants: (props?: ({
+    [x: string]: string | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+
+export { type InstallPromptAPI, type InstallPromptProps, type InstallPromptState, type StorageAdapter, createInstallPrompt, installPromptVariants };

package/dist/internal/install-prompt/index.d.ts

@@ -0,0 +1,36 @@
+interface StorageAdapter {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+}
+interface InstallPromptProps {
+    /** Delay in ms before showing prompt. Default: 3000 */
+    delay?: number;
+    /** Key used to persist dismissed state. Default: 'rfr-install-dismissed' */
+    storageKey?: string;
+}
+interface InstallPromptState {
+    canShow: boolean;
+    isDismissed: boolean;
+}
+interface InstallPromptAPI {
+    state: InstallPromptState;
+    /** Mark the prompt as showable (call after delay + event fire) */
+    show(): void;
+    /** Dismiss and persist */
+    dismiss(): void;
+    /** Trigger the browser install prompt */
+    install(promptEvent?: {
+        prompt(): void;
+    }): void;
+    /** ARIA attributes for the banner */
+    ariaProps: Record<string, string>;
+}
+declare function createInstallPrompt(props?: InstallPromptProps, storage?: StorageAdapter): InstallPromptAPI;
+
+declare const installPromptVariants: (props?: ({
+    [x: string]: string | undefined;
+} & {
+    className?: string;
+}) | undefined) => string;
+
+export { type InstallPromptAPI, type InstallPromptProps, type InstallPromptState, type StorageAdapter, createInstallPrompt, installPromptVariants };