@kosdev-code/kos-ui-sdk 2.0.43 → 2.0.45

package/ui/hooks/translation-container/with-translation-container.d.ts

@@ -4,6 +4,12 @@ interface TranslationContainerProps {
     translationContainer: TranslationContainerModel;
 }
 type HoCTranslationContainerProps = TranslationContainerProps;
+/**
+ * Higher-order component that injects a `TranslationContainerModel` into a wrapped component.
+ *
+ * @kosService core.use-translation
+ * @kosApiLevel 2
+ */
 export declare function withTranslationContainer<T extends HoCTranslationContainerProps = HoCTranslationContainerProps>(WrappedComponent: React.ComponentType<T>): (props: Omit<T, keyof TranslationContainerProps>) => import("@emotion/react/jsx-runtime").JSX.Element;
 export {};
 //# sourceMappingURL=with-translation-container.d.ts.map

package/ui/hooks/translation-container/with-translation-container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"with-translation-container.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/ui/hooks/translation-container/with-translation-container.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAGjE,UAAU,yBAAyB;IACjC,oBAAoB,EAAE,yBAAyB,CAAC;CACjD;AAED,KAAK,4BAA4B,GAAG,yBAAyB,CAAC;AAE9D,wBAAgB,wBAAwB,CACtC,CAAC,SAAS,4BAA4B,GAAG,4BAA4B,EACrE,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,WACzB,KAAK,CAAC,EAAE,MAAM,yBAAyB,CAAC,sDASxD"}
+{"version":3,"file":"with-translation-container.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/ui/hooks/translation-container/with-translation-container.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAGjE,UAAU,yBAAyB;IACjC,oBAAoB,EAAE,yBAAyB,CAAC;CACjD;AAED,KAAK,4BAA4B,GAAG,yBAAyB,CAAC;AAC9D;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,CAAC,SAAS,4BAA4B,GAAG,4BAA4B,EACrE,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,WACzB,KAAK,CAAC,EAAE,MAAM,yBAAyB,CAAC,sDASxD"}

package/ui/hooks/usb-update-container/use-usb-update-container.d.ts

@@ -1,5 +1,11 @@
 import { UsbUpdateContainerModel, UsbUpdateModel } from '../../../models';
 
+/**
+ * Hook for accessing the KOS USB update container model.
+ *
+ * @kosService core.use-usb-update
+ * @kosApiLevel 2
+ */
 export declare const useUsbUpdateContainer: () => {
     inserted: boolean;
     updateAvailable: boolean;

package/ui/hooks/usb-update-container/use-usb-update-container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-usb-update-container.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/ui/hooks/usb-update-container/use-usb-update-container.ts"],"names":[],"mappings":";AAEA,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAC;AAGzB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;CA2BjC,CAAC"}
+{"version":3,"file":"use-usb-update-container.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/ui/hooks/usb-update-container/use-usb-update-container.ts"],"names":[],"mappings":";AAEA,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAC;AAGzB;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;CA2BjC,CAAC"}

package/ui/hooks/use-config-bean.d.ts

@@ -4,6 +4,12 @@ interface UseConfigBeanParams {
     path: string;
     propKey?: string;
 }
