@kosdev-code/kos-ui-sdk 0.1.0-dev.5382 → 0.1.0-dev.5603

package/models/models/kos-expression-evaluator/index.d.ts

@@ -1,4 +1,4 @@
-export type { KosExpressionEvaluatorModel, KosExpressionEvaluatorModelImpl, } from './kos-expression-evaluator-model';
+export type { KosExpressionEvaluatorModel, KosExpressionEvaluatorModelImpl, ExpressionResult, NamedExpression, } from './kos-expression-evaluator-model';
 export type * from './types';
 export declare const KosExpressionEvaluator: import('../../..').KosModelRegistrationType<import('./kos-expression-evaluator-model').KosExpressionEvaluatorModel<string>, import('./types').KosExpressionEvaluatorOptions>;
 //# sourceMappingURL=index.d.ts.map

package/models/models/kos-expression-evaluator/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/kos-expression-evaluator/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,kCAAkC,CAAC;AAC1C,mBAAmB,SAAS,CAAC;AAE7B,eAAO,MAAM,sBAAsB,8KACW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/kos-expression-evaluator/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,2BAA2B,EAC3B,+BAA+B,EAC/B,gBAAgB,EAChB,eAAe,GAChB,MAAM,kCAAkC,CAAC;AAC1C,mBAAmB,SAAS,CAAC;AAE7B,eAAO,MAAM,sBAAsB,8KACW,CAAC"}

package/models/models/kos-expression-evaluator/kos-expression-evaluator-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kos-expression-evaluator-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/kos-expression-evaluator/kos-expression-evaluator-model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"kos-expression-evaluator-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/kos-expression-evaluator/kos-expression-evaluator-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,wBAAwB,EAC9B,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EACV,aAAa,EAEb,kBAAkB,EACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,SAAS,CAAC;AAE7D,eAAO,MAAM,UAAU,mCAAmC,CAAC;AAE3D;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,KAAK,EAAE,OAAO,CAAC;IACf,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA+DD,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,IAAI,MAAM,IAAI,gBAAgB,CAAC;IAC/B,gEAAgE;IAChE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAAC;IACjE,yCAAyC;IACzC,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,MAAM,2BAA2B,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAC/D,oBAAoB,CAAC,+BAA+B,CAAC,CAAC,CAAC,CAAC,CAAC;AAE3D;;;GAGG;AACH,qBACa,+BAA+B,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CACpE,YAAW,aAAa,EAAE,gBAAgB;IAG1C,MAAM,CAAC,YAAY,EAAE,wBAAwB,CAC3C,2BAA2B,EAC3B,6BAA6B,CAC9B,CAAC;IACF,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,MAAM,CAAmB;IAEjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,YAAY,CAAsC;IAE1D,OAAO,CAAC,QAAQ,CAA4C;IAC5D,OAAO,CAAC,gBAAgB,CAAK;gBAG3B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,6BAA6B,EACvC,OAAO,EAAE,kBAAkB;IAwB7B;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElC;IAED,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED;;;;;;;;;;OAUG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAYtD;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAIrD;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAyBrD;;;;;;;;;;;;;;OAcG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAIpD;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAwBtD,gBAAgB,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO;IAelC,aAAa,CAAC,IAAI,EAAE,CAAC,GAAG,eAAe,GAAG,SAAS;IAYnD,kBAAkB,CAAC,IAAI,EAAE,CAAC,GAAG,gBAAgB,GAAG,SAAS;IAazD;;;;;;;;;;;;OAYG;IACH,wBAAwB,CAAC,IAAI,EAAE,CAAC,GAAG,gBAAgB,GAAG,SAAS;IAU/D,IAAI,WAAW,IAAI,eAAe,EAAE,CAEnC;IAED,IAAI,eAAe,IAAI,CAAC,EAAE,CAEzB;IAGD,IAAI,OAAO,IAAI,MAAM,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAMzC;IAED;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAW9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAYpB;;;;;;;;;;;;OAYG;IACH,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM;CAUnD"}

package/models/utils/client.d.ts

@@ -8,10 +8,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -27,10 +27,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -46,10 +46,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -65,10 +65,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;

package/models/utils/extension-manager.d.ts

