@wise/dynamic-flow-types 2.24.1 → 2.26.0

package/build/renderers/ImageRendererProps.d.ts

@@ -0,0 +1,9 @@
+import { Margin, Size } from './constants';
+export type ImageRendererProps = {
+    type: 'image';
+    control?: string;
+    accessibilityDescription?: string;
+    size: Size;
+    margin: Margin;
+    url: string;
+};

package/build/renderers/InstructionsRendererProps.d.ts

@@ -0,0 +1,12 @@
+import { Context, Margin } from './constants';
+export type InstructionsRendererProps = {
+    type: 'instructions';
+    control?: string;
+    items: InstructionItem[];
+    margin: Margin;
+    title?: string;
+};
+export type InstructionItem = {
+    context: Context;
+    text: string;
+};

package/build/renderers/IntegerInputRendererProps.d.ts

@@ -0,0 +1,10 @@
+import { BaseInputRendererProps } from './BaseInputRendererProps';
+export type IntegerInputRendererProps = BaseInputRendererProps & {
+    type: 'input-integer';
+    value: number | null;
+    /** @experimental */
+    maximum?: number;
+    /** @experimental */
+    minimum?: number;
+    onChange: (value: number | null) => void;
+};

package/build/renderers/LoadingIndicatorRendererProps.d.ts

@@ -0,0 +1,7 @@
+import { Margin, Size } from './constants';
+export type LoadingIndicatorRendererProps = {
+    type: 'loading-indicator';
+    control?: string;
+    margin: Margin;
+    size: Size;
+};

package/build/renderers/MarkdownRendererProps.d.ts

@@ -0,0 +1,8 @@
+import { Align, Margin } from './constants';
+export type MarkdownRendererProps = {
+    type: 'markdown';
+    control?: string;
+    align: Align;
+    margin: Margin;
+    content: string;
+};

package/build/renderers/ModalRendererProps.d.ts

@@ -0,0 +1,14 @@
+import { ReactNode } from 'react';
+import { Margin } from './constants';
+export type ModalRendererProps = {
+    type: 'modal';
+    control?: string;
+    content: {
+        components: ReactNode;
+        title?: string;
+    };
+    margin: Margin;
+    trigger: {
+        title: string;
+    };
+};

package/build/renderers/MultiSelectInputRendererProps.d.ts

@@ -0,0 +1,14 @@
+import { BaseInputRendererProps } from './BaseInputRendererProps';
+import { SelectInputRendererOption } from './SelectInputRendererProps';
+export type MultiSelectInputRendererProps = Omit<BaseInputRendererProps, 'required'> & {
+    type: 'input-multi-select';
+    label?: string;
+    description?: string;
+    /** @experimental */
+    maxItems?: number;
+    /** @experimental */
+    minItems?: number;
+    selectedIndices: number[];
+    options: SelectInputRendererOption[];
+    onSelect: (indices: number[]) => void;
+};

package/build/renderers/MultiUploadInputRendererProps.d.ts

@@ -0,0 +1,19 @@
+import { BaseInputRendererProps, ValidationResult } from './BaseInputRendererProps';
+export type MultiUploadInputRendererProps = BaseInputRendererProps & {
+    type: 'input-upload-multi';
+    maxSize?: number;
+    minItems?: number;
+    maxItems?: number;
+    accepts?: string[];
+    uploadLabel?: string;
+    value: FileWithId[];
+    onUpload: (file: File, fileId: string) => Promise<void>;
+    onDelete: (fileId: string) => Promise<void>;
+};
+type FileWithId = {
+    id: string;
+    file: File;
+    /** @experimental */
+    validationState?: ValidationResult;
+};
+export {};

package/build/renderers/NumberInputRendererProps.d.ts

@@ -0,0 +1,10 @@
+import { BaseInputRendererProps } from './BaseInputRendererProps';
+export type NumberInputRendererProps = BaseInputRendererProps & {
+    type: 'input-number';
+    value: number | null;
+    /** @experimental */
+    maximum?: number;
+    /** @experimental */
+    minimum?: number;
+    onChange: (value: number | null) => void;
+};