+/**
+ * Hook for binding to a KOS configuration bean.
+ *
+ * @kosService core.use-config-property
+ * @kosApiLevel 2
+ */
 export declare const useConfigBean: ({ path, propKey }: UseConfigBeanParams) => {
     config: IConfigBeanModel | undefined;
     ready: boolean;

package/ui/hooks/use-config-bean.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-config-bean.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/ui/hooks/use-config-bean.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAA2B,MAAM,cAAc,CAAC;AAI9E,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AACD,eAAO,MAAM,aAAa,sBAAuB,mBAAmB;;;;;uBAYxC,MAAM;CAuCjC,CAAC"}
+{"version":3,"file":"use-config-bean.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/ui/hooks/use-config-bean.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAA2B,MAAM,cAAc,CAAC;AAI9E,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AACD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,sBAAuB,mBAAmB;;;;;uBAYxC,MAAM;CAuCjC,CAAC"}

package/ui/hooks/use-config-property.d.ts

@@ -8,6 +8,12 @@ interface Props {
     configProperty?: KosConfigProp;
     optionsTransformer?: OptionsTransformer;
 }
+/**
+ * Hook for binding to a KOS configuration property.
+ *
+ * @kosService core.use-config-property
+ * @kosApiLevel 2
+ */
 export declare const useConfigProperty: <T extends object = any>({ configProperty, optionsTransformer, }: Props) => {
     configSelectProps: {
         onChange: (e: SelectCallback) => void;

package/ui/hooks/use-config-property.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-config-property.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/ui/hooks/use-config-property.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EAMZ,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,KAAK,cAAc,GAAG,MAAM,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAAC;AAC9D,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,KAAK,GAAG,EAAE,CAAC;AAEpE,KAAK,aAAa,GACd,iBAAiB,CAAC,mBAAmB,CAAC,GACtC,iBAAiB,CAAC,MAAM,CAAC,GACzB,iBAAiB,CAAC,MAAM,CAAC,GACzB,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAC/B,UAAU,KAAK;IACb,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AA2BD,eAAO,MAAM,iBAAiB,oEAG3B,KAAK;;sBAkBA,cAAc;;;;;;;;uBAvCF,GAAG;;;;8BAII,MAAM,KAAK,IAAI;;CAuGzC,CAAC"}
+{"version":3,"file":"use-config-property.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/ui/hooks/use-config-property.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EAMZ,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,KAAK,cAAc,GAAG,MAAM,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAAC;AAC9D,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,KAAK,GAAG,EAAE,CAAC;AAEpE,KAAK,aAAa,GACd,iBAAiB,CAAC,mBAAmB,CAAC,GACtC,iBAAiB,CAAC,MAAM,CAAC,GACzB,iBAAiB,CAAC,MAAM,CAAC,GACzB,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAC/B,UAAU,KAAK;IACb,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AA2BD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,oEAG3B,KAAK;;sBAkBA,cAAc;;;;;;;;uBA7CF,GAAG;;;;8BAII,MAAM,KAAK,IAAI;;CA6GzC,CAAC"}

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

@@ -7,7 +7,14 @@ interface Options<T extends IKosDataModel, O extends Object = {}> {
     options?: O;
     activate?: boolean;
     destroyOnUnmount?: boolean;
+    forceUpdate?: boolean;
 }
+/**
+ * Primary hook for consuming KOS models in React components.
+ *
+ * @kosService core.use-kos-model
+ * @kosApiLevel 2
+ */
 export declare const useKosModel: <T extends IKosDataModel, O extends Object = {}>(modelOptions: Options<T, O>) => {
     model: T | undefined;
     ready: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"use-kos-model.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/ui/hooks/use-kos-model.ts"],"names":[],"mappings":";AAAA,OAAO,EAGL,aAAa,EAGb,YAAY,EACb,MAAM,YAAY,CAAC;AAQpB,UAAU,OAAO,CAAC,CAAC,SAAS,aAAa,EAAE,CAAC,SAAS,MAAM,GAAG,EAAE;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AA8FD,eAAO,MAAM,WAAW,iEACR,QAAQ,CAAC,EAAE,CAAC,CAAC;;;;;;;;;;CA8F5B,CAAC"}
+{"version":3,"file":"use-kos-model.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/ui/hooks/use-kos-model.ts"],"names":[],"mappings":";AAAA,OAAO,EAGL,aAAa,EAGb,YAAY,EACb,MAAM,YAAY,CAAC;AASpB,UAAU,OAAO,CAAC,CAAC,SAAS,aAAa,EAAE,CAAC,SAAS,MAAM,GAAG,EAAE;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA8FD;;;;;GAKG;AACH,eAAO,MAAM,WAAW,iEACR,QAAQ,CAAC,EAAE,CAAC,CAAC;;;;;;;;;;CAsG5B,CAAC"}

package/ui/hooks/use-kos-regions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-kos-regions.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/ui/hooks/use-kos-regions.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAoC,MAAM,OAAO,CAAC;AAMtE,OAAO,EAGL,cAAc,EACd,KAAK,eAAe,EACrB,MAAM,iCAAiC,CAAC;AAQzC,KAAK,cAAc,GAAG,MAAM,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAAC;AAC9D,KAAK,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,KAAK,CAAC,CAAC;AAO/D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAChC,UAAU,SAAS,cAAc,CAAC,kBAAkB,GAAG,cAAc,CAAC,kBAAkB,EACxF,CAAC,SAAS,MAAM,GAAG,GAAG;IAEtB,4DAA4D;IAC5D,GAAG,EAAE,MAAM,EAAE,CAAC;IAEd,yDAAyD;IACzD,WAAW,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;IAE1C,yDAAyD;IACzD,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAC;IAEvB,uDAAuD;IACvD,YAAY,EAAE,CAAC,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;IAE1C,+DAA+D;IAC/D,iBAAiB,EAAE;QACjB,QAAQ,EAAE,CAAC,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;QACtC,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,CAAC,EAAE,CAAC;KACd,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,aAAa,6HAIb,UAAU,CAAC,CAAC,KACtB,kBAAkB,UAAU,EAAE,CAAC,CAgEjC,CAAC"}
+{"version":3,"file":"use-kos-regions.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/ui/hooks/use-kos-regions.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAoC,MAAM,OAAO,CAAC;AAMtE,OAAO,EAGL,cAAc,EACd,KAAK,eAAe,EACrB,MAAM,iCAAiC,CAAC;AAQzC,KAAK,cAAc,GAAG,MAAM,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAAC;AAC9D,KAAK,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,KAAK,CAAC,CAAC;AAO/D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAChC,UAAU,SAAS,cAAc,CAAC,kBAAkB,GAAG,cAAc,CAAC,kBAAkB,EACxF,CAAC,SAAS,MAAM,GAAG,GAAG;IAEtB,4DAA4D;IAC5D,GAAG,EAAE,MAAM,EAAE,CAAC;IAEd,yDAAyD;IACzD,WAAW,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;IAE1C,yDAAyD;IACzD,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAC;IAEvB,uDAAuD;IACvD,YAAY,EAAE,CAAC,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;IAE1C,+DAA+D;IAC/D,iBAAiB,EAAE;QACjB,QAAQ,EAAE,CAAC,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;QACtC,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,CAAC,EAAE,CAAC;KACd,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,aAAa,6HAIb,UAAU,CAAC,CAAC,KACtB,kBAAkB,UAAU,EAAE,CAAC,CA+DjC,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"}

package/models/models/trouble-container/trouble-container-registration.d.ts

@@ -1,5 +0,0 @@
-import { TroubleContainerModel, TroubleContainerOptions } from './types';
-import { SingletonKosModelRegistrationBean } from '../../../core';
-
-export declare const TroubleContainer: Readonly<SingletonKosModelRegistrationBean<TroubleContainerModel, TroubleContainerOptions>>;
-//# sourceMappingURL=trouble-container-registration.d.ts.map

package/models/models/trouble-container/trouble-container-registration.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"trouble-container-registration.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/models/models/trouble-container/trouble-container-registration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,eAAe,CAAC;AAGvE,OAAO,KAAK,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAmF9E,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CACrC,iCAAiC,CAC/B,qBAAqB,EACrB,uBAAuB,CACxB,CAaF,CAAC"}

