@mittwald/flow-react-components 1.5.0-next.9 → 1.5.1

package/dist/js/packages/components-base/src/list/filter/ListDateRangeFilter.mjs

@@ -0,0 +1,29 @@
+"use client"
+/* */
+import { ListFilter } from "./ListFilter.mjs";
+import { applyDateRangeColumnDef, isListDateRange } from "./dateRange.mjs";
+//#region ../components-base/src/list/filter/ListDateRangeFilter.ts
+/**
+* A filter over a span of days rather than over a set of values.
+*
+* Everything except the control that picks the range: the table column, the
+* comparison and the stored value are the same in every binding, and what a
+* calendar looks like is not. A binding subclasses this to add its own calendar
+* options.
+*/
+var ListDateRangeFilter = class extends ListFilter {
+	updateTableColumnDef(def) {
+		applyDateRangeColumnDef(def);
+	}
+	getValue() {
+		const value = super.getValue();
+		return isListDateRange(value) ? value : null;
+	}
+	setValue(range) {
+		this.getTableColumn().setFilterValue(range);
+	}
+};
+//#endregion
+export { ListDateRangeFilter, ListDateRangeFilter as default };
+
+//# sourceMappingURL=ListDateRangeFilter.mjs.map

package/dist/js/packages/components-base/src/list/filter/ListDateRangeFilter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListDateRangeFilter.mjs","names":[],"sources":["../../../../../../../../components-base/src/list/filter/ListDateRangeFilter.ts"],"sourcesContent":["import { ListFilter } from \"./ListFilter\";\nimport {\n  applyDateRangeColumnDef,\n  isListDateRange,\n  type ListDateRange,\n} from \"./dateRange\";\nimport type { PropertyName } from \"../types\";\nimport type { ColumnDef } from \"@tanstack/table-core\";\n\n/**\n * A filter over a span of days rather than over a set of values.\n *\n * Everything except the control that picks the range: the table column, the\n * comparison and the stored value are the same in every binding, and what a\n * calendar looks like is not. A binding subclasses this to add its own calendar\n * options.\n */\nexport class ListDateRangeFilter<\n  T = never,\n  TProp extends PropertyName<T> = never,\n  TRendered = unknown,\n> extends ListFilter<T, TProp, never, TRendered> {\n  public override updateTableColumnDef(def: ColumnDef<T>): void {\n    applyDateRangeColumnDef(def);\n  }\n\n  public override getValue(): ListDateRange | null {\n    const value = super.getValue();\n    return isListDateRange(value) ? value : null;\n  }\n\n  public setValue(range: ListDateRange | null): void {\n    this.getTableColumn().setFilterValue(range);\n  }\n}\n\nexport default ListDateRangeFilter;\n"],"mappings":";;;;;;;;;;;;;AAiBA,IAAa,sBAAb,cAIU,WAAuC;CAC/C,qBAAqC,KAAyB;EAC5D,wBAAwB,GAAG;CAC7B;CAEA,WAAiD;EAC/C,MAAM,QAAQ,MAAM,SAAS;EAC7B,OAAO,gBAAgB,KAAK,IAAI,QAAQ;CAC1C;CAEA,SAAgB,OAAmC;EACjD,KAAK,eAAe,CAAC,CAAC,eAAe,KAAK;CAC5C;AACF"}

package/dist/js/packages/components-base/src/list/filter/ListFilter.mjs

