@kosdev-code/base-ui-components 0.1.0-dev.5385 → 0.1.0-dev.5596

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosdev-code/base-ui-components",
-  "version": "0.1.0-dev.5385",
+  "version": "0.1.0-dev.5596",
   "main": "./index.cjs",
   "module": "./index.js",
   "types": "./index.d.ts",
@@ -20,7 +20,7 @@
     "./style.css": "./style.css"
   },
   "peerDependencies": {
-    "@kosdev-code/kos-ui-sdk": "0.1.0-dev.5385",
+    "@kosdev-code/kos-ui-sdk": "0.1.0-dev.5596",
     "@emotion/react": "^11.11.1",
     "@emotion/styled": "^11.11.0",
     "react": "^18.2.0",
@@ -35,7 +35,7 @@
   },
   "kos": {
     "build": {
-      "gitHash": "957680b8a0360362059edfeb74b1cf78d3a6cbef"
+      "gitHash": "009439d0e2ae59f61a2144470b35aa46cfc002ed"
     }
   }
 }

package/providers/data-providers/create-observable-list-provider.d.ts

@@ -0,0 +1,116 @@
+import { ObservableListDataProvider, ObservableListProviderConfig } from './types';
+import { ListItem } from '../../components/molecules/list/common/types';
+
+/**
+ * Factory function that creates an observable-based data provider for AsyncList.
+ *
+ * This eliminates boilerplate by:
+ * - Automatically tracking changes to observable arrays via MobX reactions
+ * - Transforming raw items to ListItem format
+ * - Maintaining originalItems map for action integration
+ * - Managing initialization and disposal lifecycle
+ *
+ * The provider integrates seamlessly with AsyncList component and provides automatic
+ * UI updates when the underlying model data changes.
+ *
+ * @typeParam M - The model type containing observable data
+ * @typeParam I - The raw item type from the model's observable array
+ * @typeParam T - The transformed ListItem type
+ *
+ * @param config - Configuration object
+ * @returns An AsyncListDataProvider-compatible provider with observable tracking
+ *
+ * @category Data Providers
+ *
+ * @example Basic usage with a projects model
+ * ```typescript
+ * interface Project {
+ *   id: string;
+ *   name: string;
+ *   description: string;
+ *   status: 'active' | 'archived';
+ * }
+ *
+ * interface ProjectListItem extends ListItem {
+ *   subText?: string;
+ * }
+ *
+ * class ProjectsModel {
+ *   @observable projects: Project[] = [];
+ * }
+ *
+ * const projectsModel = new ProjectsModel();
+ *
+ * const provider = createObservableListProvider({
+ *   model: projectsModel,
+ *   itemsExpression: (m) => m.projects,
+ *   transformer: (project) => ({
+ *     id: project.id,
+ *     name: project.name,
+ *     subText: project.description,
+ *   }),
+ * });
+ *
+ * // Use with AsyncList
+ * <AsyncList
+ *   dataProvider={provider}
+ *   ItemTemplate={StudioNamedListItem}
+ *   itemActions={[...]}
+ * />
+ * ```
+ *
+ * @example Filtering items in the expression
+ * ```typescript
+ * const activeProjectsProvider = createObservableListProvider({
+ *   model: projectsModel,
+ *   // Only show active projects - MobX tracks both array changes and status changes
+ *   itemsExpression: (m) => m.projects.filter(p => p.status === 'active'),
+ *   transformer: (project) => ({
+ *     id: project.id,
+ *     name: project.name,
+ *     subText: `Status: ${project.status}`,
+ *   }),
+ * });
+ * ```
+ *
+ * @example Complex transformation with additional data
+ * ```typescript
+ * interface EnhancedProjectListItem extends ListItem {
+ *   subText?: string;
+ *   type?: string;
+ * }
+ *
+ * const provider = createObservableListProvider<
+ *   ProjectsModel,
+ *   Project,
+ *   EnhancedProjectListItem
+ * >({
+ *   model: projectsModel,
+ *   itemsExpression: (m) => m.projects,
+ *   transformer: (project) => ({
+ *     id: project.id,
+ *     name: project.name,
+ *     subText: `${project.description} - ${project.status}`,
+ *     type: project.status, // Can be used with itemIconMap
+ *   }),
+ * });
+ * ```
+ *
+ * @example Manual disposal control
+ * ```typescript
+ * const provider = createObservableListProvider({
+ *   model: projectsModel,
+ *   itemsExpression: (m) => m.projects,
+ *   transformer: (project) => ({ id: project.id, name: project.name }),
+ *   autoDispose: false, // Manual disposal control
+ * });
+ *
+ * // Later, manually dispose when needed
+ * provider.dispose();
+ * ```
+ *
+ * @see {@link ObservableListDataProvider} for the provider interface
+ * @see {@link AsyncList} for the component that consumes this provider
+ */
+export declare function createObservableListProvider<M, I extends Record<string, any>, T extends ListItem>(config: ObservableListProviderConfig<M, I, T>): ObservableListDataProvider<M, I, T>;
+//# sourceMappingURL=create-observable-list-provider.d.ts.map

