@konomi-app/ui 5.1.0 → 5.3.2

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as lit from 'lit';
 import { LitElement, TemplateResult } from 'lit';
 
-type DialogType = 'loading' | 'alert' | 'confirm' | 'queue' | 'steps';
+type DialogType = 'loading' | 'alert' | 'confirm' | 'queue' | 'steps' | 'form' | 'step-form';
 type AlertIcon = 'success' | 'error' | 'warning' | 'info';
 type QueueItemStatus = 'pending' | 'active' | 'done' | 'skipped' | 'error';
 type StepItemStatus = 'pending' | 'active' | 'done' | 'skipped' | 'error';
@@ -19,6 +19,78 @@ type TaskItemInput = string | {
     key: string;
     label: string;
 };
+type FormInputType = 'text' | 'number' | 'checkbox' | 'select' | 'date' | 'email' | 'url';
+interface FormFieldMeta {
+    key: string;
+    inputType: FormInputType;
+    label: string;
+    description: string;
+    required: boolean;
+    options: string[];
+    placeholder: string;
+    min?: number;
+    max?: number;
+    minLength?: number;
+    maxLength?: number;
+    defaultValue: unknown;
+}
+interface FormFieldGroup {
+    label?: string;
+    fields: string[];
+    columns?: number;
+}
+interface FormLayout {
+    columns?: number;
+    gap?: string;
+    fieldOrder?: string[];
+    groups?: FormFieldGroup[];
+}
+interface FormOptions<T = Record<string, unknown>> {
+    title?: string;
+    description?: string;
+    confirmButtonText?: string;
+    cancelButtonText?: string;
+    allowOutsideClick?: boolean;
+    allowEscapeKey?: boolean;
+    layout?: FormLayout;
+    defaultValues?: Partial<T>;
+    validateOnChange?: boolean;
+    validateOnBlur?: boolean;
+}
+/** フォームを持つ1ステップの描画状態 (コントローラー内部で管理) */
+interface StepFormItem {
+    key: string;
+    label: string;
+    description: string;
+    fields: FormFieldMeta[];
+    values: Record<string, unknown>;
+    errors: Record<string, string>;
+    touched: Record<string, boolean>;
+    layout: FormLayout;
+}
+/** `showStepForm()` に渡す各ステップの定義 */
+interface StepFormStepInput {
+    key: string;
+    label: string;
+    description?: string;
+    /** Zod スキーマ。省略するとフォームなし (説明のみ) のステップになる */
+    schema?: {
+        _def: any;
+        safeParse: (data: unknown) => any;
+    };
+    layout?: FormLayout;
+    defaultValues?: Record<string, unknown>;
+}
+/** `showStepForm()` のオプション */
+interface StepFormOptions {
+    title?: string;
+    allowOutsideClick?: boolean;
+    allowEscapeKey?: boolean;
+    nextButtonText?: string;
+    prevButtonText?: string;
+    submitButtonText?: string;
+    cancelButtonText?: string;
+}
 interface ShowOptions {
     type: DialogType;
     label?: string;
@@ -71,6 +143,18 @@ interface DialogState {
     steps: StepItem[];
     timer: number | null;
     title: string;
+    formFields: FormFieldMeta[];
+    formValues: Record<string, unknown>;
+    formErrors: Record<string, string>;
+    formTouched: Record<string, boolean>;
+    formLayout: FormLayout;
+    formValidateOnChange: boolean;
+    formValidateOnBlur: boolean;
+    stepFormSteps: StepFormItem[];
+    stepFormCurrentIndex: number;
+    stepFormNextText: string;
+    stepFormPrevText: string;
+    stepFormSubmitText: string;
 }
 
 type Listener = (state: DialogState) => void;
@@ -102,6 +186,18 @@ declare class DialogController {
     skipStep(key: string): void;
     failStep(key: string): void;
     clearSteps(): void;
+    form<TSchema extends {
+        _output: unknown;
+        safeParse: (data: unknown) => any;
+        _def: any;
+    }>(schema: TSchema, options?: FormOptions<TSchema['_output']>): Promise<TSchema['_output'] | null>;
+    updateFormField(key: string, value: unknown): void;
+    touchFormField(key: string): void;
+    showStepForm(steps: StepFormStepInput[], options?: StepFormOptions): Promise<Record<string, unknown> | null>;
+    onStepNext(): void;
+    onStepPrev(): void;
+    updateStepFormField(fieldKey: string, value: unknown): void;
+    touchStepFormField(fieldKey: string): void;
     onConfirm(): void;
     onCancel(): void;
     onOutsideClick(): void;
@@ -112,7 +208,10 @@ declare class OverlayDialog extends LitElement {
     static styles: lit.CSSResult;
     controller: DialogController;
     private _state;
+    private _bodyKey;
+    private _isClosing;
     private _unsubscribe?;
+    private _closeTimer?;
     private _beforeUnloadHandler;
     connectedCallback(): void;
     disconnectedCallback(): void;
@@ -126,7 +225,17 @@ declare class OverlayDialog extends LitElement {
     private _renderQueueList;
     private _renderStepsHeader;
     private _renderStepsList;
+    private _createFormContext;
+    private _createStepFormContext;
+    private _getOrderedFields;
+    private _renderFormGrid;
+    private _renderGroupedForm;
+    private _renderForm;
+    private _renderFormField;
+    private _renderFormInput;
     private _renderButtons;
+    private _renderStepFormButtons;
+    private _deriveStepItems;
     private _renderBody;
     render(): TemplateResult;
 }
@@ -142,6 +251,16 @@ declare class DialogSingleton {
     hide(): void;
     alert(optionsOrLabel: string | AlertOptions): Promise<DialogResult>;
     confirm(optionsOrLabel: string | ConfirmOptions): Promise<boolean>;
+    form<TSchema extends {
+        _output: unknown;
+        safeParse: (data: unknown) => any;
+        _def: any;
+    }>(schema: TSchema, options?: FormOptions<TSchema['_output']>): Promise<TSchema['_output'] | null>;
+    showStepForm(steps: StepFormStepInput[], options?: StepFormOptions): Promise<Record<string, unknown> | null>;
+    onStepNext(): void;
+    onStepPrev(): void;
+    updateStepFormField(fieldKey: string, value: unknown): void;
+    touchStepFormField(fieldKey: string): void;
     showLoading(label?: string): void;
     setProgress(percent: number): void;
     setLabel(label: string): void;
@@ -165,4 +284,4 @@ declare class DialogSingleton {
 }
 declare const dialog: DialogSingleton;
 
-export { type AlertIcon, type AlertOptions, type ConfirmOptions, DialogController, type DialogResult, type DialogState, type DialogType, OverlayDialog, type QueueItem, type QueueItemStatus, type ShowOptions, type StepItem, type StepItemStatus, type TaskItemInput, dialog };
+export { type AlertIcon, type AlertOptions, type ConfirmOptions, DialogController, type DialogResult, type DialogState, type DialogType, type FormFieldGroup, type FormFieldMeta, type FormInputType, type FormLayout, type FormOptions, OverlayDialog, type QueueItem, type QueueItemStatus, type ShowOptions, type StepFormItem, type StepFormOptions, type StepFormStepInput, type StepItem, type StepItemStatus, type TaskItemInput, dialog };