@kosdev-code/kos-ui-sdk 2.1.26 → 2.1.28

package/core/core/decorators/kos-container-aware.d.ts

@@ -22,7 +22,8 @@ export interface KosContainerAwareOptions<T extends IKosDataModel = IKosDataMode
      */
     containerProperty?: string;
     /**
-     * Whether to include convenience methods (getModel, addModel, removeModel).
+     * Whether to include convenience methods (getModel, addModel, removeModel, addAll, removeAll,
+     * removeAndDestroy, removeAndDestroyAll).
      *
      * @default true
      * @example
@@ -60,7 +61,9 @@ export interface KosContainerAwareOptions<T extends IKosDataModel = IKosDataMode
      *       active: (device) => device.isOnline
      *     },
      *     parentId: "custom-parent", // Overrides automatic inference
-     *     extensionId: "device-manager"
+     *     extensionId: "device-manager",
+     *     maxCapacity: 1000,  // Safety net for unbounded growth
+     *     evictionStrategy: "fifo"
      *   }
      * })
      * ```
@@ -92,6 +95,52 @@ export interface KosContainerAwareOptions<T extends IKosDataModel = IKosDataMode
         parentId?: string;
         /** Extension identifier for the container */
         extensionId?: string;
+        /**
+         * SAFETY NET: Maximum number of models this container can hold.
+         * When exceeded, models are automatically evicted and destroyed based on evictionStrategy.
+         *
+         * **Primary use case**: Prevent memory overflow when cleanup handlers are missing or
+         * data becomes inconsistent. Set higher than normal usage to catch edge cases.
+         *
+         * @example
+         * ```typescript
+         * containerOptions: {
+         *   maxCapacity: 10000,  // Safety net: expect ~100-1000 normally
+         *   evictionStrategy: 'fifo'
+         * }
+         * ```
+         */
+        maxCapacity?: number;
+        /**
+         * Strategy for selecting which models to evict when maxCapacity is exceeded.
+         *
+         * - **fifo** (default): Remove oldest models first - best for event streams, logs
+         * - **lru**: Remove least recently accessed models - best for caches
+         * - **custom**: Use customEvictionFilter to determine eviction candidates
+         *
+         * @default 'fifo'
+         */
+        evictionStrategy?: "fifo" | "lru" | "custom";
+        /**
+         * Number of models to evict when maxCapacity is exceeded.
+         * @default Math.max(10, Math.ceil(maxCapacity * 0.1))
+         */
+        evictionBatchSize?: number;
+        /**
+         * Custom filter function for 'custom' eviction strategy.
+         * Should return models that are candidates for eviction.
+         *
+         * @example
+         * ```typescript
+         * customEvictionFilter: (models) => {
+         *   return models.filter(m =>
+         *     m.status === 'resolved' &&
+         *     Date.now() - m.resolvedAt > 3600000
+         *   );
+         * }
+         * ```
+         */
+        customEvictionFilter?: (models: T[]) => T[];
     };
     /**
      * Custom name for the reactive models array getter.
@@ -156,7 +205,11 @@ export interface KosContainerAwareOptions<T extends IKosDataModel = IKosDataMode
  * - **`container`**: Core KosModelContainer instance for direct access (or custom name via `containerProperty`)
  * - **`getModel(id)`**: Retrieve a model by ID from the container
  * - **`addModel(model)`**: Add a model to the container
- * - **`removeModel(id)`**: Remove a model from the container by ID
+ * - **`removeModel(id)`**: Remove a model from the container by ID (does not destroy)
+ * - **`addAll(models)`**: Add multiple models to the container at once
+ * - **`removeAll(ids)`**: Remove multiple models from the container by IDs (does not destroy)
+ * - **`removeAndDestroy(id)`**: Remove a model from the container and destroy it
+ * - **`removeAndDestroyAll(ids)`**: Remove multiple models from the container and destroy them
  * - **`models`**: Readonly KosModelContainer instance (compatible with IKosModelHolder)
  * - **`data`**: Reactive array of all model instances (compatible with IKosModelHolder)
  *
@@ -243,6 +296,28 @@ export interface KosContainerAware<T extends IKosDataModel = IKosDataModel> {
      * @param id - The unique identifier of the model to remove
      */
     removeModel(id: string): void;
