@anzusystems/common-admin 2.0.0-rc.1 → 2.0.0-rc.10

package/dist/domains/dam/uploadQueue/components/uploadQueueBindings.d.ts

@@ -5,32 +5,32 @@ import { CustomDataValue } from '../../../customDataForm/types/CustomDataForm';
 import { UploadQueue, UploadQueueItem, UploadQueueKey } from '../../types/UploadQueue';
 import { UploadRefreshOutcome } from '../settlement/uploadSettlementTypes';
 import { UploadRefreshWarningKey } from '../composables/uploadQueueItemRefresh';
-/** How the keywords and authors of a row look while they cannot be edited: their chips, or a switched-off input. */
+/** How a row's keywords and authors look while not editable: as chips, or as a disabled input. */
 export type DamFieldsDisabledAs = 'chips' | 'input';
-/** The suggestions of a queue, which the name chips of its rows mark as "new". */
+/** The suggestions of a queue. Name chips of its rows mark them as "new". */
 export type UploadQueueSuggestionsLookup = (queueKey: UploadQueueKey) => UploadQueue['suggestions'] | undefined;
-/** Provided by an application whose queues are not the library's store. Without it the chips read that store. */
+/** Provided by an application whose queues are not in the library store. Without it the chips read that store. */
 export declare const UploadQueueSuggestionsKey: InjectionKey<UploadQueueSuggestionsLookup>;
-/** Today's library: the suggestions in its store, which is asked for only when a chip needs them. */
+/** Default: the suggestions in the library store. The store is resolved only when a chip needs them. */
 export declare const libraryUploadQueueSuggestions: UploadQueueSuggestionsLookup;
-/** What the list of a queue asks of its host. Without it the list works over the library's store, as today. */
+/** What a queue list needs from its host. Without it the list uses the library store. */
 export interface UploadQueueListBinding {
     items(): UploadQueueItem[];
-    /** `queueKey` is the one in the row's event. */
+    /** `queueKey` is the one from the row's event. */
     cancel(item: UploadQueueItem, index: number, queueKey: UploadQueueKey): void;
-    /** For the library's default "remove from queue". */
+    /** Used by the library's default "remove from queue". */
     remove(index: number): void;
     refresh(item: UploadQueueItem): Promise<UploadRefreshOutcome>;
     refreshMayHelp(item: UploadQueueItem): boolean;
-    /** A warning of a refresh, through the host's own alerts. */
+    /** Shows a refresh warning through the host's own alerts. */
     warn(key: UploadRefreshWarningKey): void;
-    /** Hands the keywords and authors of the rows to the name caches and asks for them, once when the list mounts. */
+    /** Passes the rows' keywords and authors to the name caches and fetches them, once when the list mounts. */
     prime(items: UploadQueueItem[]): void;
     mainFileSingleUseEnabled: boolean;
 }
-/** Today's list of the library: its store, its caches, its alerts, its options. It follows the key as it changes. */
+/** Default list binding: the library store, caches, alerts and options. It follows the key as it changes. */
 export declare function useLibraryUploadQueueListBinding(queueKey: MaybeRefOrGetter<UploadQueueKey>, configName: string): UploadQueueListBinding;
