cesium-heatbox 1.2.1 → 1.3.4

package/CHANGELOG.md

@@ -41,6 +41,59 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.3.4] - 2026-04-07
+
+### Fixed
+- temporal examples で初回表示やカメラ移動後に voxel が空のまま残る問題を修正しました。
+- `TimeController` がカメラ変更時に現在の time slice を再描画するようにし、`RenderPlanner` のカリング後でも表示が回復するようにしました。
+- `examples/temporal/temporal-data.js` の CZML パス解決をページ URL 非依存に修正し、examples 配下での読み込み失敗を防止しました。
+- `TimeSlicer` は lazy-loaded entry を統合した際に global stats cache を破棄するようになりました。
+- `Heatbox.updateValues()` の bounds 再利用判定を保守的に見直し、既存グリッドを不正に再利用しないようにしました。
+- `examples/temporal/advanced-temporal.html` は初期スライス描画、ポイントプレビュー、全高レイアウトを追加し、ロード直後から表示状態を確認しやすくしました。
+
+## [1.3.3] - 2026-04-06
+
+### Added
+- `examples/temporal/advanced-temporal.html` を追加し、`temporal.interpolate` / `temporal.dataSource` / `temporal.useWorker` を単一画面で確認できるようにしました。
+
+### Changed
+- `package.json`、`package-lock.json`、`src/index.js` の版番号を `1.3.3` に更新しました。
+- `examples/README.md`、`examples/temporal/README.md`、`docs/API.md` を現行の時系列機能セットに合わせて更新しました。
+- `README.md` と `README.ja.md` の temporal セクションに `useWorker` と時系列デモ構成の説明を追記しました。
+
+## [1.3.2] - 2026-04-06
+
+### Added
+- `temporal.interpolate` を実装し、スライス間ギャップの数値プロパティ補間を追加しました。
+- `temporal.dataSource` を実装し、遅延ロードで時系列スライスを供給できるようにしました。
+- `temporal.useWorker` を実装し、補間と時系列統計の前処理を worker へオフロードできるようにしました。
+
+### Changed
+- `TimeController` と `TimeSlicer` を非同期時系列経路に対応させ、worker 非対応環境ではメインスレッドへフォールバックするよう整理しました。
+- README / MIGRATION / ROADMAP / API docs を `v1.3.2` の temporal 拡張内容に合わせて更新しました。
+
+## [1.3.1] - 2026-04-06
+
+### Added
+- `Heatbox.updateValues(entities, runtimeOptions?)` を追加し、既存 bounds/grid を再利用できる更新を軽量化しました。
+
+### Changed
+- `TimeController` は `updateValues()` を優先利用し、時系列更新時の再構築コストを削減するようになりました。
+
+## [1.3.0] - 2026-04-06
+
+### Added
+- `RenderPlanner` を追加し、描画優先度制御、簡易LoD、ビューポートカリングを分離。
+- CI に `cesium@^1.120.0` / `cesium@latest` の dual smoke test を追加。
+
+### Changed
+- `DataProcessor` の voxel record から `entities` 配列保持を削除し、compact な内部表現へ変更。
+- `GeometryRenderer` を差分更新型に変更し、ボクセルキー単位の add/update/remove を実装。
+- 互換性ポリシーを整理し、minimum supported Cesium を `^1.120.0` と明記。
+
+### Fixed
+- レンダ/クリア反復時の不要なエンティティ再生成を抑制し、ヒープ増分の回帰を起こしにくい構成へ修正。
+
 ## [1.1.0] - 2025-11-19
 
 ### Changed

package/README.ja.md

@@ -51,6 +51,12 @@ npm install
 npm run build
 ```
 
+## 互換性
+
+- minimum supported Cesium: `^1.120.0`
+- latest verified Cesium: CI の互換 smoke test を最後に通過した最新版
+- CI では `cesium@^1.120.0` と `cesium@latest` の両方を検証
+
 ## クイックスタート
 
 ```javascript
@@ -128,13 +134,18 @@ const heatbox = new Heatbox(viewer, {
     ],
     classificationScope: 'global',  // または 'per-time'
     updateInterval: 1000,           // ミリ秒スロットル
-    outOfRangeBehavior: 'clear'     // または 'hold'
+    outOfRangeBehavior: 'clear',    // または 'hold'
+    interpolate: true               // スライス間ギャップの数値を補間
   }
 });
 ```
 
 - オーバーラップ解決: `prefer-earlier`、`prefer-later`、`skip`
 - 二分探索+キャッシュによる効率的な時間検索
+- `updateValues()` は既存グリッドに収まる更新を軽量経路で処理
+- `dataSource(currentTime, context)` で lazy loading を追加可能
+- `useWorker: true` で補間と時系列統計の前処理を worker に逃がせます
+- デモは baseline 再生、Global/Per-Time 比較、シナリオ切替、補間/lazy loading の拡張フローまで含みます
 - デモ: `examples/temporal/`
 
 詳細は[APIリファレンス — 時系列](docs/API.md)を参照してください。
@@ -266,6 +277,7 @@ aggregation: {
 | `new Heatbox(viewer, options)` | インスタンス作成 |
 | `createFromEntities(entities)` | ヒートマップ作成（非同期、統計情報を返却） |
 | `setData(entities)` | データ設定と描画 |
+| `updateValues(entities, runtimeOptions?)` | 既存グリッドを再利用できる場合の軽量更新 |
 | `updateOptions(newOptions)` | オプション更新と再描画 |
 | `setVisible(show)` | 表示/非表示切り替え |
 | `clear()` | ヒートマップをクリア |

package/README.md

@@ -51,6 +51,12 @@ npm install
 npm run build
 ```
 
+## Compatibility
+
+- Minimum supported Cesium: `^1.120.0`
+- Latest verified Cesium: latest version that passes the CI compatibility smoke job
+- CI validates both `cesium@^1.120.0` and `cesium@latest`
+
 ## Quick Start
 
 ```javascript
@@ -128,13 +134,18 @@ const heatbox = new Heatbox(viewer, {
     ],
     classificationScope: 'global',  // or 'per-time'
     updateInterval: 1000,           // ms throttle
-    outOfRangeBehavior: 'clear'     // or 'hold'
+    outOfRangeBehavior: 'clear',    // or 'hold'
+    interpolate: true               // interpolate numeric properties across gaps
   }
 });
 ```
 
 - Overlap resolution: `prefer-earlier`, `prefer-later`, or `skip`
 - Binary search + cache for efficient temporal lookup
+- `updateValues()` reuses the current grid when temporal slices stay within the existing bounds
+- `dataSource(currentTime, context)` can lazily provide additional temporal slices
+- `useWorker: true` offloads interpolation and temporal stats preprocessing when workers are available
+- Demos cover baseline playback, global/per-time comparison, scenario simulation, and advanced interpolation/lazy-loading flows
 - Demos: `examples/temporal/`
 
 See [API Reference — Temporal](docs/API.md) for full details.
@@ -266,6 +277,7 @@ See [Aggregation Examples](examples/aggregation/) for details.
 | `new Heatbox(viewer, options)` | Create a new instance |
 | `createFromEntities(entities)` | Create heatmap (async, returns statistics) |
 | `setData(entities)` | Set data and render |
+| `updateValues(entities, runtimeOptions?)` | Update data while reusing the current grid when possible |
 | `updateOptions(newOptions)` | Update options and re-render |
 | `setVisible(show)` | Toggle visibility |
 | `clear()` | Clear heatmap |