@@ -1,23 +1,59 @@
 import { TroubleResponse } from '../models/trouble/services';
-import { PropertyMapper, DataLoader } from '../../core';
+import { ExtensionOptions, PropertyMapper, DataLoader } from '../../core';
 
 export type TroubleRankMapper = PropertyMapper<TroubleResponse, number, any>;
 export type TroubleColorMapper = PropertyMapper<TroubleResponse, string, any>;
 export type TroubleRoleMapper = PropertyMapper<TroubleResponse, string, any>;
 export declare class CoreExtensionManager {
     /**
-     * Maps the rank property of the trouble into the {@link TroubleModel}
+     * Maps the rank property of the trouble into the {@link TroubleModel}.
+     *
+     * @param troubleRankMapper - Mapping function that derives a numeric rank from a {@link TroubleResponse}
+     * @param options - Optional {@link ExtensionOptions} to control failure behavior.
+     *   Defaults to `failurePolicy: "throw"`, which throws an {@link ExtensionException} on mapper failure.
+     *   Set to `"continue"` to log the error and return a fallback value instead.
+     * @returns this instance for chaining
      * */
-    registerTroubleRankMapper(troubleRankMapper: TroubleRankMapper): this;
+    registerTroubleRankMapper(troubleRankMapper: TroubleRankMapper, options?: ExtensionOptions): this;
     /**
-     * Maps the role property of the trouble into the {@link TroubleModel}
+     * Maps the role property of the trouble into the {@link TroubleModel}.
+     *
+     * @param troubleRoleMapper - Mapping function that derives a role string from a {@link TroubleResponse}
+     * @param options - Optional {@link ExtensionOptions} to control failure behavior.
+     *   Defaults to `failurePolicy: "throw"`, which throws an {@link ExtensionException} on mapper failure.
+     *   Set to `"continue"` to log the error and return a fallback value instead.
+     * @returns this instance for chaining
      * */
-    registerTroubleRoleMapper(troubleRoleMapper: TroubleRoleMapper): this;
+    registerTroubleRoleMapper(troubleRoleMapper: TroubleRoleMapper, options?: ExtensionOptions): this;
     /**
-     * Maps the color property of the trouble into the {@link TroubleModel}
+     * Maps the color property of the trouble into the {@link TroubleModel}.
+     *
+     * @param troubleColorMapper - Mapping function that derives a color string from a {@link TroubleResponse}
+     * @param options - Optional {@link ExtensionOptions} to control failure behavior.
+     *   Defaults to `failurePolicy: "throw"`, which throws an {@link ExtensionException} on mapper failure.
+     *   Set to `"continue"` to log the error and return a fallback value instead.
+     * @returns this instance for chaining
      * */
-    registerTroubleColorMapper(troubleColorMapper: TroubleColorMapper): this;
-    registerModelLoader(id: string, loader: DataLoader): void;
-    registerCanvasPatternLoader(loader: DataLoader): void;
+    registerTroubleColorMapper(troubleColorMapper: TroubleColorMapper, options?: ExtensionOptions): this;
+    /**
+     * Registers a data loader for a given model id. The loader is invoked during model
+     * initialization to fetch data that is provided as context to associated mappers.
+     *
+     * @param id - The model identifier to associate the loader with
+     * @param loader - Async function that loads and returns data for the model
+     * @param options - Optional {@link ExtensionOptions} to control failure behavior.
+     *   Defaults to `failurePolicy: "throw"`, which throws an {@link ExtensionException} on loader failure.
+     *   Set to `"continue"` to log the error and return `undefined` instead.
+     */
+    registerModelLoader(id: string, loader: DataLoader, options?: ExtensionOptions): void;
+    /**
+     * Registers a data loader for the {@link CanvasDispatcher} pattern data.
+     *
+     * @param loader - Async function that loads canvas pattern data
+     * @param options - Optional {@link ExtensionOptions} to control failure behavior.
+     *   Defaults to `failurePolicy: "throw"`, which throws an {@link ExtensionException} on loader failure.
+     *   Set to `"continue"` to log the error and return `undefined` instead.
+     */
+    registerCanvasPatternLoader(loader: DataLoader, options?: ExtensionOptions): void;
 }
 //# sourceMappingURL=extension-manager.d.ts.map

