@genesislcap/foundation-utils 14.408.0 → 14.409.0-FUI-2495.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-utils",
   "description": "Genesis Foundation Utils",
-  "version": "14.408.0",
+  "version": "14.409.0-FUI-2495.1",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -29,18 +29,18 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.408.0",
-    "@genesislcap/genx": "14.408.0",
-    "@genesislcap/rollup-builder": "14.408.0",
-    "@genesislcap/ts-builder": "14.408.0",
-    "@genesislcap/uvu-playwright-builder": "14.408.0",
-    "@genesislcap/vite-builder": "14.408.0",
-    "@genesislcap/webpack-builder": "14.408.0",
+    "@genesislcap/foundation-testing": "14.409.0-FUI-2495.1",
+    "@genesislcap/genx": "14.409.0-FUI-2495.1",
+    "@genesislcap/rollup-builder": "14.409.0-FUI-2495.1",
+    "@genesislcap/ts-builder": "14.409.0-FUI-2495.1",
+    "@genesislcap/uvu-playwright-builder": "14.409.0-FUI-2495.1",
+    "@genesislcap/vite-builder": "14.409.0-FUI-2495.1",
+    "@genesislcap/webpack-builder": "14.409.0-FUI-2495.1",
     "@types/json-schema": "^7.0.11"
   },
   "dependencies": {
-    "@genesislcap/expression-builder": "14.408.0",
-    "@genesislcap/foundation-logger": "14.408.0",
+    "@genesislcap/expression-builder": "14.409.0-FUI-2495.1",
+    "@genesislcap/foundation-logger": "14.409.0-FUI-2495.1",
     "@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": "26b08831fd001b4ee95c8a0d3364a18c0ec4005b"
+  "gitHead": "1587391f8f98599f221c4fe75b20868382f73144"
 }

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

@@ -1,12 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [ACCEPT\_TERMS\_URL](./foundation-utils.accept_terms_url.md)
-
-## ACCEPT\_TERMS\_URL variable
-
-
-**Signature:**
-
-```typescript
-ACCEPT_TERMS_URL: string
-```

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

@@ -1,13 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [activeColorScheme](./foundation-utils.activecolorscheme.md)
-
-## activeColorScheme variable
-
-A design token that represents the active color scheme (light or dark).
-
-**Signature:**
-
-```typescript
-activeColorScheme: import("@microsoft/fast-foundation").CSSDesignToken<string>
-```

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

@@ -1,22 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [API\_HOST](./foundation-utils.api_host.md)
-
-## API\_HOST variable
-
-The Genesis Server URL (WebSocket or HTTP).
-
-**Signature:**
-
-```typescript
-_API_HOST: string
-```
-
-## Remarks
-
-Optional.
-
-## Example
-
-ws://localhost/gwf/, ws://localhost:9064
-

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

@@ -1,90 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [assureDesignSystem](./foundation-utils.assuredesignsystem.md)
-
-## assureDesignSystem() function
-
-assureDesignSystem.
-
-**Signature:**
-
-```typescript
-export declare function assureDesignSystem(module: DesignSystemModule): DesignSystemModule;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-module
-
-
-</td><td>
-
-[DesignSystemModule](./foundation-utils.designsystemmodule.md)
-
-
-</td><td>
-
-
-</td></tr>
-</tbody></table>
-
-**Returns:**
-
-[DesignSystemModule](./foundation-utils.designsystemmodule.md)
-
-## Remarks
-
-Webpack caching strategies can backfill missing modules with placeholders in an attempt to prevent errors. In the case of offline remotes, we rely on the error to fall back to local versions. This utility assures we have a design system.
-
-## Example 1
-
-
-```ts
-async function zeroDesignSystemImport(): Promise<DesignSystemModule> {
-  let module: DesignSystemModule;
-  let type: ResourceType = ResourceType.remote;
-  try {
-    module = await import('foundationZero/ZeroDesignSystem');
-    return assureDesignSystem(module);
-  } catch (e) {
-    logger.info(
-      `Please note remoteEntry.js load errors are expected if module federated dependencies are offline. Falling back to locally bundled versions.`,
-    );
-    type = ResourceType.local;
-    module = await import('@genesislcap/foundation-zero');
-    return assureDesignSystem(module);
-  } finally {
-    logger.debug(`Using '${type}' version of foundation-zero`);
-  }
-}
-```
-
-## Example 2
-
-You should also instruct webpack to use strict module handling.
-
-```ts
-output: {
-  strictModuleErrorHandling: true,
-  strictModuleExceptionHandling: true,
-}
-```
-

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

@@ -1,56 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [avoidTreeShaking](./foundation-utils.avoidtreeshaking.md)
-
-## avoidTreeShaking() function
-
-Explicitly prevents tree-shaking of custom element classes by referencing them.
-
-Bundlers may incorrectly remove code that it thinks has no side effects, such as custom element definitions that are only referenced in templates. By passing these classes to `avoidTreeShaking`<!-- -->, we create a side effect that signals to the bundler to preserve the code.
-
-**Signature:**
-
-```typescript
-avoidTreeShaking: (...classes: unknown[]) => void
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-classes
-
-
-</td><td>
-
-unknown\[\]
-
-
-</td><td>
-
-One or more custom element classes that should not be tree-shaken.
-
-
-</td></tr>
-</tbody></table>
-
-**Returns:**
-
-void
-

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

@@ -1,18 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [BUILDER](./foundation-utils.builder.md)
-
-## BUILDER variable
-
-The builder aka file bundler.
-
-**Signature:**
-
-```typescript
-_BUILDER: string
-```
-
-## Example
-
-'webpack', 'vite'.
-

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

