floor-editor-ts 1.3.7 → 1.3.9

package/dist/src/lib/models/types.d.ts

@@ -128,6 +128,19 @@ export interface GuideLine {
     orientation: 'horizontal' | 'vertical';
     position: number;
 }
+/** Floor overlay zone (not tied to walls). Independent of heatmap. */
+export type ZoneShape = 'rectangle' | 'triangle' | 'polygon';
+export interface Zone {
+    id: string;
+    name: string;
+    shape: ZoneShape;
+    /** Closed polygon vertices (first point not repeated). */
+    points: Point[];
+    /** Stroke + label color (hex). */
+    color: string;
+    /** Soft fill alpha inside polygon. Default ~0.1 */
+    fillOpacity?: number;
+}
 export interface BackgroundImage {
     dataUrl: string;
     position: Point;
@@ -152,6 +165,7 @@ export interface Floor {
     measurements: Measurement[];
     annotations: Annotation[];
     textAnnotations: TextAnnotation[];
+    zones?: Zone[];
     groups: ElementGroup[];
 }
 export interface Project {

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/stores/project.d.ts

@@ -1,10 +1,12 @@
-import { Project, Floor, Wall, Door, Window as Win, FurnitureItem, Point, Stair, Column, BackgroundImage, ElementGroup } from '../../../lib/models/types';
+import { Project, Floor, Wall, Door, Window as Win, FurnitureItem, Point, Stair, Column, BackgroundImage, ElementGroup, Zone, ZoneShape } from '../../../lib/models/types';
 export declare function createDefaultFloor(level?: number): Floor;
 export declare function createDefaultProject(name?: string): Project;
 export declare const currentProject: import('svelte/store').Writable<Project | null>;
 export declare const activeFloor: import('svelte/store').Readable<Floor | null>;
-export type Tool = 'select' | 'wall' | 'door' | 'window' | 'furniture' | 'text';
+export type Tool = 'select' | 'wall' | 'door' | 'window' | 'furniture' | 'text' | 'annotate' | 'measure' | 'zone';
 export declare const selectedTool: import('svelte/store').Writable<Tool>;
+/** Subtype when selectedTool === 'zone' */
+export declare const placingZoneShape: import('svelte/store').Writable<ZoneShape>;
 export declare const snapEnabled: import('svelte/store').Writable<boolean>;
 /** When true, left-click drag pans the canvas instead of selecting */
 export declare const panMode: import('svelte/store').Writable<boolean>;
@@ -142,6 +144,11 @@ export declare function moveTextAnnotation(id: string, position: {
     x: number;
     y: number;
 }): void;
+export declare function addZone(shape: ZoneShape, points: Point[], name?: string, color?: string): string;
+export declare function updateZone(id: string, updates: Partial<Pick<Zone, 'name' | 'color' | 'fillOpacity' | 'points' | 'shape'>>): void;
+/** Live drag without undo snapshot (commit with updateZone / endUndoGroup). */
+export declare function moveZonePoints(id: string, points: Point[]): void;
+export declare function removeZone(id: string): void;
 export declare const layerVisibility: import('svelte/store').Writable<{
     walls: boolean;
     doors: boolean;
@@ -152,6 +159,7 @@ export declare const layerVisibility: import('svelte/store').Writable<{
     guides: boolean;
     measurements: boolean;
     annotations: boolean;
+    zones: boolean;
 }>;
 export declare function toggleFurnitureLock(id: string): void;
 export declare function setFurnitureLocked(id: string, locked: boolean): void;

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 { Point, Wall, Door, Window as Win, FurnitureItem, Stair, Column, Floor, Annotation, Zone, 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;
@@ -33,6 +34,10 @@ export declare function drawColumn(cs: CanvasState, col: Column, selected: boole
 export declare function drawGuides(cs: CanvasState, floor: Floor, selectedGuideId: string | null, RULER_SIZE: number): void;
 export declare function drawPersistedMeasurements(cs: CanvasState, floor: Floor, selectedMeasurementId: string | null, dimSettings: ProjectSettings): void;
 export declare function drawTextAnnotations(cs: CanvasState, floor: Floor, selectedTextAnnotationId: string | null, currentSelectedId: string | null): void;
+export declare function drawZoneShape(cs: CanvasState, zone: Zone, selected: boolean): void;
+export declare function drawZones(cs: CanvasState, floor: Floor, selectedZoneId: string | null): void;
+/** Preview while drawing polygon / dragging rect. */
+export declare function drawZoneDraft(cs: CanvasState, points: Point[], color: string, closed: boolean, cursor?: Point | null): void;
 export declare function drawAnnotation(cs: CanvasState, a: Annotation, selected: boolean, dimSettings: ProjectSettings): void;
 export declare function drawAnnotations(cs: CanvasState, floor: Floor, selectedAnnotationId: string | null, dimSettings: ProjectSettings): void;
 export declare function getRoomFill(room: Room, index: number): string;
@@ -49,4 +54,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/dist/src/lib/utils/hitTesting.d.ts

@@ -1,4 +1,4 @@
-import { Point, Wall, Door, Window as Win, FurnitureItem, Stair, Column, Floor, Room } from '../../../lib/models/types';
+import { Point, Wall, Door, Window as Win, FurnitureItem, Stair, Column, Floor, Zone, Room } from '../../../lib/models/types';
 import { HandleType } from '../../../lib/utils/canvasInteraction';
 export declare function pointInPolygon(p: Point, poly: Point[]): boolean;
 export declare function pointToSegmentDist(p: Point, a: Point, b: Point): number;
@@ -14,3 +14,7 @@ export declare function findRoomAt(p: Point, rooms: Room[], walls: Wall[]): Room
 export declare function hitTestMeasurement(wp: Point, floor: Floor, zoom: number): string | null;
 export declare function hitTestAnnotation(wp: Point, floor: Floor, zoom: number): string | null;
 export declare function hitTestTextAnnotation(wp: Point, floor: Floor, ctx: CanvasRenderingContext2D, zoom: number): string | null;
+/** Hit zone vertex; returns index or -1. */
+export declare function findZoneVertexAt(wp: Point, zone: Zone, zoom: number): number;
+/** Top-most zone under point (fill or near edge). */
+export declare function findZoneAt(wp: Point, zones: Zone[] | undefined, zoom: number): Zone | null;

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

@@ -0,0 +1,22 @@
+import { Point, Zone, ZoneShape } from '../../../lib/models/types';
+export declare const ZONE_COLOR_PALETTE: readonly ["#F97316", "#22C55E", "#3B82F6", "#EF4444", "#A855F7", "#EAB308"];
+export declare const DEFAULT_ZONE_FILL_OPACITY = 0.1;
+/** Default rect half-size in world units (cm). */
+export declare const DEFAULT_ZONE_SIZE = 200;
+export declare function nextZoneColor(existingCount: number): string;
+export declare function rectPoints(x1: number, y1: number, x2: number, y2: number): Point[];
+/** Isosceles triangle pointing up, centered at `c`. */
+export declare function trianglePoints(c: Point, size?: number): Point[];
+export declare function defaultRectAt(c: Point, size?: number): Point[];
+export declare function zoneBounds(points: Point[]): {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+} | null;
+export declare function translatePoints(points: Point[], dx: number, dy: number): Point[];
+/** Axis-aligned resize: keep opposite corner fixed when dragging corner index. */
+export declare function resizeRectCorner(points: Point[], cornerIndex: number, to: Point): Point[];
+export declare function isNearPoint(a: Point, b: Point, threshold: number): boolean;
+export declare function ensureZoneDefaults(zone: Zone): Zone;
+export declare function createZoneDraft(shape: ZoneShape, points: Point[], name: string, color: string): Omit<Zone, "id">;

package/package.json

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