package/build/renderers/ParagraphRendererProps.d.ts

@@ -0,0 +1,11 @@
+import { Align, Margin } from './constants';
+/**
+ * Known values for "control" are: 'copyable'.
+ */
+export type ParagraphRendererProps = {
+    type: 'paragraph';
+    control?: string;
+    align: Align;
+    margin: Margin;
+    text: string;
+};

package/build/renderers/RendererProps.d.ts

@@ -0,0 +1,38 @@
+import { AlertRendererProps } from './AlertRendererProps';
+import { BooleanInputRendererProps } from './BooleanRendererProps';
+import { BoxRendererProps } from './BoxRendererProps';
+import { ButtonRendererProps } from './ButtonRendererProps';
+import { ColumnsRendererProps } from './ColumnsRendererProps';
+import { CoreContainerRendererProps } from './CoreContainerRendererProps';
+import { DateInputRendererProps } from './DateInputRendererProps';
+import { DecisionRendererProps } from './DecisionRendererProps';
+import { DividerRendererProps } from './DividerRendererProps';
+import { FormRendererProps } from './FormRendererProps';
+import { FormSectionRendererProps } from './FormSectionRendererProps';
+import { HeadingRendererProps } from './HeadingRendererProps';
+import { HiddenRendererProps } from './HiddenRendererProps';
+import { ImageRendererProps } from './ImageRendererProps';
+import { InstructionsRendererProps } from './InstructionsRendererProps';
+import { IntegerInputRendererProps } from './IntegerInputRendererProps';
+import { LoadingIndicatorRendererProps } from './LoadingIndicatorRendererProps';
+import { MarkdownRendererProps } from './MarkdownRendererProps';
+import { ModalRendererProps } from './ModalRendererProps';
+import { MultiSelectInputRendererProps } from './MultiSelectInputRendererProps';
+import { MultiUploadInputRendererProps } from './MultiUploadInputRendererProps';
+import { NumberInputRendererProps } from './NumberInputRendererProps';
+import { ParagraphRendererProps } from './ParagraphRendererProps';
+import { RepeatableRendererProps } from './RepeatableRendererProps';
+import { ReviewRendererProps } from './ReviewRendererProps';
+import { SearchRendererProps } from './SearchRendererProps';
+import { SelectInputRendererProps } from './SelectInputRendererProps';
+import { StatusListRendererProps } from './StatusListRendererProps';
+import { StepRendererProps } from './StepRendererProps';
+import { TextInputRendererProps } from './TextInputRendererProps';
+import { UploadInputRendererProps } from './UploadInputRendererProps';
+export type RendererProps = AlertRendererProps | BooleanInputRendererProps | BoxRendererProps | ButtonRendererProps | ColumnsRendererProps | CoreContainerRendererProps | DateInputRendererProps | DecisionRendererProps | DividerRendererProps | FormRendererProps | FormSectionRendererProps | HeadingRendererProps | HiddenRendererProps | ImageRendererProps | InstructionsRendererProps | IntegerInputRendererProps | LoadingIndicatorRendererProps | MarkdownRendererProps | ModalRendererProps | MultiSelectInputRendererProps | MultiUploadInputRendererProps | NumberInputRendererProps | ParagraphRendererProps | RepeatableRendererProps | ReviewRendererProps | SearchRendererProps | SelectInputRendererProps | StatusListRendererProps | StepRendererProps | TextInputRendererProps | UploadInputRendererProps;
+export type Renderer<P extends RendererProps> = {
+    canRenderType: P['type'];
+    canRender?: (props: P) => boolean;
+    render: (props: P) => JSX.Element;
+};
+export type Renderers = readonly (Renderer<StepRendererProps> | Renderer<CoreContainerRendererProps> | Renderer<AlertRendererProps> | Renderer<BoxRendererProps> | Renderer<ColumnsRendererProps> | Renderer<DecisionRendererProps> | Renderer<DividerRendererProps> | Renderer<FormRendererProps> | Renderer<HeadingRendererProps> | Renderer<InstructionsRendererProps> | Renderer<LoadingIndicatorRendererProps> | Renderer<MarkdownRendererProps> | Renderer<ImageRendererProps> | Renderer<ModalRendererProps> | Renderer<ParagraphRendererProps> | Renderer<ReviewRendererProps> | Renderer<SearchRendererProps> | Renderer<StatusListRendererProps> | Renderer<FormSectionRendererProps> | Renderer<BooleanInputRendererProps> | Renderer<ButtonRendererProps> | Renderer<DateInputRendererProps> | Renderer<HiddenRendererProps> | Renderer<IntegerInputRendererProps> | Renderer<NumberInputRendererProps> | Renderer<RepeatableRendererProps> | Renderer<SelectInputRendererProps> | Renderer<MultiSelectInputRendererProps> | Renderer<TextInputRendererProps> | Renderer<UploadInputRendererProps> | Renderer<MultiUploadInputRendererProps>)[];

