@vived/host 4.10.0 → 4.11.0

package/dist/esm/Assets/Mocks/MockUpdateAppAssetMetaUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"MockUpdateAppAssetMetaUC.js","sourceRoot":"","sources":["../../../../src/Assets/Mocks/MockUpdateAppAssetMetaUC.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,MAAM,OAAO,wBAAyB,SAAQ,oBAAoB;IAGhE,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAH9C,eAAU,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAIpD,CAAC;CACF;AAED,MAAM,UAAU,4BAA4B,CAAC,UAAyB;IACpE,OAAO,IAAI,wBAAwB,CACjC,UAAU,CAAC,WAAW,CAAC,0BAA0B,CAAC,CACnD,CAAC;AACJ,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\r\nimport { UpdateAppAssetMetaUC } from \"../UCs/UpdateAppAssetMetaUC\";\r\n\r\nexport class MockUpdateAppAssetMetaUC extends UpdateAppAssetMetaUC {\r\n  updateMeta = jest.fn().mockResolvedValue(undefined);\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, UpdateAppAssetMetaUC.type);\r\n  }\r\n}\r\n\r\nexport function makeMockUpdateAppAssetMetaUC(appObjects: AppObjectRepo) {\r\n  return new MockUpdateAppAssetMetaUC(\r\n    appObjects.getOrCreate(\"MockUpdateAppAssetMetaUC\")\r\n  );\r\n}\r\n"]}
+{"version":3,"file":"MockUpdateAppAssetMetaUC.js","sourceRoot":"","sources":["../../../../src/Assets/Mocks/MockUpdateAppAssetMetaUC.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,MAAM,OAAO,wBAAyB,SAAQ,oBAAoB;IAGhE,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAH9C,eAAU,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAIpD,CAAC;CACF;AAED,MAAM,UAAU,4BAA4B,CAAC,UAAyB;IACpE,OAAO,IAAI,wBAAwB,CACjC,UAAU,CAAC,WAAW,CAAC,0BAA0B,CAAC,CACnD,CAAC;AACJ,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\nimport { UpdateAppAssetMetaUC } from \"../UCs/UpdateAppAssetMetaUC\";\n\nexport class MockUpdateAppAssetMetaUC extends UpdateAppAssetMetaUC {\n  updateMeta = jest.fn().mockResolvedValue(undefined);\n\n  constructor(appObject: AppObject) {\n    super(appObject, UpdateAppAssetMetaUC.type);\n  }\n}\n\nexport function makeMockUpdateAppAssetMetaUC(appObjects: AppObjectRepo) {\n  return new MockUpdateAppAssetMetaUC(\n    appObjects.getOrCreate(\"MockUpdateAppAssetMetaUC\")\n  );\n}\n"]}

package/dist/esm/Assets/Mocks/MockUpdateAssetFileUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"MockUpdateAssetFileUC.js","sourceRoot":"","sources":["../../../../src/Assets/Mocks/MockUpdateAssetFileUC.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,OAAO,qBAAsB,SAAQ,iBAAiB;IAG1D,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAH3C,eAAU,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAIzD,CAAC;CACF;AAED,MAAM,UAAU,yBAAyB,CAAC,UAAyB;IACjE,OAAO,IAAI,qBAAqB,CAC9B,UAAU,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAChD,CAAC;AACJ,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\r\nimport { UpdateAssetFileUC } from \"../UCs/UpdateAssetFileUC\";\r\n\r\nexport class MockUpdateAssetFileUC extends UpdateAssetFileUC {\r\n  updateFile = jest.fn().mockResolvedValue(\"newFile.name\");\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, UpdateAssetFileUC.type);\r\n  }\r\n}\r\n\r\nexport function makeMockUpdateAssetFileUC(appObjects: AppObjectRepo) {\r\n  return new MockUpdateAssetFileUC(\r\n    appObjects.getOrCreate(\"MockUpdateAssetFileUC\")\r\n  );\r\n}\r\n"]}
+{"version":3,"file":"MockUpdateAssetFileUC.js","sourceRoot":"","sources":["../../../../src/Assets/Mocks/MockUpdateAssetFileUC.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,OAAO,qBAAsB,SAAQ,iBAAiB;IAG1D,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAH3C,eAAU,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAIzD,CAAC;CACF;AAED,MAAM,UAAU,yBAAyB,CAAC,UAAyB;IACjE,OAAO,IAAI,qBAAqB,CAC9B,UAAU,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAChD,CAAC;AACJ,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\nimport { UpdateAssetFileUC } from \"../UCs/UpdateAssetFileUC\";\n\nexport class MockUpdateAssetFileUC extends UpdateAssetFileUC {\n  updateFile = jest.fn().mockResolvedValue(\"newFile.name\");\n\n  constructor(appObject: AppObject) {\n    super(appObject, UpdateAssetFileUC.type);\n  }\n}\n\nexport function makeMockUpdateAssetFileUC(appObjects: AppObjectRepo) {\n  return new MockUpdateAssetFileUC(\n    appObjects.getOrCreate(\"MockUpdateAssetFileUC\")\n  );\n}\n"]}

package/dist/esm/Assets/Mocks/ShowArchivedAppAssetPMMock.js.map

@@ -1 +1 @@
-{"version":3,"file":"ShowArchivedAppAssetPMMock.js","sourceRoot":"","sources":["../../../../src/Assets/Mocks/ShowArchivedAppAssetPMMock.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,MAAM,OAAO,0BAA2B,SAAQ,sBAAsB;IAGpE,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAHhD,gBAAW,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;IAIxB,CAAC;CACF;AAED,MAAM,UAAU,8BAA8B,CAAC,UAAyB;IACtE,OAAO,IAAI,0BAA0B,CACnC,UAAU,CAAC,WAAW,CAAC,4BAA4B,CAAC,CACrD,CAAC;AACJ,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\r\nimport { ShowArchivedAppAssetPM } from \"../PMs/ShowArchivedAppAssetPM\";\r\n\r\nexport class ShowArchivedAppAssetPMMock extends ShowArchivedAppAssetPM {\r\n  vmsAreEqual = jest.fn();\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ShowArchivedAppAssetPM.type);\r\n  }\r\n}\r\n\r\nexport function makeShowArchivedAppAssetPMMock(appObjects: AppObjectRepo) {\r\n  return new ShowArchivedAppAssetPMMock(\r\n    appObjects.getOrCreate(\"ShowArchivedAppAssetPMMock\")\r\n  );\r\n}\r\n"]}
+{"version":3,"file":"ShowArchivedAppAssetPMMock.js","sourceRoot":"","sources":["../../../../src/Assets/Mocks/ShowArchivedAppAssetPMMock.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,MAAM,OAAO,0BAA2B,SAAQ,sBAAsB;IAGpE,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAHhD,gBAAW,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;IAIxB,CAAC;CACF;AAED,MAAM,UAAU,8BAA8B,CAAC,UAAyB;IACtE,OAAO,IAAI,0BAA0B,CACnC,UAAU,CAAC,WAAW,CAAC,4BAA4B,CAAC,CACrD,CAAC;AACJ,CAAC","sourcesContent":["import { AppObject, AppObjectRepo } from \"@vived/core\";\nimport { ShowArchivedAppAssetPM } from \"../PMs/ShowArchivedAppAssetPM\";\n\nexport class ShowArchivedAppAssetPMMock extends ShowArchivedAppAssetPM {\n  vmsAreEqual = jest.fn();\n\n  constructor(appObject: AppObject) {\n    super(appObject, ShowArchivedAppAssetPM.type);\n  }\n}\n\nexport function makeShowArchivedAppAssetPMMock(appObjects: AppObjectRepo) {\n  return new ShowArchivedAppAssetPMMock(\n    appObjects.getOrCreate(\"ShowArchivedAppAssetPMMock\")\n  );\n}\n"]}

package/dist/esm/Assets/Mocks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Assets/Mocks/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC","sourcesContent":["export * from \"./AppAssetListPMMock\";\r\nexport * from \"./AssetPMMock\";\r\nexport * from \"./AssetFilePMMock\";\r\nexport * from \"./EditingAppAssetPMMock\";\r\nexport * from \"./MockArchiveAsset\";\r\nexport * from \"./MockDeleteAssetUC\";\r\nexport * from \"./MockDownloadAssetFileUC\";\r\nexport * from \"./MockEditAppAssetUC\";\r\nexport * from \"./MockGetAppAssetsUC\";\r\nexport * from \"./MockGetAssetBlobURLUC\";\r\nexport * from \"./MockGetAssetFileUC\";\r\nexport * from \"./MockGetAssetUC\";\r\nexport * from \"./MockNewAppAsset\";\r\nexport * from \"./MockNewAssetUC\";\r\nexport * from \"./MockPrefetchAssets\";\r\nexport * from \"./MockUpdateAssetFileUC\";\r\nexport * from \"./MockUpdateAppAssetMetaUC\";\r\nexport * from \"./ShowArchivedAppAssetPMMock\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Assets/Mocks/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC","sourcesContent":["export * from \"./AppAssetListPMMock\";\nexport * from \"./AssetPMMock\";\nexport * from \"./AssetFilePMMock\";\nexport * from \"./EditingAppAssetPMMock\";\nexport * from \"./MockArchiveAsset\";\nexport * from \"./MockDeleteAssetUC\";\nexport * from \"./MockDownloadAssetFileUC\";\nexport * from \"./MockEditAppAssetUC\";\nexport * from \"./MockGetAppAssetsUC\";\nexport * from \"./MockGetAssetBlobURLUC\";\nexport * from \"./MockGetAssetFileUC\";\nexport * from \"./MockGetAssetUC\";\nexport * from \"./MockNewAppAsset\";\nexport * from \"./MockNewAssetUC\";\nexport * from \"./MockPrefetchAssets\";\nexport * from \"./MockUpdateAssetFileUC\";\nexport * from \"./MockUpdateAppAssetMetaUC\";\nexport * from \"./ShowArchivedAppAssetPMMock\";\n"]}

