@vived/host 4.10.0 → 4.11.1

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

@@ -1,2 +1,2 @@
-export * from "./AssetPluginFactory";
+export * from "./setupAssetsPluginForSandbox";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/AssetPlugin/Factories/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/AssetPlugin/Factories/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC"}

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

@@ -1,3 +1,33 @@
+/**
+ * archiveAsset.ts
+ *
+ * This controller function handles archiving and unarchiving asset operations.
+ * It provides a simple interface for managing asset visibility without permanently
+ * deleting them from the system.
+ *
+ * Key Concepts:
+ * - Archive operations are reversible soft-deletion mechanisms
+ * - Archived assets are hidden from normal views but remain in the system
+ * - Uses the ArchiveAssetUC to perform the actual business logic
+ * - Provides error handling and validation for missing dependencies
+ *
+ * Usage Patterns:
+ * - Called from UI components when users archive/unarchive assets
+ * - Used by bulk operations for managing multiple assets
+ * - Integrated with asset management workflows for organizational purposes
+ */
 import { AppObjectRepo } from "@vived/core";
+/**
+ * Archives or unarchives an asset, making it hidden or visible in asset lists.
+ *
+ * This function provides a controller-level interface for asset archival operations,
+ * abstracting the underlying use case logic and providing consistent error handling.
+ *
+ * @param assetID - The unique identifier of the asset to archive/unarchive
+ * @param archive - True to archive the asset (hide it), false to unarchive (show it)
+ * @param appObjects - Repository for accessing asset-related app objects and components
+ * @returns Promise that resolves when the operation completes successfully
+ * @throws Promise rejection if the ArchiveAssetUC component cannot be found
+ */
 export declare function archiveAsset(assetID: string, archive: boolean, appObjects: AppObjectRepo): Promise<void>;
 //# sourceMappingURL=archiveAsset.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"archiveAsset.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/archiveAsset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,aAAa,GACxB,OAAO,CAAC,IAAI,CAAC,CAQf"}
+{"version":3,"file":"archiveAsset.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/archiveAsset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,aAAa,GACxB,OAAO,CAAC,IAAI,CAAC,CAQf"}

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

@@ -1,3 +1,33 @@
+/**
+ * deleteAsset.ts
+ *
+ * This controller function handles permanent asset deletion operations with user confirmation.
+ * It provides a safe interface for removing assets from the system completely, including
+ * built-in confirmation dialogs to prevent accidental data loss.
+ *
+ * Key Concepts:
+ * - Permanent deletion removes assets completely from the system
+ * - Includes confirmation prompts to prevent accidental deletions
+ * - Uses DeleteAssetUC to handle the business logic and user interactions
+ * - Provides error handling for missing dependencies
+ *
+ * Usage Patterns:
+ * - Called from UI components when users request asset deletion
+ * - Used in asset management workflows for cleanup operations
+ * - Integrated with confirmation dialogs for user safety
+ */
 import { AppObjectRepo } from "@vived/core";
+/**
+ * Initiates the deletion process for an asset with user confirmation.
+ *
+ * This function provides a controller-level interface for asset deletion operations.
+ * It automatically handles user confirmation prompts through the underlying use case
+ * to ensure users don't accidentally delete important assets.
+ *
+ * @param assetID - The unique identifier of the asset to delete
+ * @param appObjects - Repository for accessing asset-related app objects and components
+ * @returns void - The function initiates the deletion process but doesn't return a promise
+ *                 as the confirmation dialog makes the operation inherently asynchronous
+ */
 export declare function deleteAsset(assetID: string, appObjects: AppObjectRepo): void;
 //# sourceMappingURL=deleteAsset.d.ts.map

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

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

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

@@ -1,3 +1,32 @@
+/**
+ * downloadAssetFile.ts
+ *
+ * This controller function handles asset file download operations, triggering
+ * browser downloads of asset files to the user's local system.
+ *
+ * Key Concepts:
+ * - Initiates browser download of asset files to user's local storage
+ * - Uses DownloadAssetFileUC to handle the underlying download logic
+ * - Provides error handling for missing components
+ * - Works with both local and remote asset files
+ *
+ * Usage Patterns:
+ * - Called from UI components when users click download buttons
+ * - Used in asset management workflows for file retrieval
+ * - Integrated with asset viewers for quick file access
+ */
 import { AppObjectRepo } from "@vived/core";
+/**
+ * Initiates a download of the asset's file to the user's local system.
+ *
+ * This function provides a controller-level interface for asset file downloads.
+ * It triggers the browser's download mechanism to save the asset file locally,
+ * handling both cached and remote file sources automatically.
+ *
+ * @param assetID - The unique identifier of the asset whose file should be downloaded
+ * @param appObjects - Repository for accessing asset-related app objects and components
+ * @returns void - The function initiates the download but doesn't return a promise
+ *                 as the download operation is handled by the browser
+ */
 export declare function downloadAssetFile(assetID: string, appObjects: AppObjectRepo): void;
 //# sourceMappingURL=downloadAssetFile.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"downloadAssetFile.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/downloadAssetFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,QAW3E"}
+{"version":3,"file":"downloadAssetFile.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/downloadAssetFile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,QAW3E"}

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

@@ -1,3 +1,32 @@
+/**
+ * editAppAsset.ts
+ *
+ * This controller function initiates the asset editing workflow, transitioning
+ * the application into editing mode for a specific asset.
+ *
+ * Key Concepts:
+ * - Initiates asset editing workflows and UI state transitions
+ * - Uses EditAppAssetUC to handle editing state management
+ * - Provides error handling for missing components
+ * - Coordinates with asset editing UI components
+ *
+ * Usage Patterns:
+ * - Called from UI components when users click edit buttons
+ * - Used in asset management workflows for content modification
+ * - Integrated with asset editing dialogs and forms
+ */
 import { AppObjectRepo } from "@vived/core";
