@marimo-team/islands 0.23.9-dev3 → 0.23.9-dev4

package/src/components/data-table/filter-pills.tsx

@@ -2,62 +2,154 @@
 "use no memo";
 
 import type { ColumnFiltersState, Table } from "@tanstack/react-table";
-import { XIcon } from "lucide-react";
-import { useState } from "react";
-import { type DateFormatter, useDateFormatter } from "react-aria";
+import { MoreHorizontalIcon, XIcon } from "lucide-react";
+import { useLayoutEffect, useRef, useState } from "react";
+import { useLocale } from "react-aria";
 import type { CalculateTopKRows } from "@/plugins/impl/DataTablePlugin";
-import { logNever } from "@/utils/assertNever";
 import { cn } from "@/utils/cn";
 import { Badge } from "../ui/badge";
 import { Button } from "../ui/button";
-import { Popover, PopoverContent, PopoverTrigger } from "../ui/popover";
-import { FilterPillEditor } from "./filter-pill-editor";
+import { DraggablePopover } from "../ui/draggable-popover";
 import {
-  type ColumnFilterValue,
-  dateToISODate,
-  dateToISODateTime,
-} from "./filters";
-import { OPERATOR_LABELS } from "./operator-labels";
-import { stringifyUnknownValue } from "./utils";
+  Popover,
+  PopoverClose,
+  PopoverContent,
+  PopoverTrigger,
+} from "../ui/popover";
+import { Tooltip } from "../ui/tooltip";
+import { AddFilterButton } from "./add-filter-button";
+import { FilterPillEditor } from "./filter-pill-editor";
+import { type ColumnFilterValue, formatValue, type Snapshot } from "./filters";
+import { extractTimezone } from "./types";
+import { ChipWithComma, CompactChipRow } from "./value-chips";
 
 interface Props<TData> {
   filters: ColumnFiltersState | undefined;
   table: Table<TData>;
   calculateTopKRows?: CalculateTopKRows;
+  addFilterSnapshot: Snapshot | null;
+  onAddFilterSnapshotChange: (snapshot: Snapshot | null) => void;
 }
 