@@ -0,0 +1,229 @@
+"use client"
+/* */
+import { toArray } from "../../lib/array.mjs";
+import { getListColumn } from "../ListModelContext.mjs";
+import { ListFilterValue } from "./ListFilterValue.mjs";
+import { difference, unique } from "remeda";
+import { getProperty } from "dot-prop";
+//#region ../components-base/src/list/filter/ListFilter.ts
+var equalsPropertyMatcher = (filterValue, propertyValue) => filterValue === propertyValue;
+/** From how many values on a multiple-choice filter offers "Select all". */
+var selectAllMinValueCount = 6;
+var stringCastRenderMethod = (value) => String(value);
+/**
+* One filter of a list: its values, which of them are on, and how that is
+* persisted.
+*
+* Framework-free apart from one thing, which is why `TRendered` exists: a
+* filter value has to be _shown_, and what "shown" is belongs to the binding.
+* React's `Filter` fills it with `ReactNode`; the default is `unknown`, so the
+* core can be read without deciding.
+*
+* The selected values live in the TanStack table's column filter, not here.
+* This translates: ids to values, values to a predicate, a toggle to a new
+* column filter.
+*/
+var ListFilter = class {
+	_values;
+	valuesFromTableState;
+	context;
+	property;
+	mode;
+	matcher;
+	renderItem;
+	name;
+	autosave;
+	manualSave;
+	onFilterChangeCallbacks = /* @__PURE__ */ new Set();
+	defaultSelectedValues;
+	priority;
+	storageKey;
+	constructor(context, shape) {
+		const { autosave = context.settingsDefaults?.filters?.autosave ?? false, manualSave = context.settingsDefaults?.filters?.manualSave ?? true, property, mode = "some", values, matcher = equalsPropertyMatcher, renderItem = stringCastRenderMethod, priority = "primary", name, defaultSelected, onChange } = shape;
+		this.context = context;
+		this.autosave = autosave;
+		this.manualSave = manualSave;
+		this.property = property;
+		this.storageKey = String(property);
+		this.mode = mode;
+		this._values = values?.map((v) => ListFilterValue.create(this, v));
+		this.matcher = matcher;
+		this.renderItem = renderItem;
+		this.name = name;
+		this.priority = priority;
+		this.defaultSelectedValues = defaultSelected?.map((v) => ListFilterValue.create(this, v));
+		if (onChange) this.onFilterChangeCallbacks.add(onChange);
+	}
+	updateInitialState(initialState) {
+		const initialIds = this.getInitialSelectedIds();
+		if (initialIds?.length) initialState.columnFilters = [...initialState.columnFilters ?? [], {
+			id: this.property,
+			value: initialIds
+		}];
+	}
+	getInitialSelectedIds() {
+		return this.getStoredSelectedIds({
+			autosave: this.autosave,
+			manualSave: this.manualSave
+		}) ?? this.defaultSelectedValues?.map((v) => v.id);
+	}
+	getStoredSelectedIds(options) {
+		return this.context.settings?.get("activeFilters", options)?.[this.storageKey];
+	}
+	getStoredSelectedValues(options) {
+		return this.getStoredSelectedIds(options)?.map((id) => this.values.find((v) => v.id === id)).filter((v) => v !== void 0);
+	}
+	/**
+	* Writes every filter's selection in one go — they share a settings key.
+	*
+	* Takes the two members it reads rather than a `ListFilter<any, …>`: a
+	* `Table<never>` is not assignable to a `Table<any>` (a row model sits in a
+	* contravariant position deep inside), so a list of concrete filters would
+	* not go in.
+	*/
+	static storeFilters(context, filters, options) {
+		const data = Object.fromEntries(filters.map((filter) => [filter.storageKey, filter.getArrayValue().map((v) => v.id)]));
+		context.settings?.store("activeFilters", data, options);
+	}
+	updateTableColumnDef(def) {
+		def.enableColumnFilter = true;
+		def.filterFn = this.getTableFilterFn();
+	}
+	getTableFilterFn() {
+		return (row, _, filterValue) => {
+			const propertyAsString = this.property;
+			const filterBy = propertyAsString.startsWith("$") ? row.original : getProperty(row.original, propertyAsString);
+			return this.checkFilterMatches(filterBy, filterValue);
+		};
+	}
+	checkFilterMatches(property, filterValueInput) {
+		if (filterValueInput === null) return true;
+		const predicate = (filterValue) => this.matcher(filterValue.value, property);
+		const toFilterValue = (something) => ListFilterValue.create(this, something);
+		if (this.mode === "all") return toArray(filterValueInput).map(toFilterValue).every(predicate);
+		else if (this.mode === "some") {
+			const filterArr = toArray(filterValueInput);
+			return filterArr.length === 0 || filterArr.map(toFilterValue).some(predicate);
+		} else if (this.mode === "one") return predicate(toFilterValue(Array.isArray(filterValueInput) ? filterValueInput[0] : filterValueInput));
+		throw new Error(`Unknown filter mode '${this.mode}'`);
+	}
+	getTableColumnFilter() {
+		return this.context.dataTable.getState().columnFilters.find((f) => f.id === this.property);
+	}
+	getTableColumn() {
+		return getListColumn(this.context.dataTable, this.property);
+	}
+	getValue() {
+		return this.getTableColumnFilter()?.value ?? null;
+	}
+	getValuesFromTableState() {
+		const facets = this.getTableColumn().getFacetedUniqueValues();
+		if (this.valuesFromTableState?.facets !== facets) this.valuesFromTableState = {
+			facets,
+			values: unique(Array.from(facets.keys()).flatMap((v) => v).filter((v) => v !== void 0 && v !== null)).map((v) => ListFilterValue.create(this, v))
+		};
+		return this.valuesFromTableState.values;
+	}
+	checkIfValueIsUnknown(value) {
+		return !this.values.some((v) => v.id === value.id);
+	}
+	/**
+	* Drops a selection the data no longer offers — a stored filter value whose
+	* item is gone would otherwise filter everything away with no way to undo
+	* it.
+	*/
+	deleteUnknownFilterValues() {
+		if (this._values === void 0) return;
+		for (const currentValues of this.getArrayValue()) if (this.checkIfValueIsUnknown(currentValues)) this.deactivateValue(currentValues);
+	}
+	/**
+	* The values the filter offers — the ones it was given, or the ones the data
+	* has.
+	*
+	* Follows the table, not a snapshot. A binding that keeps one filter instance
+	* for the list's lifetime would otherwise hold the answer from before the
+	* first batch arrived: an async loader gives the header an empty menu and
+	* never fills it. The values are cached per faceted-values map, which
+	* TanStack replaces when the data changes.
+	*/
+	get values() {
+		return this._values ?? this.getValuesFromTableState();
+	}
+	getArrayValue() {
+		const value = this.getValue();
+		return value === null ? [] : toArray(value).map((v) => ListFilterValue.create(this, v));
+	}
+	isValueActive(value) {
+		return this.getArrayValue().some((v) => v.equals(value));
+	}
+	isActive() {
+		return this.getArrayValue().length > 0;
+	}
+	deactivateValue(value) {
+		const currentValueAsArray = this.getArrayValue();
+		const updatedValue = this.mode === "all" || this.mode === "some" ? currentValueAsArray.filter((v) => !v.equals(value)) : null;
+		this.getTableColumn().setFilterValue(updatedValue);
+		this.callOnChangedHandlers(updatedValue);
+	}
+	callOnChangedHandlers(newValue) {
+		const values = toArray(newValue).map((v) => v?.value);
+		this.onFilterChangeCallbacks.forEach((cb) => cb(values));
+	}
+	hasChanges() {
+		const currentIds = this.getArrayValue().map((v) => v.id);
+		const defaultIds = this.getStoredSelectedIds({ autosave: false }) ?? this.defaultSelectedValues?.map((v) => v.id) ?? [];
+		return currentIds.length !== defaultIds.length || difference(currentIds, defaultIds).length > 0;
+	}
+	isStoringAvailable() {
+		return !!this.context.settings && this.manualSave;
+	}
+	resetValues() {
+		const resetTo = this.getStoredSelectedValues({ autosave: false }) ?? this.defaultSelectedValues ?? (this.mode === "all" || this.mode === "some" ? [] : null);
+		this.getTableColumn().setFilterValue(resetTo);
+		this.callOnChangedHandlers(resetTo);
+	}
+	clear() {
+		this.getTableColumn().setFilterValue(null);
+		this.callOnChangedHandlers(null);
+	}
+	toggleValue(newValue) {
+		const currentValueAsArray = this.getArrayValue();
+		let updatedValue;
+		if (this.mode === "all" || this.mode === "some") updatedValue = newValue.isActive ? currentValueAsArray.filter((v) => !v.equals(newValue)) : [...currentValueAsArray, newValue];
+		else updatedValue = newValue.isActive ? null : newValue;
+		this.getTableColumn().setFilterValue(updatedValue);
+		this.callOnChangedHandlers(updatedValue);
+	}
+	/**
+	* Whether the filter offers "Select all" — a `some` filter with enough
+	* values.
+	*/
+	get isSelectAllAvailable() {
+		return this.mode === "some" && this.values.length >= selectAllMinValueCount;
+	}
+	isEveryValueActive() {
+		return this.values.every((v) => v.isActive);
+	}
+	selectAll() {
+		this.setArrayValue(this.values);
+	}
+	/** Makes exactly these values active — what a multiple-selection menu reports. */
+	setActiveValueIds(ids) {
+		const idSet = new Set(ids);
+		this.setArrayValue(this.values.filter((v) => idSet.has(v.id)));
+	}
+	deselectAll() {
+		this.setArrayValue([]);
+	}
+	setArrayValue(value) {
+		this.getTableColumn().setFilterValue(value);
+		this.callOnChangedHandlers(value);
+	}
+	onFilterUpdated(cb) {
+		this.onFilterChangeCallbacks.add(cb);
+	}
+};
+//#endregion
+export { ListFilter, ListFilter as default };
+
+//# sourceMappingURL=ListFilter.mjs.map

