@genesislcap/foundation-utils 14.178.0 → 14.180.0

package/README.md

@@ -1,41 +1,49 @@
 # Genesis Foundation Utils
 
-Shared utils for foundation packages. *Please note that this shouldn't have any cross dependencies to other parts of
-foundation.*
-
-### [Module Federation Details](https://webpack.js.org/concepts/module-federation):
-
-| Remote Name           | Port  |
-| --------------------- | ----- |
-| foundationUtils       | 3040  |
-
-[![lerna](https://img.shields.io/badge/maintained%20with-lerna-cc00ff.svg)](https://lerna.js.org/)
-[![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](https://www.typescriptlang.org/)
-
+The `@genesislcap/foundation-utils` package provides a collection of utility services and helpers designed to facilitate common development tasks within Genesis applications. It aims to enhance productivity by offering reusable solutions for patterns and problems encountered across different projects.
+
+## API Documentation
+
+For more detailed information on API and configurations, please refer to the [API documentation](docs/api/index.md) in the `docs/api` directory.
+
+## Features
+
+The library encompasses a broad range of features, including:
+
+- **[Data](src/data/README.md)** - Manages in-memory databases and data storage solutions.
+- **[Decorators](src/decorators/README.md)** - Provides decorators for enhancing class functionalities, such as rendering on change.
+- **[Design System](src/design-system/README.md)** - Holds the design system configurations and utilities.
+- **[Directives](src/directives/README.md)** - Offers Angular-like directives for DOM manipulations, including conditional rendering and synchronization functionalities.
+- **[ENV](src/env/README.md)** - Contains utilities for environment variable management and detection of development environments.
+- **[Error](src/error/README.md)** - Deals with error mapping and handling strategies.
+- **[Formatters](src/formatters/README.md)** - Includes functions for formatting dates and numbers according to locale settings.
+- **[Logger](src/logger/README.md)** - A simple logging utility for debugging and information tracking.
+- **[Mappers](src/mappers/README.md)** - Focuses on data transformation, especially for DTOs (Data Transfer Objects).
+- **[Mixins](src/mixins/README.md)** - Provides mixins for common functionalities like lifecycle hooks and state management.
+- **[Observer](src/observer/README.md)** - Implements the Observer pattern for reactive programming.
+- **[Resource](src/observer/README.md)** - Defines types and interfaces for resource management.
+- **[Serializers](src/serializers/README.md)** - Contains serializers, particularly for JSON data handling.
+- **[State](src/state/README.md)** - Manages reactive state and provides utilities for state observation.
+- **[Styles](src/styles/README.md)** - Includes utilities for styling, dealing with colors, typography, and DOM styles.
+- **[UUID](src/uuid/README.md)** - Utilities for generating and managing UUIDs.
+- **[Window](src/window/README.md)** - Provides abstractions and utilities for window object manipulations.
 
 ## Installation
 
-To enable this module in your application, follow the steps below.
-
-1. Add `@genesislcap/foundation-utils` as a dependency in your `package.json` file. Whenever you change the dependencies of your project, ensure you run the `$ npm run bootstrap` command again. You can find more information in the [package.json basics](https://learn.genesis.global/secure/web/basics/package-json-basics/) page.
+To include `@genesislcap/foundation-utils` in your project, add it as a dependency in your `package.json` file and follow your project's routine for dependency installation.
 
 ```json
 {
-  ...
   "dependencies": {
-    ...
     "@genesislcap/foundation-utils": "latest"
-    ...
-  },
-  ...
+  }
 }
 ```
 
-## [API Docs](./docs/api/index.md)
-
 ## License
 
 Note: this project provides front-end dependencies and uses licensed components listed in the next section; thus, licenses for those components are required during development. Contact [Genesis Global](https://genesis.global/contact-us/) for more details.
 
 ### Licensed components
-Genesis low-code platform
+
+Genesis low-code platform

package/dist/custom-elements.json

@@ -1551,41 +1551,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/utils/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./logger"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/utils/logger.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "logger"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "logger",
-          "declaration": {
-            "name": "logger",
-            "module": "src/utils/logger.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/styles/color.ts",
@@ -1935,7 +1900,7 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/uuid/index.ts",
+      "path": "src/utils/index.ts",
       "declarations": [],
       "exports": [
         {
@@ -1943,36 +1908,34 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "package": "./uuid"
+            "package": "./logger"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/uuid/uuid.ts",
+      "path": "src/utils/logger.ts",
       "declarations": [
         {
           "kind": "variable",
-          "name": "UUID",
-          "description": "A dependency injection token for the UUID interface.",
-          "privacy": "public"
+          "name": "logger"
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "UUID",
+          "name": "logger",
           "declaration": {
-            "name": "UUID",
-            "module": "src/uuid/uuid.ts"
+            "name": "logger",
+            "module": "src/utils/logger.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/directives/sync/index.ts",
+      "path": "src/uuid/index.ts",
       "declarations": [],
       "exports": [
         {
@@ -1980,146 +1943,29 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "package": "./sync"
+            "package": "./uuid"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/directives/sync/sync.ts",
+      "path": "src/uuid/uuid.ts",
       "declarations": [
         {
           "kind": "variable",
-          "name": "defaultEventMap",
-          "type": {
-            "text": "Map<string, EventName>"
-          },
-          "default": "new Map([\n  ['FAST-TEXT-AREA', 'input'],\n  ['FAST-TEXT-FIELD', 'input'],\n  ['FOUNDATION-TEXT-AREA', 'input'],\n  ['FOUNDATION-TEXT-FIELD', 'input'],\n  ['INPUT', 'input'],\n  ['ZERO-TEXT-FIELD', 'input'],\n])",
-          "description": "A map that associates specific HTML element tags with their corresponding default event names.",
-          "privacy": "public"
-        },
-        {
-          "kind": "function",
-          "name": "sync",
-          "return": {
-            "type": {
-              "text": "CaptureType<TSource>"
-            }
-          },
-          "parameters": [
-            {
-              "name": "binding",
-              "type": {
-                "text": "Binding<TSource, TReturn>"
-              }
-            },
-            {
-              "name": "conversionType",
-              "default": "'string'",
-              "type": {
-                "text": "ConversionType"
-              }
-            },
-            {
-              "name": "eventName",
-              "default": "'default'",
-              "type": {
-                "text": "EventName"
-              }
-            },
-            {
-              "name": "keyAttr",
-              "optional": true,
-              "type": {
-                "text": "string"
-              }
-            }
-          ],
-          "description": "Creates a synchronization directive that binds a data source to an HTML element,",
-          "privacy": "public"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "defaultEventMap",
-          "declaration": {
-            "name": "defaultEventMap",
-            "module": "src/directives/sync/sync.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "sync",
-          "declaration": {
-            "name": "sync",
-            "module": "src/directives/sync/sync.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/directives/when-else/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./when-else"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/directives/when-else/when-else.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "whenElse",
-          "return": {
-            "type": {
-              "text": "CaptureType<TSource>"
-            }
-          },
-          "parameters": [
-            {
-              "name": "binding",
-              "type": {
-                "text": "Binding<TSource, TReturn>"
-              },
-              "description": "The condition to test for rendering."
-            },
-            {
-              "name": "trueTemplateOrTemplateBinding",
-              "type": {
-                "text": "WhenTemplate<TSource>"
-              },
-              "description": "The template or a binding that gets the template to render when the condition is true."
-            },
-            {
-              "name": "falseTemplateOrTemplateBinding",
-              "type": {
-                "text": "WhenTemplate<TSource>"
-              },
-              "description": "The template or a binding that gets the template to render when the condition is false."
-            }
-          ],
-          "description": "Directive that allows supplying an \"else\" template to the traditional https://www.fast.design/docs/api/fast-element.when/#when-function directive",
+          "name": "UUID",
+          "description": "A dependency injection token for the UUID interface.",
           "privacy": "public"
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "whenElse",
+          "name": "UUID",
           "declaration": {
-            "name": "whenElse",
-            "module": "src/directives/when-else/when-else.ts"
+            "name": "UUID",
+            "module": "src/uuid/uuid.ts"
           }
         }
       ]
@@ -2272,6 +2118,160 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/directives/sync/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./sync"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/directives/sync/sync.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "defaultEventMap",
+          "type": {
+            "text": "Map<string, EventName>"
+          },
+          "default": "new Map([\n  ['FAST-TEXT-AREA', 'input'],\n  ['FAST-TEXT-FIELD', 'input'],\n  ['FOUNDATION-TEXT-AREA', 'input'],\n  ['FOUNDATION-TEXT-FIELD', 'input'],\n  ['INPUT', 'input'],\n  ['ZERO-TEXT-FIELD', 'input'],\n])",
+          "description": "A map that associates specific HTML element tags with their corresponding default event names.",
+          "privacy": "public"
+        },
+        {
+          "kind": "function",
+          "name": "sync",
+          "return": {
+            "type": {
+              "text": "CaptureType<TSource>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "binding",
+              "type": {
+                "text": "Binding<TSource, TReturn>"
+              }
+            },
+            {
+              "name": "conversionType",
+              "default": "'string'",
+              "type": {
+                "text": "ConversionType"
+              }
+            },
+            {
+              "name": "eventName",
+              "default": "'default'",
+              "type": {
+                "text": "EventName"
+              }
+            },
+            {
+              "name": "keyAttr",
+              "optional": true,
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Creates a synchronization directive that binds a data source to an HTML element,",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "defaultEventMap",
+          "declaration": {
+            "name": "defaultEventMap",
+            "module": "src/directives/sync/sync.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "sync",
+          "declaration": {
+            "name": "sync",
+            "module": "src/directives/sync/sync.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/directives/when-else/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./when-else"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/directives/when-else/when-else.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "whenElse",
+          "return": {
+            "type": {
+              "text": "CaptureType<TSource>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "binding",
+              "type": {
+                "text": "Binding<TSource, TReturn>"
+              },
+              "description": "The condition to test for rendering."
+            },
+            {
+              "name": "trueTemplateOrTemplateBinding",
+              "type": {
+                "text": "WhenTemplate<TSource>"
+              },
+              "description": "The template or a binding that gets the template to render when the condition is true."
+            },
+            {
+              "name": "falseTemplateOrTemplateBinding",
+              "type": {
+                "text": "WhenTemplate<TSource>"
+              },
+              "description": "The template or a binding that gets the template to render when the condition is false."
+            }
+          ],
+          "description": "Directive that allows supplying an \"else\" template to the traditional https://www.fast.design/docs/api/fast-element.when/#when-function directive",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "whenElse",
+          "declaration": {
+            "name": "whenElse",
+            "module": "src/directives/when-else/when-else.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/mappers/dto/index.ts",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-utils",
   "description": "Genesis Foundation Utils",
-  "version": "14.178.0",
+  "version": "14.180.0",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -19,17 +19,17 @@
     "test": "genx test"
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.178.0",
-    "@genesislcap/genx": "14.178.0",
-    "@genesislcap/rollup-builder": "14.178.0",
-    "@genesislcap/ts-builder": "14.178.0",
-    "@genesislcap/uvu-playwright-builder": "14.178.0",
-    "@genesislcap/vite-builder": "14.178.0",
-    "@genesislcap/webpack-builder": "14.178.0",
+    "@genesislcap/foundation-testing": "14.180.0",
+    "@genesislcap/genx": "14.180.0",
+    "@genesislcap/rollup-builder": "14.180.0",
+    "@genesislcap/ts-builder": "14.180.0",
+    "@genesislcap/uvu-playwright-builder": "14.180.0",
+    "@genesislcap/vite-builder": "14.180.0",
+    "@genesislcap/webpack-builder": "14.180.0",
     "rimraf": "^3.0.2"
   },
   "dependencies": {
-    "@genesislcap/foundation-logger": "14.178.0",
+    "@genesislcap/foundation-logger": "14.180.0",
     "@microsoft/fast-components": "^2.30.6",
     "@microsoft/fast-element": "^1.12.0",
     "@microsoft/fast-foundation": "^2.49.4",
@@ -47,5 +47,5 @@
     "access": "public"
   },
   "customElements": "dist/custom-elements.json",
-  "gitHead": "fd55a5cd2e3b0fa048377835c73186df1e75b849"
+  "gitHead": "24ddbaf4c43ccfe2c323ec1178b1829451b1721a"
 }