Merge pull request 'ci: use ci-workflows@v1 again' (#66) from ci/pin-v1 into develop

v1 now contains node.yaml publishing (ci-workflows 0e0f145).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

.circleci/config.yml

@@ -1,71 +0,0 @@
----
-
-version: 2.1
-
-orbs:
-  qqq-orb: kingsrook/qqq-orb@0.6
-
-workflows:
-
-  test_only:
-    jobs:
-      - qqq-orb/node_test_only:
-          context: [qqq-maven-registry-credentials, build-qqq-sample-app]
-          filters:
-            branches:
-              ignore: /(develop|main|release/.*|hotfix/.*|integration.*)/
-            tags:
-              only: []
-
-  publish_snapshot:
-    jobs:
-      - qqq-orb/node_publish:
-          context: [qqq-maven-registry-credentials, build-qqq-sample-app]
-          branch_type: snapshot
-          filters:
-            branches:
-              only:
-                - develop
-
-  publish_feature:
-    jobs:
-      - qqq-orb/node_publish:
-          context: [qqq-maven-registry-credentials, build-qqq-sample-app]
-          branch_type: feature
-          filters:
-            branches:
-              only:
-                - feature/.*
-            tags:
-              only: [/publish.*/]
-
-  publish_release_candidate:
-    jobs:
-      - qqq-orb/node_publish:
-          context: [qqq-maven-registry-credentials, build-qqq-sample-app]
-          branch_type: release_candidate
-          filters:
-            branches:
-              only:
-                - /release\/.*/
-
-  publish_release:
-    jobs:
-      - qqq-orb/node_publish:
-          context: [qqq-maven-registry-credentials, build-qqq-sample-app]
-          branch_type: release
-          filters:
-            branches:
-              only: [main]
-            tags:
-              only: [/v.*/]
-
-  publish_hotfix_release:
-    jobs:
-      - qqq-orb/node_publish:
-          context: [qqq-maven-registry-credentials, build-qqq-sample-app]
-          branch_type: hotfix
-          filters:
-            branches:
-              only:
-                - /hotfix\/.*/

.eslintignore

@@ -1,3 +1,4 @@
 node_modules
 lib
 coverage
+lib-cjs

.gitea/workflows/build.yaml

@@ -0,0 +1,17 @@
+name: build
+on:
+  push:
+jobs:
+  node:
+    # @main until the owner moves ci-workflows v1 onto the publishing node.yaml; then back to @v1.
+    uses: self:KofTwentyTwo/ci-workflows/.gitea/workflows/node.yaml@v1
+    secrets: inherit
+    with:
+      node-version: '24'
+      commands: |
+        npm run lint
+        npm test
+        npm run prepublishOnly
+      # A vX.Y.Z[-RC.N] tag equal to package.json publishes @qrunio/qqq-frontend-core to the
+      # QRun-IO Gitea npm registry (RC -> dist-tag next). Branches only verify.
+      publish: true

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @KofTwentyTwo

.github/CONTRIBUTING.md

@@ -157,7 +157,7 @@ When reporting frontend-specific issues, include:
 
 ## 📄 License
 
-By contributing to this project, you agree that your contributions will be licensed under the same license as the project (GNU Affero General Public License v3.0).
+By contributing to this project, you agree that your contributions will be licensed under the same license as the project (Apache License, Version 2.0).
 
 ## 🙏 Thank You
 

.gitignore

@@ -17,3 +17,4 @@ lib
 # Claude Code local settings
 .claude/
 
+lib-cjs

.idea/copyright/Kingsrook_Copyright_Profile.xml

@@ -1,6 +1,6 @@
 <component name="CopyrightManager">
   <copyright>
-    <option name="notice" value="Copyright (c) &amp;#36;originalComment.match(&quot;Copyright \(c\) (\d+)&quot;, 1, &quot;-&quot;)&amp;#36;today.year. Kingsrook LLC &lt;contact@kingsrook.com&gt;.  All Rights Reserved.  " />
+    <option name="notice" value="Copyright (c) &amp;#36;originalComment.match(&quot;Copyright \(c\) (\d+)&quot;, 1, &quot;-&quot;)&amp;#36;today.year. Kingsrook LLC &lt;contact@kingsrook.com&gt;.  &#10;&#10;Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);&#10;you may not use this file except in compliance with the License.&#10;You may obtain a copy of the License at&#10;&#10;    https://www.apache.org/licenses/LICENSE-2.0&#10;&#10;Unless required by applicable law or agreed to in writing, software&#10;distributed under the License is distributed on an &quot;AS IS&quot; BASIS,&#10;WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.&#10;See the License for the specific language governing permissions and&#10;limitations under the License." />
     <option name="myName" value="Kingsrook Copyright Profile" />
   </copyright>
 </component>

.npmrc

@@ -1,4 +0,0 @@
-# Public NPM Registry Configuration
-# All packages published to npmjs.org under @qrunio organization
-registry=https://registry.npmjs.org/
-@qrunio:registry=https://registry.npmjs.org/

CLAUDE.md

@@ -68,3 +68,18 @@ Main metaData container. Contains:
 ## Session Continuity
 Session state is stored in `.session-state.md` (local to this repo).
 To continue: say "continue from last session"
+
+## Knowledge base
+
+Durable knowledge about this repo lives in the second-brain vault
+(`$SECOND_BRAIN_VAULT`, i.e. `R:/Git.Local/KofTwentyTwo/second-brain`):
+
+- QQQ domain hub: `knowledge/qqq/qqq-hub.md`
+- This repo's dossier: `knowledge/qqq/repos/qqq-frontend-core.md`
+  (endpoint map legacy vs `/qqq/v1`, npm version history, division of labor
+  vs material-dashboard, known bugs/risks)
+
+Dossier reviewed at commit `e234e3028c8d` (branch `develop`,
+0.40.13-SNAPSHOT, 2026-07-04). Consult the dossier before re-deriving
+architecture from source; update it when controllers, endpoints, or
+publishing change.

README.md

@@ -35,6 +35,17 @@ If you want a ready-to-use admin UI, use [qqq-frontend-material-dashboard](https
 npm install @qrunio/qqq-frontend-core
 ```
 
+Releases are published to the QRun-IO Gitea npm registry (release candidates under the `next`
+dist-tag). Point the scope there in `.npmrc`:
+
+```ini
+@qrunio:registry=https://git.kof22.com/api/packages/QRun-IO/npm/
+//git.kof22.com/api/packages/QRun-IO/npm/:_authToken=${GITEA_TOKEN}
+```
+
+To release: set the version (`npm version 0.41.0-RC.1 --no-git-tag-version`), merge, and tag the
+merge commit `v<version>`; CI verifies the tag equals `package.json`, runs the checks and publishes.
+
 ```typescript
 import { QController } from '@qrunio/qqq-frontend-core';
 
@@ -152,4 +163,4 @@ Submit issues and PRs to the [main QQQ repository](https://github.com/QRun-IO/qq
 
 ## License
 
-AGPL-3.0
+Apache-2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE).

docs/npm-publishing.md

@@ -0,0 +1,19 @@
+# npm publishing
+
+CircleCI publishes `@qrunio/qqq-frontend-core` with npm Trusted Publishing through the shared `frontend-core` profile in `.qqq-ci.yml`. The canonical caller tracks `kingsrook/qqq-orb@0.8` and uses `cimg/node:24.21`. Publishing logic lives in the orb, not in a repository-specific workflow. In the package Settings on npmjs.com, add a **CircleCI** trusted publisher with the values below and explicitly allow **npm publish** (the staged-only default does not run this pipeline).
+
+Develop snapshots use build-specific versions such as `0.40.28-SNAPSHOT.1234`
+and the npm `snapshot` dist-tag. The version is calculated in the publishing
+workspace; the job does not push a version-only `[skip ci]` commit back to
+`develop`. Required checks therefore stay attached to the source head being
+published. See [version management](version-management.md) and the
+[shared orb policy](https://github.com/QRun-IO/qqq-orb/blob/main/docs/GENERATED-PIPELINES.md#node-snapshot-versions).
+
+| npm field | Value |
+| --- | --- |
+| Organization ID | `bb329fea-03cd-4fb5-b530-15e85703598d` |
+| Project ID | `5bd1e544-282a-4080-afc1-36ffdebf5487` |
+| Pipeline definition ID | `3bd87740-26e6-5f18-8600-10685a13a81e` |
+| VCS origin | `github.com/QRun-IO/qqq-frontend-core` |
+
+These are public identifiers, not credentials. The job obtains a short-lived npm-audience OIDC identity only for publication, so no new `NPM_TOKEN` is needed. Do not use `npm whoami` or a publish dry run as proof: verify the real immutable version at npm and install it in a clean consumer. Once that succeeds, remove obsolete token access only after checking its other consumers. CircleCI Trusted Publishing currently does not attach npm provenance attestations. See [npm documentation](https://docs.npmjs.com/trusted-publishers/).

docs/version-management.md

@@ -1,42 +1,46 @@
-# Version Management
-
-## Current Versions (as of 2026-01-12)
-
-| Package | Version | Registry |
-|---------|---------|----------|
-| `@qrunio/qqq-frontend-core` | 0.40.1-SNAPSHOT | npm |
-| `qqq-frontend-material-dashboard` | 0.40.1-SNAPSHOT | Maven Central |
-| `qqq` (backend) | 0.40.0-SNAPSHOT | Maven Central |
-
-## Frontend vs Backend Versioning
-
-Frontend repos can version independently from the backend. In `qqq-frontend-material-dashboard`:
-
-```xml
-<properties>
-  <revision>0.40.1-SNAPSHOT</revision>      <!-- This artifact's version -->
-  <qqq.version>0.40.0-SNAPSHOT</qqq.version> <!-- Backend dependency version -->
-</properties>
-```
-
-This allows frontend-only releases without requiring a full backend release.
-
-## Version Bump Process
-
-### qqq-frontend-core (npm)
-1. Update `version` in `package.json`
-2. Push to develop branch
-3. CI automatically publishes to npm
-
-### qqq-frontend-material-dashboard (Maven)
-1. Update `revision` property in `pom.xml`
-2. Optionally update `qqq.version` if backend changes needed
-3. Push to develop branch
-4. CI runs Playwright tests + publishes to Maven Central
-
-## CI/CD Orb Behavior
-
-The `kingsrook/qqq-orb` `calculate_version.sh` script:
-- For develop branch with existing SNAPSHOT: keeps current version
-- Only bumps version on release merges or RC versions
-- Each repo manages its own version independently
+# Version Management
+
+## Historical Versions (2026-01-12)
+
+| Package | Version | Registry |
+|---------|---------|----------|
+| `@qrunio/qqq-frontend-core` | 0.40.1-SNAPSHOT | npm |
+| `qqq-frontend-material-dashboard` | 0.40.1-SNAPSHOT | Maven Central |
+| `qqq` (backend) | 0.40.0-SNAPSHOT | Maven Central |
+
+## Frontend vs Backend Versioning
+
+Frontend repos can version independently from the backend. In `qqq-frontend-material-dashboard`:
+
+```xml
+<properties>
+  <revision>0.40.1-SNAPSHOT</revision>      <!-- This artifact's version -->
+  <qqq.version>0.40.0-SNAPSHOT</qqq.version> <!-- Backend dependency version -->
+</properties>
+```
+
+This allows frontend-only releases without requiring a full backend release.
+
+## Version Bump Process
+
+### qqq-frontend-core (npm)
+1. Merge a verified source change to `develop` through the shared required checks.
+2. The orb calculates `MAJOR.MINOR.NEXT_PATCH-SNAPSHOT.CIRCLE_BUILD_NUM` from the source package version and the unique CircleCI job number. For example, source `0.40.27-SNAPSHOT` in job 1234 publishes `0.40.28-SNAPSHOT.1234`.
+3. CI builds and publishes that immutable npm version under the `snapshot` dist-tag. It keeps the source branch unchanged; no snapshot version commit or manual per-build version bump is needed.
+4. Verify the published version and install it in a clean consumer before claiming publication success. CI-only declaration updates may run verification without publishing.
+
+Stable, RC and hotfix publication keep their existing shared orb policies. A
+snapshot publication is not a stable release.
+
+### qqq-frontend-material-dashboard (Maven)
+1. Update `revision` property in `pom.xml`
+2. Optionally update `qqq.version` if backend changes needed
+3. Push to develop branch
+4. CI runs Playwright tests + publishes to Maven Central
+
+## CI/CD Orb Behavior
+
+For Maven projects, the shared orb's `calculate_version.sh` script:
+- For develop branch with existing SNAPSHOT: keeps current version
+- Only bumps version on release merges or RC versions
+- Each repo manages its own version independently

package-lock.json

@@ -1,16 +1,16 @@
 {
    "name": "@qrunio/qqq-frontend-core",
-   "version": "0.40.0-SNAPSHOT",
+   "version": "0.40.27-RC.1",
    "lockfileVersion": 3,
    "requires": true,
    "packages": {
       "": {
          "name": "@qrunio/qqq-frontend-core",
-         "version": "0.40.0-SNAPSHOT",
-         "license": "ISC",
+         "version": "0.40.27-RC.1",
+         "license": "Apache-2.0",
          "dependencies": {
-            "axios": "0.28.1",
-            "form-data": "4.0.0"
+            "axios": "0.34.0",
+            "form-data": "4.0.6"
          },
          "devDependencies": {
             "@types/jest": "^27.0.2",
@@ -29,28 +29,14 @@
             "typescript": "^4.4.4"
          }
       },
-      "node_modules/@ampproject/remapping": {
-         "version": "2.3.0",
-         "resolved": "https://registry.npmjs.org/@ampproject/remapping/-/remapping-2.3.0.tgz",
-         "integrity": "sha512-30iZtAPgz+LTIYoeivqYo853f02jBYSd5uGnGpkFV0M3xOt9aN73erkgYAmZU43x4VfqcnLxW9Kpg3R5LC4YYw==",
-         "dev": true,
-         "license": "Apache-2.0",
-         "dependencies": {
-            "@jridgewell/gen-mapping": "^0.3.5",
-            "@jridgewell/trace-mapping": "^0.3.24"
-         },
-         "engines": {
-            "node": ">=6.0.0"
-         }
-      },
       "node_modules/@babel/code-frame": {
-         "version": "7.27.1",
-         "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.27.1.tgz",
-         "integrity": "sha512-cjQ7ZlQ0Mv3b47hABuTevyTuYN4i+loJKGeV9flcCgIK37cCXRh+L1bd3iBHlynerhQ7BhCkn2BPbQUL+rGqFg==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.7.tgz",
+         "integrity": "sha512-Aup7aUOfpbAUg2ROOJN6Iw5f9DMBlzu0mIkm/malLQFN/YQgO48wCj0Kxa3sEHJvPVFg7siR+qRInwXd2qhQKw==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@babel/helper-validator-identifier": "^7.27.1",
+            "@babel/helper-validator-identifier": "^7.29.7",
             "js-tokens": "^4.0.0",
             "picocolors": "^1.1.1"
          },
@@ -59,9 +45,9 @@
          }
       },
       "node_modules/@babel/compat-data": {
-         "version": "7.28.0",
-         "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.28.0.tgz",
-         "integrity": "sha512-60X7qkglvrap8mn1lh2ebxXdZYtUcpd7gsmy9kLaBJ4i/WdY8PqTSdxyA8qraikqKQK5C1KRBKXqznrVapyNaw==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.29.7.tgz",
+         "integrity": "sha512-locTkQyKvwIEgBzVrn8693ebc97F2U8ZHjbXwDXJ5Fn2TCpNwTlKcaKLkdHop5c/icOFE7qt7Q9JC5hnKNa6Gg==",
          "dev": true,
          "license": "MIT",
          "engines": {
@@ -69,23 +55,22 @@
          }
       },
       "node_modules/@babel/core": {
-         "version": "7.28.3",
-         "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.28.3.tgz",
-         "integrity": "sha512-yDBHV9kQNcr2/sUr9jghVyz9C3Y5G2zUM2H2lo+9mKv4sFgbA8s8Z9t8D1jiTkGoO/NoIfKMyKWr4s6CN23ZwQ==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.29.7.tgz",
+         "integrity": "sha512-RgHBCvtjbOK2gXSNBNIkNoEc9qoVEtau3hj8gEqKQuL3HZAibKarWFEI3Lfm6EYKkLalOh8eSrj9b+ch9H/VBA==",
          "dev": true,
          "license": "MIT",
-         "peer": true,
          "dependencies": {
-            "@ampproject/remapping": "^2.2.0",
-            "@babel/code-frame": "^7.27.1",
-            "@babel/generator": "^7.28.3",
-            "@babel/helper-compilation-targets": "^7.27.2",
-            "@babel/helper-module-transforms": "^7.28.3",
-            "@babel/helpers": "^7.28.3",
-            "@babel/parser": "^7.28.3",
-            "@babel/template": "^7.27.2",
-            "@babel/traverse": "^7.28.3",
-            "@babel/types": "^7.28.2",
+            "@babel/code-frame": "^7.29.7",
+            "@babel/generator": "^7.29.7",
+            "@babel/helper-compilation-targets": "^7.29.7",
+            "@babel/helper-module-transforms": "^7.29.7",
+            "@babel/helpers": "^7.29.7",
+            "@babel/parser": "^7.29.7",
+            "@babel/template": "^7.29.7",
+            "@babel/traverse": "^7.29.7",
+            "@babel/types": "^7.29.7",
+            "@jridgewell/remapping": "^2.3.5",
             "convert-source-map": "^2.0.0",
             "debug": "^4.1.0",
             "gensync": "^1.0.0-beta.2",
@@ -118,14 +103,14 @@
          }
       },
       "node_modules/@babel/generator": {
-         "version": "7.28.3",
-         "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.28.3.tgz",
-         "integrity": "sha512-3lSpxGgvnmZznmBkCRnVREPUFJv2wrv9iAoFDvADJc0ypmdOxdUtcLeBgBJ6zE0PMeTKnxeQzyk0xTBq4Ep7zw==",
+         "version": "7.29.8",
+         "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.29.8.tgz",
+         "integrity": "sha512-gZbepsdh3WDtgZKWL+vTPh71LSBrm/Y4/QDZBVCcYfmeTEEuoOYwlSy+G1StfJg+/Zy550u/3TATbm7qDbbMtg==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@babel/parser": "^7.28.3",
-            "@babel/types": "^7.28.2",
+            "@babel/parser": "^7.29.8",
+            "@babel/types": "^7.29.8",
             "@jridgewell/gen-mapping": "^0.3.12",
             "@jridgewell/trace-mapping": "^0.3.28",
             "jsesc": "^3.0.2"
@@ -135,14 +120,14 @@
          }
       },
       "node_modules/@babel/helper-compilation-targets": {
-         "version": "7.27.2",
-         "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.27.2.tgz",
-         "integrity": "sha512-2+1thGUUWWjLTYTHZWK1n8Yga0ijBz1XAhUXcKy81rd5g6yh7hGqMp45v7cadSbEHc9G3OTv45SyneRN3ps4DQ==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.29.7.tgz",
+         "integrity": "sha512-wem6WaBj4NaVYVdNhLPPVacES6ZJ+KBBfSkTMD3YZxbP3rm3Di85tJU5ljaUNhaOynt+Aj0xruhYuzQBt8n71g==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@babel/compat-data": "^7.27.2",
-            "@babel/helper-validator-option": "^7.27.1",
+            "@babel/compat-data": "^7.29.7",
+            "@babel/helper-validator-option": "^7.29.7",
             "browserslist": "^4.24.0",
             "lru-cache": "^5.1.1",
             "semver": "^6.3.1"
@@ -162,9 +147,9 @@
          }
       },
       "node_modules/@babel/helper-globals": {
-         "version": "7.28.0",
-         "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.28.0.tgz",
-         "integrity": "sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.29.7.tgz",
+         "integrity": "sha512-3nQVUAtvkKH9zahfWgw96Jc/uFOmjACE1kQz82E2lqWmHBgjzbNlsC22nuQTfahmWeQtTq5nQ/4Nnd2A1wj4zA==",
          "dev": true,
          "license": "MIT",
          "engines": {
@@ -172,29 +157,29 @@
          }
       },
       "node_modules/@babel/helper-module-imports": {
-         "version": "7.27.1",
-         "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.27.1.tgz",
-         "integrity": "sha512-0gSFWUPNXNopqtIPQvlD5WgXYI5GY2kP2cCvoT8kczjbfcfuIljTbcWrulD1CIPIX2gt1wghbDy08yE1p+/r3w==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.29.7.tgz",
+         "integrity": "sha512-ejHwrQQYcm9xnTivShn2IDOlIzInN34AXskvq9QicvCtEzq1Vzclu/tKF8Jq1Cg8JG2GL6/EmjgsCT7lXepE3g==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@babel/traverse": "^7.27.1",
-            "@babel/types": "^7.27.1"
+            "@babel/traverse": "^7.29.7",
+            "@babel/types": "^7.29.7"
          },
          "engines": {
             "node": ">=6.9.0"
          }
       },
       "node_modules/@babel/helper-module-transforms": {
-         "version": "7.28.3",
-         "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.28.3.tgz",
-         "integrity": "sha512-gytXUbs8k2sXS9PnQptz5o0QnpLL51SwASIORY6XaBKF88nsOT0Zw9szLqlSGQDP/4TljBAD5y98p2U1fqkdsw==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.29.7.tgz",
+         "integrity": "sha512-UPUVSyXbOh627KiCIGQSgwWzGeBKLkaJ9PJEdrngIwMSzxLR4jS4+f1f1jb7VzBbg8nFLaYotvVPFCTqdrmTAg==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@babel/helper-module-imports": "^7.27.1",
-            "@babel/helper-validator-identifier": "^7.27.1",
-            "@babel/traverse": "^7.28.3"
+            "@babel/helper-module-imports": "^7.29.7",
+            "@babel/helper-validator-identifier": "^7.29.7",
+            "@babel/traverse": "^7.29.7"
          },
          "engines": {
             "node": ">=6.9.0"
@@ -214,9 +199,9 @@
          }
       },
       "node_modules/@babel/helper-string-parser": {
-         "version": "7.27.1",
-         "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz",
-         "integrity": "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.29.7.tgz",
+         "integrity": "sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==",
          "dev": true,
          "license": "MIT",
          "engines": {
@@ -224,9 +209,9 @@
          }
       },
       "node_modules/@babel/helper-validator-identifier": {
-         "version": "7.27.1",
-         "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.27.1.tgz",
-         "integrity": "sha512-D2hP9eA+Sqx1kBZgzxZh0y1trbuU+JoDkiEwqhQ36nodYqJwyEIhPSdMNd7lOm/4io72luTPWH20Yda0xOuUow==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz",
+         "integrity": "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==",
          "dev": true,
          "license": "MIT",
          "engines": {
@@ -234,9 +219,9 @@
          }
       },
       "node_modules/@babel/helper-validator-option": {
-         "version": "7.27.1",
-         "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.27.1.tgz",
-         "integrity": "sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.29.7.tgz",
+         "integrity": "sha512-N9ZErrD+yW5geCDtBqnOoxmR8+tNKiGuxKlDpuJxfsqpa2dFcexaziGAE/qoHLiDDreVNMupxGmSoNlyvsA3gw==",
          "dev": true,
          "license": "MIT",
          "engines": {
@@ -244,27 +229,27 @@
          }
       },
       "node_modules/@babel/helpers": {
-         "version": "7.28.3",
-         "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.28.3.tgz",
-         "integrity": "sha512-PTNtvUQihsAsDHMOP5pfobP8C6CM4JWXmP8DrEIt46c3r2bf87Ua1zoqevsMo9g+tWDwgWrFP5EIxuBx5RudAw==",
+         "version": "7.29.10",
+         "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.29.10.tgz",
+         "integrity": "sha512-EMCx3AGZ3WfAl6ht7AyQoPm2Lh+BGYEMdc4Q6Hf7uSCDOZFuLq44qNwL+iaim8VlyYhRAo4X43+weadK8ZB4Yg==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@babel/template": "^7.27.2",
-            "@babel/types": "^7.28.2"
+            "@babel/template": "^7.29.7",
+            "@babel/types": "^7.29.8"
          },
          "engines": {
             "node": ">=6.9.0"
          }
       },
       "node_modules/@babel/parser": {
-         "version": "7.28.3",
-         "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.28.3.tgz",
-         "integrity": "sha512-7+Ey1mAgYqFAx2h0RuoxcQT5+MlG3GTV0TQrgr7/ZliKsm/MNDxVVutlWaziMq7wJNAz8MTqz55XLpWvva6StA==",
+         "version": "7.29.9",
+         "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.9.tgz",
+         "integrity": "sha512-CjXrNHTnvqBVqHgdBysY3vk2T8tpJHb5/RMeHJBTyVa9xgugCB0CJTx/3oO8RV2QRQP391RWpB7D6hLjm8V9uA==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@babel/types": "^7.28.2"
+            "@babel/types": "^7.29.8"
          },
          "bin": {
             "parser": "bin/babel-parser.js"
@@ -520,33 +505,33 @@
          }
       },
       "node_modules/@babel/template": {
-         "version": "7.27.2",
-         "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.27.2.tgz",
-         "integrity": "sha512-LPDZ85aEJyYSd18/DkjNh4/y1ntkE5KwUHWTiqgRxruuZL2F1yuHligVHLvcHY2vMHXttKFpJn6LwfI7cw7ODw==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.29.7.tgz",
+         "integrity": "sha512-puq+Gf35oI24FeN11LkoUQFqv9uwNeWpxXZi/Ji3rRIoKAzKnxRaZ+Gkj0vKS9ZCiTESfng1N9LyOyXvo+m+Gg==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@babel/code-frame": "^7.27.1",
-            "@babel/parser": "^7.27.2",
-            "@babel/types": "^7.27.1"
+            "@babel/code-frame": "^7.29.7",
+            "@babel/parser": "^7.29.7",
+            "@babel/types": "^7.29.7"
          },
          "engines": {
             "node": ">=6.9.0"
          }
       },
       "node_modules/@babel/traverse": {
-         "version": "7.28.3",
-         "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.28.3.tgz",
-         "integrity": "sha512-7w4kZYHneL3A6NP2nxzHvT3HCZ7puDZZjFMqDpBPECub79sTtSO5CGXDkKrTQq8ksAwfD/XI2MRFX23njdDaIQ==",
+         "version": "7.29.10",
+         "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.29.10.tgz",
+         "integrity": "sha512-B3lYAs2nkKskbgQ1nfy8Ma9ao9Q1rntTAQHrzzyDuj+TSO+X3le6PfWwqDvodsb+OumE10eMFfuMCTQSQ5iuIQ==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@babel/code-frame": "^7.27.1",
-            "@babel/generator": "^7.28.3",
-            "@babel/helper-globals": "^7.28.0",
-            "@babel/parser": "^7.28.3",
-            "@babel/template": "^7.27.2",
-            "@babel/types": "^7.28.2",
+            "@babel/code-frame": "^7.29.7",
+            "@babel/generator": "^7.29.8",
+            "@babel/helper-globals": "^7.29.7",
+            "@babel/parser": "^7.29.9",
+            "@babel/template": "^7.29.7",
+            "@babel/types": "^7.29.8",
             "debug": "^4.3.1"
          },
          "engines": {
@@ -554,14 +539,14 @@
          }
       },
       "node_modules/@babel/types": {
-         "version": "7.28.2",
-         "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.28.2.tgz",
-         "integrity": "sha512-ruv7Ae4J5dUYULmeXw1gmb7rYRz57OWCPM57pHojnLq/3Z1CK2lNSLTCVjxVk1F/TZHwOZZrOWi0ur95BbLxNQ==",
+         "version": "7.29.8",
+         "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.8.tgz",
+         "integrity": "sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@babel/helper-string-parser": "^7.27.1",
-            "@babel/helper-validator-identifier": "^7.27.1"
+            "@babel/helper-string-parser": "^7.29.7",
+            "@babel/helper-validator-identifier": "^7.29.7"
          },
          "engines": {
             "node": ">=6.9.0"
@@ -650,9 +635,9 @@
          }
       },
       "node_modules/@istanbuljs/load-nyc-config/node_modules/js-yaml": {
-         "version": "3.14.1",
-         "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.1.tgz",
-         "integrity": "sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==",
+         "version": "3.15.2",
+         "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.15.2.tgz",
+         "integrity": "sha512-6EuL879VkRA+1Cz578mKMiKvjPNEuk6+r1JaFzoSWejZmtf7xWbIyw1e3KkxlkzTIt9Taw6JBhEppG7utc1P+w==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
@@ -945,6 +930,17 @@
             "@jridgewell/trace-mapping": "^0.3.24"
          }
       },
