babel-plugin-transform-assets-import-to-string 1.1.0 → 2.0.0

package/README.md

@@ -1,4 +1,5 @@
 # babel-plugin-transform-assets-import-to-string
+
 > Babel plugin that transforms image assets import and requires to urls / cdn
 
 [![npm][npm-badge]][npm-link]
@@ -6,11 +7,19 @@
 
 ## Table of Contents
 
--   [About](#about)
--   [Installation](#installation)
--   [Usage](#usage)
-    -   [via babelrc](#via-babelrc)
-    -   [via Node API](#via-node-api)
+* [About](#about)
+* [Features](#features)
+* [Requirements](#requirements)
+* [Installation](#installation)
+* [Usage](#usage)
+  * [via babelrc](#via-babelrc)
+  * [via Node API](#via-node-api)
+* [Options](#options)
+* [Examples](#examples)
+  * [Basic URI Transformation](#basic-uri-transformation)
+  * [File Copying with outputDir](#file-copying-with-outputdir)
+  * [Path Preservation with preservePaths](#path-preservation-with-preservepaths)
+  * [Disabling Hash](#disabling-hash)
 
 ## About
 
@@ -24,8 +33,8 @@ const image1 = require('../path/assets/icon1.svg');
 
 // to
 
-const image = 'http://your.cdn.address/assets/icon.svg';
-const image1 = 'http://your.cdn.address/assets/icon1.svg';
+const image = 'https://cdn.example.com/assets/icon.a1b2c3d4.svg';
+const image1 = 'https://cdn.example.com/assets/icon1.e5f6g7h8.svg';
 
 // Somewhere further down in your code:
 //
@@ -36,47 +45,201 @@ const image1 = 'http://your.cdn.address/assets/icon1.svg';
 // ajaxAsyncRequest(image)
 ```
 
-See the spec for more [examples](https://github.com/yeojz/babel-plugin-transform-assets-import-to-string/blob/master/test/index.spec.js).
+See the spec for more [examples](https://github.com/yeojz/babel-plugin-transform-assets-import-to-string/blob/master/test/index.spec.ts).
+
+## Features
+
+- Transforms asset imports to CDN URLs with content hashing
+- Supports both ES6 `import` and CommonJS `require()`
+- Optional file copying to output directory during build
+- Content-based hashing for cache busting (same content = same hash)
+- Configurable file extensions and hash length
+- Path structure preservation option
+- TypeScript support
+
+## Requirements
+
+- Node.js 20 or higher
+- Babel 7.20 or higher
 
 ## Installation
 
 ```
-$> npm install babel-plugin-transform-assets-import-to-string --save
+$> npm install babel-plugin-transform-assets-import-to-string --save-dev
+```
+
+This plugin requires `@babel/core` as a peer dependency. If you don't already have it installed:
+
+```
+$> npm install @babel/core --save-dev
 ```
 
 ## Usage
 
 ### via .babelrc
+
 ```json
 {
-  "plugins": [["transform-assets-import-to-string", {
-    "baseDir": "/assets",
-    "baseUri": "http://your.cdn.address"
-  }]]
+  "plugins": [
+    [
+      "transform-assets-import-to-string",
+      {
+        "baseUri": "https://cdn.example.com/assets"
+      }
+    ]
+  ]
 }
 ```
 
 ### via Node API
 
 ```js
-require("babel-core").transform("code", {
-  plugins: [["transform-assets-import-to-string", {
-    "baseDir": "/assets",
-    "baseUri": "http://your.cdn.address"
-  }]]
+require('@babel/core').transform('code', {
+  plugins: [
+    [
+      'transform-assets-import-to-string',
+      {
+        baseUri: 'https://cdn.example.com/assets'
+      }
+    ]
+  ]
 });
 ```
 
-By default, it will transform the following extensions: `.gif, .jpeg, .jpg, .png, .svg` if `extensions` option is not defined. To configure a custom list, just add the `extensions` array as an option.
+## Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `baseUri` | `string` | `""` | URL prefix for transformed paths (e.g., `"https://cdn.example.com/assets"`) |
+| `outputDir` | `string` | `undefined` | Directory to copy assets to during build. If not set, no files are copied. |
+| `extensions` | `string[]` | `[".gif", ".jpeg", ".jpg", ".png", ".svg"]` | File extensions to transform. Leading `.` (dot) is required. |
+| `hashLength` | `number` | `8` | Length of content hash in filename. Set to `0` to disable hashing. |
+| `preservePaths` | `string` | `undefined` | Base path to strip while preserving directory structure. If not set, filenames are flattened. |
+
+## Examples
+
+### Basic URI Transformation
+
+Transform imports to CDN URLs with content hashing:
+
+```json
+{
+  "plugins": [
+    [
+      "transform-assets-import-to-string",
+      {
+        "baseUri": "https://cdn.example.com/assets"
+      }
+    ]
+  ]
+}
+```
+
+```js
+// Input
+import logo from './images/logo.svg';
+
+// Output
+const logo = 'https://cdn.example.com/assets/logo.a1b2c3d4.svg';
+```
+
+### File Copying with outputDir
+
+Copy assets to a build directory during transformation:
+
+```json
+{
+  "plugins": [
+    [
+      "transform-assets-import-to-string",
+      {
+        "baseUri": "https://cdn.example.com/assets",
+        "outputDir": "./dist/assets"
+      }
+    ]
+  ]
+}
+```
+
+```js
+// Input
+import logo from './images/logo.svg';
 
-__Note:__ leading `.` (dot) is required.
+// Output
+const logo = 'https://cdn.example.com/assets/logo.a1b2c3d4.svg';
+// File copied to: ./dist/assets/logo.a1b2c3d4.svg
+```
+
+### Path Preservation with preservePaths
+
+Keep directory structure by specifying a base path to strip:
 
 ```json
 {
   "plugins": [
-    ["transform-assets-import-to-string", {
-      "extensions": [".jpg", ".png"]
-    }]
+    [
+      "transform-assets-import-to-string",
+      {
+        "baseUri": "https://cdn.example.com",
+        "outputDir": "./dist/static",
+        "preservePaths": "src"
+      }
+    ]
+  ]
+}
+```
+
+```js
+// Input (file at src/components/icons/logo.svg)
+import logo from './icons/logo.svg';
+
+// Output
+const logo = 'https://cdn.example.com/components/icons/logo.a1b2c3d4.svg';
+// File copied to: ./dist/static/components/icons/logo.a1b2c3d4.svg
+```
+
+Without `preservePaths`, all files are flattened to the root of `outputDir`.
+
+### Disabling Hash
+
+Use `hashLength: 0` to disable content hashing:
+
+```json
+{
+  "plugins": [
+    [
+      "transform-assets-import-to-string",
+      {
+        "baseUri": "https://cdn.example.com/assets",
+        "hashLength": 0
+      }
+    ]
+  ]
+}
+```
+
+```js
+// Input
+import logo from './images/logo.svg';
+
+// Output
+const logo = 'https://cdn.example.com/assets/logo.svg';
+```
+
+### Custom Extensions
+
+Transform only specific file types:
+
+```json
+{
+  "plugins": [
+    [
+      "transform-assets-import-to-string",
+      {
+        "baseUri": "https://cdn.example.com/assets",
+        "extensions": [".svg", ".png"]
+      }
+    ]
   ]
 }
 ```
@@ -87,6 +250,5 @@ __Note:__ leading `.` (dot) is required.
 
 [circle-badge]: https://img.shields.io/circleci/project/github/yeojz/babel-plugin-transform-assets-import-to-string/master.svg?style=flat-square
 [circle-link]: https://circleci.com/gh/yeojz/babel-plugin-transform-assets-import-to-string
-
 [npm-badge]: https://img.shields.io/npm/v/babel-plugin-transform-assets-import-to-string.svg?style=flat-square
 [npm-link]: https://www.npmjs.com/package/babel-plugin-transform-assets-import-to-string

package/dist/index.cjs

@@ -0,0 +1,249 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  default: () => plugin,
+  resetBuildCache: () => resetBuildCache
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/transform.ts
+var import_node_path3 = __toESM(require("path"), 1);
+
+// src/steps/fileHash.ts
+var import_node_crypto = __toESM(require("crypto"), 1);
+var import_node_fs = __toESM(require("fs"), 1);
+function computeFileHash(absPath, hashLength) {
+  if (hashLength === 0) {
+    return "";
+  }
+  const content = import_node_fs.default.readFileSync(absPath);
+  const hash = import_node_crypto.default.createHash("sha1").update(content).digest("hex").slice(0, hashLength);
+  return hash;
+}
+
+// src/steps/buildOutputPath.ts
+var import_node_path = __toESM(require("path"), 1);
+function buildOutputPath(options) {
+  const { absPath, hash, preservePaths, projectRoot } = options;
+  const ext = import_node_path.default.extname(absPath);
+  const basename = import_node_path.default.basename(absPath, ext);
+  const hashedName = hash ? `${basename}.${hash}${ext}` : `${basename}${ext}`;
+  if (!preservePaths) {
+    return hashedName;
+  }
+  const normalizedBase = preservePaths.replace(/^\/|\/$/g, "");
+  const relativePath = import_node_path.default.relative(projectRoot, absPath);
+  const segments = relativePath.split(import_node_path.default.sep);
+  const baseIndex = segments.indexOf(normalizedBase);
+  let dirPath;
+  if (baseIndex !== -1) {
+    dirPath = segments.slice(baseIndex + 1, -1).join("/");
+  } else {
+    dirPath = import_node_path.default.dirname(relativePath).split(import_node_path.default.sep).join("/");
+  }
+  if (dirPath && dirPath !== ".") {
+    return `${dirPath}/${hashedName}`;
+  }
+  return hashedName;
+}
+
+// src/steps/copyFile.ts
+var import_node_fs2 = __toESM(require("fs"), 1);
+var import_node_path2 = __toESM(require("path"), 1);
+function copyFile(options) {
+  const { absPath, outputPath, outputDir, cache } = options;
+  if (cache.pathMap.has(absPath)) {
+    return;
+  }
+  const existingSource = cache.outputMap.get(outputPath);
+  if (existingSource && existingSource !== absPath) {
+    throw new Error(
+      `Filename collision detected (hashLength is 0)
+  - ${existingSource}
+  - ${absPath}
+  Both would output to: ${import_node_path2.default.join(outputDir, outputPath)}
+  Consider enabling hashLength or renaming one of the files.`
+    );
+  }
+  const destPath = import_node_path2.default.join(outputDir, outputPath);
+  const destDir = import_node_path2.default.dirname(destPath);
+  if (!import_node_fs2.default.existsSync(destDir)) {
+    import_node_fs2.default.mkdirSync(destDir, { recursive: true });
+  }
+  import_node_fs2.default.copyFileSync(absPath, destPath);
+  cache.pathMap.set(absPath, outputPath);
+  cache.outputMap.set(outputPath, absPath);
+}
+
+// src/steps/replaceNode.ts
+function getVariableName(node) {
+  if (node.specifiers?.[0]?.type === "ImportDefaultSpecifier") {
+    return node.specifiers[0].local.name;
+  }
+  return void 0;
+}
+function replaceNode(scope, uri, types) {
+  const content = types.stringLiteral(uri);
+  if (scope.callee === "require") {
+    scope.path.replaceWith(content);
+    return;
+  }
+  const importPath = scope.path;
+  const variableName = getVariableName(importPath.node);
+  if (variableName) {
+    scope.path.replaceWith(
+      types.variableDeclaration("const", [
+        types.variableDeclarator(types.identifier(variableName), content)
+      ])
+    );
+  }
+}
+
+// src/transform.ts
+function transform(scope, options, types, cache, projectRoot) {
+  const ext = import_node_path3.default.extname(scope.value);
+  if (!options.extensions || !options.extensions.includes(ext)) {
+    return;
+  }
+  const dir = import_node_path3.default.dirname(import_node_path3.default.resolve(scope.filename));
+  const absPath = import_node_path3.default.resolve(dir, scope.value);
+  if (absPath.includes("node_modules")) {
+    return;
+  }
+  const hashLength = options.hashLength ?? 8;
+  const hash = computeFileHash(absPath, hashLength);
+  const outputPath = buildOutputPath({
+    absPath,
+    hash,
+    preservePaths: options.preservePaths,
+    projectRoot
+  });
+  if (options.outputDir) {
+    copyFile({
+      absPath,
+      outputPath,
+      outputDir: options.outputDir,
+      cache
+    });
+  }
+  const baseUri = options.baseUri || "";
+  const separator = baseUri && !baseUri.endsWith("/") ? "/" : "";
+  const uri = `${baseUri}${separator}${outputPath}`;
+  replaceNode(scope, uri, types);
+}
+
+// src/index.ts
+var DEFAULT_EXTENSIONS = [".gif", ".jpeg", ".jpg", ".png", ".svg"];
+function isRequireStatement(path4) {
+  const callee = path4.get("callee");
+  return !Array.isArray(callee) && callee.isIdentifier() && callee.node.name === "require";
+}
+function isValidArgument(path4) {
+  const args = path4.get("arguments");
+  const arg = args[0];
+  return arg !== void 0 && arg.isStringLiteral();
+}
+var buildCache = null;
+function plugin({
+  types: t
+}) {
+  return {
+    name: "transform-assets-import-to-string",
+    pre() {
+      if (!buildCache) {
+        buildCache = {
+          pathMap: /* @__PURE__ */ new Map(),
+          outputMap: /* @__PURE__ */ new Map()
+        };
+      }
+    },
+    post() {
+    },
+    visitor: {
+      ImportDeclaration(nodePath, state) {
+        const opts = {
+          baseUri: "",
+          extensions: DEFAULT_EXTENSIONS,
+          hashLength: 8,
+          ...state.opts
+        };
+        const projectRoot = state.cwd || process.cwd();
+        transform(
+          {
+            path: nodePath,
+            filename: state.filename,
+            value: nodePath.node.source.value,
+            callee: "import"
+          },
+          opts,
+          t,
+          buildCache,
+          projectRoot
+        );
+      },
+      CallExpression(nodePath, state) {
+        if (isRequireStatement(nodePath) && isValidArgument(nodePath)) {
+          const args = nodePath.get("arguments");
+          const arg = args[0];
+          if (!arg.isStringLiteral()) return;
+          const opts = {
+            baseUri: "",
+            extensions: DEFAULT_EXTENSIONS,
+            hashLength: 8,
+            ...state.opts
+          };
+          const projectRoot = state.cwd || process.cwd();
+          transform(
+            {
+              path: nodePath,
+              filename: state.filename,
+              value: arg.node.value,
+              callee: "require"
+            },
+            opts,
+            t,
+            buildCache,
+            projectRoot
+          );
+        }
+      }
+    }
+  };
+}
+function resetBuildCache() {
+  buildCache = null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  resetBuildCache
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/transform.ts","../src/steps/fileHash.ts","../src/steps/buildOutputPath.ts","../src/steps/copyFile.ts","../src/steps/replaceNode.ts"],"sourcesContent":["import type { PluginObj, NodePath } from '@babel/core';\nimport type { ImportDeclaration, CallExpression } from '@babel/types';\nimport { transform } from './transform.js';\nimport type { PluginOptions, CopyCache } from './types.js';\n\nconst DEFAULT_EXTENSIONS = ['.gif', '.jpeg', '.jpg', '.png', '.svg'];\n\nfunction isRequireStatement(path: NodePath<CallExpression>): boolean {\n  const callee = path.get('callee');\n  return (\n    !Array.isArray(callee) &&\n    callee.isIdentifier() &&\n    callee.node.name === 'require'\n  );\n}\n\nfunction isValidArgument(path: NodePath<CallExpression>): boolean {\n  const args = path.get('arguments');\n  const arg = args[0];\n  return arg !== undefined && arg.isStringLiteral();\n}\n\ninterface PluginState {\n  opts: PluginOptions;\n  filename: string;\n  cwd: string;\n}\n\n// Module-level cache shared across all files in a build\nlet buildCache: CopyCache | null = null;\n\nexport default function plugin({\n  types: t,\n}: {\n  types: typeof import('@babel/types');\n}): PluginObj<PluginState> {\n  return {\n    name: 'transform-assets-import-to-string',\n    pre() {\n      // Initialize cache at start of build if not exists\n      if (!buildCache) {\n        buildCache = {\n          pathMap: new Map(),\n          outputMap: new Map(),\n        };\n      }\n    },\n    post() {\n      // Clear cache after build completes\n      // Note: This runs per-file, so we don't clear here\n      // Cache persists for the entire build\n    },\n    visitor: {\n      ImportDeclaration(\n        nodePath: NodePath<ImportDeclaration>,\n        state: PluginState\n      ) {\n        const opts: PluginOptions = {\n          baseUri: '',\n          extensions: DEFAULT_EXTENSIONS,\n          hashLength: 8,\n          ...state.opts,\n        };\n\n        const projectRoot = state.cwd || process.cwd();\n\n        transform(\n          {\n            path: nodePath,\n            filename: state.filename,\n            value: nodePath.node.source.value,\n            callee: 'import',\n          },\n          opts,\n          t,\n          buildCache!,\n          projectRoot\n        );\n      },\n      CallExpression(nodePath: NodePath<CallExpression>, state: PluginState) {\n        if (isRequireStatement(nodePath) && isValidArgument(nodePath)) {\n          const args = nodePath.get('arguments');\n          const arg = args[0];\n\n          if (!arg.isStringLiteral()) return;\n\n          const opts: PluginOptions = {\n            baseUri: '',\n            extensions: DEFAULT_EXTENSIONS,\n            hashLength: 8,\n            ...state.opts,\n          };\n\n          const projectRoot = state.cwd || process.cwd();\n\n          transform(\n            {\n              path: nodePath,\n              filename: state.filename,\n              value: arg.node.value,\n              callee: 'require',\n            },\n            opts,\n            t,\n            buildCache!,\n            projectRoot\n          );\n        }\n      },\n    },\n  };\n}\n\n// Export for testing - allows resetting cache between test runs\nexport function resetBuildCache(): void {\n  buildCache = null;\n}\n\nexport type { PluginOptions } from './types.js';\n","import path from 'node:path';\nimport type { types as t } from '@babel/core';\nimport { computeFileHash } from './steps/fileHash.js';\nimport { buildOutputPath } from './steps/buildOutputPath.js';\nimport { copyFile } from './steps/copyFile.js';\nimport { replaceNode } from './steps/replaceNode.js';\nimport type { PluginOptions, TransformScope, CopyCache } from './types.js';\n\nexport function transform(\n  scope: TransformScope,\n  options: PluginOptions,\n  types: typeof t,\n  cache: CopyCache,\n  projectRoot: string\n): void {\n  const ext = path.extname(scope.value);\n\n  if (!options.extensions || !options.extensions.includes(ext)) {\n    return;\n  }\n\n  const dir = path.dirname(path.resolve(scope.filename));\n  const absPath = path.resolve(dir, scope.value);\n\n  // Skip node_modules\n  if (absPath.includes('node_modules')) {\n    return;\n  }\n\n  // Compute content hash\n  const hashLength = options.hashLength ?? 8;\n  const hash = computeFileHash(absPath, hashLength);\n\n  // Build output path\n  const outputPath = buildOutputPath({\n    absPath,\n    hash,\n    preservePaths: options.preservePaths,\n    projectRoot,\n  });\n\n  // Copy file if outputDir is set\n  if (options.outputDir) {\n    copyFile({\n      absPath,\n      outputPath,\n      outputDir: options.outputDir,\n      cache,\n    });\n  }\n\n  // Build final URI\n  const baseUri = options.baseUri || '';\n  const separator = baseUri && !baseUri.endsWith('/') ? '/' : '';\n  const uri = `${baseUri}${separator}${outputPath}`;\n\n  replaceNode(scope, uri, types);\n}\n","import crypto from 'node:crypto';\nimport fs from 'node:fs';\n\n/**\n * Compute SHA1 content hash of a file\n * @param absPath - Absolute path to the file\n * @param hashLength - Number of hex characters to return (0 = no hash)\n * @returns Hash string or empty string if hashLength is 0\n */\nexport function computeFileHash(absPath: string, hashLength: number): string {\n  if (hashLength === 0) {\n    return '';\n  }\n\n  const content = fs.readFileSync(absPath);\n\n  const hash = crypto\n    .createHash('sha1')\n    .update(content)\n    .digest('hex')\n    .slice(0, hashLength);\n\n  return hash;\n}\n","import path from 'node:path';\n\nexport interface BuildOutputPathOptions {\n  absPath: string;\n  hash: string;\n  preservePaths: string | undefined;\n  projectRoot: string;\n}\n\nexport function buildOutputPath(options: BuildOutputPathOptions): string {\n  const { absPath, hash, preservePaths, projectRoot } = options;\n\n  const ext = path.extname(absPath);\n  const basename = path.basename(absPath, ext);\n  const hashedName = hash ? `${basename}.${hash}${ext}` : `${basename}${ext}`;\n\n  if (!preservePaths) {\n    return hashedName;\n  }\n\n  // Normalize preservePaths: strip leading/trailing slashes\n  const normalizedBase = preservePaths.replace(/^\\/|\\/$/g, '');\n\n  // Get relative path from project root\n  const relativePath = path.relative(projectRoot, absPath);\n\n  // Find the preservePaths segment in the path\n  const segments = relativePath.split(path.sep);\n  const baseIndex = segments.indexOf(normalizedBase);\n\n  let dirPath: string;\n  if (baseIndex !== -1) {\n    // Strip everything up to and including the base\n    dirPath = segments.slice(baseIndex + 1, -1).join('/');\n  } else {\n    // Base not found, use full relative directory path\n    dirPath = path.dirname(relativePath).split(path.sep).join('/');\n  }\n\n  if (dirPath && dirPath !== '.') {\n    return `${dirPath}/${hashedName}`;\n  }\n\n  return hashedName;\n}\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport type { CopyCache } from '../types.js';\n\nexport interface CopyFileOptions {\n  absPath: string;\n  outputPath: string;\n  outputDir: string;\n  cache: CopyCache;\n}\n\nexport function copyFile(options: CopyFileOptions): void {\n  const { absPath, outputPath, outputDir, cache } = options;\n\n  // Check if already copied from this source\n  if (cache.pathMap.has(absPath)) {\n    return;\n  }\n\n  // Check for collision (different source, same output)\n  const existingSource = cache.outputMap.get(outputPath);\n  if (existingSource && existingSource !== absPath) {\n    throw new Error(\n      `Filename collision detected (hashLength is 0)\\n` +\n      `  - ${existingSource}\\n` +\n      `  - ${absPath}\\n` +\n      `  Both would output to: ${path.join(outputDir, outputPath)}\\n` +\n      `  Consider enabling hashLength or renaming one of the files.`\n    );\n  }\n\n  // Build full destination path\n  const destPath = path.join(outputDir, outputPath);\n  const destDir = path.dirname(destPath);\n\n  // Create directories if needed\n  if (!fs.existsSync(destDir)) {\n    fs.mkdirSync(destDir, { recursive: true });\n  }\n\n  // Copy the file\n  fs.copyFileSync(absPath, destPath);\n\n  // Update cache\n  cache.pathMap.set(absPath, outputPath);\n  cache.outputMap.set(outputPath, absPath);\n}\n","import type { types as t } from '@babel/core';\nimport type { TransformScope } from '../types.js';\n\nfunction getVariableName(node: t.ImportDeclaration): string | undefined {\n  if (node.specifiers?.[0]?.type === 'ImportDefaultSpecifier') {\n    return node.specifiers[0].local.name;\n  }\n  return undefined;\n}\n\nexport function replaceNode(\n  scope: TransformScope,\n  uri: string,\n  types: typeof t\n): void {\n  const content = types.stringLiteral(uri);\n\n  if (scope.callee === 'require') {\n    scope.path.replaceWith(content);\n    return;\n  }\n\n  const importPath = scope.path as import('@babel/core').NodePath<t.ImportDeclaration>;\n  const variableName = getVariableName(importPath.node);\n\n  if (variableName) {\n    scope.path.replaceWith(\n      types.variableDeclaration('const', [\n        types.variableDeclarator(types.identifier(variableName), content),\n      ])\n    );\n  }\n}\n"],"mappings":"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","names":["import_node_path","fs","crypto","path","import_node_fs","import_node_path","path","fs","path","path"]}

package/dist/index.d.cts

@@ -0,0 +1,27 @@
+import * as _babel_types from '@babel/types';
+import { PluginObj } from '@babel/core';
+
+interface PluginOptions {
+    /** Base URL prefix (e.g., "https://cdn.example.com/assets") */
+    baseUri?: string;
+    /** Directory to copy assets to (enables file copying when set) */
+    outputDir?: string;
+    /** File extensions to transform (default: ['.gif', '.jpeg', '.jpg', '.png', '.svg']) */
+    extensions?: string[];
+    /** Content hash length in filename (default: 8, set 0 to disable) */
+    hashLength?: number;
+    /** Path base to strip when preserving paths (flattens if not set) */
+    preservePaths?: string;
+}
+
+interface PluginState {
+    opts: PluginOptions;
+    filename: string;
+    cwd: string;
+}
+declare function plugin({ types: t, }: {
+    types: typeof _babel_types;
+}): PluginObj<PluginState>;
+declare function resetBuildCache(): void;
+
+export { type PluginOptions, plugin as default, resetBuildCache };

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import * as _babel_types from '@babel/types';
+import { PluginObj } from '@babel/core';
+
+interface PluginOptions {
+    /** Base URL prefix (e.g., "https://cdn.example.com/assets") */
+    baseUri?: string;
+    /** Directory to copy assets to (enables file copying when set) */
+    outputDir?: string;
+    /** File extensions to transform (default: ['.gif', '.jpeg', '.jpg', '.png', '.svg']) */
+    extensions?: string[];
+    /** Content hash length in filename (default: 8, set 0 to disable) */
+    hashLength?: number;
+    /** Path base to strip when preserving paths (flattens if not set) */
+    preservePaths?: string;
+}
+
+interface PluginState {
+    opts: PluginOptions;
+    filename: string;
+    cwd: string;
+}
+declare function plugin({ types: t, }: {
+    types: typeof _babel_types;
+}): PluginObj<PluginState>;
+declare function resetBuildCache(): void;
+
+export { type PluginOptions, plugin as default, resetBuildCache };