@lotics/ui 47.12.1 → 47.12.2

package/docs/catalog.md

@@ -1815,7 +1815,10 @@ source (`src/<module>.tsx`/`.ts`) is the API reference.
   control cannot do itself — see [composition.md](./composition.md) §register.
 - **`column_filter`** — `ColumnFilter` + `columnFilterToConditions` +
   `isColumnFilterActive` + `columnFilterSummary`: the typed per-column filter pill; for a
-  register filtering on several columns.
+  register filtering on several columns. `FilterableColumn<C>` / `FilterConditionNode<C>` carry
+  the column key's type — pass the app SDK's `ColumnKeyOf<alias>` so the nodes this helper builds
+  stay assignable to a `useQuery` filter typed against its query; the default `C = string` is
+  for an alias whose projection codegen could not read.
 - **`filter_band`** — `FilterBand`: the toolbar ROW above a list — search, the `FilterChip`s,
   and the screen's primary action. **On a small screen the chips collapse into one `Filters (n)`
   button** that opens a sheet where the same chips render as full-width disclosure rows, one

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/ui",
-  "version": "47.12.1",
+  "version": "47.12.2",
   "type": "module",
   "exports": {
     "./accordion": "./src/accordion.tsx",

package/src/column_filter.tsx

@@ -7,9 +7,17 @@ import { FilterChip } from "./filter_chip";
 import type { PickerOption } from "./picker";
 import { useLoticsLocale } from "./locale";
 
-/** A column the picker can filter on. `type` selects the control + operators. */
-export interface FilterableColumn {
-  key: string;
+/**
+ * A column the picker can filter on. `type` selects the control + operators.
+ *
+ * `C` is the key's type — `string` by default, or the literal union of a
+ * query's projected outputs (`AppQueryColumns[alias]` from the app SDK) when
+ * the caller has one. It exists so a condition built here stays assignable to
+ * a `useQuery` filter typed against its query; with a plain `string` key the
+ * SDK's typed filter would refuse every node this helper produced.
+ */
+export interface FilterableColumn<C extends string = string> {
+  key: C;
   label: string;
   type: "text" | "number" | "select";
   /** Options for `type: "select"`. */
@@ -22,10 +30,11 @@ export type ColumnFilterValue =
   | { kind: "number"; min: number | null; max: number | null }
   | { kind: "select"; selected: string[] };
 
-/** A `TableRecordFilters` condition node (the shape the app query RPC accepts). */
-export interface FilterConditionNode {
+/** A `TableRecordFilters` condition node (the shape the app query RPC accepts).
+ *  `C` follows the column it was built from — see `FilterableColumn`. */
+export interface FilterConditionNode<C extends string = string> {
   node_type: "condition";
-  field_key: string;
+  field_key: C;
   type: "text" | "number" | "select";
   operator: string;
   value: unknown;
@@ -36,10 +45,10 @@ export interface FilterConditionNode {
  * column filter must become a `TableRecordFilters` predicate). Returns 0+ nodes
  * — a number range yields two, an empty filter yields none.
  */
-export function columnFilterToConditions(
-  column: FilterableColumn,
+export function columnFilterToConditions<C extends string = string>(
+  column: FilterableColumn<C>,
   value: ColumnFilterValue | undefined,
-): FilterConditionNode[] {
+): FilterConditionNode<C>[] {
   if (!value) return [];
   if (value.kind === "text") {
     const q = value.query.trim();
@@ -48,7 +57,7 @@ export function columnFilterToConditions(
       : [];
   }
   if (value.kind === "number") {
-    const nodes: FilterConditionNode[] = [];
+    const nodes: FilterConditionNode<C>[] = [];
     if (value.min != null) {
       nodes.push({ node_type: "condition", field_key: column.key, type: "number", operator: "greater_than_or_equal_to", value: value.min });
     }