@bryntum/gantt-angular-thin 7.1.1 → 7.1.2

package/README.md

@@ -1,37 +1,323 @@
-# Angular Ivy wrapper for Bryntum Gantt
+<div style="display: flex; justify-content: space-between; align-items: center; margin: 0 50px;">
+    <a href="https://bryntum.com/" rel="noopener" target="_blank">
+        <img width="350" src="https://bryntum.com/resources/bryntum_logo_blue.svg" alt="Bryntum logo">
+    </a>
+    <img src="https://bryntum.com/products/grid/docs/data/Core/images/logo/angular.svg" alt="Angular" width="100">
+</div>
 
-This package contains a wrapper that encapsulates Bryntum Gantt and turns it into an Angular component, exposing
-configuration options, properties, features, and events. Compiled for the Angular Ivy engine.
+# Angular wrapper for Bryntum Gantt Thin packages
+
+This package provides a wrapper that turns Bryntum Gantt into an Angular component, exposing configuration options,
+properties, features, and events.
+
+> **Thin Package:** This is a thin wrapper package designed for applications that use multiple Bryntum products.
+> Thin packages exclude bundled dependencies to avoid duplication. For details, see
+> [Angular Multiple Products](https://bryntum.com/products/gantt/docs/guide/Gantt/integration/angular/multiple-products).
+
+## Version Requirement
+
+Wrapper is compiled for the **Angular Ivy** rendering engine (Angular 12+).
+
+* Angular: `12` with Ivy support or higher
+* TypeScript: `4.2` or higher
+* Vite `5` or higher (starting with Angular `17`)
+
+## Package Contents
+
+| Path   | Description                      |
+|--------|----------------------------------|
+| `lib/` | Component type definitions       |
+| `src/` | Original TypeScript source files |
 
 ## Installation
 
-The installation is performed by issuing the installation command in the root of the application folder.
-The specific command depends on the package manager used by the application.
+### Angular Wrapper
+
+```bash
+npm install @bryntum/gantt-angular-thin@latest
+```
+
+### Component Package (Required)
+
+```bash
+npm install @bryntum/gantt-thin@latest
+```
+
+## Try Bryntum Online Demos
+
+* [View Online Angular Demos](https://bryntum.com/products/gantt/examples/?framework=angular)
+
+## Quick Start
+
+Edit the `src/app/app-module.ts` file and add the following import:
+
+```typescript
+import { NgModule } from '@angular/core';
+import { BrowserModule } from '@angular/platform-browser';
+
+import { BryntumCoreModule } from '@bryntum/core-angular-thin';
+import { BryntumGridModule } from '@bryntum/grid-angular-thin';
+import { BryntumSchedulerModule } from '@bryntum/scheduler-angular-thin';
+import { BryntumSchedulerProModule } from '@bryntum/schedulerpro-angular-thin';
+import { BryntumGanttModule } from '@bryntum/gantt-angular-thin';
+
+import { AppComponent } from './app';
+
+@NgModule({
+    declarations : [
+        AppComponent
+    ],
+    imports      : [
+        BrowserModule,
+        BryntumCoreModule,
+        BryntumGridModule,
+        BryntumSchedulerModule,
+        BryntumSchedulerProModule,
+        BryntumGanttModule
+    ],
+    providers    : [],
+    bootstrap    : [AppComponent]
+})
+export class AppModule {}
+```
+
+Create `src/app/app.config.ts` file with the following content:
+
+```typescript
+import { BryntumGanttProps, BryntumGanttProjectModelProps } from '@bryntum/gantt-angular-thin';
+
+export const projectProps: BryntumGanttProjectModelProps = {
+    // Automatically introduces a `startnoearlier` constraint for tasks that (a) have no predecessors,
+    // (b) do not use constraints and (c) aren't `manuallyScheduled`
+    autoSetConstraints : true,
+    loadUrl            : 'data/data.json',
+    autoLoad           : true
+};
+export const ganttProps: BryntumGanttProps = {
+    columns : [
+        { type : 'name', width : 200 }
+    ],
+    startDate : new Date(2026, 0, 1),
+    endDate   : new Date(2026, 2, 1)
+};
+```
+
+Update the `src/app/app.ts` file with the following content:
+
+```typescript
+import { Component, ViewChild } from '@angular/core';
+import { BryntumGanttComponent, BryntumGanttProjectModelComponent } from '@bryntum/gantt-angular-thin';
+import { ganttProps, projectProps } from './app.config';
+
+@Component({
+    selector    : 'app-root',
+    standalone  : false,
+    templateUrl : './app.html',
+    styleUrl    : './app.css',
+})
+export class AppComponent {
+
+    ganttProps = ganttProps;
+    projectProps = projectProps;
+
+    @ViewChild('gantt') ganttComponent!: BryntumGanttComponent;
+    @ViewChild('project') projectComponent!: BryntumGanttProjectModelComponent;
+}
+```
+
+Edit the `src/app/app.html` file and replace the content with the following:
 
-The following are most frequently used:
+```html
+<bryntum-gantt-project-model
+    #project
+    [loadUrl] = "projectProps.loadUrl!"
+    [autoLoad] = "projectProps.autoLoad!"
+    [autoSetConstraints] = "projectProps.autoSetConstraints!"
+></bryntum-gantt-project-model>
 
-Install using `npm`:
+<bryntum-gantt
+    #gantt
+    [startDate] = "ganttProps.startDate!"
+    [columns] = "ganttProps.columns!"
+    [endDate] = "ganttProps.endDate!"
+    [project] = "project"
+></bryntum-gantt>
+```
+
+<details>
+<summary>Create sample data (click to expand)</summary>
+
+Create a `public/data/data.json` file for example data and add the following JSON data to it:
+```javascript
+{
+  "success": "true",
+  "tasks": {
+    "rows": [
+      {
+        "id": 1,
+        "name": "Documentation Project",
+        "expanded": true,
+        "children": [
+          {
+            "id": 2,
+            "name": "Preparation",
+            "expanded": true,
+            "children": [
+              { "id": 6, "name": "Proof-read docs", "startDate": "2026-01-02", "endDate": "2026-01-09" },
+              { "id": 3, "name": "Release docs",    "startDate": "2026-01-09", "endDate": "2026-01-10" }
+            ]
+          },
+          {
+            "id": 4,
+            "name": "Development",
+            "expanded": true,
+            "children": [
+              { "id": 7, "name": "Write API docs",  "startDate": "2026-01-05", "endDate": "2026-01-12" },
+              { "id": 8, "name": "Write tutorials", "startDate": "2026-01-10", "endDate": "2026-01-16" },
+              { "id": 9, "name": "Create examples", "startDate": "2026-01-12", "endDate": "2026-01-18" }
+            ]
+          },
+          {
+            "id": 5,
+            "name": "Review & Release",
+            "expanded": true,
+            "children": [
+              { "id": 10, "name": "Team review",     "startDate": "2026-01-18", "endDate": "2026-01-20" },
+              { "id": 11, "name": "Final approval",  "startDate": "2026-01-20", "endDate": "2026-01-21" },
+              { "id": 12, "name": "Public release",  "startDate": "2026-01-22", "endDate": "2026-01-22" }
+            ]
+          }
+        ]
+      }
+    ]
+  },
+  "dependencies": {
+    "rows": [
+      { "fromTask": 6,  "toTask": 3  },
+      { "fromTask": 7,  "toTask": 8  },
+      { "fromTask": 8,  "toTask": 9  },
+      { "fromTask": 9,  "toTask": 10 },
+      { "fromTask": 10, "toTask": 11 },
+      { "fromTask": 11, "toTask": 12 }
+    ]
+  }
+}
+```
+
+This is the data the Bryntum Gantt will use.
+
+</details>
+
+## Project Structure
+
+### Product Dependencies
+
+API packages:
+
+```json
+{
+  "dependencies": {
+    "@bryntum/core-thin": "7.1.2",
+    "@bryntum/engine-thin": "7.1.2",
+    "@bryntum/grid-thin": "7.1.2",
+    "@bryntum/scheduler-thin": "7.1.2",
+    "@bryntum/schedulerpro-thin": "7.1.2",
+    "@bryntum/gantt-thin": "7.1.2"
+  }
+}
+```
+
+Framework wrapper packages:
+
+```json
+{
+  "dependencies": {
+    "@bryntum/core-angular-thin": "7.1.2",
+    "@bryntum/gantt-angular-thin": "7.1.2"
+  }
+}
+```
+
+### Product Configuration
+
+```typescript
+import { BryntumGanttProps } from '@bryntum/gantt-angular-thin';
 
-```shell
-npm install @bryntum/gantt-angular@7.1.1
+const ganttProps : BryntumGanttProps = {
+    // Gantt configuration
+};
 ```
 
-Install using `yarn`:
+### Product Styling
 
-```shell
-yarn add @bryntum/gantt-angular@7.1.1
+**SCSS/CSS:**
+
+```css
+/* FontAwesome is used for icons */
+@import '@bryntum/core-thin/fontawesome/css/fontawesome.css';
+@import "@bryntum/core-thin/fontawesome/css/solid.css";
+/* Structural CSS */
+@import '@bryntum/core-thin/core.css';
+@import '@bryntum/grid-thin/grid.css';
+@import '@bryntum/scheduler-thin/scheduler.css';
+@import '@bryntum/schedulerpro-thin/schedulerpro.css';
+@import '@bryntum/gantt-thin/gantt.css';
+/* Theme */
+@import '@bryntum/core-thin/material3-light.css';
+```
+
+### Product Localization
+
+```javascript
+import '@bryntum/gantt-thin/lib/localization/De.js'
 ```
 
-## Integration guide
+## Integration Guide
 
 For details on installing and using this package, see the
 [Angular Integration Guide](https://bryntum.com/products/gantt/docs/guide/Gantt/integration/angular/guide).
 
-# Online references
+## Wrappers
+
+Angular wrappers encapsulate Bryntum components as native Angular components, exposing all configuration options,
+properties, features, and events through Angular-familiar patterns like inputs, outputs, and templates.
+
+Visit [Wrappers documentation](https://bryntum.com/products/gantt/docs/guide/Gantt/integration/angular/guide#wrappers) for the complete list of available
+wrapper components.
+
+## Features
+
+Features are optional modules that extend Bryntum Gantt functionality. Each feature is suffixed with `Feature` and
+can be enabled and configured through standard Angular inputs.
+
+Visit [Features documentation](https://bryntum.com/products/gantt/docs/guide/Gantt/integration/angular/guide#features) for the complete list of available
+features and their configuration options.
+
+## Explore All Bryntum Products
+
+* [Bryntum Grid](https://bryntum.com/products/grid/) - High-performance data grid
+* [Bryntum Scheduler](https://bryntum.com/products/scheduler/) - Resource scheduling component
+* [Bryntum Scheduler Pro](https://bryntum.com/products/schedulerpro/) - Advanced scheduling with dependencies
+* [Bryntum Gantt](https://bryntum.com/products/gantt/) - Project planning and management
+* [Bryntum Calendar](https://bryntum.com/products/calendar/) - Full-featured calendar component
+* [Bryntum TaskBoard](https://bryntum.com/products/taskboard/) - Kanban-style task management
+
+Explore our comprehensive collection of demos:
+
+| Product           |   <img src="https://bryntum.com/products/grid/docs/data/Core/images/logo/js.svg" alt="JavaScript" width="30"><br>JavaScript    |  <img src="https://bryntum.com/products/grid/docs/data/Core/images/logo/react.svg" alt="React" width="30"><br>React  |   <img src="https://bryntum.com/products/grid/docs/data/Core/images/logo/vue.svg" alt="Vue" width="30"><br>Vue   | <img src="https://bryntum.com/products/grid/docs/data/Core/images/logo/angular.svg" alt="Angular" width="30"><br>Angular |
+|-------------------|:------------------------------------------------------------------------------------:|:--------------------------------------------------------------------------:|:----------------------------------------------------------------------:|:------------------------------------------------------------------------------:|
+| **Grid**          |         [Grid JavaScript demos](https://bryntum.com/products/grid/examples/?framework=javascript)          |         [Grid React demos](https://bryntum.com/products/grid/examples/?framework=react)          |         [Grid Vue demos](https://bryntum.com/products/grid/examples/?framework=vue)          |         [Grid Angular demos](https://bryntum.com/products/grid/examples/?framework=angular)          |
+| **Scheduler**     |    [Scheduler JavaScript demos](https://bryntum.com/products/scheduler/examples/?framework=javascript)     |    [Scheduler React demos](https://bryntum.com/products/scheduler/examples/?framework=react)     |    [Scheduler Vue demos](https://bryntum.com/products/scheduler/examples/?framework=vue)     |    [Scheduler Angular demos](https://bryntum.com/products/scheduler/examples/?framework=angular)     |
+| **Scheduler Pro** | [Scheduler Pro JavaScript demos](https://bryntum.com/products/schedulerpro/examples/?framework=javascript) | [Scheduler Pro React demos](https://bryntum.com/products/schedulerpro/examples/?framework=react) | [Scheduler Pro Vue demos](https://bryntum.com/products/schedulerpro/examples/?framework=vue) | [Scheduler Pro Angular demos](https://bryntum.com/products/schedulerpro/examples/?framework=angular) |
+| **Gantt**         |        [Gantt JavaScript demos](https://bryntum.com/products/gantt/examples/?framework=javascript)         |        [Gantt React demos](https://bryntum.com/products/gantt/examples/?framework=react)         |        [Gantt Vue demos](https://bryntum.com/products/gantt/examples/?framework=vue)         |        [Gantt Angular demos](https://bryntum.com/products/gantt/examples/?framework=angular)         |
+| **Calendar**      |     [Calendar JavaScript demos](https://bryntum.com/products/calendar/examples/?framework=javascript)      |     [Calendar React demos](https://bryntum.com/products/calendar/examples/?framework=react)      |     [Calendar Vue demos](https://bryntum.com/products/calendar/examples/?framework=vue)      |     [Calendar Angular demos](https://bryntum.com/products/calendar/examples/?framework=angular)      |
+| **TaskBoard**     |    [TaskBoard JavaScript demos](https://bryntum.com/products/taskboard/examples/?framework=javascript)     |    [TaskBoard React demos](https://bryntum.com/products/taskboard/examples/?framework=react)     |    [TaskBoard Vue demos](https://bryntum.com/products/taskboard/examples/?framework=vue)     |    [TaskBoard Angular demos](https://bryntum.com/products/taskboard/examples/?framework=angular)     |
+
+## Online references
 
-* [Bryntum npm repository guide](https://bryntum.com/products/gantt/docs/guide/Gantt/npm-repository)
 * [Bryntum Gantt documentation](https://bryntum.com/products/gantt/docs/)
 * [Bryntum Gantt examples](https://bryntum.com/products/gantt/examples/)
+
 * [Bryntum Support Forum](https://forum.bryntum.com/)
 * [Contact us](https://bryntum.com/contact/)
 
@@ -42,3 +328,4 @@ Please visit the [Bryntum Gantt End User License](https://bryntum.com/products/g
 
 Copyright © 2009-2026, Bryntum
 All rights reserved.
+