+    /**
+     * Adds multiple models to the container at once.
+     * @param models - Array of model instances to add
+     */
+    addAll(models: T[]): void;
+    /**
+     * Removes multiple models from the container by their IDs.
+     * @param ids - Array of unique identifiers of the models to remove
+     */
+    removeAll(ids: string[]): void;
+    /**
+     * Removes a model from the container and destroys it.
+     * Convenience method that combines removeModel() and destroyKosModel().
+     * @param id - The unique identifier of the model to remove and destroy
+     */
+    removeAndDestroy(id: string): Promise<void>;
+    /**
+     * Removes multiple models from the container and destroys them.
+     * Convenience method that combines removeAll() and destroyKosModel().
+     * @param ids - Array of unique identifiers of the models to remove and destroy
+     */
+    removeAndDestroyAll(ids: string[]): Promise<void>;
     /**
      * The container instance managing the models.
      * Readonly property that provides access to the KosModelContainer.
@@ -280,6 +355,28 @@ export interface KosContainerAwareBase<T extends IKosDataModel = IKosDataModel>
      * @param id - The unique identifier of the model to remove
      */
     removeModel(id: string): void;
+    /**
+     * Adds multiple models to the container at once.
+     * @param models - Array of model instances to add
+     */
+    addAll(models: T[]): void;
+    /**
+     * Removes multiple models from the container by their IDs.
+     * @param ids - Array of unique identifiers of the models to remove
+     */
+    removeAll(ids: string[]): void;
+    /**
+     * Removes a model from the container and destroys it.
+     * Convenience method that combines removeModel() and destroyKosModel().
+     * @param id - The unique identifier of the model to remove and destroy
+     */
+    removeAndDestroy(id: string): Promise<void>;
+    /**
+     * Removes multiple models from the container and destroys them.
+     * Convenience method that combines removeAll() and destroyKosModel().
+     * @param ids - Array of unique identifiers of the models to remove and destroy
+     */
+    removeAndDestroyAll(ids: string[]): Promise<void>;
     /**
      * The container instance managing the models.
      * Readonly property that provides access to the KosModelContainer.
@@ -356,7 +453,7 @@ export type KosContainerAwareWithProp<T extends IKosDataModel = IKosDataModel, P
  *
  * This decorator eliminates the need for manual container setup by:
  * - **Adding a container property** (default: `container`) for managing model collections
- * - **Adding convenience methods** (`getModel`, `addModel`, `removeModel`) if `includeMethods` is true (default)
+ * - **Adding convenience methods** (`getModel`, `addModel`, `removeModel`, `addAll`, `removeAll`, `removeAndDestroy`, `removeAndDestroyAll`) if `includeMethods` is true (default)
  * - **Adding reactive getters** (`models`, `data`) if `includeGetters` is true (default)
  * - **Automatically inferring parentId** from the model's constructor `modelId` parameter
  * - **Registering container as @kosChild** for proper lifecycle management and cleanup
@@ -383,6 +480,42 @@ export type KosContainerAwareWithProp<T extends IKosDataModel = IKosDataModel, P
  * }
  * ```
  *
+ * ## Model Lifecycle: removeModel vs removeAndDestroy
+ *
+ * The decorator provides both removal and destruction methods with different purposes:
+ *
+ * **removeModel(id) / removeAll(ids)** - Removes from container WITHOUT destroying:
+ * - Use when moving models between containers
+ * - Use when temporarily hiding models that may be re-added
+ * - Use when model lifecycle is managed elsewhere
+ * - Container handles cleanup of observers and metadata
+ * - Model remains in memory and can be used elsewhere
+ *
+ * **removeAndDestroy(id) / removeAndDestroyAll(ids)** - Removes AND destroys:
+ * - Use when permanently removing models from the system
+ * - Use when models should be fully cleaned up and disposed
+ * - Calls destroyKosModel() automatically after removal
+ * - Ensures proper cleanup of all model resources
+ * - Model is removed from framework and memory
+ *
+ * ```typescript
+ * // Example: Explicit lifecycle control
+ * @kosTopicHandler({ topic: "/device/sensor/removed" })
+ * handleSensorRemoved(id: string) {
+ *   // Permanently remove - sensor is gone from system
+ *   await this.removeAndDestroy(id);
+ * }
+ *
+ * // Example: Reorganization without destruction
+ * moveSensorToArchive(id: string) {
+ *   const sensor = this.getModel(id);
+ *   if (sensor) {
+ *     this.removeModel(id);           // Remove from active container
+ *     this.archive.addModel(sensor);  // Add to archive container
+ *   }
+ * }
+ * ```
+ *
  * ## Configuration Options
  *
  * ```typescript

package/core/core/decorators/kos-container-aware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kos-container-aware.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/decorators/kos-container-aware.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"kos-container-aware.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/decorators/kos-container-aware.ts"],"names":[],"mappings":"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"}

package/core/core/decorators/kosModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kosModel.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/decorators/kosModel.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAklB5C,UAAU,cAAc;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACtC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,cAAc,CA0DjD"}
+{"version":3,"file":"kosModel.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/core/decorators/kosModel.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA6lB5C,UAAU,cAAc;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACtC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,cAAc,CA0DjD"}

package/core/core/kos-container-model.d.ts

@@ -26,13 +26,96 @@ export interface IKosModelContainer<T extends IKosDataModel> extends IKosBaseCon
     getModel: (id: string) => T | undefined;
     getIndexByKey: (indexName: string, indexKey: string) => T[];
     getIndexKeys: (indexName: string) => string[];
+    removeAndDestroy: (id: string) => Promise<void>;
+    removeAndDestroyAll: (ids: string[]) => Promise<void>;
     toJSON?: () => object;
 }
+/**
+ * Eviction strategy for container capacity management
+ *
+ * - **fifo**: First-In-First-Out - removes oldest models first (default for event streams)
+ * - **lru**: Least Recently Used - removes models not accessed recently (good for caches)
+ * - **custom**: Uses customEvictionFilter function to determine which models to evict
+ *
+ * @category Container Capacity Management
+ * @see {@link ContainerOptions.maxCapacity}
+ * @see {@link ContainerOptions.evictionStrategy}
+ */
+export type EvictionStrategy = "fifo" | "lru" | "custom";
 interface ContainerOptions<T extends IKosDataModel> {
     sortKey?: keyof T;
     indexMap?: Record<string, keyof T | IndexMapper<T>>;
     parentId?: string;
     extensionId?: string;
+    /**
+     * SAFETY NET: Maximum number of models this container can hold.
+     * When exceeded, models are automatically evicted and destroyed based on evictionStrategy.
+     *
+     * **Primary use case**: Prevent memory overflow when cleanup handlers are missing or
+     * data becomes inconsistent. Set higher than normal usage to catch edge cases.
+     *
+     * **Eviction is logged**: All automatic evictions are logged at WARNING level
+     * to aid in debugging and identifying data inconsistencies.
+     *
+     * @category Capacity Management
+     * @see {@link EvictionStrategy}
+     * @see {@link evictionBatchSize}
+     *
+     * @example
+     * ```typescript
+     * containerOptions: {
+     *   maxCapacity: 10000,  // Safety net: expect ~100-1000 normally
+     *   evictionStrategy: 'fifo'
+     * }
+     * ```
+     */
+    maxCapacity?: number;
+    /**
+     * Strategy for selecting which models to evict when maxCapacity is exceeded.
+     *
+     * - **fifo** (default): Remove oldest models first - best for event streams, logs
+     * - **lru**: Remove least recently accessed models - best for caches
+     * - **custom**: Use customEvictionFilter to determine eviction candidates
+     *
+     * @category Capacity Management
+     * @see {@link EvictionStrategy}
+     * @see {@link maxCapacity}
+     * @see {@link customEvictionFilter}
+     *
+     * @default 'fifo'
+     */
+    evictionStrategy?: EvictionStrategy;
+    /**
+     * Number of models to evict when maxCapacity is exceeded.
+     * Removing in batches prevents thrashing at the capacity boundary.
+     *
+     * @category Capacity Management
+     * @see {@link maxCapacity}
+     *
+     * @default Math.max(10, Math.ceil(maxCapacity * 0.1))
+     */
+    evictionBatchSize?: number;
+    /**
+     * Custom filter function for 'custom' eviction strategy.
+     * Should return models that are candidates for eviction.
+     * The container will evict up to evictionBatchSize models from the returned array.
+     *
+     * @category Capacity Management
+     * @see {@link EvictionStrategy}
+     * @see {@link maxCapacity}
+     *
+     * @example
+     * ```typescript
+     * // Evict resolved troubles older than 1 hour
+     * customEvictionFilter: (models) => {
+     *   return models.filter(m =>
+     *     m.status === 'resolved' &&
+     *     Date.now() - m.resolvedAt > 3600000
+     *   );
+     * }
+     * ```
+     */
+    customEvictionFilter?: (models: T[]) => T[];
 }
 export declare class KosModelContainer<T extends IKosDataModel> implements IKosModelContainer<T> {
     _data: Map<string, T>;
@@ -43,6 +126,12 @@ export declare class KosModelContainer<T extends IKosDataModel> implements IKosM
     private _disposerMap;
     private _parentId?;
     idx: KosData<Record<string, Record<string, T[]>>>;
+    private _maxCapacity?;
+    private _evictionStrategy;
+    private _evictionBatchSize;
+    private _insertionOrder;
+    private _accessTimes?;
+    private _customEvictionFilter?;
     constructor(options?: ContainerOptions<T>);
     init(): void;
     [Symbol.iterator](): IterableIterator<T>;
@@ -54,12 +143,111 @@ export declare class KosModelContainer<T extends IKosDataModel> implements IKosM
     increment(): void;
     addAll(models: T[]): void;
     removeAll(ids: string[]): void;
+    /**
+     * Remove a model from the container and destroy it.
+     * This is a convenience method that combines removeModel() and destroyKosModel().
+     *
+     * Use this when:
+     * - The model is being permanently removed from the system
+     * - The model should be cleaned up and disposed
+     *
+     * Use removeModel() alone when:
+     * - Moving models between containers
+     * - Temporarily removing without destroying
+     * - Managing models that may be re-added later
+     *
+     * @param id - The unique identifier of the model to remove and destroy
+     */
+    removeAndDestroy(id: string): Promise<void>;
+    /**
+     * Remove multiple models from the container and destroy them.
+     * This is a convenience method that combines removeAll() and destroyKosModel().
+     *
+     * Operations are performed in parallel for efficiency, but each destruction
+     * is independent - failures in one won't prevent others from being destroyed.
+     *
+     * @param ids - Array of unique identifiers of the models to remove and destroy
+     * @returns Promise that resolves when all models have been removed and destroyed
+     */
+    removeAndDestroyAll(ids: string[]): Promise<void>;
+    /**
+     * Add a model to the container (Zone 2: Workflow orchestration)
+     *
+     * @param model - The model to add
+     * @param defer - If true, skip incrementing revision (for batch operations)
+     */
     addModel(model: T, defer?: boolean): void;
+    /**
+     * Persist model to container storage (Zone 3)
+     * @private
+     */
+    private _persistModel;
+    /**
+     * Track model metadata for capacity management (Zone 3)
+     * @private
+     */
+    private _trackModelMetadata;
+    /**
+     * Establish parent-child relationships (Zone 3)
+     * @private
+     */
+    private _establishModelRelationships;
+    /**
+     * Enforce capacity limits and trigger eviction if needed (Zone 3)
+     * @private
+     */
+    private _enforceCapacityLimits;
+    /**
+     * Configure MobX observers for model property changes (Zone 3)
+     * @private
+     */
+    private _configureModelMonitoring;
     removeModel(id: string, defer?: boolean): void;
     updateModel(model: T): void;
     getModel(id: string): T | undefined;
     getIndexKeys(indexName: string): string[];
     getIndexByKey(indexName: string, indexKey: string): T[];
+    /**
+     * SAFETY NET: Evict models when capacity is exceeded (Zone 2: Workflow orchestration)
+     * Logs all evictions at WARNING level for debugging.
+     * @private
+     */
+    private _evictModels;
+    /**
+     * Log capacity exceeded warning (Zone 3)
+     * @private
+     */
+    private _logCapacityWarning;
+    /**
+     * Select models for eviction based on strategy (Zone 3)
+     * @private
+     */
+    private _selectModelsForEviction;
+    /**
+     * Select oldest models for FIFO eviction (Zone 3)
+     * @private
+     */
+    private _selectFifoModels;
+    /**
+     * Select least recently used models for LRU eviction (Zone 3)
+     * @private
+     */
+    private _selectLruModels;
+    /**
+     * Select models using custom filter for eviction (Zone 3)
+     * @private
+     */
+    private _selectCustomModels;
+    /**
+     * Remove and destroy evicted models (Zone 3)
+     * @private
+     */
+    private _removeEvictedModels;
+    /**
+     * Log eviction completion (Zone 3)
+     * @private
+     */
+    private _logEvictionComplete;
     clear(): Promise<void>;
     filter<S extends any>(predicate: (value: any, index: number, array: any[]) => value is S, thisArg?: any): T[];
     sort(compareFn?: ((a: any, b: any) => number) | undefined): T[];

package/core/core/kos-container-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kos-container-model.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/core/kos-container-model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"kos-container-model.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/core/kos-container-model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkFG;AAYH,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAG5E,OAAO,EACL,kBAAkB,EAClB,WAAW,EAEZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,gBAAgB;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAClD,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IAChD,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;IAC9B,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACnC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,CAAC,GAAG,SAAS,CAAC;IACxC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,GAAG,EAAE,CAAC,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,EAAE,CAAC,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,EAAE,CAAC,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAC1C;AA2BD,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,aAAa,CACzD,SAAQ,iBAAiB,CAAC,CAAC,CAAC;IAC5B,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAChC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,CAAC,GAAG,SAAS,CAAC;IACxC,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;IAC5D,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IAC9C,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,mBAAmB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CACvB;AAID;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEzD,UAAU,gBAAgB,CAAC,CAAC,SAAS,aAAa;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC;;;;;;;;OAQG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;CAC7C;AACD,qBAAa,iBAAiB,CAAC,CAAC,SAAS,aAAa,CACpD,YAAW,kBAAkB,CAAC,CAAC,CAAC;IAEhC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,CAAW;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAGlD,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,YAAY,CAAC,CAAsB;IAC3C,OAAO,CAAC,qBAAqB,CAAC,CAAuB;gBAEzC,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAwCzC,IAAI;IAWJ,CAAC,MAAM,CAAC,QAAQ,CAAC;IAIjB,IAAI,KAAK,uCAER;IACD,IAAI,QAAQ,WAEX;IAED,IAAI,SAAS,yCAOZ;IAED,MAAM,CAAC,CAAC,KAAA,EAAE,CAAC,KAAA,GAAG,MAAM;IAWpB,IAAI,IAAI,QAOP;IAED,SAAS;IAMT,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE;IAOlB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE;IAOvB;;;;;;;;;;;;;;OAcG;IACG,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjD;;;;;;;;;OASG;IACG,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCvD;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO;IAalC;;;OAGG;IACH,OAAO,CAAC,aAAa;IAIrB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAMpC;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAQ9B;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IA2CjC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;IAuBvC,WAAW,CAAC,KAAK,EAAE,CAAC;IAKpB,QAAQ,CAAC,EAAE,EAAE,MAAM;IAWnB,YAAY,CAAC,SAAS,EAAE,MAAM;IAW9B,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAqBjD;;;;OAIG;YACW,YAAY;IAiB1B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAahC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAczB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAmBxB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;;OAGG;YACW,oBAAoB;IAmBlC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAQtB,KAAK;IAaX,MAAM,CAAC,CAAC,SAAS,GAAG,EAClB,SAAS,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC,EAClE,OAAO,CAAC,EAAE,GAAG;IAKf,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,KAAK,MAAM,CAAC,GAAG,SAAS;IAGzD,GAAG,CAAC,CAAC,EACH,UAAU,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,EAC1D,OAAO,CAAC,EAAE,GAAG;IAKf,OAAO,CACL,UAAU,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,EAC7D,OAAO,CAAC,EAAE,GAAG;IAKf,MAAM;;;;;;;CAYP"}