package/dist/js/packages/components-base/src/list/filter/ListFilter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListFilter.mjs","names":[],"sources":["../../../../../../../../components-base/src/list/filter/ListFilter.ts"],"sourcesContent":["import { toArray } from \"../../lib/array\";\nimport { getListColumn, type ListModelContext } from \"../ListModelContext\";\nimport type { ListSettingsOperationOptions } from \"../settings/types\";\nimport { customPropertyPrefix } from \"../types\";\nimport type { PropertyName, PropertyValueRenderMethod } from \"../types\";\nimport { ListFilterValue } from \"./ListFilterValue\";\nimport type {\n  FilterMatcher,\n  FilterMode,\n  FilterUpdatedCallback,\n  ListFilterShape,\n} from \"./types\";\nimport type {\n  Column,\n  ColumnDef,\n  ColumnFilter,\n  InitialTableState,\n} from \"@tanstack/table-core\";\nimport { getProperty } from \"dot-prop\";\nimport { difference, unique } from \"remeda\";\n\nconst equalsPropertyMatcher: FilterMatcher<unknown, never, never> = (\n  filterValue,\n  propertyValue,\n) => filterValue === propertyValue;\n\n/** From how many values on a multiple-choice filter offers \"Select all\". */\nconst selectAllMinValueCount = 6;\n\nconst stringCastRenderMethod: PropertyValueRenderMethod<unknown, never> = (\n  value,\n) => String(value) as never;\n\n/** What `storeFilters` needs of a filter, and nothing more. */\ninterface StorableFilter {\n  readonly storageKey: string;\n  getArrayValue(): { id: string }[];\n}\n\n/**\n * One filter of a list: its values, which of them are on, and how that is\n * persisted.\n *\n * Framework-free apart from one thing, which is why `TRendered` exists: a\n * filter value has to be _shown_, and what \"shown\" is belongs to the binding.\n * React's `Filter` fills it with `ReactNode`; the default is `unknown`, so the\n * core can be read without deciding.\n *\n * The selected values live in the TanStack table's column filter, not here.\n * This translates: ids to values, values to a predicate, a toggle to a new\n * column filter.\n */\nexport class ListFilter<\n  T = never,\n  TProp extends PropertyName<T> = never,\n  TMatchValue = never,\n  TRendered = unknown,\n> {\n  private _values?: ListFilterValue<TRendered>[] | undefined;\n  private valuesFromTableState?: {\n    facets: Map<unknown, number>;\n    values: ListFilterValue<TRendered>[];\n  };\n  public readonly context: ListModelContext<T>;\n  public readonly property: TProp;\n  public readonly mode: FilterMode;\n  public readonly matcher: FilterMatcher<T, never, never>;\n  public readonly renderItem: PropertyValueRenderMethod<TMatchValue, TRendered>;\n  public readonly name?: string;\n  public readonly autosave: boolean;\n  public readonly manualSave: boolean;\n  private readonly onFilterChangeCallbacks = new Set<FilterUpdatedCallback>();\n  private readonly defaultSelectedValues?: ListFilterValue<TRendered>[];\n  public readonly priority: \"primary\" | \"secondary\";\n  public readonly storageKey: string;\n\n  public constructor(\n    context: ListModelContext<T>,\n    shape: ListFilterShape<T, TProp, TMatchValue, TRendered>,\n  ) {\n    const {\n      autosave = context.settingsDefaults?.filters?.autosave ?? false,\n      manualSave = context.settingsDefaults?.filters?.manualSave ?? true,\n      property,\n      mode = \"some\",\n      values,\n      matcher = equalsPropertyMatcher,\n      renderItem = stringCastRenderMethod as PropertyValueRenderMethod<\n        TMatchValue,\n        TRendered\n      >,\n      priority = \"primary\",\n      name,\n      defaultSelected,\n      onChange,\n    } = shape;\n\n    this.context = context;\n    this.autosave = autosave;\n    this.manualSave = manualSave;\n    this.property = property;\n    this.storageKey = String(property);\n    this.mode = mode;\n    this._values = values?.map((v) => ListFilterValue.create(this, v));\n    this.matcher = matcher;\n    this.renderItem = renderItem;\n    this.name = name;\n    this.priority = priority;\n    this.defaultSelectedValues = defaultSelected?.map((v) =>\n      ListFilterValue.create(this, v),\n    );\n    if (onChange) {\n      this.onFilterChangeCallbacks.add(onChange);\n    }\n  }\n\n  public updateInitialState(initialState: InitialTableState): void {\n    const initialIds = this.getInitialSelectedIds();\n\n    if (initialIds?.length) {\n      initialState.columnFilters = [\n        ...(initialState.columnFilters ?? []),\n        {\n          id: this.property as string,\n          value: initialIds,\n        },\n      ];\n    }\n  }\n\n  private getInitialSelectedIds(): string[] | undefined {\n    return (\n      this.getStoredSelectedIds({\n        autosave: this.autosave,\n        manualSave: this.manualSave,\n      }) ?? this.defaultSelectedValues?.map((v) => v.id)\n    );\n  }\n\n  private getStoredSelectedIds(\n    options: ListSettingsOperationOptions,\n  ): string[] | undefined {\n    return this.context.settings?.get(\"activeFilters\", options)?.[\n      this.storageKey\n    ];\n  }\n\n  private getStoredSelectedValues(\n    options: ListSettingsOperationOptions,\n  ): ListFilterValue<TRendered>[] | undefined {\n    return this.getStoredSelectedIds(options)\n      ?.map((id) => this.values.find((v) => v.id === id))\n      .filter((v): v is ListFilterValue<TRendered> => v !== undefined);\n  }\n\n  /**\n   * Writes every filter's selection in one go — they share a settings key.\n   *\n   * Takes the two members it reads rather than a `ListFilter<any, …>`: a\n   * `Table<never>` is not assignable to a `Table<any>` (a row model sits in a\n   * contravariant position deep inside), so a list of concrete filters would\n   * not go in.\n   */\n  public static storeFilters<T>(\n    context: ListModelContext<T>,\n    filters: StorableFilter[],\n    options: ListSettingsOperationOptions,\n  ): void {\n    const data = Object.fromEntries(\n      filters.map((filter) => [\n        filter.storageKey,\n        filter.getArrayValue().map((v) => v.id),\n      ]),\n    );\n\n    context.settings?.store(\"activeFilters\", data, options);\n  }\n\n  public updateTableColumnDef(def: ColumnDef<T>): void {\n    def.enableColumnFilter = true;\n    def.filterFn = this.getTableFilterFn();\n  }\n\n  private getTableFilterFn(): ColumnDef<T>[\"filterFn\"] {\n    return (row, _, filterValue) => {\n      const propertyAsString = this.property as string;\n\n      /*\n       * A custom property is not on the item, so the matcher gets the item\n       * itself and decides.\n       */\n      const filterBy = propertyAsString.startsWith(customPropertyPrefix)\n        ? row.original\n        : getProperty(row.original as object, propertyAsString);\n\n      return this.checkFilterMatches(filterBy, filterValue);\n    };\n  }\n\n  private checkFilterMatches(\n    property: unknown,\n    filterValueInput: unknown,\n  ): boolean {\n    if (filterValueInput === null) {\n      return true;\n    }\n\n    const predicate = (filterValue: ListFilterValue<TRendered>) =>\n      this.matcher(filterValue.value as never, property as never);\n\n    const toFilterValue = (something: unknown) =>\n      ListFilterValue.create(this, something);\n\n    if (this.mode === \"all\") {\n      return toArray(filterValueInput).map(toFilterValue).every(predicate);\n    } else if (this.mode === \"some\") {\n      const filterArr = toArray(filterValueInput);\n      return (\n        filterArr.length === 0 || filterArr.map(toFilterValue).some(predicate)\n      );\n    } else if (this.mode === \"one\") {\n      const oneValue = Array.isArray(filterValueInput)\n        ? filterValueInput[0]\n        : filterValueInput;\n      return predicate(toFilterValue(oneValue));\n    }\n\n    throw new Error(`Unknown filter mode '${this.mode}'`);\n  }\n\n  protected getTableColumnFilter(): ColumnFilter | undefined {\n    return this.context.dataTable\n      .getState()\n      .columnFilters.find((f) => f.id === this.property);\n  }\n\n  protected getTableColumn(): Column<T> {\n    return getListColumn(this.context.dataTable, this.property);\n  }\n\n  public getValue(): unknown {\n    return this.getTableColumnFilter()?.value ?? null;\n  }\n\n  /*\n   * Rebuilt only when TanStack hands out a new map: it memoizes the faceted\n   * values and replaces the map when the data changes. Without this, every\n   * row the filter function checks re-hashes every value — `getArrayValue()`\n   * resolves each stored id through `values`.\n   */\n  private getValuesFromTableState(): ListFilterValue<TRendered>[] {\n    const facets = this.getTableColumn().getFacetedUniqueValues();\n\n    if (this.valuesFromTableState?.facets !== facets) {\n      this.valuesFromTableState = {\n        facets,\n        values: unique(\n          Array.from(facets.keys())\n            .flatMap((v) => v)\n            .filter((v) => v !== undefined && v !== null),\n        ).map((v) => ListFilterValue.create(this, v)),\n      };\n    }\n\n    return this.valuesFromTableState.values;\n  }\n\n  private checkIfValueIsUnknown(value: ListFilterValue<TRendered>): boolean {\n    return !this.values.some((v) => v.id === value.id);\n  }\n\n  /**\n   * Drops a selection the data no longer offers — a stored filter value whose\n   * item is gone would otherwise filter everything away with no way to undo\n   * it.\n   */\n  public deleteUnknownFilterValues(): void {\n    /* Values the data offers are by definition known. */\n    if (this._values === undefined) {\n      return;\n    }\n\n    for (const currentValues of this.getArrayValue()) {\n      if (this.checkIfValueIsUnknown(currentValues)) {\n        this.deactivateValue(currentValues);\n      }\n    }\n  }\n\n  /**\n   * The values the filter offers — the ones it was given, or the ones the data\n   * has.\n   *\n   * Follows the table, not a snapshot. A binding that keeps one filter instance\n   * for the list's lifetime would otherwise hold the answer from before the\n   * first batch arrived: an async loader gives the header an empty menu and\n   * never fills it. The values are cached per faceted-values map, which\n   * TanStack replaces when the data changes.\n   */\n  public get values(): ListFilterValue<TRendered>[] {\n    return this._values ?? this.getValuesFromTableState();\n  }\n\n  public getArrayValue(): ListFilterValue<TRendered>[] {\n    const value = this.getValue();\n    return value === null\n      ? []\n      : toArray(value).map((v) => ListFilterValue.create(this, v));\n  }\n\n  public isValueActive(value: ListFilterValue<TRendered>): boolean {\n    return this.getArrayValue().some((v) => v.equals(value));\n  }\n\n  public isActive(): boolean {\n    return this.getArrayValue().length > 0;\n  }\n\n  public deactivateValue(value: ListFilterValue<TRendered>): void {\n    const currentValueAsArray = this.getArrayValue();\n\n    const updatedValue =\n      this.mode === \"all\" || this.mode === \"some\"\n        ? currentValueAsArray.filter((v) => !v.equals(value))\n        : null;\n\n    this.getTableColumn().setFilterValue(updatedValue);\n    this.callOnChangedHandlers(updatedValue);\n  }\n\n  private callOnChangedHandlers(\n    newValue: ListFilterValue<TRendered>[] | ListFilterValue<TRendered> | null,\n  ): void {\n    const values = toArray(newValue).map((v) => v?.value);\n    this.onFilterChangeCallbacks.forEach((cb) => cb(values));\n  }\n\n  public hasChanges(): boolean {\n    const currentIds = this.getArrayValue().map((v) => v.id);\n\n    const defaultIds =\n      this.getStoredSelectedIds({ autosave: false }) ??\n      this.defaultSelectedValues?.map((v) => v.id) ??\n      [];\n\n    return (\n      currentIds.length !== defaultIds.length ||\n      difference(currentIds, defaultIds).length > 0\n    );\n  }\n\n  public isStoringAvailable(): boolean {\n    return !!this.context.settings && this.manualSave;\n  }\n\n  public resetValues(): void {\n    const storedValues =\n      this.getStoredSelectedValues({ autosave: false }) ??\n      this.defaultSelectedValues;\n\n    const resetTo =\n      storedValues ?? (this.mode === \"all\" || this.mode === \"some\" ? [] : null);\n\n    this.getTableColumn().setFilterValue(resetTo);\n    this.callOnChangedHandlers(resetTo);\n  }\n\n  public clear(): void {\n    this.getTableColumn().setFilterValue(null);\n    this.callOnChangedHandlers(null);\n  }\n\n  public toggleValue(newValue: ListFilterValue<TRendered>): void {\n    const currentValueAsArray = this.getArrayValue();\n\n    let updatedValue:\n      ListFilterValue<TRendered>[] | ListFilterValue<TRendered> | null;\n\n    if (this.mode === \"all\" || this.mode === \"some\") {\n      updatedValue = newValue.isActive\n        ? currentValueAsArray.filter((v) => !v.equals(newValue))\n        : [...currentValueAsArray, newValue];\n    } else {\n      updatedValue = newValue.isActive ? null : newValue;\n    }\n\n    this.getTableColumn().setFilterValue(updatedValue);\n    this.callOnChangedHandlers(updatedValue);\n  }\n\n  /**\n   * Whether the filter offers \"Select all\" — a `some` filter with enough\n   * values.\n   */\n  public get isSelectAllAvailable(): boolean {\n    return this.mode === \"some\" && this.values.length >= selectAllMinValueCount;\n  }\n\n  public isEveryValueActive(): boolean {\n    return this.values.every((v) => v.isActive);\n  }\n\n  public selectAll(): void {\n    this.setArrayValue(this.values);\n  }\n\n  /** Makes exactly these values active — what a multiple-selection menu reports. */\n  public setActiveValueIds(ids: Iterable<unknown>): void {\n    const idSet = new Set(ids);\n    this.setArrayValue(this.values.filter((v) => idSet.has(v.id)));\n  }\n\n  public deselectAll(): void {\n    this.setArrayValue([]);\n  }\n\n  private setArrayValue(value: ListFilterValue<TRendered>[]): void {\n    this.getTableColumn().setFilterValue(value);\n    this.callOnChangedHandlers(value);\n  }\n\n  public onFilterUpdated(cb: () => unknown): void {\n    this.onFilterChangeCallbacks.add(cb);\n  }\n}\n\nexport default ListFilter;\n"],"mappings":"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"}

