@nice2dev/ui-graphics 1.0.0

package/dist/cjs/core/integrations.js

@@ -0,0 +1,261 @@
+'use strict';
+
+/**
+ * integrations.ts — External service integrations for editors.
+ *
+ * Stock image pickers (Unsplash/Pexels), Adobe CC connector,
+ * Figma import/export, template library, and AI image generation.
+ */
+// ── Unsplash Integration ────────────────────────────────────────
+class UnsplashProvider {
+    constructor(accessKey) {
+        this.accessKey = accessKey;
+    }
+    async search(options) {
+        const { query, page = 1, perPage = 20, orientation } = options;
+        const params = new URLSearchParams({
+            query,
+            page: String(page),
+            per_page: String(perPage),
+            ...(orientation ? { orientation } : {}),
+        });
+        const response = await fetch(`https://api.unsplash.com/search/photos?${params}`, { headers: { Authorization: `Client-ID ${this.accessKey}` } });
+        if (!response.ok)
+            throw new Error(`Unsplash API error: ${response.status}`);
+        const data = await response.json();
+        return data.results.map((r) => ({
+            id: String(r.id),
+            url: String(r.urls.regular),
+            thumbnailUrl: String(r.urls.thumb),
+            author: String(r.user.name),
+            source: "unsplash",
+            width: Number(r.width),
+            height: Number(r.height),
+            description: r.description ? String(r.description) : undefined,
+        }));
+    }
+}
+// ── Pexels Integration ──────────────────────────────────────────
+class PexelsProvider {
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    async search(options) {
+        const { query, page = 1, perPage = 20, orientation } = options;
+        const params = new URLSearchParams({
+            query,
+            page: String(page),
+            per_page: String(perPage),
+            ...(orientation ? { orientation } : {}),
+        });
+        const response = await fetch(`https://api.pexels.com/v1/search?${params}`, { headers: { Authorization: this.apiKey } });
+        if (!response.ok)
+            throw new Error(`Pexels API error: ${response.status}`);
+        const data = await response.json();
+        return data.photos.map((p) => {
+            var _a;
+            return ({
+                id: String(p.id),
+                url: String(p.src.large),
+                thumbnailUrl: String(p.src.tiny),
+                author: String(p.photographer),
+                source: "pexels",
+                width: Number(p.width),
+                height: Number(p.height),
+                description: String((_a = p.alt) !== null && _a !== void 0 ? _a : ""),
+            });
+        });
+    }
+}
+class AdobeCCConnector {
+    constructor(config) {
+        this.config = config;
+    }
+    /** Get the OAuth authorization URL. */
+    getAuthUrl() {
+        const params = new URLSearchParams({
+            client_id: this.config.clientId,
+            redirect_uri: this.config.redirectUri,
+            scope: "openid,creative_sdk",
+            response_type: "code",
+        });
+        return `https://ims-na1.adobelogin.com/ims/authorize/v2?${params}`;
+    }
+    /** Import a file from Adobe CC Libraries. */
+    async importFromLibrary(accessToken, assetId) {
+        const response = await fetch(`https://cc-api-storage.adobe.io/assets/${encodeURIComponent(assetId)}/rendition`, { headers: { Authorization: `Bearer ${accessToken}`, "x-api-key": this.config.clientId } });
+        if (!response.ok)
+            throw new Error(`Adobe CC API error: ${response.status}`);
+        return response.blob();
+    }
+}
+// ── Figma Integration ───────────────────────────────────────────
+class FigmaConnector {
+    constructor(accessToken) {
+        this.accessToken = accessToken;
+    }
+    /** Import nodes from a Figma file. */
+    async importFile(fileKey, nodeIds) {
+        var _a;
+        const url = `https://api.figma.com/v1/files/${encodeURIComponent(fileKey)}` +
+            ((nodeIds === null || nodeIds === void 0 ? void 0 : nodeIds.length) ? `?ids=${nodeIds.map(encodeURIComponent).join(",")}` : "");
+        const response = await fetch(url, {
+            headers: { "X-Figma-Token": this.accessToken },
+        });
+        if (!response.ok)
+            throw new Error(`Figma API error: ${response.status}`);
+        const data = await response.json();
+        const nodes = this.extractNodes(data.document);
+        // Fetch images for nodes
+        const images = new Map();
+        if (nodes.length > 0) {
+            const ids = nodes.map((n) => n.id).join(",");
+            const imgResp = await fetch(`https://api.figma.com/v1/images/${encodeURIComponent(fileKey)}?ids=${ids}&format=svg`, { headers: { "X-Figma-Token": this.accessToken } });
+            if (imgResp.ok) {
+                const imgData = await imgResp.json();
+                for (const [id, imgUrl] of Object.entries((_a = imgData.images) !== null && _a !== void 0 ? _a : {})) {
+                    if (typeof imgUrl === "string") {
+                        const blobResp = await fetch(imgUrl);
+                        if (blobResp.ok)
+                            images.set(id, await blobResp.blob());
+                    }
+                }
+            }
+        }
+        return { nodes, images };
+    }
+    /** Export a design to Figma (via plugin API—returns Figma plugin code). */
+    exportToFigmaPlugin(svg, nodeName = "Nice2Dev Export") {
+        return `// Figma Plugin — paste into Figma Plugin Console
+const node = figma.createNodeFromSvg(\`${svg.replace(/`/g, "\\`")}\`);
+node.name = "${nodeName}";
+figma.currentPage.appendChild(node);
+figma.viewport.scrollAndZoomIntoView([node]);
+figma.closePlugin("Imported from Nice2Dev");`;
+    }
+    extractNodes(document) {
+        const nodes = [];
+        const walk = (node) => {
+            var _a, _b, _c;
+            if (node.type && node.id) {
+                const abs = node.absoluteBoundingBox;
+                nodes.push({
+                    id: String(node.id),
+                    name: String((_a = node.name) !== null && _a !== void 0 ? _a : ""),
+                    type: String(node.type),
+                    width: (_b = abs === null || abs === void 0 ? void 0 : abs.width) !== null && _b !== void 0 ? _b : 0,
+                    height: (_c = abs === null || abs === void 0 ? void 0 : abs.height) !== null && _c !== void 0 ? _c : 0,
+                });
+            }
+            const children = node.children;
+            if (Array.isArray(children))
+                children.forEach(walk);
+        };
+        walk(document);
+        return nodes;
+    }
+}
+// ── Template Library ────────────────────────────────────────────
+class TemplateLibrary {
+    constructor() {
+        this.templates = [];
+    }
+    /** Register a template. */
+    register(template) {
+        this.templates.push(template);
+    }
+    /** Get all templates. */
+    getAll() {
+        return [...this.templates];
+    }
+    /** Get templates by category. */
+    getByCategory(category) {
+        return this.templates.filter((t) => t.category === category);
+    }
+    /** Get all categories. */
+    getCategories() {
+        return [...new Set(this.templates.map((t) => t.category))];
+    }
+    /** Search templates by name. */
+    search(query) {
+        const lower = query.toLowerCase();
+        return this.templates.filter((t) => t.name.toLowerCase().includes(lower));
+    }
+}
+// ── AI Image Generation ─────────────────────────────────────────
+async function generateAIImage(options) {
+    var _a, _b;
+    const { prompt, width = 512, height = 512, style = "realistic", provider, apiKey, apiUrl } = options;
+    if (!apiKey)
+        throw new Error("API key is required for AI image generation");
+    let url;
+    let body;
+    const headers = { "Content-Type": "application/json" };
+    switch (provider) {
+        case "openai":
+            url = "https://api.openai.com/v1/images/generations";
+            headers["Authorization"] = `Bearer ${apiKey}`;
+            body = JSON.stringify({
+                model: "dall-e-3",
+                prompt: `${prompt} (style: ${style})`,
+                n: 1,
+                size: `${width}x${height}`,
+                response_format: "url",
+            });
+            break;
+        case "stability":
+            url = "https://api.stability.ai/v1/generation/stable-diffusion-xl-1024-v1-0/text-to-image";
+            headers["Authorization"] = `Bearer ${apiKey}`;
+            body = JSON.stringify({
+                text_prompts: [{ text: prompt, weight: 1 }],
+                cfg_scale: 7,
+                width, height,
+                samples: 1,
+                steps: 30,
+                style_preset: style === "pixel-art" ? "pixel-art" : style === "vector" ? "line-art" : undefined,
+            });
+            break;
+        case "custom":
+            if (!apiUrl)
+                throw new Error("Custom API URL is required");
+            url = apiUrl;
+            headers["Authorization"] = `Bearer ${apiKey}`;
+            body = JSON.stringify({ prompt, width, height, style });
+            break;
+        default:
+            throw new Error(`Unknown AI provider: ${provider}`);
+    }
+    const response = await fetch(url, { method: "POST", headers, body });
+    if (!response.ok)
+        throw new Error(`AI generation failed: ${response.status}`);
+    const data = await response.json();
+    // Extract image URL based on provider
+    let imageUrl;
+    if (provider === "openai") {
+        imageUrl = data.data[0].url;
+    }
+    else if (provider === "stability") {
+        imageUrl = `data:image/png;base64,${data.artifacts[0].base64}`;
+    }
+    else {
+        imageUrl = (_b = (_a = data.url) !== null && _a !== void 0 ? _a : data.image) !== null && _b !== void 0 ? _b : "";
+    }
+    const imgResp = imageUrl.startsWith("data:") ? null : await fetch(imageUrl);
+    const imageBlob = imgResp ? await imgResp.blob() : base64ToBlob(imageUrl.split(",")[1], "image/png");
+    return { imageUrl, imageBlob, metadata: data };
+}
+function base64ToBlob(base64, mimeType) {
+    const bytes = atob(base64);
+    const arr = new Uint8Array(bytes.length);
+    for (let i = 0; i < bytes.length; i++)
+        arr[i] = bytes.charCodeAt(i);
+    return new Blob([arr], { type: mimeType });
+}
+
+exports.AdobeCCConnector = AdobeCCConnector;
+exports.FigmaConnector = FigmaConnector;
+exports.PexelsProvider = PexelsProvider;
+exports.TemplateLibrary = TemplateLibrary;
+exports.UnsplashProvider = UnsplashProvider;
+exports.generateAIImage = generateAIImage;
+//# sourceMappingURL=integrations.js.map

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

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

