@bwp-web/canvas 0.4.1 → 0.4.3

package/dist/index.d.ts

@@ -5,6 +5,14 @@ export { useEditCanvas } from './hooks';
 export type { UseEditCanvasOptions } from './hooks';
 export { useViewCanvas } from './hooks';
 export type { UseViewCanvasOptions, ViewObjectStyle } from './hooks';
+export { useCanvasEvents } from './hooks';
+export type { CanvasEventHandlers } from './hooks';
+export { useCanvasTooltip } from './hooks';
+export type { UseCanvasTooltipOptions, CanvasTooltipState } from './hooks';
+export { useCanvasClick } from './hooks';
+export type { UseCanvasClickOptions } from './hooks';
+export { useObjectOverlay } from './hooks';
+export type { UseObjectOverlayOptions } from './hooks';
 export type { Point2D, ShapeStyleOptions, SnappingOptions, InteractionModeOptions, SnappableInteractionOptions, DragBounds, ModeSetup, } from './types';
 export { createRectangle, createRectangleAtPoint, editRectangle, } from './shapes';
 export type { RectangleOptions, RectangleAtPointOptions } from './shapes';
@@ -20,7 +28,7 @@ export type { DrawToCreateOptions } from './interactions';
 export { enableVertexEdit } from './interactions';
 export type { VertexEditOptions } from './interactions';
 export { enablePanAndZoom, resetViewport } from './viewport';
-export type { ViewportController, ViewportMode, PanAndZoomOptions, } from './viewport';
+export type { ViewportController, ViewportMode, PanAndZoomOptions, PanToObjectOptions, } from './viewport';
 export { getSnapPoints, registerSnapPointExtractor } from './alignment';
 export type { SnapPointExtractor } from './alignment';
 export { enableObjectAlignment } from './alignment';
@@ -31,8 +39,9 @@ export { snapCursorPoint } from './alignment';
 export type { CursorSnapResult, CursorSnapOptions, GuidelineStyle, } from './alignment';
 export { deleteObjects, enableKeyboardShortcuts } from './keyboard';
 export { enableScaledStrokes, serializeCanvas, loadCanvas, getBaseStrokeWidth, } from './serialization';
-export type { SerializeOptions } from './serialization';
-export { fitViewportToBackground, setBackgroundOpacity, getBackgroundOpacity, setBackgroundInverted, getBackgroundInverted, resizeImageUrl, setBackgroundImage, } from './background';
-export type { FitViewportOptions, ResizeResult, ResizeImageOptions, } from './background';
+export type { SerializeOptions, LoadCanvasOptions } from './serialization';
+export { fitViewportToBackground, getBackgroundSrc, setBackgroundOpacity, getBackgroundOpacity, setBackgroundInverted, getBackgroundInverted, resizeImageUrl, setBackgroundImage, } from './background';
+export type { FitViewportOptions, ResizeResult, ResizeImageOptions, SetBackgroundImageOptions, } from './background';
 export { DEFAULT_CONTROL_STYLE, DEFAULT_SHAPE_STYLE, DEFAULT_CIRCLE_STYLE, DEFAULT_DRAG_SHAPE_STYLE, DEFAULT_GUIDELINE_SHAPE_STYLE, DEFAULT_ALIGNMENT_STYLE, } from './styles';
+export { Canvas as FabricCanvas, FabricObject, FabricImage, Rect, Polygon, Point, util, } from 'fabric';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,3 +1,6 @@
+// src/fabricAugmentation.ts
+import "fabric";
+
 // src/Canvas/Canvas.tsx
 import { Canvas as FabricCanvas } from "fabric";
 import { useEffect, useRef } from "react";
