@nice2dev/icons 1.3.15 → 1.3.17

package/dist/esm/figmaSync.js

@@ -1,338 +1,260 @@
-/**
- * @file figmaSync.ts
- * @description Bidirectional sync between Figma design files and the codebase.
- *
- * - Sync changes from Figma → codebase (import new/updated icons)
- * - Push code changes → Figma (export updated icons to Figma)
- * - Version tracking (track which version of icon is in Figma vs code)
- * - Conflict detection (detect when both sides changed)
- *
- * This module provides the data structures and logic for syncing.
- * The actual Figma API calls are delegated to callbacks so this
- * module can work with any Figma plugin or REST API implementation.
- *
- * @example
- * ```tsx
- * const manager = createFigmaSyncManager({
- *   fetchFromFigma: async () => figmaIcons,
- *   pushToFigma: async (icons) => { ... },
- *   getLocalIcons: () => localIcons,
- *   onConflict: (diff) => 'prefer-local',
- * });
- *
- * // Pull changes from Figma
- * const result = await manager.pull();
- *
- * // Push changes to Figma
- * const pushResult = await manager.push();
- *
- * // Full bidirectional sync
- * const syncResult = await manager.sync();
- * ```
- */
-/* ────────────────────────────────────────────────────────────────────────────
-   HASH UTILITY
-───────────────────────────────────────────────────────────────────────────── */
-/**
- * Simple content hash for change detection.
- * Uses a deterministic djb2-like hash for speed (no crypto needed).
- */
 function hashContent(content) {
-    let hash = 5381;
-    for (let i = 0; i < content.length; i++) {
-        hash = ((hash << 5) + hash + content.charCodeAt(i)) & 0xffffffff;
-    }
-    return (hash >>> 0).toString(36);
+  let hash = 5381;
+  for (let i = 0; i < content.length; i++) {
+    hash = (hash << 5) + hash + content.charCodeAt(i) & 4294967295;
+  }
+  return (hash >>> 0).toString(36);
 }
-/** Generate a hash for an icon's content. */
 function hashIcon(icon) {
-    var _a;
-    return hashContent(icon.svgPaths.join('|') + icon.viewBox + ((_a = icon.variant) !== null && _a !== void 0 ? _a : ''));
+  return hashContent(icon.svgPaths.join("|") + icon.viewBox + (icon.variant ?? ""));
 }