package/dist/cjs/core/minimap.js

@@ -0,0 +1,142 @@
+'use strict';
+
+var React = require('react');
+
+/**
+ * minimap.ts — Zoom navigator / minimap component for editors.
+ *
+ * Provides a small overview of the full canvas with a viewport indicator
+ * that can be dragged to navigate around the document.
+ */
+// ── Component ───────────────────────────────────────────────────
+/** Zoom navigator / minimap showing a scaled-down view of the full document. */
+const Minimap = ({ canvasRef, imageDataUrl, documentWidth, documentHeight, viewport, onViewportChange, config = {}, className = "", }) => {
+    const { width: mapW = 160, height: mapH = 120, visible = true, position = "bottom-right", opacity = 0.85, } = config;
+    const minimapCanvasRef = React.useRef(null);
+    const isDragging = React.useRef(false);
+    const scaleX = mapW / (documentWidth || 1);
+    const scaleY = mapH / (documentHeight || 1);
+    const scale = Math.min(scaleX, scaleY);
+    // Draw minimap
+    React.useEffect(() => {
+        if (!visible)
+            return;
+        const canvas = minimapCanvasRef.current;
+        if (!canvas)
+            return;
+        const ctx = canvas.getContext("2d");
+        if (!ctx)
+            return;
+        ctx.clearRect(0, 0, mapW, mapH);
+        // Draw background
+        ctx.fillStyle = "#1a1a2e";
+        ctx.fillRect(0, 0, mapW, mapH);
+        // Draw document content
+        if (canvasRef === null || canvasRef === void 0 ? void 0 : canvasRef.current) {
+            const sw = documentWidth * scale;
+            const sh = documentHeight * scale;
+            ctx.drawImage(canvasRef.current, 0, 0, documentWidth, documentHeight, 0, 0, sw, sh);
+        }
+        else if (imageDataUrl) {
+            const img = new Image();
+            img.onload = () => {
+                const sw = documentWidth * scale;
+                const sh = documentHeight * scale;
+                ctx.drawImage(img, 0, 0, sw, sh);
+                drawViewport(ctx);
+            };
+            img.src = imageDataUrl;
+            return;
+        }
+        drawViewport(ctx);
+    }, [visible, canvasRef, imageDataUrl, viewport, documentWidth, documentHeight, scale, mapW, mapH]);
+    function drawViewport(ctx) {
+        // Draw viewport rect
+        const vx = viewport.x * scale;
+        const vy = viewport.y * scale;
+        const vw = viewport.width * scale;
+        const vh = viewport.height * scale;
+        ctx.strokeStyle = "rgba(59, 130, 246, 0.8)";
+        ctx.lineWidth = 1.5;
+        ctx.strokeRect(vx, vy, vw, vh);
+        // Dim areas outside viewport
+        ctx.fillStyle = "rgba(0, 0, 0, 0.3)";
+        // Top
+        ctx.fillRect(0, 0, mapW, vy);
+        // Bottom
+        ctx.fillRect(0, vy + vh, mapW, mapH - vy - vh);
+        // Left
+        ctx.fillRect(0, vy, vx, vh);
+        // Right
+        ctx.fillRect(vx + vw, vy, mapW - vx - vw, vh);
+    }
+    const handlePointerDown = (e) => {
+        isDragging.current = true;
+        updateViewportFromPointer(e);
+        e.target.setPointerCapture(e.pointerId);
+    };
+    const handlePointerMove = (e) => {
+        if (!isDragging.current)
+            return;
+        updateViewportFromPointer(e);
+    };
+    const handlePointerUp = () => {
+        isDragging.current = false;
+    };
+    function updateViewportFromPointer(e) {
+        var _a;
+        const rect = (_a = minimapCanvasRef.current) === null || _a === void 0 ? void 0 : _a.getBoundingClientRect();
+        if (!rect || !onViewportChange)
+            return;
+        const mx = e.clientX - rect.left;
+        const my = e.clientY - rect.top;
+        const docX = mx / scale - viewport.width / 2;
+        const docY = my / scale - viewport.height / 2;
+        onViewportChange({
+            x: Math.max(0, Math.min(documentWidth - viewport.width, docX)),
+            y: Math.max(0, Math.min(documentHeight - viewport.height, docY)),
+            width: viewport.width,
+            height: viewport.height,
+        });
+    }
+    if (!visible)
+        return null;
+    const positionStyles = {
+        "top-left": { top: 8, left: 8 },
+        "top-right": { top: 8, right: 8 },
+        "bottom-left": { bottom: 8, left: 8 },
+        "bottom-right": { bottom: 8, right: 8 },
+    };
+    return React.createElement("div", {
+        className: `nice-minimap ${className}`,
+        style: {
+            position: "absolute",
+            ...positionStyles[position],
+            opacity,
+            borderRadius: 4,
+            overflow: "hidden",
+            border: "1px solid rgba(255,255,255,0.2)",
+            cursor: "crosshair",
+            zIndex: 100,
+        },
+    }, React.createElement("canvas", {
+        ref: minimapCanvasRef,
+        width: mapW,
+        height: mapH,
+        onPointerDown: handlePointerDown,
+        onPointerMove: handlePointerMove,
+        onPointerUp: handlePointerUp,
+        style: { display: "block" },
+    }));
+};
+// ── Hook ────────────────────────────────────────────────────────
+/** Hook for managing minimap visibility state. */
+function useMinimap(initialVisible = true) {
+    const [visible, setVisible] = React.useState(initialVisible);
+    const toggle = React.useCallback(() => setVisible((v) => !v), []);
+    return { visible, setVisible, toggle };
+}
+
+exports.Minimap = Minimap;
+exports.useMinimap = useMinimap;
+//# sourceMappingURL=minimap.js.map

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

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