@@ -26,27 +29,56 @@ function enableKeyboardShortcuts(canvas) {
 // src/Canvas/Canvas.tsx
 import { jsx } from "react/jsx-runtime";
 function Canvas({
-  width = 800,
-  height = 600,
+  width,
+  height,
   className,
   style,
   onReady
 }) {
   const canvasRef = useRef(null);
+  const wrapperRef = useRef(null);
+  const isFixedSize = width !== void 0 && height !== void 0;
   useEffect(() => {
     const el = canvasRef.current;
-    if (!el) {
-      return;
-    }
-    const fabricCanvas = new FabricCanvas(el, { width, height });
+    const wrapper = wrapperRef.current;
+    if (!el || !wrapper) return;
+    const initialWidth = isFixedSize ? width : wrapper.clientWidth || 800;
+    const initialHeight = isFixedSize ? height : wrapper.clientHeight || 600;
+    const fabricCanvas = new FabricCanvas(el, {
+      width: initialWidth,
+      height: initialHeight
+    });
     onReady?.(fabricCanvas);
     const cleanupShortcuts = enableKeyboardShortcuts(fabricCanvas);
+    let observer;
+    let rafId = 0;
+    if (!isFixedSize) {
+      let currentWidth = initialWidth;
+      let currentHeight = initialHeight;
+      observer = new ResizeObserver((entries) => {
+        cancelAnimationFrame(rafId);
+        rafId = requestAnimationFrame(() => {
+          const entry = entries[0];
+          if (!entry) return;
+          const { width: newWidth, height: newHeight } = entry.contentRect;
+          if (newWidth > 0 && newHeight > 0 && (newWidth !== currentWidth || newHeight !== currentHeight)) {
+            currentWidth = newWidth;
+            currentHeight = newHeight;
+            fabricCanvas.setDimensions({ width: newWidth, height: newHeight });
+          }
+        });
+      });
+      observer.observe(wrapper);
+    }
     return () => {
+      cancelAnimationFrame(rafId);
+      observer?.disconnect();
       cleanupShortcuts();
       fabricCanvas.dispose();
     };
   }, []);
-  return /* @__PURE__ */ jsx("div", { className, style, children: /* @__PURE__ */ jsx("canvas", { ref: canvasRef }) });
+  const wrapperStyle = isFixedSize ? { ...style } : { width: "100%", height: "100%", ...style };
+  return /* @__PURE__ */ jsx("div", { ref: wrapperRef, className, style: wrapperStyle, children: /* @__PURE__ */ jsx("canvas", { ref: canvasRef }) });
 }
 
 // src/hooks/useEditCanvas.ts
@@ -54,7 +86,9 @@ import { useCallback, useEffect as useEffect2, useRef as useRef2, useState } fro
 import { Polygon as Polygon4 } from "fabric";
 
 // src/viewport.ts
-import { Point } from "fabric";
+import {
+  Point
+} from "fabric";
 
 // src/constants.ts
 var DEFAULT_MIN_ZOOM = 0.2;
@@ -256,6 +290,54 @@ function enablePanAndZoom(canvas, options) {
         z
       );
     },