+      "node_modules/@jridgewell/remapping": {
+         "version": "2.3.5",
+         "resolved": "https://registry.npmjs.org/@jridgewell/remapping/-/remapping-2.3.5.tgz",
+         "integrity": "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==",
+         "dev": true,
+         "license": "MIT",
+         "dependencies": {
+            "@jridgewell/gen-mapping": "^0.3.5",
+            "@jridgewell/trace-mapping": "^0.3.24"
+         }
+      },
       "node_modules/@jridgewell/resolve-uri": {
          "version": "3.1.2",
          "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz",
@@ -1129,7 +1125,6 @@
          "integrity": "sha512-mpT8LJJ4CMeeahobofYWIjFo0xonRS/HfxnVEPMPFSQdGUt1uHCnoPT7Zhb+sjDU2wz0oKV0OLUR0WzrHNgfeA==",
          "dev": true,
          "license": "MIT",
-         "peer": true,
          "dependencies": {
             "jest-matcher-utils": "^27.0.0",
             "pretty-format": "^27.0.0"
@@ -1230,7 +1225,6 @@
          "integrity": "sha512-JaNYGkaQVhP6HNF+lkdOr2cAs2wdSZBoalE22uYWq8IEv/OVH0RksSGydk+sW8cLoSeYmC+OHvRyv2i4AQ7Czg==",
          "dev": true,
          "license": "BSD-2-Clause",
-         "peer": true,
          "dependencies": {
             "@typescript-eslint/scope-manager": "5.10.2",
             "@typescript-eslint/types": "5.10.2",
@@ -1397,7 +1391,6 @@
          "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==",
          "dev": true,
          "license": "MIT",
-         "peer": true,
          "bin": {
             "acorn": "bin/acorn"
          },
@@ -1729,13 +1722,13 @@
          }
       },
       "node_modules/axios": {
-         "version": "0.28.1",
-         "resolved": "https://registry.npmjs.org/axios/-/axios-0.28.1.tgz",
-         "integrity": "sha512-iUcGA5a7p0mVb4Gm/sy+FSECNkPFT4y7wt6OM/CDpO/OnNCvSs3PoMG8ibrC9jRoGYU0gUK5pXVC4NPXq6lHRQ==",
+         "version": "0.34.0",
+         "resolved": "https://registry.npmjs.org/axios/-/axios-0.34.0.tgz",
+         "integrity": "sha512-CkOmqy7BaT4VC9+wRUmSM3LVwCkKK3UYc7koEqIHWRpOTJypwdNctaVOgnOjhHP3599Ubq2K8KqYwfC7c8NdPQ==",
          "license": "MIT",
          "dependencies": {
-            "follow-redirects": "^1.15.0",
-            "form-data": "^4.0.0",
+            "follow-redirects": "^1.15.4",
+            "form-data": "^4.0.4",
             "proxy-from-env": "^1.1.0"
          }
       },
@@ -1853,10 +1846,23 @@
          "dev": true,
          "license": "MIT"
       },
