@genesislcap/foundation-utils 15.6.0 → 15.6.2

package/dist/custom-elements.json

@@ -211,209 +211,48 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/design-system/design-system.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "assureDesignSystem",
-          "return": {
-            "type": {
-              "text": "DesignSystemModule"
-            }
-          },
-          "parameters": [
-            {
-              "name": "module",
-              "type": {
-                "text": "DesignSystemModule"
-              }
-            }
-          ],
-          "description": "assureDesignSystem.",
-          "privacy": "public"
-        },
-        {
-          "kind": "function",
-          "name": "getCurrentDesignSystem",
-          "return": {
-            "type": {
-              "text": ""
-            }
-          },
-          "parameters": [
-            {
-              "name": "element",
-              "type": {
-                "text": "HTMLElement"
-              },
-              "description": "The starting HTML element"
-            },
-            {
-              "name": "fallbackPrefix",
-              "type": {
-                "text": "string"
-              },
-              "description": "The prefix to fallback to if the provider is not available"
-            }
-          ],
-          "description": "Get the current design system provider element and prefix by checking available providers.\nIf no provider is found, falls back to the provided prefix.",
-          "privacy": "public"
-        },
-        {
-          "kind": "function",
-          "name": "getCurrentDesignSystemPrefix",
-          "return": {
-            "type": {
-              "text": ""
-            }
-          },
-          "parameters": [
-            {
-              "name": "element",
-              "type": {
-                "text": "HTMLElement"
-              },
-              "description": "The starting HTML element"
-            },
-            {
-              "name": "fallbackPrefix",
-              "type": {
-                "text": "string"
-              },
-              "description": "The prefix to fallback to if the provider is not available"
-            }
-          ],
-          "description": "Get the current design system prefix by checking available providers.\nIf no provider is found, falls back to the provided prefix.",
-          "privacy": "public"
-        }
-      ],
+      "path": "src/converters/index.ts",
+      "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "assureDesignSystem",
-          "declaration": {
-            "name": "assureDesignSystem",
-            "module": "src/design-system/design-system.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "getCurrentDesignSystem",
-          "declaration": {
-            "name": "getCurrentDesignSystem",
-            "module": "src/design-system/design-system.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "getCurrentDesignSystemPrefix",
+          "name": "*",
           "declaration": {
-            "name": "getCurrentDesignSystemPrefix",
-            "module": "src/design-system/design-system.ts"
+            "name": "*",
+            "package": "./string-array-converter"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/design-system/editable-elements.ts",
+      "path": "src/converters/string-array-converter.ts",
       "declarations": [
         {
           "kind": "variable",
-          "name": "BASE_EDITABLE_ELEMENT_SELECTORS",
-          "type": {
-            "text": "[\n  ...NATIVE_EDITABLE_ELEMENT_SELECTORS,\n  ...CONTENT_EDITABLE_SELECTORS,\n  ...ARIA_EDITABLE_ROLE_SELECTORS,\n]"
-          },
-          "default": "[\n  ...NATIVE_EDITABLE_ELEMENT_SELECTORS,\n  ...CONTENT_EDITABLE_SELECTORS,\n  ...ARIA_EDITABLE_ROLE_SELECTORS,\n]",
-          "description": "Base selectors treated as editable context regardless of design system.\nIncludes native controls, contenteditable, and ARIA-editable roles."
-        },
-        {
-          "kind": "variable",
-          "name": "DESIGN_SYSTEM_EDITABLE_ELEMENT_SELECTORS",
+          "name": "stringArrayConverter",
           "type": {
-            "text": "Record<\n  EditableDesignSystemPrefix,\n  readonly string[]\n>"
-          },
-          "default": "{\n  rapid: buildDesignSystemEditableSelectors('rapid'),\n  zero: buildDesignSystemEditableSelectors('zero'),\n}",
-          "description": "Design-system specific editable host selectors."
-        },
-        {
-          "kind": "function",
-          "name": "buildEditableElementSelector",
-          "return": {
-            "type": {
-              "text": "string"
-            }
+            "text": "ValueConverter"
           },
-          "parameters": [
-            {
-              "name": "designSystems",
-              "type": {
-                "text": "readonly EditableDesignSystemPrefix[]"
-              }
-            },
-            {
-              "name": "customEditableSelectors",
-              "default": "[]",
-              "type": {
-                "text": "readonly string[]"
-              }
-            }
-          ]
+          "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": "BASE_EDITABLE_ELEMENT_SELECTORS",
-          "declaration": {
-            "name": "BASE_EDITABLE_ELEMENT_SELECTORS",
-            "module": "src/design-system/editable-elements.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "DESIGN_SYSTEM_EDITABLE_ELEMENT_SELECTORS",
-          "declaration": {
-            "name": "DESIGN_SYSTEM_EDITABLE_ELEMENT_SELECTORS",
-            "module": "src/design-system/editable-elements.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "buildEditableElementSelector",
-          "declaration": {
-            "name": "buildEditableElementSelector",
-            "module": "src/design-system/editable-elements.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/design-system/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./design-system"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "*",
+          "name": "stringArrayConverter",
           "declaration": {
-            "name": "*",
-            "package": "./editable-elements"
+            "name": "stringArrayConverter",
+            "module": "src/converters/string-array-converter.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/directives/index.ts",
+      "path": "src/decorators/index.ts",
       "declarations": [],
       "exports": [
         {
@@ -421,256 +260,709 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "package": "./sync"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./when-else"
+            "package": "./renderOnChange"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/encoding/index.ts",
-      "declarations": [],
-      "exports": [
+      "path": "src/decorators/renderOnChange.ts",
+      "declarations": [
         {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./base64"
-          }
+          "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"
         }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/env/index.ts",
-      "declarations": [],
+      ],
       "exports": [
         {
           "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./is-dev"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "*",
+          "name": "renderOnChange",
           "declaration": {
-            "name": "*",
-            "package": "./variables"
+            "name": "renderOnChange",
+            "module": "src/decorators/renderOnChange.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/env/is-dev.ts",
+      "path": "src/data/inMemoryDatabase.ts",
       "declarations": [
         {
-          "kind": "function",
-          "name": "isDev",
-          "description": "Determines if the current environment is a development environment.",
-          "privacy": "public"
+          "kind": "class",
+          "description": "An in memory database of specific DatabaseRecord types.",
+          "name": "InMemoryDatabase",
+          "members": [
+            {
+              "kind": "field",
+              "name": "isWorking",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "records",
+              "type": {
+                "text": "Record<string, T>"
+              },
+              "privacy": "private",
+              "default": "{}"
+            },
+            {
+              "kind": "field",
+              "name": "beforeUpdateListeners",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "afterUpdateListeners",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "create",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "Promise<DatabaseAccessResult.Create<T>>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "newValue",
+                  "type": {
+                    "text": "Omit<T, 'id'>"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "read",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "Promise<DatabaseAccessResult.Read<T>>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "update",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "Promise<DatabaseAccessResult.Update<T>>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "newValue",
+                  "type": {
+                    "text": "Omit<Partial<T>, 'id'>"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "delete",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "Promise<DatabaseAccessResult.Delete>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "visit",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "visitor",
+                  "type": {
+                    "text": "(record: T) => void"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "onBeforeUpdate",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "() => void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "Listener<DatabaseEvent.BeforeUpdate<T>>"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "onAfterUpdate",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "() => void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "Listener<DatabaseEvent.AfterUpdate<T>>"
+                  }
+                }
+              ]
+            }
+          ]
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "isDev",
+          "name": "InMemoryDatabase",
           "declaration": {
-            "name": "isDev",
-            "module": "src/env/is-dev.ts"
+            "name": "InMemoryDatabase",
+            "module": "src/data/inMemoryDatabase.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/env/variables.ts",
-      "declarations": [
+      "path": "src/data/index.ts",
+      "declarations": [],
+      "exports": [
         {
-          "kind": "variable",
-          "name": "BUILDER",
-          "type": {
-            "text": "string"
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./inMemoryDatabase"
           }
-        },
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/design-system/design-system.ts",
+      "declarations": [
         {
-          "kind": "variable",
-          "name": "_BUILDER",
-          "type": {
-            "text": "string"
+          "kind": "function",
+          "name": "assureDesignSystem",
+          "return": {
+            "type": {
+              "text": "DesignSystemModule"
+            }
           },
-          "default": "'webpack'",
-          "description": "The builder aka file bundler.",
+          "parameters": [
+            {
+              "name": "module",
+              "type": {
+                "text": "DesignSystemModule"
+              }
+            }
+          ],
+          "description": "assureDesignSystem.",
           "privacy": "public"
         },
         {
-          "kind": "variable",
-          "name": "PUBLIC_PATH",
-          "type": {
-            "text": "string"
-          }
-        },
-        {
-          "kind": "variable",
-          "name": "_PUBLIC_PATH",
-          "type": {
-            "text": "string"
+          "kind": "function",
+          "name": "getCurrentDesignSystem",
+          "return": {
+            "type": {
+              "text": ""
+            }
           },
-          "default": "'/'",
-          "description": "The public path.",
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "description": "The starting HTML element"
+            },
+            {
+              "name": "fallbackPrefix",
+              "type": {
+                "text": "string"
+              },
+              "description": "The prefix to fallback to if the provider is not available"
+            }
+          ],
+          "description": "Get the current design system provider element and prefix by checking available providers.\nIf no provider is found, falls back to the provided prefix.",
           "privacy": "public"
         },
         {
-          "kind": "variable",
-          "name": "SOCKET_EXT",
-          "type": {
-            "text": "string"
-          }
-        },
-        {
-          "kind": "variable",
-          "name": "_SOCKET_EXT",
-          "type": {
-            "text": "string"
+          "kind": "function",
+          "name": "getCurrentDesignSystemPrefix",
+          "return": {
+            "type": {
+              "text": ""
+            }
           },
-          "default": "'gwf'",
-          "description": "The sub-path used for WebSocket connections when API_HOST is not set",
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "description": "The starting HTML element"
+            },
+            {
+              "name": "fallbackPrefix",
+              "type": {
+                "text": "string"
+              },
+              "description": "The prefix to fallback to if the provider is not available"
+            }
+          ],
+          "description": "Get the current design system prefix by checking available providers.\nIf no provider is found, falls back to the provided prefix.",
           "privacy": "public"
-        },
+        }
+      ],
+      "exports": [
         {
-          "kind": "variable",
-          "name": "FORCE_HTTP",
-          "type": {
-            "text": "string"
+          "kind": "js",
+          "name": "assureDesignSystem",
+          "declaration": {
+            "name": "assureDesignSystem",
+            "module": "src/design-system/design-system.ts"
           }
         },
         {
-          "kind": "variable",
-          "name": "_FORCE_HTTP",
-          "type": {
-            "text": "string"
-          },
-          "description": "The path to a JSON config file for the HTTP mode.",
-          "privacy": "public"
+          "kind": "js",
+          "name": "getCurrentDesignSystem",
+          "declaration": {
+            "name": "getCurrentDesignSystem",
+            "module": "src/design-system/design-system.ts"
+          }
         },
         {
-          "kind": "variable",
-          "name": "FORCE_HTTP_REQREP",
-          "type": {
-            "text": "string"
+          "kind": "js",
+          "name": "getCurrentDesignSystemPrefix",
+          "declaration": {
+            "name": "getCurrentDesignSystemPrefix",
+            "module": "src/design-system/design-system.ts"
           }
-        },
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/design-system/editable-elements.ts",
+      "declarations": [
         {
           "kind": "variable",
-          "name": "_FORCE_HTTP_REQREP",
+          "name": "BASE_EDITABLE_ELEMENT_SELECTORS",
           "type": {
-            "text": "string"
+            "text": "[\n  ...NATIVE_EDITABLE_ELEMENT_SELECTORS,\n  ...CONTENT_EDITABLE_SELECTORS,\n  ...ARIA_EDITABLE_ROLE_SELECTORS,\n]"
           },
-          "description": "When `'true'`, request/reply and event traffic (`request`, `commitEvent`, metadata, schema and\nresources lookups) is sent over HTTP even while the primary connection is a WebSocket.\nStreaming (`stream`/`snapshot`) stays on the socket.",
-          "privacy": "public"
-        },
-        {
-          "kind": "variable",
-          "name": "GENESIS_SOCKET_URL",
-          "default": "`${location.protocol.replace('http', 'ws')}//${location.host}${_PUBLIC_PATH}/${_SOCKET_EXT}/`",
-          "description": "Genesis Socket URL",
-          "privacy": "public"
+          "default": "[\n  ...NATIVE_EDITABLE_ELEMENT_SELECTORS,\n  ...CONTENT_EDITABLE_SELECTORS,\n  ...ARIA_EDITABLE_ROLE_SELECTORS,\n]",
+          "description": "Base selectors treated as editable context regardless of design system.\nIncludes native controls, contenteditable, and ARIA-editable roles."
         },
         {
           "kind": "variable",
-          "name": "API_HOST",
+          "name": "DESIGN_SYSTEM_EDITABLE_ELEMENT_SELECTORS",
           "type": {
-            "text": "string"
-          }
+            "text": "Record<\n  EditableDesignSystemPrefix,\n  readonly string[]\n>"
+          },
+          "default": "{\n  rapid: buildDesignSystemEditableSelectors('rapid'),\n  zero: buildDesignSystemEditableSelectors('zero'),\n}",
+          "description": "Design-system specific editable host selectors."
         },
         {
-          "kind": "variable",
-          "name": "_API_HOST",
-          "type": {
-            "text": "string"
+          "kind": "function",
+          "name": "buildEditableElementSelector",
+          "return": {
+            "type": {
+              "text": "string"
+            }
           },
-          "default": "`${PROTOCOL}//${location.host}/${_SOCKET_EXT}/`",
-          "description": "The Genesis Server URL (WebSocket or HTTP).",
-          "privacy": "public"
-        },
+          "parameters": [
+            {
+              "name": "designSystems",
+              "type": {
+                "text": "readonly EditableDesignSystemPrefix[]"
+              }
+            },
+            {
+              "name": "customEditableSelectors",
+              "default": "[]",
+              "type": {
+                "text": "readonly string[]"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
         {
-          "kind": "variable",
-          "name": "HTTP_CONFIG",
-          "type": {
-            "text": "string"
+          "kind": "js",
+          "name": "BASE_EDITABLE_ELEMENT_SELECTORS",
+          "declaration": {
+            "name": "BASE_EDITABLE_ELEMENT_SELECTORS",
+            "module": "src/design-system/editable-elements.ts"
           }
         },
         {
-          "kind": "variable",
-          "name": "_HTTP_CONFIG",
-          "type": {
-            "text": "string"
-          },
-          "description": "Configuration settings for HTTP, used in http connect flow [`genesislcap-foundation-comms.HttpConnectConfig`](https://link-to-docs).",
-          "privacy": "public"
+          "kind": "js",
+          "name": "DESIGN_SYSTEM_EDITABLE_ELEMENT_SELECTORS",
+          "declaration": {
+            "name": "DESIGN_SYSTEM_EDITABLE_ELEMENT_SELECTORS",
+            "module": "src/design-system/editable-elements.ts"
+          }
         },
         {
-          "kind": "variable",
-          "name": "DEFAULT_ORGANISATION",
-          "type": {
-            "text": "string"
+          "kind": "js",
+          "name": "buildEditableElementSelector",
+          "declaration": {
+            "name": "buildEditableElementSelector",
+            "module": "src/design-system/editable-elements.ts"
           }
-        },
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/design-system/index.ts",
+      "declarations": [],
+      "exports": [
         {
-          "kind": "variable",
-          "name": "_DEFAULT_ORGANISATION",
-          "type": {
-            "text": "string"
-          },
-          "description": "The default Organisation value, used in auth/login flow [`genesislcap-foundation-auth`](https://link-to-docs).",
-          "privacy": "public"
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./design-system"
+          }
         },
         {
-          "kind": "variable",
-          "name": "DEFAULT_PASSWORD",
-          "type": {
-            "text": "string"
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./editable-elements"
           }
-        },
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/directives/index.ts",
+      "declarations": [],
+      "exports": [
         {
-          "kind": "variable",
-          "name": "_DEFAULT_PASSWORD",
-          "type": {
-            "text": "string"
-          },
-          "description": "The default Password value, used in auth/login flow [`genesislcap-foundation-auth`](https://link-to-docs).",
-          "privacy": "public"
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./sync"
+          }
         },
         {
-          "kind": "variable",
-          "name": "DEFAULT_USER",
-          "type": {
-            "text": "string"
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./when-else"
           }
-        },
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/encoding/index.ts",
+      "declarations": [],
+      "exports": [
         {
-          "kind": "variable",
-          "name": "_DEFAULT_USER",
-          "type": {
-            "text": "string"
-          },
-          "description": "The default Username value, used in auth/login flow [`genesislcap-foundation-auth`](https://link-to-docs).",
-          "privacy": "public"
-        },
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./base64"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/env/index.ts",
+      "declarations": [],
+      "exports": [
         {
-          "kind": "variable",
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./is-dev"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./variables"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/env/is-dev.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "isDev",
+          "description": "Determines if the current environment is a development environment.",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "isDev",
+          "declaration": {
+            "name": "isDev",
+            "module": "src/env/is-dev.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/env/variables.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "BUILDER",
+          "type": {
+            "text": "string"
+          }
+        },
+        {
+          "kind": "variable",
+          "name": "_BUILDER",
+          "type": {
+            "text": "string"
+          },
+          "default": "'webpack'",
+          "description": "The builder aka file bundler.",
+          "privacy": "public"
+        },
+        {
+          "kind": "variable",
+          "name": "PUBLIC_PATH",
+          "type": {
+            "text": "string"
+          }
+        },
+        {
+          "kind": "variable",
+          "name": "_PUBLIC_PATH",
+          "type": {
+            "text": "string"
+          },
+          "default": "'/'",
+          "description": "The public path.",
+          "privacy": "public"
+        },
+        {
+          "kind": "variable",
+          "name": "SOCKET_EXT",
+          "type": {
+            "text": "string"
+          }
+        },
+        {
+          "kind": "variable",
+          "name": "_SOCKET_EXT",
+          "type": {
+            "text": "string"
+          },
+          "default": "'gwf'",
+          "description": "The sub-path used for WebSocket connections when API_HOST is not set",
+          "privacy": "public"
+        },
+        {
+          "kind": "variable",
+          "name": "FORCE_HTTP",
+          "type": {
+            "text": "string"
+          }
+        },
+        {
+          "kind": "variable",
+          "name": "_FORCE_HTTP",
+          "type": {
+            "text": "string"
+          },
+          "description": "The path to a JSON config file for the HTTP mode.",
+          "privacy": "public"
+        },
+        {
+          "kind": "variable",
+          "name": "FORCE_HTTP_REQREP",
+          "type": {
+            "text": "string"
+          }
+        },
+        {
+          "kind": "variable",
+          "name": "_FORCE_HTTP_REQREP",
+          "type": {
+            "text": "string"
+          },
+          "description": "When `'true'`, request/reply and event traffic (`request`, `commitEvent`, metadata, schema and\nresources lookups) is sent over HTTP even while the primary connection is a WebSocket.\nStreaming (`stream`/`snapshot`) stays on the socket.",
+          "privacy": "public"
+        },
+        {
+          "kind": "variable",
+          "name": "GENESIS_SOCKET_URL",
+          "default": "`${location.protocol.replace('http', 'ws')}//${location.host}${_PUBLIC_PATH}/${_SOCKET_EXT}/`",
+          "description": "Genesis Socket URL",
+          "privacy": "public"
+        },
+        {
+          "kind": "variable",
+          "name": "API_HOST",
+          "type": {
+            "text": "string"
+          }
+        },
+        {
+          "kind": "variable",
+          "name": "_API_HOST",
+          "type": {
+            "text": "string"
+          },
+          "default": "`${PROTOCOL}//${location.host}/${_SOCKET_EXT}/`",
+          "description": "The Genesis Server URL (WebSocket or HTTP).",
+          "privacy": "public"
+        },
+        {
+          "kind": "variable",
+          "name": "HTTP_CONFIG",
+          "type": {
+            "text": "string"
+          }
+        },
+        {
+          "kind": "variable",
+          "name": "_HTTP_CONFIG",
+          "type": {
+            "text": "string"
+          },
+          "description": "Configuration settings for HTTP, used in http connect flow [`genesislcap-foundation-comms.HttpConnectConfig`](https://link-to-docs).",
+          "privacy": "public"
+        },
+        {
+          "kind": "variable",
+          "name": "DEFAULT_ORGANISATION",
+          "type": {
+            "text": "string"
+          }
+        },
+        {
+          "kind": "variable",
+          "name": "_DEFAULT_ORGANISATION",
+          "type": {
+            "text": "string"
+          },
+          "description": "The default Organisation value, used in auth/login flow [`genesislcap-foundation-auth`](https://link-to-docs).",
+          "privacy": "public"
+        },
+        {
+          "kind": "variable",
+          "name": "DEFAULT_PASSWORD",
+          "type": {
+            "text": "string"
+          }
+        },
+        {
+          "kind": "variable",
+          "name": "_DEFAULT_PASSWORD",
+          "type": {
+            "text": "string"
+          },
+          "description": "The default Password value, used in auth/login flow [`genesislcap-foundation-auth`](https://link-to-docs).",
+          "privacy": "public"
+        },
+        {
+          "kind": "variable",
+          "name": "DEFAULT_USER",
+          "type": {
+            "text": "string"
+          }
+        },
+        {
+          "kind": "variable",
+          "name": "_DEFAULT_USER",
+          "type": {
+            "text": "string"
+          },
+          "description": "The default Username value, used in auth/login flow [`genesislcap-foundation-auth`](https://link-to-docs).",
+          "privacy": "public"
+        },
+        {
+          "kind": "variable",
           "name": "LOGIN_URL",
           "type": {
             "text": "string"
@@ -948,298 +1240,6 @@
         }
       ]
     },
-    {
-      "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",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "An in memory database of specific DatabaseRecord types.",
-          "name": "InMemoryDatabase",
-          "members": [
-            {
-              "kind": "field",
-              "name": "isWorking",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "public",
-              "default": "false"
-            },
-            {
-              "kind": "field",
-              "name": "records",
-              "type": {
-                "text": "Record<string, T>"
-              },
-              "privacy": "private",
-              "default": "{}"
-            },
-            {
-              "kind": "field",
-              "name": "beforeUpdateListeners",
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "afterUpdateListeners",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "create",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "Promise<DatabaseAccessResult.Create<T>>"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "newValue",
-                  "type": {
-                    "text": "Omit<T, 'id'>"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "read",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "Promise<DatabaseAccessResult.Read<T>>"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "id",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "update",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "Promise<DatabaseAccessResult.Update<T>>"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "id",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "newValue",
-                  "type": {
-                    "text": "Omit<Partial<T>, 'id'>"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "delete",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "Promise<DatabaseAccessResult.Delete>"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "id",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "visit",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "Promise<void>"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "visitor",
-                  "type": {
-                    "text": "(record: T) => void"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "onBeforeUpdate",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "() => void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "listener",
-                  "type": {
-                    "text": "Listener<DatabaseEvent.BeforeUpdate<T>>"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "onAfterUpdate",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "() => void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "listener",
-                  "type": {
-                    "text": "Listener<DatabaseEvent.AfterUpdate<T>>"
-                  }
-                }
-              ]
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "InMemoryDatabase",
-          "declaration": {
-            "name": "InMemoryDatabase",
-            "module": "src/data/inMemoryDatabase.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/data/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./inMemoryDatabase"
-          }
-        }
-      ]
-    },
-    {
-      "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/error/errorMap.ts",