DataView

DataView описывает чистую проекцию входных данных в форму, нужную потребителю. Глобальный DataView и локальный DataView внутри Query компилируются в один program-контракт и исполняются одним runtime-механизмом.

Во всех декларативных режимах доступен общий API функциональных выражений, включая типы, числа, строки, коллекции, DateTime и Duration. DataView дополнительно предоставляет структурный pipeline, path, template, spread и вызов Converter. Новые операции не превращают Converter в ValueExpression host.

Режимы

Режим	Когда использовать
pipeline	Последовательные преобразования результата через select или обработка коллекции через from, join и map
projection	Построение одного объекта из входного scope
expression	Возврат произвольного ValueExpression
manual	Зарезервирован, но временно не исполняется runtime

Pipeline

Pipeline поддерживает два отдельных контракта steps:

• value pipeline — только select(...);
• collection pipeline — from(...), join(...) и map(...).

Смешивать select со структурными steps в одном DataView нельзя.

Value pipeline: select(expression)

select преобразует значение целиком. Первый step получает вход DataView, каждый следующий — результат предыдущего, а результат последнего step становится результатом DataView:

defineDataView({
  mode: 'pipeline',
  steps: [
    select({
      activeRows: path('items')
        .where(match({ active: true })),
    }),

    select(
      path('activeRows')
        .map(pick(['id', 'name'])),
    ),
  ],
})

Здесь path('items') в первом step читает исходный input, а path('activeRows') во втором — объект, возвращённый первым select.

select принимает ровно одно ValueExpression и может вернуть объект, массив, scalar или null. steps должен быть непустым. В текущей версии select pipeline всегда материализуется целиком (full), потому что следующий step может зависеть от всего результата предыдущего.

select(...) не создаёт вложенный DataView и не обращается к другому DataView. Это последовательные этапы одного скомпилированного DataView.

Collection pipeline

defineDataView({
  mode: 'pipeline',
  steps: [
    from('raw').as('row'),
    map({
      ...spread('row'),
      id: path('row.id'),
      title: path('row.title').trim().defaultTo('Без названия'),
      activeItems: path('row.items').where(match({ active: true })),
    }),
  ],
})

from(source).as(alias)

Выбирает коллекцию из входного scope и задаёт alias текущей строки:

from('response.items').as('row')

Перед обходом существующий collection pipeline может применить глобальный DataView. Это совместимый legacy-контракт; в новом коде для последовательных преобразований используйте select steps:

from('items')
  .dataView('normalize-item')
  .as('row')

Прежняя явная форма .dataView(dataView('normalize-item')) остаётся совместимой.

Inline-вложение defineDataView также пока читается ради обратной совместимости, но не является рекомендуемым способом композиции:

from('items')
  .dataView(defineDataView({
    mode: 'pipeline',
    steps: [from('').as('item'), map({ id: path('item.id') })],
  }))
  .as('row')

Новый select pipeline не создаёт и не вызывает вложенные DataView.

join(source).by(...)

Legacy structural join присоединяет первый подходящий элемент другой коллекции:

join('attributes').by({
  left: 'leg.id',
  right: 'entityId',
  as: 'legAttributes',
})

Для новых преобразований, составных ключей и сохранения кардинальности используйте общие leftJoin, fullJoin, lookupOne и lookupMany.

map({...}) и spread(alias)

map формирует выходной объект для каждой строки. spread копирует поля объекта; явно объявленное поле имеет приоритет:

map({
  ...spread('row'),
  title: path('row.name'),
})

Projection

Projection строит один объект без структурных steps:

defineDataView({
  mode: 'projection',
  output: {
    requestId: path('meta.requestId'),
    rows: path('items')
      .where(match({ active: true }))
      .sortBy(get('name')),
  },
})

Если output является объектом, compiler также может вывести режим projection из формы source.

Expression

Expression возвращает результат одного общего выражения:

defineDataView({
  mode: 'expression',
  output: path('items')
    .where(match({ active: true }))
    .map(pick(['id', 'name'])),
})

Используйте этот режим, когда не нужен объект projection и структурный pipeline.

Специальные выражения DataView

path(path)

Читает значение из входного scope или alias pipeline и может продолжаться любым общим методом ValueExpression:

path('row.items').where(match({ active: true })).map(get('id'))

Legacy-операции path

path('row.category').pick('code')
path('row.statuses').find({ active: true })
path('row.std').convert('date.iso-to-time', { format: 'HH:mm' })

• .pick(path) читает вложенный путь;
• .find(criteria) находит первый подходящий элемент массива;
• .convert(identity, options?) вызывает зарегистрированный Converter.

Для Converter также принимается явная совместимая форма .convert(converter('date.iso-to-time'), options).

Для новых выражений pick и find также доступны в общем API, но convert остаётся специальной возможностью DataView.

template(template)

Подставляет значения текущего scope в строковый шаблон:

template('{row.name} / {row.status}')

Incremental materialization

DataView может запросить стратегию обновления результата:

defineDataView({
  mode: 'pipeline',
  incremental: collectionByKey('id'),
  steps: [
    from('items').as('row'),
    map({ ...spread('row') }),
  ],
})

API	Поведение
auto()	Compiler выбирает безопасную стратегию
full()	Полная повторная материализация
collectionByKey(key)	Переисполнение изменившихся строк коллекции по стабильному ключу

collectionByKey применяется только к доказуемо row-local collection pipeline. Для select pipeline, projection, expression, manual или pipeline с глобальными зависимостями используется полная материализация.

Manual DataView

defineDataView({
  mode: 'manual',
  transform(input, tools) {
    return input.raw
  },
})

Manual-режим пока сохранён в source/compiler contract, но runtime явно завершает его запуск ошибкой. Используйте pipeline, projection или expression до появления capability-limited runtime для пользовательского TypeScript. Manual по-прежнему не поддерживается для локального DataView внутри Query или inline DataView.

Граница ответственности

DataView не хранит состояние и не запускает HTTP-запросы. Query получает данные, DataView формирует проекцию, а Composition связывает результат с Store и потребителями.