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

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

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

.circleci/config.yml

@@ -1,14 +0,0 @@
-version: 2.1
-setup: true
-orbs:
-  qqq-orb: kingsrook/qqq-orb@0.8
-workflows:
-  setup:
-    jobs:
-    - qqq-orb/generate_pipeline:
-        orb_version: '0.8'
-        filters:
-          branches:
-            ignore: automation/qbit-rc-pending
-          tags:
-            only: /.*/

.eslintignore

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

.gitea/workflows/build.yaml

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

.gitea/workflows/qrun-release.yaml

@@ -1,37 +0,0 @@
-name: QRun original Node release
-on:
-  push:
-    branches: ['**']
-  create:
-  workflow_dispatch:
-# Thin caller default stays READ.
-permissions:
-  contents: read
-  actions: read
-jobs:
-  release:
-    # Tag creation bypasses the forge's [skip ci] push suppression. Push is branch-only, so a tag has one route.
-    if: ${{ github.event_name != 'create' || (github.event.ref_type == 'tag' && github.event.ref == github.ref && (startsWith(github.ref, 'refs/tags/publish') || startsWith(github.ref, 'refs/tags/v'))) }}
-    # Ceiling only: the callee's isolated version and cleanup jobs declare their own contents: write; every other callee job is READ.
-    # No NPM_TOKEN, no OIDC, no registry secret is passed. Not rolled out to any caller.
-    permissions:
-      contents: write
-      actions: read
-    uses: self:KofTwentyTwo/platform-ci/.gitea/workflows/qrun-node-release.yaml@qrun-release-v1
-    with:
-      runner: linux-small
-  postpublish:
-    needs: release
-    if: ${{ success() && needs.release.outputs.computed-version != '' }}
-    permissions:
-      contents: write
-      actions: read
-    uses: self:KofTwentyTwo/platform-ci/.gitea/workflows/qrun-node-finalize.yaml@qrun-release-v1
-    with:
-      runner: linux-small
-      mode: ${{ needs.release.outputs.mode }}
-      version: ${{ needs.release.outputs.computed-version }}
-      dist-tag: ${{ needs.release.outputs.dist-tag }}
-      built-commit: ${{ needs.release.outputs.built-commit }}
-      build-job-id: ${{ needs.release.outputs.build-job-id }}
-      run-attempt: ${{ needs.release.outputs.run-attempt }}

.github/CODEOWNERS

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

.github/CONTRIBUTING.md

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

.github/release.yml

@@ -1,38 +0,0 @@
-# GitHub Release Configuration
-# Auto-generates release notes from PR labels
-
-changelog:
-  exclude:
-    labels:
-      - ignore-for-release
-      - duplicate
-      - invalid
-    authors:
-      - dependabot
-      - dependabot[bot]
-  categories:
-    - title: Breaking Changes
-      labels:
-        - breaking-change
-        - breaking
-    - title: New Features
-      labels:
-        - enhancement
-        - feature
-    - title: Bug Fixes
-      labels:
-        - bug
-        - fix
-    - title: Performance Improvements
-      labels:
-        - performance
-    - title: Documentation
-      labels:
-        - documentation
-        - docs
-    - title: Dependencies
-      labels:
-        - dependencies
-    - title: Other Changes
-      labels:
-        - "*"

.gitignore

@@ -1,5 +1,7 @@
 *.iml
 .env
+.yalc
+yalc*
 
 node_modules
 coverage
@@ -11,3 +13,8 @@ lib
 
 **/.DS_Store
 *.iml
+
+# Claude Code local settings
+.claude/
+
+lib-cjs

.idea/copyright/Kingsrook_Copyright_Profile.xml

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

.npmrc

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

.qqq-ci.yml

@@ -1,4 +0,0 @@
-profile: frontend-core
-orb_version: '0.8'
-default_branch: develop
-node_version: '24.21'

.session-state.md

@@ -0,0 +1,38 @@
+# Session State - qqq-frontend-core
+
+## Last Session
+- **Date:** 2026-01-12
+- **Branch:** develop
+- **Version:** 0.40.2-SNAPSHOT (auto-bumped by CI)
+- **Status:** All tasks complete, ready to continue
+
+## Completed This Session
+
+### 1. qqq-frontend-core (npm)
+- Fixed stale `lib/` build issue (theme properties were missing)
+- Committed `f60d45c`: fix(build): ensure yalc-push rebuilds lib before pushing
+- Pipeline #341 succeeded
+- Published `@qrunio/qqq-frontend-core@0.40.1-SNAPSHOT` to npm
+- Verified 90+ QThemeMetaData properties in published package
+
+### 2. qqq-frontend-material-dashboard (Maven)
+- Bumped to `0.40.1-SNAPSHOT` (commit `aadcb599`)
+- Fixed BOM dependency: `qqq.version=0.40.0-SNAPSHOT` (commit `cb6331a`)
+- Pipeline #1370 succeeded (21 min, includes Playwright tests)
+- Published to Maven Central snapshots
+
+### 3. Views Dropdown Investigation
+- **Not a bug** - permission-based visibility
+- Requires `querySavedView`, `storeSavedView`, `deleteSavedView` process permissions
+- Documented in `docs/troubleshooting.md`
+
+## Current State
+- All frontend artifacts at 0.40.1-SNAPSHOT and published
+- No pending code changes
+- Documentation created in `docs/` and `CLAUDE.md`
+
+## To Continue
+Say "continue from last session" - Claude will read this file and CLAUDE.md.
+
+## Open Items
+None - all tasks complete.

CLAUDE.md

@@ -0,0 +1,85 @@
+# QQQ Frontend Core - Project Context
+
+## Overview
+TypeScript client library for QQQ frontends. Framework-agnostic (React, Vue, Angular, plain JS).
+
+- **Package:** `@qrunio/qqq-frontend-core`
+- **Registry:** npm
+- **Current Version:** 0.40.1-SNAPSHOT
+
+## Build System
+
+### Key Scripts
+```bash
+npm run prepublishOnly  # Clean rebuild: rm -rf lib/ && tsc -p ./ --outDir lib/
+npm run yalc-push       # Local dev: rebuild + yalc push
+```
+
+### Build Guarantee
+The `prepublishOnly` npm lifecycle hook ensures `lib/` is always rebuilt before publishing. This prevents stale build issues.
+
+## Related Repositories
+
+| Repo | Type | Relationship |
+|------|------|--------------|
+| `qqq-frontend-material-dashboard` | Maven JAR | React frontend, depends on this library |
+| `qqq` | Maven multi-module | Backend framework |
+
+## Version Strategy
+Frontend repos can version independently from backend:
+- `qqq-frontend-core` and `qqq-frontend-material-dashboard` share version (currently 0.40.1-SNAPSHOT)
+- `qqq-frontend-material-dashboard` can use different `qqq.version` for backend deps (currently 0.40.0-SNAPSHOT)
+
+## Key Classes
+
+### QInstance (`src/model/metaData/QInstance.ts`)
+Main metaData container. Contains:
+- `tables: Map<string, QTableMetaData>`
+- `processes: Map<string, QProcessMetaData>`
+- `reports`, `widgets`, `apps`, `branding`, `theme`, etc.
+
+### QThemeMetaData (`src/model/metaData/QThemeMetaData.ts`)
+90+ theme properties for UI customization. Includes colors, typography, component-specific styling.
+
+## CI/CD
+
+- **Platform:** CircleCI
+- **Orb:** `kingsrook/qqq-orb`
+- **Workflows:**
+  - `test_only` - feature branches
+  - `publish_snapshot` - develop branch
+  - `publish_release` - main branch + tags
+
+## Common Issues
+
+### Stale lib/ Build
+**Symptom:** Published package missing recent changes
+**Cause:** `lib/` not rebuilt before publish
+**Fix:** `prepublishOnly` hook handles this automatically
+
+### Views Dropdown Missing (Frontend)
+**Symptom:** "Views" dropdown not showing on table pages
+**Cause:** Permission-based visibility - requires process permissions
+**Fix:** Grant permissions for:
+- `querySavedView` (required to show dropdown)
+- `storeSavedView` (save functionality)
+- `deleteSavedView` (delete functionality)
+
+## Session Continuity
+Session state is stored in `.session-state.md` (local to this repo).
+To continue: say "continue from last session"
+
+## Knowledge base
+
+Durable knowledge about this repo lives in the second-brain vault
+(`$SECOND_BRAIN_VAULT`, i.e. `R:/Git.Local/KofTwentyTwo/second-brain`):
+
+- QQQ domain hub: `knowledge/qqq/qqq-hub.md`
+- This repo's dossier: `knowledge/qqq/repos/qqq-frontend-core.md`
+  (endpoint map legacy vs `/qqq/v1`, npm version history, division of labor
+  vs material-dashboard, known bugs/risks)
+
+Dossier reviewed at commit `e234e3028c8d` (branch `develop`,
+0.40.13-SNAPSHOT, 2026-07-04). Consult the dossier before re-deriving
+architecture from source; update it when controllers, endpoints, or
+publishing change.

README.md

@@ -1,516 +1,166 @@
-# QQQ Frontend Core
+# qqq-frontend-core
 
