@nice2dev/ui-graphics 1.0.0

package/dist/esm/core/fixes.js

@@ -0,0 +1,179 @@
+/**
+ * fixes.ts — Bug fixes and performance patches for editors.
+ *
+ * - PhotoEditor: Retina/HiDPI canvas devicePixelRatio handling
+ * - VectorEditor: Shape virtualization for >100 shapes
+ * - AnimationEditor: Memory leak prevention (raf/timer cleanup)
+ */
+/**
+ * Configure a canvas for Retina/HiDPI displays.
+ * Scales the backing store while keeping CSS dimensions intact.
+ */
+function setupRetinaCanvas(canvas, options) {
+    var _a;
+    const dpr = (_a = options.dpr) !== null && _a !== void 0 ? _a : (typeof window !== "undefined" ? window.devicePixelRatio : 1);
+    canvas.width = Math.round(options.width * dpr);
+    canvas.height = Math.round(options.height * dpr);
+    canvas.style.width = `${options.width}px`;
+    canvas.style.height = `${options.height}px`;
+    const ctx = canvas.getContext("2d");
+    ctx.scale(dpr, dpr);
+    return ctx;
+}
+/**
+ * Get the correct mouse position on a Retina canvas.
+ */
+function retinaMousePosition(e, canvas) {
+    const rect = canvas.getBoundingClientRect();
+    return {
+        x: e.clientX - rect.left,
+        y: e.clientY - rect.top,
+    };
+}
+/**
+ * Given a list of shapes with bounding boxes and a visible viewport,
+ * returns only the shapes intersecting the viewport.
+ */
+function virtualizeShapes(shapes, viewport, margin = 50) {
+    const vx = viewport.x - margin;
+    const vy = viewport.y - margin;
+    const vr = viewport.x + viewport.width + margin;
+    const vb = viewport.y + viewport.height + margin;
+    return shapes
+        .filter(({ bounds: b }) => {
+        const bx2 = b.x + b.width;
+        const by2 = b.y + b.height;
+        return bx2 >= vx && b.x <= vr && by2 >= vy && b.y <= vb;
+    })
+        .map(({ shape }) => shape);
+}
+/**
+ * Spatial hash grid for fast shape lookup.
+ * Greatly speeds up rendering and hit-testing with many shapes.
+ */
+class SpatialHashGrid {
+    constructor(cellSize = 200) {
+        this.cellSize = cellSize;
+        this.cells = new Map();
+    }
+    cellKey(cx, cy) {
+        return `${cx},${cy}`;
+    }
+    /** Insert a shape into the grid. */
+    insert(shape, bounds) {
+        const x0 = Math.floor(bounds.x / this.cellSize);
+        const y0 = Math.floor(bounds.y / this.cellSize);
+        const x1 = Math.floor((bounds.x + bounds.width) / this.cellSize);
+        const y1 = Math.floor((bounds.y + bounds.height) / this.cellSize);
+        const vs = { shape, bounds };
+        for (let cx = x0; cx <= x1; cx++) {
+            for (let cy = y0; cy <= y1; cy++) {
+                const key = this.cellKey(cx, cy);
+                const cell = this.cells.get(key);
+                if (cell)
+                    cell.push(vs);
+                else
+                    this.cells.set(key, [vs]);
+            }
+        }
+    }
+    /** Query shapes overlapping the given viewport. */
+    query(viewport) {
+        const x0 = Math.floor(viewport.x / this.cellSize);
+        const y0 = Math.floor(viewport.y / this.cellSize);
+        const x1 = Math.floor((viewport.x + viewport.width) / this.cellSize);
+        const y1 = Math.floor((viewport.y + viewport.height) / this.cellSize);
+        const seen = new Set();
+        const result = [];
+        for (let cx = x0; cx <= x1; cx++) {
+            for (let cy = y0; cy <= y1; cy++) {
+                const cell = this.cells.get(this.cellKey(cx, cy));
+                if (!cell)
+                    continue;
+                for (const vs of cell) {
+                    if (!seen.has(vs.shape)) {
+                        seen.add(vs.shape);
+                        result.push(vs.shape);
+                    }
+                }
+            }
+        }
+        return result;
+    }
+    /** Remove all shapes from the grid. */
+    clear() {
+        this.cells.clear();
+    }
+    /** Rebuild the grid from a list of shapes. */
+    rebuild(shapes) {
+        this.clear();
+        for (const vs of shapes)
+            this.insert(vs.shape, vs.bounds);
+    }
+}
+// ── Animation Memory Leak Prevention ────────────────────────────
+/**
+ * Track requestAnimationFrame IDs and timers for proper cleanup.
+ */
+class AnimationCleanup {
+    constructor() {
+        this.rafIds = new Set();
+        this.timerIds = new Set();
+        this.intervalIds = new Set();
+        this.disposed = false;
+    }
+    /** Wraps requestAnimationFrame with tracking. */
+    requestAnimationFrame(cb) {
+        if (this.disposed)
+            return -1;
+        const id = window.requestAnimationFrame((time) => {
+            this.rafIds.delete(id);
+            if (!this.disposed)
+                cb(time);
+        });
+        this.rafIds.add(id);
+        return id;
+    }
+    /** Wraps setTimeout with tracking. */
+    setTimeout(cb, ms) {
+        if (this.disposed)
+            return null;
+        const id = setTimeout(() => {
+            this.timerIds.delete(id);
+            if (!this.disposed)
+                cb();
+        }, ms);
+        this.timerIds.add(id);
+        return id;
+    }
+    /** Wraps setInterval with tracking. */
+    setInterval(cb, ms) {
+        if (this.disposed)
+            return null;
+        const id = setInterval(() => {
+            if (this.disposed) {
+                clearInterval(id);
+                return;
+            }
+            cb();
+        }, ms);
+        this.intervalIds.add(id);
+        return id;
+    }
+    /** Cancel all tracked timers and animation frames. */
+    dispose() {
+        this.disposed = true;
+        for (const id of this.rafIds)
+            window.cancelAnimationFrame(id);
+        for (const id of this.timerIds)
+            clearTimeout(id);
+        for (const id of this.intervalIds)
+            clearInterval(id);
+        this.rafIds.clear();
+        this.timerIds.clear();
+        this.intervalIds.clear();
+    }
+}
+
+export { AnimationCleanup, SpatialHashGrid, retinaMousePosition, setupRetinaCanvas, virtualizeShapes };
+//# sourceMappingURL=fixes.js.map

