@platforma-sdk/ui-vue 1.63.1 → 1.63.8

package/dist/internal/createAppV1.js.map

@@ -1 +1 @@
-{"version":3,"file":"createAppV1.js","names":[],"sources":["../../src/internal/createAppV1.ts"],"sourcesContent":["import { deepClone, isJsonEqual, tap } from \"@milaboratories/helpers\";\nimport type { Mutable } from \"@milaboratories/helpers\";\nimport type {\n  NavigationState,\n  BlockOutputsBase,\n  BlockState,\n  PlatformaV1,\n  PlatformaExtended,\n} from \"@platforma-sdk/model\";\nimport { reactive, nextTick, computed, watch } from \"vue\";\nimport type {\n  StateModelOptions,\n  UnwrapOutputs,\n  OptionalResult,\n  OutputValues,\n  OutputErrors,\n  AppSettings,\n} from \"../types\";\nimport { createModel } from \"../createModel\";\nimport { createAppModel } from \"./createAppModel\";\nimport { parseQuery } from \"../urls\";\nimport { ensureOutputHasStableFlag, MultiError, unwrapOutput } from \"../utils\";\nimport { useDebounceFn } from \"@vueuse/core\";\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 UiState - The type of the UI state.\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 createAppV1<\n  Args = unknown,\n  Outputs extends BlockOutputsBase = BlockOutputsBase,\n  UiState = unknown,\n  Href extends `/${string}` = `/${string}`,\n>(\n  state: BlockState<Args, Outputs, UiState, Href>,\n  platforma: PlatformaExtended<PlatformaV1<Args, Outputs, UiState, Href>>,\n  settings: AppSettings,\n) {\n  type AppModel = {\n    args: Args;\n    ui: UiState;\n  };\n\n  const log = (msg: string, ...rest: unknown[]) => {\n    if (settings.debug) {\n      console.log(`%c>>> %c${msg}`, \"color: orange; font-weight: bold\", \"color: orange\", ...rest);\n    }\n  };\n\n  /**\n   * Reactive snapshot of the application state, including args, outputs, UI state, and navigation state.\n   */\n  const snapshot = reactive({\n    args: Object.freeze(state.args),\n    outputs: Object.freeze(state.outputs),\n    ui: Object.freeze(state.ui),\n    navigationState: Object.freeze(state.navigationState) as NavigationState<Href>,\n  }) as {\n    args: Readonly<Args>;\n    outputs: Partial<Readonly<Outputs>>;\n    ui: Readonly<UiState>;\n    navigationState: Readonly<NavigationState<Href>>;\n  };\n\n  const debounceSpan = settings.debounceSpan ?? 200;\n\n  const maxWait = tap(settings.debounceMaxWait ?? 0, (v) =>\n    v < 20_000 ? 20_000 : v < debounceSpan ? debounceSpan * 100 : v,\n  );\n\n  const setBlockArgs = useDebounceFn(\n    (args: Args) => {\n      if (!isJsonEqual(args, snapshot.args)) {\n        platforma.setBlockArgs(args);\n      }\n    },\n    debounceSpan,\n    { maxWait },\n  );\n\n  const setBlockUiState = useDebounceFn(\n    (ui: UiState) => {\n      if (!isJsonEqual(ui, snapshot.ui)) {\n        platforma.setBlockUiState(ui);\n      }\n    },\n    debounceSpan,\n    { maxWait },\n  );\n\n  const setBlockArgsAndUiState = useDebounceFn(\n    (args: Args, ui: UiState) => {\n      if (!isJsonEqual(args, snapshot.args) || !isJsonEqual(ui, snapshot.ui)) {\n        platforma.setBlockArgsAndUiState(args, ui);\n      }\n    },\n    debounceSpan,\n    { maxWait },\n  );\n\n  (platforma as PlatformaV1<Args, Outputs, UiState, Href>).onStateUpdates(async (updates) => {\n    updates.forEach((patch) => {\n      if (patch.key === \"args\" && !isJsonEqual(snapshot.args, patch.value)) {\n        snapshot.args = Object.freeze(patch.value);\n        log(\"args patch\", snapshot.args);\n      }\n\n      if (patch.key === \"ui\" && !isJsonEqual(snapshot.ui, patch.value)) {\n        snapshot.ui = Object.freeze(patch.value);\n        log(\"ui patch\", snapshot.ui);\n      }\n\n      if (patch.key === \"outputs\" && !isJsonEqual(snapshot.outputs, patch.value)) {\n        snapshot.outputs = Object.freeze(patch.value);\n        log(\"outputs patch\", snapshot.outputs);\n      }\n\n      if (patch.key === \"navigationState\" && !isJsonEqual(snapshot.navigationState, patch.value)) {\n        snapshot.navigationState = Object.freeze(patch.value);\n        log(\"navigationState patch\", snapshot.navigationState);\n      }\n    });\n\n    await nextTick();\n  });\n\n  const cloneArgs = () => deepClone(snapshot.args) as Args;\n  const cloneUiState = () => deepClone(snapshot.ui) as UiState;\n  const cloneNavigationState = () =>\n    deepClone(snapshot.navigationState) as Mutable<NavigationState<Href>>;\n\n  const methods = {\n    createArgsModel<T = Args>(options: StateModelOptions<Args, T> = {}) {\n      return createModel<T, Args>({\n        get() {\n          if (options.transform) {\n            return options.transform(snapshot.args);\n          }\n\n          return snapshot.args as T;\n        },\n        validate: options.validate,\n        autoSave: true,\n        onSave(newArgs) {\n          setBlockArgs(newArgs);\n        },\n      });\n    },\n    /**\n     * defaultUiState is temporarily here, remove it after implementing initialUiState\n     */\n    createUiModel<T = UiState>(\n      options: StateModelOptions<UiState, T> = {},\n      defaultUiState: () => UiState,\n    ) {\n      return createModel<T, UiState>({\n        get() {\n          if (options.transform) {\n            return options.transform(snapshot.ui);\n          }\n\n          return (snapshot.ui ?? defaultUiState()) as T;\n        },\n        validate: options.validate,\n        autoSave: true,\n        onSave(newData) {\n          setBlockUiState(newData);\n        },\n      });\n    },\n    /**\n     * Note: Don't forget to list the output names, like: useOutputs('output1', 'output2', ...etc)\n     * @param keys - List of output names\n     * @returns {OptionalResult<UnwrapOutputs<Outputs, K>>}\n     */\n    useOutputs<K extends keyof Outputs>(...keys: K[]): OptionalResult<UnwrapOutputs<Outputs, K>> {\n      const data = reactive({\n        errors: undefined,\n        value: undefined,\n      });\n\n      watch(\n        () => snapshot.outputs,\n        () => {\n          try {\n            Object.assign(data, {\n              value: this.unwrapOutputs<K>(...keys),\n              errors: undefined,\n            });\n          } catch (error) {\n            Object.assign(data, {\n              value: undefined,\n              errors: [String(error)],\n            });\n          }\n        },\n        { immediate: true, deep: true },\n      );\n\n      return data as OptionalResult<UnwrapOutputs<Outputs, K>>;\n    },\n    /**\n     * Retrieves the unwrapped values of outputs for the given keys.\n     *\n     * @template K - Keys of the outputs to unwrap.\n     * @param keys - List of output names.\n     * @throws Error if the outputs contain errors.\n     * @returns An object with unwrapped output values.\n     */\n    unwrapOutputs<K extends keyof Outputs>(...keys: K[]): UnwrapOutputs<Outputs, K> {\n      const outputs = snapshot.outputs;\n      const entries = keys.map((key) => [key, unwrapOutput(outputs[key])]);\n      return Object.fromEntries(entries);\n    },\n    /**\n     * Updates the arguments state by applying a callback.\n     *\n     * @param cb - Callback to modify the current arguments.\n     * @returns A promise resolving after the update is applied.\n     */\n    updateArgs(cb: (args: Args) => void) {\n      const newArgs = cloneArgs();\n      cb(newArgs);\n      return platforma.setBlockArgs(newArgs);\n    },\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    updateUiState(cb: (args: UiState) => UiState): Promise<void> {\n      const newUiState = cloneUiState();\n      return platforma.setBlockUiState(cb(newUiState));\n    },\n    /**\n     * Updates the navigation state by applying a callback.\n     *\n     * @param cb - Callback to modify the current navigation state.\n     * @returns A promise resolving after the update is applied.\n     */\n    updateNavigationState(cb: (args: Mutable<NavigationState<Href>>) => void) {\n      const newState = cloneNavigationState();\n      cb(newState);\n      return platforma.setNavigationState(newState);\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 platforma.setNavigationState(newState);\n    },\n  };\n\n  const outputs = computed<OutputValues<Outputs>>(() => {\n    const entries = Object.entries(snapshot.outputs).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.outputs).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 getters = {\n    snapshot,\n    queryParams: computed(() => parseQuery<Href>(snapshot.navigationState.href)),\n    href: computed(() => snapshot.navigationState.href),\n    hasErrors: computed(() => Object.values(snapshot.outputs).some((v) => !v?.ok)),\n  };\n\n  const model = createAppModel(\n    {\n      get() {\n        return { args: snapshot.args, ui: snapshot.ui } as AppModel;\n      },\n      autoSave: true,\n      onSave(newData: AppModel) {\n        setBlockArgsAndUiState(newData.args, newData.ui);\n      },\n    },\n    {\n      outputs,\n      outputErrors,\n    },\n    settings,\n  );\n\n  return reactive(Object.assign(model, methods, getters));\n}\n\nexport type BaseAppV1<\n  Args = unknown,\n  Outputs extends BlockOutputsBase = BlockOutputsBase,\n  UiState = unknown,\n  Href extends `/${string}` = `/${string}`,\n> = ReturnType<typeof createAppV1<Args, Outputs, UiState, Href>>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAAgB,EAMd,GACA,GACA,GACA;CAMA,IAAM,KAAO,GAAa,GAAG,MAAoB;AAC/C,EAAI,EAAS,SACX,QAAQ,IAAI,WAAW,KAAO,oCAAoC,iBAAiB,GAAG,EAAK;IAOzF,IAAW,EAAS;EACxB,MAAM,OAAO,OAAO,EAAM,KAAK;EAC/B,SAAS,OAAO,OAAO,EAAM,QAAQ;EACrC,IAAI,OAAO,OAAO,EAAM,GAAG;EAC3B,iBAAiB,OAAO,OAAO,EAAM,gBAAgB;EACtD,CAAC,EAOI,IAAe,EAAS,gBAAgB,KAExC,IAAU,EAAI,EAAS,mBAAmB,IAAI,MAClD,IAAI,MAAS,MAAS,IAAI,IAAe,IAAe,MAAM,EAC/D,EAEK,IAAe,GAClB,MAAe;AACd,EAAK,EAAY,GAAM,EAAS,KAAK,IACnC,EAAU,aAAa,EAAK;IAGhC,GACA,EAAE,YAAS,CACZ,EAEK,IAAkB,GACrB,MAAgB;AACf,EAAK,EAAY,GAAI,EAAS,GAAG,IAC/B,EAAU,gBAAgB,EAAG;IAGjC,GACA,EAAE,YAAS,CACZ,EAEK,IAAyB,GAC5B,GAAY,MAAgB;AAC3B,GAAI,CAAC,EAAY,GAAM,EAAS,KAAK,IAAI,CAAC,EAAY,GAAI,EAAS,GAAG,KACpE,EAAU,uBAAuB,GAAM,EAAG;IAG9C,GACA,EAAE,YAAS,CACZ;AAEA,GAAwD,eAAe,OAAO,MAAY;AAuBzF,EAtBA,EAAQ,SAAS,MAAU;AAgBzB,GAfI,EAAM,QAAQ,UAAU,CAAC,EAAY,EAAS,MAAM,EAAM,MAAM,KAClE,EAAS,OAAO,OAAO,OAAO,EAAM,MAAM,EAC1C,EAAI,cAAc,EAAS,KAAK,GAG9B,EAAM,QAAQ,QAAQ,CAAC,EAAY,EAAS,IAAI,EAAM,MAAM,KAC9D,EAAS,KAAK,OAAO,OAAO,EAAM,MAAM,EACxC,EAAI,YAAY,EAAS,GAAG,GAG1B,EAAM,QAAQ,aAAa,CAAC,EAAY,EAAS,SAAS,EAAM,MAAM,KACxE,EAAS,UAAU,OAAO,OAAO,EAAM,MAAM,EAC7C,EAAI,iBAAiB,EAAS,QAAQ,GAGpC,EAAM,QAAQ,qBAAqB,CAAC,EAAY,EAAS,iBAAiB,EAAM,MAAM,KACxF,EAAS,kBAAkB,OAAO,OAAO,EAAM,MAAM,EACrD,EAAI,yBAAyB,EAAS,gBAAgB;IAExD,EAEF,MAAM,GAAU;GAChB;CAEF,IAAM,UAAkB,EAAU,EAAS,KAAK,EAC1C,UAAqB,EAAU,EAAS,GAAG,EAC3C,UACJ,EAAU,EAAS,gBAAgB,EAE/B,IAAU;EACd,gBAA0B,IAAsC,EAAE,EAAE;AAClE,UAAO,EAAqB;IAC1B,MAAM;AAKJ,YAJI,EAAQ,YACH,EAAQ,UAAU,EAAS,KAAK,GAGlC,EAAS;;IAElB,UAAU,EAAQ;IAClB,UAAU;IACV,OAAO,GAAS;AACd,OAAa,EAAQ;;IAExB,CAAC;;EAKJ,cACE,IAAyC,EAAE,EAC3C,GACA;AACA,UAAO,EAAwB;IAC7B,MAAM;AAKJ,YAJI,EAAQ,YACH,EAAQ,UAAU,EAAS,GAAG,GAG/B,EAAS,MAAM,GAAgB;;IAEzC,UAAU,EAAQ;IAClB,UAAU;IACV,OAAO,GAAS;AACd,OAAgB,EAAQ;;IAE3B,CAAC;;EAOJ,WAAoC,GAAG,GAAsD;GAC3F,IAAM,IAAO,EAAS;IACpB,QAAQ,KAAA;IACR,OAAO,KAAA;IACR,CAAC;AAoBF,UAlBA,QACQ,EAAS,eACT;AACJ,QAAI;AACF,YAAO,OAAO,GAAM;MAClB,OAAO,KAAK,cAAiB,GAAG,EAAK;MACrC,QAAQ,KAAA;MACT,CAAC;aACK,GAAO;AACd,YAAO,OAAO,GAAM;MAClB,OAAO,KAAA;MACP,QAAQ,CAAC,OAAO,EAAM,CAAC;MACxB,CAAC;;MAGN;IAAE,WAAW;IAAM,MAAM;IAAM,CAChC,EAEM;;EAUT,cAAuC,GAAG,GAAsC;GAC9E,IAAM,IAAU,EAAS,SACnB,IAAU,EAAK,KAAK,MAAQ,CAAC,GAAK,EAAa,EAAQ,GAAK,CAAC,CAAC;AACpE,UAAO,OAAO,YAAY,EAAQ;;EAQpC,WAAW,GAA0B;GACnC,IAAM,IAAU,GAAW;AAE3B,UADA,EAAG,EAAQ,EACJ,EAAU,aAAa,EAAQ;;EASxC,cAAc,GAA+C;GAC3D,IAAM,IAAa,GAAc;AACjC,UAAO,EAAU,gBAAgB,EAAG,EAAW,CAAC;;EAQlD,sBAAsB,GAAoD;GACxE,IAAM,IAAW,GAAsB;AAEvC,UADA,EAAG,EAAS,EACL,EAAU,mBAAmB,EAAS;;EAQ/C,WAAW,GAAY;GACrB,IAAM,IAAW,GAAsB;AAEvC,UADA,EAAS,OAAO,GACT,EAAU,mBAAmB,EAAS;;EAEhD,EAEK,IAAU,QAAsC;EACpD,IAAM,IAAU,OAAO,QAAQ,EAAS,QAAQ,CAAC,KAAK,CAAC,GAAG,OACxD,EAAU,eAAe,QAAQ,GAAG,aAChC,CAAC,GAAG,EAA0B,EAAiB,CAAC,GAChD,CACE,GACA,EAAiB,MAAM,EAAiB,UAAU,KAAA,IAC9C,EAAiB,QACjB,KAAA,EACL,CACN;AACD,SAAO,OAAO,YAAY,EAAQ;GAClC,EAEI,IAAe,QAAsC;EACzD,IAAM,IAAU,OAAO,QAAQ,EAAS,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAY,CACpE,GACA,KAAU,EAAO,OAAO,KAAQ,IAAI,EAAW,EAAO,OAAO,GAAG,KAAA,EACjE,CAAC;AACF,SAAO,OAAO,YAAY,EAAQ;GAClC,EAEI,IAAU;EACd;EACA,aAAa,QAAe,EAAiB,EAAS,gBAAgB,KAAK,CAAC;EAC5E,MAAM,QAAe,EAAS,gBAAgB,KAAK;EACnD,WAAW,QAAe,OAAO,OAAO,EAAS,QAAQ,CAAC,MAAM,MAAM,CAAC,GAAG,GAAG,CAAC;EAC/E,EAEK,IAAQ,EACZ;EACE,MAAM;AACJ,UAAO;IAAE,MAAM,EAAS;IAAM,IAAI,EAAS;IAAI;;EAEjD,UAAU;EACV,OAAO,GAAmB;AACxB,KAAuB,EAAQ,MAAM,EAAQ,GAAG;;EAEnD,EACD;EACE;EACA;EACD,EACD,EACD;AAED,QAAO,EAAS,OAAO,OAAO,GAAO,GAAS,EAAQ,CAAC"}
+{"version":3,"file":"createAppV1.js","names":[],"sources":["../../src/internal/createAppV1.ts"],"sourcesContent":["import { deepClone, isJsonEqual, tap } from \"@milaboratories/helpers\";\nimport type { Mutable } from \"@milaboratories/helpers\";\nimport type {\n  NavigationState,\n  BlockOutputsBase,\n  BlockState,\n  PlatformaV1,\n  PlatformaExtended,\n} from \"@platforma-sdk/model\";\nimport { reactive, nextTick, computed, watch } from \"vue\";\nimport type {\n  StateModelOptions,\n  UnwrapOutputs,\n  OptionalResult,\n  OutputValues,\n  OutputErrors,\n  AppSettings,\n} from \"../types\";\nimport { createModel } from \"../createModel\";\nimport { createAppModel } from \"./createAppModel\";\nimport { parseQuery } from \"../urls\";\nimport { ensureOutputHasStableFlag, MultiError, unwrapOutput } from \"../utils\";\nimport { useDebounceFn } from \"@vueuse/core\";\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 UiState - The type of the UI state.\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 createAppV1<\n  Args = unknown,\n  Outputs extends BlockOutputsBase = BlockOutputsBase,\n  UiState = unknown,\n  Href extends `/${string}` = `/${string}`,\n>(\n  state: BlockState<Args, Outputs, UiState, Href>,\n  platforma: PlatformaExtended<PlatformaV1<Args, Outputs, UiState, Href>>,\n  settings: AppSettings,\n) {\n  type AppModel = {\n    args: Args;\n    ui: UiState;\n  };\n\n  const log = (msg: string, ...rest: unknown[]) => {\n    if (settings.debug) {\n      console.log(`%c>>> %c${msg}`, \"color: orange; font-weight: bold\", \"color: orange\", ...rest);\n    }\n  };\n\n  /**\n   * Reactive snapshot of the application state, including args, outputs, UI state, and navigation state.\n   */\n  const snapshot = reactive({\n    args: Object.freeze(state.args),\n    outputs: Object.freeze(state.outputs),\n    ui: Object.freeze(state.ui),\n    navigationState: Object.freeze(state.navigationState) as NavigationState<Href>,\n  }) as {\n    args: Readonly<Args>;\n    outputs: Partial<Readonly<Outputs>>;\n    ui: Readonly<UiState>;\n    navigationState: Readonly<NavigationState<Href>>;\n  };\n\n  const debounceSpan = settings.debounceSpan ?? 200;\n\n  const maxWait = tap(settings.debounceMaxWait ?? 0, (v) =>\n    v < 20_000 ? 20_000 : v < debounceSpan ? debounceSpan * 100 : v,\n  );\n\n  const setBlockArgs = useDebounceFn(\n    (args: Args) => {\n      if (!isJsonEqual(args, snapshot.args)) {\n        platforma.setBlockArgs(args);\n      }\n    },\n    debounceSpan,\n    { maxWait },\n  );\n\n  const setBlockUiState = useDebounceFn(\n    (ui: UiState) => {\n      if (!isJsonEqual(ui, snapshot.ui)) {\n        platforma.setBlockUiState(ui);\n      }\n    },\n    debounceSpan,\n    { maxWait },\n  );\n\n  const setBlockArgsAndUiState = useDebounceFn(\n    (args: Args, ui: UiState) => {\n      if (!isJsonEqual(args, snapshot.args) || !isJsonEqual(ui, snapshot.ui)) {\n        platforma.setBlockArgsAndUiState(args, ui);\n      }\n    },\n    debounceSpan,\n    { maxWait },\n  );\n\n  (platforma as PlatformaV1<Args, Outputs, UiState, Href>).onStateUpdates(async (updates) => {\n    updates.forEach((patch) => {\n      if (patch.key === \"args\" && !isJsonEqual(snapshot.args, patch.value)) {\n        snapshot.args = Object.freeze(patch.value);\n        log(\"args patch\", snapshot.args);\n      }\n\n      if (patch.key === \"ui\" && !isJsonEqual(snapshot.ui, patch.value)) {\n        snapshot.ui = Object.freeze(patch.value);\n        log(\"ui patch\", snapshot.ui);\n      }\n\n      if (patch.key === \"outputs\" && !isJsonEqual(snapshot.outputs, patch.value)) {\n        snapshot.outputs = Object.freeze(patch.value);\n        log(\"outputs patch\", snapshot.outputs);\n      }\n\n      if (patch.key === \"navigationState\" && !isJsonEqual(snapshot.navigationState, patch.value)) {\n        snapshot.navigationState = Object.freeze(patch.value);\n        log(\"navigationState patch\", snapshot.navigationState);\n      }\n    });\n\n    await nextTick();\n  });\n\n  const cloneArgs = () => deepClone(snapshot.args) as Args;\n  const cloneUiState = () => deepClone(snapshot.ui) as UiState;\n  const cloneNavigationState = () =>\n    deepClone(snapshot.navigationState) as Mutable<NavigationState<Href>>;\n\n  const methods = {\n    createArgsModel<T = Args>(options: StateModelOptions<Args, T> = {}) {\n      return createModel<T, Args>({\n        get() {\n          if (options.transform) {\n            return options.transform(snapshot.args);\n          }\n\n          return snapshot.args as T;\n        },\n        validate: options.validate,\n        autoSave: true,\n        onSave(newArgs) {\n          setBlockArgs(newArgs);\n        },\n      });\n    },\n    /**\n     * defaultUiState is temporarily here, remove it after implementing initialUiState\n     */\n    createUiModel<T = UiState>(\n      options: StateModelOptions<UiState, T> = {},\n      defaultUiState: () => UiState,\n    ) {\n      return createModel<T, UiState>({\n        get() {\n          if (options.transform) {\n            return options.transform(snapshot.ui);\n          }\n\n          return (snapshot.ui ?? defaultUiState()) as T;\n        },\n        validate: options.validate,\n        autoSave: true,\n        onSave(newData) {\n          setBlockUiState(newData);\n        },\n      });\n    },\n    /**\n     * Note: Don't forget to list the output names, like: useOutputs('output1', 'output2', ...etc)\n     * @param keys - List of output names\n     * @returns {OptionalResult<UnwrapOutputs<Outputs, K>>}\n     */\n    useOutputs<K extends keyof Outputs>(...keys: K[]): OptionalResult<UnwrapOutputs<Outputs, K>> {\n      const data = reactive({\n        errors: undefined,\n        value: undefined,\n      });\n\n      watch(\n        () => snapshot.outputs,\n        () => {\n          try {\n            Object.assign(data, {\n              value: this.unwrapOutputs<K>(...keys),\n              errors: undefined,\n            });\n          } catch (error) {\n            Object.assign(data, {\n              value: undefined,\n              errors: [String(error)],\n            });\n          }\n        },\n        { immediate: true, deep: true },\n      );\n\n      return data as OptionalResult<UnwrapOutputs<Outputs, K>>;\n    },\n    /**\n     * Retrieves the unwrapped values of outputs for the given keys.\n     *\n     * @template K - Keys of the outputs to unwrap.\n     * @param keys - List of output names.\n     * @throws Error if the outputs contain errors.\n     * @returns An object with unwrapped output values.\n     */\n    unwrapOutputs<K extends keyof Outputs>(...keys: K[]): UnwrapOutputs<Outputs, K> {\n      const outputs = snapshot.outputs;\n      const entries = keys.map((key) => [key, unwrapOutput(outputs[key])]);\n      return Object.fromEntries(entries);\n    },\n    /**\n     * Updates the arguments state by applying a callback.\n     *\n     * @param cb - Callback to modify the current arguments.\n     * @returns A promise resolving after the update is applied.\n     */\n    updateArgs(cb: (args: Args) => void) {\n      const newArgs = cloneArgs();\n      cb(newArgs);\n      return platforma.setBlockArgs(newArgs);\n    },\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    updateUiState(cb: (args: UiState) => UiState): Promise<void> {\n      const newUiState = cloneUiState();\n      return platforma.setBlockUiState(cb(newUiState));\n    },\n    /**\n     * Updates the navigation state by applying a callback.\n     *\n     * @param cb - Callback to modify the current navigation state.\n     * @returns A promise resolving after the update is applied.\n     */\n    updateNavigationState(cb: (args: Mutable<NavigationState<Href>>) => void) {\n      const newState = cloneNavigationState();\n      cb(newState);\n      return platforma.setNavigationState(newState);\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 platforma.setNavigationState(newState);\n    },\n  };\n\n  const outputs = computed<OutputValues<Outputs>>(() => {\n    const entries = Object.entries(snapshot.outputs).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.outputs).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 getters = {\n    snapshot,\n    queryParams: computed(() => parseQuery<Href>(snapshot.navigationState.href)),\n    href: computed(() => snapshot.navigationState.href),\n    hasErrors: computed(() => Object.values(snapshot.outputs).some((v) => !v?.ok)),\n  };\n\n  const model = createAppModel(\n    {\n      get() {\n        return { args: snapshot.args, ui: snapshot.ui } as AppModel;\n      },\n      autoSave: true,\n      onSave(newData: AppModel) {\n        setBlockArgsAndUiState(newData.args, newData.ui);\n      },\n    },\n    {\n      outputs,\n      outputErrors,\n    },\n    settings,\n  );\n\n  return reactive(Object.assign(model, methods, getters));\n}\n\nexport type BaseAppV1<\n  Args = unknown,\n  Outputs extends BlockOutputsBase = BlockOutputsBase,\n  UiState = unknown,\n  Href extends `/${string}` = `/${string}`,\n> = ReturnType<typeof createAppV1<Args, Outputs, UiState, Href>>;\n"],"mappings":"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"}

package/dist/internal/createAppV2.js

@@ -10,31 +10,16 @@ import { computed as l, reactive as u, ref as d } from "vue";
 import { hasAbortError as f, unwrapResult as p } from "@platforma-sdk/model";
 import { watchIgnorable as m } from "@vueuse/core";
 import { applyPatch as h } from "fast-json-patch";
-const g = (e) => ({
+var g = (e) => ({
 	authorId: e?.authorId ?? t(),
 	localVersion: (e?.localVersion ?? 0) + 1
-});
-var _ = (e) => {
+}), _ = (e) => {
 	try {
 		return JSON.stringify(e, null, 2);
 	} catch (e) {
 		return e instanceof Error ? e.message : String(e);
 	}
 };
-/**
-* Creates an application instance with reactive state management, outputs, and methods for state updates and navigation.
-*
-* @template Args - The type of arguments used in the application.
-* @template Outputs - The type of block outputs extending `BlockOutputsBase`.
-* @template UiState - The type of the UI state.
-* @template Href - The type of navigation href, defaulting to a string starting with `/`.
-*
-* @param state - Initial state of the application, including args, outputs, UI state, and navigation state.
-* @param platforma - A platform interface for interacting with block states.
-* @param settings - Application settings, such as debug flags.
-*
-* @returns A reactive application object with methods, getters, and state.
-*/
 function v(v, y, b) {
 	let x = (e, ...t) => {
 		b.debug && console.log(`%c>>> %c${e}`, "color: orange; font-weight: bold", "color: orange", ...t.map((e) => _(e)));
@@ -146,6 +131,7 @@ function v(v, y, b) {
 	}, q = u(Object.assign(z, G, K));
 	return b.debug && (globalThis.__block_app__ = q), q;
 }
+//#endregion
 export { v as createAppV2 };
 
 //# sourceMappingURL=createAppV2.js.map

package/dist/internal/createAppV2.js.map

@@ -1 +1 @@
-{"version":3,"file":"createAppV2.js","names":[],"sources":["../../src/internal/createAppV2.ts"],"sourcesContent":["import { deepClone, delay, uniqueId } from \"@milaboratories/helpers\";\nimport type { Mutable } from \"@milaboratories/helpers\";\nimport type {\n  NavigationState,\n  BlockOutputsBase,\n  BlockState,\n  PlatformaV2,\n  ValueWithUTag,\n  AuthorMarker,\n  PlatformaExtended,\n} from \"@platforma-sdk/model\";\nimport { hasAbortError, unwrapResult } from \"@platforma-sdk/model\";\nimport type { Ref } from \"vue\";\nimport { reactive, computed, ref } from \"vue\";\nimport type {\n  StateModelOptions,\n  UnwrapOutputs,\n  OutputValues,\n  OutputErrors,\n  AppSettings,\n} from \"../types\";\nimport { createModel } from \"../createModel\";\nimport { parseQuery } from \"../urls\";\nimport { ensureOutputHasStableFlag, MultiError, unwrapOutput } from \"../utils\";\nimport { applyPatch } from \"fast-json-patch\";\nimport { UpdateSerializer } from \"./UpdateSerializer\";\nimport { watchIgnorable } from \"@vueuse/core\";\n\nexport const patchPoolingDelay = 150;\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 UiState - The type of the UI state.\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 createAppV2<\n  Args = unknown,\n  Outputs extends BlockOutputsBase = BlockOutputsBase,\n  UiState = unknown,\n  Href extends `/${string}` = `/${string}`,\n>(\n  state: ValueWithUTag<BlockState<Args, Outputs, UiState, Href>>,\n  platforma: PlatformaExtended<PlatformaV2<Args, Outputs, UiState, 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 setArgsQueue = new UpdateSerializer({ debounceSpan });\n  const setUiStateQueue = new UpdateSerializer({ debounceSpan });\n  const setArgsAndUiStateQueue = new UpdateSerializer({ debounceSpan });\n  const setNavigationStateQueue = new UpdateSerializer({ debounceSpan });\n\n  /**\n   * Reactive snapshot of the application state, including args, outputs, UI state, and navigation state.\n   */\n  const snapshot = ref<{\n    args: Args;\n    outputs: Partial<Outputs>;\n    ui: UiState;\n    navigationState: NavigationState<Href>;\n  }>(state.value) as Ref<{\n    args: Args;\n    outputs: Partial<Outputs>;\n    ui: UiState;\n    navigationState: NavigationState<Href>;\n  }>;\n\n  const setBlockArgs = async (args: Args) => {\n    return platforma.setBlockArgs(args, nextAuthorMarker());\n  };\n\n  const setBlockUiState = async (ui: UiState) => {\n    return platforma.setBlockUiState(ui, nextAuthorMarker());\n  };\n\n  const setBlockArgsAndUiState = async (args: Args, ui: UiState) => {\n    return platforma.setBlockArgsAndUiState(args, ui, nextAuthorMarker());\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    error: \"\",\n    model: {\n      args: deepClone(snapshot.value.args) as Args,\n      ui: deepClone(snapshot.value.ui) as UiState,\n      outputs,\n      outputErrors,\n    },\n  }) as {\n    error: string;\n    model: {\n      args: Args;\n      ui: UiState;\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(\"setArgsAndUiStateQueue appModel.model, args\", newData.args, \"ui\", newData.ui);\n      setArgsAndUiStateQueue.run(() =>\n        setBlockArgsAndUiState(newData.args, newData.ui).then(unwrapResult),\n      );\n    },\n    { deep: true },\n  );\n\n  const updateAppModel = (newData: { args: Args; ui: UiState }) => {\n    debug(\"updateAppModel\", newData);\n    appModel.model.args = deepClone(newData.args) as Args;\n    appModel.model.ui = deepClone(newData.ui) as UiState;\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({ args: snapshot.value.args, ui: snapshot.value.ui });\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 cloneArgs = () => deepClone(appModel.model.args) as Args;\n  const cloneUiState = () => deepClone(appModel.model.ui) as UiState;\n  const cloneNavigationState = () =>\n    deepClone(snapshot.value.navigationState) as Mutable<NavigationState<Href>>;\n\n  const methods = {\n    cloneArgs,\n    cloneUiState,\n    cloneNavigationState,\n    createArgsModel<T extends Args = Args>(options: StateModelOptions<Args, T> = {}) {\n      return createModel<T, Args>({\n        get() {\n          if (options.transform) {\n            return options.transform(snapshot.value.args as Args);\n          }\n\n          return snapshot.value.args as T;\n        },\n        validate: options.validate,\n        autoSave: true,\n        onSave(newArgs) {\n          setArgsQueue.run(() => setBlockArgs(newArgs).then(unwrapResult));\n        },\n      });\n    },\n    /**\n     * defaultUiState is temporarily here, remove it after implementing initialUiState\n     */\n    createUiModel<T extends UiState = UiState>(\n      options: StateModelOptions<UiState, T> = {},\n      defaultUiState: () => UiState,\n    ) {\n      return createModel<T, UiState>({\n        get() {\n          if (options.transform) {\n            return options.transform(snapshot.value.ui as UiState);\n          }\n\n          return (snapshot.value.ui ?? defaultUiState()) as T;\n        },\n        validate: options.validate,\n        autoSave: true,\n        onSave(newData) {\n          setUiStateQueue.run(() => setBlockUiState(newData).then(unwrapResult));\n        },\n      });\n    },\n    /**\n     * Retrieves the unwrapped values of outputs for the given keys.\n     *\n     * @template K - Keys of the outputs to unwrap.\n     * @param keys - List of output names.\n     * @throws Error if the outputs contain errors.\n     * @returns An object with unwrapped output values.\n     */\n    unwrapOutputs<K extends keyof Outputs>(...keys: K[]): UnwrapOutputs<Outputs, K> {\n      const outputs = snapshot.value.outputs as Partial<Readonly<Outputs>>;\n      const entries = keys.map((key) => [key, unwrapOutput(outputs[key])]);\n      return Object.fromEntries(entries);\n    },\n    /**\n     * Updates the arguments state by applying a callback.\n     *\n     * @param cb - Callback to modify the current arguments.\n     * @returns A promise resolving after the update is applied.\n     */\n    updateArgs(cb: (args: Args) => void): Promise<boolean> {\n      const newArgs = cloneArgs();\n      cb(newArgs);\n      debug(\"updateArgs\", newArgs);\n      appModel.model.args = newArgs;\n      return setArgsQueue.run(() => setBlockArgs(newArgs).then(unwrapResult));\n    },\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    updateUiState(cb: (args: UiState) => UiState): Promise<boolean> {\n      const newUiState = cb(cloneUiState());\n      debug(\"updateUiState\", newUiState);\n      appModel.model.ui = newUiState;\n      return setUiStateQueue.run(() => setBlockUiState(newUiState).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      return setArgsAndUiStateQueue.allSettled();\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 = reactive(Object.assign(appModel, methods, getters));\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;\n}\n\nexport type BaseAppV2<\n  Args = unknown,\n  Outputs extends BlockOutputsBase = BlockOutputsBase,\n  UiState = unknown,\n  Href extends `/${string}` = `/${string}`,\n> = ReturnType<typeof createAppV2<Args, Outputs, UiState, Href>>;\n"],"mappings":"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"}
+{"version":3,"file":"createAppV2.js","names":[],"sources":["../../src/internal/createAppV2.ts"],"sourcesContent":["import { deepClone, delay, uniqueId } from \"@milaboratories/helpers\";\nimport type { Mutable } from \"@milaboratories/helpers\";\nimport type {\n  NavigationState,\n  BlockOutputsBase,\n  BlockState,\n  PlatformaV2,\n  ValueWithUTag,\n  AuthorMarker,\n  PlatformaExtended,\n} from \"@platforma-sdk/model\";\nimport { hasAbortError, unwrapResult } from \"@platforma-sdk/model\";\nimport type { Ref } from \"vue\";\nimport { reactive, computed, ref } from \"vue\";\nimport type {\n  StateModelOptions,\n  UnwrapOutputs,\n  OutputValues,\n  OutputErrors,\n  AppSettings,\n} from \"../types\";\nimport { createModel } from \"../createModel\";\nimport { parseQuery } from \"../urls\";\nimport { ensureOutputHasStableFlag, MultiError, unwrapOutput } from \"../utils\";\nimport { applyPatch } from \"fast-json-patch\";\nimport { UpdateSerializer } from \"./UpdateSerializer\";\nimport { watchIgnorable } from \"@vueuse/core\";\n\nexport const patchPoolingDelay = 150;\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 UiState - The type of the UI state.\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 createAppV2<\n  Args = unknown,\n  Outputs extends BlockOutputsBase = BlockOutputsBase,\n  UiState = unknown,\n  Href extends `/${string}` = `/${string}`,\n>(\n  state: ValueWithUTag<BlockState<Args, Outputs, UiState, Href>>,\n  platforma: PlatformaExtended<PlatformaV2<Args, Outputs, UiState, 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 setArgsQueue = new UpdateSerializer({ debounceSpan });\n  const setUiStateQueue = new UpdateSerializer({ debounceSpan });\n  const setArgsAndUiStateQueue = new UpdateSerializer({ debounceSpan });\n  const setNavigationStateQueue = new UpdateSerializer({ debounceSpan });\n\n  /**\n   * Reactive snapshot of the application state, including args, outputs, UI state, and navigation state.\n   */\n  const snapshot = ref<{\n    args: Args;\n    outputs: Partial<Outputs>;\n    ui: UiState;\n    navigationState: NavigationState<Href>;\n  }>(state.value) as Ref<{\n    args: Args;\n    outputs: Partial<Outputs>;\n    ui: UiState;\n    navigationState: NavigationState<Href>;\n  }>;\n\n  const setBlockArgs = async (args: Args) => {\n    return platforma.setBlockArgs(args, nextAuthorMarker());\n  };\n\n  const setBlockUiState = async (ui: UiState) => {\n    return platforma.setBlockUiState(ui, nextAuthorMarker());\n  };\n\n  const setBlockArgsAndUiState = async (args: Args, ui: UiState) => {\n    return platforma.setBlockArgsAndUiState(args, ui, nextAuthorMarker());\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    error: \"\",\n    model: {\n      args: deepClone(snapshot.value.args) as Args,\n      ui: deepClone(snapshot.value.ui) as UiState,\n      outputs,\n      outputErrors,\n    },\n  }) as {\n    error: string;\n    model: {\n      args: Args;\n      ui: UiState;\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(\"setArgsAndUiStateQueue appModel.model, args\", newData.args, \"ui\", newData.ui);\n      setArgsAndUiStateQueue.run(() =>\n        setBlockArgsAndUiState(newData.args, newData.ui).then(unwrapResult),\n      );\n    },\n    { deep: true },\n  );\n\n  const updateAppModel = (newData: { args: Args; ui: UiState }) => {\n    debug(\"updateAppModel\", newData);\n    appModel.model.args = deepClone(newData.args) as Args;\n    appModel.model.ui = deepClone(newData.ui) as UiState;\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({ args: snapshot.value.args, ui: snapshot.value.ui });\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 cloneArgs = () => deepClone(appModel.model.args) as Args;\n  const cloneUiState = () => deepClone(appModel.model.ui) as UiState;\n  const cloneNavigationState = () =>\n    deepClone(snapshot.value.navigationState) as Mutable<NavigationState<Href>>;\n\n  const methods = {\n    cloneArgs,\n    cloneUiState,\n    cloneNavigationState,\n    createArgsModel<T extends Args = Args>(options: StateModelOptions<Args, T> = {}) {\n      return createModel<T, Args>({\n        get() {\n          if (options.transform) {\n            return options.transform(snapshot.value.args as Args);\n          }\n\n          return snapshot.value.args as T;\n        },\n        validate: options.validate,\n        autoSave: true,\n        onSave(newArgs) {\n          setArgsQueue.run(() => setBlockArgs(newArgs).then(unwrapResult));\n        },\n      });\n    },\n    /**\n     * defaultUiState is temporarily here, remove it after implementing initialUiState\n     */\n    createUiModel<T extends UiState = UiState>(\n      options: StateModelOptions<UiState, T> = {},\n      defaultUiState: () => UiState,\n    ) {\n      return createModel<T, UiState>({\n        get() {\n          if (options.transform) {\n            return options.transform(snapshot.value.ui as UiState);\n          }\n\n          return (snapshot.value.ui ?? defaultUiState()) as T;\n        },\n        validate: options.validate,\n        autoSave: true,\n        onSave(newData) {\n          setUiStateQueue.run(() => setBlockUiState(newData).then(unwrapResult));\n        },\n      });\n    },\n    /**\n     * Retrieves the unwrapped values of outputs for the given keys.\n     *\n     * @template K - Keys of the outputs to unwrap.\n     * @param keys - List of output names.\n     * @throws Error if the outputs contain errors.\n     * @returns An object with unwrapped output values.\n     */\n    unwrapOutputs<K extends keyof Outputs>(...keys: K[]): UnwrapOutputs<Outputs, K> {\n      const outputs = snapshot.value.outputs as Partial<Readonly<Outputs>>;\n      const entries = keys.map((key) => [key, unwrapOutput(outputs[key])]);\n      return Object.fromEntries(entries);\n    },\n    /**\n     * Updates the arguments state by applying a callback.\n     *\n     * @param cb - Callback to modify the current arguments.\n     * @returns A promise resolving after the update is applied.\n     */\n    updateArgs(cb: (args: Args) => void): Promise<boolean> {\n      const newArgs = cloneArgs();\n      cb(newArgs);\n      debug(\"updateArgs\", newArgs);\n      appModel.model.args = newArgs;\n      return setArgsQueue.run(() => setBlockArgs(newArgs).then(unwrapResult));\n    },\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    updateUiState(cb: (args: UiState) => UiState): Promise<boolean> {\n      const newUiState = cb(cloneUiState());\n      debug(\"updateUiState\", newUiState);\n      appModel.model.ui = newUiState;\n      return setUiStateQueue.run(() => setBlockUiState(newUiState).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      return setArgsAndUiStateQueue.allSettled();\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 = reactive(Object.assign(appModel, methods, getters));\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;\n}\n\nexport type BaseAppV2<\n  Args = unknown,\n  Outputs extends BlockOutputsBase = BlockOutputsBase,\n  UiState = unknown,\n  Href extends `/${string}` = `/${string}`,\n> = ReturnType<typeof createAppV2<Args, Outputs, UiState, Href>>;\n"],"mappings":"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"}

package/dist/internal/createAppV3.js

@@ -10,31 +10,16 @@ import { computed as c, markRaw as l, reactive as u, ref as d } from "vue";
 import { buildServices as f, createNodeServiceProxy as p, deriveDataFromStorage as m, getPluginData as h, hasAbortError as g, isPluginOutputKey as _, pluginOutputPrefix as v, unwrapResult as y } from "@platforma-sdk/model";
 import { watchIgnorable as b } from "@vueuse/core";
 import { applyPatch as x } from "fast-json-patch";
-const S = (e) => ({
+var S = (e) => ({
 	authorId: e?.authorId ?? t(),
 	localVersion: (e?.localVersion ?? 0) + 1
-});
-var C = (e) => {
+}), C = (e) => {
 	try {
 		return JSON.stringify(e, null, 2);
 	} catch (e) {
 		return e instanceof Error ? e.message : String(e);
 	}
 };
-/**
-* Creates an application instance with reactive state management, outputs, and methods for state updates and navigation.
-*
-* @template Args - The type of arguments used in the application.
-* @template Outputs - The type of block outputs extending `BlockOutputsBase`.
-* @template Data - The type of the block data.
-* @template Href - The type of navigation href, defaulting to a string starting with `/`.
-*
-* @param state - Initial state of the application, including args, outputs, UI state, and navigation state.
-* @param platforma - A platform interface for interacting with block states.
-* @param settings - Application settings, such as debug flags.
-*
-* @returns A reactive application object with methods, getters, and state.
-*/
 function w(w, T, E) {
 	let D = (e, ...t) => {
 		E.debug && console.log(`%c>>> %c${e}`, "color: orange; font-weight: bold", "color: orange", ...t.map((e) => C(e)));
@@ -161,6 +146,7 @@ function w(w, T, E) {
 		pluginAccess: te
 	};
 }
+//#endregion
 export { w as createAppV3 };
 
 //# sourceMappingURL=createAppV3.js.map

package/dist/internal/createAppV3.js.map

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

package/dist/internal/service_factories.js

@@ -1,19 +1,13 @@
 import { Services as e, UiServiceRegistry as t } from "@milaboratories/pl-model-common";
 import { SpecDriver as n } from "@milaboratories/pf-spec-driver";
-/**
-* UI service factories — add a factory for each new service here.
-*
-* Each entry maps a Services key to a factory function that creates the
-* UI-side driver instance:
-* - WASM services: instantiated directly (e.g. SpecDriver)
-* - Node services: proxied via IPC using NodeServiceProxy
-*/
+//#region src/internal/service_factories.ts
 function r(r) {
 	return new t(e, {
 		PFrameSpec: () => new n(),
 		PFrame: () => r.proxy(e.PFrame)
 	});
 }
+//#endregion
 export { r as createUiServiceRegistry };
 
 //# sourceMappingURL=service_factories.js.map

package/dist/internal/service_factories.js.map

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

package/dist/lib/util/helpers/dist/functions.js

@@ -1,9 +1,8 @@
-/**
-* A utility to add a timeout to a promise, rejecting the promise if the timeout is exceeded.
-*/
+//#region ../../lib/util/helpers/dist/functions.js
 function e(e, t) {
 	return Promise.race([e, new Promise((e, n) => setTimeout(() => n(Error(`Timeout exceeded ${t}`)), t))]);
 }
+//#endregion
 export { e as promiseTimeout };
 
 //# sourceMappingURL=functions.js.map

package/dist/lib/util/helpers/dist/functions.js.map

@@ -1 +1 @@
-{"version":3,"file":"functions.js","names":[],"sources":["../../../../../../../lib/util/helpers/src/functions.ts"],"sourcesContent":["import type { AnyFunction } from \"./types\";\n\nexport function isFunction(value: unknown): value is AnyFunction {\n  return typeof value === \"function\";\n}\n\n/**\n * A utility class that ensures asynchronous locks, allowing only one task to proceed at a time.\n */\nexport class AwaitLock {\n  private acquired = false;\n  private resolvers: (() => void)[] = [];\n\n  acquireAsync(): Promise<void> {\n    if (!this.acquired) {\n      this.acquired = true;\n      return Promise.resolve();\n    }\n\n    return new Promise((resolve) => {\n      this.resolvers.push(resolve);\n    });\n  }\n\n  release(): void {\n    if (!this.acquired) {\n      throw new Error(\"Cannot release not acquired lock\");\n    }\n\n    if (this.resolvers.length) {\n      this.resolvers.shift()?.();\n    } else {\n      this.acquired = false;\n    }\n  }\n}\n\n/**\n * A utility to add a timeout to a promise, rejecting the promise if the timeout is exceeded.\n */\nexport function promiseTimeout<T>(prom: PromiseLike<T>, ms: number): Promise<T> {\n  return Promise.race<T>([\n    prom,\n    new Promise((_r, reject) => setTimeout(() => reject(Error(`Timeout exceeded ${ms}`)), ms)),\n  ]);\n}\n\n/**\n * Debounce utility: delays the execution of a function until a certain time has passed since the last call.\n * @param callback\n * @param ms\n * @param immediate (if first call is required)\n * @returns\n */\nexport function debounce<F extends AnyFunction>(\n  callback: F,\n  ms: number,\n  immediate?: boolean,\n): (...args: Parameters<F>) => void {\n  let timeout: ReturnType<typeof setTimeout> | undefined;\n  return function (this: unknown, ...args: Parameters<F>) {\n    const i = immediate && !timeout;\n    if (i) {\n      callback.apply(this, args);\n    }\n    if (timeout) {\n      clearTimeout(timeout);\n    }\n    timeout = setTimeout(() => {\n      timeout = undefined;\n      if (!i) {\n        callback.apply(this, args);\n      }\n    }, ms);\n  };\n}\n\n/**\n * Throttle utility: ensures a function is called at most once every `ms` milliseconds.\n * @param callback\n * @param ms milliseconds\n * @param trailing (ensure last call)\n * @returns\n */\nexport function throttle<F extends AnyFunction>(\n  callback: F,\n  ms: number,\n  trailing = true,\n): (...args: Parameters<F>) => void {\n  let t = 0,\n    call: AnyFunction | null;\n  return function (this: unknown, ...args: Parameters<F>) {\n    call = () => {\n      callback.apply(this, args);\n      t = new Date().getTime() + ms;\n      call = null;\n      if (trailing) {\n        setTimeout(() => {\n          call?.();\n        }, ms);\n      }\n    };\n    if (new Date().getTime() > t) call();\n  };\n}\n\n/**\n * Memoization utility: caches results of function calls based on their arguments to avoid redundant calculations.\n */\nexport const memoize = <F extends AnyFunction>(fn: F) => {\n  const cache = new Map();\n  return function (...args: Parameters<F>): ReturnType<F> {\n    const key = JSON.stringify(args);\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return cache.has(key)\n      ? cache.get(key)\n      : cache.set(key, fn.call(null, ...args)) && cache.get(key);\n  };\n};\n\n/**\n * Function wrapper utility: executes a function before the main function is called.\n */\nexport const wrapFunction = <T extends unknown[], U>(fn: (...args: T) => U, before: () => void) => {\n  return (...args: T): U => {\n    before();\n    return fn(...args);\n  };\n};\n\n/**\n * Function piping utility: allows chaining of functions by passing the result of one as input to another\n */\nexport function pipe<A, B>(cb: (a: A) => B) {\n  const fn = (a: A) => cb(a);\n\n  fn.pipe = <C>(next: (b: B) => C) => pipe((a: A) => next(cb(a)));\n\n  return fn;\n}\n\n/**\n * Ensures that only one request can be processed at a time.\n */\nexport function exclusiveRequest<A, R>(request: (...args: A[]) => Promise<R>) {\n  let counter = 0n;\n  let ongoingOperation: Promise<R> | undefined;\n\n  return async function (...params: A[]): Promise<\n    | {\n        ok: false;\n      }\n    | {\n        ok: true;\n        value: R;\n      }\n  > {\n    const myId = ++counter;\n\n    try {\n      await ongoingOperation;\n    } catch {\n      // ignoring the error here, original caller will receive any rejections\n    }\n\n    // checking that this update is still the most recent\n    if (counter !== myId) {\n      return {\n        ok: false,\n      };\n    }\n\n    const promise = request(...params);\n\n    ongoingOperation = promise;\n\n    const value = await promise;\n\n    return {\n      ok: true,\n      value,\n    };\n  };\n}\n\nexport function tryDo<R1>(fn: () => R1): R1 | undefined;\nexport function tryDo<R1, R2>(fn: () => R1, fallback: (cause: unknown) => R2): R1 | R2;\nexport function tryDo(fn: () => unknown, fallback?: (cause: unknown) => unknown) {\n  try {\n    return fn();\n  } catch (cause: unknown) {\n    return fallback?.(cause);\n  }\n}\n"],"mappings":";;;AAwCA,SAAgB,EAAkB,GAAsB,GAAwB;AAC9E,QAAO,QAAQ,KAAQ,CACrB,GACA,IAAI,SAAS,GAAI,MAAW,iBAAiB,EAAO,MAAM,oBAAoB,IAAK,CAAC,EAAE,EAAG,CAAC,CAC3F,CAAC"}
+{"version":3,"file":"functions.js","names":[],"sources":["../../../../../../../lib/util/helpers/src/functions.ts"],"sourcesContent":["import type { AnyFunction } from \"./types\";\n\nexport function isFunction(value: unknown): value is AnyFunction {\n  return typeof value === \"function\";\n}\n\n/**\n * A utility class that ensures asynchronous locks, allowing only one task to proceed at a time.\n */\nexport class AwaitLock {\n  private acquired = false;\n  private resolvers: (() => void)[] = [];\n\n  acquireAsync(): Promise<void> {\n    if (!this.acquired) {\n      this.acquired = true;\n      return Promise.resolve();\n    }\n\n    return new Promise((resolve) => {\n      this.resolvers.push(resolve);\n    });\n  }\n\n  release(): void {\n    if (!this.acquired) {\n      throw new Error(\"Cannot release not acquired lock\");\n    }\n\n    if (this.resolvers.length) {\n      this.resolvers.shift()?.();\n    } else {\n      this.acquired = false;\n    }\n  }\n}\n\n/**\n * A utility to add a timeout to a promise, rejecting the promise if the timeout is exceeded.\n */\nexport function promiseTimeout<T>(prom: PromiseLike<T>, ms: number): Promise<T> {\n  return Promise.race<T>([\n    prom,\n    new Promise((_r, reject) => setTimeout(() => reject(Error(`Timeout exceeded ${ms}`)), ms)),\n  ]);\n}\n\n/**\n * Debounce utility: delays the execution of a function until a certain time has passed since the last call.\n * @param callback\n * @param ms\n * @param immediate (if first call is required)\n * @returns\n */\nexport function debounce<F extends AnyFunction>(\n  callback: F,\n  ms: number,\n  immediate?: boolean,\n): (...args: Parameters<F>) => void {\n  let timeout: ReturnType<typeof setTimeout> | undefined;\n  return function (this: unknown, ...args: Parameters<F>) {\n    const i = immediate && !timeout;\n    if (i) {\n      callback.apply(this, args);\n    }\n    if (timeout) {\n      clearTimeout(timeout);\n    }\n    timeout = setTimeout(() => {\n      timeout = undefined;\n      if (!i) {\n        callback.apply(this, args);\n      }\n    }, ms);\n  };\n}\n\n/**\n * Throttle utility: ensures a function is called at most once every `ms` milliseconds.\n * @param callback\n * @param ms milliseconds\n * @param trailing (ensure last call)\n * @returns\n */\nexport function throttle<F extends AnyFunction>(\n  callback: F,\n  ms: number,\n  trailing = true,\n): (...args: Parameters<F>) => void {\n  let t = 0,\n    call: AnyFunction | null;\n  return function (this: unknown, ...args: Parameters<F>) {\n    call = () => {\n      callback.apply(this, args);\n      t = new Date().getTime() + ms;\n      call = null;\n      if (trailing) {\n        setTimeout(() => {\n          call?.();\n        }, ms);\n      }\n    };\n    if (new Date().getTime() > t) call();\n  };\n}\n\n/**\n * Memoization utility: caches results of function calls based on their arguments to avoid redundant calculations.\n */\nexport const memoize = <F extends AnyFunction>(fn: F) => {\n  const cache = new Map();\n  return function (...args: Parameters<F>): ReturnType<F> {\n    const key = JSON.stringify(args);\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return cache.has(key)\n      ? cache.get(key)\n      : cache.set(key, fn.call(null, ...args)) && cache.get(key);\n  };\n};\n\n/**\n * Function wrapper utility: executes a function before the main function is called.\n */\nexport const wrapFunction = <T extends unknown[], U>(fn: (...args: T) => U, before: () => void) => {\n  return (...args: T): U => {\n    before();\n    return fn(...args);\n  };\n};\n\n/**\n * Function piping utility: allows chaining of functions by passing the result of one as input to another\n */\nexport function pipe<A, B>(cb: (a: A) => B) {\n  const fn = (a: A) => cb(a);\n\n  fn.pipe = <C>(next: (b: B) => C) => pipe((a: A) => next(cb(a)));\n\n  return fn;\n}\n\n/**\n * Ensures that only one request can be processed at a time.\n */\nexport function exclusiveRequest<A, R>(request: (...args: A[]) => Promise<R>) {\n  let counter = 0n;\n  let ongoingOperation: Promise<R> | undefined;\n\n  return async function (...params: A[]): Promise<\n    | {\n        ok: false;\n      }\n    | {\n        ok: true;\n        value: R;\n      }\n  > {\n    const myId = ++counter;\n\n    try {\n      await ongoingOperation;\n    } catch {\n      // ignoring the error here, original caller will receive any rejections\n    }\n\n    // checking that this update is still the most recent\n    if (counter !== myId) {\n      return {\n        ok: false,\n      };\n    }\n\n    const promise = request(...params);\n\n    ongoingOperation = promise;\n\n    const value = await promise;\n\n    return {\n      ok: true,\n      value,\n    };\n  };\n}\n\nexport function tryDo<R1>(fn: () => R1): R1 | undefined;\nexport function tryDo<R1, R2>(fn: () => R1, fallback: (cause: unknown) => R2): R1 | R2;\nexport function tryDo(fn: () => unknown, fallback?: (cause: unknown) => unknown) {\n  try {\n    return fn();\n  } catch (cause: unknown) {\n    return fallback?.(cause);\n  }\n}\n"],"mappings":";AAwCA,SAAgB,EAAkB,GAAsB,GAAwB;AAC9E,QAAO,QAAQ,KAAQ,CACrB,GACA,IAAI,SAAS,GAAI,MAAW,iBAAiB,EAAO,MAAM,oBAAoB,IAAK,CAAC,EAAE,EAAG,CAAC,CAC3F,CAAC"}

package/dist/lib/util/helpers/dist/hash.js

@@ -1,5 +1,5 @@
-import "./utils.js";
 import { createGetIncrementalId as e } from "./uniqId.js";
 e();
+//#endregion
 
 //# sourceMappingURL=hash.js.map

package/dist/lib/util/helpers/dist/hash.js.map

@@ -1 +1 @@
-{"version":3,"file":"hash.js","names":[],"sources":["../../../../../../../lib/util/helpers/src/hash.ts"],"sourcesContent":["import { createGetIncrementalId } from \"./uniqId\";\nimport { isPrimitive } from \"./utils\";\n\nexport function hashString(str: string, seed = 0): number {\n  let h1 = 0xdeadbeef ^ seed,\n    h2 = 0x41c6ce57 ^ seed;\n\n  for (let i = 0, ch; i < str.length; i++) {\n    ch = str.charCodeAt(i);\n    h1 = Math.imul(h1 ^ ch, 2654435761);\n    h2 = Math.imul(h2 ^ ch, 1597334677);\n  }\n  h1 = Math.imul(h1 ^ (h1 >>> 16), 2246822507) ^ Math.imul(h2 ^ (h2 >>> 13), 3266489909);\n  h2 = Math.imul(h2 ^ (h2 >>> 16), 2246822507) ^ Math.imul(h1 ^ (h1 >>> 13), 3266489909);\n\n  return 4294967296 * (2097151 & h2) + (h1 >>> 0);\n}\n\nexport function shallowHash(...values: unknown[]): number {\n  let str = \"\";\n\n  for (let i = 0; i < values.length; i += 1) {\n    const value = values[i];\n\n    if (isPrimitive(value)) {\n      str += \"/\" + String(value);\n    } else {\n      str += \"/\" + getIdForPointer(value as object);\n    }\n  }\n\n  return hashString(str);\n}\n\nconst mapPointerToMap = new WeakMap<object, string>();\nconst getIncrementalId = createGetIncrementalId();\n\nfunction getIdForPointer(obj: object): string {\n  if (!mapPointerToMap.has(obj)) {\n    mapPointerToMap.set(obj, getIncrementalId().toString());\n  }\n\n  return mapPointerToMap.get(obj)!;\n}\n"],"mappings":";;AAmCyB,GAAwB"}
+{"version":3,"file":"hash.js","names":[],"sources":["../../../../../../../lib/util/helpers/src/hash.ts"],"sourcesContent":["import { createGetIncrementalId } from \"./uniqId\";\nimport { isPrimitive } from \"./utils\";\n\nexport function hashString(str: string, seed = 0): number {\n  let h1 = 0xdeadbeef ^ seed,\n    h2 = 0x41c6ce57 ^ seed;\n\n  for (let i = 0, ch; i < str.length; i++) {\n    ch = str.charCodeAt(i);\n    h1 = Math.imul(h1 ^ ch, 2654435761);\n    h2 = Math.imul(h2 ^ ch, 1597334677);\n  }\n  h1 = Math.imul(h1 ^ (h1 >>> 16), 2246822507) ^ Math.imul(h2 ^ (h2 >>> 13), 3266489909);\n  h2 = Math.imul(h2 ^ (h2 >>> 16), 2246822507) ^ Math.imul(h1 ^ (h1 >>> 13), 3266489909);\n\n  return 4294967296 * (2097151 & h2) + (h1 >>> 0);\n}\n\nexport function shallowHash(...values: unknown[]): number {\n  let str = \"\";\n\n  for (let i = 0; i < values.length; i += 1) {\n    const value = values[i];\n\n    if (isPrimitive(value)) {\n      str += \"/\" + String(value);\n    } else {\n      str += \"/\" + getIdForPointer(value as object);\n    }\n  }\n\n  return hashString(str);\n}\n\nconst mapPointerToMap = new WeakMap<object, string>();\nconst getIncrementalId = createGetIncrementalId();\n\nfunction getIdForPointer(obj: object): string {\n  if (!mapPointerToMap.has(obj)) {\n    mapPointerToMap.set(obj, getIncrementalId().toString());\n  }\n\n  return mapPointerToMap.get(obj)!;\n}\n"],"mappings":";AAmCyB,GAAwB"}

package/dist/lib/util/helpers/dist/index.js

@@ -7,5 +7,3 @@ import "./error.js";
 import "./uniqId.js";
 import "./hash.js";
 import "./random.js";
-import "./disposable.js";
-import "./ref_count_pool.js";

package/dist/lib/util/helpers/dist/objects.js

@@ -1,7 +1,4 @@
-import "./utils.js";
-/**
-* Alias to Array.isArray
-*/
+//#region ../../lib/util/helpers/dist/objects.js
 var e = Array.isArray;
 function t(e) {
 	return typeof e == "object" && !!e;
@@ -9,25 +6,6 @@ function t(e) {
 function n(e) {
 	return typeof e == "object" && !!e;
 }
-/**
-* Checks if the given value is a plain object.
-*
-* A plain object is defined as an object created by the `{}` literal,
-* an object created with `Object.create(null)`, or an object with a
-* prototype that resolves to `Object.prototype`.
-*
-* @param value - The value to check.
-* @returns `true` if the value is a plain object, otherwise `false`.
-*
-* @example
-* ```typescript
-* isPlainObject({}); // true
-* isPlainObject(Object.create(null)); // true
-* isPlainObject(new Date()); // false
-* isPlainObject(null); // false
-* isPlainObject([]); // false
-* ```
-*/
 function r(e) {
 	if (!n(e)) return !1;
 	let t = Object.getPrototypeOf(e);
@@ -36,28 +14,6 @@ function r(e) {
 function i(e) {
 	return Object.values(e).reduce((e, t) => t === void 0 ? e : e + 1, 0);
 }
-/**
-* Performs a deep equality check between two values, `a` and `b`, to determine if they are JSON-equivalent.
-*
-* JSON equivalence means that the two values are strictly equal in structure and content, including arrays and plain objects.
-* Non-primitive values that are neither arrays nor plain objects will throw an error.
-*
-* @param a - The first value to compare.
-* @param b - The second value to compare.
-* @returns `true` if the values are JSON-equivalent, otherwise `false`.
-*
-* @throws If the values are non-primitive and not arrays or plain objects.
-*
-* @example
-* ```typescript
-* isJsonEqual(1, 1); // true
-* isJsonEqual({ a: 1 }, { a: 1 }); // true
-* isJsonEqual([1, 2], [1, 2]); // true
-* isJsonEqual({ a: 1 }, { a: 2 }); // false
-* isJsonEqual([1, 2], [2, 1]); // false
-* isJsonEqual(new Date(), new Date()); // Error
-* ```
-*/
 function a(n, o) {
 	if (!(t(n) && t(o))) return n === o;
 	if (e(n) && e(o)) return n.length === o.length ? [...n.keys()].every((e) => a(n[e], o[e])) : !1;
@@ -76,6 +32,7 @@ function o(e) {
 		}), t;
 	} else return e;
 }
+//#endregion
 export { o as deepClone, e as isArray, a as isJsonEqual, t as isNonPrimitive, n as isObject, r as isPlainObject };
 
 //# sourceMappingURL=objects.js.map

package/dist/lib/util/helpers/dist/objects.js.map

@@ -1 +1 @@
-{"version":3,"file":"objects.js","names":[],"sources":["../../../../../../../lib/util/helpers/src/objects.ts"],"sourcesContent":["/**/\n\nimport type { PartialBy, PlainObject } from \"./types\";\nimport { isNil } from \"./utils\";\n\n/**\n * Alias to Array.isArray\n */\nexport const isArray = Array.isArray;\n\n//\nexport function isNonPrimitive<V, T extends PlainObject<V> | V[]>(obj: T | unknown): obj is T {\n  return obj !== null && typeof obj === \"object\";\n}\n\nexport function isObject(value: unknown): value is object {\n  return typeof value === \"object\" && value !== null;\n}\n\n/**\n * Checks if the given value is a plain object.\n *\n * A plain object is defined as an object created by the `{}` literal,\n * an object created with `Object.create(null)`, or an object with a\n * prototype that resolves to `Object.prototype`.\n *\n * @param value - The value to check.\n * @returns `true` if the value is a plain object, otherwise `false`.\n *\n * @example\n * ```typescript\n * isPlainObject({}); // true\n * isPlainObject(Object.create(null)); // true\n * isPlainObject(new Date()); // false\n * isPlainObject(null); // false\n * isPlainObject([]); // false\n * ```\n */\nexport function isPlainObject(value: unknown): value is PlainObject {\n  if (!isObject(value)) {\n    return false;\n  }\n\n  const prototype: unknown = Object.getPrototypeOf(value);\n\n  return (\n    prototype === null ||\n    prototype === Object.prototype ||\n    Object.getPrototypeOf(prototype) === null\n  );\n}\n\nexport function map<U, T extends Record<string, unknown>>(\n  obj: T,\n  callback: (curr: T[keyof T], key: keyof T) => U,\n) {\n  const keys = Object.keys(obj) as Array<keyof T>;\n\n  return keys.map((key: keyof T) => {\n    return callback(obj[key], key);\n  });\n}\n\nfunction definedKeysSize(obj: PlainObject) {\n  return Object.values(obj).reduce((length: number, v) => {\n    return v !== undefined ? length + 1 : length;\n  }, 0);\n}\n\n/**\n * Performs a deep equality check between two values, `a` and `b`, to determine if they are JSON-equivalent.\n *\n * JSON equivalence means that the two values are strictly equal in structure and content, including arrays and plain objects.\n * Non-primitive values that are neither arrays nor plain objects will throw an error.\n *\n * @param a - The first value to compare.\n * @param b - The second value to compare.\n * @returns `true` if the values are JSON-equivalent, otherwise `false`.\n *\n * @throws If the values are non-primitive and not arrays or plain objects.\n *\n * @example\n * ```typescript\n * isJsonEqual(1, 1); // true\n * isJsonEqual({ a: 1 }, { a: 1 }); // true\n * isJsonEqual([1, 2], [1, 2]); // true\n * isJsonEqual({ a: 1 }, { a: 2 }); // false\n * isJsonEqual([1, 2], [2, 1]); // false\n * isJsonEqual(new Date(), new Date()); // Error\n * ```\n */\nexport function isJsonEqual(a: unknown, b: unknown): boolean {\n  if (!(isNonPrimitive(a) && isNonPrimitive(b))) {\n    return a === b;\n  }\n\n  if (isArray(a) && isArray(b)) {\n    if (a.length !== b.length) {\n      return false;\n    } else {\n      return [...a.keys()].every((k) => isJsonEqual(a[k], b[k]));\n    }\n  }\n\n  if (isPlainObject(a) && isPlainObject(b)) {\n    if (definedKeysSize(a) !== definedKeysSize(b)) {\n      return false;\n    }\n\n    return Object.keys(a).every((k) => isJsonEqual(a[k], b[k]));\n  }\n\n  throw Error(`Cannot compare a ${String(a)} and b ${String(b)}`);\n}\n\n/**\n * Alias to isJsonEqual function\n * @deprecated change to isJsonEqual\n */\nexport const deepEqual = isJsonEqual;\n\nexport function deepClone<T>(obj: T): T {\n  if (Array.isArray(obj)) {\n    const copy: any[] = [];\n    for (let i = 0; i < obj.length; i++) {\n      copy[i] = deepClone(obj[i]) as unknown;\n    }\n    return copy as T;\n  } else if (isPlainObject(obj)) {\n    const copy: Record<string, any> = {};\n    Object.keys(obj).forEach((k) => {\n      copy[k] = deepClone(obj[k]);\n    });\n    return copy as T;\n  } else {\n    return obj;\n  }\n}\n\nexport function shallowClone<T>(obj: T): T {\n  if (isNil(obj)) return obj;\n  if (Array.isArray(obj)) return obj.slice() as T;\n  if (isPlainObject(obj)) return Object.assign({}, obj) as T;\n  if (obj instanceof Map) return new Map(obj) as T;\n  if (obj instanceof Set) return new Set(obj) as T;\n  throw Error(`Not implemented clone strategy for ${JSON.stringify(obj)}`);\n}\n\nexport function shallowDiff<T>(to: T, from: T): Partial<T> {\n  const diff: Partial<T> = {};\n\n  for (const key in from) {\n    if (from[key] !== to[key]) {\n      diff[key] = to[key];\n    }\n  }\n\n  return diff;\n}\n\nexport function bindMethods<O extends Record<string, unknown>>(obj: O) {\n  Object.entries(obj).forEach(([key, m]) => {\n    if (m instanceof Function) {\n      //\n      obj[key as keyof O] = m.bind(obj);\n    }\n  });\n\n  return obj;\n}\n\nexport function setProp<O, K extends keyof O>(obj: O, key: K, value: O[K]) {\n  obj[key] = value;\n  return obj;\n}\n\nexport function getProp<O, K extends keyof O>(obj: O, key: K): O[K] {\n  return obj[key];\n}\n\nexport function shiftProp<O, K extends keyof O>(obj: O, key: K): [O[K], Omit<O, K>] {\n  obj = { ...obj };\n  const val = obj[key];\n  delete obj[key];\n  return [val, obj];\n}\n\nexport function pick<T, K extends keyof T>(obj: T, ...keys: K[]): Pick<T, K> {\n  return Object.assign({}, ...keys.map((k) => ({ [k]: obj[k] }))) as Pick<T, K>;\n}\n\nexport function pickValues<T, K extends keyof T>(obj: T, ...keys: K[]) {\n  return keys.map((k) => obj[k]);\n}\n\nexport function omit<T, K extends keyof T>(obj: T, ...keys: K[]): Omit<T, K> {\n  const o = Object.assign({}, obj) as PartialBy<T, K>;\n  keys.forEach((k) => delete o[k]);\n  return o;\n}\n\n/**\n * Performs a deep patch of the target object or array using the source object or array.\n *\n * This function recursively merges properties of the source into the target:\n * - If a property in both target and source is a plain object, they are recursively merged.\n * - If a property in both target and source is an array of the same length, the arrays are recursively patched element by element.\n * - Otherwise, the property value in the target is replaced by the corresponding value from the source.\n *\n * The patch is applied in-place to the target object or array, which is also returned for convenience.\n *\n * @typeParam T - The type of the target and source, which must be either a plain object or an array.\n * @param target - The target object or array to be patched. This object/array is modified in-place.\n * @param source - The source object or array providing the new values for the patch.\n * @returns The modified target object or array.\n *\n * @example\n * ```typescript\n * const target = { a: { b: 1 }, c: [1, 2] };\n * const source = { a: { b: 2 }, c: [3, 4], d: 5 };\n * const result = deepPatch(target, source);\n * // target is now: { a: { b: 2 }, c: [3, 4], d: 5 }\n * // result is the same reference as target.\n *\n * const targetArray = [{ a: 1 }, { b: 2 }];\n * const sourceArray = [{ a: 2 }, { b: 3 }];\n * const resultArray = deepPatch(targetArray, sourceArray);\n * // targetArray is now: [{ a: 2 }, { b: 3 }]\n * ```\n */\nexport function deepPatch<T extends PlainObject | unknown[]>(target: T, source: T) {\n  const sk = new Set<keyof T>([\n    ...(Object.keys(target) as (keyof T)[]),\n    ...(Object.keys(source) as (keyof T)[]),\n  ]);\n\n  sk.forEach((key) => {\n    const t = target[key];\n    const s = source[key];\n    if (isPlainObject(t) && isPlainObject(s)) {\n      deepPatch(t, s);\n    } else if (isArray(t) && isArray(s) && t.length === s.length) {\n      deepPatch(t, s);\n    } else {\n      target[key] = s;\n    }\n  });\n\n  return target;\n}\n"],"mappings":";;;;AAQA,IAAa,IAAU,MAAM;AAG7B,SAAgB,EAAkD,GAA4B;AAC5F,QAAuB,OAAO,KAAQ,cAA/B;;AAGT,SAAgB,EAAS,GAAiC;AACxD,QAAO,OAAO,KAAU,cAAY;;;;;;;;;;;;;;;;;;;;;AAsBtC,SAAgB,EAAc,GAAsC;AAClE,KAAI,CAAC,EAAS,EAAM,CAClB,QAAO;CAGT,IAAM,IAAqB,OAAO,eAAe,EAAM;AAEvD,QACE,MAAc,QACd,MAAc,OAAO,aACrB,OAAO,eAAe,EAAU,KAAK;;AAezC,SAAS,EAAgB,GAAkB;AACzC,QAAO,OAAO,OAAO,EAAI,CAAC,QAAQ,GAAgB,MACzC,MAAM,KAAA,IAAyB,IAAb,IAAS,GACjC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;AAyBP,SAAgB,EAAY,GAAY,GAAqB;AAC3D,KAAI,EAAE,EAAe,EAAE,IAAI,EAAe,EAAE,EAC1C,QAAO,MAAM;AAGf,KAAI,EAAQ,EAAE,IAAI,EAAQ,EAAE,CAIxB,QAHE,EAAE,WAAW,EAAE,SAGV,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,OAAO,MAAM,EAAY,EAAE,IAAI,EAAE,GAAG,CAAC,GAFnD;AAMX,KAAI,EAAc,EAAE,IAAI,EAAc,EAAE,CAKtC,QAJI,EAAgB,EAAE,KAAK,EAAgB,EAAE,GAItC,OAAO,KAAK,EAAE,CAAC,OAAO,MAAM,EAAY,EAAE,IAAI,EAAE,GAAG,CAAC,GAHlD;AAMX,OAAM,MAAM,oBAAoB,OAAO,EAAE,CAAC,SAAS,OAAO,EAAE,GAAG;;AASjE,SAAgB,EAAa,GAAW;AACtC,KAAI,MAAM,QAAQ,EAAI,EAAE;EACtB,IAAM,IAAc,EAAE;AACtB,OAAK,IAAI,IAAI,GAAG,IAAI,EAAI,QAAQ,IAC9B,GAAK,KAAK,EAAU,EAAI,GAAG;AAE7B,SAAO;YACE,EAAc,EAAI,EAAE;EAC7B,IAAM,IAA4B,EAAE;AAIpC,SAHA,OAAO,KAAK,EAAI,CAAC,SAAS,MAAM;AAC9B,KAAK,KAAK,EAAU,EAAI,GAAG;IAC3B,EACK;OAEP,QAAO"}
+{"version":3,"file":"objects.js","names":[],"sources":["../../../../../../../lib/util/helpers/src/objects.ts"],"sourcesContent":["/**/\n\nimport type { PartialBy, PlainObject } from \"./types\";\nimport { isNil } from \"./utils\";\n\n/**\n * Alias to Array.isArray\n */\nexport const isArray = Array.isArray;\n\n//\nexport function isNonPrimitive<V, T extends PlainObject<V> | V[]>(obj: T | unknown): obj is T {\n  return obj !== null && typeof obj === \"object\";\n}\n\nexport function isObject(value: unknown): value is object {\n  return typeof value === \"object\" && value !== null;\n}\n\n/**\n * Checks if the given value is a plain object.\n *\n * A plain object is defined as an object created by the `{}` literal,\n * an object created with `Object.create(null)`, or an object with a\n * prototype that resolves to `Object.prototype`.\n *\n * @param value - The value to check.\n * @returns `true` if the value is a plain object, otherwise `false`.\n *\n * @example\n * ```typescript\n * isPlainObject({}); // true\n * isPlainObject(Object.create(null)); // true\n * isPlainObject(new Date()); // false\n * isPlainObject(null); // false\n * isPlainObject([]); // false\n * ```\n */\nexport function isPlainObject(value: unknown): value is PlainObject {\n  if (!isObject(value)) {\n    return false;\n  }\n\n  const prototype: unknown = Object.getPrototypeOf(value);\n\n  return (\n    prototype === null ||\n    prototype === Object.prototype ||\n    Object.getPrototypeOf(prototype) === null\n  );\n}\n\nexport function map<U, T extends Record<string, unknown>>(\n  obj: T,\n  callback: (curr: T[keyof T], key: keyof T) => U,\n) {\n  const keys = Object.keys(obj) as Array<keyof T>;\n\n  return keys.map((key: keyof T) => {\n    return callback(obj[key], key);\n  });\n}\n\nfunction definedKeysSize(obj: PlainObject) {\n  return Object.values(obj).reduce((length: number, v) => {\n    return v !== undefined ? length + 1 : length;\n  }, 0);\n}\n\n/**\n * Performs a deep equality check between two values, `a` and `b`, to determine if they are JSON-equivalent.\n *\n * JSON equivalence means that the two values are strictly equal in structure and content, including arrays and plain objects.\n * Non-primitive values that are neither arrays nor plain objects will throw an error.\n *\n * @param a - The first value to compare.\n * @param b - The second value to compare.\n * @returns `true` if the values are JSON-equivalent, otherwise `false`.\n *\n * @throws If the values are non-primitive and not arrays or plain objects.\n *\n * @example\n * ```typescript\n * isJsonEqual(1, 1); // true\n * isJsonEqual({ a: 1 }, { a: 1 }); // true\n * isJsonEqual([1, 2], [1, 2]); // true\n * isJsonEqual({ a: 1 }, { a: 2 }); // false\n * isJsonEqual([1, 2], [2, 1]); // false\n * isJsonEqual(new Date(), new Date()); // Error\n * ```\n */\nexport function isJsonEqual(a: unknown, b: unknown): boolean {\n  if (!(isNonPrimitive(a) && isNonPrimitive(b))) {\n    return a === b;\n  }\n\n  if (isArray(a) && isArray(b)) {\n    if (a.length !== b.length) {\n      return false;\n    } else {\n      return [...a.keys()].every((k) => isJsonEqual(a[k], b[k]));\n    }\n  }\n\n  if (isPlainObject(a) && isPlainObject(b)) {\n    if (definedKeysSize(a) !== definedKeysSize(b)) {\n      return false;\n    }\n\n    return Object.keys(a).every((k) => isJsonEqual(a[k], b[k]));\n  }\n\n  throw Error(`Cannot compare a ${String(a)} and b ${String(b)}`);\n}\n\n/**\n * Alias to isJsonEqual function\n * @deprecated change to isJsonEqual\n */\nexport const deepEqual = isJsonEqual;\n\nexport function deepClone<T>(obj: T): T {\n  if (Array.isArray(obj)) {\n    const copy: any[] = [];\n    for (let i = 0; i < obj.length; i++) {\n      copy[i] = deepClone(obj[i]) as unknown;\n    }\n    return copy as T;\n  } else if (isPlainObject(obj)) {\n    const copy: Record<string, any> = {};\n    Object.keys(obj).forEach((k) => {\n      copy[k] = deepClone(obj[k]);\n    });\n    return copy as T;\n  } else {\n    return obj;\n  }\n}\n\nexport function shallowClone<T>(obj: T): T {\n  if (isNil(obj)) return obj;\n  if (Array.isArray(obj)) return obj.slice() as T;\n  if (isPlainObject(obj)) return Object.assign({}, obj) as T;\n  if (obj instanceof Map) return new Map(obj) as T;\n  if (obj instanceof Set) return new Set(obj) as T;\n  throw Error(`Not implemented clone strategy for ${JSON.stringify(obj)}`);\n}\n\nexport function shallowDiff<T>(to: T, from: T): Partial<T> {\n  const diff: Partial<T> = {};\n\n  for (const key in from) {\n    if (from[key] !== to[key]) {\n      diff[key] = to[key];\n    }\n  }\n\n  return diff;\n}\n\nexport function bindMethods<O extends Record<string, unknown>>(obj: O) {\n  Object.entries(obj).forEach(([key, m]) => {\n    if (m instanceof Function) {\n      //\n      obj[key as keyof O] = m.bind(obj);\n    }\n  });\n\n  return obj;\n}\n\nexport function setProp<O, K extends keyof O>(obj: O, key: K, value: O[K]) {\n  obj[key] = value;\n  return obj;\n}\n\nexport function getProp<O, K extends keyof O>(obj: O, key: K): O[K] {\n  return obj[key];\n}\n\nexport function shiftProp<O, K extends keyof O>(obj: O, key: K): [O[K], Omit<O, K>] {\n  obj = { ...obj };\n  const val = obj[key];\n  delete obj[key];\n  return [val, obj];\n}\n\nexport function pick<T, K extends keyof T>(obj: T, ...keys: K[]): Pick<T, K> {\n  return Object.assign({}, ...keys.map((k) => ({ [k]: obj[k] }))) as Pick<T, K>;\n}\n\nexport function pickValues<T, K extends keyof T>(obj: T, ...keys: K[]) {\n  return keys.map((k) => obj[k]);\n}\n\nexport function omit<T, K extends keyof T>(obj: T, ...keys: K[]): Omit<T, K> {\n  const o = Object.assign({}, obj) as PartialBy<T, K>;\n  keys.forEach((k) => delete o[k]);\n  return o;\n}\n\n/**\n * Performs a deep patch of the target object or array using the source object or array.\n *\n * This function recursively merges properties of the source into the target:\n * - If a property in both target and source is a plain object, they are recursively merged.\n * - If a property in both target and source is an array of the same length, the arrays are recursively patched element by element.\n * - Otherwise, the property value in the target is replaced by the corresponding value from the source.\n *\n * The patch is applied in-place to the target object or array, which is also returned for convenience.\n *\n * @typeParam T - The type of the target and source, which must be either a plain object or an array.\n * @param target - The target object or array to be patched. This object/array is modified in-place.\n * @param source - The source object or array providing the new values for the patch.\n * @returns The modified target object or array.\n *\n * @example\n * ```typescript\n * const target = { a: { b: 1 }, c: [1, 2] };\n * const source = { a: { b: 2 }, c: [3, 4], d: 5 };\n * const result = deepPatch(target, source);\n * // target is now: { a: { b: 2 }, c: [3, 4], d: 5 }\n * // result is the same reference as target.\n *\n * const targetArray = [{ a: 1 }, { b: 2 }];\n * const sourceArray = [{ a: 2 }, { b: 3 }];\n * const resultArray = deepPatch(targetArray, sourceArray);\n * // targetArray is now: [{ a: 2 }, { b: 3 }]\n * ```\n */\nexport function deepPatch<T extends PlainObject | unknown[]>(target: T, source: T) {\n  const sk = new Set<keyof T>([\n    ...(Object.keys(target) as (keyof T)[]),\n    ...(Object.keys(source) as (keyof T)[]),\n  ]);\n\n  sk.forEach((key) => {\n    const t = target[key];\n    const s = source[key];\n    if (isPlainObject(t) && isPlainObject(s)) {\n      deepPatch(t, s);\n    } else if (isArray(t) && isArray(s) && t.length === s.length) {\n      deepPatch(t, s);\n    } else {\n      target[key] = s;\n    }\n  });\n\n  return target;\n}\n"],"mappings":";AAQA,IAAa,IAAU,MAAM;AAG7B,SAAgB,EAAkD,GAA4B;AAC5F,QAAuB,OAAO,KAAQ,cAA/B;;AAGT,SAAgB,EAAS,GAAiC;AACxD,QAAO,OAAO,KAAU,cAAY;;AAsBtC,SAAgB,EAAc,GAAsC;AAClE,KAAI,CAAC,EAAS,EAAM,CAClB,QAAO;CAGT,IAAM,IAAqB,OAAO,eAAe,EAAM;AAEvD,QACE,MAAc,QACd,MAAc,OAAO,aACrB,OAAO,eAAe,EAAU,KAAK;;AAezC,SAAS,EAAgB,GAAkB;AACzC,QAAO,OAAO,OAAO,EAAI,CAAC,QAAQ,GAAgB,MACzC,MAAM,KAAA,IAAyB,IAAb,IAAS,GACjC,EAAE;;AAyBP,SAAgB,EAAY,GAAY,GAAqB;AAC3D,KAAI,EAAE,EAAe,EAAE,IAAI,EAAe,EAAE,EAC1C,QAAO,MAAM;AAGf,KAAI,EAAQ,EAAE,IAAI,EAAQ,EAAE,CAIxB,QAHE,EAAE,WAAW,EAAE,SAGV,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,OAAO,MAAM,EAAY,EAAE,IAAI,EAAE,GAAG,CAAC,GAFnD;AAMX,KAAI,EAAc,EAAE,IAAI,EAAc,EAAE,CAKtC,QAJI,EAAgB,EAAE,KAAK,EAAgB,EAAE,GAItC,OAAO,KAAK,EAAE,CAAC,OAAO,MAAM,EAAY,EAAE,IAAI,EAAE,GAAG,CAAC,GAHlD;AAMX,OAAM,MAAM,oBAAoB,OAAO,EAAE,CAAC,SAAS,OAAO,EAAE,GAAG;;AASjE,SAAgB,EAAa,GAAW;AACtC,KAAI,MAAM,QAAQ,EAAI,EAAE;EACtB,IAAM,IAAc,EAAE;AACtB,OAAK,IAAI,IAAI,GAAG,IAAI,EAAI,QAAQ,IAC9B,GAAK,KAAK,EAAU,EAAI,GAAG;AAE7B,SAAO;YACE,EAAc,EAAI,EAAE;EAC7B,IAAM,IAA4B,EAAE;AAIpC,SAHA,OAAO,KAAK,EAAI,CAAC,SAAS,MAAM;AAC9B,KAAK,KAAK,EAAU,EAAI,GAAG;IAC3B,EACK;OAEP,QAAO"}

package/dist/lib/util/helpers/dist/prettyBytes.js

@@ -1,3 +1,4 @@
+//#region ../../lib/util/helpers/dist/prettyBytes.js
 var e = [
 	"B",
 	"kB",
@@ -57,6 +58,7 @@ function a(a, o) {
 	let d = i(Number(a), o.locale), f = s[u];
 	return l + d + " " + f;
 }
+//#endregion
 export { a as prettyBytes };
 
 //# sourceMappingURL=prettyBytes.js.map

package/dist/lib/util/helpers/dist/prettyBytes.js.map

@@ -1 +1 @@
-{"version":3,"file":"prettyBytes.js","names":[],"sources":["../../../../../../../lib/util/helpers/src/prettyBytes.ts"],"sourcesContent":["const BYTE_UNITS = [\"B\", \"kB\", \"MB\", \"GB\", \"TB\", \"PB\", \"EB\", \"ZB\", \"YB\"];\n\nconst BIBYTE_UNITS = [\"B\", \"kiB\", \"MiB\", \"GiB\", \"TiB\", \"PiB\", \"EiB\", \"ZiB\", \"YiB\"];\n\nconst BIT_UNITS = [\"b\", \"kbit\", \"Mbit\", \"Gbit\", \"Tbit\", \"Pbit\", \"Ebit\", \"Zbit\", \"Ybit\"];\n\nconst BIBIT_UNITS = [\"b\", \"kibit\", \"Mibit\", \"Gibit\", \"Tibit\", \"Pibit\", \"Eibit\", \"Zibit\", \"Yibit\"];\n\ntype Options = {\n  bits?: boolean;\n  binary?: boolean;\n  signed?: boolean;\n  locale?: string;\n};\n\n/*\nFormats the given number using `Number#toLocaleString`.\n- If locale is a string, the value is expected to be a locale-key (for example: `de`).\n- If locale is true, the system default locale is used for translation.\n- If no value for locale is specified, the number is returned unmodified.\n*/\nconst toLocaleString = (number: number, locale: string | undefined) => {\n  let result = String(number);\n  if (typeof locale === \"string\" || Array.isArray(locale)) {\n    result = number.toLocaleString(locale);\n  } else if (locale === true) {\n    result = number.toLocaleString(undefined);\n  }\n\n  return result;\n};\n\nexport function prettyBytes(number: number | bigint, options: Options) {\n  number = typeof number === \"bigint\" ? Number(number) : number;\n\n  if (!Number.isFinite(number)) {\n    throw new TypeError(`Expected a finite number, got ${typeof number}: ${number}`);\n  }\n\n  Object.assign(\n    {\n      bits: false,\n      binary: false,\n    },\n    options,\n  );\n\n  const UNITS = options.bits\n    ? options.binary\n      ? BIBIT_UNITS\n      : BIT_UNITS\n    : options.binary\n      ? BIBYTE_UNITS\n      : BYTE_UNITS;\n\n  if (options.signed && number === 0) {\n    return ` 0 ${UNITS[0]}`;\n  }\n\n  const isNegative = number < 0;\n  const prefix = isNegative ? \"-\" : options.signed ? \"+\" : \"\";\n\n  if (isNegative) {\n    number = -number;\n  }\n\n  if (number < 1) {\n    const numberString = toLocaleString(number, options.locale);\n    return prefix + numberString + \" \" + UNITS[0];\n  }\n\n  const exponent = Math.min(\n    Math.floor(options.binary ? Math.log(number) / Math.log(1024) : Math.log10(number) / 3),\n    UNITS.length - 1,\n  );\n  number /= (options.binary ? 1024 : 1000) ** exponent;\n\n  number = Number(number.toPrecision(3));\n\n  const numberString = toLocaleString(Number(number), options.locale);\n\n  const unit = UNITS[exponent];\n\n  return prefix + numberString + \" \" + unit;\n}\n"],"mappings":"AAAA,IAAM,IAAa;CAAC;CAAK;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;CAAK,EAElE,IAAe;CAAC;CAAK;CAAO;CAAO;CAAO;CAAO;CAAO;CAAO;CAAO;CAAM,EAE5E,IAAY;CAAC;CAAK;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAO,EAEjF,IAAc;CAAC;CAAK;CAAS;CAAS;CAAS;CAAS;CAAS;CAAS;CAAS;CAAQ,EAe3F,KAAkB,GAAgB,MAA+B;CACrE,IAAI,IAAS,OAAO,EAAO;AAO3B,QANI,OAAO,KAAW,YAAY,MAAM,QAAQ,EAAO,GACrD,IAAS,EAAO,eAAe,EAAO,GAC7B,MAAW,OACpB,IAAS,EAAO,eAAe,KAAA,EAAU,GAGpC;;AAGT,SAAgB,EAAY,GAAyB,GAAkB;AAGrE,KAFA,IAAS,OAAO,KAAW,WAAW,OAAO,EAAO,GAAG,GAEnD,CAAC,OAAO,SAAS,EAAO,CAC1B,OAAU,UAAU,iCAAiC,OAAO,EAAO,IAAI,IAAS;AAGlF,QAAO,OACL;EACE,MAAM;EACN,QAAQ;EACT,EACD,EACD;CAED,IAAM,IAAQ,EAAQ,OAClB,EAAQ,SACN,IACA,IACF,EAAQ,SACN,IACA;AAEN,KAAI,EAAQ,UAAU,MAAW,EAC/B,QAAO,MAAM,EAAM;CAGrB,IAAM,IAAa,IAAS,GACtB,IAAS,IAAa,MAAM,EAAQ,SAAS,MAAM;AAMzD,KAJI,MACF,IAAS,CAAC,IAGR,IAAS,EAEX,QAAO,IADc,EAAe,GAAQ,EAAQ,OAAO,GAC5B,MAAM,EAAM;CAG7C,IAAM,IAAW,KAAK,IACpB,KAAK,MAAM,EAAQ,SAAS,KAAK,IAAI,EAAO,GAAG,KAAK,IAAI,KAAK,GAAG,KAAK,MAAM,EAAO,GAAG,EAAE,EACvF,EAAM,SAAS,EAChB;AAGD,CAFA,MAAW,EAAQ,SAAS,OAAO,QAAS,GAE5C,IAAS,OAAO,EAAO,YAAY,EAAE,CAAC;CAEtC,IAAM,IAAe,EAAe,OAAO,EAAO,EAAE,EAAQ,OAAO,EAE7D,IAAO,EAAM;AAEnB,QAAO,IAAS,IAAe,MAAM"}
+{"version":3,"file":"prettyBytes.js","names":[],"sources":["../../../../../../../lib/util/helpers/src/prettyBytes.ts"],"sourcesContent":["const BYTE_UNITS = [\"B\", \"kB\", \"MB\", \"GB\", \"TB\", \"PB\", \"EB\", \"ZB\", \"YB\"];\n\nconst BIBYTE_UNITS = [\"B\", \"kiB\", \"MiB\", \"GiB\", \"TiB\", \"PiB\", \"EiB\", \"ZiB\", \"YiB\"];\n\nconst BIT_UNITS = [\"b\", \"kbit\", \"Mbit\", \"Gbit\", \"Tbit\", \"Pbit\", \"Ebit\", \"Zbit\", \"Ybit\"];\n\nconst BIBIT_UNITS = [\"b\", \"kibit\", \"Mibit\", \"Gibit\", \"Tibit\", \"Pibit\", \"Eibit\", \"Zibit\", \"Yibit\"];\n\ntype Options = {\n  bits?: boolean;\n  binary?: boolean;\n  signed?: boolean;\n  locale?: string;\n};\n\n/*\nFormats the given number using `Number#toLocaleString`.\n- If locale is a string, the value is expected to be a locale-key (for example: `de`).\n- If locale is true, the system default locale is used for translation.\n- If no value for locale is specified, the number is returned unmodified.\n*/\nconst toLocaleString = (number: number, locale: string | undefined) => {\n  let result = String(number);\n  if (typeof locale === \"string\" || Array.isArray(locale)) {\n    result = number.toLocaleString(locale);\n  } else if (locale === true) {\n    result = number.toLocaleString(undefined);\n  }\n\n  return result;\n};\n\nexport function prettyBytes(number: number | bigint, options: Options) {\n  number = typeof number === \"bigint\" ? Number(number) : number;\n\n  if (!Number.isFinite(number)) {\n    throw new TypeError(`Expected a finite number, got ${typeof number}: ${number}`);\n  }\n\n  Object.assign(\n    {\n      bits: false,\n      binary: false,\n    },\n    options,\n  );\n\n  const UNITS = options.bits\n    ? options.binary\n      ? BIBIT_UNITS\n      : BIT_UNITS\n    : options.binary\n      ? BIBYTE_UNITS\n      : BYTE_UNITS;\n\n  if (options.signed && number === 0) {\n    return ` 0 ${UNITS[0]}`;\n  }\n\n  const isNegative = number < 0;\n  const prefix = isNegative ? \"-\" : options.signed ? \"+\" : \"\";\n\n  if (isNegative) {\n    number = -number;\n  }\n\n  if (number < 1) {\n    const numberString = toLocaleString(number, options.locale);\n    return prefix + numberString + \" \" + UNITS[0];\n  }\n\n  const exponent = Math.min(\n    Math.floor(options.binary ? Math.log(number) / Math.log(1024) : Math.log10(number) / 3),\n    UNITS.length - 1,\n  );\n  number /= (options.binary ? 1024 : 1000) ** exponent;\n\n  number = Number(number.toPrecision(3));\n\n  const numberString = toLocaleString(Number(number), options.locale);\n\n  const unit = UNITS[exponent];\n\n  return prefix + numberString + \" \" + unit;\n}\n"],"mappings":";AAAA,IAAM,IAAa;CAAC;CAAK;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;CAAK,EAElE,IAAe;CAAC;CAAK;CAAO;CAAO;CAAO;CAAO;CAAO;CAAO;CAAO;CAAM,EAE5E,IAAY;CAAC;CAAK;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAQ;CAAO,EAEjF,IAAc;CAAC;CAAK;CAAS;CAAS;CAAS;CAAS;CAAS;CAAS;CAAS;CAAQ,EAe3F,KAAkB,GAAgB,MAA+B;CACrE,IAAI,IAAS,OAAO,EAAO;AAO3B,QANI,OAAO,KAAW,YAAY,MAAM,QAAQ,EAAO,GACrD,IAAS,EAAO,eAAe,EAAO,GAC7B,MAAW,OACpB,IAAS,EAAO,eAAe,KAAA,EAAU,GAGpC;;AAGT,SAAgB,EAAY,GAAyB,GAAkB;AAGrE,KAFA,IAAS,OAAO,KAAW,WAAW,OAAO,EAAO,GAAG,GAEnD,CAAC,OAAO,SAAS,EAAO,CAC1B,OAAU,UAAU,iCAAiC,OAAO,EAAO,IAAI,IAAS;AAGlF,QAAO,OACL;EACE,MAAM;EACN,QAAQ;EACT,EACD,EACD;CAED,IAAM,IAAQ,EAAQ,OAClB,EAAQ,SACN,IACA,IACF,EAAQ,SACN,IACA;AAEN,KAAI,EAAQ,UAAU,MAAW,EAC/B,QAAO,MAAM,EAAM;CAGrB,IAAM,IAAa,IAAS,GACtB,IAAS,IAAa,MAAM,EAAQ,SAAS,MAAM;AAMzD,KAJI,MACF,IAAS,CAAC,IAGR,IAAS,EAEX,QAAO,IADc,EAAe,GAAQ,EAAQ,OAAO,GAC5B,MAAM,EAAM;CAG7C,IAAM,IAAW,KAAK,IACpB,KAAK,MAAM,EAAQ,SAAS,KAAK,IAAI,EAAO,GAAG,KAAK,IAAI,KAAK,GAAG,KAAK,MAAM,EAAO,GAAG,EAAE,EACvF,EAAM,SAAS,EAChB;AAGD,CAFA,MAAW,EAAQ,SAAS,OAAO,QAAS,GAE5C,IAAS,OAAO,EAAO,YAAY,EAAE,CAAC;CAEtC,IAAM,IAAe,EAAe,OAAO,EAAO,EAAE,EAAQ,OAAO,EAE7D,IAAO,EAAM;AAEnB,QAAO,IAAS,IAAe,MAAM"}