@genesislcap/foundation-utils 14.404.0 → 14.406.0

package/dist/custom-elements.json

@@ -7,6 +7,14 @@
       "path": "src/index.ts",
       "declarations": [],
       "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./converters"
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -201,6 +209,47 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/converters/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./string-array-converter"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/converters/string-array-converter.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "stringArrayConverter",
+          "type": {
+            "text": "ValueConverter"
+          },
+          "default": "{\n  fromView(v: string): string | string[] | undefined {\n    if (!v?.trim()) return undefined;\n    return v.includes(',') ? v.split(',').map((s) => s.trim()) : v.trim();\n  },\n  toView(v: string | string[] | undefined): string {\n    if (typeof v === 'string') return v;\n    if (Array.isArray(v)) return v.join(',');\n    return '';\n  },\n}",
+          "description": "A @microsoft/fast-element#ValueConverter that converts between comma-separated string attributes\nand `string | string[]` properties.",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "stringArrayConverter",
+          "declaration": {
+            "name": "stringArrayConverter",
+            "module": "src/converters/string-array-converter.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/data/inMemoryDatabase.ts",
@@ -399,59 +448,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/decorators/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./renderOnChange"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/decorators/renderOnChange.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "renderOnChange",
-          "parameters": [
-            {
-              "name": "target",
-              "type": {
-                "text": "FASTElement & { render(): void }"
-              },
-              "description": "The target to define the property change handler on."
-            },
-            {
-              "name": "name",
-              "type": {
-                "text": "string"
-              },
-              "description": "The property name."
-            }
-          ],
-          "description": "Defines a property changed handler that calls a render() method on the target as an internal observation enhancement.",
-          "privacy": "public"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "renderOnChange",
-          "declaration": {
-            "name": "renderOnChange",
-            "module": "src/decorators/renderOnChange.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/design-system/design-system.ts",
@@ -572,6 +568,59 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/decorators/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./renderOnChange"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/decorators/renderOnChange.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "renderOnChange",
+          "parameters": [
+            {
+              "name": "target",
+              "type": {
+                "text": "FASTElement & { render(): void }"
+              },
+              "description": "The target to define the property change handler on."
+            },
+            {
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "description": "The property name."
+            }
+          ],
+          "description": "Defines a property changed handler that calls a render() method on the target as an internal observation enhancement.",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "renderOnChange",
+          "declaration": {
+            "name": "renderOnChange",
+            "module": "src/decorators/renderOnChange.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/directives/index.ts",

package/dist/dts/converters/index.d.ts

@@ -0,0 +1,2 @@
+export * from './string-array-converter';
+//# sourceMappingURL=index.d.ts.map

package/dist/dts/converters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/converters/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC"}

package/dist/dts/converters/string-array-converter.d.ts

@@ -0,0 +1,13 @@
+import type { ValueConverter } from '@microsoft/fast-element';
+/**
+ * A {@link @microsoft/fast-element#ValueConverter} that converts between comma-separated string attributes
+ * and `string | string[]` properties.
+ *
+ * @remarks
+ * - fromView: "A,B,C" → ["A","B","C"], "A" → "A", "" → undefined
+ * - toView: ["A","B","C"] → "A,B,C", "A" → "A", undefined → ""
+ *
+ * @public
+ */
+export declare const stringArrayConverter: ValueConverter;
+//# sourceMappingURL=string-array-converter.d.ts.map

package/dist/dts/converters/string-array-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-array-converter.d.ts","sourceRoot":"","sources":["../../../src/converters/string-array-converter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,EAAE,cAUlC,CAAC"}

package/dist/dts/index.d.ts

@@ -1,3 +1,4 @@
+export * from './converters';
 export * from './data';
 export * from './decorators';
 export * from './design-system';

package/dist/dts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC"}

package/dist/esm/converters/index.js

@@ -0,0 +1 @@
+export * from './string-array-converter';

package/dist/esm/converters/string-array-converter.js

@@ -0,0 +1,24 @@
+/**
+ * A {@link @microsoft/fast-element#ValueConverter} that converts between comma-separated string attributes
+ * and `string | string[]` properties.
+ *
+ * @remarks
+ * - fromView: "A,B,C" → ["A","B","C"], "A" → "A", "" → undefined
+ * - toView: ["A","B","C"] → "A,B,C", "A" → "A", undefined → ""
+ *
+ * @public
+ */
+export const stringArrayConverter = {
+    fromView(v) {
+        if (!(v === null || v === void 0 ? void 0 : v.trim()))
+            return undefined;
+        return v.includes(',') ? v.split(',').map((s) => s.trim()) : v.trim();
+    },
+    toView(v) {
+        if (typeof v === 'string')
+            return v;
+        if (Array.isArray(v))
+            return v.join(',');
+        return '';
+    },
+};

package/dist/esm/index.js

@@ -1,3 +1,4 @@
+export * from './converters';
 export * from './data';
 export * from './decorators';
 export * from './design-system';

package/dist/foundation-utils.api.json

@@ -18938,6 +18938,30 @@
             "endIndex": 2
           }
         },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@genesislcap/foundation-utils!stringArrayConverter:var",
+          "docComment": "/**\n * A {@link @microsoft/fast-element#ValueConverter} that converts between comma-separated string attributes and `string | string[]` properties.\n *\n * @remarks\n *\n * - fromView: \"A,B,C\" → [\"A\",\"B\",\"C\"], \"A\" → \"A\", \"\" → undefined - toView: [\"A\",\"B\",\"C\"] → \"A,B,C\", \"A\" → \"A\", undefined → \"\"\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "stringArrayConverter: "
+            },
+            {
+              "kind": "Reference",
+              "text": "ValueConverter",
+              "canonicalReference": "@microsoft/fast-element!ValueConverter:interface"
+            }
+          ],
+          "fileUrlPath": "src/converters/string-array-converter.ts",
+          "isReadonly": true,
+          "releaseTag": "Public",
+          "name": "stringArrayConverter",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          }
+        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/foundation-utils!Subscribe:type",

