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

package/dist/domains/filters/components/FiltersSelected.vue_vue_type_script_setup_true_lang.js

@@ -1,16 +1,16 @@
-import { isArray as e, isUndefined as t } from "../../../shared/utils/common.js";
-import { FilterConfigKey as n, FilterDataKey as r, FilterSelectedKey as i } from "../utils/filterInjectionKeys.js";
+import { FilterConfigKey as e, FilterDataKey as t, FilterSelectedKey as n } from "../utils/filterInjectionKeys.js";
+import { isArray as r, isUndefined as i } from "../../../shared/utils/common.js";
 import { useFilterClearHelpers as a } from "../composables/filterFactory.js";
 import { Fragment as o, computed as s, createBlock as c, createElementBlock as l, createElementVNode as u, createTextVNode as d, createVNode as f, defineComponent as p, inject as m, openBlock as h, renderList as g, toDisplayString as _, withCtx as v, withModifiers as y } from "vue";
 import { useI18n as b } from "vue-i18n";
 import { VChip as x } from "vuetify/components/VChip";
 import { VIcon as S } from "vuetify/components/VIcon";
-//#region src/domains/filters/components/FiltersSelected.vue?vue&type=script&setup=true&lang.ts
+// src/domains/filters/components/FiltersSelected.vue?vue&type=script&setup=true&lang.ts
 var C = { class: "a-selected-filters__label text-body-small" }, w = /*@__PURE__*/ p({
 	__name: "FiltersSelected",
 	setup(p) {
-		let w = m(n), T = m(r), E = m(i);
-		if (t(w) || t(T) || t(E)) throw Error("Incorrect provide/inject config.");
+		let w = m(e), T = m(t), E = m(n);
+		if (i(w) || i(T) || i(E)) throw Error("Incorrect provide/inject config.");
 		let { t: D } = b(), O = (e) => {
 			let t = w.fields?.[e]?.titleT;
 			return t ? D(t) : e;
@@ -21,15 +21,15 @@ var C = { class: "a-selected-filters__label text-body-small" }, w = /*@__PURE__*
 				title: O(e),
 				options: t
 			})).sort((t, n) => e.indexOf(t.name) - e.indexOf(n.name));
-		}), { clearOneFilterSelected: A, isClearable: j } = a(), M = (t) => {
-			if (!j(t, w)) return !1;
-			let n = w.fields[t];
-			if (n.type === "timeInterval" && n.related) {
-				let e = w.fields[n.related];
-				if (T[n.related] !== e.default) return !0;
+		}), { clearOneFilterSelected: A, isClearable: j } = a(), M = (e) => {
+			if (!j(e, w)) return !1;
+			let t = w.fields[e];
+			if (t.type === "timeInterval" && t.related) {
+				let e = w.fields[t.related];
+				if (T[t.related] !== e.default) return !0;
 			}
-			let r = T[t];
-			return e(r) ? !0 : r !== n.default;
+			let n = T[e];
+			return r(n) ? !0 : n !== t.default;
 		}, N = (e, t) => {
 			A(e, t, T, w, E), w.touched = !0;
 		};
@@ -63,7 +63,6 @@ var C = { class: "a-selected-filters__label text-body-small" }, w = /*@__PURE__*
 		}, 1024))]))), 128))]))), 128));
 	}
 });
-//#endregion
 export { w as default };
 
 //# sourceMappingURL=FiltersSelected.vue_vue_type_script_setup_true_lang.js.map

package/dist/domains/filters/components/FiltersSelected.vue_vue_type_script_setup_true_lang.js.map

@@ -1 +1 @@
-{"version":3,"file":"FiltersSelected.vue_vue_type_script_setup_true_lang.js","names":["_openBlock","_createElementBlock","_Fragment","_renderList","_createElementVNode","_toDisplayString","_createBlock","_component_VChip","_withModifiers","_withCtx","_createVNode","_component_VIcon","_createTextVNode","_hoisted_1","FiltersSelected_vue_vue_type_script_setup_true_lang_default","filterConfig","inject","FilterConfigKey","filterData","FilterDataKey","filterSelected","FilterSelectedKey","isUndefined","useI18n","getTitleFromConfig","titleT","name","t","selectedArray","computed","fieldOrder","key","valueArray","a","b","useFilterClearHelpers","canClear","isClearable","config","related","value","isArray","clickClose","clearOneFilterSelected","optionValue","openBlock","createElementBlock","Fragment","renderList","item","createElementVNode","toDisplayString","option","createBlock","VChip","withModifiers","withCtx","createVNode","VIcon","createTextVNode"],"sources":["../../../../src/domains/filters/components/FiltersSelected.vue"],"sourcesContent":["<script lang=\"ts\" setup>\nimport { computed, inject } from 'vue'\nimport { FilterConfigKey, FilterDataKey, FilterSelectedKey } from '@/domains/filters/utils/filterInjectionKeys'\nimport { isArray, isUndefined } from '@/shared/utils/common'\nimport { useI18n } from 'vue-i18n'\nimport { useFilterClearHelpers } from '@/domains/filters/composables/filterFactory'\n\nconst filterConfig = inject(FilterConfigKey)\nconst filterData = inject(FilterDataKey)\nconst filterSelected = inject(FilterSelectedKey)\n\nif (isUndefined(filterConfig) || isUndefined(filterData) || isUndefined(filterSelected)) {\n  throw new Error('Incorrect provide/inject config.')\n}\n\nconst { t } = useI18n()\n\nconst getTitleFromConfig = (name: string) => {\n  const titleT = filterConfig.fields?.[name]?.titleT\n  if (titleT) return t(titleT)\n  return name\n}\n\nconst selectedArray = computed(() => {\n  const fieldOrder = Object.keys(filterConfig.fields)\n  return Array.from(filterSelected.value)\n    .filter(([key]) => filterConfig.fields?.[key]?.render?.selected !== false)\n    .map(([key, valueArray]) => ({\n      name: key,\n      title: getTitleFromConfig(key),\n      options: valueArray,\n    }))\n    .sort((a, b) => fieldOrder.indexOf(a.name) - fieldOrder.indexOf(b.name))\n})\n\nconst { clearOneFilterSelected, isClearable } = useFilterClearHelpers()\n\n/**\n * Clearing means \"back to the default\", so on a field already holding its default there is\n * nothing to clear and the close button would do nothing at all - it would drop the chip, write\n * the same value back, and the chip would come straight back. Only fields with a non-null default\n * can reach that state; an array is different, because closing one chip removes one option.\n */\nconst canClear = (name: string) => {\n  if (!isClearable(name, filterConfig)) return false\n  // `isClearable` has just read this same config, so it is there.\n  const config = filterConfig.fields[name]!\n  // A time interval is a pair sharing one chip, and clearing writes the default into both. Only\n  // `until` may differ - the custom dialog opens prefilled, so shortening just the upper bound\n  // leaves `from` at its default - and the button still has work to do then.\n  if (config.type === 'timeInterval' && config.related) {\n    // `createFilter` checked that the related field is configured.\n    const related = filterConfig.fields[config.related]!\n    if (filterData[config.related] !== related.default) return true\n  }\n  const value = filterData[name]\n  if (isArray(value)) return true\n  return value !== config.default\n}\n\nconst clickClose = (name: string, optionValue: number | string) => {\n  clearOneFilterSelected(name, optionValue, filterData, filterConfig, filterSelected)\n  filterConfig.touched = true\n}\n</script>\n\n<template>\n  <div\n    v-for=\"item in selectedArray\"\n    :key=\"item.name\"\n    class=\"a-selected-filters\"\n  >\n    <div class=\"a-selected-filters__label text-body-small\">{{ item.title }}:</div>\n    <div\n      v-for=\"option in item.options\"\n      :key=\"option.value\"\n      class=\"a-selected-filters__chips\"\n    >\n      <VChip\n        v-if=\"canClear(item.name)\"\n        closable\n        close-label=\"common.button.remove\"\n        size=\"small\"\n        class=\"a-selected-filters__chip\"\n        @click:close.stop=\"clickClose(item.name, option.value)\"\n      >\n        <template #close>\n          <VIcon\n            size=\"16\"\n            icon=\"mdi-close-circle\"\n          />\n        </template>\n        {{ option.title }}\n      </VChip>\n      <VChip\n        v-else\n        size=\"small\"\n        class=\"a-selected-filters__chip\"\n      >\n        {{ option.title }}\n      </VChip>\n    </div>\n  </div>\n</template>\n\n<style lang=\"scss\">\n.a-selected-filters {\n  display: inline-flex;\n  align-items: center;\n  background: #f5f5f5;\n  border-radius: 20px;\n  padding: 4px 4px 4px 12px;\n  margin: 0 4px 2px 0;\n  gap: 8px;\n  max-width: 100%;\n\n  &__label {\n    white-space: nowrap;\n  }\n\n  &__chips {\n    display: flex;\n    gap: 4px;\n    flex-wrap: wrap;\n  }\n\n  &__chip {\n    background: white;\n    box-shadow: none;\n\n    .v-chip__content {\n      max-width: 40vw;\n    }\n\n    &:hover .v-chip__close {\n      opacity: 0.8;\n    }\n  }\n\n  .v-chip__close {\n    opacity: 0.3;\n    transition: opacity 0.2s;\n  }\n}\n\n// Values above are hardcoded light, which renders white-on-white in dark theme.\n.v-theme--dark .a-selected-filters {\n  background: rgb(var(--v-theme-on-surface), 0.08);\n\n  .a-selected-filters__chip {\n    background: rgb(var(--v-theme-on-surface), 0.16);\n    color: rgb(var(--v-theme-on-surface));\n  }\n}\n</style>\n"],"mappings":";;;;;;;;;;;EAOA,IAAMe,IAAeC,EAAOC,CAAe,GACrCC,IAAaF,EAAOG,CAAa,GACjCC,IAAiBJ,EAAOK,CAAiB;EAE/C,IAAIC,EAAYP,CAAY,KAAKO,EAAYJ,CAAU,KAAKI,EAAYF,CAAc,GACpF,MAAU,MAAM,kCAAkC;EAGpD,IAAM,EAAE,SAAMG,EAAQ,GAEhBC,KAAsB,MAAiB;GAC3C,IAAMC,IAASV,EAAa,SAASW,EAAK,EAAE;GAE5C,OADID,IAAeE,EAAEF,CAAM,IACpBC;EACT,GAEME,IAAgBC,QAAe;GACnC,IAAMC,IAAa,OAAO,KAAKf,EAAa,MAAM;GAClD,OAAO,MAAM,KAAKK,EAAe,KAAK,CAAA,CACnC,QAAQ,CAACW,OAAShB,EAAa,SAASgB,EAAI,EAAE,QAAQ,aAAa,EAAK,CAAA,CACxE,KAAK,CAACA,GAAKC,QAAiB;IAC3B,MAAMD;IACN,OAAOP,EAAmBO,CAAG;IAC7B,SAASC;GACX,EAAE,CAAA,CACD,MAAM,GAAG,MAAMF,EAAW,QAAQG,EAAE,IAAI,IAAIH,EAAW,QAAQI,EAAE,IAAI,CAAC;EAC3E,CAAC,GAEK,EAAE,2BAAwB,mBAAgBC,EAAsB,GAQhEC,KAAY,MAAiB;GACjC,IAAI,CAACC,EAAYX,GAAMX,CAAY,GAAG,OAAO;GAE7C,IAAMuB,IAASvB,EAAa,OAAOW;GAInC,IAAIY,EAAO,SAAS,kBAAkBA,EAAO,SAAS;IAEpD,IAAMC,IAAUxB,EAAa,OAAOuB,EAAO;IAC3C,IAAIpB,EAAWoB,EAAO,aAAaC,EAAQ,SAAS,OAAO;GAC7D;GACA,IAAMC,IAAQtB,EAAWQ;GAEzB,OADIe,EAAQD,CAAK,IAAU,KACpBA,MAAUF,EAAO;EAC1B,GAEMI,KAAc,GAAc,MAAiC;GAEjE,AADAC,EAAuBjB,GAAMkB,GAAa1B,GAAYH,GAAcK,CAAc,GAClF,EAAa,UAAU;EACzB;E,kBAIEpB,EAAA,EAAA,GAAAC,EAmCMC,GAAA,MAAAC,EAlCWyB,EAAA,QAAR,OADT5B,EAAA,GAAAC,EAmCM,OAAA;GAjCH,KAAKgD,EAAK;GACX,OAAM;E,IAEN7C,EAA8E,OAA9ES,GAA8ER,EAApB4C,EAAK,KAAK,IAAG,KAAC,CAAA,IACxEjD,EAAA,EAAA,GAAAC,EA4BMC,GAAA,MAAAC,EA3Ba8C,EAAK,UAAf,OADTjD,EAAA,GAAAC,EA4BM,OAAA;GA1BH,KAAKmD,EAAO;GACb,OAAM;E,IAGEhB,EAASa,EAAK,IAAI,KAD1BjD,EAAA,GAAAM,EAeQC,GAAA;;GAbN,UAAA;GACA,eAAY;GACZ,MAAK;GACL,OAAM;GACL,iBAAWC,GAAA,MAAOkC,EAAWO,EAAK,MAAMG,EAAO,KAAK,GAAA,CAAA,MAAA,CAAA;;GAE1C,OAAK3C,QAIZ,CAHFC,EAGEC,GAAA;IAFA,MAAK;IACL,MAAK;;GAEE,SAAAF,QACX,CADWG,EAAA,MACXP,EAAG+C,EAAO,KAAK,GAAA,CAAA,C;;E,gCAEjBpD,EAAA,GAAAM,EAMQC,GAAA;;GAJN,MAAK;GACL,OAAM;;GAEN,SAAAE,QAAkB,CAAfG,EAAAP,EAAA+C,EAAO,KAAK,GAAA,CAAA,C"}
+{"version":3,"file":"FiltersSelected.vue_vue_type_script_setup_true_lang.js","names":["_openBlock","_createElementBlock","_Fragment","_renderList","_createElementVNode","_toDisplayString","_createBlock","_component_VChip","_withModifiers","_withCtx","_createVNode","_component_VIcon","_createTextVNode","_hoisted_1","FiltersSelected_vue_vue_type_script_setup_true_lang_default","filterConfig","inject","FilterConfigKey","filterData","FilterDataKey","filterSelected","FilterSelectedKey","isUndefined","useI18n","getTitleFromConfig","titleT","name","t","selectedArray","computed","fieldOrder","key","valueArray","a","b","useFilterClearHelpers","canClear","isClearable","config","related","value","isArray","clickClose","clearOneFilterSelected","optionValue","openBlock","createElementBlock","Fragment","renderList","item","createElementVNode","toDisplayString","option","createBlock","VChip","withModifiers","withCtx","createVNode","VIcon","createTextVNode"],"sources":["../../../../src/domains/filters/components/FiltersSelected.vue"],"sourcesContent":["<script lang=\"ts\" setup>\nimport { computed, inject } from 'vue'\nimport { FilterConfigKey, FilterDataKey, FilterSelectedKey } from '@/domains/filters/utils/filterInjectionKeys'\nimport { isArray, isUndefined } from '@/shared/utils/common'\nimport { useI18n } from 'vue-i18n'\nimport { useFilterClearHelpers } from '@/domains/filters/composables/filterFactory'\n\nconst filterConfig = inject(FilterConfigKey)\nconst filterData = inject(FilterDataKey)\nconst filterSelected = inject(FilterSelectedKey)\n\nif (isUndefined(filterConfig) || isUndefined(filterData) || isUndefined(filterSelected)) {\n  throw new Error('Incorrect provide/inject config.')\n}\n\nconst { t } = useI18n()\n\nconst getTitleFromConfig = (name: string) => {\n  const titleT = filterConfig.fields?.[name]?.titleT\n  if (titleT) return t(titleT)\n  return name\n}\n\nconst selectedArray = computed(() => {\n  const fieldOrder = Object.keys(filterConfig.fields)\n  return Array.from(filterSelected.value)\n    .filter(([key]) => filterConfig.fields?.[key]?.render?.selected !== false)\n    .map(([key, valueArray]) => ({\n      name: key,\n      title: getTitleFromConfig(key),\n      options: valueArray,\n    }))\n    .sort((a, b) => fieldOrder.indexOf(a.name) - fieldOrder.indexOf(b.name))\n})\n\nconst { clearOneFilterSelected, isClearable } = useFilterClearHelpers()\n\n/**\n * Clearing restores the default. On a field already at its non-null default, the close\n * button would drop the chip, write the same value, and the chip would come back.\n * Arrays differ: closing one chip removes one option.\n */\nconst canClear = (name: string) => {\n  if (!isClearable(name, filterConfig)) return false\n  // `isClearable` has just read this same config, so it is there.\n  const config = filterConfig.fields[name]!\n  // A time interval is a pair sharing one chip, and clearing writes the default into both.\n  // Only `until` may differ, because the custom dialog opens prefilled. The button still has work then.\n  if (config.type === 'timeInterval' && config.related) {\n    // `createFilter` checked that the related field is configured.\n    const related = filterConfig.fields[config.related]!\n    if (filterData[config.related] !== related.default) return true\n  }\n  const value = filterData[name]\n  if (isArray(value)) return true\n  return value !== config.default\n}\n\nconst clickClose = (name: string, optionValue: number | string) => {\n  clearOneFilterSelected(name, optionValue, filterData, filterConfig, filterSelected)\n  filterConfig.touched = true\n}\n</script>\n\n<template>\n  <div\n    v-for=\"item in selectedArray\"\n    :key=\"item.name\"\n    class=\"a-selected-filters\"\n  >\n    <div class=\"a-selected-filters__label text-body-small\">{{ item.title }}:</div>\n    <div\n      v-for=\"option in item.options\"\n      :key=\"option.value\"\n      class=\"a-selected-filters__chips\"\n    >\n      <VChip\n        v-if=\"canClear(item.name)\"\n        closable\n        close-label=\"common.button.remove\"\n        size=\"small\"\n        class=\"a-selected-filters__chip\"\n        @click:close.stop=\"clickClose(item.name, option.value)\"\n      >\n        <template #close>\n          <VIcon\n            size=\"16\"\n            icon=\"mdi-close-circle\"\n          />\n        </template>\n        {{ option.title }}\n      </VChip>\n      <VChip\n        v-else\n        size=\"small\"\n        class=\"a-selected-filters__chip\"\n      >\n        {{ option.title }}\n      </VChip>\n    </div>\n  </div>\n</template>\n\n<style lang=\"scss\">\n.a-selected-filters {\n  display: inline-flex;\n  align-items: center;\n  background: #f5f5f5;\n  border-radius: 20px;\n  padding: 4px 4px 4px 12px;\n  margin: 0 4px 2px 0;\n  gap: 8px;\n  max-width: 100%;\n\n  &__label {\n    white-space: nowrap;\n  }\n\n  &__chips {\n    display: flex;\n    gap: 4px;\n    flex-wrap: wrap;\n  }\n\n  &__chip {\n    background: white;\n    box-shadow: none;\n\n    .v-chip__content {\n      max-width: 40vw;\n    }\n\n    &:hover .v-chip__close {\n      opacity: 0.8;\n    }\n  }\n\n  .v-chip__close {\n    opacity: 0.3;\n    transition: opacity 0.2s;\n  }\n}\n\n// Values above are hardcoded light, which renders white-on-white in dark theme.\n.v-theme--dark .a-selected-filters {\n  background: rgb(var(--v-theme-on-surface), 0.08);\n\n  .a-selected-filters__chip {\n    background: rgb(var(--v-theme-on-surface), 0.16);\n    color: rgb(var(--v-theme-on-surface));\n  }\n}\n</style>\n"],"mappings":";;;;;;;;;;;EAOA,IAAMe,IAAeC,EAAOC,CAAe,GACrCC,IAAaF,EAAOG,CAAa,GACjCC,IAAiBJ,EAAOK,CAAiB;EAE/C,IAAIC,EAAYP,CAAY,KAAKO,EAAYJ,CAAU,KAAKI,EAAYF,CAAc,GACpF,MAAU,MAAM,kCAAkC;EAGpD,IAAM,EAAE,SAAMG,EAAQ,GAEhBC,KAAsB,MAAiB;GAC3C,IAAMC,IAASV,EAAa,SAASW,EAAK,EAAE;GAE5C,OADID,IAAeE,EAAEF,CAAM,IACpBC;EACT,GAEME,IAAgBC,QAAe;GACnC,IAAMC,IAAa,OAAO,KAAKf,EAAa,MAAM;GAClD,OAAO,MAAM,KAAKK,EAAe,KAAK,CAAA,CACnC,QAAQ,CAACW,OAAShB,EAAa,SAASgB,EAAI,EAAE,QAAQ,aAAa,EAAK,CAAA,CACxE,KAAK,CAACA,GAAKC,QAAiB;IAC3B,MAAMD;IACN,OAAOP,EAAmBO,CAAG;IAC7B,SAASC;GACX,EAAE,CAAA,CACD,MAAM,GAAG,MAAMF,EAAW,QAAQG,EAAE,IAAI,IAAIH,EAAW,QAAQI,EAAE,IAAI,CAAC;EAC3E,CAAC,GAEK,EAAE,2BAAwB,mBAAgBC,EAAsB,GAOhEC,KAAY,MAAiB;GACjC,IAAI,CAACC,EAAYX,GAAMX,CAAY,GAAG,OAAO;GAE7C,IAAMuB,IAASvB,EAAa,OAAOW;GAGnC,IAAIY,EAAO,SAAS,kBAAkBA,EAAO,SAAS;IAEpD,IAAMC,IAAUxB,EAAa,OAAOuB,EAAO;IAC3C,IAAIpB,EAAWoB,EAAO,aAAaC,EAAQ,SAAS,OAAO;GAC7D;GACA,IAAMC,IAAQtB,EAAWQ;GAEzB,OADIe,EAAQD,CAAK,IAAU,KACpBA,MAAUF,EAAO;EAC1B,GAEMI,KAAc,GAAc,MAAiC;GAEjE,AADAC,EAAuBjB,GAAMkB,GAAa1B,GAAYH,GAAcK,CAAc,GAClF,EAAa,UAAU;EACzB;E,kBAIEpB,EAAA,EAAA,GAAAC,EAmCMC,GAAA,MAAAC,EAlCWyB,EAAA,QAAR,OADT5B,EAAA,GAAAC,EAmCM,OAAA;GAjCH,KAAKgD,EAAK;GACX,OAAM;E,IAEN7C,EAA8E,OAA9ES,GAA8ER,EAApB4C,EAAK,KAAK,IAAG,KAAC,CAAA,IACxEjD,EAAA,EAAA,GAAAC,EA4BMC,GAAA,MAAAC,EA3Ba8C,EAAK,UAAf,OADTjD,EAAA,GAAAC,EA4BM,OAAA;GA1BH,KAAKmD,EAAO;GACb,OAAM;E,IAGEhB,EAASa,EAAK,IAAI,KAD1BjD,EAAA,GAAAM,EAeQC,GAAA;;GAbN,UAAA;GACA,eAAY;GACZ,MAAK;GACL,OAAM;GACL,iBAAWC,GAAA,MAAOkC,EAAWO,EAAK,MAAMG,EAAO,KAAK,GAAA,CAAA,MAAA,CAAA;;GAE1C,OAAK3C,QAIZ,CAHFC,EAGEC,GAAA;IAFA,MAAK;IACL,MAAK;;GAEE,SAAAF,QACX,CADWG,EAAA,MACXP,EAAG+C,EAAO,KAAK,GAAA,CAAA,C;;E,gCAEjBpD,EAAA,GAAAM,EAMQC,GAAA;;GAJN,MAAK;GACL,OAAM;;GAEN,SAAAE,QAAkB,CAAfG,EAAAP,EAAA+C,EAAO,KAAK,GAAA,CAAA,C"}

package/dist/domains/filters/composables/filterFactory.d.ts

@@ -8,13 +8,10 @@ export type FilterStoreIdentifier = {
     subject: string;
 };
 /**
- * Hash for a filter link, with values equal to their default left out.
- *
- * Pair it with `router.push({ name, hash })`, which needs the leading `#` — without it vue-router
- * glues the value onto the path instead. A hash still containing `%` (diacritics, `&`, `=`) does
- * not survive that trip; check with `isRouterSafeHash` and fall back to assigning
- * `window.location.hash` after navigating. Returns an empty string when nothing differs from
- * the defaults.
+ * Hash for a filter link, leaving out values equal to their default. Returns an empty string when nothing differs.
+ * Use with `router.push({ name, hash })`. The hash needs the leading `#`, or vue-router appends it to the path.
+ * A hash containing `%` (diacritics, `&`, `=`) does not survive the push. Check
+ * `isRouterSafeHash` and fall back to setting `window.location.hash` after navigating.
  */
 export declare function buildFilterHash<F extends readonly MakeFilterOption<string>[]>(filterConfig: FilterConfig<F>, filters: Partial<Record<keyof FilterData<F> & string, AllowedFilterValues>>, sortBy?: DatatableSortBy): string;
 /** Whether `router.push({ hash })` would leave the hash intact — see `buildFilterHash`. */
@@ -31,9 +28,10 @@ export declare function useFilterClearHelpers<F extends readonly MakeFilterOptio
     clearAllFilterSelected: (filterData: FilterData<F>, filterConfig: FilterConfig<F>, filterSelected: Ref<Map<string, ValueObjectOption<string | number>[]>>) => void;
     isClearable: (name: string, filterConfig: FilterConfig<F>) => boolean;
 };
-interface FilterHelpersMoreOptions {
+export interface FilterHelpersMoreOptions {
     storeFiltersLocalStorage: string | boolean;
     populateUrlParams: boolean;
+    pageStoreKey?: string;
 }
 export declare function useFilterHelpers<F extends readonly MakeFilterOption<string>[] = readonly MakeFilterOption<string>[]>(filterData: FilterData<F>, filterConfig: FilterConfig<F>, moreOptions?: Partial<FilterHelpersMoreOptions>): {
     loadStoredFilters: (pagination: Ref<Pagination>, callback?: AnyFn) => boolean;
@@ -45,6 +43,28 @@ export declare function useFilterHelpers<F extends readonly MakeFilterOption<str
         sortBy: DatatableSortBy;
     } | null;
 };
+/**
+ * Provides the filter (`FilterConfigKey`, `FilterDataKey`) and `pagination` (`DatatablePaginationKey`)
+ * to the filter bar and `ADatatablePagination` below, and wires the list to them.
+ * `getList` is a debounced `fetchList(pagination, filterData, filterConfig)` that resolves when
+ * the load finishes. A call superseded within the debounce resolves at once without loading.
+ * Submit, reset and sort go through `useFilterHelpers` (with `filterHelpersOptions`).
+ * On mount the stored filter and remembered page are restored before the first load.
+ * Use only for a datatable that is the parent of its filter bar. Wire it by hand when the first load skips the stored
+ * filter, `getList` adds logic, sort is custom, `fetchList` takes other arguments, or a parent renders the filter bar.
+ * @example
+ * const { filterData, filterConfig } = useFaqListFilter()
+ * const { fetchList, listItems } = useFaqListActions()
+ * const { pagination } = usePagination(SORT_BY_ID)
+ * const { getList, sortByChange, submitFilterAction, resetFilterAction
+ * } = useDatatableList(filterData, filterConfig, pagination, fetchList)
+ */
+export declare function useDatatableList<F extends readonly MakeFilterOption<string>[] = readonly MakeFilterOption<string>[], R = unknown>(filterData: FilterData<F>, filterConfig: FilterConfig<F>, pagination: Ref<Pagination>, fetchList: (pagination: Ref<Pagination>, filterData: FilterData<F>, filterConfig: FilterConfig<F>) => R, filterHelpersOptions?: Partial<FilterHelpersMoreOptions>): {
+    getList: import('@vueuse/shared').UseDebounceFnReturn<() => R>;
+    sortByChange: () => void;
+    submitFilterAction: () => void;
+    resetFilterAction: () => void;
+};
 export type AllowedFilterValues = number | number[] | string | string[] | null | undefined | boolean;
 export interface GeneralFilterOptions {
     system?: string;
@@ -102,4 +122,3 @@ export type FilterConfig<F extends readonly MakeFilterOption<string>[] = readonl
 export type FilterData<F extends readonly MakeFilterOption<string>[] = readonly MakeFilterOption<string>[]> = {
     [P in F[number]['name']]: AllowedFilterValues;
 };
-export {};

package/dist/domains/filters/composables/filterFactory.js

@@ -1,11 +1,12 @@
-import { cloneDeep as e, isArray as t, isBoolean as n, isEmptyArray as r, isEmptyObject as i, isNull as a, isNumber as o, isObject as s, isString as c, isUndefined as l } from "../../../shared/utils/common.js";
-import { stringToBooleanExact as u, stringToNumber as d } from "../../../shared/utils/string.js";
-import { datatablePageKey as f, useDatatablePageStore as p } from "../../system/store/datatablePageStore.js";
-import { DatatablePageStoreKey as m } from "../utils/filterInjectionKeys.js";
-import { SortOrder as h } from "../../api/types/SortOrder.js";
-import { getCurrentInstance as g, provide as _, reactive as v, toRaw as y } from "vue";
-//#region src/domains/filters/composables/filterFactory.ts
-var b = "_sort", x = "~", S = {
+import { datatablePageKey as e, useDatatablePageStore as t } from "../../system/store/datatablePageStore.js";
+import { DatatablePageStoreKey as n, DatatablePaginationKey as r, FilterConfigKey as i, FilterDataKey as a } from "../utils/filterInjectionKeys.js";
+import { cloneDeep as o, isArray as s, isBoolean as c, isEmptyArray as l, isEmptyObject as u, isNull as d, isNumber as f, isObject as p, isString as m, isUndefined as h } from "../../../shared/utils/common.js";
+import { SortOrder as g } from "../../api/types/SortOrder.js";
+import { stringToBooleanExact as _, stringToNumber as v } from "../../../shared/utils/string.js";
+import { getCurrentInstance as y, onMounted as b, provide as x, reactive as S, toRaw as C } from "vue";
+import { useDebounceFn as w } from "@vueuse/core";
+// src/domains/filters/composables/filterFactory.ts
+var T = "_sort", E = "~", D = {
 	"%2C": ",",
 	"%3A": ":",
 	"%2F": "/",
@@ -17,24 +18,24 @@ var b = "_sort", x = "~", S = {
 	"%29": ")",
 	"%3B": ";",
 	"%3F": "?"
-}, C = (e) => e.replace(/%(2C|3A|2F|40|24|21|27|28|29|3B|3F)/g, (e) => S[e]), w = (e, n) => t(e) && t(n) ? e.length === n.length && e.every((e, t) => e === n[t]) : e === n, T = (e, n) => {
-	let o = new URLSearchParams();
-	for (let n in e) {
-		let u = e[n];
-		l(u) || a(u) || t(u) && r(u) || s(u) && i(u) || c(u) && u.length === 0 || o.set(n, t(u) ? u.join(",") : String(u));
+}, O = (e) => e.replace(/%(2C|3A|2F|40|24|21|27|28|29|3B|3F)/g, (e) => D[e]), k = (e, t) => s(e) && s(t) ? e.length === t.length && e.every((e, n) => e === t[n]) : e === t, A = (e, t) => {
+	let n = new URLSearchParams();
+	for (let t in e) {
+		let r = e[t];
+		h(r) || d(r) || s(r) && l(r) || p(r) && u(r) || m(r) && r.length === 0 || n.set(t, s(r) ? r.join(",") : String(r));
 	}
-	return n && o.set(b, `${n.key},${n.order}`), o.size === 0 ? "" : C(o.toString()) + x;
+	return t && n.set(T, `${t.key},${t.order}`), n.size === 0 ? "" : O(n.toString()) + E;
 };
-function E(e, t, n) {
+function j(e, t, n) {
 	let r = {};
 	for (let [n, i] of Object.entries(t)) {
 		let t = e.fields[n];
-		l(t) || w(i, t.default) || (r[n] = i);
+		h(t) || k(i, t.default) || (r[n] = i);
 	}
-	let i = T(r, n);
+	let i = A(r, n);
 	return i.length === 0 ? i : "#" + i;
 }
-var D = (e) => !e.includes("%"), O = {
+var M = (e) => !e.includes("%"), N = {
 	skip: !1,
 	selected: !0,
 	xs: void 0,
@@ -43,209 +44,225 @@ var D = (e) => !e.includes("%"), O = {
 	lg: void 0,
 	xl: void 0
 };
-function k(t) {
-	return v(t.reduce((t, n) => ({
-		...t,
-		[n.name]: e(n.default)
+function P(e) {
+	return S(e.reduce((e, t) => ({
+		...e,
+		[t.name]: o(t.default)
 	}), {}));
 }
-function A(n, r, i) {
-	let a = n.reduce((n, r) => {
-		let a = r.name, o = e(r.default);
+function F(e, t, n) {
+	let r = e.reduce((e, t) => {
+		let r = t.name, i = o(t.default);
 		return {
-			...n,
-			[a]: {
-				name: a,
-				variant: j(r.variant, "eq"),
-				type: j(r.type, "custom"),
-				titleT: r.titleT ?? (i?.system && i?.subject && r.name ? `${i.system}.${i.subject}.filter.${r.name}` : void 0),
-				apiName: j(r.apiName, r.name),
-				clearable: j(r.clearable, !0),
-				mandatory: j(r.mandatory, !1),
-				multiple: t(o),
-				advanced: j(r.advanced, !1),
-				related: j(r.related, void 0),
-				exclude: j(r.exclude, !1),
-				default: o,
+			...e,
+			[r]: {
+				name: r,
+				variant: I(t.variant, "eq"),
+				type: I(t.type, "custom"),
+				titleT: t.titleT ?? (n?.system && n?.subject && t.name ? `${n.system}.${n.subject}.filter.${t.name}` : void 0),
+				apiName: I(t.apiName, t.name),
+				clearable: I(t.clearable, !0),
+				mandatory: I(t.mandatory, !1),
+				multiple: s(i),
+				advanced: I(t.advanced, !1),
+				related: I(t.related, void 0),
+				exclude: I(t.exclude, !1),
+				default: i,
 				render: {
-					...O,
-					...j(r.render, {})
+					...N,
+					...I(t.render, {})
 				}
 			}
 		};
 	}, {});
-	for (let e of Object.values(a)) if (e.related && !(e.related in a)) throw Error(`createFilter: "${e.name}" names related field "${e.related}", which is not configured`);
-	let o = {
+	for (let e of Object.values(r)) if (e.related && !(e.related in r)) throw Error(`createFilter: "${e.name}" names related field "${e.related}", which is not configured`);
+	let i = {
 		elastic: !1,
 		system: void 0,
 		subject: void 0,
 		simpleFilters: !1,
-		...i
+		...n
 	};
-	return o.elastic && (o.simpleFilters = !0), {
-		filterConfig: v({
-			general: o,
+	return i.elastic && (i.simpleFilters = !0), {
+		filterConfig: S({
+			general: i,
 			touched: !1,
-			fields: a
+			fields: r
 		}),
-		filterData: r
+		filterData: t
 	};
 }
-function j(e, t) {
-	return l(e) ? t : e;
+function I(e, t) {
+	return h(e) ? t : e;
 }
-function M() {
-	let r = (t, n, r) => {
-		r.fields[t]?.clearable && (n[t] = e(r.fields[t].default));
-	}, i = (e, t) => {
-		for (let n in t.fields) r(n, e, t);
-	}, a = (e, r, i, a, s) => {
-		if (!l(e, a)) return;
-		let u = a.fields[e], d = s.value.get(e);
-		if (d && d.length === 1) s.value.delete(e);
-		else if (d) {
-			let e = d.findIndex((e) => e.value === r);
-			e !== -1 && d.splice(e, 1);
+function L() {
+	let e = (e, t, n) => {
+		n.fields[e]?.clearable && (t[e] = o(n.fields[e].default));
+	}, t = (t, n) => {
+		for (let r in n.fields) e(r, t, n);
+	}, n = (e, t, n, r, a) => {
+		if (!i(e, r)) return;
+		let o = r.fields[e], l = a.value.get(e);
+		if (l && l.length === 1) a.value.delete(e);
+		else if (l) {
+			let e = l.findIndex((e) => e.value === t);
+			e !== -1 && l.splice(e, 1);
 		}
-		if (u.type === "timeInterval" && u.related) i[e] = u.default, i[u.related] = a.fields[u.related].default;
-		else if (t(i[e]) && i[e].length > 0) {
-			let t = i[e].findIndex((e) => String(e) === String(r));
-			if (t !== -1) {
-				let n = [...y(i[e])];
-				n.splice(t, 1), i[e] = n;
+		if (o.type === "timeInterval" && o.related) n[e] = o.default, n[o.related] = r.fields[o.related].default;
+		else if (s(n[e]) && n[e].length > 0) {
+			let r = n[e].findIndex((e) => String(e) === String(t));
+			if (r !== -1) {
+				let t = [...C(n[e])];
+				t.splice(r, 1), n[e] = t;
 			}
-		} else (c(i[e]) || o(i[e]) || n(i[e])) && (i[e] = u.default);
-	}, s = (e, t, n) => {
-		for (let e of n.value.keys()) l(e, t) && n.value.delete(e);
-	}, l = (e, t) => {
+		} else (m(n[e]) || f(n[e]) || c(n[e])) && (n[e] = o.default);
+	}, r = (e, t, n) => {
+		for (let e of n.value.keys()) i(e, t) && n.value.delete(e);
+	}, i = (e, t) => {
 		let n = t.fields[e];
 		return !(n.mandatory || !n.clearable);
 	};
 	return {
-		clearOne: r,
-		clearAll: i,
-		clearOneFilterSelected: a,
-		clearAllFilterSelected: s,
-		isClearable: l
+		clearOne: e,
+		clearAll: t,
+		clearOneFilterSelected: n,
+		clearAllFilterSelected: r,
+		isClearable: i
 	};
 }
-var N = {
+var R = {
 	storeFiltersLocalStorage: !0,
 	populateUrlParams: !0
 };
-function P(e, t, o = {}) {
-	let v = {
-		...N,
-		...o
-	}, y;
-	c(v.storeFiltersLocalStorage) ? y = v.storeFiltersLocalStorage : n(v.storeFiltersLocalStorage) && !0 === v.storeFiltersLocalStorage && c(t.general.system) && c(t.general.subject) && (y = "tableFilter_" + t.general.system + "_" + t.general.subject);
-	let S = c(v.storeFiltersLocalStorage) ? v.storeFiltersLocalStorage : f(t.general.system, t.general.subject);
-	g() && _(m, S);
-	let { clearAll: C } = M(), E = () => {
-		let n = {};
-		for (let i in e) try {
-			let o = i, s = e[o];
-			!l(s) && !a(s) && !r(s) && !w(s, t.fields[o].default) && (n[i] = s);
+function z(r, i, a = {}) {
+	let o = {
+		...R,
+		...a
+	}, s;
+	m(o.storeFiltersLocalStorage) ? s = o.storeFiltersLocalStorage : c(o.storeFiltersLocalStorage) && !0 === o.storeFiltersLocalStorage && m(i.general.system) && m(i.general.subject) && (s = "tableFilter_" + i.general.system + "_" + i.general.subject);
+	let f = o.pageStoreKey ?? (m(o.storeFiltersLocalStorage) ? o.storeFiltersLocalStorage : e(i.general.system, i.general.subject));
+	y() && x(n, f);
+	let { consumeStoredPage: b, getStoredRowsPerPage: S, getStoredView: C, setStoredPage: w } = t(), D = (e) => A(F(), e), O = (e) => w(f, e.value.page, e.value.rowsPerPage, D(e.value.sortBy)), j = o.populateUrlParams || !h(s), M = (e) => {
+		let t = b(f);
+		if (t === null || j) return t;
+		let n = C(f);
+		return n === null || n === D(e) ? t : null;
+	}, N = (e, t) => t === null ? e.value.rowsPerPage : S(f) ?? e.value.rowsPerPage, { clearAll: P } = L(), F = () => {
+		let e = {};
+		for (let t in r) try {
+			let n = t, a = r[n];
+			h(a) || d(a) || l(a) || k(a, i.fields[n].default) || (e[t] = a);
 		} catch {}
-		return n;
-	}, D = (e, t, n) => T(e, n ? t.value.sortBy : void 0), O = (e) => {
+		return e;
+	}, I = (e, t, n) => A(e, n ? t.value.sortBy : void 0), z = (e) => {
 		if (!e) return null;
 		e.startsWith("#") && (e = e.substring(1));
-		let n = e.indexOf(x);
-		if (n === -1) return null;
-		e = e.slice(0, n);
-		let r = new URLSearchParams(e), o = {}, s = null, c = r.get(b);
-		if (c) {
-			let [e, t] = c.split(",");
-			e && (t === h.Asc || t === h.Desc) && (s = {
+		let t = e.indexOf(E);
+		if (t === -1) return null;
+		e = e.slice(0, t);
+		let n = new URLSearchParams(e), r = {}, a = null, o = n.get(T);
+		if (o) {
+			let [e, t] = o.split(",");
+			e && (t === g.Asc || t === g.Desc) && (a = {
 				key: e,
 				order: t
-			}), r.delete(b);
+			}), n.delete(T);
 		}
-		for (let [e, n] of r.entries()) {
-			let r = t.fields[e];
-			if (l(r)) console.error(`Filter config not found for ${e}`);
-			else if (r.multiple ?? !1) {
-				let t = n.split(",");
-				o[e] = t.every((e) => e !== "" && String(Number(e)) === e) ? t.map(Number) : t;
-			} else o[e] = n;
+		for (let [e, t] of n.entries()) {
+			let n = i.fields[e];
+			if (h(n)) console.error(`Filter config not found for ${e}`);
+			else if (n.multiple ?? !1) {
+				let n = t.split(",");
+				r[e] = n.every((e) => e !== "" && String(Number(e)) === e) ? n.map(Number) : n;
+			} else r[e] = t;
 		}
-		return i(o) && a(s) ? null : {
-			filters: o,
-			sortBy: s
+		return u(r) && d(a) ? null : {
+			filters: r,
+			sortBy: a
 		};
-	}, k = (e) => {
-		let t = window.location.pathname + window.location.search + e, n = window.history.state, r = s(n) && c(n.current) ? {
+	}, B = (e) => {
+		let t = window.location.pathname + window.location.search + e, n = window.history.state, r = p(n) && m(n.current) ? {
 			...n,
 			current: (n.current.split("#")[0] ?? "") + e
 		} : n;
 		window.history.replaceState(r, "", t);
-	}, A = (e) => {
-		v.populateUrlParams !== !1 && k("#" + e);
-	}, j = () => {
-		v.populateUrlParams !== !1 && k("");
-	}, P = () => v.populateUrlParams === !1 ? null : O(window.location.hash), F = (e) => {
-		y && localStorage && localStorage.setItem(y, e);
-	}, I = () => {
-		if (!y || !localStorage) return null;
-		let e = localStorage.getItem(y);
-		return !e || !c(e) ? null : O(e);
+	}, V = (e) => {
+		o.populateUrlParams !== !1 && B("#" + e);
+	}, H = () => {
+		o.populateUrlParams !== !1 && B("");
+	}, U = () => o.populateUrlParams === !1 ? null : z(window.location.hash), W = (e) => {
+		s && localStorage && localStorage.setItem(s, e);
+	}, G = () => {
+		if (!s || !localStorage) return null;
+		let e = localStorage.getItem(s);
+		return !e || !m(e) ? null : z(e);
 	};
 	return {
-		loadStoredFilters: (n, r) => {
-			let { consumeStoredPage: o } = p(), s = "hash", f = P();
-			if (a(f) && (s = "localStorage", f = I()), a(f) || i(f.filters) && a(f.sortBy)) {
-				let e = o(S);
-				return e !== null && (n.value = {
-					...n.value,
-					page: e
-				}), r && r(), !1;
+		loadStoredFilters: (e, t) => {
+			let n = "hash", a = U();
+			if (d(a) && (n = "localStorage", a = G()), d(a) || u(a.filters) && d(a.sortBy)) {
+				let n = M(e.value.sortBy);
+				return n !== null && (e.value = {
+					...e.value,
+					page: n,
+					rowsPerPage: N(e, n)
+				}), O(e), t && t(), !1;
 			}
-			let m = s === "hash" && !i(f.filters);
-			m && C(e, t);
-			for (let t in e) {
-				let n = t, r = f.filters[n];
-				if (!l(r)) {
-					if (c(r)) {
-						let e = d(r);
-						if (!a(e) && String(e) === r) r = e;
+			let o = n === "hash" && !u(a.filters);
+			o && P(r, i);
+			for (let e in r) {
+				let t = e, n = a.filters[t];
+				if (!h(n)) {
+					if (m(n)) {
+						let e = v(n);
+						if (!d(e) && String(e) === n) n = e;
 						else {
-							let e = u(r);
-							a(e) || (r = e);
+							let e = _(n);
+							d(e) || (n = e);
 						}
 					}
-					e[n] = r;
+					r[t] = n;
 				}
 			}
-			if (s === "localStorage" && y && localStorage) {
-				let e = localStorage.getItem(y);
-				e && A(e);
+			if (n === "localStorage" && s && localStorage) {
+				let e = localStorage.getItem(s);
+				e && V(e);
 			}
-			let h = o(S);
-			return n.value = {
-				...n.value,
-				sortBy: f.sortBy ?? n.value.sortBy,
-				page: h ?? (s === "hash" ? 1 : n.value.page)
-			}, m && F(D(E(), n, !0)), r && r(), !0;
+			let c = a.sortBy ?? e.value.sortBy, l = M(c);
+			return e.value = {
+				...e.value,
+				sortBy: c,
+				page: l ?? (n === "hash" ? 1 : e.value.page),
+				rowsPerPage: N(e, l)
+			}, O(e), o && W(I(F(), e, !0)), t && t(), !0;
 		},
-		resetFilter: (e, n) => {
+		resetFilter: (e, t) => {
 			e.value = {
 				...e.value,
 				page: 1
-			}, y && localStorage && localStorage.removeItem(y), j(), t.touched = !1, n && n();
+			}, O(e), s && localStorage && localStorage.removeItem(s), H(), i.touched = !1, t && t();
 		},
-		submitFilter: (e, n) => {
-			let r = E(), i = D(r, e, !0);
-			A(i), F(i), e.value = {
+		submitFilter: (e, t) => {
+			let n = F(), r = I(n, e, !0);
+			V(r), W(r), e.value = {
 				...e.value,
 				page: 1
-			}, t.touched = !1, n && n();
+			}, O(e), i.touched = !1, t && t();
 		},
-		serializeFilters: D,
-		deserializeFilters: O
+		serializeFilters: I,
+		deserializeFilters: z
+	};
+}
+function B(e, t, n, o, s = {}) {
+	x(i, t), x(a, e), x(r, n);
+	let { resetFilter: c, submitFilter: l, loadStoredFilters: u } = z(e, t, s), d = w(() => o(n, e, t)), f = () => l(n, d);
+	return b(() => u(n, d)), {
+		getList: d,
+		sortByChange: f,
+		submitFilterAction: f,
+		resetFilterAction: () => c(n, d)
 	};
 }
-//#endregion
-export { E as buildFilterHash, A as createFilter, k as createFilterStore, D as isRouterSafeHash, M as useFilterClearHelpers, P as useFilterHelpers };
+export { j as buildFilterHash, F as createFilter, P as createFilterStore, M as isRouterSafeHash, B as useDatatableList, L as useFilterClearHelpers, z as useFilterHelpers };
 
 //# sourceMappingURL=filterFactory.js.map