-/* ────────────────────────────────────────────────────────────────────────────
-   DIFF ENGINE
-───────────────────────────────────────────────────────────────────────────── */
-/**
- * Computes a diff between two sets of tracked icons.
- *
- * @param localIcons - Icons in the codebase
- * @param figmaIcons - Icons in Figma
- * @param syncState - Previously synced hashes (for conflict detection)
- * @returns Array of diffs
- */
 function diffIconSets(localIcons, figmaIcons, syncState) {
-    const diffs = [];
-    const localMap = new Map(localIcons.map((i) => [i.name, i]));
-    const figmaMap = new Map(figmaIcons.map((i) => [i.name, i]));
-    const allNames = new Set([...localMap.keys(), ...figmaMap.keys()]);
-    for (const name of allNames) {
-        const local = localMap.get(name);
-        const figma = figmaMap.get(name);
-        const lastHash = syncState === null || syncState === void 0 ? void 0 : syncState.get(name);
-        if (local && figma) {
-            const localHash = hashIcon(local);
-            const figmaHash = hashIcon(figma);
-            if (localHash === figmaHash) {
-                diffs.push({
-                    name,
-                    status: 'unchanged',
-                    direction: 'none',
-                    local,
-                    figma,
-                    lastSyncedHash: lastHash,
-                });
-            }
-            else if (lastHash) {
-                // Both sides changed since last sync
-                const localChanged = localHash !== lastHash;
-                const figmaChanged = figmaHash !== lastHash;
-                if (localChanged && figmaChanged) {
-                    diffs.push({
-                        name,
-                        status: 'conflict',
-                        direction: 'both',
-                        local,
-                        figma,
-                        lastSyncedHash: lastHash,
-                    });
-                }
-                else if (localChanged) {
-                    diffs.push({
-                        name,
-                        status: 'modified',
-                        direction: 'code-to-figma',
-                        local,
-                        figma,
-                        lastSyncedHash: lastHash,
-                    });
-                }
-                else {
-                    diffs.push({
-                        name,
-                        status: 'modified',
-                        direction: 'figma-to-code',
-                        local,
-                        figma,
-                        lastSyncedHash: lastHash,
-                    });
-                }
-            }
-            else {
-                // No previous sync state — treat as conflict if different
-                diffs.push({ name, status: 'conflict', direction: 'both', local, figma });
-            }
-        }
-        else if (figma && !local) {
-            diffs.push({ name, status: 'added', direction: 'figma-to-code', figma });
-        }
-        else if (local && !figma) {
-            diffs.push({ name, status: 'added', direction: 'code-to-figma', local });
+  const diffs = [];
+  const localMap = new Map(localIcons.map((i) => [i.name, i]));
+  const figmaMap = new Map(figmaIcons.map((i) => [i.name, i]));
+  const allNames = /* @__PURE__ */ new Set([...localMap.keys(), ...figmaMap.keys()]);
+  for (const name of allNames) {
+    const local = localMap.get(name);
+    const figma = figmaMap.get(name);
+    const lastHash = syncState?.get(name);
+    if (local && figma) {
+      const localHash = hashIcon(local);
+      const figmaHash = hashIcon(figma);
+      if (localHash === figmaHash) {
+        diffs.push({
+          name,
+          status: "unchanged",
+          direction: "none",
+          local,
+          figma,
+          lastSyncedHash: lastHash
+        });
+      } else if (lastHash) {
+        const localChanged = localHash !== lastHash;
+        const figmaChanged = figmaHash !== lastHash;
+        if (localChanged && figmaChanged) {
+          diffs.push({
+            name,
+            status: "conflict",
+            direction: "both",
+            local,
+            figma,
+            lastSyncedHash: lastHash
+          });
+        } else if (localChanged) {
+          diffs.push({
+            name,
+            status: "modified",
+            direction: "code-to-figma",
+            local,
+            figma,
+            lastSyncedHash: lastHash
+          });
+        } else {
+          diffs.push({
+            name,
+            status: "modified",
+            direction: "figma-to-code",
+            local,
+            figma,
+            lastSyncedHash: lastHash
+          });
         }
+      } else {
+        diffs.push({ name, status: "conflict", direction: "both", local, figma });
+      }
+    } else if (figma && !local) {
+      diffs.push({ name, status: "added", direction: "figma-to-code", figma });
+    } else if (local && !figma) {
+      diffs.push({ name, status: "added", direction: "code-to-figma", local });
     }
-    return diffs;
+  }
+  return diffs;
 }
-/* ────────────────────────────────────────────────────────────────────────────
-   SYNC MANAGER
-───────────────────────────────────────────────────────────────────────────── */
-const STORAGE_KEY = 'ntd-figma-sync-state';
-/**
- * Creates a FigmaSyncManager for bidirectional icon synchronization.
- */
+const STORAGE_KEY = "ntd-figma-sync-state";
 function createFigmaSyncManager(config) {
-    return new FigmaSyncManager(config);
+  return new FigmaSyncManager(config);
 }
 class FigmaSyncManager {
-    constructor(config) {
-        this.config = config;
-        this.syncState = this.loadSyncState();
-    }
-    /** Pull changes from Figma → codebase. */
-    async pull() {
-        var _a, _b, _c;
-        const start = performance.now();
-        const figmaIcons = await this.config.fetchFromFigma();
-        const localIcons = this.config.getLocalIcons();
-        const diffs = diffIconSets(localIcons, figmaIcons, this.syncState);
-        const pulled = [];
-        const conflicts = [];
-        const skipped = [];
-        for (const diff of diffs) {
-            if (diff.status === 'unchanged') {
-                continue;
-            }
-            if (diff.status === 'conflict') {
-                const resolution = (_c = (_b = (_a = this.config).onConflict) === null || _b === void 0 ? void 0 : _b.call(_a, diff)) !== null && _c !== void 0 ? _c : 'skip';
-                if (resolution === 'prefer-figma') {
-                    pulled.push(diff);
-                    this.updateSyncHash(diff.name, diff.figma);
-                }
-                else if (resolution === 'skip') {
-                    skipped.push(diff);
-                }
-                else {
-                    // prefer-local — no pull needed
-                    skipped.push(diff);
-                }
-                conflicts.push(diff);
-            }
-            else if (diff.direction === 'figma-to-code') {
-                pulled.push(diff);
-                if (diff.figma) {
-                    this.updateSyncHash(diff.name, diff.figma);
-                }
-            }
+  constructor(config) {
+    this.config = config;
+    this.syncState = this.loadSyncState();
+  }
+  /** Pull changes from Figma → codebase. */
+  async pull() {
+    const start = performance.now();
+    const figmaIcons = await this.config.fetchFromFigma();
+    const localIcons = this.config.getLocalIcons();
+    const diffs = diffIconSets(localIcons, figmaIcons, this.syncState);
+    const pulled = [];
+    const conflicts = [];
+    const skipped = [];
+    for (const diff of diffs) {
+      if (diff.status === "unchanged") {
+        continue;
+      }
+      if (diff.status === "conflict") {
+        const resolution = this.config.onConflict?.(diff) ?? "skip";
+        if (resolution === "prefer-figma") {
+          pulled.push(diff);
+          this.updateSyncHash(diff.name, diff.figma);
+        } else if (resolution === "skip") {
+          skipped.push(diff);
+        } else {
+          skipped.push(diff);
         }
-        this.saveSyncState();
-        return {
-            pulled,
-            pushed: [],
-            conflicts,
-            skipped,
-            duration: performance.now() - start,
-            timestamp: Date.now(),
-        };
-    }
-    /** Push changes from codebase → Figma. */
-    async push() {
-        var _a, _b, _c;
-        const start = performance.now();
-        const figmaIcons = await this.config.fetchFromFigma();
-        const localIcons = this.config.getLocalIcons();
-        const diffs = diffIconSets(localIcons, figmaIcons, this.syncState);
-        const pushed = [];
-        const conflicts = [];
-        const skipped = [];
-        const toPush = [];
-        for (const diff of diffs) {
-            if (diff.status === 'unchanged') {
-                continue;
-            }
-            if (diff.status === 'conflict') {
-                const resolution = (_c = (_b = (_a = this.config).onConflict) === null || _b === void 0 ? void 0 : _b.call(_a, diff)) !== null && _c !== void 0 ? _c : 'skip';
-                if (resolution === 'prefer-local') {
-                    toPush.push(diff.local);
-                    pushed.push(diff);
-                    this.updateSyncHash(diff.name, diff.local);
-                }
-                else if (resolution === 'skip') {
-                    skipped.push(diff);
-                }
-                conflicts.push(diff);
-            }
-            else if (diff.direction === 'code-to-figma' && diff.local) {
-                toPush.push(diff.local);
-                pushed.push(diff);
-                this.updateSyncHash(diff.name, diff.local);
-            }
-        }
-        if (toPush.length > 0) {
-            await this.config.pushToFigma(toPush);
+        conflicts.push(diff);
+      } else if (diff.direction === "figma-to-code") {
+        pulled.push(diff);
+        if (diff.figma) {
+          this.updateSyncHash(diff.name, diff.figma);
         }
-        this.saveSyncState();
-        return {
-            pulled: [],
-            pushed,
-            conflicts,
-            skipped,
-            duration: performance.now() - start,
-            timestamp: Date.now(),
-        };
+      }
     }
-    /** Full bidirectional sync. */
-    async sync() {
-        var _a, _b, _c;
-        const start = performance.now();
-        const figmaIcons = await this.config.fetchFromFigma();
-        const localIcons = this.config.getLocalIcons();
-        const diffs = diffIconSets(localIcons, figmaIcons, this.syncState);
-        const pulled = [];
-        const pushed = [];
-        const conflicts = [];
-        const skipped = [];
-        const toPush = [];
-        for (const diff of diffs) {
-            if (diff.status === 'unchanged') {
-                continue;
-            }
-            if (diff.status === 'conflict') {
-                const resolution = (_c = (_b = (_a = this.config).onConflict) === null || _b === void 0 ? void 0 : _b.call(_a, diff)) !== null && _c !== void 0 ? _c : 'skip';
-                conflicts.push(diff);
-                if (resolution === 'prefer-local' && diff.local) {
-                    toPush.push(diff.local);
-                    pushed.push(diff);
-                    this.updateSyncHash(diff.name, diff.local);
-                }
-                else if (resolution === 'prefer-figma' && diff.figma) {
-                    pulled.push(diff);
-                    this.updateSyncHash(diff.name, diff.figma);
-                }
-                else {
-                    skipped.push(diff);
-                }
-            }
-            else if (diff.direction === 'figma-to-code') {
-                pulled.push(diff);
-                if (diff.figma) {
-                    this.updateSyncHash(diff.name, diff.figma);
-                }
-            }
-            else if (diff.direction === 'code-to-figma' && diff.local) {
-                toPush.push(diff.local);
-                pushed.push(diff);
-                this.updateSyncHash(diff.name, diff.local);
-            }
-        }
-        if (toPush.length > 0) {
-            await this.config.pushToFigma(toPush);
+    this.saveSyncState();
+    return {
+      pulled,
+      pushed: [],
+      conflicts,
+      skipped,
+      duration: performance.now() - start,
+      timestamp: Date.now()
+    };
+  }
+  /** Push changes from codebase → Figma. */
+  async push() {
+    const start = performance.now();
+    const figmaIcons = await this.config.fetchFromFigma();
+    const localIcons = this.config.getLocalIcons();
+    const diffs = diffIconSets(localIcons, figmaIcons, this.syncState);
+    const pushed = [];
+    const conflicts = [];
+    const skipped = [];
+    const toPush = [];
+    for (const diff of diffs) {
+      if (diff.status === "unchanged") {
+        continue;
+      }
+      if (diff.status === "conflict") {
+        const resolution = this.config.onConflict?.(diff) ?? "skip";
+        if (resolution === "prefer-local") {
+          toPush.push(diff.local);
+          pushed.push(diff);
+          this.updateSyncHash(diff.name, diff.local);
+        } else if (resolution === "skip") {
+          skipped.push(diff);
         }
-        this.saveSyncState();
-        return {
-            pulled,
-            pushed,
-            conflicts,
-            skipped,
-            duration: performance.now() - start,
-            timestamp: Date.now(),
-        };
+        conflicts.push(diff);
+      } else if (diff.direction === "code-to-figma" && diff.local) {
+        toPush.push(diff.local);
+        pushed.push(diff);
+        this.updateSyncHash(diff.name, diff.local);
+      }
     }
-    /** Get current diff without making changes. */
-    async diff() {
-        const figmaIcons = await this.config.fetchFromFigma();
-        const localIcons = this.config.getLocalIcons();
-        return diffIconSets(localIcons, figmaIcons, this.syncState);
+    if (toPush.length > 0) {
+      await this.config.pushToFigma(toPush);
     }
-    /** Get sync history from storage. */
-    getSyncState() {
-        return new Map(this.syncState);
+    this.saveSyncState();
+    return {
+      pulled: [],
+      pushed,
+      conflicts,
+      skipped,
+      duration: performance.now() - start,
+      timestamp: Date.now()
+    };
+  }
+  /** Full bidirectional sync. */
+  async sync() {
+    const start = performance.now();
+    const figmaIcons = await this.config.fetchFromFigma();
+    const localIcons = this.config.getLocalIcons();
+    const diffs = diffIconSets(localIcons, figmaIcons, this.syncState);
+    const pulled = [];
+    const pushed = [];
+    const conflicts = [];
+    const skipped = [];
+    const toPush = [];
+    for (const diff of diffs) {
+      if (diff.status === "unchanged") {
+        continue;
+      }
+      if (diff.status === "conflict") {
+        const resolution = this.config.onConflict?.(diff) ?? "skip";
+        conflicts.push(diff);
+        if (resolution === "prefer-local" && diff.local) {
+          toPush.push(diff.local);
+          pushed.push(diff);
+          this.updateSyncHash(diff.name, diff.local);
+        } else if (resolution === "prefer-figma" && diff.figma) {
+          pulled.push(diff);
+          this.updateSyncHash(diff.name, diff.figma);
+        } else {
+          skipped.push(diff);
+        }
+      } else if (diff.direction === "figma-to-code") {
+        pulled.push(diff);
+        if (diff.figma) {
+          this.updateSyncHash(diff.name, diff.figma);
+        }
+      } else if (diff.direction === "code-to-figma" && diff.local) {
+        toPush.push(diff.local);
+        pushed.push(diff);
+        this.updateSyncHash(diff.name, diff.local);
+      }
     }
-    /** Reset sync state (forces full re-sync on next operation). */
-    resetSyncState() {
-        this.syncState.clear();
-        this.saveSyncState();
+    if (toPush.length > 0) {
+      await this.config.pushToFigma(toPush);
     }
-    // ── Private helpers ──
-    updateSyncHash(name, icon) {
-        this.syncState.set(name, hashIcon(icon));
+    this.saveSyncState();
+    return {
+      pulled,
+      pushed,
+      conflicts,
+      skipped,
+      duration: performance.now() - start,
+      timestamp: Date.now()
+    };
+  }
+  /** Get current diff without making changes. */
+  async diff() {
+    const figmaIcons = await this.config.fetchFromFigma();
+    const localIcons = this.config.getLocalIcons();
+    return diffIconSets(localIcons, figmaIcons, this.syncState);
+  }
+  /** Get sync history from storage. */
+  getSyncState() {
+    return new Map(this.syncState);
+  }
+  /** Reset sync state (forces full re-sync on next operation). */
+  resetSyncState() {
+    this.syncState.clear();
+    this.saveSyncState();
+  }
+  // ── Private helpers ──
+  updateSyncHash(name, icon) {
+    this.syncState.set(name, hashIcon(icon));
+  }
+  loadSyncState() {
+    const raw = this.config.storage?.get(STORAGE_KEY);
+    if (!raw) {
+      return /* @__PURE__ */ new Map();
     }
-    loadSyncState() {
-        var _a;
-        const raw = (_a = this.config.storage) === null || _a === void 0 ? void 0 : _a.get(STORAGE_KEY);
-        if (!raw) {
-            return new Map();
-        }
-        try {
-            return new Map(Object.entries(JSON.parse(raw)));
-        }
-        catch (_b) {
-            return new Map();
-        }
+    try {
+      return new Map(Object.entries(JSON.parse(raw)));
+    } catch {
+      return /* @__PURE__ */ new Map();
     }
-    saveSyncState() {
-        if (!this.config.storage) {
-            return;
-        }
-        this.config.storage.set(STORAGE_KEY, JSON.stringify(Object.fromEntries(this.syncState)));
+  }
+  saveSyncState() {
+    if (!this.config.storage) {
+      return;
     }
+    this.config.storage.set(STORAGE_KEY, JSON.stringify(Object.fromEntries(this.syncState)));
+  }
 }
-
-export { FigmaSyncManager, createFigmaSyncManager, diffIconSets };
+export {
+  FigmaSyncManager,
+  createFigmaSyncManager,
+  diffIconSets
+};