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

package/dist/domains/cached/components/ACachedChip.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,138 @@
+import { objectGetValueByPath as e } from "../../../shared/utils/object.js";
+import { isNull as t, isUndefined as n } from "../../../shared/utils/common.js";
+import { COMMON_CONFIG as r } from "../../../shared/commonConfig.js";
+import { useCachedItem as i } from "../composables/useCachedItem.js";
+import { Fragment as a, computed as o, createBlock as s, createCommentVNode as c, createElementBlock as l, createTextVNode as u, defineComponent as d, normalizeClass as f, openBlock as p, renderSlot as m, toDisplayString as h, unref as g, withCtx as _, withModifiers as v } from "vue";
+import { useI18n as y } from "vue-i18n";
+import { VChip as b } from "vuetify/components/VChip";
+import { useRouter as x } from "vue-router";
+import { VProgressCircular as S } from "vuetify/components/VProgressCircular";
+import { VTooltip as C } from "vuetify/components/VTooltip";
+// src/domains/cached/components/ACachedChip.vue?vue&type=script&setup=true&lang.ts
+var w = ["title"], T = /*@__PURE__*/ d({
+	__name: "ACachedChip",
+	props: {
+		id: { default: null },
+		title: { default: "" },
+		containerClass: { default: "d-inline-flex" },
+		getCachedFn: {},
+		displayTextPath: {},
+		route: {},
+		disableClick: {
+			type: Boolean,
+			default: !1
+		},
+		openInNew: {
+			type: Boolean,
+			default: !1
+		},
+		size: { default: "small" },
+		forceRounded: {
+			type: Boolean,
+			default: !1
+		},
+		textOnly: {
+			type: Boolean,
+			default: !1
+		},
+		fallbackIdText: {
+			type: Boolean,
+			default: !1
+		},
+		wrapText: {
+			type: Boolean,
+			default: !1
+		},
+		closable: {
+			type: Boolean,
+			default: !1
+		},
+		customTitleFn: {
+			type: Function,
+			default: void 0
+		}
+	},
+	emits: ["close"],
+	setup(d, { emit: T }) {
+		let E = d, D = T, { t: O } = y(), k = x(), { cached: A, loaded: j, unresolved: M } = i(() => E.getCachedFn(E.id)), N = o(() => E.disableClick || M.value), P = o(() => E.wrapText ? E.containerClass + " a-chip--wrap" : E.containerClass), F = o(() => M.value && E.title.length === 0), I = o(() => {
+			if (F.value) return "#" + E.id;
+			if (E.customTitleFn && A.value) {
+				let e = E.customTitleFn(A.value, E.title, E.displayTextPath, E.fallbackIdText);
+				if (e !== void 0) return e;
+			}
+			return E.title.length > 0 ? E.title : A.value ? e(A.value, E.displayTextPath) : E.fallbackIdText ? E.id : "";
+		}), L = () => {
+			k.push({
+				name: E.route,
+				params: { id: E.id }
+			});
+		};
+		return (e, i) => (p(), l("div", { class: f(P.value) }, [g(t)(d.id) || g(n)(d.id) ? m(e.$slots, "empty", {}, () => [i[2] ||= u("-", -1)], void 0, 0) : d.textOnly ? (p(), l("div", {
+			key: 1,
+			title: g(M) ? g(O)("common.model.cachedUnavailable") : void 0
+		}, [F.value ? m(e.$slots, "unresolved", { id: d.id }, () => [u(h(I.value), 1)], void 0, 0) : (p(), l(a, { key: 1 }, [u(h(I.value), 1)], 64)), !g(j) && d.title.length === 0 ? (p(), s(S, {
+			key: 2,
+			size: 12,
+			width: 2,
+			indeterminate: "",
+			class: "mx-1"
+		})) : c("", !0)], 8, w)) : N.value ? (p(), s(b, {
+			key: 2,
+			size: d.size,
+			label: !d.forceRounded || void 0,
+			closable: d.closable,
+			"close-label": "common.button.remove",
+			"onClick:close": i[0] ||= () => D("close", d.id)
+		}, {
+			default: _(() => [
+				F.value ? m(e.$slots, "unresolved", { id: d.id }, () => [u(h(I.value), 1)], void 0, 0) : (p(), l(a, { key: 1 }, [u(h(I.value), 1)], 64)),
+				g(M) ? (p(), s(C, {
+					key: 2,
+					activator: "parent",
+					location: "bottom"
+				}, {
+					default: _(() => [u(h(g(O)("common.model.cachedUnavailable")), 1)]),
+					_: 1
+				})) : c("", !0),
+				!g(j) && d.title.length === 0 ? (p(), s(S, {
+					key: 3,
+					size: 12,
+					width: 2,
+					indeterminate: "",
+					class: "mx-1"
+				})) : c("", !0)
+			]),
+			_: 3
+		}, 8, [
+			"size",
+			"label",
+			"closable"
+		])) : (p(), s(b, {
+			key: 3,
+			size: d.size,
+			"append-icon": d.openInNew ? g(r).CHIP.ICON.LINK_EXTERNAL : g(r).CHIP.ICON.LINK,
+			label: !d.forceRounded || void 0,
+			closable: d.closable,
+			"close-label": "common.button.remove",
+			onClick: v(L, ["stop"]),
+			"onClick:close": i[1] ||= () => D("close", d.id)
+		}, {
+			default: _(() => [u(h(I.value) + " ", 1), !g(j) && d.title.length === 0 ? (p(), s(S, {
+				key: 0,
+				size: 12,
+				width: 2,
+				indeterminate: "",
+				class: "mx-1"
+			})) : c("", !0)]),
+			_: 1
+		}, 8, [
+			"size",
+			"append-icon",
+			"label",
+			"closable"
+		]))], 2));
+	}
+});
+export { T as default };
+
+//# sourceMappingURL=ACachedChip.vue_vue_type_script_setup_true_lang.js.map

