@genesislcap/foundation-entity-management 14.408.0 → 14.409.0

package/README.md

@@ -1,111 +1,25 @@
-## Foundation Entity Management
+# @genesislcap/foundation-entity-management
 
-[API](./docs/api/index.md)
+Documentation for this package is published on the Genesis docs site:
 
-## Entity Management
+**Docs: [Entity Manager](https://docs.genesis.global/docs/develop/client-capabilities/grids/entity-manager/)**
 
-### Introduction
+## Installation
 
-The Entity Management micro front-end is used to connect to a resource on the back end and manage it from the front end. Handlers can be set up for create, update, and delete events; after adding an event, a button is displayed, so that the user can perform the action. There is a list of pre-defined events and resources to manage, but you can also manage custom resources that have been created on the back end.
+Add the package to your `package.json` dependencies. After changing dependencies, run `npm run bootstrap` (or your project's equivalent). See [package.json basics](https://learn.genesis.global/secure/web/basics/package-json-basics/) for more information.
 
-:::tip
-The buttons are accessed conditionally, based on the specified events. For example, if the current user is only able to edit the entities, then you should only set the edit event on the entity-manager - you need to set the events so that they are conditional on user authorisations.
-:::
-
-Two core components are used to manage the entities - the grid and the form.
-
-The grid contains an entity on each row and data in each column. Here is an example showing a grid used to manage counterparties:
-
-![Example entity management grid](./docs/img/foundation-entity-management-grid.png)
-
-The other component is the form. This is used to update an existing entity or to create a new one. Here is an example:
-
-![Example entity management form](./docs/img/foundation-entity-management-form.png)
-
-### Set-up
-
-To enable this micro-front-end in your application, follow the steps below.
-
-1. Add `@genesislcap/foundation-entity-management` as a dependency in your **package.json** file. Whenever you change the dependencies of your project, run the `$ npm run bootstrap` command again. For more information, see the [package.json basics](https://learn.genesis.global/secure/web/basics/package-json-basics/) page.
-
-```javascript
+```json
 {
-  ...
   "dependencies": {
     "@genesislcap/foundation-entity-management": "latest"
-  },
-  ...
+  }
 }
 ```
 
-2. Import and declare the class in the page of the class where you wish to use the Entity Manager. Then add the entity management into the template html where required:
-
-```javascript
-// Import
-import { EntityManagement, } from '@genesislcap/foundation-entity-management';
-
-// Declare class
-EntityManagement;
-
-// Example html with the entity management used in two different tabs to manage two
-// different resources - one managing the counterpartys, and one managing the users.
-export const AdminTemplate: ViewTemplate = html`
-  <zero-tabs>
-    <zero-tab-panel slot="tabpanel">
-      <zero-notification-listener>
-        <entity-management
-          resourceName="ALL_COUNTERPARTYS"
-          title="Counterparty Management"
-          updateEvent="EVENT_COUNTERPARTY_MODIFY"
-          deleteEvent="EVENT_COUNTERPARTY_DELETE"
-          createEvent="EVENT_COUNTERPARTY_INSERT"
-        ></entity-management>
-      </zero-notification-listener>
-    </zero-tab-panel>
-    <zero-tab-panel slot="tabpanel">
-      <zero-notification-listener>
-        <entity-management
-          resourceName="ALL_USERS"
-          title="User Management"
-          updateEvent="EVENT_AMEND_USER"
-          deleteEvent="EVENT_DELETE_USER"
-          createEvent="EVENT_INSERT_USER"
-        ></entity-management>
-      </zero-notification-listener>
-    </zero-tab-panel>
-  </zero-tabs>
-`;
-```
-
-### Config
-
-The functionality of the Entity Manager is customised through the properties you set on it in the HTML. This section covers the main properties that you need to customise. For a full list of properties, [see here](./docs/api/foundation-entity-management.entitymanagement.md#properties).
-
-#### Title
-
-`title` customises the title of the entity list so that the user can see what resource they are managing.
-
-#### Resource
-
-`resourceName` refers to the name of a resource on the server. This could be:
-
-- a `query` in a Data Server
-- a `ReqRep` definition in a Request Server
-- an `eventHandler`in the Event Handler.
-
- In the [above example](#set-up), we use `ALL_COUNTERPARTYS`, which is a `query` in a Data Server; by convention, these queries all start with `ALL_`.
-
-#### Events
-
-`createEvent`, `updateEvent`, `deleteEvent` are set to be the events on the back end that handle the specific actions, such as deleting counterparty data. For the create and update functionality, these also define the resource in which the form is populated when the user is creating or updating an entity. After adding an event, a button is displayed so that the user can perform the selected action.
-
-#### Datasource configuration
+## License
 
-Set this object to configure how the Entity Manager interacts with the resource. [See here](./docs/api/foundation-entity-management.datasourceconfiguration/#example).
+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.
 
-#### Persist column state
-`persist-column-state-key` is a string value. It is used to control how the column states are persisted through actions such as page changes or refreshes. If no `persist-column-state-key` property is set, then the behaviour will be to _not_ persist the column state, and  the grid will revert back to its default state every time the user navigates away from it.
+### Licensed components
 
-:::warning
-The string defines the key in which the serialised state of the columns is stored in an object in [session storage](https://developer.mozilla.org/en-US/docs/Web/API/Window/sessionStorage). Therefore, if you are setting multiple Entity Managers in your application, you must use unique keys to persist the state - otherwise, you will get undefined behaviour.
-:::
+Genesis low-code platform

package/dist/custom-elements.json

@@ -2671,6 +2671,55 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/layouts/default.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "loginLayout",
+          "default": "new GenesisElementLayout(\n  html`\n    <div class=\"container\">\n      <div class=\"content\">\n        <slot></slot>\n      </div>\n    </div>\n  `,\n  baseLayoutCss,\n)"
+        },
+        {
+          "kind": "variable",
+          "name": "defaultLayout",
+          "default": "new GenesisElementLayout(\n  html`\n    <div class=\"container\">\n      <div class=\"content\">\n        <slot></slot>\n      </div>\n    </div>\n  `,\n  css`\n    ${baseLayoutCss}\n  `,\n)"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "loginLayout",
+          "declaration": {
+            "name": "loginLayout",
+            "module": "src/layouts/default.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "defaultLayout",
+          "declaration": {
+            "name": "defaultLayout",
+            "module": "src/layouts/default.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/layouts/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./default"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/list/index.ts",
@@ -3370,6 +3419,27 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/routes/config.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/routes/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./config"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/main/index.ts",
@@ -3514,76 +3584,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/layouts/default.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "loginLayout",
-          "default": "new GenesisElementLayout(\n  html`\n    <div class=\"container\">\n      <div class=\"content\">\n        <slot></slot>\n      </div>\n    </div>\n  `,\n  baseLayoutCss,\n)"
-        },
-        {
-          "kind": "variable",
-          "name": "defaultLayout",
-          "default": "new GenesisElementLayout(\n  html`\n    <div class=\"container\">\n      <div class=\"content\">\n        <slot></slot>\n      </div>\n    </div>\n  `,\n  css`\n    ${baseLayoutCss}\n  `,\n)"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "loginLayout",
-          "declaration": {
-            "name": "loginLayout",
-            "module": "src/layouts/default.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "defaultLayout",
-          "declaration": {
-            "name": "defaultLayout",
-            "module": "src/layouts/default.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/layouts/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./default"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/routes/config.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/routes/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./config"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/utils/custom-actions-utils.ts",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-entity-management",
   "description": "Genesis Foundation Entity Management",
-  "version": "14.408.0",
+  "version": "14.409.0",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -54,32 +54,32 @@
     }
   },
   "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",
+    "@genesislcap/genx": "14.409.0",
+    "@genesislcap/rollup-builder": "14.409.0",
+    "@genesislcap/ts-builder": "14.409.0",
+    "@genesislcap/uvu-playwright-builder": "14.409.0",
+    "@genesislcap/vite-builder": "14.409.0",
+    "@genesislcap/webpack-builder": "14.409.0"
   },
   "peerDependencies": {
     "@ag-grid-community/core": "29.2.0"
   },
   "dependencies": {
-    "@genesislcap/foundation-ai": "14.408.0",
-    "@genesislcap/foundation-comms": "14.408.0",
-    "@genesislcap/foundation-errors": "14.408.0",
-    "@genesislcap/foundation-events": "14.408.0",
-    "@genesislcap/foundation-forms": "14.408.0",
-    "@genesislcap/foundation-logger": "14.408.0",
-    "@genesislcap/foundation-login": "14.408.0",
-    "@genesislcap/foundation-notifications": "14.408.0",
-    "@genesislcap/foundation-ui": "14.408.0",
-    "@genesislcap/foundation-utils": "14.408.0",
-    "@genesislcap/foundation-zero": "14.408.0",
-    "@genesislcap/foundation-zero-grid-pro": "14.408.0",
-    "@genesislcap/grid-pro": "14.408.0",
-    "@genesislcap/web-core": "14.408.0",
+    "@genesislcap/foundation-ai": "14.409.0",
+    "@genesislcap/foundation-comms": "14.409.0",
+    "@genesislcap/foundation-errors": "14.409.0",
+    "@genesislcap/foundation-events": "14.409.0",
+    "@genesislcap/foundation-forms": "14.409.0",
+    "@genesislcap/foundation-logger": "14.409.0",
+    "@genesislcap/foundation-login": "14.409.0",
+    "@genesislcap/foundation-notifications": "14.409.0",
+    "@genesislcap/foundation-ui": "14.409.0",
+    "@genesislcap/foundation-utils": "14.409.0",
+    "@genesislcap/foundation-zero": "14.409.0",
+    "@genesislcap/foundation-zero-grid-pro": "14.409.0",
+    "@genesislcap/grid-pro": "14.409.0",
+    "@genesislcap/web-core": "14.409.0",
     "change-case": "^4.1.2"
   },
   "repository": {
@@ -91,5 +91,5 @@
     "access": "public"
   },
   "customElements": "dist/custom-elements.json",
-  "gitHead": "26b08831fd001b4ee95c8a0d3364a18c0ec4005b"
+  "gitHead": "cbe0459d170f27c35a7de18cec415947aedf4da5"
 }

package/docs/api/foundation-entity-management.actionsmenustyle.md

@@ -1,74 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-entity-management](./foundation-entity-management.md) &gt; [ActionsMenuStyle](./foundation-entity-management.actionsmenustyle.md)
-
-## ActionsMenuStyle enum
-
-**Signature:**
-
-```typescript
-export declare enum ActionsMenuStyle 
-```
-
-## Enumeration Members
-
-<table><thead><tr><th>
-
-Member
-
-
-</th><th>
-
-Value
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-ActionsHorizontal
-
-
-</td><td>
-
-`"actions-horizontal"`
-
-
-</td><td>
-
-
-</td></tr>
-<tr><td>
-
-ActionsVertical
-
-
-</td><td>
-
-`"actions-vertical"`
-
-
-</td><td>
-
-
-</td></tr>
-<tr><td>
-
-Default
-
-
-</td><td>
-
-`"default"`
-
-
-</td><td>
-
-
-</td></tr>
-</tbody></table>
-

package/docs/api/foundation-entity-management.additionalentry.md

@@ -1,22 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-entity-management](./foundation-entity-management.md) &gt; [AdditionalEntry](./foundation-entity-management.additionalentry.md)
-
-## AdditionalEntry type
-
-**Signature:**
-
-```typescript
-export type AdditionalEntry = string | UiSchema | {
-    type: 'Control';
-    scope: string;
-    label?: string;
-    options?: {
-        readonly?: boolean;
-        hidden?: boolean;
-        allOptionsResourceName?: string;
-        valueField?: string;
-        labelField?: string;
-    };
-};
-```

