@platforma-sdk/ui-vue 1.66.0 → 1.66.2

package/dist/internal/createAppV3.js.map

@@ -1 +1 @@
-{"version":3,"file":"createAppV3.js","names":[],"sources":["../../src/internal/createAppV3.ts"],"sourcesContent":["import { deepClone, delay, uniqueId } from \"@milaboratories/helpers\";\nimport type { Mutable } from \"@milaboratories/helpers\";\nimport type {\n  NavigationState,\n  BlockOutputsBase,\n  BlockStateV3,\n  PlatformaV3,\n  ValueWithUTag,\n  AuthorMarker,\n  PlatformaExtended,\n  InferPluginHandles,\n  PluginHandle,\n  InferFactoryData,\n  InferFactoryOutputs,\n  InferFactoryUiServices,\n  PluginFactoryLike,\n} from \"@platforma-sdk/model\";\nimport {\n  hasAbortError,\n  unwrapResult,\n  deriveDataFromStorage,\n  getPluginData,\n  isPluginOutputKey,\n  pluginOutputPrefix,\n  createNodeServiceProxy,\n  buildServices,\n} from \"@platforma-sdk/model\";\nimport { type UiServices as AllUiServices } from \"@milaboratories/pl-model-common\";\nimport { createUiServiceRegistry } from \"./service_factories\";\nimport type { Ref } from \"vue\";\nimport { reactive, computed, ref, markRaw } from \"vue\";\nimport type { OutputValues, OutputErrors, AppSettings } from \"../types\";\nimport { parseQuery } from \"../urls\";\nimport { ensureOutputHasStableFlag, MultiError } from \"../utils\";\nimport { applyPatch } from \"fast-json-patch\";\nimport { UpdateSerializer } from \"./UpdateSerializer\";\nimport { watchIgnorable } from \"@vueuse/core\";\nimport type { PluginState, PluginAccess } from \"../usePlugin\";\n\nexport const patchPoolingDelay = 150;\n\n/** Internal per-plugin state with reconciliation support. */\ninterface InternalPluginState<\n  Data = unknown,\n  Outputs = unknown,\n  Services = Record<string, unknown>,\n> extends PluginState<Data, Outputs, Services> {\n  readonly ignoreUpdates: (fn: () => void) => void;\n}\n\nexport const createNextAuthorMarker = (marker: AuthorMarker | undefined): AuthorMarker => ({\n  authorId: marker?.authorId ?? uniqueId(),\n  localVersion: (marker?.localVersion ?? 0) + 1,\n});\n\nconst stringifyForDebug = (v: unknown) => {\n  try {\n    return JSON.stringify(v, null, 2);\n  } catch (err) {\n    return err instanceof Error ? err.message : String(err);\n  }\n};\n\n/**\n * Creates an application instance with reactive state management, outputs, and methods for state updates and navigation.\n *\n * @template Args - The type of arguments used in the application.\n * @template Outputs - The type of block outputs extending `BlockOutputsBase`.\n * @template Data - The type of the block data.\n * @template Href - The type of navigation href, defaulting to a string starting with `/`.\n *\n * @param state - Initial state of the application, including args, outputs, UI state, and navigation state.\n * @param platforma - A platform interface for interacting with block states.\n * @param settings - Application settings, such as debug flags.\n *\n * @returns A reactive application object with methods, getters, and state.\n */\nexport function createAppV3<\n  Data = unknown,\n  Args = unknown,\n  Outputs extends BlockOutputsBase = BlockOutputsBase,\n  Href extends `/${string}` = `/${string}`,\n  Plugins extends Record<string, unknown> = Record<string, unknown>,\n  UiServices extends Partial<AllUiServices> = Partial<AllUiServices>,\n>(\n  state: ValueWithUTag<BlockStateV3<Data, Outputs, Href>>,\n  platforma: PlatformaExtended<PlatformaV3<Data, Args, Outputs, Href, Plugins, UiServices>>,\n  settings: AppSettings,\n) {\n  const debug = (msg: string, ...rest: unknown[]) => {\n    if (settings.debug) {\n      console.log(\n        `%c>>> %c${msg}`,\n        \"color: orange; font-weight: bold\",\n        \"color: orange\",\n        ...rest.map((r) => stringifyForDebug(r)),\n      );\n    }\n  };\n\n  const error = (msg: string, ...rest: unknown[]) => {\n    console.error(\n      `%c>>> %c${msg}`,\n      \"color: red; font-weight: bold\",\n      \"color: red\",\n      ...rest.map((r) => stringifyForDebug(r)),\n    );\n  };\n\n  const data = {\n    isExternalSnapshot: false,\n    author: {\n      authorId: uniqueId(),\n      localVersion: 0,\n    },\n  };\n\n  const nextAuthorMarker = () => {\n    data.author = createNextAuthorMarker(data.author);\n    debug(\"nextAuthorMarker\", data.author);\n    return data.author;\n  };\n\n  const closedRef = ref(false);\n\n  const uTagRef = ref(state.uTag);\n\n  const debounceSpan = settings.debounceSpan ?? 200;\n\n  const setDataQueue = new UpdateSerializer({ debounceSpan });\n  const pluginDataQueues = new Map<PluginHandle, UpdateSerializer>();\n  const getPluginDataQueue = (handle: PluginHandle): UpdateSerializer => {\n    let queue = pluginDataQueues.get(handle);\n    if (!queue) {\n      queue = new UpdateSerializer({ debounceSpan });\n      pluginDataQueues.set(handle, queue);\n    }\n    return queue;\n  };\n  const setNavigationStateQueue = new UpdateSerializer({ debounceSpan });\n\n  /** Lazily-created per-plugin reactive states. */\n  const pluginStates = new Map<PluginHandle, InternalPluginState>();\n  /**\n   * Reactive snapshot of the application state, including args, outputs, UI state, and navigation state.\n   */\n  const snapshot = ref<{\n    outputs: Partial<Outputs>;\n    blockStorage: unknown;\n    navigationState: NavigationState<Href>;\n  }>(state.value) as Ref<{\n    outputs: Partial<Outputs>;\n    blockStorage: unknown;\n    navigationState: NavigationState<Href>;\n  }>;\n\n  const updateData = async (value: Data) => {\n    return platforma.mutateStorage({ operation: \"update-block-data\", value }, nextAuthorMarker());\n  };\n\n  const updatePluginData = async (handle: PluginHandle, value: unknown) => {\n    return platforma.mutateStorage(\n      { operation: \"update-plugin-data\", pluginId: handle, value },\n      nextAuthorMarker(),\n    );\n  };\n\n  const setNavigationState = async (state: NavigationState<Href>) => {\n    return platforma.setNavigationState(state);\n  };\n\n  const outputs = computed<OutputValues<Outputs>>(() => {\n    const entries = Object.entries(snapshot.value.outputs as Partial<Readonly<Outputs>>)\n      .filter(([k]) => !isPluginOutputKey(k))\n      .map(([k, outputWithStatus]) =>\n        platforma.blockModelInfo.outputs[k]?.withStatus\n          ? [k, ensureOutputHasStableFlag(outputWithStatus)]\n          : [\n              k,\n              outputWithStatus.ok && outputWithStatus.value !== undefined\n                ? outputWithStatus.value\n                : undefined,\n            ],\n      );\n    return Object.fromEntries(entries);\n  });\n\n  const outputErrors = computed<OutputErrors<Outputs>>(() => {\n    const entries = Object.entries(snapshot.value.outputs as Partial<Readonly<Outputs>>)\n      .filter(([k]) => !isPluginOutputKey(k))\n      .map(([k, vOrErr]) => [\n        k,\n        vOrErr && vOrErr.ok === false ? new MultiError(vOrErr.errors) : undefined,\n      ]);\n    return Object.fromEntries(entries);\n  });\n\n  const appModel = reactive({\n    apiVersion: 3,\n    error: \"\",\n    model: {\n      data: deepClone(deriveDataFromStorage<Data>(snapshot.value.blockStorage)) as Data,\n      outputs,\n      outputErrors,\n    },\n  }) as {\n    error: string;\n    model: {\n      data: Data;\n      outputs: OutputValues<Outputs>;\n      outputErrors: OutputErrors<Outputs>;\n    };\n  };\n\n  const { ignoreUpdates } = watchIgnorable(\n    () => appModel.model,\n    (_newData) => {\n      const newData = deepClone(_newData);\n      debug(\"setDataQueue appModel.model, data\", newData.data);\n      setDataQueue.run(() => updateData(newData.data).then(unwrapResult));\n    },\n    { deep: true },\n  );\n\n  const updateAppModel = (newData: { data: Data }) => {\n    debug(\"updateAppModel\", newData);\n    appModel.model.data = deepClone(newData.data) as Data;\n  };\n\n  (async () => {\n    window.addEventListener(\"beforeunload\", () => {\n      closedRef.value = true;\n      Promise.allSettled([uiRegistry.dispose(), platforma.dispose().then(unwrapResult)]).catch(\n        (err) => {\n          error(\"error in dispose\", err);\n        },\n      );\n    });\n\n    while (!closedRef.value) {\n      try {\n        const patches = await platforma.getPatches(uTagRef.value).then(unwrapResult);\n\n        debug(\"patches.length\", patches.value.length);\n        debug(\"uTagRef.value\", uTagRef.value);\n        debug(\"patches.uTag\", patches.uTag);\n        debug(\"patches.author\", patches.author);\n        debug(\"data.author\", data.author);\n\n        uTagRef.value = patches.uTag;\n\n        if (patches.value.length === 0) {\n          await new Promise((resolve) => setTimeout(resolve, patchPoolingDelay));\n          continue;\n        }\n\n        const isAuthorChanged = data.author?.authorId !== patches.author?.authorId;\n\n        // Immutable behavior, apply external changes to the snapshot\n        if (isAuthorChanged || data.isExternalSnapshot) {\n          debug(\"got external changes, applying them to the snapshot\", patches.value);\n          ignoreUpdates(() => {\n            snapshot.value = applyPatch(snapshot.value, patches.value, false, false).newDocument;\n            updateAppModel({ data: deriveDataFromStorage<Data>(snapshot.value.blockStorage) });\n            // Reconcile plugin data from external source\n            for (const [handle, pluginState] of pluginStates) {\n              pluginState.ignoreUpdates(() => {\n                pluginState.model.data = deepClone(\n                  getPluginData(snapshot.value.blockStorage, handle),\n                );\n              });\n            }\n            data.isExternalSnapshot = isAuthorChanged;\n          });\n        } else {\n          // Mutable behavior\n          debug(\"outputs changed\", patches.value);\n          ignoreUpdates(() => {\n            snapshot.value = applyPatch(snapshot.value, patches.value).newDocument;\n          });\n        }\n\n        await new Promise((resolve) => setTimeout(resolve, patchPoolingDelay));\n      } catch (err) {\n        if (hasAbortError(err)) {\n          debug(\"patches loop aborted\");\n          closedRef.value = true;\n        } else {\n          error(\"error in patches loop\", err);\n          await new Promise((resolve) => setTimeout(resolve, 1000));\n        }\n      }\n    }\n  })();\n\n  const cloneData = () => deepClone(appModel.model.data) as Data;\n  const cloneNavigationState = () =>\n    deepClone(snapshot.value.navigationState) as Mutable<NavigationState<Href>>;\n\n  const methods = {\n    cloneData,\n    cloneNavigationState,\n    /**\n     * Updates the UI state by applying a callback.\n     *\n     * @param cb - Callback to modify the current UI state.\n     * @returns A promise resolving after the update is applied.\n     * @todo Make it mutable since there is already an initial one\n     */\n    updateData(cb: (data: Data) => Data): Promise<boolean> {\n      const newData = cb(cloneData());\n      debug(\"updateData\", newData);\n      appModel.model.data = newData;\n      return setDataQueue.run(() => updateData(newData).then(unwrapResult));\n    },\n    /**\n     * Navigates to a specific href by updating the navigation state.\n     *\n     * @param href - The target href to navigate to.\n     * @returns A promise resolving after the navigation state is updated.\n     */\n    navigateTo(href: Href) {\n      const newState = cloneNavigationState();\n      newState.href = href;\n      return setNavigationStateQueue.run(() => setNavigationState(newState).then(unwrapResult));\n    },\n    async allSettled() {\n      await delay(0);\n      const allQueues = [\n        setDataQueue.allSettled(),\n        ...Array.from(pluginDataQueues.values()).map((q) => q.allSettled()),\n      ];\n      await Promise.all(allQueues);\n    },\n  };\n\n  const proxy = createNodeServiceProxy(platforma.serviceDispatch);\n  const uiRegistry = createUiServiceRegistry({ proxy });\n  const services = buildServices<UiServices>(platforma.serviceDispatch, uiRegistry);\n\n  /** Creates a lazily-cached per-plugin reactive state. */\n  const createPluginState = <F extends PluginFactoryLike>(\n    handle: PluginHandle<F>,\n  ): InternalPluginState<InferFactoryData<F>, InferFactoryOutputs<F>> => {\n    const prefix = pluginOutputPrefix(handle);\n\n    const pluginOutputs = computed(() => {\n      const result: Record<string, unknown> = {};\n      for (const [key, outputWithStatus] of Object.entries(\n        snapshot.value.outputs as Partial<Readonly<Outputs>>,\n      )) {\n        if (!key.startsWith(prefix)) continue;\n        const outputKey = key.slice(prefix.length);\n        if (platforma.blockModelInfo.outputs[key]?.withStatus) {\n          result[outputKey] = outputWithStatus\n            ? ensureOutputHasStableFlag(outputWithStatus)\n            : undefined;\n        } else {\n          result[outputKey] =\n            outputWithStatus.ok && outputWithStatus.value !== undefined\n              ? outputWithStatus.value\n              : undefined;\n        }\n      }\n      return result;\n    });\n\n    const pluginOutputErrors = computed(() => {\n      const result: Record<string, Error | undefined> = {};\n      for (const [key, vOrErr] of Object.entries(\n        snapshot.value.outputs as Partial<Readonly<Outputs>>,\n      )) {\n        if (!key.startsWith(prefix)) continue;\n        result[key.slice(prefix.length)] =\n          vOrErr && vOrErr.ok === false ? new MultiError(vOrErr.errors) : undefined;\n      }\n      return result;\n    });\n\n    const pluginModel = reactive({\n      data: deepClone(getPluginData(snapshot.value.blockStorage, handle)),\n      outputs: pluginOutputs,\n      outputErrors: pluginOutputErrors,\n    }) as InternalPluginState<InferFactoryData<F>, InferFactoryOutputs<F>>[\"model\"];\n\n    const { ignoreUpdates } = watchIgnorable(\n      () => pluginModel.data,\n      (newData) => {\n        if (newData === undefined) return;\n        debug(\"plugin setData\", handle, newData);\n        getPluginDataQueue(handle).run(() =>\n          updatePluginData(handle, deepClone(newData)).then(unwrapResult),\n        );\n      },\n      { deep: true },\n    );\n\n    return {\n      model: pluginModel,\n      services: markRaw(services),\n      ignoreUpdates,\n    };\n  };\n\n  /** Plugin internals — provided via separate injection key, not exposed on useApp(). */\n  const pluginAccess: PluginAccess = {\n    getOrCreatePluginState<F extends PluginFactoryLike>(handle: PluginHandle<F>) {\n      const existing = pluginStates.get(handle);\n      if (existing) {\n        return existing as unknown as PluginState<\n          InferFactoryData<F>,\n          InferFactoryOutputs<F>,\n          InferFactoryUiServices<F>\n        >;\n      }\n      const state = createPluginState(handle);\n      pluginStates.set(handle, state);\n      return state as unknown as PluginState<\n        InferFactoryData<F>,\n        InferFactoryOutputs<F>,\n        InferFactoryUiServices<F>\n      >;\n    },\n  };\n\n  const plugins = Object.fromEntries(\n    platforma.blockModelInfo.pluginIds.map((id) => [id, { handle: id }]),\n  ) as InferPluginHandles<Plugins>;\n\n  const getters = {\n    closedRef,\n    snapshot,\n    plugins,\n    services: markRaw(services),\n    queryParams: computed(() => parseQuery<Href>(snapshot.value.navigationState.href as Href)),\n    href: computed(() => snapshot.value.navigationState.href),\n    hasErrors: computed(() =>\n      Object.values(snapshot.value.outputs as Partial<Readonly<Outputs>>).some((v) => !v?.ok),\n    ),\n  };\n\n  const app = Object.assign(reactive(Object.assign(appModel, getters)), methods);\n\n  if (settings.debug) {\n    // @ts-expect-error (to inspect in console in debug mode)\n    globalThis.__block_app__ = app;\n  }\n\n  return { app, pluginAccess };\n}\n\nexport type BaseAppV3<\n  Data = unknown,\n  Args = unknown,\n  Outputs extends BlockOutputsBase = BlockOutputsBase,\n  Href extends `/${string}` = `/${string}`,\n  Plugins extends Record<string, unknown> = Record<string, unknown>,\n  UiServices extends Partial<AllUiServices> = Partial<AllUiServices>,\n> = ReturnType<typeof createAppV3<Data, Args, Outputs, Href, Plugins, UiServices>>[\"app\"];\n"],"mappings":"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"}
+{"version":3,"file":"createAppV3.js","names":[],"sources":["../../src/internal/createAppV3.ts"],"sourcesContent":["import { deepClone, delay, uniqueId } from \"@milaboratories/helpers\";\nimport type { Mutable } from \"@milaboratories/helpers\";\nimport type {\n  NavigationState,\n  BlockOutputsBase,\n  BlockStateV3,\n  PlatformaV3,\n  ValueWithUTag,\n  AuthorMarker,\n  PlatformaExtended,\n  InferPluginHandles,\n  PluginHandle,\n  InferFactoryData,\n  InferFactoryOutputs,\n  InferFactoryUiServices,\n  PluginFactoryLike,\n} from \"@platforma-sdk/model\";\nimport {\n  hasAbortError,\n  unwrapResult,\n  deriveDataFromStorage,\n  getPluginData,\n  isPluginOutputKey,\n  pluginOutputPrefix,\n} from \"@platforma-sdk/model\";\nimport { type UiServices as AllUiServices } from \"@milaboratories/pl-model-common\";\nimport type { Ref } from \"vue\";\nimport { reactive, computed, ref, markRaw } from \"vue\";\nimport type { OutputValues, OutputErrors, AppSettings } from \"../types\";\nimport { parseQuery } from \"../urls\";\nimport { ensureOutputHasStableFlag, MultiError } from \"../utils\";\nimport { applyPatch } from \"fast-json-patch\";\nimport { UpdateSerializer } from \"./UpdateSerializer\";\nimport { watchIgnorable } from \"@vueuse/core\";\nimport type { PluginState, PluginAccess } from \"../usePlugin\";\nimport { logDebug, logError } from \"./utils\";\nimport { getServices } from \"./getServices\";\n\nexport const patchPoolingDelay = 150;\n\n/** Internal per-plugin state with reconciliation support. */\ninterface InternalPluginState<\n  Data = unknown,\n  Outputs = unknown,\n  Services = Record<string, unknown>,\n> extends PluginState<Data, Outputs, Services> {\n  readonly ignoreUpdates: (fn: () => void) => void;\n}\n\nexport const createNextAuthorMarker = (marker: AuthorMarker | undefined): AuthorMarker => ({\n  authorId: marker?.authorId ?? uniqueId(),\n  localVersion: (marker?.localVersion ?? 0) + 1,\n});\n\n/**\n * Creates an application instance with reactive state management, outputs, and methods for state updates and navigation.\n *\n * @template Args - The type of arguments used in the application.\n * @template Outputs - The type of block outputs extending `BlockOutputsBase`.\n * @template Data - The type of the block data.\n * @template Href - The type of navigation href, defaulting to a string starting with `/`.\n *\n * @param state - Initial state of the application, including args, outputs, UI state, and navigation state.\n * @param platforma - A platform interface for interacting with block states.\n * @param settings - Application settings, such as debug flags.\n *\n * @returns A reactive application object with methods, getters, and state.\n */\nexport function createAppV3<\n  Data = unknown,\n  Args = unknown,\n  Outputs extends BlockOutputsBase = BlockOutputsBase,\n  Href extends `/${string}` = `/${string}`,\n  Plugins extends Record<string, unknown> = Record<string, unknown>,\n  UiServices extends Partial<AllUiServices> = Partial<AllUiServices>,\n>(\n  state: ValueWithUTag<BlockStateV3<Data, Outputs, Href>>,\n  platforma: PlatformaExtended<PlatformaV3<Data, Args, Outputs, Href, Plugins, UiServices>>,\n  settings: AppSettings,\n) {\n  const debug = settings.debug ? logDebug : () => {};\n  const error = logError;\n\n  const data = {\n    isExternalSnapshot: false,\n    author: {\n      authorId: uniqueId(),\n      localVersion: 0,\n    },\n  };\n\n  const nextAuthorMarker = () => {\n    data.author = createNextAuthorMarker(data.author);\n    debug(\"nextAuthorMarker\", data.author);\n    return data.author;\n  };\n\n  const closedRef = ref(false);\n\n  const uTagRef = ref(state.uTag);\n\n  const debounceSpan = settings.debounceSpan ?? 200;\n\n  const setDataQueue = new UpdateSerializer({ debounceSpan });\n  const pluginDataQueues = new Map<PluginHandle, UpdateSerializer>();\n  const getPluginDataQueue = (handle: PluginHandle): UpdateSerializer => {\n    let queue = pluginDataQueues.get(handle);\n    if (!queue) {\n      queue = new UpdateSerializer({ debounceSpan });\n      pluginDataQueues.set(handle, queue);\n    }\n    return queue;\n  };\n  const setNavigationStateQueue = new UpdateSerializer({ debounceSpan });\n\n  /** Lazily-created per-plugin reactive states. */\n  const pluginStates = new Map<PluginHandle, InternalPluginState>();\n  /**\n   * Reactive snapshot of the application state, including args, outputs, UI state, and navigation state.\n   */\n  const snapshot = ref<{\n    outputs: Partial<Outputs>;\n    blockStorage: unknown;\n    navigationState: NavigationState<Href>;\n  }>(state.value) as Ref<{\n    outputs: Partial<Outputs>;\n    blockStorage: unknown;\n    navigationState: NavigationState<Href>;\n  }>;\n\n  const updateData = async (value: Data) => {\n    return platforma.mutateStorage({ operation: \"update-block-data\", value }, nextAuthorMarker());\n  };\n\n  const updatePluginData = async (handle: PluginHandle, value: unknown) => {\n    return platforma.mutateStorage(\n      { operation: \"update-plugin-data\", pluginId: handle, value },\n      nextAuthorMarker(),\n    );\n  };\n\n  const setNavigationState = async (state: NavigationState<Href>) => {\n    return platforma.setNavigationState(state);\n  };\n\n  const outputs = computed<OutputValues<Outputs>>(() => {\n    const entries = Object.entries(snapshot.value.outputs as Partial<Readonly<Outputs>>)\n      .filter(([k]) => !isPluginOutputKey(k))\n      .map(([k, outputWithStatus]) =>\n        platforma.blockModelInfo.outputs[k]?.withStatus\n          ? [k, ensureOutputHasStableFlag(outputWithStatus)]\n          : [\n              k,\n              outputWithStatus.ok && outputWithStatus.value !== undefined\n                ? outputWithStatus.value\n                : undefined,\n            ],\n      );\n    return Object.fromEntries(entries);\n  });\n\n  const outputErrors = computed<OutputErrors<Outputs>>(() => {\n    const entries = Object.entries(snapshot.value.outputs as Partial<Readonly<Outputs>>)\n      .filter(([k]) => !isPluginOutputKey(k))\n      .map(([k, vOrErr]) => [\n        k,\n        vOrErr && vOrErr.ok === false ? new MultiError(vOrErr.errors) : undefined,\n      ]);\n    return Object.fromEntries(entries);\n  });\n\n  const appModel = reactive({\n    apiVersion: 3,\n    error: \"\",\n    model: {\n      data: deepClone(deriveDataFromStorage<Data>(snapshot.value.blockStorage)) as Data,\n      outputs,\n      outputErrors,\n    },\n  }) as {\n    error: string;\n    model: {\n      data: Data;\n      outputs: OutputValues<Outputs>;\n      outputErrors: OutputErrors<Outputs>;\n    };\n  };\n\n  const { ignoreUpdates } = watchIgnorable(\n    () => appModel.model,\n    (_newData) => {\n      const newData = deepClone(_newData);\n      debug(\"setDataQueue appModel.model, data\", newData.data);\n      setDataQueue.run(() => updateData(newData.data).then(unwrapResult));\n    },\n    { deep: true },\n  );\n\n  const updateAppModel = (newData: { data: Data }) => {\n    debug(\"updateAppModel\", newData);\n    appModel.model.data = deepClone(newData.data) as Data;\n  };\n\n  (async () => {\n    window.addEventListener(\"beforeunload\", () => {\n      closedRef.value = true;\n      platforma\n        .dispose()\n        .then(unwrapResult)\n        .catch((err) => {\n          error(\"error in dispose\", err);\n        });\n    });\n\n    while (!closedRef.value) {\n      try {\n        const patches = await platforma.getPatches(uTagRef.value).then(unwrapResult);\n\n        debug(\"patches.length\", patches.value.length);\n        debug(\"uTagRef.value\", uTagRef.value);\n        debug(\"patches.uTag\", patches.uTag);\n        debug(\"patches.author\", patches.author);\n        debug(\"data.author\", data.author);\n\n        uTagRef.value = patches.uTag;\n\n        if (patches.value.length === 0) {\n          await new Promise((resolve) => setTimeout(resolve, patchPoolingDelay));\n          continue;\n        }\n\n        const isAuthorChanged = data.author?.authorId !== patches.author?.authorId;\n\n        // Immutable behavior, apply external changes to the snapshot\n        if (isAuthorChanged || data.isExternalSnapshot) {\n          debug(\"got external changes, applying them to the snapshot\", patches.value);\n          ignoreUpdates(() => {\n            snapshot.value = applyPatch(snapshot.value, patches.value, false, false).newDocument;\n            updateAppModel({ data: deriveDataFromStorage<Data>(snapshot.value.blockStorage) });\n            // Reconcile plugin data from external source\n            for (const [handle, pluginState] of pluginStates) {\n              pluginState.ignoreUpdates(() => {\n                pluginState.model.data = deepClone(\n                  getPluginData(snapshot.value.blockStorage, handle),\n                );\n              });\n            }\n            data.isExternalSnapshot = isAuthorChanged;\n          });\n        } else {\n          // Mutable behavior\n          debug(\"outputs changed\", patches.value);\n          ignoreUpdates(() => {\n            snapshot.value = applyPatch(snapshot.value, patches.value).newDocument;\n          });\n        }\n\n        await new Promise((resolve) => setTimeout(resolve, patchPoolingDelay));\n      } catch (err) {\n        if (hasAbortError(err)) {\n          debug(\"patches loop aborted\");\n          closedRef.value = true;\n        } else {\n          error(\"error in patches loop\", err);\n          await new Promise((resolve) => setTimeout(resolve, 1000));\n        }\n      }\n    }\n  })();\n\n  const cloneData = () => deepClone(appModel.model.data) as Data;\n  const cloneNavigationState = () =>\n    deepClone(snapshot.value.navigationState) as Mutable<NavigationState<Href>>;\n\n  const methods = {\n    cloneData,\n    cloneNavigationState,\n    /**\n     * Updates the UI state by applying a callback.\n     *\n     * @param cb - Callback to modify the current UI state.\n     * @returns A promise resolving after the update is applied.\n     * @todo Make it mutable since there is already an initial one\n     */\n    updateData(cb: (data: Data) => Data): Promise<boolean> {\n      const newData = cb(cloneData());\n      debug(\"updateData\", newData);\n      appModel.model.data = newData;\n      return setDataQueue.run(() => updateData(newData).then(unwrapResult));\n    },\n    /**\n     * Navigates to a specific href by updating the navigation state.\n     *\n     * @param href - The target href to navigate to.\n     * @returns A promise resolving after the navigation state is updated.\n     */\n    navigateTo(href: Href) {\n      const newState = cloneNavigationState();\n      newState.href = href;\n      return setNavigationStateQueue.run(() => setNavigationState(newState).then(unwrapResult));\n    },\n    async allSettled() {\n      await delay(0);\n      const allQueues = [\n        setDataQueue.allSettled(),\n        ...Array.from(pluginDataQueues.values()).map((q) => q.allSettled()),\n      ];\n      await Promise.all(allQueues);\n    },\n  };\n\n  const services = getServices<UiServices>({ platforma });\n\n  /** Creates a lazily-cached per-plugin reactive state. */\n  const createPluginState = <F extends PluginFactoryLike>(\n    handle: PluginHandle<F>,\n  ): InternalPluginState<InferFactoryData<F>, InferFactoryOutputs<F>> => {\n    const prefix = pluginOutputPrefix(handle);\n\n    const pluginOutputs = computed(() => {\n      const result: Record<string, unknown> = {};\n      for (const [key, outputWithStatus] of Object.entries(\n        snapshot.value.outputs as Partial<Readonly<Outputs>>,\n      )) {\n        if (!key.startsWith(prefix)) continue;\n        const outputKey = key.slice(prefix.length);\n        if (platforma.blockModelInfo.outputs[key]?.withStatus) {\n          result[outputKey] = outputWithStatus\n            ? ensureOutputHasStableFlag(outputWithStatus)\n            : undefined;\n        } else {\n          result[outputKey] =\n            outputWithStatus.ok && outputWithStatus.value !== undefined\n              ? outputWithStatus.value\n              : undefined;\n        }\n      }\n      return result;\n    });\n\n    const pluginOutputErrors = computed(() => {\n      const result: Record<string, Error | undefined> = {};\n      for (const [key, vOrErr] of Object.entries(\n        snapshot.value.outputs as Partial<Readonly<Outputs>>,\n      )) {\n        if (!key.startsWith(prefix)) continue;\n        result[key.slice(prefix.length)] =\n          vOrErr && vOrErr.ok === false ? new MultiError(vOrErr.errors) : undefined;\n      }\n      return result;\n    });\n\n    const pluginModel = reactive({\n      data: deepClone(getPluginData(snapshot.value.blockStorage, handle)),\n      outputs: pluginOutputs,\n      outputErrors: pluginOutputErrors,\n    }) as InternalPluginState<InferFactoryData<F>, InferFactoryOutputs<F>>[\"model\"];\n\n    const { ignoreUpdates } = watchIgnorable(\n      () => pluginModel.data,\n      (newData) => {\n        if (newData === undefined) return;\n        debug(\"plugin setData\", handle, newData);\n        getPluginDataQueue(handle).run(() =>\n          updatePluginData(handle, deepClone(newData)).then(unwrapResult),\n        );\n      },\n      { deep: true },\n    );\n\n    return {\n      model: pluginModel,\n      services: markRaw(services),\n      ignoreUpdates,\n    };\n  };\n\n  /** Plugin internals — provided via separate injection key, not exposed on useApp(). */\n  const pluginAccess: PluginAccess = {\n    getOrCreatePluginState<F extends PluginFactoryLike>(handle: PluginHandle<F>) {\n      const existing = pluginStates.get(handle);\n      if (existing) {\n        return existing as unknown as PluginState<\n          InferFactoryData<F>,\n          InferFactoryOutputs<F>,\n          InferFactoryUiServices<F>\n        >;\n      }\n      const state = createPluginState(handle);\n      pluginStates.set(handle, state);\n      return state as unknown as PluginState<\n        InferFactoryData<F>,\n        InferFactoryOutputs<F>,\n        InferFactoryUiServices<F>\n      >;\n    },\n  };\n\n  const plugins = Object.fromEntries(\n    platforma.blockModelInfo.pluginIds.map((id) => [id, { handle: id }]),\n  ) as InferPluginHandles<Plugins>;\n\n  const getters = {\n    closedRef,\n    snapshot,\n    plugins,\n    services: markRaw(services),\n    queryParams: computed(() => parseQuery<Href>(snapshot.value.navigationState.href as Href)),\n    href: computed(() => snapshot.value.navigationState.href),\n    hasErrors: computed(() =>\n      Object.values(snapshot.value.outputs as Partial<Readonly<Outputs>>).some((v) => !v?.ok),\n    ),\n  };\n\n  const app = Object.assign(reactive(Object.assign(appModel, getters)), methods);\n\n  if (settings.debug) {\n    // @ts-expect-error (to inspect in console in debug mode)\n    globalThis.__block_app__ = app;\n  }\n\n  return { app, pluginAccess };\n}\n\nexport type BaseAppV3<\n  Data = unknown,\n  Args = unknown,\n  Outputs extends BlockOutputsBase = BlockOutputsBase,\n  Href extends `/${string}` = `/${string}`,\n  Plugins extends Record<string, unknown> = Record<string, unknown>,\n  UiServices extends Partial<AllUiServices> = Partial<AllUiServices>,\n> = ReturnType<typeof createAppV3<Data, Args, Outputs, Href, Plugins, UiServices>>[\"app\"];\n"],"mappings":"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"}