package/dist/domains/cached/components/ACachedChip.vue_vue_type_script_setup_true_lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ACachedChip.vue_vue_type_script_setup_true_lang.js","names":["_openBlock","_createElementBlock","_normalizeClass","_unref","_renderSlot","_createTextVNode","_toDisplayString","_Fragment","_createBlock","_component_VProgressCircular","_createCommentVNode","_component_VChip","_withCtx","_component_VTooltip","_withModifiers","_hoisted_1","ACachedChip_vue_vue_type_script_setup_true_lang_default","__emit","props","__props","emit","useI18n","router","useRouter","useCachedItem","linkDisabled","computed","unresolved","containerClassComputed","showUnresolved","displayTitle","cached","customTitle","objectGetValueByPath","onClick","openBlock","createElementBlock","normalizeClass","unref","isNull","isUndefined","renderSlot","_ctx","_cache","createTextVNode","t","toDisplayString","Fragment","loaded","createBlock","VProgressCircular","createCommentVNode","VChip","withCtx","VTooltip","COMMON_CONFIG","withModifiers"],"sources":["../../../../src/domains/cached/components/ACachedChip.vue"],"sourcesContent":["<script lang=\"ts\" setup>\nimport { computed } from 'vue'\nimport { useI18n } from 'vue-i18n'\nimport { useRouter } from 'vue-router'\nimport type { DocId, IntegerId } from '@/shared/types/common'\nimport { objectGetValueByPath } from '@/shared/utils/object'\nimport { isNull, isUndefined } from '@/shared/utils/common'\nimport { COMMON_CONFIG } from '@/shared/commonConfig'\nimport { useCachedItem } from '@/domains/cached/composables/useCachedItem'\n\nconst props = withDefaults(\n  defineProps<{\n    id?: null | undefined | IntegerId | DocId\n    title?: string\n    containerClass?: undefined | string\n    getCachedFn: (id: any) => any\n    displayTextPath: string\n    route: string\n    disableClick?: boolean\n    openInNew?: boolean\n    size?: string\n    forceRounded?: boolean\n    textOnly?: boolean\n    fallbackIdText?: boolean\n    wrapText?: boolean\n    closable?: boolean\n    customTitleFn?: (\n      cachedItem: any,\n      defaultTitle: string,\n      displayTextPath: string,\n      fallbackIdText: boolean\n    ) => string | undefined\n  }>(),\n  {\n    id: null,\n    title: '',\n    containerClass: 'd-inline-flex',\n    disableClick: false,\n    openInNew: false,\n    size: 'small',\n    forceRounded: false,\n    textOnly: false,\n    fallbackIdText: false,\n    wrapText: false,\n    closable: false,\n    customTitleFn: undefined,\n  }\n)\n\nconst emit = defineEmits<{\n  (e: 'close', id: null | undefined | IntegerId | DocId): void\n}>()\n\nconst { t } = useI18n()\nconst router = useRouter()\nconst { cached, loaded, unresolved } = useCachedItem(() => props.getCachedFn(props.id as any))\n\n// An item the fetch could not resolve shows only its id placeholder.\n// It gets no link, because its detail would not load either.\nconst linkDisabled = computed(() => props.disableClick || unresolved.value)\n\nconst containerClassComputed = computed(() => {\n  return props.wrapText ? props.containerClass + ' a-chip--wrap' : props.containerClass\n})\n\n// A title given by the caller still wins over the placeholder.\nconst showUnresolved = computed(() => unresolved.value && props.title.length === 0)\n\nconst displayTitle = computed(() => {\n  if (showUnresolved.value) return '#' + props.id\n  if (props.customTitleFn && cached.value) {\n    const customTitle = props.customTitleFn(cached.value, props.title, props.displayTextPath, props.fallbackIdText)\n    if (customTitle !== undefined) {\n      return customTitle\n    }\n  }\n  if (props.title.length > 0) return props.title\n  if (cached.value) {\n    return objectGetValueByPath(cached.value, props.displayTextPath)\n  }\n  return props.fallbackIdText ? props.id : ''\n})\n\nconst onClick = () => {\n  router.push({ name: props.route, params: { id: props.id } })\n}\n</script>\n\n<template>\n  <div :class=\"containerClassComputed\">\n    <template v-if=\"isNull(id) || isUndefined(id)\">\n      <slot name=\"empty\">-</slot>\n    </template>\n    <div\n      v-else-if=\"textOnly\"\n      :title=\"unresolved ? t('common.model.cachedUnavailable') : undefined\"\n    >\n      <slot\n        v-if=\"showUnresolved\"\n        :id=\"id\"\n        name=\"unresolved\"\n      >\n        {{ displayTitle }}\n      </slot>\n      <template v-else>{{ displayTitle }}</template>\n      <VProgressCircular\n        v-if=\"!loaded && title.length === 0\"\n        :size=\"12\"\n        :width=\"2\"\n        indeterminate\n        class=\"mx-1\"\n      />\n    </div>\n    <VChip\n      v-else-if=\"linkDisabled\"\n      :size=\"size\"\n      :label=\"forceRounded ? undefined : true\"\n      :closable=\"closable\"\n      close-label=\"common.button.remove\"\n      @click:close=\"() => emit('close', id)\"\n    >\n      <slot\n        v-if=\"showUnresolved\"\n        :id=\"id\"\n        name=\"unresolved\"\n      >\n        {{ displayTitle }}\n      </slot>\n      <template v-else>{{ displayTitle }}</template>\n      <VTooltip\n        v-if=\"unresolved\"\n        activator=\"parent\"\n        location=\"bottom\"\n      >\n        {{ t('common.model.cachedUnavailable') }}\n      </VTooltip>\n      <VProgressCircular\n        v-if=\"!loaded && title.length === 0\"\n        :size=\"12\"\n        :width=\"2\"\n        indeterminate\n        class=\"mx-1\"\n      />\n    </VChip>\n    <VChip\n      v-else\n      :size=\"size\"\n      :append-icon=\"openInNew ? COMMON_CONFIG.CHIP.ICON.LINK_EXTERNAL : COMMON_CONFIG.CHIP.ICON.LINK\"\n      :label=\"forceRounded ? undefined : true\"\n      :closable=\"closable\"\n      close-label=\"common.button.remove\"\n      @click.stop=\"onClick\"\n      @click:close=\"() => emit('close', id)\"\n    >\n      {{ displayTitle }}\n      <VProgressCircular\n        v-if=\"!loaded && title.length === 0\"\n        :size=\"12\"\n        :width=\"2\"\n        indeterminate\n        class=\"mx-1\"\n      />\n    </VChip>\n  </div>\n</template>\n\n<style lang=\"scss\">\n.a-chip--wrap {\n  .v-chip {\n    height: auto !important;\n  }\n\n  .v-chip .v-chip__content {\n    max-width: 100%;\n    height: auto;\n    min-height: 26px;\n    white-space: pre-wrap;\n  }\n}\n</style>\n"],"mappings":"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"}

