#StepDefinition

interface StepDefinition<TModel extends FlowModel = FlowModel>
  extends Partial<Omit<ActionDefinition<TModel, FlowRuntimeContext<TModel>>, 'name'>> {
  key?: string;
  isAwait?: boolean;
  use?: string;
  sort?: number;
  preset?: boolean;
  paramsRequired?: boolean;
  hideInSettings?: boolean;
  uiMode?: StepUIMode | ((ctx: FlowRuntimeContext<TModel>) => StepUIMode | Promise<StepUIMode>);
}

class MyModel extends FlowModel {}

MyModel.registerFlow({
  key: 'pageSettings',
  steps: {
    step1: {
      use: 'actionName',
      title: 'Перший крок',
      sort: 0,
      preset: true
    },
    step2: {
      handler: async (ctx, params) => {
        // Користувацька логіка обробки
        return { result: 'success' };
      },
      title: 'Другий крок',
      sort: 1
    }
  }
});

steps: {
  loadData: {  // ключ — 'loadData'
    use: 'loadDataAction'
  }
}

// Спочатку зареєструйте дію
MyModel.registerAction({
  name: 'loadDataAction',
  handler: async (ctx, params) => {
    // Логіка завантаження даних
  }
});

// Використайте це в кроці
steps: {
  step1: {
    use: 'loadDataAction',  // Посилання на зареєстровану дію
    title: 'Завантажити дані'
  }
}

title: 'Завантажити дані'
title: 'Обробити інформацію'
title: 'Зберегти результати'

steps: {
  step1: { sort: 0 },  // Виконується першим
  step2: { sort: 1 },  // Виконується наступним
  step3: { sort: 2 }   // Виконується останнім
}

handler: async (ctx, params) => {
  // Отримайте інформацію про контекст
  const { model, flowEngine } = ctx;
  
  // Логіка обробки
  const result = await processData(params);
  
  // Поверніть результат
  return { success: true, data: result };
}

// Статичні параметри за замовчуванням
defaultParams: {
  timeout: 5000,
  retries: 3,
  format: 'json'
}

// Динамічні параметри за замовчуванням
defaultParams: (ctx) => {
  return {
    userId: ctx.model.uid,
    timestamp: Date.now()
  }
}

// Асинхронні параметри за замовчуванням
defaultParams: async (ctx) => {
  const config = await loadConfig();
  return {
    apiUrl: config.apiUrl,
    apiKey: config.apiKey
  }
}

uiSchema: {
  'x-component': 'Form',
  'x-component-props': {
    layout: 'vertical'
  },
  properties: {
    name: {
      type: 'string',
      title: 'Ім\'я',
      'x-component': 'Input'
    },
    age: {
      type: 'number',
      title: 'Вік',
      'x-component': 'InputNumber'
    }
  }
}

beforeParamsSave: (ctx, params, previousParams) => {
  // Перевірка параметрів
  if (!params.name) {
    throw new Error('Ім\'я є обов\'язковим');
  }
  
  // Перетворення параметрів
  params.name = params.name.trim().toLowerCase();
}

afterParamsSave: (ctx, params, previousParams) => {
  // Запишіть логи
  console.log('Параметри кроку збережено:', params);
  
  // Запустіть інші операції
  ctx.model.emitter.emit('paramsChanged', params);
}

// Простий режим
uiMode: 'dialog'

// Користувацька конфігурація
uiMode: {
  type: 'dialog',
  props: {
    width: 800,
    title: 'Конфігурація кроку'
  }
}

// Динамічний режим
uiMode: (ctx) => {
  return ctx.model.isMobile ? 'drawer' : 'dialog';
}

steps: {
  step1: {
    preset: true,  // Параметри необхідно заповнити під час створення
    use: 'requiredAction'
  },
  step2: {
    preset: false, // Параметри можна заповнити пізніше
    use: 'optionalAction'
  }
}

paramsRequired: true  // Параметри необхідно налаштувати перед додаванням моделі
paramsRequired: false // Параметри можна налаштувати пізніше

hideInSettings: true  // Приховати в налаштуваннях
hideInSettings: false // Показати в налаштуваннях (за замовчуванням)

isAwait: true  // Чекати завершення функції-обробника (за замовчуванням)
isAwait: false // Не чекати, виконувати асинхронно

class DataProcessingModel extends FlowModel {}

DataProcessingModel.registerFlow({
  key: 'dataProcessing',
  title: 'Обробка даних',
  steps: {
    loadData: {
      use: 'loadDataAction',
      title: 'Завантажити дані',
      sort: 0,
      preset: true,
      paramsRequired: true,
      defaultParams: {
        source: 'api',
        timeout: 5000
      },
      uiMode: 'dialog'
    },
    processData: {
      handler: async (ctx, params) => {
        const data = await ctx.model.getData();
        return processData(data, params);
      },
      title: 'Обробити дані',
      sort: 1,
      defaultParams: (ctx) => ({
        userId: ctx.model.uid,
        timestamp: Date.now()
      }),
      beforeParamsSave: (ctx, params) => {
        if (!params.processor) {
          throw new Error('Обробник є обов’язковим');
        }
      },
      afterParamsSave: (ctx, params) => {
        ctx.model.emitter.emit('dataProcessed', params);
      }
    },
    saveData: {
      use: 'saveDataAction',
      title: 'Зберегти дані',
      sort: 2,
      hideInSettings: false,
      uiMode: {
        type: 'drawer',
        props: {
          width: 600,
          title: 'Конфігурація збереження'
        }
      }
    }
  }
});