package/dist/js/packages/components-base/src/list/filter/ListFilterValue.mjs

@@ -0,0 +1,51 @@
+"use client"
+/* */
+import { isShallowEqual } from "remeda";
+import { hash } from "object-code";
+//#region ../components-base/src/list/filter/ListFilterValue.ts
+var idPrefix = "FilterValueId@@";
+/**
+* One selectable value of a filter, and the identity it is stored under.
+*
+* The id is content-addressed — the property plus a hash of the value — so a
+* selection survives a reload without the values having to keep their order or
+* their index.
+*/
+var ListFilterValue = class ListFilterValue {
+	filter;
+	value;
+	id;
+	constructor(filter, value) {
+		this.filter = filter;
+		if (typeof value === "string" && value.startsWith(idPrefix)) {
+			this.value = filter.values.find((v) => v.id === value)?.value;
+			this.id = value;
+		} else {
+			this.value = value;
+			this.id = `${idPrefix}${this.filter.property}@@${hash(this.value)}`;
+		}
+	}
+	static create(filter, value) {
+		if (value instanceof ListFilterValue) return value;
+		return new ListFilterValue(filter, value);
+	}
+	equals(otherValue) {
+		return isShallowEqual(this.value, otherValue.value);
+	}
+	get isActive() {
+		return this.filter.isValueActive(this);
+	}
+	render() {
+		return this.filter.renderItem(this.value);
+	}
+	toggle() {
+		this.filter.toggleValue(this);
+	}
+	deactivate() {
+		this.filter.deactivateValue(this);
+	}
+};
+//#endregion
+export { ListFilterValue, ListFilterValue as default };
+
+//# sourceMappingURL=ListFilterValue.mjs.map