package/core/core/kos-data-container.d.ts

@@ -1,5 +1,5 @@
 import { IKosIdentifiable } from './types/model';
-import { IKosBaseContainer } from './kos-container-model';
+import { IKosBaseContainer, EvictionStrategy } from './kos-container-model';
 import { IKosContainerIndex, IndexMapper } from './kos-container-index';
 import { KosData } from '../util/observable-proxy-map';
 
@@ -12,6 +12,14 @@ export interface IKosDataContainer<T extends IKosIdentifiable> extends IKosBaseC
 interface ContainerOptions<T extends IKosIdentifiable> {
     sortKey?: keyof T;
     indexMap?: Record<string, keyof T | IndexMapper<T>>;
+    /** SAFETY NET: Maximum capacity before eviction */
+    maxCapacity?: number;
+    /** Eviction strategy when maxCapacity is exceeded */
+    evictionStrategy?: EvictionStrategy;
+    /** Number of items to evict when capacity exceeded */
+    evictionBatchSize?: number;
+    /** Custom eviction filter for 'custom' strategy */
+    customEvictionFilter?: (models: T[]) => T[];
 }
 export declare class KosDataContainer<T extends IKosIdentifiable> implements IKosDataContainer<T> {
     _data: Map<string, T>;
@@ -21,6 +29,12 @@ export declare class KosDataContainer<T extends IKosIdentifiable> implements IKo
     private _optionsMap;
     private _disposerMap;
     idx: KosData<Record<string, Record<string, T[]>>>;
+    private _maxCapacity?;
+    private _evictionStrategy;
+    private _evictionBatchSize;
+    private _insertionOrder;
+    private _accessTimes?;
+    private _customEvictionFilter?;
     constructor(options?: ContainerOptions<T>);
     init(): void;
     [Symbol.iterator](): IterableIterator<T>;
@@ -32,12 +46,90 @@ export declare class KosDataContainer<T extends IKosIdentifiable> implements IKo
     sortFn(a: any, b: any): number;
     get data(): T[];
     increment(): void;
+    /**
+     * Add a data object to the container (Zone 2: Workflow orchestration)
+     *
+     * @param model - The data object to add
+     * @param defer - If true, skip incrementing revision (for batch operations)
+     */
     addModel(model: T, defer?: boolean): void;
+    /**
+     * Ensure data is observable (Zone 3)
+     * @private
+     */
+    private _ensureObservable;
+    /**
+     * Clean up existing disposer if present (Zone 3)
+     * @private
+     */
+    private _cleanupExistingDisposer;
+    /**
+     * Persist data to container storage (Zone 3)
+     * @private
+     */
+    private _persistData;
+    /**
+     * Track data metadata for capacity management (Zone 3)
+     * @private
+     */
+    private _trackDataMetadata;
+    /**
+     * Enforce capacity limits and trigger eviction if needed (Zone 3)
+     * @private
+     */
+    private _enforceCapacityLimits;
+    /**
+     * Configure MobX observers for data property changes (Zone 3)
+     * @private
+     */
+    private _configureDataMonitoring;
     removeModel(id: string): void;
     updateModel(model: T): void;
     getModel(id: string): T | undefined;
     getIndexKeys(indexName: string): string[];
     getIndexByKey(indexName: string, indexKey: string): T[];
+    /**
+     * SAFETY NET: Evict data models when capacity is exceeded (Zone 2: Workflow orchestration)
+     * Logs all evictions at WARNING level for debugging.
+     * Note: Data models are not destroyed (no lifecycle), only removed from container.
+     * @private
+     */
+    private _evictModels;
+    /**
+     * Log capacity exceeded warning for data container (Zone 3)
+     * @private
+     */
+    private _logDataCapacityWarning;
+    /**
+     * Select data for eviction based on strategy (Zone 3)
+     * @private
+     */
+    private _selectDataForEviction;
+    /**
+     * Select oldest data IDs for FIFO eviction (Zone 3)
+     * @private
+     */
+    private _selectFifoData;
+    /**
+     * Select least recently used data IDs for LRU eviction (Zone 3)
+     * @private
+     */
+    private _selectLruData;
+    /**
+     * Select data using custom filter for eviction (Zone 3)
+     * @private
+     */
+    private _selectCustomData;
+    /**
+     * Remove evicted data items (Zone 3)
+     * @private
+     */
+    private _removeEvictedData;
+    /**
+     * Log eviction completion for data container (Zone 3)
+     * @private
+     */
+    private _logDataEvictionComplete;
     clear(): Promise<void>;
     filter<S extends any>(predicate: (value: any, index: number, array: any[]) => value is S, thisArg?: any): T[];
     sort(compareFn?: ((a: any, b: any) => number) | undefined): T[];

package/core/core/kos-data-container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kos-data-container.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/core/kos-data-container.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"kos-data-container.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/core/kos-data-container.ts"],"names":[],"mappings":"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"}