@vived/host 4.10.0 → 4.11.0

package/dist/types/Assets/Controllers/toggleShowArchivedAssets.d.ts

@@ -1,3 +1,31 @@
+/**
+ * toggleShowArchivedAssets.ts
+ *
+ * This controller function toggles the visibility of archived assets in the asset list.
+ * It provides a simple interface for users to show or hide archived assets from
+ * their asset management workspace.
+ *
+ * Key Concepts:
+ * - Toggles the display state of archived assets in asset lists
+ * - Directly modifies the AppAssetsEntity's showArchived property
+ * - Provides error handling for missing components
+ * - Triggers immediate UI updates through entity change notifications
+ *
+ * Usage Patterns:
+ * - Called from UI components with toggle buttons or checkboxes
+ * - Used in asset management interfaces for filtering options
+ * - Integrated with asset list displays and filter controls
+ */
 import { AppObjectRepo } from "@vived/core";
+/**
+ * Toggles the visibility of archived assets in the asset management interface.
+ *
+ * This function provides a controller-level interface for toggling archived asset visibility.
+ * It flips the current state of the showArchived property, which immediately affects
+ * what assets are displayed in asset lists and management interfaces.
+ *
+ * @param appObjects - Repository for accessing the AppAssetsEntity that controls visibility
+ * @returns void - The function operates synchronously and triggers immediate UI updates
+ */
 export declare function toggleShowArchivedAssets(appObjects: AppObjectRepo): void;
 //# sourceMappingURL=toggleShowArchivedAssets.d.ts.map

package/dist/types/Assets/Controllers/toggleShowArchivedAssets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toggleShowArchivedAssets.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/toggleShowArchivedAssets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,aAAa,QAWjE"}
+{"version":3,"file":"toggleShowArchivedAssets.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/toggleShowArchivedAssets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,aAAa,QAWjE"}

package/dist/types/Assets/Controllers/updateAppAssetMeta.d.ts

@@ -1,4 +1,34 @@
+/**
+ * updateAppAssetMeta.ts
+ *
+ * This controller function handles updating asset metadata (name, description, etc.)
+ * for existing assets. It provides a streamlined interface for modifying asset
+ * information without affecting the actual asset files.
+ *
+ * Key Concepts:
+ * - Updates asset metadata without modifying the actual file content
+ * - Uses UpdateAppAssetMetaUC to handle validation and persistence
+ * - Provides error handling for missing components
+ * - Supports partial updates of asset information
+ *
+ * Usage Patterns:
+ * - Called from asset editing forms and dialogs
+ * - Used in asset management workflows for information updates
+ * - Integrated with asset detail views and editing interfaces
+ */
 import { AppObjectRepo } from "@vived/core";
 import { UpdateAppAssetMetaDTO } from "../UCs/UpdateAppAssetMetaUC";
+/**
+ * Updates the metadata of an existing asset.
+ *
+ * This function provides a controller-level interface for updating asset metadata
+ * such as name, description, and other properties. It handles validation and
+ * persistence of the changes through the underlying use case.
+ *
+ * @param data - Data transfer object containing the metadata fields to update
+ * @param assetID - The unique identifier of the asset to update
+ * @param appObjects - Repository for accessing asset-related app objects and components
+ * @returns void - The function operates synchronously and triggers immediate updates
+ */
 export declare function updateAppAssetMeta(data: UpdateAppAssetMetaDTO, assetID: string, appObjects: AppObjectRepo): void;
 //# sourceMappingURL=updateAppAssetMeta.d.ts.map

package/dist/types/Assets/Controllers/updateAppAssetMeta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updateAppAssetMeta.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/updateAppAssetMeta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAEL,qBAAqB,EACtB,MAAM,6BAA6B,CAAC;AAErC,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,qBAAqB,EAC3B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,QAY1B"}
+{"version":3,"file":"updateAppAssetMeta.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/updateAppAssetMeta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAEL,qBAAqB,EACtB,MAAM,6BAA6B,CAAC;AAErC;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,qBAAqB,EAC3B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,QAY1B"}

