ngx-view-builder-designer 0.5.0

package/LICENSE.md

@@ -0,0 +1,79 @@
+# NGX View Builder Designer Commercial License Agreement
+
+Copyright © 2026 NGX View Builder (https://ngxviewbuilder.io). All rights reserved.
+
+This is a legal agreement between you (the **"Licensee"**) and NGX View Builder (the **"Licensor"**) covering the `ngx-view-builder-designer` package and the official `ngx-view-builder-plugin-*` packages (together the **"Software"**). By installing or using the Software you agree to these terms.
+
+**This is commercial software. It is not open source.** The Software's source form being readable in the npm distribution does not grant any open-source rights.
+
+The `ngx-view-builder-runtime` package is **not** covered by this agreement. It is free to use in production, requires no License Key, and has its own terms in that package's `LICENSE.md`. What you pay for here is the visual editor your team designs views in.
+
+## 1. Definitions
+
+- **"License Key"** a cryptographically signed key issued by Licensor that identifies the customer, plan, and expiry date (the **"License Term"**).
+- **"Covered Version"** any version of the Software whose release date is earlier than the expiry date of Licensee's License Key.
+- **"Application"** a software product that incorporates the Software, developed by Licensee for itself **or for a client of Licensee** (contract / agency work).
+
+## 2. License grant
+
+Subject to the purchase of a valid License Key and compliance with this agreement, Licensor grants Licensee a non-exclusive, non-transferable, worldwide license to:
+
+1. use the Software to develop Applications, within the limits of the purchased plan;
+2. deploy Covered Versions in any number of Applications and environments, unless the purchased plan states otherwise;
+3. develop Applications **for third parties (Licensee's clients)** and deliver or transfer such Applications to them the client may operate, host, and use the delivered Application without a separate License Key;
+4. keep using Covered Versions **perpetually** this right survives the end of the License Term.
+
+End users of Licensee's Applications do **not** need their own License Key: an Application ships `ngx-view-builder-runtime`, which is free and shows no license UI.
+
+For clarity, development with the Software must be covered by a License Key held by **either side of a contract-work relationship**:
+
+- If Licensee is a development company or agency, its License Key covers the development it performs for its clients (Section 2.3).
+- If Licensee is the end customer of an Application, Licensee's License Key also covers **contractors and outsourced developers** working on that Application on Licensee's behalf. Such contractor use is limited to Licensee's Applications and does not extend to the contractor's own or other clients' projects.
+
+Any party that develops with the Software outside these two cases needs its own License Key.
+
+## 3. Evaluation use
+
+The Software may be used **without** a License Key for evaluation and development trial purposes only. In that mode the builder displays a watermark. Any production use requires a valid License Key.
+
+## 4. Updates
+
+Versions of the Software released **after** the end of the License Term are not Covered Versions. Using them requires renewing the License Key; without renewal they run in degraded (watermarked) mode.
+
+## 5. Restrictions
+
+Licensee may not:
+
+1. redistribute, resell, rent, lease, or sublicense the Software on its own (i.e. other than embedded in an Application);
+2. offer the Software, or a product derived from it, as a form-builder, view-builder, or low-code SDK/service that competes with the Software;
+3. remove, disable, alter, or circumvent the license-enforcement mechanisms (License Keys, watermark, signature or server validation), nor assist or permit anyone else to do so;
+4. exceed the seat, plan, or usage limits of the purchased plan;
+5. remove or alter copyright or license notices.
+
+## 6. Third-party software
+
+The Software depends on third-party open-source packages installed separately from npm, each under its own license (MIT: `codemirror`, `@codemirror/*`, `jexl`, `prettier`, `lodash-es`; 0BSD: `tslib`). Those licenses govern those packages only; this agreement governs the Software.
+
+## 7. Ownership
+
+The Software is licensed, not sold. Licensor retains all right, title, and interest in and to the Software.
+
+## 8. Warranty disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+## 9. Limitation of liability
+
+TO THE MAXIMUM EXTENT PERMITTED BY LAW, LICENSOR SHALL NOT BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES, NOR FOR LOSS OF PROFITS, DATA, OR BUSINESS, ARISING FROM THE USE OF THE SOFTWARE. LICENSOR'S AGGREGATE LIABILITY UNDER THIS AGREEMENT SHALL NOT EXCEED THE LICENSE FEES PAID BY LICENSEE IN THE TWELVE (12) MONTHS PRECEDING THE CLAIM.
+
+## 10. Termination
+
+This agreement terminates automatically if Licensee materially breaches it. Upon termination, Licensee must stop using the Software; rights to Covered Versions granted under Section 2.3 do not survive termination for breach. Sections 6–11 survive termination.
+
+## 11. Governing law
+
+This agreement is governed by the laws of the Republic of Lithuania. Any disputes shall be resolved by the competent courts of the Republic of Lithuania.
+
+---
+
+Questions about licensing: support@ngxviewbuilder.io · Pricing and License Keys: https://ngxviewbuilder.io/pricing

package/README.md

@@ -0,0 +1,104 @@
+# ngx-view-builder-designer
+
+The visual editor half of [NGX View Builder](https://ngxviewbuilder.io): a drag-and-drop workspace where an Angular screen (forms, dashboards, data tables, multi-step flows) is composed, previewed and saved as a plain JSON document.
+
+It runs on top of [`ngx-view-builder-runtime`](https://www.npmjs.com/package/ngx-view-builder-runtime), which renders what you design. The two are versioned in lockstep. Install this package only where people actually edit views, so the editor stays out of your production bundle.
+
+## Requirements
+
+Angular 22 or newer, plus `ngx-view-builder-runtime` at the same version. `@angular/common`, `@angular/core`, `@angular/cdk` and `@angular/forms` are peer dependencies.
+
+## Install
+
+```bash
+npm i ngx-view-builder-runtime ngx-view-builder-designer
+```
+
+The designer needs the runtime's providers and stylesheet, because it renders real elements in the canvas and preview.
+
+```ts
+import { bootstrapApplication } from '@angular/platform-browser';
+import { provideNgxViewBuilderRuntime } from 'ngx-view-builder-runtime';
+import { AppComponent } from './app/app.component';
+
+bootstrapApplication(AppComponent, {
+  providers: [provideNgxViewBuilderRuntime()],
+});
+```
+
+```css
+@import 'ngx-view-builder-runtime/styles/index.css';
+```
+
+## Embed the designer
+
+```ts
+import { Component } from '@angular/core';
+import { NgxViewBuilderBuilder, BuilderModel, IStructure } from 'ngx-view-builder-designer';
+
+@Component({
+  selector: 'app-designer',
+  imports: [NgxViewBuilderBuilder],
+  template: `
+    <ngx-view-builder-builder
+      [model]="model"
+      [runtimeSettings]="{ licenseKey: licenseKey }"
+      (saveRequested)="save()" />
+  `,
+})
+export class DesignerComponent {
+  licenseKey = 'your-key';
+  model = new BuilderModel();
+
+  save() {
+    const structure: IStructure = this.model.getJson();
+    // Persist wherever you like: database, file, API.
+  }
+}
+```
+
+Two things that catch people out:
+
+- Give the host element real height. The designer fills its container, and a container of height `0` renders an empty strip.
+- `BuilderModel` is constructed empty. Load an existing view with `model.setJson(raw)`, which takes the JSON as a **string**; `getJson()` returns a parsed `IStructure`.
+
+That is the whole setup. Settings, theming, custom header actions, templates and the rest are covered in the [developer guide](https://ngxviewbuilder.io/developers/).
+
+## Runtime API
+
+The runtime's public API is re-exported here, so a host that embeds the designer can take `IStructure`, `BuilderModel`, `NgxViewBuilderApiService` and the rest from one import site. Code that only renders views should import from `ngx-view-builder-runtime` directly, which is what keeps the designer out of your production bundle.
+
+## Upgrading from `ngx-view-builder`
+
+That package was one library containing both halves. From 0.5.0 it is two.
+
+```bash
+npm rm ngx-view-builder
+npm i ngx-view-builder-runtime ngx-view-builder-designer
+```
+
+Change the import source and the stylesheet path; selectors, inputs, outputs and saved JSON are unchanged.
+
+```diff
+-import { NgxViewBuilderBuilder, BuilderModel } from 'ngx-view-builder';
++import { NgxViewBuilderBuilder, BuilderModel } from 'ngx-view-builder-designer';
+```
+
+```diff
+-@import 'ngx-view-builder/styles/index.css';
++@import 'ngx-view-builder-runtime/styles/index.css';
+```
+
+## Documentation
+
+https://ngxviewbuilder.io
+
+- Developer guide: https://ngxviewbuilder.io/developers/
+- Creator guide: https://ngxviewbuilder.io/creators/
+- Live demo: https://ngxviewbuilder.io/demo
+
+## License
+
+Commercial software. Terms in [LICENSE.md](./LICENSE.md). The designer is what a license key covers; the runtime is free.
+
+Pricing and keys: https://ngxviewbuilder.io/pricing