package/dist/internal/getServices.d.ts

@@ -0,0 +1,5 @@
+import { BlockDefaultUiServices, PlatformaV3, UiServices } from '@platforma-sdk/model';
+export declare function getServices<Services extends Partial<UiServices> = BlockDefaultUiServices>(deps?: {
+    platforma?: PlatformaV3<any, any, any, any, any, Services>;
+}): Services;
+//# sourceMappingURL=getServices.d.ts.map

package/dist/internal/getServices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getServices.d.ts","sourceRoot":"","sources":["../../src/internal/getServices.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EAItB,WAAW,EACX,UAAU,EACX,MAAM,sBAAsB,CAAC;AAO9B,wBAAgB,WAAW,CAAC,QAAQ,SAAS,OAAO,CAAC,UAAU,CAAC,GAAG,sBAAsB,EAAE,IAAI,CAAC,EAAE;IAChG,SAAS,CAAC,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;CAC5D,GAAG,QAAQ,CAmBX"}

package/dist/internal/getServices.js

@@ -0,0 +1,19 @@
+import { logError as e } from "./utils.js";
+import { createUiServiceRegistry as t } from "./service_factories.js";
+import { buildServices as n, createServiceProxy as r, getRawPlatformaInstance as i } from "@platforma-sdk/model";
+import { isNil as a } from "es-toolkit";
+//#region src/internal/getServices.ts
+var o = null;
+function s(s) {
+	if (!a(o)) return o;
+	let c = s?.platforma ?? i(), l = t({ proxy: r(c.serviceDispatch) }), u = n(c.serviceDispatch, l);
+	return window.addEventListener("beforeunload", () => {
+		l.dispose().catch((t) => {
+			e("uiRegistry error in dispose", t);
+		});
+	}), o = u;
+}
+//#endregion
+export { s as getServices };
+
+//# sourceMappingURL=getServices.js.map

