@gridify/studio 0.0.0-stage → 1.0.0-rc.1

package/LICENSE

@@ -0,0 +1,163 @@
+# GRIDIFY STUDIO SOFTWARE LICENSE AGREEMENT
+
+**Version 1.0 — Effective Date: November 2026**
+
+**Licensor:** Gridify Softworks s.r.o., Czech Republic
+
+**Product:** Gridify Studio (including the Gridify Designer integrated application)
+
+**Official Portal:** https://gridify.dev
+
+### IMPORTANT NOTICE — PLEASE READ CAREFULLY
+
+BY DOWNLOADING, INSTALLING, COPYING, ACCESSING, OR OTHERWISE USING GRIDIFY STUDIO OR THE GRIDIFY DESIGNER (COLLECTIVELY, THE "SOFTWARE"), YOU ("LICENSEE") AGREE TO BE BOUND BY THE TERMS OF THIS SOFTWARE LICENSE AGREEMENT ("AGREEMENT") ENTERED INTO WITH GRIDIFY SOFTWORKS S.R.O. ("LICENSOR"). IF YOU DO NOT AGREE TO THE TERMS, DO NOT INSTALL, COPY, OR USE THE SOFTWARE.
+
+### 1. DEFINITIONS
+
+* **"Licensor"** means **Gridify Softworks s.r.o.**, a limited liability company organized and existing under the laws of the Czech Republic.
+
+* **"Software"** means the Gridify Studio platform and SDK, comprising runtime libraries, Angular UI components, docking containers, directives, themes, documentation, interactive tutorials, sample applications, and the **Gridify Designer** integrated visual application.
+
+* **"Gridify Designer"** means the integrated visual RAD application provided with the Software, featuring unified, switchable editing environments including, but not limited to, the Layout Editor, Ribbon Editor, and Form Editor.
+
+* **"Designated Developer"** means an identified individual software engineer, contractor, or architect employed or retained by Licensee who actively integrates, programs, builds, or designs applications utilizing the Software. Build servers, continuous integration systems, testers, and end users of Licensee's applications who do not write code with the Software are not Designated Developers.
+
+* **"Community Edition"** means the free runtime packages and accompanying Gridify Designer application distributed for community, educational, and public web use.
+
+* **"Public Web Application"** means a web-based application freely and publicly accessible over the open Internet without mandatory commercial subscription fees, paywalls, or closed member access controls. A free registration or sign-in that is open to anyone does not by itself make an application non-public. An application that displays advertising, solicits donations, sells goods or services, or is otherwise monetized is not a Public Web Application.
+
+* **"Internal / Commercial Application"** means any software deployed within a corporate intranet, internal network, private VPN, multi-tenant B2B SaaS platform, or behind paid customer login walls, and any software that generates revenue or serves commercial purposes, regardless of whether its source code is published under an open-source license.
+
+* **"Production Deployment"** means making an application built with the Software available to its intended users, internal or external, or using it in Licensee's operations. Development, test, and demonstration environments used only by Licensee's developers and testers are not Production Deployments.
+
+* **"Covered Versions"** means the versions of the Software released by Licensor during an active commercial subscription (Section 2.3) or during the Pilot Period (Section 2.2), as applicable.
+
+* **"Order Form"** means an ordering document, quotation, digital checkout confirmation, registration form, or invoice issued by Licensor or its authorized reseller specifying the purchased license tier, developer capacity, term, selected options, and applicable fees.
+
+* **"Pilot Period"** means a period of twelve (12) consecutive months starting from the date an official Pilot License Key or written authorization is issued by Licensor.
+
+### 2. LICENSING TIERS & GRANT OF RIGHTS
+
+#### 2.1 Community Edition
+
+* **Grant of License:** Subject to continuous compliance with this Agreement, Licensor grants Licensee a worldwide, non-exclusive, royalty-free, revocable license to access, integrate, and use the complete Software—comprising runtime packages and the unrestricted, fully functional **Gridify Designer** application with all editing modules—solely for the following permitted purposes:
+
+  1. Open-source software projects distributed under an OSI-approved license. This purpose covers the development and the public distribution of such projects. The deployment or use of an application, including an open-source one, by a company or other commercial organization for its internal operations or for commercial purposes is an Internal / Commercial Application and requires a commercial license. An open-source project that uses or includes the Software shall state that the Software is licensed under this Agreement and not under the project's own open-source license.
+
+  2. Non-commercial, educational, academic, and public institutional purposes (such as public libraries, museums, or state schools, including their internal systems and networks), and personal non-commercial projects.
+
+  3. Freely accessible, non-monetized Public Web Applications.
+
+  4. **Evaluation:** Any person or organization, including a team of developers at a company, may install the Software, try it out, build prototypes, and develop applications with it for an evaluation period of ninety (90) days per project, counted from the first use of the Software in that project. Evaluation never includes a Production Deployment. A commercial license under Section 2.2 or 2.3 is required at the end of the evaluation period or from the first Production Deployment of an Internal / Commercial Application, whichever comes first. Licensor may extend the evaluation period in writing. Upon registration, Licensor issues a free evaluation key valid for ninety (90) days, which suppresses the Community notice of the Software during the evaluation; without an evaluation key, or after it expires, the Software displays the Community notice in the browser console. An evaluation key does not authorize any Production Deployment.
+
+* **Unrestricted Tooling:** Under the Community Edition, Gridify Designer is provided with full feature availability, including layout arrangement, ribbon authoring, form design, and code generation routines, subject only to the operational scopes defined herein.
+
+* **Term & Revocation:** The Community Edition license remains effective only for as long as Licensee satisfies the qualifying criteria above. Licensor reserves the right to revoke or condition this license if the scope of use is breached or mischaracterized.
+
+* **Restrictions:** The Community Edition may **not** be deployed behind private corporate intranets, closed enterprise workstations, internal business portals, or within commercial revenue-generating SaaS systems without an active commercial license tier. This restriction does not apply to the internal systems of the public institutions under item 2 above.
+
+#### 2.2 Commercial Pilot License (1-Year Term)
+
+* **Grant of License:** Subject to registration and verification by Licensor, Licensor grants Licensee a worldwide, non-exclusive, fully functional commercial license for the number of Designated Developers stated in its pilot authorization (the Pilot License Key or the written authorization of Licensor) to integrate, use Gridify Designer, and deploy Gridify Studio in production environments for a fixed term of twelve (12) consecutive months ("Pilot Period").
+
+* **Selection:** Licensor selects the pilot participants at its sole discretion. It may limit the number of Designated Developers of a pilot license, or decline an application, without giving reasons.
+
+* **Fees:** $0 USD for the initial Pilot Period.
+
+* **Scope of Use:** Licensee is authorized to:
+
+  1. Use the complete Gridify Designer application (Layout, Ribbon, and Form editing modules) to design and generate production application code.
+
+  2. Integrate Gridify Studio into proprietary enterprise applications, internal corporate intranets, and VPN-restricted environments.
+
+  3. Deploy resulting applications into live commercial production.
+
+* **Pilot Commitments:** In consideration of the zero-cost commercial pilot authorization, Licensee agrees to:
+
+  1. Register using a verified organizational corporate domain.
+
+  2. Provide reasonable technical feedback, architectural compatibility notes, and bug reports during the Pilot Period.
+
+  3. **Marketing & Reference (Optional):** Where Licensee affirmatively opts in via the applicable Order Form, registration form checkbox, or written communication, Licensee grants Licensor the non-exclusive right to reference Licensee as an early adopter (including corporate logo display on Licensor's website and marketing assets, subject to Licensee's standard trademark guidelines). If Licensee does not opt in, or requests anonymity, Licensor shall treat Licensee's participation as confidential.
+
+* **Expiration & Continuity:** Upon expiration of the Pilot Period, the Covered Versions released during the Pilot Period remain licensed to Licensee perpetually: Licensee may continue to use them to develop, maintain, build, and deploy its applications, including in live commercial production, without time limit, and no remote deactivation or kill-switch applies. Versions released after the Pilot Period, updates to Gridify Designer, technical support, and access to private registry feeds require one of the commercial license tiers under Section 2.3.
+
+#### 2.3 Commercial Production License Tiers
+
+Subject to the timely payment of the applicable license subscription fees specified in the relevant Order Form, invoice, or current pricing schedule published on Licensor's official website (`gridify.dev`), Licensor grants Licensee a commercial, non-exclusive, non-transferable license to use the Software within internal and commercial production environments according to the designated capacity tier:
+
+* **Tier A — Single or Small Team License:**
+
+  Authorizes **one (1) to five (5)** Designated Developers within Licensee's organization to develop, build, and utilize the Software and Gridify Designer across Licensee's applications. Each Designated Developer seat may be reassigned to another developer within the same organization no more than once every thirty (30) days.
+
+* **Tier B — Large Team License:**
+
+  Authorizes **six (6) to nine (9)** Designated Developers within Licensee's organization to develop, build, and utilize the Software and Gridify Designer across Licensee's applications.
+
+* **Tier C — Corporate License:**
+
+  Authorizes **ten (10) to twenty-five (25)** Designated Developers within Licensee's organization to develop, build, and utilize the Software and Gridify Designer across Licensee's applications.
+
+* **Tier D — Enterprise Site License:**
+
+  Authorizes **twenty-six (26) or more (unlimited)** developers within the purchasing legal entity to utilize the Software and Gridify Designer. Covers unlimited internal systems, corporate intranets, private clouds, and commercial customer-facing web applications without per-seat tracking, administrative developer caps, or seat compliance audits. The fee of Tier D is agreed individually in the relevant Order Form.
+
+**Commercial Terms:** Commercial subscriptions renew on an annual basis unless cancelled or modified in accordance with the applicable Order Form.
+
+**Perpetual Use of Covered Versions:** Every version of the Software released while Licensee's subscription is active remains licensed to Licensee perpetually, also after the subscription ends: Licensee may continue to use such versions to develop, maintain, build, and deploy its applications without time limit, within the capacity of the tier it held. Versions released after the end of the subscription require an active subscription.
+
+**License Key:** For each commercial or pilot license, Licensor issues a license key that identifies the license and covers its Covered Versions. An evaluation key (Section 2.1, item 4) is valid until its stated last day only. Licensee shall use the key only in its own applications covered by the license, and shall not remove, alter, or circumvent the license key check of the Software or the notices it writes.
+
+### 3. SOURCE CODE ADD-ON & SOURCE CODE ESCROW
+
+1. **Eligibility & Grant:** The Source Code Add-On is available exclusively as an optional add-on for Licensees holding an active **Tier D (Enterprise Site License)**. Upon payment of the applicable fee specified in the relevant Order Form, Licensor grants Licensee a non-exclusive license to inspect, audit, debug, customize, and internally recompile the complete, unminified TypeScript, SCSS, and build source files of the runtime libraries, the Angular UI components, the editors, and Gridify Designer (the **"Source Code Package"**). The documentation, the interactive tutorials, and the sample applications are part of the Software in the form in which Licensor publishes them and are not part of the Source Code Package.
+
+2. **Internal Audit & Continuity:** The source code package is intended strictly for internal corporate compliance, independent security auditing, architectural continuity (escrow equivalence), and internal application tailoring.
+
+3. **Strict Anti-Distribution & Non-Compete:** Licensee shall NOT under any circumstances:
+
+   * Publicly distribute, disclose, publish, sublicense, assign, sell, or circulate the source code, in whole or in part, modified or unmodified.
+
+   * Use the source code to train machine learning models, or to design, market, or distribute any UI component library, docking engine, visual designer, or RAD toolkit that directly or indirectly competes with Gridify Studio or Gridify Designer.
+
+4. **Source Code Escrow (Tiers C and D):** Licensees holding an active **Tier C (Corporate License)** or **Tier D (Enterprise Site License)** may request, upon payment of the applicable fee specified in the relevant Order Form, that Licensor deposit the Source Code Package with an independent escrow agent under a separate escrow agreement between Licensor, Licensee, and the agent. Licensor updates the deposit at least with every major version released while Licensee's subscription is active. The deposited source code is released to Licensee only upon a release event defined in the escrow agreement, such as Licensor's insolvency or liquidation, or the discontinuation of the Software without a successor. Upon release, Licensee may use the source code solely to maintain, build, and deploy its own applications covered by its license, subject to items 2 and 3 of this Section.
+
+### 4. PRIVACY, TELEMETRY & SECURITY GUARANTEE
+
+* **No Kill-Switch:** Gridify Studio and Gridify Designer contain no logical time-bombs, expiring build locks, remote deactivation triggers, or administrative backdoors.
+
+* **Zero Telemetry / Air-Gapped Ready:** The Software does not transmit telemetry, tracking analytics, runtime usage statistics, or application metadata to Licensor's servers. It is fully qualified for closed, air-gapped corporate intranets and security-hardened environments.
+
+### 5. INTELLECTUAL PROPERTY & OWNERSHIP
+
+* **Ownership by Licensor:** Licensor retains all worldwide rights, titles, and interests (including copyrights, patents, trademarks, and trade secrets) in and to Gridify Studio, the Gridify Designer application, runtime engines, and documentation. Licensee acquires only the limited license rights expressly granted herein.
+
+* **Ownership by Licensee:** Licensee retains sole and exclusive ownership of any custom application logic, user data, visual designs, schemas, and source code generated by Licensee through the use of Gridify Designer.
+
+### 6. TECHNICAL SUPPORT & MAINTENANCE DISCLAIMER
+
+* **Best-Effort Support:** Technical support is provided on a commercially reasonable, best-effort basis primarily via asynchronous digital communication (email, support ticketing portal, or designated developer channels).
+
+* **No Fixed Response SLA:** Licensor does not warrant, promise, or contractually guarantee fixed response times (hourly or daily), around-the-clock availability, or uninterrupted support desk operations. Support operations observe standard business hours in the Czech Republic, excluding statutory public holidays and reasonable, scheduled leaves or business interruptions.
+
+* **No Resolution Guarantee:** Licensor agrees to investigate reproducible technical issues in good faith. However, Licensor makes no guarantee that every reported issue, defect, or platform discrepancy can or will be resolved, or that patches will be released within a defined timeframe. The provision of technical workarounds, configuration recommendations, architectural guidance, or documenting a planned update in a future release roadmap shall fully satisfy Licensor's support obligations.
+
+* **Exclusions:** Licensor is under no obligation to debug, refactor, or diagnose issues stemming from third-party libraries, host browser memory limitations, customer-side change detection conflicts, unhandled memory leaks in user code, or architectural misuse of the Software.
+
+### 7. DISCLAIMER OF WARRANTIES & LIMITATION OF LIABILITY
+
+* **Disclaimer:** EXCEPT AS EXPRESSLY SET FORTH IN A SEPARATE WRITTEN ENTERPRISE AGREEMENT OR ORDER FORM, THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED.
+
+* **Limitation of Liability:** IN NO EVENT SHALL LICENSOR BE LIABLE FOR ANY INDIRECT, SPECIAL, INCIDENTAL, PUNITIVE, OR CONSEQUENTIAL DAMAGES (INCLUDING LOSS OF PROFITS, LOSS OF DATA, OR BUSINESS INTERRUPTION) ARISING OUT OF OR IN CONNECTION WITH THIS AGREEMENT.
+
+* **Liability Cap:** LICENSOR’S AGGREGATE CUMULATIVE LIABILITY UNDER THIS AGREEMENT SHALL BE STRICTLY LIMITED BASED ON THE LICENSE TIER UTILIZED:
+
+  1. **For Paid Commercial Licenses (Tiers A, B, C, and D):** Licensor's total aggregate liability shall not exceed the actual license subscription fees paid by Licensee to Licensor for the Software during the twelve (12) months preceding the event giving rise to the claim.
+
+  2. **For Commercial Pilot Licenses:** Licensor's total aggregate liability arising out of or related to the Pilot Period shall not exceed an aggregate amount of **$100 USD**.
+
+  3. **For Community Edition:** To the maximum extent permitted by applicable law, Licensor's total financial liability under the Community Edition is **ZERO ($0.00 USD)**. Licensor shall have no financial liability, warranty obligations, or indemnification duties whatsoever toward any Licensee utilizing the free Community Edition.
+
+### 8. GOVERNING LAW & JURISDICTION
+
+This Agreement is governed by and construed in accordance with the laws of the Czech Republic and the European Union, without regard to conflict of law principles. The United Nations Convention on Contracts for the International Sale of Goods (CISG) shall not apply. Any disputes arising hereunder shall be submitted to the exclusive jurisdiction of the competent courts of the Czech Republic.

