@zaininnari/postcss-cachebuster 0.4.1 → 0.6.0

package/CHANGELOG.md

@@ -1,15 +1,26 @@
 # Changelog
 
+## 0.6.0 (2026-01-04)
+
+- remove unnecessary canonical-path and path polyfill
+
+## 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+
 
@@ -20,12 +31,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)
 
@@ -34,5 +46,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/index.mjs

@@ -2,7 +2,7 @@ import fs from 'fs';
 import crypto from 'crypto';
 import chalk from 'chalk';
 
-import path from 'canonical-path';
+import path from 'node:path';
 
 const checksums = {};
 
@@ -17,6 +17,7 @@ const checksums = {};
 
 const plugin = (opts = {}) => {
   const pattern = /url\((['"])?([^'")]+)(['"])?\)/g;
+  // prettier-ignore
   const supportedPropsDefault = [
     'background',
     'background-image',
@@ -50,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;
       }
@@ -74,10 +73,13 @@ const plugin = (opts = {}) => {
   function resolveUrl(assetUrl, file, imagesPath, isRootRelativeButNotProtocolRelative) {
     let assetPath = decodeURI(assetUrl.pathname);
 
+    // URL pathname always use '/', so use the POSIX API here to avoid introducing OS-specific path separators.
+    const posixPath = path.posix;
+
     if (isRootRelativeButNotProtocolRelative) {
-      assetPath = path.join(imagesPath, assetPath);
+      assetPath = posixPath.join(imagesPath, assetPath);
     } else {
-      assetPath = path.join(opts.cssPath || path.dirname(file), assetPath);
+      assetPath = posixPath.join(opts.cssPath || posixPath.dirname(file), assetPath);
     }
     return assetPath;
   }
@@ -116,7 +118,7 @@ const plugin = (opts = {}) => {
     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};
+    return { u, isAbsolute, isRootRelativeButNotProtocolRelative, originalUrl: input };
   }
 
   /**
@@ -134,7 +136,7 @@ const plugin = (opts = {}) => {
     const url = `${u.pathname}${u.search}${u.hash}`;
     if (!isRootRelativeButNotProtocolRelative) {
       // remove start slash
-      return  url.substring(1);
+      return url.substring(1);
     }
     return url;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaininnari/postcss-cachebuster",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "description": "Fork of postcss-cachebuster. Cachebusting all local files in css",
   "keywords": [
     "postcss",
@@ -33,20 +33,20 @@
   },
   "main": "./index.mjs",
   "dependencies": {
-    "canonical-path": "^1.0.0",
-    "chalk": "^5.6.2",
-    "path": "^0.12.7"
+    "chalk": "^5.6.2"
   },
   "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"
   },
@@ -55,6 +55,8 @@
   },
   "scripts": {
     "lint": "eslint .",
-    "test": "gulp --gulpfile gulpfile.mjs"
+    "test": "gulp --gulpfile gulpfile.mjs",
+    "format:check": "prettier . --check",
+    "format:write": "prettier . --write"
   }
 }

package/.github/workflows/lint.yml

@@ -1,28 +0,0 @@
-name: Lint
-
-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 run lint

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>

package/eslint.config.js

@@ -1,22 +0,0 @@
-import js from "@eslint/js";
-import globals from "globals";
-import n from "eslint-plugin-n";
-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"],
-        ignores: ['eslint.config.js'],
-    },
-]);

package/postcss-cachebuster.iml

@@ -1,9 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<module type="WEB_MODULE" version="4">
-  <component name="NewModuleRootManager" inherit-compiler-output="true">
-    <exclude-output />
-    <content url="file://$MODULE_DIR$" />
-    <orderEntry type="inheritedJdk" />
-    <orderEntry type="sourceFolder" forTests="false" />
-  </component>
-</module>