package/dist/types/Assets/Controllers/updateAssetFile.d.ts

@@ -1,3 +1,33 @@
+/**
+ * updateAssetFile.ts
+ *
+ * This controller function handles updating the actual file content of existing assets.
+ * It provides a streamlined interface for replacing asset files while preserving
+ * the asset's metadata and relationships.
+ *
+ * Key Concepts:
+ * - Updates the actual file content of existing assets
+ * - Preserves asset metadata and relationships during file replacement
+ * - Uses UpdateAssetFileUC to handle file upload and persistence
+ * - Provides error handling for missing components
+ *
+ * Usage Patterns:
+ * - Called from file upload interfaces when users replace asset files
+ * - Used in asset management workflows for content updates
+ * - Integrated with drag-and-drop file replacement interfaces
+ */
 import { AppObjectRepo } from "@vived/core";
+/**
+ * Updates the file content of an existing asset.
+ *
+ * This function provides a controller-level interface for replacing the file
+ * associated with an existing asset. It handles the upload and storage of the
+ * new file while preserving all asset metadata and relationships.
+ *
+ * @param file - The new file object to replace the existing asset file
+ * @param assetID - The unique identifier of the asset whose file should be updated
+ * @param appObjects - Repository for accessing asset-related app objects and components
+ * @returns void - The function initiates the file update process asynchronously
+ */
 export declare function updateAssetFile(file: File, assetID: string, appObjects: AppObjectRepo): void;
 //# sourceMappingURL=updateAssetFile.d.ts.map

package/dist/types/Assets/Controllers/updateAssetFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updateAssetFile.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/updateAssetFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,QAY1B"}
+{"version":3,"file":"updateAssetFile.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/updateAssetFile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,QAY1B"}

package/dist/types/Assets/Entities/AppAssetsEntity.d.ts

@@ -1,16 +1,99 @@
 import { AppObject, AppObjectEntity, AppObjectRepo } from "@vived/core";
 import { AssetEntity } from "./AssetEntity";
+/**
+ * AppAssetsEntity manages the collection of assets associated with a specific VIVED application.
+ *
+ * This singleton entity handles:
+ * 1. Asset collection management (add, remove, query operations)
+ * 2. Editing state management with automatic observer registration
+ * 3. Archive filtering functionality for showing/hiding archived assets
+ * 4. Global asset reference tracking for applications
+ *
+ * Key Concepts:
+ * - Singleton pattern ensures only one instance exists per application
+ * - Observer pattern integration for automatic UI updates when editing state changes
+ * - Smart observer management prevents memory leaks by properly registering/unregistering
+ * - Archive filtering support for improved user experience
+ *
+ * Usage Patterns:
+ * ```typescript
+ * // Get the global app assets entity
+ * const appAssets = AppAssetsEntity.get(appObjects);
+ * if (appAssets) {
+ *   // Manage asset collection
+ *   appAssets.add("asset123");
+ *   const allAssets = appAssets.getAll();
+ *   const hasAsset = appAssets.has("asset123");
+ *   appAssets.remove("asset123");
+ *
+ *   // Manage editing state
+ *   const assetEntity = AssetEntity.get(someAppObject);
+ *   appAssets.editingAsset = assetEntity; // Automatically registers observers
+ *
+ *   // Control archive visibility
+ *   appAssets.showArchived = true; // Show archived assets
+ *   appAssets.showArchived = false; // Hide archived assets
+ * }
+ * ```
+ *
+ * Integration Points:
+ * - Works with AssetRepo for asset lifecycle management
+ * - Integrates with AssetEntity for individual asset operations
+ * - Used by GetAppAssetsUC for bulk asset operations
+ * - Supports UI components through observer pattern notifications
+ */
 export declare abstract class AppAssetsEntity extends AppObjectEntity {
+    /** Static type identifier for component registration */
     static type: string;
+    /**
+     * Retrieves all asset IDs in this application's collection
+     * @returns Array of asset IDs, returned as a copy to prevent external modification
+     */
     abstract getAll(): string[];
+    /**
+     * Adds an asset ID to the collection if not already present
+     * @param assetID - The unique identifier of the asset to add
+     * Side effects: Triggers change notifications for UI updates
+     */
     abstract add(assetID: string): void;
+    /**
+     * Checks if an asset ID exists in the collection
+     * @param assetID - The unique identifier to check for
+     * @returns true if the asset is in the collection, false otherwise
+     */
     abstract has(assetID: string): boolean;
+    /**
+     * Removes an asset ID from the collection if present
+     * @param assetID - The unique identifier of the asset to remove
+     * Side effects: Triggers change notifications for UI updates
+     */
     abstract remove(assetID: string): void;
+    /**
+     * The asset currently being edited, if any
+     * When set, automatically manages observer registration for change notifications
+     * Setting to undefined clears the editing state
+     */
     abstract get editingAsset(): AssetEntity | undefined;
     abstract set editingAsset(val: AssetEntity | undefined);
+    /**
+     * Controls whether archived assets are shown in UI components
+     * When true, archived assets are included in queries and displays
+     * When false, archived assets are filtered out for better UX
+     */
     abstract get showArchived(): boolean;
     abstract set showArchived(show: boolean);
+    /**
+     * Retrieves the singleton AppAssetsEntity from the host application objects
+     * @param hostAppObjects - The application object repository to search
+     * @returns AppAssetsEntity instance or undefined if not found
+     * Uses getSingletonComponent to ensure only one instance exists
+     */
     static get(hostAppObjects: AppObjectRepo): AppAssetsEntity | undefined;
 }
