stockchart-treemap 1.0.0 → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 stockchart-treemap contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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 NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,90 +1,89 @@
-# stockchart-treemap
-
-Готовый к публикации на npm пакет с самостоятельным TreeMap-компонентом для Angular.
-Компонент работает как standalone, поддерживает подсветку по `TreeMapColorScale`,
-источники данных в виде массива, Observable или лоадера, а также кастомные шаблоны плиток и заголовков.
-
-## Сборка и публикация
-1. Соберите библиотеку:
-   ```bash
-   npm run ng -- build stockchart-treemap
-   ```
-2. Перейдите в папку сборки и опубликуйте пакет (убедитесь, что вошли в npm):
-   ```bash
-   cd dist/stockchart-treemap
-   npm publish --access public
-   ```
-
-## Сборка примерных компонентов для отладки
-Для локального тестирования и пошаговой отладки демо-компонентов соберите отдельный пакет `stockchart-treemap-examples`:
-```bash
-npm run build:stockchart-treemap-examples
-```
-Сборка использует tsconfig для примеров и кладёт артефакты в `dist/stockchart-treemap-examples`, чтобы их можно было подключить в песочнице или во внешнем приложении без вмешательства в основной пакет.
-
-Для живого просмотра примеров запустите дев-сервер с подходящей конфигурацией:
-```bash
-# карта рынка на стандартном порту 4200
-ng serve stockchart-treemap-examples
-
-# вариант с собственными цветами на порту 4200
-ng serve stockchart-treemap-examples --configuration self-colored
-```
-
-## Подключение
-```ts
-import { bootstrapApplication } from '@angular/platform-browser';
-import { AppComponent } from './app/app.component';
-import { TreeMapComponent } from 'stockchart-treemap';
-
-bootstrapApplication(AppComponent, {
-  providers: [
-    // TreeMapComponent подключается как standalone в импортах компонентов
-  ]
-});
-```
-
-В компоненте-доме добавьте `TreeMapComponent` или готовые демо-обёртки в секцию `imports` и используйте селектор
-`<stockchart-treemap>` прямо в шаблоне.
-
-## Пример «app-stockchart-treemap» с сгенерированными данными
-```ts
-import { AppStockchartTreemapExampleComponent, createMockMarketMap } from 'stockchart-treemap';
-
-@Component({
-  standalone: true,
-  imports: [AppStockchartTreemapExampleComponent]
-})
-export class DemoHost {}
-```
-
-Компонент сам генерирует дерево с секторами и тикерами, выставляет `colorValueField: 'change'` и
-использует `TreeMapColorScale` для плавной подсветки приростов и падений.
-
-## Базовое использование с авторасчётом цветов
-```html
-<stockchart-treemap
-  [data]="data"
-  [options]="{ textField: 'name', valueField: 'value', colorValueField: 'change', colorScale: performanceColorScale }">
-</stockchart-treemap>
-```
-```ts
-import { performanceColorScale, createPerformanceTreemap } from 'stockchart-treemap';
-
-@Component({
-  standalone: true,
-  imports: [TreeMapComponent]
-})
-export class SimpleDemo {
-  data = createPerformanceTreemap();
-  options = {
-    textField: 'name',
-    valueField: 'value',
-    colorValueField: 'change',
-    colorScale: performanceColorScale,
-    colors: []
-  };
-}
-```
-
-Плитки не содержат поля `color`, поэтому библиотека самостоятельно рассчитывает оттенки на основе значений из `change`.
+# stockchart-treemap
+
+Standalone TreeMap component for Angular, ready to publish to npm. This is an independent port of the Kendo TreeMap functionality implemented on fully independent code (no Kendo UI runtime dependencies). The component is standalone, supports highlighting via `TreeMapColorScale`, accepts array/Observable/loader data sources, and lets you supply custom tile and header templates.
+
+## Live demo
+- Updated StackBlitz example: https://stackblitz.com/edit/stackblitz-starters-drgync8z?file=README.md
+
+## Build and publish
+1. Build the library:
+   ```bash
+   npm run ng -- build stockchart-treemap
+   ```
+2. Publish from the build output (make sure you are authenticated in npm):
+   ```bash
+   cd dist/stockchart-treemap
+   npm publish --access public
+   ```
+
+## Build example components for debugging
+For local testing and step-by-step debugging of the demo components, build the separate `stockchart-treemap-examples` package:
+```bash
+npm run build:stockchart-treemap-examples
+```
+The build uses the examples tsconfig and places artifacts in `dist/stockchart-treemap-examples` so they can be consumed in a sandbox or external app without touching the main package.
+
+To view the examples live, run the dev server with the desired configuration:
+```bash
+# market map on the default 4200 port
+ng serve stockchart-treemap-examples
+
+# variant with custom colors on port 4200
+ng serve stockchart-treemap-examples --configuration self-colored
+```
+
+## Bootstrapping
+```ts
+import { bootstrapApplication } from '@angular/platform-browser';
+import { AppComponent } from './app/app.component';
+import { TreeMapComponent } from 'stockchart-treemap';
+
+bootstrapApplication(AppComponent, {
+  providers: [
+    // TreeMapComponent is added as a standalone import on the components that use it
+  ]
+});
+```
+
+Add `TreeMapComponent` or the ready-made demo wrappers to the `imports` of the host component and use the `<stockchart-treemap>` selector directly in the template.
+
+## Example `<app-stockchart-treemap>` with generated data
+```ts
+import { AppStockchartTreemapExampleComponent, createMockMarketMap } from 'stockchart-treemap';
+
+@Component({
+  standalone: true,
+  imports: [AppStockchartTreemapExampleComponent]
+})
+export class DemoHost {}
+```
+
+The example component generates a tree with sectors and tickers, sets `colorValueField: 'change'`, and applies `TreeMapColorScale` for smooth gain/loss highlighting.
+
+## Basic usage with automatic colors
+```html
+<stockchart-treemap
+  [data]="data"
+  [options]="{ textField: 'name', valueField: 'value', colorValueField: 'change', colorScale: performanceColorScale }">
+</stockchart-treemap>
+```
+```ts
+import { performanceColorScale, createPerformanceTreemap } from 'stockchart-treemap';
+
+@Component({
+  standalone: true,
+  imports: [TreeMapComponent]
+})
+export class SimpleDemo {
+  data = createPerformanceTreemap();
+  options = {
+    textField: 'name',
+    valueField: 'value',
+    colorValueField: 'change',
+    colorScale: performanceColorScale,
+    colors: []
+  };
+}
+```
+
+Tiles omit the `color` field, so the library computes shades automatically from `change`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stockchart-treemap",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Standalone Angular treemap component with StockChart-themed demos and mock data generators.",
   "keywords": [
     "angular",