@nice2dev/ui-graphics 1.0.0

package/dist/cjs/core/gridGuides.js

@@ -0,0 +1,245 @@
+'use strict';
+
+/**
+ * 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: [] };
+}
+
+exports.addGuide = addGuide;
+exports.clearGuides = clearGuides;
+exports.createGuide = createGuide;
+exports.drawGrid = drawGrid;
+exports.drawGuides = drawGuides;
+exports.drawHorizontalRuler = drawHorizontalRuler;
+exports.drawVerticalRuler = drawVerticalRuler;
+exports.removeGuide = removeGuide;
+exports.snapPoint = snapPoint;
+exports.snapToGrid = snapToGrid;
+exports.snapToGuides = snapToGuides;
+exports.snapToPixel = snapToPixel;
+//# sourceMappingURL=gridGuides.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gridGuides.js","sources":["../../../src/core/gridGuides.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;AAKG;AA8CH;AA6BA;AAEA;AACM,SAAU,QAAQ,CACtB,GAA6B,EAC7B,KAAa,EACb,MAAc,EACd,MAAkB,EAClB,OAAO,GAAG,CAAC,EACX,OAAO,GAAG,CAAC,EACX,IAAI,GAAG,CAAC,EAAA;IAER,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE;AAErB,IAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,GAAG,IAAI;AACnC,IAAA,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC,YAAY;IAE9C,GAAG,CAAC,IAAI,EAAE;AACV,IAAA,GAAG,CAAC,WAAW,GAAG,MAAM,CAAC,OAAO;;IAGhC,IAAI,MAAM,CAAC,YAAY,GAAG,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE;AAC3C,QAAA,GAAG,CAAC,WAAW,GAAG,MAAM,CAAC,QAAQ;AACjC,QAAA,GAAG,CAAC,SAAS,GAAG,GAAG;QACnB,GAAG,CAAC,SAAS,EAAE;QACf,MAAM,MAAM,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC;QACnC,MAAM,MAAM,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC;AACnC,QAAA,KAAK,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,IAAI,OAAO,EAAE;AAC7C,YAAA,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;AAClC,YAAA,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,CAAC;QACzC;AACA,QAAA,KAAK,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,IAAI,OAAO,EAAE;AAC9C,YAAA,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AAClC,YAAA,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QACxC;QACA,GAAG,CAAC,MAAM,EAAE;IACd;;AAGA,IAAA,GAAG,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK;AAC9B,IAAA,GAAG,CAAC,SAAS,GAAG,CAAC;IACjB,GAAG,CAAC,SAAS,EAAE;IACf,MAAM,UAAU,GAAG,EAAE,OAAO,GAAG,QAAQ,CAAC;IACxC,MAAM,UAAU,GAAG,EAAE,OAAO,GAAG,QAAQ,CAAC;AACxC,IAAA,KAAK,IAAI,CAAC,GAAG,UAAU,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,IAAI,QAAQ,EAAE;AAClD,QAAA,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;AAClC,QAAA,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,CAAC;IACzC;AACA,IAAA,KAAK,IAAI,CAAC,GAAG,UAAU,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,IAAI,QAAQ,EAAE;AACnD,QAAA,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AAClC,QAAA,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IACxC;IACA,GAAG,CAAC,MAAM,EAAE;IAEZ,GAAG,CAAC,OAAO,EAAE;AACf;AAEA;AAEA;AACM,SAAU,mBAAmB,CACjC,GAA6B,EAC7B,KAAa,EACb,MAAoB,EACpB,OAAO,GAAG,CAAC,EACX,IAAI,GAAG,CAAC,EAAA;IAER,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE;IAErB,GAAG,CAAC,IAAI,EAAE;AACV,IAAA,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC,eAAe;AACtC,IAAA,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC;AAEtC,IAAA,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC;AACrC,IAAA,GAAG,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK;AAC9B,IAAA,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS;AAChC,IAAA,GAAG,CAAC,IAAI,GAAG,eAAe;AAC1B,IAAA,GAAG,CAAC,SAAS,GAAG,QAAQ;AAExB,IAAA,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,IAAI,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI;IAC1D,MAAM,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI;AAEzC,IAAA,KAAK,IAAI,GAAG,GAAG,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE;QAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,OAAO,GAAG,IAAI,IAAI,IAAI;AACvC,QAAA,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK;YAAE;;QAGxB,GAAG,CAAC,SAAS,EAAE;AACf,QAAA,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC;QAC5C,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;QAClE,GAAG,CAAC,MAAM,EAAE;QACZ,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;;AAG/E,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE;YAC1B,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,GAAG,IAAI,IAAI,IAAI;AAC3D,YAAA,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK;gBAAE;YAC1B,GAAG,CAAC,SAAS,EAAE;AACf,YAAA,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC;YAC7C,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC;YAC/D,GAAG,CAAC,MAAM,EAAE;QACd;IACF;IAEA,GAAG,CAAC,OAAO,EAAE;AACf;AAEA;AACM,SAAU,iBAAiB,CAC/B,GAA6B,EAC7B,MAAc,EACd,MAAoB,EACpB,OAAO,GAAG,CAAC,EACX,IAAI,GAAG,CAAC,EAAA;IAER,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE;IAErB,GAAG,CAAC,IAAI,EAAE;AACV,IAAA,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC,eAAe;AACtC,IAAA,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC;AAEvC,IAAA,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC;AACrC,IAAA,GAAG,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK;AAC9B,IAAA,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS;AAChC,IAAA,GAAG,CAAC,IAAI,GAAG,eAAe;AAE1B,IAAA,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,IAAI,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI;IAC1D,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI;AAE1C,IAAA,KAAK,IAAI,GAAG,GAAG,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE;QAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,OAAO,GAAG,IAAI,IAAI,IAAI;AACvC,QAAA,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM;YAAE;QAEzB,GAAG,CAAC,SAAS,EAAE;AACf,QAAA,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QAC5C,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QAClE,GAAG,CAAC,MAAM,EAAE;;QAGZ,GAAG,CAAC,IAAI,EAAE;AACV,QAAA,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvD,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;AACxB,QAAA,GAAG,CAAC,SAAS,GAAG,QAAQ;AACxB,QAAA,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3C,GAAG,CAAC,OAAO,EAAE;IACf;IAEA,GAAG,CAAC,OAAO,EAAE;AACf;AAEA,SAAS,kBAAkB,CAAC,IAAY,EAAA;;AACtC,IAAA,MAAM,SAAS,GAAG,EAAE,GAAG,IAAI;IAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;AAC1D,IAAA,OAAO,MAAA,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,SAAS;AAC5D;AAEA;AAEA;AACM,SAAU,UAAU,CACxB,GAA6B,EAC7B,KAAa,EACb,MAAc,EACd,MAAoB,EACpB,OAAO,GAAG,CAAC,EACX,OAAO,GAAG,CAAC,EACX,IAAI,GAAG,CAAC,EAAA;IAER,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE;IAErB,GAAG,CAAC,IAAI,EAAE;IACV,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACvB,IAAA,GAAG,CAAC,SAAS,GAAG,CAAC;AAEjB,IAAA,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE;QACjC,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK;QAC7C,GAAG,CAAC,SAAS,EAAE;AAEf,QAAA,IAAI,KAAK,CAAC,WAAW,KAAK,YAAY,EAAE;AACtC,YAAA,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,GAAG,IAAI,IAAI,IAAI;AAClD,YAAA,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AAClC,YAAA,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QACxC;aAAO;AACL,YAAA,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,GAAG,IAAI,IAAI,IAAI;AAClD,YAAA,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;AAClC,YAAA,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,CAAC;QACzC;QACA,GAAG,CAAC,MAAM,EAAE;IACd;AAEA,IAAA,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;IACnB,GAAG,CAAC,OAAO,EAAE;AACf;AAEA;AAEA;SACgB,UAAU,CAAC,CAAS,EAAE,CAAS,EAAE,QAAgB,EAAA;IAC/D,OAAO;QACL,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,QAAQ;QACtC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,QAAQ;AACtC,QAAA,QAAQ,EAAE,IAAI;AACd,QAAA,QAAQ,EAAE,IAAI;KACf;AACH;AAEA;AACM,SAAU,YAAY,CAC1B,CAAS,EACT,CAAS,EACT,MAAe,EACf,YAAoB,EAAA;AAEpB,IAAA,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC;AAClB,IAAA,IAAI,QAAQ,GAAG,KAAK,EAAE,QAAQ,GAAG,KAAK;AAEtC,IAAA,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;AAC1B,QAAA,IAAI,KAAK,CAAC,WAAW,KAAK,UAAU,EAAE;AACpC,YAAA,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,YAAY,EAAE;AAChD,gBAAA,EAAE,GAAG,KAAK,CAAC,QAAQ;gBACnB,QAAQ,GAAG,IAAI;YACjB;QACF;aAAO;AACL,YAAA,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,YAAY,EAAE;AAChD,gBAAA,EAAE,GAAG,KAAK,CAAC,QAAQ;gBACnB,QAAQ,GAAG,IAAI;YACjB;QACF;IACF;AAEA,IAAA,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;AAC7C;AAEA;AACM,SAAU,WAAW,CAAC,CAAS,EAAE,CAAS,EAAA;IAC9C,OAAO;AACL,QAAA,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAChB,QAAA,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAChB,QAAA,QAAQ,EAAE,IAAI;AACd,QAAA,QAAQ,EAAE,IAAI;KACf;AACH;AAEA;AACM,SAAU,SAAS,CACvB,CAAS,EACT,CAAS,EACT,UAAsB,EACtB,YAA0B,EAAA;;IAG1B,IAAI,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC,YAAY,EAAE;AACrD,QAAA,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,YAAY,CAAC;AACtF,QAAA,IAAI,WAAW,CAAC,QAAQ,IAAI,WAAW,CAAC,QAAQ;AAAE,YAAA,OAAO,WAAW;IACtE;;IAGA,IAAI,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,UAAU,EAAE;QAC/C,OAAO,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC;IAC1C;AAEA,IAAA,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE;AACnD;AAEA;AAEA,IAAI,WAAW,GAAG,CAAC;AAEnB;SACgB,WAAW,CACzB,WAAsC,EACtC,QAAgB,EAChB,KAAc,EAAA;IAEd,OAAO;AACL,QAAA,EAAE,EAAE,CAAA,MAAA,EAAS,WAAW,EAAE,CAAA,CAAE;QAC5B,WAAW;QACX,QAAQ;AACR,QAAA,KAAK,EAAE,KAAK,KAAA,IAAA,IAAL,KAAK,KAAA,MAAA,GAAL,KAAK,GAAI,yBAAyB;AACzC,QAAA,MAAM,EAAE,KAAK;KACd;AACH;AAEA;AACM,SAAU,QAAQ,CAAC,MAAoB,EAAE,KAAY,EAAA;AACzD,IAAA,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE;AACzD;AAEA;AACM,SAAU,WAAW,CAAC,MAAoB,EAAE,OAAe,EAAA;IAC/D,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE;AAC7E;AAEA;AACM,SAAU,WAAW,CAAC,MAAoB,EAAA;IAC9C,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE;AAClC;;;;;;;;;;;;;;;"}

package/dist/cjs/core/historyVisual.js

@@ -0,0 +1,124 @@
+'use strict';
+
+var React = require('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)))));
+}
+
+exports.VisualHistoryPanel = VisualHistoryPanel;
+exports.useVisualHistory = useVisualHistory;
+//# sourceMappingURL=historyVisual.js.map

package/dist/cjs/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/cjs/core/i18n.js

@@ -0,0 +1,16 @@
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var React = require('react');
+
+const fallback = (_key, defaultValue) => defaultValue;
+const NiceI18nContext = React.createContext(fallback);
+const NiceI18nProvider = ({ t, children }) => (jsxRuntime.jsx(NiceI18nContext.Provider, { value: t, children: children }));
+function useNiceTranslation() {
+    const t = React.useContext(NiceI18nContext);
+    return { t };
+}
+
+exports.NiceI18nProvider = NiceI18nProvider;
+exports.useNiceTranslation = useNiceTranslation;
+//# sourceMappingURL=i18n.js.map

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

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