@zaininnari/postcss-cachebuster 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,10 +1,22 @@
 # Changelog
 
+## 0.5.0 (2026-01-04)
+
+- Add Prettier
+
+## 0.4.1 (2026-01-02)
+
+- Add ESLint
+  - @eslint/js recommended
+  - eslint-plugin-n recommended
+
 ## 0.4.0 (2025-12-30)
+
 - update dependencies
 - update support node version 20+
 
 ## 0.3.0 (2025-12-29)
+
 - update npm package
 - update support node version 18+
 
@@ -15,12 +27,13 @@
 ## 0.1.5 (2018-12-07)
 
 ## 0.1.4 (2017-01-07)
+
 Fix multiple css imports in single css file.
 
 ## 0.1.3 (2016-05-27)
 
-- `type` can be defined as function. 
-Thanks for Jackson Ray Hamilton [@jacksonrayhamilton](http://github.com/jacksonrayhamilton)
+- `type` can be defined as function.
+  Thanks for Jackson Ray Hamilton [@jacksonrayhamilton](http://github.com/jacksonrayhamilton)
 
 ## 0.1.2 (2015-11-19)
 
@@ -29,5 +42,3 @@ Thanks for Jackson Ray Hamilton [@jacksonrayhamilton](http://github.com/jacksonr
 ## 0.1.1 (2015-11-18)
 
 - Added .htc support
-
-

package/LICENSE

@@ -1,6 +1,7 @@
 The MIT License (MIT)
 
 Copyright 2015 Gleb Mikheev <glebmachine@gmail.com>
+Copyright 2026 zaininnari
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in

package/README.md

@@ -8,29 +8,34 @@ This project is a fork of https://github.com/glebmachine/postcss-cachebuster.
 [PostCSS] plugin added cachebuster to local files based on their date changed.
 
 ## Install
+
 ```bash
 npm i -D @zaininnari/postcss-cachebuster
 ```
 
 ## Usage
+
 ```js
 import postcss from 'postcss';
 import cachebuster from '@zaininnari/postcss-cachebuster';
 
-await postcss([
+const result = await postcss([
   cachebuster({
     imagesPath: '/images',
-    cssPath: '/stylesheets'
-  })
+    cssPath: '/stylesheets',
+  }),
 ]).process(css, { from: undefined });
+
+result.css;
 ```
 
 ## Input css example
+
 ```css
-@import url("/css/styles.css");
+@import url('/css/styles.css');
 .foo {
-  background-image : url('../images/index/logo.png');
-  behavior : url('../behaviors/backgroundsize.min.htc');
+  background-image: url('../images/index/logo.png');
+  behavior: url('../behaviors/backgroundsize.min.htc');
 }
 @font-face {
   font-family: 'My font';
@@ -39,11 +44,12 @@ await postcss([
 ```
 
 ## Output css example
+
 ```css
-@import url("/css/styles.css?v66f22a33fff");
+@import url('/css/styles.css?v66f22a33fff');
 .foo {
-  background-image : url('../images/index/logo.png?v14f32a475b8');
-  behavior : url('../behaviors/backgroundsize.min.htc?v15f55a666c2');
+  background-image: url('../images/index/logo.png?v14f32a475b8');
+  behavior: url('../behaviors/backgroundsize.min.htc?v15f55a666c2');
 }
 @font-face {
   font-family: 'My font';
@@ -52,14 +58,19 @@ await postcss([
 ```
 
 ## Configure
+
 ```js
-postcss([ 
-  require('postcss-cachebuster')({
-    imagesPath : '/images', 
-    cssPath : '/stylesheets'
-  }) 
-])
+import postcss from 'postcss';
+import cachebuster from '@zaininnari/postcss-cachebuster';
+
+postcss([
+  cachebuster({
+    imagesPath: '/images',
+    cssPath: '/stylesheets',
+  }),
+]);
 ```
+
 See [PostCSS] docs for examples for your environment.
 
 [PostCSS]: https://postcss.org/
@@ -95,31 +106,32 @@ Add to this list by setting the `additionalProps` configuration option.
 To add support for `mask-image` properties, for example:
 
 ```js
-postcss([ 
-  require('postcss-cachebuster')({
-    additionalProps : [
-      'mask-image',
-      '-webkit-mask-image'
-    ]
-  })
-])
+import postcss from 'postcss';
+import cachebuster from '@zaininnari/postcss-cachebuster';
+
+postcss([
+  cachebuster({
+    additionalProps: ['mask-image', '-webkit-mask-image'],
+  }),
+]);
 ```
 
 Replace the default list by setting the `supportedProps` configuration option.
 To limit the cachbusting to background images only, for example:
 
 ```js
-postcss([ 
-  require('postcss-cachebuster')({
-    supportedProps : [
-      'background',
-      'background-image'
-    ]
-  })
-])
+import postcss from 'postcss';
+import cachebuster from '@zaininnari/postcss-cachebuster';
+
+postcss([
+  cachebuster({
+    supportedProps: ['background', 'background-image'],
+  }),
+]);
 ```
 
 ## Contributors
+
 - Gleb Mikheev (https://github.com/glebmachine)
 - Graham Bates (https://github.com/grahambates)
 - Yusuke Yagyu (https://github.com/gyugyu)

package/eslint.config.js

@@ -0,0 +1,26 @@
+import js from '@eslint/js';
+import globals from 'globals';
+import n from 'eslint-plugin-n';
+import eslintConfigPrettier from 'eslint-config-prettier';
+import { defineConfig } from 'eslint/config';
+
+export default defineConfig([
+  {
+    files: ['**/*.{js,mjs,cjs}'],
+    languageOptions: {
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+      globals: {
+        ...globals.node,
+        ...globals.mocha,
+        myCustomGlobal: 'readonly',
+      },
+    },
+    plugins: {
+      js,
+      n,
+    },
+    extends: ['js/recommended', 'n/recommended', eslintConfigPrettier],
+    ignores: ['eslint.config.js'],
+  },
+]);

package/index.mjs

@@ -1,4 +1,3 @@
-import url from 'url';
 import fs from 'fs';
 import crypto from 'crypto';
 import chalk from 'chalk';
@@ -7,8 +6,18 @@ import path from 'canonical-path';
 
 const checksums = {};
 
+/**
+ * parsed
+ * @typedef {Object} parsed
+ * @property {URL} u
+ * @property {boolean} isAbsolute
+ * @property {boolean} isRootRelativeButNotProtocolRelative
+ * @property {string} originalUrl
+ */
+
 const plugin = (opts = {}) => {
   const pattern = /url\((['"])?([^'")]+)(['"])?\)/g;
+  // prettier-ignore
   const supportedPropsDefault = [
     'background',
     'background-image',
@@ -42,9 +51,7 @@ const plugin = (opts = {}) => {
         cachebuster = checksums[checksumKey];
       } else {
         const data = fs.readFileSync(assetPath);
-        cachebuster = crypto.createHash(opts.hashAlgorithm)
-          .update(data)
-          .digest('hex');
+        cachebuster = crypto.createHash(opts.hashAlgorithm).update(data).digest('hex');
 
         checksums[checksumKey] = cachebuster;
       }
@@ -56,10 +63,17 @@ const plugin = (opts = {}) => {
     return cachebuster;
   }
 
-  function resolveUrl(assetUrl, file, imagesPath) {
+  /**
+   * @param assetUrl {URL}
+   * @param file {string}
+   * @param imagesPath {string}
+   * @param isRootRelativeButNotProtocolRelative {boolean}
+   * @returns {string}
+   */
+  function resolveUrl(assetUrl, file, imagesPath, isRootRelativeButNotProtocolRelative) {
     let assetPath = decodeURI(assetUrl.pathname);
 
-    if (/^\//.test(assetUrl.pathname)) {
+    if (isRootRelativeButNotProtocolRelative) {
       assetPath = path.join(imagesPath, assetPath);
     } else {
       assetPath = path.join(opts.cssPath || path.dirname(file), assetPath);
@@ -67,14 +81,22 @@ const plugin = (opts = {}) => {
     return assetPath;
   }
 
-  function updateAssetUrl(assetUrl, inputFile) {
-    const assetPath = resolveUrl(assetUrl, inputFile, opts.imagesPath);
+  /**
+   * @param assetUrl {URL}
+   * @param inputFile {string}
+   * @param isRootRelativeButNotProtocolRelative {boolean}
+   */
+  function updateAssetUrl(assetUrl, inputFile, isRootRelativeButNotProtocolRelative) {
+    const assetPath = resolveUrl(assetUrl, inputFile, opts.imagesPath, isRootRelativeButNotProtocolRelative);
 
     // complete url with cachebuster
-    const cachebuster = createCachebuster(assetPath, assetUrl.pathname, opts.type);
+    const originPath = isRootRelativeButNotProtocolRelative ? assetUrl.pathname : assetUrl.pathname.substring(1);
+    const cachebuster = createCachebuster(assetPath, originPath, opts.type);
     if (!cachebuster) {
       return;
-    } else if (typeof opts.type === 'function') {
+    }
+
+    if (typeof opts.type === 'function') {
       assetUrl.pathname = cachebuster;
     } else if (assetUrl.search && assetUrl.search.length > 1) {
       assetUrl.search = assetUrl.search + '&' + opts.paramName + cachebuster;
@@ -83,6 +105,39 @@ const plugin = (opts = {}) => {
     }
   }
 
+  const DUMMY_BASE = 'http://localhost';
+
+  /**
+   * @param input {string}
+   * @returns {parsed}
+   */
+  function parseUrlPreserveRelative(input) {
+    const isAbsolute = /^[a-zA-Z][a-zA-Z\d+\-.]*:/.test(input);
+    const isRootRelativeButNotProtocolRelative = /^\/(?!\/)/.test(input);
+    const u = isAbsolute ? new URL(input) : new URL(input, DUMMY_BASE);
+    return { u, isAbsolute, isRootRelativeButNotProtocolRelative, originalUrl: input };
+  }
+
+  /**
+   * @param parsed {parsed}
+   * @returns {string|string}
+   */
+  function formatUrlPreserveRelative(parsed) {
+    const u = parsed.u;
+    const isAbsolute = parsed.isAbsolute;
+    const isRootRelativeButNotProtocolRelative = parsed.isRootRelativeButNotProtocolRelative;
+
+    if (isAbsolute) {
+      return u.toString();
+    }
+    const url = `${u.pathname}${u.search}${u.hash}`;
+    if (!isRootRelativeButNotProtocolRelative) {
+      // remove start slash
+      return url.substring(1);
+    }
+    return url;
+  }
+
   return {
     postcssPlugin: 'postcss-cachebuster',
     Once(root) {
@@ -96,10 +151,10 @@ const plugin = (opts = {}) => {
         const quote = results[1] || '"';
         const originalUrl = results[2];
 
-        const assetUrl = url.parse(originalUrl);
-        updateAssetUrl(assetUrl, inputFile);
+        const parsed = parseUrlPreserveRelative(originalUrl);
+        updateAssetUrl(parsed.u, inputFile, parsed.isRootRelativeButNotProtocolRelative, parsed.originalUrl);
 
-        atrule.params = 'url(' + quote + url.format(assetUrl) + quote + ')';
+        atrule.params = 'url(' + quote + formatUrlPreserveRelative(parsed) + quote + ')';
       });
 
       root.walkDecls(function walkThroughtDeclarations(declaration) {
@@ -111,20 +166,22 @@ const plugin = (opts = {}) => {
         declaration.value = declaration.value.replace(pattern, function (match, quote, originalUrl) {
           quote = quote || '"';
 
-          const assetUrl = url.parse(originalUrl);
+          const parsed = parseUrlPreserveRelative(originalUrl);
+          const assetUrl = parsed.u;
 
           // only locals
           if (
-            assetUrl.host ||
+            assetUrl.toString().indexOf(DUMMY_BASE) !== 0 ||
+            parsed.isAbsolute ||
             assetUrl.pathname.indexOf('//') === 0 ||
             assetUrl.pathname.indexOf(';base64') !== -1
           ) {
             return match;
           }
 
-          updateAssetUrl(assetUrl, inputFile);
+          updateAssetUrl(assetUrl, inputFile, parsed.isRootRelativeButNotProtocolRelative);
 
-          return 'url(' + quote + url.format(assetUrl) + quote + ')';
+          return 'url(' + quote + formatUrlPreserveRelative(parsed) + quote + ')';
         });
       });
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaininnari/postcss-cachebuster",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Fork of postcss-cachebuster. Cachebusting all local files in css",
   "keywords": [
     "postcss",
@@ -38,11 +38,17 @@
     "path": "^0.12.7"
   },
   "devDependencies": {
+    "@eslint/js": "^9.39.2",
     "chai": "^6.2.2",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-n": "^17.23.1",
+    "globals": "^16.5.0",
     "gulp": "^5.0.1",
     "gulp-mocha": "^10.0.1",
     "gulp-postcss": "^10.0.0",
     "postcss": "^8.5.6",
+    "prettier": "^3.7.4",
     "sinon": "^21.0.1",
     "sinon-chai": "^4.0.1"
   },
@@ -50,6 +56,9 @@
     "glob": "9.3.5"
   },
   "scripts": {
-    "test": "gulp --gulpfile gulpfile.mjs"
+    "lint": "eslint .",
+    "test": "gulp --gulpfile gulpfile.mjs",
+    "format:check": "prettier . --check",
+    "format:write": "prettier . --write"
   }
 }

package/.eslintrc.json

@@ -1,13 +0,0 @@
-
-{
-  "rules": {
-    "max-len": 0,
-    "indent": ["error", 2, { "VariableDeclarator": 1 }],
-    "global-require": 0,
-    "func-names": 0,
-    "prefer-rest-params": 1,
-    "strict": 1,
-    "no-param-reassign": 0
-  }
-}
-

package/.github/workflows/test-latest.yml

@@ -1,31 +0,0 @@
-name: Test (latest deps)
-
-on:
-  push:
-  pull_request:
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-
-    strategy:
-      matrix:
-        node-version: [20, 22, 24]
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Use Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-
-      - name: Remove package-lock.json
-        run: rm -f package-lock.json
-
-      - name: Install dependencies (latest allowed by package.json)
-        run: npm install
-
-      - name: Run tests
-        run: npm test
-

package/.github/workflows/test.yml

@@ -1,28 +0,0 @@
-name: Test
-
-on:
-  push:
-  pull_request:
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-
-    strategy:
-      matrix:
-        node-version: [20, 22, 24]
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Use Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-          cache: 'npm'
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Run tests
-        run: npm test

package/.idea/copilot.data.migration.ask2agent.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="Ask2AgentMigrationStateService">
-    <option name="migrationStatus" value="COMPLETED" />
-  </component>
-</project>

package/.idea/jsLibraryMappings.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="JavaScriptLibraryMappings">
-    <includedPredefinedLibrary name="Node.js Core" />
-  </component>
-</project>

package/.idea/misc.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectRootManager" version="2">
-    <output url="file://$PROJECT_DIR$/out" />
-  </component>
-</project>

package/.idea/modules.xml

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectModuleManager">
-    <modules>
-      <module fileurl="file://$PROJECT_DIR$/postcss-cachebuster.iml" filepath="$PROJECT_DIR$/postcss-cachebuster.iml" />
-    </modules>
-  </component>
-</project>

package/.idea/vcs.xml

@@ -1,7 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="VcsDirectoryMappings">
-    <mapping directory="" vcs="Git" />
-    <mapping directory="$PROJECT_DIR$" vcs="Git" />
-  </component>
-</project>