+      "node_modules/baseline-browser-mapping": {
+         "version": "2.11.28",
+         "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.11.28.tgz",
+         "integrity": "sha512-br0LOmjJqr6Rt4AEkadbcNf67Zpo7EPwKsWbjnRrJIa1QYFHQBqM4C7F2WTbV8ahTEcg1Eo+Y0aWjjORInYFyA==",
+         "dev": true,
+         "license": "Apache-2.0",
+         "bin": {
+            "baseline-browser-mapping": "dist/cli.cjs"
+         },
+         "engines": {
+            "node": ">=6.0.0"
+         }
+      },
       "node_modules/brace-expansion": {
-         "version": "1.1.12",
-         "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz",
-         "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==",
+         "version": "1.1.21",
+         "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.21.tgz",
+         "integrity": "sha512-9zeA+KLZNNzglF2TPKRQEDyx6Yby7daAkuy8MiPzpXPsYDWi/DRM8jmwUDxokQjYqBpv5DgPiwD4h4ZZSy1Ujw==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
@@ -1885,9 +1891,9 @@
          "license": "BSD-2-Clause"
       },
       "node_modules/browserslist": {
-         "version": "4.25.3",
-         "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.25.3.tgz",
-         "integrity": "sha512-cDGv1kkDI4/0e5yON9yM5G/0A5u8sf5TnmdX5C9qHzI9PPu++sQ9zjm1k9NiOrf3riY4OkK0zSGqfvJyJsgCBQ==",
+         "version": "4.29.3",
+         "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.29.3.tgz",
+         "integrity": "sha512-1R4kiYKXGViqEN0CnoDrXc1StD9niAwu+j2dukWzrD4bJgsD4lDmEp0CRbc6E/vYJIfTHwPmwyaKtVSudICdPA==",
          "dev": true,
          "funding": [
             {
@@ -1904,12 +1910,12 @@
             }
          ],
          "license": "MIT",
-         "peer": true,
          "dependencies": {
-            "caniuse-lite": "^1.0.30001735",
-            "electron-to-chromium": "^1.5.204",
-            "node-releases": "^2.0.19",
-            "update-browserslist-db": "^1.1.3"
+            "baseline-browser-mapping": "^2.11.26",
+            "caniuse-lite": "^1.0.30001813",
+            "electron-to-chromium": "^1.5.439",
+            "node-releases": "^2.0.57",
+            "update-browserslist-db": "^1.3.3"
          },
          "bin": {
             "browserslist": "cli.js"
@@ -1971,7 +1977,6 @@
          "version": "1.0.2",
          "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
          "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
-         "dev": true,
          "license": "MIT",
          "dependencies": {
             "es-errors": "^1.3.0",
@@ -2019,9 +2024,9 @@
          }
       },
       "node_modules/caniuse-lite": {
-         "version": "1.0.30001737",
-         "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001737.tgz",
-         "integrity": "sha512-BiloLiXtQNrY5UyF0+1nSJLXUENuhka2pzy2Fx5pGxqavdrxSCW4U6Pn/PoG3Efspi2frRbHpBV2XsrPE6EDlw==",
+         "version": "1.0.30001816",
+         "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001816.tgz",
+         "integrity": "sha512-+8Yx7BXCoqk6IF8yTicjfUR6D/ldJzdlsodlEOiOSPmhK844WIgk67/zIQaGAOxNkZyyvBlrRFnLvqKIoqbAFw==",
          "dev": true,
          "funding": [
             {
@@ -2470,7 +2475,6 @@
          "version": "1.0.1",
          "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
          "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
-         "dev": true,
          "license": "MIT",
          "dependencies": {
             "call-bind-apply-helpers": "^1.0.1",
@@ -2482,9 +2486,9 @@
          }
       },
       "node_modules/electron-to-chromium": {
-         "version": "1.5.211",
-         "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.211.tgz",
-         "integrity": "sha512-IGBvimJkotaLzFnwIVgW9/UD/AOJ2tByUmeOrtqBfACSbAw5b1G0XpvdaieKyc7ULmbwXVx+4e4Be8pOPBrYkw==",
+         "version": "1.5.456",
+         "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.456.tgz",
+         "integrity": "sha512-8hboqI6xesozteFb8aa7OGknvxUtTeRJLz0FoePysUEh/oWbddykIGdgpEJRbPRg/nIMfBf2DFos+H2MtvJl2A==",
          "dev": true,
          "license": "ISC"
       },
@@ -2591,7 +2595,6 @@
          "version": "1.0.1",
          "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
          "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
-         "dev": true,
          "license": "MIT",
          "engines": {
             "node": ">= 0.4"
@@ -2601,7 +2604,6 @@
          "version": "1.3.0",
          "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
          "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
-         "dev": true,
          "license": "MIT",
          "engines": {
             "node": ">= 0.4"
@@ -2611,7 +2613,6 @@
          "version": "1.1.1",
          "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
          "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
-         "dev": true,
          "license": "MIT",
          "dependencies": {
             "es-errors": "^1.3.0"
@@ -2624,7 +2625,6 @@
          "version": "2.1.0",
          "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz",
          "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==",
-         "dev": true,
          "license": "MIT",
          "dependencies": {
             "es-errors": "^1.3.0",
@@ -2719,7 +2719,6 @@
          "deprecated": "This version is no longer supported. Please see https://eslint.org/version-support for other options.",
          "dev": true,
          "license": "MIT",
-         "peer": true,
          "dependencies": {
             "@eslint/eslintrc": "^1.0.5",
             "@humanwhocodes/config-array": "^0.9.2",
@@ -2896,7 +2895,6 @@
          "integrity": "sha512-/KJBASVFxpu0xg1kIBn9AUa8hQVnszpwgE7Ld0lKAlx7Ie87yzEzCgSkekt+le/YVhiaosO4Y14GDAOc41nfxA==",
          "dev": true,
          "license": "MIT",
-         "peer": true,
          "dependencies": {
             "array-includes": "^3.1.4",
             "array.prototype.flat": "^1.2.5",
@@ -2955,7 +2953,6 @@
          "integrity": "sha512-sVCFKX9fllURnXT2JwLN5Qgo24Ug5NF6dxhkmxsMEUZhXRcGg+X3e1JbJ84YePQKBl5E0ZjAH5Q4rkdcGY99+g==",
          "dev": true,
          "license": "MIT",
-         "peer": true,
          "dependencies": {
             "@babel/runtime": "^7.16.3",
             "aria-query": "^4.2.2",
@@ -2983,7 +2980,6 @@
          "integrity": "sha512-IOlFIRHzWfEQQKcAD4iyYDndHwTQiCMcJVJjxempf203jnNLUnW34AXLrV33+nEXoifJE2ZEGmcjKPL8957eSw==",
          "dev": true,
          "license": "MIT",
-         "peer": true,
          "dependencies": {
             "array-includes": "^3.1.4",
             "array.prototype.flatmap": "^1.2.5",
@@ -3013,7 +3009,6 @@
          "integrity": "sha512-XslZy0LnMn+84NEG9jSGR6eGqaZB3133L8xewQo3fQagbQuGt7a63gf+P1NGKZavEYEC3UXaWEAA/AqDkuN6xA==",
          "dev": true,
          "license": "MIT",
-         "peer": true,
          "engines": {
             "node": ">=10"
          },
@@ -3399,16 +3394,16 @@
          }
       },
       "node_modules/flatted": {
-         "version": "3.3.3",
-         "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.3.3.tgz",
-         "integrity": "sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==",
+         "version": "3.4.4",
+         "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.4.4.tgz",
+         "integrity": "sha512-5+ybhBZANEJxaH3X5evAFatUxLfEHSr7n6kYJ+1Qd0mUqr4eu9gIf6GDbWHf8RJijHrjjO8G+la14SlL2SeS1Q==",
          "dev": true,
          "license": "ISC"
       },
       "node_modules/follow-redirects": {
-         "version": "1.15.11",
-         "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.11.tgz",
-         "integrity": "sha512-deG2P0JfjrTxl50XGCDyfI97ZGVCxIpfKYmfyrQ54n5FO/0gfIES8C/Psl6kWVDolizcaaxZJnTS0QSMxvnsBQ==",
+         "version": "1.16.1",
+         "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.16.1.tgz",
+         "integrity": "sha512-FNvFGzoMLWmE6Yj9spb/zjd7yiNCHiAW9/Tg9CXrQ8wuu32HtlJOwWO11OJafl5FfY3DxTdQ0vj42zU1kvv5jg==",
          "funding": [
             {
                "type": "individual",
@@ -3442,14 +3437,16 @@
          }
       },
       "node_modules/form-data": {
-         "version": "4.0.0",
-         "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.0.tgz",
-         "integrity": "sha512-ETEklSGi5t0QMZuiXoA/Q6vcnxcLQP5vdugSpuAyi6SVGi2clPPp+xgEhuMaHC+zGgn31Kd235W35f7Hykkaww==",
+         "version": "4.0.6",
+         "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.6.tgz",
+         "integrity": "sha512-vKatAh4SlVfgbv+YtmhiRjhEMJsYpsG1Y2rMQtR+SVSbytsSD1YGzDIcrAJmdFec88u/+VoGmxnl+80gL1tRCQ==",
          "license": "MIT",
          "dependencies": {
             "asynckit": "^0.4.0",
             "combined-stream": "^1.0.8",
-            "mime-types": "^2.1.12"
+            "es-set-tostringtag": "^2.1.0",
+            "hasown": "^2.0.4",
+            "mime-types": "^2.1.35"
          },
          "engines": {
             "node": ">= 6"
@@ -3481,7 +3478,6 @@
          "version": "1.1.2",
          "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
          "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
-         "dev": true,
          "license": "MIT",
          "funding": {
             "url": "https://github.com/sponsors/ljharb"
@@ -3549,7 +3545,6 @@
          "version": "1.3.0",
          "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
          "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
-         "dev": true,
          "license": "MIT",
          "dependencies": {
             "call-bind-apply-helpers": "^1.0.2",
@@ -3584,7 +3579,6 @@
          "version": "1.0.1",
          "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
          "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
-         "dev": true,
          "license": "MIT",
          "dependencies": {
             "dunder-proto": "^1.0.1",
@@ -3718,7 +3712,6 @@
          "version": "1.2.0",
          "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
          "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
-         "dev": true,
          "license": "MIT",
          "engines": {
             "node": ">= 0.4"
@@ -3800,7 +3793,6 @@
          "version": "1.1.0",
          "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
          "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
-         "dev": true,
          "license": "MIT",
          "engines": {
             "node": ">= 0.4"
@@ -3813,7 +3805,6 @@
          "version": "1.0.2",
          "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz",
          "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==",
-         "dev": true,
          "license": "MIT",
          "dependencies": {
             "has-symbols": "^1.0.3"
@@ -3826,10 +3817,9 @@
          }
       },
       "node_modules/hasown": {
-         "version": "2.0.2",
-         "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
-         "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
-         "dev": true,
+         "version": "2.0.4",
+         "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.4.tgz",
+         "integrity": "sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A==",
          "license": "MIT",
          "dependencies": {
             "function-bind": "^1.1.2"
@@ -4547,7 +4537,6 @@
          "integrity": "sha512-Yn0mADZB89zTtjkPJEXwrac3LHudkQMR+Paqa8uxJHCBr9agxztUifWCyiYrjhMPBoUVBjyny0I7XH6ozDr7QQ==",
          "dev": true,
          "license": "MIT",
-         "peer": true,
          "dependencies": {
             "@jest/core": "^27.5.1",
             "import-local": "^3.0.2",
@@ -5204,10 +5193,20 @@
          "license": "MIT"
       },
       "node_modules/js-yaml": {
-         "version": "4.1.0",
-         "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz",
-         "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==",
+         "version": "4.3.2",
+         "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.3.2.tgz",
+         "integrity": "sha512-SFNOvSJ+Dgf/9An904Yx+CgSlIPCkIpao4qo51lpee25TIRejdH3rhR4EZMGoNx3/TP3O+wzWuiTFl4sqbltzA==",
          "dev": true,
+         "funding": [
+            {
+               "type": "github",
+               "url": "https://github.com/sponsors/puzrin"
+            },
+            {
+               "type": "github",
+               "url": "https://github.com/sponsors/nodeca"
+            }
+         ],
          "license": "MIT",
          "dependencies": {
             "argparse": "^2.0.1"
@@ -5264,16 +5263,16 @@
          }
       },
       "node_modules/jsdom/node_modules/form-data": {
-         "version": "3.0.4",
-         "resolved": "https://registry.npmjs.org/form-data/-/form-data-3.0.4.tgz",
-         "integrity": "sha512-f0cRzm6dkyVYV3nPoooP8XlccPQukegwhAnpoLcXy+X+A8KfpGOoXwDr9FLZd3wzgLaBGQBE3lY93Zm/i1JvIQ==",
+         "version": "3.0.5",
+         "resolved": "https://registry.npmjs.org/form-data/-/form-data-3.0.5.tgz",
+         "integrity": "sha512-j23EibVLnp4zNXGW7LjryXYa2X6U/M96yoOX+ybZxwkYajdxRNEqYY3zhh7y0i6kfISKS2jr+EJq1YTUDEv5+w==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
             "asynckit": "^0.4.0",
             "combined-stream": "^1.0.8",
             "es-set-tostringtag": "^2.1.0",
-            "hasown": "^2.0.2",
+            "hasown": "^2.0.4",
             "mime-types": "^2.1.35"
          },
          "engines": {
@@ -5435,9 +5434,9 @@
          }
       },
       "node_modules/lodash": {
-         "version": "4.17.21",
-         "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz",
-         "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==",
+         "version": "4.18.1",
+         "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.18.1.tgz",
+         "integrity": "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==",
          "dev": true,
          "license": "MIT"
       },
@@ -5515,7 +5514,6 @@
          "version": "1.1.0",
          "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
          "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
-         "dev": true,
          "license": "MIT",
          "engines": {
             "node": ">= 0.4"
@@ -5584,9 +5582,9 @@
          }
       },
       "node_modules/minimatch": {
-         "version": "3.1.2",
-         "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
-         "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+         "version": "3.1.5",
+         "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz",
+         "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==",
          "dev": true,
          "license": "ISC",
          "dependencies": {
@@ -5628,11 +5626,14 @@
          "license": "MIT"
       },
       "node_modules/node-releases": {
-         "version": "2.0.19",
-         "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.19.tgz",
-         "integrity": "sha512-xxOWJsBKtzAq7DY0J+DTzuz58K8e7sJbdgwkbMWQe8UYB6ekmsQ45q0M/tJDsGaZmbC+l7n57UV8Hl5tHxO9uw==",
+         "version": "2.0.58",
+         "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.58.tgz",
+         "integrity": "sha512-BdiKAgbfRlvfMq/XzO/AF9NPmaA8a+YpLAyAFTVFBj3gARrAIfWvNq7Q7NE4se3KgFu0KkrvQMxTS0XVnsGzHg==",
          "dev": true,
-         "license": "MIT"
+         "license": "MIT",
+         "engines": {
+            "node": ">=18"
+         }
       },
       "node_modules/normalize-path": {
          "version": "3.0.0",
@@ -5985,9 +5986,9 @@
          "license": "ISC"
       },
       "node_modules/picomatch": {
-         "version": "2.3.1",
-         "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz",
-         "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==",
+         "version": "2.3.2",
+         "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz",
+         "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==",
          "dev": true,
          "license": "MIT",
          "engines": {
@@ -7224,7 +7225,6 @@
          "integrity": "sha512-1FXk9E2Hm+QzZQ7z+McJiHL4NW1F2EzMu9Nq9i3zAaGqibafqYwCVU6WyWAuyQRRzOlxou8xZSyXLEN8oKj24g==",
          "dev": true,
          "license": "Apache-2.0",
-         "peer": true,
          "bin": {
             "tsc": "bin/tsc",
             "tsserver": "bin/tsserver"
@@ -7270,9 +7270,9 @@
          }
       },
       "node_modules/update-browserslist-db": {
-         "version": "1.1.3",
-         "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.1.3.tgz",
-         "integrity": "sha512-UxhIZQ+QInVdunkDAaiazvvT/+fXL5Osr0JZlJulepYu6Jd7qJtDZjlur0emRlT71EN3ScPoE7gvsuIKKNavKw==",
+         "version": "1.3.4",
+         "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.3.4.tgz",
+         "integrity": "sha512-t8wonIOdQyOjtPd2VktlBu6QjTVTks6v8bSi7kd0r2Vll8TK1JYDZtRRdbmCHOAMphkZgrzK+L+vXK4pyZ8t4A==",
          "dev": true,
          "funding": [
             {
@@ -7583,9 +7583,9 @@
          }
       },
       "node_modules/ws": {
-         "version": "7.5.10",
-         "resolved": "https://registry.npmjs.org/ws/-/ws-7.5.10.tgz",
-         "integrity": "sha512-+dbF1tHwZpXcbOJdVOkzLDxZP1ailvSxM6ZweXTegylPny803bFhA+vqBYw4s31NSAk4S2Qz+AKXK9a4wkdjcQ==",
+         "version": "7.5.13",
+         "resolved": "https://registry.npmjs.org/ws/-/ws-7.5.13.tgz",
+         "integrity": "sha512-rsKI6xDBFVf4r/x8XyChGK04QR/XHroxs/jUcoWvtEZM8TPU/X/uIY9B1CsSzYws9ZJb/6bbBu7dPhFW00CAoA==",
          "dev": true,
          "license": "MIT",
          "engines": {

package.json

@@ -1,36 +1,39 @@
 {
    "name": "@qrunio/qqq-frontend-core",
-   "version": "0.40.4-SNAPSHOT",
+   "version": "0.40.27-RC.1",
    "description": "",
-   "main": "qqq-frontend-core.js",
-   "module": "lib/qqq-frontend-core.esm.js",
+   "main": "lib-cjs/qqq-frontend-core.js",
+   "module": "lib/qqq-frontend-core.js",
+   "types": "lib/qqq-frontend-core.d.ts",
    "scripts": {
       "delete-modules": "rm -rf node_modules; rm package-lock.json",
       "lint": "eslint . --ext .ts",
       "npm-install": "npm install",
-      "clean-and-install": "rm -rf node_modules/ && rm -rf package-lock.json && rm -rf lib/ && npm install",
-      "prepublishOnly": "rm -rf lib/ && tsc -p ./ --outDir lib/",
+      "clean-and-install": "npm ci && npm run prepublishOnly",
+      "prepublishOnly": "node scripts/clean-build.cjs && tsc -p ./ --outDir lib/ && tsc -p ./ --module commonjs --outDir lib-cjs/",
       "test": "jest",
       "yalc-push": "npm run prepublishOnly && yalc push --private",
       "yalc-watch": "yalc-watch"
    },
    "dependencies": {
-      "axios": "0.28.1",
-      "form-data": "4.0.0"
+      "axios": "0.34.0",
+      "form-data": "4.0.6"
    },
    "keywords": [],
    "files": [
       "lib",
-      "package.json"
+      "lib-cjs",
+      "package.json",
+      "NOTICE"
    ],
    "author": "Kingsrook LLC",
-   "license": "ISC",
+   "license": "Apache-2.0",
    "repository": {
       "type": "git",
-      "url": "https://github.com/Kingsrook/qqq-frontend-core"
+      "url": "https://github.com/QRun-IO/qqq-frontend-core"
    },
    "publishConfig": {
-      "registry": "https://registry.npmjs.org/"
+      "registry": "https://git.kof22.com/api/packages/QRun-IO/npm/"
    },
    "devDependencies": {
       "@types/jest": "^27.0.2",

scripts/clean-build.cjs

@@ -0,0 +1,7 @@
+const {rmSync} = require("node:fs");
+const {resolve} = require("node:path");
+
+// Resolve only these build outputs relative to the repository, never the caller's cwd.
+for (const directory of ["lib", "lib-cjs"]) {
+   rmSync(resolve(__dirname, "..", directory), {recursive: true, force: true});
+}

src/controllers/QController.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {AxiosError, AxiosRequestConfig, AxiosResponse} from "axios";

src/controllers/QControllerV1.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {AxiosError, AxiosResponse} from "axios";

src/exceptions/QException.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 

src/model/QPossibleValue.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 

src/model/QRecord.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 

src/model/metaData/AdornmentType.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 /*******************************************************************************

src/model/metaData/Banner.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 /*******************************************************************************

src/model/metaData/Capability.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 /*******************************************************************************

src/model/metaData/Collapsible.ts

@@ -0,0 +1,50 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022.  Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*******************************************************************************
+ ** Meta-Data to define Collapsible state, e.g., for a section or widget
+ **
+ *******************************************************************************/
+export class Collapsible
+{
+   isCollapsible: boolean;
+   initiallyOpen: boolean;
+
+   constructor(object: any)
+   {
+      ////////////////////////////////////////////////////////////////////////////
+      // use value === true to let undefined (or any other) values become false //
+      ////////////////////////////////////////////////////////////////////////////
+      this.isCollapsible = object.isCollapsible === true;
+      this.initiallyOpen = object.initiallyOpen === true;
+   }
+
+
+   /***************************************************************************
+    *
+    ***************************************************************************/
+   public clone(): Collapsible
+   {
+      const clone = new Collapsible({
+         ...this
+      });
+      return (clone);
+   }
+}

src/model/metaData/FieldAdornment.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {AdornmentType} from "./AdornmentType";

src/model/metaData/ProcessMetaDataAdjustment.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {QFieldMetaData} from "./QFieldMetaData";

src/model/metaData/QAppMetaData.ts

@@ -5,22 +5,22 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {QAppSection} from "./QAppSection";
 import {QAppTreeNode} from "./QAppTreeNode";
+import {QHelpContent} from "./QHelpContent";
 
 /*******************************************************************************
  ** Meta-Data to define an app in a QQQ instance.
@@ -36,6 +36,7 @@ export class QAppMetaData
    widgets?: string[];
    sections?: QAppSection[];
    supplementalAppMetaData: Map<String, any> = new Map();
+   helpContent?: Map<string, QHelpContent[]>;
 
    constructor(object: any)
    {
@@ -64,13 +65,17 @@ export class QAppMetaData
          }
       }
 
-      if(object.supplementalAppMetaData)
+      if (object.supplementalAppMetaData)
       {
          for (const key in object.supplementalAppMetaData)
          {
             this.supplementalAppMetaData.set(key, object.supplementalAppMetaData[key]);
          }
       }
-   }
 
+      if (object.helpContents)
+      {
+         this.helpContent = QHelpContent.buildMap(object.helpContents);
+      }
+   }
 }

src/model/metaData/QAppNodeType.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 /*******************************************************************************

src/model/metaData/QAppSection.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {QIcon} from "./QIcon";

src/model/metaData/QAppTreeNode.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {QAppNodeType} from "./QAppNodeType";

src/model/metaData/QAuthenticationMetaData.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 /*******************************************************************************

src/model/metaData/QBrandingMetaData.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {Banner} from "./Banner";
@@ -33,6 +32,8 @@ export class QBrandingMetaData
    logo?: string;
    icon?: string;
    accentColor?: string;
+   accentColorLight?: string;
+   gravatarDefault?: string;
 
    // Deprecated
    environmentBannerText?: string;
@@ -50,6 +51,8 @@ export class QBrandingMetaData
       this.logo = object.logo;
       this.icon = object.icon;
       this.accentColor = object.accentColor;
+      this.accentColorLight = object.accentColorLight;
+      this.gravatarDefault = object.gravatarDefault;
       this.environmentBannerText = object.environmentBannerText;
       this.environmentBannerColor = object.environmentBannerColor;
 

src/model/metaData/QComponentType.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 /*******************************************************************************

src/model/metaData/QExposedJoin.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {QJoinMetaData} from "./QJoinMetaData";
@@ -36,11 +35,11 @@ export class QExposedJoin
 
    constructor(object: any)
    {
-      this.label = object.label;
-      this.isMany = object.isMany;
-      this.joinTable = new QTableMetaData(object.joinTable);
+      this.label = object?.label;
+      this.isMany = object?.isMany;
+      this.joinTable = new QTableMetaData(object?.joinTable);
       this.joinPath = [];
-      for (let i = 0; i < object.joinPath.length; i++)
+      for (let i = 0; i < object?.joinPath?.length; i++)
       {
          this.joinPath.push(new QJoinMetaData(object.joinPath[i]));
       }
@@ -51,12 +50,12 @@ export class QExposedJoin
     ***************************************************************************/
    public clone(): QExposedJoin
    {
-      const joinTableClone = (this.joinTable as any).clone();
+      const joinTableClone = this.joinTable?.clone();
 
       const joinPathClone: QJoinMetaData[] = [];
-      for (let joinMetaData of this.joinPath)
+      for (let joinMetaData of this.joinPath ?? [])
       {
-         joinPathClone.push((joinMetaData as any).clone());
+         joinPathClone.push(joinMetaData.clone());
       }
 
       const clone = new QExposedJoin({
@@ -64,6 +63,9 @@ export class QExposedJoin
          joinTable: joinTableClone,
          joinPath: joinPathClone
       });
+      // overwrite joinTable — the constructor re-wraps it in new QTableMetaData(),
+      // which loses Map-based fields/virtualFields from the already-cloned object
+      clone.joinTable = joinTableClone;
       return (clone);
    }
 }

src/model/metaData/QFieldMetaData.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {QPossibleValue} from "../QPossibleValue";
@@ -91,11 +90,12 @@ export class QFieldMetaData
       this.helpContents = QHelpContent.buildArray(object.helpContents);
       this.behaviors = object.behaviors;
 
-      if (object.supplementalFieldMetaData)
+      const supplementalFieldMetaData = object.supplementalFieldMetaData || object.supplementalMetaData;
+      if (supplementalFieldMetaData)
       {
-         for (const key in object.supplementalFieldMetaData)
+         for (const key in supplementalFieldMetaData)
          {
-            this.supplementalFieldMetaData.set(key, object.supplementalFieldMetaData[key]);
+            this.supplementalFieldMetaData.set(key, supplementalFieldMetaData[key]);
          }
       }
 

src/model/metaData/QFieldType.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 /*******************************************************************************

src/model/metaData/QFrontendComponent.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {QComponentType} from "./QComponentType";

src/model/metaData/QFrontendStepMetaData.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {QFieldMetaData} from "./QFieldMetaData";

src/model/metaData/QHelpContent.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 /*******************************************************************************

src/model/metaData/QIcon.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 /*******************************************************************************

src/model/metaData/QInstance.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {QAppMetaData} from "./QAppMetaData";
@@ -27,7 +26,6 @@ import {QHelpContent} from "./QHelpContent";
 import {QProcessMetaData} from "./QProcessMetaData";
 import {QReportMetaData} from "./QReportMetaData";
 import {QTableMetaData} from "./QTableMetaData";
-import {QThemeMetaData} from "./QThemeMetaData";
 import {QWidgetMetaData} from "./QWidgetMetaData";
 
 /*******************************************************************************
@@ -43,7 +41,6 @@ export class QInstance
    apps?: Map<string, QAppMetaData>;
    appTree?: QAppTreeNode[];
    branding?: QBrandingMetaData;
-   theme?: QThemeMetaData;
    environmentValues?: Map<string, string>;
    helpContent?: Map<string, QHelpContent[]>;
    supplementalInstanceMetaData: Map<String, any> = new Map();
@@ -126,11 +123,6 @@ export class QInstance
          {
             this.supplementalInstanceMetaData.set(key, object.supplementalInstanceMetaData[key]);
          }
-
-         if (object.supplementalInstanceMetaData["theme"])
-         {
-            this.theme = new QThemeMetaData(object.supplementalInstanceMetaData["theme"]);
-         }
       }
 
       this.helpContent = QHelpContent.buildMap(object.helpContents);

src/model/metaData/QJoinMetaData.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 /*******************************************************************************

src/model/metaData/QMenu.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {QIcon} from "./QIcon";

src/model/metaData/QMenuItem.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {QIcon} from "./QIcon";

src/model/metaData/QProcessMetaData.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {QFrontendStepMetaData} from "./QFrontendStepMetaData";

src/model/metaData/QReportMetaData.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 /*******************************************************************************

src/model/metaData/QTableMetaData.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {QExposedJoin} from "./QExposedJoin";
@@ -24,6 +23,7 @@ import {QFieldMetaData} from "./QFieldMetaData";
 import {QHelpContent} from "./QHelpContent";
 import {QMenu} from "./QMenu";
 import {QTableSection} from "./QTableSection";
+import {QVirtualFieldMetaData} from "./QVirtualFieldMetaData";
 
 /*******************************************************************************
  ** Meta-Data to define a table in a QQQ instance.
@@ -36,7 +36,7 @@ export class QTableMetaData
    isHidden: boolean = false;
    primaryKeyField: string;
    fields?: Map<string, QFieldMetaData>;
-   virtualFields?: Map<string, QFieldMetaData>;
+   virtualFields?: Map<string, QVirtualFieldMetaData>;
    iconName?: string;
    sections?: QTableSection[];
    exposedJoins?: QExposedJoin[];
@@ -77,10 +77,10 @@ export class QTableMetaData
 
       if (object.virtualFields)
       {
-         this.virtualFields = new Map<string, QFieldMetaData>();
+         this.virtualFields = new Map<string, QVirtualFieldMetaData>();
          for (const key in object.virtualFields)
          {
-            this.virtualFields.set(key, new QFieldMetaData(object.virtualFields[key]));
+            this.virtualFields.set(key, new QVirtualFieldMetaData(object.virtualFields[key]));
          }
       }
 

src/model/metaData/QTableSection.ts

@@ -5,20 +5,20 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
+import {Collapsible} from "./Collapsible";
 import {QHelpContent} from "./QHelpContent";
 
 /*******************************************************************************
@@ -37,6 +37,7 @@ export class QTableSection
    gridColumns?: number;
    helpContents?: QHelpContent[];
    alternatives?: Map<string, QTableSection>;
+   collapsible?: Collapsible;
 
 
    /*******************************************************************************
@@ -68,6 +69,11 @@ export class QTableSection
             this.alternatives.set(type, new QTableSection(object.alternatives[type]));
          }
       }
+
+      if (object.collapsible)
+      {
+         this.collapsible = new Collapsible(object.collapsible);
+      }
    }
 
    /***************************************************************************
@@ -97,11 +103,14 @@ export class QTableSection
             alternativesClone.set(key, value.clone()));
       }
 
+      const collapsibleClone: Collapsible | undefined = (this.collapsible ? this.collapsible.clone() : undefined);
+
       const clone = new QTableSection({...this});
 
       clone.fieldNames = fieldNamesClone;
       clone.helpContents = helpContentsClone;
       clone.alternatives = alternativesClone;
+      clone.collapsible = collapsibleClone;
 
       return (clone);
    }

src/model/metaData/QTableVariant.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 /*******************************************************************************

src/model/metaData/QThemeMetaData.ts

@@ -1,312 +0,0 @@
-/*
- * QQQ - Low-code Application Framework for Engineers.
- * Copyright (C) 2021-2025.  Kingsrook, LLC
- * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
- * contact@kingsrook.com
- * https://github.com/Kingsrook/
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
- *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
- */
-
-/*******************************************************************************
- ** Meta-Data to define theme configuration in a QQQ instance.
- **
- *******************************************************************************/
-export class QThemeMetaData
-{
-   // Color palette
-   primaryColor?: string;
-   secondaryColor?: string;
-   backgroundColor?: string;
-   surfaceColor?: string;
-   textPrimary?: string;
-   textSecondary?: string;
-   errorColor?: string;
-   warningColor?: string;
-   successColor?: string;
-   infoColor?: string;
-
-   // Typography - Base
-   fontFamily?: string;
-   headerFontFamily?: string;
-   monoFontFamily?: string;
-   fontSizeBase?: string;
-   fontWeightLight?: number;
-   fontWeightRegular?: number;
-   fontWeightMedium?: number;
-   fontWeightBold?: number;
-
-   // Typography - H1
-   typographyH1FontSize?: string;
-   typographyH1FontWeight?: number;
-   typographyH1LineHeight?: number;
-   typographyH1LetterSpacing?: string;
-   typographyH1TextTransform?: string;
-
-   // Typography - H2
-   typographyH2FontSize?: string;
-   typographyH2FontWeight?: number;
-   typographyH2LineHeight?: number;
-   typographyH2LetterSpacing?: string;
-   typographyH2TextTransform?: string;
-
-   // Typography - H3
-   typographyH3FontSize?: string;
-   typographyH3FontWeight?: number;
-   typographyH3LineHeight?: number;
-   typographyH3LetterSpacing?: string;
-   typographyH3TextTransform?: string;
-
-   // Typography - H4
-   typographyH4FontSize?: string;
-   typographyH4FontWeight?: number;
-   typographyH4LineHeight?: number;
-   typographyH4LetterSpacing?: string;
-   typographyH4TextTransform?: string;
-
-   // Typography - H5
-   typographyH5FontSize?: string;
-   typographyH5FontWeight?: number;
-   typographyH5LineHeight?: number;
-   typographyH5LetterSpacing?: string;
-   typographyH5TextTransform?: string;
-
-   // Typography - H6
-   typographyH6FontSize?: string;
-   typographyH6FontWeight?: number;
-   typographyH6LineHeight?: number;
-   typographyH6LetterSpacing?: string;
-   typographyH6TextTransform?: string;
-
-   // Typography - Body1
-   typographyBody1FontSize?: string;
-   typographyBody1FontWeight?: number;
-   typographyBody1LineHeight?: number;
-   typographyBody1LetterSpacing?: string;
-   typographyBody1TextTransform?: string;
-
-   // Typography - Body2
-   typographyBody2FontSize?: string;
-   typographyBody2FontWeight?: number;
-   typographyBody2LineHeight?: number;
-   typographyBody2LetterSpacing?: string;
-   typographyBody2TextTransform?: string;
-
-   // Typography - Button
-   typographyButtonFontSize?: string;
-   typographyButtonFontWeight?: number;
-   typographyButtonLineHeight?: number;
-   typographyButtonLetterSpacing?: string;
-   typographyButtonTextTransform?: string;
-
-   // Typography - Caption
-   typographyCaptionFontSize?: string;
-   typographyCaptionFontWeight?: number;
-   typographyCaptionLineHeight?: number;
-   typographyCaptionLetterSpacing?: string;
-   typographyCaptionTextTransform?: string;
-
-   // Sizing
-   borderRadius?: string;
-   density?: "compact" | "normal" | "comfortable";
-
-   // Asset paths
-   logoPath?: string;
-   iconPath?: string;
-   faviconPath?: string;
-
-   // Custom CSS
-   customCss?: string;
-
-   // Icon style
-   iconStyle?: "filled" | "outlined" | "rounded" | "sharp" | "two-tone";
-
-   // Branded Header Bar
-   brandedHeaderEnabled?: boolean;
-   brandedHeaderBackgroundColor?: string;
-   brandedHeaderTextColor?: string;
-   brandedHeaderLogoPath?: string;
-   brandedHeaderLogoAltText?: string;
-   brandedHeaderHeight?: string;
-   brandedHeaderTagline?: string;
-
-   // App Bar
-   appBarBackgroundColor?: string;
-   appBarTextColor?: string;
-
-   // Sidebar
-   sidebarBackgroundColor?: string;
-   sidebarTextColor?: string;
-   sidebarIconColor?: string;
-   sidebarSelectedBackgroundColor?: string;
-   sidebarSelectedTextColor?: string;
-   sidebarHoverBackgroundColor?: string;
-   sidebarDividerColor?: string;
-
-   // Tables
-   tableHeaderBackgroundColor?: string;
-   tableHeaderTextColor?: string;
-   tableRowHoverColor?: string;
-   tableRowSelectedColor?: string;
-   tableBorderColor?: string;
-
-   // General
-   dividerColor?: string;
-   borderColor?: string;
-   cardBorderColor?: string;
-
-   constructor(object: any)
-   {
-      // Color palette
-      this.primaryColor = object.primaryColor;
-      this.secondaryColor = object.secondaryColor;
-      this.backgroundColor = object.backgroundColor;
-      this.surfaceColor = object.surfaceColor;
-      this.textPrimary = object.textPrimary;
-      this.textSecondary = object.textSecondary;
-      this.errorColor = object.errorColor;
-      this.warningColor = object.warningColor;
-      this.successColor = object.successColor;
-      this.infoColor = object.infoColor;
-
-      // Typography - Base
-      this.fontFamily = object.fontFamily;
-      this.headerFontFamily = object.headerFontFamily;
-      this.monoFontFamily = object.monoFontFamily;
-      this.fontSizeBase = object.fontSizeBase;
-      this.fontWeightLight = object.fontWeightLight;
-      this.fontWeightRegular = object.fontWeightRegular;
-      this.fontWeightMedium = object.fontWeightMedium;
-      this.fontWeightBold = object.fontWeightBold;
-
-      // Typography - H1
-      this.typographyH1FontSize = object.typographyH1FontSize;
-      this.typographyH1FontWeight = object.typographyH1FontWeight;
-      this.typographyH1LineHeight = object.typographyH1LineHeight;
-      this.typographyH1LetterSpacing = object.typographyH1LetterSpacing;
-      this.typographyH1TextTransform = object.typographyH1TextTransform;
-
-      // Typography - H2
-      this.typographyH2FontSize = object.typographyH2FontSize;
-      this.typographyH2FontWeight = object.typographyH2FontWeight;
-      this.typographyH2LineHeight = object.typographyH2LineHeight;
-      this.typographyH2LetterSpacing = object.typographyH2LetterSpacing;
-      this.typographyH2TextTransform = object.typographyH2TextTransform;
-
-      // Typography - H3
-      this.typographyH3FontSize = object.typographyH3FontSize;
-      this.typographyH3FontWeight = object.typographyH3FontWeight;
-      this.typographyH3LineHeight = object.typographyH3LineHeight;
-      this.typographyH3LetterSpacing = object.typographyH3LetterSpacing;
-      this.typographyH3TextTransform = object.typographyH3TextTransform;
-
-      // Typography - H4
-      this.typographyH4FontSize = object.typographyH4FontSize;
-      this.typographyH4FontWeight = object.typographyH4FontWeight;
-      this.typographyH4LineHeight = object.typographyH4LineHeight;
-      this.typographyH4LetterSpacing = object.typographyH4LetterSpacing;
-      this.typographyH4TextTransform = object.typographyH4TextTransform;
-
-      // Typography - H5
-      this.typographyH5FontSize = object.typographyH5FontSize;
-      this.typographyH5FontWeight = object.typographyH5FontWeight;
-      this.typographyH5LineHeight = object.typographyH5LineHeight;
-      this.typographyH5LetterSpacing = object.typographyH5LetterSpacing;
-      this.typographyH5TextTransform = object.typographyH5TextTransform;
-
-      // Typography - H6
-      this.typographyH6FontSize = object.typographyH6FontSize;
-      this.typographyH6FontWeight = object.typographyH6FontWeight;
-      this.typographyH6LineHeight = object.typographyH6LineHeight;
-      this.typographyH6LetterSpacing = object.typographyH6LetterSpacing;
-      this.typographyH6TextTransform = object.typographyH6TextTransform;
-
-      // Typography - Body1
-      this.typographyBody1FontSize = object.typographyBody1FontSize;
-      this.typographyBody1FontWeight = object.typographyBody1FontWeight;
-      this.typographyBody1LineHeight = object.typographyBody1LineHeight;
-      this.typographyBody1LetterSpacing = object.typographyBody1LetterSpacing;
-      this.typographyBody1TextTransform = object.typographyBody1TextTransform;
-
-      // Typography - Body2
-      this.typographyBody2FontSize = object.typographyBody2FontSize;
-      this.typographyBody2FontWeight = object.typographyBody2FontWeight;
-      this.typographyBody2LineHeight = object.typographyBody2LineHeight;
-      this.typographyBody2LetterSpacing = object.typographyBody2LetterSpacing;
-      this.typographyBody2TextTransform = object.typographyBody2TextTransform;
-
-      // Typography - Button
-      this.typographyButtonFontSize = object.typographyButtonFontSize;
-      this.typographyButtonFontWeight = object.typographyButtonFontWeight;
-      this.typographyButtonLineHeight = object.typographyButtonLineHeight;
-      this.typographyButtonLetterSpacing = object.typographyButtonLetterSpacing;
-      this.typographyButtonTextTransform = object.typographyButtonTextTransform;
-
-      // Typography - Caption
-      this.typographyCaptionFontSize = object.typographyCaptionFontSize;
-      this.typographyCaptionFontWeight = object.typographyCaptionFontWeight;
-      this.typographyCaptionLineHeight = object.typographyCaptionLineHeight;
-      this.typographyCaptionLetterSpacing = object.typographyCaptionLetterSpacing;
-      this.typographyCaptionTextTransform = object.typographyCaptionTextTransform;
-
-      // Sizing
-      this.borderRadius = object.borderRadius;
-      this.density = object.density;
-
-      // Asset paths
-      this.logoPath = object.logoPath;
-      this.iconPath = object.iconPath;
-      this.faviconPath = object.faviconPath;
-
-      // Custom CSS
-      this.customCss = object.customCss;
-
-      // Icon style
-      this.iconStyle = object.iconStyle;
-
-      // Branded Header Bar
-      this.brandedHeaderEnabled = object.brandedHeaderEnabled;
-      this.brandedHeaderBackgroundColor = object.brandedHeaderBackgroundColor;
-      this.brandedHeaderTextColor = object.brandedHeaderTextColor;
-      this.brandedHeaderLogoPath = object.brandedHeaderLogoPath;
-      this.brandedHeaderLogoAltText = object.brandedHeaderLogoAltText;
-      this.brandedHeaderHeight = object.brandedHeaderHeight;
-      this.brandedHeaderTagline = object.brandedHeaderTagline;
-
-      // App Bar
-      this.appBarBackgroundColor = object.appBarBackgroundColor;
-      this.appBarTextColor = object.appBarTextColor;
-
-      // Sidebar
-      this.sidebarBackgroundColor = object.sidebarBackgroundColor;
-      this.sidebarTextColor = object.sidebarTextColor;
-      this.sidebarIconColor = object.sidebarIconColor;
-      this.sidebarSelectedBackgroundColor = object.sidebarSelectedBackgroundColor;
-      this.sidebarSelectedTextColor = object.sidebarSelectedTextColor;
-      this.sidebarHoverBackgroundColor = object.sidebarHoverBackgroundColor;
-      this.sidebarDividerColor = object.sidebarDividerColor;
-
-      // Tables
-      this.tableHeaderBackgroundColor = object.tableHeaderBackgroundColor;
-      this.tableHeaderTextColor = object.tableHeaderTextColor;
-      this.tableRowHoverColor = object.tableRowHoverColor;
-      this.tableRowSelectedColor = object.tableRowSelectedColor;
-      this.tableBorderColor = object.tableBorderColor;
-
-      // General
-      this.dividerColor = object.dividerColor;
-      this.borderColor = object.borderColor;
-      this.cardBorderColor = object.cardBorderColor;
-   }
-}

src/model/metaData/QVirtualFieldMetaData.ts

@@ -0,0 +1,63 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2026.  Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import {QFieldMetaData} from "./QFieldMetaData";
+
+/***************************************************************************
+ * Meta-data to represent a virtual field in a table.
+ *
+ * This is a subclass of QFieldMetaData, as it is on the QQQ backend.
+ ***************************************************************************/
+export class QVirtualFieldMetaData extends QFieldMetaData
+{
+   isQueryCriteria: boolean  = false;
+   isQuerySelectable: boolean = false;
+
+   /***************************************************************************
+    *
+    ***************************************************************************/
+   constructor(object: any)
+   {
+      super(object);
+
+      this.isQueryCriteria = object.isQueryCriteria;
+      this.isQuerySelectable = object.isQuerySelectable;
+   }
+
+
+
+   /***************************************************************************
+    *
+    ***************************************************************************/
+   public clone(): QVirtualFieldMetaData
+   {
+      const clone = super.clone() as QVirtualFieldMetaData;
+
+      ///////////////////////////////////////////////////////////////////////////////
+      // any time we do a super clone, we want to set the prototype to our subtype //
+      ///////////////////////////////////////////////////////////////////////////////
+      Object.setPrototypeOf(clone, QVirtualFieldMetaData.prototype)
+
+      clone.isQueryCriteria = this.isQueryCriteria;
+      clone.isQuerySelectable = this.isQuerySelectable;
+
+      return (clone);
+   }
+}

src/model/metaData/QWidgetMetaData.ts

@@ -5,20 +5,20 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
+import {Collapsible} from "./Collapsible";
 import {QHelpContent} from "./QHelpContent";
 import {QIcon} from "./QIcon";
 
@@ -51,6 +51,7 @@ export class QWidgetMetaData
 
    helpContent?: Map<string, QHelpContent[]>;
    defaultValues?: Map<string, any>;
+   collapsible?: Collapsible;
 
    constructor(object: any)
    {
@@ -89,5 +90,9 @@ export class QWidgetMetaData
          }
       }
 
+      if (object.collapsible)
+      {
+         this.collapsible = new Collapsible(object.collapsible);
+      }
    }
 }

src/model/processes/QJobComplete.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {ProcessMetaDataAdjustment} from "../metaData/ProcessMetaDataAdjustment";

src/model/processes/QJobError.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 /*******************************************************************************

src/model/processes/QJobRunning.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 /*******************************************************************************

src/model/processes/QJobStarted.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 /*******************************************************************************

src/model/query/FieldFunction.ts

@@ -0,0 +1,53 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022.  Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*******************************************************************************
+ ** Define a field function being used in a QQQ application
+ **
+ *******************************************************************************/
+export class FieldFunction
+{
+   fieldName: string;
+   functionTypeIdentifierName: string;
+   arguments: Record<string, any>
+
+   constructor(fieldName: string, functionTypeIdentifierName: string, _arguments: Record<string, any>)
+   {
+      this.fieldName = fieldName;
+      this.functionTypeIdentifierName = functionTypeIdentifierName;
+      this.arguments = _arguments;
+   }
+
+   /***************************************************************************
+    *
+    ***************************************************************************/
+   public clone(): FieldFunction
+   {
+      const cloneArguments = (this.arguments === null ? null : this.arguments === undefined ? undefined : {...this.arguments}) as Record<string, any>;
+
+      const clone = new FieldFunction(
+         this.fieldName,
+         this.functionTypeIdentifierName,
+         cloneArguments
+      );
+
+      return (clone);
+   }
+}

src/model/query/FilterVariableExpression.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 

src/model/query/NowExpression.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 

src/model/query/NowWithOffsetExpression.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 

src/model/query/QCriteriaOperator.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 /*******************************************************************************

src/model/query/QFilterCriteria.ts

@@ -5,20 +5,20 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
+import {FieldFunction} from "./FieldFunction";
 import {QCriteriaOperator} from "./QCriteriaOperator";
 
 /*******************************************************************************
@@ -31,6 +31,7 @@ export class QFilterCriteria
    operator: QCriteriaOperator;
    values!: any[];
    otherFieldName?: string;
+   fieldFunction?: FieldFunction;
 
    constructor(fieldName: string, operator: QCriteriaOperator, values: any[])
    {
@@ -51,7 +52,14 @@ export class QFilterCriteria
          this.operator,
          cloneValues
       );
+
       clone.otherFieldName = this.otherFieldName;
+
+      if(this.fieldFunction)
+      {
+         clone.fieldFunction = this.fieldFunction.clone();
+      }
+
       return (clone);
    }
 }

src/model/query/QFilterOrderBy.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 /*******************************************************************************

src/model/query/QQueryFilter.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {QFilterCriteria} from "./QFilterCriteria";

src/model/query/QueryJoin.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 /*******************************************************************************

src/model/query/ThisOrLastPeriodExpression.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 

src/qqq-frontend-core.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {QController} from "./controllers/QController";
@@ -24,7 +23,7 @@ import {QFieldMetaData} from "./model/metaData/QFieldMetaData";
 import {QFieldType} from "./model/metaData/QFieldType";
 import {QTableMetaData} from "./model/metaData/QTableMetaData";
 
-module.exports = {
+export {
    QController,
    QTableMetaData,
    QFieldMetaData,

tests/PackageExports.test.ts

@@ -0,0 +1,32 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022.  Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import {QController, QFieldMetaData, QFieldType, QTableMetaData} from "../src/qqq-frontend-core";
+
+describe("public package exports", () =>
+{
+   it("exposes the controller and metadata constructors", () =>
+   {
+      expect(typeof QController).toBe("function");
+      expect(typeof QTableMetaData).toBe("function");
+      expect(new QFieldMetaData({name: "id", type: QFieldType.INTEGER}).name).toBe("id");
+      expect(QFieldType.INTEGER).toBeDefined();
+   });
+});

tests/controllers/QController.test.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import axios from "axios";

tests/controllers/QControllerTransport.test.ts

@@ -0,0 +1,125 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2022.  Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import {createServer, IncomingHttpHeaders, Server} from "http";
+import {AddressInfo} from "net";
+import FormData = require("form-data");
+import {QController} from "../../src/controllers/QController";
+import {QException} from "../../src/exceptions/QException";
+
+require("jest-localstorage-mock");
+
+describe("QController real HTTP transport", () =>
+{
+   let server: Server;
+   let controller: QController;
+   const requests: {path: string, method: string, headers: IncomingHttpHeaders, body: string}[] = [];
+
+   beforeAll(async () =>
+   {
+      server = createServer((request, response) =>
+      {
+         const chunks: Buffer[] = [];
+         request.on("data", (chunk: Buffer) => chunks.push(chunk));
+         request.on("end", () =>
+         {
+            requests.push({path: request.url!, method: request.method!, headers: request.headers, body: Buffer.concat(chunks).toString("utf8")});
+            response.setHeader("Content-Type", "application/json");
+            if (request.url === "/metaData/authentication")
+            {
+               response.end(JSON.stringify({name: "owned-fixture", type: "MOCK"}));
+            }
+            else if (request.url === "/manageSession")
+            {
+               response.end(JSON.stringify({uuid: "fixture-session", values: {accepted: true}}));
+            }
+            else if (request.url === "/processes/upload%20fixture/init")
+            {
+               response.end(JSON.stringify({jobUUID: "fixture-job", processUUID: "fixture-process"}));
+            }
+            else
+            {
+               response.statusCode = 403;
+               response.end(JSON.stringify({error: "Denied by owned fixture"}));
+            }
+         });
+      });
+      await new Promise<void>((resolve) => server.listen(0, "127.0.0.1", resolve));
+      controller = new QController(`http://127.0.0.1:${(server.address() as AddressInfo).port}`);
+      controller.getAxiosInstance().defaults.proxy = false;
+      controller.setGotAuthentication();
+   });
+
+   beforeEach(() =>
+   {
+      requests.length = 0;
+      localStorage.clear();
+      QController.clearMemoization();
+   });
+
+   afterAll(async () =>
+   {
+      await new Promise<void>((resolve, reject) => server.close(error => error ? reject(error) : resolve()));
+   });
+
+   it("fetches and caches provider metadata, then refreshes after cache eviction", async () =>
+   {
+      expect((await controller.getAuthenticationMetaData()).name).toBe("owned-fixture");
+      expect((await controller.getAuthenticationMetaData()).type).toBe("MOCK");
+      expect(requests).toHaveLength(1);
+      controller.clearAuthenticationMetaDataLocalStorage();
+      await controller.getAuthenticationMetaData();
+      expect(requests.map(request => [request.method, request.path])).toEqual([
+         ["GET", "/metaData/authentication"], ["GET", "/metaData/authentication"]
+      ]);
+   });
+
+   it("posts session JSON without changing the supplied values", async () =>
+   {
+      expect(await controller.manageSession("fixture-access-token", "previous-session")).toEqual({uuid: "fixture-session", values: {accepted: true}});
+      expect(requests[0].path).toBe("/manageSession");
+      expect(requests[0].method).toBe("POST");
+      expect(JSON.parse(requests[0].body)).toEqual({accessToken: "fixture-access-token", uuid: "previous-session"});
+      expect(requests[0].headers["content-type"]).toContain("application/json");
+   });
+
+   it("sends multipart fields and file bytes with the declared boundary", async () =>
+   {
+      const data = new FormData();
+      data.append("description", "Fixture café");
+      data.append("file", Buffer.from("owned upload bytes"), {filename: "fixture.txt", contentType: "text/plain"});
+      const result = await controller.processInit("upload fixture", data);
+      expect(result).toMatchObject({jobUUID: "fixture-job", processUUID: "fixture-process"});
+      expect(requests[0].method).toBe("POST");
+      expect(requests[0].headers["content-type"]).toBe(`multipart/form-data; boundary=${data.getBoundary()}`);
+      expect(requests[0].body).toContain(`--${data.getBoundary()}`);
+      expect(requests[0].body).toContain("name=\"description\"");
+      expect(requests[0].body).toContain("Fixture café");
+      expect(requests[0].body).toContain("filename=\"fixture.txt\"");
+      expect(requests[0].body).toContain("owned upload bytes");
+   });
+
+   it("surfaces a rejected server response without retrying the write", async () =>
+   {
+      await expect(controller.processInit("denied")).rejects.toBeInstanceOf(QException);
+      expect(requests).toHaveLength(1);
+      expect(requests[0].path).toBe("/processes/denied/init");
+   });
+});

tests/controllers/QInstance.test.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {QInstance} from "../../src/model/metaData/QInstance";

tests/model/metaData/Collapsible.test.ts

@@ -0,0 +1,63 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2025.  Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import {Collapsible} from "../../../src/model/metaData/Collapsible";
+
+describe("Collapsible", () =>
+{
+   describe("constructor", () =>
+   {
+      it("should construct with all properties from object", () =>
+      {
+         const collapsible = new Collapsible({
+            isCollapsible: true,
+            initiallyOpen: true
+         });
+
+         expect(collapsible.isCollapsible).toBe(true);
+         expect(collapsible.initiallyOpen).toBe(true);
+      });
+
+      it("should handle empty object", () =>
+      {
+         const collapsible = new Collapsible({});
+
+         //////////////////////////////////////
+         // both attributes default to false //
+         //////////////////////////////////////
+         expect(collapsible.isCollapsible).toBe(false);
+         expect(collapsible.initiallyOpen).toBe(false);
+      });
+
+      it("should treat non-true values as false", () =>
+      {
+         const collapsible = new Collapsible({
+            isCollapsible: 1,
+            initiallyOpen: "true"
+         });
+
+         //////////////////////////////////////
+         // both attributes default to false //
+         //////////////////////////////////////
+         expect(collapsible.isCollapsible).toBe(false);
+         expect(collapsible.initiallyOpen).toBe(false);
+      });
+   });
+});

tests/model/metaData/QInstance.test.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {QAppMetaData} from "../../../src/model/metaData/QAppMetaData";

tests/model/metaData/QTableMetaData.test.ts

@@ -1,22 +1,21 @@
 /*
  * QQQ - Low-code Application Framework for Engineers.
- * Copyright (C) 2021-2025.  Kingsrook, LLC
+ * Copyright (C) 2021-2026.  Kingsrook, LLC
  * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 
@@ -24,9 +23,70 @@ import {QHelpContent} from "../../../src/model/metaData/QHelpContent";
 import {QMenu} from "../../../src/model/metaData/QMenu";
 import {QMenuItem} from "../../../src/model/metaData/QMenuItem";
 import {QTableMetaData} from "../../../src/model/metaData/QTableMetaData";
+import {QVirtualFieldMetaData} from "../../../src/model/metaData/QVirtualFieldMetaData";
 
 describe("QTableMetaData tests", () =>
 {
+   it("it should read field supplementalFieldMetaData", () =>
+   {
+      const table = new QTableMetaData({
+         "name": "myTable",
+         "label": "My Table",
+         "primaryKeyField": "id",
+         "fields": {
+            "warehouseId": {
+               "name": "warehouseId",
+               "label": "Warehouse",
+               "type": "INTEGER",
+               "displayFormat": "%s",
+               "supplementalFieldMetaData": {
+                  "materialDashboard": {
+                     "formAdjusterIdentifier": "process:myProcess;field:warehouseId",
+                     "type": "materialDashboard"
+                  }
+               }
+            }
+         }
+      });
+
+      expect(table.fields?.get("warehouseId")?.supplementalFieldMetaData.get("materialDashboard")).toEqual(
+         expect.objectContaining({
+            formAdjusterIdentifier: "process:myProcess;field:warehouseId",
+            type: "materialDashboard"
+         })
+      );
+   });
+
+   it("it should read field supplementalMetaData", () =>
+   {
+      const table = new QTableMetaData({
+         "name": "myTable",
+         "label": "My Table",
+         "primaryKeyField": "id",
+         "fields": {
+            "warehouseId": {
+               "name": "warehouseId",
+               "label": "Warehouse",
+               "type": "INTEGER",
+               "displayFormat": "%s",
+               "supplementalMetaData": {
+                  "materialDashboard": {
+                     "formAdjusterIdentifier": "process:myProcess;field:warehouseId",
+                     "type": "materialDashboard"
+                  }
+               }
+            }
+         }
+      });
+
+      expect(table.fields?.get("warehouseId")?.supplementalFieldMetaData.get("materialDashboard")).toEqual(
+         expect.objectContaining({
+            formAdjusterIdentifier: "process:myProcess;field:warehouseId",
+            type: "materialDashboard"
+         })
+      );
+   });
+
    it("it should clone", () =>
    {
       /////////////////////////////////////
@@ -131,7 +191,7 @@ describe("QTableMetaData tests", () =>
                         "contentAsHtml": "Field Help"
                      }
                   ],
-                  "supplementalFieldMetaData": {
+                  "supplementalMetaData": {
                      "materialDashboard": {
                         "formAdjusterIdentifier": "table:connection;field:externalSystemId",
                         "onChangeFormAdjuster": {
@@ -159,7 +219,7 @@ describe("QTableMetaData tests", () =>
                   "gridColumns": -1,
                   "displayFormat": "%s",
                   "possibleValueSourceName": "type",
-                  "supplementalFieldMetaData": {
+                  "supplementalMetaData": {
                      "materialDashboard": {
                         "formAdjusterIdentifier": "table:myTable;field:type",
                         "onChangeFormAdjuster": {
@@ -171,6 +231,32 @@ describe("QTableMetaData tests", () =>
                   }
                },
             },
+            "virtualFields": {
+               "nameLength": {
+                  "name": "nameLength",
+                  "label": "Name Length",
+                  "type": "INTEGER",
+                  "isRequired": false,
+                  "isEditable": false,
+                  "isHeavy": false,
+                  "isHidden": false,
+                  "gridColumns": -1,
+                  "isQueryCriteria": true,
+                  "isQuerySelectable": false
+               },
+               "createDateWeekday": {
+                  "name": "createDateWeekday",
+                  "label": "Create Date Weekday",
+                  "type": "DATE",
+                  "isRequired": false,
+                  "isEditable": false,
+                  "isHeavy": false,
+                  "isHidden": false,
+                  "gridColumns": -1,
+                  "isQueryCriteria": false,
+                  "isQuerySelectable": true
+               },
+            },
             "sections": [
                {
                   "name": "identity",
@@ -196,7 +282,27 @@ describe("QTableMetaData tests", () =>
                   "isHidden": false
                },
             ],
-            "exposedJoins": [],
+            "exposedJoins": [
+               {
+                  "label": "Parcel",
+                  "isMany": false,
+                  "joinTable": {
+                     "name": "parcel",
+                     "label": "Parcel",
+                     "primaryKeyField": "id",
+                     "fields": {
+                        "id": {"name": "id", "label": "Id", "type": "INTEGER", "isEditable": false, "isHidden": false},
+                        "trackingNumber": {"name": "trackingNumber", "label": "Tracking Number", "type": "STRING", "isEditable": true, "isHidden": false},
+                        "status": {"name": "status", "label": "Status", "type": "STRING", "isEditable": true, "isHidden": false}
+                     },
+                     "sections": [],
+                     "capabilities": []
+                  },
+                  "joinPath": [
+                     {"name": "orderShipmentJoinParcel", "leftTable": "orderShipment", "rightTable": "parcel", "type": "ONE_TO_ONE", "joinOns": []}
+                  ]
+               }
+            ],
             "supplementalTableMetaData": {
                "materialDashboard": {
                   "onLoadFormAdjuster": {
@@ -251,6 +357,9 @@ describe("QTableMetaData tests", () =>
       const cloneTable = table.clone();
       expect(cloneTable.name).toEqual(table.name);
 
+      expect(cloneTable.virtualFields?.size).toEqual(2);
+      expect(cloneTable.virtualFields?.get("nameLength") instanceof QVirtualFieldMetaData).toBeTruthy();
+
       expect(cloneTable.sections?.length).toEqual(2);
       expect(cloneTable.sections?.length).toEqual(table.sections?.length);
       expect(cloneTable.sections?.[0].name).toEqual(table.sections?.[0].name);
@@ -278,6 +387,11 @@ describe("QTableMetaData tests", () =>
       expect(cloneTable.menus?.length).toEqual(1);
       expect(cloneTable.menus?.[0].items?.length).toEqual(2);
 
+      expect(cloneTable.exposedJoins?.length).toEqual(1);
+      expect(cloneTable.exposedJoins?.[0].joinTable.name).toEqual("parcel");
+      expect(cloneTable.exposedJoins?.[0].joinTable.fields?.size).toEqual(3);
+      expect(cloneTable.exposedJoins?.[0].joinTable.fields?.get("trackingNumber")?.name).toEqual("trackingNumber");
+
       ////////////////////////////////////////////////////////////////////////////////////////////////
       // turns out toEqual will do a deep equality test, so, we could have just done this all along //
       ////////////////////////////////////////////////////////////////////////////////////////////////
@@ -288,11 +402,20 @@ describe("QTableMetaData tests", () =>
       ///////////////////////////////////////////////////////////////////////////////////////////
       cloneTable.name = "changed";
       expect(cloneTable.name).not.toEqual(table.name);
-      if (cloneTable.sections)
-      {
-         cloneTable.sections[0].name = "changed";
-         cloneTable.sections[0].isHidden = true;
-      }
+
+      cloneTable.virtualFields?.set("new", new QVirtualFieldMetaData({}));
+      expect(cloneTable.virtualFields?.size).toEqual(3);
+      expect(table.virtualFields?.size).toEqual(2);
+
+      cloneTable.virtualFields!.get("nameLength")!.gridColumns = 6;
+      cloneTable.virtualFields!.get("nameLength")!.isQuerySelectable = !cloneTable.virtualFields!.get("nameLength")!.isQuerySelectable;
+      cloneTable.virtualFields!.get("nameLength")!.isQueryCriteria = !cloneTable.virtualFields!.get("nameLength")!.isQueryCriteria;
+      expect(cloneTable.virtualFields?.get("nameLength")?.gridColumns).not.toEqual(table.virtualFields?.get("nameLength")?.gridColumns);
+      expect(cloneTable.virtualFields?.get("nameLength")?.isQuerySelectable).not.toEqual(table.virtualFields?.get("nameLength")?.isQuerySelectable);
+      expect(cloneTable.virtualFields?.get("nameLength")?.isQueryCriteria).not.toEqual(table.virtualFields?.get("nameLength")?.isQueryCriteria);
+
+      cloneTable.sections![0]!.name = "changed";
+      cloneTable.sections![0]!.isHidden = true;
 
       expect(cloneTable.sections?.[0].name).not.toEqual(table.sections?.[0].name);
       expect(cloneTable.sections?.[0].isHidden).not.toEqual(table.sections?.[0].isHidden);
@@ -300,21 +423,14 @@ describe("QTableMetaData tests", () =>
       cloneTable.capabilities.delete("TABLE_COUNT");
       expect(cloneTable.capabilities.size).not.toEqual(table.capabilities.size);
 
-      if (cloneTable.helpContent && table.helpContent) // avoid possibly-undef and ?. on left-hand sides below
-      {
-         cloneTable.helpContent.set("key2", []);
-         expect(cloneTable.helpContent.size).not.toEqual(table.helpContent.size);
+      cloneTable.helpContent?.set("key2", []);
+      expect(cloneTable.helpContent?.size).not.toEqual(table.helpContent?.size);
 
-         cloneTable.helpContent.get("key")?.push(new QHelpContent({}));
-         expect(cloneTable.helpContent.get("key")?.length).not.toEqual(table.helpContent.get("key")?.length);
+      cloneTable.helpContent?.get("key")?.push(new QHelpContent({}));
+      expect(cloneTable.helpContent?.get("key")?.length).not.toEqual(table.helpContent?.get("key")?.length);
 
-         cloneTable.helpContent.get("key")?.[0].roles.add("READ_SCREENS");
-         expect(cloneTable.helpContent.get("key")?.[0].roles.size).not.toEqual(table.helpContent.get("key")?.[0].roles.size);
-      }
-      else
-      {
-         fail("help content wasn't set in either table or cloneTable (or neither)");
-      }
+      cloneTable.helpContent?.get("key")?.[0].roles.add("READ_SCREENS");
+      expect(cloneTable.helpContent?.get("key")?.[0].roles.size).not.toEqual(table.helpContent?.get("key")?.[0].roles.size);
 
       cloneTable.sections?.[0]?.fieldNames?.push("foobar");
       expect(cloneTable.sections?.[0]?.fieldNames?.length).not.toEqual(table.sections?.[0]?.fieldNames?.length);
@@ -331,4 +447,4 @@ describe("QTableMetaData tests", () =>
       expect(cloneTable.menus?.length).not.toEqual(table.menus?.length);
    });
 
-});
+});

tests/model/metaData/QTableSection.test.ts

@@ -0,0 +1,104 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2025.  Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import {QTableSection} from "../../../src/model/metaData/QTableSection";
+
+describe("QTableSection", () =>
+{
+   describe("constructor", () =>
+   {
+      it("should construct with collapsible object if set in source object", () =>
+      {
+         const section = new QTableSection({
+            name: "section1",
+            collapsible: {
+               isCollapsible: true,
+               initiallyOpen: false
+            }
+         });
+
+         expect(section.name).toBe("section1");
+         expect(section.collapsible?.isCollapsible).toBe(true);
+         expect(section.collapsible?.initiallyOpen).toBe(false);
+      });
+
+      it("should construct with undefined collapsible object if not present in source object", () =>
+      {
+         const section = new QTableSection({
+            name: "section2"
+         });
+
+         expect(section.name).toBe("section2");
+         expect(section.collapsible).toBeUndefined();
+      });
+
+      it("should construct with collapsible object with null values if empty collapsible object is in source", () =>
+      {
+         const section = new QTableSection({
+            name: "section3",
+            collapsible: {}
+         });
+
+         expect(section.name).toBe("section3");
+         expect(section.collapsible?.isCollapsible).toBe(false);
+         expect(section.collapsible?.initiallyOpen).toBe(false);
+      });
+
+      it("should deeply clone a collapsible", () =>
+      {
+         const section = new QTableSection({
+            name: "section4",
+            collapsible: {
+               isCollapsible: true,
+               initiallyOpen: true
+            }
+         });
+
+         expect(section.name).toBe("section4");
+         expect(section.collapsible?.isCollapsible).toBe(true);
+         expect(section.collapsible?.initiallyOpen).toBe(true);
+
+         const clone = section.clone();
+         expect(clone.collapsible?.isCollapsible).toBe(true);
+         expect(clone.collapsible?.initiallyOpen).toBe(true);
+
+         if(clone.collapsible)
+         {
+            clone.collapsible.initiallyOpen = false;
+         }
+         expect(section.collapsible?.initiallyOpen).toBe(true);
+         expect(clone.collapsible?.initiallyOpen).toBe(false);
+      });
+
+      it("should handle an undefined collapsible during cloning", () =>
+      {
+         const section = new QTableSection({
+            name: "section5"
+         });
+
+         expect(section.name).toBe("section5");
+         expect(section.collapsible).toBeUndefined();
+
+         const clone = section.clone();
+         expect(clone.collapsible).toBeUndefined();
+      });
+   });
+
+});

tests/model/metaData/QThemeMetaData.test.ts

@@ -1,216 +0,0 @@
-/*
- * QQQ - Low-code Application Framework for Engineers.
- * Copyright (C) 2021-2025.  Kingsrook, LLC
- * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
- * contact@kingsrook.com
- * https://github.com/Kingsrook/
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
- *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
- */
-
-import {QThemeMetaData} from "../../../src/model/metaData/QThemeMetaData";
-
-describe("QThemeMetaData", () =>
-{
-   describe("constructor", () =>
-   {
-      it("should construct with all properties from object", () =>
-      {
-         const theme = new QThemeMetaData({
-            primaryColor: "#FF0000",
-            secondaryColor: "#00FF00",
-            backgroundColor: "#0000FF",
-            surfaceColor: "#FFFFFF",
-            textPrimary: "#000000",
-            textSecondary: "#666666",
-            errorColor: "#FF0000",
-            warningColor: "#FFA500",
-            successColor: "#00FF00",
-            infoColor: "#0000FF",
-            fontFamily: "Roboto",
-            headerFontFamily: "Open Sans",
-            borderRadius: "8px",
-            density: "compact",
-            logoPath: "/assets/logo.svg",
-            iconPath: "/assets/icon.svg",
-            faviconPath: "/assets/favicon.ico",
-            customCss: "body { margin: 0; }",
-            iconStyle: "outlined"
-         });
-
-         expect(theme.primaryColor).toBe("#FF0000");
-         expect(theme.secondaryColor).toBe("#00FF00");
-         expect(theme.backgroundColor).toBe("#0000FF");
-         expect(theme.surfaceColor).toBe("#FFFFFF");
-         expect(theme.textPrimary).toBe("#000000");
-         expect(theme.textSecondary).toBe("#666666");
-         expect(theme.errorColor).toBe("#FF0000");
-         expect(theme.warningColor).toBe("#FFA500");
-         expect(theme.successColor).toBe("#00FF00");
-         expect(theme.infoColor).toBe("#0000FF");
-         expect(theme.fontFamily).toBe("Roboto");
-         expect(theme.headerFontFamily).toBe("Open Sans");
-         expect(theme.borderRadius).toBe("8px");
-         expect(theme.density).toBe("compact");
-         expect(theme.logoPath).toBe("/assets/logo.svg");
-         expect(theme.iconPath).toBe("/assets/icon.svg");
-         expect(theme.faviconPath).toBe("/assets/favicon.ico");
-         expect(theme.customCss).toBe("body { margin: 0; }");
-         expect(theme.iconStyle).toBe("outlined");
-      });
-
-      it("should handle empty object", () =>
-      {
-         const theme = new QThemeMetaData({});
-
-         expect(theme.primaryColor).toBeUndefined();
-         expect(theme.secondaryColor).toBeUndefined();
-         expect(theme.backgroundColor).toBeUndefined();
-         expect(theme.surfaceColor).toBeUndefined();
-         expect(theme.textPrimary).toBeUndefined();
-         expect(theme.textSecondary).toBeUndefined();
-         expect(theme.errorColor).toBeUndefined();
-         expect(theme.warningColor).toBeUndefined();
-         expect(theme.successColor).toBeUndefined();
-         expect(theme.infoColor).toBeUndefined();
-         expect(theme.fontFamily).toBeUndefined();
-         expect(theme.headerFontFamily).toBeUndefined();
-         expect(theme.borderRadius).toBeUndefined();
-         expect(theme.density).toBeUndefined();
-         expect(theme.logoPath).toBeUndefined();
-         expect(theme.iconPath).toBeUndefined();
-         expect(theme.faviconPath).toBeUndefined();
-         expect(theme.customCss).toBeUndefined();
-         expect(theme.iconStyle).toBeUndefined();
-      });
-
-      it("should handle partial object", () =>
-      {
-         const theme = new QThemeMetaData({
-            primaryColor: "#FF0000",
-            density: "normal"
-         });
-
-         expect(theme.primaryColor).toBe("#FF0000");
-         expect(theme.density).toBe("normal");
-         expect(theme.secondaryColor).toBeUndefined();
-         expect(theme.iconStyle).toBeUndefined();
-      });
-   });
-
-   describe("density type", () =>
-   {
-      it("should accept compact density", () =>
-      {
-         const theme = new QThemeMetaData({density: "compact"});
-         expect(theme.density).toBe("compact");
-      });
-
-      it("should accept normal density", () =>
-      {
-         const theme = new QThemeMetaData({density: "normal"});
-         expect(theme.density).toBe("normal");
-      });
-
-      it("should accept comfortable density", () =>
-      {
-         const theme = new QThemeMetaData({density: "comfortable"});
-         expect(theme.density).toBe("comfortable");
-      });
-   });
-
-   describe("iconStyle type", () =>
-   {
-      it("should accept filled iconStyle", () =>
-      {
-         const theme = new QThemeMetaData({iconStyle: "filled"});
-         expect(theme.iconStyle).toBe("filled");
-      });
-
-      it("should accept outlined iconStyle", () =>
-      {
-         const theme = new QThemeMetaData({iconStyle: "outlined"});
-         expect(theme.iconStyle).toBe("outlined");
-      });
-
-      it("should accept rounded iconStyle", () =>
-      {
-         const theme = new QThemeMetaData({iconStyle: "rounded"});
-         expect(theme.iconStyle).toBe("rounded");
-      });
-
-      it("should accept sharp iconStyle", () =>
-      {
-         const theme = new QThemeMetaData({iconStyle: "sharp"});
-         expect(theme.iconStyle).toBe("sharp");
-      });
-
-      it("should accept two-tone iconStyle", () =>
-      {
-         const theme = new QThemeMetaData({iconStyle: "two-tone"});
-         expect(theme.iconStyle).toBe("two-tone");
-      });
-   });
-
-   describe("color properties", () =>
-   {
-      it("should handle hex color formats", () =>
-      {
-         const theme = new QThemeMetaData({
-            primaryColor: "#F00",
-            secondaryColor: "#00FF00",
-            errorColor: "#FF0000FF"
-         });
-
-         expect(theme.primaryColor).toBe("#F00");
-         expect(theme.secondaryColor).toBe("#00FF00");
-         expect(theme.errorColor).toBe("#FF0000FF");
-      });
-   });
-
-   describe("asset paths", () =>
-   {
-      it("should handle various path formats", () =>
-      {
-         const theme = new QThemeMetaData({
-            logoPath: "/assets/logo.svg",
-            iconPath: "https://example.com/icon.png",
-            faviconPath: "./favicon.ico"
-         });
-
-         expect(theme.logoPath).toBe("/assets/logo.svg");
-         expect(theme.iconPath).toBe("https://example.com/icon.png");
-         expect(theme.faviconPath).toBe("./favicon.ico");
-      });
-   });
-
-   describe("customCss", () =>
-   {
-      it("should handle multi-line CSS", () =>
-      {
-         const css = `
-            body {
-               margin: 0;
-               padding: 0;
-            }
-            .custom-class {
-               color: red;
-            }
-         `;
-         const theme = new QThemeMetaData({customCss: css});
-
-         expect(theme.customCss).toBe(css);
-      });
-   });
-});

tests/model/metaData/QWidgetMetaData.test.ts

@@ -0,0 +1,66 @@
+/*
+ * QQQ - Low-code Application Framework for Engineers.
+ * Copyright (C) 2021-2025.  Kingsrook, LLC
+ * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
+ * contact@kingsrook.com
+ * https://github.com/Kingsrook/
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import {QWidgetMetaData} from "../../../src/model/metaData/QWidgetMetaData";
+
+describe("QWidgetMetaData", () =>
+{
+   describe("constructor", () =>
+   {
+      it("should construct with collapsible object if set in source object", () =>
+      {
+         const widget = new QWidgetMetaData({
+            name: "widget1",
+            collapsible: {
+               isCollapsible: true,
+               initiallyOpen: false
+            }
+         });
+
+         expect(widget.name).toBe("widget1");
+         expect(widget.collapsible?.isCollapsible).toBe(true);
+         expect(widget.collapsible?.initiallyOpen).toBe(false);
+      });
+
+      it("should construct with undefined collapsible object if not present in source object", () =>
+      {
+         const widget = new QWidgetMetaData({
+            name: "widget2"
+         });
+
+         expect(widget.name).toBe("widget2");
+         expect(widget.collapsible).toBeUndefined();
+      });
+
+      it("should construct with collapsible object with null values if empty collapsible object is in source", () =>
+      {
+         const widget = new QWidgetMetaData({
+            name: "widget3",
+            collapsible: {}
+         });
+
+         expect(widget.name).toBe("widget3");
+         expect(widget.collapsible?.isCollapsible).toBe(false);
+         expect(widget.collapsible?.initiallyOpen).toBe(false);
+      });
+
+   });
+
+});

tests/model/query/QQueryFilter.test.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */