Ленивые модели

lazyModel нужен, когда модель фичи лежит в отдельном модуле и должна загрузиться только в момент реальной работы. Так удобно выносить тяжелые экраны, редко открываемые сценарии, редакторы, вкладки чатов и другой код, который не должен попадать в первый bundle.

Ленивая модель выглядит как настоящая модель. На ее юниты можно ссылаться в правилах до загрузки модуля:

import { event, lazyModel, reaction, store } from "@virentia/core";
import type { createChatModel } from "./chat.model";

const chat = lazyModel<ReturnType<typeof createChatModel>>(() =>
  import("./chat.model").then(({ createChatModel }) => createChatModel()),
);

const routeOpened = event<{ chatId: string }>();
const refreshRequested = event<{ chatId: string }>();

const currentChatId = store<string | null>(null);
const messageCount = store(0);

reaction({
  on: routeOpened,
  run({ chatId }) {
    void chat.opened({ chatId });
  },
});

reaction({
  on: refreshRequested,
  run({ chatId }) {
    void chat.loadHistoryFx(chatId);
  },
});

Здесь обычная модель решает, что произошло в приложении, а ленивая модель подключается только в момент вызова chat.opened или chat.loadHistoryFx. Так можно держать переходы, команды и фоновые обновления рядом с текущей моделью, не загружая код чата заранее.

На lazy-юниты можно и подписываться до загрузки модуля:

reaction({
  on: chat.opened,
  run({ chatId }) {
    currentChatId.value = chatId;
  },
});

reaction({
  on: chat.loadHistoryFx.doneData,
  run(messages) {
    messageCount.value = messages.length;
  },
});

Когда запускается lazy-юнит, Virentia ставит ветку с подставным юнитом на паузу, ждет загрузки модуля, переносит уже подключенные реакции на настоящий юнит и запускает его с тем же payload и scope.

await scoped(appScope, () => chat.opened({ chatId: "support" }));

Состояние загрузки

У каждой ленивой модели есть стор pending: true, пока модуль импортируется, и false после загрузки. Он работает по scope (как pending у эффекта) — каждый scope отслеживает свою загрузку.

const loading = scoped(appScope, () => chat.opened({ chatId: "support" }));

// chat.pending равен `true` в appScope, пока импортируется ./chat.model
await loading;
// chat.pending снова `false`; модель готова

Показывайте спиннер из chat.pending (например, через useUnit в React), не заводя отдельный флаг загрузки для импорта.

WARNING

Ленивая модель умеет ждать загрузку при запуске события, эффекта или lifecycle-юнита эффекта. Чтение стора остается синхронным: chat.messages.value не может ждать import.

Читайте сторы ленивой модели после того, как модель загрузилась через событие или эффект. Защитное чтение стройте на loaded, а не на pending — см. ниже.

loaded против pending

Флаги отвечают на разные вопросы, и гейтом для чтения годится только один:

	до загрузки	во время	после
pending	false	true	false
loaded	false	false	true

pending означает «идёт импорт», поэтому он false и до, и после — отличить «ещё не загружено» от «готово» по нему нельзя. loaded это умеет:

const unreadCount = computed(() => (chat.loaded.value ? chat.unread.value : 0));

Чтение стора ленивой модели, пока loaded равен false, бросает Lazy unit is not loaded yet. Типы от этого не защищают: LazyModel<Model> типизирован как Model, поэтому chat.unread.value на этапе компиляции выглядит обычным значением.

Как и pending, флаг loaded работает по scope: scope узнаёт о загрузке, когда сам в ней участвует, — это происходит при первом обращении к любому ленивому юниту.