@platforma-sdk/ui-vue 1.57.3 → 1.58.0

package/dist/internal/createAppV3.js

@@ -1,116 +1,118 @@
-import { delay as B } from "../lib/util/helpers/dist/utils.js";
-import { uniqueId as R } from "../lib/util/helpers/dist/strings.js";
-import { deepClone as h } from "../lib/util/helpers/dist/objects.js";
-import { deriveDataFromStorage as N, unwrapResult as p, hasAbortError as G, getPluginData as K } from "@platforma-sdk/model";
-import { ref as D, reactive as y, computed as g } from "vue";
-import { parseQuery as X } from "../urls.js";
-import { ensureOutputHasStableFlag as Y, MultiError as Z } from "../utils.js";
-import { applyPatch as V } from "fast-json-patch";
-import { UpdateSerializer as P } from "./UpdateSerializer.js";
-import { watchIgnorable as W } from "@vueuse/core";
-const _ = 150, ee = (r) => ({
-  authorId: (r == null ? void 0 : r.authorId) ?? R(),
+import { delay as ot } from "../lib/util/helpers/dist/utils.js";
+import { uniqueId as z } from "../lib/util/helpers/dist/strings.js";
+import { deepClone as p } from "../lib/util/helpers/dist/objects.js";
+import { isPluginOutputKey as U, deriveDataFromStorage as V, unwrapResult as h, getPluginData as _, hasAbortError as at, pluginOutputPrefix as nt } from "@platforma-sdk/model";
+import { ref as E, computed as g, reactive as M } from "vue";
+import { parseQuery as rt } from "../urls.js";
+import { ensureOutputHasStableFlag as ut, MultiError as R } from "../utils.js";
+import { applyPatch as q } from "fast-json-patch";
+import { UpdateSerializer as x } from "./UpdateSerializer.js";
+import { watchIgnorable as C } from "@vueuse/core";
+const F = 150, st = (r) => ({
+  authorId: (r == null ? void 0 : r.authorId) ?? z(),
   localVersion: ((r == null ? void 0 : r.localVersion) ?? 0) + 1
-}), F = (r) => {
+}), $ = (r) => {
   try {
     return JSON.stringify(r, null, 2);
   } catch (u) {
     return u instanceof Error ? u.message : String(u);
   }
 };
-function pe(r, u, f) {
-  const n = (e, ...t) => {
-    f.debug && console.log(
-      `%c>>> %c${e}`,
+function bt(r, u, S) {
+  const n = (t, ...e) => {
+    S.debug && console.log(
+      `%c>>> %c${t}`,
       "color: orange; font-weight: bold",
       "color: orange",
-      ...t.map((a) => F(a))
+      ...e.map((o) => $(o))
     );
-  }, M = (e, ...t) => {
+  }, I = (t, ...e) => {
     console.error(
-      `%c>>> %c${e}`,
+      `%c>>> %c${t}`,
       "color: red; font-weight: bold",
       "color: red",
-      ...t.map((a) => F(a))
+      ...e.map((o) => $(o))
     );
-  }, s = {
+  }, i = {
     isExternalSnapshot: !1,
     author: {
-      authorId: R(),
+      authorId: z(),
       localVersion: 0
     }
-  }, T = () => (s.author = ee(s.author), n("nextAuthorMarker", s.author), s.author), m = D(!1), v = D(r.uTag), b = f.debounceSpan ?? 200, w = new P({ debounceSpan: b }), S = /* @__PURE__ */ new Map(), q = (e) => {
-    let t = S.get(e);
-    return t || (t = new P({ debounceSpan: b }), S.set(e, t)), t;
-  }, I = new P({ debounceSpan: b }), c = y({}), o = D(r.value), A = async (e) => u.mutateStorage({ operation: "update-block-data", value: e }, T()), k = async (e, t) => u.mutateStorage(
-    { operation: "update-plugin-data", pluginId: e, value: t },
+  }, T = () => (i.author = st(i.author), n("nextAuthorMarker", i.author), i.author), m = E(!1), w = E(r.uTag), y = S.debounceSpan ?? 200, O = new x({ debounceSpan: y }), D = /* @__PURE__ */ new Map(), H = (t) => {
+    let e = D.get(t);
+    return e || (e = new x({ debounceSpan: y }), D.set(t, e)), e;
+  }, J = new x({ debounceSpan: y }), P = /* @__PURE__ */ new Map(), a = E(r.value), j = async (t) => u.mutateStorage({ operation: "update-block-data", value: t }, T()), K = async (t, e) => u.mutateStorage(
+    { operation: "update-plugin-data", pluginId: t, value: e },
     T()
-  ), E = (e) => K(o.value.blockStorage, e), C = async (e) => u.setNavigationState(e), U = g(() => {
-    const e = Object.entries(o.value.outputs).map(
-      ([t, a]) => {
-        var l;
-        return (l = u.blockModelInfo.outputs[t]) != null && l.withStatus ? [t, Y(a)] : [
-          t,
-          a.ok && a.value !== void 0 ? a.value : void 0
+  ), L = async (t) => u.setNavigationState(t), B = g(() => {
+    const t = Object.entries(a.value.outputs).filter(([e]) => !U(e)).map(
+      ([e, o]) => {
+        var s;
+        return (s = u.blockModelInfo.outputs[e]) != null && s.withStatus ? [e, ut(o)] : [
+          e,
+          o.ok && o.value !== void 0 ? o.value : void 0
         ];
       }
     );
-    return Object.fromEntries(e);
-  }), $ = g(() => {
-    const e = Object.entries(o.value.outputs).map(
-      ([t, a]) => [
-        t,
-        a && a.ok === !1 ? new Z(a.errors) : void 0
-      ]
-    );
-    return Object.fromEntries(e);
-  }), d = y({
+    return Object.fromEntries(t);
+  }), G = g(() => {
+    const t = Object.entries(a.value.outputs).filter(([e]) => !U(e)).map(([e, o]) => [
+      e,
+      o && o.ok === !1 ? new R(o.errors) : void 0
+    ]);
+    return Object.fromEntries(t);
+  }), f = M({
     apiVersion: 3,
     error: "",
     model: {
-      data: h(N(o.value.blockStorage)),
-      outputs: U,
-      outputErrors: $
+      data: p(V(a.value.blockStorage)),
+      outputs: B,
+      outputErrors: G
     }
-  }), { ignoreUpdates: j } = W(
-    () => d.model,
-    (e) => {
-      const t = h(e);
-      n("setDataQueue appModel.model, data", t.data), w.run(() => A(t.data).then(p));
+  }), { ignoreUpdates: A } = C(
+    () => f.model,
+    (t) => {
+      const e = p(t);
+      n("setDataQueue appModel.model, data", e.data), O.run(() => j(e.data).then(h));
     },
     { deep: !0 }
-  ), z = (e) => {
-    n("updateAppModel", e), d.model.data = h(e.data);
+  ), W = (t) => {
+    n("updateAppModel", t), f.model.data = p(t.data);
   };
   (async () => {
-    var e, t;
+    var t, e;
     for (window.addEventListener("beforeunload", () => {
-      m.value = !0, u.dispose().then(p).catch((a) => {
-        M("error in dispose", a);
+      m.value = !0, u.dispose().then(h).catch((o) => {
+        I("error in dispose", o);
       });
     }); !m.value; )
       try {
-        const a = await u.getPatches(v.value).then(p);
-        if (n("patches.length", a.value.length), n("uTagRef.value", v.value), n("patches.uTag", a.uTag), n("patches.author", a.author), n("data.author", s.author), v.value = a.uTag, a.value.length === 0) {
-          await new Promise((i) => setTimeout(i, _));
+        const o = await u.getPatches(w.value).then(h);
+        if (n("patches.length", o.value.length), n("uTagRef.value", w.value), n("patches.uTag", o.uTag), n("patches.author", o.author), n("data.author", i.author), w.value = o.uTag, o.value.length === 0) {
+          await new Promise((c) => setTimeout(c, F));
           continue;
         }
-        const l = ((e = s.author) == null ? void 0 : e.authorId) !== ((t = a.author) == null ? void 0 : t.authorId);
-        l || s.isExternalSnapshot ? (n("got external changes, applying them to the snapshot", a.value), j(() => {
-          o.value = V(o.value, a.value, !1, !1).newDocument, z({ data: N(o.value.blockStorage) });
-          for (const i of Object.keys(c))
-            c[i] = E(i);
-          s.isExternalSnapshot = l;
-        })) : (n("outputs changed", a.value), j(() => {
-          o.value = V(o.value, a.value).newDocument;
-        })), await new Promise((i) => setTimeout(i, _));
-      } catch (a) {
-        G(a) ? (n("patches loop aborted"), m.value = !0) : (M("error in patches loop", a), await new Promise((l) => setTimeout(l, 1e3)));
+        const s = ((t = i.author) == null ? void 0 : t.authorId) !== ((e = o.author) == null ? void 0 : e.authorId);
+        s || i.isExternalSnapshot ? (n("got external changes, applying them to the snapshot", o.value), A(() => {
+          a.value = q(a.value, o.value, !1, !1).newDocument, W({ data: V(a.value.blockStorage) });
+          for (const [c, b] of P)
+            b.ignoreUpdates(() => {
+              b.model.data = p(
+                _(a.value.blockStorage, c)
+              );
+            });
+          i.isExternalSnapshot = s;
+        })) : (n("outputs changed", o.value), A(() => {
+          a.value = q(a.value, o.value).newDocument;
+        })), await new Promise((c) => setTimeout(c, F));
+      } catch (o) {
+        at(o) ? (n("patches loop aborted"), m.value = !0) : (I("error in patches loop", o), await new Promise((s) => setTimeout(s, 1e3)));
       }
   })();
-  const x = () => h(d.model.data), O = () => h(o.value.navigationState), H = {
-    cloneData: x,
-    cloneNavigationState: O,
+  const k = () => p(f.model.data), Q = () => p(a.value.navigationState), X = {
+    cloneData: k,
+    cloneNavigationState: Q,
     /**
      * Updates the UI state by applying a callback.
      *
@@ -118,9 +120,9 @@ function pe(r, u, f) {
      * @returns A promise resolving after the update is applied.
      * @todo Make it mutable since there is already an initial one
      */
-    updateData(e) {
-      const t = e(x());
-      return n("updateData", t), d.model.data = t, w.run(() => A(t).then(p));
+    updateData(t) {
+      const e = t(k());
+      return n("updateData", e), f.model.data = e, O.run(() => j(e).then(h));
     },
     /**
      * Navigates to a specific href by updating the navigation state.
@@ -128,42 +130,75 @@ function pe(r, u, f) {
      * @param href - The target href to navigate to.
      * @returns A promise resolving after the navigation state is updated.
      */
-    navigateTo(e) {
-      const t = O();
-      return t.href = e, I.run(() => C(t).then(p));
+    navigateTo(t) {
+      const e = Q();
+      return e.href = t, J.run(() => L(e).then(h));
     },
     async allSettled() {
-      await B(0);
-      const e = [
-        w.allSettled(),
-        ...Array.from(S.values()).map((t) => t.allSettled())
+      await ot(0);
+      const t = [
+        O.allSettled(),
+        ...Array.from(D.values()).map((e) => e.allSettled())
       ];
-      await Promise.all(e);
+      await Promise.all(t);
     }
-  }, J = {
-    pluginDataMap: c,
-    setPluginData(e, t) {
-      return c[e] = t, n("setPluginData", e, t), q(e).run(
-        () => k(e, t).then(p)
-      );
-    },
-    initPluginDataSlot(e) {
-      e in c || (c[e] = E(e));
+  }, Y = (t) => {
+    const e = nt(t), o = g(() => {
+      const l = {};
+      for (const [v, d] of Object.entries(
+        a.value.outputs
+      ))
+        v.startsWith(e) && (l[v.slice(e.length)] = d.ok && d.value !== void 0 ? d.value : void 0);
+      return l;
+    }), s = g(() => {
+      const l = {};
+      for (const [v, d] of Object.entries(
+        a.value.outputs
+      ))
+        v.startsWith(e) && (l[v.slice(e.length)] = d && d.ok === !1 ? new R(d.errors) : void 0);
+      return l;
+    }), c = M({
+      data: p(_(a.value.blockStorage, t)),
+      outputs: o,
+      outputErrors: s
+    }), { ignoreUpdates: b } = C(
+      () => c.data,
+      (l) => {
+        l !== void 0 && (n("plugin setData", t, l), H(t).run(
+          () => K(t, p(l)).then(h)
+        ));
+      },
+      { deep: !0 }
+    );
+    return {
+      model: c,
+      ignoreUpdates: b
+    };
+  }, Z = {
+    getOrCreatePluginState(t) {
+      const e = P.get(t);
+      if (e)
+        return e;
+      const o = Y(t);
+      return P.set(t, o), o;
     }
-  }, L = {
+  }, tt = Object.fromEntries(
+    u.blockModelInfo.pluginIds.map((t) => [t, t])
+  ), et = {
     closedRef: m,
-    snapshot: o,
-    queryParams: g(() => X(o.value.navigationState.href)),
-    href: g(() => o.value.navigationState.href),
+    snapshot: a,
+    plugins: tt,
+    queryParams: g(() => rt(a.value.navigationState.href)),
+    href: g(() => a.value.navigationState.href),
     hasErrors: g(
-      () => Object.values(o.value.outputs).some((e) => !(e != null && e.ok))
+      () => Object.values(a.value.outputs).some((t) => !(t != null && t.ok))
     )
-  }, Q = Object.assign(y(Object.assign(d, L)), H);
-  return f.debug && (globalThis.__block_app__ = Q), { app: Q, pluginAccess: J };
+  }, N = Object.assign(M(Object.assign(f, et)), X);
+  return S.debug && (globalThis.__block_app__ = N), { app: N, pluginAccess: Z };
 }
 export {
-  pe as createAppV3,
-  ee as createNextAuthorMarker,
-  _ as patchPoolingDelay
+  bt as createAppV3,
+  st as createNextAuthorMarker,
+  F as patchPoolingDelay
 };
 //# sourceMappingURL=createAppV3.js.map

package/dist/internal/createAppV3.js.map

@@ -1 +1 @@
-{"version":3,"file":"createAppV3.js","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} from \"@platforma-sdk/model\";\nimport {\n  hasAbortError,\n  unwrapResult,\n  deriveDataFromStorage,\n  getPluginData,\n} from \"@platforma-sdk/model\";\nimport type { Ref } from \"vue\";\nimport { reactive, computed, ref } 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\";\n\nexport const patchPoolingDelay = 150;\n\n/** Internal interface for plugin data access — injected separately from the app. */\nexport interface PluginDataAccess {\n  readonly pluginDataMap: Record<string, unknown>;\n  setPluginData(pluginId: string, value: unknown): Promise<boolean>;\n  initPluginDataSlot(pluginId: string): 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>(\n  state: ValueWithUTag<BlockStateV3<Data, Outputs, Href>>,\n  platforma: PlatformaExtended<PlatformaV3<Data, Args, Outputs, Href>>,\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<string, UpdateSerializer>();\n  const getPluginDataQueue = (pluginId: string): UpdateSerializer => {\n    let queue = pluginDataQueues.get(pluginId);\n    if (!queue) {\n      queue = new UpdateSerializer({ debounceSpan });\n      pluginDataQueues.set(pluginId, queue);\n    }\n    return queue;\n  };\n  const setNavigationStateQueue = new UpdateSerializer({ debounceSpan });\n\n  /** Reactive map of plugin data keyed by pluginId. Optimistic state for plugin components. */\n  const pluginDataMap = reactive<Record<string, unknown>>({});\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 (pluginId: string, value: unknown) => {\n    return platforma.mutateStorage(\n      { operation: \"update-plugin-data\", pluginId, value },\n      nextAuthorMarker(),\n    );\n  };\n\n  /** Derives plugin data for a given pluginId from the current snapshot. */\n  const derivePluginDataFromSnapshot = (pluginId: string): unknown => {\n    return getPluginData(snapshot.value.blockStorage, pluginId);\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>>).map(\n      ([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>>).map(\n      ([k, vOrErr]) => [\n        k,\n        vOrErr && vOrErr.ok === false ? new MultiError(vOrErr.errors) : undefined,\n      ],\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 pluginId of Object.keys(pluginDataMap)) {\n              pluginDataMap[pluginId] = derivePluginDataFromSnapshot(pluginId);\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  /** Plugin internals — provided via separate injection key, not exposed on useApp(). */\n  const pluginAccess: PluginDataAccess = {\n    pluginDataMap,\n    setPluginData(pluginId: string, value: unknown): Promise<boolean> {\n      pluginDataMap[pluginId] = value;\n      debug(\"setPluginData\", pluginId, value);\n      return getPluginDataQueue(pluginId).run(() =>\n        updatePluginData(pluginId, value).then(unwrapResult),\n      );\n    },\n    initPluginDataSlot(pluginId: string): void {\n      if (!(pluginId in pluginDataMap)) {\n        pluginDataMap[pluginId] = derivePluginDataFromSnapshot(pluginId);\n      }\n    },\n  };\n\n  const getters = {\n    closedRef,\n    snapshot,\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> = ReturnType<typeof createAppV3<Data, Args, Outputs, Href>>[\"app\"];\n"],"names":["patchPoolingDelay","createNextAuthorMarker","marker","uniqueId","stringifyForDebug","v","err","createAppV3","state","platforma","settings","debug","msg","rest","r","error","data","nextAuthorMarker","closedRef","ref","uTagRef","debounceSpan","setDataQueue","UpdateSerializer","pluginDataQueues","getPluginDataQueue","pluginId","queue","setNavigationStateQueue","pluginDataMap","reactive","snapshot","updateData","value","updatePluginData","derivePluginDataFromSnapshot","getPluginData","setNavigationState","outputs","computed","entries","k","outputWithStatus","_a","ensureOutputHasStableFlag","outputErrors","vOrErr","MultiError","appModel","deepClone","deriveDataFromStorage","ignoreUpdates","watchIgnorable","_newData","newData","unwrapResult","updateAppModel","patches","resolve","isAuthorChanged","_b","applyPatch","hasAbortError","cloneData","cloneNavigationState","methods","cb","href","newState","delay","allQueues","q","pluginAccess","getters","parseQuery","app"],"mappings":"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"}
+{"version":3,"file":"createAppV3.js","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} 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 } 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<Data = unknown, Outputs = unknown> extends PluginState<\n  Data,\n  Outputs\n> {\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>(\n  state: ValueWithUTag<BlockStateV3<Data, Outputs, Href>>,\n  platforma: PlatformaExtended<PlatformaV3<Data, Args, Outputs, Href, Plugins>>,\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      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  /** 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        result[key.slice(prefix.length)] =\n          outputWithStatus.ok && outputWithStatus.value !== undefined\n            ? outputWithStatus.value\n            : undefined;\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      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<InferFactoryData<F>, InferFactoryOutputs<F>>;\n      }\n      const state = createPluginState(handle);\n      pluginStates.set(handle, state);\n      return state;\n    },\n  };\n\n  const plugins = Object.fromEntries(\n    platforma.blockModelInfo.pluginIds.map((id) => [id, id]),\n  ) as InferPluginHandles<Plugins>;\n\n  const getters = {\n    closedRef,\n    snapshot,\n    plugins,\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> = ReturnType<typeof createAppV3<Data, Args, Outputs, Href, Plugins>>[\"app\"];\n"],"names":["patchPoolingDelay","createNextAuthorMarker","marker","uniqueId","stringifyForDebug","v","err","createAppV3","state","platforma","settings","debug","msg","rest","r","error","data","nextAuthorMarker","closedRef","ref","uTagRef","debounceSpan","setDataQueue","UpdateSerializer","pluginDataQueues","getPluginDataQueue","handle","queue","setNavigationStateQueue","pluginStates","snapshot","updateData","value","updatePluginData","setNavigationState","outputs","computed","entries","k","isPluginOutputKey","outputWithStatus","_a","ensureOutputHasStableFlag","outputErrors","vOrErr","MultiError","appModel","reactive","deepClone","deriveDataFromStorage","ignoreUpdates","watchIgnorable","_newData","newData","unwrapResult","updateAppModel","patches","resolve","isAuthorChanged","_b","applyPatch","pluginState","getPluginData","hasAbortError","cloneData","cloneNavigationState","methods","cb","href","newState","delay","allQueues","q","createPluginState","prefix","pluginOutputPrefix","pluginOutputs","result","key","pluginOutputErrors","pluginModel","pluginAccess","existing","plugins","id","getters","parseQuery","app"],"mappings":"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"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=createAppV3.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createAppV3.test.d.ts","sourceRoot":"","sources":["../../src/internal/createAppV3.test.ts"],"names":[],"mappings":""}

package/dist/lib.d.ts

@@ -19,7 +19,9 @@ export * from './components/PlAnnotations';
 export * from './components/PlBtnExportArchive';
 export * from './components/PlAdvancedFilter';
 export * from './defineApp';
-export { usePluginData } from './usePluginData';
+export { usePlugin } from './usePlugin';
+export type { PluginState } from './usePlugin';
+export type { PluginHandle, PluginFactoryLike, InferPluginHandle, InferFactoryData, InferFactoryOutputs, } from '@platforma-sdk/model';
 export * from './createModel';
 export * from './types';
 export * from './defineStore';

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,aAAa,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,cAAc,eAAe,CAAC;AAE9B,cAAc,SAAS,CAAC;AAExB,cAAc,eAAe,CAAC;AAE9B,cAAc,UAAU,CAAC;AAEzB,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,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,UAAU,CAAC;AAEzB,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/usePlugin.d.ts

@@ -0,0 +1,44 @@
+import { Reactive } from 'vue';
+import { PluginHandle, InferFactoryData, InferFactoryOutputs, PluginFactoryLike } from '@platforma-sdk/model';
+/** Per-plugin reactive model exposed to consumers via usePlugin(). */
+export interface PluginState<Data = unknown, Outputs = unknown> {
+    readonly model: Reactive<{
+        data: Data;
+        outputs: Outputs extends Record<string, unknown> ? {
+            [K in keyof Outputs]: Outputs[K] | undefined;
+        } : Record<string, unknown>;
+        outputErrors: Outputs extends Record<string, unknown> ? {
+            [K in keyof Outputs]?: Error;
+        } : Record<string, Error | undefined>;
+    }>;
+}
+/** Internal interface for plugin access — provided via Vue injection to usePlugin(). */
+export interface PluginAccess {
+    getOrCreatePluginState<F extends PluginFactoryLike>(handle: PluginHandle<F>): PluginState<InferFactoryData<F>, InferFactoryOutputs<F>>;
+}
+/**
+ * Composable for accessing a plugin's reactive model: data, outputs, and outputErrors.
+ *
+ * Mirrors the `app.model` access pattern — `plugin.model.data` is reactive and deep-watched,
+ * mutations are automatically queued and sent to storage.
+ *
+ * @param handle - Opaque plugin handle obtained from `app.plugins`.
+ * @typeParam F - The plugin factory type (inferred from the handle)
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * import { usePlugin, type InferPluginHandle } from '@platforma-sdk/ui-vue';
+ * import type { CounterPlugin } from './plugins/counter';
+ *
+ * const props = defineProps<{ instance: InferPluginHandle<CounterPlugin> }>();
+ * const plugin = usePlugin(props.instance);
+ *
+ * plugin.model.data.count += 1;          // reactive, triggers storage update
+ * plugin.model.outputs.displayText       // computed, plugin's own outputs only
+ * plugin.model.outputErrors.displayText  // Error | undefined
+ * </script>
+ * ```
+ */
+export declare function usePlugin<F extends PluginFactoryLike>(handle: PluginHandle<F>): PluginState<InferFactoryData<F>, InferFactoryOutputs<F>>;
+//# sourceMappingURL=usePlugin.d.ts.map

package/dist/usePlugin.d.ts.map

@@ -0,0 +1 @@
+{"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,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAE9B,sEAAsE;AACtE,MAAM,WAAW,WAAW,CAAC,IAAI,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAC5D,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;CACJ;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,CAAC,CAAC;CAC7D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,iBAAiB,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,4DAW7E"}

package/dist/usePlugin.js

@@ -0,0 +1,14 @@
+import { inject as t } from "vue";
+import { pluginDataKey as i } from "./defineApp.js";
+function s(r) {
+  const e = t(i);
+  if (!e)
+    throw new Error(
+      "usePlugin requires a V3 block (BlockModelV3). Make sure the block uses apiVersion 3 and the plugin is installed."
+    );
+  return e.getOrCreatePluginState(r);
+}
+export {
+  s as usePlugin
+};
+//# sourceMappingURL=usePlugin.js.map

package/dist/usePlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePlugin.js","sources":["../src/usePlugin.ts"],"sourcesContent":["import { inject, type Reactive } from \"vue\";\nimport { pluginDataKey } from \"./defineApp\";\nimport type {\n  PluginHandle,\n  InferFactoryData,\n  InferFactoryOutputs,\n  PluginFactoryLike,\n} from \"@platforma-sdk/model\";\n\n/** Per-plugin reactive model exposed to consumers via usePlugin(). */\nexport interface PluginState<Data = unknown, Outputs = unknown> {\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}\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>>;\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"],"names":["usePlugin","handle","access","inject","pluginDataKey"],"mappings":";;AAqDO,SAASA,EAAuCC,GAAyB;AAC9E,QAAMC,IAASC,EAAqBC,CAAa;AAEjD,MAAI,CAACF;AACH,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAKJ,SAAOA,EAAO,uBAA0BD,CAAM;AAChD;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platforma-sdk/ui-vue",
-  "version": "1.57.3",
+  "version": "1.58.0",
   "type": "module",
   "sideEffects": [
     "**/*.css"
@@ -28,8 +28,8 @@
     "lru-cache": "^11.2.2",
     "vue": "^3.5.24",
     "zod": "~3.23.8",
-    "@platforma-sdk/model": "1.57.2",
-    "@milaboratories/uikit": "2.10.32"
+    "@milaboratories/uikit": "2.10.33",
+    "@platforma-sdk/model": "1.58.0"
   },
   "devDependencies": {
     "@faker-js/faker": "^9.2.0",
@@ -44,10 +44,10 @@
     "typescript": "~5.6.3",
     "vite": "^6.4.1",
     "vitest": "^4.0.16",
-    "@milaboratories/helpers": "1.13.5",
-    "@milaboratories/ts-builder": "1.2.11",
+    "@milaboratories/build-configs": "1.5.0",
     "@milaboratories/ts-configs": "1.2.1",
-    "@milaboratories/build-configs": "1.5.0"
+    "@milaboratories/ts-builder": "1.2.11",
+    "@milaboratories/helpers": "1.13.5"
   },
   "scripts": {
     "dev": "ts-builder serve --target browser-lib",