package/providers/data-providers/create-observable-list-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-observable-list-provider.d.ts","sourceRoot":"","sources":["../../../../../../packages/libraries/base-ui-components/src/providers/data-providers/create-observable-list-provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,OAAO,EAEL,KAAK,QAAQ,EACd,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EACV,0BAA0B,EAC1B,4BAA4B,EAC7B,MAAM,SAAS,CAAC;AA8NjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8GG;AACH,wBAAgB,4BAA4B,CAC1C,CAAC,EACD,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,CAAC,SAAS,QAAQ,EAElB,MAAM,EAAE,4BAA4B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC5C,0BAA0B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAErC"}

package/providers/data-providers/index.d.ts

@@ -0,0 +1,86 @@
+/**
+ * (C) Copyright 2025, TCCC, All rights reserved.
+ */
+/**
+ * Observable List Data Providers
+ *
+ * This module provides observable-based data provider utilities that integrate
+ * MobX models with AsyncList component, eliminating boilerplate for reactive data binding.
+ *
+ * ## Overview
+ *
+ * The Observable List Data Provider system enables automatic UI updates when model
+ * data changes by leveraging MobX reactions. This eliminates the need for manual
+ * state synchronization and reduces boilerplate code.
+ *
+ * ## Key Features
+ *
+ * - **Automatic Updates**: MobX reactions track observable changes and update UI automatically
+ * - **Type Safety**: Full generic type inference for model, raw items, and transformed items
+ * - **Memory Safe**: Proper disposal and WeakMap usage prevent memory leaks
+ * - **Action Integration**: Maintains originalItems map for action callbacks
+ * - **Simple API**: Single factory function creates fully-functional providers
+ *
+ * ## Usage Pattern
+ *
+ * 1. Define your model with observable data
+ * 2. Create provider with expression and transformer
+ * 3. Pass provider to AsyncList component
+ * 4. UI updates automatically when model data changes
+ *
+ * @example Basic Usage
+ * ```typescript
+ * // 1. Model with observable data
+ * class ProjectsModel {
+ *   @observable projects: Project[] = [];
+ * }
+ *
+ * // 2. Create observable provider
+ * const provider = createObservableListProvider({
+ *   model: projectsModel,
+ *   itemsExpression: (m) => m.projects,
+ *   transformer: (project) => ({
+ *     id: project.id,
+ *     name: project.name,
+ *     subText: project.description,
+ *   }),
+ * });
+ *
+ * // 3. Use with AsyncList
+ * <AsyncList
+ *   dataProvider={provider}
+ *   ItemTemplate={StudioNamedListItem}
+ *   itemActions={[
+ *     {
+ *       id: 'delete',
+ *       iconId: 'DeleteOutlined',
+ *       onClick: (id, item) => handleDelete(id),
+ *     }
+ *   ]}
+ * />
+ * ```
+ *
+ * @example Filtering in Expression
+ * ```typescript
+ * const activeProjectsProvider = createObservableListProvider({
+ *   model: projectsModel,
+ *   // MobX tracks both array changes and property changes
+ *   itemsExpression: (m) => m.projects.filter(p => p.status === 'active'),
+ *   transformer: (project) => ({
+ *     id: project.id,
+ *     name: project.name,
+ *     subText: `Status: ${project.status}`,
+ *   }),
+ * });
+ * ```
+ *
+ * @module providers/data-providers
+ * @category Data Providers
+ */
+export { createObservableListProvider } from './create-observable-list-provider';
+export { createLifecycleAwareProvider, LifecycleAwareListProvider, } from './lifecycle-aware-list-provider';
+export { createLifecycleAwareTreeProvider, LifecycleAwareTreeProvider, } from './lifecycle-aware-tree-provider';
+export type { ObservableExpression, ItemTransformer, ObservableListProviderConfig, ObservableListDataProvider, } from './types';
+export type { LifecycleAwareProviderConfig, ViewContextData, } from './lifecycle-aware-list-provider';
+export type { LifecycleAwareTreeProviderConfig, TreeViewContextData, ChildrenExpression, HasChildrenExpression, } from './lifecycle-aware-tree-provider';
+//# sourceMappingURL=index.d.ts.map