package/dist/js/packages/components-base/src/list/filter/ListFilterValue.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListFilterValue.mjs","names":[],"sources":["../../../../../../../../components-base/src/list/filter/ListFilterValue.ts"],"sourcesContent":["import type { ListFilter } from \"./ListFilter\";\nimport { hash } from \"object-code\";\nimport { isShallowEqual } from \"remeda\";\n\nconst idPrefix = \"FilterValueId@@\";\n\n/**\n * One selectable value of a filter, and the identity it is stored under.\n *\n * The id is content-addressed — the property plus a hash of the value — so a\n * selection survives a reload without the values having to keep their order or\n * their index.\n */\nexport class ListFilterValue<TRendered = unknown> {\n  public readonly filter: ListFilter<unknown, string, unknown, TRendered>;\n  public readonly value: unknown;\n  public readonly id: string;\n\n  private constructor(\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    filter: ListFilter<any, any, any, TRendered>,\n    value: unknown,\n  ) {\n    this.filter = filter;\n\n    /* An id round-tripped through storage, rather than a value. */\n    if (typeof value === \"string\" && value.startsWith(idPrefix)) {\n      this.value = filter.values.find((v) => v.id === value)?.value;\n      this.id = value;\n    } else {\n      this.value = value;\n      this.id = `${idPrefix}${this.filter.property}@@${hash(this.value)}`;\n    }\n  }\n\n  public static create<TRendered>(\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    filter: ListFilter<any, any, any, TRendered>,\n    value: unknown,\n  ): ListFilterValue<TRendered> {\n    if (value instanceof ListFilterValue) {\n      return value as ListFilterValue<TRendered>;\n    }\n    return new ListFilterValue<TRendered>(filter, value);\n  }\n\n  public equals(otherValue: ListFilterValue<TRendered>): boolean {\n    return isShallowEqual(this.value, otherValue.value);\n  }\n\n  public get isActive(): boolean {\n    return this.filter.isValueActive(this);\n  }\n\n  public render(): TRendered {\n    return this.filter.renderItem(this.value as never);\n  }\n\n  public toggle(): void {\n    this.filter.toggleValue(this);\n  }\n\n  public deactivate(): void {\n    this.filter.deactivateValue(this);\n  }\n}\n\nexport default ListFilterValue;\n"],"mappings":";;;;;AAIA,IAAM,WAAW;;;;;;;;AASjB,IAAa,kBAAb,MAAa,gBAAqC;CAChD;CACA;CACA;CAEA,YAEE,QACA,OACA;EACA,KAAK,SAAS;EAGd,IAAI,OAAO,UAAU,YAAY,MAAM,WAAW,QAAQ,GAAG;GAC3D,KAAK,QAAQ,OAAO,OAAO,MAAM,MAAM,EAAE,OAAO,KAAK,CAAC,EAAE;GACxD,KAAK,KAAK;EACZ,OAAO;GACL,KAAK,QAAQ;GACb,KAAK,KAAK,GAAG,WAAW,KAAK,OAAO,SAAS,IAAI,KAAK,KAAK,KAAK;EAClE;CACF;CAEA,OAAc,OAEZ,QACA,OAC4B;EAC5B,IAAI,iBAAiB,iBACnB,OAAO;EAET,OAAO,IAAI,gBAA2B,QAAQ,KAAK;CACrD;CAEA,OAAc,YAAiD;EAC7D,OAAO,eAAe,KAAK,OAAO,WAAW,KAAK;CACpD;CAEA,IAAW,WAAoB;EAC7B,OAAO,KAAK,OAAO,cAAc,IAAI;CACvC;CAEA,SAA2B;EACzB,OAAO,KAAK,OAAO,WAAW,KAAK,KAAc;CACnD;CAEA,SAAsB;EACpB,KAAK,OAAO,YAAY,IAAI;CAC9B;CAEA,aAA0B;EACxB,KAAK,OAAO,gBAAgB,IAAI;CAClC;AACF"}

package/dist/js/packages/components-base/src/list/filter/dateRange.mjs

@@ -0,0 +1,51 @@
+"use client"
+/* */
+import { CalendarDate } from "@internationalized/date";
+import { DateTime } from "luxon";
+//#region ../components-base/src/list/filter/dateRange.ts
+/** A range needs both ends present to be one, even if either may be unset. */
+var isListDateRange = (value) => !!value && typeof value === "object" && "start" in value && "end" in value;
+var startOfDay = (date) => DateTime.fromObject({
+	year: date.year,
+	month: date.month,
+	day: date.day
+});
+/**
+* The cell's value as a point in time, or `undefined` when the filter does not
+* treat it as a date.
+*
+* Three shapes count, each on its own terms: a luxon `DateTime` and an ISO 8601
+* string are compared as the instant they name — a date-only string as the
+* start of its day — and a `CalendarDate` as its day. Anything else, a plain `{
+* year, month, day }` object included, is not a date here.
+*/
+var toDateTime = (value) => {
+	if (value instanceof DateTime) return value;
+	if (value instanceof CalendarDate) return startOfDay(value);
+	if (typeof value === "string") return DateTime.fromISO(value);
+};
+/**
+* Whether a row's date falls inside the selected range.
+*
+* A value that is not a date keeps its row: a filter the data cannot answer
+* should not empty the list. That includes a string luxon cannot parse — the
+* invalid `DateTime` compares as `NaN`, and neither end excludes it.
+*/
+var dateRangeFilterFn = (row, columnId, range) => {
+	if (!range) return true;
+	const dateValue = toDateTime(row.getValue(columnId));
+	if (!dateValue) return true;
+	const startDate = range.start ? startOfDay(range.start) : void 0;
+	const endDate = range.end ? startOfDay(range.end).endOf("day") : void 0;
+	if (startDate && dateValue < startDate) return false;
+	return !(endDate && dateValue > endDate);
+};
+/** Turns the column into one a date range filters. */
+var applyDateRangeColumnDef = (def) => {
+	def.enableColumnFilter = true;
+	def.filterFn = dateRangeFilterFn;
+};
+//#endregion
+export { applyDateRangeColumnDef, dateRangeFilterFn, isListDateRange };
+
+//# sourceMappingURL=dateRange.mjs.map

package/dist/js/packages/components-base/src/list/filter/dateRange.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateRange.mjs","names":[],"sources":["../../../../../../../../components-base/src/list/filter/dateRange.ts"],"sourcesContent":["import { CalendarDate } from \"@internationalized/date\";\nimport type { ColumnDef, Row } from \"@tanstack/table-core\";\nimport { DateTime } from \"luxon\";\n\n/** A calendar date, in whichever shape it reached the filter. */\nexport interface ListDateParts {\n  readonly year: number;\n  readonly month: number;\n  readonly day: number;\n}\n\nexport interface ListDateRange {\n  readonly start?: ListDateParts;\n  readonly end?: ListDateParts;\n}\n\n/** A range needs both ends present to be one, even if either may be unset. */\nexport const isListDateRange = (value: unknown): value is ListDateRange =>\n  !!value && typeof value === \"object\" && \"start\" in value && \"end\" in value;\n\n/*\n * The range's ends are read field by field: they come from the calendar, and\n * after crossing the remote boundary a `CalendarDate` is a plain object.\n */\nconst startOfDay = (date: ListDateParts): DateTime =>\n  DateTime.fromObject({\n    year: date.year,\n    month: date.month,\n    day: date.day,\n  });\n\n/**\n * The cell's value as a point in time, or `undefined` when the filter does not\n * treat it as a date.\n *\n * Three shapes count, each on its own terms: a luxon `DateTime` and an ISO 8601\n * string are compared as the instant they name — a date-only string as the\n * start of its day — and a `CalendarDate` as its day. Anything else, a plain `{\n * year, month, day }` object included, is not a date here.\n */\nconst toDateTime = (value: unknown): DateTime | undefined => {\n  if (value instanceof DateTime) {\n    return value;\n  }\n  if (value instanceof CalendarDate) {\n    return startOfDay(value);\n  }\n  if (typeof value === \"string\") {\n    return DateTime.fromISO(value);\n  }\n  return undefined;\n};\n\n/**\n * Whether a row's date falls inside the selected range.\n *\n * A value that is not a date keeps its row: a filter the data cannot answer\n * should not empty the list. That includes a string luxon cannot parse — the\n * invalid `DateTime` compares as `NaN`, and neither end excludes it.\n */\nexport const dateRangeFilterFn = <T>(\n  row: Row<T>,\n  columnId: string,\n  range?: ListDateRange,\n): boolean => {\n  if (!range) {\n    return true;\n  }\n\n  const dateValue = toDateTime(row.getValue(columnId));\n\n  if (!dateValue) {\n    return true;\n  }\n\n  const startDate = range.start ? startOfDay(range.start) : undefined;\n  /* The whole end day counts, up to its last moment. */\n  const endDate = range.end ? startOfDay(range.end).endOf(\"day\") : undefined;\n\n  if (startDate && dateValue < startDate) {\n    return false;\n  }\n\n  return !(endDate && dateValue > endDate);\n};\n\n/** Turns the column into one a date range filters. */\nexport const applyDateRangeColumnDef = <T>(def: ColumnDef<T>): void => {\n  def.enableColumnFilter = true;\n  def.filterFn = dateRangeFilterFn;\n};\n"],"mappings":";;;;;;AAiBA,IAAa,mBAAmB,UAC9B,CAAC,CAAC,SAAS,OAAO,UAAU,YAAY,WAAW,SAAS,SAAS;AAMvE,IAAM,cAAc,SAClB,SAAS,WAAW;CAClB,MAAM,KAAK;CACX,OAAO,KAAK;CACZ,KAAK,KAAK;AACZ,CAAC;;;;;;;;;;AAWH,IAAM,cAAc,UAAyC;CAC3D,IAAI,iBAAiB,UACnB,OAAO;CAET,IAAI,iBAAiB,cACnB,OAAO,WAAW,KAAK;CAEzB,IAAI,OAAO,UAAU,UACnB,OAAO,SAAS,QAAQ,KAAK;AAGjC;;;;;;;;AASA,IAAa,qBACX,KACA,UACA,UACY;CACZ,IAAI,CAAC,OACH,OAAO;CAGT,MAAM,YAAY,WAAW,IAAI,SAAS,QAAQ,CAAC;CAEnD,IAAI,CAAC,WACH,OAAO;CAGT,MAAM,YAAY,MAAM,QAAQ,WAAW,MAAM,KAAK,IAAI,KAAA;CAE1D,MAAM,UAAU,MAAM,MAAM,WAAW,MAAM,GAAG,CAAC,CAAC,MAAM,KAAK,IAAI,KAAA;CAEjE,IAAI,aAAa,YAAY,WAC3B,OAAO;CAGT,OAAO,EAAE,WAAW,YAAY;AAClC;;AAGA,IAAa,2BAA8B,QAA4B;CACrE,IAAI,qBAAqB;CACzB,IAAI,WAAW;AACjB"}