package/dist/domains/cached/components/ACachedUserChip.js

@@ -0,0 +1,8 @@
+import e from "./ACachedUserChip.vue_vue_type_script_setup_true_lang.js";
+/* empty css                                                                */
+import t from "../../../_virtual/_plugin-vue_export-helper.js";
+// src/domains/cached/components/ACachedUserChip.vue
+var n = /*#__PURE__*/ t(e, [["__scopeId", "data-v-c2700907"]]);
+export { n as default };
+
+//# sourceMappingURL=ACachedUserChip.js.map

package/dist/domains/cached/components/ACachedUserChip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ACachedUserChip.js","names":["_sfc_main","ACachedUserChip_vue_vue_type_script_setup_true_lang_default","_plugin_vue_export_helper_default","ACachedUserChip_default"],"sources":["../../../../src/domains/cached/components/ACachedUserChip.vue"],"sourcesContent":["<script lang=\"ts\" setup>\nimport type { IntegerIdNullable } from '@/shared/types/common'\nimport { computed } from 'vue'\nimport { useI18n } from 'vue-i18n'\nimport { useRouter } from 'vue-router'\nimport type { AnzuUserMinimal } from '@/shared/types/AnzuUser'\nimport type { CachedItem } from '@/domains/cached/composables/defineCached'\nimport { COMMON_CONFIG } from '@/shared/commonConfig'\nimport AAnzuUserAvatar from '@/domains/ui/components/AAnzuUserAvatar.vue'\nimport { replaceUrlParameters } from '@/domains/api/utils/apiHelper'\nimport { useCachedItem } from '@/domains/cached/composables/useCachedItem'\n\nconst props = withDefaults(\n  defineProps<{\n    id: IntegerIdNullable | undefined\n    /** The admin's cache getter, e.g. `getCachedUser` of its `useCachedUsers()`. */\n    getCachedFn: (id: IntegerIdNullable | undefined) => CachedItem<AnzuUserMinimal> | undefined\n    routeName?: string | undefined\n    externalUrlTemplate?: string | undefined\n    /**\n     * Label for caches whose users carry a better one than `person.fullName`, such as a nickname.\n     * `any` because it reads the admin's own user type, which `AnzuUserMinimal` does not describe.\n     */\n    titleFn?: ((user: CachedItem<any>) => string) | undefined\n    disableClick?: boolean\n    /** Label of the close button when Vuetify defaults make the chip closable. Defaults to \"Remove\". */\n    closeLabel?: string\n  }>(),\n  {\n    routeName: undefined,\n    externalUrlTemplate: undefined,\n    titleFn: undefined,\n    disableClick: false,\n    closeLabel: 'common.button.remove',\n  }\n)\n\nconst { t } = useI18n()\nconst router = useRouter()\n// 0 counts as no id, as in `defineCached`. A blank factory record carries it.\nconst { cached, loaded, unresolved } = useCachedItem(() => (props.id ? props.getCachedFn(props.id) : undefined))\n\n// Optional chaining on purpose. Each admin maps its own users into the cache.\n// A mapper that omits the name or e-mail falls through to the next label instead of throwing.\nconst text = computed(() => {\n  const user = cached.value\n  if (!user) return ''\n  const title = props.titleFn ? props.titleFn(user) : ''\n  if (title) return title\n  if (user.person?.fullName) return user.person.fullName\n  if (user.email) return user.email.split('@')[0]\n  return '#' + props.id\n})\n\nconst clickable = computed(\n  () => !props.disableClick && !unresolved.value && !!(props.externalUrlTemplate || props.routeName)\n)\n\nconst appendIcon = computed(() => {\n  if (!clickable.value) return undefined\n  return props.externalUrlTemplate ? COMMON_CONFIG.CHIP.ICON.LINK_EXTERNAL : COMMON_CONFIG.CHIP.ICON.LINK\n})\n\nconst onClick = () => {\n  if (!clickable.value || !props.id) return\n  if (props.externalUrlTemplate) {\n    window.open(replaceUrlParameters(props.externalUrlTemplate, { id: props.id }), '_blank')\n    return\n  }\n  if (props.routeName) router.push({ name: props.routeName, params: { id: props.id } })\n}\n</script>\n\n<template>\n  <div class=\"d-inline-flex\">\n    <span v-if=\"!id\">-</span>\n    <VChip\n      v-else-if=\"unresolved\"\n      class=\"non-clickable\"\n      size=\"small\"\n      :close-label=\"closeLabel\"\n      data-cy=\"cached-user-chip-unresolved\"\n    >\n      #{{ id }}\n      <VTooltip\n        activator=\"parent\"\n        location=\"bottom\"\n      >\n        {{ t('common.model.tracking.userUnavailable') }}\n      </VTooltip>\n    </VChip>\n    <VChip\n      v-else\n      class=\"pl-1\"\n      :class=\"clickable ? '' : 'non-clickable'\"\n      size=\"small\"\n      :append-icon=\"appendIcon\"\n      :close-label=\"closeLabel\"\n      @click.stop=\"onClick\"\n    >\n      <AAnzuUserAvatar\n        v-if=\"loaded\"\n        :user=\"cached\"\n        container-class=\"mr-1\"\n        :size=\"20\"\n      />\n      {{ text }}\n      <VProgressCircular\n        v-if=\"!loaded\"\n        :size=\"12\"\n        :width=\"2\"\n        indeterminate\n        class=\"ml-1\"\n      />\n    </VChip>\n  </div>\n</template>\n\n<style lang=\"scss\" scoped>\n.non-clickable {\n  cursor: default;\n}\n</style>\n"],"mappings":""}

package/dist/domains/cached/components/ACachedUserChip.vue.d.ts