package/build/renderers/RepeatableRendererProps.d.ts

@@ -0,0 +1,38 @@
+import { ReactNode } from 'react';
+import { Icon } from './Icon';
+import { Image } from './Image';
+import { ValidationResult } from './BaseInputRendererProps';
+export type RepeatableRendererProps = {
+    type: 'repeatable';
+    control?: string;
+    addItemTitle: string;
+    description?: string;
+    children: ReactNode[];
+    editableItem: ReactNode;
+    editItemTitle: string;
+    /**
+     * @deprecated please use the `validationState` property instead
+     */
+    error?: string;
+    /** @experimental */
+    validationState: ValidationResult | undefined;
+    items: RepeatableItemRendererProps[];
+    title: string;
+    /** @experimental */
+    maxItems?: number;
+    /** @experimental */
+    minItems?: number;
+    icon?: Icon;
+    image?: Image;
+    onAdd: () => void;
+    onEdit: (itemIndex: number) => void;
+    onSave: () => boolean;
+    onRemove: () => void;
+};
+export type RepeatableItemRendererProps = {
+    id: string;
+    description?: string;
+    icon?: Icon;
+    image?: Image;
+    title?: string;
+};

package/build/renderers/ReviewRendererProps.d.ts

@@ -0,0 +1,18 @@
+import { Margin } from './constants';
+export type ReviewRendererProps = {
+    type: 'review';
+    control?: string;
+    fields: ReviewField[];
+    margin: Margin;
+    title?: string;
+    callToAction?: ReviewCallToAction;
+};
+export type ReviewField = {
+    help?: string;
+    label: string;
+    value: string;
+};
+export type ReviewCallToAction = {
+    title: string;
+    onClick: () => void;
+};

package/build/renderers/SearchRendererProps.d.ts

@@ -0,0 +1,33 @@
+import type { SearchResult as SearchResultSpec } from '../next';
+import { Margin } from './constants';
+export type SearchRendererProps = {
+    type: 'search';
+    control?: string;
+    id: string;
+    isLoading: boolean;
+    margin: Margin;
+    query: string;
+    onChange: (query: string) => void;
+    state: SearchState;
+    title: string;
+};
+export type SearchState = PendingSearchState | NoResultsSearchState | ResultsSearchState | ErrorSearchState;
+export type PendingSearchState = {
+    type: 'pending';
+};
+export type NoResultsSearchState = {
+    type: 'noResults';
+    message: string;
+};
+export type ErrorSearchState = {
+    type: 'error';
+    onRetry: () => void;
+};
+export type ResultsSearchState = {
+    type: 'results';
+    results: SearchResult[];
+};
+export type SearchResult = Pick<SearchResultSpec, 'description' | 'icon' | 'image' | 'title' | 'type'> & {
+    id?: string;
+    onClick: () => void;
+};