package/dist/esm/core/fixes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixes.js","sources":["../../../src/core/fixes.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/core/gridGuides.js

@@ -0,0 +1,232 @@
+/**
+ * gridGuides.ts — Grid, guides, rulers, and snap-to-grid/pixel for editors.
+ *
+ * Unified system for drawing grids, ruler bars, snapping to grid,
+ * and managing user-defined guide lines.
+ */
+// ── Default Config ──────────────────────────────────────────────
+// ── Grid Rendering ──────────────────────────────────────────────
+/** Draw a grid on a canvas context. */
+function drawGrid(ctx, width, height, config, offsetX = 0, offsetY = 0, zoom = 1) {
+    if (!config.enabled)
+        return;
+    const gridSize = config.size * zoom;
+    const subSize = gridSize / config.subdivisions;
+    ctx.save();
+    ctx.globalAlpha = config.opacity;
+    // Sub-grid
+    if (config.subdivisions > 1 && subSize >= 3) {
+        ctx.strokeStyle = config.subColor;
+        ctx.lineWidth = 0.5;
+        ctx.beginPath();
+        const startX = -(offsetX % subSize);
+        const startY = -(offsetY % subSize);
+        for (let x = startX; x <= width; x += subSize) {
+            ctx.moveTo(Math.round(x) + 0.5, 0);
+            ctx.lineTo(Math.round(x) + 0.5, height);
+        }
+        for (let y = startY; y <= height; y += subSize) {
+            ctx.moveTo(0, Math.round(y) + 0.5);
+            ctx.lineTo(width, Math.round(y) + 0.5);
+        }
+        ctx.stroke();
+    }
+    // Main grid
+    ctx.strokeStyle = config.color;
+    ctx.lineWidth = 1;
+    ctx.beginPath();
+    const mainStartX = -(offsetX % gridSize);
+    const mainStartY = -(offsetY % gridSize);
+    for (let x = mainStartX; x <= width; x += gridSize) {
+        ctx.moveTo(Math.round(x) + 0.5, 0);
+        ctx.lineTo(Math.round(x) + 0.5, height);
+    }
+    for (let y = mainStartY; y <= height; y += gridSize) {
+        ctx.moveTo(0, Math.round(y) + 0.5);
+        ctx.lineTo(width, Math.round(y) + 0.5);
+    }
+    ctx.stroke();
+    ctx.restore();
+}
+// ── Ruler Rendering ─────────────────────────────────────────────
+/** Draw horizontal ruler bar. */
+function drawHorizontalRuler(ctx, width, config, offsetX = 0, zoom = 1) {
+    if (!config.enabled)
+        return;
+    ctx.save();
+    ctx.fillStyle = config.backgroundColor;
+    ctx.fillRect(0, 0, width, config.size);
+    const step = calculateRulerStep(zoom);
+    ctx.strokeStyle = config.color;
+    ctx.fillStyle = config.textColor;
+    ctx.font = "9px monospace";
+    ctx.textAlign = "center";
+    const startX = Math.floor(-offsetX / (step * zoom)) * step;
+    const endX = startX + width / zoom + step;
+    for (let val = startX; val <= endX; val += step) {
+        const x = (val + offsetX / zoom) * zoom;
+        if (x < 0 || x > width)
+            continue;
+        // Major tick
+        ctx.beginPath();
+        ctx.moveTo(Math.round(x) + 0.5, config.size);
+        ctx.lineTo(Math.round(x) + 0.5, config.size - config.tickSize * 2);
+        ctx.stroke();
+        ctx.fillText(String(Math.round(val)), x, config.size - config.tickSize * 2 - 2);
+        // Minor ticks
+        for (let m = 1; m < 5; m++) {
+            const mx = ((val + (step * m) / 5) + offsetX / zoom) * zoom;
+            if (mx < 0 || mx > width)
+                continue;
+            ctx.beginPath();
+            ctx.moveTo(Math.round(mx) + 0.5, config.size);
+            ctx.lineTo(Math.round(mx) + 0.5, config.size - config.tickSize);
+            ctx.stroke();
+        }
+    }
+    ctx.restore();
+}
+/** Draw vertical ruler bar. */
+function drawVerticalRuler(ctx, height, config, offsetY = 0, zoom = 1) {
+    if (!config.enabled)
+        return;
+    ctx.save();
+    ctx.fillStyle = config.backgroundColor;
+    ctx.fillRect(0, 0, config.size, height);
+    const step = calculateRulerStep(zoom);
+    ctx.strokeStyle = config.color;
+    ctx.fillStyle = config.textColor;
+    ctx.font = "9px monospace";
+    const startY = Math.floor(-offsetY / (step * zoom)) * step;
+    const endY = startY + height / zoom + step;
+    for (let val = startY; val <= endY; val += step) {
+        const y = (val + offsetY / zoom) * zoom;
+        if (y < 0 || y > height)
+            continue;
+        ctx.beginPath();
+        ctx.moveTo(config.size, Math.round(y) + 0.5);
+        ctx.lineTo(config.size - config.tickSize * 2, Math.round(y) + 0.5);
+        ctx.stroke();
+        // Rotated text
+        ctx.save();
+        ctx.translate(config.size - config.tickSize * 2 - 2, y);
+        ctx.rotate(-Math.PI / 2);
+        ctx.textAlign = "center";
+        ctx.fillText(String(Math.round(val)), 0, 0);
+        ctx.restore();
+    }
+    ctx.restore();
+}
+function calculateRulerStep(zoom) {
+    var _a;
+    const idealStep = 50 / zoom;
+    const magnitude = Math.pow(10, Math.floor(Math.log10(idealStep)));
+    const candidates = [1, 2, 5, 10].map((m) => m * magnitude);
+    return (_a = candidates.find((c) => c >= idealStep)) !== null && _a !== void 0 ? _a : idealStep;
+}
+// ── Guide Rendering ─────────────────────────────────────────────
+/** Draw guides on a canvas context. */
+function drawGuides(ctx, width, height, config, offsetX = 0, offsetY = 0, zoom = 1) {
+    if (!config.enabled)
+        return;
+    ctx.save();
+    ctx.setLineDash([6, 3]);
+    ctx.lineWidth = 1;
+    for (const guide of config.guides) {
+        ctx.strokeStyle = guide.color || config.color;
+        ctx.beginPath();
+        if (guide.orientation === "horizontal") {
+            const y = (guide.position + offsetY / zoom) * zoom;
+            ctx.moveTo(0, Math.round(y) + 0.5);
+            ctx.lineTo(width, Math.round(y) + 0.5);
+        }
+        else {
+            const x = (guide.position + offsetX / zoom) * zoom;
+            ctx.moveTo(Math.round(x) + 0.5, 0);
+            ctx.lineTo(Math.round(x) + 0.5, height);
+        }
+        ctx.stroke();
+    }
+    ctx.setLineDash([]);
+    ctx.restore();
+}
+// ── Snapping ────────────────────────────────────────────────────
+/** Snap a point to the grid. */
+function snapToGrid(x, y, gridSize) {
+    return {
+        x: Math.round(x / gridSize) * gridSize,
+        y: Math.round(y / gridSize) * gridSize,
+        snappedX: true,
+        snappedY: true,
+    };
+}
+/** Snap a point to nearby guides. */
+function snapToGuides(x, y, guides, snapDistance) {
+    let sx = x, sy = y;
+    let snappedX = false, snappedY = false;
+    for (const guide of guides) {
+        if (guide.orientation === "vertical") {
+            if (Math.abs(x - guide.position) <= snapDistance) {
+                sx = guide.position;
+                snappedX = true;
+            }
+        }
+        else {
+            if (Math.abs(y - guide.position) <= snapDistance) {
+                sy = guide.position;
+                snappedY = true;
+            }
+        }
+    }
+    return { x: sx, y: sy, snappedX, snappedY };
+}
+/** Snap to pixel (floor to nearest integer). */
+function snapToPixel(x, y) {
+    return {
+        x: Math.round(x),
+        y: Math.round(y),
+        snappedX: true,
+        snappedY: true,
+    };
+}
+/** Combined snap: try guides first, then grid, then pixel. */
+function snapPoint(x, y, gridConfig, guidesConfig) {
+    // Try guides first
+    if (guidesConfig.enabled && guidesConfig.snapToGuides) {
+        const guideResult = snapToGuides(x, y, guidesConfig.guides, guidesConfig.snapDistance);
+        if (guideResult.snappedX || guideResult.snappedY)
+            return guideResult;
+    }
+    // Then grid
+    if (gridConfig.enabled && gridConfig.snapToGrid) {
+        return snapToGrid(x, y, gridConfig.size);
+    }
+    return { x, y, snappedX: false, snappedY: false };
+}
+// ── Guide Management ────────────────────────────────────────────
+let nextGuideId = 1;
+/** Create a new guide. */
+function createGuide(orientation, position, color) {
+    return {
+        id: `guide-${nextGuideId++}`,
+        orientation,
+        position,
+        color: color !== null && color !== void 0 ? color : "rgba(59, 130, 246, 0.6)",
+        locked: false,
+    };
+}
+/** Add a guide to the config. */
+function addGuide(config, guide) {
+    return { ...config, guides: [...config.guides, guide] };
+}
+/** Remove a guide by ID. */
+function removeGuide(config, guideId) {
+    return { ...config, guides: config.guides.filter((g) => g.id !== guideId) };
+}
+/** Clear all guides. */
+function clearGuides(config) {
+    return { ...config, guides: [] };
+}
+
+export { addGuide, clearGuides, createGuide, drawGrid, drawGuides, drawHorizontalRuler, drawVerticalRuler, removeGuide, snapPoint, snapToGrid, snapToGuides, snapToPixel };
+//# sourceMappingURL=gridGuides.js.map