package/dist/esm/Assets/PMs/AppAssetListPM.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppAssetListPM.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/AppAssetListPM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,MAAM,OAAgB,cAAe,SAAQ,WAAqB;IAGhE,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAChE,CAAC;;AAJM,mBAAI,GAAG,gBAAgB,CAAC;AAOjC,MAAM,UAAU,kBAAkB,CAAC,SAAoB;IACrD,OAAO,IAAI,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,iBAAkB,SAAQ,cAAc;IAG5C,IAAY,SAAS;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED,WAAW,CAAC,CAAW,EAAE,CAAW;QAClC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAExC,IAAI,aAAa,GAAG,IAAI,CAAC;QACzB,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACnB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACjB,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;gBAChB,aAAa,GAAG,KAAK,CAAC;YACxB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,aAAa,CAAC;IACvB,CAAC;IAuBD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;QAtBhC,sBAAiB,GAAG,GAAG,EAAE;YAC/B,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO;YAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YAE7C,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;gBAChC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;gBAChC,OAAO;YACT,CAAC;YAED,MAAM,iBAAiB,GAAa,EAAE,CAAC;YAEvC,YAAY,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC3C,IAAI,KAAK,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;oBACtC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;QACvC,CAAC,CAAC;QAKA,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,YAAY,CACrC,eAAe,CAAC,IAAI,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,CACR,+DAA+D,CAChE,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAEzD,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC3B,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectPM,\r\n  AppObjectRepo\r\n} from \"@vived/core\";\r\nimport { AppAssetsEntity } from \"../Entities/AppAssetsEntity\";\r\nimport { AssetRepo } from \"../Entities/AssetRepo\";\r\n\r\nexport abstract class AppAssetListPM extends AppObjectPM<string[]> {\r\n  static type = \"AppAssetListPM\";\r\n\r\n  static get(appObjects: AppObjectRepo): AppAssetListPM | undefined {\r\n    return getSingletonComponent(AppAssetListPM.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makeAppAssetListPM(appObject: AppObject): AppAssetListPM {\r\n  return new AppAssetListPMImp(appObject);\r\n}\r\n\r\nclass AppAssetListPMImp extends AppAssetListPM {\r\n  private appAssets?: AppAssetsEntity;\r\n\r\n  private get assetRepo() {\r\n    return this.getCachedSingleton<AssetRepo>(AssetRepo.type);\r\n  }\r\n\r\n  vmsAreEqual(a: string[], b: string[]): boolean {\r\n    if (a.length !== b.length) return false;\r\n\r\n    let listsAreEqual = true;\r\n    a.forEach((aID, i) => {\r\n      const bID = b[i];\r\n      if (bID !== aID) {\r\n        listsAreEqual = false;\r\n      }\r\n    });\r\n\r\n    return listsAreEqual;\r\n  }\r\n\r\n  private onAppAssetsChange = () => {\r\n    if (!this.appAssets) return;\r\n    const allAppAssets = this.appAssets.getAll();\r\n\r\n    if (this.appAssets.showArchived) {\r\n      this.doUpdateView(allAppAssets);\r\n      return;\r\n    }\r\n\r\n    const nonArchivedAssets: string[] = [];\r\n\r\n    allAppAssets.forEach((assetID) => {\r\n      const asset = this.assetRepo?.get(assetID);\r\n      if (asset && asset.archived === false) {\r\n        nonArchivedAssets.push(assetID);\r\n      }\r\n    });\r\n\r\n    this.doUpdateView(nonArchivedAssets);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, AppAssetListPM.type);\r\n\r\n    this.appAssets = appObject.getComponent<AppAssetsEntity>(\r\n      AppAssetsEntity.type\r\n    );\r\n    if (!this.appAssets) {\r\n      this.error(\r\n        \"PM has been added to an app object without an AppAssetsEntity\"\r\n      );\r\n      return;\r\n    }\r\n\r\n    this.appAssets.addChangeObserver(this.onAppAssetsChange);\r\n\r\n    this.appObjects.registerSingleton(this);\r\n\r\n    this.onAppAssetsChange();\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"AppAssetListPM.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/AppAssetListPM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,MAAM,OAAgB,cAAe,SAAQ,WAAqB;IAGhE,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAChE,CAAC;;AAJM,mBAAI,GAAG,gBAAgB,CAAC;AAOjC,MAAM,UAAU,kBAAkB,CAAC,SAAoB;IACrD,OAAO,IAAI,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,iBAAkB,SAAQ,cAAc;IAG5C,IAAY,SAAS;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAY,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED,WAAW,CAAC,CAAW,EAAE,CAAW;QAClC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAExC,IAAI,aAAa,GAAG,IAAI,CAAC;QACzB,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACnB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACjB,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;gBAChB,aAAa,GAAG,KAAK,CAAC;YACxB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,aAAa,CAAC;IACvB,CAAC;IAuBD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;QAtBhC,sBAAiB,GAAG,GAAG,EAAE;YAC/B,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO;YAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YAE7C,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;gBAChC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;gBAChC,OAAO;YACT,CAAC;YAED,MAAM,iBAAiB,GAAa,EAAE,CAAC;YAEvC,YAAY,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC3C,IAAI,KAAK,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;oBACtC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;QACvC,CAAC,CAAC;QAKA,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,YAAY,CACrC,eAAe,CAAC,IAAI,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,CACR,+DAA+D,CAChE,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAEzD,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC3B,CAAC;CACF","sourcesContent":["import {\n  getSingletonComponent,\n  AppObject,\n  AppObjectPM,\n  AppObjectRepo\n} from \"@vived/core\";\nimport { AppAssetsEntity } from \"../Entities/AppAssetsEntity\";\nimport { AssetRepo } from \"../Entities/AssetRepo\";\n\nexport abstract class AppAssetListPM extends AppObjectPM<string[]> {\n  static type = \"AppAssetListPM\";\n\n  static get(appObjects: AppObjectRepo): AppAssetListPM | undefined {\n    return getSingletonComponent(AppAssetListPM.type, appObjects);\n  }\n}\n\nexport function makeAppAssetListPM(appObject: AppObject): AppAssetListPM {\n  return new AppAssetListPMImp(appObject);\n}\n\nclass AppAssetListPMImp extends AppAssetListPM {\n  private appAssets?: AppAssetsEntity;\n\n  private get assetRepo() {\n    return this.getCachedSingleton<AssetRepo>(AssetRepo.type);\n  }\n\n  vmsAreEqual(a: string[], b: string[]): boolean {\n    if (a.length !== b.length) return false;\n\n    let listsAreEqual = true;\n    a.forEach((aID, i) => {\n      const bID = b[i];\n      if (bID !== aID) {\n        listsAreEqual = false;\n      }\n    });\n\n    return listsAreEqual;\n  }\n\n  private onAppAssetsChange = () => {\n    if (!this.appAssets) return;\n    const allAppAssets = this.appAssets.getAll();\n\n    if (this.appAssets.showArchived) {\n      this.doUpdateView(allAppAssets);\n      return;\n    }\n\n    const nonArchivedAssets: string[] = [];\n\n    allAppAssets.forEach((assetID) => {\n      const asset = this.assetRepo?.get(assetID);\n      if (asset && asset.archived === false) {\n        nonArchivedAssets.push(assetID);\n      }\n    });\n\n    this.doUpdateView(nonArchivedAssets);\n  };\n\n  constructor(appObject: AppObject) {\n    super(appObject, AppAssetListPM.type);\n\n    this.appAssets = appObject.getComponent<AppAssetsEntity>(\n      AppAssetsEntity.type\n    );\n    if (!this.appAssets) {\n      this.error(\n        \"PM has been added to an app object without an AppAssetsEntity\"\n      );\n      return;\n    }\n\n    this.appAssets.addChangeObserver(this.onAppAssetsChange);\n\n    this.appObjects.registerSingleton(this);\n\n    this.onAppAssetsChange();\n  }\n}\n"]}

package/dist/esm/Assets/PMs/AssetFilePM.js.map