+/**
+ * Factory function to create a new AppAssetsEntity instance
+ * @param appObj - The AppObject that will host this AppAssetsEntity
+ * @returns A new AppAssetsEntity implementation instance
+ */
 export declare function makeAppAssets(appObj: AppObject): AppAssetsEntity;
 //# sourceMappingURL=AppAssetsEntity.d.ts.map

package/dist/types/Assets/Entities/AppAssetsEntity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppAssetsEntity.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Entities/AppAssetsEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,eAAe,EACf,aAAa,EAGd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,8BAAsB,eAAgB,SAAQ,eAAe;IAC3D,MAAM,CAAC,IAAI,SAAqB;IAEhC,QAAQ,CAAC,MAAM,IAAI,MAAM,EAAE;IAC3B,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IACnC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IACtC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAEtC,QAAQ,KAAK,YAAY,IAAI,WAAW,GAAG,SAAS,CAAC;IACrD,QAAQ,KAAK,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,SAAS,EAAE;IAExD,QAAQ,KAAK,YAAY,IAAI,OAAO,CAAC;IACrC,QAAQ,KAAK,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE;IAEzC,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,aAAa,GAAG,eAAe,GAAG,SAAS;CAGvE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,eAAe,CAEhE"}
+{"version":3,"file":"AppAssetsEntity.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Entities/AppAssetsEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,eAAe,EACf,aAAa,EAGd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,8BAAsB,eAAgB,SAAQ,eAAe;IAC3D,wDAAwD;IACxD,MAAM,CAAC,IAAI,SAAqB;IAEhC;;;OAGG;IACH,QAAQ,CAAC,MAAM,IAAI,MAAM,EAAE;IAE3B;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAEnC;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAEtC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAEtC;;;;OAIG;IACH,QAAQ,KAAK,YAAY,IAAI,WAAW,GAAG,SAAS,CAAC;IACrD,QAAQ,KAAK,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,SAAS,EAAE;IAExD;;;;OAIG;IACH,QAAQ,KAAK,YAAY,IAAI,OAAO,CAAC;IACrC,QAAQ,KAAK,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE;IAEzC;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,aAAa,GAAG,eAAe,GAAG,SAAS;CAGvE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,eAAe,CAEhE"}

package/dist/types/Assets/Entities/AssetEntity.d.ts

@@ -1,35 +1,171 @@
 import { AppObject, AppObjectEntity } from "@vived/core";
