Skip to content

Условия (кейсы)

Условие (кейс) — «объект-цель + поле + оператор + значение» — живёт в трёх контейнерах: реакции (trigger[].cases), алармы (alarms[].cases) и логика драйвер-линков (driverLinks[].logic). Контракты полей кейсов собирает тот же декларативный слой, что и additional data команд (Additional data команд): generic-ветка — из геттеров сущности-цели, отклонения объявляются в schema.ts типа (пока единственное — mode-object State: ссылка на stateId вместо значения-литерала).

Контракт поля кейса ​

ts
/**
 * Контракт одного поля кейса (пара объект-цель + objectField) — editorState
 * адаптера кейс-поля. Специализированную связь объявляет тип цели
 * (caseFieldAdapters, по образцу actionDataAdapters); остальные поля —
 * identity-адаптер из геттеров сущности: enum-поля берут availableStates,
 * числа — границы из getCaseAdditionalData. Форма `caseValue` (`{ type, value }`)
 * не меняется: enum-поля хранят ключ опции, mode-object State — stateId.
 */
export interface CaseFieldDefinition {
  /** имя поля объекта (FieldCase / сужение типа) */
  field: string;
  label: string;
  /** logicCase → лейбл (источник — availableOperators сущности) */
  operators: Record<string, string>;
  /** оператор нового кейса (defaultLogicCase сущности) */
  defaultOperator: string;
  valueKind: "enum" | "number";
  widget: "dropdown" | "number";
  /** дефолт editor-значения нового кейса */
  defaultValue: unknown;
  /** вычисляемые enum-опции (тот же словарь проекций, что у полей экшенов) */
  optionsProjection?: ActionFieldProjection;
  /** статичные enum-опции (источник — availableStates сущности) */
  staticOptions?: Record<string, string>;
  /** границы number (источник — getCaseAdditionalData сущности) */
  min?: number;
  max?: number;
  persistence: CaseFieldPersistence;
}
ts
/**
 * Что именно хранится в `case.caseValue.value`:
 * `literal` — значение как есть (enum-строка статичного перечисления или число);
 * `reference` — стабильный id доменной сущности, а не её имя/индекс
 *   (единственный refType — состояние mode-object, см. runtime-перевод).
 */
export type CaseFieldPersistence =
  | { kind: "literal" }
  | { kind: "reference"; refType: "mode_state" };

Адаптер кейс-поля для пары (цель, objectField). Возвращает undefined, если поле не объявлено у типа цели (availableObjectFields). Сначала спрашивается декларация типа (caseFieldAdapters — фабрика напрямую), нет — identity-адаптер из геттеров сущности: enum-поля берут availableStates, числа — границы из getCaseAdditionalData.

Опции значения enum-поля кейса: статичные — staticOptions контракта (generic-поля), вычисляемые — проекцией через тот же движок, что строит поля экшенов (mode-object State: словарь состояний цели). Ключи опций — stored-значения caseValue.value.

Mentioned In ​