@fusion.dev/helix-core 0.142.1 → 0.144.0

package/dist/utils/written-list/written-list.d.ts

@@ -1,3 +1,12 @@
+/**
+ * What a list property may hold: what an attribute writes, or an array a
+ * framework assigned to the property.
+ *
+ * **An array as well, because React 19 sets the property.**
+ * `values={[1240, 1318]}` arrives as an array, and splitting it as a string
+ * threw inside the render and left the old drawing on the screen.
+ */
+export type WrittenList = string | readonly (number | string)[] | null | undefined;
 /**
  * A list a consumer wrote into an attribute, split the way they write one.
  *
@@ -20,7 +29,7 @@
  * `for` take whitespace and only whitespace, and accepting a comma there would
  * resolve an id nobody can write.
  */
-export declare const writtenList: (source: string | undefined) => string[];
+export declare const writtenList: (source: WrittenList) => string[];
 /**
  * The same list read as numbers, with everything that is not one dropped.
  *
@@ -33,4 +42,22 @@ export declare const writtenList: (source: string | undefined) => string[];
  * answer, because a number that makes sense here is a bound, a reading and a
  * playback rate, and only the caller knows that a rate of zero is not a rate.
  */
-export declare const writtenNumbers: (source: string | undefined) => number[];
+export declare const writtenNumbers: (source: WrittenList) => number[];
+/**
+ * A value list: the entries between commas, trimmed, with the empty ones
+ * dropped.
+ *
+ * **Commas only**, which is the value rule `writtenList` describes beside it: a
+ * value may hold a space, and `value="New York, Paris"` is two cities. Select,
+ * Listbox, Checkbox Group, Tag Group, Toggle Group, Date Picker, Time Picker
+ * and Legend's hidden series all read their lists this way.
+ */
+export declare const commaList: (value: string) => string[];
+/**
+ * A list with `value` taken out where it is in it, or added at the end where
+ * it is not.
+ *
+ * With `order`, the result is put in that order and holds only what `order`
+ * holds, so a set of pressed items reads the same whichever was pressed first.
+ */
+export declare const toggleValue: (list: readonly string[], value: string, order?: readonly string[]) => string[];

package/dist/utils/written-list/written-list.js

@@ -1,4 +1,14 @@
-export const writtenList = (source) => (source ?? '').split(/[\s,]+/).filter((one) => one !== '');
+export const writtenList = (source) => (Array.isArray(source) ? source.join(' ') : String(source ?? ''))
+    .split(/[\s,]+/)
+    .filter((one) => one !== '');
 export const writtenNumbers = (source) => writtenList(source)
     .map(Number)
     .filter((one) => Number.isFinite(one));
+export const commaList = (value) => value
+    .split(',')
+    .map((one) => one.trim())
+    .filter((one) => one !== '');
+export const toggleValue = (list, value, order) => {
+    const next = list.includes(value) ? list.filter((one) => one !== value) : [...list, value];
+    return order ? order.filter((one) => next.includes(one)) : next;
+};

package/dist/version.d.ts

@@ -6,4 +6,4 @@
  * release, so the two never disagree; a spec beside this holds them to it.
  * Nothing else in the running code knows which release it is.
  */
-export declare const VERSION = "0.142.1";
+export declare const VERSION = "0.144.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.142.1';
+export const VERSION = '0.144.0';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-core",
   "description": "Helix element primitives: base classes, mixins, decorators, utilities.",
-  "version": "0.142.1",
+  "version": "0.144.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -34,11 +34,11 @@
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
     "@floating-ui/dom": "^1.8.0",
-    "@fusion.dev/helix-icons": "0.142.1"
+    "@fusion.dev/helix-icons": "0.144.0"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.142.1",
-    "@fusion.dev/helix-testing": "0.142.1",
+    "@fusion.dev/helix-cem": "0.144.0",
+    "@fusion.dev/helix-testing": "0.144.0",
     "@lit-labs/ssr": "^4.1.0",
     "lit": "^3.2.1"
   },