+/**
+ * AssetEntity manages individual file-based resources in VIVED applications.
+ *
+ * This entity handles:
+ * 1. Asset metadata (name, description, owner, archive status)
+ * 2. File management (filename, fileURL, blob URL creation)
+ * 3. Linked asset relationships for hierarchical asset structures
+ * 4. Fetch state management (loading indicators, error handling)
+ * 5. Observer pattern implementation for UI updates
+ *
+ * Key Concepts:
+ * - Uses memoized properties for efficient change tracking and notifications
+ * - Supports both file URLs (remote) and blob URLs (local) for flexible file access
+ * - Maintains linked asset relationships to support complex asset hierarchies
+ * - Implements observer pattern to notify UI components of changes
+ *
+ * Usage Patterns:
+ * ```typescript
+ * // Get an asset entity from an app object
+ * const asset = AssetEntity.get(appObject);
+ * if (asset) {
+ *   // Set asset metadata
+ *   asset.name = "My Asset";
+ *   asset.description = "A sample asset";
+ *
+ *   // Handle file operations
+ *   asset.setFile(fileObject);
+ *   const blobURL = asset.blobURL; // Access local blob URL
+ *
+ *   // Manage linked assets
+ *   asset.addLinkedAsset("texture", "texture123");
+ *   const textures = asset.getLinkedAssetByType("texture");
+ *
+ *   // Monitor fetch state
+ *   if (asset.isFetchingFile) {
+ *     console.log("File is being downloaded...");
+ *   }
+ *   if (asset.fetchError) {
+ *     console.error("Failed to fetch file:", asset.fetchError.message);
+ *   }
+ * }
+ * ```
+ *
+ * Integration Points:
+ * - Works with AssetRepo for asset lifecycle management
+ * - Integrates with AppAssetsEntity for collection management
+ * - Used by GetAssetBlobURLUC for file retrieval operations
+ * - Supports caching mechanisms for optimized file access
+ */
 export declare abstract class AssetEntity extends AppObjectEntity {
+    /** Static type identifier for component registration */
     static type: string;
+    /**
+     * Unique identifier for this asset, derived from the underlying AppObject
+     * @readonly
+     */
     abstract readonly id: string;
+    /**
+     * Display name of the asset
+     * Triggers change notifications when modified for UI updates
+     */
     abstract get name(): string;
     abstract set name(name: string);
+    /**
+     * Detailed description of the asset's purpose or content
+     * Triggers change notifications when modified for UI updates
+     */
     abstract get description(): string;
     abstract set description(description: string);
+    /**
+     * ID of the user or entity that owns this asset
+     * Used for permission and filtering operations
+     */
     abstract get owner(): string;
     abstract set owner(val: string);
+    /**
+     * Whether this asset is archived (hidden from normal views)
+     * Used for soft deletion and filtering capabilities
+     */
     abstract get archived(): boolean;
     abstract set archived(archived: boolean);
+    /**
+     * Original filename of the uploaded file
+     * Preserved for download operations and display purposes
+     */
     abstract get filename(): string;
     abstract set filename(filename: string);
+    /**
+     * Remote URL where the file can be accessed
+     * Used for fetching the actual file content from external storage
+     */
     abstract get fileURL(): string;
     abstract set fileURL(fileURL: string);
+    /**
+     * Sets the local file object and creates a blob URL for immediate access
+     * @param file - The file object to associate with this asset
+     * Side effects: Creates blob URL, triggers change notifications
+     */
     abstract setFile(file: File): void;
+    /**
+     * The local file object if one has been set
+     * @returns File object or undefined if no file has been loaded locally
+     */
     abstract get file(): File | undefined;
+    /**
+     * Local blob URL for immediate file access without network requests
+     * @returns Blob URL string or undefined if no local file is available
+     */
     abstract get blobURL(): string | undefined;
+    /**
+     * Indicates whether the file has been successfully fetched and stored locally
+     * @returns true if file is available locally, false otherwise
+     */
     abstract get fileHasBeenFetched(): boolean;
+    /**
+     * Array of linked assets that have relationships with this asset
+     * Supports hierarchical asset structures (e.g., models with textures)
+     * @returns Array of linked asset references with type and ID
+     */
     abstract get linkedAssets(): {
         type: string;
         id: string;
     }[];
+    /**
+     * Adds a linked asset relationship
+     * @param type - The type/category of the linked asset (e.g., "texture", "sound")
+     * @param id - The unique ID of the linked asset
+     * Side effects: Triggers change notifications if asset is not already linked
+     */
     abstract addLinkedAsset(type: string, id: string): void;
+    /**
+     * Removes a linked asset relationship
+     * @param type - The type/category of the linked asset to remove
+     * @param id - The unique ID of the linked asset to remove
+     * Side effects: Triggers change notifications if asset was previously linked
+     */
     abstract removeLinkedAsset(type: string, id: string): void;
+    /**
+     * Retrieves all linked asset IDs of a specific type
+     * @param type - The type/category to filter by (e.g., "texture", "sound")
+     * @returns Array of asset IDs that match the specified type
+     */
     abstract getLinkedAssetByType(type: string): string[];
+    /**
+     * Indicates whether a file fetch operation is currently in progress
+     * Used for showing loading states in UI components
+     */
     abstract get isFetchingFile(): boolean;
     abstract set isFetchingFile(isFetchingFile: boolean);
+    /**
+     * Any error that occurred during the most recent fetch operation
+     * Used for error handling and user feedback in UI components
+     */
     abstract get fetchError(): Error | undefined;
     abstract set fetchError(fetchError: Error | undefined);
+    /**
+     * Retrieves an AssetEntity component from an AppObject
+     * @param appObject - The AppObject to search for the AssetEntity component
+     * @returns AssetEntity instance or undefined if not found
+     * Logs warning if component is not found to aid in debugging
+     */
     static get(appObject: AppObject): AssetEntity | undefined;
 }
