@ideasonpurpose/build-tools-wordpress 2.5.0 → 2.6.0

package/.github/workflows/release-from-version-tag.yml

@@ -8,6 +8,7 @@ jobs:
   build:
     name: Build Release
     # https://docs.github.com/en/actions/using-github-hosted-runners/about-github-hosted-runners#supported-runners-and-hardware-resources
+    # https://github.com/actions/runner-images
     runs-on: ubuntu-24.04
 
     steps:

package/CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes to this project will be documented in this file. Dates are d
 
 Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 
+#### v2.5.1
+
+> 8 March 2026
+
+- add rimraf
+- add SVG processing details to README
+- add comment for runner images in release workflow
+
+#### v2.5.0
+
+> 7 March 2026
+
+- bump deps
+- beginning of typing, some cleanup
+- inline SVGs in SCSS files by default
+
 #### v2.4.2
 
 > 22 December 2025

package/README.md

@@ -1,6 +1,6 @@
 # @ideasonpurpose/build-tools-wordpress
 
-#### Version 2.5.0
+#### Version 2.6.0
 
 [![NPM Version](https://img.shields.io/npm/v/%40ideasonpurpose%2Fbuild-tools-wordpress?logo=npm)](https://www.npmjs.com/package/@ideasonpurpose/build-tools-wordpress)
 [![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/ideasonpurpose/build-tools-wordpress/npm-publish.yml?logo=github&logoColor=white)](https://github.com/ideasonpurpose/build-tools-wordpress#readme)
@@ -29,6 +29,18 @@ Each project may optionally include an **ideasonpurpose.config.js** file in the
 
 -->
 
+## SVG Processing
+
+Webpack handles SVG files differently based on import context:
+
+- **In SCSS files**: SVGs referenced via `url('file.svg')` are inlined as data URIs if under 4KB, otherwise emitted as separate files in the output directory.
+
+- **In JS/TSX files**:
+  - With `?url` query (e.g., `import svg from 'file.svg?url'`): Treated as assets, inlined as data URIs if under 4KB, else files.
+  - Without `?url`: Converted to React components using `@svgr/webpack` for direct JSX usage.
+
+Data URIs are generated as `data:image/svg+xml,<url-encoded-content>` using more efficient URL-encoding, not base64.
+
 ## Local Development
 
 Because this project makes use of bin scripts, conventional `npm link` workflows won't work correctly. To work on this code in a development project, change the project's package.json to install from a local file path, probably something like this:

package/config/webpack.config.js

@@ -186,6 +186,7 @@ export default async (env) => {
 
                   loadPaths: [
                     path.resolve(config.src, "sass"),
+                    path.resolve(config.src, "styles"),
                     path.resolve(siteDir, "node_modules"),
                   ],
                 },
@@ -302,9 +303,10 @@ export default async (env) => {
       hot: true, // Enable hot module replacement with fallback to full reload
 
       // hot: "only",
-      static: {
-        watch: false,
-      },
+      static: [
+        { directory: config.dist, watch: false },
+        { directory: config.src, publicPath: config.publicPath.replace('/dist/', '/src/'), watch: false },
+      ],
 
       client: {
         logging: "verbose",
@@ -486,7 +488,7 @@ export default async (env) => {
               dot: true, // TODO: Dangerous? Why is this ever necessary?!
               ignore: [
                 "**/{.gitignore,.DS_Store,*:Zone.Identifier}",
-                config.src + "/{block,blocks,fonts,js,sass}/**",
+                config.src + "/{block,blocks,fonts,js,sass,styles}/**",
               ],
             },
             noErrorOnMissing: true,

package/lib/DependencyManifestPlugin.js

@@ -24,7 +24,7 @@ export class DependencyManifestPlugin {
       //   Object.keys(compilation),
       // );
 
-      console.log(Array.from(compilation.namedChunkGroups.keys()))
+      // console.log(Array.from(compilation.namedChunkGroups.keys()))
 
       Array.from(compilation.namedChunkGroups.entries()).forEach(
         ([key, group]) => {
@@ -76,7 +76,7 @@ export class DependencyManifestPlugin {
         },
       );
 
-      console.log(this.manifest);
+      // console.log(this.manifest);
 
       callback();
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ideasonpurpose/build-tools-wordpress",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "description": "Build scripts and dependencies for IOP's WordPress development environments.",
   "homepage": "https://github.com/ideasonpurpose/build-tools-wordpress#readme",
   "bugs": {
@@ -45,8 +45,8 @@
     "archiver": "^7.0.1",
     "auto-changelog": "^2.5.0",
     "autoprefixer": "^10.4.27",
-    "babel-loader": "^10.1.0",
-    "caniuse-lite": "^1.0.30001777",
+    "babel-loader": "^10.1.1",
+    "caniuse-lite": "^1.0.30001778",
     "chalk": "^5.6.2",
     "chalk-cli": "^6.0.0",
     "classnames": "^2.5.1",
@@ -68,7 +68,7 @@
     "image-minimizer-webpack-plugin": "^5.0.0",
     "is-text-path": "^3.0.0",
     "lodash": "^4.17.23",
-    "mini-css-extract-plugin": "^2.10.0",
+    "mini-css-extract-plugin": "^2.10.1",
     "ora": "^9.3.0",
     "postcss": "^8.5.8",
     "postcss-loader": "^8.2.1",
@@ -77,7 +77,8 @@
     "pretty-hrtime": "^1.0.3",
     "read-package-up": "^12.0.0",
     "replacestream": "^4.0.3",
-    "sass-embedded": "^1.97.3",
+    "rimraf": "^6.1.3",
+    "sass-embedded": "^1.98.0",
     "sass-loader": "^16.0.7",
     "semver": "^7.7.4",
     "sharp": "^0.34.5",
@@ -97,8 +98,8 @@
     "webpack-cli": "^6.0.1"
   },
   "devDependencies": {
-    "@vitest/coverage-v8": "^4.0.18",
-    "vitest": "^4.0.18"
+    "@vitest/coverage-v8": "^4.1.0",
+    "vitest": "^4.1.0"
   },
   "version-everything": {
     "files": [