package/dist/internal/getServices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getServices.js","names":[],"sources":["../../src/internal/getServices.ts"],"sourcesContent":["import {\n  BlockDefaultUiServices,\n  buildServices,\n  createServiceProxy,\n  getRawPlatformaInstance,\n  PlatformaV3,\n  UiServices,\n} from \"@platforma-sdk/model\";\nimport { createUiServiceRegistry } from \"./service_factories\";\nimport { isNil } from \"es-toolkit\";\nimport { logError } from \"./utils\";\n\nlet cachedServices: null | Partial<UiServices> = null;\n\nexport function getServices<Services extends Partial<UiServices> = BlockDefaultUiServices>(deps?: {\n  platforma?: PlatformaV3<any, any, any, any, any, Services>;\n}): Services {\n  if (!isNil(cachedServices)) {\n    return cachedServices as Services;\n  }\n\n  const platforma =\n    deps?.platforma ??\n    (getRawPlatformaInstance() as PlatformaV3<any, any, any, any, any, Services>);\n  const proxy = createServiceProxy(platforma.serviceDispatch);\n  const uiRegistry = createUiServiceRegistry({ proxy });\n  const services = buildServices<Services>(platforma.serviceDispatch, uiRegistry);\n\n  window.addEventListener(\"beforeunload\", () => {\n    uiRegistry.dispose().catch((err) => {\n      logError(\"uiRegistry error in dispose\", err);\n    });\n  });\n\n  return (cachedServices = services) as Services;\n}\n"],"mappings":";;;;;AAYA,IAAI,IAA6C;AAEjD,SAAgB,EAA2E,GAE9E;AACX,KAAI,CAAC,EAAM,EAAe,CACxB,QAAO;CAGT,IAAM,IACJ,GAAM,aACL,GAAyB,EAEtB,IAAa,EAAwB,EAAE,OAD/B,EAAmB,EAAU,gBAAgB,EACP,CAAC,EAC/C,IAAW,EAAwB,EAAU,iBAAiB,EAAW;AAQ/E,QANA,OAAO,iBAAiB,sBAAsB;AAC5C,IAAW,SAAS,CAAC,OAAO,MAAQ;AAClC,KAAS,+BAA+B,EAAI;IAC5C;GACF,EAEM,IAAiB"}