package/models/utils/extension-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extension-manager.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/models/utils/extension-manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAG/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;AAE7E,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;AAE9E,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;AAE7E,qBAAa,oBAAoB;IAC/B;;SAEK;IACL,yBAAyB,CAAC,iBAAiB,EAAE,iBAAiB;IAQ9D;;SAEK;IACL,yBAAyB,CAAC,iBAAiB,EAAE,iBAAiB;IAQ9D;;SAEK;IACL,0BAA0B,CAAC,kBAAkB,EAAE,kBAAkB;IAQjE,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU;IAIlD,2BAA2B,CAAC,MAAM,EAAE,UAAU;CAG/C"}
+{"version":3,"file":"extension-manager.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/models/utils/extension-manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,gBAAgB,EAChB,cAAc,EACd,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;AAE7E,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;AAE9E,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;AAE7E,qBAAa,oBAAoB;IAC/B;;;;;;;;SAQK;IACL,yBAAyB,CACvB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,CAAC,EAAE,gBAAgB;IAU5B;;;;;;;;SAQK;IACL,yBAAyB,CACvB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,CAAC,EAAE,gBAAgB;IAU5B;;;;;;;;SAQK;IACL,0BAA0B,CACxB,kBAAkB,EAAE,kBAAkB,EACtC,OAAO,CAAC,EAAE,gBAAgB;IAU5B;;;;;;;;;OASG;IACH,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAI9E;;;;;;;OAOG;IACH,2BAA2B,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,gBAAgB;CAG3E"}

package/models/utils/service.d.ts

@@ -9,10 +9,10 @@ declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -28,10 +28,10 @@ declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -47,10 +47,10 @@ declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -66,10 +66,10 @@ declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;

package/models/utils/services/kos/1.6.5/service.d.ts

@@ -49,10 +49,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -68,10 +68,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -87,10 +87,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -106,10 +106,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;

package/models/utils/services/kos/1.8.1/service.d.ts

@@ -49,10 +49,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -68,10 +68,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -87,10 +87,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -106,10 +106,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;

package/models/utils/services/kos/daily/service.d.ts

@@ -49,10 +49,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -68,10 +68,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -87,10 +87,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -106,10 +106,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;

package/models/utils/services/vfs/1.6.5/service.d.ts

@@ -49,10 +49,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -68,10 +68,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -87,10 +87,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -106,10 +106,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;

package/models/utils/services/vfs/1.8.1/service.d.ts

@@ -49,10 +49,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -68,10 +68,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -87,10 +87,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -106,10 +106,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;

package/models/utils/services/vfs/daily/service.d.ts

@@ -49,10 +49,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -68,10 +68,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -87,10 +87,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;
@@ -106,10 +106,10 @@ export declare const api: {
         ordered?: boolean | undefined;
         tracker?: string | undefined;
         timeout?: number | undefined;
+        destinationAddress?: string | undefined;
+        bridge?: boolean | undefined;
         headers?: Record<string, string> | undefined;
         fos?: boolean | undefined;
-        bridge?: boolean | undefined;
-        destinationAddress?: string | undefined;
         studio?: boolean | undefined;
         signal?: AbortSignal | undefined;
         stream?: boolean | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosdev-code/kos-ui-sdk",
-  "version": "0.1.0-dev.5382",
+  "version": "0.1.0-dev.5603",
   "type": "module",
   "main": "./index.cjs",
   "module": "./index.js",
@@ -36,7 +36,7 @@
   },
   "kos": {
     "build": {
-      "gitHash": "9e8e9e0b9133a62eb70283c36c1e85e1a40416d2"
+      "gitHash": "34977cc553cf0e74d03288bbce58fef5e9853ee4"
     }
   }
 }

package/ui/hooks/index.d.ts

@@ -27,5 +27,6 @@ export * from './use-press-gesture';
 export * from './use-project-reloading';
 export * from './use-region-time-props';
 export * from './use-time-props';
+export * from './view-model';
 export * from './with-project-reload';
 //# sourceMappingURL=index.d.ts.map