package/dist/foundation-utils.d.ts

@@ -16,6 +16,7 @@ import { LogLevel } from '@genesislcap/foundation-logger';
 import { Observable } from 'rxjs';
 import { SyntheticViewTemplate } from '@microsoft/fast-element';
 import { Types } from '@genesislcap/expression-builder';
+import type { ValueConverter } from '@microsoft/fast-element';
 
 /**
  * @public
@@ -2349,6 +2350,18 @@ export declare let SSO_LIST_URL: string;
  */
 export declare let SSO_LOGIN_URL: string;
 
+/**
+ * A {@link @microsoft/fast-element#ValueConverter} that converts between comma-separated string attributes
+ * and `string | string[]` properties.
+ *
+ * @remarks
+ * - fromView: "A,B,C" → ["A","B","C"], "A" → "A", "" → undefined
+ * - toView: ["A","B","C"] → "A,B,C", "A" → "A", undefined → ""
+ *
+ * @public
+ */
+export declare const stringArrayConverter: ValueConverter;
+
 /**
  * Subscribes a listener function to receive events of a specific type.
  * @returns An unsubscribe function.

package/docs/api/foundation-utils.md

@@ -1339,6 +1339,17 @@ The sub-path used for WebSocket connections when API\_HOST is not set
 
 
 
+</td></tr>
+<tr><td>
+
+[stringArrayConverter](./foundation-utils.stringarrayconverter.md)
+
+
+</td><td>
+
+A  that converts between comma-separated string attributes and `string | string[]` properties.
+
+
 </td></tr>
 <tr><td>
 

package/docs/api/foundation-utils.stringarrayconverter.md

@@ -0,0 +1,18 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [stringArrayConverter](./foundation-utils.stringarrayconverter.md)
+
+## stringArrayConverter variable
+
+A  that converts between comma-separated string attributes and `string | string[]` properties.
+
+**Signature:**
+
+```typescript
+stringArrayConverter: ValueConverter
+```
+
+## Remarks
+
+- fromView: "A,B,C" → \["A","B","C"\], "A" → "A", "" → undefined - toView: \["A","B","C"\] → "A,B,C", "A" → "A", undefined → ""
+

package/docs/api-report.md.api.md

@@ -22,6 +22,7 @@ import { LogLevel } from '@genesislcap/foundation-logger';
 import { Observable } from 'rxjs';
 import { SyntheticViewTemplate } from '@microsoft/fast-element';
 import { Types } from '@genesislcap/expression-builder';
+import type { ValueConverter } from '@microsoft/fast-element';
 
 // @public (undocumented)
 export let ACCEPT_TERMS_URL: string;
@@ -1572,6 +1573,9 @@ export let SSO_LIST_URL: string;
 // @public (undocumented)
 export let SSO_LOGIN_URL: string;
 
+// @public
+export const stringArrayConverter: ValueConverter;
+
 // @public
 export type Subscribe<EventType> = (listener: Listener<EventType>) => () => void;
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-utils",
   "description": "Genesis Foundation Utils",
-  "version": "14.404.0",
+  "version": "14.406.0",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -29,18 +29,18 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.404.0",
-    "@genesislcap/genx": "14.404.0",
-    "@genesislcap/rollup-builder": "14.404.0",
-    "@genesislcap/ts-builder": "14.404.0",
-    "@genesislcap/uvu-playwright-builder": "14.404.0",
-    "@genesislcap/vite-builder": "14.404.0",
-    "@genesislcap/webpack-builder": "14.404.0",
+    "@genesislcap/foundation-testing": "14.406.0",
+    "@genesislcap/genx": "14.406.0",
+    "@genesislcap/rollup-builder": "14.406.0",
+    "@genesislcap/ts-builder": "14.406.0",
+    "@genesislcap/uvu-playwright-builder": "14.406.0",
+    "@genesislcap/vite-builder": "14.406.0",
+    "@genesislcap/webpack-builder": "14.406.0",
     "@types/json-schema": "^7.0.11"
   },
   "dependencies": {
-    "@genesislcap/expression-builder": "14.404.0",
-    "@genesislcap/foundation-logger": "14.404.0",
+    "@genesislcap/expression-builder": "14.406.0",
+    "@genesislcap/foundation-logger": "14.406.0",
     "@microsoft/fast-components": "2.30.6",
     "@microsoft/fast-element": "1.14.0",
     "@microsoft/fast-foundation": "2.50.0",
@@ -58,5 +58,5 @@
     "access": "public"
   },
   "customElements": "dist/custom-elements.json",
-  "gitHead": "54c68ebeae4e39b6c2e1b0bece963468279c323c"
+  "gitHead": "69e2b4662605a6e5e60efe537b8871a7e0c00f44"
 }