@mittwald/flow-react-components 1.6.0-next.3 → 1.6.0-next.30

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

@@ -1 +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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"}
+{"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    this.notifyFilterUpdated(toArray(newValue).map((v) => v?.value));\n  }\n\n  /** Tells the listeners — the list resetting its batches among them. */\n  protected notifyFilterUpdated(values: unknown[]): void {\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/dateRange.mjs

@@ -1,27 +1,52 @@
 "use client"
 /* */
-import { CalendarDate } from "@internationalized/date";
+import { CalendarDate, CalendarDateTime, ZonedDateTime } 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({
+var hasTime = (date) => "hour" in date;
+/**
+* The date as a local point in time. A `ZonedDateTime` is the instant it names;
+* anything else is read field by field, since after crossing the remote
+* boundary a `CalendarDate` is a plain object.
+*/
+var listDateToDateTime = (date) => date instanceof ZonedDateTime ? DateTime.fromJSDate(date.toDate()) : DateTime.fromObject({
 	year: date.year,
 	month: date.month,
-	day: date.day
+	day: date.day,
+	...hasTime(date) ? {
+		hour: date.hour,
+		minute: date.minute,
+		second: date.second
+	} : {}
 });
 /**
+* Resolves a range to the instants it spans, for filtering on the server side.
+* Both bounds are inclusive: a date covers its whole day and a date with time
+* its whole minute, in the user's local time zone. A missing side has no
+* bound.
+*/
+var resolveListDateRange = (range) => {
+	const unit = (date) => hasTime(date) ? "minute" : "day";
+	return {
+		start: range.start ? listDateToDateTime(range.start).startOf(unit(range.start)).toJSDate() : void 0,
+		end: range.end ? listDateToDateTime(range.end).endOf(unit(range.end)).toJSDate() : void 0
+	};
+};
+/**
 * 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.
+* 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. A `CalendarDate` counts as
+* the start of its day, a `CalendarDateTime` as its local time and a
+* `ZonedDateTime` as its instant. 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 (value instanceof CalendarDate || value instanceof CalendarDateTime || value instanceof ZonedDateTime) return listDateToDateTime(value);
 	if (typeof value === "string") return DateTime.fromISO(value);
 };
 /**
@@ -35,10 +60,9 @@ 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);
+	const { start, end } = resolveListDateRange(range);
+	if (start && dateValue.toMillis() < start.getTime()) return false;
+	return !(end && dateValue.toMillis() > end.getTime());
 };
 /** Turns the column into one a date range filters. */
 var applyDateRangeColumnDef = (def) => {
@@ -46,6 +70,6 @@ var applyDateRangeColumnDef = (def) => {
 	def.filterFn = dateRangeFilterFn;
 };
 //#endregion
-export { applyDateRangeColumnDef, dateRangeFilterFn, isListDateRange };
+export { applyDateRangeColumnDef, dateRangeFilterFn, isListDateRange, listDateToDateTime, resolveListDateRange };
 
 //# sourceMappingURL=dateRange.mjs.map

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

@@ -1 +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"}
+{"version":3,"file":"dateRange.mjs","names":[],"sources":["../../../../../../../../components-base/src/list/filter/dateRange.ts"],"sourcesContent":["import {\n  CalendarDate,\n  CalendarDateTime,\n  ZonedDateTime,\n} from \"@internationalized/date\";\nimport type { ColumnDef, Row } from \"@tanstack/table-core\";\nimport { DateTime } from \"luxon\";\n\n/**\n * A calendar date, in whichever shape it reached the filter — with a time of\n * day when the filter narrows down by minute.\n */\nexport interface ListDateParts {\n  readonly year: number;\n  readonly month: number;\n  readonly day: number;\n  readonly hour?: number;\n  readonly minute?: number;\n  readonly second?: 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\nconst hasTime = (date: ListDateParts) => \"hour\" in date;\n\n/**\n * The date as a local point in time. A `ZonedDateTime` is the instant it names;\n * anything else is read field by field, since after crossing the remote\n * boundary a `CalendarDate` is a plain object.\n */\nexport const listDateToDateTime = (date: ListDateParts): DateTime =>\n  date instanceof ZonedDateTime\n    ? DateTime.fromJSDate(date.toDate())\n    : DateTime.fromObject({\n        year: date.year,\n        month: date.month,\n        day: date.day,\n        ...(hasTime(date)\n          ? { hour: date.hour, minute: date.minute, second: date.second }\n          : {}),\n      });\n\n/**\n * Resolves a range to the instants it spans, for filtering on the server side.\n * Both bounds are inclusive: a date covers its whole day and a date with time\n * its whole minute, in the user's local time zone. A missing side has no\n * bound.\n */\nexport const resolveListDateRange = (\n  range: ListDateRange,\n): { start?: Date; end?: Date } => {\n  const unit = (date: ListDateParts) => (hasTime(date) ? \"minute\" : \"day\");\n\n  return {\n    start: range.start\n      ? listDateToDateTime(range.start).startOf(unit(range.start)).toJSDate()\n      : undefined,\n    end: range.end\n      ? listDateToDateTime(range.end).endOf(unit(range.end)).toJSDate()\n      : undefined,\n  };\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 * A luxon `DateTime` and an ISO 8601 string are compared as the instant they\n * name — a date-only string as the start of its day. A `CalendarDate` counts as\n * the start of its day, a `CalendarDateTime` as its local time and a\n * `ZonedDateTime` as its instant. Anything else, a plain `{ year, month, day }`\n * 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 (\n    value instanceof CalendarDate ||\n    value instanceof CalendarDateTime ||\n    value instanceof ZonedDateTime\n  ) {\n    return listDateToDateTime(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 { start, end } = resolveListDateRange(range);\n\n  if (start && dateValue.toMillis() < start.getTime()) {\n    return false;\n  }\n\n  return !(end && dateValue.toMillis() > end.getTime());\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":";;;;;;AA2BA,IAAa,mBAAmB,UAC9B,CAAC,CAAC,SAAS,OAAO,UAAU,YAAY,WAAW,SAAS,SAAS;AAEvE,IAAM,WAAW,SAAwB,UAAU;;;;;;AAOnD,IAAa,sBAAsB,SACjC,gBAAgB,gBACZ,SAAS,WAAW,KAAK,OAAO,CAAC,IACjC,SAAS,WAAW;CAClB,MAAM,KAAK;CACX,OAAO,KAAK;CACZ,KAAK,KAAK;CACV,GAAI,QAAQ,IAAI,IACZ;EAAE,MAAM,KAAK;EAAM,QAAQ,KAAK;EAAQ,QAAQ,KAAK;CAAO,IAC5D,CAAC;AACP,CAAC;;;;;;;AAQP,IAAa,wBACX,UACiC;CACjC,MAAM,QAAQ,SAAyB,QAAQ,IAAI,IAAI,WAAW;CAElE,OAAO;EACL,OAAO,MAAM,QACT,mBAAmB,MAAM,KAAK,CAAC,CAAC,QAAQ,KAAK,MAAM,KAAK,CAAC,CAAC,CAAC,SAAS,IACpE,KAAA;EACJ,KAAK,MAAM,MACP,mBAAmB,MAAM,GAAG,CAAC,CAAC,MAAM,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS,IAC9D,KAAA;CACN;AACF;;;;;;;;;;;AAYA,IAAM,cAAc,UAAyC;CAC3D,IAAI,iBAAiB,UACnB,OAAO;CAET,IACE,iBAAiB,gBACjB,iBAAiB,oBACjB,iBAAiB,eAEjB,OAAO,mBAAmB,KAAK;CAEjC,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,EAAE,OAAO,QAAQ,qBAAqB,KAAK;CAEjD,IAAI,SAAS,UAAU,SAAS,IAAI,MAAM,QAAQ,GAChD,OAAO;CAGT,OAAO,EAAE,OAAO,UAAU,SAAS,IAAI,IAAI,QAAQ;AACrD;;AAGA,IAAa,2BAA8B,QAA4B;CACrE,IAAI,qBAAqB;CACzB,IAAI,WAAW;AACjB"}

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

@@ -0,0 +1,55 @@
+"use client"
+/* */
+import { resolveListDateRange } from "./dateRange.mjs";
+import { CalendarDate, Time, toCalendarDateTime } from "@internationalized/date";
+//#region ../components-base/src/list/filter/dateTimeRangeFields.ts
+var toListCalendarDate = (value) => value ? new CalendarDate(value.year, value.month, value.day) : null;
+var toListTime = (value) => value && "hour" in value ? new Time(value.hour, value.minute) : null;
+var listDateTimeRangeFieldsFromValue = (value) => ({
+	startDate: toListCalendarDate(value?.start),
+	startTime: toListTime(value?.start),
+	endDate: toListCalendarDate(value?.end),
+	endTime: toListTime(value?.end)
+});
+var toBound = (date, time) => date ? time ? toCalendarDateTime(date, time) : date : void 0;
+var boundKey = (bound) => bound && [
+	bound.year,
+	bound.month,
+	bound.day,
+	bound.hour,
+	bound.minute
+].join("-");
+var isYearComplete = (date) => !!date && date.year >= 1e3;
+/** Not while a year is still being typed: "2" would read as an early end. */
+var isListDateTimeRangeEndBeforeStart = (fields) => {
+	if (!isYearComplete(fields.startDate) || !isYearComplete(fields.endDate)) return false;
+	const { start, end } = resolveListDateRange({
+		start: toBound(fields.startDate, fields.startTime),
+		end: toBound(fields.endDate, fields.endTime)
+	});
+	return !!start && !!end && end < start;
+};
+var isListDateValid = (date, limits = {}) => {
+	const minValue = toListCalendarDate(limits.minValue);
+	const maxValue = toListCalendarDate(limits.maxValue);
+	return !date || !(!isYearComplete(date) || minValue && date.compare(minValue) < 0 || maxValue && date.compare(maxValue) > 0 || limits.isDateUnavailable?.(date));
+};
+/**
+* The range the fields stand for, or `undefined` while it must not be applied:
+* an invalid input keeps the last valid range, and an unchanged one needs no
+* update. `null` clears the filter.
+*/
+var getListDateTimeRangeUpdate = (fields, applied, limits) => {
+	if (!isListDateValid(fields.startDate, limits) || !isListDateValid(fields.endDate, limits) || isListDateTimeRangeEndBeforeStart(fields)) return;
+	const start = toBound(fields.startDate, fields.startTime);
+	const end = toBound(fields.endDate, fields.endTime);
+	if (boundKey(start) === boundKey(applied?.start) && boundKey(end) === boundKey(applied?.end)) return;
+	return start || end ? {
+		start,
+		end
+	} : null;
+};
+//#endregion
+export { getListDateTimeRangeUpdate, isListDateTimeRangeEndBeforeStart, isListDateValid, listDateTimeRangeFieldsFromValue, toListCalendarDate, toListTime };
+
+//# sourceMappingURL=dateTimeRangeFields.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dateTimeRangeFields.mjs","names":[],"sources":["../../../../../../../../components-base/src/list/filter/dateTimeRangeFields.ts"],"sourcesContent":["import {\n  CalendarDate,\n  type CalendarDateTime,\n  Time,\n  toCalendarDateTime,\n} from \"@internationalized/date\";\nimport {\n  resolveListDateRange,\n  type ListDateParts,\n  type ListDateRange,\n} from \"./dateRange\";\n\n/*\n * The rules of the date and time fields a range filter shows with\n * `granularity: \"minute\"`. Which input is valid and when it applies is the same\n * in every binding; the fields and the state holding their input are not.\n */\n\nexport interface ListDateTimeRangeFields {\n  readonly startDate: CalendarDate | null;\n  readonly startTime: Time | null;\n  readonly endDate: CalendarDate | null;\n  readonly endTime: Time | null;\n}\n\nexport interface ListDateTimeRangeLimits {\n  readonly minValue?: ListDateParts | null;\n  readonly maxValue?: ListDateParts | null;\n  readonly isDateUnavailable?: (date: CalendarDate) => boolean;\n}\n\ntype Bound = CalendarDate | CalendarDateTime;\n\nexport interface ListDateTimeRange {\n  readonly start?: Bound;\n  readonly end?: Bound;\n}\n\n/* Field by field: a value from the host of a remote connection is a plain object. */\nexport const toListCalendarDate = (\n  value?: ListDateParts | null,\n): CalendarDate | null =>\n  value ? new CalendarDate(value.year, value.month, value.day) : null;\n\nexport const toListTime = (\n  value?: { readonly hour?: number; readonly minute?: number } | null,\n): Time | null =>\n  value && \"hour\" in value ? new Time(value.hour, value.minute) : null;\n\nexport const listDateTimeRangeFieldsFromValue = (\n  value: ListDateRange | null,\n): ListDateTimeRangeFields => ({\n  startDate: toListCalendarDate(value?.start),\n  startTime: toListTime(value?.start),\n  endDate: toListCalendarDate(value?.end),\n  endTime: toListTime(value?.end),\n});\n\nconst toBound = (date: CalendarDate | null, time: Time | null) =>\n  date ? (time ? toCalendarDateTime(date, time) : date) : undefined;\n\nconst boundKey = (bound?: ListDateParts) =>\n  bound &&\n  [bound.year, bound.month, bound.day, bound.hour, bound.minute].join(\"-\");\n\n// react-aria reports a typed year digit by digit (2, 20, 202, 2026)\nconst isYearComplete = (date: CalendarDate | null) =>\n  !!date && date.year >= 1000;\n\n/** Not while a year is still being typed: \"2\" would read as an early end. */\nexport const isListDateTimeRangeEndBeforeStart = (\n  fields: ListDateTimeRangeFields,\n): boolean => {\n  if (!isYearComplete(fields.startDate) || !isYearComplete(fields.endDate)) {\n    return false;\n  }\n  const { start, end } = resolveListDateRange({\n    start: toBound(fields.startDate, fields.startTime),\n    end: toBound(fields.endDate, fields.endTime),\n  });\n  return !!start && !!end && end < start;\n};\n\nexport const isListDateValid = (\n  date: CalendarDate | null,\n  limits: ListDateTimeRangeLimits = {},\n): boolean => {\n  const minValue = toListCalendarDate(limits.minValue);\n  const maxValue = toListCalendarDate(limits.maxValue);\n\n  return (\n    !date ||\n    !(\n      !isYearComplete(date) ||\n      (minValue && date.compare(minValue) < 0) ||\n      (maxValue && date.compare(maxValue) > 0) ||\n      limits.isDateUnavailable?.(date)\n    )\n  );\n};\n\n/**\n * The range the fields stand for, or `undefined` while it must not be applied:\n * an invalid input keeps the last valid range, and an unchanged one needs no\n * update. `null` clears the filter.\n */\nexport const getListDateTimeRangeUpdate = (\n  fields: ListDateTimeRangeFields,\n  applied: ListDateRange | null,\n  limits?: ListDateTimeRangeLimits,\n): ListDateTimeRange | null | undefined => {\n  if (\n    !isListDateValid(fields.startDate, limits) ||\n    !isListDateValid(fields.endDate, limits) ||\n    isListDateTimeRangeEndBeforeStart(fields)\n  ) {\n    return undefined;\n  }\n\n  const start = toBound(fields.startDate, fields.startTime);\n  const end = toBound(fields.endDate, fields.endTime);\n\n  if (\n    boundKey(start) === boundKey(applied?.start) &&\n    boundKey(end) === boundKey(applied?.end)\n  ) {\n    return undefined;\n  }\n\n  return start || end ? { start, end } : null;\n};\n"],"mappings":";;;;;AAuCA,IAAa,sBACX,UAEA,QAAQ,IAAI,aAAa,MAAM,MAAM,MAAM,OAAO,MAAM,GAAG,IAAI;AAEjE,IAAa,cACX,UAEA,SAAS,UAAU,QAAQ,IAAI,KAAK,MAAM,MAAM,MAAM,MAAM,IAAI;AAElE,IAAa,oCACX,WAC6B;CAC7B,WAAW,mBAAmB,OAAO,KAAK;CAC1C,WAAW,WAAW,OAAO,KAAK;CAClC,SAAS,mBAAmB,OAAO,GAAG;CACtC,SAAS,WAAW,OAAO,GAAG;AAChC;AAEA,IAAM,WAAW,MAA2B,SAC1C,OAAQ,OAAO,mBAAmB,MAAM,IAAI,IAAI,OAAQ,KAAA;AAE1D,IAAM,YAAY,UAChB,SACA;CAAC,MAAM;CAAM,MAAM;CAAO,MAAM;CAAK,MAAM;CAAM,MAAM;AAAM,CAAC,CAAC,KAAK,GAAG;AAGzE,IAAM,kBAAkB,SACtB,CAAC,CAAC,QAAQ,KAAK,QAAQ;;AAGzB,IAAa,qCACX,WACY;CACZ,IAAI,CAAC,eAAe,OAAO,SAAS,KAAK,CAAC,eAAe,OAAO,OAAO,GACrE,OAAO;CAET,MAAM,EAAE,OAAO,QAAQ,qBAAqB;EAC1C,OAAO,QAAQ,OAAO,WAAW,OAAO,SAAS;EACjD,KAAK,QAAQ,OAAO,SAAS,OAAO,OAAO;CAC7C,CAAC;CACD,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,MAAM;AACnC;AAEA,IAAa,mBACX,MACA,SAAkC,CAAC,MACvB;CACZ,MAAM,WAAW,mBAAmB,OAAO,QAAQ;CACnD,MAAM,WAAW,mBAAmB,OAAO,QAAQ;CAEnD,OACE,CAAC,QACD,EACE,CAAC,eAAe,IAAI,KACnB,YAAY,KAAK,QAAQ,QAAQ,IAAI,KACrC,YAAY,KAAK,QAAQ,QAAQ,IAAI,KACtC,OAAO,oBAAoB,IAAI;AAGrC;;;;;;AAOA,IAAa,8BACX,QACA,SACA,WACyC;CACzC,IACE,CAAC,gBAAgB,OAAO,WAAW,MAAM,KACzC,CAAC,gBAAgB,OAAO,SAAS,MAAM,KACvC,kCAAkC,MAAM,GAExC;CAGF,MAAM,QAAQ,QAAQ,OAAO,WAAW,OAAO,SAAS;CACxD,MAAM,MAAM,QAAQ,OAAO,SAAS,OAAO,OAAO;CAElD,IACE,SAAS,KAAK,MAAM,SAAS,SAAS,KAAK,KAC3C,SAAS,GAAG,MAAM,SAAS,SAAS,GAAG,GAEvC;CAGF,OAAO,SAAS,MAAM;EAAE;EAAO;CAAI,IAAI;AACzC"}

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

@@ -0,0 +1,27 @@
+"use client"
+/* */
+import { listDateToDateTime } from "./dateRange.mjs";
+import { DateFormatter } from "@internationalized/date";
+//#region ../components-base/src/list/filter/formatDateRange.ts
+/** The active filter chip's text: an end with time shows its time. */
+var formatListDateRange = (value, locale, format) => {
+	const formatBound = (bound) => new DateFormatter(locale, {
+		year: "numeric",
+		month: "numeric",
+		day: "numeric",
+		..."hour" in bound ? {
+			hour: "2-digit",
+			minute: "2-digit",
+			hourCycle: "h23"
+		} : {}
+	}).format(listDateToDateTime(bound).toJSDate());
+	const { start, end } = value;
+	if (start && end) return `${formatBound(start)} – ${formatBound(end)}`;
+	if (start) return format("dateRange.from", { date: formatBound(start) });
+	if (end) return format("dateRange.until", { date: formatBound(end) });
+	return "";
+};
+//#endregion
+export { formatListDateRange };
+
+//# sourceMappingURL=formatDateRange.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatDateRange.mjs","names":[],"sources":["../../../../../../../../components-base/src/list/filter/formatDateRange.ts"],"sourcesContent":["import { DateFormatter } from \"@internationalized/date\";\nimport {\n  listDateToDateTime,\n  type ListDateParts,\n  type ListDateRange,\n} from \"./dateRange\";\n\n/** Formats the text of an open range (\"from {date}\", \"until {date}\"). */\nexport type ListDateRangeTextFormat = (\n  key: \"dateRange.from\" | \"dateRange.until\",\n  values: { date: string },\n) => string;\n\n/** The active filter chip's text: an end with time shows its time. */\nexport const formatListDateRange = (\n  value: ListDateRange,\n  locale: string,\n  format: ListDateRangeTextFormat,\n): string => {\n  const formatBound = (bound: ListDateParts) =>\n    new DateFormatter(locale, {\n      year: \"numeric\",\n      month: \"numeric\",\n      day: \"numeric\",\n      // TimeField always shows 24 hours\n      ...(\"hour\" in bound\n        ? { hour: \"2-digit\", minute: \"2-digit\", hourCycle: \"h23\" }\n        : {}),\n    }).format(listDateToDateTime(bound).toJSDate());\n\n  const { start, end } = value;\n\n  if (start && end) {\n    return `${formatBound(start)} – ${formatBound(end)}`;\n  }\n  if (start) {\n    return format(\"dateRange.from\", { date: formatBound(start) });\n  }\n  if (end) {\n    return format(\"dateRange.until\", { date: formatBound(end) });\n  }\n  return \"\";\n};\n"],"mappings":";;;;;;AAcA,IAAa,uBACX,OACA,QACA,WACW;CACX,MAAM,eAAe,UACnB,IAAI,cAAc,QAAQ;EACxB,MAAM;EACN,OAAO;EACP,KAAK;EAEL,GAAI,UAAU,QACV;GAAE,MAAM;GAAW,QAAQ;GAAW,WAAW;EAAM,IACvD,CAAC;CACP,CAAC,CAAC,CAAC,OAAO,mBAAmB,KAAK,CAAC,CAAC,SAAS,CAAC;CAEhD,MAAM,EAAE,OAAO,QAAQ;CAEvB,IAAI,SAAS,KACX,OAAO,GAAG,YAAY,KAAK,EAAE,KAAK,YAAY,GAAG;CAEnD,IAAI,OACF,OAAO,OAAO,kBAAkB,EAAE,MAAM,YAAY,KAAK,EAAE,CAAC;CAE9D,IAAI,KACF,OAAO,OAAO,mBAAmB,EAAE,MAAM,YAAY,GAAG,EAAE,CAAC;CAE7D,OAAO;AACT"}

package/dist/types/_bundled/flow-components-base/index.d.ts

@@ -2,7 +2,9 @@ export { ActionState, actionStateDurations, type ActionStateValue, } from "./act
 export { toArray, type ItemType } from "./lib/array";
 export { ListFilter } from "./list/filter/ListFilter";
 export { ListDateRangeFilter } from "./list/filter/ListDateRangeFilter";
-export { applyDateRangeColumnDef, dateRangeFilterFn, isListDateRange, type ListDateParts, type ListDateRange, } from "./list/filter/dateRange";
+export { applyDateRangeColumnDef, dateRangeFilterFn, isListDateRange, listDateToDateTime, resolveListDateRange, type ListDateParts, type ListDateRange, } from "./list/filter/dateRange";
+export { formatListDateRange, type ListDateRangeTextFormat, } from "./list/filter/formatDateRange";
+export { getListDateTimeRangeUpdate, isListDateTimeRangeEndBeforeStart, isListDateValid, listDateTimeRangeFieldsFromValue, toListCalendarDate, toListTime, type ListDateTimeRange, type ListDateTimeRangeFields, type ListDateTimeRangeLimits, } from "./list/filter/dateTimeRangeFields";
 export { ListFilterValue } from "./list/filter/ListFilterValue";
 export type { FilterMatcher, FilterMode, FilterUpdatedCallback, ListFilterShape, } from "./list/filter/types";
 export { getListColumn, type ListModelContext } from "./list/ListModelContext";

package/dist/types/_bundled/flow-components-base/list/filter/ListFilter.d.ts

@@ -83,6 +83,8 @@ export declare class ListFilter<T = never, TProp extends PropertyName<T> = never
     isActive(): boolean;
     deactivateValue(value: ListFilterValue<TRendered>): void;
     private callOnChangedHandlers;
+    /** Tells the listeners — the list resetting its batches among them. */
+    protected notifyFilterUpdated(values: unknown[]): void;
     hasChanges(): boolean;
     isStoringAvailable(): boolean;
     resetValues(): void;

package/dist/types/_bundled/flow-components-base/list/filter/dateRange.d.ts

@@ -1,9 +1,16 @@
 import type { ColumnDef, Row } from "@tanstack/table-core";
-/** A calendar date, in whichever shape it reached the filter. */
+import { DateTime } from "luxon";
+/**
+ * A calendar date, in whichever shape it reached the filter — with a time of
+ * day when the filter narrows down by minute.
+ */
 export interface ListDateParts {
     readonly year: number;
     readonly month: number;
     readonly day: number;
+    readonly hour?: number;
+    readonly minute?: number;
+    readonly second?: number;
 }
 export interface ListDateRange {
     readonly start?: ListDateParts;
@@ -11,6 +18,22 @@ export interface ListDateRange {
 }
 /** A range needs both ends present to be one, even if either may be unset. */
 export declare const isListDateRange: (value: unknown) => value is ListDateRange;
+/**
+ * The date as a local point in time. A `ZonedDateTime` is the instant it names;
+ * anything else is read field by field, since after crossing the remote
+ * boundary a `CalendarDate` is a plain object.
+ */
+export declare const listDateToDateTime: (date: ListDateParts) => DateTime;
+/**
+ * Resolves a range to the instants it spans, for filtering on the server side.
+ * Both bounds are inclusive: a date covers its whole day and a date with time
+ * its whole minute, in the user's local time zone. A missing side has no
+ * bound.
+ */
+export declare const resolveListDateRange: (range: ListDateRange) => {
+    start?: Date;
+    end?: Date;
+};
 /**
  * Whether a row's date falls inside the selected range.
  *

package/dist/types/_bundled/flow-components-base/list/filter/dateTimeRangeFields.d.ts

@@ -0,0 +1,34 @@
+import { CalendarDate, type CalendarDateTime, Time } from "@internationalized/date";
+import { type ListDateParts, type ListDateRange } from "./dateRange";
+export interface ListDateTimeRangeFields {
+    readonly startDate: CalendarDate | null;
+    readonly startTime: Time | null;
+    readonly endDate: CalendarDate | null;
+    readonly endTime: Time | null;
+}
+export interface ListDateTimeRangeLimits {
+    readonly minValue?: ListDateParts | null;
+    readonly maxValue?: ListDateParts | null;
+    readonly isDateUnavailable?: (date: CalendarDate) => boolean;
+}
+type Bound = CalendarDate | CalendarDateTime;
+export interface ListDateTimeRange {
+    readonly start?: Bound;
+    readonly end?: Bound;
+}
+export declare const toListCalendarDate: (value?: ListDateParts | null) => CalendarDate | null;
+export declare const toListTime: (value?: {
+    readonly hour?: number;
+    readonly minute?: number;
+} | null) => Time | null;
+export declare const listDateTimeRangeFieldsFromValue: (value: ListDateRange | null) => ListDateTimeRangeFields;
+/** Not while a year is still being typed: "2" would read as an early end. */
+export declare const isListDateTimeRangeEndBeforeStart: (fields: ListDateTimeRangeFields) => boolean;
+export declare const isListDateValid: (date: CalendarDate | null, limits?: ListDateTimeRangeLimits) => boolean;
+/**
+ * The range the fields stand for, or `undefined` while it must not be applied:
+ * an invalid input keeps the last valid range, and an unchanged one needs no
+ * update. `null` clears the filter.
+ */
+export declare const getListDateTimeRangeUpdate: (fields: ListDateTimeRangeFields, applied: ListDateRange | null, limits?: ListDateTimeRangeLimits) => ListDateTimeRange | null | undefined;
+export {};

package/dist/types/_bundled/flow-components-base/list/filter/formatDateRange.d.ts

@@ -0,0 +1,7 @@
+import { type ListDateRange } from "./dateRange";
+/** Formats the text of an open range ("from {date}", "until {date}"). */
+export type ListDateRangeTextFormat = (key: "dateRange.from" | "dateRange.until", values: {
+    date: string;
+}) => string;
+/** The active filter chip's text: an end with time shows its time. */
+export declare const formatListDateRange: (value: ListDateRange, locale: string, format: ListDateRangeTextFormat) => string;

package/dist/types/components/CartesianChart/hooks/useTickLabelWidth.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/components/CodeBlock/CodeBlock.d.ts

@@ -8,7 +8,7 @@ export interface CodeBlockProps extends PropsWithClassName, PropsWithChildren, P
      * Controls truncation of long code blocks. `false` disables it, `true`
      * truncates after 8 lines, and a number sets the maximum line count.
      *
-     * @default: false
+     * @default false
      */
     truncateLines?: boolean | number;
 }

package/dist/types/components/DonutChart/DonutChart.d.ts

@@ -15,10 +15,7 @@ export interface DonutChartProps extends Omit<Aria.ProgressBarProps, "children"
     size?: "m" | "l";
     /** Divides the fill of the donut chart into segments */
     segments?: DonutChartSegment[];
-    /**
-     * Whether the legend component is shown when segments are used. @default:
-     * true
-     */
+    /** Whether the legend component is shown when segments are used. @default true */
     showLegend?: boolean;
     /** The position of the legend. @default "right" */
     legendPosition?: "top" | "left" | "bottom" | "right";

package/dist/types/components/List/components/Header/components/DateTimeRangeFields/DateTimeRangeFields.d.ts

@@ -0,0 +1,8 @@
+import { FC } from 'react';
+import { AnyDateRangeFilter } from '../../../../model/filter/types';
+interface Props {
+    filter: AnyDateRangeFilter;
+    className?: string;
+}
+export declare const DateTimeRangeFields: FC<Props>;
+export default DateTimeRangeFields;

package/dist/types/components/List/components/Items/components/Item/Item.d.ts

@@ -7,6 +7,8 @@ interface Props extends PropsWithChildren {
     triggerRef?: Ref<HTMLDivElement>;
     list: ListModel<never>;
     isTile: boolean;
+    /** Stable invoker of the list's latest `onAction` */
+    onAction?: (data: never) => void;
 }
 export declare const Item: import('react').MemoExoticComponent<(props: Props) => import('react').JSX.Element | null>;
 interface ItemContainerProps extends PropsWithChildren {

package/dist/types/components/List/components/Items/components/Item/hooks/useGridItemProps.d.ts

@@ -2,6 +2,7 @@ import { PropsWithChildren } from 'react';
 import { default as List } from '../../../../../model/List';
 interface P extends PropsWithChildren {
     data: never;
+    onAction?: (data: never) => void;
 }
 export declare const useGridItemProps: (props: P, list: List<never>) => {
     gridItemProps: {

package/dist/types/components/List/components/ListSummary/ListSummary.d.ts

@@ -1,7 +1,8 @@
 import { PropsWithChildren } from 'react';
 import { FlowComponentProps } from '../../../../lib/componentFactory/flowComponent';
-export interface ListSummaryProps extends FlowComponentProps, PropsWithChildren {
-    /** Whether the summary is placed above or underneath the list @default: "top" */
+import { PropsWithClassName } from '../../../../lib/types/props';
+export interface ListSummaryProps extends PropsWithClassName, FlowComponentProps, PropsWithChildren {
+    /** Whether the summary is placed above or underneath the list @default "top" */
     position?: "top" | "bottom";
 }
 /** @flr-generate all */

package/dist/types/components/List/components/Table/components/Row.d.ts

@@ -0,0 +1,13 @@
+import { Ref } from 'react';
+import { Key } from 'react-aria-components';
+import { default as ListModel } from '../../../model/List';
+interface Props {
+    id: Key;
+    data: never;
+    list: ListModel<never>;
+    /** Stable invoker of the list's latest `onAction` */
+    onAction?: (data: never) => void;
+    triggerRef?: Ref<HTMLTableRowElement>;
+}
+export declare const Row: import('react').MemoExoticComponent<(props: Props) => import('react').JSX.Element | null>;
+export default Row;

package/dist/types/components/List/hooks/useLatestOnAction.d.ts

@@ -0,0 +1,7 @@
+import { default as List } from '../model/List';
+/**
+ * A stable invoker of the list's latest `onAction`, or `undefined` without one.
+ * An event handler only ever needs to be the latest one, so items and rows do
+ * not re-render for an inline `onAction`.
+ */
+export declare const useLatestOnAction: (list: List<never>) => ((data: never) => void | undefined) | undefined;

package/dist/types/components/List/index.d.ts

@@ -1,6 +1,8 @@
 export type { RenderItemFn } from './model/item/types';
 export type { AsyncDataLoader, AsyncResourceFactory, DataLoaderOptions, DataLoaderResult, } from './model/loading/types';
 export type { SortingFn } from './model/sorting/types';
+export type { DateRangeFilterOptions, DateRangeFilterValue, } from './model/filter/types';
+export { resolveDateRangeFilterValue } from './model/filter/resolveDateRangeFilterValue';
 export { SortingFunctions } from './model/sorting/SortingFunctions';
 export * from './components/Items/views/GridList';
 export * from './components/Items/views/GridListItem';

package/dist/types/components/List/model/filter/DateRangeFilter.d.ts

@@ -1,9 +1,7 @@
 import { ListDateRangeFilter, ListModelContext } from '../../../../_bundled/flow-components-base/index';
-import { FilterShape } from './types';
+import { DateRangeFilterOptions, DateRangeFilterValue, FilterShape } from './types';
 import { PropertyName } from '../types';
 import { RangeCalendarProps } from '../../../Calendar';
-import { DateValue } from '@internationalized/date';
-import { DateRange, RangeValue } from 'react-aria-components';
 import { ReactNode } from 'react';
 import { List } from '../List';
 import { FilterValue } from './FilterValue';
@@ -12,14 +10,23 @@ import { FilterValue } from './FilterValue';
  *
  * The column, the comparison and the stored value are `ListDateRangeFilter` in
  * `@mittwald/flow-components-base`, so the Vue binding filters the same dates
- * the same way. What is left here is the calendar's own options, which are
- * Flow's `RangeCalendar` props.
+ * the same way. What is left here are the options of the fields that pick the
+ * range: Flow's `RangeCalendar` props, or with `granularity: "minute"` those of
+ * the date and time fields.
  */
 export declare class DateRangeFilter<T = never, TProp extends PropertyName<T> = never> extends ListDateRangeFilter<T, TProp, ReactNode> {
-    readonly dateRangeOptions?: RangeCalendarProps;
+    readonly dateRangeOptions?: DateRangeFilterOptions;
     constructor(context: ListModelContext<T>, shape: FilterShape<T, TProp, never>);
-    getValue(): DateRange | null;
-    setValue(range: RangeValue<DateValue> | null): void;
+    get granularity(): "day" | "minute";
+    get rangeCalendarProps(): RangeCalendarProps;
+    get dateTimeRangeOptions(): {
+        granularity: "minute";
+        minValue?: import('@internationalized/date').DateValue | null;
+        maxValue?: import('@internationalized/date').DateValue | null;
+        isDateUnavailable?: (date: import('@internationalized/date').DateValue) => boolean;
+    } | undefined;
+    getValue(): DateRangeFilterValue | null;
+    setValue(range: DateRangeFilterValue | null): void;
     /** The list this filter belongs to — `context`, typed as React's `List`. */
     get list(): List<T>;
     get values(): FilterValue[];

package/dist/types/components/List/model/filter/resolveDateRangeFilterValue.d.ts

@@ -0,0 +1,11 @@
+import { DateRangeFilterValue } from './types';
+/**
+ * Resolves the value of a date range filter to the instants it spans, for
+ * filtering on the server side. Both bounds are inclusive: a date covers its
+ * whole day and a date with time its whole minute, in the user's local time
+ * zone. A missing side has no bound.
+ */
+export declare const resolveDateRangeFilterValue: (range: DateRangeFilterValue) => {
+    start?: Date;
+    end?: Date;
+};

package/dist/types/components/List/model/filter/types.d.ts

@@ -3,8 +3,30 @@ import { PropertyName } from '../types';
 import { RangeCalendarProps } from '../../../Calendar';
 import { ListFilterShape } from '../../../../_bundled/flow-components-base/index';
 import { ReactNode } from 'react';
+import { DateValue } from '@internationalized/date';
 export type { FilterMatcher, FilterMode, FilterUpdatedCallback, } from '../../../../_bundled/flow-components-base/index';
 export interface FilterShape<T, TProp extends PropertyName<T>, TMatcherValue> extends ListFilterShape<T, TProp, TMatcherValue, ReactNode> {
-    dateRangeOptions?: RangeCalendarProps;
+    dateRangeOptions?: DateRangeFilterOptions;
+}
+export type DateRangeFilterOptions = ({
+    /**
+     * Whether the filter narrows down by date only, or by date and time.
+     *
+     * @default "day"
+     */
+    granularity?: "day";
+} & RangeCalendarProps) | {
+    granularity: "minute";
+    minValue?: DateValue | null;
+    maxValue?: DateValue | null;
+    isDateUnavailable?: (date: DateValue) => boolean;
+};
+/**
+ * A date covers its whole day, a date with time its whole minute. A missing
+ * side has no bound.
+ */
+export interface DateRangeFilterValue {
+    start?: DateValue;
+    end?: DateValue;
 }
 export type AnyDateRangeFilter = DateRangeFilter | DateRangeFilter<any, any>;