@@ -0,0 +1,27 @@
+import { IntegerIdNullable } from '../../../shared/types/common';
+import { AnzuUserMinimal } from '../../../shared/types/AnzuUser';
+import { CachedItem } from '../composables/defineCached';
+type __VLS_Props = {
+    id: IntegerIdNullable | undefined;
+    /** The admin's cache getter, e.g. `getCachedUser` of its `useCachedUsers()`. */
+    getCachedFn: (id: IntegerIdNullable | undefined) => CachedItem<AnzuUserMinimal> | undefined;
+    routeName?: string | undefined;
+    externalUrlTemplate?: string | undefined;
+    /**
+     * Label for caches whose users carry a better one than `person.fullName`, such as a nickname.
+     * `any` because it reads the admin's own user type, which `AnzuUserMinimal` does not describe.
+     */
+    titleFn?: ((user: CachedItem<any>) => string) | undefined;
+    disableClick?: boolean;
+    /** Label of the close button when Vuetify defaults make the chip closable. Defaults to "Remove". */
+    closeLabel?: string;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    closeLabel: string;
+    disableClick: boolean;
+    routeName: string;
+    externalUrlTemplate: string;
+    titleFn: (user: CachedItem<any>) => string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/domains/cached/components/ACachedUserChip.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,90 @@
+import { COMMON_CONFIG as e } from "../../../shared/commonConfig.js";
+import t from "../../ui/components/AAnzuUserAvatar.js";
+import { replaceUrlParameters as n } from "../../api/utils/apiHelper.js";
+import { useCachedItem as r } from "../composables/useCachedItem.js";
+import { computed as i, createBlock as a, createCommentVNode as o, createElementBlock as s, createTextVNode as c, createVNode as l, defineComponent as u, normalizeClass as d, openBlock as f, toDisplayString as p, unref as m, withCtx as h, withModifiers as g } from "vue";
+import { useI18n as _ } from "vue-i18n";
+import { VChip as v } from "vuetify/components/VChip";
+import { useRouter as y } from "vue-router";
+import { VProgressCircular as b } from "vuetify/components/VProgressCircular";
+import { VTooltip as x } from "vuetify/components/VTooltip";
+// src/domains/cached/components/ACachedUserChip.vue?vue&type=script&setup=true&lang.ts
+var S = { class: "d-inline-flex" }, C = { key: 0 }, w = /*@__PURE__*/ u({
+	__name: "ACachedUserChip",
+	props: {
+		id: {},
+		getCachedFn: {},
+		routeName: { default: void 0 },
+		externalUrlTemplate: { default: void 0 },
+		titleFn: {
+			type: Function,
+			default: void 0
+		},
+		disableClick: {
+			type: Boolean,
+			default: !1
+		},
+		closeLabel: { default: "common.button.remove" }
+	},
+	setup(u) {
+		let w = u, { t: T } = _(), E = y(), { cached: D, loaded: O, unresolved: k } = r(() => w.id ? w.getCachedFn(w.id) : void 0), A = i(() => {
+			let e = D.value;
+			return e ? (w.titleFn ? w.titleFn(e) : "") || (e.person?.fullName ? e.person.fullName : e.email ? e.email.split("@")[0] : "#" + w.id) : "";
+		}), j = i(() => !w.disableClick && !k.value && !!(w.externalUrlTemplate || w.routeName)), M = i(() => {
+			if (j.value) return w.externalUrlTemplate ? e.CHIP.ICON.LINK_EXTERNAL : e.CHIP.ICON.LINK;
+		}), N = () => {
+			j.value && w.id && (w.externalUrlTemplate ? window.open(n(w.externalUrlTemplate, { id: w.id }), "_blank") : w.routeName && E.push({
+				name: w.routeName,
+				params: { id: w.id }
+			}));
+		};
+		return (e, n) => (f(), s("div", S, [u.id ? m(k) ? (f(), a(v, {
+			key: 1,
+			class: "non-clickable",
+			size: "small",
+			"close-label": u.closeLabel,
+			"data-cy": "cached-user-chip-unresolved"
+		}, {
+			default: h(() => [c(" #" + p(u.id) + " ", 1), l(x, {
+				activator: "parent",
+				location: "bottom"
+			}, {
+				default: h(() => [c(p(m(T)("common.model.tracking.userUnavailable")), 1)]),
+				_: 1
+			})]),
+			_: 1
+		}, 8, ["close-label"])) : (f(), a(v, {
+			key: 2,
+			class: d(["pl-1", j.value ? "" : "non-clickable"]),
+			size: "small",
+			"append-icon": M.value,
+			"close-label": u.closeLabel,
+			onClick: g(N, ["stop"])
+		}, {
+			default: h(() => [
+				m(O) ? (f(), a(t, {
+					key: 0,
+					user: m(D),
+					"container-class": "mr-1",
+					size: 20
+				}, null, 8, ["user"])) : o("", !0),
+				c(" " + p(A.value) + " ", 1),
+				m(O) ? o("", !0) : (f(), a(b, {
+					key: 1,
+					size: 12,
+					width: 2,
+					indeterminate: "",
+					class: "ml-1"
+				}))
+			]),
+			_: 1
+		}, 8, [
+			"class",
+			"append-icon",
+			"close-label"
+		])) : (f(), s("span", C, "-"))]));
+	}
+});
+export { w as default };
+
+//# sourceMappingURL=ACachedUserChip.vue_vue_type_script_setup_true_lang.js.map

package/dist/domains/cached/components/ACachedUserChip.vue_vue_type_script_setup_true_lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ACachedUserChip.vue_vue_type_script_setup_true_lang.js","names":["_openBlock","_createElementBlock","_unref","_createBlock","_component_VChip","_withCtx","_createTextVNode","_toDisplayString","_createVNode","_component_VTooltip","_normalizeClass","_withModifiers","AAnzuUserAvatar","_createCommentVNode","_component_VProgressCircular","AAnzuUserAvatar_default","_hoisted_1","_hoisted_2","ACachedUserChip_vue_vue_type_script_setup_true_lang_default","props","__props","useI18n","router","useRouter","useCachedItem","text","computed","user","cached","clickable","unresolved","appendIcon","COMMON_CONFIG","onClick","replaceUrlParameters","openBlock","createElementBlock","unref","createBlock","VChip","withCtx","createTextVNode","toDisplayString","createVNode","VTooltip","t","normalizeClass","withModifiers","loaded","createCommentVNode","VProgressCircular"],"sources":["../../../../src/domains/cached/components/ACachedUserChip.vue"],"sourcesContent":["<script lang=\"ts\" setup>\nimport type { IntegerIdNullable } from '@/shared/types/common'\nimport { computed } from 'vue'\nimport { useI18n } from 'vue-i18n'\nimport { useRouter } from 'vue-router'\nimport type { AnzuUserMinimal } from '@/shared/types/AnzuUser'\nimport type { CachedItem } from '@/domains/cached/composables/defineCached'\nimport { COMMON_CONFIG } from '@/shared/commonConfig'\nimport AAnzuUserAvatar from '@/domains/ui/components/AAnzuUserAvatar.vue'\nimport { replaceUrlParameters } from '@/domains/api/utils/apiHelper'\nimport { useCachedItem } from '@/domains/cached/composables/useCachedItem'\n\nconst props = withDefaults(\n  defineProps<{\n    id: IntegerIdNullable | undefined\n    /** The admin's cache getter, e.g. `getCachedUser` of its `useCachedUsers()`. */\n    getCachedFn: (id: IntegerIdNullable | undefined) => CachedItem<AnzuUserMinimal> | undefined\n    routeName?: string | undefined\n    externalUrlTemplate?: string | undefined\n    /**\n     * Label for caches whose users carry a better one than `person.fullName`, such as a nickname.\n     * `any` because it reads the admin's own user type, which `AnzuUserMinimal` does not describe.\n     */\n    titleFn?: ((user: CachedItem<any>) => string) | undefined\n    disableClick?: boolean\n    /** Label of the close button when Vuetify defaults make the chip closable. Defaults to \"Remove\". */\n    closeLabel?: string\n  }>(),\n  {\n    routeName: undefined,\n    externalUrlTemplate: undefined,\n    titleFn: undefined,\n    disableClick: false,\n    closeLabel: 'common.button.remove',\n  }\n)\n\nconst { t } = useI18n()\nconst router = useRouter()\n// 0 counts as no id, as in `defineCached`. A blank factory record carries it.\nconst { cached, loaded, unresolved } = useCachedItem(() => (props.id ? props.getCachedFn(props.id) : undefined))\n\n// Optional chaining on purpose. Each admin maps its own users into the cache.\n// A mapper that omits the name or e-mail falls through to the next label instead of throwing.\nconst text = computed(() => {\n  const user = cached.value\n  if (!user) return ''\n  const title = props.titleFn ? props.titleFn(user) : ''\n  if (title) return title\n  if (user.person?.fullName) return user.person.fullName\n  if (user.email) return user.email.split('@')[0]\n  return '#' + props.id\n})\n\nconst clickable = computed(\n  () => !props.disableClick && !unresolved.value && !!(props.externalUrlTemplate || props.routeName)\n)\n\nconst appendIcon = computed(() => {\n  if (!clickable.value) return undefined\n  return props.externalUrlTemplate ? COMMON_CONFIG.CHIP.ICON.LINK_EXTERNAL : COMMON_CONFIG.CHIP.ICON.LINK\n})\n\nconst onClick = () => {\n  if (!clickable.value || !props.id) return\n  if (props.externalUrlTemplate) {\n    window.open(replaceUrlParameters(props.externalUrlTemplate, { id: props.id }), '_blank')\n    return\n  }\n  if (props.routeName) router.push({ name: props.routeName, params: { id: props.id } })\n}\n</script>\n\n<template>\n  <div class=\"d-inline-flex\">\n    <span v-if=\"!id\">-</span>\n    <VChip\n      v-else-if=\"unresolved\"\n      class=\"non-clickable\"\n      size=\"small\"\n      :close-label=\"closeLabel\"\n      data-cy=\"cached-user-chip-unresolved\"\n    >\n      #{{ id }}\n      <VTooltip\n        activator=\"parent\"\n        location=\"bottom\"\n      >\n        {{ t('common.model.tracking.userUnavailable') }}\n      </VTooltip>\n    </VChip>\n    <VChip\n      v-else\n      class=\"pl-1\"\n      :class=\"clickable ? '' : 'non-clickable'\"\n      size=\"small\"\n      :append-icon=\"appendIcon\"\n      :close-label=\"closeLabel\"\n      @click.stop=\"onClick\"\n    >\n      <AAnzuUserAvatar\n        v-if=\"loaded\"\n        :user=\"cached\"\n        container-class=\"mr-1\"\n        :size=\"20\"\n      />\n      {{ text }}\n      <VProgressCircular\n        v-if=\"!loaded\"\n        :size=\"12\"\n        :width=\"2\"\n        indeterminate\n        class=\"ml-1\"\n      />\n    </VChip>\n  </div>\n</template>\n\n<style lang=\"scss\" scoped>\n.non-clickable {\n  cursor: default;\n}\n</style>\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYA,IAAMmB,IAAQC,GAyBR,EAAE,SAAMC,EAAQ,GAChBC,IAASC,EAAU,GAEnB,EAAE,WAAQ,WAAQ,kBAAeC,QAAqBL,EAAM,KAAKA,EAAM,YAAYA,EAAM,EAAE,IAAI,KAAA,CAAU,GAIzGM,IAAOC,QAAe;GAC1B,IAAMC,IAAOC,EAAO;GAMpB,OALKD,KACSR,EAAM,UAAUA,EAAM,QAAQQ,CAAI,IAAI,QAEhDA,EAAK,QAAQ,WAAiBA,EAAK,OAAO,WAC1CA,EAAK,QAAcA,EAAK,MAAM,MAAM,GAAG,CAAC,CAAC,KACtC,MAAMR,EAAM,MALD;EAMpB,CAAC,GAEKU,IAAYH,QACV,CAACP,EAAM,gBAAgB,CAACW,EAAW,SAAS,CAAC,EAAEX,EAAM,uBAAuBA,EAAM,UAC1F,GAEMY,IAAaL,QAAe;GAChC,IAAKG,EAAU,OACf,OAAOV,EAAM,sBAAsBa,EAAc,KAAK,KAAK,gBAAgBA,EAAc,KAAK,KAAK;EACrG,CAAC,GAEKC,UAAgB;GACpB,AAAKJ,EAAU,SAAUV,EAAM,OAC3BA,EAAM,sBACR,OAAO,KAAKe,EAAqBf,EAAM,qBAAqB,EAAE,IAAIA,EAAM,GAAG,CAAC,GAAG,QAAQ,IAGrFA,EAAM,aAAWG,EAAO,KAAK;IAAE,MAAMH,EAAM;IAAW,QAAQ,EAAE,IAAIA,EAAM,GAAG;GAAE,CAAC;EACtF;E,kBAIEnB,EAAA,GAAAC,EAyCM,OAzCNe,GAyCM,CAxCSI,EAAA,KAEAlB,EAAA4B,CAAA,KADb9B,EAAA,GAAAG,EAcQC,GAAA;;GAZN,OAAM;GACN,MAAK;GACJ,eAAagB,EAAA;GACd,WAAQ;;GACT,SAAAf,QACE,CADFC,EAAA,OACEC,EAAGa,EAAA,EAAE,IAAG,KACT,CAAA,GAAAZ,EAKWC,GAAA;IAJT,WAAU;IACV,UAAS;;IAET,SAAAJ,QAAgD,CAA7CC,EAAAC,EAAAL,EAAA2C,CAAA,CAAC,CAAA,uCAAA,CAAA,GAAA,CAAA,C;;;;E,2BAGR7C,EAAA,GAAAG,EAuBQC,GAAA;;GArBN,OAAKM,EAAA,CAAC,QACEmB,EAAA,QAAS,KAAA,eAAA,CAAA;GACjB,MAAK;GACJ,eAAaE,EAAA;GACb,eAAaX,EAAA;GACb,SAAKT,EAAOsB,GAAO,CAAA,MAAA,CAAA;;GAEpB,SAAA5B,QAKE;IAJMH,EAAA8C,CAAA,KADRhD,EAAA,GAAAG,EAKES,GAAA;;KAHC,MAAMV,EAAA0B,CAAA;KACP,mBAAgB;KACf,MAAM;;IACPtB,EAAA,MACFC,EAAGkB,EAAA,KAAI,IAAG,KACV,CAAA;IACSvB,EAAA8C,CAAA,I,aADThD,EAAA,GAAAG,EAMEW,GAAA;;KAJC,MAAM;KACN,OAAO;KACR,eAAA;KACA,OAAM;;;;;;;;E,OArCVd,EAAA,GAAAC,EAAyB,QAAAgB,GAAR,GAAC,E"}