+/**
+ * Factory function to create a new AssetEntity instance
+ * @param appObject - The AppObject that will host this AssetEntity
+ * @returns A new AssetEntity implementation instance
+ */
 export declare function makeAssetEntity(appObject: AppObject): AssetEntity;
 //# sourceMappingURL=AssetEntity.d.ts.map

package/dist/types/Assets/Entities/AssetEntity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssetEntity.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Entities/AssetEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,eAAe,EAGhB,MAAM,aAAa,CAAC;AAErB,8BAAsB,WAAY,SAAQ,eAAe;IACvD,MAAM,CAAC,IAAI,SAAiB;IAE5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAE7B,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC;IAC5B,QAAQ,KAAK,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE;IAEhC,QAAQ,KAAK,WAAW,IAAI,MAAM,CAAC;IACnC,QAAQ,KAAK,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE;IAE9C,QAAQ,KAAK,KAAK,IAAI,MAAM,CAAC;IAC7B,QAAQ,KAAK,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE;IAEhC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC;IACjC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE;IAEzC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC;IAChC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;IAExC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC;IAC/B,QAAQ,KAAK,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE;IAEtC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAClC,QAAQ,KAAK,IAAI,IAAI,IAAI,GAAG,SAAS,CAAC;IACtC,QAAQ,KAAK,OAAO,IAAI,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,KAAK,kBAAkB,IAAI,OAAO,CAAC;IAE3C,QAAQ,KAAK,YAAY,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IACvD,QAAQ,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAC1D,QAAQ,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAErD,QAAQ,KAAK,cAAc,IAAI,OAAO,CAAC;IACvC,QAAQ,KAAK,cAAc,CAAC,cAAc,EAAE,OAAO,EAAE;IAErD,QAAQ,KAAK,UAAU,IAAI,KAAK,GAAG,SAAS,CAAC;IAC7C,QAAQ,KAAK,UAAU,CAAC,UAAU,EAAE,KAAK,GAAG,SAAS,EAAE;IAEvD,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS;CAU1D;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,CAEjE"}
+{"version":3,"file":"AssetEntity.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Entities/AssetEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,eAAe,EAGhB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,8BAAsB,WAAY,SAAQ,eAAe;IACvD,wDAAwD;IACxD,MAAM,CAAC,IAAI,SAAiB;IAE5B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC;IAC5B,QAAQ,KAAK,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE;IAEhC;;;OAGG;IACH,QAAQ,KAAK,WAAW,IAAI,MAAM,CAAC;IACnC,QAAQ,KAAK,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE;IAE9C;;;OAGG;IACH,QAAQ,KAAK,KAAK,IAAI,MAAM,CAAC;IAC7B,QAAQ,KAAK,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE;IAEhC;;;OAGG;IACH,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC;IACjC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE;IAEzC;;;OAGG;IACH,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC;IAChC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;IAExC;;;OAGG;IACH,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC;IAC/B,QAAQ,KAAK,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE;IAEtC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAElC;;;OAGG;IACH,QAAQ,KAAK,IAAI,IAAI,IAAI,GAAG,SAAS,CAAC;IAEtC;;;OAGG;IACH,QAAQ,KAAK,OAAO,IAAI,MAAM,GAAG,SAAS,CAAC;IAE3C;;;OAGG;IACH,QAAQ,KAAK,kBAAkB,IAAI,OAAO,CAAC;IAE3C;;;;OAIG;IACH,QAAQ,KAAK,YAAY,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAE5D;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAEvD;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAE1D;;;;OAIG;IACH,QAAQ,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAErD;;;OAGG;IACH,QAAQ,KAAK,cAAc,IAAI,OAAO,CAAC;IACvC,QAAQ,KAAK,cAAc,CAAC,cAAc,EAAE,OAAO,EAAE;IAErD;;;OAGG;IACH,QAAQ,KAAK,UAAU,IAAI,KAAK,GAAG,SAAS,CAAC;IAC7C,QAAQ,KAAK,UAAU,CAAC,UAAU,EAAE,KAAK,GAAG,SAAS,EAAE;IAEvD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS;CAU1D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,CAEjE"}