package/dist/js/packages/components-base/src/list/item/ListItem.mjs

@@ -0,0 +1,21 @@
+"use client"
+/* */
+//#region ../components-base/src/list/item/ListItem.ts
+/** One row of the list, as the views see it: an id and the data behind it. */
+var ListItem = class ListItem {
+	id;
+	data;
+	collection;
+	constructor(collection, id, data) {
+		this.collection = collection;
+		this.id = id;
+		this.data = data;
+	}
+	static fromRow(collection, row) {
+		return new ListItem(collection, row.id, row.original);
+	}
+};
+//#endregion
+export { ListItem };
+
+//# sourceMappingURL=ListItem.mjs.map

package/dist/js/packages/components-base/src/list/item/ListItem.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListItem.mjs","names":[],"sources":["../../../../../../../../components-base/src/list/item/ListItem.ts"],"sourcesContent":["import type { ListItemCollection } from \"./ListItemCollection\";\nimport type { Row } from \"@tanstack/table-core\";\n\n/** One row of the list, as the views see it: an id and the data behind it. */\nexport class ListItem<T> {\n  public readonly id: string;\n  public readonly data: T;\n  public readonly collection: ListItemCollection<T>;\n\n  public constructor(collection: ListItemCollection<T>, id: string, data: T) {\n    this.collection = collection;\n    this.id = id;\n    this.data = data;\n  }\n\n  public static fromRow<T>(\n    collection: ListItemCollection<T>,\n    row: Row<T>,\n  ): ListItem<T> {\n    return new ListItem(collection, row.id, row.original);\n  }\n}\n"],"mappings":";;;;AAIA,IAAa,WAAb,MAAa,SAAY;CACvB;CACA;CACA;CAEA,YAAmB,YAAmC,IAAY,MAAS;EACzE,KAAK,aAAa;EAClB,KAAK,KAAK;EACV,KAAK,OAAO;CACd;CAEA,OAAc,QACZ,YACA,KACa;EACb,OAAO,IAAI,SAAS,YAAY,IAAI,IAAI,IAAI,QAAQ;CACtD;AACF"}

package/dist/js/packages/components-base/src/list/item/ListItemCollection.mjs

@@ -0,0 +1,24 @@
+"use client"
+/* */
+import { ListItem } from "./ListItem.mjs";
+//#region ../components-base/src/list/item/ListItemCollection.ts
+/**
+* The items the list currently shows.
+*
+* Read from the table's row model on every access rather than kept: the rows
+* are what sorting, filtering and paging produce, so a stored copy would be a
+* second answer to the same question.
+*/
+var ListItemCollection = class {
+	context;
+	constructor(context) {
+		this.context = context;
+	}
+	get entries() {
+		return this.context.dataTable.getRowModel().rows.map((r) => ListItem.fromRow(this, r));
+	}
+};
+//#endregion
+export { ListItemCollection };
+
+//# sourceMappingURL=ListItemCollection.mjs.map

package/dist/js/packages/components-base/src/list/item/ListItemCollection.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListItemCollection.mjs","names":[],"sources":["../../../../../../../../components-base/src/list/item/ListItemCollection.ts"],"sourcesContent":["import type { ListModelContext } from \"../ListModelContext\";\nimport { ListItem } from \"./ListItem\";\n\n/**\n * The items the list currently shows.\n *\n * Read from the table's row model on every access rather than kept: the rows\n * are what sorting, filtering and paging produce, so a stored copy would be a\n * second answer to the same question.\n */\nexport class ListItemCollection<T> {\n  public readonly context: ListModelContext<T>;\n\n  public constructor(context: ListModelContext<T>) {\n    this.context = context;\n  }\n\n  public get entries(): ListItem<T>[] {\n    return this.context.dataTable\n      .getRowModel()\n      .rows.map((r) => ListItem.fromRow(this, r));\n  }\n}\n"],"mappings":";;;;;;;;;;;AAUA,IAAa,qBAAb,MAAmC;CACjC;CAEA,YAAmB,SAA8B;EAC/C,KAAK,UAAU;CACjB;CAEA,IAAW,UAAyB;EAClC,OAAO,KAAK,QAAQ,UACjB,YAAY,CAAC,CACb,KAAK,KAAK,MAAM,SAAS,QAAQ,MAAM,CAAC,CAAC;CAC9C;AACF"}

package/dist/js/packages/components-base/src/list/loading/ListLoaderState.mjs