+    panToObject(object, panOpts) {
+      const zoom = canvas.getZoom();
+      const objectCenter = object.getCenterPoint();
+      const canvasCenterX = canvas.getWidth() / 2;
+      const canvasCenterY = canvas.getHeight() / 2;
+      const targetX = canvasCenterX - objectCenter.x * zoom;
+      const targetY = canvasCenterY - objectCenter.y * zoom;
+      if (!panOpts?.animate) {
+        const vt2 = canvas.viewportTransform;
+        if (!vt2) return;
+        canvas.setViewportTransform([
+          vt2[0],
+          vt2[1],
+          vt2[2],
+          vt2[3],
+          targetX,
+          targetY
+        ]);
+        return;
+      }
+      const duration = panOpts.duration ?? 300;
+      const vt = canvas.viewportTransform;
+      if (!vt) return;
+      const startX = vt[4];
+      const startY = vt[5];
+      const startTime = performance.now();
+      function step(now) {
+        const elapsed = now - startTime;
+        const t = Math.min(elapsed / duration, 1);
+        const eased = 1 - Math.pow(1 - t, 3);
+        const currentX = startX + (targetX - startX) * eased;
+        const currentY = startY + (targetY - startY) * eased;
+        const currentVt = canvas.viewportTransform;
+        if (!currentVt) return;
+        canvas.setViewportTransform([
+          currentVt[0],
+          currentVt[1],
+          currentVt[2],
+          currentVt[3],
+          currentX,
+          currentY
+        ]);
+        if (t < 1) {
+          requestAnimationFrame(step);
+        }
+      }
+      requestAnimationFrame(step);
+    },
     cleanup() {
       canvas.off("mouse:wheel", handleWheel);
       canvas.off("mouse:down", panHandlers.handleMouseDown);
@@ -274,6 +356,11 @@ import { FabricImage, filters } from "fabric";
 function getBackgroundImage(canvas) {
   return canvas.backgroundImage;
 }
+function getBackgroundSrc(canvas) {
+  const bg = getBackgroundImage(canvas);
+  if (!bg) return null;
+  return bg.getSrc() || null;
+}
 function fitViewportToBackground(canvas, options) {
   const bg = getBackgroundImage(canvas);
   if (!bg) return;
@@ -369,14 +456,18 @@ function resizeImageUrl(url, options) {
     img.src = url;
   });
 }
-async function setBackgroundImage(canvas, url, resize) {
+async function setBackgroundImage(canvas, url, options) {
+  const prevOpacity = options?.preserveOpacity ? getBackgroundOpacity(canvas) : void 0;
   let imageUrl = url;
-  if (resize !== void 0) {
-    const result = await resizeImageUrl(url, resize);
+  if (options !== void 0) {
+    const result = await resizeImageUrl(url, options);
     imageUrl = result.url;
   }
   const img = await FabricImage.fromURL(imageUrl, { crossOrigin: "anonymous" });
   canvas.backgroundImage = img;
+  if (prevOpacity !== void 0 && prevOpacity !== 1) {
+    img.set("opacity", prevOpacity);
+  }
   canvas.requestRenderAll();
   return img;
 }
@@ -405,7 +496,10 @@ function createViewportActions(canvasRef, viewportRef, setZoom) {
     viewportRef.current?.zoomOut(step);
     syncZoom(canvasRef, setZoom);
   };
-  return { resetViewport: resetViewport2, zoomIn, zoomOut };
+  const panToObject = (object, panOpts) => {
+    viewportRef.current?.panToObject(object, panOpts);
+  };
+  return { resetViewport: resetViewport2, zoomIn, zoomOut, panToObject };
 }
 function resolveAlignmentEnabled(enableAlignment, alignmentProp) {
   if (enableAlignment !== void 0) return enableAlignment;
@@ -1301,21 +1395,39 @@ function enableDragToCreate(canvas, factory, options) {
     options?.onCreated?.(obj);
     previewRect = null;
   };
+  const handleKeyDown = (e) => {
+    if (e.key === "Escape") {
+      e.stopImmediatePropagation();
+      e.preventDefault();
+      cleanup("cancel");
+    }
+  };
   canvas.on("mouse:down", handleMouseDown);
   canvas.on("mouse:move", handleMouseMove);
   canvas.on("mouse:up", handleMouseUp);
-  return () => {
+  document.addEventListener("keydown", handleKeyDown, true);
+  let exited = false;
+  function cleanup(reason) {
+    if (exited) return;
+    exited = true;
     canvas.off("mouse:down", handleMouseDown);
     canvas.off("mouse:move", handleMouseMove);
     canvas.off("mouse:up", handleMouseUp);
+    document.removeEventListener("keydown", handleKeyDown, true);
     shiftTracker.cleanup();
     snapping.cleanup();
     if (isDrawing && previewRect) {
+      snapping.excludeSet.delete(previewRect);
       canvas.remove(previewRect);
+      canvas.selection = previousSelection;
       canvas.requestRenderAll();
     }
     restoreViewport(options?.viewport);
-  };
+    if (reason === "cancel") {
+      options?.onCancel?.();
+    }
+  }
+  return () => cleanup();
 }
 
 // src/interactions/drawToCreate.ts
@@ -1595,6 +1707,9 @@ function enableDrawToCreate(canvas, options) {
     removePreviewElements();
     snapping.clearSnapResult();
     const polygon = createPolygonFromVertices(canvas, points, options?.style);
+    if (options?.data) {
+      polygon.data = options.data;
+    }
     canvas.selection = previousSelection;
     canvas.requestRenderAll();
     restoreViewport(options?.viewport);
@@ -1973,8 +2088,15 @@ function serializeCanvas(canvas, options) {
   });
   return json;
 }