package/dist/types/Assets/Entities/AssetRepo.d.ts

@@ -1,5 +1,22 @@
 import { AppObject, AppObjectEntity, AppObjectRepo } from "@vived/core";
 import { AssetEntity } from "./AssetEntity";
+/**
+ * Data Transfer Object interface for asset operations between external APIs and the asset system.
+ *
+ * This interface defines the structure for transferring asset data from external sources
+ * (such as APIs, databases, or file systems) into the VIVED asset management system.
+ * It includes all necessary metadata and supports hierarchical asset relationships.
+ *
+ * @interface AssetDTO
+ * @property id - Unique identifier for the asset
+ * @property ownerId - ID of the user or entity that owns this asset
+ * @property name - Display name of the asset
+ * @property description - Detailed description of the asset's purpose or content
+ * @property archived - Whether the asset is archived (soft deleted)
+ * @property filename - Original filename of the uploaded file
+ * @property fileURL - Remote URL where the file can be accessed
+ * @property linkedAssets - Array of linked asset relationships with type and nested DTO
+ */
 export interface AssetDTO {
     id: string;
     ownerId: string;
@@ -13,17 +30,120 @@ export interface AssetDTO {
         asset: AssetDTO;
     }[];
 }
+/**
+ * AssetRepo implements the Repository pattern for asset lifecycle management in VIVED applications.
+ *
+ * This singleton entity handles:
+ * 1. Asset CRUD operations (Create, Read, Update, Delete)
+ * 2. Factory pattern for asset creation with dependency injection support
+ * 3. DTO to entity mapping for external data integration
+ * 4. Recursive linked asset processing for complex hierarchies
+ * 5. Asset lookup and caching for performance optimization
+ *
+ * Key Concepts:
+ * - Repository pattern provides a clean abstraction over asset storage
+ * - Factory pattern allows for customizable asset creation strategies
+ * - DTO processing supports complex asset hierarchies with linked relationships
+ * - Singleton pattern ensures consistent asset management across the application
+ *
+ * Usage Patterns:
+ * ```typescript
+ * // Get the global asset repository
+ * const assetRepo = AssetRepo.get(appObjects);
+ * if (assetRepo) {
+ *   // Basic CRUD operations
+ *   const asset = assetRepo.getOrCreate("asset123");
+ *   assetRepo.add(asset);
+ *   const allAssets = assetRepo.getAll();
+ *   const exists = assetRepo.has("asset123");
+ *   assetRepo.remove("asset123");
+ *
+ *   // DTO processing for external data
+ *   const assetDTO = {
+ *     id: "asset456",
+ *     name: "Sample Asset",
+ *     // ... other properties
+ *     linkedAssets: [
+ *       { type: "texture", asset: textureDTO },
+ *       { type: "sound", asset: soundDTO }
+ *     ]
+ *   };
+ *   const createdAsset = assetRepo.addFromDTO(assetDTO);
+ * }
+ * ```
+ *
+ * Integration Points:
+ * - Works with AssetEntity for individual asset management
+ * - Integrates with AppAssetsEntity for collection operations
+ * - Used by GetAppAssetsUC and other use cases for bulk operations
+ * - Supports external APIs through DTO processing
+ */
 export declare abstract class AssetRepo extends AppObjectEntity {
+    /** Static type identifier for component registration */
     static type: string;
+    /**
+     * Adds an asset to the repository if not already present
+     * @param asset - The AssetEntity to add to the repository
+     * Side effects: Triggers change notifications for UI updates
+     */
     abstract add(asset: AssetEntity): void;
+    /**
+     * Checks if an asset exists in the repository
+     * @param id - The unique identifier to check for
+     * @returns true if the asset exists, false otherwise
+     */
     abstract has(id: string): boolean;
+    /**
+     * Retrieves an asset from the repository
+     * @param assetID - The unique identifier of the asset to retrieve
+     * @returns AssetEntity if found, undefined otherwise
+     */
     abstract get(assetID: string): AssetEntity | undefined;
+    /**
+     * Retrieves an existing asset or creates a new one if not found
+     * Uses the asset factory to create new instances when needed
+     * @param assetID - The unique identifier of the asset
+     * @returns AssetEntity (either existing or newly created)
+     */
     abstract getOrCreate(assetID: string): AssetEntity;
+    /**
+     * Retrieves all assets currently stored in the repository
+     * @returns Array of all AssetEntity instances
+     */
     abstract getAll(): AssetEntity[];
+    /**
+     * Removes an asset from the repository
+     * @param assetID - The unique identifier of the asset to remove
+     * Side effects: Triggers change notifications for UI updates
+     */
     abstract remove(assetID: string): void;
+    /**
+     * Factory method for creating new AssetEntity instances
+     * Can be overridden or injected to customize asset creation behavior
+     * @param id - The unique identifier for the new asset
+     * @returns A new AssetEntity instance
+     */
     abstract assetFactory(id: string): AssetEntity;
+    /**
+     * Creates assets from external DTO data with recursive linked asset processing
+     * Handles complex asset hierarchies by processing all linked assets recursively
+     * @param dto - The asset data transfer object containing asset metadata and relationships
+     * @returns The primary AssetEntity created from the DTO
+     * Side effects: Creates and adds multiple assets if linked assets are present
+     */
     abstract addFromDTO(dto: AssetDTO): AssetEntity;
+    /**
+     * Retrieves the singleton AssetRepo from the host application objects
+     * @param hostAppObjects - The application object repository to search
+     * @returns AssetRepo instance or undefined if not found
+     * Uses getSingletonComponent to ensure only one instance exists
+     */
     static get(hostAppObjects: AppObjectRepo): AssetRepo | undefined;
 }
