figma-metadata-extractor 1.0.4 → 1.0.5

package/dist/index.cjs

@@ -1433,7 +1433,7 @@ async function getFigmaMetadata(figmaUrl, options = {}) {
           imageNodes,
           { pngScale: imageFormat === "png" ? pngScale : void 0 }
         );
-        result.nodes = enrichNodesWithImages(nodes, imageAssets, downloadResults, useRelativePaths);
+        result.nodes = enrichNodesWithImages(nodes, imageAssets, downloadResults, useRelativePaths, localPath);
         Logger.log(`Successfully downloaded and enriched ${downloadResults.length} images`);
       }
     }
@@ -1557,7 +1557,7 @@ function hasImageFill(node, globalVars) {
   }
   return fillData.some((fill) => fill?.type === "IMAGE");
 }
-function enrichNodesWithImages(nodes, imageAssets, downloadResults, useRelativePaths = true) {
+function enrichNodesWithImages(nodes, imageAssets, downloadResults, useRelativePaths = true, localPath) {
   const imageMap = /* @__PURE__ */ new Map();
   imageAssets.forEach((asset, index) => {
     const result = downloadResults[index];
@@ -1566,9 +1566,17 @@ function enrichNodesWithImages(nodes, imageAssets, downloadResults, useRelativeP
       if (useRelativePaths === false) {
         pathForMarkup = result.filePath;
       } else if (typeof useRelativePaths === "string") {
-        pathForMarkup = result.filePath.replace(useRelativePaths, ".");
+        const basePath = useRelativePaths.endsWith("/") ? useRelativePaths : useRelativePaths + "/";
+        const normalizedFilePath = result.filePath.replace(/\\/g, "/");
+        const normalizedBasePath = basePath.replace(/\\/g, "/");
+        if (normalizedFilePath.startsWith(normalizedBasePath)) {
+          pathForMarkup = "./" + normalizedFilePath.substring(normalizedBasePath.length);
+        } else {
+          pathForMarkup = "./" + result.filePath.split(/[/\\]/).pop();
+        }
       } else {
-        pathForMarkup = result.filePath.replace(process.cwd(), ".");
+        const fileName = result.filePath.split(/[/\\]/).pop();
+        pathForMarkup = "./" + fileName;
       }
       imageMap.set(asset.id, {
         filePath: result.filePath,

package/dist/index.js

@@ -1431,7 +1431,7 @@ async function getFigmaMetadata(figmaUrl, options = {}) {
           imageNodes,
           { pngScale: imageFormat === "png" ? pngScale : void 0 }
         );
-        result.nodes = enrichNodesWithImages(nodes, imageAssets, downloadResults, useRelativePaths);
+        result.nodes = enrichNodesWithImages(nodes, imageAssets, downloadResults, useRelativePaths, localPath);
         Logger.log(`Successfully downloaded and enriched ${downloadResults.length} images`);
       }
     }
@@ -1555,7 +1555,7 @@ function hasImageFill(node, globalVars) {
   }
   return fillData.some((fill) => fill?.type === "IMAGE");
 }
-function enrichNodesWithImages(nodes, imageAssets, downloadResults, useRelativePaths = true) {
+function enrichNodesWithImages(nodes, imageAssets, downloadResults, useRelativePaths = true, localPath) {
   const imageMap = /* @__PURE__ */ new Map();
   imageAssets.forEach((asset, index) => {
     const result = downloadResults[index];
@@ -1564,9 +1564,17 @@ function enrichNodesWithImages(nodes, imageAssets, downloadResults, useRelativeP
       if (useRelativePaths === false) {
         pathForMarkup = result.filePath;
       } else if (typeof useRelativePaths === "string") {
-        pathForMarkup = result.filePath.replace(useRelativePaths, ".");
+        const basePath = useRelativePaths.endsWith("/") ? useRelativePaths : useRelativePaths + "/";
+        const normalizedFilePath = result.filePath.replace(/\\/g, "/");
+        const normalizedBasePath = basePath.replace(/\\/g, "/");
+        if (normalizedFilePath.startsWith(normalizedBasePath)) {
+          pathForMarkup = "./" + normalizedFilePath.substring(normalizedBasePath.length);
+        } else {
+          pathForMarkup = "./" + result.filePath.split(/[/\\]/).pop();
+        }
       } else {
-        pathForMarkup = result.filePath.replace(process.cwd(), ".");
+        const fileName = result.filePath.split(/[/\\]/).pop();
+        pathForMarkup = "./" + fileName;
       }
       imageMap.set(asset.id, {
         filePath: result.filePath,

package/dist/lib.d.ts

@@ -18,9 +18,10 @@ export interface FigmaMetadataOptions {
     /** Export scale for PNG images (defaults to 2) */
     pngScale?: number;
     /**
-     * Use relative paths in downloadedImage properties instead of absolute paths.
-     * If true, paths will be relative to process.cwd().
-     * If a string, paths will be relative to that base path.
+     * Control how image paths are generated in downloadedImage properties.
+     * - true (default): Just the filename (e.g., "./icon.png")
+     * - false: Absolute file path (e.g., "/absolute/path/to/images/icon.png")
+     * - string: Strip this base path from file path (e.g., "/var/www" → "./images/icon.png")
      * Default: true
      */
     useRelativePaths?: boolean | string;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "figma-metadata-extractor",
-    "version": "1.0.4",
+    "version": "1.0.5",
     "description": "Extract metadata and download images from Figma files. A standalone library for accessing Figma design data and downloading frame images programmatically.",
     "type": "module",
     "main": "dist/index.cjs",