@@ -1,12 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [CHANGE\_PASSWORD\_URL](./foundation-utils.change_password_url.md)
-
-## CHANGE\_PASSWORD\_URL variable
-
-
-**Signature:**
-
-```typescript
-CHANGE_PASSWORD_URL: string
-```

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

@@ -1,12 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [ConstructableLifecycleHandler](./foundation-utils.constructablelifecyclehandler.md)
-
-## ConstructableLifecycleHandler type
-
-
-**Signature:**
-
-```typescript
-export type ConstructableLifecycleHandler = Constructable<FASTElement & HTMLElement>;
-```

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

@@ -1,13 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [ConstructablePendingState](./foundation-utils.constructablependingstate.md)
-
-## ConstructablePendingState type
-
-A mixin that provides functionality for raising `pending-state` events.
-
-**Signature:**
-
-```typescript
-export declare type ConstructablePendingState = Constructable<FASTElement & HTMLElement>;
-```

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

@@ -1,13 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [ConversionType](./foundation-utils.conversiontype.md)
-
-## ConversionType type
-
-Represents the possible types of value conversion for data synchronization.
-
-**Signature:**
-
-```typescript
-export type ConversionType = 'string' | 'number' | 'time' | 'boolean';
-```

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

@@ -1,56 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [createErrorMap](./foundation-utils.createerrormap.md)
-
-## createErrorMap() function
-
-A factory to create the error map.
-
-**Signature:**
-
-```typescript
-createErrorMap: <TErrorDetailMap extends ErrorDetailMap>(logger: ErrorMapLogger) => ErrorMap<TErrorDetailMap>
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-logger
-
-
-</td><td>
-
-[ErrorMapLogger](./foundation-utils.errormaplogger.md)
-
-
-</td><td>
-
-A logger error method reference.
-
-
-</td></tr>
-</tbody></table>
-
-**Returns:**
-
-[ErrorMap](./foundation-utils.errormap.md)<!-- -->&lt;TErrorDetailMap&gt;
-
-A ErrorMap instance.
-

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

@@ -1,77 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [createLogger](./foundation-utils.createlogger.md)
-
-## createLogger() function
-
-> Warning: This API is now obsolete.
-> 
-> - Use `createLogger` from `@genesislcap/foundation-logger` instead.
-> 
-
-Creates a logger with the given name and options.
-
-**Signature:**
-
-```typescript
-export declare function createLogger(name: string, options?: LoggerOptions): Logger;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-name
-
-
-</td><td>
-
-string
-
-
-</td><td>
-
-The name to give the logger.
-
-
-</td></tr>
-<tr><td>
-
-options
-
-
-</td><td>
-
-[LoggerOptions](./foundation-utils.loggeroptions.md)
-
-
-</td><td>
-
-_(Optional)_ The options to use when creating the logger.
-
-
-</td></tr>
-</tbody></table>
-
-**Returns:**
-
-[Logger](./foundation-utils.logger.md)
-
-The resulting logger.
-

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

@@ -1,17 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [createObserver](./foundation-utils.createobserver.md)
-
-## createObserver() function
-
-Creates a new event observer instance.
-
-**Signature:**
-
-```typescript
-createObserver: <EventType>() => Observer<EventType>
-```
-**Returns:**
-
-[Observer](./foundation-utils.observer.md)<!-- -->&lt;EventType&gt;
-

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

@@ -1,52 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [customNumberParser](./foundation-utils.customnumberparser.md)
-
-## customNumberParser() function
-
-A Default Number Parser for deserializing objects.
-
-**Signature:**
-
-```typescript
-export declare function customNumberParser(value: any): number | bigint;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-value
-
-
-</td><td>
-
-any
-
-
-</td><td>
-
-
-</td></tr>
-</tbody></table>
-
-**Returns:**
-
-number \| bigint
-

package/docs/api/foundation-utils.database.create.md

@@ -1,50 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [Database](./foundation-utils.database.md) &gt; [create](./foundation-utils.database.create.md)
-
-## Database.create() method
-
-**Signature:**
-
-```typescript
-create(newValue: Omit<T, 'id'>): Promise<DatabaseAccessResult.Create<T>>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-newValue
-
-
-</td><td>
-
-Omit&lt;T, 'id'&gt;
-
-
-</td><td>
-
-
-</td></tr>
-</tbody></table>
-
-**Returns:**
-
-Promise&lt;[DatabaseAccessResult.Create](./foundation-utils.databaseaccessresult.create.md)<!-- -->&lt;T&gt;&gt;
-

package/docs/api/foundation-utils.database.delete.md

@@ -1,50 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [Database](./foundation-utils.database.md) &gt; [delete](./foundation-utils.database.delete.md)
-
-## Database.delete() method
-
-**Signature:**
-
-```typescript
-delete(id: string): Promise<DatabaseAccessResult.Delete>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-id
-
-
-</td><td>
-
-string
-
-
-</td><td>
-
-
-</td></tr>
-</tbody></table>
-
-**Returns:**
-
-Promise&lt;[DatabaseAccessResult.Delete](./foundation-utils.databaseaccessresult.delete.md)<!-- -->&gt;
-

package/docs/api/foundation-utils.database.isworking.md

@@ -1,11 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [Database](./foundation-utils.database.md) &gt; [isWorking](./foundation-utils.database.isworking.md)
-
-## Database.isWorking property
-
-**Signature:**
-
-```typescript
-isWorking: boolean;
-```