package/dist/domains/cached/composables/createCachedChip.d.ts

@@ -0,0 +1,36 @@
+import { Component } from 'vue';
+import { DocId, IntegerId } from '../../../shared/types/common';
+export type CachedChipId = null | undefined | IntegerId | DocId;
+export interface CreateCachedChipOptions {
+    /**
+     * Composable returning the per-id cache getter — invoked inside the chip's
+     * setup so the backing cache store resolves in component scope. The `id`
+     * param is `any` to match `ACachedChip` and accept both numeric- and
+     * doc-id getters regardless of their exact parameter type.
+     */
+    useGetCachedFn: () => (id: any) => unknown;
+    /** Named route the chip links to (e.g. `'/(cms)/desks/[id]'`). */
+    route: string;
+    /** Dot-path into the cached entity for the chip label (e.g. `'name'`). */
+    displayTextPath: string;
+    /** Static props baked onto every instance (e.g. a fixed `textOnly`). */
+    chipProps?: Record<string, unknown>;
+    /** Component name for devtools / warnings. */
+    name?: string;
+}
+/**
+ * Builds a cached-entity chip from a domain's cache composable + route, so each
+ * per-domain `CachedXChip.vue` collapses to a single factory call instead of a
+ * full SFC re-binding `ACachedChip`. Caller-passed attributes (`size`, `color`,
+ * `disable-click`, …) and slots fall through to `ACachedChip`.
+ *
+ * Use in an SFC's plain `<script lang="ts">` (not `setup`):
+ * ```ts
+ * export default createCachedChip({
+ *   useGetCachedFn: () => useCachedDesks().getCachedDesk,
+ *   route: '/(cms)/desks/[id]',
+ *   displayTextPath: 'name',
+ * })
+ * ```
+ */
+export declare function createCachedChip(options: CreateCachedChipOptions): Component;