package/dist/esm/core/gridGuides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridGuides.js","sources":["../../../src/core/gridGuides.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/core/historyVisual.js

@@ -0,0 +1,121 @@
+import React from 'react';
+
+/**
+ * historyVisual.ts — Visual undo/redo history for editors.
+ *
+ * Provides a visual timeline showing thumbnails/labels for each history entry,
+ * allowing users to click on any point to jump to that state.
+ */
+// ── Hook ────────────────────────────────────────────────────────
+let nextHistoryId = 1;
+/** React hook for visual undo/redo history management. */
+function useVisualHistory(maxEntries = 100) {
+    const [state, setState] = React.useState({
+        entries: [],
+        currentIndex: -1,
+    });
+    const push = React.useCallback((label, snapshot, thumbnail) => {
+        setState((prev) => {
+            // Trim redo stack
+            const entries = prev.entries.slice(0, prev.currentIndex + 1);
+            const entry = {
+                id: nextHistoryId++,
+                label,
+                timestamp: Date.now(),
+                thumbnail,
+                state: snapshot,
+            };
+            entries.push(entry);
+            // Enforce max
+            while (entries.length > maxEntries)
+                entries.shift();
+            return { entries, currentIndex: entries.length - 1 };
+        });
+    }, [maxEntries]);
+    const undo = React.useCallback(() => {
+        let result = null;
+        setState((prev) => {
+            if (prev.currentIndex <= 0)
+                return prev;
+            const newIndex = prev.currentIndex - 1;
+            result = prev.entries[newIndex].state;
+            return { ...prev, currentIndex: newIndex };
+        });
+        return result;
+    }, []);
+    const redo = React.useCallback(() => {
+        let result = null;
+        setState((prev) => {
+            if (prev.currentIndex >= prev.entries.length - 1)
+                return prev;
+            const newIndex = prev.currentIndex + 1;
+            result = prev.entries[newIndex].state;
+            return { ...prev, currentIndex: newIndex };
+        });
+        return result;
+    }, []);
+    const jumpTo = React.useCallback((index) => {
+        let result = null;
+        setState((prev) => {
+            if (index < 0 || index >= prev.entries.length)
+                return prev;
+            result = prev.entries[index].state;
+            return { ...prev, currentIndex: index };
+        });
+        return result;
+    }, []);
+    const clear = React.useCallback(() => {
+        setState({ entries: [], currentIndex: -1 });
+    }, []);
+    return {
+        push,
+        undo,
+        redo,
+        jumpTo,
+        getState: () => state,
+        canUndo: state.currentIndex > 0,
+        canRedo: state.currentIndex < state.entries.length - 1,
+        count: state.entries.length,
+        currentIndex: state.currentIndex,
+        entries: state.entries,
+        clear,
+    };
+}
+/** Visual history timeline panel showing entries with thumbnails. */
+function VisualHistoryPanel({ history, onJump, className = "", style, }) {
+    const handleClick = (index) => {
+        const state = history.jumpTo(index);
+        if (state !== null && onJump)
+            onJump(state);
+    };
+    return React.createElement("div", {
+        className: `nice-visual-history ${className}`,
+        style: { display: "flex", flexDirection: "column", gap: 2, padding: 4, ...style },
+    }, React.createElement("div", {
+        style: { display: "flex", justifyContent: "space-between", marginBottom: 4, fontSize: 11 },
+    }, React.createElement("strong", null, "History"), React.createElement("span", { style: { opacity: 0.6 } }, `${history.currentIndex + 1} / ${history.count}`)), React.createElement("div", {
+        style: { display: "flex", flexDirection: "column", gap: 1, overflowY: "auto", maxHeight: 300 },
+    }, history.entries.map((entry, idx) => React.createElement("div", {
+        key: entry.id,
+        onClick: () => handleClick(idx),
+        style: {
+            display: "flex",
+            alignItems: "center",
+            gap: 4,
+            padding: "3px 6px",
+            cursor: "pointer",
+            fontSize: 11,
+            borderRadius: 3,
+            background: idx === history.currentIndex ? "rgba(59,130,246,0.15)" : "transparent",
+            fontWeight: idx === history.currentIndex ? 600 : 400,
+            opacity: idx > history.currentIndex ? 0.4 : 1,
+        },
+    }, entry.thumbnail && React.createElement("img", {
+        src: entry.thumbnail,
+        alt: "",
+        style: { width: 24, height: 24, borderRadius: 2, objectFit: "cover" },
+    }), React.createElement("span", { style: { flex: 1, overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" } }, entry.label)))));
+}
+
+export { VisualHistoryPanel, useVisualHistory };
+//# sourceMappingURL=historyVisual.js.map

package/dist/esm/core/historyVisual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"historyVisual.js","sources":["../../../src/core/historyVisual.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/core/i18n.js

@@ -0,0 +1,13 @@
+import { jsx } from 'react/jsx-runtime';
+import { createContext, useContext } from 'react';
+
+const fallback = (_key, defaultValue) => defaultValue;
+const NiceI18nContext = createContext(fallback);
+const NiceI18nProvider = ({ t, children }) => (jsx(NiceI18nContext.Provider, { value: t, children: children }));
+function useNiceTranslation() {
+    const t = useContext(NiceI18nContext);
+    return { t };
+}
+
+export { NiceI18nProvider, useNiceTranslation };
+//# sourceMappingURL=i18n.js.map

package/dist/esm/core/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sources":["../../../src/core/i18n.tsx"],"sourcesContent":[null],"names":["_jsx"],"mappings":";;;AAqBA,MAAM,QAAQ,GAAoB,CAAC,IAAY,EAAE,YAAoB,KAAK,YAAY;AAEtF,MAAM,eAAe,GAAG,aAAa,CAAkB,QAAQ,CAAC;AAOzD,MAAM,gBAAgB,GAAoC,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,MAC/EA,GAAA,CAAC,eAAe,CAAC,QAAQ,EAAA,EAAC,KAAK,EAAE,CAAC,EAAA,QAAA,EAAG,QAAQ,EAAA,CAA4B;SAG3D,kBAAkB,GAAA;AAChC,IAAA,MAAM,CAAC,GAAG,UAAU,CAAC,eAAe,CAAC;IACrC,OAAO,EAAE,CAAC,EAAE;AACd;;;;"}