package/ui/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/ui/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AACtD,cAAc,YAAY,CAAC;AAC3B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,OAAO,CAAC;AACtB,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9D,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,SAAS,CAAC;AACxB,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/ui/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AACtD,cAAc,YAAY,CAAC;AAC3B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,OAAO,CAAC;AACtB,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9D,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,SAAS,CAAC;AACxB,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC"}

package/ui/hooks/view-model/index.d.ts

@@ -0,0 +1,2 @@
+export * from './use-view-model';
+//# sourceMappingURL=index.d.ts.map

package/ui/hooks/view-model/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/ui/hooks/view-model/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/ui/hooks/view-model/use-view-model.d.ts

@@ -0,0 +1,80 @@
+/// <reference types="react" />
+/**
+ * Configuration options for the useViewModel hook.
+ */
+export interface UseViewModelOptions {
+    /**
+     * When true, calls the ViewModel's dispose() method on unmount
+     * and when dependencies change causing recreation.
+     * Default: true (if dispose method exists)
+     */
+    disposeOnUnmount?: boolean;
+}
+/**
+ * Result returned by useViewModel when the ViewModel implements IKosViewModelReady.
+ */
+export interface UseViewModelResult<T> {
+    /** The ViewModel instance */
+    viewModel: T;
+    /** Whether the ViewModel's ready() hook has completed */
+    ready: boolean;
+    /** Error from the ready() hook, if any */
+    error: Error | undefined;
+}
+/**
+ * React hook for creating and managing ViewModel instances.
+ *
+ * The hook:
+ * - Creates the ViewModel using the provided factory function
+ * - Calls ready() if the ViewModel implements IKosViewModelReady
+ * - Automatically calls dispose() on unmount (if the method exists)
+ * - Re-creates the ViewModel when dependencies change
+ * - Disposes the previous ViewModel when recreating
+ *
+ * @param factory - Function that creates the ViewModel instance
+ * @param deps - Dependency array (similar to useEffect/useMemo)
+ * @param options - Optional configuration
+ * @returns UseViewModelResult with viewModel, ready state, and error
+ *
+ * @example
+ * ```typescript
+ * // Basic usage (no ready hook)
+ * function Counter() {
+ *   const { viewModel: vm, ready } = useViewModel(() => new CounterViewModel(), []);
+ *
+ *   return (
+ *     <div>
+ *       <span>{vm.count}</span>
+ *       <button onClick={() => vm.increment()}>+</button>
+ *     </div>
+ *   );
+ * }
+ *
+ * // With ready hook for async initialization
+ * function OrderSummary({ orderId }: Props) {
+ *   const { model: order } = useKosModel<IOrderModel>({ modelId: orderId });
+ *   const { model: inventory } = useKosModel<IInventoryModel>({ modelId: 'inventory' });
+ *
+ *   const { viewModel: vm, ready, error } = useViewModel(
+ *     () => new OrderSummaryViewModel(order!, inventory!),
+ *     [order, inventory]
+ *   );
+ *
+ *   if (error) return <ErrorDisplay error={error} />;
+ *   if (!ready) return <Loading />;
+ *
+ *   return <div>Total: ${vm.total}</div>;
+ * }
+ *
+ * // Disable auto-disposal
+ * const { viewModel: vm } = useViewModel(
+ *   () => new MyViewModel(),
+ *   [],
+ *   { disposeOnUnmount: false }
+ * );
+ * ```
+ *
+ * @category KOS React Hook
+ */
+export declare function useViewModel<T>(factory: () => T, deps: React.DependencyList, options?: UseViewModelOptions): UseViewModelResult<T>;
+//# sourceMappingURL=use-view-model.d.ts.map

package/ui/hooks/view-model/use-view-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-view-model.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/ui/hooks/view-model/use-view-model.ts"],"names":[],"mappings":";AAMA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,6BAA6B;IAC7B,SAAS,EAAE,CAAC,CAAC;IACb,yDAAyD;IACzD,KAAK,EAAE,OAAO,CAAC;IACf,0CAA0C;IAC1C,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,OAAO,EAAE,MAAM,CAAC,EAChB,IAAI,EAAE,KAAK,CAAC,cAAc,EAC1B,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,CAAC,CAAC,CAAC,CAoFvB"}