package/providers/data-providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/libraries/base-ui-components/src/providers/data-providers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2EG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,iCAAiC,CAAC;AAEzC,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,4BAA4B,EAC5B,eAAe,GAChB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,gCAAgC,EAChC,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC"}

package/providers/data-providers/lifecycle-aware-list-provider.d.ts

@@ -0,0 +1,206 @@
+import { ItemTransformer, ObservableExpression, ObservableListDataProvider } from './types';
+import { ListItem } from '../../components/molecules/list/common/types';
+
+/**
+ * Configuration for creating a lifecycle-aware list data provider.
+ * Supports both static and dynamic model IDs with automatic model lifecycle tracking.
+ *
+ * @typeParam M - The model type containing observable data
+ * @typeParam I - The raw item type from the model
+ * @typeParam T - The transformed ListItem type
+ */
+export interface LifecycleAwareProviderConfig<M, I extends Record<string, any>, T extends ListItem> {
+    /**
+     * Model type name (e.g., "ArtifactContainerModel")
+     */
+    modelType: string;
+    /**
+     * Model ID to retrieve from KOS ModelManager (e.g., "artifact-container")
+     */
+    modelId: string | ((context: ViewContextData) => string | undefined);
+    /**
+     * Expression to extract items from the model
+     */
+    itemsExpression: ObservableExpression<M, I>;
+    /**
+     * Transformer to convert raw items to ListItem format
+     */
+    transformer: ItemTransformer<I, T>;
+    /**
+     * View context data for dynamic modelId evaluation
+     */
+    context: ViewContextData;
+    /**
+     * Whether to call activate() on the model when retrieved from ModelManager.
+     * Only set to true if the model needs activation to load its data.
+     * Default: false
+     */
+    activate?: boolean;
+}
+/**
+ * Simplified ViewContext interface to avoid circular dependencies.
+ * Contains only the properties needed for dynamic modelId evaluation.
+ */
+export interface ViewContextData {
+    selectedItems: string[];
+    activeFilters: Record<string, unknown>;
+    searchQuery: string;
+    userPermissions: string[];
+    applicationState: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Lifecycle-aware wrapper for ObservableListDataProvider that enables
+ * declarative view registration independent of component lifecycle and model availability.
+ *
+ * This provider:
+ * - Subscribes to KOS model lifecycle events via EventBus
+ * - Automatically creates inner provider when model becomes ready
+ * - Supports both static and dynamic model IDs
+ * - Returns empty array until model is ready
+ * - Properly disposes subscriptions and inner providers
+ *
+ * **Architecture:**
+ * 1. **Registration Time**: View registered with modelId (string or function)
+ * 2. **Provider Creation**: Lifecycle-aware wrapper created immediately
+ * 3. **Model Waiting**: Wrapper subscribes to EventBus for model-ready events
+ * 4. **Model Ready**: Wrapper looks up model from ModelManager and creates inner provider
+ * 5. **Dynamic Updates**: For function-based modelIds, MobX reaction tracks changes
+ *
+ * @typeParam M - The model type containing observable data
+ * @typeParam I - The raw item type from the model
+ * @typeParam T - The transformed ListItem type
+ *
+ * @example Static model ID
+ * ```typescript
+ * const provider = new LifecycleAwareListProvider({
+ *   modelId: "artifact-container",
+ *   itemsExpression: (m) => m.publishedAvailableArtifacts,
+ *   transformer: (artifact) => ({ id: artifact.id, name: artifact.name }),
+ *   context: viewContext.data
+ * });
+ * ```
+ *
+ * @example Dynamic model ID
+ * ```typescript
+ * const provider = new LifecycleAwareListProvider({
+ *   modelId: (context) => context.selectedProjectId,
+ *   itemsExpression: (m) => m.artifacts,
+ *   transformer: (artifact) => ({ id: artifact.id, name: artifact.name }),
+ *   context: viewContext.data
+ * });
+ * ```
+ */
+export declare class LifecycleAwareListProvider<M, I extends Record<string, any>, T extends ListItem> implements ObservableListDataProvider<M, I, T> {
+    readonly itemsExpression: ObservableExpression<M, I>;
+    readonly transformer: ItemTransformer<I, T>;
+    readonly autoDispose: boolean;
+    private _modelId;
+    private _context;
+    private _innerProvider;
+    private _isInitialized;
+    private _isDisposed;
+    private _isLoading;
+    private _eventBusUnsubscribe;
+    private _modelIdReactionDisposer;
+    private _currentModelId;
+    private _modelType;
+    private _shouldActivate;
+    private _items;
+    constructor(config: LifecycleAwareProviderConfig<M, I, T>);
+    /**
+     * Returns the current model instance from the inner provider, or undefined.
+     */
+    get model(): M;
+    /**
+     * Returns items from the inner provider, or empty array if model not ready.
+     * Computed to ensure MobX tracks changes to the inner provider's items.
+     */
+    get items(): T[];
+    get isInitialized(): boolean;
+    get isDisposed(): boolean;
+    /**
+     * Returns true when the provider is loading data.
+     * This includes:
+     * - Model activation (if configured)
+     * - Waiting for model to become ready
+     * - Dynamic modelId changes causing new model lookup
+     *
+     * Does NOT include:
+     * - No selection made yet (dynamic modelId returns undefined)
+     *
+     * The provider is only "loading" if we have a valid modelId but no inner provider yet.
+     * If modelId is undefined (no selection), we're in an empty/unselected state, not loading.
+     */
+    get isLoading(): boolean;
+    /**
+     * Map of original items by ID for action integration.
+     * Delegates to inner provider when available.
+     */
+    get originalItems(): Map<string, I>;
+    /**
+     * Initialize the lifecycle-aware provider.
+     * Sets up EventBus subscription and MobX reaction for dynamic modelId.
+     * Can be called again after dispose() to re-initialize.
+     */
+    init(): Promise<void>;
+    /**
+     * Handle changes to dynamic modelId.
+     * Disposes old provider and subscribes to new model.
+     * Wrapped in runInAction to comply with MobX strict mode.
+     */
+    private handleModelIdChange;
+    /**
+     * Subscribe to EventBus for model lifecycle events.
+     * When model becomes ready, creates the inner provider.
+     */
+    private subscribeToModelLifecycle;
+    /**
+     * Create the inner ObservableListDataProvider with the ready model.
+     * Sets loading state during async activation.
+     * Wrapped in runInAction to comply with MobX strict mode.
+     */
+    private createInnerProvider;
+    /**
+     * Get model from KOS ModelManager.
+     * Optionally calls activate() if configured to do so.
+     * Sets loading state during async activation.
+     * Uses runInAction to comply with MobX strict mode.
+     */
+    private getModelFromManager;
+    /**
+     * Dispose of the provider and clean up all subscriptions.
+     * Uses runInAction for observable state changes to comply with MobX strict mode.
+     */
+    dispose(): void;
+    /**
+     * Promise that resolves when provider is ready.
+     */
+    whenReady(): Promise<void>;
+    /**
+     * Refresh the data by delegating to inner provider.
+     */
+    refresh(): Promise<void>;
+}
+/**
+ * Factory function to create a lifecycle-aware list data provider.
+ *
+ * @typeParam M - The model type containing observable data
+ * @typeParam I - The raw item type from the model
+ * @typeParam T - The transformed ListItem type
+ *
+ * @param config - Configuration including modelId (string or function)
+ * @returns Lifecycle-aware provider that waits for model to be ready
+ *
+ * @example
+ * ```typescript
+ * const provider = createLifecycleAwareProvider({
+ *   modelId: "artifact-container",
+ *   itemsExpression: (m) => m.publishedAvailableArtifacts,
+ *   transformer: (artifact) => ({ id: artifact.id, name: artifact.name }),
+ *   context: viewContext.data
+ * });
+ * ```
+ */
+export declare function createLifecycleAwareProvider<M, I extends Record<string, any>, T extends ListItem>(config: LifecycleAwareProviderConfig<M, I, T>): ObservableListDataProvider<M, I, T>;
+//# sourceMappingURL=lifecycle-aware-list-provider.d.ts.map

package/providers/data-providers/lifecycle-aware-list-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-aware-list-provider.d.ts","sourceRoot":"","sources":["../../../../../../packages/libraries/base-ui-components/src/providers/data-providers/lifecycle-aware-list-provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8CAA8C,CAAC;AAE7E,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,SAAS,CAAC;AAQjB;;;;;;;GAOG;AACH,MAAM,WAAW,4BAA4B,CAC3C,CAAC,EACD,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,CAAC,SAAS,QAAQ;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,eAAe,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;IAErE;;OAEG;IACH,eAAe,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5C;;OAEG;IACH,WAAW,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEnC;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC;IAEzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE1C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBAAa,0BAA0B,CACrC,CAAC,EACD,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,CAAC,SAAS,QAAQ,CAClB,YAAW,0BAA0B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAE9C,SAAgB,eAAe,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5D,SAAgB,WAAW,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,SAAgB,WAAW,EAAE,OAAO,CAAQ;IAE5C,OAAO,CAAC,QAAQ,CAA8D;IAC9E,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,cAAc,CAAoD;IAC1E,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,oBAAoB,CAA6B;IACzD,OAAO,CAAC,wBAAwB,CAAkC;IAClE,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,eAAe,CAAU;IAGjC,OAAO,CAAC,MAAM,CAA2B;gBAE7B,MAAM,EAAE,4BAA4B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAoBzD;;OAEG;IACH,IAAW,KAAK,IAAI,CAAC,CAEpB;IAED;;;OAGG;IACH,IAAW,KAAK,IAAI,CAAC,EAAE,CAEtB;IAED,IAAW,aAAa,IAAI,OAAO,CAElC;IAED,IAAW,UAAU,IAAI,OAAO,CAE/B;IAED;;;;;;;;;;;;OAYG;IACH,IAAW,SAAS,IAAI,OAAO,CAK9B;IAED;;;OAGG;IACH,IAAW,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAEzC;IAED;;;;OAIG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA2ClC;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAsBjC;;;;OAIG;YACW,mBAAmB;IAsBjC;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;;OAGG;IACI,OAAO,IAAI,IAAI;IA8BtB;;OAEG;IACU,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBvC;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAMtC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,4BAA4B,CAC1C,CAAC,EACD,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,CAAC,SAAS,QAAQ,EAElB,MAAM,EAAE,4BAA4B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC5C,0BAA0B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAErC"}

package/providers/data-providers/lifecycle-aware-tree-provider.d.ts

@@ -0,0 +1,187 @@
+import { ItemTransformer, ObservableExpression } from './types';
+import { ListItem } from '../../components/molecules/list/common/types';
+import { AsyncTreeBranch } from '../../components/molecules/list/common/data-providers/async-tree-data-provider';
+
+/**
+ * Expression to extract children from a parent item.
+ */
+export type ChildrenExpression<M, I> = (model: M, parentItem: I) => I[];
+/**
+ * Expression to determine if an item has children.
+ */
+export type HasChildrenExpression<M, I> = (model: M, item: I) => boolean | "unknown";
+/**
+ * Simplified ViewContext interface to avoid circular dependencies.
+ */
+export interface TreeViewContextData {
+    selectedItems: string[];
+    activeFilters: Record<string, unknown>;
+    searchQuery: string;
+    userPermissions: string[];
+    applicationState: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Configuration for creating a lifecycle-aware tree data provider.
+ */
+export interface LifecycleAwareTreeProviderConfig<M, I extends Record<string, any>, T extends ListItem> {
+    /**
+     * Model type name (e.g., "VirtualMachineContainerModel")
+     */
+    modelType: string;
+    /**
+     * Model ID to retrieve from KOS ModelManager
+     */
+    modelId: string | ((context: TreeViewContextData) => string | undefined);
+    /**
+     * Expression to extract root items from the model
+     */
+    rootsExpression: ObservableExpression<M, I>;
+    /**
+     * Expression to get children of a specific item
+     */
+    childrenExpression: ChildrenExpression<M, I>;
+    /**
+     * Expression to determine if an item has children
+     */
+    hasChildrenExpression: HasChildrenExpression<M, I>;
+    /**
+     * Function to extract unique ID from an item
+     */
+    getItemId: (item: I) => string;
+    /**
+     * Transformer to convert raw items to ListItem format
+     */
+    transformer: ItemTransformer<I, T>;
+    /**
+     * View context data for dynamic modelId evaluation
+     */
+    context: TreeViewContextData;
+    /**
+     * Whether to call activate() on the model when retrieved
+     * @default false
+     */
+    activate?: boolean;
+}
+/**
+ * Lifecycle-aware tree data provider using composition pattern.
+ *
+ * Uses composition instead of inheritance to properly delegate to inner provider
+ * without MobX observable override conflicts.
+ *
+ * Implements AsyncTreeDataProvider interface directly.
+ */
+export declare class LifecycleAwareTreeProvider<M extends Record<string, any>, I extends Record<string, any>, T extends ListItem> {
+    private _modelId;
+    private _context;
+    private _innerProvider;
+    private _isInitialized;
+    private _isInitializing;
+    private _isDisposed;
+    private _isLoading;
+    private _eventBusUnsubscribe;
+    private _modelIdReactionDisposer;
+    private _currentModelId;
+    private _modelType;
+    private _shouldActivate;
+    private _rootsExpression;
+    private _childrenExpression;
+    private _hasChildrenExpression;
+    private _getItemIdFn;
+    private _transformer;
+    constructor(config: LifecycleAwareTreeProviderConfig<M, I, T>);
+    /**
+     * Returns items from the inner provider's tree, or empty if not ready.
+     */
+    get tree(): AsyncTreeBranch<T>[];
+    /**
+     * Returns the original items map from the inner provider.
+     */
+    get originalItems(): ReadonlyMap<string, I>;
+    /**
+     * Returns initialization status
+     */
+    get initialized(): boolean;
+    /**
+     * Returns loading status
+     */
+    get isLoading(): boolean;
+    /**
+     * Check if an item has children
+     */
+    hasChildren(item: I): boolean | "unknown";
+    /**
+     * Get the unique ID for an item
+     */
+    getItemId(item: I): string;
+    /**
+     * Initialize the lifecycle-aware provider.
+     * Can be called again after dispose() to re-initialize.
+     */
+    init(): Promise<void>;
+    /**
+     * Handle changes to dynamic modelId.
+     */
+    private handleModelIdChange;
+    /**
+     * Subscribe to EventBus for model lifecycle events.
+     * Returns a promise that resolves when the inner provider is ready.
+     */
+    private subscribeToModelLifecycle;
+    /**
+     * Create the inner tree provider with the ready model.
+     */
+    private createInnerProvider;
+    /**
+     * Get model from KOS ModelManager.
+     */
+    private getModelFromManager;
+    /**
+     * Expand a branch - delegates to inner provider
+     */
+    expandBranch(itemId: string, item: I): Promise<void>;
+    /**
+     * Expand all nodes recursively - delegates to inner provider.
+     * Call this when expandedMode is true.
+     */
+    expandAll(): Promise<void>;
+    /**
+     * Collapse a branch - delegates to inner provider
+     */
+    collapseBranch(itemId: string): void;
+    /**
+     * Clear cache - delegates to inner provider
+     */
+    clearCache(itemId?: string): void;
+    /**
+     * Refresh - delegates to inner provider
+     */
+    refresh(): void;
+    /**
+     * Wait for provider to be ready
+     */
+    whenReady(): Promise<void>;
+    /**
+     * Dispose of the provider and clean up all subscriptions.
+     */
+    dispose(): void;
+}
+/**
+ * Factory function to create a lifecycle-aware tree data provider.
+ *
+ * @example
+ * ```typescript
+ * const provider = createLifecycleAwareTreeProvider({
+ *   modelType: "VirtualMachineContainerModel",
+ *   modelId: "VirtualMachineContainerModel",
+ *   rootsExpression: (model) => model.models.filter(vm => !vm.parentId),
+ *   childrenExpression: (model, item) => model.models.filter(vm => vm.parentId === item.id),
+ *   hasChildrenExpression: (model, item) => model.models.some(vm => vm.parentId === item.id),
+ *   getItemId: (item) => item.id,
+ *   transformer: (vm) => ({ id: vm.id, name: vm.name }),
+ *   context: studio.data
+ * });
+ * ```
+ */
+export declare function createLifecycleAwareTreeProvider<M extends Record<string, any>, I extends Record<string, any>, T extends ListItem>(config: LifecycleAwareTreeProviderConfig<M, I, T>): LifecycleAwareTreeProvider<M, I, T>;
+//# sourceMappingURL=lifecycle-aware-tree-provider.d.ts.map

package/providers/data-providers/lifecycle-aware-tree-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-aware-tree-provider.d.ts","sourceRoot":"","sources":["../../../../../../packages/libraries/base-ui-components/src/providers/data-providers/lifecycle-aware-tree-provider.ts"],"names":[],"mappings":"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"}