floor-editor-ts 1.3.6 → 1.3.8

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

@@ -1,4 +1,6 @@
-import { Project } from '../../lib/models/types';
+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;
@@ -16,12 +18,19 @@ export type AssignedCamera = {
 /** Flatten host camera object into string props for furniture + UI. */
 export declare function assignedCameraToProps(cam: AssignedCamera): Record<string, string>;
 export declare function formatCameraPropLabel(key: string): string;
+/** How secondary TopBar tools (grid/furniture/history/area/settings) are shown. */
+export type HeaderToolsMode = "full" | "compact" | "auto";
 export interface FloorEditorConfig {
     viewOnly: boolean;
     floorMaxWidth: number;
     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;
@@ -36,9 +45,20 @@ export interface FloorEditorConfig {
     canvasBackground?: string;
     /** Fill under the floor plan (inside wall bounds) */
     floorPlateBackground?: string;
+    /**
+     * TopBar secondary tools layout:
+     * - `full` — separate icons (default)
+     * - `compact` — always fold into one Settings menu
+     * - `auto` — fold when header is narrow
+     */
+    headerToolsMode?: HeaderToolsMode;
 }
 export declare const DEFAULT_CONFIG: FloorEditorConfig;
 export declare function normalizeConfig(value: Partial<FloorEditorConfig> | null | undefined): FloorEditorConfig;
-export declare function normalizeFloorData(data: Partial<Project> | null | undefined): Project;
+/**
+ * Accepts a full Project, `{ floors }`, a floors array, or a single Floor.
+ * Furniture (incl. cameras) is preserved as given.
+ */
+export declare function normalizeFloorData(data: Partial<Project> | Floor[] | Floor | null | undefined): Project;
 /** Strip runtime-only fields before persisting or dispatching floor:save. */
 export declare function exportProjectForSave(project: Project): Project;

package/dist/src/lib/stores/assignedCamerasSync.d.ts

@@ -1,4 +1,6 @@
 import { AssignedCamera } from '../../../lib/packageDefaults';
+/** Call when host replaces floorData so load doesn't fight a stale sync set. */
+export declare function resetAssignedCamerasSyncState(): void;
 /**
  * Sync host `assignedCameras` onto the active floor.
  * - Adds missing serials at floor center (non-overlapping)

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.6",
+  "version": "1.3.8",
   "type": "module",
   "main": "./dist/floor-editor.es.js",
   "module": "./dist/floor-editor.es.js",