@@ -1 +1 @@
-{"version":3,"file":"AssetFilePM.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/AssetFilePM.ts"],"names":[],"mappings":"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","sourcesContent":["// filepath: c:\\Users\\amosp\\Documents\\WebGL\\vivedlearning_host\\src\\Assets\\PMs\\AssetFilePM.ts\r\nimport { AppObject, AppObjectPM, AppObjectRepo } from \"@vived/core\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\n\r\n/**\r\n * View Model for Asset file information\r\n * Represents the data needed by the view to display asset file status\r\n */\r\nexport interface AssetFileVM {\r\n  /** URL to the asset's file blob for direct access */\r\n  blobURL: string | undefined;\r\n  /** Whether the asset file is currently being fetched */\r\n  isFetchingFile: boolean;\r\n  /** Whether the asset file has been successfully fetched */\r\n  fileHasBeenFetched: boolean;\r\n  /** Error that occurred during file fetching, if any */\r\n  fetchError: Error | undefined;\r\n}\r\n\r\n/**\r\n * Default empty AssetFileVM for initialization\r\n */\r\nexport const defaultAssetFileVM: AssetFileVM = {\r\n  blobURL: undefined,\r\n  isFetchingFile: false,\r\n  fileHasBeenFetched: false,\r\n  fetchError: undefined\r\n};\r\n\r\n/**\r\n * Presentation Manager for Asset file status\r\n *\r\n * The AssetFilePM is responsible for:\r\n * - Converting the file-related properties of AssetEntity into a view-friendly format (AssetFileVM)\r\n * - Notifying the view when asset file status changes\r\n * - Providing comparison utilities for view models\r\n *\r\n * Usage:\r\n * 1. Retrieve an instance with `AssetFilePM.getByID(assetId, appObjects)`\r\n * 2. Subscribe to view updates with `pm.addView(callback)`\r\n * 3. Access current view data with `pm.lastVM`\r\n */\r\nexport abstract class AssetFilePM extends AppObjectPM<AssetFileVM> {\r\n  static type = \"AssetFilePM\";\r\n\r\n  /**\r\n   * Retrieves an AssetFilePM instance for a specific asset by ID\r\n   *\r\n   * @param assetID - The unique identifier of the asset\r\n   * @param appObjects - The repository of app objects\r\n   * @returns The AssetFilePM instance or undefined if not found\r\n   */\r\n  static getByID(\r\n    assetID: string,\r\n    appObjects: AppObjectRepo\r\n  ): AssetFilePM | undefined {\r\n    const appObject = appObjects.get(assetID);\r\n    if (!appObject) {\r\n      appObjects.submitWarning(\r\n        \"AssetFilePM.getByID\",\r\n        \"Unable to find app object by ID \" + assetID\r\n      );\r\n      return;\r\n    }\r\n\r\n    const pm = appObject.getComponent<AssetFilePM>(AssetFilePM.type);\r\n    if (!pm) {\r\n      appObjects.submitWarning(\r\n        \"AssetFilePM.getByID\",\r\n        \"App Object does not have a AssetFilePM\"\r\n      );\r\n      return;\r\n    }\r\n    return pm;\r\n  }\r\n}\r\n\r\n/**\r\n * Creates a new AssetFilePM instance\r\n *\r\n * @param appObject - The app object to associate with this PM\r\n * @returns A new AssetFilePM instance\r\n */\r\nexport function makeAssetFilePM(appObject: AppObject): AssetFilePM {\r\n  return new AssetFilePMImp(appObject);\r\n}\r\n\r\n/**\r\n * Implementation of the AssetFilePM abstract class\r\n * Handles the connection between AssetEntity file properties and view\r\n */\r\nclass AssetFilePMImp extends AssetFilePM {\r\n  private get asset() {\r\n\t\treturn this.getCachedLocalComponent<AssetEntity>(AssetEntity.type);\r\n\t}\r\n\r\n  /**\r\n   * Compares two AssetFileVM instances for equality\r\n   * Used to determine if the view needs to update\r\n   *\r\n   * @param a - First AssetFileVM to compare\r\n   * @param b - Second AssetFileVM to compare\r\n   * @returns True if view models are equal, false otherwise\r\n   */\r\n  vmsAreEqual(a: AssetFileVM, b: AssetFileVM): boolean {\r\n    if (a.blobURL !== b.blobURL) return false;\r\n    if (a.isFetchingFile !== b.isFetchingFile) return false;\r\n    if (a.fileHasBeenFetched !== b.fileHasBeenFetched) return false;\r\n\r\n    // Handle errors comparison (both undefined, or same message)\r\n    if (a.fetchError !== b.fetchError) {\r\n      if (a.fetchError === undefined && b.fetchError !== undefined)\r\n        return false;\r\n      if (a.fetchError !== undefined && b.fetchError === undefined)\r\n        return false;\r\n      if (\r\n        a.fetchError !== undefined &&\r\n        b.fetchError !== undefined &&\r\n        a.fetchError.message !== b.fetchError.message\r\n      )\r\n        return false;\r\n    }\r\n\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Observer callback that updates the view model when the entity changes\r\n   * Transforms entity data into view model format\r\n   */\r\n  private onAssetChange = () => {\r\n    if (!this.asset) return;\r\n\r\n    const vm: AssetFileVM = {\r\n      blobURL: this.asset.blobURL,\r\n      isFetchingFile: this.asset.isFetchingFile,\r\n      fileHasBeenFetched: this.asset.fileHasBeenFetched,\r\n      fetchError: this.asset.fetchError\r\n    };\r\n\r\n    this.doUpdateView(vm);\r\n  };\r\n\r\n  /**\r\n   * Cleans up resources and removes observers when the PM is disposed\r\n   */\r\n  dispose(): void {\r\n    if (this.asset) {\r\n      this.asset.removeChangeObserver(this.onAssetChange);\r\n    }\r\n    super.dispose();\r\n  }\r\n\r\n  /**\r\n   * Creates a new AssetFilePMImp instance\r\n   *\r\n   * @param appObject - The app object to associate with this PM\r\n   */\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, AssetFilePM.type);\r\n\r\n    this.asset?.addChangeObserver(this.onAssetChange);\r\n    this.onAssetChange();\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"AssetFilePM.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/AssetFilePM.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,EAAa,WAAW,EAAiB,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAiBtD;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAgB;IAC7C,OAAO,EAAE,SAAS;IAClB,cAAc,EAAE,KAAK;IACrB,kBAAkB,EAAE,KAAK;IACzB,UAAU,EAAE,SAAS;CACtB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,OAAgB,WAAY,SAAQ,WAAwB;IAGhE;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CACZ,OAAe,EACf,UAAyB;QAEzB,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,UAAU,CAAC,aAAa,CACtB,qBAAqB,EACrB,kCAAkC,GAAG,OAAO,CAC7C,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,EAAE,GAAG,SAAS,CAAC,YAAY,CAAc,WAAW,CAAC,IAAI,CAAC,CAAC;QACjE,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,aAAa,CACtB,qBAAqB,EACrB,wCAAwC,CACzC,CAAC;YACF,OAAO;QACT,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;;AA/BM,gBAAI,GAAG,aAAa,CAAC;AAkC9B;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,SAAoB;IAClD,OAAO,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,cAAe,SAAQ,WAAW;IACtC,IAAY,KAAK;QACf,OAAO,IAAI,CAAC,uBAAuB,CAAc,WAAW,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;OAOG;IACH,WAAW,CAAC,CAAc,EAAE,CAAc;QACxC,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC1C,IAAI,CAAC,CAAC,cAAc,KAAK,CAAC,CAAC,cAAc;YAAE,OAAO,KAAK,CAAC;QACxD,IAAI,CAAC,CAAC,kBAAkB,KAAK,CAAC,CAAC,kBAAkB;YAAE,OAAO,KAAK,CAAC;QAEhE,6DAA6D;QAC7D,IAAI,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;YAClC,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS;gBAC1D,OAAO,KAAK,CAAC;YACf,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS;gBAC1D,OAAO,KAAK,CAAC;YACf,IACE,CAAC,CAAC,UAAU,KAAK,SAAS;gBAC1B,CAAC,CAAC,UAAU,KAAK,SAAS;gBAC1B,CAAC,CAAC,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,UAAU,CAAC,OAAO;gBAE7C,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAmBD;;OAEG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACH,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAjCrC;;;WAGG;QACK,kBAAa,GAAG,GAAG,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,KAAK;gBAAE,OAAO;YAExB,MAAM,EAAE,GAAgB;gBACtB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO;gBAC3B,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc;gBACzC,kBAAkB,EAAE,IAAI,CAAC,KAAK,CAAC,kBAAkB;gBACjD,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU;aAClC,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC,CAAC;QAoBA,IAAI,CAAC,KAAK,EAAE,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAClD,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;CACF","sourcesContent":["// filepath: c:\\Users\\amosp\\Documents\\WebGL\\vivedlearning_host\\src\\Assets\\PMs\\AssetFilePM.ts\nimport { AppObject, AppObjectPM, AppObjectRepo } from \"@vived/core\";\nimport { AssetEntity } from \"../Entities/AssetEntity\";\n\n/**\n * View Model for Asset file information\n * Represents the data needed by the view to display asset file status\n */\nexport interface AssetFileVM {\n  /** URL to the asset's file blob for direct access */\n  blobURL: string | undefined;\n  /** Whether the asset file is currently being fetched */\n  isFetchingFile: boolean;\n  /** Whether the asset file has been successfully fetched */\n  fileHasBeenFetched: boolean;\n  /** Error that occurred during file fetching, if any */\n  fetchError: Error | undefined;\n}\n\n/**\n * Default empty AssetFileVM for initialization\n */\nexport const defaultAssetFileVM: AssetFileVM = {\n  blobURL: undefined,\n  isFetchingFile: false,\n  fileHasBeenFetched: false,\n  fetchError: undefined\n};\n\n/**\n * Presentation Manager for Asset file status\n *\n * The AssetFilePM is responsible for:\n * - Converting the file-related properties of AssetEntity into a view-friendly format (AssetFileVM)\n * - Notifying the view when asset file status changes\n * - Providing comparison utilities for view models\n *\n * Usage:\n * 1. Retrieve an instance with `AssetFilePM.getByID(assetId, appObjects)`\n * 2. Subscribe to view updates with `pm.addView(callback)`\n * 3. Access current view data with `pm.lastVM`\n */\nexport abstract class AssetFilePM extends AppObjectPM<AssetFileVM> {\n  static type = \"AssetFilePM\";\n\n  /**\n   * Retrieves an AssetFilePM instance for a specific asset by ID\n   *\n   * @param assetID - The unique identifier of the asset\n   * @param appObjects - The repository of app objects\n   * @returns The AssetFilePM instance or undefined if not found\n   */\n  static getByID(\n    assetID: string,\n    appObjects: AppObjectRepo\n  ): AssetFilePM | undefined {\n    const appObject = appObjects.get(assetID);\n    if (!appObject) {\n      appObjects.submitWarning(\n        \"AssetFilePM.getByID\",\n        \"Unable to find app object by ID \" + assetID\n      );\n      return;\n    }\n\n    const pm = appObject.getComponent<AssetFilePM>(AssetFilePM.type);\n    if (!pm) {\n      appObjects.submitWarning(\n        \"AssetFilePM.getByID\",\n        \"App Object does not have a AssetFilePM\"\n      );\n      return;\n    }\n    return pm;\n  }\n}\n\n/**\n * Creates a new AssetFilePM instance\n *\n * @param appObject - The app object to associate with this PM\n * @returns A new AssetFilePM instance\n */\nexport function makeAssetFilePM(appObject: AppObject): AssetFilePM {\n  return new AssetFilePMImp(appObject);\n}\n\n/**\n * Implementation of the AssetFilePM abstract class\n * Handles the connection between AssetEntity file properties and view\n */\nclass AssetFilePMImp extends AssetFilePM {\n  private get asset() {\n    return this.getCachedLocalComponent<AssetEntity>(AssetEntity.type);\n  }\n\n  /**\n   * Compares two AssetFileVM instances for equality\n   * Used to determine if the view needs to update\n   *\n   * @param a - First AssetFileVM to compare\n   * @param b - Second AssetFileVM to compare\n   * @returns True if view models are equal, false otherwise\n   */\n  vmsAreEqual(a: AssetFileVM, b: AssetFileVM): boolean {\n    if (a.blobURL !== b.blobURL) return false;\n    if (a.isFetchingFile !== b.isFetchingFile) return false;\n    if (a.fileHasBeenFetched !== b.fileHasBeenFetched) return false;\n\n    // Handle errors comparison (both undefined, or same message)\n    if (a.fetchError !== b.fetchError) {\n      if (a.fetchError === undefined && b.fetchError !== undefined)\n        return false;\n      if (a.fetchError !== undefined && b.fetchError === undefined)\n        return false;\n      if (\n        a.fetchError !== undefined &&\n        b.fetchError !== undefined &&\n        a.fetchError.message !== b.fetchError.message\n      )\n        return false;\n    }\n\n    return true;\n  }\n\n  /**\n   * Observer callback that updates the view model when the entity changes\n   * Transforms entity data into view model format\n   */\n  private onAssetChange = () => {\n    if (!this.asset) return;\n\n    const vm: AssetFileVM = {\n      blobURL: this.asset.blobURL,\n      isFetchingFile: this.asset.isFetchingFile,\n      fileHasBeenFetched: this.asset.fileHasBeenFetched,\n      fetchError: this.asset.fetchError\n    };\n\n    this.doUpdateView(vm);\n  };\n\n  /**\n   * Cleans up resources and removes observers when the PM is disposed\n   */\n  dispose(): void {\n    if (this.asset) {\n      this.asset.removeChangeObserver(this.onAssetChange);\n    }\n    super.dispose();\n  }\n\n  /**\n   * Creates a new AssetFilePMImp instance\n   *\n   * @param appObject - The app object to associate with this PM\n   */\n  constructor(appObject: AppObject) {\n    super(appObject, AssetFilePM.type);\n\n    this.asset?.addChangeObserver(this.onAssetChange);\n    this.onAssetChange();\n  }\n}\n"]}

package/dist/esm/Assets/PMs/AssetPM.js

@@ -1,6 +1,39 @@
+/**
+ * AssetPM.ts
+ *
+ * This presentation manager handles the view model generation and change tracking
+ * for individual asset entities, providing a clean interface between asset data
+ * and UI components.
+ *
+ * Key Concepts:
+ * - Transforms asset entity data into view models for UI consumption
+ * - Tracks entity changes and triggers UI updates when needed
+ * - Provides efficient comparison methods for view model equality
+ * - Manages asset entity lifecycle and observer patterns
+ * - Follows the PM pattern for separation of concerns between domain and presentation
+ *
+ * Usage Patterns:
+ * - Created per-asset during factory setup
+ * - Accessed through static getByID() method with asset ID
+ * - Automatically updates UI components when underlying asset data changes
+ * - Used by adapters to connect asset data to React components and other UI frameworks
+ */
 import { AppObjectPM } from "@vived/core";
 import { AssetEntity } from "../Entities/AssetEntity";
+/**
+ * AssetPM manages presentation logic for individual asset entities.
+ *
+ * This presentation manager bridges the gap between asset domain entities
+ * and UI components by providing optimized view models and change tracking.
+ */
 export class AssetPM extends AppObjectPM {
+    /**
+     * Retrieves an AssetPM component for a specific asset.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @param appObjects - Repository for accessing app objects and components
+     * @returns AssetPM instance or undefined if not found
+     */
     static getByID(assetID, appObjects) {
         const appObject = appObjects.get(assetID);
         if (!appObject) {
@@ -15,11 +48,34 @@ export class AssetPM extends AppObjectPM {
         return pm;
     }
 }
+/** Static type identifier for component registration */
 AssetPM.type = "AssetPM";
+/**
+ * Factory function to create a new AssetPM instance.
+ *
+ * @param appObject - The AppObject that will host this PM (should contain an AssetEntity)
+ * @returns A new AssetPM implementation instance
+ */
 export function makeAssetPM(appObject) {
     return new AssetPMImp(appObject);
 }
+/**
+ * Private implementation of AssetPM with entity integration and change tracking.
+ *
+ * Key Implementation Details:
+ * - Observes AssetEntity changes and generates view models accordingly
+ * - Implements efficient view model comparison for performance optimization
+ * - Handles entity lifecycle management and cleanup
+ * - Provides error handling for missing entity dependencies
+ */
 class AssetPMImp extends AssetPM {
+    /**
+     * Compares two asset view models for equality to optimize UI updates.
+     *
+     * @param a - First asset view model to compare
+     * @param b - Second asset view model to compare
+     * @returns true if view models are equal, false otherwise
+     */
     vmsAreEqual(a, b) {
         if (a.archived !== b.archived)
             return false;

package/dist/esm/Assets/PMs/AssetPM.js.map

@@ -1 +1 @@
-{"version":3,"file":"AssetPM.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/AssetPM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,WAAW,EAAiB,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAStD,MAAM,OAAgB,OAAQ,SAAQ,WAAoB;IAGxD,MAAM,CAAC,OAAO,CACZ,OAAe,EACf,UAAyB;QAEzB,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,UAAU,CAAC,aAAa,CACtB,iBAAiB,EACjB,kCAAkC,GAAG,OAAO,CAC7C,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,EAAE,GAAG,SAAS,CAAC,YAAY,CAAU,OAAO,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,aAAa,CACtB,iBAAiB,EACjB,oCAAoC,CACrC,CAAC;YACF,OAAO;QACT,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;;AAxBM,YAAI,GAAG,SAAS,CAAC;AA2B1B,MAAM,UAAU,WAAW,CAAC,SAAoB;IAC9C,OAAO,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAW,SAAQ,OAAO;IAG9B,WAAW,CAAC,CAAU,EAAE,CAAU;QAChC,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,IAAI,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW;YAAE,OAAO,KAAK,CAAC;QAClD,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACpC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE;YAAE,OAAO,KAAK,CAAC;QAEhC,OAAO,IAAI,CAAC;IACd,CAAC;IAeD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAdzB,kBAAa,GAAG,GAAG,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,KAAK;gBAAE,OAAO;YAExB,MAAM,EAAE,GAAY;gBAClB,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ;gBAC7B,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW;gBACnC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE;gBACjB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;aACtB,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC,CAAC;QAKA,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,YAAY,CAAc,WAAW,CAAC,IAAI,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;YACvE,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACjD,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,QAAQ,EAAE,KAAK;IACf,WAAW,EAAE,EAAE;IACf,EAAE,EAAE,EAAE;IACN,IAAI,EAAE,EAAE;CACT,CAAC","sourcesContent":["import { AppObject, AppObjectPM, AppObjectRepo } from \"@vived/core\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\n\r\nexport interface AssetVM {\r\n  id: string;\r\n  name: string;\r\n  description: string;\r\n  archived: boolean;\r\n}\r\n\r\nexport abstract class AssetPM extends AppObjectPM<AssetVM> {\r\n  static type = \"AssetPM\";\r\n\r\n  static getByID(\r\n    assetID: string,\r\n    appObjects: AppObjectRepo\r\n  ): AssetPM | undefined {\r\n    const appObject = appObjects.get(assetID);\r\n    if (!appObject) {\r\n      appObjects.submitWarning(\r\n        \"AssetPM.getByID\",\r\n        \"Unable to find app object by ID \" + assetID\r\n      );\r\n      return;\r\n    }\r\n\r\n    const pm = appObject.getComponent<AssetPM>(AssetPM.type);\r\n    if (!pm) {\r\n      appObjects.submitWarning(\r\n        \"AssetPM.getByID\",\r\n        \"App Object does not have a AssetPM\"\r\n      );\r\n      return;\r\n    }\r\n    return pm;\r\n  }\r\n}\r\n\r\nexport function makeAssetPM(appObject: AppObject): AssetPM {\r\n  return new AssetPMImp(appObject);\r\n}\r\n\r\nclass AssetPMImp extends AssetPM {\r\n  private asset?: AssetEntity;\r\n\r\n  vmsAreEqual(a: AssetVM, b: AssetVM): boolean {\r\n    if (a.archived !== b.archived) return false;\r\n    if (a.description !== b.description) return false;\r\n    if (a.name !== b.name) return false;\r\n    if (a.id !== b.id) return false;\r\n\r\n    return true;\r\n  }\r\n\r\n  private onAssetChange = () => {\r\n    if (!this.asset) return;\r\n\r\n    const vm: AssetVM = {\r\n      archived: this.asset.archived,\r\n      description: this.asset.description,\r\n      id: this.asset.id,\r\n      name: this.asset.name\r\n    };\r\n\r\n    this.doUpdateView(vm);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, AssetPM.type);\r\n\r\n    this.asset = appObject.getComponent<AssetEntity>(AssetEntity.type);\r\n    if (!this.asset) {\r\n      this.warn(\"PM has been added to an App Object without an AssetEntity\");\r\n      return;\r\n    }\r\n\r\n    this.asset.addChangeObserver(this.onAssetChange);\r\n    this.onAssetChange();\r\n  }\r\n}\r\n\r\nexport const defaultAssetVM: AssetVM = {\r\n  archived: false,\r\n  description: \"\",\r\n  id: \"\",\r\n  name: \"\"\r\n};\r\n"]}
+{"version":3,"file":"AssetPM.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/AssetPM.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAa,WAAW,EAAiB,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAiBtD;;;;;GAKG;AACH,MAAM,OAAgB,OAAQ,SAAQ,WAAoB;IAIxD;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CACZ,OAAe,EACf,UAAyB;QAEzB,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,UAAU,CAAC,aAAa,CACtB,iBAAiB,EACjB,kCAAkC,GAAG,OAAO,CAC7C,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,EAAE,GAAG,SAAS,CAAC,YAAY,CAAU,OAAO,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,UAAU,CAAC,aAAa,CACtB,iBAAiB,EACjB,oCAAoC,CACrC,CAAC;YACF,OAAO;QACT,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;;AAhCD,wDAAwD;AACjD,YAAI,GAAG,SAAS,CAAC;AAkC1B;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,SAAoB;IAC9C,OAAO,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAW,SAAQ,OAAO;IAI9B;;;;;;OAMG;IACH,WAAW,CAAC,CAAU,EAAE,CAAU;QAChC,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,IAAI,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW;YAAE,OAAO,KAAK,CAAC;QAClD,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACpC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE;YAAE,OAAO,KAAK,CAAC;QAEhC,OAAO,IAAI,CAAC;IACd,CAAC;IAeD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAdzB,kBAAa,GAAG,GAAG,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,KAAK;gBAAE,OAAO;YAExB,MAAM,EAAE,GAAY;gBAClB,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ;gBAC7B,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW;gBACnC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE;gBACjB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;aACtB,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC,CAAC;QAKA,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,YAAY,CAAc,WAAW,CAAC,IAAI,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;YACvE,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACjD,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,QAAQ,EAAE,KAAK;IACf,WAAW,EAAE,EAAE;IACf,EAAE,EAAE,EAAE;IACN,IAAI,EAAE,EAAE;CACT,CAAC","sourcesContent":["/**\r\n * AssetPM.ts\r\n *\r\n * This presentation manager handles the view model generation and change tracking\r\n * for individual asset entities, providing a clean interface between asset data\r\n * and UI components.\r\n *\r\n * Key Concepts:\r\n * - Transforms asset entity data into view models for UI consumption\r\n * - Tracks entity changes and triggers UI updates when needed\r\n * - Provides efficient comparison methods for view model equality\r\n * - Manages asset entity lifecycle and observer patterns\r\n * - Follows the PM pattern for separation of concerns between domain and presentation\r\n *\r\n * Usage Patterns:\r\n * - Created per-asset during factory setup\r\n * - Accessed through static getByID() method with asset ID\r\n * - Automatically updates UI components when underlying asset data changes\r\n * - Used by adapters to connect asset data to React components and other UI frameworks\r\n */\r\n\r\nimport { AppObject, AppObjectPM, AppObjectRepo } from \"@vived/core\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\n\r\n/**\r\n * View model interface representing asset data optimized for UI display.\r\n * Contains essential asset information formatted for presentation components.\r\n */\r\nexport interface AssetVM {\r\n  /** Unique identifier of the asset */\r\n  id: string;\r\n  /** Display name of the asset */\r\n  name: string;\r\n  /** Description of the asset's purpose or content */\r\n  description: string;\r\n  /** Whether the asset is archived (hidden from normal views) */\r\n  archived: boolean;\r\n}\r\n\r\n/**\r\n * AssetPM manages presentation logic for individual asset entities.\r\n *\r\n * This presentation manager bridges the gap between asset domain entities\r\n * and UI components by providing optimized view models and change tracking.\r\n */\r\nexport abstract class AssetPM extends AppObjectPM<AssetVM> {\r\n  /** Static type identifier for component registration */\r\n  static type = \"AssetPM\";\r\n\r\n  /**\r\n   * Retrieves an AssetPM component for a specific asset.\r\n   *\r\n   * @param assetID - The unique identifier of the asset\r\n   * @param appObjects - Repository for accessing app objects and components\r\n   * @returns AssetPM instance or undefined if not found\r\n   */\r\n  static getByID(\r\n    assetID: string,\r\n    appObjects: AppObjectRepo\r\n  ): AssetPM | undefined {\r\n    const appObject = appObjects.get(assetID);\r\n    if (!appObject) {\r\n      appObjects.submitWarning(\r\n        \"AssetPM.getByID\",\r\n        \"Unable to find app object by ID \" + assetID\r\n      );\r\n      return;\r\n    }\r\n\r\n    const pm = appObject.getComponent<AssetPM>(AssetPM.type);\r\n    if (!pm) {\r\n      appObjects.submitWarning(\r\n        \"AssetPM.getByID\",\r\n        \"App Object does not have a AssetPM\"\r\n      );\r\n      return;\r\n    }\r\n    return pm;\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new AssetPM instance.\r\n *\r\n * @param appObject - The AppObject that will host this PM (should contain an AssetEntity)\r\n * @returns A new AssetPM implementation instance\r\n */\r\nexport function makeAssetPM(appObject: AppObject): AssetPM {\r\n  return new AssetPMImp(appObject);\r\n}\r\n\r\n/**\r\n * Private implementation of AssetPM with entity integration and change tracking.\r\n *\r\n * Key Implementation Details:\r\n * - Observes AssetEntity changes and generates view models accordingly\r\n * - Implements efficient view model comparison for performance optimization\r\n * - Handles entity lifecycle management and cleanup\r\n * - Provides error handling for missing entity dependencies\r\n */\r\nclass AssetPMImp extends AssetPM {\r\n  /** The asset entity this PM observes and presents */\r\n  private asset?: AssetEntity;\r\n\r\n  /**\r\n   * Compares two asset view models for equality to optimize UI updates.\r\n   *\r\n   * @param a - First asset view model to compare\r\n   * @param b - Second asset view model to compare\r\n   * @returns true if view models are equal, false otherwise\r\n   */\r\n  vmsAreEqual(a: AssetVM, b: AssetVM): boolean {\r\n    if (a.archived !== b.archived) return false;\r\n    if (a.description !== b.description) return false;\r\n    if (a.name !== b.name) return false;\r\n    if (a.id !== b.id) return false;\r\n\r\n    return true;\r\n  }\r\n\r\n  private onAssetChange = () => {\r\n    if (!this.asset) return;\r\n\r\n    const vm: AssetVM = {\r\n      archived: this.asset.archived,\r\n      description: this.asset.description,\r\n      id: this.asset.id,\r\n      name: this.asset.name\r\n    };\r\n\r\n    this.doUpdateView(vm);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, AssetPM.type);\r\n\r\n    this.asset = appObject.getComponent<AssetEntity>(AssetEntity.type);\r\n    if (!this.asset) {\r\n      this.warn(\"PM has been added to an App Object without an AssetEntity\");\r\n      return;\r\n    }\r\n\r\n    this.asset.addChangeObserver(this.onAssetChange);\r\n    this.onAssetChange();\r\n  }\r\n}\r\n\r\nexport const defaultAssetVM: AssetVM = {\r\n  archived: false,\r\n  description: \"\",\r\n  id: \"\",\r\n  name: \"\"\r\n};\r\n"]}

package/dist/esm/Assets/PMs/EditingAppAssetPM.js.map

@@ -1 +1 @@
-{"version":3,"file":"EditingAppAssetPM.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/EditingAppAssetPM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAU9D,MAAM,OAAgB,iBAAkB,SAAQ,WAE/C;IAGC,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACnE,CAAC;;AAJM,sBAAI,GAAG,mBAAmB,CAAC;AAOpC,MAAM,UAAU,qBAAqB,CAAC,SAAoB;IACxD,OAAO,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,oBAAqB,SAAQ,iBAAiB;IAGlD,WAAW,CACT,CAAgC,EAChC,CAAgC;QAEhC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAEpD,IAAI,CAAC,EAAE,QAAQ,KAAK,CAAC,EAAE,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9C,IAAI,CAAC,EAAE,WAAW,KAAK,CAAC,EAAE,WAAW;YAAE,OAAO,KAAK,CAAC;QACpD,IAAI,CAAC,EAAE,QAAQ,KAAK,CAAC,EAAE,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9C,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE;YAAE,OAAO,KAAK,CAAC;QAClC,IAAI,CAAC,EAAE,IAAI,KAAK,CAAC,EAAE,IAAI;YAAE,OAAO,KAAK,CAAC;QAEtC,OAAO,IAAI,CAAC;IACd,CAAC;IA0BD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAzBnC,kBAAa,GAAG,GAAG,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO;YAE5B,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;gBAChC,MAAM,EACJ,EAAE,EACF,IAAI,EACJ,WAAW,EACX,QAAQ,EACR,QAAQ,EACT,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;gBAChC,MAAM,EAAE,GAAsB;oBAC5B,EAAE;oBACF,IAAI;oBACJ,WAAW;oBACX,QAAQ;oBACR,QAAQ;iBACT,CAAC;gBACF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC,CAAC;QAKA,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,YAAY,CACrC,eAAe,CAAC,IAAI,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CACP,+DAA+D,CAChE,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrD,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectPM,\r\n  AppObjectRepo\r\n} from \"@vived/core\";\r\nimport { AppAssetsEntity } from \"../Entities/AppAssetsEntity\";\r\n\r\nexport interface EditingAppAssetVM {\r\n  id: string;\r\n  name: string;\r\n  description: string;\r\n  archived: boolean;\r\n  filename: string;\r\n}\r\n\r\nexport abstract class EditingAppAssetPM extends AppObjectPM<\r\n  EditingAppAssetVM | undefined\r\n> {\r\n  static type = \"EditingAppAssetPM\";\r\n\r\n  static get(appObjects: AppObjectRepo): EditingAppAssetPM | undefined {\r\n    return getSingletonComponent(EditingAppAssetPM.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makeEditingAppAssetPM(appObject: AppObject): EditingAppAssetPM {\r\n  return new EditingAppAssetPMImp(appObject);\r\n}\r\n\r\nclass EditingAppAssetPMImp extends EditingAppAssetPM {\r\n  private appAssets?: AppAssetsEntity;\r\n\r\n  vmsAreEqual(\r\n    a: EditingAppAssetVM | undefined,\r\n    b: EditingAppAssetVM | undefined\r\n  ): boolean {\r\n    if (a === undefined && b === undefined) return true;\r\n\r\n    if (a?.archived !== b?.archived) return false;\r\n    if (a?.description !== b?.description) return false;\r\n    if (a?.filename !== b?.filename) return false;\r\n    if (a?.id !== b?.id) return false;\r\n    if (a?.name !== b?.name) return false;\r\n\r\n    return true;\r\n  }\r\n\r\n  private onAssetChange = () => {\r\n    if (!this.appAssets) return;\r\n\r\n    if (this.appAssets.editingAsset) {\r\n      const {\r\n        id,\r\n        name,\r\n        description,\r\n        archived,\r\n        filename\r\n      } = this.appAssets.editingAsset;\r\n      const vm: EditingAppAssetVM = {\r\n        id,\r\n        name,\r\n        description,\r\n        archived,\r\n        filename\r\n      };\r\n      this.doUpdateView(vm);\r\n    } else {\r\n      this.doUpdateView(undefined);\r\n    }\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, EditingAppAssetPM.type);\r\n\r\n    this.appAssets = appObject.getComponent<AppAssetsEntity>(\r\n      AppAssetsEntity.type\r\n    );\r\n    if (!this.appAssets) {\r\n      this.warn(\r\n        \"PM has been added to an App Object without an AppAssetsEntity\"\r\n      );\r\n      return;\r\n    }\r\n\r\n    this.appObjects.registerSingleton(this);\r\n\r\n    this.appAssets.addChangeObserver(this.onAssetChange);\r\n    this.onAssetChange();\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"EditingAppAssetPM.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/EditingAppAssetPM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAU9D,MAAM,OAAgB,iBAAkB,SAAQ,WAE/C;IAGC,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACnE,CAAC;;AAJM,sBAAI,GAAG,mBAAmB,CAAC;AAOpC,MAAM,UAAU,qBAAqB,CAAC,SAAoB;IACxD,OAAO,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,oBAAqB,SAAQ,iBAAiB;IAGlD,WAAW,CACT,CAAgC,EAChC,CAAgC;QAEhC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAEpD,IAAI,CAAC,EAAE,QAAQ,KAAK,CAAC,EAAE,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9C,IAAI,CAAC,EAAE,WAAW,KAAK,CAAC,EAAE,WAAW;YAAE,OAAO,KAAK,CAAC;QACpD,IAAI,CAAC,EAAE,QAAQ,KAAK,CAAC,EAAE,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9C,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE;YAAE,OAAO,KAAK,CAAC;QAClC,IAAI,CAAC,EAAE,IAAI,KAAK,CAAC,EAAE,IAAI;YAAE,OAAO,KAAK,CAAC;QAEtC,OAAO,IAAI,CAAC;IACd,CAAC;IAqBD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;QApBnC,kBAAa,GAAG,GAAG,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO;YAE5B,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;gBAChC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,GACjD,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;gBAC9B,MAAM,EAAE,GAAsB;oBAC5B,EAAE;oBACF,IAAI;oBACJ,WAAW;oBACX,QAAQ;oBACR,QAAQ;iBACT,CAAC;gBACF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC,CAAC;QAKA,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,YAAY,CACrC,eAAe,CAAC,IAAI,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CACP,+DAA+D,CAChE,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrD,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;CACF","sourcesContent":["import {\n  getSingletonComponent,\n  AppObject,\n  AppObjectPM,\n  AppObjectRepo\n} from \"@vived/core\";\nimport { AppAssetsEntity } from \"../Entities/AppAssetsEntity\";\n\nexport interface EditingAppAssetVM {\n  id: string;\n  name: string;\n  description: string;\n  archived: boolean;\n  filename: string;\n}\n\nexport abstract class EditingAppAssetPM extends AppObjectPM<\n  EditingAppAssetVM | undefined\n> {\n  static type = \"EditingAppAssetPM\";\n\n  static get(appObjects: AppObjectRepo): EditingAppAssetPM | undefined {\n    return getSingletonComponent(EditingAppAssetPM.type, appObjects);\n  }\n}\n\nexport function makeEditingAppAssetPM(appObject: AppObject): EditingAppAssetPM {\n  return new EditingAppAssetPMImp(appObject);\n}\n\nclass EditingAppAssetPMImp extends EditingAppAssetPM {\n  private appAssets?: AppAssetsEntity;\n\n  vmsAreEqual(\n    a: EditingAppAssetVM | undefined,\n    b: EditingAppAssetVM | undefined\n  ): boolean {\n    if (a === undefined && b === undefined) return true;\n\n    if (a?.archived !== b?.archived) return false;\n    if (a?.description !== b?.description) return false;\n    if (a?.filename !== b?.filename) return false;\n    if (a?.id !== b?.id) return false;\n    if (a?.name !== b?.name) return false;\n\n    return true;\n  }\n\n  private onAssetChange = () => {\n    if (!this.appAssets) return;\n\n    if (this.appAssets.editingAsset) {\n      const { id, name, description, archived, filename } =\n        this.appAssets.editingAsset;\n      const vm: EditingAppAssetVM = {\n        id,\n        name,\n        description,\n        archived,\n        filename\n      };\n      this.doUpdateView(vm);\n    } else {\n      this.doUpdateView(undefined);\n    }\n  };\n\n  constructor(appObject: AppObject) {\n    super(appObject, EditingAppAssetPM.type);\n\n    this.appAssets = appObject.getComponent<AppAssetsEntity>(\n      AppAssetsEntity.type\n    );\n    if (!this.appAssets) {\n      this.warn(\n        \"PM has been added to an App Object without an AppAssetsEntity\"\n      );\n      return;\n    }\n\n    this.appObjects.registerSingleton(this);\n\n    this.appAssets.addChangeObserver(this.onAssetChange);\n    this.onAssetChange();\n  }\n}\n"]}

package/dist/esm/Assets/PMs/ShowArchivedAppAssetPM.js.map

@@ -1 +1 @@
-{"version":3,"file":"ShowArchivedAppAssetPM.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/ShowArchivedAppAssetPM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,OAAgB,sBAAuB,SAAQ,WAAoB;IAGvE,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,sBAAsB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AAJM,2BAAI,GAAG,wBAAwB,CAAC;AAOzC,MAAM,UAAU,0BAA0B,CACxC,SAAoB;IAEpB,OAAO,IAAI,yBAAyB,CAAC,SAAS,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,yBAA0B,SAAQ,sBAAsB;IAG5D,WAAW,CAAC,CAAU,EAAE,CAAU;QAChC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAOD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,sBAAsB,CAAC,IAAI,CAAC,CAAC;QANxC,kBAAa,GAAG,GAAG,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO;YAC5B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACjD,CAAC,CAAC;QAKA,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,YAAY,CACrC,eAAe,CAAC,IAAI,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CACP,+DAA+D,CAChE,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrD,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;CACF","sourcesContent":["import {\r\n  getSingletonComponent,\r\n  AppObject,\r\n  AppObjectPM,\r\n  AppObjectRepo\r\n} from \"@vived/core\";\r\nimport { AppAssetsEntity } from \"../Entities/AppAssetsEntity\";\r\n\r\nexport abstract class ShowArchivedAppAssetPM extends AppObjectPM<boolean> {\r\n  static type = \"ShowArchivedAppAssetPM\";\r\n\r\n  static get(appObjects: AppObjectRepo): ShowArchivedAppAssetPM | undefined {\r\n    return getSingletonComponent(ShowArchivedAppAssetPM.type, appObjects);\r\n  }\r\n}\r\n\r\nexport function makeShowArchivedAppAssetPM(\r\n  appObject: AppObject\r\n): ShowArchivedAppAssetPM {\r\n  return new ShowArchivedAppAssetPMImp(appObject);\r\n}\r\n\r\nclass ShowArchivedAppAssetPMImp extends ShowArchivedAppAssetPM {\r\n  private appAssets?: AppAssetsEntity;\r\n\r\n  vmsAreEqual(a: boolean, b: boolean): boolean {\r\n    return a === b;\r\n  }\r\n\r\n  private onAssetChange = () => {\r\n    if (!this.appAssets) return;\r\n    this.doUpdateView(this.appAssets.showArchived);\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ShowArchivedAppAssetPM.type);\r\n\r\n    this.appAssets = appObject.getComponent<AppAssetsEntity>(\r\n      AppAssetsEntity.type\r\n    );\r\n    if (!this.appAssets) {\r\n      this.warn(\r\n        \"PM has been added to an App Object without an AppAssetsEntity\"\r\n      );\r\n      return;\r\n    }\r\n\r\n    this.appObjects.registerSingleton(this);\r\n\r\n    this.appAssets.addChangeObserver(this.onAssetChange);\r\n    this.onAssetChange();\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ShowArchivedAppAssetPM.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/ShowArchivedAppAssetPM.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,WAAW,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,OAAgB,sBAAuB,SAAQ,WAAoB;IAGvE,MAAM,CAAC,GAAG,CAAC,UAAyB;QAClC,OAAO,qBAAqB,CAAC,sBAAsB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;;AAJM,2BAAI,GAAG,wBAAwB,CAAC;AAOzC,MAAM,UAAU,0BAA0B,CACxC,SAAoB;IAEpB,OAAO,IAAI,yBAAyB,CAAC,SAAS,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,yBAA0B,SAAQ,sBAAsB;IAG5D,WAAW,CAAC,CAAU,EAAE,CAAU;QAChC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAOD,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,sBAAsB,CAAC,IAAI,CAAC,CAAC;QANxC,kBAAa,GAAG,GAAG,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO;YAC5B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACjD,CAAC,CAAC;QAKA,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,YAAY,CACrC,eAAe,CAAC,IAAI,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CACP,+DAA+D,CAChE,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrD,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;CACF","sourcesContent":["import {\n  getSingletonComponent,\n  AppObject,\n  AppObjectPM,\n  AppObjectRepo\n} from \"@vived/core\";\nimport { AppAssetsEntity } from \"../Entities/AppAssetsEntity\";\n\nexport abstract class ShowArchivedAppAssetPM extends AppObjectPM<boolean> {\n  static type = \"ShowArchivedAppAssetPM\";\n\n  static get(appObjects: AppObjectRepo): ShowArchivedAppAssetPM | undefined {\n    return getSingletonComponent(ShowArchivedAppAssetPM.type, appObjects);\n  }\n}\n\nexport function makeShowArchivedAppAssetPM(\n  appObject: AppObject\n): ShowArchivedAppAssetPM {\n  return new ShowArchivedAppAssetPMImp(appObject);\n}\n\nclass ShowArchivedAppAssetPMImp extends ShowArchivedAppAssetPM {\n  private appAssets?: AppAssetsEntity;\n\n  vmsAreEqual(a: boolean, b: boolean): boolean {\n    return a === b;\n  }\n\n  private onAssetChange = () => {\n    if (!this.appAssets) return;\n    this.doUpdateView(this.appAssets.showArchived);\n  };\n\n  constructor(appObject: AppObject) {\n    super(appObject, ShowArchivedAppAssetPM.type);\n\n    this.appAssets = appObject.getComponent<AppAssetsEntity>(\n      AppAssetsEntity.type\n    );\n    if (!this.appAssets) {\n      this.warn(\n        \"PM has been added to an App Object without an AppAssetsEntity\"\n      );\n      return;\n    }\n\n    this.appObjects.registerSingleton(this);\n\n    this.appAssets.addChangeObserver(this.onAssetChange);\n    this.onAssetChange();\n  }\n}\n"]}

package/dist/esm/Assets/PMs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC","sourcesContent":["export * from \"./AppAssetListPM\";\r\nexport * from \"./AssetPM\";\r\nexport * from \"./AssetFilePM\";\r\nexport * from \"./EditingAppAssetPM\";\r\nexport * from \"./ShowArchivedAppAssetPM\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Assets/PMs/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC","sourcesContent":["export * from \"./AppAssetListPM\";\nexport * from \"./AssetPM\";\nexport * from \"./AssetFilePM\";\nexport * from \"./EditingAppAssetPM\";\nexport * from \"./ShowArchivedAppAssetPM\";\n"]}

package/dist/esm/Assets/UCs/ArchiveAssetUC.js

@@ -1,9 +1,43 @@
+/**
+ * ArchiveAssetUC.ts
+ *
+ * This use case handles the archiving and unarchiving of assets, providing
+ * a reversible soft-deletion mechanism that hides assets from normal views
+ * while preserving them in the system.
+ *
+ * Key Concepts:
+ * - Archive operations are reversible soft-deletion mechanisms
+ * - Archived assets remain in the system but are hidden from normal views
+ * - Uses API calls to persist archive state changes
+ * - Provides user feedback through spinner and error dialogs
+ * - Updates both local entity state and collection notifications
+ *
+ * Usage Patterns:
+ * - Created per-asset during factory setup
+ * - Accessed through static get() method with asset ID
+ * - Handles both archiving (hiding) and unarchiving (showing) operations
+ * - Manages async API calls with proper error handling and user feedback
+ */
 import { AppObjectUC } from "@vived/core";
 import { MakeAlertDialogUC, MakeSpinnerDialogUC } from "../../Dialog";
 import { PatchAssetIsArchivedUC } from "../../VivedAPI";
 import { AppAssetsEntity } from "../Entities/AppAssetsEntity";
 import { AssetEntity } from "../Entities/AssetEntity";
+/**
+ * ArchiveAssetUC manages the archiving and unarchiving operations for individual assets.
+ *
+ * This use case provides the business logic for toggling asset archive status,
+ * handling API persistence, and managing user feedback during the operation.
+ * Archive operations are reversible and provide a soft-deletion mechanism.
+ */
 export class ArchiveAssetUC extends AppObjectUC {
+    /**
+     * Retrieves an ArchiveAssetUC component for a specific asset.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @param appObjects - Repository for accessing app objects and components
+     * @returns ArchiveAssetUC instance or undefined if not found
+     */
     static get(assetID, appObjects) {
         const appObject = appObjects.get(assetID);
         if (!appObject) {
@@ -18,24 +52,68 @@ export class ArchiveAssetUC extends AppObjectUC {
         return uc;
     }
 }
+/** Static type identifier for component registration */
 ArchiveAssetUC.type = "ArchiveAssetUC";
+/**
+ * Factory function to create a new ArchiveAssetUC instance.
+ *
+ * @param appObject - The AppObject that will host this use case (should contain an AssetEntity)
+ * @returns A new ArchiveAssetUC implementation instance
+ */
 export function makeArchiveAssetUC(appObject) {
     return new ArchiveAssetUCImp(appObject);
 }
+/**
+ * Private implementation of ArchiveAssetUC that handles the concrete archive operations.
+ *
+ * Key Implementation Details:
+ * - Validates asset entity existence and current archive state
+ * - Uses PatchAssetIsArchivedUC for API persistence
+ * - Provides user feedback through spinner dialogs during operations
+ * - Handles errors gracefully with alert dialogs and logging
+ * - Updates local asset state and triggers collection change notifications
+ * - Prevents redundant operations when archive state hasn't changed
+ */
 class ArchiveAssetUCImp extends ArchiveAssetUC {
+    /**
+     * Gets the API use case for patching asset archive status
+     * Cached for efficient repeated access during operations
+     */
     get patchAssetIsArchived() {
         return this.getCachedSingleton(PatchAssetIsArchivedUC.type)?.doPatch;
     }
+    /**
+     * Gets the app assets collection entity for triggering collection updates
+     * Used to notify UI components when asset visibility changes
+     */
     get appAssets() {
         return this.getCachedSingleton(AppAssetsEntity.type);
     }
+    /**
+     * Initializes the ArchiveAssetUC with validation of required components.
+     *
+     * @param appObject - The AppObject that should contain the AssetEntity this UC will operate on
+     */
     constructor(appObject) {
         super(appObject, ArchiveAssetUC.type);
+        /**
+         * Sets the archived status of the asset with full error handling and user feedback.
+         *
+         * This method handles the complete archive workflow:
+         * 1. Validates the asset exists and state change is needed
+         * 2. Shows a spinner dialog during the API operation
+         * 3. Updates the asset entity and collection on success
+         * 4. Shows error dialogs and logs failures appropriately
+         *
+         * @param archived - True to archive the asset, false to unarchive it
+         * @returns Promise that resolves when the operation completes (successfully or with handled error)
+         */
         this.setArchived = (archived) => {
             const asset = this.asset;
             if (!asset) {
                 return Promise.reject(new Error("No Asset Entity"));
             }
+            // Prevent redundant operations
             if (asset.archived === archived) {
                 return Promise.resolve();
             }
@@ -43,6 +121,7 @@ class ArchiveAssetUCImp extends ArchiveAssetUC {
             if (!patchAssetIsArchived) {
                 return Promise.reject();
             }
+            // Show user feedback during operation
             const title = archived ? "Archiving Asset" : "Unarchive Asset";
             const spinner = MakeSpinnerDialogUC.make({
                 title,
@@ -51,7 +130,9 @@ class ArchiveAssetUCImp extends ArchiveAssetUC {
             return new Promise((resolve, reject) => {
                 patchAssetIsArchived(asset.id, archived)
                     .then(() => {
+                    // Update local state
                     asset.archived = archived;
+                    // Notify collections if this asset is part of them
                     if (this.appAssets && this.appAssets.has(asset.id)) {
                         this.appAssets.notifyOnChange();
                     }
@@ -59,6 +140,7 @@ class ArchiveAssetUCImp extends ArchiveAssetUC {
                     resolve();
                 })
                     .catch((e) => {
+                    // Handle errors with user feedback
                     this.error("Archive asset error: " + e.message);
                     spinner?.close();
                     const dialogDTO = {
@@ -67,7 +149,7 @@ class ArchiveAssetUCImp extends ArchiveAssetUC {
                         title: "Archive Asset Error"
                     };
                     MakeAlertDialogUC.make(dialogDTO, this.appObjects);
-                    resolve();
+                    resolve(); // Resolve to prevent unhandled rejections, error is already handled
                 });
             });
         };

package/dist/esm/Assets/UCs/ArchiveAssetUC.js.map

@@ -1 +1 @@
-{"version":3,"file":"ArchiveAssetUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/ArchiveAssetUC.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppObject, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\nimport {\r\n  DialogAlertDTO,\r\n  MakeAlertDialogUC,\r\n  MakeSpinnerDialogUC\r\n} from \"../../Dialog\";\r\nimport { PatchAssetIsArchivedUC } from \"../../VivedAPI\";\r\nimport { AppAssetsEntity } from \"../Entities/AppAssetsEntity\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\n\r\nexport abstract class ArchiveAssetUC extends AppObjectUC {\r\n  static type = \"ArchiveAssetUC\";\r\n\r\n  abstract setArchived(archived: boolean): Promise<void>;\r\n\r\n  static get(\r\n    assetID: string,\r\n    appObjects: AppObjectRepo\r\n  ): ArchiveAssetUC | undefined {\r\n    const appObject = appObjects.get(assetID);\r\n    if (!appObject) {\r\n      appObjects.submitWarning(\r\n        \"ArchiveAssetUC.get\",\r\n        \"Unable to find app object\"\r\n      );\r\n      return undefined;\r\n    }\r\n\r\n    const uc = appObject.getComponent<ArchiveAssetUC>(ArchiveAssetUC.type);\r\n    if (!uc) {\r\n      appObjects.submitWarning(\r\n        \"ArchiveAssetUC.get\",\r\n        \"App Object does not have ArchiveAssetUC\"\r\n      );\r\n      return undefined;\r\n    }\r\n\r\n    return uc;\r\n  }\r\n}\r\n\r\nexport function makeArchiveAssetUC(appObject: AppObject): ArchiveAssetUC {\r\n  return new ArchiveAssetUCImp(appObject);\r\n}\r\n\r\nclass ArchiveAssetUCImp extends ArchiveAssetUC {\r\n  private asset?: AssetEntity;\r\n\r\n  private get patchAssetIsArchived() {\r\n    return this.getCachedSingleton<PatchAssetIsArchivedUC>(\r\n      PatchAssetIsArchivedUC.type\r\n    )?.doPatch;\r\n  }\r\n\r\n  private get appAssets() {\r\n    return this.getCachedSingleton<AppAssetsEntity>(AppAssetsEntity.type);\r\n  }\r\n\r\n  setArchived = (archived: boolean): Promise<void> => {\r\n    const asset = this.asset;\r\n\r\n    if (!asset) {\r\n      return Promise.reject(new Error(\"No Asset Entity\"));\r\n    }\r\n\r\n    if (asset.archived === archived) {\r\n      return Promise.resolve();\r\n    }\r\n\r\n    const patchAssetIsArchived = this.patchAssetIsArchived;\r\n    if (!patchAssetIsArchived) {\r\n      return Promise.reject();\r\n    }\r\n\r\n    const title = archived ? \"Archiving Asset\" : \"Unarchive Asset\";\r\n    const spinner = MakeSpinnerDialogUC.make(\r\n      {\r\n        title,\r\n        message: \"Updating asset's archived flag...\"\r\n      },\r\n      this.appObjects\r\n    );\r\n\r\n    return new Promise((resolve, reject) => {\r\n      patchAssetIsArchived(asset.id, archived)\r\n        .then(() => {\r\n          asset.archived = archived;\r\n\r\n          if (this.appAssets && this.appAssets.has(asset.id)) {\r\n            this.appAssets.notifyOnChange();\r\n          }\r\n          spinner?.close();\r\n          resolve();\r\n        })\r\n        .catch((e) => {\r\n          this.error(\"Archive asset error: \" + e.message);\r\n          spinner?.close();\r\n          const dialogDTO: DialogAlertDTO = {\r\n            buttonLabel: \"OK\",\r\n            message: `Something went wrong when setting the asset's archived flag. Check the console. ${e.message}`,\r\n            title: \"Archive Asset Error\"\r\n          };\r\n\r\n          MakeAlertDialogUC.make(dialogDTO, this.appObjects);\r\n          resolve();\r\n        });\r\n    });\r\n  };\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ArchiveAssetUC.type);\r\n\r\n    this.asset = appObject.getComponent<AssetEntity>(AssetEntity.type);\r\n    if (!this.asset) {\r\n      this.error(\r\n        \"UC has been added to an App Object that does not have ArchiveAssetUC\"\r\n      );\r\n    }\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ArchiveAssetUC.js","sourceRoot":"","sources":["../../../../src/Assets/UCs/ArchiveAssetUC.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * ArchiveAssetUC.ts\r\n *\r\n * This use case handles the archiving and unarchiving of assets, providing\r\n * a reversible soft-deletion mechanism that hides assets from normal views\r\n * while preserving them in the system.\r\n *\r\n * Key Concepts:\r\n * - Archive operations are reversible soft-deletion mechanisms\r\n * - Archived assets remain in the system but are hidden from normal views\r\n * - Uses API calls to persist archive state changes\r\n * - Provides user feedback through spinner and error dialogs\r\n * - Updates both local entity state and collection notifications\r\n *\r\n * Usage Patterns:\r\n * - Created per-asset during factory setup\r\n * - Accessed through static get() method with asset ID\r\n * - Handles both archiving (hiding) and unarchiving (showing) operations\r\n * - Manages async API calls with proper error handling and user feedback\r\n */\r\n\r\nimport { AppObject, AppObjectRepo, AppObjectUC } from \"@vived/core\";\r\nimport {\r\n  DialogAlertDTO,\r\n  MakeAlertDialogUC,\r\n  MakeSpinnerDialogUC\r\n} from \"../../Dialog\";\r\nimport { PatchAssetIsArchivedUC } from \"../../VivedAPI\";\r\nimport { AppAssetsEntity } from \"../Entities/AppAssetsEntity\";\r\nimport { AssetEntity } from \"../Entities/AssetEntity\";\r\n\r\n/**\r\n * ArchiveAssetUC manages the archiving and unarchiving operations for individual assets.\r\n *\r\n * This use case provides the business logic for toggling asset archive status,\r\n * handling API persistence, and managing user feedback during the operation.\r\n * Archive operations are reversible and provide a soft-deletion mechanism.\r\n */\r\nexport abstract class ArchiveAssetUC extends AppObjectUC {\r\n  /** Static type identifier for component registration */\r\n  static type = \"ArchiveAssetUC\";\r\n\r\n  /**\r\n   * Sets the archived status of the associated asset.\r\n   *\r\n   * @param archived - True to archive (hide) the asset, false to unarchive (show) it\r\n   * @returns Promise that resolves when the operation completes successfully\r\n   */\r\n  abstract setArchived(archived: boolean): Promise<void>;\r\n\r\n  /**\r\n   * Retrieves an ArchiveAssetUC component for a specific asset.\r\n   *\r\n   * @param assetID - The unique identifier of the asset\r\n   * @param appObjects - Repository for accessing app objects and components\r\n   * @returns ArchiveAssetUC instance or undefined if not found\r\n   */\r\n  static get(\r\n    assetID: string,\r\n    appObjects: AppObjectRepo\r\n  ): ArchiveAssetUC | undefined {\r\n    const appObject = appObjects.get(assetID);\r\n    if (!appObject) {\r\n      appObjects.submitWarning(\r\n        \"ArchiveAssetUC.get\",\r\n        \"Unable to find app object\"\r\n      );\r\n      return undefined;\r\n    }\r\n\r\n    const uc = appObject.getComponent<ArchiveAssetUC>(ArchiveAssetUC.type);\r\n    if (!uc) {\r\n      appObjects.submitWarning(\r\n        \"ArchiveAssetUC.get\",\r\n        \"App Object does not have ArchiveAssetUC\"\r\n      );\r\n      return undefined;\r\n    }\r\n\r\n    return uc;\r\n  }\r\n}\r\n\r\n/**\r\n * Factory function to create a new ArchiveAssetUC instance.\r\n *\r\n * @param appObject - The AppObject that will host this use case (should contain an AssetEntity)\r\n * @returns A new ArchiveAssetUC implementation instance\r\n */\r\nexport function makeArchiveAssetUC(appObject: AppObject): ArchiveAssetUC {\r\n  return new ArchiveAssetUCImp(appObject);\r\n}\r\n\r\n/**\r\n * Private implementation of ArchiveAssetUC that handles the concrete archive operations.\r\n *\r\n * Key Implementation Details:\r\n * - Validates asset entity existence and current archive state\r\n * - Uses PatchAssetIsArchivedUC for API persistence\r\n * - Provides user feedback through spinner dialogs during operations\r\n * - Handles errors gracefully with alert dialogs and logging\r\n * - Updates local asset state and triggers collection change notifications\r\n * - Prevents redundant operations when archive state hasn't changed\r\n */\r\nclass ArchiveAssetUCImp extends ArchiveAssetUC {\r\n  /** The asset entity this use case operates on */\r\n  private asset?: AssetEntity;\r\n\r\n  /**\r\n   * Gets the API use case for patching asset archive status\r\n   * Cached for efficient repeated access during operations\r\n   */\r\n  private get patchAssetIsArchived() {\r\n    return this.getCachedSingleton<PatchAssetIsArchivedUC>(\r\n      PatchAssetIsArchivedUC.type\r\n    )?.doPatch;\r\n  }\r\n\r\n  /**\r\n   * Gets the app assets collection entity for triggering collection updates\r\n   * Used to notify UI components when asset visibility changes\r\n   */\r\n  private get appAssets() {\r\n    return this.getCachedSingleton<AppAssetsEntity>(AppAssetsEntity.type);\r\n  }\r\n\r\n  /**\r\n   * Sets the archived status of the asset with full error handling and user feedback.\r\n   *\r\n   * This method handles the complete archive workflow:\r\n   * 1. Validates the asset exists and state change is needed\r\n   * 2. Shows a spinner dialog during the API operation\r\n   * 3. Updates the asset entity and collection on success\r\n   * 4. Shows error dialogs and logs failures appropriately\r\n   *\r\n   * @param archived - True to archive the asset, false to unarchive it\r\n   * @returns Promise that resolves when the operation completes (successfully or with handled error)\r\n   */\r\n  setArchived = (archived: boolean): Promise<void> => {\r\n    const asset = this.asset;\r\n\r\n    if (!asset) {\r\n      return Promise.reject(new Error(\"No Asset Entity\"));\r\n    }\r\n\r\n    // Prevent redundant operations\r\n    if (asset.archived === archived) {\r\n      return Promise.resolve();\r\n    }\r\n\r\n    const patchAssetIsArchived = this.patchAssetIsArchived;\r\n    if (!patchAssetIsArchived) {\r\n      return Promise.reject();\r\n    }\r\n\r\n    // Show user feedback during operation\r\n    const title = archived ? \"Archiving Asset\" : \"Unarchive Asset\";\r\n    const spinner = MakeSpinnerDialogUC.make(\r\n      {\r\n        title,\r\n        message: \"Updating asset's archived flag...\"\r\n      },\r\n      this.appObjects\r\n    );\r\n\r\n    return new Promise((resolve, reject) => {\r\n      patchAssetIsArchived(asset.id, archived)\r\n        .then(() => {\r\n          // Update local state\r\n          asset.archived = archived;\r\n\r\n          // Notify collections if this asset is part of them\r\n          if (this.appAssets && this.appAssets.has(asset.id)) {\r\n            this.appAssets.notifyOnChange();\r\n          }\r\n          spinner?.close();\r\n          resolve();\r\n        })\r\n        .catch((e) => {\r\n          // Handle errors with user feedback\r\n          this.error(\"Archive asset error: \" + e.message);\r\n          spinner?.close();\r\n          const dialogDTO: DialogAlertDTO = {\r\n            buttonLabel: \"OK\",\r\n            message: `Something went wrong when setting the asset's archived flag. Check the console. ${e.message}`,\r\n            title: \"Archive Asset Error\"\r\n          };\r\n\r\n          MakeAlertDialogUC.make(dialogDTO, this.appObjects);\r\n          resolve(); // Resolve to prevent unhandled rejections, error is already handled\r\n        });\r\n    });\r\n  };\r\n\r\n  /**\r\n   * Initializes the ArchiveAssetUC with validation of required components.\r\n   *\r\n   * @param appObject - The AppObject that should contain the AssetEntity this UC will operate on\r\n   */\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ArchiveAssetUC.type);\r\n\r\n    this.asset = appObject.getComponent<AssetEntity>(AssetEntity.type);\r\n    if (!this.asset) {\r\n      this.error(\r\n        \"UC has been added to an App Object that does not have ArchiveAssetUC\"\r\n      );\r\n    }\r\n  }\r\n}\r\n"]}

package/dist/esm/Assets/UCs/DeleteAssetUC.js

@@ -1,10 +1,42 @@
+/**
+ * DeleteAssetUC.ts
+ *
+ * This use case handles the permanent deletion of assets from the system,
+ * including user confirmation dialogs and cleanup of all related data.
+ *
+ * Key Concepts:
+ * - Permanent deletion removes assets completely from the system
+ * - Includes mandatory user confirmation to prevent accidental deletions
+ * - Cleans up asset from all collections and repositories
+ * - Uses API calls to persist deletion on the backend
+ * - Provides user feedback through dialogs during the operation
+ *
+ * Usage Patterns:
+ * - Created per-asset during factory setup
+ * - Accessed through static get() method with asset ID
+ * - Provides both confirmed and unconfirmed deletion methods
+ * - Handles async operations with proper error handling and user feedback
+ */
 import { AppObjectUC } from "@vived/core";
 import { MakeAlertDialogUC, MakeConfirmDialogUC, MakeSpinnerDialogUC } from "../../Dialog";
 import { DeleteAssetOnAPIUC } from "../../VivedAPI";
 import { AppAssetsEntity } from "../Entities/AppAssetsEntity";
 import { AssetEntity } from "../Entities/AssetEntity";
 import { AssetRepo } from "../Entities/AssetRepo";
+/**
+ * DeleteAssetUC manages the permanent deletion of individual assets.
+ *
+ * This use case provides both confirmed and unconfirmed deletion methods,
+ * handling complete cleanup of asset data from all system components.
+ */
 export class DeleteAssetUC extends AppObjectUC {
+    /**
+     * Retrieves a DeleteAssetUC component for a specific asset.
+     *
+     * @param assetID - The unique identifier of the asset
+     * @param appObjects - Repository for accessing app objects and components
+     * @returns DeleteAssetUC instance or undefined if not found
+     */
     static get(assetID, appObjects) {
         const appObject = appObjects.get(assetID);
         if (!appObject) {
@@ -19,23 +51,65 @@ export class DeleteAssetUC extends AppObjectUC {
         return uc;
     }
 }
+/** Static type identifier for component registration */
 DeleteAssetUC.type = "DeleteAssetUC";
+/**
+ * Factory function to create a new DeleteAssetUC instance.
+ *
+ * @param appObject - The AppObject that will host this use case (should contain an AssetEntity)
+ * @returns A new DeleteAssetUC implementation instance
+ */
 export function makeDeleteAssetUC(appObject) {
     return new DeleteAssetUCImp(appObject);
 }
+/**
+ * Private implementation of DeleteAssetUC that handles the concrete deletion operations.
+ *
+ * Key Implementation Details:
+ * - Validates asset entity existence before operations
+ * - Uses DeleteAssetOnAPIUC for backend persistence
+ * - Provides user confirmation through dialog system
+ * - Shows spinner dialogs during deletion operations
+ * - Handles errors gracefully with alert dialogs and logging
+ * - Cleans up asset from all collections and repositories
+ * - Removes asset from both AppAssetsEntity and AssetRepo
+ */
 class DeleteAssetUCImp extends DeleteAssetUC {
+    /**
+     * Gets the API use case for deleting assets from the backend
+     * Cached for efficient repeated access during operations
+     */
     get doDelete() {
         return this.getCachedSingleton(DeleteAssetOnAPIUC.type)
             ?.doDelete;
     }
+    /**
+     * Gets the app assets collection entity for cleanup operations
+     * Used to remove the asset from collection displays
+     */
     get appAssets() {
         return this.getCachedSingleton(AppAssetsEntity.type);
     }
+    /**
+     * Gets the asset repository for cleanup operations
+     * Used to remove the asset from the global asset repository
+     */
     get assetRepo() {
         return this.getCachedSingleton(AssetRepo.type);
     }
+    /**
+     * Initializes the DeleteAssetUC with validation of required components.
+     *
+     * @param appObject - The AppObject that should contain the AssetEntity this UC will operate on
+     */
     constructor(appObject) {
         super(appObject, DeleteAssetUC.type);
+        /**
+         * Initiates asset deletion with user confirmation.
+         *
+         * Shows a confirmation dialog with warnings about the irreversible nature
+         * of the operation and suggests archiving as an alternative.
+         */
         this.deleteWithConfirm = () => {
             MakeConfirmDialogUC.make({
                 cancelButtonLabel: "Cancel",
@@ -45,6 +119,18 @@ class DeleteAssetUCImp extends DeleteAssetUC {
                 onConfirm: this.delete
             }, this.appObjects);
         };
+        /**
+         * Permanently deletes the asset with full cleanup and user feedback.
+         *
+         * This method handles the complete deletion workflow:
+         * 1. Validates the asset exists
+         * 2. Shows a spinner dialog during the API operation
+         * 3. Removes the asset from backend via API
+         * 4. Cleans up the asset from all local collections and repositories
+         * 5. Shows error dialogs and logs failures appropriately
+         *
+         * @returns Promise that resolves when the operation completes (successfully or with handled error)
+         */
         this.delete = () => {
             const asset = this.asset;
             if (!asset) {
@@ -54,6 +140,7 @@ class DeleteAssetUCImp extends DeleteAssetUC {
             if (!doDelete) {
                 return Promise.reject();
             }
+            // Show user feedback during operation
             const title = "Delete Asset";
             const spinnerDialog = MakeSpinnerDialogUC.make({
                 title,
@@ -62,6 +149,7 @@ class DeleteAssetUCImp extends DeleteAssetUC {
             return new Promise((resolve) => {
                 doDelete(asset.id)
                     .then(() => {
+                    // Clean up from all collections and repositories
                     if (this.appAssets && this.appAssets.has(asset.id)) {
                         this.appAssets.remove(asset.id);
                     }
@@ -72,6 +160,7 @@ class DeleteAssetUCImp extends DeleteAssetUC {
                     resolve();
                 })
                     .catch((e) => {
+                    // Handle errors with user feedback
                     this.error("Archive asset error: " + e.message);
                     spinnerDialog?.close();
                     const dialogDTO = {
@@ -80,7 +169,7 @@ class DeleteAssetUCImp extends DeleteAssetUC {
                         title: "Archive Asset Error"
                     };
                     MakeAlertDialogUC.make(dialogDTO, this.appObjects);
-                    resolve();
+                    resolve(); // Resolve to prevent unhandled rejections, error is already handled
                 });
             });
         };