+/**
+ * Factory function to create a new AssetRepo instance
+ * @param appObj - The AppObject that will host this AssetRepo
+ * @returns A new AssetRepo implementation instance
+ */
 export declare function makeAssetRepo(appObj: AppObject): AssetRepo;
 //# sourceMappingURL=AssetRepo.d.ts.map

package/dist/types/Assets/Entities/AssetRepo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssetRepo.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Entities/AssetRepo.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EACT,eAAe,EACf,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAmB,MAAM,eAAe,CAAC;AAE7D,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,QAAQ,CAAA;KAAE,EAAE,CAAC;CACnD;AAED,8BAAsB,SAAU,SAAQ,eAAe;IACrD,MAAM,CAAC,IAAI,SAAqB;IAEhC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IACjC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IACtD,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW;IAClD,QAAQ,CAAC,MAAM,IAAI,WAAW,EAAE;IAChC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW;IAC9C,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW;IAE/C,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,aAAa,GAAG,SAAS,GAAG,SAAS;CAGjE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAE1D"}
+{"version":3,"file":"AssetRepo.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Entities/AssetRepo.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EACT,eAAe,EACf,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAmB,MAAM,eAAe,CAAC;AAE7D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,QAAQ,CAAA;KAAE,EAAE,CAAC;CACnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,8BAAsB,SAAU,SAAQ,eAAe;IACrD,wDAAwD;IACxD,MAAM,CAAC,IAAI,SAAqB;IAEhC;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAEtC;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAEjC;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAEtD;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW;IAElD;;;OAGG;IACH,QAAQ,CAAC,MAAM,IAAI,WAAW,EAAE;IAEhC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAEtC;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW;IAE9C;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW;IAE/C;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,aAAa,GAAG,SAAS,GAAG,SAAS;CAGjE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAE1D"}

package/dist/types/Assets/Entities/index.d.ts

@@ -1,4 +1,4 @@
-export * from './AppAssetsEntity';
-export * from './AssetEntity';
-export * from './AssetRepo';
+export * from "./AppAssetsEntity";
+export * from "./AssetEntity";
+export * from "./AssetRepo";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/Assets/Factories/AssetsFactory.d.ts

@@ -0,0 +1,34 @@
+import { AppObject, DomainFactory } from "@vived/core";
+/**
+ * Factory responsible for setting up the Assets domain components.
+ * This factory initializes all entities, use cases, and presentation models
+ * required for the Assets functionality.
+ */
+export declare class AssetsFactory extends DomainFactory {
+    readonly factoryName = "AssetsFactory";
+    private assetRepoAO;
+    private appAssetsAO;
+    private assetRepo;
+    constructor(appObject: AppObject);
+    /**
+     * Sets up all entities required for the Assets system
+     */
+    setupEntities(): void;
+    /**
+     * Creates an asset factory function that properly initializes assets with all required components
+     */
+    private makeAssetFactory;
+    /**
+     * Sets up all use cases for the Assets system
+     */
+    setupUCs(): void;
+    /**
+     * Sets up all presentation managers for the Assets system
+     */
+    setupPMs(): void;
+    /**
+     * Performs any final setup operations after all components are initialized
+     */
+    finalSetup(): void;
+}
+//# sourceMappingURL=AssetsFactory.d.ts.map

package/dist/types/Assets/Factories/AssetsFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetsFactory.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Factories/AssetsFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAiB,aAAa,EAAE,MAAM,aAAa,CAAC;AA8BtE;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,aAAa;IAE9C,QAAQ,CAAC,WAAW,mBAAmB;IAGvC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,SAAS,CAAM;gBAEX,SAAS,EAAE,SAAS;IAIhC;;OAEG;IACH,aAAa,IAAI,IAAI;IAUrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsBxB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAchB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAOhB;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}

package/dist/types/Assets/Factories/index.d.ts

@@ -1,2 +1,3 @@
-export * from "./AssetRepoFactory";
+export * from "./setupAssetsForSandbox";
+export * from "./AssetsFactory";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/Assets/Factories/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Factories/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Factories/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC"}

package/dist/types/Assets/Factories/setupAssets.d.ts

@@ -0,0 +1,8 @@
+import { AppObjectRepo } from "@vived/core";
+/**
+ * Sets up the Assets system using the domain factory pattern
+ *
+ * @param appObjects The application's object repository
+ */
+export declare function setupAssets(appObjects: AppObjectRepo): void;
+//# sourceMappingURL=setupAssets.d.ts.map

package/dist/types/Assets/Factories/setupAssets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupAssets.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Factories/setupAssets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,aAAa,QAGpD"}