+/**
+ * Initiates the editing workflow for a specific asset.
+ *
+ * This function provides a controller-level interface for starting asset editing operations.
+ * It transitions the application into editing mode for the specified asset, typically
+ * opening editing dialogs or forms where users can modify asset properties.
+ *
+ * @param assetID - The unique identifier of the asset to edit
+ * @param appObjects - Repository for accessing asset-related app objects and components
+ * @returns void - The function initiates the editing workflow but doesn't return a promise
+ *                 as the editing process is managed through UI state changes
+ */
 export declare function editAppAsset(assetID: string, appObjects: AppObjectRepo): void;
 //# sourceMappingURL=editAppAsset.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"editAppAsset.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/editAppAsset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,QAQtE"}
+{"version":3,"file":"editAppAsset.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/editAppAsset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,QAQtE"}

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

@@ -1,3 +1,32 @@
+/**
+ * getAppAssets.ts
+ *
+ * This controller function initiates the retrieval of assets associated with a specific application.
+ * It triggers the loading and display of all assets that belong to or are used by a particular app.
+ *
+ * Key Concepts:
+ * - Retrieves and loads assets associated with a specific application
+ * - Uses GetAppAssetsUC to handle the asset fetching and filtering logic
+ * - Provides error handling for missing components
+ * - Updates asset collections and UI displays automatically
+ *
+ * Usage Patterns:
+ * - Called when loading an application's asset workspace
+ * - Used in asset management interfaces to filter by application
+ * - Integrated with application switching workflows
+ */
 import { AppObjectRepo } from "@vived/core";
+/**
+ * Retrieves and loads all assets associated with a specific application.
+ *
+ * This function provides a controller-level interface for fetching application-specific assets.
+ * It triggers the loading of all assets that belong to or are used by the specified application,
+ * updating asset collections and UI displays accordingly.
+ *
+ * @param appID - The unique identifier of the application whose assets should be retrieved
+ * @param appObjects - Repository for accessing asset-related app objects and components
+ * @returns void - The function initiates the asset retrieval but doesn't return a promise
+ *                 as the loading process is managed through UI state updates
+ */
 export declare function getAppAssets(appID: string, appObjects: AppObjectRepo): void;
 //# sourceMappingURL=getAppAssets.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getAppAssets.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/getAppAssets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,QAQpE"}
+{"version":3,"file":"getAppAssets.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/getAppAssets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,QAQpE"}

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

@@ -1,3 +1,22 @@
+/**
+ * Assets Controllers Index
+ *
+ * This module exports all controller functions for the Assets feature.
+ * Controllers provide simple, stateless functions that serve as entry points
+ * for asset-related operations from UI components and external systems.
+ *
+ * Key Concepts:
+ * - Controllers act as the interface layer between UI components and business logic
+ * - Each controller function handles a specific asset operation
+ * - Controllers delegate to Use Cases (UCs) for actual business logic implementation
+ * - Error handling and validation are performed at the controller level
+ *
+ * Available Operations:
+ * - Asset lifecycle: create, edit, delete, archive
+ * - File management: upload, download, update
+ * - Collection management: get app assets, toggle archived visibility
+ * - Metadata management: update asset information
+ */
 export * from "./archiveAsset";
 export * from "./deleteAsset";
 export * from "./downloadAssetFile";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}

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

@@ -1,4 +1,34 @@
+/**
+ * newAppAsset.ts
+ *
+ * This controller function handles the creation of new assets within the context
+ * of a specific application. It provides a streamlined interface for adding
+ * new assets to an application's asset collection.
+ *
+ * Key Concepts:
+ * - Creates new assets and associates them with specific applications
+ * - Uses NewAppAssetUC to handle the creation logic and API interactions
+ * - Provides error handling for missing components
+ * - Returns promises for async operation handling
+ *
+ * Usage Patterns:
+ * - Called from UI components when users upload new assets
+ * - Used in asset creation workflows and dialogs
+ * - Integrated with file upload mechanisms and asset forms
+ */
 import { AppObjectRepo } from "@vived/core";
 import { NewAppAssetDTO } from "../UCs/NewAppAssetUC";
+/**
+ * Creates a new asset associated with a specific application.
+ *
+ * This function provides a controller-level interface for creating new application assets.
+ * It handles the complete asset creation workflow, including file upload, metadata storage,
+ * and integration with the application's asset collection.
+ *
+ * @param data - Data transfer object containing all necessary information for asset creation
+ * @param appObjects - Repository for accessing asset-related app objects and components
+ * @returns Promise that resolves when the asset is successfully created
+ * @throws Promise rejection if the NewAppAssetUC component cannot be found
+ */
 export declare function newAppAsset(data: NewAppAssetDTO, appObjects: AppObjectRepo): Promise<void>;
 //# sourceMappingURL=newAppAsset.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"newAppAsset.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/newAppAsset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAiB,MAAM,sBAAsB,CAAC;AAErE,wBAAgB,WAAW,CACzB,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,aAAa,GACxB,OAAO,CAAC,IAAI,CAAC,CAQf"}
+{"version":3,"file":"newAppAsset.d.ts","sourceRoot":"","sources":["../../../../src/Assets/Controllers/newAppAsset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAiB,MAAM,sBAAsB,CAAC;AAErE;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,aAAa,GACxB,OAAO,CAAC,IAAI,CAAC,CAQf"}

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"}