@pienter/ui 0.16.0 → 0.17.0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 ## Unreleased
 
+## 0.17.0 - 2026-09-15
+
+### Added
+
+- `splitFilterValues` and `joinFilterValues` in `@pienter/ui/utils/cms`, for
+  the multi-value filter convention the backend contract now documents: a
+  filter such as `filter[type]=1,2` carries its values as one comma-separated
+  string of identifiers or enum tokens, and a numeric range is two ordinary
+  allowlisted filters, `<name>_min` and `<name>_max`. Both stay one string per
+  `filter[name]`, so `decodeListQuery`, `encodeListQuery`, the URL sync and
+  the allowlist are unchanged. `splitFilterValues('')` is `[]` and
+  `joinFilterValues([])` is `undefined`, so clearing deletes the parameter
+  rather than sending an empty string. See ADR 0009.
+
 ## 0.16.0 - 2026-09-15
 
 ### Breaking

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pienter/ui",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Shared Pienter UI components, styles, icons, and browser utilities.",
   "type": "module",
   "license": "MIT",

package/utils/cms/index.ts

@@ -205,6 +205,19 @@ export function encodeListQuery(query: ListQuery): URLSearchParams {
     return params;
 }
 
+/** Values of a multi-value filter, from its comma-separated wire string. */
+export function splitFilterValues(value: string | undefined): string[] {
+    return value ? value.split(',').filter(Boolean) : [];
+}
+
+/** The wire string of a multi-value filter; `undefined` clears the parameter. */
+export function joinFilterValues(
+    values: readonly string[],
+): string | undefined {
+    const joined = values.filter(Boolean).join(',');
+    return joined || undefined;
+}
+
 export function cloneRecord<T>(record: T): T {
     return JSON.parse(JSON.stringify(record)) as T;
 }