@@ -0,0 +1,86 @@
+"use client"
+/* */
+import { uniqueBy } from "remeda";
+import { action, computed, makeObservable, observable } from "mobx";
+//#region ../components-base/src/list/loading/ListLoaderState.ts
+/**
+* What a list has loaded so far, and how far each batch has got.
+*
+* MobX, and nothing else — no hook, no framework. A binding reads it through
+* its own reactivity: React with `useSelector`, Vue with `watchMobxValue`. That
+* split is the point: the batching, the deduplication and the "still loading"
+* rules are one implementation, and only the subscription is written twice.
+*
+* What is _not_ here is the loading itself. Fetching a batch is
+* `usePromise`/Suspense in React and something else in Vue, so it stays with
+* the binding, and only its outcome is reported here.
+*/
+var ListLoaderState = class {
+	dataBatches = [];
+	batchLoadingStates = ["void"];
+	metadata = void 0;
+	isInitiallyLoading = true;
+	/**
+	* The last non-empty result, kept outside MobX on purpose: it exists so a
+	* reset can keep rendering the previous data instead of flashing empty, and
+	* observing it would make that very reset re-render.
+	*/
+	prevDataBatches = [];
+	getItemId;
+	constructor(options = {}) {
+		this.getItemId = options.getItemId;
+		makeObservable(this, {
+			prevDataBatches: false,
+			dataBatches: observable.shallow,
+			batchLoadingStates: observable.shallow,
+			metadata: observable,
+			mergedData: computed,
+			isLoading: computed,
+			isLoadingMore: computed,
+			isInitiallyLoading: observable,
+			setIsInitiallyLoading: action.bound,
+			reset: action.bound,
+			setDataBatch: action.bound,
+			setBatchLoadingState: action.bound,
+			setMetadata: action.bound
+		});
+	}
+	reset() {
+		this.batchLoadingStates = [];
+		this.dataBatches = [];
+	}
+	setDataBatch(index, data) {
+		if (this.dataBatches.length === 0) this.prevDataBatches = [];
+		if (this.dataBatches[index] !== data) {
+			this.dataBatches[index] = data;
+			this.prevDataBatches[index] = data;
+		}
+	}
+	setBatchLoadingState(index, state) {
+		if (state === "error" || state === "loaded") this.setIsInitiallyLoading(false);
+		if (this.batchLoadingStates[index] !== state) this.batchLoadingStates[index] = state;
+	}
+	setMetadata(metadata) {
+		this.metadata = metadata;
+	}
+	setIsInitiallyLoading(isInitiallyLoading) {
+		this.isInitiallyLoading = isInitiallyLoading;
+	}
+	get mergedData() {
+		const merged = (this.dataBatches.length === 0 ? this.prevDataBatches : this.dataBatches).flatMap((d) => d);
+		return this.getItemId ? uniqueBy(merged, this.getItemId) : merged;
+	}
+	get isLoading() {
+		return this.batchLoadingStates.some((s) => s === "loading" || s === "void");
+	}
+	get isLoadingMore() {
+		return this.isLoading && this.dataBatches.length > 0;
+	}
+	isBatchLoaded(batchIndex) {
+		return batchIndex in this.dataBatches;
+	}
+};
+//#endregion
+export { ListLoaderState, ListLoaderState as default };
+
+//# sourceMappingURL=ListLoaderState.mjs.map

package/dist/js/packages/components-base/src/list/loading/ListLoaderState.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListLoaderState.mjs","names":[],"sources":["../../../../../../../../components-base/src/list/loading/ListLoaderState.ts"],"sourcesContent":["import type { BatchLoadingState, ListData } from \"./types\";\nimport { action, computed, makeObservable, observable } from \"mobx\";\nimport { uniqueBy } from \"remeda\";\n\nexport interface ListLoaderStateOptions<T> {\n  /**\n   * Identifies an item, so the same one loaded in two batches appears once.\n   * Without it the batches are concatenated as they arrive.\n   */\n  getItemId?: (item: T) => string;\n}\n\n/**\n * What a list has loaded so far, and how far each batch has got.\n *\n * MobX, and nothing else — no hook, no framework. A binding reads it through\n * its own reactivity: React with `useSelector`, Vue with `watchMobxValue`. That\n * split is the point: the batching, the deduplication and the \"still loading\"\n * rules are one implementation, and only the subscription is written twice.\n *\n * What is _not_ here is the loading itself. Fetching a batch is\n * `usePromise`/Suspense in React and something else in Vue, so it stays with\n * the binding, and only its outcome is reported here.\n */\nexport class ListLoaderState<T> {\n  public dataBatches: ListData<T>[] = [];\n  public batchLoadingStates: BatchLoadingState[] = [\"void\"];\n  public metadata?: unknown = undefined;\n  public isInitiallyLoading = true;\n\n  /**\n   * The last non-empty result, kept outside MobX on purpose: it exists so a\n   * reset can keep rendering the previous data instead of flashing empty, and\n   * observing it would make that very reset re-render.\n   */\n  public prevDataBatches: ListData<T>[] = [];\n\n  private readonly getItemId?: (item: T) => string;\n\n  public constructor(options: ListLoaderStateOptions<T> = {}) {\n    this.getItemId = options.getItemId;\n\n    makeObservable(this, {\n      prevDataBatches: false,\n      dataBatches: observable.shallow,\n      batchLoadingStates: observable.shallow,\n      metadata: observable,\n      mergedData: computed,\n      isLoading: computed,\n      isLoadingMore: computed,\n      isInitiallyLoading: observable,\n      setIsInitiallyLoading: action.bound,\n      reset: action.bound,\n      setDataBatch: action.bound,\n      setBatchLoadingState: action.bound,\n      setMetadata: action.bound,\n    });\n  }\n\n  public reset(): void {\n    this.batchLoadingStates = [];\n    this.dataBatches = [];\n  }\n\n  public setDataBatch(index: number, data: ListData<T>): void {\n    if (this.dataBatches.length === 0) {\n      this.prevDataBatches = [];\n    }\n\n    if (this.dataBatches[index] !== data) {\n      this.dataBatches[index] = data;\n      this.prevDataBatches[index] = data;\n    }\n  }\n\n  public setBatchLoadingState(index: number, state: BatchLoadingState): void {\n    if (state === \"error\" || state === \"loaded\") {\n      this.setIsInitiallyLoading(false);\n    }\n    if (this.batchLoadingStates[index] !== state) {\n      this.batchLoadingStates[index] = state;\n    }\n  }\n\n  public setMetadata(metadata?: unknown): void {\n    this.metadata = metadata;\n  }\n\n  public setIsInitiallyLoading(isInitiallyLoading: boolean): void {\n    this.isInitiallyLoading = isInitiallyLoading;\n  }\n\n  public get mergedData(): T[] {\n    const dataBatches =\n      this.dataBatches.length === 0 ? this.prevDataBatches : this.dataBatches;\n\n    const merged = dataBatches.flatMap((d) => d);\n    return this.getItemId ? uniqueBy(merged, this.getItemId) : merged;\n  }\n\n  public get isLoading(): boolean {\n    return this.batchLoadingStates.some((s) => s === \"loading\" || s === \"void\");\n  }\n\n  public get isLoadingMore(): boolean {\n    return this.isLoading && this.dataBatches.length > 0;\n  }\n\n  public isBatchLoaded(batchIndex: number): boolean {\n    return batchIndex in this.dataBatches;\n  }\n}\n\nexport default ListLoaderState;\n"],"mappings":";;;;;;;;;;;;;;;;;AAwBA,IAAa,kBAAb,MAAgC;CAC9B,cAAoC,CAAC;CACrC,qBAAiD,CAAC,MAAM;CACxD,WAA4B,KAAA;CAC5B,qBAA4B;;;;;;CAO5B,kBAAwC,CAAC;CAEzC;CAEA,YAAmB,UAAqC,CAAC,GAAG;EAC1D,KAAK,YAAY,QAAQ;EAEzB,eAAe,MAAM;GACnB,iBAAiB;GACjB,aAAa,WAAW;GACxB,oBAAoB,WAAW;GAC/B,UAAU;GACV,YAAY;GACZ,WAAW;GACX,eAAe;GACf,oBAAoB;GACpB,uBAAuB,OAAO;GAC9B,OAAO,OAAO;GACd,cAAc,OAAO;GACrB,sBAAsB,OAAO;GAC7B,aAAa,OAAO;EACtB,CAAC;CACH;CAEA,QAAqB;EACnB,KAAK,qBAAqB,CAAC;EAC3B,KAAK,cAAc,CAAC;CACtB;CAEA,aAAoB,OAAe,MAAyB;EAC1D,IAAI,KAAK,YAAY,WAAW,GAC9B,KAAK,kBAAkB,CAAC;EAG1B,IAAI,KAAK,YAAY,WAAW,MAAM;GACpC,KAAK,YAAY,SAAS;GAC1B,KAAK,gBAAgB,SAAS;EAChC;CACF;CAEA,qBAA4B,OAAe,OAAgC;EACzE,IAAI,UAAU,WAAW,UAAU,UACjC,KAAK,sBAAsB,KAAK;EAElC,IAAI,KAAK,mBAAmB,WAAW,OACrC,KAAK,mBAAmB,SAAS;CAErC;CAEA,YAAmB,UAA0B;EAC3C,KAAK,WAAW;CAClB;CAEA,sBAA6B,oBAAmC;EAC9D,KAAK,qBAAqB;CAC5B;CAEA,IAAW,aAAkB;EAI3B,MAAM,UAFJ,KAAK,YAAY,WAAW,IAAI,KAAK,kBAAkB,KAAK,YAAA,CAEnC,SAAS,MAAM,CAAC;EAC3C,OAAO,KAAK,YAAY,SAAS,QAAQ,KAAK,SAAS,IAAI;CAC7D;CAEA,IAAW,YAAqB;EAC9B,OAAO,KAAK,mBAAmB,MAAM,MAAM,MAAM,aAAa,MAAM,MAAM;CAC5E;CAEA,IAAW,gBAAyB;EAClC,OAAO,KAAK,aAAa,KAAK,YAAY,SAAS;CACrD;CAEA,cAAqB,YAA6B;EAChD,OAAO,cAAc,KAAK;CAC5B;AACF"}