-[![Version](https://img.shields.io/badge/version-1.0.128-blue.svg)](https://github.com/Kingsrook/qqq-frontend-core)
-[![License](https://img.shields.io/badge/license-GNU%20Affero%20GPL%20v3-green.svg)](https://www.gnu.org/licenses/agpl-3.0.en.html)
-[![TypeScript](https://img.shields.io/badge/TypeScript-4.4.4-blue.svg)](https://www.typescriptlang.org/)
-[![NPM Package](https://img.shields.io/badge/npm-%40qrunio%2Fqqq--frontend--core-red.svg)](https://www.npmjs.com/package/@qrunio/qqq-frontend-core)
+TypeScript client library for building frontends on QQQ applications.
 
-> **Core Frontend Library for QQQ - Low-code Application Framework for Engineers**
+**For:** Developers building custom UIs or integrating QQQ into existing applications  
+**Status:** Stable
 
-A TypeScript/JavaScript library that provides the core client-side functionality for interacting with QQQ backend servers. This library is framework-agnostic and can be used in any JavaScript environment, including React, Vue, Angular, or vanilla JavaScript applications.
+## Why This Exists
 
-## 🚀 Overview
+QQQ applications expose a backend API for metadata, records, and processes. If you're building a custom frontend instead of using the standard dashboard, you need a client that:
 
-QQQ Frontend Core is the **foundational library** that enables frontend applications to communicate with QQQ backend servers. It provides:
+- Understands QQQ's metadata-driven architecture
+- Handles authentication flows (OAuth2, tokens)
+- Provides typed interfaces for records, queries, and processes
+- Manages API communication reliably
 
-- **HTTP Client**: Axios-based HTTP client for QQQ API interactions
-- **Data Models**: TypeScript interfaces and classes for QQQ data structures
-- **Controllers**: High-level abstractions for common QQQ operations
-- **Exception Handling**: Standardized error handling for QQQ operations
-- **Authentication**: Built-in authentication management and token handling
+This library is that client. It's framework-agnostic - use it with React, Vue, Angular, or plain JavaScript.
 
-### What This Repository Contains
+If you want a ready-to-use admin UI, use [qqq-frontend-material-dashboard](https://github.com/QRun-IO/qqq-frontend-material-dashboard) instead. It's built on this library.
 
-- **Core Library**: TypeScript/JavaScript library for QQQ client operations
-- **Data Models**: Complete type definitions for QQQ metadata and data structures
-- **HTTP Controllers**: Controllers for interacting with QQQ backend APIs
-- **Exception Classes**: Standardized error handling for QQQ operations
-- **Type Definitions**: Full TypeScript support with strict typing
+## Features
 
-### What This Repository Does NOT Contain
+- **Typed API client** - Full TypeScript support for QQQ operations
+- **Metadata loading** - Fetch table, process, and app definitions from QQQ
+- **Record CRUD** - Create, read, update, delete with query filters
+- **Process execution** - Run backend processes with parameter passing
+- **Auth handling** - OAuth2, bearer tokens, and custom auth flows
+- **Error normalization** - Consistent exception handling across operations
 
-- **QQQ Server**: The actual low-code engine and backend
-- **UI Components**: Visual components or user interface elements
-- **Framework Bindings**: React, Vue, or Angular specific implementations
-- **Business Logic**: Application-specific business rules or processes
+## Quick Start
 
-## 🏗️ Architecture
-
-### Technology Stack
-
-- **Language**: TypeScript with strict typing
-- **HTTP Client**: Axios for HTTP requests
-- **Build Tool**: TypeScript compiler with ES modules
-- **Testing**: Jest with TypeScript support
-- **Linting**: ESLint with TypeScript rules
-
-### Core Dependencies
-
-- **axios**: HTTP client for API communication
-- **form-data**: Form data handling for file uploads
-- **TypeScript**: Type safety and modern JavaScript features
-
-### Development Dependencies
-
-- **jest**: Testing framework
-- **eslint**: Code quality and style enforcement
-- **typescript**: TypeScript compiler and tools
-
-## 📁 Project Structure
-
-```
-src/
-├── controllers/           # HTTP controllers for QQQ operations
-│   ├── QController.ts    # Main controller for QQQ interactions
-│   └── QControllerV1.ts # Version 1 controller implementation
-├── model/                # Data models and type definitions
-│   ├── metaData/         # QQQ metadata models
-│   │   ├── QInstance.ts  # QQQ instance metadata
-│   │   ├── QTableMetaData.ts # Table structure definitions
-│   │   ├── QProcessMetaData.ts # Process definitions
-│   │   ├── QAppMetaData.ts # Application metadata
-│   │   └── ...          # Other metadata models
-│   ├── query/            # Query and filter models
-│   ├── processes/        # Process execution models
-│   ├── QRecord.ts        # Data record model
-│   └── QPossibleValue.ts # Possible value model
-├── exceptions/            # Exception handling
-│   └── QException.ts     # Standard QQQ exception class
-└── qqq-frontend-core.ts  # Main library entry point
-```
-
-## 🎯 Core Functionality
-
-### HTTP Controllers
-
-The library provides high-level controllers for common QQQ operations:
-
-```typescript
-import { QController } from '@qrunio/qqq-frontend-core';
-
-const controller = new QController('https://your-qqq-server.com');
-
-// Load metadata
-const metadata = await controller.loadMetaData();
-
-// Query records
-const records = await controller.queryRecords('tableName', filters);
-
-// Execute processes
-const result = await controller.executeProcess('processName', parameters);
-```
-
-### Data Models
-
-Complete TypeScript models for all QQQ data structures:
-
-```typescript
-import { 
-  QInstance, 
-  QTableMetaData, 
-  QProcessMetaData 
-} from '@qrunio/qqq-frontend-core';
-
-// Instance metadata
-const instance: QInstance = new QInstance(rawData);
-
-// Table metadata
-const table: QTableMetaData = new QTableMetaData(tableData);
-
-// Process metadata
-const process: QProcessMetaData = new QProcessMetaData(processData);
-```
-
-### Exception Handling
-
-Standardized error handling for QQQ operations:
-
-```typescript
-import { QException } from '@qrunio/qqq-frontend-core';
-
-try {
-  const result = await controller.executeProcess('processName', params);
-} catch (error) {
-  if (error instanceof QException) {
-    console.error(`QQQ Error: ${error.message} (Status: ${error.status})`);
-  }
-}
-```
-
-## 🚀 Getting Started
-
-### Installation
+**Prerequisites:** Node.js 18+
 
 ```bash
 npm install @qrunio/qqq-frontend-core
 ```
 
-### Basic Usage
+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';
 
-// Create controller instance
-const controller = new QController('https://your-qqq-server.com');
+const api = new QController('https://your-qqq-server.com');
 
-// Set authentication (if required)
-controller.setAuthorizationHeaderValue('Bearer your-token');
-
-// Load QQQ instance metadata
-const metadata = await controller.loadMetaData();
-
-// Query records from a table
-const records = await controller.queryRecords('users', {
-  filters: [{ field: 'active', operator: '=', value: true }],
-  limit: 100
-});
-
-// Execute a process
-const result = await controller.executeProcess('sendNotification', {
-  userId: 123,
-  message: 'Hello World'
-});
-```
-
-### Advanced Usage
-
-```typescript
-// Custom exception handler
-const controller = new QController('https://your-qqq-server.com', (error) => {
-  console.error('Custom error handling:', error);
-  // Handle error appropriately
-});
-
-// Set custom timeout
-controller.setStepTimeoutMillis(120000); // 2 minutes
-
-// Handle authentication
-controller.setAuthenticationMetaData({
-  type: 'OAUTH2',
-  clientId: 'your-client-id',
-  // ... other auth config
-});
-```
-
-## 🔧 Configuration
-
-### Environment Setup
-
-```typescript
-// Development
-const controller = new QController('http://localhost:8080');
-
-// Production
-const controller = new QController('https://api.yourdomain.com');
-
-// With custom configuration
-const controller = new QController('https://api.yourdomain.com', {
-  timeout: 30000,
-  headers: {
-    'X-Custom-Header': 'value'
-  }
-});
-```
-
-### Authentication Configuration
-
-```typescript
-// OAuth2
-controller.setAuthenticationMetaData({
-  type: 'OAUTH2',
-  clientId: 'your-client-id',
-  clientSecret: 'your-client-secret',
-  authorizationUrl: 'https://auth.yourdomain.com/oauth2/authorize',
-  tokenUrl: 'https://auth.yourdomain.com/oauth2/token'
-});
-
-// Custom token
-controller.setAuthorizationHeaderValue('Bearer your-jwt-token');
-```
-
-## 🧪 Testing
-
-### Running Tests
-
-```bash
-# Run all tests
-npm test
-
-# Run tests in watch mode
-npm test -- --watch
-
-# Run tests with coverage
-npm test -- --coverage
-```
-
-### Test Structure
-
-- **Unit Tests**: Individual component testing
-- **Integration Tests**: Controller and model testing
-- **Mock Data**: Comprehensive test fixtures
-
-## 📦 Building for Production
-
-### Build Process
-
-```bash
-# Clean and build
-npm run clean-and-install
-npm run prepublishOnly
-```
-
-The build process:
-- Compiles TypeScript to JavaScript
-- Generates ES modules and CommonJS outputs
-- Creates optimized production bundles
-- Generates type definitions
-
-### Output Files
-
-- **lib/**: Compiled JavaScript files
-- **qqq-frontend-core.js**: CommonJS bundle
-- **qqq-frontend-core.esm.js**: ES module bundle
-- **Type definitions**: Full TypeScript support
-
-## 🔐 Authentication
-
-### Supported Authentication Methods
-
-1. **OAuth2**: Standard OAuth2 flow
-2. **Custom Tokens**: JWT or other token-based auth
-3. **API Keys**: Simple API key authentication
-
-### Authentication Flow
-
-```typescript
-// OAuth2 flow
-await controller.authenticateOAuth2({
-  username: 'user@example.com',
-  password: 'password'
-});
-
-// Custom token
-controller.setAuthorizationHeaderValue('Bearer token');
-
-// Check authentication status
-const isAuthenticated = controller.isAuthenticated();
-```
-
-## 📊 Data Management
-
-### Record Operations
-
-```typescript
-// Create record
-const newRecord = await controller.createRecord('users', {
-  name: 'John Doe',
-  email: 'john@example.com'
-});
-
-// Update record
-const updatedRecord = await controller.updateRecord('users', 123, {
-  name: 'John Smith'
-});
-
-// Delete record
-await controller.deleteRecord('users', 123);
+// Load what tables and processes exist
+const metadata = await api.loadMetaData();
+console.log('Tables:', [...metadata.tables.keys()]);
 
 // Query records
-const records = await controller.queryRecords('users', {
-  filters: [{ field: 'active', operator: '=', value: true }],
-  sort: [{ field: 'name', direction: 'ASC' }],
-  limit: 50,
-  offset: 0
+const users = await api.queryRecords('user', {
+  filters: [{ field: 'isActive', operator: '=', value: true }],
+  limit: 10
 });
 ```
 
-### Process Execution
+## Usage
+
+### Authentication
 
 ```typescript
-// Execute process
-const result = await controller.executeProcess('sendEmail', {
-  to: 'user@example.com',
-  subject: 'Welcome',
-  body: 'Welcome to our platform!'
+// Bearer token (simplest)
+api.setAuthorizationHeaderValue('Bearer your-jwt-token');
+
+// OAuth2
+api.setAuthenticationMetaData({
+  type: 'OAUTH2',
+  clientId: 'your-client-id',
+  tokenUrl: 'https://auth.example.com/token'
 });
-
-// Monitor process status
-const status = await controller.getProcessStatus('process-id');
-
-// Cancel process
-await controller.cancelProcess('process-id');
 ```
 
-## 🎨 Integration Examples
-
-### React Integration
+### Working with Records
 
 ```typescript
-import React, { useEffect, useState } from 'react';
-import { QController, QInstance } from '@qrunio/qqq-frontend-core';
+// Create
+const order = await api.createRecord('order', { 
+  customerId: 42, 
+  status: 'pending' 
+});
 
-function QQQApp() {
-  const [metadata, setMetadata] = useState<QInstance | null>(null);
-  const [loading, setLoading] = useState(true);
+// Read
+const record = await api.getRecord('order', order.id);
 
-  useEffect(() => {
-    const controller = new QController('https://your-qqq-server.com');
-    
-    controller.loadMetaData()
-      .then(setMetadata)
-      .finally(() => setLoading(false));
-  }, []);
+// Update
+await api.updateRecord('order', order.id, { status: 'shipped' });
 
-  if (loading) return <div>Loading...</div>;
-  if (!metadata) return <div>No metadata available</div>;
+// Delete
+await api.deleteRecord('order', order.id);
 
-  return (
-    <div>
-      <h1>QQQ Application</h1>
-      <p>Tables: {metadata.tables?.size || 0}</p>
-      <p>Processes: {metadata.processes?.size || 0}</p>
-    </div>
-  );
+// Query with filters
+const pending = await api.queryRecords('order', {
+  filters: [{ field: 'status', operator: '=', value: 'pending' }],
+  sort: [{ field: 'createdAt', direction: 'DESC' }],
+  limit: 50
+});
+```
+
+### Running Processes
+
+```typescript
+const result = await api.executeProcess('generateInvoice', {
+  orderId: 123,
+  format: 'pdf'
+});
+```
+
+### Error Handling
+
+```typescript
+import { QException } from '@qrunio/qqq-frontend-core';
+
+try {
+  await api.executeProcess('riskyOperation', params);
+} catch (e) {
+  if (e instanceof QException) {
+    console.error(`QQQ error: ${e.message} (${e.status})`);
+  }
+  throw e;
 }
 ```
 
-### Vue Integration
+## Configuration
 
 ```typescript
-import { defineComponent, ref, onMounted } from 'vue';
-import { QController, QInstance } from '@qrunio/qqq-frontend-core';
+// Custom timeout (default: 60s)
+api.setStepTimeoutMillis(120000);
 
-export default defineComponent({
-  setup() {
-    const metadata = ref<QInstance | null>(null);
-    const loading = ref(true);
-
-    onMounted(async () => {
-      const controller = new QController('https://your-qqq-server.com');
-      
-      try {
-        metadata.value = await controller.loadMetaData();
-      } finally {
-        loading.value = false;
-      }
-    });
-
-    return { metadata, loading };
-  }
+// Global error handler
+const api = new QController('https://...', (error) => {
+  logToMonitoring(error);
 });
 ```
 
-### Vanilla JavaScript
+## Project Status
 
-```javascript
-import { QController } from '@qrunio/qqq-frontend-core';
+**Maturity:** Stable, used in production  
+**Breaking changes:** Follow semver; major versions may break API  
 
-const controller = new QController('https://your-qqq-server.com');
+**Roadmap:**
+- WebSocket support for real-time updates
+- Request batching for bulk operations
+- Offline queue for intermittent connectivity
 
-// Load metadata
-controller.loadMetaData()
-  .then(metadata => {
-    console.log('Tables:', metadata.tables);
-    console.log('Processes:', metadata.processes);
-  })
-  .catch(error => {
-    console.error('Error loading metadata:', error);
-  });
+## Contributing
+
+```bash
+git clone https://github.com/QRun-IO/qqq-frontend-core
+cd qqq-frontend-core
+npm install
+npm test
 ```
 
-## 🚀 Performance
+Submit issues and PRs to the [main QQQ repository](https://github.com/QRun-IO/qqq/issues).
 
-### Optimization Features
-
-- **Memoization**: Cached metadata promises
-- **Connection Reuse**: Persistent HTTP connections
-- **Batch Operations**: Efficient bulk operations
-- **Lazy Loading**: On-demand metadata loading
-
-### Best Practices
-
-- **Reuse Controllers**: Don't create new controllers unnecessarily
-- **Cache Metadata**: Use cached metadata when possible
-- **Handle Errors**: Implement proper error handling
-- **Monitor Performance**: Track API response times
-
-## 🤝 Contributing
-
-**Important**: This repository is a core component of the QQQ framework. All contributions, issues, and discussions should go through the main QQQ repository.
-
-### Development Workflow
-
-1. **Fork the main QQQ repository**: https://github.com/Kingsrook/qqq
-2. **Create a feature branch**: `git checkout -b feature/amazing-feature`
-3. **Make your changes** (including core library changes if applicable)
-4. **Run tests**: `npm test`
-5. **Commit your changes**: `git commit -m 'Add amazing feature'`
-6. **Push to the branch**: `git push origin feature/amazing-feature`
-7. **Open a Pull Request** to the main QQQ repository
-
-### Code Standards
-
-- **TypeScript**: Strict type checking enabled
-- **ESLint**: Code quality and style enforcement
-- **Testing**: Comprehensive test coverage
-- **Documentation**: Clear API documentation
-
-## 📄 License
-
-This project is licensed under the GNU Affero General Public License v3.0 - see the [LICENSE](LICENSE) file for details.
-
-```
-QQQ Frontend Core
-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/
-```
-
-**Note**: This is a core component of the QQQ framework. For the complete license and more information, see the main QQQ repository: https://github.com/Kingsrook/qqq
-
-## 🆘 Support & Community
-
-### ⚠️ Important: Use Main QQQ Repository
-
-**All support, issues, discussions, and community interactions should go through the main QQQ repository:**
-
-- **Main Repository**: https://github.com/Kingsrook/qqq
-- **Issues**: https://github.com/Kingsrook/qqq/issues
-- **Discussions**: https://github.com/Kingsrook/qqq/discussions
-- **Wiki**: https://github.com/Kingsrook/qqq.wiki
-
-### Why This Repository Exists
-
-This repository is maintained separately from the main QQQ repository to:
-- **Enable independent library development** and versioning
-- **Allow library-specific CI/CD** and deployment pipelines
-- **Provide clear separation** between core library and framework concerns
-- **Support different release cycles** for library vs. framework updates
-
-### Getting Help
-
-- **Documentation**: Check the [QQQ Wiki](https://github.com/Kingsrook/qqq.wiki)
-- **Issues**: Report bugs and feature requests on [Main QQQ Issues](https://github.com/Kingsrook/qqq/issues)
-- **Discussions**: Join community discussions on [Main QQQ Discussions](https://github.com/Kingsrook/qqq/discussions)
-- **Questions**: Ask questions in the main QQQ repository
-
-### Contact Information
-
-- **Company**: Kingsrook, LLC
-- **Email**: contact@kingsrook.com
-- **Website**: https://kingsrook.com
-- **Main GitHub**: https://github.com/Kingsrook/qqq
-
-## 🙏 Acknowledgments
-
-- **TypeScript Team**: For the powerful type system
-- **Axios Team**: For the excellent HTTP client library
-- **QQQ Framework Team**: For the underlying low-code platform
-- **Open Source Community**: For the tools and libraries that make this possible
-
----
-
-**Built with ❤️ by the Kingsrook Team**
-
-**This is a core library component of the QQQ framework. For complete information, support, and community, visit: https://github.com/Kingsrook/qqq**
+## License
 
+Apache-2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE).

docs/npm-publishing.md

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

docs/troubleshooting.md

@@ -0,0 +1,55 @@
+# Troubleshooting
+
+## Views Dropdown Missing on Table Pages
+
+### Symptom
+The "Views" dropdown (for saving/loading filter presets) is not visible on table pages.
+
+### Root Cause
+The SavedViews component visibility is **permission-based**. It checks:
+
+```typescript
+const hasQueryPermission = metaData?.processes.has("querySavedView");
+// Only renders if hasQueryPermission && tableMetaData
+```
+
+### Solution
+Grant users permission to these processes:
+
+| Process | Purpose |
+|---------|---------|
+| `querySavedView` | **Required** - show dropdown, load views |
+| `storeSavedView` | Save/update views |
+| `deleteSavedView` | Delete views |
+
+In your QQQ app's permission configuration:
+```java
+.withProcessPermission("querySavedView", true)
+.withProcessPermission("storeSavedView", true)
+.withProcessPermission("deleteSavedView", true)
+```
+
+### Related Files
+- Frontend: `SavedViews.tsx` in qqq-frontend-material-dashboard
+- Backend: `SavedViewsMetaDataProvider.java` in qqq-backend-core
+
+---
+
+## Stale lib/ Build
+
+### Symptom
+Published npm package is missing recent TypeScript changes.
+
+### Root Cause
+The `lib/` directory wasn't rebuilt before publishing.
+
+### Solution
+The `prepublishOnly` hook in `package.json` now handles this:
+```json
+"prepublishOnly": "rm -rf lib/ && tsc -p ./ --outDir lib/"
+```
+
+For local development with yalc:
+```bash
+npm run yalc-push  # Runs prepublishOnly first
+```

docs/version-management.md

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

package-lock.json

@@ -1,16 +1,16 @@
 {
-   "name": "@kingsrook/qqq-frontend-core",
-   "version": "1.0.127-SNAPSHOT",
+   "name": "@qrunio/qqq-frontend-core",
+   "version": "0.40.27-RC.1",
    "lockfileVersion": 3,
    "requires": true,
    "packages": {
       "": {
-         "name": "@kingsrook/qqq-frontend-core",
-         "version": "1.0.127-SNAPSHOT",
-         "license": "ISC",
+         "name": "@qrunio/qqq-frontend-core",
+         "version": "0.40.27-RC.1",
+         "license": "Apache-2.0",
          "dependencies": {
-            "axios": "0.28.1",
-            "form-data": "4.0.0"
+            "axios": "0.34.0",
+            "form-data": "4.0.6"
          },
          "devDependencies": {
             "@types/jest": "^27.0.2",
@@ -29,28 +29,14 @@
             "typescript": "^4.4.4"
          }
       },
-      "node_modules/@ampproject/remapping": {
-         "version": "2.3.0",
-         "resolved": "https://registry.npmjs.org/@ampproject/remapping/-/remapping-2.3.0.tgz",
-         "integrity": "sha512-30iZtAPgz+LTIYoeivqYo853f02jBYSd5uGnGpkFV0M3xOt9aN73erkgYAmZU43x4VfqcnLxW9Kpg3R5LC4YYw==",
-         "dev": true,
-         "license": "Apache-2.0",
-         "dependencies": {
-            "@jridgewell/gen-mapping": "^0.3.5",
-            "@jridgewell/trace-mapping": "^0.3.24"
-         },
-         "engines": {
-            "node": ">=6.0.0"
-         }
-      },
       "node_modules/@babel/code-frame": {
-         "version": "7.27.1",
-         "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.27.1.tgz",
-         "integrity": "sha512-cjQ7ZlQ0Mv3b47hABuTevyTuYN4i+loJKGeV9flcCgIK37cCXRh+L1bd3iBHlynerhQ7BhCkn2BPbQUL+rGqFg==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.7.tgz",
+         "integrity": "sha512-Aup7aUOfpbAUg2ROOJN6Iw5f9DMBlzu0mIkm/malLQFN/YQgO48wCj0Kxa3sEHJvPVFg7siR+qRInwXd2qhQKw==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@babel/helper-validator-identifier": "^7.27.1",
+            "@babel/helper-validator-identifier": "^7.29.7",
             "js-tokens": "^4.0.0",
             "picocolors": "^1.1.1"
          },
@@ -59,9 +45,9 @@
          }
       },
       "node_modules/@babel/compat-data": {
-         "version": "7.28.0",
-         "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.28.0.tgz",
-         "integrity": "sha512-60X7qkglvrap8mn1lh2ebxXdZYtUcpd7gsmy9kLaBJ4i/WdY8PqTSdxyA8qraikqKQK5C1KRBKXqznrVapyNaw==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.29.7.tgz",
+         "integrity": "sha512-locTkQyKvwIEgBzVrn8693ebc97F2U8ZHjbXwDXJ5Fn2TCpNwTlKcaKLkdHop5c/icOFE7qt7Q9JC5hnKNa6Gg==",
          "dev": true,
          "license": "MIT",
          "engines": {
@@ -69,22 +55,22 @@
          }
       },
       "node_modules/@babel/core": {
-         "version": "7.28.3",
-         "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.28.3.tgz",
-         "integrity": "sha512-yDBHV9kQNcr2/sUr9jghVyz9C3Y5G2zUM2H2lo+9mKv4sFgbA8s8Z9t8D1jiTkGoO/NoIfKMyKWr4s6CN23ZwQ==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.29.7.tgz",
+         "integrity": "sha512-RgHBCvtjbOK2gXSNBNIkNoEc9qoVEtau3hj8gEqKQuL3HZAibKarWFEI3Lfm6EYKkLalOh8eSrj9b+ch9H/VBA==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@ampproject/remapping": "^2.2.0",
-            "@babel/code-frame": "^7.27.1",
-            "@babel/generator": "^7.28.3",
-            "@babel/helper-compilation-targets": "^7.27.2",
-            "@babel/helper-module-transforms": "^7.28.3",
-            "@babel/helpers": "^7.28.3",
-            "@babel/parser": "^7.28.3",
-            "@babel/template": "^7.27.2",
-            "@babel/traverse": "^7.28.3",
-            "@babel/types": "^7.28.2",
+            "@babel/code-frame": "^7.29.7",
+            "@babel/generator": "^7.29.7",
+            "@babel/helper-compilation-targets": "^7.29.7",
+            "@babel/helper-module-transforms": "^7.29.7",
+            "@babel/helpers": "^7.29.7",
+            "@babel/parser": "^7.29.7",
+            "@babel/template": "^7.29.7",
+            "@babel/traverse": "^7.29.7",
+            "@babel/types": "^7.29.7",
+            "@jridgewell/remapping": "^2.3.5",
             "convert-source-map": "^2.0.0",
             "debug": "^4.1.0",
             "gensync": "^1.0.0-beta.2",
@@ -117,14 +103,14 @@
          }
       },
       "node_modules/@babel/generator": {
-         "version": "7.28.3",
-         "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.28.3.tgz",
-         "integrity": "sha512-3lSpxGgvnmZznmBkCRnVREPUFJv2wrv9iAoFDvADJc0ypmdOxdUtcLeBgBJ6zE0PMeTKnxeQzyk0xTBq4Ep7zw==",
+         "version": "7.29.8",
+         "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.29.8.tgz",
+         "integrity": "sha512-gZbepsdh3WDtgZKWL+vTPh71LSBrm/Y4/QDZBVCcYfmeTEEuoOYwlSy+G1StfJg+/Zy550u/3TATbm7qDbbMtg==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@babel/parser": "^7.28.3",
-            "@babel/types": "^7.28.2",
+            "@babel/parser": "^7.29.8",
+            "@babel/types": "^7.29.8",
             "@jridgewell/gen-mapping": "^0.3.12",
             "@jridgewell/trace-mapping": "^0.3.28",
             "jsesc": "^3.0.2"
@@ -134,14 +120,14 @@
          }
       },
       "node_modules/@babel/helper-compilation-targets": {
-         "version": "7.27.2",
-         "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.27.2.tgz",
-         "integrity": "sha512-2+1thGUUWWjLTYTHZWK1n8Yga0ijBz1XAhUXcKy81rd5g6yh7hGqMp45v7cadSbEHc9G3OTv45SyneRN3ps4DQ==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.29.7.tgz",
+         "integrity": "sha512-wem6WaBj4NaVYVdNhLPPVacES6ZJ+KBBfSkTMD3YZxbP3rm3Di85tJU5ljaUNhaOynt+Aj0xruhYuzQBt8n71g==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@babel/compat-data": "^7.27.2",
-            "@babel/helper-validator-option": "^7.27.1",
+            "@babel/compat-data": "^7.29.7",
+            "@babel/helper-validator-option": "^7.29.7",
             "browserslist": "^4.24.0",
             "lru-cache": "^5.1.1",
             "semver": "^6.3.1"
@@ -161,9 +147,9 @@
          }
       },
       "node_modules/@babel/helper-globals": {
-         "version": "7.28.0",
-         "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.28.0.tgz",
-         "integrity": "sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.29.7.tgz",
+         "integrity": "sha512-3nQVUAtvkKH9zahfWgw96Jc/uFOmjACE1kQz82E2lqWmHBgjzbNlsC22nuQTfahmWeQtTq5nQ/4Nnd2A1wj4zA==",
          "dev": true,
          "license": "MIT",
          "engines": {
@@ -171,29 +157,29 @@
          }
       },
       "node_modules/@babel/helper-module-imports": {
-         "version": "7.27.1",
-         "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.27.1.tgz",
-         "integrity": "sha512-0gSFWUPNXNopqtIPQvlD5WgXYI5GY2kP2cCvoT8kczjbfcfuIljTbcWrulD1CIPIX2gt1wghbDy08yE1p+/r3w==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.29.7.tgz",
+         "integrity": "sha512-ejHwrQQYcm9xnTivShn2IDOlIzInN34AXskvq9QicvCtEzq1Vzclu/tKF8Jq1Cg8JG2GL6/EmjgsCT7lXepE3g==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@babel/traverse": "^7.27.1",
-            "@babel/types": "^7.27.1"
+            "@babel/traverse": "^7.29.7",
+            "@babel/types": "^7.29.7"
          },
          "engines": {
             "node": ">=6.9.0"
          }
       },
       "node_modules/@babel/helper-module-transforms": {
-         "version": "7.28.3",
-         "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.28.3.tgz",
-         "integrity": "sha512-gytXUbs8k2sXS9PnQptz5o0QnpLL51SwASIORY6XaBKF88nsOT0Zw9szLqlSGQDP/4TljBAD5y98p2U1fqkdsw==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.29.7.tgz",
+         "integrity": "sha512-UPUVSyXbOh627KiCIGQSgwWzGeBKLkaJ9PJEdrngIwMSzxLR4jS4+f1f1jb7VzBbg8nFLaYotvVPFCTqdrmTAg==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@babel/helper-module-imports": "^7.27.1",
-            "@babel/helper-validator-identifier": "^7.27.1",
-            "@babel/traverse": "^7.28.3"
+            "@babel/helper-module-imports": "^7.29.7",
+            "@babel/helper-validator-identifier": "^7.29.7",
+            "@babel/traverse": "^7.29.7"
          },
          "engines": {
             "node": ">=6.9.0"
@@ -213,9 +199,9 @@
          }
       },
       "node_modules/@babel/helper-string-parser": {
-         "version": "7.27.1",
-         "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz",
-         "integrity": "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.29.7.tgz",
+         "integrity": "sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==",
          "dev": true,
          "license": "MIT",
          "engines": {
@@ -223,9 +209,9 @@
          }
       },
       "node_modules/@babel/helper-validator-identifier": {
-         "version": "7.27.1",
-         "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.27.1.tgz",
-         "integrity": "sha512-D2hP9eA+Sqx1kBZgzxZh0y1trbuU+JoDkiEwqhQ36nodYqJwyEIhPSdMNd7lOm/4io72luTPWH20Yda0xOuUow==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz",
+         "integrity": "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==",
          "dev": true,
          "license": "MIT",
          "engines": {
@@ -233,9 +219,9 @@
          }
       },
       "node_modules/@babel/helper-validator-option": {
-         "version": "7.27.1",
-         "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.27.1.tgz",
-         "integrity": "sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.29.7.tgz",
+         "integrity": "sha512-N9ZErrD+yW5geCDtBqnOoxmR8+tNKiGuxKlDpuJxfsqpa2dFcexaziGAE/qoHLiDDreVNMupxGmSoNlyvsA3gw==",
          "dev": true,
          "license": "MIT",
          "engines": {
@@ -243,27 +229,27 @@
          }
       },
       "node_modules/@babel/helpers": {
-         "version": "7.28.3",
-         "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.28.3.tgz",
-         "integrity": "sha512-PTNtvUQihsAsDHMOP5pfobP8C6CM4JWXmP8DrEIt46c3r2bf87Ua1zoqevsMo9g+tWDwgWrFP5EIxuBx5RudAw==",
+         "version": "7.29.10",
+         "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.29.10.tgz",
+         "integrity": "sha512-EMCx3AGZ3WfAl6ht7AyQoPm2Lh+BGYEMdc4Q6Hf7uSCDOZFuLq44qNwL+iaim8VlyYhRAo4X43+weadK8ZB4Yg==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@babel/template": "^7.27.2",
-            "@babel/types": "^7.28.2"
+            "@babel/template": "^7.29.7",
+            "@babel/types": "^7.29.8"
          },
          "engines": {
             "node": ">=6.9.0"
          }
       },
       "node_modules/@babel/parser": {
-         "version": "7.28.3",
-         "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.28.3.tgz",
-         "integrity": "sha512-7+Ey1mAgYqFAx2h0RuoxcQT5+MlG3GTV0TQrgr7/ZliKsm/MNDxVVutlWaziMq7wJNAz8MTqz55XLpWvva6StA==",
+         "version": "7.29.9",
+         "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.9.tgz",
+         "integrity": "sha512-CjXrNHTnvqBVqHgdBysY3vk2T8tpJHb5/RMeHJBTyVa9xgugCB0CJTx/3oO8RV2QRQP391RWpB7D6hLjm8V9uA==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@babel/types": "^7.28.2"
+            "@babel/types": "^7.29.8"
          },
          "bin": {
             "parser": "bin/babel-parser.js"
@@ -519,33 +505,33 @@
          }
       },
       "node_modules/@babel/template": {
-         "version": "7.27.2",
-         "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.27.2.tgz",
-         "integrity": "sha512-LPDZ85aEJyYSd18/DkjNh4/y1ntkE5KwUHWTiqgRxruuZL2F1yuHligVHLvcHY2vMHXttKFpJn6LwfI7cw7ODw==",
+         "version": "7.29.7",
+         "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.29.7.tgz",
+         "integrity": "sha512-puq+Gf35oI24FeN11LkoUQFqv9uwNeWpxXZi/Ji3rRIoKAzKnxRaZ+Gkj0vKS9ZCiTESfng1N9LyOyXvo+m+Gg==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@babel/code-frame": "^7.27.1",
-            "@babel/parser": "^7.27.2",
-            "@babel/types": "^7.27.1"
+            "@babel/code-frame": "^7.29.7",
+            "@babel/parser": "^7.29.7",
+            "@babel/types": "^7.29.7"
          },
          "engines": {
             "node": ">=6.9.0"
          }
       },
       "node_modules/@babel/traverse": {
-         "version": "7.28.3",
-         "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.28.3.tgz",
-         "integrity": "sha512-7w4kZYHneL3A6NP2nxzHvT3HCZ7puDZZjFMqDpBPECub79sTtSO5CGXDkKrTQq8ksAwfD/XI2MRFX23njdDaIQ==",
+         "version": "7.29.10",
+         "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.29.10.tgz",
+         "integrity": "sha512-B3lYAs2nkKskbgQ1nfy8Ma9ao9Q1rntTAQHrzzyDuj+TSO+X3le6PfWwqDvodsb+OumE10eMFfuMCTQSQ5iuIQ==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@babel/code-frame": "^7.27.1",
-            "@babel/generator": "^7.28.3",
-            "@babel/helper-globals": "^7.28.0",
-            "@babel/parser": "^7.28.3",
-            "@babel/template": "^7.27.2",
-            "@babel/types": "^7.28.2",
+            "@babel/code-frame": "^7.29.7",
+            "@babel/generator": "^7.29.8",
+            "@babel/helper-globals": "^7.29.7",
+            "@babel/parser": "^7.29.9",
+            "@babel/template": "^7.29.7",
+            "@babel/types": "^7.29.8",
             "debug": "^4.3.1"
          },
          "engines": {
@@ -553,14 +539,14 @@
          }
       },
       "node_modules/@babel/types": {
-         "version": "7.28.2",
-         "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.28.2.tgz",
-         "integrity": "sha512-ruv7Ae4J5dUYULmeXw1gmb7rYRz57OWCPM57pHojnLq/3Z1CK2lNSLTCVjxVk1F/TZHwOZZrOWi0ur95BbLxNQ==",
+         "version": "7.29.8",
+         "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.8.tgz",
+         "integrity": "sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
-            "@babel/helper-string-parser": "^7.27.1",
-            "@babel/helper-validator-identifier": "^7.27.1"
+            "@babel/helper-string-parser": "^7.29.7",
+            "@babel/helper-validator-identifier": "^7.29.7"
          },
          "engines": {
             "node": ">=6.9.0"
@@ -649,9 +635,9 @@
          }
       },
       "node_modules/@istanbuljs/load-nyc-config/node_modules/js-yaml": {
-         "version": "3.14.1",
-         "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.1.tgz",
-         "integrity": "sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==",
+         "version": "3.15.2",
+         "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.15.2.tgz",
+         "integrity": "sha512-6EuL879VkRA+1Cz578mKMiKvjPNEuk6+r1JaFzoSWejZmtf7xWbIyw1e3KkxlkzTIt9Taw6JBhEppG7utc1P+w==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
@@ -944,6 +930,17 @@
             "@jridgewell/trace-mapping": "^0.3.24"
          }
       },
+      "node_modules/@jridgewell/remapping": {
+         "version": "2.3.5",
+         "resolved": "https://registry.npmjs.org/@jridgewell/remapping/-/remapping-2.3.5.tgz",
+         "integrity": "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==",
+         "dev": true,
+         "license": "MIT",
+         "dependencies": {
+            "@jridgewell/gen-mapping": "^0.3.5",
+            "@jridgewell/trace-mapping": "^0.3.24"
+         }
+      },
       "node_modules/@jridgewell/resolve-uri": {
          "version": "3.1.2",
          "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz",
@@ -1725,13 +1722,13 @@
          }
       },
       "node_modules/axios": {
-         "version": "0.28.1",
-         "resolved": "https://registry.npmjs.org/axios/-/axios-0.28.1.tgz",
-         "integrity": "sha512-iUcGA5a7p0mVb4Gm/sy+FSECNkPFT4y7wt6OM/CDpO/OnNCvSs3PoMG8ibrC9jRoGYU0gUK5pXVC4NPXq6lHRQ==",
+         "version": "0.34.0",
+         "resolved": "https://registry.npmjs.org/axios/-/axios-0.34.0.tgz",
+         "integrity": "sha512-CkOmqy7BaT4VC9+wRUmSM3LVwCkKK3UYc7koEqIHWRpOTJypwdNctaVOgnOjhHP3599Ubq2K8KqYwfC7c8NdPQ==",
          "license": "MIT",
          "dependencies": {
-            "follow-redirects": "^1.15.0",
-            "form-data": "^4.0.0",
+            "follow-redirects": "^1.15.4",
+            "form-data": "^4.0.4",
             "proxy-from-env": "^1.1.0"
          }
       },
@@ -1849,10 +1846,23 @@
          "dev": true,
          "license": "MIT"
       },
+      "node_modules/baseline-browser-mapping": {
+         "version": "2.11.28",
+         "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.11.28.tgz",
+         "integrity": "sha512-br0LOmjJqr6Rt4AEkadbcNf67Zpo7EPwKsWbjnRrJIa1QYFHQBqM4C7F2WTbV8ahTEcg1Eo+Y0aWjjORInYFyA==",
+         "dev": true,
+         "license": "Apache-2.0",
+         "bin": {
+            "baseline-browser-mapping": "dist/cli.cjs"
+         },
+         "engines": {
+            "node": ">=6.0.0"
+         }
+      },
       "node_modules/brace-expansion": {
-         "version": "1.1.12",
-         "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz",
-         "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==",
+         "version": "1.1.21",
+         "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.21.tgz",
+         "integrity": "sha512-9zeA+KLZNNzglF2TPKRQEDyx6Yby7daAkuy8MiPzpXPsYDWi/DRM8jmwUDxokQjYqBpv5DgPiwD4h4ZZSy1Ujw==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
@@ -1881,9 +1891,9 @@
          "license": "BSD-2-Clause"
       },
       "node_modules/browserslist": {
-         "version": "4.25.3",
-         "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.25.3.tgz",
-         "integrity": "sha512-cDGv1kkDI4/0e5yON9yM5G/0A5u8sf5TnmdX5C9qHzI9PPu++sQ9zjm1k9NiOrf3riY4OkK0zSGqfvJyJsgCBQ==",
+         "version": "4.29.3",
+         "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.29.3.tgz",
+         "integrity": "sha512-1R4kiYKXGViqEN0CnoDrXc1StD9niAwu+j2dukWzrD4bJgsD4lDmEp0CRbc6E/vYJIfTHwPmwyaKtVSudICdPA==",
          "dev": true,
          "funding": [
             {
@@ -1901,10 +1911,11 @@
          ],
          "license": "MIT",
          "dependencies": {
-            "caniuse-lite": "^1.0.30001735",
-            "electron-to-chromium": "^1.5.204",
-            "node-releases": "^2.0.19",
-            "update-browserslist-db": "^1.1.3"
+            "baseline-browser-mapping": "^2.11.26",
+            "caniuse-lite": "^1.0.30001813",
+            "electron-to-chromium": "^1.5.439",
+            "node-releases": "^2.0.57",
+            "update-browserslist-db": "^1.3.3"
          },
          "bin": {
             "browserslist": "cli.js"
@@ -1966,7 +1977,6 @@
          "version": "1.0.2",
          "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
          "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
-         "dev": true,
          "license": "MIT",
          "dependencies": {
             "es-errors": "^1.3.0",
@@ -2014,9 +2024,9 @@
          }
       },
       "node_modules/caniuse-lite": {
-         "version": "1.0.30001737",
-         "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001737.tgz",
-         "integrity": "sha512-BiloLiXtQNrY5UyF0+1nSJLXUENuhka2pzy2Fx5pGxqavdrxSCW4U6Pn/PoG3Efspi2frRbHpBV2XsrPE6EDlw==",
+         "version": "1.0.30001816",
+         "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001816.tgz",
+         "integrity": "sha512-+8Yx7BXCoqk6IF8yTicjfUR6D/ldJzdlsodlEOiOSPmhK844WIgk67/zIQaGAOxNkZyyvBlrRFnLvqKIoqbAFw==",
          "dev": true,
          "funding": [
             {
@@ -2465,7 +2475,6 @@
          "version": "1.0.1",
          "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
          "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
-         "dev": true,
          "license": "MIT",
          "dependencies": {
             "call-bind-apply-helpers": "^1.0.1",
@@ -2477,9 +2486,9 @@
          }
       },
       "node_modules/electron-to-chromium": {
-         "version": "1.5.211",
-         "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.211.tgz",
-         "integrity": "sha512-IGBvimJkotaLzFnwIVgW9/UD/AOJ2tByUmeOrtqBfACSbAw5b1G0XpvdaieKyc7ULmbwXVx+4e4Be8pOPBrYkw==",
+         "version": "1.5.456",
+         "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.456.tgz",
+         "integrity": "sha512-8hboqI6xesozteFb8aa7OGknvxUtTeRJLz0FoePysUEh/oWbddykIGdgpEJRbPRg/nIMfBf2DFos+H2MtvJl2A==",
          "dev": true,
          "license": "ISC"
       },
@@ -2586,7 +2595,6 @@
          "version": "1.0.1",
          "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
          "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
-         "dev": true,
          "license": "MIT",
          "engines": {
             "node": ">= 0.4"
@@ -2596,7 +2604,6 @@
          "version": "1.3.0",
          "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
          "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
-         "dev": true,
          "license": "MIT",
          "engines": {
             "node": ">= 0.4"
@@ -2606,7 +2613,6 @@
          "version": "1.1.1",
          "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
          "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
-         "dev": true,
          "license": "MIT",
          "dependencies": {
             "es-errors": "^1.3.0"
@@ -2619,7 +2625,6 @@
          "version": "2.1.0",
          "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz",
          "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==",
-         "dev": true,
          "license": "MIT",
          "dependencies": {
             "es-errors": "^1.3.0",
@@ -3389,16 +3394,16 @@
          }
       },
       "node_modules/flatted": {
-         "version": "3.3.3",
-         "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.3.3.tgz",
-         "integrity": "sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==",
+         "version": "3.4.4",
+         "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.4.4.tgz",
+         "integrity": "sha512-5+ybhBZANEJxaH3X5evAFatUxLfEHSr7n6kYJ+1Qd0mUqr4eu9gIf6GDbWHf8RJijHrjjO8G+la14SlL2SeS1Q==",
          "dev": true,
          "license": "ISC"
       },
       "node_modules/follow-redirects": {
-         "version": "1.15.11",
-         "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.11.tgz",
-         "integrity": "sha512-deG2P0JfjrTxl50XGCDyfI97ZGVCxIpfKYmfyrQ54n5FO/0gfIES8C/Psl6kWVDolizcaaxZJnTS0QSMxvnsBQ==",
+         "version": "1.16.1",
+         "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.16.1.tgz",
+         "integrity": "sha512-FNvFGzoMLWmE6Yj9spb/zjd7yiNCHiAW9/Tg9CXrQ8wuu32HtlJOwWO11OJafl5FfY3DxTdQ0vj42zU1kvv5jg==",
          "funding": [
             {
                "type": "individual",
@@ -3432,14 +3437,16 @@
          }
       },
       "node_modules/form-data": {
-         "version": "4.0.0",
-         "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.0.tgz",
-         "integrity": "sha512-ETEklSGi5t0QMZuiXoA/Q6vcnxcLQP5vdugSpuAyi6SVGi2clPPp+xgEhuMaHC+zGgn31Kd235W35f7Hykkaww==",
+         "version": "4.0.6",
+         "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.6.tgz",
+         "integrity": "sha512-vKatAh4SlVfgbv+YtmhiRjhEMJsYpsG1Y2rMQtR+SVSbytsSD1YGzDIcrAJmdFec88u/+VoGmxnl+80gL1tRCQ==",
          "license": "MIT",
          "dependencies": {
             "asynckit": "^0.4.0",
             "combined-stream": "^1.0.8",
-            "mime-types": "^2.1.12"
+            "es-set-tostringtag": "^2.1.0",
+            "hasown": "^2.0.4",
+            "mime-types": "^2.1.35"
          },
          "engines": {
             "node": ">= 6"
@@ -3471,7 +3478,6 @@
          "version": "1.1.2",
          "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
          "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
-         "dev": true,
          "license": "MIT",
          "funding": {
             "url": "https://github.com/sponsors/ljharb"
@@ -3539,7 +3545,6 @@
          "version": "1.3.0",
          "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
          "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
-         "dev": true,
          "license": "MIT",
          "dependencies": {
             "call-bind-apply-helpers": "^1.0.2",
@@ -3574,7 +3579,6 @@
          "version": "1.0.1",
          "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
          "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
-         "dev": true,
          "license": "MIT",
          "dependencies": {
             "dunder-proto": "^1.0.1",
@@ -3708,7 +3712,6 @@
          "version": "1.2.0",
          "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
          "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
-         "dev": true,
          "license": "MIT",
          "engines": {
             "node": ">= 0.4"
@@ -3790,7 +3793,6 @@
          "version": "1.1.0",
          "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
          "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
-         "dev": true,
          "license": "MIT",
          "engines": {
             "node": ">= 0.4"
@@ -3803,7 +3805,6 @@
          "version": "1.0.2",
          "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz",
          "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==",
-         "dev": true,
          "license": "MIT",
          "dependencies": {
             "has-symbols": "^1.0.3"
@@ -3816,10 +3817,9 @@
          }
       },
       "node_modules/hasown": {
-         "version": "2.0.2",
-         "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
-         "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
-         "dev": true,
+         "version": "2.0.4",
+         "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.4.tgz",
+         "integrity": "sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A==",
          "license": "MIT",
          "dependencies": {
             "function-bind": "^1.1.2"
@@ -5193,10 +5193,20 @@
          "license": "MIT"
       },
       "node_modules/js-yaml": {
-         "version": "4.1.0",
-         "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz",
-         "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==",
+         "version": "4.3.2",
+         "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.3.2.tgz",
+         "integrity": "sha512-SFNOvSJ+Dgf/9An904Yx+CgSlIPCkIpao4qo51lpee25TIRejdH3rhR4EZMGoNx3/TP3O+wzWuiTFl4sqbltzA==",
          "dev": true,
+         "funding": [
+            {
+               "type": "github",
+               "url": "https://github.com/sponsors/puzrin"
+            },
+            {
+               "type": "github",
+               "url": "https://github.com/sponsors/nodeca"
+            }
+         ],
          "license": "MIT",
          "dependencies": {
             "argparse": "^2.0.1"
@@ -5253,16 +5263,16 @@
          }
       },
       "node_modules/jsdom/node_modules/form-data": {
-         "version": "3.0.4",
-         "resolved": "https://registry.npmjs.org/form-data/-/form-data-3.0.4.tgz",
-         "integrity": "sha512-f0cRzm6dkyVYV3nPoooP8XlccPQukegwhAnpoLcXy+X+A8KfpGOoXwDr9FLZd3wzgLaBGQBE3lY93Zm/i1JvIQ==",
+         "version": "3.0.5",
+         "resolved": "https://registry.npmjs.org/form-data/-/form-data-3.0.5.tgz",
+         "integrity": "sha512-j23EibVLnp4zNXGW7LjryXYa2X6U/M96yoOX+ybZxwkYajdxRNEqYY3zhh7y0i6kfISKS2jr+EJq1YTUDEv5+w==",
          "dev": true,
          "license": "MIT",
          "dependencies": {
             "asynckit": "^0.4.0",
             "combined-stream": "^1.0.8",
             "es-set-tostringtag": "^2.1.0",
-            "hasown": "^2.0.2",
+            "hasown": "^2.0.4",
             "mime-types": "^2.1.35"
          },
          "engines": {
@@ -5424,9 +5434,9 @@
          }
       },
       "node_modules/lodash": {
-         "version": "4.17.21",
-         "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz",
-         "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==",
+         "version": "4.18.1",
+         "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.18.1.tgz",
+         "integrity": "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==",
          "dev": true,
          "license": "MIT"
       },
@@ -5504,7 +5514,6 @@
          "version": "1.1.0",
          "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
          "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
-         "dev": true,
          "license": "MIT",
          "engines": {
             "node": ">= 0.4"
@@ -5573,9 +5582,9 @@
          }
       },
       "node_modules/minimatch": {
-         "version": "3.1.2",
-         "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
-         "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+         "version": "3.1.5",
+         "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz",
+         "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==",
          "dev": true,
          "license": "ISC",
          "dependencies": {
@@ -5617,11 +5626,14 @@
          "license": "MIT"
       },
       "node_modules/node-releases": {
-         "version": "2.0.19",
-         "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.19.tgz",
-         "integrity": "sha512-xxOWJsBKtzAq7DY0J+DTzuz58K8e7sJbdgwkbMWQe8UYB6ekmsQ45q0M/tJDsGaZmbC+l7n57UV8Hl5tHxO9uw==",
+         "version": "2.0.58",
+         "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.58.tgz",
+         "integrity": "sha512-BdiKAgbfRlvfMq/XzO/AF9NPmaA8a+YpLAyAFTVFBj3gARrAIfWvNq7Q7NE4se3KgFu0KkrvQMxTS0XVnsGzHg==",
          "dev": true,
-         "license": "MIT"
+         "license": "MIT",
+         "engines": {
+            "node": ">=18"
+         }
       },
       "node_modules/normalize-path": {
          "version": "3.0.0",
@@ -5974,9 +5986,9 @@
          "license": "ISC"
       },
       "node_modules/picomatch": {
-         "version": "2.3.1",
-         "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz",
-         "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==",
+         "version": "2.3.2",
+         "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz",
+         "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==",
          "dev": true,
          "license": "MIT",
          "engines": {
@@ -7258,9 +7270,9 @@
          }
       },
       "node_modules/update-browserslist-db": {
-         "version": "1.1.3",
-         "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.1.3.tgz",
-         "integrity": "sha512-UxhIZQ+QInVdunkDAaiazvvT/+fXL5Osr0JZlJulepYu6Jd7qJtDZjlur0emRlT71EN3ScPoE7gvsuIKKNavKw==",
+         "version": "1.3.4",
+         "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.3.4.tgz",
+         "integrity": "sha512-t8wonIOdQyOjtPd2VktlBu6QjTVTks6v8bSi7kd0r2Vll8TK1JYDZtRRdbmCHOAMphkZgrzK+L+vXK4pyZ8t4A==",
          "dev": true,
          "funding": [
             {
@@ -7571,9 +7583,9 @@
          }
       },
       "node_modules/ws": {
-         "version": "7.5.10",
-         "resolved": "https://registry.npmjs.org/ws/-/ws-7.5.10.tgz",
-         "integrity": "sha512-+dbF1tHwZpXcbOJdVOkzLDxZP1ailvSxM6ZweXTegylPny803bFhA+vqBYw4s31NSAk4S2Qz+AKXK9a4wkdjcQ==",
+         "version": "7.5.13",
+         "resolved": "https://registry.npmjs.org/ws/-/ws-7.5.13.tgz",
+         "integrity": "sha512-rsKI6xDBFVf4r/x8XyChGK04QR/XHroxs/jUcoWvtEZM8TPU/X/uIY9B1CsSzYws9ZJb/6bbBu7dPhFW00CAoA==",
          "dev": true,
          "license": "MIT",
          "engines": {

package.json

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

scripts/clean-build.cjs

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

src/controllers/QController.ts

@@ -5,21 +5,20 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
-import {AxiosError, AxiosResponse} from "axios";
+import {AxiosError, AxiosRequestConfig, AxiosResponse} from "axios";
 import FormData from "form-data";
 import {QException} from "../exceptions/QException";
 import {QAuthenticationMetaData} from "../model/metaData/QAuthenticationMetaData";
@@ -783,13 +782,15 @@ export class QController
             }
          }
 
+         const axiosConfigExtras: AxiosRequestConfig = {};
          if (dontGoAsyncOnBackend)
          {
             formDataOrQueryString.append("_qStepTimeoutMillis", 300 * 1000);
+            axiosConfigExtras.timeout = 300 * 1000;
          }
 
          return this.axiosInstance
-            .post(url, formDataOrQueryString, {headers: formDataHeaders})
+            .post(url, formDataOrQueryString, {headers: formDataHeaders, ...axiosConfigExtras})
             .then((response: AxiosResponse) =>
             {
                const responseObject = this.parseProcessResponse(response);
@@ -899,7 +900,7 @@ export class QController
 
 
    /*******************************************************************************
-    ** Fetch the data for a specific widget.
+    ** Fetch the data about variants for a table
     *******************************************************************************/
    async tableVariants(tableName: string): Promise<QTableVariant[]>
    {
@@ -933,24 +934,48 @@ export class QController
 
 
    /*******************************************************************************
-    ** Fetch the data for a specific widget.
+    * Fetch the data for a specific widget.
+    *
+    * Originally, this was a GET request, with params passed on the query string.
+    * However, that fails if params get too long.  So, in 10/2025, qqq-javalin
+    * is being updated to serve /widget/{widgetName} as a POST.
+    *
+    * This method, for some attempted backward compatibility, will first *try* a
+    * POST.  If it fails with a 404 (which an older version (w/o the POST endpoint)
+    * would return), then, assuming the params are a string (not FormData), then
+    * this method will automatically re-try the request as a GET.
     *******************************************************************************/
-   async widget(widgetName: string, urlParams?: string): Promise<any>
+   async widget(widgetName: string, params?: string | FormData, overrideAbortName?: string): Promise<any>
    {
       let url = `/widget/${encodeURIComponent(widgetName)}`;
-      if (urlParams)
+      const abortName = overrideAbortName ?? widgetName;
+
+      const paramsAreFormData = params instanceof FormData
+      let postBody: FormData;
+      if (paramsAreFormData)
       {
-         url += `?${urlParams}`;
+         postBody = params;
+      }
+      else
+      {
+         postBody = new FormData();
+         if (params)
+         {
+            for (let pair of params.split("&"))
+            {
+               let [name, value] = pair.split("=");
+               postBody.append(name, decodeURIComponent(value));
+            }
+         }
       }
 
       /////////////////////////////////////////////////////////////////
       // see if an abort controller was created for this widget name //
       /////////////////////////////////////////////////////////////////
-      console.log("Looking for controller for widget [" + widgetName + "]");
-      let controller = QController.widgetAbortControllerMap.get(widgetName);
+      let controller = QController.widgetAbortControllerMap.get(abortName);
       if (controller)
       {
-         console.log(`Found existing abort controller for widget '${widgetName}', aborting...`);
+         console.log(`Found existing abort controller for widget '${abortName}', aborting...`);
          controller.abort();
       }
 
@@ -959,7 +984,69 @@ export class QController
       /////////////////////////////////////////
       controller = new AbortController();
       const signal = controller.signal;
-      QController.widgetAbortControllerMap.set(widgetName, controller);
+      QController.widgetAbortControllerMap.set(abortName, controller);
+
+      return this.axiosInstance
+         .post(url, postBody, {signal})
+         .then((response: AxiosResponse) =>
+         {
+            ///////////////////////////////////////////////////
+            // make sure to clear out the request controller //
+            ///////////////////////////////////////////////////
+            QController.widgetAbortControllerMap.set(abortName, null);
+            return response.data;
+         })
+         .catch(async (e: any) =>
+         {
+            ///////////////////////////////////////////////////////////////////////////////////////////////////////
+            // if the server responded with 404, assume this could be due to the backend not supporting POST for //
+            // the widget endpoint - so if we took in params as a string (not FormData), then try to do a GET    //
+            ///////////////////////////////////////////////////////////////////////////////////////////////////////
+            if(e?.response?.status == 404)
+            {
+               if(!paramsAreFormData)
+               {
+                  return await this.getWidget(widgetName, params, overrideAbortName);
+               }
+               else
+               {
+                  console.log("widget POST request failed with 404 - but params are FormData, so we cannot attempt a fallback-GET...");
+               }
+            }
+
+            if (e.code && e.code === "ERR_CANCELED")
+            {
+               console.log("Controller request cancellation successful!");
+               return;
+            }
+            this.handleException(e);
+         });
+   }
+
+
+   /*******************************************************************************
+    * Fetch the data for a specific widget, doing a GET.
+    * This HTTP method is being deprecated for rendering widgets, due to query
+    * string being too limited in size, compared to the relative unlimited size of
+    * POST body - but this method is here for a backward-compatibility later - in
+    * case hitting a backend server that 404'ed for the POST call.
+    *******************************************************************************/
+   private async getWidget(widgetName: string, urlParams?: string, overrideAbortName?: string): Promise<any>
+   {
+      const abortName = overrideAbortName ?? widgetName;
+
+      let url = `/widget/${encodeURIComponent(widgetName)}`;
+      if(urlParams)
+      {
+         url += `?${urlParams}`;
+      }
+
+      /////////////////////////////////////////
+      // keep track of this widget's request //
+      /////////////////////////////////////////
+      const controller = new AbortController();
+      const signal = controller.signal;
+      QController.widgetAbortControllerMap.set(abortName, controller);
 
       return this.axiosInstance
          .get(url, {signal})
@@ -968,7 +1055,7 @@ export class QController
             ///////////////////////////////////////////////////
             // make sure to clear out the request controller //
             ///////////////////////////////////////////////////
-            QController.widgetAbortControllerMap.set(widgetName, null);
+            QController.widgetAbortControllerMap.set(abortName, null);
             return response.data;
          })
          .catch((e: any) =>
@@ -983,6 +1070,7 @@ export class QController
    }
 
 
+
    /***************************************************************************
     * overload 1 of possibleValues function - this is its "original" signature
     * that took several params, many optional, and kept evolving and getting

src/controllers/QControllerV1.ts

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

src/exceptions/QException.ts

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

src/model/QPossibleValue.ts

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

src/model/QRecord.ts

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

src/model/metaData/AdornmentType.ts

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

src/model/metaData/Banner.ts

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

src/model/metaData/Capability.ts

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

src/model/metaData/Collapsible.ts

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

src/model/metaData/FieldAdornment.ts

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

src/model/metaData/ProcessMetaDataAdjustment.ts

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

src/model/metaData/QAppMetaData.ts

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

src/model/metaData/QAppNodeType.ts

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

src/model/metaData/QAppSection.ts

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

src/model/metaData/QAppTreeNode.ts

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

src/model/metaData/QAuthenticationMetaData.ts

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

src/model/metaData/QBrandingMetaData.ts

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

src/model/metaData/QComponentType.ts

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

src/model/metaData/QExposedJoin.ts

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

src/model/metaData/QFieldMetaData.ts

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

src/model/metaData/QFieldType.ts

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

src/model/metaData/QFrontendComponent.ts

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

src/model/metaData/QFrontendStepMetaData.ts

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

src/model/metaData/QHelpContent.ts

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

src/model/metaData/QIcon.ts

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

src/model/metaData/QInstance.ts

@@ -5,18 +5,17 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {QAppMetaData} from "./QAppMetaData";
@@ -45,6 +44,8 @@ export class QInstance
    environmentValues?: Map<string, string>;
    helpContent?: Map<string, QHelpContent[]>;
    supplementalInstanceMetaData: Map<String, any> = new Map();
+   redirects: Map<string, string> = new Map();
+   private pathsMap: Record<string, {path: string, affinity: number}[]> = {};
 
    constructor(object: any)
    {
@@ -125,6 +126,44 @@ export class QInstance
       }
 
       this.helpContent = QHelpContent.buildMap(object.helpContents);
+
+      if (object.redirects)
+      {
+         for (const key in object.redirects)
+         {
+            this.redirects.set(key, object.redirects[key]);
+         }
+      }
+
+      this.buildPathsMap(this.appTree || []);
+   }
+
+
+   /***************************************************************************
+    * populate the private/internal "pathsMap" - with lists of all available
+    * paths to tables, processes, etc (where a table in more than 1 app will
+    * have more than 1 entry).  This is used to help determine which app to
+    * open when a user clicks on a table name.  To select a path, they should
+    * be sorted by affinity, so that the most preferred app is first.
+    ***************************************************************************/
+   buildPathsMap(nodes: QAppTreeNode[], path: string = ""): void
+   {
+      for (let i = 0; i < nodes.length; i++)
+      {
+         const node = nodes[i];
+         if(node.type === QAppNodeType.APP && node.children)
+         {
+            this.buildPathsMap(node.children, path + "/" + node.name);
+         }
+         else
+         {
+            if(!this.pathsMap[node.name])
+            {
+               this.pathsMap[node.name] = [];
+            }
+            this.pathsMap[node.name].push({path: path + "/" + node.name, affinity: node.appAffinity ?? Number.MIN_SAFE_INTEGER});
+         }
+      }
    }
 
 
@@ -142,7 +181,7 @@ export class QInstance
     *******************************************************************************/
    getTablePath(table: QTableMetaData): string | null
    {
-      return QInstance.searchAppTreeForPath(this.appTree, table.name, QAppNodeType.TABLE, 1, "");
+      return this.getTablePathByName(table.name);
    }
 
    /*******************************************************************************
@@ -150,7 +189,14 @@ export class QInstance
     *******************************************************************************/
    getTablePathByName(tableName: string): string | null
    {
-      return QInstance.searchAppTreeForPath(this.appTree, tableName, QAppNodeType.TABLE, 1, "");
+      const value = this.pathsMap[tableName];
+      if(value)
+      {
+         value.sort((a, b) => b.affinity - a.affinity);
+         return (value[0].path);
+      }
+
+      return (null);
    }
 
    /*******************************************************************************

src/model/metaData/QJoinMetaData.ts

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

src/model/metaData/QMenu.ts

@@ -0,0 +1,68 @@
+/*
+ * 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 {QIcon} from "./QIcon";
+import {QMenuItem} from "./QMenuItem";
+
+/*******************************************************************************
+ * Meta-Data that defines a Menu in a QQQ Instance
+ *
+ *******************************************************************************/
+export class QMenu
+{
+   label: string;
+   icon?: QIcon;
+   slot: string;
+   items?: QMenuItem[];
+
+   constructor(object: any)
+   {
+      this.label = object.label;
+      if (object.icon)
+      {
+         this.icon = new QIcon(object.icon);
+      }
+      this.slot = object.slot;
+      if (object.items)
+      {
+         this.items = object.items.map((item: any) => new QMenuItem(item));
+      }
+   }
+
+   /***************************************************************************
+    *
+    ***************************************************************************/
+   public clone(): QMenu
+   {
+      const clone = new QMenu({
+         label: this.label,
+         slot: this.slot
+      });
+
+      clone.icon = this.icon?.clone();
+
+      if (this.items)
+      {
+         clone.items = this.items.map((item: QMenuItem) => item.clone());
+      }
+
+      return (clone);
+   }
+}

src/model/metaData/QMenuItem.ts

@@ -0,0 +1,74 @@
+/*
+ * 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 {QIcon} from "./QIcon";
+
+/*******************************************************************************
+ * Meta-Data that defines a MenuItem in a QQQ Instance
+ *
+ *******************************************************************************/
+export class QMenuItem
+{
+   label: string;
+   icon?: QIcon;
+   itemType: string;
+   values?: Map<string, any>;
+
+   constructor(object: any)
+   {
+      this.label = object.label;
+      if (object.icon)
+      {
+         this.icon = new QIcon(object.icon);
+      }
+      this.itemType = object.itemType;
+
+      if (object.values)
+      {
+         this.values = new Map<string, any>();
+
+         for (let key in object.values)
+         {
+            this.values?.set(key, object.values[key]);
+         }
+      }
+   }
+
+   /***************************************************************************
+    *
+    ***************************************************************************/
+   public clone(): QMenuItem
+   {
+      const clone = new QMenuItem({
+         label: this.label,
+         itemType: this.itemType
+      });
+
+      clone.icon = this.icon?.clone();
+
+      if (this.values)
+      {
+         clone.values = new Map<string, any>();
+         this.values.forEach((value: any, key: string) => clone.values?.set(key, value));
+      }
+
+      return (clone);
+   }
+}

src/model/metaData/QProcessMetaData.ts

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

src/model/metaData/QReportMetaData.ts

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

src/model/metaData/QTableMetaData.ts

@@ -5,24 +5,25 @@
  * contact@kingsrook.com
  * https://github.com/Kingsrook/
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as
- * published by the Free Software Foundation, either version 3 of the
- * License, or (at your option) any later version.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
 
 import {QExposedJoin} from "./QExposedJoin";
 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.
@@ -35,6 +36,7 @@ export class QTableMetaData
    isHidden: boolean = false;
    primaryKeyField: string;
    fields?: Map<string, QFieldMetaData>;
+   virtualFields?: Map<string, QVirtualFieldMetaData>;
    iconName?: string;
    sections?: QTableSection[];
    exposedJoins?: QExposedJoin[];
@@ -48,6 +50,7 @@ export class QTableMetaData
    supplementalTableMetaData: Map<String, any> = new Map();
    shareableTableMetaData: any;
    helpContent?: Map<string, QHelpContent[]>;
+   menus?: QMenu[];
 
    constructor(object: any)
    {
@@ -72,6 +75,15 @@ export class QTableMetaData
          }
       }
 
+      if (object.virtualFields)
+      {
+         this.virtualFields = new Map<string, QVirtualFieldMetaData>();
+         for (const key in object.virtualFields)
+         {
+            this.virtualFields.set(key, new QVirtualFieldMetaData(object.virtualFields[key]));
+         }
+      }
+
       if (object.sections)
       {
          this.sections = [];
@@ -93,7 +105,7 @@ export class QTableMetaData
       this.capabilities = new Set<string>();
       if (object.capabilities)
       {
-         for (var i = 0; i < object.capabilities.length; i++)
+         for (let i = 0; i < object.capabilities.length; i++)
          {
             this.capabilities.add(object.capabilities[i]);
          }
@@ -110,5 +122,113 @@ export class QTableMetaData
       this.shareableTableMetaData = object.shareableTableMetaData;
 
       this.helpContent = QHelpContent.buildMap(object.helpContents);
+
+      if(object.menus)
+      {
+         this.menus = [];
+         for(let i = 0; i < object.menus.length; i++)
+         {
+            this.menus.push(new QMenu(object.menus[i]));
+         }
+      }
    }
+
+
+   /***************************************************************************
+    *
+    ***************************************************************************/
+   public clone(): QTableMetaData
+   {
+      const fieldsClone = this.fields ? new Map() : undefined;
+      if (this.fields && fieldsClone)
+      {
+         this.fields.forEach((field, name) =>
+         {
+            fieldsClone.set(name, field.clone());
+         });
+      }
+
+      const virtualFieldsClone = this.virtualFields ? new Map() : undefined;
+      if (this.virtualFields && virtualFieldsClone)
+      {
+         this.virtualFields.forEach((field, name) =>
+         {
+            virtualFieldsClone.set(name, field.clone());
+         });
+      }
+
+      const sectionsClone: QTableSection[] | undefined = this.sections ? [] : undefined;
+      if (this.sections && sectionsClone)
+      {
+         for (let section of this.sections)
+         {
+            sectionsClone.push((section as any).clone());
+         }
+      }
+
+      const exposedJoinsClone: QExposedJoin[] | undefined = this.exposedJoins ? [] : undefined;
+      if (this.exposedJoins && exposedJoinsClone)
+      {
+         for (let exposedJoin of this.exposedJoins)
+         {
+            exposedJoinsClone.push((exposedJoin as any).clone());
+         }
+      }
+
+      const capabilitiesClone = new Set<string>();
+      if (this.capabilities && capabilitiesClone)
+      {
+         this.capabilities.forEach((capability) =>
+         {
+            capabilitiesClone.add(capability);
+         });
+      }
+
+      const helpContentsClone = this.helpContent ? new Map() : undefined;
+      if (this.helpContent && helpContentsClone)
+      {
+         this.helpContent.forEach((helpContentArray, name) =>
+         {
+            if (helpContentArray)
+            {
+               const helpContentArrayClone: QHelpContent[] = [];
+               for (let qHelpContent of helpContentArray)
+               {
+                  helpContentArrayClone.push((qHelpContent as any).clone());
+               }
+               helpContentsClone.set(name, helpContentArrayClone);
+            }
+         });
+      }
+
+      const supplementalTableMetaDataClone = new Map<String, any>();
+      this.supplementalTableMetaData.forEach((value, name) =>
+      {
+         supplementalTableMetaDataClone.set(name, Object.assign({}, value));
+      });
+
+      const menusClone: QMenu[] | undefined = this.menus ? [] : undefined;
+      if (this.menus && menusClone)
+      {
+         for (let i = 0; i < this.menus.length; i++)
+         {
+            menusClone.push(this.menus[i].clone());
+         }
+      }
+
+      const clone = new QTableMetaData({...this});
+
+      clone.fields = fieldsClone;
+      clone.virtualFields = virtualFieldsClone;
+      clone.sections = sectionsClone;
+      clone.exposedJoins = exposedJoinsClone;
+      clone.capabilities = capabilitiesClone;
+      clone.supplementalTableMetaData = supplementalTableMetaDataClone;
+      clone.helpContent = helpContentsClone;
+      clone.menus = menusClone;
+
+      return (clone);
+   }
+
+
 }

src/model/metaData/QTableSection.ts

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

src/model/metaData/QTableVariant.ts

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

src/model/metaData/QVirtualFieldMetaData.ts

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

src/model/metaData/QWidgetMetaData.ts

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

src/model/processes/QJobComplete.ts

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

src/model/processes/QJobError.ts

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

src/model/processes/QJobRunning.ts

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

src/model/processes/QJobStarted.ts

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

src/model/query/FieldFunction.ts

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

src/model/query/FilterVariableExpression.ts

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

src/model/query/NowExpression.ts

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

src/model/query/NowWithOffsetExpression.ts

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

src/model/query/QCriteriaOperator.ts

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

src/model/query/QFilterCriteria.ts

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

src/model/query/QFilterOrderBy.ts

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

src/model/query/QQueryFilter.ts

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

src/model/query/QueryJoin.ts

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

src/model/query/ThisOrLastPeriodExpression.ts

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

src/qqq-frontend-core.ts

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

tests/PackageExports.test.ts

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

tests/controllers/QController.test.ts

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

tests/controllers/QControllerTransport.test.ts

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

tests/controllers/QInstance.test.ts

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

tests/model/metaData/Collapsible.test.ts

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

tests/model/metaData/QInstance.test.ts

@@ -0,0 +1,88 @@
+/*
+ * 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 {QAppMetaData} from "../../../src/model/metaData/QAppMetaData";
+import {QAppNodeType} from "../../../src/model/metaData/QAppNodeType";
+import {QAppTreeNode} from "../../../src/model/metaData/QAppTreeNode";
+import {QInstance} from "../../../src/model/metaData/QInstance";
+import {QTableMetaData} from "../../../src/model/metaData/QTableMetaData";
+
+describe("QInstance", () =>
+{
+   describe("getTablePath", () =>
+   {
+      it("should work for basic case (tables in only 1 app)", () =>
+      {
+         const qInstance = buildTestQInstance();
+         expect(qInstance.getTablePathByName("order")).toBe("/oms/order");
+         expect(qInstance.getTablePathByName("group")).toBe("/admin/usermgr/group");
+         expect(qInstance.getTablePathByName("role")).toBe("/setup/role");
+      });
+
+      it("should use app affinity when table is in two apps", () =>
+      {
+         const qInstance1 = buildTestQInstance({user: {admin: 50, setup: 100}});
+         expect(qInstance1.getTablePathByName("user")).toBe("/setup/user");
+
+         const qInstance2 = buildTestQInstance({user: {admin: 1}});
+         expect(qInstance2.getTablePathByName("user")).toBe("/admin/usermgr/user");
+      });
+
+   });
+
+});
+
+
+function buildTestQInstance(affinityValues: Record<string, Record<string, number>> = {}): QInstance
+{
+   const qInstance = new QInstance({});
+
+   qInstance.tables = new Map<string, QTableMetaData>();
+   qInstance.tables.set("order", new QTableMetaData({name: "order"}));
+   qInstance.tables.set("user", new QTableMetaData({name: "user"})); // will be under both /admin/usermgr and /setup
+   qInstance.tables.set("group", new QTableMetaData({name: "group"})); // will just be under /admin/usermgr
+   qInstance.tables.set("role", new QTableMetaData({name: "role"})); // will just be under /setup
+
+   qInstance.apps = new Map<string, QAppMetaData>();
+   qInstance.apps.set("oms", new QAppMetaData({name: "oms"}));
+   qInstance.apps.set("usermgr", new QAppMetaData({name: "usermgr"})); // will go under setup
+   qInstance.apps.set("admin", new QAppMetaData({name: "admin"}));
+   qInstance.apps.set("setup", new QAppMetaData({name: "setup"}));
+
+   const orderTableNode = new QAppTreeNode({name: "order", type: QAppNodeType.TABLE});
+   const userTableNodeForAdminUsermgr = new QAppTreeNode({name: "user", type: QAppNodeType.TABLE, appAffinity: affinityValues["user"]?.["admin"] ?? undefined});
+   const userTableNodeForSetup = new QAppTreeNode({name: "user", type: QAppNodeType.TABLE, appAffinity:  affinityValues["user"]?.["setup"] ?? undefined});
+   const groupTableNode = new QAppTreeNode({name: "group", type: QAppNodeType.TABLE});
+   const roleTableNode = new QAppTreeNode({name: "role", type: QAppNodeType.TABLE});
+
+   const omsAppNode = new QAppTreeNode({name: "oms", type: QAppNodeType.APP, children: [orderTableNode]});
+   const usermgrAppNode = new QAppTreeNode({name: "usermgr", type: QAppNodeType.APP, children: [userTableNodeForAdminUsermgr, groupTableNode]});
+   const adminAppNode = new QAppTreeNode({name: "admin", type: QAppNodeType.APP, children: [usermgrAppNode]});
+   const setupAppNode = new QAppTreeNode({name: "setup", type: QAppNodeType.APP, children: [userTableNodeForSetup, roleTableNode]});
+
+   qInstance.appTree = [];
+   qInstance.appTree.push(omsAppNode);
+   qInstance.appTree.push(adminAppNode);
+   qInstance.appTree.push(setupAppNode);
+
+   qInstance.buildPathsMap(qInstance.appTree);
+
+   return (qInstance);
+}

tests/model/metaData/QTableMetaData.test.ts

@@ -0,0 +1,450 @@
+/*
+ * 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 {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", () =>
+   {
+      /////////////////////////////////////
+      // build a table with lots of data //
+      /////////////////////////////////////
+      const table = new QTableMetaData(
+         {
+            "name": "myTable",
+            "label": "My Table",
+            "isHidden": false,
+            "primaryKeyField": "id",
+            "icon": {"name": "link"},
+            "fields": {
+               "id": {
+                  "name": "id",
+                  "label": "Id",
+                  "type": "INTEGER",
+                  "isRequired": false,
+                  "isEditable": true,
+                  "isHeavy": false,
+                  "isHidden": false,
+                  "gridColumns": -1,
+                  "displayFormat": "%s"
+               },
+               "name": {
+                  "name": "name",
+                  "label": "Name",
+                  "type": "STRING",
+                  "isRequired": false,
+                  "isEditable": true,
+                  "isHeavy": false,
+                  "isHidden": false,
+                  "gridColumns": -1,
+                  "displayFormat": "%s",
+                  "maxLength": 100
+               },
+               "clientId": {
+                  "name": "clientId",
+                  "label": "Client",
+                  "type": "INTEGER",
+                  "isRequired": false,
+                  "isEditable": true,
+                  "isHeavy": false,
+                  "isHidden": false,
+                  "gridColumns": -1,
+                  "possibleValueSourceName": "client",
+                  "displayFormat": "%s",
+                  "adornments": [
+                     {
+                        "type": "LINK",
+                        "values": {
+                           "toRecordFromTable": "client"
+                        }
+                     }
+                  ],
+                  "possibleValueSourceFilter": {
+                     "criteria": [
+                        {
+                           "fieldName": "isActive",
+                           "operator": "EQUALS",
+                           "values": [
+                              true
+                           ]
+                        }
+                     ],
+                     "booleanOperator": "AND",
+                     "subFilters": [
+                        {
+                           "criteria": [
+                              {
+                                 "fieldName": "clientId",
+                                 "operator": "EQUALS",
+                                 "values": [
+                                    "${input.clientId}"
+                                 ]
+                              },
+                              {
+                                 "fieldName": "clientId",
+                                 "operator": "IS_BLANK"
+                              }
+                           ],
+                           "booleanOperator": "OR"
+                        }
+                     ]
+                  }
+               },
+               "apiKey": {
+                  "name": "apiKey",
+                  "label": "API Key",
+                  "type": "PASSWORD",
+                  "isRequired": false,
+                  "isEditable": true,
+                  "isHeavy": false,
+                  "isHidden": false,
+                  "gridColumns": -1,
+                  "displayFormat": "%s",
+                  "helpContents": [
+                     {
+                        "content": "Field Help",
+                        "format": "MARKDOWN",
+                        "roles": ["READ_SCREENS"],
+                        "contentAsHtml": "Field Help"
+                     }
+                  ],
+                  "supplementalMetaData": {
+                     "materialDashboard": {
+                        "formAdjusterIdentifier": "table:connection;field:externalSystemId",
+                        "onChangeFormAdjuster": {
+                           "name": "com.coldtrack.live.tables.setup.customizers.ConnectionTableMetaDataAdjuster",
+                           "codeType": "JAVA"
+                        },
+                        "type": "materialDashboard"
+                     }
+                  },
+                  "adornments": [
+                     {
+                        "type": "LINK",
+                        "values": {"toRecordFromTable": "foreignTable"}
+                     }
+                  ]
+               },
+               "type": {
+                  "name": "type",
+                  "label": "Type",
+                  "type": "BOOLEAN",
+                  "isRequired": false,
+                  "isEditable": true,
+                  "isHeavy": false,
+                  "isHidden": false,
+                  "gridColumns": -1,
+                  "displayFormat": "%s",
+                  "possibleValueSourceName": "type",
+                  "supplementalMetaData": {
+                     "materialDashboard": {
+                        "formAdjusterIdentifier": "table:myTable;field:type",
+                        "onChangeFormAdjuster": {
+                           "name": "com.qqq.MyTableFormAdjuster",
+                           "codeType": "JAVA"
+                        },
+                        "type": "materialDashboard"
+                     }
+                  }
+               },
+            },
+            "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",
+                  "label": "Identity",
+                  "tier": "T1",
+                  "fieldNames": ["id", "name"],
+                  "icon": {"name": "badge"},
+                  "isHidden": false,
+                  "alternatives": {
+                     "RECORD_VIEW": {
+                        "name": "identityView",
+                        "label": "Identity",
+                        "fieldNames": ["id", "specialName"]
+                     }
+                  }
+               },
+               {
+                  "name": "authentication",
+                  "label": "Authentication",
+                  "tier": "T2",
+                  "fieldNames": ["apiKey",],
+                  "icon": {"name": "edit_attributes"},
+                  "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": []}
+                  ]
+               }
+            ],
+            "supplementalTableMetaData": {
+               "materialDashboard": {
+                  "onLoadFormAdjuster": {
+                     "name": "com.qqq.MyTableFormAdjuster",
+                     "codeType": "JAVA"
+                  },
+                  "type": "materialDashboard"
+               }
+            },
+            "capabilities": [
+               "TABLE_COUNT",
+               "TABLE_GET",
+               "TABLE_QUERY",
+               "QUERY_STATS",
+               "TABLE_INSERT",
+               "TABLE_UPDATE",
+               "TABLE_DELETE",
+               "TABLE_EXPORT"
+            ],
+            "readPermission": true,
+            "insertPermission": true,
+            "editPermission": true,
+            "deletePermission": true,
+            "usesVariants": false,
+            "iconName": "link",
+            "helpContents": {
+               "key": [
+                  {
+                     "content": "Table Help",
+                     "format": "MARKDOWN",
+                     "roles": ["WRITE_SCREENS"],
+                     "contentAsHtml": "Table Help"
+                  }
+               ]
+            },
+            "menus": [
+               {
+                  label: "My Menu",
+                  icon: {name: "hotdog"},
+                  slot: "VIEW_SCREEN_ADDITIONAL",
+                  items: [
+                     {label: "Cars", icon: {name: "car"}, itemType: "RUN_PROCESS", values: {processName: "runCarsProcess"}},
+                     {label: "Apples", icon: {name: "download"}, itemType: "DOWNLOAD_FILE", values: {fieldName: "appleFileUrl"}},
+                  ]
+               }
+            ]
+         });
+
+      ////////////////////////////////////////////////////////////////
+      // clone it - make a few assertions about data being the same //
+      ////////////////////////////////////////////////////////////////
+      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);
+      expect(cloneTable.sections?.[0].iconName).toEqual(table.sections?.[0].iconName);
+      expect(cloneTable.sections?.[0].alternatives?.size).toEqual(1);
+
+      expect(cloneTable.capabilities.size).toEqual(table.capabilities.size);
+
+      expect(cloneTable.helpContent?.size).toEqual(table.helpContent?.size);
+      expect(cloneTable.helpContent?.get("key")?.[0].roles.size).not.toEqual(0);
+      expect(cloneTable.helpContent?.get("key")?.[0].roles.size).toEqual(table.helpContent?.get("key")?.[0].roles.size);
+
+      expect(cloneTable.supplementalTableMetaData.size).not.toEqual(0);
+      expect(cloneTable.supplementalTableMetaData.size).toEqual(table.supplementalTableMetaData.size);
+
+      const apiKeyField = table.fields?.get("apiKey");
+      const cloneApiKeyField = cloneTable.fields?.get("apiKey");
+      expect(cloneApiKeyField?.supplementalFieldMetaData.size).not.toEqual(0);
+      expect(cloneApiKeyField?.supplementalFieldMetaData.size).toEqual(apiKeyField?.supplementalFieldMetaData.size);
+      expect(cloneApiKeyField?.adornments?.length).not.toEqual(0);
+      expect(cloneApiKeyField?.adornments?.length).toEqual(apiKeyField?.adornments?.length);
+      expect(cloneApiKeyField?.adornments?.[0].values?.size).not.toEqual(0);
+      expect(cloneApiKeyField?.adornments?.[0].values?.size).toEqual(apiKeyField?.adornments?.[0].values?.size);
+
+      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 //
+      ////////////////////////////////////////////////////////////////////////////////////////////////
+      expect(cloneTable).toEqual(table);
+
+      ///////////////////////////////////////////////////////////////////////////////////////////
+      // change some things in the clone - assert that they are then not equal to the original //
+      ///////////////////////////////////////////////////////////////////////////////////////////
+      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;
+
+      expect(cloneTable.sections?.[0].name).not.toEqual(table.sections?.[0].name);
+      expect(cloneTable.sections?.[0].isHidden).not.toEqual(table.sections?.[0].isHidden);
+
+      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);
+
+      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.sections?.[0]?.fieldNames?.push("foobar");
+      expect(cloneTable.sections?.[0]?.fieldNames?.length).not.toEqual(table.sections?.[0]?.fieldNames?.length);
+
+      cloneTable.sections?.[0]?.alternatives?.get("RECORD_VIEW")?.fieldNames?.push("another");
+      expect(table.sections?.[0]?.alternatives?.get("RECORD_VIEW")?.fieldNames?.length).toEqual(2);
+      expect(cloneTable.sections?.[0]?.alternatives?.get("RECORD_VIEW")?.fieldNames?.length).toEqual(3);
+
+      cloneTable.menus?.[0]?.icon && (cloneTable.menus[0].icon.name = "hamburger");
+      cloneTable.menus?.[0]?.items && (cloneTable.menus[0].items.push(new QMenuItem({itemType: "DIVIDER"})));
+      cloneTable.menus && (cloneTable.menus.push(new QMenu({})));
+      expect(cloneTable.menus?.[0]?.icon?.name).not.toEqual(table.menus?.[0]?.icon?.name);
+      expect(cloneTable.menus?.[0]?.items?.length).not.toEqual(table.menus?.[0]?.items?.length);
+      expect(cloneTable.menus?.length).not.toEqual(table.menus?.length);
+   });
+
+});

tests/model/metaData/QTableSection.test.ts

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

tests/model/metaData/QWidgetMetaData.test.ts

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

tests/model/query/QQueryFilter.test.ts

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