@platforma-sdk/ui-vue 1.67.0 → 1.68.1

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

@@ -1 +1 @@
-{"version":3,"file":"createAppV3.d.ts","sourceRoot":"","sources":["../../src/internal/createAppV3.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAMnB,MAAM,sBAAsB,CAAC;AAS9B,OAAO,EAAE,KAAK,UAAU,IAAI,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAGnF,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAMxE,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,cAAc,CAAC;AAI9D,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAWrC,eAAO,MAAM,sBAAsB,GAAI,QAAQ,YAAY,GAAG,SAAS,KAAG,YAGxE,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CACzB,IAAI,GAAG,OAAO,EACd,IAAI,GAAG,OAAO,EACd,OAAO,SAAS,gBAAgB,GAAG,gBAAgB,EACnD,IAAI,SAAS,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,EACxC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,UAAU,SAAS,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,EAElE,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,EACvD,SAAS,EAAE,iBAAiB,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,EACzF,QAAQ,EAAE,WAAW;;eAsGZ,MAAM;;;;;;;;qBAvDJ,OAAO,CAAC,OAAO,CAAC;0BACX,OAAO;6BACJ,eAAe,CAAC,IAAI,CAAC;;;;;;;;yBA+IkB,IAAI;oCAEf,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAK3E;;;;;;WAMG;uBACY,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;QAMtD;;;;;WAKG;yBACc,IAAI;;;;EA8HxB;AAED,MAAM,MAAM,SAAS,CACnB,IAAI,GAAG,OAAO,EACd,IAAI,GAAG,OAAO,EACd,OAAO,SAAS,gBAAgB,GAAG,gBAAgB,EACnD,IAAI,SAAS,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,EACxC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,UAAU,SAAS,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,IAChE,UAAU,CAAC,OAAO,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC"}
+{"version":3,"file":"createAppV3.d.ts","sourceRoot":"","sources":["../../src/internal/createAppV3.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAKlB,UAAU,IAAI,aAAa,EAE5B,MAAM,sBAAsB,CAAC;AAW9B,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAMxE,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI1E,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAWrC,eAAO,MAAM,sBAAsB,GAAI,QAAQ,YAAY,GAAG,SAAS,KAAG,YAGxE,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CACzB,IAAI,GAAG,OAAO,EACd,IAAI,GAAG,OAAO,EACd,OAAO,SAAS,gBAAgB,GAAG,gBAAgB,EACnD,IAAI,SAAS,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,EACxC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,UAAU,SAAS,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,EAElE,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,EACvD,SAAS,EAAE,iBAAiB,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,EACzF,QAAQ,EAAE,WAAW;;eAsGZ,MAAM;;;;;;;;qBAvDJ,OAAO,CAAC,OAAO,CAAC;0BACX,OAAO;6BACJ,eAAe,CAAC,IAAI,CAAC;;;;;;;;yBA+IkB,IAAI;oCAEf,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAK3E;;;;;;WAMG;uBACY,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;QAMtD;;;;;WAKG;yBACc,IAAI;;;;EA8HxB;AAED,MAAM,MAAM,SAAS,CACnB,IAAI,GAAG,OAAO,EACd,IAAI,GAAG,OAAO,EACd,OAAO,SAAS,gBAAgB,GAAG,gBAAgB,EACnD,IAAI,SAAS,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,EACxC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,UAAU,SAAS,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,IAChE,UAAU,CAAC,OAAO,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC"}

package/dist/internal/createAppV3.js

@@ -55,7 +55,7 @@ function C(C, w, T) {
 	(async () => {
 		for (window.addEventListener("beforeunload", () => {
 			A.value = !0, w.dispose().then(y).catch((e) => {
-				D("error in dispose", e);
+				D("platforma error in dispose", e);
 			});
 		}); !A.value;) try {
 			let e = await w.getPatches(j.value).then(y);

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} 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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"}
+{"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  PluginFactoryLike,\n  UiServices as AllUiServices,\n  InferFactoryUiServices,\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 { 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 \"../composition/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(\"platforma 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/service_factories.d.ts

@@ -6,5 +6,6 @@ export type UiServiceOptions = {
 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">>;
     PFrame: import('@milaboratories/pl-model-common').Branded<"pframe", import('@milaboratories/pl-model-common').ServiceTypesLike<import('@milaboratories/pl-model-common').PFrameModelDriver<import('@milaboratories/pl-model-common').PColumn<string | import('@milaboratories/pl-model-common').PColumnValues | import('@milaboratories/pl-model-common').DataInfo<string>>>, import('@milaboratories/pl-model-common').PFrameDriver, "node">>;
+    Dialog: import('@milaboratories/pl-model-common').Branded<"dialog", import('@milaboratories/pl-model-common').ServiceTypesLike<Record<string, never>, import('@milaboratories/pl-model-common').DialogService, "main">>;
 }>;
 //# sourceMappingURL=service_factories.d.ts.map

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,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"}
+{"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;;;;GAMhE"}

package/dist/internal/service_factories.js

@@ -4,7 +4,8 @@ import { SpecDriver as n } from "@milaboratories/pf-spec-driver";
 function r(r) {
 	return new t(e, {
 		PFrameSpec: () => new n(),
-		PFrame: () => r.proxy(e.PFrame)
+		PFrame: () => r.proxy(e.PFrame),
+		Dialog: () => r.proxy(e.Dialog)
 	});
 }
 //#endregion

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 { 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"}
+{"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    Dialog: () => options.proxy(Services.Dialog),\n  });\n}\n"],"mappings":";;;AAiBA,SAAgB,EAAwB,GAA2B;AACjE,QAAO,IAAI,EAAkB,GAAU;EACrC,kBAAkB,IAAI,GAAY;EAClC,cAAc,EAAQ,MAAM,EAAS,OAAO;EAC5C,cAAc,EAAQ,MAAM,EAAS,OAAO;EAC7C,CAAC"}

package/dist/lib.d.ts

@@ -20,8 +20,8 @@ export * from './components/PlBtnExportArchive';
 export * from './components/PlAdvancedFilter';
 export * from './components/PlDatasetSelector';
 export * from './defineApp';
-export { usePlugin } from './usePlugin';
-export type { PluginState } from './usePlugin';
+export { usePlugin } from './composition/usePlugin';
+export type { PluginState } from './composition/usePlugin';
 export type { PluginHandle, PluginFactoryLike, InferPluginHandle, InferFactoryData, InferFactoryOutputs, } from '@platforma-sdk/model';
 export * from './createModel';
 export * from './types';

package/dist/lib.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAC5F,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AAClG,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAEhG,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,cAAc,aAAa,CAAC;AAE5B,cAAc,+BAA+B,CAAC;AAE9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,cAAc,sCAAsC,CAAC;AAErD,cAAc,4BAA4B,CAAC;AAE3C,cAAc,8BAA8B,CAAC;AAE7C,cAAc,oCAAoC,CAAC;AAEnD,cAAc,oCAAoC,CAAC;AAEnD,cAAc,6BAA6B,CAAC;AAE5C,cAAc,4BAA4B,CAAC;AAE3C,cAAc,iCAAiC,CAAC;AAEhD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,gCAAgC,CAAC;AAE/C,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,cAAc,eAAe,CAAC;AAE9B,cAAc,SAAS,CAAC;AAExB,cAAc,eAAe,CAAC;AAE9B,cAAc,sBAAsB,CAAC;AAErC,cAAc,SAAS,CAAC;AAExB,cAAc,cAAc,CAAC;AAE7B,cAAc,kBAAkB,CAAC;AAEjC,cAAc,2BAA2B,CAAC;AAE1C,cAAc,uBAAuB,CAAC;AAEtC,mBAAmB,uBAAuB,CAAC"}
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAC5F,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AAClG,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAEhG,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,cAAc,aAAa,CAAC;AAE5B,cAAc,+BAA+B,CAAC;AAE9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,cAAc,sCAAsC,CAAC;AAErD,cAAc,4BAA4B,CAAC;AAE3C,cAAc,8BAA8B,CAAC;AAE7C,cAAc,oCAAoC,CAAC;AAEnD,cAAc,oCAAoC,CAAC;AAEnD,cAAc,6BAA6B,CAAC;AAE5C,cAAc,4BAA4B,CAAC;AAE3C,cAAc,iCAAiC,CAAC;AAEhD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,gCAAgC,CAAC;AAE/C,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,cAAc,eAAe,CAAC;AAE9B,cAAc,SAAS,CAAC;AAExB,cAAc,eAAe,CAAC;AAE9B,cAAc,sBAAsB,CAAC;AAErC,cAAc,SAAS,CAAC;AAExB,cAAc,cAAc,CAAC;AAE7B,cAAc,kBAAkB,CAAC;AAEjC,cAAc,2BAA2B,CAAC;AAE1C,cAAc,uBAAuB,CAAC;AAEtC,mBAAmB,uBAAuB,CAAC"}

package/dist/lib.js

@@ -4,25 +4,25 @@ import "./utils.js";
 import "./createModel.js";
 import "./defineApp.js";
 import "./components/BlockLayout.js";
-import "./components/PlAgCsvExporter/PlAgCsvExporter.js";
+import "./components/PlAgDataTable/PlAgOverlayLoading.js";
+import "./components/PlAgDataTable/PlAgOverlayNoRows.js";
+import "./components/PlAgDataTable/types.js";
 import "./components/PlAgDataTable/sources/row-number.js";
+import "./components/PlAgDataTable/sources/focus-row.js";
+import "./components/PlAgDataTable/sources/menu-items.js";
+import "./components/PlAgDataTable/index.js";
+import "./components/PlAgCsvExporter/PlAgCsvExporter.js";
 import "./components/PlAgGridColumnManager/PlAgGridColumnManager.js";
 import "./components/PlAgGridColumnManager/index.js";
 import "./components/PlAdvancedFilter/PlAdvancedFilter.js";
 import "./components/PlAdvancedFilter/index.js";
 import "./components/PlTableFilters/PlTableFiltersV2.js";
-import "./components/PlAgDataTable/sources/focus-row.js";
 import "./components/PlAgColumnHeader/PlAgColumnHeader.js";
 import "./components/PlAgColumnHeader/index.js";
 import "./components/PlAgTextAndButtonCell/PlAgTextAndButtonCell.js";
 import "./components/PlAgTextAndButtonCell/index.js";
-import "./components/PlAgDataTable/sources/menu-items.js";
-import "./components/PlAgDataTable/PlAgOverlayLoading.js";
-import "./components/PlAgDataTable/PlAgOverlayNoRows.js";
 import "./AgGridVue/AgGridTheme.js";
 import "./components/PlAgDataTable/PlAgDataTableV2.js";
-import "./components/PlAgDataTable/types.js";
-import "./components/PlAgDataTable/index.js";
 import "./components/PlAgCellProgress/PlAgCellProgress.js";
 import "./components/PlAgCellProgress/index.js";
 import "./AgGridVue/createAgGridColDef.js";
@@ -46,7 +46,7 @@ import "./components/PlBtnExportArchive/PlBtnExportArchive.js";
 import "./components/PlBtnExportArchive/index.js";
 import "./components/PlDatasetSelector/PlDatasetSelector.js";
 import "./components/PlDatasetSelector/index.js";
-import "./usePlugin.js";
+import "./composition/usePlugin.js";
 import "./defineStore.js";
 import "./composition/AgGrid/index.js";
 import "./objectHash.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platforma-sdk/ui-vue",
-  "version": "1.67.0",
+  "version": "1.68.1",
   "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/pf-spec-driver": "1.3.3",
-    "@milaboratories/pl-model-common": "1.35.0",
-    "@platforma-sdk/model": "1.67.0",
-    "@milaboratories/uikit": "2.12.9"
+    "@milaboratories/pl-model-common": "1.36.0",
+    "@milaboratories/pf-spec-driver": "1.3.4",
+    "@milaboratories/uikit": "2.12.10",
+    "@platforma-sdk/model": "1.68.0"
   },
   "devDependencies": {
     "@faker-js/faker": "^9.2.0",
@@ -46,9 +46,9 @@
     "vite": "^8.0.6",
     "vitest": "^4.1.3",
     "@milaboratories/helpers": "1.14.1",
-    "@milaboratories/build-configs": "2.0.0",
     "@milaboratories/ts-configs": "1.2.3",
-    "@milaboratories/ts-builder": "1.3.2"
+    "@milaboratories/ts-builder": "1.3.2",
+    "@milaboratories/build-configs": "2.0.0"
   },
   "scripts": {
     "dev": "ts-builder serve --target browser-lib",

package/src/components/PlAgCsvExporter/PlAgCsvExporter.vue

@@ -1,25 +1,38 @@
 <script setup lang="ts">
 import type { GridApi } from "ag-grid-enterprise";
+import type { PTableHandle } from "@platforma-sdk/model";
 import { PlBtnGhost, usePlBlockPageTitleTeleportTarget } from "@milaboratories/uikit";
 import { shallowRef, toRefs } from "vue";
-import { exportCsv } from "./export-csv";
+import { isNil } from "es-toolkit";
+import { exportCsv, isCsvExportAvailable } from "./export-csv";
+import type { ExportOptions } from "./export-csv";
 
 const props = defineProps<{
   api: GridApi;
+  tableHandle?: PTableHandle;
 }>();
 const { api: gridApi } = toRefs(props);
+const csvExportAvailable = isCsvExportAvailable();
 
 const exporting = shallowRef(false);
 const initiateExport = () => {
+  const nativeOptions: ExportOptions | undefined = !isNil(props.tableHandle)
+    ? { tableHandle: props.tableHandle, format: "csv" }
+    : undefined;
+
+  if (isNil(nativeOptions)) {
+    return;
+  }
+
   exporting.value = true;
-  exportCsv(gridApi.value, () => (exporting.value = false));
+  exportCsv(gridApi.value, nativeOptions).finally(() => (exporting.value = false));
 };
 
 const teleportTarget = usePlBlockPageTitleTeleportTarget("PlAgCsvExporter");
 </script>
 
 <template>
-  <Teleport v-if="teleportTarget" :to="teleportTarget">
+  <Teleport v-if="teleportTarget && csvExportAvailable" :to="teleportTarget">
     <PlBtnGhost :loading="exporting" icon="export" @click.stop="initiateExport">
       Export
     </PlBtnGhost>

package/src/components/PlAgCsvExporter/export-csv.ts

@@ -1,74 +1,122 @@
-import {
-  type ColDef,
-  type ColGroupDef,
-  createGrid,
-  type GridApi,
-  type GridOptions,
-  ServerSideRowModelModule,
-} from "ag-grid-enterprise";
+import { type ColDef, type ColGroupDef, type GridApi } from "ag-grid-enterprise";
+import type {
+  PTableHandle,
+  PTableDownloadFormat,
+  PTableColumnSpec,
+  PFrameSpecDriver,
+  WritePTableToFsResult,
+  PlTableColumnIdJson,
+} from "@platforma-sdk/model";
+import { getPTableColumnId, parseJson } from "@platforma-sdk/model";
+import { isNil } from "es-toolkit";
+import { Nil } from "@milaboratories/helpers";
+import { getServices } from "../../internal/getServices";
+import { PlAgDataTableRowNumberColId } from "../PlAgDataTable";
 
-function createGridDiv(): HTMLDivElement {
-  const div = document.createElement("div");
+/** Options for the native CSV export path. */
+export interface ExportOptions {
+  tableHandle: PTableHandle;
+  format: PTableDownloadFormat;
+  defaultFileName?: string;
+}
 
-  div.style.visibility = "hidden";
-  div.style.position = "absolute";
+/**
+ * CSV export via the platforma desktop runtime. Prompts for a save
+ * destination via the `Dialog` service, then streams the PTable to the
+ * chosen path via `PFrame.writePTableToFs`.
+ */
+export async function exportCsv(
+  gridApi: GridApi,
+  nativeOptions: ExportOptions,
+): Promise<undefined | WritePTableToFsResult> {
+  const { dialog, pframe, pframeSpec } = getServices();
+  if (isNil(dialog)) {
+    throw new Error("dialog service is not available in the current environment");
+  }
+  if (isNil(pframe)) {
+    throw new Error("pframe service is not available");
+  }
+  if (isNil(pframeSpec)) {
+    throw new Error("pframeSpec service is not available");
+  }
 
-  document.body.appendChild(div);
-  return div;
+  const specs = await pframe.getSpec(nativeOptions.tableHandle);
+  const columnIndices = collectVisibleColumnIndices(gridApi, specs, pframeSpec);
+  if (isNil(columnIndices)) {
+    return undefined;
+  }
+
+  const { canceled, path } = await dialog.showSaveDialog({
+    defaultFileName:
+      (nativeOptions.defaultFileName ?? `table_${formatTimestamp(new Date())}`) +
+      `.${nativeOptions.format}.gz`,
+  });
+  if (canceled || isNil(path)) {
+    return undefined;
+  }
+
+  return pframe.writePTableToFs(nativeOptions.tableHandle, {
+    path,
+    format: nativeOptions.format,
+    columnIndices,
+    compression: { type: "gzip" },
+  });
+}
+
+function formatTimestamp(d: Date): string {
+  const pad = (n: number) => String(n).padStart(2, "0");
+  return (
+    `${pad(d.getDate())}-${pad(d.getMonth() + 1)}-${d.getFullYear()}` +
+    `_${pad(d.getHours())}-${pad(d.getMinutes())}-${pad(d.getSeconds())}`
+  );
 }
 
-function destroyGridDiv(cellFake: HTMLDivElement) {
-  document.body.removeChild(cellFake);
+/**
+ * Checks whether the native CSV export capability is available in the
+ * current platforma runtime environment. Both `Dialog` and `PFrame`
+ * services must be present — desktop-app wires them, web/preview do not.
+ */
+export function isCsvExportAvailable(): boolean {
+  try {
+    const services = getServices();
+    return !isNil(services?.dialog) && !isNil(services?.pframe);
+  } catch {
+    return false;
+  }
 }
 
-export async function exportCsv(gridApi: GridApi, completed: () => void) {
-  const rowModel = gridApi.getGridOption("rowModelType");
-  switch (rowModel) {
-    case "clientSide": {
-      gridApi.exportDataAsCsv();
-      return completed();
-    }
+/**
+ * Collect unified column indices for visible (non-hidden) columns from the
+ * ag-grid column defs, remapped onto the provided PTable spec array so the
+ * indices match the current table handle (ColDef.field indices may be stale
+ * or diverge from the spec order).
+ *
+ * Each grid column carries a `PlTableColumnId` ({ source, labeled }). When
+ * the labeled spec differs from the source (axis replaced by a label
+ * column), both indices are emitted so the export contains the raw axis
+ * value alongside its human-readable label.
+ */
+export function collectVisibleColumnIndices(
+  gridApi: GridApi,
+  specs: PTableColumnSpec[],
+  pframeSpec: PFrameSpecDriver,
+): Nil | number[] {
+  const columnDefs = gridApi.getColumnDefs();
+  if (isNil(columnDefs)) {
+    return;
+  }
 
-    case "serverSide": {
-      const state = gridApi.getServerSideGroupLevelState();
-      if (state.length === 0 || state[0].rowCount <= state[0].cacheBlockSize!) {
-        gridApi.exportDataAsCsv();
-        return completed();
-      }
+  const findIndex = (spec: PTableColumnSpec) =>
+    pframeSpec.findTableColumn(specs, getPTableColumnId(spec));
 
-      let exportStarted = false;
-      const gridDiv = createGridDiv();
-      const gridOptions: GridOptions = {
-        rowModelType: "serverSide",
-        columnDefs:
-          gridApi
-            .getColumnDefs()
-            ?.filter((def: ColDef | ColGroupDef): def is ColDef => !("children" in def))
-            .map((def) => ({
-              headerName: def.headerName,
-              field: def.field,
-              valueFormatter: def.valueFormatter,
-              valueGetter: def.valueGetter,
-            })) ?? [],
-        serverSideDatasource: gridApi.getGridOption("serverSideDatasource"),
-        cacheBlockSize: state[0].rowCount,
-        onModelUpdated: (event) => {
-          const state = event.api.getServerSideGroupLevelState();
-          if (!exportStarted && state.length > 0 && state[0].rowCount === state[0].cacheBlockSize) {
-            exportStarted = true;
-            event.api.exportDataAsCsv();
-            destroyGridDiv(gridDiv);
-            return completed();
-          }
-        },
-        defaultCsvExportParams: gridApi.getGridOption("defaultCsvExportParams"),
-      };
-      return createGrid(gridDiv, gridOptions, { modules: [ServerSideRowModelModule] });
-    }
+  const specsForDef = (def: ColDef | ColGroupDef): PTableColumnSpec[] => {
+    if ("children" in def) return [];
+    if (def.hide === true) return [];
+    if (isNil(def.colId)) return [];
+    if (def.colId === PlAgDataTableRowNumberColId) return [];
+    const { labeled } = parseJson(def.colId as PlTableColumnIdJson);
+    return [labeled];
+  };
 
-    default: {
-      completed();
-      throw Error(`exportCsv unsupported for rowModelType = ${rowModel}`);
-    }
-  }
+  return [...new Set(columnDefs.flatMap(specsForDef).map(findIndex))].filter((idx) => idx !== -1);
 }

package/src/components/PlAgDataTable/PlAgDataTableV2.vue

@@ -554,8 +554,13 @@ watchEffect(() => {
       @updateFilters="(v) => (filtersState = v)"
       @resetDefaultFilters="resetDefaultFilters"
       @updateDefaultFilters="(v) => (defaultFiltersState = v)"
+      v-model="filtersState"
+    />
+    <PlAgCsvExporter
+      v-if="gridApi && showExportButton"
+      :api="gridApi"
+      :table-handle="'model' in settings ? settings?.model?.visibleTableHandle : undefined"
     />
-    <PlAgCsvExporter v-if="gridApi && showExportButton" :api="gridApi" />
     <PlAgDataTableSheets v-model="sheetsState" :settings="sheetsSettings">
       <template v-if="$slots['before-sheets']" #before>
         <slot name="before-sheets" />

package/src/components/PlAgDataTable/compositions/useGrid.ts

@@ -81,11 +81,14 @@ export function useGrid({
       text: noRowsText,
     } satisfies PlAgOverlayNoRowsParams,
     defaultCsvExportParams: {
-      allColumns: true,
       suppressQuotes: true,
       columnSeparator: "\t",
       fileName: "table.tsv",
     },
+    getContextMenuItems: (params) =>
+      (params.defaultItems ?? []).filter(
+        (item) => item !== "export" && item !== "csvExport" && item !== "excelExport",
+      ),
     onGridReady: (event) => {
       const api = event.api;
       autoSizeRowNumberColumn(api);

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

@@ -396,11 +396,11 @@ function selectDisplayableIndices(
     .filter(([, spec]) => {
       switch (spec.type) {
         case "axis":
-          return !isPartitionedAxis(spec.id);
+          return !isColumnHidden(spec.spec) && !isPartitionedAxis(spec.id);
         case "column":
           return (
-            !isLabelColumnSpec(spec.spec) &&
             !isColumnHidden(spec.spec) &&
+            !isLabelColumnSpec(spec.spec) &&
             !isLinkerColumnSpec(spec.spec)
           );
       }

package/src/{usePlugin.ts → composition/usePlugin.ts}

@@ -1,5 +1,5 @@
 import { inject, type Reactive } from "vue";
-import { pluginDataKey } from "./defineApp";
+import { pluginDataKey } from "../defineApp";
 import type {
   PluginHandle,
   InferFactoryData,

package/src/composition/useServices.ts

@@ -0,0 +1,5 @@
+import { getServices } from "../internal/getServices";
+
+export function useServices() {
+  return getServices();
+}

package/src/internal/createAppV3.ts

@@ -12,8 +12,9 @@ import type {
   PluginHandle,
   InferFactoryData,
   InferFactoryOutputs,
-  InferFactoryUiServices,
   PluginFactoryLike,
+  UiServices as AllUiServices,
+  InferFactoryUiServices,
 } from "@platforma-sdk/model";
 import {
   hasAbortError,
@@ -23,7 +24,6 @@ import {
   isPluginOutputKey,
   pluginOutputPrefix,
 } from "@platforma-sdk/model";
-import { type UiServices as AllUiServices } from "@milaboratories/pl-model-common";
 import type { Ref } from "vue";
 import { reactive, computed, ref, markRaw } from "vue";
 import type { OutputValues, OutputErrors, AppSettings } from "../types";
@@ -32,7 +32,7 @@ import { ensureOutputHasStableFlag, MultiError } from "../utils";
 import { applyPatch } from "fast-json-patch";
 import { UpdateSerializer } from "./UpdateSerializer";
 import { watchIgnorable } from "@vueuse/core";
-import type { PluginState, PluginAccess } from "../usePlugin";
+import type { PluginState, PluginAccess } from "../composition/usePlugin";
 import { logDebug, logError } from "./utils";
 import { getServices } from "./getServices";
 
@@ -208,7 +208,7 @@ export function createAppV3<
         .dispose()
         .then(unwrapResult)
         .catch((err) => {
-          error("error in dispose", err);
+          error("platforma error in dispose", err);
         });
     });
 

package/src/internal/service_factories.ts

@@ -19,5 +19,6 @@ export function createUiServiceRegistry(options: UiServiceOptions) {
   return new UiServiceRegistry(Services, {
     PFrameSpec: () => new SpecDriver(),
     PFrame: () => options.proxy(Services.PFrame),
+    Dialog: () => options.proxy(Services.Dialog),
   });
 }

package/src/lib.ts

@@ -37,8 +37,8 @@ export * from "./components/PlDatasetSelector";
 
 export * from "./defineApp";
 
-export { usePlugin } from "./usePlugin";
-export type { PluginState } from "./usePlugin";
+export { usePlugin } from "./composition/usePlugin";
+export type { PluginState } from "./composition/usePlugin";
 export type {
   PluginHandle,
   PluginFactoryLike,

package/dist/usePlugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"usePlugin.d.ts","sourceRoot":"","sources":["../src/usePlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AAE5C,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAE9B,sEAAsE;AACtE,MAAM,WAAW,WAAW,CAC1B,IAAI,GAAG,OAAO,EACd,OAAO,GAAG,OAAO,EACjB,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAElC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;QACvB,IAAI,EAAE,IAAI,CAAC;QACX,OAAO,EAAE,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5C;aAAG,CAAC,IAAI,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS;SAAE,GAChD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC5B,YAAY,EAAE,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjD;aAAG,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,EAAE,KAAK;SAAE,GAChC,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,SAAS,CAAC,CAAC;KACvC,CAAC,CAAC;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AAED,wFAAwF;AACxF,MAAM,WAAW,YAAY;IAC3B,sBAAsB,CAAC,CAAC,SAAS,iBAAiB,EAChD,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GACtB,WAAW,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;CACxF;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,iBAAiB,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,uFAW7E"}

package/dist/usePlugin.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"usePlugin.js","names":[],"sources":["../src/usePlugin.ts"],"sourcesContent":["import { inject, type Reactive } from \"vue\";\nimport { pluginDataKey } from \"./defineApp\";\nimport type {\n  PluginHandle,\n  InferFactoryData,\n  InferFactoryOutputs,\n  InferFactoryUiServices,\n  PluginFactoryLike,\n} from \"@platforma-sdk/model\";\n\n/** Per-plugin reactive model exposed to consumers via usePlugin(). */\nexport interface PluginState<\n  Data = unknown,\n  Outputs = unknown,\n  Services = Record<string, unknown>,\n> {\n  readonly model: Reactive<{\n    data: Data;\n    outputs: Outputs extends Record<string, unknown>\n      ? { [K in keyof Outputs]: Outputs[K] | undefined }\n      : Record<string, unknown>;\n    outputErrors: Outputs extends Record<string, unknown>\n      ? { [K in keyof Outputs]?: Error }\n      : Record<string, Error | undefined>;\n  }>;\n  readonly services: Services;\n}\n\n/** Internal interface for plugin access — provided via Vue injection to usePlugin(). */\nexport interface PluginAccess {\n  getOrCreatePluginState<F extends PluginFactoryLike>(\n    handle: PluginHandle<F>,\n  ): PluginState<InferFactoryData<F>, InferFactoryOutputs<F>, InferFactoryUiServices<F>>;\n}\n\n/**\n * Composable for accessing a plugin's reactive model: data, outputs, and outputErrors.\n *\n * Mirrors the `app.model` access pattern — `plugin.model.data` is reactive and deep-watched,\n * mutations are automatically queued and sent to storage.\n *\n * @param handle - Opaque plugin handle obtained from `app.plugins`.\n * @typeParam F - The plugin factory type (inferred from the handle)\n *\n * @example\n * ```vue\n * <script setup lang=\"ts\">\n * import { usePlugin, type InferPluginHandle } from '@platforma-sdk/ui-vue';\n * import type { CounterPlugin } from './plugins/counter';\n *\n * const props = defineProps<{ instance: InferPluginHandle<CounterPlugin> }>();\n * const plugin = usePlugin(props.instance);\n *\n * plugin.model.data.count += 1;          // reactive, triggers storage update\n * plugin.model.outputs.displayText       // computed, plugin's own outputs only\n * plugin.model.outputErrors.displayText  // Error | undefined\n * </script>\n * ```\n */\nexport function usePlugin<F extends PluginFactoryLike>(handle: PluginHandle<F>) {\n  const access = inject<PluginAccess>(pluginDataKey);\n\n  if (!access) {\n    throw new Error(\n      \"usePlugin requires a V3 block (BlockModelV3). \" +\n        \"Make sure the block uses apiVersion 3 and the plugin is installed.\",\n    );\n  }\n\n  return access.getOrCreatePluginState<F>(handle);\n}\n"],"mappings":";;;AA2DA,SAAgB,EAAuC,GAAyB;CAC9E,IAAM,IAAS,EAAqB,EAAc;AAElD,KAAI,CAAC,EACH,OAAU,MACR,mHAED;AAGH,QAAO,EAAO,uBAA0B,EAAO"}