package/build/renderers/SelectInputRendererProps.d.ts

@@ -0,0 +1,19 @@
+import { ReactNode } from 'react';
+import { BaseInputRendererProps } from './BaseInputRendererProps';
+import { Icon } from './Icon';
+import { Image } from './Image';
+export type SelectInputRendererProps = BaseInputRendererProps & {
+    type: 'input-select';
+    children: ReactNode;
+    options: SelectInputRendererOption[];
+    selectedIndex: number | null;
+    onSelect: (index: number | null) => void;
+};
+export type SelectInputRendererOption = {
+    description?: string;
+    disabled: boolean;
+    icon?: Icon;
+    image?: Image;
+    keywords?: string[];
+    title: string;
+};

package/build/renderers/StatusListRendererProps.d.ts

@@ -0,0 +1,23 @@
+import { Icon } from './Icon';
+import { Margin } from './constants';
+export type StatusListRendererProps = {
+    type: 'status-list';
+    control?: string;
+    items: StatusListItem[];
+    margin: Margin;
+    title?: string;
+};
+export type StatusListItem = {
+    description?: string;
+    icon: Icon;
+    status?: 'done' | 'not-done' | 'pending';
+    title: string;
+    callToAction?: StatusListItemCallToAction;
+};
+export type StatusListItemCallToAction = {
+    accessibilityDescription?: string;
+    href?: string;
+    title: string;
+    onClick: () => void;
+};
+export type StatusListItemStatus = 'done' | 'not-done' | 'pending';

package/build/renderers/StepRendererProps.d.ts

@@ -0,0 +1,25 @@
+import type { Action, Step } from '../next';
+import type { ReactNode } from 'react';
+export type AnalyticsEventDispatcher = (eventName: string, properties?: Record<string, unknown>) => void;
+export type LoadingState = 'idle' | 'submitting' | 'refreshing';
+export type StepRendererProps = {
+    type: 'step';
+    control?: string;
+    back?: {
+        title?: string;
+        onClick: () => void;
+    };
+    description?: string;
+    error?: string;
+    external?: {
+        url: string;
+    };
+    loadingState: LoadingState;
+    title?: string;
+    trackEvent: AnalyticsEventDispatcher;
+    /** @experimental Please do not use this property. It is only here to support a legacy camera step. */
+    step?: Step;
+    /** @experimental Please do not use this function. Calling onAction from a step renderer completely bypasses the core logic and may result in unexpected behavior. It is only here to support a legacy camera step. */
+    onAction?: (action: Action) => void | Promise<void>;
+    children: ReactNode;
+};

package/build/renderers/TextInputRendererProps.d.ts

@@ -0,0 +1,14 @@
+import { BaseInputRendererProps } from './BaseInputRendererProps';
+/**
+ * Known values for "control" are: 'password' | 'textarea' | 'email' | 'numeric' | 'phone-number'.
+ */
+export type TextInputRendererProps = BaseInputRendererProps & {
+    type: 'input-text';
+    displayFormat?: string;
+    value: string | null;
+    /** @experimental */
+    maxLength?: number;
+    /** @experimental */
+    minLength?: number;
+    onChange: (value: string | null) => void;
+};

package/build/renderers/UploadInputRendererProps.d.ts

@@ -0,0 +1,8 @@
+import { BaseInputRendererProps } from './BaseInputRendererProps';
+export type UploadInputRendererProps = BaseInputRendererProps & {
+    type: 'input-upload';
+    maxSize?: number;
+    accepts?: string[];
+    value: File | null;
+    onUpload: (file: File | null) => Promise<void>;
+};

package/build/renderers/constants.d.ts

@@ -0,0 +1,3 @@
+export type Align = 'start' | 'center' | 'end';
+export type Context = 'positive' | 'negative' | 'warning' | 'neutral';
+export type { Margin, Size } from '../next';