-async function loadCanvas(canvas, json) {
+async function loadCanvas(canvas, json, options) {
   await canvas.loadFromJSON(json);
+  if (options?.filter) {
+    const toRemove = [];
+    canvas.forEachObject((obj) => {
+      if (!options.filter(obj)) toRemove.push(obj);
+    });
+    for (const obj of toRemove) canvas.remove(obj);
+  }
   canvas.forEachObject((obj) => {
     obj.set(DEFAULT_CONTROL_STYLE);
     if (obj.shapeType === "circle" && obj instanceof Rect5) {
@@ -1982,6 +2104,7 @@ async function loadCanvas(canvas, json) {
     }
   });
   canvas.requestRenderAll();
+  return canvas.getObjects();
 }
 
 // src/hooks/useEditCanvas.ts
@@ -1997,6 +2120,7 @@ function useEditCanvas(options) {
   const [selected, setSelected] = useState([]);
   const [viewportMode, setViewportModeState] = useState("select");
   const [isEditingVertices, setIsEditingVertices] = useState(false);
+  const [isDirty, setIsDirty] = useState(false);
   const setMode = useCallback((setup) => {
     vertexEditCleanupRef.current?.();
     vertexEditCleanupRef.current = null;
@@ -2067,6 +2191,11 @@ function useEditCanvas(options) {
       canvas.on("selection:cleared", () => {
         setSelected([]);
       });
+      if (options?.trackChanges) {
+        canvas.on("object:added", () => setIsDirty(true));
+        canvas.on("object:removed", () => setIsDirty(true));
+        canvas.on("object:modified", () => setIsDirty(true));
+      }
       if (options?.vertexEdit !== false) {
         const vertexOpts = typeof options?.vertexEdit === "object" ? options.vertexEdit : void 0;
         canvas.on("mouse:dblclick", (e) => {
@@ -2121,22 +2250,26 @@ function useEditCanvas(options) {
     viewportRef.current?.setMode(mode);
     setViewportModeState(mode);
   }, []);
-  const { resetViewport: resetViewport2, zoomIn, zoomOut } = createViewportActions(
+  const { resetViewport: resetViewport2, zoomIn, zoomOut, panToObject } = createViewportActions(
     canvasRef,
     viewportRef,
     setZoom
   );
-  const setBackground = useCallback(async (url) => {
-    const canvas = canvasRef.current;
-    if (!canvas) throw new Error("Canvas not ready");
-    const resizeOpts = options?.backgroundResize !== false ? typeof options?.backgroundResize === "object" ? options.backgroundResize : {} : void 0;
-    const img = await setBackgroundImage(canvas, url, resizeOpts);
-    if (options?.autoFitToBackground !== false) {
-      fitViewportToBackground(canvas);
-      syncZoom(canvasRef, setZoom);
-    }
-    return img;
-  }, []);
+  const setBackground = useCallback(
+    async (url, bgOpts) => {
+      const canvas = canvasRef.current;
+      if (!canvas) throw new Error("Canvas not ready");
+      const resizeOpts = options?.backgroundResize !== false ? typeof options?.backgroundResize === "object" ? { ...options.backgroundResize, ...bgOpts } : { ...bgOpts } : bgOpts?.preserveOpacity ? { preserveOpacity: true } : void 0;
+      const img = await setBackgroundImage(canvas, url, resizeOpts);
+      if (options?.autoFitToBackground !== false) {
+        fitViewportToBackground(canvas);
+        syncZoom(canvasRef, setZoom);
+      }
+      return img;
+    },
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    []
+  );
   return {
     /** Pass this to `<Canvas onReady={...} />` */
     onReady,
@@ -2157,7 +2290,9 @@ function useEditCanvas(options) {
       /** Zoom in toward the canvas center. Default step: 0.2. */
       zoomIn,
       /** Zoom out from the canvas center. Default step: 0.2. */
-      zoomOut
+      zoomOut,
+      /** Pan the viewport to center on a specific object. */
+      panToObject
     },
     /** Whether vertex edit mode is currently active (reactive). */
     isEditingVertices,
@@ -2181,8 +2316,15 @@ function useEditCanvas(options) {
      * Set a background image from a URL. Automatically resizes if the image
      * exceeds the configured limits (opt out via `backgroundResize: false`),
      * and fits the viewport after setting if `autoFitToBackground` is enabled.
+     *
+     * Pass `{ preserveOpacity: true }` to keep the current background opacity
+     * when replacing the image.
      */
-    setBackground
+    setBackground,
+    /** Whether the canvas has been modified since the last `resetDirty()` call. Requires `trackChanges: true`. */
+    isDirty,
+    /** Reset the dirty flag (e.g., after a successful save). */
+    resetDirty: useCallback(() => setIsDirty(false), [])
   };
 }
 
@@ -2240,7 +2382,7 @@ function useViewCanvas(options) {
     // eslint-disable-next-line react-hooks/exhaustive-deps
     []
   );
-  const { resetViewport: resetViewport2, zoomIn, zoomOut } = createViewportActions(
+  const { resetViewport: resetViewport2, zoomIn, zoomOut, panToObject } = createViewportActions(
     canvasRef,
     viewportRef,
     setZoom
@@ -2306,7 +2448,9 @@ function useViewCanvas(options) {
       /** Zoom in toward the canvas center. Default step: 0.2. */
       zoomIn,
       /** Zoom out from the canvas center. Default step: 0.2. */
-      zoomOut
+      zoomOut,
+      /** Pan the viewport to center on a specific object. */
+      panToObject
     },
     /** Update a single object's visual style by its `data.id`. */
     setObjectStyle,
@@ -2316,6 +2460,217 @@ function useViewCanvas(options) {
     setObjectStyleByType
   };
 }
+
+// src/hooks/useCanvasEvents.ts
+import { useEffect as useEffect3, useRef as useRef4 } from "react";
+function useCanvasEvents(canvasRef, events) {
+  const eventsRef = useRef4(events);
+  eventsRef.current = events;
+  useEffect3(() => {
+    const canvas = canvasRef.current;
+    if (!canvas) return;
+    const wrappers = /* @__PURE__ */ new Map();
+    for (const key of Object.keys(eventsRef.current)) {
+      if (!eventsRef.current[key]) continue;
+      const wrapped = (options) => {
+        eventsRef.current[key]?.(options);
+      };
+      canvas.on(key, wrapped);
+      wrappers.set(key, wrapped);
+    }
+    return () => {
+      wrappers.forEach((handler, name) => {
+        canvas.off(name, handler);
+      });
+    };
+  }, [canvasRef]);
+}
+
+// src/hooks/useCanvasTooltip.ts
+import { useEffect as useEffect4, useRef as useRef5, useState as useState3 } from "react";
+function useCanvasTooltip(canvasRef, options) {
+  const [state, setState] = useState3({
+    visible: false,
+    content: null,
+    position: { x: 0, y: 0 }
+  });
+  const hoveredObjectRef = useRef5(null);
+  const optionsRef = useRef5(options);
+  optionsRef.current = options;
+  useEffect4(() => {
+    const canvas = canvasRef.current;
+    if (!canvas) return;
+    function calculatePosition(target) {
+      const bounds = target.getBoundingRect();
+      const zoom = canvas.getZoom();
+      const vt = canvas.viewportTransform;
+      if (!vt) return null;
+      return {
+        x: (bounds.left + bounds.width / 2) * zoom + vt[4],
+        y: bounds.top * zoom + vt[5] - 10
+      };
+    }
+    const handleMouseOver = (e) => {
+      const target = e.target;
+      if (!target) return;
+      const content = optionsRef.current.getContent(target);
+      if (content === null) return;
+      if (hoveredObjectRef.current !== target) {
+        hoveredObjectRef.current = target;
+        const position = calculatePosition(target);
+        if (position) {
+          setState({ visible: true, content, position });
+        }
+      }
+    };
+    const handleMouseOut = (e) => {
+      if (e.target && hoveredObjectRef.current === e.target) {
+        setState((prev) => ({ ...prev, visible: false }));
+        hoveredObjectRef.current = null;
+      }
+    };
+    const updatePosition = () => {
+      if (!hoveredObjectRef.current) return;
+      const position = calculatePosition(hoveredObjectRef.current);
+      if (position) {
+        setState((prev) => prev.visible ? { ...prev, position } : prev);
+      }
+    };
+    canvas.on("mouse:over", handleMouseOver);
+    canvas.on("mouse:out", handleMouseOut);
+    canvas.on("after:render", updatePosition);
+    canvas.on("mouse:wheel", updatePosition);
+    return () => {
+      canvas.off("mouse:over", handleMouseOver);
+      canvas.off("mouse:out", handleMouseOut);
+      canvas.off("after:render", updatePosition);
+      canvas.off("mouse:wheel", updatePosition);
+    };
+  }, [canvasRef]);
+  return state;
+}
+
+// src/hooks/useCanvasClick.ts
+import { useEffect as useEffect5, useRef as useRef6 } from "react";
+function useCanvasClick(canvasRef, onClick, options) {
+  const onClickRef = useRef6(onClick);
+  onClickRef.current = onClick;
+  const optionsRef = useRef6(options);
+  optionsRef.current = options;
+  useEffect5(() => {
+    const canvas = canvasRef.current;
+    if (!canvas) return;
+    let mouseDown = null;
+    let isPanning = false;
+    const handleMouseDown = (e) => {
+      const native = e.e instanceof TouchEvent ? e.e.touches[0] : e.e;
+      if (native) {
+        mouseDown = { x: native.clientX, y: native.clientY, time: Date.now() };
+        isPanning = false;
+      }
+    };
+    const handleMouseMove = (e) => {
+      if (!mouseDown) return;
+      const native = e.e instanceof TouchEvent ? e.e.touches[0] : e.e;
+      if (!native) return;
+      const threshold = optionsRef.current?.threshold ?? 5;
+      const deltaX = Math.abs(native.clientX - mouseDown.x);
+      const deltaY = Math.abs(native.clientY - mouseDown.y);
+      if (deltaX > threshold || deltaY > threshold) {
+        isPanning = true;
+      }
+    };
+    const handleMouseUp = (e) => {
+      if (!mouseDown) return;
+      const maxDuration = optionsRef.current?.maxDuration ?? 300;
+      const elapsed = Date.now() - mouseDown.time;
+      if (!isPanning && elapsed < maxDuration) {
+        onClickRef.current(e.target);
+      }
+      mouseDown = null;
+      isPanning = false;
+    };
+    canvas.on("mouse:down", handleMouseDown);
+    canvas.on("mouse:move", handleMouseMove);
+    canvas.on("mouse:up", handleMouseUp);
+    return () => {
+      canvas.off("mouse:down", handleMouseDown);
+      canvas.off("mouse:move", handleMouseMove);
+      canvas.off("mouse:up", handleMouseUp);
+    };
+  }, [canvasRef]);
+}
+
+// src/hooks/useObjectOverlay.ts
+import { useEffect as useEffect6, useRef as useRef7 } from "react";
+import { util as util4 } from "fabric";
+function useObjectOverlay(canvasRef, object, options) {
+  const containerRef = useRef7(null);
+  const optionsRef = useRef7(options);
+  optionsRef.current = options;
+  useEffect6(() => {
+    const canvas = canvasRef.current;
+    if (!canvas || !object) return;
+    function update() {
+      const el = containerRef.current;
+      if (!el || !canvas || !object) return;
+      const zoom = canvas.getZoom();
+      const vt = canvas.viewportTransform;
+      if (!vt) return;
+      const center = object.getCenterPoint();
+      const actualWidth = (object.width ?? 0) * (object.scaleX ?? 1);
+      const actualHeight = (object.height ?? 0) * (object.scaleY ?? 1);
+      const screenCoords = util4.transformPoint(center, vt);
+      const screenWidth = actualWidth * zoom;
+      const screenHeight = actualHeight * zoom;
+      el.style.left = `${screenCoords.x - screenWidth / 2}px`;
+      el.style.top = `${screenCoords.y - screenHeight / 2}px`;
+      el.style.width = `${screenWidth}px`;
+      el.style.height = `${screenHeight}px`;
+      const angle = object.angle ?? 0;
+      el.style.rotate = angle !== 0 ? `${angle}deg` : "";
+      const opts = optionsRef.current;
+      if (opts?.autoScaleContent) {
+        const contentScale = Math.min(screenWidth, screenHeight) / 100;
+        const clampedScale = Math.max(0.1, Math.min(contentScale, 2));
+        el.style.setProperty("--overlay-scale", String(clampedScale));
+        if (opts.textSelector) {
+          const textMinScale = opts.textMinScale ?? 0.5;
+          const textEls = el.querySelectorAll(opts.textSelector);
+          const display = clampedScale < textMinScale ? "none" : "";
+          textEls.forEach((t) => {
+            t.style.display = display;
+          });
+        }
+      }
+    }
+    update();
+    canvas.on("after:render", update);
+    canvas.on("mouse:wheel", update);
+    object.on("moving", update);
+    object.on("scaling", update);
+    object.on("rotating", update);
+    return () => {
+      canvas.off("after:render", update);
+      canvas.off("mouse:wheel", update);
+      object.off("moving", update);
+      object.off("scaling", update);
+      object.off("rotating", update);
+    };
+  }, [canvasRef, object]);
+  return containerRef;
+}
+
+// src/index.ts
+import {
+  Canvas as Canvas2,
+  FabricObject as FabricObject5,
+  FabricImage as FabricImage2,
+  Rect as Rect7,
+  Polygon as Polygon5,
+  Point as Point9,
+  util as util5
+} from "fabric";
 export {
   Canvas,
   DEFAULT_ALIGNMENT_STYLE,
@@ -2324,6 +2679,12 @@ export {
   DEFAULT_DRAG_SHAPE_STYLE,
   DEFAULT_GUIDELINE_SHAPE_STYLE,
   DEFAULT_SHAPE_STYLE,
+  Canvas2 as FabricCanvas,
+  FabricImage2 as FabricImage,
+  FabricObject5 as FabricObject,
+  Point9 as Point,
+  Polygon5 as Polygon,
+  Rect7 as Rect,
   createCircle,
   createCircleAtPoint,
   createPolygon,
@@ -2348,6 +2709,7 @@ export {
   fitViewportToBackground,
   getBackgroundInverted,
   getBackgroundOpacity,
+  getBackgroundSrc,
   getBaseStrokeWidth,
   getSnapPoints,
   loadCanvas,
@@ -2359,7 +2721,12 @@ export {
   setBackgroundInverted,
   setBackgroundOpacity,
   snapCursorPoint,
+  useCanvasClick,
+  useCanvasEvents,
+  useCanvasTooltip,
   useEditCanvas,
-  useViewCanvas
+  useObjectOverlay,
+  useViewCanvas,
+  util5 as util
 };
 //# sourceMappingURL=index.js.map