floor-editor-ts 1.3.7 → 1.3.8

package/dist/src/lib/packageDefaults.d.ts

@@ -1,4 +1,6 @@
 import { Floor, Project } from '../../lib/models/types';
+import { HeatmapColorScale } from '../../lib/utils/heatmapColorScale';
+export type { HeatmapColorLevel, HeatmapColorScale, } from '../../lib/utils/heatmapColorScale';
 /** Camera from host app — used to assign floor camera furniture via select. */
 export interface SiteCameraOption {
     serial: string;
@@ -24,6 +26,11 @@ export interface FloorEditorConfig {
     floorMaxHeight: number;
     heatmapEnabled: boolean;
     heatmapMatrix: number[][];
+    /**
+     * Floor heatmap color scale from host.
+     * `gradient` (default) or `levels` with host-defined N bands — see docs/heatmap-host-standard.md §8.
+     */
+    heatmapColorScale?: HeatmapColorScale;
     projectName?: string;
     selectedCameraSerial?: string | null;
     showCameraCones?: boolean;

package/dist/src/lib/utils/canvasRenderer.d.ts

@@ -1,6 +1,7 @@
 import { Point, Wall, Door, Window as Win, FurnitureItem, Stair, Column, Floor, Annotation, Room } from '../../../lib/models/types';
 import { CanvasState } from '../../../lib/utils/canvasInteraction';
 import { ProjectSettings } from '../../../lib/stores/settings';
+import { HeatmapColorScale } from '../../../lib/utils/heatmapColorScale';
 export declare function wallLength(w: Wall): number;
 export declare function wallPointAt(w: Wall, t: number): Point;
 export declare function wallTangentAt(w: Wall, t: number): Point;
@@ -49,4 +50,4 @@ export declare function drawMinimap(cs: CanvasState, minimapCanvas: HTMLCanvasEl
     maxX: number;
     maxY: number;
 } | null): void;
-export declare function drawFloorHeatmap(cs: CanvasState, floor: Floor, heatmapMatrix: number[][], detectedRooms: Room[]): void;
+export declare function drawFloorHeatmap(cs: CanvasState, floor: Floor, heatmapMatrix: number[][], detectedRooms: Room[], colorScale?: HeatmapColorScale | null): void;

package/dist/src/lib/utils/heatmapColorScale.d.ts

@@ -0,0 +1,39 @@
+/** Host-defined discrete heatmap band. */
+export interface HeatmapColorLevel {
+    /** Inclusive lower bound for this band (see resolve rules). */
+    min: number;
+    /** Optional inclusive upper bound; if every level has max, use closed ranges. */
+    max?: number;
+    /** CSS color (hex / rgb / rgba). */
+    color: string;
+    /** Legend label — metadata for host; unused when drawing. */
+    label?: string;
+}
+/**
+ * Floor heatmap color scale from host config.
+ * - `gradient`: value / max(matrix) → built-in continuous palette
+ * - `levels`: absolute thresholds + host colors (N bands, host-defined)
+ */
+export interface HeatmapColorScale {
+    mode: "gradient" | "levels";
+    levels?: HeatmapColorLevel[];
+    /** Cells with value <= hideBelow are not drawn. Default 0. */
+    hideBelow?: number;
+}
+export declare function normalizeHeatmapColorScale(value: unknown): HeatmapColorScale | undefined;
+/** Fingerprint for heatmap offscreen cache invalidation. */
+export declare function getHeatmapColorScaleKey(scale: HeatmapColorScale | null | undefined): string;
+export declare function colorWithAlpha(color: string, alpha: number): string;
+/**
+ * Resolve discrete band color for a cell value.
+ * @returns null → do not draw
+ */
+export declare function resolveHeatmapLevelColor(value: number, scale: HeatmapColorScale): {
+    color: string;
+    levelIndex: number;
+    levelCount: number;
+} | null;
+export declare function isLevelsColorScale(scale: HeatmapColorScale | null | undefined): scale is HeatmapColorScale & {
+    mode: "levels";
+    levels: HeatmapColorLevel[];
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "floor-editor-ts",
   "private": false,
-  "version": "1.3.7",
+  "version": "1.3.8",
   "type": "module",
   "main": "./dist/floor-editor.es.js",
   "module": "./dist/floor-editor.es.js",