-/** What the mass operations of a queue ask of their host. Without it they work over the library's store. */
+/** What a queue's mass operations need from their host. Without it they use the library store. */
 export interface UploadQueueMassOperationsBinding {
     assetTypes(): DamAssetTypeType[];
     fillCustomDataValue(data: {
@@ -38,9 +38,9 @@ export interface UploadQueueMassOperationsBinding {
         elementProperty: string;
         value: CustomDataValue;
     }, forceReplace?: boolean): void;
-    /** Into which rows is the host's: every row in the library. */
+    /** The host decides which rows are filled. The library fills every row. */
     fillKeywords(value: DocId[], forceReplace?: boolean): void;
     fillAuthors(value: DocId[], forceReplace?: boolean): void;
 }
-/** Today's: the asset types of the library's store and `useUploadQueueMassOperations`. */
+/** Default binding: the asset types of the library store and `useUploadQueueMassOperations`. */
 export declare function useLibraryUploadQueueMassOperationsBinding(queueKey: MaybeRefOrGetter<UploadQueueKey>): UploadQueueMassOperationsBinding;

package/dist/domains/dam/uploadQueue/components/uploadQueueBindings.js

@@ -1,19 +1,19 @@
-import { useAlerts as e } from "../../../system/composables/alerts.js";
-import { useCommonAdminCoreDamOptions as t } from "../../composables/commonAdminCoreDamOptions.js";
-import { useDamCachedAuthors as n } from "../../author/composables/cachedAuthors.js";
-import { useDamCachedKeywords as r } from "../../keyword/composables/cachedKeywords.js";
-import { useUploadQueuesStore as i } from "../store/uploadQueuesStore.js";
-import { useUploadQueueMassOperations as a } from "../composables/uploadQueueMassOperations.js";
+import { useUploadQueuesStore as e } from "../store/uploadQueuesStore.js";
+import { useUploadQueueMassOperations as t } from "../composables/uploadQueueMassOperations.js";
+import { useDamCachedKeywords as n } from "../../keyword/composables/cachedKeywords.js";
+import { useDamCachedAuthors as r } from "../../author/composables/cachedAuthors.js";
+import { useCommonAdminCoreDamOptions as i } from "../../composables/commonAdminCoreDamOptions.js";
+import { useAlerts as a } from "../../../system/composables/alerts.js";
 import { toValue as o } from "vue";
-//#region src/domains/dam/uploadQueue/components/uploadQueueBindings.ts
-var s = Symbol.for("anzu:UploadQueueSuggestions"), c = (e) => i().getQueue(e)?.suggestions;
-function l(a, s) {
-	let c = i(), { showWarningT: l } = e(), { addToCachedKeywords: u, fetchCachedKeywords: d } = r(s), { addToCachedAuthors: f, fetchCachedAuthors: p } = n(s), { mainFileSingleUseEnabled: m } = t(s);
+// src/domains/dam/uploadQueue/components/uploadQueueBindings.ts
+var s = Symbol.for("anzu:UploadQueueSuggestions"), c = (t) => e().getQueue(t)?.suggestions;
+function l(t, s) {
+	let c = e(), { showWarningT: l } = a(), { addToCachedKeywords: u, fetchCachedKeywords: d } = n(s), { addToCachedAuthors: f, fetchCachedAuthors: p } = r(s), { mainFileSingleUseEnabled: m } = i(s);
 	return {
-		items: () => c.getQueueItems(o(a)),
+		items: () => c.getQueueItems(o(t)),
 		cancel: (e, t, n) => c.stopItemUpload(n, e, t),
-		remove: (e) => c.removeByIndex(o(a), e),
-		refresh: (e) => c.refreshAsset(e.assetId, { queueKey: o(a) }),
+		remove: (e) => c.removeByIndex(o(t), e),
+		refresh: (e) => c.refreshAsset(e.assetId, { queueKey: o(t) }),
 		refreshMayHelp: (e) => c.refreshMayHelp(e),
 		warn: (e) => l(e),
 		prime: (e) => {
@@ -24,16 +24,15 @@ function l(a, s) {
 		mainFileSingleUseEnabled: m
 	};
 }
-function u(e) {
-	let t = i(), { replaceEmptyCustomDataValue: n, replaceEmptyKeywords: r, replaceEmptyAuthors: s } = a(e);
+function u(n) {
+	let r = e(), { replaceEmptyCustomDataValue: i, replaceEmptyKeywords: a, replaceEmptyAuthors: s } = t(n);
 	return {
-		assetTypes: () => t.getQueueItemsTypes(o(e)),
-		fillCustomDataValue: n,
-		fillKeywords: r,
+		assetTypes: () => r.getQueueItemsTypes(o(n)),
+		fillCustomDataValue: i,
+		fillKeywords: a,
 		fillAuthors: s
 	};
 }
-//#endregion
 export { s as UploadQueueSuggestionsKey, c as libraryUploadQueueSuggestions, l as useLibraryUploadQueueListBinding, u as useLibraryUploadQueueMassOperationsBinding };
 
 //# sourceMappingURL=uploadQueueBindings.js.map

package/dist/domains/dam/uploadQueue/components/uploadQueueBindings.js.map

@@ -1 +1 @@
-{"version":3,"file":"uploadQueueBindings.js","names":["UploadQueueSuggestionsKey","libraryUploadQueueSuggestions","useUploadQueuesStore","queueKey","useLibraryUploadQueueListBinding","uploadQueuesStore","useAlerts","useDamCachedKeywords","configName","useDamCachedAuthors","useCommonAdminCoreDamOptions","toValue","itemQueueKey","item","index","showWarningT","key","items","addToCachedKeywords","addToCachedAuthors","fetchCachedKeywords","fetchCachedAuthors","useLibraryUploadQueueMassOperationsBinding","useUploadQueueMassOperations","replaceEmptyCustomDataValue","replaceEmptyKeywords","replaceEmptyAuthors"],"sources":["../../../../../src/domains/dam/uploadQueue/components/uploadQueueBindings.ts"],"sourcesContent":["import { type InjectionKey, type MaybeRefOrGetter, toValue } from 'vue'\nimport type { DocId } from '@/shared/types/common'\nimport type { DamAssetTypeType } from '@/domains/dam/types/Asset'\nimport type { CustomDataValue } from '@/domains/customDataForm/types/CustomDataForm'\nimport type { UploadQueue, UploadQueueItem, UploadQueueKey } from '@/domains/dam/types/UploadQueue'\nimport type { UploadRefreshOutcome } from '@/domains/dam/uploadQueue/settlement/uploadSettlementTypes'\nimport type { UploadRefreshWarningKey } from '@/domains/dam/uploadQueue/composables/uploadQueueItemRefresh'\nimport { useUploadQueuesStore } from '@/domains/dam/uploadQueue/store/uploadQueuesStore'\nimport { useUploadQueueMassOperations } from '@/domains/dam/uploadQueue/composables/uploadQueueMassOperations'\nimport { useDamCachedKeywords } from '@/domains/dam/keyword/composables/cachedKeywords'\nimport { useDamCachedAuthors } from '@/domains/dam/author/composables/cachedAuthors'\nimport { useCommonAdminCoreDamOptions } from '@/domains/dam/composables/commonAdminCoreDamOptions'\nimport { useAlerts } from '@/domains/system/composables/alerts'\n\n/** How the keywords and authors of a row look while they cannot be edited: their chips, or a switched-off input. */\nexport type DamFieldsDisabledAs = 'chips' | 'input'\n\n/** The suggestions of a queue, which the name chips of its rows mark as \"new\". */\nexport type UploadQueueSuggestionsLookup = (queueKey: UploadQueueKey) => UploadQueue['suggestions'] | undefined\n\n/** Provided by an application whose queues are not the library's store. Without it the chips read that store. */\nexport const UploadQueueSuggestionsKey: InjectionKey<UploadQueueSuggestionsLookup> =\n  Symbol.for('anzu:UploadQueueSuggestions')\n\n/** Today's library: the suggestions in its store, which is asked for only when a chip needs them. */\nexport const libraryUploadQueueSuggestions: UploadQueueSuggestionsLookup = (queueKey) =>\n  useUploadQueuesStore().getQueue(queueKey)?.suggestions\n\n/** What the list of a queue asks of its host. Without it the list works over the library's store, as today. */\nexport interface UploadQueueListBinding {\n  items(): UploadQueueItem[]\n  /** `queueKey` is the one in the row's event. */\n  cancel(item: UploadQueueItem, index: number, queueKey: UploadQueueKey): void\n  /** For the library's default \"remove from queue\". */\n  remove(index: number): void\n  refresh(item: UploadQueueItem): Promise<UploadRefreshOutcome>\n  refreshMayHelp(item: UploadQueueItem): boolean\n  /** A warning of a refresh, through the host's own alerts. */\n  warn(key: UploadRefreshWarningKey): void\n  /** Hands the keywords and authors of the rows to the name caches and asks for them, once when the list mounts. */\n  prime(items: UploadQueueItem[]): void\n  mainFileSingleUseEnabled: boolean\n}\n\n/** Today's list of the library: its store, its caches, its alerts, its options. It follows the key as it changes. */\nexport function useLibraryUploadQueueListBinding(\n  queueKey: MaybeRefOrGetter<UploadQueueKey>,\n  configName: string\n): UploadQueueListBinding {\n  const uploadQueuesStore = useUploadQueuesStore()\n  const { showWarningT } = useAlerts()\n  const { addToCachedKeywords, fetchCachedKeywords } = useDamCachedKeywords(configName)\n  const { addToCachedAuthors, fetchCachedAuthors } = useDamCachedAuthors(configName)\n  const { mainFileSingleUseEnabled } = useCommonAdminCoreDamOptions(configName)\n\n  return {\n    items: () => uploadQueuesStore.getQueueItems(toValue(queueKey)),\n    cancel: (item, index, itemQueueKey) => uploadQueuesStore.stopItemUpload(itemQueueKey, item, index),\n    remove: (index) => uploadQueuesStore.removeByIndex(toValue(queueKey), index),\n    // A row offers refresh only with its asset; the rows of the configuration of its queue are settled by it.\n    refresh: (item) => uploadQueuesStore.refreshAsset(item.assetId!, { queueKey: toValue(queueKey) }),\n    refreshMayHelp: (item) => uploadQueuesStore.refreshMayHelp(item),\n    warn: (key) => showWarningT(key),\n    prime: (items) => {\n      items.forEach((item) => {\n        addToCachedKeywords(item.keywords)\n        addToCachedAuthors(item.authors)\n      })\n      fetchCachedKeywords()\n      fetchCachedAuthors()\n    },\n    mainFileSingleUseEnabled,\n  }\n}\n\n/** What the mass operations of a queue ask of their host. Without it they work over the library's store. */\nexport interface UploadQueueMassOperationsBinding {\n  assetTypes(): DamAssetTypeType[]\n  fillCustomDataValue(\n    data: { assetType: DamAssetTypeType; elementProperty: string; value: CustomDataValue },\n    forceReplace?: boolean\n  ): void\n  /** Into which rows is the host's: every row in the library. */\n  fillKeywords(value: DocId[], forceReplace?: boolean): void\n  fillAuthors(value: DocId[], forceReplace?: boolean): void\n}\n\n/** Today's: the asset types of the library's store and `useUploadQueueMassOperations`. */\nexport function useLibraryUploadQueueMassOperationsBinding(\n  queueKey: MaybeRefOrGetter<UploadQueueKey>\n): UploadQueueMassOperationsBinding {\n  const uploadQueuesStore = useUploadQueuesStore()\n  const { replaceEmptyCustomDataValue, replaceEmptyKeywords, replaceEmptyAuthors } =\n    useUploadQueueMassOperations(queueKey)\n\n  return {\n    assetTypes: () => uploadQueuesStore.getQueueItemsTypes(toValue(queueKey)),\n    fillCustomDataValue: replaceEmptyCustomDataValue,\n    fillKeywords: replaceEmptyKeywords,\n    fillAuthors: replaceEmptyAuthors,\n  }\n}\n"],"mappings":";;;;;;;;AAqBA,IAAaA,IACX,OAAO,IAAI,6BAA6B,GAG7BC,KAA+D,MAC1EC,EAAqB,CAAC,CAAC,SAASC,CAAQ,CAAC,EAAE;AAmB7C,SAAgBC,EACd,GACA,GACwB;CACxB,IAAMC,IAAoBH,EAAqB,GACzC,EAAE,oBAAiBI,EAAU,GAC7B,EAAE,wBAAqB,2BAAwBC,EAAqBC,CAAU,GAC9E,EAAE,uBAAoB,0BAAuBC,EAAoBD,CAAU,GAC3E,EAAE,gCAA6BE,EAA6BF,CAAU;CAE5E,OAAO;EACL,aAAaH,EAAkB,cAAcM,EAAQR,CAAQ,CAAC;EAC9D,SAAS,GAAM,GAAO,MAAiBE,EAAkB,eAAeO,GAAcC,GAAMC,CAAK;EACjG,SAAS,MAAUT,EAAkB,cAAcM,EAAQR,CAAQ,GAAGW,CAAK;EAE3E,UAAU,MAAST,EAAkB,aAAaQ,EAAK,SAAU,EAAE,UAAUF,EAAQR,CAAQ,EAAE,CAAC;EAChG,iBAAiB,MAASE,EAAkB,eAAeQ,CAAI;EAC/D,OAAO,MAAQE,EAAaC,CAAG;EAC/B,QAAQ,MAAU;GAMhB,AALAC,EAAM,SAAS,MAAS;IAEtB,AADAC,EAAoBL,EAAK,QAAQ,GACjCM,EAAmBN,EAAK,OAAO;GACjC,CAAC,GACDO,EAAoB,GACpBC,EAAmB;EACrB;EACA;CACF;AACF;AAeA,SAAgBC,EACd,GACkC;CAClC,IAAMjB,IAAoBH,EAAqB,GACzC,EAAE,gCAA6B,yBAAsB,2BACzDqB,EAA6BpB,CAAQ;CAEvC,OAAO;EACL,kBAAkBE,EAAkB,mBAAmBM,EAAQR,CAAQ,CAAC;EACxE,qBAAqBqB;EACrB,cAAcC;EACd,aAAaC;CACf;AACF"}
+{"version":3,"file":"uploadQueueBindings.js","names":["UploadQueueSuggestionsKey","libraryUploadQueueSuggestions","useUploadQueuesStore","queueKey","useLibraryUploadQueueListBinding","uploadQueuesStore","useAlerts","useDamCachedKeywords","configName","useDamCachedAuthors","useCommonAdminCoreDamOptions","toValue","itemQueueKey","item","index","showWarningT","key","items","addToCachedKeywords","addToCachedAuthors","fetchCachedKeywords","fetchCachedAuthors","useLibraryUploadQueueMassOperationsBinding","useUploadQueueMassOperations","replaceEmptyCustomDataValue","replaceEmptyKeywords","replaceEmptyAuthors"],"sources":["../../../../../src/domains/dam/uploadQueue/components/uploadQueueBindings.ts"],"sourcesContent":["import { type InjectionKey, type MaybeRefOrGetter, toValue } from 'vue'\nimport type { DocId } from '@/shared/types/common'\nimport type { DamAssetTypeType } from '@/domains/dam/types/Asset'\nimport type { CustomDataValue } from '@/domains/customDataForm/types/CustomDataForm'\nimport type { UploadQueue, UploadQueueItem, UploadQueueKey } from '@/domains/dam/types/UploadQueue'\nimport type { UploadRefreshOutcome } from '@/domains/dam/uploadQueue/settlement/uploadSettlementTypes'\nimport type { UploadRefreshWarningKey } from '@/domains/dam/uploadQueue/composables/uploadQueueItemRefresh'\nimport { useUploadQueuesStore } from '@/domains/dam/uploadQueue/store/uploadQueuesStore'\nimport { useUploadQueueMassOperations } from '@/domains/dam/uploadQueue/composables/uploadQueueMassOperations'\nimport { useDamCachedKeywords } from '@/domains/dam/keyword/composables/cachedKeywords'\nimport { useDamCachedAuthors } from '@/domains/dam/author/composables/cachedAuthors'\nimport { useCommonAdminCoreDamOptions } from '@/domains/dam/composables/commonAdminCoreDamOptions'\nimport { useAlerts } from '@/domains/system/composables/alerts'\n\n/** How a row's keywords and authors look while not editable: as chips, or as a disabled input. */\nexport type DamFieldsDisabledAs = 'chips' | 'input'\n\n/** The suggestions of a queue. Name chips of its rows mark them as \"new\". */\nexport type UploadQueueSuggestionsLookup = (queueKey: UploadQueueKey) => UploadQueue['suggestions'] | undefined\n\n/** Provided by an application whose queues are not in the library store. Without it the chips read that store. */\nexport const UploadQueueSuggestionsKey: InjectionKey<UploadQueueSuggestionsLookup> =\n  Symbol.for('anzu:UploadQueueSuggestions')\n\n/** Default: the suggestions in the library store. The store is resolved only when a chip needs them. */\nexport const libraryUploadQueueSuggestions: UploadQueueSuggestionsLookup = (queueKey) =>\n  useUploadQueuesStore().getQueue(queueKey)?.suggestions\n\n/** What a queue list needs from its host. Without it the list uses the library store. */\nexport interface UploadQueueListBinding {\n  items(): UploadQueueItem[]\n  /** `queueKey` is the one from the row's event. */\n  cancel(item: UploadQueueItem, index: number, queueKey: UploadQueueKey): void\n  /** Used by the library's default \"remove from queue\". */\n  remove(index: number): void\n  refresh(item: UploadQueueItem): Promise<UploadRefreshOutcome>\n  refreshMayHelp(item: UploadQueueItem): boolean\n  /** Shows a refresh warning through the host's own alerts. */\n  warn(key: UploadRefreshWarningKey): void\n  /** Passes the rows' keywords and authors to the name caches and fetches them, once when the list mounts. */\n  prime(items: UploadQueueItem[]): void\n  mainFileSingleUseEnabled: boolean\n}\n\n/** Default list binding: the library store, caches, alerts and options. It follows the key as it changes. */\nexport function useLibraryUploadQueueListBinding(\n  queueKey: MaybeRefOrGetter<UploadQueueKey>,\n  configName: string\n): UploadQueueListBinding {\n  const uploadQueuesStore = useUploadQueuesStore()\n  const { showWarningT } = useAlerts()\n  const { addToCachedKeywords, fetchCachedKeywords } = useDamCachedKeywords(configName)\n  const { addToCachedAuthors, fetchCachedAuthors } = useDamCachedAuthors(configName)\n  const { mainFileSingleUseEnabled } = useCommonAdminCoreDamOptions(configName)\n\n  return {\n    items: () => uploadQueuesStore.getQueueItems(toValue(queueKey)),\n    cancel: (item, index, itemQueueKey) => uploadQueuesStore.stopItemUpload(itemQueueKey, item, index),\n    remove: (index) => uploadQueuesStore.removeByIndex(toValue(queueKey), index),\n    // A row offers refresh only with its asset. Rows of its queue's configuration are settled by the refresh.\n    refresh: (item) => uploadQueuesStore.refreshAsset(item.assetId!, { queueKey: toValue(queueKey) }),\n    refreshMayHelp: (item) => uploadQueuesStore.refreshMayHelp(item),\n    warn: (key) => showWarningT(key),\n    prime: (items) => {\n      items.forEach((item) => {\n        addToCachedKeywords(item.keywords)\n        addToCachedAuthors(item.authors)\n      })\n      fetchCachedKeywords()\n      fetchCachedAuthors()\n    },\n    mainFileSingleUseEnabled,\n  }\n}\n\n/** What a queue's mass operations need from their host. Without it they use the library store. */\nexport interface UploadQueueMassOperationsBinding {\n  assetTypes(): DamAssetTypeType[]\n  fillCustomDataValue(\n    data: { assetType: DamAssetTypeType; elementProperty: string; value: CustomDataValue },\n    forceReplace?: boolean\n  ): void\n  /** The host decides which rows are filled. The library fills every row. */\n  fillKeywords(value: DocId[], forceReplace?: boolean): void\n  fillAuthors(value: DocId[], forceReplace?: boolean): void\n}\n\n/** Default binding: the asset types of the library store and `useUploadQueueMassOperations`. */\nexport function useLibraryUploadQueueMassOperationsBinding(\n  queueKey: MaybeRefOrGetter<UploadQueueKey>\n): UploadQueueMassOperationsBinding {\n  const uploadQueuesStore = useUploadQueuesStore()\n  const { replaceEmptyCustomDataValue, replaceEmptyKeywords, replaceEmptyAuthors } =\n    useUploadQueueMassOperations(queueKey)\n\n  return {\n    assetTypes: () => uploadQueuesStore.getQueueItemsTypes(toValue(queueKey)),\n    fillCustomDataValue: replaceEmptyCustomDataValue,\n    fillKeywords: replaceEmptyKeywords,\n    fillAuthors: replaceEmptyAuthors,\n  }\n}\n"],"mappings":";;;;;;;;AAqBA,IAAaA,IACX,OAAO,IAAI,6BAA6B,GAG7BC,KAA+D,MAC1EC,EAAqB,CAAC,CAAC,SAASC,CAAQ,CAAC,EAAE;AAmB7C,SAAgBC,EACd,GACA,GACwB;CACxB,IAAMC,IAAoBH,EAAqB,GACzC,EAAE,oBAAiBI,EAAU,GAC7B,EAAE,wBAAqB,2BAAwBC,EAAqBC,CAAU,GAC9E,EAAE,uBAAoB,0BAAuBC,EAAoBD,CAAU,GAC3E,EAAE,gCAA6BE,EAA6BF,CAAU;CAE5E,OAAO;EACL,aAAaH,EAAkB,cAAcM,EAAQR,CAAQ,CAAC;EAC9D,SAAS,GAAM,GAAO,MAAiBE,EAAkB,eAAeO,GAAcC,GAAMC,CAAK;EACjG,SAAS,MAAUT,EAAkB,cAAcM,EAAQR,CAAQ,GAAGW,CAAK;EAE3E,UAAU,MAAST,EAAkB,aAAaQ,EAAK,SAAU,EAAE,UAAUF,EAAQR,CAAQ,EAAE,CAAC;EAChG,iBAAiB,MAASE,EAAkB,eAAeQ,CAAI;EAC/D,OAAO,MAAQE,EAAaC,CAAG;EAC/B,QAAQ,MAAU;GAMhB,AALAC,EAAM,SAAS,MAAS;IAEtB,AADAC,EAAoBL,EAAK,QAAQ,GACjCM,EAAmBN,EAAK,OAAO;GACjC,CAAC,GACDO,EAAoB,GACpBC,EAAmB;EACrB;EACA;CACF;AACF;AAeA,SAAgBC,EACd,GACkC;CAClC,IAAMjB,IAAoBH,EAAqB,GACzC,EAAE,gCAA6B,yBAAsB,2BACzDqB,EAA6BpB,CAAQ;CAEvC,OAAO;EACL,kBAAkBE,EAAkB,mBAAmBM,EAAQR,CAAQ,CAAC;EACxE,qBAAqBqB;EACrB,cAAcC;EACd,aAAaC;CACf;AACF"}

package/dist/domains/dam/uploadQueue/composables/assetSuggestions.js

@@ -1,5 +1,5 @@
 import { isArray as e, isEmptyObject as t } from "../../../../shared/utils/common.js";
-//#region src/domains/dam/uploadQueue/composables/assetSuggestions.ts
+// src/domains/dam/uploadQueue/composables/assetSuggestions.ts
 function n() {
 	return {
 		updateNewNames: (e, n) => {
@@ -14,7 +14,6 @@ function n() {
 		}
 	};
 }
-//#endregion
 export { n as useAssetSuggestions };
 
 //# sourceMappingURL=assetSuggestions.js.map

package/dist/domains/dam/uploadQueue/composables/damUploadChunkSize.d.ts

@@ -1,6 +1,6 @@
 /**
- * The size of the next chunk of an upload under the DAM configuration `configName`, bounded by its prv configuration.
- * A name left out is the inherited one in a component's setup, else `default`.
+ * The next chunk size of an upload under the DAM configuration `configName`, bounded by its prv configuration.
+ * Without a name, the inherited one in a component's setup is used, else `default`.
  */
 export declare function useDamUploadChunkSize(apiTimeout?: number, configName?: string): {
     lastChunkSize: import('vue').Ref<number, number>;

package/dist/domains/dam/uploadQueue/composables/damUploadChunkSize.js

@@ -2,7 +2,7 @@ import { isNull as e } from "../../../../shared/utils/common.js";
 import { useDamConfigStoreOf as t } from "../../config/store/damConfigStore.js";
 import { inheritedDamConfigName as n } from "../../composables/damConfigName.js";
 import { ref as r } from "vue";
-//#region src/domains/dam/uploadQueue/composables/damUploadChunkSize.ts
+// src/domains/dam/uploadQueue/composables/damUploadChunkSize.ts
 var i = /* @__PURE__ */ new Map();
 function a(a = 30, o) {
 	let s = n(o), c = t(s), l = r(i.get(s) || c.damPrvConfig.settings.imageChunkConfig.minSize), u = a / 5, d = a / 4, f = a / 2, p = (t) => {
@@ -18,7 +18,6 @@ function a(a = 30, o) {
 		updateChunkSize: p
 	};
 }
-//#endregion
 export { a as useDamUploadChunkSize };
 
 //# sourceMappingURL=damUploadChunkSize.js.map

package/dist/domains/dam/uploadQueue/composables/damUploadChunkSize.js.map

@@ -1 +1 @@
-{"version":3,"file":"damUploadChunkSize.js","names":["chunkSizes","useDamUploadChunkSize","name","inheritedDamConfigName","configName","damConfigStore","useDamConfigStoreOf","lastChunkSize","ref","minUploadTimeThreshold","apiTimeout","idealUploadTimeThreshold","maxUploadTimeThreshold","updateChunkSize","isNull","speed","expectedChunkUploadSpeed","resize","next","returnFromRange","size","changed","value"],"sources":["../../../../../src/domains/dam/uploadQueue/composables/damUploadChunkSize.ts"],"sourcesContent":["import { ref } from 'vue'\nimport { isNull } from '@/shared/utils/common'\nimport { useDamConfigStoreOf } from '@/domains/dam/config/store/damConfigStore'\nimport { inheritedDamConfigName } from '@/domains/dam/composables/damConfigName'\n\n// The last size of each DAM configuration: one upload hands it to the next one of its name.\nconst chunkSizes = new Map<string, number>()\n\n/**\n * The size of the next chunk of an upload under the DAM configuration `configName`, bounded by its prv configuration.\n * A name left out is the inherited one in a component's setup, else `default`.\n */\nexport function useDamUploadChunkSize(apiTimeout: number = 30, configName?: string) {\n  const name = inheritedDamConfigName(configName)\n  const damConfigStore = useDamConfigStoreOf(name)\n  const lastChunkSize = ref(chunkSizes.get(name) || damConfigStore.damPrvConfig.settings.imageChunkConfig.minSize)\n\n  const minUploadTimeThreshold = apiTimeout / 5\n  const idealUploadTimeThreshold = apiTimeout / 4\n  const maxUploadTimeThreshold = apiTimeout / 2\n\n  const updateChunkSize = (speed: number | null) => {\n    if (isNull(speed)) {\n      return false\n    }\n\n    const expectedChunkUploadSpeed = lastChunkSize.value / speed\n    if (expectedChunkUploadSpeed > maxUploadTimeThreshold) {\n      return resize(maxUploadTimeThreshold * speed)\n    }\n    if (expectedChunkUploadSpeed < minUploadTimeThreshold) {\n      return resize(idealUploadTimeThreshold * speed)\n    }\n\n    return false\n  }\n\n  // Answers whether the size changed: at a bound of the configuration it stays, and the chunk of a retry is not read\n  // from the file again.\n  const resize = (size: number) => {\n    const next = returnFromRange(size)\n    const changed = next !== lastChunkSize.value\n    lastChunkSize.value = next\n    chunkSizes.set(name, next)\n\n    return changed\n  }\n\n  const returnFromRange = (value: number) => {\n    if (value > damConfigStore.damPrvConfig.settings.imageChunkConfig.maxSize) {\n      return damConfigStore.damPrvConfig.settings.imageChunkConfig.maxSize\n    }\n    if (value < damConfigStore.damPrvConfig.settings.imageChunkConfig.minSize) {\n      return damConfigStore.damPrvConfig.settings.imageChunkConfig.minSize\n    }\n\n    return value\n  }\n\n  return {\n    lastChunkSize,\n    updateChunkSize,\n  }\n}\n"],"mappings":";;;;;AAMA,IAAMA,oBAAa,IAAI,IAAoB;AAM3C,SAAgBC,EAAsB,IAAqB,IAAI,GAAqB;CAClF,IAAMC,IAAOC,EAAuBC,CAAU,GACxCC,IAAiBC,EAAoBJ,CAAI,GACzCK,IAAgBC,EAAIR,EAAW,IAAIE,CAAI,KAAKG,EAAe,aAAa,SAAS,iBAAiB,OAAO,GAEzGI,IAAyBC,IAAa,GACtCC,IAA2BD,IAAa,GACxCE,IAAyBF,IAAa,GAEtCG,KAAmB,MAAyB;EAChD,IAAIC,EAAOC,CAAK,GACd,OAAO;EAGT,IAAMC,IAA2BT,EAAc,QAAQQ;EAQvD,OAPIC,IAA2BJ,IACtBK,EAAOL,IAAyBG,CAAK,IAE1CC,IAA2BP,KACtBQ,EAAON,IAA2BI,CAAK;CAIlD,GAIME,KAAU,MAAiB;EAC/B,IAAMC,IAAOC,EAAgBC,CAAI,GAC3BC,IAAUH,MAASX,EAAc;EAIvC,OAHA,EAAc,QAAQW,GACtBlB,EAAW,IAAIE,GAAMgB,CAAI,GAElBG;CACT,GAEMF,KAAmB,MACnBG,IAAQjB,EAAe,aAAa,SAAS,iBAAiB,UACzDA,EAAe,aAAa,SAAS,iBAAiB,UAE3DiB,IAAQjB,EAAe,aAAa,SAAS,iBAAiB,UACzDA,EAAe,aAAa,SAAS,iBAAiB,UAGxDiB;CAGT,OAAO;EACL;EACA;CACF;AACF"}
+{"version":3,"file":"damUploadChunkSize.js","names":["chunkSizes","useDamUploadChunkSize","name","inheritedDamConfigName","configName","damConfigStore","useDamConfigStoreOf","lastChunkSize","ref","minUploadTimeThreshold","apiTimeout","idealUploadTimeThreshold","maxUploadTimeThreshold","updateChunkSize","isNull","speed","expectedChunkUploadSpeed","resize","next","returnFromRange","size","changed","value"],"sources":["../../../../../src/domains/dam/uploadQueue/composables/damUploadChunkSize.ts"],"sourcesContent":["import { ref } from 'vue'\nimport { isNull } from '@/shared/utils/common'\nimport { useDamConfigStoreOf } from '@/domains/dam/config/store/damConfigStore'\nimport { inheritedDamConfigName } from '@/domains/dam/composables/damConfigName'\n\n// Last chunk size per DAM configuration. One upload passes it to the next upload of the same configuration.\nconst chunkSizes = new Map<string, number>()\n\n/**\n * The next chunk size of an upload under the DAM configuration `configName`, bounded by its prv configuration.\n * Without a name, the inherited one in a component's setup is used, else `default`.\n */\nexport function useDamUploadChunkSize(apiTimeout: number = 30, configName?: string) {\n  const name = inheritedDamConfigName(configName)\n  const damConfigStore = useDamConfigStoreOf(name)\n  const lastChunkSize = ref(chunkSizes.get(name) || damConfigStore.damPrvConfig.settings.imageChunkConfig.minSize)\n\n  const minUploadTimeThreshold = apiTimeout / 5\n  const idealUploadTimeThreshold = apiTimeout / 4\n  const maxUploadTimeThreshold = apiTimeout / 2\n\n  const updateChunkSize = (speed: number | null) => {\n    if (isNull(speed)) {\n      return false\n    }\n\n    const expectedChunkUploadSpeed = lastChunkSize.value / speed\n    if (expectedChunkUploadSpeed > maxUploadTimeThreshold) {\n      return resize(maxUploadTimeThreshold * speed)\n    }\n    if (expectedChunkUploadSpeed < minUploadTimeThreshold) {\n      return resize(idealUploadTimeThreshold * speed)\n    }\n\n    return false\n  }\n\n  // Returns whether the size changed. At a configuration bound it\n  // stays, so a retry does not re-read the chunk from the file.\n  const resize = (size: number) => {\n    const next = returnFromRange(size)\n    const changed = next !== lastChunkSize.value\n    lastChunkSize.value = next\n    chunkSizes.set(name, next)\n\n    return changed\n  }\n\n  const returnFromRange = (value: number) => {\n    if (value > damConfigStore.damPrvConfig.settings.imageChunkConfig.maxSize) {\n      return damConfigStore.damPrvConfig.settings.imageChunkConfig.maxSize\n    }\n    if (value < damConfigStore.damPrvConfig.settings.imageChunkConfig.minSize) {\n      return damConfigStore.damPrvConfig.settings.imageChunkConfig.minSize\n    }\n\n    return value\n  }\n\n  return {\n    lastChunkSize,\n    updateChunkSize,\n  }\n}\n"],"mappings":";;;;;AAMA,IAAMA,oBAAa,IAAI,IAAoB;AAM3C,SAAgBC,EAAsB,IAAqB,IAAI,GAAqB;CAClF,IAAMC,IAAOC,EAAuBC,CAAU,GACxCC,IAAiBC,EAAoBJ,CAAI,GACzCK,IAAgBC,EAAIR,EAAW,IAAIE,CAAI,KAAKG,EAAe,aAAa,SAAS,iBAAiB,OAAO,GAEzGI,IAAyBC,IAAa,GACtCC,IAA2BD,IAAa,GACxCE,IAAyBF,IAAa,GAEtCG,KAAmB,MAAyB;EAChD,IAAIC,EAAOC,CAAK,GACd,OAAO;EAGT,IAAMC,IAA2BT,EAAc,QAAQQ;EAQvD,OAPIC,IAA2BJ,IACtBK,EAAOL,IAAyBG,CAAK,IAE1CC,IAA2BP,KACtBQ,EAAON,IAA2BI,CAAK;CAIlD,GAIME,KAAU,MAAiB;EAC/B,IAAMC,IAAOC,EAAgBC,CAAI,GAC3BC,IAAUH,MAASX,EAAc;EAIvC,OAHA,EAAc,QAAQW,GACtBlB,EAAW,IAAIE,GAAMgB,CAAI,GAElBG;CACT,GAEMF,KAAmB,MACnBG,IAAQjB,EAAe,aAAa,SAAS,iBAAiB,UACzDA,EAAe,aAAa,SAAS,iBAAiB,UAE3DiB,IAAQjB,EAAe,aAAa,SAAS,iBAAiB,UACzDA,EAAe,aAAa,SAAS,iBAAiB,UAGxDiB;CAGT,OAAO;EACL;EACA;CACF;AACF"}

package/dist/domains/dam/uploadQueue/composables/uploadMeter.d.ts

@@ -1,26 +1,26 @@
 import { AxiosProgressEvent } from 'axios';
 import { UploadProgressCallback } from '../presets/uploadPresets';
 /**
- * How far one upload is, how fast it goes and how long it still takes, from one curve: the bytes of its file sent
- * over time, from the request of its first chunk to the answer to its last. It reports once a second, the first at
- * once, and only once it has a speed and either bytes came since its last report or the answer to a chunk that is
- * whole on its way is awaited; the whole file once it is out, also without a speed; without `report` it reports
- * nothing and asks for no second.
+ * Progress, speed and remaining time of one upload, from one curve: file
+ * bytes sent over time, from the first chunk request to the last answer.
+ * Reports once a second, the first immediately. It reports only with a known speed and
+ * when bytes moved since the last report or an answer to a fully sent chunk is awaited.
+ * Once the file is out it reports the whole file, also without a
+ * speed. Without `report` it reports nothing and starts no timer.
  */
 export declare function useUploadMeter(report: UploadProgressCallback | undefined): {
-    /** The reports of a file of the given size begin. */
+    /** Starts reporting for a file of the given size. */
     start(size: number): void;
-    /** Before each request of a chunk: the curve goes on from what the server has, and the try reports into it. */
+    /** Call before each chunk request. The curve continues from what the server has, and the try reports into it. */
     attempt(chunkSize: number): (event: Pick<AxiosProgressEvent, "loaded" | "total">) => void;
-    /** The server answered the chunk of the try. */
+    /** The server answered the try's chunk. */
     chunkDone(chunkSize: number): void;
     /**
-     * A try failed: the server took none of its bytes, and neither its time nor the pause after it counts. Until the
-     * next try has a speed nothing is reported, and the row keeps what it was told last.
+     * A try failed. The server kept none of its bytes, and neither its time nor the pause after it counts.
+     * Nothing is reported until the next try has a speed, so the row keeps its last values.
      */
     attemptFailed(): void;
-    /** Z9: the second that runs reports the whole file, and no further one is asked for. */
+    /** The running second reports the whole file, and no further second is scheduled. */
     lastChunkSent(): void;
-    /** Z10: no further report. */
     stop(): void;
 };

package/dist/domains/dam/uploadQueue/composables/uploadMeter.js

@@ -1,5 +1,5 @@
 import { isNull as e } from "../../../../shared/utils/common.js";
-//#region src/domains/dam/uploadQueue/composables/uploadMeter.ts
+// src/domains/dam/uploadQueue/composables/uploadMeter.ts
 var t = 1e3, n = 1e4, r = 500;
 function i(i) {
 	let a = [], o = 0, s = 0, c = 0, l = 0, u = !1, d = !1, f = 0, p, m, h = () => {
@@ -53,7 +53,6 @@ function i(i) {
 		}
 	};
 }
-//#endregion
 export { i as useUploadMeter };
 
 //# sourceMappingURL=uploadMeter.js.map

package/dist/domains/dam/uploadQueue/composables/uploadMeter.js.map

@@ -1 +1 @@
-{"version":3,"file":"uploadMeter.js","names":["TICK_MS","WINDOW_MS","MIN_SPAN_MS","useUploadMeter","points","fileSize","received","sent","shown","moved","sendingOver","reportedSpeed","timer","current","now","at","mark","bytes","sentAt","next","point","before","after","speed","end","from","span","answered","answerAwaited","tick","bytesPerSecond","report","isNull","size","thisTry","chunkSize","onItsWay","event"],"sources":["../../../../../src/domains/dam/uploadQueue/composables/uploadMeter.ts"],"sourcesContent":["import type { AxiosProgressEvent } from 'axios'\nimport type { UploadProgressCallback } from '@/domains/dam/uploadQueue/presets/uploadPresets'\nimport { isNull } from '@/shared/utils/common'\n\nconst TICK_MS = 1_000\n// Holds the answer to at least one chunk of the size the upload aims at (a quarter of the timeout, 7.5 s at 30 s),\n// and follows a change of speed within it.\nconst WINDOW_MS = 10_000\n// A shorter stretch without an answer of the server shows mostly what the browser took into its buffers: Chromium\n// tells how far the body is at most every 100 ms, axios passes it on at most every 333 ms.\nconst MIN_SPAN_MS = 500\n\ninterface MeterPoint {\n  at: number\n  /** Bytes of the file sent by then: the chunks the server answered, and the share of the one on its way. */\n  sent: number\n  /** The server answered a chunk here. */\n  answered: boolean\n}\n\n/**\n * How far one upload is, how fast it goes and how long it still takes, from one curve: the bytes of its file sent\n * over time, from the request of its first chunk to the answer to its last. It reports once a second, the first at\n * once, and only once it has a speed and either bytes came since its last report or the answer to a chunk that is\n * whole on its way is awaited; the whole file once it is out, also without a speed; without `report` it reports\n * nothing and asks for no second.\n */\nexport function useUploadMeter(report: UploadProgressCallback | undefined) {\n  let points: MeterPoint[] = []\n  let fileSize = 0\n  // Bytes of the chunks the server answered.\n  let received = 0\n  // Bytes sent by the last point; after a failed try, what the server has.\n  let sent = 0\n  // The share last reported: it never goes back.\n  let shown = 0\n  // Bytes came since the last report. A chunk that stands on its way reports nothing: a speed falling with every\n  // second of silence would make the time left hours and the next chunk, sized by the speed, small.\n  let moved = false\n  let sendingOver = false\n  // The speed last reported: the whole file is reported at it when no speed can be read by then, as when the clock\n  // went back before the answer to the last chunk.\n  let reportedSpeed = 0\n  let timer: ReturnType<typeof setTimeout> | undefined\n  // The try whose progress counts, and where the curve is once its chunk is whole on its way. A report of a try that\n  // has ended comes too late to be on the curve.\n  let current: { end: number } | undefined\n\n  const now = () => {\n    const at = Date.now()\n    // The clock went back: nothing measured before can be set against it.\n    if (points.length && at < points.at(-1)!.at) points = []\n    return at\n  }\n  const mark = (bytes: number, answered = false) => {\n    const at = now()\n    if (bytes > sent) moved = true\n    sent = bytes\n    points.push({ at, sent: bytes, answered })\n    // One point stays before the window: its edge is read between two.\n    while (points.length > 2 && points[1]!.at <= at - WINDOW_MS) points.shift()\n  }\n  // Where the curve was as the millisecond `at` began: of the points that share it, the first.\n  const sentAt = (at: number) => {\n    const next = points.findIndex((point) => point.at >= at)\n    if (next === -1) return points.at(-1)!.sent\n    if (next === 0) return points[0]!.sent\n    const before = points[next - 1]!\n    const after = points[next]!\n    return before.sent + ((after.sent - before.sent) * (at - before.at)) / (after.at - before.at)\n  }\n  /** Bytes a second over the window up to now, or up to the last answer once the file is out. */\n  const speed = () => {\n    const end = sendingOver ? points.at(-1)?.at : now()\n    if (points.length < 2 || end === undefined) return null\n    const from = Math.max(points[0]!.at, end - WINDOW_MS)\n    const span = end - from\n    // No point is later than the end: the last one says where the curve is, also among several of one millisecond.\n    const bytes = points.at(-1)!.sent - sentAt(from)\n    const answered = points.some((point) => point.answered && point.at > from)\n    return span > 0 && bytes > 0 && (span >= MIN_SPAN_MS || answered) ? (bytes * 1000) / span : null\n  }\n\n  // The wait for the answer to a chunk that is whole on its way is the server's time. The speed goes on counting it:\n  // the next chunk is sized right after the answer, and not by what the browser took alone.\n  const answerAwaited = () => !!current && sent >= current.end\n\n  const tick = () => {\n    const bytesPerSecond = speed() ?? (sendingOver ? reportedSpeed : null)\n    if (report && !isNull(bytesPerSecond) && (moved || answerAwaited() || sendingOver)) {\n      moved = false\n      shown = sendingOver ? 100 : Math.max(shown, Math.min((sent * 100) / fileSize, 100))\n      reportedSpeed = Math.ceil(bytesPerSecond)\n      report(shown, reportedSpeed, sendingOver ? 0 : Math.ceil((fileSize - sent) / bytesPerSecond))\n    }\n    if (!sendingOver) timer = setTimeout(tick, TICK_MS)\n  }\n\n  return {\n    /** The reports of a file of the given size begin. */\n    start(size: number) {\n      fileSize = size\n      if (report) tick()\n    },\n    /** Before each request of a chunk: the curve goes on from what the server has, and the try reports into it. */\n    attempt(chunkSize: number) {\n      const thisTry = { end: received + chunkSize }\n      current = thisTry\n      mark(received)\n      return (event: Pick<AxiosProgressEvent, 'loaded' | 'total'>) => {\n        if (current !== thisTry) return\n        let onItsWay = event.loaded\n        // `total` is the whole multipart body; what goes on the curve is its share of the chunk, and all of the chunk\n        // once the body is out: of numbers past 2^53 the division makes a little less.\n        if (event.total) onItsWay = event.loaded >= event.total ? chunkSize : (event.loaded * chunkSize) / event.total\n        mark(received + Math.min(Math.max(onItsWay, 0), chunkSize))\n      }\n    },\n    /** The server answered the chunk of the try. */\n    chunkDone(chunkSize: number) {\n      current = undefined\n      received += chunkSize\n      mark(received, true)\n    },\n    /**\n     * A try failed: the server took none of its bytes, and neither its time nor the pause after it counts. Until the\n     * next try has a speed nothing is reported, and the row keeps what it was told last.\n     */\n    attemptFailed() {\n      current = undefined\n      points = []\n      sent = received\n    },\n    /** Z9: the second that runs reports the whole file, and no further one is asked for. */\n    lastChunkSent() {\n      sendingOver = true\n    },\n    /** Z10: no further report. */\n    stop() {\n      clearTimeout(timer)\n      timer = undefined\n      sendingOver = true\n    },\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"uploadMeter.js","names":["TICK_MS","WINDOW_MS","MIN_SPAN_MS","useUploadMeter","points","fileSize","received","sent","shown","moved","sendingOver","reportedSpeed","timer","current","now","at","mark","bytes","sentAt","next","point","before","after","speed","end","from","span","answered","answerAwaited","tick","bytesPerSecond","report","isNull","size","thisTry","chunkSize","onItsWay","event"],"sources":["../../../../../src/domains/dam/uploadQueue/composables/uploadMeter.ts"],"sourcesContent":["import type { AxiosProgressEvent } from 'axios'\nimport type { UploadProgressCallback } from '@/domains/dam/uploadQueue/presets/uploadPresets'\nimport { isNull } from '@/shared/utils/common'\n\nconst TICK_MS = 1_000\n// Covers the response to at least one target-size chunk (a quarter of\n// the timeout, 7.5 s at 30 s), and still tracks speed changes within it.\nconst WINDOW_MS = 10_000\n// A shorter span without a server response mostly measures browser buffering.\n// Chromium reports body progress at most every 100 ms, and axios forwards it at most every 333 ms.\nconst MIN_SPAN_MS = 500\n\ninterface MeterPoint {\n  at: number\n  /** File bytes sent by then: the answered chunks plus the sent share of the chunk in flight. */\n  sent: number\n  /** The server answered a chunk at this point. */\n  answered: boolean\n}\n\n/**\n * Progress, speed and remaining time of one upload, from one curve: file\n * bytes sent over time, from the first chunk request to the last answer.\n * Reports once a second, the first immediately. It reports only with a known speed and\n * when bytes moved since the last report or an answer to a fully sent chunk is awaited.\n * Once the file is out it reports the whole file, also without a\n * speed. Without `report` it reports nothing and starts no timer.\n */\nexport function useUploadMeter(report: UploadProgressCallback | undefined) {\n  let points: MeterPoint[] = []\n  let fileSize = 0\n  let received = 0\n  // Bytes sent at the last point. After a failed try, what the server has.\n  let sent = 0\n  // The share last reported. It never decreases.\n  let shown = 0\n  // Bytes moved since the last report. A stalled chunk reports nothing.\n  // Otherwise the speed would fall each silent second, the time left would\n  // grow to hours and the next chunk, sized by speed, would be small.\n  let moved = false\n  let sendingOver = false\n  // The speed last reported. The whole file is reported at it when no speed\n  // can be read, e.g. when the clock went back before the last chunk's answer.\n  let reportedSpeed = 0\n  let timer: ReturnType<typeof setTimeout> | undefined\n  // The try whose progress counts, and the curve position once its chunk is\n  // fully sent. Progress from an ended try arrives too late for the curve.\n  let current: { end: number } | undefined\n\n  const now = () => {\n    const at = Date.now()\n    // The clock went back: earlier measurements cannot be compared with it.\n    if (points.length && at < points.at(-1)!.at) points = []\n    return at\n  }\n  const mark = (bytes: number, answered = false) => {\n    const at = now()\n    if (bytes > sent) moved = true\n    sent = bytes\n    points.push({ at, sent: bytes, answered })\n    // Keep one point before the window, so its edge can be interpolated between two points.\n    while (points.length > 2 && points[1]!.at <= at - WINDOW_MS) points.shift()\n  }\n  // The curve value at the start of millisecond `at`: of points sharing it, the first.\n  const sentAt = (at: number) => {\n    const next = points.findIndex((point) => point.at >= at)\n    if (next === -1) return points.at(-1)!.sent\n    if (next === 0) return points[0]!.sent\n    const before = points[next - 1]!\n    const after = points[next]!\n    return before.sent + ((after.sent - before.sent) * (at - before.at)) / (after.at - before.at)\n  }\n  /** Bytes per second over the window up to now, or up to the last answer once the file is out. */\n  const speed = () => {\n    const end = sendingOver ? points.at(-1)?.at : now()\n    if (points.length < 2 || end === undefined) return null\n    const from = Math.max(points[0]!.at, end - WINDOW_MS)\n    const span = end - from\n    // No point is later than the end, so the last one is the\n    // current curve value, also when several share one millisecond.\n    const bytes = points.at(-1)!.sent - sentAt(from)\n    const answered = points.some((point) => point.answered && point.at > from)\n    return span > 0 && bytes > 0 && (span >= MIN_SPAN_MS || answered) ? (bytes * 1000) / span : null\n  }\n\n  // Waiting for the answer to a fully sent chunk is server time. The speed keeps counting\n  // it, so the next chunk is sized after the answer and not by browser buffering alone.\n  const answerAwaited = () => !!current && sent >= current.end\n\n  const tick = () => {\n    const bytesPerSecond = speed() ?? (sendingOver ? reportedSpeed : null)\n    if (report && !isNull(bytesPerSecond) && (moved || answerAwaited() || sendingOver)) {\n      moved = false\n      shown = sendingOver ? 100 : Math.max(shown, Math.min((sent * 100) / fileSize, 100))\n      reportedSpeed = Math.ceil(bytesPerSecond)\n      report(shown, reportedSpeed, sendingOver ? 0 : Math.ceil((fileSize - sent) / bytesPerSecond))\n    }\n    if (!sendingOver) timer = setTimeout(tick, TICK_MS)\n  }\n\n  return {\n    /** Starts reporting for a file of the given size. */\n    start(size: number) {\n      fileSize = size\n      if (report) tick()\n    },\n    /** Call before each chunk request. The curve continues from what the server has, and the try reports into it. */\n    attempt(chunkSize: number) {\n      const thisTry = { end: received + chunkSize }\n      current = thisTry\n      mark(received)\n      return (event: Pick<AxiosProgressEvent, 'loaded' | 'total'>) => {\n        if (current !== thisTry) return\n        let onItsWay = event.loaded\n        // `total` is the whole multipart body. The curve gets its share of the chunk, and the whole\n        // chunk once the body is out, since the division gives slightly less for numbers past 2^53.\n        if (event.total) onItsWay = event.loaded >= event.total ? chunkSize : (event.loaded * chunkSize) / event.total\n        mark(received + Math.min(Math.max(onItsWay, 0), chunkSize))\n      }\n    },\n    /** The server answered the try's chunk. */\n    chunkDone(chunkSize: number) {\n      current = undefined\n      received += chunkSize\n      mark(received, true)\n    },\n    /**\n     * A try failed. The server kept none of its bytes, and neither its time nor the pause after it counts.\n     * Nothing is reported until the next try has a speed, so the row keeps its last values.\n     */\n    attemptFailed() {\n      current = undefined\n      points = []\n      sent = received\n    },\n    /** The running second reports the whole file, and no further second is scheduled. */\n    lastChunkSent() {\n      sendingOver = true\n    },\n    stop() {\n      clearTimeout(timer)\n      timer = undefined\n      sendingOver = true\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/domains/dam/uploadQueue/composables/uploadQueueItemRefresh.d.ts

@@ -3,7 +3,7 @@ import { UploadQueueItem, UploadQueueKey } from '../../types/UploadQueue';
 import { UploadQueueListBinding } from '../components/uploadQueueBindings';
 import { DocId } from '../../../../shared/types/common';
 export declare const SHOW_REFRESH_AFTER_SECONDS = 20;
-/** The warnings of a refresh, the message keys a host's `warn` is handed. */
+/** Message keys passed to the host's `warn` after a refresh. */
 export declare const REFRESH_WARNING_KEYS: {
     readonly pendingT: "common.damImage.queueItem.stillUploadingOrProcessing";
     readonly failedT: "common.damImage.queueItem.refreshFailed";
@@ -11,15 +11,15 @@ export declare const REFRESH_WARNING_KEYS: {
     readonly originalUnreadT: "common.damImage.queueItem.duplicateOriginalUnread";
 };
 export type UploadRefreshWarningKey = (typeof REFRESH_WARNING_KEYS)[keyof typeof REFRESH_WARNING_KEYS];
-/** The refresh of the rows of a list, over what its host binds: the host asks, and says what came of it. */
+/** Refresh for the rows of a list. The host binding does the request and shows the warnings. */
 export declare function createUploadQueueItemRefresh(queue: Pick<UploadQueueListBinding, 'items' | 'refresh' | 'refreshMayHelp' | 'warn'>): {
     refreshing: Ref<boolean, boolean>;
     refreshItem: (item: UploadQueueItem) => Promise<void>;
 };
 /**
- * The refresh of an item of the upload queue: asks what became of its file, and settles the item accordingly.
- * The store asks with the client of the configuration of the queue, and settles the rows of its queues: those of the
- * queue `queueKey` of the refresh, or of the configuration `configName` where none is given.
+ * Refresh of an upload queue item: asks the server what became of its file and updates the item.
+ * Uses the client of the queue's configuration. Updates rows of queue
+ * `queueKey`, or of configuration `configName` when no key is given.
  */
 export declare function useUploadQueueItemRefresh(configName: string): {
     refreshing: Ref<boolean, boolean>;

package/dist/domains/dam/uploadQueue/composables/uploadQueueItemRefresh.js

@@ -1,9 +1,9 @@
-import { isUndefined as e } from "../../../../shared/utils/common.js";
-import { useAlerts as t } from "../../../system/composables/alerts.js";
-import { UploadQueueItemStatus as n } from "../../types/UploadQueue.js";
-import { useUploadQueuesStore as r } from "../store/uploadQueuesStore.js";
+import { UploadQueueItemStatus as e } from "../../types/UploadQueue.js";
+import { useUploadQueuesStore as t } from "../store/uploadQueuesStore.js";
+import { useAlerts as n } from "../../../system/composables/alerts.js";
+import { isUndefined as r } from "../../../../shared/utils/common.js";
 import { ref as i } from "vue";
-//#region src/domains/dam/uploadQueue/composables/uploadQueueItemRefresh.ts
+// src/domains/dam/uploadQueue/composables/uploadQueueItemRefresh.ts
 var a = {
 	pendingT: "common.damImage.queueItem.stillUploadingOrProcessing",
 	failedT: "common.damImage.queueItem.refreshFailed",
@@ -14,27 +14,27 @@ var a = {
 	error: a.failedT,
 	missing: a.assetGoneT,
 	originalUnread: a.originalUnreadT
-}, s = (e, t) => {
-	switch (e.status) {
-		case n.Failed: return t(e);
-		case n.Uploaded: return !e.canEditMetadata && !e.isDuplicate;
-		case n.Stop: return !1;
+}, s = (t, n) => {
+	switch (t.status) {
+		case e.Failed: return n(t);
+		case e.Uploaded: return !t.canEditMetadata && !t.isDuplicate;
+		case e.Stop: return !1;
 		default: return !0;
 	}
-}, c = async (e, t, r, i, c, l) => {
-	e.value = !0;
+}, c = async (t, n, r, i, c, l) => {
+	t.value = !0;
 	let u = i?.status;
 	try {
-		let e = o[await t()];
-		if (!e) return;
+		let t = o[await n()];
+		if (!t) return;
 		if (i) {
 			if (c()) return;
-			let t = i.status === u ? null : i.status;
-			if (t === n.Uploaded || t === n.Stop || t === n.Failed && e !== a.originalUnreadT || !s(i, l)) return;
+			let n = i.status === u ? null : i.status;
+			if (n === e.Uploaded || n === e.Stop || n === e.Failed && t !== a.originalUnreadT || !s(i, l)) return;
 		}
-		r(e);
+		r(t);
 	} finally {
-		e.value = !1;
+		t.value = !1;
 	}
 };
 function l(e) {
@@ -46,14 +46,13 @@ function l(e) {
 		}
 	};
 }
-function u(n) {
-	let a = r(), { showWarningT: o } = t(), s = i(!1);
+function u(e) {
+	let a = t(), { showWarningT: o } = n(), s = i(!1);
 	return {
 		refreshing: s,
-		refreshItem: (t, r, i) => c(s, () => a.refreshAsset(t, e(i) ? n : { queueKey: i }), (e) => o(e), r, () => !!r && !e(i) && !a.getQueueItems(i).includes(r), (e) => a.refreshMayHelp(e))
+		refreshItem: (t, n, i) => c(s, () => a.refreshAsset(t, r(i) ? e : { queueKey: i }), (e) => o(e), n, () => !!n && !r(i) && !a.getQueueItems(i).includes(n), (e) => a.refreshMayHelp(e))
 	};
 }
-//#endregion
 export { a as REFRESH_WARNING_KEYS, l as createUploadQueueItemRefresh, u as useUploadQueueItemRefresh };
 
 //# sourceMappingURL=uploadQueueItemRefresh.js.map

package/dist/domains/dam/uploadQueue/composables/uploadQueueItemRefresh.js.map

@@ -1 +1 @@
-{"version":3,"file":"uploadQueueItemRefresh.js","names":["REFRESH_WARNING_KEYS","WARNING_OF","refreshMayStillHelp","item","UploadQueueItemStatus","refreshMayHelp","refreshAndSay","statusBefore","key","ask","gone","changedInto","createUploadQueueItemRefresh","refreshing","ref","queue","failed","useUploadQueueItemRefresh","uploadQueuesStore","useUploadQueuesStore","useAlerts","assetId","isUndefined","queueKey","configName","showWarningT"],"sources":["../../../../../src/domains/dam/uploadQueue/composables/uploadQueueItemRefresh.ts"],"sourcesContent":["import { type Ref, ref } from 'vue'\nimport { type UploadQueueItem, UploadQueueItemStatus, type UploadQueueKey } from '@/domains/dam/types/UploadQueue'\nimport type { UploadQueueListBinding } from '@/domains/dam/uploadQueue/components/uploadQueueBindings'\nimport type { UploadRefreshOutcome } from '@/domains/dam/uploadQueue/settlement/uploadSettlementTypes'\nimport { useUploadQueuesStore } from '@/domains/dam/uploadQueue/store/uploadQueuesStore'\nimport { useAlerts } from '@/domains/system/composables/alerts'\nimport type { DocId } from '@/shared/types/common'\nimport { isUndefined } from '@/shared/utils/common'\n\n// How long an item of the queue waits before it offers refresh.\nexport const SHOW_REFRESH_AFTER_SECONDS = 20\n\n/** The warnings of a refresh, the message keys a host's `warn` is handed. */\nexport const REFRESH_WARNING_KEYS = {\n  pendingT: 'common.damImage.queueItem.stillUploadingOrProcessing',\n  failedT: 'common.damImage.queueItem.refreshFailed',\n  assetGoneT: 'common.damImage.queueItem.assetGone',\n  originalUnreadT: 'common.damImage.queueItem.duplicateOriginalUnread',\n} as const\nexport type UploadRefreshWarningKey = (typeof REFRESH_WARNING_KEYS)[keyof typeof REFRESH_WARNING_KEYS]\n\n// Why the item is as it was: the file is not done yet, or what asking again may mend, by its cause.\nconst WARNING_OF: Partial<Record<UploadRefreshOutcome, UploadRefreshWarningKey>> = {\n  pending: REFRESH_WARNING_KEYS.pendingT,\n  error: REFRESH_WARNING_KEYS.failedT,\n  missing: REFRESH_WARNING_KEYS.assetGoneT,\n  originalUnread: REFRESH_WARNING_KEYS.originalUnreadT,\n}\n\n/**\n * Whether a refresh may still change the item, as the row offers it: a failed one as its host says, an uploaded\n * one while it waits for its metadata, one still on its way or processed always, a stopped one never.\n */\nconst refreshMayStillHelp = (item: UploadQueueItem, refreshMayHelp: (item: UploadQueueItem) => boolean) => {\n  switch (item.status) {\n    case UploadQueueItemStatus.Failed:\n      return refreshMayHelp(item)\n    case UploadQueueItemStatus.Uploaded:\n      return !item.canEditMetadata && !item.isDuplicate\n    case UploadQueueItemStatus.Stop:\n      return false\n    default:\n      return true\n  }\n}\n\n/**\n * One refresh, and what the user is told of it. `item` is the one whose refresh was pressed, where the caller has\n * it, `gone` whether it was taken out of its queue meanwhile, and `refreshMayHelp` whether a refresh may still\n * change it once it has failed.\n */\nconst refreshAndSay = async (\n  refreshing: Ref<boolean>,\n  ask: () => Promise<UploadRefreshOutcome>,\n  warn: UploadQueueListBinding['warn'],\n  item: UploadQueueItem | undefined,\n  gone: () => boolean,\n  refreshMayHelp: (item: UploadQueueItem) => boolean\n) => {\n  refreshing.value = true\n  const statusBefore = item?.status\n  try {\n    const key = WARNING_OF[await ask()]\n    if (!key) return\n    if (item) {\n      // Taken out of its queue meanwhile: the word would be about a row nobody sees any more.\n      if (gone()) return\n      // Uploaded, stopped or failed while the read was on its way, by what overtook it or by this very read: what\n      // the read found is about the row as it was before, and the row shows what became of it. Only the press that\n      // left it without the original of its duplicate says why, as the row keeps its refresh for that.\n      const changedInto = item.status === statusBefore ? null : item.status\n      if (changedInto === UploadQueueItemStatus.Uploaded || changedInto === UploadQueueItemStatus.Stop) return\n      if (changedInto === UploadQueueItemStatus.Failed && key !== REFRESH_WARNING_KEYS.originalUnreadT) return\n      // And only while pressing again may still help it: not a failed row with no refresh left, nor an uploaded\n      // one that has its form.\n      if (!refreshMayStillHelp(item, refreshMayHelp)) return\n    }\n    warn(key)\n  } finally {\n    refreshing.value = false\n  }\n}\n\n/** The refresh of the rows of a list, over what its host binds: the host asks, and says what came of it. */\nexport function createUploadQueueItemRefresh(\n  queue: Pick<UploadQueueListBinding, 'items' | 'refresh' | 'refreshMayHelp' | 'warn'>\n) {\n  const refreshing = ref(false)\n  const gone = (item: UploadQueueItem) => !queue.items().includes(item)\n\n  const refreshItem = async (item: UploadQueueItem) => {\n    // A row that is no longer in the list is not asked about.\n    if (gone(item)) return\n    await refreshAndSay(\n      refreshing,\n      () => queue.refresh(item),\n      (key) => queue.warn(key),\n      item,\n      () => gone(item),\n      (failed) => queue.refreshMayHelp(failed)\n    )\n  }\n\n  return { refreshing, refreshItem }\n}\n\n/**\n * The refresh of an item of the upload queue: asks what became of its file, and settles the item accordingly.\n * The store asks with the client of the configuration of the queue, and settles the rows of its queues: those of the\n * queue `queueKey` of the refresh, or of the configuration `configName` where none is given.\n */\nexport function useUploadQueueItemRefresh(configName: string) {\n  const uploadQueuesStore = useUploadQueuesStore()\n  const { showWarningT } = useAlerts()\n  const refreshing = ref(false)\n\n  /**\n   * `item` is the one whose refresh was pressed and `queueKey` the queue it was pressed in, where the caller has\n   * them: the warnings of a failure and of a file not done yet go by them.\n   */\n  const refreshItem = (assetId: DocId, item?: UploadQueueItem, queueKey?: UploadQueueKey) =>\n    refreshAndSay(\n      refreshing,\n      () => uploadQueuesStore.refreshAsset(assetId, isUndefined(queueKey) ? configName : { queueKey }),\n      (key) => showWarningT(key),\n      item,\n      // A removed item keeps its status unless it was still waiting or being sent: that it is gone is read from\n      // its queue.\n      () => !!item && !isUndefined(queueKey) && !uploadQueuesStore.getQueueItems(queueKey).includes(item),\n      (failed) => uploadQueuesStore.refreshMayHelp(failed)\n    )\n\n  return { refreshing, refreshItem }\n}\n"],"mappings":";;;;;;AAaA,IAAaA,IAAuB;CAClC,UAAU;CACV,SAAS;CACT,YAAY;CACZ,iBAAiB;AACnB,GAIMC,IAA6E;CACjF,SAASD,EAAqB;CAC9B,OAAOA,EAAqB;CAC5B,SAASA,EAAqB;CAC9B,gBAAgBA,EAAqB;AACvC,GAMME,KAAuB,GAAuB,MAAuD;CACzG,QAAQC,EAAK,QAAb;EACE,KAAKC,EAAsB,QACzB,OAAOC,EAAeF,CAAI;EAC5B,KAAKC,EAAsB,UACzB,OAAO,CAACD,EAAK,mBAAmB,CAACA,EAAK;EACxC,KAAKC,EAAsB,MACzB,OAAO;EACT,SACE,OAAO;CACX;AACF,GAOME,IAAgB,OACpB,GACA,GACA,GACA,GACA,GACA,MACG;CACH,EAAW,QAAQ;CACnB,IAAMC,IAAeJ,GAAM;CAC3B,IAAI;EACF,IAAMK,IAAMP,EAAW,MAAMQ,EAAI;EACjC,IAAI,CAACD,GAAK;EACV,IAAIL,GAAM;GAER,IAAIO,EAAK,GAAG;GAIZ,IAAMC,IAAcR,EAAK,WAAWI,IAAe,OAAOJ,EAAK;GAK/D,IAJIQ,MAAgBP,EAAsB,YAAYO,MAAgBP,EAAsB,QACxFO,MAAgBP,EAAsB,UAAUI,MAAQR,EAAqB,mBAG7E,CAACE,EAAoBC,GAAME,CAAc,GAAG;EAClD;EACA,EAAKG,CAAG;CACV,UAAU;EACR,EAAW,QAAQ;CACrB;AACF;AAGA,SAAgBI,EACd,GACA;CACA,IAAMC,IAAaC,EAAI,EAAK,GACtBJ,KAAQ,MAA0B,CAACK,EAAM,MAAM,CAAC,CAAC,SAASZ,CAAI;CAepE,OAAO;EAAE;EAAY,oBAbM,MAA0B;GAEnD,AAAIO,EAAKP,CAAI,KACb,MAAMG,EACJO,SACME,EAAM,QAAQZ,CAAI,IACvB,MAAQY,EAAM,KAAKP,CAAG,GACvBL,SACMO,EAAKP,CAAI,IACd,MAAWY,EAAM,eAAeC,CAAM,CACzC;EACF;CAEiC;AACnC;AAOA,SAAgBC,EAA0B,GAAoB;CAC5D,IAAMC,IAAoBC,EAAqB,GACzC,EAAE,oBAAiBC,EAAU,GAC7BP,IAAaC,EAAI,EAAK;CAkB5B,OAAO;EAAE;EAAY,cAZA,GAAgB,GAAwB,MAC3DR,EACEO,SACMK,EAAkB,aAAaG,GAASC,EAAYC,CAAQ,IAAIC,IAAa,EAAE,YAAS,CAAC,IAC9F,MAAQC,EAAajB,CAAG,GACzBL,SAGM,CAAC,CAACA,KAAQ,CAACmB,EAAYC,CAAQ,KAAK,CAACL,EAAkB,cAAcK,CAAQ,CAAC,CAAC,SAASpB,CAAI,IACjG,MAAWe,EAAkB,eAAeF,CAAM,CACrD;CAE+B;AACnC"}
+{"version":3,"file":"uploadQueueItemRefresh.js","names":["REFRESH_WARNING_KEYS","WARNING_OF","refreshMayStillHelp","item","UploadQueueItemStatus","refreshMayHelp","refreshAndSay","statusBefore","key","ask","gone","changedInto","createUploadQueueItemRefresh","refreshing","ref","queue","failed","useUploadQueueItemRefresh","uploadQueuesStore","useUploadQueuesStore","useAlerts","assetId","isUndefined","queueKey","configName","showWarningT"],"sources":["../../../../../src/domains/dam/uploadQueue/composables/uploadQueueItemRefresh.ts"],"sourcesContent":["import { type Ref, ref } from 'vue'\nimport { type UploadQueueItem, UploadQueueItemStatus, type UploadQueueKey } from '@/domains/dam/types/UploadQueue'\nimport type { UploadQueueListBinding } from '@/domains/dam/uploadQueue/components/uploadQueueBindings'\nimport type { UploadRefreshOutcome } from '@/domains/dam/uploadQueue/settlement/uploadSettlementTypes'\nimport { useUploadQueuesStore } from '@/domains/dam/uploadQueue/store/uploadQueuesStore'\nimport { useAlerts } from '@/domains/system/composables/alerts'\nimport type { DocId } from '@/shared/types/common'\nimport { isUndefined } from '@/shared/utils/common'\n\nexport const SHOW_REFRESH_AFTER_SECONDS = 20\n\n/** Message keys passed to the host's `warn` after a refresh. */\nexport const REFRESH_WARNING_KEYS = {\n  pendingT: 'common.damImage.queueItem.stillUploadingOrProcessing',\n  failedT: 'common.damImage.queueItem.refreshFailed',\n  assetGoneT: 'common.damImage.queueItem.assetGone',\n  originalUnreadT: 'common.damImage.queueItem.duplicateOriginalUnread',\n} as const\nexport type UploadRefreshWarningKey = (typeof REFRESH_WARNING_KEYS)[keyof typeof REFRESH_WARNING_KEYS]\n\n// Warning per refresh outcome: the file is not done yet, or what a new refresh may fix.\nconst WARNING_OF: Partial<Record<UploadRefreshOutcome, UploadRefreshWarningKey>> = {\n  pending: REFRESH_WARNING_KEYS.pendingT,\n  error: REFRESH_WARNING_KEYS.failedT,\n  missing: REFRESH_WARNING_KEYS.assetGoneT,\n  originalUnread: REFRESH_WARNING_KEYS.originalUnreadT,\n}\n\n/**\n * Whether a refresh may still change the item.\n * Failed: as the host's `refreshMayHelp` says. Uploaded: only while it waits for metadata.\n * Waiting, uploading or processing: always. Stopped: never.\n */\nconst refreshMayStillHelp = (item: UploadQueueItem, refreshMayHelp: (item: UploadQueueItem) => boolean) => {\n  switch (item.status) {\n    case UploadQueueItemStatus.Failed:\n      return refreshMayHelp(item)\n    case UploadQueueItemStatus.Uploaded:\n      return !item.canEditMetadata && !item.isDuplicate\n    case UploadQueueItemStatus.Stop:\n      return false\n    default:\n      return true\n  }\n}\n\n/**\n * Runs one refresh and warns the user about the result.\n * `item` is the row whose refresh was pressed, if the caller has it. `gone` tells whether it left its queue meanwhile.\n * `refreshMayHelp` tells whether a refresh may still change a failed item.\n */\nconst refreshAndSay = async (\n  refreshing: Ref<boolean>,\n  ask: () => Promise<UploadRefreshOutcome>,\n  warn: UploadQueueListBinding['warn'],\n  item: UploadQueueItem | undefined,\n  gone: () => boolean,\n  refreshMayHelp: (item: UploadQueueItem) => boolean\n) => {\n  refreshing.value = true\n  const statusBefore = item?.status\n  try {\n    const key = WARNING_OF[await ask()]\n    if (!key) return\n    if (item) {\n      // Removed from its queue meanwhile: a warning would be about a row nobody sees.\n      if (gone()) return\n      // The status changed while the read was in flight, by another event or by this read.\n      // The result describes the old row, and the row already shows the new state.\n      // Only a failure that keeps the refresh button, such as a missing duplicate original, gets a warning.\n      const changedInto = item.status === statusBefore ? null : item.status\n      if (changedInto === UploadQueueItemStatus.Uploaded || changedInto === UploadQueueItemStatus.Stop) return\n      if (changedInto === UploadQueueItemStatus.Failed && key !== REFRESH_WARNING_KEYS.originalUnreadT) return\n      // Warn only while pressing again may still help.\n      // Not for a failed row with no refresh left, nor an uploaded row that has its form.\n      if (!refreshMayStillHelp(item, refreshMayHelp)) return\n    }\n    warn(key)\n  } finally {\n    refreshing.value = false\n  }\n}\n\n/** Refresh for the rows of a list. The host binding does the request and shows the warnings. */\nexport function createUploadQueueItemRefresh(\n  queue: Pick<UploadQueueListBinding, 'items' | 'refresh' | 'refreshMayHelp' | 'warn'>\n) {\n  const refreshing = ref(false)\n  const gone = (item: UploadQueueItem) => !queue.items().includes(item)\n\n  const refreshItem = async (item: UploadQueueItem) => {\n    if (gone(item)) return\n    await refreshAndSay(\n      refreshing,\n      () => queue.refresh(item),\n      (key) => queue.warn(key),\n      item,\n      () => gone(item),\n      (failed) => queue.refreshMayHelp(failed)\n    )\n  }\n\n  return { refreshing, refreshItem }\n}\n\n/**\n * Refresh of an upload queue item: asks the server what became of its file and updates the item.\n * Uses the client of the queue's configuration. Updates rows of queue\n * `queueKey`, or of configuration `configName` when no key is given.\n */\nexport function useUploadQueueItemRefresh(configName: string) {\n  const uploadQueuesStore = useUploadQueuesStore()\n  const { showWarningT } = useAlerts()\n  const refreshing = ref(false)\n\n  /**\n   * `item` and `queueKey` are the pressed row and its queue, if the caller has them.\n   * The warnings for a failure and for an unfinished file depend on them.\n   */\n  const refreshItem = (assetId: DocId, item?: UploadQueueItem, queueKey?: UploadQueueKey) =>\n    refreshAndSay(\n      refreshing,\n      () => uploadQueuesStore.refreshAsset(assetId, isUndefined(queueKey) ? configName : { queueKey }),\n      (key) => showWarningT(key),\n      item,\n      // A removed item keeps its status unless it was waiting or uploading.\n      // So removal is detected by checking its queue.\n      () => !!item && !isUndefined(queueKey) && !uploadQueuesStore.getQueueItems(queueKey).includes(item),\n      (failed) => uploadQueuesStore.refreshMayHelp(failed)\n    )\n\n  return { refreshing, refreshItem }\n}\n"],"mappings":";;;;;;AAYA,IAAaA,IAAuB;CAClC,UAAU;CACV,SAAS;CACT,YAAY;CACZ,iBAAiB;AACnB,GAIMC,IAA6E;CACjF,SAASD,EAAqB;CAC9B,OAAOA,EAAqB;CAC5B,SAASA,EAAqB;CAC9B,gBAAgBA,EAAqB;AACvC,GAOME,KAAuB,GAAuB,MAAuD;CACzG,QAAQC,EAAK,QAAb;EACE,KAAKC,EAAsB,QACzB,OAAOC,EAAeF,CAAI;EAC5B,KAAKC,EAAsB,UACzB,OAAO,CAACD,EAAK,mBAAmB,CAACA,EAAK;EACxC,KAAKC,EAAsB,MACzB,OAAO;EACT,SACE,OAAO;CACX;AACF,GAOME,IAAgB,OACpB,GACA,GACA,GACA,GACA,GACA,MACG;CACH,EAAW,QAAQ;CACnB,IAAMC,IAAeJ,GAAM;CAC3B,IAAI;EACF,IAAMK,IAAMP,EAAW,MAAMQ,EAAI;EACjC,IAAI,CAACD,GAAK;EACV,IAAIL,GAAM;GAER,IAAIO,EAAK,GAAG;GAIZ,IAAMC,IAAcR,EAAK,WAAWI,IAAe,OAAOJ,EAAK;GAK/D,IAJIQ,MAAgBP,EAAsB,YAAYO,MAAgBP,EAAsB,QACxFO,MAAgBP,EAAsB,UAAUI,MAAQR,EAAqB,mBAG7E,CAACE,EAAoBC,GAAME,CAAc,GAAG;EAClD;EACA,EAAKG,CAAG;CACV,UAAU;EACR,EAAW,QAAQ;CACrB;AACF;AAGA,SAAgBI,EACd,GACA;CACA,IAAMC,IAAaC,EAAI,EAAK,GACtBJ,KAAQ,MAA0B,CAACK,EAAM,MAAM,CAAC,CAAC,SAASZ,CAAI;CAcpE,OAAO;EAAE;EAAY,oBAZM,MAA0B;GACnD,AAAIO,EAAKP,CAAI,KACb,MAAMG,EACJO,SACME,EAAM,QAAQZ,CAAI,IACvB,MAAQY,EAAM,KAAKP,CAAG,GACvBL,SACMO,EAAKP,CAAI,IACd,MAAWY,EAAM,eAAeC,CAAM,CACzC;EACF;CAEiC;AACnC;AAOA,SAAgBC,EAA0B,GAAoB;CAC5D,IAAMC,IAAoBC,EAAqB,GACzC,EAAE,oBAAiBC,EAAU,GAC7BP,IAAaC,EAAI,EAAK;CAkB5B,OAAO;EAAE;EAAY,cAZA,GAAgB,GAAwB,MAC3DR,EACEO,SACMK,EAAkB,aAAaG,GAASC,EAAYC,CAAQ,IAAIC,IAAa,EAAE,YAAS,CAAC,IAC9F,MAAQC,EAAajB,CAAG,GACzBL,SAGM,CAAC,CAACA,KAAQ,CAACmB,EAAYC,CAAQ,KAAK,CAACL,EAAkB,cAAcK,CAAQ,CAAC,CAAC,SAASpB,CAAI,IACjG,MAAWe,EAAkB,eAAeF,CAAM,CACrD;CAE+B;AACnC"}

package/dist/domains/dam/uploadQueue/composables/uploadQueueMassOperations.js

@@ -1,7 +1,7 @@
 import { useUploadQueuesStore as e } from "../store/uploadQueuesStore.js";
 import { fillAuthors as t, fillCustomDataValue as n, fillKeywords as r } from "../core/uploadQueueFill.js";
 import { toValue as i } from "vue";
-//#region src/domains/dam/uploadQueue/composables/uploadQueueMassOperations.ts
+// src/domains/dam/uploadQueue/composables/uploadQueueMassOperations.ts
 function a(a) {
 	let o = e();
 	return {
@@ -16,7 +16,6 @@ function a(a) {
 		}
 	};
 }
-//#endregion
 export { a as useUploadQueueMassOperations };
 
 //# sourceMappingURL=uploadQueueMassOperations.js.map

package/dist/domains/dam/uploadQueue/composables/uploadService.d.ts

@@ -1,12 +1,11 @@
 import { UploadQueueItem } from '../../types/UploadQueue';
 import { UploadMessages, UploadPreset, UploadProgressCallback, UploadRun, UploadSide } from '../presets/uploadPresets';
-/** The text of a validation answer (422 with `fields`): one line per field, in the texts of the side. */
+/** Message for a validation error (422 with `fields`): one line per field, in the side's texts. */
 export declare function uploadValidationMessage(error: unknown, messages: UploadMessages): string;
-/** One run for both sides; without a set it is the library's. Public as `useDamUpload`. */
+/** Run for either side. Without a preset it uses the library's. Public as `useDamUpload`. */
 export declare function useUpload(queueItem: UploadQueueItem, uploadCallback?: UploadProgressCallback, preset?: undefined): UploadRun<'library'> & {
     stopSpeedCheck(): void;
 };
-/** The run of the side of the set. */
 export declare function useUpload<S extends UploadSide>(queueItem: UploadQueueItem, uploadCallback: UploadProgressCallback | undefined, preset: UploadPreset<S>): UploadRun<S> & {
     stopSpeedCheck(): void;
 };