package/dist/js/packages/components-base/src/list/loading/types.mjs

@@ -0,0 +1,29 @@
+"use client"
+/* */
+//#region ../components-base/src/list/loading/types.ts
+/**
+* The query for one batch.
+*
+* Every branch is the same question — "does the source do this itself?" — and
+* getting it wrong is silent: a source that paginates but is sent no pagination
+* returns its first page forever.
+*/
+var getListDataLoaderOptions = (source, batchIndex) => {
+	const { batchSize, modes } = source;
+	return {
+		pagination: modes.manualPagination ? {
+			limit: batchSize,
+			offset: batchSize * batchIndex
+		} : void 0,
+		sorting: modes.manualSorting ? Object.fromEntries(source.sorting.filter((s) => s.isSorted()).map((s) => [s.property, s.direction])) : void 0,
+		filtering: modes.manualFiltering ? Object.fromEntries(source.filters.filter((f) => f.getValue() !== null).map((f) => [f.property, {
+			mode: f.mode,
+			values: f.getArrayValue().map((v) => v.value)
+		}])) : void 0,
+		searchString: modes.manualFiltering ? source.searchString : void 0
+	};
+};
+//#endregion
+export { getListDataLoaderOptions };
+
+//# sourceMappingURL=types.mjs.map

package/dist/js/packages/components-base/src/list/loading/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":[],"sources":["../../../../../../../../components-base/src/list/loading/types.ts"],"sourcesContent":["import type { FilterMode } from \"../filter/types\";\nimport type { ListLoaderModes } from \"../pagination/types\";\nimport type { SearchValue } from \"../search/types\";\nimport type { ListSorting } from \"../sorting/ListSorting\";\nimport type { PropertyName } from \"../types\";\n\n/** One batch of list data, as a loader hands it over. */\nexport type ListData<T> = readonly T[];\n\n/**\n * How far one batch has got.\n *\n * The same four values `@mittwald/react-use-promise` uses, spelled out rather\n * than imported: that package is React's, and this one is the half both\n * bindings share.\n */\nexport type BatchLoadingState = \"void\" | \"loading\" | \"loaded\" | \"error\";\n\n/** A value per property of `T`, e.g. a direction or a filter's selection. */\nexport type ListPropertyRecord<T, TValue> = Partial<\n  Record<PropertyName<T>, TValue>\n>;\n\ninterface ListDataLoaderPaginationOptions {\n  offset: number;\n  limit: number;\n}\n\n/**\n * What a list asks its data source for.\n *\n * The consumer-facing contract of every dynamic loader, and the reason it is\n * here rather than with a binding: a Vue app and a React app write the same\n * loader function. Each field is filled only where the source said it does that\n * job itself — see `ListLoaderModes`.\n */\nexport interface ListDataLoaderOptions<T> {\n  sorting?: ListPropertyRecord<T, \"asc\" | \"desc\">;\n  filtering?: ListPropertyRecord<T, { mode: FilterMode; values: unknown[] }>;\n  searchString?: SearchValue;\n  pagination?: ListDataLoaderPaginationOptions;\n}\n\nexport interface ListDataLoaderResult<T> {\n  data: ListData<T>;\n  itemTotalCount?: number;\n  metadata?: unknown;\n}\n\nexport type ListAsyncDataLoader<T> = (\n  options: ListDataLoaderOptions<T>,\n) => Promise<ListDataLoaderResult<T>>;\n\n/** What building the loader options needs of a filter, and nothing more. */\nexport interface QueryableFilter<T> {\n  readonly property: PropertyName<T>;\n  readonly mode: FilterMode;\n  getValue(): unknown;\n  getArrayValue(): { value: unknown }[];\n}\n\nexport interface ListDataLoaderOptionsSource<T> {\n  readonly batchSize: number;\n  readonly modes: ListLoaderModes;\n  readonly sorting: ListSorting<T>[];\n  readonly filters: QueryableFilter<T>[];\n  readonly searchString: SearchValue;\n}\n\n/**\n * The query for one batch.\n *\n * Every branch is the same question — \"does the source do this itself?\" — and\n * getting it wrong is silent: a source that paginates but is sent no pagination\n * returns its first page forever.\n */\nexport const getListDataLoaderOptions = <T>(\n  source: ListDataLoaderOptionsSource<T>,\n  batchIndex: number,\n): ListDataLoaderOptions<T> => {\n  const { batchSize, modes } = source;\n\n  return {\n    pagination: modes.manualPagination\n      ? { limit: batchSize, offset: batchSize * batchIndex }\n      : undefined,\n\n    sorting: modes.manualSorting\n      ? (Object.fromEntries(\n          source.sorting\n            .filter((s) => s.isSorted())\n            .map((s) => [s.property, s.direction]),\n        ) as ListDataLoaderOptions<T>[\"sorting\"])\n      : undefined,\n\n    filtering: modes.manualFiltering\n      ? (Object.fromEntries(\n          source.filters\n            .filter((f) => f.getValue() !== null)\n            .map((f) => [\n              f.property,\n              { mode: f.mode, values: f.getArrayValue().map((v) => v.value) },\n            ]),\n        ) as ListDataLoaderOptions<T>[\"filtering\"])\n      : undefined,\n\n    searchString: modes.manualFiltering ? source.searchString : undefined,\n  };\n};\n"],"mappings":";;;;;;;;;;AA4EA,IAAa,4BACX,QACA,eAC6B;CAC7B,MAAM,EAAE,WAAW,UAAU;CAE7B,OAAO;EACL,YAAY,MAAM,mBACd;GAAE,OAAO;GAAW,QAAQ,YAAY;EAAW,IACnD,KAAA;EAEJ,SAAS,MAAM,gBACV,OAAO,YACN,OAAO,QACJ,QAAQ,MAAM,EAAE,SAAS,CAAC,CAAC,CAC3B,KAAK,MAAM,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,CACzC,IACA,KAAA;EAEJ,WAAW,MAAM,kBACZ,OAAO,YACN,OAAO,QACJ,QAAQ,MAAM,EAAE,SAAS,MAAM,IAAI,CAAC,CACpC,KAAK,MAAM,CACV,EAAE,UACF;GAAE,MAAM,EAAE;GAAM,QAAQ,EAAE,cAAc,CAAC,CAAC,KAAK,MAAM,EAAE,KAAK;EAAE,CAChE,CAAC,CACL,IACA,KAAA;EAEJ,cAAc,MAAM,kBAAkB,OAAO,eAAe,KAAA;CAC9D;AACF"}