package/README.md

@@ -1,3 +1,119 @@
-# Temporary Holding Version
+# Gridify Studio – community edition
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+An Angular library for applications that look and work like desktop software: a **docking engine** (panels, tabs, floating windows, a layout that is saved and restored), a **ribbon**, a toolbar, a menu bar and context menus, a status bar, and more than 70 controls (a grid, a tree, inputs and pickers, dialogs and message boxes, a kanban board, a chat, a code editor and others). Everything follows one set of **themes**, a **density** of the controls and the **language** of the page (English, German and Japanese are built in).
+
+## Requirements
+
+- Angular 21 (21.2 or newer) or Angular 22 (`@angular/core`, `@angular/common`, `@angular/forms`, `@angular/router`) and `rxjs` 7.8, which come with every Angular application. No other libraries.
+- No `zone.js`: the library works in a zoneless application (the default of Angular), and in one with zone.js too.
+- Standalone components. The library is built on signals and `OnPush`; its API has no observables to subscribe to.
+
+## Installation
+
+```
+npm install @gridify/studio
+```
+
+When you received the package as a file, install the file instead:
+
+```
+npm install ./gridify-studio-<version>.tgz
+```
+
+## Setup
+
+**1. The global styles.** The themes, the density of the controls and the text styles are loaded once, in the global stylesheet of the application (`src/styles.scss`):
+
+```scss
+@use '@gridify/studio/styles';
+```
+
+**2. One import.** Everything is imported from `@gridify/studio`, there are no deep imports:
+
+```ts
+import {GfyAppHeader, GfyButton, GfyDockingEngine, GfyMenuBar, GfyMenu, GfyDockContainerNodeInput} from '@gridify/studio';
+```
+
+The themes, the icons and the dictionaries of the library register themselves when the package is loaded; nothing else has to be provided.
+
+## A small application
+
+```ts
+import {Component} from '@angular/core';
+import {GfyDockContainerNodeInput, GfyAppHeader, GfyDockingEngine, GfyMenu, GfyMenuBar} from '@gridify/studio';
+
+@Component({
+    selector: 'app-root',
+    imports: [GfyAppHeader, GfyMenuBar, GfyDockingEngine],
+    template: `
+        <gfy-app-header productName="My application" preferences="theme density language" />
+        <gfy-menu-bar [menus]="menus" [shortcuts]="true" />
+        <div style="height: calc(100vh - 80px)">
+            <gfy-docking-engine [defaultLayout]="layout" viewSources />
+        </div>
+    `,
+})
+export class App {
+    // A row: the files on the left, the documents on the right. A tab with a tag comes back to its place when it is opened again.
+    readonly layout: GfyDockContainerNodeInput = {
+        type: 'row',
+        size: 100,
+        children: [
+            {type: 'panel', role: 'tool', size: 3, activeTab: 0, collapsed: false, tabs: [{tag: 'files', role: 'tool', title: 'Files', content: '<p>The files.</p>'}]},
+            {type: 'panel', role: 'document', size: 7, activeTab: 0, collapsed: false, tabs: [{tag: 'welcome', role: 'document', title: 'Welcome', content: '<p>Welcome.</p>'}]},
+        ],
+    };
+
+    // The View and the Window menu of the engine (viewSources): the panels with a check mark, Restore layout, and the open documents.
+    readonly menus: GfyMenu[] = [
+        {id: 'view', label: '&View', items: [{source: 'gfy:tools'}, {separator: true}, {source: 'gfy:restore-layout'}]},
+        {id: 'window', label: '&Window', items: [{source: 'gfy:documents'}]},
+    ];
+}
+```
+
+- The engine fills its parent, so the parent needs a height.
+- A layout saved in `localStorage` is restored on the next visit. Saving is off by default: `inject(GfyEngineSettings).setAutoSaveLayout(true)` saves after every change, `engine.saveLayout()` saves once. A key of your own (`layoutStorageKey="my-app"`) keeps the layout apart from other applications on the same address; `[layoutStorageKey]="null"` neither loads nor saves.
+- The header lets the user choose the theme, the density and the language. From code: `inject(GfyTheme).setTheme(name)` (the names are in `themes`) and `inject(GfyI18n).setLanguage('de')`.
+
+## License
+
+The Community edition is free, with the entire library and Gridify Designer, for open-source and non-commercial projects, education, public institutions such as schools and libraries, and free public web applications without ads or donations. Any software that generates revenue, serves commercial purposes, shows ads or asks for donations, or runs inside a company (an intranet, a VPN, internal workstations, a paid login) needs a Commercial license, also when it is open source: https://www.gridify.dev. A team at a company may evaluate the library for 90 days per project.
+
+A Commercial or pilot license comes with a license key, and an evaluation key is free. Give the key to the application once, among the providers of `app.config.ts`:
+
+```ts
+import {ApplicationConfig} from '@angular/core';
+import {provideGridifyLicense} from '@gridify/studio';
+
+export const appConfig: ApplicationConfig = {
+    providers: [provideGridifyLicense('eyJ2IjoxLC…')],
+};
+```
+
+- The key is checked in the browser, offline, once after the page has loaded. Nothing is sent anywhere, and the check never stops, slows down or changes the application.
+- With a valid key the console of the browser stays clean. Without a key, or with a key that is not valid, the console says once that this is the Community edition.
+- To evaluate the library at a company, get a free evaluation key at https://www.gridify.dev. It keeps the console clean for 90 days; without it, or after its last day, the console shows the line of the Community edition, and nothing stops working.
+- A key covers the versions of the library released until the last day of the updates of its license. A version released later says so in the console and works as before: keep using a version released by that day, or renew the license.
+- White space in the key does not matter (a key copied from a mail may be broken into lines).
+- The key holds the terms of the license and the name of the licensee. The library never writes them to the console.
+
+The terms of use are the Gridify Studio Software License Agreement, the file `LICENSE` of this package.
+
+## Help in the editor
+
+Every component, input, output, model and service is documented in the declarations of the package (`types/`): the editor shows the description, the allowed values and the defaults while you type.
+
+`REFERENCE.md` of the package is the reference of all the components in one file: every component, directive and shared part with its inputs, two-way models, outputs, methods, properties, places for content and CSS variables, their types, defaults and descriptions. A default that comes from `GfyControlDefaults` says so: change it for the whole application with `provideGfyControlDefaults`.
+
+## What the package holds
+
+| Folder         | Content                                                                                                         |
+| -------------- | --------------------------------------------------------------------------------------------------------------- |
+| `fesm2022/`    | The library, compiled for the Angular linker (the Angular CLI finishes the compilation when it builds your app) |
+| `types/`       | The declarations, with their documentation                                                                      |
+| `styles/`      | The entry of the global styles (`@use '@gridify/studio/styles'`)                                                |
+| `gfy-common/`  | The stylesheets of the themes, the density, the typography and the colors of code                               |
+| `REFERENCE.md` | The reference of all the components (generated from the sources)                                                |
+
+The community edition contains no source code of the library.