@prairielearn/ui 1.4.0 → 1.6.0

package/dist/components/nuqs.test.js

@@ -0,0 +1,231 @@
+import { describe, expect, it } from 'vitest';
+import { parseAsColumnPinningState, parseAsColumnVisibilityStateWithColumns, parseAsNumericFilter, parseAsSortingState, } from './nuqs.js';
+describe('parseAsSortingState', () => {
+    describe('parse', () => {
+        it('parses valid asc', () => {
+            expect(parseAsSortingState.parse('col:asc')).toEqual([{ id: 'col', desc: false }]);
+        });
+        it('parses valid desc', () => {
+            expect(parseAsSortingState.parse('col:desc')).toEqual([{ id: 'col', desc: true }]);
+        });
+        it('parses multiple columns', () => {
+            expect(parseAsSortingState.parse('col1:asc,col2:desc')).toEqual([
+                { id: 'col1', desc: false },
+                { id: 'col2', desc: true },
+            ]);
+        });
+        it('ignores invalid columns in multi-column', () => {
+            expect(parseAsSortingState.parse('col1:asc,invalid,foo:bar,col2:desc')).toEqual([
+                { id: 'col1', desc: false },
+                { id: 'col2', desc: true },
+            ]);
+        });
+        it('returns [] for empty string', () => {
+            expect(parseAsSortingState.parse('')).toEqual([]);
+        });
+        it('returns [] for missing id', () => {
+            expect(parseAsSortingState.parse(':asc')).toEqual([]);
+        });
+        it('returns [] for invalid direction', () => {
+            expect(parseAsSortingState.parse('col:foo')).toEqual([]);
+        });
+        it('returns [] for undefined', () => {
+            expect(parseAsSortingState.parse(undefined)).toEqual([]);
+        });
+    });
+    describe('serialize', () => {
+        it('serializes asc', () => {
+            const state = [{ id: 'col', desc: false }];
+            expect(parseAsSortingState.serialize(state)).toBe('col:asc');
+        });
+        it('serializes desc', () => {
+            const state = [{ id: 'col', desc: true }];
+            expect(parseAsSortingState.serialize(state)).toBe('col:desc');
+        });
+        it('serializes multiple columns', () => {
+            const state = [
+                { id: 'col1', desc: false },
+                { id: 'col2', desc: true },
+            ];
+            expect(parseAsSortingState.serialize(state)).toBe('col1:asc,col2:desc');
+        });
+        it('serializes empty array as null', () => {
+            expect(parseAsSortingState.serialize([])).toBe(null);
+        });
+        it('serializes missing id as empty string', () => {
+            expect(parseAsSortingState.serialize([{ id: '', desc: false }])).toBe('');
+        });
+    });
+    describe('eq', () => {
+        it('returns true for equal states', () => {
+            const a = [{ id: 'col', desc: false }];
+            const b = [{ id: 'col', desc: false }];
+            expect(parseAsSortingState.eq(a, b)).toBe(true);
+        });
+        it('returns true for equal multi-column states', () => {
+            const a = [
+                { id: 'col1', desc: false },
+                { id: 'col2', desc: true },
+            ];
+            const b = [
+                { id: 'col1', desc: false },
+                { id: 'col2', desc: true },
+            ];
+            expect(parseAsSortingState.eq(a, b)).toBe(true);
+        });
+        // The order of the sort columns matters for multi-column sorting.
+        it('returns false for different order in multi-column', () => {
+            const a = [
+                { id: 'col1', desc: false },
+                { id: 'col2', desc: true },
+            ];
+            const b = [
+                { id: 'col2', desc: true },
+                { id: 'col1', desc: false },
+            ];
+            expect(parseAsSortingState.eq(a, b)).toBe(false);
+        });
+        it('returns false for different ids', () => {
+            const a = [{ id: 'col1', desc: false }];
+            const b = [{ id: 'col2', desc: false }];
+            expect(parseAsSortingState.eq(a, b)).toBe(false);
+        });
+        it('returns false for different desc', () => {
+            const a = [{ id: 'col', desc: false }];
+            const b = [{ id: 'col', desc: true }];
+            expect(parseAsSortingState.eq(a, b)).toBe(false);
+        });
+        it('returns true for both empty', () => {
+            expect(parseAsSortingState.eq([], [])).toBe(true);
+        });
+        it('returns false for one empty, one not', () => {
+            expect(parseAsSortingState.eq([], [{ id: 'col', desc: false }])).toBe(false);
+        });
+    });
+});
+describe('parseAsColumnVisibilityStateWithColumns', () => {
+    const allColumns = ['a', 'b', 'c'];
+    const parser = parseAsColumnVisibilityStateWithColumns(allColumns);
+    it('parses empty string as all columns visible', () => {
+        expect(parser.parse('')).toEqual({ a: true, b: true, c: true });
+    });
+    it('parses comma-separated columns as only those visible', () => {
+        expect(parser.parse('a,b')).toEqual({ a: true, b: true, c: false });
+        expect(parser.parse('b')).toEqual({ a: false, b: true, c: false });
+    });
+    it('serializes partial visibility as comma-separated columns', () => {
+        expect(parser.serialize({ a: true, b: false, c: true })).toBe('a,c');
+        expect(parser.serialize({ a: false, b: true, c: false })).toBe('b');
+    });
+    it('eq returns true for equal visibility', () => {
+        expect(parser.eq({ a: true, b: false, c: true }, { a: true, b: false, c: true })).toBe(true);
+    });
+    it('eq returns false for different visibility', () => {
+        expect(parser.eq({ a: true, b: false, c: true }, { a: false, b: false, c: true })).toBe(false);
+    });
+});
+describe('parseAsColumnPinningState', () => {
+    const parser = parseAsColumnPinningState;
+    it('parses empty string as no pinned columns', () => {
+        expect(parser.parse('')).toEqual({ left: [], right: [] });
+    });
+    it('parses comma-separated columns as left-pinned', () => {
+        expect(parser.parse('a,b')).toEqual({ left: ['a', 'b'], right: [] });
+        expect(parser.parse('c')).toEqual({ left: ['c'], right: [] });
+    });
+    it('serializes left-pinned columns as comma-separated string', () => {
+        expect(parser.serialize({ left: ['a', 'b'], right: [] })).toBe('a,b');
+        expect(parser.serialize({ left: [], right: [] })).toBe('');
+    });
+    it('eq returns true for equal pinning', () => {
+        expect(parser.eq({ left: ['a', 'b'], right: [] }, { left: ['a', 'b'], right: [] })).toBe(true);
+    });
+    it('eq returns false for different pinning', () => {
+        expect(parser.eq({ left: ['a', 'b'], right: [] }, { left: ['b', 'a'], right: [] })).toBe(false);
+        expect(parser.eq({ left: ['a'], right: [] }, { left: ['a', 'b'], right: [] })).toBe(false);
+    });
+});
+describe('parseAsNumericFilter', () => {
+    describe('parse', () => {
+        it('parses gte format', () => {
+            expect(parseAsNumericFilter.parse('gte_5')).toEqual({ filterValue: '>=5', emptyOnly: false });
+        });
+        it('parses lte format', () => {
+            expect(parseAsNumericFilter.parse('lte_10')).toEqual({
+                filterValue: '<=10',
+                emptyOnly: false,
+            });
+        });
+        it('parses gt format', () => {
+            expect(parseAsNumericFilter.parse('gt_3')).toEqual({ filterValue: '>3', emptyOnly: false });
+        });
+        it('parses lt format', () => {
+            expect(parseAsNumericFilter.parse('lt_7')).toEqual({ filterValue: '<7', emptyOnly: false });
+        });
+        it('parses eq format', () => {
+            expect(parseAsNumericFilter.parse('eq_5')).toEqual({ filterValue: '=5', emptyOnly: false });
+        });
+        it('parses empty keyword', () => {
+            expect(parseAsNumericFilter.parse('empty')).toEqual({ filterValue: '', emptyOnly: true });
+        });
+        it('returns default for invalid format', () => {
+            expect(parseAsNumericFilter.parse('invalid')).toEqual({ filterValue: '', emptyOnly: false });
+        });
+        it('returns default for empty string', () => {
+            expect(parseAsNumericFilter.parse('')).toEqual({ filterValue: '', emptyOnly: false });
+        });
+        it('returns default for undefined', () => {
+            expect(parseAsNumericFilter.parse(undefined)).toEqual({
+                filterValue: '',
+                emptyOnly: false,
+            });
+        });
+        it('parses decimal values', () => {
+            expect(parseAsNumericFilter.parse('gte_3.14')).toEqual({
+                filterValue: '>=3.14',
+                emptyOnly: false,
+            });
+        });
+        it('parses negative values', () => {
+            expect(parseAsNumericFilter.parse('lt_-5')).toEqual({ filterValue: '<-5', emptyOnly: false });
+        });
+    });
+    describe('serialize', () => {
+        it('serializes >= format', () => {
+            expect(parseAsNumericFilter.serialize({ filterValue: '>=5', emptyOnly: false })).toBe('gte_5');
+        });
+        it('serializes <= format', () => {
+            expect(parseAsNumericFilter.serialize({ filterValue: '<=10', emptyOnly: false })).toBe('lte_10');
+        });
+        it('serializes > format', () => {
+            expect(parseAsNumericFilter.serialize({ filterValue: '>3', emptyOnly: false })).toBe('gt_3');
+        });
+        it('serializes < format', () => {
+            expect(parseAsNumericFilter.serialize({ filterValue: '<7', emptyOnly: false })).toBe('lt_7');
+        });
+        it('serializes = format', () => {
+            expect(parseAsNumericFilter.serialize({ filterValue: '=5', emptyOnly: false })).toBe('eq_5');
+        });
+        it('serializes emptyOnly as empty', () => {
+            expect(parseAsNumericFilter.serialize({ filterValue: '', emptyOnly: true })).toBe('empty');
+        });
+        it('serializes empty filterValue as empty', () => {
+            expect(parseAsNumericFilter.serialize({ filterValue: '', emptyOnly: false })).toBe('empty');
+        });
+        it('returns null for invalid filterValue', () => {
+            expect(parseAsNumericFilter.serialize({ filterValue: 'invalid', emptyOnly: false })).toBe(null);
+        });
+    });
+    describe('eq', () => {
+        it('returns true for equal values', () => {
+            expect(parseAsNumericFilter.eq({ filterValue: '>=5', emptyOnly: false }, { filterValue: '>=5', emptyOnly: false })).toBe(true);
+        });
+        it('returns false for different filterValue', () => {
+            expect(parseAsNumericFilter.eq({ filterValue: '>=5', emptyOnly: false }, { filterValue: '>=10', emptyOnly: false })).toBe(false);
+        });
+        it('returns false for different emptyOnly', () => {
+            expect(parseAsNumericFilter.eq({ filterValue: '', emptyOnly: true }, { filterValue: '', emptyOnly: false })).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=nuqs.test.js.map

package/dist/components/nuqs.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nuqs.test.js","sourceRoot":"","sources":["../../src/components/nuqs.test.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SortingState } from '@tanstack/table-core';\nimport { describe, expect, it } from 'vitest';\n\nimport {\n  parseAsColumnPinningState,\n  parseAsColumnVisibilityStateWithColumns,\n  parseAsNumericFilter,\n  parseAsSortingState,\n} from './nuqs.js';\n\ndescribe('parseAsSortingState', () => {\n  describe('parse', () => {\n    it('parses valid asc', () => {\n      expect(parseAsSortingState.parse('col:asc')).toEqual([{ id: 'col', desc: false }]);\n    });\n    it('parses valid desc', () => {\n      expect(parseAsSortingState.parse('col:desc')).toEqual([{ id: 'col', desc: true }]);\n    });\n    it('parses multiple columns', () => {\n      expect(parseAsSortingState.parse('col1:asc,col2:desc')).toEqual([\n        { id: 'col1', desc: false },\n        { id: 'col2', desc: true },\n      ]);\n    });\n    it('ignores invalid columns in multi-column', () => {\n      expect(parseAsSortingState.parse('col1:asc,invalid,foo:bar,col2:desc')).toEqual([\n        { id: 'col1', desc: false },\n        { id: 'col2', desc: true },\n      ]);\n    });\n    it('returns [] for empty string', () => {\n      expect(parseAsSortingState.parse('')).toEqual([]);\n    });\n    it('returns [] for missing id', () => {\n      expect(parseAsSortingState.parse(':asc')).toEqual([]);\n    });\n    it('returns [] for invalid direction', () => {\n      expect(parseAsSortingState.parse('col:foo')).toEqual([]);\n    });\n    it('returns [] for undefined', () => {\n      expect(parseAsSortingState.parse(undefined as any)).toEqual([]);\n    });\n  });\n\n  describe('serialize', () => {\n    it('serializes asc', () => {\n      const state: SortingState = [{ id: 'col', desc: false }];\n      expect(parseAsSortingState.serialize(state)).toBe('col:asc');\n    });\n    it('serializes desc', () => {\n      const state: SortingState = [{ id: 'col', desc: true }];\n      expect(parseAsSortingState.serialize(state)).toBe('col:desc');\n    });\n    it('serializes multiple columns', () => {\n      const state: SortingState = [\n        { id: 'col1', desc: false },\n        { id: 'col2', desc: true },\n      ];\n      expect(parseAsSortingState.serialize(state)).toBe('col1:asc,col2:desc');\n    });\n    it('serializes empty array as null', () => {\n      expect(parseAsSortingState.serialize([])).toBe(null);\n    });\n    it('serializes missing id as empty string', () => {\n      expect(parseAsSortingState.serialize([{ id: '', desc: false }])).toBe('');\n    });\n  });\n\n  describe('eq', () => {\n    it('returns true for equal states', () => {\n      const a: SortingState = [{ id: 'col', desc: false }];\n      const b: SortingState = [{ id: 'col', desc: false }];\n      expect(parseAsSortingState.eq(a, b)).toBe(true);\n    });\n    it('returns true for equal multi-column states', () => {\n      const a: SortingState = [\n        { id: 'col1', desc: false },\n        { id: 'col2', desc: true },\n      ];\n      const b: SortingState = [\n        { id: 'col1', desc: false },\n        { id: 'col2', desc: true },\n      ];\n      expect(parseAsSortingState.eq(a, b)).toBe(true);\n    });\n    // The order of the sort columns matters for multi-column sorting.\n    it('returns false for different order in multi-column', () => {\n      const a: SortingState = [\n        { id: 'col1', desc: false },\n        { id: 'col2', desc: true },\n      ];\n      const b: SortingState = [\n        { id: 'col2', desc: true },\n        { id: 'col1', desc: false },\n      ];\n      expect(parseAsSortingState.eq(a, b)).toBe(false);\n    });\n    it('returns false for different ids', () => {\n      const a: SortingState = [{ id: 'col1', desc: false }];\n      const b: SortingState = [{ id: 'col2', desc: false }];\n      expect(parseAsSortingState.eq(a, b)).toBe(false);\n    });\n    it('returns false for different desc', () => {\n      const a: SortingState = [{ id: 'col', desc: false }];\n      const b: SortingState = [{ id: 'col', desc: true }];\n      expect(parseAsSortingState.eq(a, b)).toBe(false);\n    });\n    it('returns true for both empty', () => {\n      expect(parseAsSortingState.eq([], [])).toBe(true);\n    });\n    it('returns false for one empty, one not', () => {\n      expect(parseAsSortingState.eq([], [{ id: 'col', desc: false }])).toBe(false);\n    });\n  });\n});\n\ndescribe('parseAsColumnVisibilityStateWithColumns', () => {\n  const allColumns = ['a', 'b', 'c'];\n  const parser = parseAsColumnVisibilityStateWithColumns(allColumns);\n\n  it('parses empty string as all columns visible', () => {\n    expect(parser.parse('')).toEqual({ a: true, b: true, c: true });\n  });\n\n  it('parses comma-separated columns as only those visible', () => {\n    expect(parser.parse('a,b')).toEqual({ a: true, b: true, c: false });\n    expect(parser.parse('b')).toEqual({ a: false, b: true, c: false });\n  });\n\n  it('serializes partial visibility as comma-separated columns', () => {\n    expect(parser.serialize({ a: true, b: false, c: true })).toBe('a,c');\n    expect(parser.serialize({ a: false, b: true, c: false })).toBe('b');\n  });\n\n  it('eq returns true for equal visibility', () => {\n    expect(parser.eq({ a: true, b: false, c: true }, { a: true, b: false, c: true })).toBe(true);\n  });\n\n  it('eq returns false for different visibility', () => {\n    expect(parser.eq({ a: true, b: false, c: true }, { a: false, b: false, c: true })).toBe(false);\n  });\n});\n\ndescribe('parseAsColumnPinningState', () => {\n  const parser = parseAsColumnPinningState;\n\n  it('parses empty string as no pinned columns', () => {\n    expect(parser.parse('')).toEqual({ left: [], right: [] });\n  });\n\n  it('parses comma-separated columns as left-pinned', () => {\n    expect(parser.parse('a,b')).toEqual({ left: ['a', 'b'], right: [] });\n    expect(parser.parse('c')).toEqual({ left: ['c'], right: [] });\n  });\n\n  it('serializes left-pinned columns as comma-separated string', () => {\n    expect(parser.serialize({ left: ['a', 'b'], right: [] })).toBe('a,b');\n    expect(parser.serialize({ left: [], right: [] })).toBe('');\n  });\n\n  it('eq returns true for equal pinning', () => {\n    expect(parser.eq({ left: ['a', 'b'], right: [] }, { left: ['a', 'b'], right: [] })).toBe(true);\n  });\n\n  it('eq returns false for different pinning', () => {\n    expect(parser.eq({ left: ['a', 'b'], right: [] }, { left: ['b', 'a'], right: [] })).toBe(false);\n    expect(parser.eq({ left: ['a'], right: [] }, { left: ['a', 'b'], right: [] })).toBe(false);\n  });\n});\n\ndescribe('parseAsNumericFilter', () => {\n  describe('parse', () => {\n    it('parses gte format', () => {\n      expect(parseAsNumericFilter.parse('gte_5')).toEqual({ filterValue: '>=5', emptyOnly: false });\n    });\n    it('parses lte format', () => {\n      expect(parseAsNumericFilter.parse('lte_10')).toEqual({\n        filterValue: '<=10',\n        emptyOnly: false,\n      });\n    });\n    it('parses gt format', () => {\n      expect(parseAsNumericFilter.parse('gt_3')).toEqual({ filterValue: '>3', emptyOnly: false });\n    });\n    it('parses lt format', () => {\n      expect(parseAsNumericFilter.parse('lt_7')).toEqual({ filterValue: '<7', emptyOnly: false });\n    });\n    it('parses eq format', () => {\n      expect(parseAsNumericFilter.parse('eq_5')).toEqual({ filterValue: '=5', emptyOnly: false });\n    });\n    it('parses empty keyword', () => {\n      expect(parseAsNumericFilter.parse('empty')).toEqual({ filterValue: '', emptyOnly: true });\n    });\n    it('returns default for invalid format', () => {\n      expect(parseAsNumericFilter.parse('invalid')).toEqual({ filterValue: '', emptyOnly: false });\n    });\n    it('returns default for empty string', () => {\n      expect(parseAsNumericFilter.parse('')).toEqual({ filterValue: '', emptyOnly: false });\n    });\n    it('returns default for undefined', () => {\n      expect(parseAsNumericFilter.parse(undefined as any)).toEqual({\n        filterValue: '',\n        emptyOnly: false,\n      });\n    });\n    it('parses decimal values', () => {\n      expect(parseAsNumericFilter.parse('gte_3.14')).toEqual({\n        filterValue: '>=3.14',\n        emptyOnly: false,\n      });\n    });\n    it('parses negative values', () => {\n      expect(parseAsNumericFilter.parse('lt_-5')).toEqual({ filterValue: '<-5', emptyOnly: false });\n    });\n  });\n\n  describe('serialize', () => {\n    it('serializes >= format', () => {\n      expect(parseAsNumericFilter.serialize({ filterValue: '>=5', emptyOnly: false })).toBe(\n        'gte_5',\n      );\n    });\n    it('serializes <= format', () => {\n      expect(parseAsNumericFilter.serialize({ filterValue: '<=10', emptyOnly: false })).toBe(\n        'lte_10',\n      );\n    });\n    it('serializes > format', () => {\n      expect(parseAsNumericFilter.serialize({ filterValue: '>3', emptyOnly: false })).toBe('gt_3');\n    });\n    it('serializes < format', () => {\n      expect(parseAsNumericFilter.serialize({ filterValue: '<7', emptyOnly: false })).toBe('lt_7');\n    });\n    it('serializes = format', () => {\n      expect(parseAsNumericFilter.serialize({ filterValue: '=5', emptyOnly: false })).toBe('eq_5');\n    });\n    it('serializes emptyOnly as empty', () => {\n      expect(parseAsNumericFilter.serialize({ filterValue: '', emptyOnly: true })).toBe('empty');\n    });\n    it('serializes empty filterValue as empty', () => {\n      expect(parseAsNumericFilter.serialize({ filterValue: '', emptyOnly: false })).toBe('empty');\n    });\n    it('returns null for invalid filterValue', () => {\n      expect(parseAsNumericFilter.serialize({ filterValue: 'invalid', emptyOnly: false })).toBe(\n        null,\n      );\n    });\n  });\n\n  describe('eq', () => {\n    it('returns true for equal values', () => {\n      expect(\n        parseAsNumericFilter.eq(\n          { filterValue: '>=5', emptyOnly: false },\n          { filterValue: '>=5', emptyOnly: false },\n        ),\n      ).toBe(true);\n    });\n    it('returns false for different filterValue', () => {\n      expect(\n        parseAsNumericFilter.eq(\n          { filterValue: '>=5', emptyOnly: false },\n          { filterValue: '>=10', emptyOnly: false },\n        ),\n      ).toBe(false);\n    });\n    it('returns false for different emptyOnly', () => {\n      expect(\n        parseAsNumericFilter.eq(\n          { filterValue: '', emptyOnly: true },\n          { filterValue: '', emptyOnly: false },\n        ),\n      ).toBe(false);\n    });\n  });\n});\n"]}

package/dist/index.d.ts

@@ -6,5 +6,8 @@ export { CategoricalColumnFilter } from './components/CategoricalColumnFilter.js
 export { MultiSelectColumnFilter } from './components/MultiSelectColumnFilter.js';
 export { NumericInputColumnFilter, parseNumericFilter, numericColumnFilterFn, type NumericColumnFilterValue, } from './components/NumericInputColumnFilter.js';
 export { useShiftClickCheckbox } from './components/useShiftClickCheckbox.js';
+export { useAutoSizeColumns } from './components/useAutoSizeColumns.js';
 export { OverlayTrigger, type OverlayTriggerProps } from './components/OverlayTrigger.js';
+export { PresetFilterDropdown } from './components/PresetFilterDropdown.js';
+export { NuqsAdapter, parseAsSortingState, parseAsColumnVisibilityStateWithColumns, parseAsColumnPinningState, parseAsNumericFilter, } from './components/nuqs.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAC1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,wBAAwB,GAC9B,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAC1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,wBAAwB,GAC9B,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,uCAAuC,EACvC,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -7,5 +7,8 @@ export { CategoricalColumnFilter } from './components/CategoricalColumnFilter.js
 export { MultiSelectColumnFilter } from './components/MultiSelectColumnFilter.js';
 export { NumericInputColumnFilter, parseNumericFilter, numericColumnFilterFn, } from './components/NumericInputColumnFilter.js';
 export { useShiftClickCheckbox } from './components/useShiftClickCheckbox.js';
+export { useAutoSizeColumns } from './components/useAutoSizeColumns.js';
 export { OverlayTrigger } from './components/OverlayTrigger.js';
+export { PresetFilterDropdown } from './components/PresetFilterDropdown.js';
+export { NuqsAdapter, parseAsSortingState, parseAsColumnVisibilityStateWithColumns, parseAsColumnPinningState, parseAsNumericFilter, } from './components/nuqs.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAC1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,GAEtB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,cAAc,EAA4B,MAAM,gCAAgC,CAAC","sourcesContent":["// Augment @tanstack/react-table types\nimport './react-table.js';\n\nexport {\n  TanstackTable,\n  TanstackTableCard,\n  TanstackTableEmptyState,\n} from './components/TanstackTable.js';\nexport { ColumnManager } from './components/ColumnManager.js';\nexport { TanstackTableDownloadButton } from './components/TanstackTableDownloadButton.js';\nexport { CategoricalColumnFilter } from './components/CategoricalColumnFilter.js';\nexport { MultiSelectColumnFilter } from './components/MultiSelectColumnFilter.js';\nexport {\n  NumericInputColumnFilter,\n  parseNumericFilter,\n  numericColumnFilterFn,\n  type NumericColumnFilterValue,\n} from './components/NumericInputColumnFilter.js';\nexport { useShiftClickCheckbox } from './components/useShiftClickCheckbox.js';\nexport { OverlayTrigger, type OverlayTriggerProps } from './components/OverlayTrigger.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAC1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,GAEtB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,cAAc,EAA4B,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,uCAAuC,EACvC,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC","sourcesContent":["// Augment @tanstack/react-table types\nimport './react-table.js';\n\nexport {\n  TanstackTable,\n  TanstackTableCard,\n  TanstackTableEmptyState,\n} from './components/TanstackTable.js';\nexport { ColumnManager } from './components/ColumnManager.js';\nexport { TanstackTableDownloadButton } from './components/TanstackTableDownloadButton.js';\nexport { CategoricalColumnFilter } from './components/CategoricalColumnFilter.js';\nexport { MultiSelectColumnFilter } from './components/MultiSelectColumnFilter.js';\nexport {\n  NumericInputColumnFilter,\n  parseNumericFilter,\n  numericColumnFilterFn,\n  type NumericColumnFilterValue,\n} from './components/NumericInputColumnFilter.js';\nexport { useShiftClickCheckbox } from './components/useShiftClickCheckbox.js';\nexport { useAutoSizeColumns } from './components/useAutoSizeColumns.js';\nexport { OverlayTrigger, type OverlayTriggerProps } from './components/OverlayTrigger.js';\nexport { PresetFilterDropdown } from './components/PresetFilterDropdown.js';\nexport {\n  NuqsAdapter,\n  parseAsSortingState,\n  parseAsColumnVisibilityStateWithColumns,\n  parseAsColumnPinningState,\n  parseAsNumericFilter,\n} from './components/nuqs.js';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prairielearn/ui",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -23,13 +23,14 @@
     "@tanstack/react-virtual": "^3.13.12",
     "@tanstack/table-core": "^8.21.3",
     "clsx": "^2.1.1",
+    "nuqs": "^2.8.2",
     "react-bootstrap": "3.0.0-beta.5"
   },
   "devDependencies": {
     "@prairielearn/tsconfig": "^0.0.0",
-    "@types/node": "^22.19.0",
+    "@types/node": "^22.19.1",
     "typescript": "^5.9.3",
     "typescript-cp": "^0.1.9",
-    "vitest": "^4.0.7"
+    "vitest": "^4.0.14"
   }
 }

package/src/components/CategoricalColumnFilter.tsx

@@ -32,7 +32,7 @@ export function CategoricalColumnFilter<TData, TValue>({
   renderValueLabel = defaultRenderValueLabel,
 }: {
   column: Column<TData, TValue>;
-  allColumnValues: TValue[];
+  allColumnValues: TValue[] | readonly TValue[];
   renderValueLabel?: (props: { value: TValue; isSelected: boolean }) => JSX.Element;
 }) {
   const [mode, setMode] = useState<'include' | 'exclude'>('include');

package/src/components/PresetFilterDropdown.tsx

@@ -0,0 +1,155 @@
+import type { ColumnFiltersState, Table } from '@tanstack/react-table';
+import { useMemo } from 'preact/compat';
+import { ButtonGroup, Dropdown } from 'react-bootstrap';
+
+/**
+ * Compares two filter values for deep equality using JSON serialization.
+ */
+function filtersEqual(a: unknown, b: unknown): boolean {
+  return JSON.stringify(a) === JSON.stringify(b);
+}
+
+/**
+ * Extracts all unique column IDs referenced across all preset options.
+ */
+function getRelevantColumnIds(options: Record<string, ColumnFiltersState>): Set<string> {
+  const columnIds = new Set<string>();
+  for (const filters of Object.values(options)) {
+    for (const filter of filters) {
+      columnIds.add(filter.id);
+    }
+  }
+  return columnIds;
+}
+
+/**
+ * Gets the current filter values for the relevant columns from the table.
+ */
+function getRelevantFilters<TData>(
+  table: Table<TData>,
+  relevantColumnIds: Set<string>,
+): ColumnFiltersState {
+  const allFilters = table.getState().columnFilters;
+  return allFilters.filter((f) => relevantColumnIds.has(f.id));
+}
+
+/**
+ * Checks if the current filters match a preset's filters.
+ * Both must have the same column IDs with equal values.
+ */
+function filtersMatchPreset(current: ColumnFiltersState, preset: ColumnFiltersState): boolean {
+  // If lengths differ, they don't match
+  if (current.length !== preset.length) return false;
+
+  // For empty presets, current must also be empty
+  if (preset.length === 0) return current.length === 0;
+
+  // Check that every preset filter exists in current with the same value
+  for (const presetFilter of preset) {
+    const currentFilter = current.find((f) => f.id === presetFilter.id);
+    if (!currentFilter || !filtersEqual(currentFilter.value, presetFilter.value)) {
+      return false;
+    }
+  }
+
+  return true;
+}
+
+/**
+ * A dropdown component that allows users to select from preset filter configurations.
+ * The selected state is derived from the table's current column filters.
+ * If no preset matches, a "Custom" option is shown as selected.
+ *
+ * Currently, this component expects that the filters states are arrays.
+ */
+export function PresetFilterDropdown<OptionName extends string, TData>({
+  table,
+  options,
+  label = 'Filter',
+  onSelect,
+}: {
+  /** The TanStack Table instance */
+  table: Table<TData>;
+  /** Mapping of option names to their filter configurations */
+  options: Record<OptionName, ColumnFiltersState>;
+  /** Label prefix for the dropdown button (e.g., "Filter") */
+  label?: string;
+  /** Callback when an option is selected, useful for side effects like column visibility */
+  onSelect?: (optionName: OptionName) => void;
+}) {
+  const relevantColumnIds = getRelevantColumnIds(options);
+
+  const currentRelevantFilters = useMemo(
+    () => getRelevantFilters(table, relevantColumnIds),
+    [table, relevantColumnIds],
+  );
+
+  // Find which option matches the current filters
+  const selectedOption = useMemo<OptionName | null>(() => {
+    for (const [optionName, presetFilters] of Object.entries(options)) {
+      if (filtersMatchPreset(currentRelevantFilters, presetFilters as ColumnFiltersState)) {
+        return optionName as OptionName;
+      }
+    }
+    return null; // No preset matches - custom filter state
+  }, [options, currentRelevantFilters]);
+
+  const handleOptionClick = (optionName: OptionName) => {
+    const presetFilters = options[optionName];
+
+    // Get current filters, removing any that are in our relevant columns
+    const currentFilters = table.getState().columnFilters;
+    const preservedFilters = currentFilters.filter((f) => !relevantColumnIds.has(f.id));
+
+    // For columns not in the preset, explicitly set empty filter to clear them
+    // This ensures the table's onColumnFiltersChange handler can sync the cleared state
+    const clearedFilters = Array.from(relevantColumnIds)
+      .filter((colId) => !presetFilters.some((f) => f.id === colId))
+      .map((colId) => ({
+        id: colId,
+        // TODO: This expects that we are only clearing filters whose state is an array.
+        value: [],
+      }));
+
+    // Combine preserved filters with the new preset filters and cleared filters
+    const newFilters = [...preservedFilters, ...presetFilters, ...clearedFilters];
+    table.setColumnFilters(newFilters);
+
+    onSelect?.(optionName);
+  };
+
+  const displayLabel = selectedOption ?? 'Custom';
+
+  return (
+    <Dropdown as={ButtonGroup}>
+      <Dropdown.Toggle variant="tanstack-table">
+        <i class="bi bi-funnel me-2" aria-hidden="true" />
+        {label}: {displayLabel}
+      </Dropdown.Toggle>
+      <Dropdown.Menu>
+        {Object.keys(options).map((optionName) => {
+          const isSelected = selectedOption === optionName;
+          return (
+            <Dropdown.Item
+              key={optionName}
+              as="button"
+              type="button"
+              active={isSelected}
+              onClick={() => handleOptionClick(optionName as OptionName)}
+            >
+              <i class={`bi ${isSelected ? 'bi-check-circle-fill' : 'bi-circle'} me-2`} />
+              {optionName}
+            </Dropdown.Item>
+          );
+        })}
+        {/* Show Custom option only when no preset matches */}
+        {selectedOption === null && (
+          <Dropdown.Item as="button" type="button" active disabled>
+            <i class="bi bi-check-circle-fill me-2" />
+            Custom
+          </Dropdown.Item>
+        )}
+      </Dropdown.Menu>
+    </Dropdown>
+  );
+}