package/dist/domains/cached/composables/createCachedChip.js

@@ -0,0 +1,27 @@
+import e from "../components/ACachedChip.js";
+import { defineComponent as t, h as n } from "vue";
+// src/domains/cached/composables/createCachedChip.ts
+function r(r) {
+	return t({
+		name: r.name ?? "CachedChip",
+		inheritAttrs: !1,
+		props: { id: {
+			type: [Number, String],
+			default: null
+		} },
+		setup(t, { attrs: i, slots: a }) {
+			let o = r.useGetCachedFn();
+			return () => n(e, {
+				id: t.id,
+				getCachedFn: o,
+				route: r.route,
+				displayTextPath: r.displayTextPath,
+				...r.chipProps,
+				...i
+			}, a);
+		}
+	});
+}
+export { r as createCachedChip };
+
+//# sourceMappingURL=createCachedChip.js.map

package/dist/domains/cached/composables/createCachedChip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createCachedChip.js","names":["ACachedChip","ACachedChip_default","createCachedChip","defineComponent","options","getCachedFn","h","props","attrs","slots"],"sources":["../../../../src/domains/cached/composables/createCachedChip.ts"],"sourcesContent":["import { type Component, defineComponent, h, type PropType } from 'vue'\nimport ACachedChip from '@/domains/cached/components/ACachedChip.vue'\nimport type { DocId, IntegerId } from '@/shared/types/common'\n\nexport type CachedChipId = null | undefined | IntegerId | DocId\n\nexport interface CreateCachedChipOptions {\n  /**\n   * Composable returning the per-id cache getter — invoked inside the chip's\n   * setup so the backing cache store resolves in component scope. The `id`\n   * param is `any` to match `ACachedChip` and accept both numeric- and\n   * doc-id getters regardless of their exact parameter type.\n   */\n  useGetCachedFn: () => (id: any) => unknown\n  /** Named route the chip links to (e.g. `'/(cms)/desks/[id]'`). */\n  route: string\n  /** Dot-path into the cached entity for the chip label (e.g. `'name'`). */\n  displayTextPath: string\n  /** Static props baked onto every instance (e.g. a fixed `textOnly`). */\n  chipProps?: Record<string, unknown>\n  /** Component name for devtools / warnings. */\n  name?: string\n}\n\n/**\n * Builds a cached-entity chip from a domain's cache composable + route, so each\n * per-domain `CachedXChip.vue` collapses to a single factory call instead of a\n * full SFC re-binding `ACachedChip`. Caller-passed attributes (`size`, `color`,\n * `disable-click`, …) and slots fall through to `ACachedChip`.\n *\n * Use in an SFC's plain `<script lang=\"ts\">` (not `setup`):\n * ```ts\n * export default createCachedChip({\n *   useGetCachedFn: () => useCachedDesks().getCachedDesk,\n *   route: '/(cms)/desks/[id]',\n *   displayTextPath: 'name',\n * })\n * ```\n */\nexport function createCachedChip(options: CreateCachedChipOptions): Component {\n  return defineComponent({\n    name: options.name ?? 'CachedChip',\n    inheritAttrs: false,\n    // Vue skips type validation for null/undefined on non-required props, so a\n    // null id (the common \"empty\" case) won't warn despite the typed prop.\n    props: {\n      id: { type: [Number, String] as PropType<CachedChipId>, default: null },\n    },\n    setup(props, { attrs, slots }) {\n      const getCachedFn = options.useGetCachedFn()\n      return () =>\n        h(\n          ACachedChip,\n          {\n            id: props.id,\n            getCachedFn,\n            route: options.route,\n            displayTextPath: options.displayTextPath,\n            ...options.chipProps,\n            ...attrs,\n          },\n          slots\n        )\n    },\n  })\n}\n"],"mappings":";;;AAuCA,SAAgBE,EAAiB,GAA6C;CAC5E,OAAOC,EAAgB;EACrB,MAAMC,EAAQ,QAAQ;EACtB,cAAc;EAGd,OAAO,EACL,IAAI;GAAE,MAAM,CAAC,QAAQ,MAAM;GAA6B,SAAS;EAAK,EACxE;EACA,MAAM,GAAO,EAAE,UAAO,YAAS;GAC7B,IAAMC,IAAcD,EAAQ,eAAe;GAC3C,aACEE,EACEN,GACA;IACE,IAAIO,EAAM;IACV;IACA,OAAOH,EAAQ;IACf,iBAAiBA,EAAQ;IACzB,GAAGA,EAAQ;IACX,GAAGI;GACL,GACAC,CACF;EACJ;CACF,CAAC;AACH"}

package/dist/domains/cached/composables/createUserAndTimeTrackingFields.d.ts

@@ -0,0 +1,36 @@
+import { Component } from 'vue';
+import { AnzuUserMinimal } from '../../../shared/types/AnzuUser';
+import { CachedItem } from './defineCached';
+import { UserAndTimeTrackingUsers } from '../../../shared/types/UserAndTimeTracking';
+export interface CreateUserAndTimeTrackingFieldsOptions<U extends AnzuUserMinimal = AnzuUserMinimal> {
+    /**
+     * The admin's user cache composable, e.g. its `useCachedUsers`.
+     * Called once inside the component's setup, so the cache resolves in component scope.
+     */
+    useCachedUsers: () => UserAndTimeTrackingUsers<U>;
+    /**
+     * Named route of a user's detail, e.g. `'/(common)/users/[id]'`. Without it the chip is not a link.
+     * A function is read on each render, so the link can follow the current user's permission for that route.
+     */
+    userRouteName?: string | (() => string | undefined);
+    /** URL of a user's detail in another admin, with `:id` replaced. Opens in a new tab. */
+    userExternalUrlTemplate?: string;
+    /** The chip's label, for users that carry a better one than `person.fullName`. */
+    userTitleFn?: (user: CachedItem<U>) => string;
+    /** Component name for devtools / warnings. */
+    name?: string;
+}
+/**
+ * Builds an admin's created / modified rows from its user cache and routes.
+ * Each admin's `XTrackingFields.vue` becomes one factory call over
+ * `AUserAndTimeTrackingFields`. `hide-*` props and the `user` slot fall through.
+ *
+ * Use in an SFC's plain `<script lang="ts">`, not `setup`:
+ * ```ts
+ * export default createUserAndTimeTrackingFields({
+ *   useCachedUsers,
+ *   userRouteName: '/(common)/users/[id]',
+ * })
+ * ```
+ */
+export declare function createUserAndTimeTrackingFields<U extends AnzuUserMinimal = AnzuUserMinimal>(options: CreateUserAndTimeTrackingFieldsOptions<U>): Component;

package/dist/domains/cached/composables/createUserAndTimeTrackingFields.js

@@ -0,0 +1,28 @@
+import { isFunction as e } from "../../../shared/utils/common.js";
+import t from "../../ui/components/AUserAndTimeTrackingFields.js";
+import { defineComponent as n, h as r } from "vue";
+// src/domains/cached/composables/createUserAndTimeTrackingFields.ts
+function i(i) {
+	return n({
+		name: i.name ?? "UserAndTimeTrackingFields",
+		inheritAttrs: !1,
+		props: { data: {
+			type: Object,
+			required: !0
+		} },
+		setup(n, { attrs: a, slots: o }) {
+			let s = i.useCachedUsers();
+			return () => r(t, {
+				data: n.data,
+				users: s,
+				userRouteName: e(i.userRouteName) ? i.userRouteName() : i.userRouteName,
+				userExternalUrlTemplate: i.userExternalUrlTemplate,
+				userTitleFn: i.userTitleFn,
+				...a
+			}, o);
+		}
+	});
+}
+export { i as createUserAndTimeTrackingFields };
+
+//# sourceMappingURL=createUserAndTimeTrackingFields.js.map

package/dist/domains/cached/composables/createUserAndTimeTrackingFields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUserAndTimeTrackingFields.js","names":["AUserAndTimeTrackingFields","AUserAndTimeTrackingFields_default","createUserAndTimeTrackingFields","defineComponent","options","users","h","props","isFunction","attrs","slots"],"sources":["../../../../src/domains/cached/composables/createUserAndTimeTrackingFields.ts"],"sourcesContent":["import { type Component, defineComponent, h, type PropType } from 'vue'\nimport { isFunction } from '@/shared/utils/common'\nimport AUserAndTimeTrackingFields from '@/domains/ui/components/AUserAndTimeTrackingFields.vue'\nimport type { AnzuUserMinimal } from '@/shared/types/AnzuUser'\nimport type { CachedItem } from '@/domains/cached/composables/defineCached'\nimport type { UserAndTimeTrackingData, UserAndTimeTrackingUsers } from '@/shared/types/UserAndTimeTracking'\n\nexport interface CreateUserAndTimeTrackingFieldsOptions<U extends AnzuUserMinimal = AnzuUserMinimal> {\n  /**\n   * The admin's user cache composable, e.g. its `useCachedUsers`.\n   * Called once inside the component's setup, so the cache resolves in component scope.\n   */\n  useCachedUsers: () => UserAndTimeTrackingUsers<U>\n  /**\n   * Named route of a user's detail, e.g. `'/(common)/users/[id]'`. Without it the chip is not a link.\n   * A function is read on each render, so the link can follow the current user's permission for that route.\n   */\n  userRouteName?: string | (() => string | undefined)\n  /** URL of a user's detail in another admin, with `:id` replaced. Opens in a new tab. */\n  userExternalUrlTemplate?: string\n  /** The chip's label, for users that carry a better one than `person.fullName`. */\n  userTitleFn?: (user: CachedItem<U>) => string\n  /** Component name for devtools / warnings. */\n  name?: string\n}\n\n/**\n * Builds an admin's created / modified rows from its user cache and routes.\n * Each admin's `XTrackingFields.vue` becomes one factory call over\n * `AUserAndTimeTrackingFields`. `hide-*` props and the `user` slot fall through.\n *\n * Use in an SFC's plain `<script lang=\"ts\">`, not `setup`:\n * ```ts\n * export default createUserAndTimeTrackingFields({\n *   useCachedUsers,\n *   userRouteName: '/(common)/users/[id]',\n * })\n * ```\n */\nexport function createUserAndTimeTrackingFields<U extends AnzuUserMinimal = AnzuUserMinimal>(\n  options: CreateUserAndTimeTrackingFieldsOptions<U>\n): Component {\n  return defineComponent({\n    name: options.name ?? 'UserAndTimeTrackingFields',\n    inheritAttrs: false,\n    props: {\n      data: { type: Object as PropType<UserAndTimeTrackingData>, required: true },\n    },\n    setup(props, { attrs, slots }) {\n      const users = options.useCachedUsers()\n      return () =>\n        h(\n          AUserAndTimeTrackingFields,\n          {\n            data: props.data,\n            users,\n            userRouteName: isFunction(options.userRouteName) ? options.userRouteName() : options.userRouteName,\n            userExternalUrlTemplate: options.userExternalUrlTemplate,\n            userTitleFn: options.userTitleFn,\n            ...attrs,\n          },\n          slots\n        )\n    },\n  })\n}\n"],"mappings":";;;;AAuCA,SAAgBE,EACd,GACW;CACX,OAAOC,EAAgB;EACrB,MAAMC,EAAQ,QAAQ;EACtB,cAAc;EACd,OAAO,EACL,MAAM;GAAE,MAAM;GAA6C,UAAU;EAAK,EAC5E;EACA,MAAM,GAAO,EAAE,UAAO,YAAS;GAC7B,IAAMC,IAAQD,EAAQ,eAAe;GACrC,aACEE,EACEN,GACA;IACE,MAAMO,EAAM;IACZ;IACA,eAAeC,EAAWJ,EAAQ,aAAa,IAAIA,EAAQ,cAAc,IAAIA,EAAQ;IACrF,yBAAyBA,EAAQ;IACjC,aAAaA,EAAQ;IACrB,GAAGK;GACL,GACAC,CACF;EACJ;CACF,CAAC;AACH"}

package/dist/domains/cached/composables/defineCached.d.ts

@@ -0,0 +1,57 @@
+import { Ref } from 'vue';
+import { DocId, IntegerId } from '../../../shared/types/common';
+/**
+ * Why a fetch settled without resolving an item:
+ * - `notFound`: the server answered and the item was not among the results.
+ * - `forbidden`: the user may not read it (403). Asking again in this session cannot change that.
+ * - `error`: anything else. Network, timeout, 5xx, a 401 before session renewal,
+ * or a 404 of the whole request (a route or proxy answering, not a missing item).
+ */
+export type CachedUnresolvedReason = 'notFound' | 'forbidden' | 'error';
+/**
+ * `_unresolved`: the fetch settled without resolving the item. `_unresolvedReason` says why.
+ * Whether a later `add()` asks again depends on the reason (see `defineCached`).
+ */
+export type CachedItem<T extends object> = T & {
+    _loaded: boolean;
+    _unresolved?: boolean;
+    _unresolvedReason?: CachedUnresolvedReason;
+};
+export interface DefineCachedOptions {
+    /**
+     * Ask again on the next `add()` for an id the server did not return. Defaults
+     * to `true`, because an entity can be created after the first lookup.
+     * A user cache passes `false`. Otherwise an id missing from the table (a
+     * system user of another backend) is requested on every page that shows it.
+     */
+    retryNotFound?: boolean;
+    /**
+     * How many ids one `fetchCallback` call gets. Each call is
+     * committed on its own. Defaults to `FETCH_BY_IDS_BATCH_SIZE`.
+     * A backend with a lower per-request limit sets it here. Splitting inside
+     * the callback would make one failing part discard the parts already loaded.
+     */
+    batchSize?: number;
+}
+export type AddToCachedArgs<T extends DocId | IntegerId> = Array<T | null | undefined> | Array<Array<T | null | undefined> | T | null | undefined>;
+/**
+ * @template I Identifier type
+ * @template T Source type
+ * @template M Minimal type
+ */
+export declare function defineCached<I extends DocId | IntegerId, T extends Record<DocId | IntegerId, any>, M extends Record<DocId | IntegerId, any>>(mapFullToMinimal: (source: T) => M, mapIdToMinimal: (id: I) => M, fetchCallback: (ids: I[]) => Promise<T[]>, idProp?: string, maxLimit?: number, options?: DefineCachedOptions): {
+    cache: Ref<Map<I, CachedItem<M>>, Map<I, CachedItem<M>>>;
+    toFetch: Ref<Set<I>, Set<I>>;
+    fetch: () => import('@vueuse/shared').Promisify<Promise<T[]>>;
+    immediateFetch: () => Promise<T[]>;
+    add: (...args: AddToCachedArgs<I>) => void;
+    addManual: (data: T) => void;
+    addManualMinimal: (data: M) => void;
+    pin: (id: I | null | undefined) => void;
+    unpin: (id: I | null | undefined) => void;
+    has: (id: I | null | undefined) => boolean;
+    get: (id: I | null | undefined) => CachedItem<M> | undefined;
+    clear: () => void;
+    isLoaded: (id: I | null | undefined) => boolean;
+    isUnresolved: (id: I | null | undefined) => boolean;
+};