@atomicsmash/compiler 0.5.0 → 0.5.1

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAsBA,OAAO,CAAC,MAAM,CAAC;IAEd,UAAU,MAAM,CAAC;QAEhB,UAAU,UAAU;YACnB,QAAQ,EAAE,YAAY,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;SAC5D;KACD;CACD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAuBA,OAAO,CAAC,MAAM,CAAC;IAEd,UAAU,MAAM,CAAC;QAEhB,UAAU,UAAU;YACnB,QAAQ,EAAE,YAAY,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;SAC5D;KACD;CACD"}

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { sep as pathSeparator, extname, resolve as resolvePath, } from "node:path";
+import { sep as pathSeparator, extname, resolve as resolvePath, relative, } from "node:path";
 import DependencyExtractionWebpackPlugin from "@wordpress/dependency-extraction-webpack-plugin";
 import browserslistToEsbuild from "browserslist-to-esbuild";
 import CopyPlugin from "copy-webpack-plugin";
@@ -64,10 +64,13 @@ const vueConfig = await import("vue-loader")
     .catch(() => ({ loader: [], plugin: [] }));
 const postCSSConfig = [
     [
+        // Support tailwind if package is found
         ...tailwindPostCSSPlugin,
         postCSSPresetEnv({
+            // Support all CSS that is considered stable.
             stage: 2,
             features: {
+                // Polyfill support for custom media queries
                 "custom-media-queries": true,
             },
         }),
@@ -77,15 +80,22 @@ const postCSSConfig = [
 const compiler = webpack({
     resolveLoader: {
         modules: [
+            // Get modules from project node_modules folder
             "node_modules",
+            // Get modules from this package's internal node modules folder once installed
             resolvePath(import.meta.dirname, "../", "node_modules"),
         ],
     },
+    // Add sourcemaps in dev mode
     devtool: MODE === "development" ? "source-map" : false,
+    // Set the environment mode from NODE_ENV.
     mode: MODE,
     entry: await glob([
+        // Parse all direct children of the JS folder, as long as they are JS & TS files
         `${srcFolder}/js/*.{js,ts,jsx,tsx}`,
+        // Parse all direct children of the CSS folder, as long as they are CSS files
         `${srcFolder}/css/*.css`,
+        // Parse all nested children of the CSS folder, as long as they are non-partial SCSS files
         `${srcFolder}/css/**/[^_]*.s[ac]ss`,
     ]).then((paths) => {
         const entryPoints = {};
@@ -93,34 +103,45 @@ const compiler = webpack({
             const entryName = path.replace(srcFolder, "").replace(extname(path), "");
             entryPoints[entryName] = {
                 import: path,
+                // Output filenames with content hash for fingerprinting
                 filename: `${path.replace(`${srcFolder}${pathSeparator}`, "").replace(extname(path), "")}${MODE === "production" ? `.[contenthash]` : ""}.js`,
             };
         });
         return entryPoints;
     }),
     output: {
+        // Output filenames with content hash for fingerprinting
         filename: "js/[name].[contenthash].js",
+        // Clear files between runs
         clean: true,
         library: {
+            // Output JS files with Universal Module Definition
             type: "umd",
         },
+        // Set the output folder
         path: distFolder,
     },
     resolve: {
+        // support TSConfig paths as aliases
         plugins: [new TsconfigPathsPlugin()],
+        // resolve TS extensions
         extensions: [".tsx", ".ts", ".js", ".jsx"],
     },
     module: {
         rules: [
+            // Support Vue files if vue-loader is present
             ...vueConfig.loader,
+            // Use ESBuild loader to transpile JS & TS files
             {
                 test: /\.[jt]sx?$/,
                 use: {
                     loader: "esbuild-loader",
                     options: {
+                        // Set target to match the browserslist config
                         target: browserslistToEsbuild(),
                     },
                 },
+                // Exclude node_modules files from transpilation unless they are vue files and the vue-loader is present
                 exclude: (file) => {
                     if (vueConfig.loader.length > 0) {
                         return file.includes("node_modules") && !file.includes(".vue.js");
@@ -128,6 +149,7 @@ const compiler = webpack({
                     return file.includes("node_modules");
                 },
             },
+            // Transpile SCSS files and run the result through postcss
             {
                 test: /\.s[ac]ss$/i,
                 exclude: /node_modules/,
@@ -154,6 +176,7 @@ const compiler = webpack({
                     },
                 ],
             },
+            // Run the css files through postcss
             {
                 test: /\.css$/i,
                 exclude: /node_modules/,
@@ -177,7 +200,9 @@ const compiler = webpack({
         ],
     },
     plugins: [
+        // Output progress information when compiling
         new webpack.ProgressPlugin(),
+        // Generate a manifest file of assets to make it possible to target fingerprinted files
         new WebpackAssetsManifest({
             writeToDisk: true,
             output: `${distFolder}/assets-manifest.json`,
@@ -196,6 +221,7 @@ const compiler = webpack({
                 return entry;
             },
         }),
+        // Create an SVG sprite from a folder of provided icons
         new SVGSpritemapPlugin(`${srcFolder}/icons/*.svg`, {
             output: {
                 filename: "icons/sprite.[contenthash].svg",
@@ -207,28 +233,39 @@ const compiler = webpack({
                 },
             },
         }),
+        // Copy fonts and images from the src folder to assets (available for backwards compatibility, not recommended)
         new CopyPlugin({
             patterns: [
                 {
-                    from: `${srcFolder}/fonts`,
-                    to: "[path]fonts/[name][ext]",
+                    from: "**/*",
+                    context: resolvePath(srcFolder, "fonts"),
+                    to({ context, absoluteFilename }) {
+                        return `fonts/${relative(context, absoluteFilename ?? "")}`;
+                    },
                     noErrorOnMissing: true,
                 },
                 {
-                    from: `${srcFolder}/images`,
-                    to: "[path]images/[name][ext]",
+                    from: "**/*",
+                    context: resolvePath(srcFolder, "images"),
+                    to({ context, absoluteFilename }) {
+                        return `images/${relative(context, absoluteFilename ?? "")}`;
+                    },
                     noErrorOnMissing: true,
                 },
             ],
         }),
+        // Output a bundle analysis if flag was provided
         ...(argv.analyse ? [new BundleAnalyzerPlugin({})] : []),
+        // Extract wordpress dependencies from js files and output a wordpress assets file for enqueues
         new DependencyExtractionWebpackPlugin({
             combineAssets: true,
         }),
+        // Support Vue files if vue-loader is present
         ...vueConfig.plugin,
     ],
     optimization: {
         minimizer: [
+            // Minify JS files
             new EsbuildPlugin({
                 target: browserslistToEsbuild(),
             }),

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@atomicsmash/compiler",
 	"type": "module",
-	"version": "0.5.0",
+	"version": "0.5.1",
 	"description": "A universal compiler for all Atomic Smash projects.",
 	"keywords": [
 		"cli",