package/dist/cjs/core/plugins.js

@@ -0,0 +1,129 @@
+'use strict';
+
+var React = require('react');
+
+/**
+ * plugins.ts — Plugin system for @nice2dev/ui-graphics editors.
+ *
+ * Allows third-party extensions to register custom tools, filters,
+ * export formats, and UI panels for any editor.
+ */
+// ── Plugin Registry ─────────────────────────────────────────────
+class PluginRegistryImpl {
+    constructor() {
+        this.plugins = new Map();
+        this.listeners = new Map();
+    }
+    /** Register a plugin. Calls onInit if defined. */
+    register(plugin) {
+        var _a;
+        if (this.plugins.has(plugin.id)) {
+            console.warn(`[PluginRegistry] Plugin "${plugin.id}" already registered, replacing.`);
+            this.unregister(plugin.id);
+        }
+        this.plugins.set(plugin.id, plugin);
+        (_a = plugin.onInit) === null || _a === void 0 ? void 0 : _a.call(plugin);
+        this.emit("register", plugin);
+    }
+    /** Unregister a plugin. Calls onDestroy if defined. */
+    unregister(pluginId) {
+        var _a;
+        const plugin = this.plugins.get(pluginId);
+        if (plugin) {
+            (_a = plugin.onDestroy) === null || _a === void 0 ? void 0 : _a.call(plugin);
+            this.plugins.delete(pluginId);
+            this.emit("unregister", plugin);
+        }
+    }
+    /** Get a registered plugin by ID. */
+    get(pluginId) {
+        return this.plugins.get(pluginId);
+    }
+    /** Get all registered plugins. */
+    getAll() {
+        return Array.from(this.plugins.values());
+    }
+    /** Get plugins for a specific editor type. */
+    getForEditor(editor) {
+        return this.getAll().filter((p) => !p.editors || p.editors.length === 0 || p.editors.includes(editor));
+    }
+    /** Get all tools from plugins for a specific editor. */
+    getTools(editor) {
+        return this.getForEditor(editor).flatMap((p) => { var _a; return (_a = p.tools) !== null && _a !== void 0 ? _a : []; });
+    }
+    /** Get all filters from plugins for a specific editor. */
+    getFilters(editor) {
+        return this.getForEditor(editor).flatMap((p) => { var _a; return (_a = p.filters) !== null && _a !== void 0 ? _a : []; });
+    }
+    /** Get all exporters from plugins for a specific editor. */
+    getExporters(editor) {
+        return this.getForEditor(editor).flatMap((p) => { var _a; return (_a = p.exporters) !== null && _a !== void 0 ? _a : []; });
+    }
+    /** Get all panels from plugins for a specific editor. */
+    getPanels(editor) {
+        return this.getForEditor(editor).flatMap((p) => { var _a; return (_a = p.panels) !== null && _a !== void 0 ? _a : []; });
+    }
+    /** Get all menu actions from plugins for a specific editor. */
+    getMenuActions(editor) {
+        return this.getForEditor(editor).flatMap((p) => { var _a; return (_a = p.menuActions) !== null && _a !== void 0 ? _a : []; });
+    }
+    /** Subscribe to registry events. */
+    on(event, handler) {
+        if (!this.listeners.has(event))
+            this.listeners.set(event, new Set());
+        this.listeners.get(event).add(handler);
+        return () => { var _a; return (_a = this.listeners.get(event)) === null || _a === void 0 ? void 0 : _a.delete(handler); };
+    }
+    emit(event, plugin) {
+        var _a;
+        (_a = this.listeners.get(event)) === null || _a === void 0 ? void 0 : _a.forEach((h) => h(plugin));
+    }
+    /** Clear all plugins. */
+    clear() {
+        var _a;
+        for (const plugin of this.plugins.values()) {
+            (_a = plugin.onDestroy) === null || _a === void 0 ? void 0 : _a.call(plugin);
+        }
+        this.plugins.clear();
+    }
+}
+/** Global plugin registry singleton. */
+const PluginRegistry = new PluginRegistryImpl();
+// ── React Hook ──────────────────────────────────────────────────
+/** React hook that returns plugins for a specific editor, re-renders on changes. */
+function usePlugins(editor) {
+    const [, setTick] = React.useState(0);
+    React.useEffect(() => {
+        const unsub1 = PluginRegistry.on("register", () => setTick((t) => t + 1));
+        const unsub2 = PluginRegistry.on("unregister", () => setTick((t) => t + 1));
+        return () => { unsub1(); unsub2(); };
+    }, []);
+    return {
+        plugins: PluginRegistry.getForEditor(editor),
+        tools: PluginRegistry.getTools(editor),
+        filters: PluginRegistry.getFilters(editor),
+        exporters: PluginRegistry.getExporters(editor),
+        panels: PluginRegistry.getPanels(editor),
+        menuActions: PluginRegistry.getMenuActions(editor),
+    };
+}
+// ── Plugin Context (React) ──────────────────────────────────────
+const PluginContext = React.createContext(PluginRegistry);
+const NicePluginProvider = ({ plugins, children }) => {
+    React.useEffect(() => {
+        if (plugins) {
+            plugins.forEach((p) => PluginRegistry.register(p));
+            return () => plugins.forEach((p) => PluginRegistry.unregister(p.id));
+        }
+    }, [plugins]);
+    return React.createElement(PluginContext.Provider, { value: PluginRegistry }, children);
+};
+function usePluginRegistry() {
+    return React.useContext(PluginContext);
+}
+
+exports.NicePluginProvider = NicePluginProvider;
+exports.PluginRegistry = PluginRegistry;
+exports.usePluginRegistry = usePluginRegistry;
+exports.usePlugins = usePlugins;
+//# sourceMappingURL=plugins.js.map

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

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