+const useHasOverflow = (
+  ref: React.RefObject<HTMLElement | null>,
+  signature: string,
+): boolean => {
+  const [hasOverflow, setHasOverflow] = useState(false);
+  useLayoutEffect(() => {
+    const el = ref.current;
+    if (!el) {
+      return;
+    }
+    const measure = () => setHasOverflow(el.scrollWidth > el.clientWidth);
+    measure();
+    const ro = new ResizeObserver(measure);
+    ro.observe(el);
+    return () => ro.disconnect();
+    // biome-ignore lint/correctness/useExhaustiveDependencies: signature triggers re-measure on filter content change
+  }, [ref, signature]);
+  return hasOverflow;
+};
+
 export const FilterPills = <TData,>({
   filters,
   table,
   calculateTopKRows,
+  addFilterSnapshot,
+  onAddFilterSnapshotChange,
 }: Props<TData>) => {
-  const timeFormatter = useDateFormatter({
-    hour: "2-digit",
-    minute: "2-digit",
-    second: "2-digit",
-  });
+  const { locale } = useLocale();
+
+  const containerRef = useRef<HTMLDivElement | null>(null);
+  const [overflowOpen, setOverflowOpen] = useState(false);
+  const allFilters = filters ?? [];
+  const signature = allFilters
+    .map((f) => `${f.id}:${JSON.stringify(f.value)}`)
+    .join("|");
+  const hasOverflow = useHasOverflow(containerRef, signature);
 
-  if (!filters || filters.length === 0) {
+  if (allFilters.length === 0 && addFilterSnapshot === null) {
     return null;
   }
 
+  const renderPill = (filter: ColumnFiltersState[number], index: number) => (
+    <FilterPill
+      key={`${filter.id}:${index}`}
+      columnId={filter.id}
+      value={filter.value as ColumnFilterValue}
+      index={index}
+      locale={locale}
+      table={table}
+      calculateTopKRows={calculateTopKRows}
+      onRemove={() =>
+        table.setColumnFilters((current) =>
+          current.filter((_, i) => i !== index),
+        )
+      }
+    />
+  );
+
   return (
-    <div part="filter-pills" className="flex flex-wrap gap-2 px-1 py-2">
-      {filters.map((filter) => (
-        <FilterPill
-          key={filter.id}
-          columnId={filter.id}
-          value={filter.value as ColumnFilterValue}
-          timeFormatter={timeFormatter}
-          table={table}
-          calculateTopKRows={calculateTopKRows}
-          onRemove={() =>
-            table.setColumnFilters((filters) =>
-              filters.filter((f) => f.id !== filter.id),
-            )
-          }
-        />
-      ))}
+    <div
+      part="filter-pills"
+      className="relative flex items-center gap-2 px-1 py-2"
+    >
+      <AddFilterButton
+        table={table}
+        calculateTopKRows={calculateTopKRows}
+        snapshot={addFilterSnapshot}
+        onSnapshotChange={onAddFilterSnapshotChange}
+      />
+      <div
+        ref={containerRef}
+        className={cn(
+          "flex flex-nowrap items-center gap-2 overflow-hidden min-w-0 flex-1",
+          hasOverflow &&
+            "mask-[linear-gradient(to_right,black_calc(100%-2rem),transparent)]",
+        )}
+      >
+        {allFilters.map((filter, index) => renderPill(filter, index))}
+      </div>
+      {hasOverflow && (
+        <button
+          type="button"
+          onClick={() => setOverflowOpen(true)}
+          className="shrink-0 inline-flex items-center gap-0.5 rounded-full border border-border bg-background px-2 py-0.5 text-xs text-foreground hover:bg-accent hover:text-accent-foreground"
+          aria-label="See all filters"
+        >
+          <MoreHorizontalIcon className="h-3.5 w-3.5" aria-hidden={true} />
+          <span>See all</span>
+        </button>
+      )}
+      {hasOverflow && (
+        <DraggablePopover
+          open={overflowOpen}
+          onOpenChange={setOverflowOpen}
+          className="w-fit max-w-[min(90vw,40rem)] p-0"
+        >
+          <PopoverClose className="absolute top-2 right-2" aria-label="Close">
+            <XIcon className="h-4 w-4" aria-hidden={true} />
+          </PopoverClose>
+          <div className="flex flex-col pt-7">
+            <div className="max-h-80 overflow-y-auto flex flex-col items-start gap-2 px-3 pb-2">
+              {allFilters.map((filter, index) => renderPill(filter, index))}
+            </div>
+            <div className="flex justify-end border-t border-border px-3 py-2">
+              <Button
+                type="button"
+                size="sm"
+                variant="ghost"
+                onClick={() => {
+                  table.setColumnFilters([]);
+                  setOverflowOpen(false);
+                }}
+              >
+                Clear all
+              </Button>
+            </div>
+          </div>
+        </DraggablePopover>
+      )}
     </div>
   );
 };
@@ -65,7 +157,8 @@ export const FilterPills = <TData,>({
 interface FilterPillProps<TData> {
   columnId: string;
   value: ColumnFilterValue;
-  timeFormatter: DateFormatter;
+  index: number;
+  locale: string;
   table: Table<TData>;
   calculateTopKRows?: CalculateTopKRows;
   onRemove: () => void;
@@ -74,28 +167,63 @@ interface FilterPillProps<TData> {
 const FilterPill = <TData,>({
   columnId,
   value,
-  timeFormatter,
+  index,
+  locale,
   table,
   calculateTopKRows,
   onRemove,
 }: FilterPillProps<TData>) => {
   const [open, setOpen] = useState(false);
 
-  const formatted = formatValue(value, timeFormatter);
+  const timezone = extractTimezone(
+    table.getColumn(columnId)?.columnDef.meta?.dtype,
+  );
+  const formatted = formatValue(value, { locale, timezone });
   if (!formatted) {
     return null;
   }
 
-  const twoSegment = formatted.value === undefined;
+  const twoSegment =
+    formatted.kind === "scalar" && formatted.value === undefined;
 
   const handleRemove = (e: React.MouseEvent) => {
     e.stopPropagation();
     onRemove();
   };
 
-  const segments = (
+  const renderValue = (truncateValue: boolean) => {
+    if (formatted.kind === "scalar") {
+      return (
+        <span
+          className={cn(
+            "font-semibold text-foreground",
+            truncateValue &&
+              "inline-block max-w-[24ch] overflow-hidden text-ellipsis whitespace-nowrap align-middle",
+          )}
+        >
+          {formatted.value}
+        </span>
+      );
+    }
+    if (truncateValue) {
+      return <CompactChipRow items={formatted.items} max={3} />;
+    }
+    return (
+      <span className="grid grid-cols-[repeat(5,max-content)] gap-1">
+        {formatted.items.map((item, i) => (
+          <ChipWithComma
+            key={i}
+            value={item}
+            showComma={i < formatted.items.length - 1}
+          />
+        ))}
+      </span>
+    );
+  };
+
+  const renderSegments = (truncateValue: boolean) => (
     <>
-      <span className="text-foreground">{columnId}</span>
+      <span className="font-semibold text-foreground">{columnId}</span>
       <Separator />
       <span
         className={cn(
@@ -108,12 +236,17 @@ const FilterPill = <TData,>({
       {!twoSegment && (
         <>
           <Separator />
-          <span className="text-foreground">{formatted.value}</span>
+          {renderValue(truncateValue)}
         </>
       )}
     </>
   );
 
+  const tooltip = (
+    <span className="inline-flex items-center">{renderSegments(false)}</span>
+  );
+  const segments = renderSegments(true);
+
   const removeButton = (
     <Button
       type="button"
@@ -138,16 +271,20 @@ const FilterPill = <TData,>({
           "transition-colors",
         )}
       >
-        <PopoverTrigger asChild={true}>
-          <button
-            type="button"
-            className="inline-flex items-center cursor-pointer bg-transparent border-0 p-0 [font:inherit] text-inherit"
-            aria-label={`Edit filter on ${columnId}`}
-          >
-            {segments}
-          </button>
-        </PopoverTrigger>
-        {removeButton}
+        <Tooltip content={tooltip} delayDuration={600}>
+          <span className="inline-flex items-center">
+            <PopoverTrigger asChild={true}>
+              <button
+                type="button"
+                className="inline-flex items-center whitespace-nowrap cursor-pointer bg-transparent border-0 p-0 [font:inherit] text-inherit"
+                aria-label={`Edit filter on ${columnId}`}
+              >
+                {segments}
+              </button>
+            </PopoverTrigger>
+            {removeButton}
+          </span>
+        </Tooltip>
       </Badge>
       <PopoverContent
         className="w-auto p-0"
@@ -156,9 +293,11 @@ const FilterPill = <TData,>({
         sideOffset={10}
         avoidCollisions={true}
         onOpenAutoFocus={(e) => e.preventDefault()}
+        onCloseAutoFocus={(e) => e.preventDefault()}
       >
         <FilterPillEditor
           snapshot={{ columnId, value }}
+          editIndex={index}
           table={table}
           calculateTopKRows={calculateTopKRows}
           onClose={() => setOpen(false)}
@@ -173,105 +312,3 @@ function Separator() {
     <span aria-hidden={true} className="mx-1.5 w-px h-3 bg-foreground/30" />
   );
 }
-
-interface FormattedFilter {
-  operator: string;
-  value?: string;
-}
-
-function formatValue(
-  value: ColumnFilterValue,
-  timeFormatter: DateFormatter,
-): FormattedFilter | undefined {
-  if (!("type" in value)) {
-    return;
-  }
-
-  if (value.operator === "is_null") {
-    return { operator: "is null" };
-  }
-  if (value.operator === "is_not_null") {
-    return { operator: "is not null" };
-  }
-
-  if (value.type === "number") {
-    switch (value.operator) {
-      case "between":
-        return {
-          operator: OPERATOR_LABELS.between.toLowerCase(),
-          value: `${value.min} - ${value.max}`,
-        };
-      case "==":
-      case "!=":
-      case ">":
-      case ">=":
-      case "<":
-      case "<=":
-        return { operator: value.operator, value: String(value.value) };
-    }
-  }
-  if (value.type === "text") {
-    switch (value.operator) {
-      case "in":
-      case "not_in": {
-        const items = value.values.map((v) => `"${v}"`);
-        return {
-          operator: value.operator === "in" ? "is in" : "not in",
-          value: `[${items.join(", ")}]`,
-        };
-      }
-      case "is_empty":
-        return { operator: "is empty" };
-      case "contains":
-      case "equals":
-      case "does_not_equal":
-      case "regex":
-      case "starts_with":
-      case "ends_with":
-        return {
-          operator: OPERATOR_LABELS[value.operator].toLowerCase(),
-          value: `"${value.text}"`,
-        };
-    }
-  }
-  if (
-    value.type === "date" ||
-    value.type === "datetime" ||
-    value.type === "time"
-  ) {
-    const format =
-      value.type === "time"
-        ? (d: Date) => timeFormatter.format(d)
-        : value.type === "date"
-          ? dateToISODate
-          : dateToISODateTime;
-    switch (value.operator) {
-      case "between":
-        return {
-          operator: OPERATOR_LABELS.between.toLowerCase(),
-          value: `${format(value.min)} - ${format(value.max)}`,
-        };
-      case "==":
-      case "!=":
-      case ">":
-      case ">=":
-      case "<":
-      case "<=":
-        return { operator: value.operator, value: format(value.value) };
-    }
-  }
-  if (value.type === "boolean") {
-    return { operator: `is ${value.value ? "True" : "False"}` };
-  }
-  if (value.type === "select") {
-    const stringifiedOptions = value.options.map((o) =>
-      stringifyUnknownValue({ value: o }),
-    );
-    return {
-      operator: value.operator === "in" ? "is in" : "not in",
-      value: `[${stringifiedOptions.join(", ")}]`,
-    };
-  }
-  logNever(value);
-  return undefined;
-}

package/src/components/data-table/filters/builders.ts

@@ -0,0 +1,102 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+import type {
+  BooleanOp,
+  ComparisonOp,
+  MembershipOp,
+  NullishOp,
+  TextScalarOp,
+} from "./operators";
+import type { FilterType } from "./types";
+
+interface NullishOpts {
+  operator: NullishOp;
+}
+
+interface MembershipOpts {
+  operator: MembershipOp;
+  values: unknown[];
+}
+
+interface BetweenRangeOpts<T> {
+  operator: "between";
+  min: T;
+  max: T;
+}
+
+type NumberFilterOpts =
+  | { operator: ComparisonOp; value: number }
+  | BetweenRangeOpts<number>
+  | MembershipOpts
+  | NullishOpts;
+
+type TextFilterOpts =
+  | { operator: TextScalarOp; text: string }
+  | { operator: "is_empty" }
+  | MembershipOpts
+  | NullishOpts;
+
+type DateLikeFilterOpts =
+  | { operator: ComparisonOp; value: Date }
+  | BetweenRangeOpts<Date>
+  | NullishOpts;
+
+interface BooleanFilterOpts {
+  operator: BooleanOp;
+}
+
+// Filter is a factory function that creates a filter object
+export const Filter = {
+  number(opts: NumberFilterOpts) {
+    return {
+      type: "number",
+      ...opts,
+    } as const;
+  },
+  text(opts: TextFilterOpts) {
+    return {
+      type: "text",
+      ...opts,
+    } as const;
+  },
+  date(opts: DateLikeFilterOpts) {
+    return {
+      type: "date",
+      ...opts,
+    } as const;
+  },
+  datetime(opts: DateLikeFilterOpts) {
+    return {
+      type: "datetime",
+      ...opts,
+    } as const;
+  },
+  time(opts: DateLikeFilterOpts) {
+    return {
+      type: "time",
+      ...opts,
+    } as const;
+  },
+  boolean(opts: BooleanFilterOpts) {
+    return {
+      type: "boolean",
+      ...opts,
+    } as const;
+  },
+};
+
+export type ColumnFilterValue = ReturnType<
+  (typeof Filter)[keyof typeof Filter]
+>;
+export type ColumnFilterForType<T extends FilterType> = T extends FilterType
+  ? Extract<ColumnFilterValue, { type: T }>
+  : never;
+export type MembershipFilterType = Extract<
+  ColumnFilterValue,
+  { operator: "in" | "not_in" }
+>["type"];
+
+export interface Snapshot {
+  columnId: string;
+  value: ColumnFilterValue;
+}

package/src/components/data-table/filters/defaults.ts

@@ -0,0 +1,31 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+"use no memo";
+
+import type { Column } from "@tanstack/react-table";
+import type { OperatorType } from "@/plugins/impl/data-frames/utils/operators";
+import type { ColumnFilterValue } from "./builders";
+import { isMembershipFilterType, isMembershipOp } from "./guards";
+import { EDITABLE_FILTER_TYPES, type FilterType } from "./types";
+
+export function columnEditableType<TData, TValue>(
+  column: Column<TData, TValue>,
+): FilterType {
+  const ft = column.columnDef.meta?.filterType;
+  if (!ft || !EDITABLE_FILTER_TYPES.has(ft)) {
+    throw new Error(
+      `Invalid or missing filterType for column ${column.id}: ${ft}`,
+    );
+  }
+  return ft;
+}
+
+/** Minimal ColumnFilterValue for a (type, operator) pair, seeding extra fields for shapes that require them. */
+export function defaultFilterValueFor(
+  type: FilterType,
+  operator: OperatorType,
+): ColumnFilterValue {
+  if (isMembershipFilterType(type) && isMembershipOp(operator)) {
+    return { type, operator, values: [] };
+  }
+  return { type, operator } as ColumnFilterValue;
+}

package/src/components/data-table/filters/format.ts

@@ -0,0 +1,131 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+import { logNever } from "@/utils/assertNever";
+import {
+  dateToLocalISODate,
+  dateToLocalISOTime,
+  exactDateTime,
+} from "@/utils/dates";
+import { OPERATOR_LABELS } from "../operator-labels";
+import { stringifyUnknownValue } from "../utils";
+import type { ColumnFilterValue } from "./builders";
+import type { FormattedFilter } from "./types";
+
+interface FormatContext {
+  locale: string;
+  timezone: string | undefined;
+}
+
+export function formatValue(
+  value: ColumnFilterValue,
+  ctx: FormatContext,
+): FormattedFilter | undefined {
+  if (!("type" in value)) {
+    return;
+  }
+
+  if (value.operator === "is_null") {
+    return { kind: "scalar", operator: "is null" };
+  }
+  if (value.operator === "is_not_null") {
+    return { kind: "scalar", operator: "is not null" };
+  }
+
+  if (value.type === "number") {
+    switch (value.operator) {
+      case "between":
+        return {
+          kind: "scalar",
+          operator: OPERATOR_LABELS.between.toLowerCase(),
+          value: `${value.min} - ${value.max}`,
+        };
+      case "==":
+      case "!=":
+      case ">":
+      case ">=":
+      case "<":
+      case "<=":
+        return {
+          kind: "scalar",
+          operator: value.operator,
+          value: String(value.value),
+        };
+      case "in":
+      case "not_in":
+        return {
+          kind: "list",
+          operator: value.operator === "in" ? "is in" : "not in",
+          items: value.values
+            .map((v) => stringifyUnknownValue({ value: v }))
+            .toSorted((a, b) => a.localeCompare(b)),
+        };
+    }
+  }
+  if (value.type === "text") {
+    switch (value.operator) {
+      case "in":
+      case "not_in":
+        return {
+          kind: "list",
+          operator: value.operator === "in" ? "is in" : "not in",
+          items: value.values
+            .map((v) => stringifyUnknownValue({ value: v }))
+            .toSorted((a, b) => a.localeCompare(b)),
+        };
+      case "is_empty":
+        return { kind: "scalar", operator: "is empty" };
+      case "contains":
+      case "equals":
+      case "does_not_equal":
+      case "regex":
+      case "starts_with":
+      case "ends_with":
+        return {
+          kind: "scalar",
+          operator: OPERATOR_LABELS[value.operator].toLowerCase(),
+          value: `"${value.text}"`,
+        };
+    }
+  }
+  if (
+    value.type === "date" ||
+    value.type === "datetime" ||
+    value.type === "time"
+  ) {
+    const format =
+      value.type === "date"
+        ? dateToLocalISODate
+        : value.type === "time"
+          ? dateToLocalISOTime
+          : (d: Date) => exactDateTime(d, ctx.timezone, ctx.locale);
+    switch (value.operator) {
+      case "between":
+        return {
+          kind: "scalar",
+          operator: OPERATOR_LABELS.between.toLowerCase(),
+          value: `${format(value.min)} - ${format(value.max)}`,
+        };
+      case "==":
+      case "!=":
+      case ">":
+      case ">=":
+      case "<":
+      case "<=":
+        return {
+          kind: "scalar",
+          operator: value.operator,
+          value: format(value.value),
+        };
+    }
+  }
+  if (value.type === "boolean") {
+    switch (value.operator) {
+      case "is_true":
+        return { kind: "scalar", operator: "is True" };
+      case "is_false":
+        return { kind: "scalar", operator: "is False" };
+    }
+  }
+  logNever(value);
+  return undefined;
+}