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

package/dist/plugins/i18n.js.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.js","names":["REQUIRED_LOCALES","slovakPluralizationRule","choicesLength","choice","i18n","createI18n","locale","key","installed","setCommonAdminI18n","instance","commonI18n","commonT","args","commonTe"],"sources":["../../src/plugins/i18n.ts"],"sourcesContent":["import type { I18n, Locale, Path } from 'vue-i18n'\nimport { createI18n } from 'vue-i18n'\nimport type en from '@/locales/en'\n\nexport type MessageSchema = typeof en\n\nconst REQUIRED_LOCALES = ['en', 'sk']\n\n/**\n * Custom Slovak Pluralization Rule.\n *\n * Automatically detects the format of the translation string based on the number\n * of pipe-separated choices (`choicesLength`) and returns the correct index.\n *\n * Case A: 4 choices (Extended format with explicit 0 support)\n * Structure: \"0 items | 1 item | 2-4 items | 5+ items\"\n * - 0    -> Index 0\n * - 1    -> Index 1\n * - 2-4  -> Index 2\n * - 5+   -> Index 3\n *\n * Case B: 3 choices (Starndard Slovak format)\n * Structure: \"1 item | 2-4 items | 5+ items\"\n * - 1    -> Index 0\n * - 2-4  -> Index 1\n * - 5+   -> Index 2 (Includes 0)\n *\n * Case C: 2 choices or fewer (Fallback)\n * - 1    -> Index 0\n * - Other-> Index 1\n */\nexport const slovakPluralizationRule = (choice: number, choicesLength: number) => {\n  if (choicesLength === 4) {\n    if (choice === 0) return 0\n    if (choice === 1) return 1\n    if (choice >= 2 && choice <= 4) return 2\n    return 3\n  }\n  if (choicesLength === 3) {\n    if (choice === 1) return 0\n    if (choice >= 2 && choice <= 4) return 1\n    return 2\n  }\n  return choice === 1 ? 0 : 1\n}\n\nexport const i18n = createI18n<[MessageSchema], string, false>({\n  globalInjection: false,\n  legacy: false,\n  locale: REQUIRED_LOCALES[0],\n  fallbackLocale: false,\n  pluralRules: {\n    sk: slovakPluralizationRule,\n    // Czech shares the Slovak plural categories (one / 2-4 / other), and without\n    // a rule the default would pick zero|one|other: \"1 nepotvrzené změny\".\n    cs: slovakPluralizationRule,\n  },\n  missing: (locale: Locale, key: Path) => {\n    if (REQUIRED_LOCALES.includes(locale) && !key.startsWith('system.subject.')) {\n      console.warn(`Missing ${locale} translation: ${key}`)\n    }\n  },\n})\n\n/** The admin's instance as the plugin takes it: composition mode (`legacy: false`), any message schema. */\n// oxlint-disable-next-line typescript/no-explicit-any -- the admin's own message schema\nexport type CommonAdminI18n = I18n<any, any, any, string, false>\n\nlet installed: CommonAdminI18n | undefined\n\n/** Takes the admin's instance (the plugin's `i18n` option); the library translates through it from then on. */\nexport const setCommonAdminI18n = (instance: CommonAdminI18n): void => {\n  installed = instance\n}\n\n/**\n * The instance the library translates through: the admin's own, once the plugin has it. Before that --\n * the library's tests and playground -- the library's instance above.\n *\n * Read when a text is translated, not when a module loads: a validator or an alert module imported\n * before the plugin is installed would otherwise keep the wrong instance for good.\n */\nexport const commonI18n = (): CommonAdminI18n => installed ?? (i18n as unknown as CommonAdminI18n)\n\ntype Translate = (key: string, ...args: unknown[]) => string\n\n/** `t` of `commonI18n()`, resolved on every call. */\nexport const commonT: Translate = (key, ...args) => (commonI18n().global.t as unknown as Translate)(key, ...args)\n\n/** `te` of `commonI18n()`, resolved on every call. */\nexport const commonTe = (key: string, locale?: string): boolean =>\n  (commonI18n().global.te as (key: string, locale?: string) => boolean)(key, locale)\n"],"mappings":";;AAMA,IAAMA,IAAmB,CAAC,MAAM,IAAI,GAyBvBC,KAA2B,GAAgB,MAClDC,MAAkB,IAChBC,MAAW,IAAU,IACrBA,MAAW,IAAU,IACrBA,KAAU,KAAKA,KAAU,IAAU,IAChC,IAELD,MAAkB,IAChBC,MAAW,IAAU,IACrBA,KAAU,KAAKA,KAAU,IAAU,IAChC,IAEFA,MAAW,IAAI,IAAI,GAGfC,IAAOC,EAA2C;CAC7D,iBAAiB;CACjB,QAAQ;CACR,QAAQL,EAAiB;CACzB,gBAAgB;CAChB,aAAa;EACX,IAAIC;EAGJ,IAAIA;CACN;CACA,UAAU,GAAgB,MAAc;EACtC,AAAID,EAAiB,SAASM,CAAM,KAAK,CAACC,EAAI,WAAW,iBAAiB,KACxE,QAAQ,KAAK,WAAWD,EAAO,gBAAgBC,GAAK;CAExD;AACF,CAAC,GAMGC,GAGSC,KAAsB,MAAoC;CACrE,IAAYC;AACd,GASaC,UAAoCH,KAAcJ,GAKlDQ,KAAsB,GAAK,GAAGC,MAAUF,EAAW,CAAC,CAAC,OAAO,EAA2BJ,GAAK,GAAGM,CAAI,GAGnGC,KAAY,GAAa,MACnCH,EAAW,CAAC,CAAC,OAAO,GAAiDJ,GAAKD,CAAM"}
+{"version":3,"file":"i18n.js","names":["REQUIRED_LOCALES","slovakPluralizationRule","choicesLength","choice","i18n","createI18n","locale","key","installed","setCommonAdminI18n","instance","commonI18n","commonT","args","commonTe"],"sources":["../../src/plugins/i18n.ts"],"sourcesContent":["import type { I18n, Locale, Path } from 'vue-i18n'\nimport { createI18n } from 'vue-i18n'\nimport type en from '@/locales/en'\n\nexport type MessageSchema = typeof en\n\nconst REQUIRED_LOCALES = ['en', 'sk']\n\n/**\n * Custom Slovak Pluralization Rule.\n *\n * Automatically detects the format of the translation string based on the number\n * of pipe-separated choices (`choicesLength`) and returns the correct index.\n *\n * Case A: 4 choices (Extended format with explicit 0 support)\n * Structure: \"0 items | 1 item | 2-4 items | 5+ items\"\n * - 0    -> Index 0\n * - 1    -> Index 1\n * - 2-4  -> Index 2\n * - 5+   -> Index 3\n *\n * Case B: 3 choices (Starndard Slovak format)\n * Structure: \"1 item | 2-4 items | 5+ items\"\n * - 1    -> Index 0\n * - 2-4  -> Index 1\n * - 5+   -> Index 2 (Includes 0)\n *\n * Case C: 2 choices or fewer (Fallback)\n * - 1    -> Index 0\n * - Other-> Index 1\n */\nexport const slovakPluralizationRule = (choice: number, choicesLength: number) => {\n  if (choicesLength === 4) {\n    if (choice === 0) return 0\n    if (choice === 1) return 1\n    if (choice >= 2 && choice <= 4) return 2\n    return 3\n  }\n  if (choicesLength === 3) {\n    if (choice === 1) return 0\n    if (choice >= 2 && choice <= 4) return 1\n    return 2\n  }\n  return choice === 1 ? 0 : 1\n}\n\nexport const i18n = createI18n<[MessageSchema], string, false>({\n  globalInjection: false,\n  legacy: false,\n  locale: REQUIRED_LOCALES[0],\n  fallbackLocale: false,\n  pluralRules: {\n    sk: slovakPluralizationRule,\n    // Czech shares the Slovak plural categories (one / 2-4 / other), and without\n    // a rule the default would pick zero|one|other: \"1 nepotvrzené změny\".\n    cs: slovakPluralizationRule,\n  },\n  missing: (locale: Locale, key: Path) => {\n    if (REQUIRED_LOCALES.includes(locale) && !key.startsWith('system.subject.')) {\n      console.warn(`Missing ${locale} translation: ${key}`)\n    }\n  },\n})\n\n/** The admin's instance as the plugin takes it: composition mode (`legacy: false`), any message schema. */\n// oxlint-disable-next-line typescript/no-explicit-any -- the admin's own message schema\nexport type CommonAdminI18n = I18n<any, any, any, string, false>\n\nlet installed: CommonAdminI18n | undefined\n\n/** Takes the admin's instance (the plugin's `i18n` option); the library translates through it from then on. */\nexport const setCommonAdminI18n = (instance: CommonAdminI18n): void => {\n  installed = instance\n}\n\n/**\n * The instance the library translates through: the admin's own once\n * the plugin has it, otherwise the library's (tests and playground).\n * Read at translation time, not at module load. A module imported before\n * the plugin is installed would otherwise keep the wrong instance.\n */\nexport const commonI18n = (): CommonAdminI18n => installed ?? (i18n as unknown as CommonAdminI18n)\n\ntype Translate = (key: string, ...args: unknown[]) => string\n\n/** `t` of `commonI18n()`, resolved on every call. */\nexport const commonT: Translate = (key, ...args) => (commonI18n().global.t as unknown as Translate)(key, ...args)\n\n/** `te` of `commonI18n()`, resolved on every call. */\nexport const commonTe = (key: string, locale?: string): boolean =>\n  (commonI18n().global.te as (key: string, locale?: string) => boolean)(key, locale)\n"],"mappings":";;AAMA,IAAMA,IAAmB,CAAC,MAAM,IAAI,GAyBvBC,KAA2B,GAAgB,MAClDC,MAAkB,IAChBC,MAAW,IAAU,IACrBA,MAAW,IAAU,IACrBA,KAAU,KAAKA,KAAU,IAAU,IAChC,IAELD,MAAkB,IAChBC,MAAW,IAAU,IACrBA,KAAU,KAAKA,KAAU,IAAU,IAChC,IAEFA,MAAW,IAAI,IAAI,GAGfC,IAAOC,EAA2C;CAC7D,iBAAiB;CACjB,QAAQ;CACR,QAAQL,EAAiB;CACzB,gBAAgB;CAChB,aAAa;EACX,IAAIC;EAGJ,IAAIA;CACN;CACA,UAAU,GAAgB,MAAc;EACtC,AAAID,EAAiB,SAASM,CAAM,KAAK,CAACC,EAAI,WAAW,iBAAiB,KACxE,QAAQ,KAAK,WAAWD,EAAO,gBAAgBC,GAAK;CAExD;AACF,CAAC,GAMGC,GAGSC,KAAsB,MAAoC;CACrE,IAAYC;AACd,GAQaC,UAAoCH,KAAcJ,GAKlDQ,KAAsB,GAAK,GAAGC,MAAUF,EAAW,CAAC,CAAC,OAAO,EAA2BJ,GAAK,GAAGM,CAAI,GAGnGC,KAAY,GAAa,MACnCH,EAAW,CAAC,CAAC,OAAO,GAAiDJ,GAAKD,CAAM"}

package/dist/plugins/pluginOptions.d.ts

@@ -34,12 +34,14 @@ export declare const coreDamOptions: import('vue').Ref<{
 export declare const collabOptions: import('vue').Ref<{
     enabled: boolean;
     socketUrl: string;
-    beforeReconnect: () => Promise<void>;
+    beforeReconnect: () => Promise<void | import('../lib').CollabReconnectVerdictType>;
+    isSameIdentity?: (() => boolean | undefined) | undefined;
     io: typeof import('socket.io-client').io | undefined;
 }, CommonAdminCollabOptions | {
     enabled: boolean;
     socketUrl: string;
-    beforeReconnect: () => Promise<void>;
+    beforeReconnect: () => Promise<void | import('../lib').CollabReconnectVerdictType>;
+    isSameIdentity?: (() => boolean | undefined) | undefined;
     io: typeof import('socket.io-client').io | undefined;
 }>;
 export declare function initCommonAdminImageOptions(data: CommonAdminImageOptions): void;

package/dist/plugins/pluginOptions.js

@@ -1,6 +1,6 @@
 import { isUndefined as e } from "../shared/utils/common.js";
 import { ref as t } from "vue";
-//#region src/plugins/pluginOptions.ts
+// src/plugins/pluginOptions.ts
 var n = t(void 0), r = t(void 0), i = t({
 	enabled: !1,
 	socketUrl: "",
@@ -16,7 +16,6 @@ function o(e) {
 function s(t) {
 	e(t) || (i.value = t);
 }
-//#endregion
 export { i as collabOptions, r as coreDamOptions, n as imageOptions, s as initCommonAdminCollabOptions, o as initCommonAdminCoreDamOptions, a as initCommonAdminImageOptions };
 
 //# sourceMappingURL=pluginOptions.js.map

package/dist/plugins/pluginOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"pluginOptions.js","names":["imageOptions","ref","coreDamOptions","collabOptions","resolve","initCommonAdminImageOptions","data","initCommonAdminCoreDamOptions","initCommonAdminCollabOptions","isUndefined"],"sources":["../../src/plugins/pluginOptions.ts"],"sourcesContent":["import { ref } from 'vue'\nimport type {\n  CommonAdminCollabOptions,\n  CommonAdminCoreDamOptions,\n  CommonAdminImageOptions,\n} from '@/AnzuSystemsCommonAdmin'\nimport { isUndefined } from '@/shared/utils/common'\n\n// What the plugin was installed with. It lives here, beside the plugin, so that installing it does\n// not load the DAM, image and collab modules that read it: they import from here, not the reverse.\n\nexport const imageOptions = ref<CommonAdminImageOptions>(undefined)\n\nexport const coreDamOptions = ref<CommonAdminCoreDamOptions | undefined>(undefined)\n\nexport const collabOptions = ref<CommonAdminCollabOptions>({\n  enabled: false,\n  socketUrl: '',\n  beforeReconnect: () => new Promise((resolve) => resolve()),\n  io: undefined,\n})\n\nexport function initCommonAdminImageOptions(data: CommonAdminImageOptions) {\n  imageOptions.value = data\n}\n\nexport function initCommonAdminCoreDamOptions(data: CommonAdminCoreDamOptions) {\n  coreDamOptions.value = data\n}\n\nexport function initCommonAdminCollabOptions(data: CommonAdminCollabOptions | undefined) {\n  if (isUndefined(data)) return\n  collabOptions.value = data\n}\n"],"mappings":";;;AAWA,IAAaA,IAAeC,EAA6B,KAAA,CAAS,GAErDC,IAAiBD,EAA2C,KAAA,CAAS,GAErEE,IAAgBF,EAA8B;CACzD,SAAS;CACT,WAAW;CACX,uBAAuB,IAAI,SAAS,MAAYG,EAAQ,CAAC;CACzD,IAAI,KAAA;AACN,CAAC;AAED,SAAgBC,EAA4B,GAA+B;CACzE,EAAa,QAAQC;AACvB;AAEA,SAAgBC,EAA8B,GAAiC;CAC7E,EAAe,QAAQD;AACzB;AAEA,SAAgBE,EAA6B,GAA4C;CACvF,AAAIC,EAAYH,CAAI,MACpB,EAAc,QAAQA;AACxB"}
+{"version":3,"file":"pluginOptions.js","names":["imageOptions","ref","coreDamOptions","collabOptions","resolve","initCommonAdminImageOptions","data","initCommonAdminCoreDamOptions","initCommonAdminCollabOptions","isUndefined"],"sources":["../../src/plugins/pluginOptions.ts"],"sourcesContent":["import { ref } from 'vue'\nimport type {\n  CommonAdminCollabOptions,\n  CommonAdminCoreDamOptions,\n  CommonAdminImageOptions,\n} from '@/AnzuSystemsCommonAdmin'\nimport { isUndefined } from '@/shared/utils/common'\n\n// Plugin install options. They live here so installing the plugin\n// does not load the DAM, image and collab modules that read them.\n\nexport const imageOptions = ref<CommonAdminImageOptions>(undefined)\n\nexport const coreDamOptions = ref<CommonAdminCoreDamOptions | undefined>(undefined)\n\nexport const collabOptions = ref<CommonAdminCollabOptions>({\n  enabled: false,\n  socketUrl: '',\n  beforeReconnect: () => new Promise((resolve) => resolve()),\n  io: undefined,\n})\n\nexport function initCommonAdminImageOptions(data: CommonAdminImageOptions) {\n  imageOptions.value = data\n}\n\nexport function initCommonAdminCoreDamOptions(data: CommonAdminCoreDamOptions) {\n  coreDamOptions.value = data\n}\n\nexport function initCommonAdminCollabOptions(data: CommonAdminCollabOptions | undefined) {\n  if (isUndefined(data)) return\n  collabOptions.value = data\n}\n"],"mappings":";;;AAWA,IAAaA,IAAeC,EAA6B,KAAA,CAAS,GAErDC,IAAiBD,EAA2C,KAAA,CAAS,GAErEE,IAAgBF,EAA8B;CACzD,SAAS;CACT,WAAW;CACX,uBAAuB,IAAI,SAAS,MAAYG,EAAQ,CAAC;CACzD,IAAI,KAAA;AACN,CAAC;AAED,SAAgBC,EAA4B,GAA+B;CACzE,EAAa,QAAQC;AACvB;AAEA,SAAgBC,EAA8B,GAAiC;CAC7E,EAAe,QAAQD;AACzB;AAEA,SAAgBE,EAA6B,GAA4C;CACvF,AAAIC,EAAYH,CAAI,MACpB,EAAc,QAAQA;AACxB"}

package/dist/plugins/webfontloader.js

@@ -5,7 +5,6 @@ async function e() {
 	let t = document.createElement("link");
 	t.rel = "stylesheet", t.href = "https://fonts.googleapis.com/css2?family=Roboto:wght@100;300;400;500;700;900&display=swap", t.dataset.anzuCommonFonts = "", document.head.append(e, t);
 }
-//#endregion
 export { e as loadCommonFonts };
 
 //# sourceMappingURL=webfontloader.js.map

package/dist/plugins/webfontloader.js.map

@@ -1 +1 @@
-{"version":3,"file":"webfontloader.js","names":["loadCommonFonts","preconnect","link"],"sources":["../../src/plugins/webfontloader.ts"],"sourcesContent":["// The weights the webfontloader call asked for, straight from Google Fonts (webfontloader has had no\n// release since 2017 and injected the same stylesheet).\nconst FONTS_HREF = 'https://fonts.googleapis.com/css2?family=Roboto:wght@100;300;400;500;700;900&display=swap'\n\nexport async function loadCommonFonts(): Promise<void> {\n  if (typeof document === 'undefined' || document.querySelector('link[data-anzu-common-fonts]')) return\n  const preconnect = document.createElement('link')\n  preconnect.rel = 'preconnect'\n  preconnect.href = 'https://fonts.gstatic.com'\n  preconnect.crossOrigin = ''\n  const link = document.createElement('link')\n  link.rel = 'stylesheet'\n  link.href = FONTS_HREF\n  link.dataset.anzuCommonFonts = ''\n  document.head.append(preconnect, link)\n}\n"],"mappings":"AAIA,eAAsBA,IAAiC;CACrD,IAAI,OAAO,WAAa,OAAe,SAAS,cAAc,8BAA8B,GAAG;CAC/F,IAAMC,IAAa,SAAS,cAAc,MAAM;CAGhD,AAFA,EAAW,MAAM,cACjB,EAAW,OAAO,6BAClB,EAAW,cAAc;CACzB,IAAMC,IAAO,SAAS,cAAc,MAAM;CAI1C,AAHA,EAAK,MAAM,cACX,EAAK,OAAO,6FACZ,EAAK,QAAQ,kBAAkB,IAC/B,SAAS,KAAK,OAAOD,GAAYC,CAAI;AACvC"}
+{"version":3,"file":"webfontloader.js","names":["loadCommonFonts","preconnect","link"],"sources":["../../src/plugins/webfontloader.ts"],"sourcesContent":["// The weights the old webfontloader call requested, loaded straight from Google Fonts.\n// webfontloader has had no release since 2017 and injected the same stylesheet.\nconst FONTS_HREF = 'https://fonts.googleapis.com/css2?family=Roboto:wght@100;300;400;500;700;900&display=swap'\n\nexport async function loadCommonFonts(): Promise<void> {\n  if (typeof document === 'undefined' || document.querySelector('link[data-anzu-common-fonts]')) return\n  const preconnect = document.createElement('link')\n  preconnect.rel = 'preconnect'\n  preconnect.href = 'https://fonts.gstatic.com'\n  preconnect.crossOrigin = ''\n  const link = document.createElement('link')\n  link.rel = 'stylesheet'\n  link.href = FONTS_HREF\n  link.dataset.anzuCommonFonts = ''\n  document.head.append(preconnect, link)\n}\n"],"mappings":"AAIA,eAAsBA,IAAiC;CACrD,IAAI,OAAO,WAAa,OAAe,SAAS,cAAc,8BAA8B,GAAG;CAC/F,IAAMC,IAAa,SAAS,cAAc,MAAM;CAGhD,AAFA,EAAW,MAAM,cACjB,EAAW,OAAO,6BAClB,EAAW,cAAc;CACzB,IAAMC,IAAO,SAAS,cAAc,MAAM;CAI1C,AAHA,EAAK,MAAM,cACX,EAAK,OAAO,6FACZ,EAAK,QAAQ,kBAAkB,IAC/B,SAAS,KAAK,OAAOD,GAAYC,CAAI;AACvC"}

package/dist/shared/commonConfig.js

@@ -6,7 +6,6 @@ var t = e({ CHIP: {
 		LINK_EXTERNAL: "mdi-open-in-new"
 	}
 } });
-//#endregion
 export { t as COMMON_CONFIG };
 
 //# sourceMappingURL=commonConfig.js.map

package/dist/shared/error/AnzuApiAxiosError.js

@@ -1,11 +1,10 @@
 import { AnzuError as e } from "./AnzuError.js";
-//#region src/shared/error/AnzuApiAxiosError.ts
+// src/shared/error/AnzuApiAxiosError.ts
 var t = (e) => e instanceof n, n = class extends e {
 	constructor(e) {
 		super("API request failed"), this.name = "AnzuApiAxiosError", this.cause = e;
 	}
 };
-//#endregion
 export { n as AnzuApiAxiosError, t as isAnzuApiAxiosError };
 
 //# sourceMappingURL=AnzuApiAxiosError.js.map

package/dist/shared/error/AnzuApiCancelledError.d.ts

@@ -1,17 +1,14 @@
 import { AnzuError } from './AnzuError';
 export declare const isAnzuApiCancelledError: (error: unknown) => error is AnzuApiCancelledError;
 /**
- * A request the caller stopped, told apart from a request that failed.
- *
- * Axios reports it as a `CanceledError` -- an axios error carrying `code: 'ERR_CANCELED'`, not the
- * `DOMException` an `AbortController`-shaped check would look for, which is why such a check never
- * fires.
+ * A request the caller stopped, as opposed to one that failed.
+ * Axios reports it as a `CanceledError` with `code: 'ERR_CANCELED'`, not
+ * as a `DOMException`. An `AbortController`-style check never fires.
  */
 export declare const axiosErrorIsCancelled: (error: unknown) => boolean;
 /**
- * A stopped request is an ordinary outcome -- another keystroke in an autocomplete, a route change
- * while a list is loading -- so it needs a class of its own. Reported as a transport failure it
- * would raise an error at the user for something the user did.
+ * A stopped request is a normal outcome, such as another autocomplete keystroke or a route change during loading.
+ * Reported as a transport failure, it would show the user an error for their own action.
  */
 export declare class AnzuApiCancelledError extends AnzuError {
     constructor(cause?: unknown);

package/dist/shared/error/AnzuApiCancelledError.js

@@ -1,12 +1,11 @@
 import { AnzuError as e } from "./AnzuError.js";
 import t from "axios";
-//#region src/shared/error/AnzuApiCancelledError.ts
+// src/shared/error/AnzuApiCancelledError.ts
 var n = (e) => e instanceof i, r = (e) => t.isCancel(e) || t.isAxiosError(e) && e.code === "ERR_CANCELED", i = class extends e {
 	constructor(e = void 0) {
 		super("API request was cancelled", e), this.name = "AnzuApiCancelledError";
 	}
 };
-//#endregion
 export { i as AnzuApiCancelledError, r as axiosErrorIsCancelled, n as isAnzuApiCancelledError };
 
 //# sourceMappingURL=AnzuApiCancelledError.js.map

package/dist/shared/error/AnzuApiCancelledError.js.map

@@ -1 +1 @@
-{"version":3,"file":"AnzuApiCancelledError.js","names":["axios","isAnzuApiCancelledError","error","AnzuApiCancelledError","axiosErrorIsCancelled","AnzuError","cause"],"sources":["../../../src/shared/error/AnzuApiCancelledError.ts"],"sourcesContent":["import axios from 'axios'\nimport { AnzuError } from '@/shared/error/AnzuError'\n\nexport const isAnzuApiCancelledError = (error: unknown): error is AnzuApiCancelledError => {\n  return error instanceof AnzuApiCancelledError\n}\n\n/**\n * A request the caller stopped, told apart from a request that failed.\n *\n * Axios reports it as a `CanceledError` -- an axios error carrying `code: 'ERR_CANCELED'`, not the\n * `DOMException` an `AbortController`-shaped check would look for, which is why such a check never\n * fires.\n */\nexport const axiosErrorIsCancelled = (error: unknown) =>\n  // Both, because they answer for different things. `isCancel` reads an internal marker axios puts\n  // on the error it constructs; the code check catches a cancellation that arrived as a plain\n  // object -- rebuilt across a boundary, or handed over by a test.\n  axios.isCancel(error) || (axios.isAxiosError(error) && error.code === 'ERR_CANCELED')\n\n/**\n * A stopped request is an ordinary outcome -- another keystroke in an autocomplete, a route change\n * while a list is loading -- so it needs a class of its own. Reported as a transport failure it\n * would raise an error at the user for something the user did.\n */\nexport class AnzuApiCancelledError extends AnzuError {\n  constructor(cause: unknown = undefined) {\n    super('API request was cancelled', cause)\n    this.name = 'AnzuApiCancelledError'\n  }\n}\n"],"mappings":";;;AAGA,IAAaC,KAA2B,MAC/BC,aAAiBC,GAUbC,KAAyB,MAIpCJ,EAAM,SAASE,CAAK,KAAMF,EAAM,aAAaE,CAAK,KAAKA,EAAM,SAAS,gBAO3DC,IAAb,cAA2CE,EAAU;CACnD,YAAY,IAAiB,KAAA,GAAW;EAEtC,AADA,MAAM,6BAA6BC,CAAK,GACxC,KAAK,OAAO;CACd;AACF"}
+{"version":3,"file":"AnzuApiCancelledError.js","names":["axios","isAnzuApiCancelledError","error","AnzuApiCancelledError","axiosErrorIsCancelled","AnzuError","cause"],"sources":["../../../src/shared/error/AnzuApiCancelledError.ts"],"sourcesContent":["import axios from 'axios'\nimport { AnzuError } from '@/shared/error/AnzuError'\n\nexport const isAnzuApiCancelledError = (error: unknown): error is AnzuApiCancelledError => {\n  return error instanceof AnzuApiCancelledError\n}\n\n/**\n * A request the caller stopped, as opposed to one that failed.\n * Axios reports it as a `CanceledError` with `code: 'ERR_CANCELED'`, not\n * as a `DOMException`. An `AbortController`-style check never fires.\n */\nexport const axiosErrorIsCancelled = (error: unknown) =>\n  // Both checks are needed. `isCancel` reads an internal marker on errors axios constructs.\n  // The code check catches a cancellation that arrives as a plain\n  // object, rebuilt across a boundary or passed in by a test.\n  axios.isCancel(error) || (axios.isAxiosError(error) && error.code === 'ERR_CANCELED')\n\n/**\n * A stopped request is a normal outcome, such as another autocomplete keystroke or a route change during loading.\n * Reported as a transport failure, it would show the user an error for their own action.\n */\nexport class AnzuApiCancelledError extends AnzuError {\n  constructor(cause: unknown = undefined) {\n    super('API request was cancelled', cause)\n    this.name = 'AnzuApiCancelledError'\n  }\n}\n"],"mappings":";;;AAGA,IAAaC,KAA2B,MAC/BC,aAAiBC,GAQbC,KAAyB,MAIpCJ,EAAM,SAASE,CAAK,KAAMF,EAAM,aAAaE,CAAK,KAAKA,EAAM,SAAS,gBAM3DC,IAAb,cAA2CE,EAAU;CACnD,YAAY,IAAiB,KAAA,GAAW;EAEtC,AADA,MAAM,6BAA6BC,CAAK,GACxC,KAAK,OAAO;CACd;AACF"}

package/dist/shared/error/AnzuApiDependencyExistsError.js

@@ -1,7 +1,7 @@
 import { AnzuError as e } from "./AnzuError.js";
 import "../statusCodes.js";
 import t from "axios";
-//#region src/shared/error/AnzuApiDependencyExistsError.ts
+// src/shared/error/AnzuApiDependencyExistsError.ts
 var n = "dependency_exists_error", r = (e) => t.isAxiosError(e) && e.response?.status === 422 && e.response.data?.error === n && e.response.data?.dependencies, i = (e) => e instanceof o;
 function a(e) {
 	return (e.response?.data).dependencies;
@@ -12,7 +12,6 @@ var o = class extends e {
 		super(i), this.name = "AnzuApiDependencyExistsError", this.cause = r, this.message = i, this.dependencies = a(e);
 	}
 };
-//#endregion
 export { o as AnzuApiDependencyExistsError, r as axiosErrorResponseHasDependencyExistsData, i as isAnzuApiDependencyExistsError };
 
 //# sourceMappingURL=AnzuApiDependencyExistsError.js.map

package/dist/shared/error/AnzuApiForbiddenError.js

@@ -1,13 +1,12 @@
 import { AnzuError as e } from "./AnzuError.js";
 import "../statusCodes.js";
 import t from "axios";
-//#region src/shared/error/AnzuApiForbiddenError.ts
+// src/shared/error/AnzuApiForbiddenError.ts
 var n = (e) => t.isAxiosError(e) && e.response?.status === 403, r = (e) => e instanceof i, i = class extends e {
 	constructor(e, t = "") {
 		super(t), this.name = "AnzuApiForbiddenError", this.cause = e, this.message = t;
 	}
 };
-//#endregion
 export { i as AnzuApiForbiddenError, n as axiosErrorResponseIsForbidden, r as isAnzuApiForbiddenError };
 
 //# sourceMappingURL=AnzuApiForbiddenError.js.map

package/dist/shared/error/AnzuApiForbiddenOperationError.js

@@ -1,7 +1,7 @@
 import { AnzuError as e } from "./AnzuError.js";
 import "../statusCodes.js";
 import t from "axios";
-//#region src/shared/error/AnzuApiForbiddenOperationError.ts
+// src/shared/error/AnzuApiForbiddenOperationError.ts
 var n = "forbidden_operation_error", r = (e) => t.isAxiosError(e) && e.response?.status === 422 && e.response.data?.error === n && e.response.data?.detail, i = (e) => e instanceof o;
 function a(e) {
 	return (e.response?.data).detail;
@@ -12,7 +12,6 @@ var o = class extends e {
 		super(n), this.name = "AnzuApiForbiddenOperationError", this.cause = t, this.message = n, this.detail = a(e);
 	}
 };
-//#endregion
 export { o as AnzuApiForbiddenOperationError, r as axiosErrorResponseHasForbiddenOperationData, i as isAnzuApiForbiddenOperationError };
 
 //# sourceMappingURL=AnzuApiForbiddenOperationError.js.map

package/dist/shared/error/AnzuApiResponseCodeError.js

@@ -1,5 +1,5 @@
 import { AnzuError as e } from "./AnzuError.js";
-//#region src/shared/error/AnzuApiResponseCodeError.ts
+// src/shared/error/AnzuApiResponseCodeError.ts
 var t = (e) => e instanceof n, n = class extends e {
 	code;
 	constructor(e, t, n) {
@@ -7,7 +7,6 @@ var t = (e) => e instanceof n, n = class extends e {
 		super(r), this.name = "AnzuApiResponseCodeError", this.cause = t, this.code = e;
 	}
 };
-//#endregion
 export { n as AnzuApiResponseCodeError, t as isAnzuApiResponseCodeError };
 
 //# sourceMappingURL=AnzuApiResponseCodeError.js.map

package/dist/shared/error/AnzuApiTimeoutError.js

@@ -1,12 +1,11 @@
 import { AnzuError as e } from "./AnzuError.js";
 import t from "axios";
-//#region src/shared/error/AnzuApiTimeoutError.ts
+// src/shared/error/AnzuApiTimeoutError.ts
 var n = (e) => e instanceof i, r = (e) => t.isAxiosError(e) && (e.code === "ECONNABORTED" || e.message.includes("timeout") || e.cause instanceof Error && e.cause.message.includes("timeout")), i = class extends e {
 	constructor(e = void 0) {
 		super("API request timed out"), this.name = "AnzuApiTimeoutError", this.cause = e;
 	}
 };
-//#endregion
 export { i as AnzuApiTimeoutError, r as axiosErrorIsTimeout, n as isAnzuApiTimeoutError };
 
 //# sourceMappingURL=AnzuApiTimeoutError.js.map

package/dist/shared/error/AnzuApiValidationError.js

@@ -1,7 +1,7 @@
 import { AnzuError as e } from "./AnzuError.js";
 import "../statusCodes.js";
 import t from "axios";
-//#region src/shared/error/AnzuApiValidationError.ts
+// src/shared/error/AnzuApiValidationError.ts
 var n = "validation_failed", r = (e) => t.isAxiosError(e) && e.response?.status === 422 && e.response.data?.error === n && e.response.data?.fields, i = (e) => e instanceof s, a = (e, t, n) => e.fields.some((e) => e.field === n && e.errors.includes(t));
 function o(e, t, n) {
 	let r = e.response?.data, i = [];
@@ -18,7 +18,6 @@ var s = class extends e {
 		super(s), this.name = "AnzuApiValidationError", this.cause = r, this.message = s, this.fields = a;
 	}
 };
-//#endregion
 export { s as AnzuApiValidationError, r as axiosErrorResponseHasValidationData, a as hasAnzuApiValidationErrorSpecific, i as isAnzuApiValidationError };
 
 //# sourceMappingURL=AnzuApiValidationError.js.map

package/dist/shared/error/AnzuError.d.ts

@@ -1,10 +1,8 @@
 export declare const isAnzuError: (error: unknown) => error is AnzuError;
 /**
- * The base every Anzu error extends.
- *
- * It exists so the api helpers can ask "has this already been mapped?" without testing the error's
- * name: a string prefix answers true for anyone else's class called `Anzu…`, and answers false the
- * moment a class forgets to set `name`. One `instanceof` says exactly what is meant.
+ * Base class of every Anzu error.
+ * The api helpers use `instanceof` to check whether an error is already mapped. A name
+ * prefix check matches foreign `Anzu…` classes and misses classes that do not set `name`.
  */
 export declare class AnzuError extends Error {
     constructor(message: string, cause?: unknown);

package/dist/shared/error/AnzuError.js

@@ -1,10 +1,9 @@
-//#region src/shared/error/AnzuError.ts
+// src/shared/error/AnzuError.ts
 var e = (e) => e instanceof t, t = class extends Error {
 	constructor(e, t = void 0) {
 		super(e), this.name = "AnzuError", this.cause = t;
 	}
 };
-//#endregion
 export { t as AnzuError, e as isAnzuError };
 
 //# sourceMappingURL=AnzuError.js.map

package/dist/shared/error/AnzuError.js.map

@@ -1 +1 @@
-{"version":3,"file":"AnzuError.js","names":["isAnzuError","error","AnzuError","message","cause"],"sources":["../../../src/shared/error/AnzuError.ts"],"sourcesContent":["export const isAnzuError = (error: unknown): error is AnzuError => {\n  return error instanceof AnzuError\n}\n\n/**\n * The base every Anzu error extends.\n *\n * It exists so the api helpers can ask \"has this already been mapped?\" without testing the error's\n * name: a string prefix answers true for anyone else's class called `Anzu…`, and answers false the\n * moment a class forgets to set `name`. One `instanceof` says exactly what is meant.\n */\nexport class AnzuError extends Error {\n  constructor(message: string, cause: unknown = undefined) {\n    super(message)\n    this.name = 'AnzuError'\n    this.cause = cause\n  }\n}\n"],"mappings":";AAAA,IAAaA,KAAe,MACnBC,aAAiBC,GAUbA,IAAb,cAA+B,MAAM;CACnC,YAAY,GAAiB,IAAiB,KAAA,GAAW;EAGvD,AAFA,MAAMC,CAAO,GACb,KAAK,OAAO,aACZ,KAAK,QAAQC;CACf;AACF"}
+{"version":3,"file":"AnzuError.js","names":["isAnzuError","error","AnzuError","message","cause"],"sources":["../../../src/shared/error/AnzuError.ts"],"sourcesContent":["export const isAnzuError = (error: unknown): error is AnzuError => {\n  return error instanceof AnzuError\n}\n\n/**\n * Base class of every Anzu error.\n * The api helpers use `instanceof` to check whether an error is already mapped. A name\n * prefix check matches foreign `Anzu…` classes and misses classes that do not set `name`.\n */\nexport class AnzuError extends Error {\n  constructor(message: string, cause: unknown = undefined) {\n    super(message)\n    this.name = 'AnzuError'\n    this.cause = cause\n  }\n}\n"],"mappings":";AAAA,IAAaA,KAAe,MACnBC,aAAiBC,GAQbA,IAAb,cAA+B,MAAM;CACnC,YAAY,GAAiB,IAAiB,KAAA,GAAW;EAGvD,AAFA,MAAMC,CAAO,GACb,KAAK,OAAO,aACZ,KAAK,QAAQC;CACf;AACF"}

package/dist/shared/error/AnzuFatalError.js

@@ -1,12 +1,11 @@
 import { AnzuError as e } from "./AnzuError.js";
-//#region src/shared/error/AnzuFatalError.ts
+// src/shared/error/AnzuFatalError.ts
 var t = (e) => e instanceof n, n = class extends e {
 	constructor(e, t = "") {
 		let n = t || "Unexpected error";
 		super(n), this.name = "AnzuFatalError", this.cause = e, this.message = n;
 	}
 };
-//#endregion
 export { n as AnzuFatalError, t as isAnzuFatalError };
 
 //# sourceMappingURL=AnzuFatalError.js.map

package/dist/shared/error/AnzuNewVersionFetchError.js

@@ -1,12 +1,11 @@
 import { AnzuError as e } from "./AnzuError.js";
-//#region src/shared/error/AnzuNewVersionFetchError.ts
+// src/shared/error/AnzuNewVersionFetchError.ts
 var t = (e) => e instanceof n, n = class extends e {
 	originalError;
 	constructor(e = "", t = null) {
 		super(e), this.name = "AnzuNewVersionFetchError", this.message = e, this.originalError = t;
 	}
 };
-//#endregion
 export { n as AnzuNewVersionFetchError, t as isAnzuNewVersionFetchError };
 
 //# sourceMappingURL=AnzuNewVersionFetchError.js.map

package/dist/shared/error/AuthUnavailableError.d.ts

@@ -1,7 +1,7 @@
 /**
- * The auth backend could not answer the refresh (403, 5xx, timeout, network), as opposed to "the
- * session is gone". A request stopped by it rejects with this, so a caller can tell it from a 403 of
- * the request itself -- anywhere in the `.cause` chain, since the api helpers wrap what they catch.
+ * The auth backend could not answer the refresh (403, 5xx, timeout, network). This differs from an expired session.
+ * A request stopped by it rejects with this error, so a caller can tell it from a 403 of the request itself.
+ * Check the whole `.cause` chain, because the api helpers wrap what they catch.
  */
 export declare class AuthUnavailableError extends Error {
     constructor(cause: unknown);

package/dist/shared/error/AuthUnavailableError.js

@@ -1,10 +1,9 @@
-//#region src/shared/error/AuthUnavailableError.ts
+// src/shared/error/AuthUnavailableError.ts
 var e = class extends Error {
 	constructor(e) {
 		super("Auth backend unavailable", { cause: e }), this.name = "AuthUnavailableError";
 	}
 };
-//#endregion
 export { e as AuthUnavailableError };
 
 //# sourceMappingURL=AuthUnavailableError.js.map

package/dist/shared/error/AuthUnavailableError.js.map

@@ -1 +1 @@
-{"version":3,"file":"AuthUnavailableError.js","names":["AuthUnavailableError"],"sources":["../../../src/shared/error/AuthUnavailableError.ts"],"sourcesContent":["/**\n * The auth backend could not answer the refresh (403, 5xx, timeout, network), as opposed to \"the\n * session is gone\". A request stopped by it rejects with this, so a caller can tell it from a 403 of\n * the request itself -- anywhere in the `.cause` chain, since the api helpers wrap what they catch.\n */\nexport class AuthUnavailableError extends Error {\n  constructor(cause: unknown) {\n    super('Auth backend unavailable', { cause })\n    this.name = 'AuthUnavailableError'\n  }\n}\n"],"mappings":";AAKA,IAAaA,IAAb,cAA0C,MAAM;CAC9C,YAAY,GAAgB;EAE1B,AADA,MAAM,4BAA4B,EAAE,SAAM,CAAC,GAC3C,KAAK,OAAO;CACd;AACF"}
+{"version":3,"file":"AuthUnavailableError.js","names":["AuthUnavailableError"],"sources":["../../../src/shared/error/AuthUnavailableError.ts"],"sourcesContent":["/**\n * The auth backend could not answer the refresh (403, 5xx, timeout, network). This differs from an expired session.\n * A request stopped by it rejects with this error, so a caller can tell it from a 403 of the request itself.\n * Check the whole `.cause` chain, because the api helpers wrap what they catch.\n */\nexport class AuthUnavailableError extends Error {\n  constructor(cause: unknown) {\n    super('Auth backend unavailable', { cause })\n    this.name = 'AuthUnavailableError'\n  }\n}\n"],"mappings":";AAKA,IAAaA,IAAb,cAA0C,MAAM;CAC9C,YAAY,GAAgB;EAE1B,AADA,MAAM,4BAA4B,EAAE,SAAM,CAAC,GAC3C,KAAK,OAAO;CACd;AACF"}

package/dist/shared/error/SessionExpiredError.js

@@ -1,10 +1,9 @@
-//#region src/shared/error/SessionExpiredError.ts
+// src/shared/error/SessionExpiredError.ts
 var e = class extends Error {
 	constructor() {
 		super("Session expired"), this.name = "SessionExpiredError";
 	}
 };
-//#endregion
 export { e as SessionExpiredError };
 
 //# sourceMappingURL=SessionExpiredError.js.map

package/dist/shared/error/isInCauseChain.d.ts

@@ -1,5 +1,5 @@
 /**
- * Walks an error's `.cause` chain (tolerant: a cause is not always an `Error`, and a chain could loop)
- * and answers whether any value in it matches.
+ * Checks whether any value in an error's `.cause` chain matches.
+ * A cause is not always an `Error`, and a chain can loop.
  */
 export declare const isInCauseChain: (error: unknown, predicate: (value: unknown) => boolean) => boolean;

package/dist/shared/error/isInCauseChain.js

@@ -1,5 +1,5 @@
 import { isDefined as e, isNull as t } from "../utils/common.js";
-//#region src/shared/error/isInCauseChain.ts
+// src/shared/error/isInCauseChain.ts
 var n = (n, r) => {
 	let i = /* @__PURE__ */ new Set(), a = n;
 	for (; e(a) && !t(a) && !i.has(a);) {
@@ -8,7 +8,6 @@ var n = (n, r) => {
 	}
 	return !1;
 };
-//#endregion
 export { n as isInCauseChain };
 
 //# sourceMappingURL=isInCauseChain.js.map

package/dist/shared/error/isInCauseChain.js.map

@@ -1 +1 @@
-{"version":3,"file":"isInCauseChain.js","names":["isInCauseChain","seen","current","error","isDefined","isNull","predicate"],"sources":["../../../src/shared/error/isInCauseChain.ts"],"sourcesContent":["import { isDefined, isNull } from '@/shared/utils/common'\n\n/**\n * Walks an error's `.cause` chain (tolerant: a cause is not always an `Error`, and a chain could loop)\n * and answers whether any value in it matches.\n */\nexport const isInCauseChain = (error: unknown, predicate: (value: unknown) => boolean): boolean => {\n  const seen = new Set<unknown>()\n  let current: unknown = error\n  while (isDefined(current) && !isNull(current) && !seen.has(current)) {\n    seen.add(current)\n    if (predicate(current)) return true\n    current = (current as { cause?: unknown }).cause\n  }\n  return false\n}\n"],"mappings":";;AAMA,IAAaA,KAAkB,GAAgB,MAAoD;CACjG,IAAMC,oBAAO,IAAI,IAAa,GAC1BC,IAAmBC;CACvB,OAAOC,EAAUF,CAAO,KAAK,CAACG,EAAOH,CAAO,KAAK,CAACD,EAAK,IAAIC,CAAO,IAAG;EAEnE,IADAD,EAAK,IAAIC,CAAO,GACZI,EAAUJ,CAAO,GAAG,OAAO;EAC/B,IAAWA,EAAgC;CAC7C;CACA,OAAO;AACT"}
+{"version":3,"file":"isInCauseChain.js","names":["isInCauseChain","seen","current","error","isDefined","isNull","predicate"],"sources":["../../../src/shared/error/isInCauseChain.ts"],"sourcesContent":["import { isDefined, isNull } from '@/shared/utils/common'\n\n/**\n * Checks whether any value in an error's `.cause` chain matches.\n * A cause is not always an `Error`, and a chain can loop.\n */\nexport const isInCauseChain = (error: unknown, predicate: (value: unknown) => boolean): boolean => {\n  const seen = new Set<unknown>()\n  let current: unknown = error\n  while (isDefined(current) && !isNull(current) && !seen.has(current)) {\n    seen.add(current)\n    if (predicate(current)) return true\n    current = (current as { cause?: unknown }).cause\n  }\n  return false\n}\n"],"mappings":";;AAMA,IAAaA,KAAkB,GAAgB,MAAoD;CACjG,IAAMC,oBAAO,IAAI,IAAa,GAC1BC,IAAmBC;CACvB,OAAOC,EAAUF,CAAO,KAAK,CAACG,EAAOH,CAAO,KAAK,CAACD,EAAK,IAAIC,CAAO,IAAG;EAEnE,IADAD,EAAK,IAAIC,CAAO,GACZI,EAAUJ,CAAO,GAAG,OAAO;EAC/B,IAAWA,EAAgC;CAC7C;CACA,OAAO;AACT"}

package/dist/shared/injectionKeys.js

@@ -1,6 +1,5 @@
-//#region src/shared/injectionKeys.ts
+// src/shared/injectionKeys.ts
 var e = Symbol.for("anzu:SystemScope"), t = Symbol.for("anzu:SubjectScope"), n = Symbol.for("anzu:AvailableLanguages"), r = Symbol.for("anzu:DefaultLanguage");
-//#endregion
 export { n as AvailableLanguagesSymbol, r as DefaultLanguageSymbol, t as SubjectScopeKey, e as SystemScopeKey };
 
 //# sourceMappingURL=injectionKeys.js.map

package/dist/shared/statusCodes.js

@@ -1,11 +1,10 @@
-//#region src/shared/statusCodes.ts
+// src/shared/statusCodes.ts
 var e = 200, t = 201, n = 204, r = 400, i = 401, a = 403, o = 404, s = 422, c = [
 	200,
 	201,
 	202,
 	204
 ];
-//#endregion
 export { r as HTTP_STATUS_BAD_REQUEST, t as HTTP_STATUS_CREATED, a as HTTP_STATUS_FORBIDDEN, o as HTTP_STATUS_NOT_FOUND, n as HTTP_STATUS_NO_CONTENT, e as HTTP_STATUS_OK, i as HTTP_STATUS_UNAUTHORIZED, s as HTTP_STATUS_UNPROCESSABLE_ENTITY, c as HTTP_STATUS_VALID_ALL };
 
 //# sourceMappingURL=statusCodes.js.map

package/dist/shared/types/CreatedByAware.js

@@ -1,6 +1,5 @@
-//#region src/shared/types/CreatedByAware.ts
+// src/shared/types/CreatedByAware.ts
 var e = (e) => Object.hasOwn(e, "createdBy");
-//#endregion
 export { e as isCreatedByAware };
 
 //# sourceMappingURL=CreatedByAware.js.map

package/dist/shared/types/OwnerAware.js

@@ -1,7 +1,6 @@
 import { isObject as e } from "../utils/common.js";
-//#region src/shared/types/OwnerAware.ts
+// src/shared/types/OwnerAware.ts
 var t = (t) => e(t) && Object.hasOwn(t, "owners");
-//#endregion
 export { t as isOwnerAware };
 
 //# sourceMappingURL=OwnerAware.js.map

package/dist/shared/types/UserAndTimeTracking.d.ts

@@ -2,8 +2,8 @@ import { DatetimeUTCNullable, IntegerId, IntegerIdNullable } from './common';
 import { AnzuUserMinimal } from './AnzuUser';
 import { AddToCachedArgs, CachedItem } from '../../domains/cached/composables/defineCached';
 /**
- * What the created / modified rows read. Every field is optional: a backend without user tracking
- * leaves `createdBy` and `modifiedBy` out of its answer, one without any tracking all four.
+ * Every field is optional. A backend without user tracking omits
+ * `createdBy` and `modifiedBy`; one without any tracking omits all four.
  */
 export interface UserAndTimeTrackingData {
     createdAt?: DatetimeUTCNullable;
@@ -12,9 +12,9 @@ export interface UserAndTimeTrackingData {
     modifiedBy?: IntegerIdNullable;
 }
 /**
- * The admin's user cache, as the rows need it. Every admin's `useCachedUsers()` (and the library's
- * `useCachedAnzuUsers()`, `useDamCachedUsers()`) returns these three under these names, and every
- * admin's minimal user is a superset of `AnzuUserMinimal`.
+ * The admin's user cache, as the rows need it.
+ * Every admin's `useCachedUsers()`, and the library's `useCachedAnzuUsers()` and `useDamCachedUsers()`,
+ * return these three members. Every admin's minimal user is a superset of `AnzuUserMinimal`.
  */
 export interface UserAndTimeTrackingUsers<U extends AnzuUserMinimal = AnzuUserMinimal> {
     getCachedUser: (id: IntegerIdNullable | undefined) => CachedItem<U> | undefined;

package/dist/shared/types/Validation.d.ts

@@ -1,8 +1,8 @@
 import { Ref } from 'vue';
 export type ValidationScope = string | number | boolean | symbol | undefined;
 /**
- * What a form field reads from its `v`. A vuelidate field state (`v$.title`) fits as it is; anything
- * else has to provide these members.
+ * What a form field reads from its `v`. A vuelidate field state
+ * (`v$.title`) fits as is; anything else must provide these members.
  */
 export interface AFormFieldValidation {
     $touch: () => void;
@@ -14,10 +14,9 @@ export interface AFormFieldValidation {
     /** `system.subject.field`: names the field for collaboration and the remote form fields. */
     $path: string;
     /**
-     * A `required` rule stars the label; its `$params.type` tells it from `requiredIf`. `unknown`
-     * because vuelidate types the member of a field without that rule as a nested validation.
+     * A `required` rule stars the label. Its `$params.type` tells it from `requiredIf`.
+     * Typed `unknown` because vuelidate types this member as a nested validation on a field without that rule.
      */
     required?: unknown;
 }
-/** What `ACreateDialog` reads from its `v`: the form's state. */
 export type ACreateDialogValidation = Pick<AFormFieldValidation, '$touch' | '$invalid'>;

package/dist/shared/types/common.d.ts

@@ -2,9 +2,7 @@
  * Datetime in RFC 3339 format as string.
  */
 export type DatetimeUTC = string;
-/**
- * Calendar day carried as an RFC 3339 datetime pinned to UTC midnight.
- */
+/** Calendar day carried as an RFC 3339 datetime pinned to UTC midnight. */
 export type DateUTC = string;
 /**
  * Datetime in RFC 3339 format as string + null.

package/dist/shared/types/globalComponents.d.ts

@@ -3,12 +3,11 @@ import { VBtn } from 'vuetify/components';
 import { default as Acl } from '../../domains/auth/components/Acl.vue';
 import { default as AChipNoLink } from '../../domains/ui/components/AChipNoLink.vue';
 /**
- * What the library registers globally, typed for templates: the button aliases of its Vuetify config
- * (`useCommonVuetifyConfig().commonAliases`), and `Acl` and `AChipNoLink`, which the plugin registers. Their names are
- * `globalComponentNames` in `@anzusystems/common-admin/eslint`.
- *
- * The augmentations below live in this module, which the public entry re-exports, so that an admin's
- * program loads them with the declarations.
+ * Global components the library registers, typed for templates: the button aliases from
+ * `useCommonVuetifyConfig().commonAliases`, plus `Acl` and `AChipNoLink` registered by the plugin.
+ * Their names are `globalComponentNames` in `@anzusystems/common-admin/eslint`.
+ * The augmentations live in this module because the public entry
+ * re-exports it, so an admin's program loads them with the declarations.
  */
 export interface CommonAdminGlobalComponents {
     ABtnPrimary: typeof VBtn;

package/dist/shared/types/utils.js

@@ -1,8 +1,7 @@
-//#region src/shared/types/utils.ts
+// src/shared/types/utils.ts
 function e(e) {
 	return e;
 }
-//#endregion
 export { e as ensureUniqueValues };
 
 //# sourceMappingURL=utils.js.map

package/dist/shared/utils/array.js

@@ -1,4 +1,4 @@
-//#region src/shared/utils/array.ts
+// src/shared/utils/array.ts
 var e = (e, t) => {
 	let n = e.indexOf(t);
 	n === -1 ? e.push(t) : e.splice(n, 1);
@@ -11,7 +11,6 @@ var e = (e, t) => {
 	for (let e = 0; e < n.length; e++) if (n[e] !== r[e]) return !1;
 	return !0;
 };
-//#endregion
 export { n as arrayFlatten, t as arrayFromArgs, e as arrayItemToggle, r as arraysHaveSameElements };
 
 //# sourceMappingURL=array.js.map

package/dist/shared/utils/boolean.js

@@ -1,6 +1,5 @@
-//#region src/shared/utils/boolean.ts
+// src/shared/utils/boolean.ts
 var e = (e) => +!!e;
-//#endregion
 export { e as booleanToInteger };
 
 //# sourceMappingURL=boolean.js.map

package/dist/shared/utils/common.js

@@ -1,5 +1,5 @@
 import { isRef as e, toRaw as t, unref as n } from "vue";
-//#region src/shared/utils/common.ts
+// src/shared/utils/common.ts
 var r = (e) => e === void 0, i = (e) => !r(e), a = (e) => e === null, o = (e) => typeof e == "number", s = (e) => typeof e == "string", c = (e) => Array.isArray(e), l = (e) => typeof e == "function", u = (e) => typeof e == "boolean", d = (e) => s(e) && /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.test(e), f = (e) => {
 	let t = parseFloat(e);
 	return !isNaN(e) && Number.isInteger(t);
@@ -24,7 +24,6 @@ var r = (e) => e === void 0, i = (e) => !r(e), a = (e) => e === null, o = (e) =>
 	}
 	return JSON.parse(JSON.stringify(e));
 };
-//#endregion
 export { v as cloneDeep, c as isArray, u as isBoolean, i as isDefined, d as isDocId, g as isEmpty, h as isEmptyArray, m as isEmptyObject, l as isFunction, f as isInt, a as isNull, o as isNumber, p as isObject, s as isString, r as isUndefined };
 
 //# sourceMappingURL=common.js.map