package/docs/api/foundation-entity-management.buttoncellrenderer.md

@@ -1,95 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-entity-management](./foundation-entity-management.md) &gt; [buttonCellRenderer](./foundation-entity-management.buttoncellrenderer.md)
-
-## buttonCellRenderer() function
-
-
-**Signature:**
-
-```typescript
-buttonCellRenderer: (title: any, clickHandler: any, contentTemplate: any, tooltip?: string) => ColDef
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-title
-
-
-</td><td>
-
-any
-
-
-</td><td>
-
-
-</td></tr>
-<tr><td>
-
-clickHandler
-
-
-</td><td>
-
-any
-
-
-</td><td>
-
-
-</td></tr>
-<tr><td>
-
-contentTemplate
-
-
-</td><td>
-
-any
-
-
-</td><td>
-
-
-</td></tr>
-<tr><td>
-
-tooltip
-
-
-</td><td>
-
-string
-
-
-</td><td>
-
-_(Optional)_
-
-
-</td></tr>
-</tbody></table>
-
-**Returns:**
-
-ColDef
-

package/docs/api/foundation-entity-management.confirmsubmit.md

@@ -1,71 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-entity-management](./foundation-entity-management.md) &gt; [ConfirmSubmit](./foundation-entity-management.confirmsubmit.md)
-
-## ConfirmSubmit interface
-
-**Signature:**
-
-```typescript
-export interface ConfirmSubmit 
-```
-
-## Properties
-
-<table><thead><tr><th>
-
-Property
-
-
-</th><th>
-
-Modifiers
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-[message](./foundation-entity-management.confirmsubmit.message.md)
-
-
-</td><td>
-
-
-</td><td>
-
-string
-
-
-</td><td>
-
-
-</td></tr>
-<tr><td>
-
-[state](./foundation-entity-management.confirmsubmit.state.md)
-
-
-</td><td>
-
-
-</td><td>
-
-'enabled' \| 'disabled'
-
-
-</td><td>
-
-
-</td></tr>
-</tbody></table>
-

package/docs/api/foundation-entity-management.confirmsubmit.message.md

@@ -1,11 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-entity-management](./foundation-entity-management.md) &gt; [ConfirmSubmit](./foundation-entity-management.confirmsubmit.md) &gt; [message](./foundation-entity-management.confirmsubmit.message.md)
-
-## ConfirmSubmit.message property
-
-**Signature:**
-
-```typescript
-message: string;
-```

package/docs/api/foundation-entity-management.confirmsubmit.state.md

@@ -1,11 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-entity-management](./foundation-entity-management.md) &gt; [ConfirmSubmit](./foundation-entity-management.confirmsubmit.md) &gt; [state](./foundation-entity-management.confirmsubmit.state.md)
-
-## ConfirmSubmit.state property
-
-**Signature:**
-
-```typescript
-state: 'enabled' | 'disabled';
-```