chore: empty commit to trigger workflow

2026-01-30 11:20:15 -06:00
78 changed files with 1425 additions and 1554 deletions
@@ -0,0 +1,71 @@
+---
+
+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\/.*/
@@ -1,4 +1,3 @@
 node_modules
 lib
 coverage
-lib-cjs
@@ -1,17 +0,0 @@
-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
@@ -1 +0,0 @@
-* @KofTwentyTwo
@@ -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 (Apache License, Version 2.0).
+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).

 ## 🙏 Thank You

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

-lib-cjs
@@ -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;.  &#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="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="myName" value="Kingsrook Copyright Profile" />
  </copyright>
 </component>
@@ -0,0 +1,4 @@
+# Public NPM Registry Configuration
+# All packages published to npmjs.org under @qrunio organization
+registry=https://registry.npmjs.org/
+@qrunio:registry=https://registry.npmjs.org/
@@ -68,18 +68,3 @@ 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.
@@ -35,17 +35,6 @@ 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';

@@ -163,4 +152,4 @@ Submit issues and PRs to the [main QQQ repository](https://github.com/QRun-IO/qq

 ## License

-Apache-2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE).
+AGPL-3.0
@@ -1,19 +0,0 @@
-# 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/).
@@ -1,46 +1,42 @@
-# 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
+# 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
@@ -1,16 +1,16 @@
 {
   "name": "@qrunio/qqq-frontend-core",
-   "version": "0.40.27-RC.1",
+   "version": "0.40.0-SNAPSHOT",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
      "": {
         "name": "@qrunio/qqq-frontend-core",
-         "version": "0.40.27-RC.1",
-         "license": "Apache-2.0",
+         "version": "0.40.0-SNAPSHOT",
+         "license": "ISC",
         "dependencies": {
-            "axios": "0.34.0",
-            "form-data": "4.0.6"
+            "axios": "0.28.1",
+            "form-data": "4.0.0"
         },
         "devDependencies": {
            "@types/jest": "^27.0.2",
@@ -29,14 +29,28 @@
            "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.29.7",
-         "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.7.tgz",
-         "integrity": "sha512-Aup7aUOfpbAUg2ROOJN6Iw5f9DMBlzu0mIkm/malLQFN/YQgO48wCj0Kxa3sEHJvPVFg7siR+qRInwXd2qhQKw==",
+         "version": "7.27.1",
+         "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.27.1.tgz",
+         "integrity": "sha512-cjQ7ZlQ0Mv3b47hABuTevyTuYN4i+loJKGeV9flcCgIK37cCXRh+L1bd3iBHlynerhQ7BhCkn2BPbQUL+rGqFg==",
         "dev": true,
         "license": "MIT",
         "dependencies": {
-            "@babel/helper-validator-identifier": "^7.29.7",
+            "@babel/helper-validator-identifier": "^7.27.1",
            "js-tokens": "^4.0.0",
            "picocolors": "^1.1.1"
         },
@@ -45,9 +59,9 @@
         }
      },
      "node_modules/@babel/compat-data": {
-         "version": "7.29.7",
-         "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.29.7.tgz",
-         "integrity": "sha512-locTkQyKvwIEgBzVrn8693ebc97F2U8ZHjbXwDXJ5Fn2TCpNwTlKcaKLkdHop5c/icOFE7qt7Q9JC5hnKNa6Gg==",
+         "version": "7.28.0",
+         "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.28.0.tgz",
+         "integrity": "sha512-60X7qkglvrap8mn1lh2ebxXdZYtUcpd7gsmy9kLaBJ4i/WdY8PqTSdxyA8qraikqKQK5C1KRBKXqznrVapyNaw==",
         "dev": true,
         "license": "MIT",
         "engines": {
@@ -55,22 +69,23 @@
         }
      },
      "node_modules/@babel/core": {
-         "version": "7.29.7",
-         "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.29.7.tgz",
-         "integrity": "sha512-RgHBCvtjbOK2gXSNBNIkNoEc9qoVEtau3hj8gEqKQuL3HZAibKarWFEI3Lfm6EYKkLalOh8eSrj9b+ch9H/VBA==",
+         "version": "7.28.3",
+         "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.28.3.tgz",
+         "integrity": "sha512-yDBHV9kQNcr2/sUr9jghVyz9C3Y5G2zUM2H2lo+9mKv4sFgbA8s8Z9t8D1jiTkGoO/NoIfKMyKWr4s6CN23ZwQ==",
         "dev": true,
         "license": "MIT",
+         "peer": true,
         "dependencies": {
-            "@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",
+            "@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",
            "convert-source-map": "^2.0.0",
            "debug": "^4.1.0",
            "gensync": "^1.0.0-beta.2",
@@ -103,14 +118,14 @@
         }
      },
      "node_modules/@babel/generator": {
-         "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==",
+         "version": "7.28.3",
+         "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.28.3.tgz",
+         "integrity": "sha512-3lSpxGgvnmZznmBkCRnVREPUFJv2wrv9iAoFDvADJc0ypmdOxdUtcLeBgBJ6zE0PMeTKnxeQzyk0xTBq4Ep7zw==",
         "dev": true,
         "license": "MIT",
         "dependencies": {
-            "@babel/parser": "^7.29.8",
-            "@babel/types": "^7.29.8",
+            "@babel/parser": "^7.28.3",
+            "@babel/types": "^7.28.2",
            "@jridgewell/gen-mapping": "^0.3.12",
            "@jridgewell/trace-mapping": "^0.3.28",
            "jsesc": "^3.0.2"
@@ -120,14 +135,14 @@
         }
      },
      "node_modules/@babel/helper-compilation-targets": {
-         "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==",
+         "version": "7.27.2",
+         "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.27.2.tgz",
+         "integrity": "sha512-2+1thGUUWWjLTYTHZWK1n8Yga0ijBz1XAhUXcKy81rd5g6yh7hGqMp45v7cadSbEHc9G3OTv45SyneRN3ps4DQ==",
         "dev": true,
         "license": "MIT",
         "dependencies": {
-            "@babel/compat-data": "^7.29.7",
-            "@babel/helper-validator-option": "^7.29.7",
+            "@babel/compat-data": "^7.27.2",
+            "@babel/helper-validator-option": "^7.27.1",
            "browserslist": "^4.24.0",
            "lru-cache": "^5.1.1",
            "semver": "^6.3.1"
@@ -147,9 +162,9 @@
         }
      },
      "node_modules/@babel/helper-globals": {
-         "version": "7.29.7",
-         "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.29.7.tgz",
-         "integrity": "sha512-3nQVUAtvkKH9zahfWgw96Jc/uFOmjACE1kQz82E2lqWmHBgjzbNlsC22nuQTfahmWeQtTq5nQ/4Nnd2A1wj4zA==",
+         "version": "7.28.0",
+         "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.28.0.tgz",
+         "integrity": "sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==",
         "dev": true,
         "license": "MIT",
         "engines": {
@@ -157,29 +172,29 @@
         }
      },
      "node_modules/@babel/helper-module-imports": {
-         "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==",
+         "version": "7.27.1",
+         "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.27.1.tgz",
+         "integrity": "sha512-0gSFWUPNXNopqtIPQvlD5WgXYI5GY2kP2cCvoT8kczjbfcfuIljTbcWrulD1CIPIX2gt1wghbDy08yE1p+/r3w==",
         "dev": true,
         "license": "MIT",
         "dependencies": {
-            "@babel/traverse": "^7.29.7",
-            "@babel/types": "^7.29.7"
+            "@babel/traverse": "^7.27.1",
+            "@babel/types": "^7.27.1"
         },
         "engines": {
            "node": ">=6.9.0"
         }
      },
      "node_modules/@babel/helper-module-transforms": {
-         "version": "7.29.7",
-         "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.29.7.tgz",
-         "integrity": "sha512-UPUVSyXbOh627KiCIGQSgwWzGeBKLkaJ9PJEdrngIwMSzxLR4jS4+f1f1jb7VzBbg8nFLaYotvVPFCTqdrmTAg==",
+         "version": "7.28.3",
+         "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.28.3.tgz",
+         "integrity": "sha512-gytXUbs8k2sXS9PnQptz5o0QnpLL51SwASIORY6XaBKF88nsOT0Zw9szLqlSGQDP/4TljBAD5y98p2U1fqkdsw==",
         "dev": true,
         "license": "MIT",
         "dependencies": {
-            "@babel/helper-module-imports": "^7.29.7",
-            "@babel/helper-validator-identifier": "^7.29.7",
-            "@babel/traverse": "^7.29.7"
+            "@babel/helper-module-imports": "^7.27.1",
+            "@babel/helper-validator-identifier": "^7.27.1",
+            "@babel/traverse": "^7.28.3"
         },
         "engines": {
            "node": ">=6.9.0"
@@ -199,9 +214,9 @@
         }
      },
      "node_modules/@babel/helper-string-parser": {
-         "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==",
+         "version": "7.27.1",
+         "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz",
+         "integrity": "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==",
         "dev": true,
         "license": "MIT",
         "engines": {
@@ -209,9 +224,9 @@
         }
      },
      "node_modules/@babel/helper-validator-identifier": {
-         "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==",
+         "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==",
         "dev": true,
         "license": "MIT",
         "engines": {
@@ -219,9 +234,9 @@
         }
      },
      "node_modules/@babel/helper-validator-option": {
-         "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==",
+         "version": "7.27.1",
+         "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.27.1.tgz",
+         "integrity": "sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg==",
         "dev": true,
         "license": "MIT",
         "engines": {
@@ -229,27 +244,27 @@
         }
      },
      "node_modules/@babel/helpers": {
-         "version": "7.29.10",
-         "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.29.10.tgz",
-         "integrity": "sha512-EMCx3AGZ3WfAl6ht7AyQoPm2Lh+BGYEMdc4Q6Hf7uSCDOZFuLq44qNwL+iaim8VlyYhRAo4X43+weadK8ZB4Yg==",
+         "version": "7.28.3",
+         "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.28.3.tgz",
+         "integrity": "sha512-PTNtvUQihsAsDHMOP5pfobP8C6CM4JWXmP8DrEIt46c3r2bf87Ua1zoqevsMo9g+tWDwgWrFP5EIxuBx5RudAw==",
         "dev": true,
         "license": "MIT",
         "dependencies": {
-            "@babel/template": "^7.29.7",
-            "@babel/types": "^7.29.8"
+            "@babel/template": "^7.27.2",
+            "@babel/types": "^7.28.2"
         },
         "engines": {
            "node": ">=6.9.0"
         }
      },
      "node_modules/@babel/parser": {
-         "version": "7.29.9",
-         "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.9.tgz",
-         "integrity": "sha512-CjXrNHTnvqBVqHgdBysY3vk2T8tpJHb5/RMeHJBTyVa9xgugCB0CJTx/3oO8RV2QRQP391RWpB7D6hLjm8V9uA==",
+         "version": "7.28.3",
+         "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.28.3.tgz",
+         "integrity": "sha512-7+Ey1mAgYqFAx2h0RuoxcQT5+MlG3GTV0TQrgr7/ZliKsm/MNDxVVutlWaziMq7wJNAz8MTqz55XLpWvva6StA==",
         "dev": true,
         "license": "MIT",
         "dependencies": {
-            "@babel/types": "^7.29.8"
+            "@babel/types": "^7.28.2"
         },
         "bin": {
            "parser": "bin/babel-parser.js"
@@ -505,33 +520,33 @@
         }
      },
      "node_modules/@babel/template": {
-         "version": "7.29.7",
-         "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.29.7.tgz",
-         "integrity": "sha512-puq+Gf35oI24FeN11LkoUQFqv9uwNeWpxXZi/Ji3rRIoKAzKnxRaZ+Gkj0vKS9ZCiTESfng1N9LyOyXvo+m+Gg==",
+         "version": "7.27.2",
+         "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.27.2.tgz",
+         "integrity": "sha512-LPDZ85aEJyYSd18/DkjNh4/y1ntkE5KwUHWTiqgRxruuZL2F1yuHligVHLvcHY2vMHXttKFpJn6LwfI7cw7ODw==",
         "dev": true,
         "license": "MIT",
         "dependencies": {
-            "@babel/code-frame": "^7.29.7",
-            "@babel/parser": "^7.29.7",
-            "@babel/types": "^7.29.7"
+            "@babel/code-frame": "^7.27.1",
+            "@babel/parser": "^7.27.2",
+            "@babel/types": "^7.27.1"
         },
         "engines": {
            "node": ">=6.9.0"
         }
      },
      "node_modules/@babel/traverse": {
-         "version": "7.29.10",
-         "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.29.10.tgz",
-         "integrity": "sha512-B3lYAs2nkKskbgQ1nfy8Ma9ao9Q1rntTAQHrzzyDuj+TSO+X3le6PfWwqDvodsb+OumE10eMFfuMCTQSQ5iuIQ==",
+         "version": "7.28.3",
+         "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.28.3.tgz",
+         "integrity": "sha512-7w4kZYHneL3A6NP2nxzHvT3HCZ7puDZZjFMqDpBPECub79sTtSO5CGXDkKrTQq8ksAwfD/XI2MRFX23njdDaIQ==",
         "dev": true,
         "license": "MIT",
         "dependencies": {
-            "@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",
+            "@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",
            "debug": "^4.3.1"
         },
         "engines": {
@@ -539,14 +554,14 @@
         }
      },
      "node_modules/@babel/types": {
-         "version": "7.29.8",
-         "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.8.tgz",
-         "integrity": "sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg==",
+         "version": "7.28.2",
+         "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.28.2.tgz",
+         "integrity": "sha512-ruv7Ae4J5dUYULmeXw1gmb7rYRz57OWCPM57pHojnLq/3Z1CK2lNSLTCVjxVk1F/TZHwOZZrOWi0ur95BbLxNQ==",
         "dev": true,
         "license": "MIT",
         "dependencies": {
-            "@babel/helper-string-parser": "^7.29.7",
-            "@babel/helper-validator-identifier": "^7.29.7"
+            "@babel/helper-string-parser": "^7.27.1",
+            "@babel/helper-validator-identifier": "^7.27.1"
         },
         "engines": {
            "node": ">=6.9.0"
@@ -635,9 +650,9 @@
         }
      },
      "node_modules/@istanbuljs/load-nyc-config/node_modules/js-yaml": {
-         "version": "3.15.2",
-         "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.15.2.tgz",
-         "integrity": "sha512-6EuL879VkRA+1Cz578mKMiKvjPNEuk6+r1JaFzoSWejZmtf7xWbIyw1e3KkxlkzTIt9Taw6JBhEppG7utc1P+w==",
+         "version": "3.14.1",
+         "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.1.tgz",
+         "integrity": "sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==",
         "dev": true,
         "license": "MIT",
         "dependencies": {
@@ -930,17 +945,6 @@
            "@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",
@@ -1125,6 +1129,7 @@
         "integrity": "sha512-mpT8LJJ4CMeeahobofYWIjFo0xonRS/HfxnVEPMPFSQdGUt1uHCnoPT7Zhb+sjDU2wz0oKV0OLUR0WzrHNgfeA==",
         "dev": true,
         "license": "MIT",
+         "peer": true,
         "dependencies": {
            "jest-matcher-utils": "^27.0.0",
            "pretty-format": "^27.0.0"
@@ -1225,6 +1230,7 @@
         "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",
@@ -1391,6 +1397,7 @@
         "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==",
         "dev": true,
         "license": "MIT",
+         "peer": true,
         "bin": {
            "acorn": "bin/acorn"
         },
@@ -1722,13 +1729,13 @@
         }
      },
      "node_modules/axios": {
-         "version": "0.34.0",
-         "resolved": "https://registry.npmjs.org/axios/-/axios-0.34.0.tgz",
-         "integrity": "sha512-CkOmqy7BaT4VC9+wRUmSM3LVwCkKK3UYc7koEqIHWRpOTJypwdNctaVOgnOjhHP3599Ubq2K8KqYwfC7c8NdPQ==",
+         "version": "0.28.1",
+         "resolved": "https://registry.npmjs.org/axios/-/axios-0.28.1.tgz",
+         "integrity": "sha512-iUcGA5a7p0mVb4Gm/sy+FSECNkPFT4y7wt6OM/CDpO/OnNCvSs3PoMG8ibrC9jRoGYU0gUK5pXVC4NPXq6lHRQ==",
         "license": "MIT",
         "dependencies": {
-            "follow-redirects": "^1.15.4",
-            "form-data": "^4.0.4",
+            "follow-redirects": "^1.15.0",
+            "form-data": "^4.0.0",
            "proxy-from-env": "^1.1.0"
         }
      },
@@ -1846,23 +1853,10 @@
         "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.21",
-         "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.21.tgz",
-         "integrity": "sha512-9zeA+KLZNNzglF2TPKRQEDyx6Yby7daAkuy8MiPzpXPsYDWi/DRM8jmwUDxokQjYqBpv5DgPiwD4h4ZZSy1Ujw==",
+         "version": "1.1.12",
+         "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz",
+         "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==",
         "dev": true,
         "license": "MIT",
         "dependencies": {
@@ -1891,9 +1885,9 @@
         "license": "BSD-2-Clause"
      },
      "node_modules/browserslist": {
-         "version": "4.29.3",
-         "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.29.3.tgz",
-         "integrity": "sha512-1R4kiYKXGViqEN0CnoDrXc1StD9niAwu+j2dukWzrD4bJgsD4lDmEp0CRbc6E/vYJIfTHwPmwyaKtVSudICdPA==",
+         "version": "4.25.3",
+         "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.25.3.tgz",
+         "integrity": "sha512-cDGv1kkDI4/0e5yON9yM5G/0A5u8sf5TnmdX5C9qHzI9PPu++sQ9zjm1k9NiOrf3riY4OkK0zSGqfvJyJsgCBQ==",
         "dev": true,
         "funding": [
            {
@@ -1910,12 +1904,12 @@
            }
         ],
         "license": "MIT",
+         "peer": true,
         "dependencies": {
-            "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"
+            "caniuse-lite": "^1.0.30001735",
+            "electron-to-chromium": "^1.5.204",
+            "node-releases": "^2.0.19",
+            "update-browserslist-db": "^1.1.3"
         },
         "bin": {
            "browserslist": "cli.js"
@@ -1977,6 +1971,7 @@
         "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",
@@ -2024,9 +2019,9 @@
         }
      },
      "node_modules/caniuse-lite": {
-         "version": "1.0.30001816",
-         "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001816.tgz",
-         "integrity": "sha512-+8Yx7BXCoqk6IF8yTicjfUR6D/ldJzdlsodlEOiOSPmhK844WIgk67/zIQaGAOxNkZyyvBlrRFnLvqKIoqbAFw==",
+         "version": "1.0.30001737",
+         "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001737.tgz",
+         "integrity": "sha512-BiloLiXtQNrY5UyF0+1nSJLXUENuhka2pzy2Fx5pGxqavdrxSCW4U6Pn/PoG3Efspi2frRbHpBV2XsrPE6EDlw==",
         "dev": true,
         "funding": [
            {
@@ -2475,6 +2470,7 @@
         "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",
@@ -2486,9 +2482,9 @@
         }
      },
      "node_modules/electron-to-chromium": {
-         "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==",
+         "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==",
         "dev": true,
         "license": "ISC"
      },
@@ -2595,6 +2591,7 @@
         "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"
@@ -2604,6 +2601,7 @@
         "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"
@@ -2613,6 +2611,7 @@
         "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"
@@ -2625,6 +2624,7 @@
         "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,6 +2719,7 @@
         "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",
@@ -2895,6 +2896,7 @@
         "integrity": "sha512-/KJBASVFxpu0xg1kIBn9AUa8hQVnszpwgE7Ld0lKAlx7Ie87yzEzCgSkekt+le/YVhiaosO4Y14GDAOc41nfxA==",
         "dev": true,
         "license": "MIT",
+         "peer": true,
         "dependencies": {
            "array-includes": "^3.1.4",
            "array.prototype.flat": "^1.2.5",
@@ -2953,6 +2955,7 @@
         "integrity": "sha512-sVCFKX9fllURnXT2JwLN5Qgo24Ug5NF6dxhkmxsMEUZhXRcGg+X3e1JbJ84YePQKBl5E0ZjAH5Q4rkdcGY99+g==",
         "dev": true,
         "license": "MIT",
+         "peer": true,
         "dependencies": {
            "@babel/runtime": "^7.16.3",
            "aria-query": "^4.2.2",
@@ -2980,6 +2983,7 @@
         "integrity": "sha512-IOlFIRHzWfEQQKcAD4iyYDndHwTQiCMcJVJjxempf203jnNLUnW34AXLrV33+nEXoifJE2ZEGmcjKPL8957eSw==",
         "dev": true,
         "license": "MIT",
+         "peer": true,
         "dependencies": {
            "array-includes": "^3.1.4",
            "array.prototype.flatmap": "^1.2.5",
@@ -3009,6 +3013,7 @@
         "integrity": "sha512-XslZy0LnMn+84NEG9jSGR6eGqaZB3133L8xewQo3fQagbQuGt7a63gf+P1NGKZavEYEC3UXaWEAA/AqDkuN6xA==",
         "dev": true,
         "license": "MIT",
+         "peer": true,
         "engines": {
            "node": ">=10"
         },
@@ -3394,16 +3399,16 @@
         }
      },
      "node_modules/flatted": {
-         "version": "3.4.4",
-         "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.4.4.tgz",
-         "integrity": "sha512-5+ybhBZANEJxaH3X5evAFatUxLfEHSr7n6kYJ+1Qd0mUqr4eu9gIf6GDbWHf8RJijHrjjO8G+la14SlL2SeS1Q==",
+         "version": "3.3.3",
+         "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.3.3.tgz",
+         "integrity": "sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==",
         "dev": true,
         "license": "ISC"
      },
      "node_modules/follow-redirects": {
-         "version": "1.16.1",
-         "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.16.1.tgz",
-         "integrity": "sha512-FNvFGzoMLWmE6Yj9spb/zjd7yiNCHiAW9/Tg9CXrQ8wuu32HtlJOwWO11OJafl5FfY3DxTdQ0vj42zU1kvv5jg==",
+         "version": "1.15.11",
+         "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.11.tgz",
+         "integrity": "sha512-deG2P0JfjrTxl50XGCDyfI97ZGVCxIpfKYmfyrQ54n5FO/0gfIES8C/Psl6kWVDolizcaaxZJnTS0QSMxvnsBQ==",
         "funding": [
            {
               "type": "individual",
@@ -3437,16 +3442,14 @@
         }
      },
      "node_modules/form-data": {
-         "version": "4.0.6",
-         "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.6.tgz",
-         "integrity": "sha512-vKatAh4SlVfgbv+YtmhiRjhEMJsYpsG1Y2rMQtR+SVSbytsSD1YGzDIcrAJmdFec88u/+VoGmxnl+80gL1tRCQ==",
+         "version": "4.0.0",
+         "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.0.tgz",
+         "integrity": "sha512-ETEklSGi5t0QMZuiXoA/Q6vcnxcLQP5vdugSpuAyi6SVGi2clPPp+xgEhuMaHC+zGgn31Kd235W35f7Hykkaww==",
         "license": "MIT",
         "dependencies": {
            "asynckit": "^0.4.0",
            "combined-stream": "^1.0.8",
-            "es-set-tostringtag": "^2.1.0",
-            "hasown": "^2.0.4",
-            "mime-types": "^2.1.35"
+            "mime-types": "^2.1.12"
         },
         "engines": {
            "node": ">= 6"
@@ -3478,6 +3481,7 @@
         "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"
@@ -3545,6 +3549,7 @@
         "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",
@@ -3579,6 +3584,7 @@
         "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",
@@ -3712,6 +3718,7 @@
         "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"
@@ -3793,6 +3800,7 @@
         "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"
@@ -3805,6 +3813,7 @@
         "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"
@@ -3817,9 +3826,10 @@
         }
      },
      "node_modules/hasown": {
-         "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==",
+         "version": "2.0.2",
+         "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
+         "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
+         "dev": true,
         "license": "MIT",
         "dependencies": {
            "function-bind": "^1.1.2"
@@ -4537,6 +4547,7 @@
         "integrity": "sha512-Yn0mADZB89zTtjkPJEXwrac3LHudkQMR+Paqa8uxJHCBr9agxztUifWCyiYrjhMPBoUVBjyny0I7XH6ozDr7QQ==",
         "dev": true,
         "license": "MIT",
+         "peer": true,
         "dependencies": {
            "@jest/core": "^27.5.1",
            "import-local": "^3.0.2",
@@ -5193,20 +5204,10 @@
         "license": "MIT"
      },
      "node_modules/js-yaml": {
-         "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==",
+         "version": "4.1.0",
+         "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz",
+         "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==",
         "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"
@@ -5263,16 +5264,16 @@
         }
      },
      "node_modules/jsdom/node_modules/form-data": {
-         "version": "3.0.5",
-         "resolved": "https://registry.npmjs.org/form-data/-/form-data-3.0.5.tgz",
-         "integrity": "sha512-j23EibVLnp4zNXGW7LjryXYa2X6U/M96yoOX+ybZxwkYajdxRNEqYY3zhh7y0i6kfISKS2jr+EJq1YTUDEv5+w==",
+         "version": "3.0.4",
+         "resolved": "https://registry.npmjs.org/form-data/-/form-data-3.0.4.tgz",
+         "integrity": "sha512-f0cRzm6dkyVYV3nPoooP8XlccPQukegwhAnpoLcXy+X+A8KfpGOoXwDr9FLZd3wzgLaBGQBE3lY93Zm/i1JvIQ==",
         "dev": true,
         "license": "MIT",
         "dependencies": {
            "asynckit": "^0.4.0",
            "combined-stream": "^1.0.8",
            "es-set-tostringtag": "^2.1.0",
-            "hasown": "^2.0.4",
+            "hasown": "^2.0.2",
            "mime-types": "^2.1.35"
         },
         "engines": {
@@ -5434,9 +5435,9 @@
         }
      },
      "node_modules/lodash": {
-         "version": "4.18.1",
-         "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.18.1.tgz",
-         "integrity": "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==",
+         "version": "4.17.21",
+         "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz",
+         "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==",
         "dev": true,
         "license": "MIT"
      },
@@ -5514,6 +5515,7 @@
         "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"
@@ -5582,9 +5584,9 @@
         }
      },
      "node_modules/minimatch": {
-         "version": "3.1.5",
-         "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz",
-         "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==",
+         "version": "3.1.2",
+         "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
+         "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
         "dev": true,
         "license": "ISC",
         "dependencies": {
@@ -5626,14 +5628,11 @@
         "license": "MIT"
      },
      "node_modules/node-releases": {
-         "version": "2.0.58",
-         "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.58.tgz",
-         "integrity": "sha512-BdiKAgbfRlvfMq/XzO/AF9NPmaA8a+YpLAyAFTVFBj3gARrAIfWvNq7Q7NE4se3KgFu0KkrvQMxTS0XVnsGzHg==",
+         "version": "2.0.19",
+         "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.19.tgz",
+         "integrity": "sha512-xxOWJsBKtzAq7DY0J+DTzuz58K8e7sJbdgwkbMWQe8UYB6ekmsQ45q0M/tJDsGaZmbC+l7n57UV8Hl5tHxO9uw==",
         "dev": true,
-         "license": "MIT",
-         "engines": {
-            "node": ">=18"
-         }
+         "license": "MIT"
      },
      "node_modules/normalize-path": {
         "version": "3.0.0",
@@ -5986,9 +5985,9 @@
         "license": "ISC"
      },
      "node_modules/picomatch": {
-         "version": "2.3.2",
-         "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz",
-         "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==",
+         "version": "2.3.1",
+         "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz",
+         "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==",
         "dev": true,
         "license": "MIT",
         "engines": {
@@ -7225,6 +7224,7 @@
         "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.3.4",
-         "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.3.4.tgz",
-         "integrity": "sha512-t8wonIOdQyOjtPd2VktlBu6QjTVTks6v8bSi7kd0r2Vll8TK1JYDZtRRdbmCHOAMphkZgrzK+L+vXK4pyZ8t4A==",
+         "version": "1.1.3",
+         "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.1.3.tgz",
+         "integrity": "sha512-UxhIZQ+QInVdunkDAaiazvvT/+fXL5Osr0JZlJulepYu6Jd7qJtDZjlur0emRlT71EN3ScPoE7gvsuIKKNavKw==",
         "dev": true,
         "funding": [
            {
@@ -7583,9 +7583,9 @@
         }
      },
      "node_modules/ws": {
-         "version": "7.5.13",
-         "resolved": "https://registry.npmjs.org/ws/-/ws-7.5.13.tgz",
-         "integrity": "sha512-rsKI6xDBFVf4r/x8XyChGK04QR/XHroxs/jUcoWvtEZM8TPU/X/uIY9B1CsSzYws9ZJb/6bbBu7dPhFW00CAoA==",
+         "version": "7.5.10",
+         "resolved": "https://registry.npmjs.org/ws/-/ws-7.5.10.tgz",
+         "integrity": "sha512-+dbF1tHwZpXcbOJdVOkzLDxZP1ailvSxM6ZweXTegylPny803bFhA+vqBYw4s31NSAk4S2Qz+AKXK9a4wkdjcQ==",
         "dev": true,
         "license": "MIT",
         "engines": {
@@ -1,39 +1,36 @@
 {
   "name": "@qrunio/qqq-frontend-core",
-   "version": "0.40.27-RC.1",
+   "version": "0.40.4-SNAPSHOT",
   "description": "",
-   "main": "lib-cjs/qqq-frontend-core.js",
-   "module": "lib/qqq-frontend-core.js",
-   "types": "lib/qqq-frontend-core.d.ts",
+   "main": "qqq-frontend-core.js",
+   "module": "lib/qqq-frontend-core.esm.js",
   "scripts": {
      "delete-modules": "rm -rf node_modules; rm package-lock.json",
      "lint": "eslint . --ext .ts",
      "npm-install": "npm install",
-      "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/",
+      "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/",
      "test": "jest",
      "yalc-push": "npm run prepublishOnly && yalc push --private",
      "yalc-watch": "yalc-watch"
   },
   "dependencies": {
-      "axios": "0.34.0",
-      "form-data": "4.0.6"
+      "axios": "0.28.1",
+      "form-data": "4.0.0"
   },
   "keywords": [],
   "files": [
      "lib",
-      "lib-cjs",
-      "package.json",
-      "NOTICE"
+      "package.json"
   ],
   "author": "Kingsrook LLC",
-   "license": "Apache-2.0",
+   "license": "ISC",
   "repository": {
      "type": "git",
-      "url": "https://github.com/QRun-IO/qqq-frontend-core"
+      "url": "https://github.com/Kingsrook/qqq-frontend-core"
   },
   "publishConfig": {
-      "registry": "https://git.kof22.com/api/packages/QRun-IO/npm/"
+      "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
      "@types/jest": "^27.0.2",
@@ -1,7 +0,0 @@
-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});
-}
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {AxiosError, AxiosRequestConfig, AxiosResponse} from "axios";
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {AxiosError, AxiosResponse} from "axios";
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */


@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */


@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */


@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */

 /*******************************************************************************
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */

 /*******************************************************************************
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */

 /*******************************************************************************
@@ -1,50 +0,0 @@
-/*
- * 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);
-   }
-}
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {AdornmentType} from "./AdornmentType";
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {QFieldMetaData} from "./QFieldMetaData";
@@ -5,22 +5,22 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {QAppSection} from "./QAppSection";
 import {QAppTreeNode} from "./QAppTreeNode";
-import {QHelpContent} from "./QHelpContent";

 /*******************************************************************************
 ** Meta-Data to define an app in a QQQ instance.
@@ -36,7 +36,6 @@ export class QAppMetaData
   widgets?: string[];
   sections?: QAppSection[];
   supplementalAppMetaData: Map<String, any> = new Map();
-   helpContent?: Map<string, QHelpContent[]>;

   constructor(object: any)
   {
@@ -65,17 +64,13 @@ 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);
-      }
   }
+
 }
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */

 /*******************************************************************************
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {QIcon} from "./QIcon";
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {QAppNodeType} from "./QAppNodeType";
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */

 /*******************************************************************************
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {Banner} from "./Banner";
@@ -32,8 +33,6 @@ export class QBrandingMetaData
   logo?: string;
   icon?: string;
   accentColor?: string;
-   accentColorLight?: string;
-   gravatarDefault?: string;

   // Deprecated
   environmentBannerText?: string;
@@ -51,8 +50,6 @@ 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;

@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */

 /*******************************************************************************
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {QJoinMetaData} from "./QJoinMetaData";
@@ -35,11 +36,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]));
      }
@@ -50,12 +51,12 @@ export class QExposedJoin
    ***************************************************************************/
   public clone(): QExposedJoin
   {
-      const joinTableClone = this.joinTable?.clone();
+      const joinTableClone = (this.joinTable as any).clone();

      const joinPathClone: QJoinMetaData[] = [];
-      for (let joinMetaData of this.joinPath ?? [])
+      for (let joinMetaData of this.joinPath)
      {
-         joinPathClone.push(joinMetaData.clone());
+         joinPathClone.push((joinMetaData as any).clone());
      }

      const clone = new QExposedJoin({
@@ -63,9 +64,6 @@ 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);
   }
 }
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {QPossibleValue} from "../QPossibleValue";
@@ -90,12 +91,11 @@ export class QFieldMetaData
      this.helpContents = QHelpContent.buildArray(object.helpContents);
      this.behaviors = object.behaviors;

-      const supplementalFieldMetaData = object.supplementalFieldMetaData || object.supplementalMetaData;
-      if (supplementalFieldMetaData)
+      if (object.supplementalFieldMetaData)
      {
-         for (const key in supplementalFieldMetaData)
+         for (const key in object.supplementalFieldMetaData)
         {
-            this.supplementalFieldMetaData.set(key, supplementalFieldMetaData[key]);
+            this.supplementalFieldMetaData.set(key, object.supplementalFieldMetaData[key]);
         }
      }

@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */

 /*******************************************************************************
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {QComponentType} from "./QComponentType";
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {QFieldMetaData} from "./QFieldMetaData";
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */

 /*******************************************************************************
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */

 /*******************************************************************************
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {QAppMetaData} from "./QAppMetaData";
@@ -26,6 +27,7 @@ import {QHelpContent} from "./QHelpContent";
 import {QProcessMetaData} from "./QProcessMetaData";
 import {QReportMetaData} from "./QReportMetaData";
 import {QTableMetaData} from "./QTableMetaData";
+import {QThemeMetaData} from "./QThemeMetaData";
 import {QWidgetMetaData} from "./QWidgetMetaData";

 /*******************************************************************************
@@ -41,6 +43,7 @@ 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();
@@ -123,6 +126,11 @@ 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);
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */

 /*******************************************************************************
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {QIcon} from "./QIcon";
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {QIcon} from "./QIcon";
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {QFrontendStepMetaData} from "./QFrontendStepMetaData";
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */

 /*******************************************************************************
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {QExposedJoin} from "./QExposedJoin";
@@ -23,7 +24,6 @@ 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, QVirtualFieldMetaData>;
+   virtualFields?: Map<string, QFieldMetaData>;
   iconName?: string;
   sections?: QTableSection[];
   exposedJoins?: QExposedJoin[];
@@ -77,10 +77,10 @@ export class QTableMetaData

      if (object.virtualFields)
      {
-         this.virtualFields = new Map<string, QVirtualFieldMetaData>();
+         this.virtualFields = new Map<string, QFieldMetaData>();
         for (const key in object.virtualFields)
         {
-            this.virtualFields.set(key, new QVirtualFieldMetaData(object.virtualFields[key]));
+            this.virtualFields.set(key, new QFieldMetaData(object.virtualFields[key]));
         }
      }

@@ -5,20 +5,20 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {Collapsible} from "./Collapsible";
 import {QHelpContent} from "./QHelpContent";

 /*******************************************************************************
@@ -37,7 +37,6 @@ export class QTableSection
   gridColumns?: number;
   helpContents?: QHelpContent[];
   alternatives?: Map<string, QTableSection>;
-   collapsible?: Collapsible;


   /*******************************************************************************
@@ -69,11 +68,6 @@ export class QTableSection
            this.alternatives.set(type, new QTableSection(object.alternatives[type]));
         }
      }
-
-      if (object.collapsible)
-      {
-         this.collapsible = new Collapsible(object.collapsible);
-      }
   }

   /***************************************************************************
@@ -103,14 +97,11 @@ 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);
   }
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */

 /*******************************************************************************
@@ -0,0 +1,312 @@
+/*
+ * 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;
+   }
+}
@@ -1,63 +0,0 @@
-/*
- * 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);
-   }
-}
@@ -5,20 +5,20 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {Collapsible} from "./Collapsible";
 import {QHelpContent} from "./QHelpContent";
 import {QIcon} from "./QIcon";

@@ -51,7 +51,6 @@ export class QWidgetMetaData

   helpContent?: Map<string, QHelpContent[]>;
   defaultValues?: Map<string, any>;
-   collapsible?: Collapsible;

   constructor(object: any)
   {
@@ -90,9 +89,5 @@ export class QWidgetMetaData
         }
      }

-      if (object.collapsible)
-      {
-         this.collapsible = new Collapsible(object.collapsible);
-      }
   }
 }
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {ProcessMetaDataAdjustment} from "../metaData/ProcessMetaDataAdjustment";
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */

 /*******************************************************************************
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */

 /*******************************************************************************
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */

 /*******************************************************************************
@@ -1,53 +0,0 @@
-/*
- * 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);
-   }
-}
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */


@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */


@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */


@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */

 /*******************************************************************************
@@ -5,20 +5,20 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {FieldFunction} from "./FieldFunction";
 import {QCriteriaOperator} from "./QCriteriaOperator";

 /*******************************************************************************
@@ -31,7 +31,6 @@ export class QFilterCriteria
   operator: QCriteriaOperator;
   values!: any[];
   otherFieldName?: string;
-   fieldFunction?: FieldFunction;

   constructor(fieldName: string, operator: QCriteriaOperator, values: any[])
   {
@@ -52,14 +51,7 @@ export class QFilterCriteria
         this.operator,
         cloneValues
      );
-
      clone.otherFieldName = this.otherFieldName;
-
-      if(this.fieldFunction)
-      {
-         clone.fieldFunction = this.fieldFunction.clone();
-      }
-
      return (clone);
   }
 }
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */

 /*******************************************************************************
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {QFilterCriteria} from "./QFilterCriteria";
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */

 /*******************************************************************************
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */


@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {QController} from "./controllers/QController";
@@ -23,7 +24,7 @@ import {QFieldMetaData} from "./model/metaData/QFieldMetaData";
 import {QFieldType} from "./model/metaData/QFieldType";
 import {QTableMetaData} from "./model/metaData/QTableMetaData";

-export {
+module.exports = {
   QController,
   QTableMetaData,
   QFieldMetaData,
@@ -1,32 +0,0 @@
-/*
- * 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();
-   });
-});
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 axios from "axios";
@@ -1,125 +0,0 @@
-/*
- * 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");
-   });
-});
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {QInstance} from "../../src/model/metaData/QInstance";
@@ -1,63 +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/
- *
- * 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);
-      });
-   });
-});
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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 {QAppMetaData} from "../../../src/model/metaData/QAppMetaData";
@@ -1,104 +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/
- *
- * 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();
-      });
-   });
-
-});
@@ -0,0 +1,216 @@
+/*
+ * 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);
+      });
+   });
+});
@@ -1,66 +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/
- *
- * 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);
-      });
-
-   });
-
-});
@@ -5,17 +5,18 @@
 * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */


@@ -1,21 +1,22 @@
 /*
 * QQQ - Low-code Application Framework for Engineers.
- * Copyright (C) 2021-2026.  Kingsrook, LLC
+ * 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
+ * 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.
 *
- *     https://www.apache.org/licenses/LICENSE-2.0
+ * 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.
 *
- * 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.
+ * 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/>.
 */


@@ -23,70 +24,9 @@ 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", () =>
   {
      /////////////////////////////////////
@@ -191,7 +131,7 @@ describe("QTableMetaData tests", () =>
                        "contentAsHtml": "Field Help"
                     }
                  ],
-                  "supplementalMetaData": {
+                  "supplementalFieldMetaData": {
                     "materialDashboard": {
                        "formAdjusterIdentifier": "table:connection;field:externalSystemId",
                        "onChangeFormAdjuster": {
@@ -219,7 +159,7 @@ describe("QTableMetaData tests", () =>
                  "gridColumns": -1,
                  "displayFormat": "%s",
                  "possibleValueSourceName": "type",
-                  "supplementalMetaData": {
+                  "supplementalFieldMetaData": {
                     "materialDashboard": {
                        "formAdjusterIdentifier": "table:myTable;field:type",
                        "onChangeFormAdjuster": {
@@ -231,32 +171,6 @@ 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",
@@ -282,27 +196,7 @@ describe("QTableMetaData tests", () =>
                  "isHidden": false
               },
            ],
-            "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": []}
-                  ]
-               }
-            ],
+            "exposedJoins": [],
            "supplementalTableMetaData": {
               "materialDashboard": {
                  "onLoadFormAdjuster": {
@@ -357,9 +251,6 @@ 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);
@@ -387,11 +278,6 @@ 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 //
      ////////////////////////////////////////////////////////////////////////////////////////////////
@@ -402,20 +288,11 @@ describe("QTableMetaData tests", () =>
      ///////////////////////////////////////////////////////////////////////////////////////////
      cloneTable.name = "changed";
      expect(cloneTable.name).not.toEqual(table.name);
-
-      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;
+      if (cloneTable.sections)
+      {
+         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);
@@ -423,14 +300,21 @@ describe("QTableMetaData tests", () =>
      cloneTable.capabilities.delete("TABLE_COUNT");
      expect(cloneTable.capabilities.size).not.toEqual(table.capabilities.size);

-      cloneTable.helpContent?.set("key2", []);
-      expect(cloneTable.helpContent?.size).not.toEqual(table.helpContent?.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?.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);
+         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.sections?.[0]?.fieldNames?.push("foobar");
      expect(cloneTable.sections?.[0]?.fieldNames?.length).not.toEqual(table.sections?.[0]?.fieldNames?.length);
@@ -447,4 +331,4 @@ describe("QTableMetaData tests", () =>
      expect(cloneTable.menus?.length).not.toEqual(table.menus?.length);
   });

-});
+});