package/models/utils/kosmodel-compatible-future-mixin.d.ts

@@ -1,142 +0,0 @@
-import { FutureAwareContainer, FutureContainer } from '../models/future/future-types';
-import { IKosDataModel } from '../../core/core/kosModel';
-
-/**
- * KosModel-compatible mixin that provides all the FutureContainer boilerplate
- * This version is designed to work with @kosModel's automatic makeAutoObservable() call
- */
-export declare class KosModelFutureContainerMixin<T extends object = Record<string, unknown>> implements FutureContainer<T> {
-    futureHandler: FutureAwareContainer<T>;
-    constructor(model: IKosDataModel);
-    get future(): import('../models/future/future-types').IFutureModel<T> | undefined;
-    get progress(): number;
-    get status(): string;
-    get isRunning(): boolean;
-    get isCancelled(): boolean;
-    cancelFuture(): Promise<void>;
-}
-/**
- * Setup minimal Future support - only adds futureHandler for @kosFuture methods
- * Use this when you only need Future methods to work internally but don't expose the interface
- *
- * Perfect for the nozzle-model pattern where:
- * - The impl class only declares futureHandler
- * - The external type adds ExternalFutureInterface via intersection
- * - No need for declare statements for progress/status/etc in the impl
- */
-export declare function setupMinimalFutureSupport<T extends IKosDataModel>(model: T): void;
-/**
- * Setup complete Future support with all getters and methods
- * Use this when you need full Future capabilities both internally and externally
- *
- * This means:
- * - When the Future's progress/status changes, UI components will reactively update
- * - The getters track the observable properties in the underlying FutureModel
- * - This is exactly what you want for reactive UI updates!
- *
- * @example
- * // @kosModel("my-model")
- * // export class MyModelImpl implements IKosDataModel, CompleteFutureContainer {
- * //   id: string;
- * //
- * //   // These will be set by setupCompleteFutureSupport()
- * //   declare futureHandler: FutureAwareContainer<Record<string, unknown>>;
- * //   declare future: any;
- * //   declare progress: number;
- * //   declare status: string;
- * //   declare isRunning: boolean;
- * //   declare isCancelled: boolean;
- * //   declare cancelFuture: () => Promise<void>;
- * //
- * //   constructor(modelId: string, options: any, context: KosCreationContext) {
- * //     this.id = modelId;
- * //     setupCompleteFutureSupport(this);
- * //   }
- * //
- * //   @kosFuture()
- * //   async performOperation() { return "done"; }
- * // }
- * //
- * // export type MyModel = PublicModelInterface<MyModelImpl>;
- */
-export declare function setupCompleteFutureSupport<T extends IKosDataModel>(model: T): void;
-/**
- * Alternative decorator approach that works with @kosModel
- * This decorator must be applied AFTER @kosModel
- *
- * @example
- * // @kosModel("my-model")
- * // @withKosModelFutures()  // AFTER @kosModel
- * // export class MyModel implements IKosDataModel {
- * //   id: string;
- * //
- * //   constructor(modelId: string, options: any, context: KosCreationContext) {
- * //     this.id = modelId;
- * //     // No need to call setup function with decorator approach
- * //   }
- * //
- * //   @kosFuture()
- * //   async performOperation() { return "done"; }
- * //
- * //   unload() {}
- * // }
- */
-export declare function withKosModelFutures(): (constructor: any) => any;
-/**
- * Composition helper that works with @kosModel
- * Use this if you prefer composition over setup function
- *
- * @example
- * Example usage:
- *
- * @kosModel("my-model")
- * export class MyModel implements IKosDataModel, FutureContainer {
- *   id: string;
- *   private futures = createKosModelFutureManager(this);
- *
- *   // Delegate FutureContainer interface
- *   get futureHandler() { return this.futures.futureHandler; }
- *   get future() { return this.futures.future; }
- *   get progress() { return this.futures.progress; }
- *   get status() { return this.futures.status; }
- *   get isRunning() { return this.futures.isRunning; }
- *   get isCancelled() { return this.futures.isCancelled; }
- *   async cancelFuture() { return this.futures.cancelFuture(); }
- *
- *   constructor(modelId: string, options: any, context: KosCreationContext) {
- *     this.id = modelId;
- *   }
- *
- *   async performOperation() { return "done"; }
- *   unload() {}
- * }
- */
-export declare function createKosModelFutureManager<T extends IKosDataModel>(model: T): KosModelFutureContainerMixin<Record<string, unknown>>;
-/**
- * Enhanced composition helper with lazy initialization
- * This version delays future manager creation until first access
- * Useful if the manager needs to be created after the model is fully constructed
- */
-export declare function createLazyKosModelFutureManager<T extends IKosDataModel>(getModel: () => T): {
-    readonly futureHandler: FutureAwareContainer<Record<string, unknown>>;
-    readonly future: import('../models/future/future-types').IFutureModel<Record<string, unknown>> | undefined;
-    readonly progress: number;
-    readonly status: string;
-    readonly isRunning: boolean;
-    readonly isCancelled: boolean;
-    cancelFuture(): Promise<void>;
-};
-/**
- * Type helper for models that use KosModel future support
- */
-export type KosModelWithFutures<T> = T & FutureContainer;
-/**
- * Utility to check if a model has been set up with KosModel future support
- */
-export declare function hasKosModelFutureSupport(model: any): model is FutureContainer;
-/**
- * Development utility to inspect the observable state of Future properties
- * Useful for debugging MobX integration issues
- */
-export declare function inspectFutureObservability(model: any): Record<string, any>;
-//# sourceMappingURL=kosmodel-compatible-future-mixin.d.ts.map

package/models/utils/kosmodel-compatible-future-mixin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"kosmodel-compatible-future-mixin.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/models/utils/kosmodel-compatible-future-mixin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EAChB,MAAM,+BAA+B,CAAC;AAEvC;;;GAGG;AACH,qBAAa,4BAA4B,CACvC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAC1C,YAAW,eAAe,CAAC,CAAC,CAAC;IAE7B,aAAa,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;gBAE3B,KAAK,EAAE,aAAa;IAIhC,IAAI,MAAM,wEAET;IAED,IAAI,QAAQ,WAEX;IAED,IAAI,MAAM,WAET;IAED,IAAI,SAAS,YAEZ;IAED,IAAI,WAAW,YAEd;IAEK,YAAY;CAKnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,aAAa,EAAE,KAAK,EAAE,CAAC,QAG1E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,aAAa,EAAE,KAAK,EAAE,CAAC,QAuD3E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,kBACH,GAAG,SA+BlC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,aAAa,EAAE,KAAK,EAAE,CAAC,yDAE5E;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,CAAC,SAAS,aAAa,EACrE,QAAQ,EAAE,MAAM,CAAC;;;;;;;;EAkClB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC;AAEzD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,eAAe,CAQ7E;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,GAAG,uBAkCpD"}

package/models/utils/kosmodel-interface-companion-mixin.d.ts

@@ -1,83 +0,0 @@
-import { PublicModelInterface } from '../../core/types';
-import { IKosDataModel } from '../../core/core/kosModel';
-
-/**
- * External interface for companion decorators
- * This is what gets added to the public model type, similar to ExternalFutureInterface
- */
-export interface ExternalCompanionInterface<TParent extends IKosDataModel> {
-    /**
-     * Get the parent model instance
-     */
-    getParent(): TParent;
-}
-/**
- * Mixin class that provides companion decorator functionality
- * This can be composed into any companion model without inheritance issues
- */
-export declare class CompanionDecoratorMixin<TParent extends IKosDataModel> {
-    private parent;
-    private companion;
-    constructor(companion: IKosDataModel, parent: TParent);
-    /**
-     * Get the parent model instance
-     */
-    getParent(): TParent;
-    /**
-     * Setup proxy properties for parent's public interface
-     * This is called after the companion's constructor to avoid MobX issues
-     */
-    setupProxy(options?: {
-        excludeProperties?: string[];
-        includeLifecycle?: boolean;
-    }): void;
-    private getAllParentProperties;
-    private createProxyProperty;
-}
-/**
- * Setup function for drop-in replacement companions
- *
- * ⚠️  Use this ONLY when you need seamless parent model replacement.
- * ✅  For most cases, prefer simple composition: `public readonly parent: ParentModel`
- *
- * This creates transparent proxies to all parent properties/methods.
- */
-export declare function setupCompanionDecoratorMixin<TParent extends IKosDataModel>(companion: IKosDataModel, parent: TParent, options?: {
-    excludeProperties?: string[];
-    includeLifecycle?: boolean;
-}): CompanionDecoratorMixin<TParent>;
-/**
- * Type utility for companions using the interface mixin approach
- * This provides proper typing for the resulting companion
- */
-export type CompanionWithMixin<TParent extends IKosDataModel, TExtensions = Record<string, never>> = TExtensions & ExternalCompanionInterface<TParent> & IKosDataModel & Omit<PublicModelInterface<TParent>, keyof IKosDataModel>;
-/**
- * Type helper for adding companion support to models
- * This adds the parent's interface and companion functionality to your model
- */
-export type WithCompanionSupport<TModel extends IKosDataModel, TParent extends IKosDataModel, TExtensions = Record<string, never>> = TModel & CompanionWithMixin<TParent, TExtensions>;
-/**
- * Helper function to check if a model has companion mixin support
- */
-export declare function hasCompanionMixin(model: any): boolean;
-/**
- * Get the companion mixin instance from a model
- */
-export declare function getCompanionMixin<TParent extends IKosDataModel>(companion: any): CompanionDecoratorMixin<TParent> | null;
-/**
- * Development utility to inspect companion mixin setup (optional debugging tool)
- */
-export declare function inspectCompanionMixin(companion: any): {
-    error: string;
-    parentType?: undefined;
-    companionType?: undefined;
-    proxiedProps?: undefined;
-    proxiedCount?: undefined;
-} | {
-    parentType: string;
-    companionType: any;
-    proxiedProps: string[];
-    proxiedCount: number;
-    error?: undefined;
-};
-//# sourceMappingURL=kosmodel-interface-companion-mixin.d.ts.map

package/models/utils/kosmodel-interface-companion-mixin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"kosmodel-interface-companion-mixin.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/models/utils/kosmodel-interface-companion-mixin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,0BAA0B,CAAC,OAAO,SAAS,aAAa;IACvE;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,uBAAuB,CAAC,OAAO,SAAS,aAAa;IAChE,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,SAAS,CAAgB;gBAErB,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO;IAKrD;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;OAGG;IACH,UAAU,CACR,OAAO,GAAE;QACP,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;KACvB,GACL,IAAI;IAuDP,OAAO,CAAC,sBAAsB;IAsB9B,OAAO,CAAC,mBAAmB;CA+B5B;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,SAAS,aAAa,EACxE,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,OAAO,EACf,OAAO,GAAE;IACP,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACvB,GACL,uBAAuB,CAAC,OAAO,CAAC,CAkBlC;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAC5B,OAAO,SAAS,aAAa,EAC7B,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IACjC,WAAW,GACb,0BAA0B,CAAC,OAAO,CAAC,GACnC,aAAa,GAEb,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,MAAM,aAAa,CAAC,CAAC;AAE3D;;;GAGG;AACH,MAAM,MAAM,oBAAoB,CAC9B,MAAM,SAAS,aAAa,EAC5B,OAAO,SAAS,aAAa,EAC7B,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IACjC,MAAM,GAAG,kBAAkB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AAEtD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAOrD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,SAAS,aAAa,EAC7D,SAAS,EAAE,GAAG,GACb,uBAAuB,CAAC,OAAO,CAAC,GAAG,IAAI,CAKzC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,GAAG;;;;;;;;;;;;EAuBnD"}