package/dist/internal/service_factories.d.ts

@@ -1,7 +1,7 @@
 import { UiServiceRegistry } from '@milaboratories/pl-model-common';
-import { NodeServiceProxy } from '@platforma-sdk/model';
+import { ServiceProxy } from '@platforma-sdk/model';
 export type UiServiceOptions = {
-    proxy: NodeServiceProxy;
+    proxy: ServiceProxy;
 };
 export declare function createUiServiceRegistry(options: UiServiceOptions): UiServiceRegistry<{
     PFrameSpec: import('@milaboratories/pl-model-common').Branded<"pframeSpec", import('@milaboratories/pl-model-common').ServiceTypesLike<import('@milaboratories/pl-model-common').PFrameSpecDriver, import('@milaboratories/pl-model-common').PFrameSpecDriver, "wasm">>;

package/dist/internal/service_factories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service_factories.d.ts","sourceRoot":"","sources":["../../src/internal/service_factories.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAY,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAE9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,gBAAgB,CAAC;CACzB,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB;;;GAKhE"}
+{"version":3,"file":"service_factories.d.ts","sourceRoot":"","sources":["../../src/internal/service_factories.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAY,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAE9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,YAAY,CAAC;CACrB,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB;;;GAKhE"}

package/dist/internal/service_factories.js.map

@@ -1 +1 @@
-{"version":3,"file":"service_factories.js","names":[],"sources":["../../src/internal/service_factories.ts"],"sourcesContent":["/**\n * UI service factories — add a factory for each new service here.\n *\n * Each entry maps a Services key to a factory function that creates the\n * UI-side driver instance:\n * - WASM services: instantiated directly (e.g. SpecDriver)\n * - Node services: proxied via IPC using NodeServiceProxy\n */\n\nimport { Services, UiServiceRegistry } from \"@milaboratories/pl-model-common\";\nimport { SpecDriver } from \"@milaboratories/pf-spec-driver\";\nimport type { NodeServiceProxy } from \"@platforma-sdk/model\";\n\nexport type UiServiceOptions = {\n  proxy: NodeServiceProxy;\n};\n\nexport function createUiServiceRegistry(options: UiServiceOptions) {\n  return new UiServiceRegistry(Services, {\n    PFrameSpec: () => new SpecDriver(),\n    PFrame: () => options.proxy(Services.PFrame),\n  });\n}\n"],"mappings":";;;AAiBA,SAAgB,EAAwB,GAA2B;AACjE,QAAO,IAAI,EAAkB,GAAU;EACrC,kBAAkB,IAAI,GAAY;EAClC,cAAc,EAAQ,MAAM,EAAS,OAAO;EAC7C,CAAC"}
+{"version":3,"file":"service_factories.js","names":[],"sources":["../../src/internal/service_factories.ts"],"sourcesContent":["/**\n * UI service factories — add a factory for each new service here.\n *\n * Each entry maps a Services key to a factory function that creates the\n * UI-side driver instance:\n * - WASM services: instantiated directly (e.g. SpecDriver)\n * - Node services: proxied via IPC using NodeServiceProxy\n */\n\nimport { Services, UiServiceRegistry } from \"@milaboratories/pl-model-common\";\nimport { SpecDriver } from \"@milaboratories/pf-spec-driver\";\nimport type { ServiceProxy } from \"@platforma-sdk/model\";\n\nexport type UiServiceOptions = {\n  proxy: ServiceProxy;\n};\n\nexport function createUiServiceRegistry(options: UiServiceOptions) {\n  return new UiServiceRegistry(Services, {\n    PFrameSpec: () => new SpecDriver(),\n    PFrame: () => options.proxy(Services.PFrame),\n  });\n}\n"],"mappings":";;;AAiBA,SAAgB,EAAwB,GAA2B;AACjE,QAAO,IAAI,EAAkB,GAAU;EACrC,kBAAkB,IAAI,GAAY;EAClC,cAAc,EAAQ,MAAM,EAAS,OAAO;EAC7C,CAAC"}

package/dist/internal/utils.d.ts

@@ -0,0 +1,3 @@
+export declare const logDebug: (msg: string, ...rest: unknown[]) => void;
+export declare const logError: (msg: string, ...rest: unknown[]) => void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/internal/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/internal/utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,EAAE,GAAG,MAAM,OAAO,EAAE,SAOvD,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,EAAE,GAAG,MAAM,OAAO,EAAE,SAOvD,CAAC"}

package/dist/internal/utils.js

@@ -0,0 +1,16 @@
+//#region src/internal/utils.ts
+var e = (e, ...t) => {
+	console.log(`%c>>> %c${e}`, "color: orange; font-weight: bold", "color: orange", ...t.map((e) => n(e)));
+}, t = (e, ...t) => {
+	console.error(`%c>>> %c${e}`, "color: red; font-weight: bold", "color: red", ...t.map((e) => n(e)));
+}, n = (e) => {
+	try {
+		return JSON.stringify(e, null, 2);
+	} catch (e) {
+		return e instanceof Error ? e.message : String(e);
+	}
+};
+//#endregion
+export { e as logDebug, t as logError };
+
+//# sourceMappingURL=utils.js.map

package/dist/internal/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../../src/internal/utils.ts"],"sourcesContent":["export const logDebug = (msg: string, ...rest: unknown[]) => {\n  console.log(\n    `%c>>> %c${msg}`,\n    \"color: orange; font-weight: bold\",\n    \"color: orange\",\n    ...rest.map((r) => stringifyForDebug(r)),\n  );\n};\n\nexport const logError = (msg: string, ...rest: unknown[]) => {\n  console.error(\n    `%c>>> %c${msg}`,\n    \"color: red; font-weight: bold\",\n    \"color: red\",\n    ...rest.map((r) => stringifyForDebug(r)),\n  );\n};\n\nconst stringifyForDebug = (v: unknown) => {\n  try {\n    return JSON.stringify(v, null, 2);\n  } catch (err) {\n    return err instanceof Error ? err.message : String(err);\n  }\n};\n"],"mappings":";AAAA,IAAa,KAAY,GAAa,GAAG,MAAoB;AAC3D,SAAQ,IACN,WAAW,KACX,oCACA,iBACA,GAAG,EAAK,KAAK,MAAM,EAAkB,EAAE,CAAC,CACzC;GAGU,KAAY,GAAa,GAAG,MAAoB;AAC3D,SAAQ,MACN,WAAW,KACX,iCACA,cACA,GAAG,EAAK,KAAK,MAAM,EAAkB,EAAE,CAAC,CACzC;GAGG,KAAqB,MAAe;AACxC,KAAI;AACF,SAAO,KAAK,UAAU,GAAG,MAAM,EAAE;UAC1B,GAAK;AACZ,SAAO,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platforma-sdk/ui-vue",
-  "version": "1.66.0",
+  "version": "1.66.2",
   "type": "module",
   "main": "dist/index.js",
   "exports": {
@@ -26,10 +26,10 @@
     "lru-cache": "^11.2.2",
     "vue": "^3.5.24",
     "zod": "~3.25.76",
-    "@milaboratories/uikit": "2.12.6",
-    "@platforma-sdk/model": "1.65.10",
-    "@milaboratories/pl-model-common": "1.34.0",
-    "@milaboratories/pf-spec-driver": "1.3.1"
+    "@milaboratories/pl-model-common": "1.34.1",
+    "@milaboratories/pf-spec-driver": "1.3.2",
+    "@milaboratories/uikit": "2.12.8",
+    "@platforma-sdk/model": "1.66.2"
   },
   "devDependencies": {
     "@faker-js/faker": "^9.2.0",
@@ -43,10 +43,10 @@
     "typescript": "~5.9.3",
     "vite": "^8.0.6",
     "vitest": "^4.1.3",
-    "@milaboratories/helpers": "1.14.1",
     "@milaboratories/ts-builder": "1.3.2",
-    "@milaboratories/build-configs": "2.0.0",
-    "@milaboratories/ts-configs": "1.2.3"
+    "@milaboratories/helpers": "1.14.1",
+    "@milaboratories/ts-configs": "1.2.3",
+    "@milaboratories/build-configs": "2.0.0"
   },
   "scripts": {
     "dev": "ts-builder serve --target browser-lib",

package/src/components/PlAgColumnHeader/PlAgColumnHeader.vue

@@ -64,14 +64,20 @@ function showMenu() {
 
 <template>
   <div class="pl-ag-column-header d-flex align-center gap-6" @click="onSortRequested">
-    <PlTooltip>
-      <template v-if="params.tooltip" #tooltip>{{ params.tooltip }}</template>
-      <div class="pl-ag-column-header__title d-flex align-center gap-6 flex-grow-1">
-        <PlMaskIcon16 :name="icon" class="pl-ag-column-header__type-icon" />
+    <div class="pl-ag-column-header__title d-flex align-center gap-6 flex-grow-1">
+      <PlMaskIcon16 :name="icon" class="pl-ag-column-header__type-icon" />
+      <PlTooltip>
+        <template v-if="params.tooltip" #tooltip>{{ params.tooltip }}</template>
         <span>{{ params.displayName }}</span>
-        <PlMaskIcon16 v-if="sortIcon" :name="sortIcon" />
-      </div>
-    </PlTooltip>
+      </PlTooltip>
+      <PlTooltip v-if="params.info" max-width="500px" position="bottom" :close-delay="10000000000">
+        <template #tooltip>
+          <span style="white-space: pre-wrap">{{ params.info }}</span>
+        </template>
+        <PlMaskIcon16 name="info" />
+      </PlTooltip>
+      <PlMaskIcon16 v-if="sortIcon" :name="sortIcon" />
+    </div>
     <div
       v-if="params.enableMenu"
       ref="menuActivatorBtn"

package/src/components/PlAgColumnHeader/types.ts

@@ -3,4 +3,5 @@ export type PlAgHeaderComponentType = "Text" | "Number" | "File" | "Date" | "Dur
 export type PlAgHeaderComponentParams = {
   type?: PlAgHeaderComponentType;
   tooltip?: string;
+  info?: string;
 };

package/src/components/PlAgDataTable/sources/table-source-v2.ts

@@ -63,15 +63,15 @@ function columns2rows(
   axesResultIndices: number[],
 ): PlAgDataTableV2Row[] {
   const rowData: PlAgDataTableV2Row[] = [];
-  for (let iRow = 0; iRow < columns[0].data.length; ++iRow) {
-    const axesKey: PTableKey = axesResultIndices.map((ri) => pTableValue(columns[ri], iRow));
+  for (let rowIdx = 0; rowIdx < columns[0].data.length; ++rowIdx) {
+    const axesKey: PTableKey = axesResultIndices.map((ri) => pTableValue(columns[ri], rowIdx));
     const id = canonicalizeJson<PlTableRowId>(axesKey);
     const row = fields.reduce<PlAgDataTableV2Row>(
-      (acc, field, iCol) => {
+      (acc, field, colIdx) => {
         acc[field.toString() as `${number}`] =
-          fieldResultMapping[iCol] === -1
+          fieldResultMapping[colIdx] === -1
             ? PTableHidden
-            : pTableValue(columns[fieldResultMapping[iCol]], iRow);
+            : pTableValue(columns[fieldResultMapping[colIdx]], rowIdx);
         return acc;
       },
       { id, axesKey },
@@ -156,10 +156,10 @@ export async function calculateGridOptions({
   // request indices: non-hidden display fields + visible axes for row selection keys.
   // Axes replaced by label columns request label data (display); original axis values
   // are fetched via visibleAxes (row keys).
-  const { requestIndices, fieldResultMapping, axesResultIndices } = buildRequestIndices(
+  const { requestIndices, axesResultIndices, fieldResultMapping } = buildRequestIndices(
     indices,
+    visibleAxes.map(([idx]) => idx),
     specsToVisibleSpecsMapping,
-    visibleAxes.map(([i]) => i),
   );
 
   let rowCount = -1;
@@ -313,7 +313,12 @@ export function makeColDef(
             throw Error(`unsupported data type: ${valueType}`);
         }
       })(),
-      tooltip: readAnnotation(labeledSpec.spec, Annotation.Description)?.trim(),
+      tooltip:
+        readAnnotation(spec.spec, Annotation.Description)?.trim() ??
+        readAnnotation(labeledSpec.spec, Annotation.Description)?.trim(),
+      info:
+        readAnnotation(spec.spec, Annotation.Table.Info)?.trim() ??
+        readAnnotation(labeledSpec.spec, Annotation.Table.Info)?.trim(),
     } satisfies PlAgHeaderComponentParams,
     cellDataType: (() => {
       switch (valueType) {
@@ -465,26 +470,23 @@ function collectVisibleAxes(
  */
 function buildRequestIndices(
   indices: number[],
-  specsToVisibleSpecsMapping: Map<number, number>,
   visibleAxesIndices: number[],
+  specsToVisibleSpecsMapping: Map<number, number>,
 ): {
   requestIndices: number[];
-  fieldResultMapping: number[];
   axesResultIndices: number[];
+  fieldResultMapping: number[];
 } {
   const resolved = indices.map((displayField) => {
     const idx = specsToVisibleSpecsMapping.get(displayField);
-    return idx === undefined || idx === -1 ? null : idx;
+    return isNil(idx) || idx === -1 ? null : idx;
   });
-  const requestedFields = resolved.filter((v): v is number => v !== null);
-
-  const fieldResultMapping: number[] = [];
-  let pos = 0;
-  for (const v of resolved) {
-    fieldResultMapping.push(v === null ? -1 : pos++);
-  }
-
-  const requestIndices = uniq([...requestedFields, ...visibleAxesIndices]);
+  const requestIndices = uniq([
+    ...resolved.filter((v): v is number => v !== null),
+    ...visibleAxesIndices,
+  ]);
+  const fieldResultMapping = resolved.map((v) => (v === null ? -1 : requestIndices.indexOf(v)));
   const axesResultIndices = visibleAxesIndices.map((vi) => requestIndices.indexOf(vi));
-  return { requestIndices, fieldResultMapping, axesResultIndices };
+
+  return { requestIndices, axesResultIndices, fieldResultMapping };
 }

package/src/internal/createAppV3.ts

@@ -22,11 +22,8 @@ import {
   getPluginData,
   isPluginOutputKey,
   pluginOutputPrefix,
-  createNodeServiceProxy,
-  buildServices,
 } from "@platforma-sdk/model";
 import { type UiServices as AllUiServices } from "@milaboratories/pl-model-common";
-import { createUiServiceRegistry } from "./service_factories";
 import type { Ref } from "vue";
 import { reactive, computed, ref, markRaw } from "vue";
 import type { OutputValues, OutputErrors, AppSettings } from "../types";
@@ -36,6 +33,8 @@ import { applyPatch } from "fast-json-patch";
 import { UpdateSerializer } from "./UpdateSerializer";
 import { watchIgnorable } from "@vueuse/core";
 import type { PluginState, PluginAccess } from "../usePlugin";
+import { logDebug, logError } from "./utils";
+import { getServices } from "./getServices";
 
 export const patchPoolingDelay = 150;
 
@@ -53,14 +52,6 @@ export const createNextAuthorMarker = (marker: AuthorMarker | undefined): Author
   localVersion: (marker?.localVersion ?? 0) + 1,
 });
 
-const stringifyForDebug = (v: unknown) => {
-  try {
-    return JSON.stringify(v, null, 2);
-  } catch (err) {
-    return err instanceof Error ? err.message : String(err);
-  }
-};
-
 /**
  * Creates an application instance with reactive state management, outputs, and methods for state updates and navigation.
  *
@@ -87,25 +78,8 @@ export function createAppV3<
   platforma: PlatformaExtended<PlatformaV3<Data, Args, Outputs, Href, Plugins, UiServices>>,
   settings: AppSettings,
 ) {
-  const debug = (msg: string, ...rest: unknown[]) => {
-    if (settings.debug) {
-      console.log(
-        `%c>>> %c${msg}`,
-        "color: orange; font-weight: bold",
-        "color: orange",
-        ...rest.map((r) => stringifyForDebug(r)),
-      );
-    }
-  };
-
-  const error = (msg: string, ...rest: unknown[]) => {
-    console.error(
-      `%c>>> %c${msg}`,
-      "color: red; font-weight: bold",
-      "color: red",
-      ...rest.map((r) => stringifyForDebug(r)),
-    );
-  };
+  const debug = settings.debug ? logDebug : () => {};
+  const error = logError;
 
   const data = {
     isExternalSnapshot: false,
@@ -230,11 +204,12 @@ export function createAppV3<
   (async () => {
     window.addEventListener("beforeunload", () => {
       closedRef.value = true;
-      Promise.allSettled([uiRegistry.dispose(), platforma.dispose().then(unwrapResult)]).catch(
-        (err) => {
+      platforma
+        .dispose()
+        .then(unwrapResult)
+        .catch((err) => {
           error("error in dispose", err);
-        },
-      );
+        });
     });
 
     while (!closedRef.value) {
@@ -334,9 +309,7 @@ export function createAppV3<
     },
   };
 
-  const proxy = createNodeServiceProxy(platforma.serviceDispatch);
-  const uiRegistry = createUiServiceRegistry({ proxy });
-  const services = buildServices<UiServices>(platforma.serviceDispatch, uiRegistry);
+  const services = getServices<UiServices>({ platforma });
 
   /** Creates a lazily-cached per-plugin reactive state. */
   const createPluginState = <F extends PluginFactoryLike>(

package/src/internal/getServices.ts

@@ -0,0 +1,36 @@
+import {
+  BlockDefaultUiServices,
+  buildServices,
+  createServiceProxy,
+  getRawPlatformaInstance,
+  PlatformaV3,
+  UiServices,
+} from "@platforma-sdk/model";
+import { createUiServiceRegistry } from "./service_factories";
+import { isNil } from "es-toolkit";
+import { logError } from "./utils";
+
+let cachedServices: null | Partial<UiServices> = null;
+
+export function getServices<Services extends Partial<UiServices> = BlockDefaultUiServices>(deps?: {
+  platforma?: PlatformaV3<any, any, any, any, any, Services>;
+}): Services {
+  if (!isNil(cachedServices)) {
+    return cachedServices as Services;
+  }
+
+  const platforma =
+    deps?.platforma ??
+    (getRawPlatformaInstance() as PlatformaV3<any, any, any, any, any, Services>);
+  const proxy = createServiceProxy(platforma.serviceDispatch);
+  const uiRegistry = createUiServiceRegistry({ proxy });
+  const services = buildServices<Services>(platforma.serviceDispatch, uiRegistry);
+
+  window.addEventListener("beforeunload", () => {
+    uiRegistry.dispose().catch((err) => {
+      logError("uiRegistry error in dispose", err);
+    });
+  });
+
+  return (cachedServices = services) as Services;
+}

package/src/internal/service_factories.ts

@@ -9,10 +9,10 @@
 
 import { Services, UiServiceRegistry } from "@milaboratories/pl-model-common";
 import { SpecDriver } from "@milaboratories/pf-spec-driver";
-import type { NodeServiceProxy } from "@platforma-sdk/model";
+import type { ServiceProxy } from "@platforma-sdk/model";
 
 export type UiServiceOptions = {
-  proxy: NodeServiceProxy;
+  proxy: ServiceProxy;
 };
 
 export function createUiServiceRegistry(options: UiServiceOptions) {

package/src/internal/utils.ts

@@ -0,0 +1,25 @@
+export const logDebug = (msg: string, ...rest: unknown[]) => {
+  console.log(
+    `%c>>> %c${msg}`,
+    "color: orange; font-weight: bold",
+    "color: orange",
+    ...rest.map((r) => stringifyForDebug(r)),
+  );
+};
+
+export const logError = (msg: string, ...rest: unknown[]) => {
+  console.error(
+    `%c>>> %c${msg}`,
+    "color: red; font-weight: bold",
+    "color: red",
+    ...rest.map((r) => stringifyForDebug(r)),
+  );
+};
+
+const stringifyForDebug = (v: unknown) => {
+  try {
+    return JSON.stringify(v, null, 2);
+  } catch (err) {
+    return err instanceof Error ? err.message : String(err);
+  }
+};