@aemvite/aem-config 0.3.1 → 0.5.0

package/CHANGELOG.md

@@ -5,6 +5,23 @@ All notable changes to **@aemvite/aem-config** will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.0] - 2026-06-26
+
+### Added
+- `@aemvite/vite-plugin-aem-css-url-passthrough` wired in as a new transitive dependency; consumers get it automatically via `@aemvite/aem-config`.
+- Plugin dependency ranges bumped to `^0.5.0`.
+
+## [0.4.0] - 2026-06-26
+
+### Added
+- Sourcemap support in the build orchestrator: external sourcemaps emitted by Vite are staged under `resources/sourcemaps/` and `sourceMappingURL` comments in JS/CSS are rewritten to point at the AEM-served resources path.
+- `sourcemapPathTransform` in Rollup output options rewrites `sources[]` entries to `aemvite://<clientlib>/` virtual URLs for clean DevTools grouping.
+- Symlink resolution via `realpathOrSelf` so path transforms work correctly on macOS where `/var` resolves to `/private/var`.
+
+### Changed
+- Plugin dependency ranges bumped to `^0.4.0`.
+- ES build target updated to `es2026`.
+
 ## [0.3.1] - 2026-06-26
 
 ### Added

package/README.md

@@ -170,6 +170,18 @@ asset and lets the other fall through to the next layer. So in production,
 
 `sourcemap` and `target` are simple overrides — the higher layer wins entirely.
 
+When `sourcemap` is `true` (or `"hidden"`), `buildClientlibs` post-processes
+the Vite output so the emitted `.map` files land at
+`clientlib-<name>/resources/sourcemaps/` (AEM serves them as static
+resources) and the `//# sourceMappingURL=` comment inside the staged `.js` /
+`.css` is rewritten to match. The `sources[]` array in each map is also
+rewritten to a virtual `aemvite://<clientlib>/<project-relative>` URL so the
+DevTools Sources tree is fetch-free, ignore-list-safe, and grouped by
+clientlib. `"inline"` skips this layout — the map lives inside the `.js` as a
+base64 data URI. See the
+[Sourcemaps section in the root README](https://github.com/LucaNerlich/aem-vite#sourcemaps-when-enabled)
+for the full on-disk layout, runtime resolution, and rationale.
+
 ### Global override
 
 ```ts

package/dist/buildClientlibs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildClientlibs.d.ts","sourceRoot":"","sources":["../src/buildClientlibs.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,sBAAsB,EAEtB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAOpB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA0CxD"}
+{"version":3,"file":"buildClientlibs.d.ts","sourceRoot":"","sources":["../src/buildClientlibs.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,sBAAsB,EAGtB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAOpB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAiDxD"}

package/dist/buildClientlibs.js

@@ -1,5 +1,6 @@
 import path from "node:path";
-import { readdir, rm } from "node:fs/promises";
+import { realpathSync } from "node:fs";
+import { readdir, readFile, rm, writeFile } from "node:fs/promises";
 import { loadAemConfig } from "./loadAemConfig.js";
 import { resolveBuildOptions } from "./resolveBuildOptions.js";
 /**
@@ -29,15 +30,17 @@ export async function buildClientlibs(options) {
     const outDir = path.resolve(configDir, options.outDir ?? "dist");
     const config = await loadAemConfig(configPath);
     const clientLibRoot = path.resolve(configDir, config.clientLibRoot);
-    const [vite, glob, resources, clientlibPkg] = await Promise.all([
+    const [vite, glob, resources, cssUrl, clientlibPkg] = await Promise.all([
         import("vite"),
         import("@aemvite/vite-plugin-glob"),
         import("@aemvite/vite-plugin-aem-resources"),
+        import("@aemvite/vite-plugin-aem-css-url-passthrough"),
         import("@aemvite/vite-plugin-aem-clientlib"),
     ]);
     const { build: viteBuild, mergeConfig } = vite;
     const { aemViteGlob } = glob;
     const { aemResources } = resources;
+    const { aemCssUrlPassthrough } = cssUrl;
     const { emitClientlib } = clientlibPkg;
     // Wipe the shared staging root once so subsequent per-clientlib builds
     // accumulate into it without stale files.
@@ -49,20 +52,35 @@ export async function buildClientlibs(options) {
             await viteBuild(buildInlineConfig(clientlib, config, configDir, stagingDir, mode, {
                 aemViteGlob,
                 aemResources,
+                aemCssUrlPassthrough,
                 mergeConfig,
             }));
+            // When Vite emitted external sourcemaps, rewrite the `sourceMappingURL`
+            // comment in the staged .js/.css to point at the resources path AEM
+            // will actually serve them from (see `collectStagedFiles`).
+            await rewriteSourceMappingUrls(stagingDir, clientlib.name);
             await collectStagedFiles(stagingDir, files);
         }
         await emitClientlib({ clientlib, outDir: clientLibRoot, files });
     }
     return { config, outDir };
 }
-function buildInlineConfig(clientlib, config, configDir, stagingDir, mode, { aemViteGlob, aemResources, mergeConfig }) {
+function buildInlineConfig(clientlib, config, configDir, stagingDir, mode, { aemViteGlob, aemResources, aemCssUrlPassthrough, mergeConfig }) {
     const entry = path.resolve(configDir, clientlib.entry);
     const resolved = resolveBuildOptions(mode, config.build, clientlib.build);
+    // Resolve symlinks (e.g. macOS `/var` → `/private/var`) so the sourcemap
+    // path transform can reconcile with Rollup's real-path source references.
+    const realConfigDir = realpathOrSelf(configDir);
     const resourceEntries = (clientlib.resources ?? []).map((from) => ({
         from: path.resolve(configDir, from),
     }));
+    // Per-clientlib value wins; explicit `false` opts out of an inherited global.
+    const cssUrlOption = clientlib.cssUrlPassthrough !== undefined
+        ? clientlib.cssUrlPassthrough
+        : config.cssUrlPassthrough;
+    const cssUrlPlugin = cssUrlOption
+        ? [aemCssUrlPassthrough(cssUrlOption === true ? {} : cssUrlOption)]
+        : [];
     let inlineConfig = {
         configFile: false,
         root: configDir,
@@ -71,6 +89,7 @@ function buildInlineConfig(clientlib, config, configDir, stagingDir, mode, { aem
         plugins: [
             aemViteGlob(),
             ...(resourceEntries.length ? [aemResources(resourceEntries)] : []),
+            ...cssUrlPlugin,
             ...(config.plugins ?? []),
             ...(clientlib.plugins ?? []),
         ],
@@ -96,6 +115,23 @@ function buildInlineConfig(clientlib, config, configDir, stagingDir, mode, { aem
                     assetFileNames: (info) => (info.name ?? "").toLowerCase().endsWith(".css")
                         ? `${clientlib.name}.css`
                         : "[name][extname]",
+                    // Rewrite sourcemap `sources[]` to a stable virtual URL rooted at
+                    // the consumer project so DevTools (a) doesn't try to fetch the
+                    // original files from the served `.js` path (where they don't
+                    // exist) and (b) groups them under a clean `aemvite://<clientlib>/`
+                    // tree in the Sources panel. `relativeSourcePath` is relative to
+                    // the emitted `.map` file (i.e. the staging dir). We anchor on
+                    // `stagingDir` and use the real (symlink-resolved) project root so
+                    // paths reconcile cleanly on macOS where `/var` → `/private/var`.
+                    // Vite/Rollup only invokes this when sourcemaps are emitted.
+                    sourcemapPathTransform: (relativeSourcePath) => {
+                        const abs = path.resolve(stagingDir, relativeSourcePath);
+                        const rel = path
+                            .relative(realConfigDir, abs)
+                            .split(path.sep)
+                            .join("/");
+                        return `aemvite://${clientlib.name}/${rel}`;
+                    },
                 },
             },
         },
@@ -106,24 +142,95 @@ function buildInlineConfig(clientlib, config, configDir, stagingDir, mode, { aem
         inlineConfig = mergeConfig(inlineConfig, clientlib.vite);
     return inlineConfig;
 }
-/** Stage the per-entry JS/CSS plus any copied `resources/` tree. */
+/**
+ * Stage the per-entry JS/CSS plus any copied `resources/` tree, and route any
+ * sourcemap siblings (`*.js.map` / `*.css.map`) under `resources/sourcemaps/`
+ * so AEM serves them as plain static files. The emitter's `resources` bucket
+ * preserves the nested `sourcemaps/` prefix from the basename.
+ *
+ * AEM's clientlib aggregator concatenates `js/` / `css/` contents into one
+ * served response, and Sling URL decomposition (`site.js.map` → selectors=js,
+ * extension=map) 404s the top-level proxy path. Routing maps through the
+ * `resources/` subtree avoids both problems — the `sourceMappingURL` comment
+ * in the JS/CSS is rewritten to match (see `rewriteSourceMappingUrls`).
+ */
 async function collectStagedFiles(stagingDir, files) {
     for (const entry of await readdir(stagingDir, { withFileTypes: true })) {
         if (!entry.isFile())
             continue;
-        const ext = path.extname(entry.name).toLowerCase();
-        if (ext === ".js" || ext === ".css") {
+        const lower = entry.name.toLowerCase();
+        const ext = path.extname(lower);
+        const isCodeFile = ext === ".js" || ext === ".css";
+        const isSourcemap = lower.endsWith(".js.map") || lower.endsWith(".css.map");
+        if (isCodeFile) {
             files.push({
                 source: path.join(stagingDir, entry.name),
                 basename: entry.name,
             });
         }
+        else if (isSourcemap) {
+            // Nested basename routes the map to `resources/sourcemaps/<file>` via
+            // the emitter's `resources` bucket (classifyFile routes `.map` there).
+            files.push({
+                source: path.join(stagingDir, entry.name),
+                basename: `sourcemaps/${entry.name}`,
+            });
+        }
     }
     const resourcesDir = path.join(stagingDir, "resources");
     for (const rel of await walk(resourcesDir)) {
         files.push({ source: path.join(resourcesDir, rel), basename: rel });
     }
 }
+/**
+ * Rewrite the `sourceMappingURL` comment in every staged `.js` / `.css` so it
+ * points at the AEM-served resources path where `collectStagedFiles` will
+ * deposit the corresponding `.map`. The browser resolves `sourceMappingURL`
+ * relative to the served code URL; for an AEM clientlib aggregated at
+ * `/etc.clientlibs/<proj>/clientlibs/clientlib-<name>.js`, a relative URL of
+ * `clientlib-<name>/resources/sourcemaps/<file>.map` resolves to the static
+ * resource served by AEM at the same path.
+ *
+ * Vite emits the comment as the final line(s) of the file:
+ *   JS:  `//# sourceMappingURL=site.js.map`
+ *   CSS: `/*# sourceMappingURL=site.css.map *\/`
+ * We rewrite only the URL token, leaving everything else untouched.
+ */
+async function rewriteSourceMappingUrls(stagingDir, clientlibName) {
+    let entries;
+    try {
+        entries = await readdir(stagingDir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        const lower = entry.name.toLowerCase();
+        if (lower.endsWith(".map"))
+            continue;
+        if (!lower.endsWith(".js") && !lower.endsWith(".css"))
+            continue;
+        const full = path.join(stagingDir, entry.name);
+        const content = await readFile(full, "utf8");
+        const mapName = `${entry.name}.map`;
+        const newUrl = `clientlib-${clientlibName}/resources/sourcemaps/${mapName}`;
+        let rewritten = content.replace(/\/\/# sourceMappingURL=[^\s]+/, `//# sourceMappingURL=${newUrl}`);
+        rewritten = rewritten.replace(/\/\*# sourceMappingURL=[^\s]+ \*\//, `/*# sourceMappingURL=${newUrl} */`);
+        if (rewritten !== content) {
+            await writeFile(full, rewritten, "utf8");
+        }
+    }
+}
+function realpathOrSelf(p) {
+    try {
+        return realpathSync(p);
+    }
+    catch {
+        return p;
+    }
+}
 async function walk(dir, prefix = "") {
     let entries;
     try {

package/dist/buildClientlibs.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildClientlibs.js","sourceRoot":"","sources":["../src/buildClientlibs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"buildClientlibs.js","sourceRoot":"","sources":["../src/buildClientlibs.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -4,5 +4,5 @@ export { mergeDefaults } from "./mergeDefaults.js";
 export { buildClientlibs } from "./buildClientlibs.js";
 export { defaults, defaultTarget, modeBaselines } from "./defaults.js";
 export { resolveBuildOptions } from "./resolveBuildOptions.js";
-export type { AemClientlib, AemConfig, BuildClientlibsOptions, BuildMode, BuildOptions, ProcessorList, ResolvedAemClientlib, ResolvedAemConfig, ResolvedBuildOptions, } from "./types.js";
+export type { AemClientlib, AemConfig, BuildClientlibsOptions, BuildMode, BuildOptions, CssUrlPassthroughOption, ProcessorList, ResolvedAemClientlib, ResolvedAemConfig, ResolvedBuildOptions, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EACV,YAAY,EACZ,SAAS,EACT,sBAAsB,EACtB,SAAS,EACT,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EACV,YAAY,EACZ,SAAS,EACT,sBAAsB,EACtB,SAAS,EACT,YAAY,EACZ,uBAAuB,EACvB,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/mergeDefaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mergeDefaults.d.ts","sourceRoot":"","sources":["../src/mergeDefaults.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,SAAS,EAET,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,iBAAiB,CAYlE"}
+{"version":3,"file":"mergeDefaults.d.ts","sourceRoot":"","sources":["../src/mergeDefaults.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,SAAS,EAET,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,iBAAiB,CAelE"}

package/dist/mergeDefaults.js

@@ -16,6 +16,9 @@ export function mergeDefaults(config) {
         clientLibRoot: config.clientLibRoot,
         clientlibs,
         ...(config.build !== undefined ? { build: config.build } : {}),
+        ...(config.cssUrlPassthrough !== undefined
+            ? { cssUrlPassthrough: config.cssUrlPassthrough }
+            : {}),
         ...(config.plugins !== undefined ? { plugins: config.plugins } : {}),
         ...(config.vite !== undefined ? { vite: config.vite } : {}),
     };

package/dist/mergeDefaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"mergeDefaults.js","sourceRoot":"","sources":["../src/mergeDefaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAQzC;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,MAAiB;IAC7C,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CACrD,gBAAgB,CAAC,SAAS,EAAE,YAAY,CAAC,CAC1C,CAAC;IACF,OAAO;QACL,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,UAAU;QACV,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,SAAuB,EACvB,YAAmC;IAEnC,MAAM,MAAM,GAAiB;QAC3B,GAAG,QAAQ;QACX,GAAG,YAAY;QACf,GAAG,SAAS;KACb,CAAC;IACF,OAAO;QACL,GAAG,MAAM;QACT,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU;QACpD,mBAAmB,EACjB,MAAM,CAAC,mBAAmB,IAAI,QAAQ,CAAC,mBAAmB;QAC5D,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,QAAQ,CAAC,YAAY;QAC1D,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW;KACxD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"mergeDefaults.js","sourceRoot":"","sources":["../src/mergeDefaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAQzC;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,MAAiB;IAC7C,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CACrD,gBAAgB,CAAC,SAAS,EAAE,YAAY,CAAC,CAC1C,CAAC;IACF,OAAO;QACL,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,UAAU;QACV,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,CAAC,MAAM,CAAC,iBAAiB,KAAK,SAAS;YACxC,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE;YACjD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,SAAuB,EACvB,YAAmC;IAEnC,MAAM,MAAM,GAAiB;QAC3B,GAAG,QAAQ;QACX,GAAG,YAAY;QACf,GAAG,SAAS;KACb,CAAC;IACF,OAAO;QACL,GAAG,MAAM;QACT,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU;QACpD,mBAAmB,EACjB,MAAM,CAAC,mBAAmB,IAAI,QAAQ,CAAC,mBAAmB;QAC5D,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,QAAQ,CAAC,YAAY;QAC1D,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW;KACxD,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -1,5 +1,17 @@
 import type { PluginOption, UserConfig } from "vite";
 export type ProcessorList = readonly string[];
+/**
+ * Toggle / configure the CSS `url()` passthrough plugin
+ * (`@aemvite/vite-plugin-aem-css-url-passthrough`). When truthy, the plugin
+ * is auto-wired into each clientlib's build.
+ *
+ * - `true` — wire with default `resourceDirs` (`["images", "fonts"]`).
+ * - `false` — explicitly disable (overrides a global `true`).
+ * - object — wire with the supplied options.
+ */
+export type CssUrlPassthroughOption = boolean | {
+    resourceDirs?: readonly string[];
+};
 /**
  * Author-facing build options. Each field is optional and overlays on top of
  * the mode baseline (development/production) and the global `AemConfig.build`.
@@ -51,6 +63,12 @@ export interface AemClientlib {
     jsProcessor?: ProcessorList;
     /** Per-clientlib build overrides; layered over `AemConfig.build`. */
     build?: BuildOptions;
+    /**
+     * Per-clientlib override for the CSS `url()` passthrough plugin. Takes
+     * precedence over the global `AemConfig.cssUrlPassthrough`. Set explicitly
+     * to `false` to opt out when the global is enabled.
+     */
+    cssUrlPassthrough?: CssUrlPassthroughOption;
     /**
      * Extra Vite plugins applied to this clientlib's build, after the built-in
      * `aemViteGlob` / `aemResources` and after `AemConfig.plugins`. Lets advanced
@@ -72,6 +90,14 @@ export interface AemConfig {
     defaults?: Partial<AemClientlib>;
     /** Global build options applied to every clientlib (overridden per-clientlib). */
     build?: BuildOptions;
+    /**
+     * Auto-wire `@aemvite/vite-plugin-aem-css-url-passthrough` into every
+     * clientlib build. Restores webpack `css-loader: { url: false }` semantics:
+     * rewrites every `url(...)` containing `resources/<sub>/` back to the
+     * canonical `../resources/<sub>/<file>` form. Override per-clientlib via
+     * `AemClientlib.cssUrlPassthrough`.
+     */
+    cssUrlPassthrough?: CssUrlPassthroughOption;
     /**
      * Extra Vite plugins applied to every clientlib build, after the built-in
      * `aemViteGlob` / `aemResources` and before any per-clientlib `plugins`.
@@ -86,6 +112,8 @@ export interface ResolvedAemConfig {
     clientlibs: ResolvedAemClientlib[];
     /** Raw global build options (resolved per-mode at build time). */
     build?: BuildOptions;
+    /** Global CSS `url()` passthrough toggle (resolved per-clientlib at build time). */
+    cssUrlPassthrough?: CssUrlPassthroughOption;
     /** Global extra Vite plugins (applied to every clientlib build). */
     plugins?: PluginOption[];
     /** Global deep Vite config override. */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAErD,MAAM,MAAM,aAAa,GAAG,SAAS,MAAM,EAAE,CAAC;AAE9C;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,OAAO,GAAG;QAAE,EAAE,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACnD,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC;IACtC,SAAS,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACzC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,kDAAkD;IAClD,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,qCAAqC;IACrC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,gEAAgE;IAChE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,mBAAmB,CAAC,EAAE,KAAK,CAAC;IAC5B,oCAAoC;IACpC,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,mCAAmC;IACnC,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,qEAAqE;IACrE,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,aAAa,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACjC,kFAAkF;IAClF,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAC7C,QAAQ,CACN,IAAI,CACF,YAAY,EACZ,YAAY,GAAG,qBAAqB,GAAG,cAAc,GAAG,aAAa,CACtE,CACF,CAAC;AAEJ,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,kEAAkE;IAClE,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,oEAAoE;IACpE,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,wCAAwC;IACxC,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,YAAY,CAAC;AAErD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aemvite/aem-config",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "description": "Typed config helper, loader, and Vite build orchestrator for AEM clientlib packages.",
   "keywords": [
     "aem",
@@ -52,9 +52,10 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@aemvite/vite-plugin-aem-clientlib": "^0.2.0",
-    "@aemvite/vite-plugin-aem-resources": "^0.2.0",
-    "@aemvite/vite-plugin-glob": "^0.2.0"
+    "@aemvite/vite-plugin-aem-clientlib": "^0.5.0",
+    "@aemvite/vite-plugin-aem-css-url-passthrough": "^0.5.0",
+    "@aemvite/vite-plugin-aem-resources": "^0.5.0",
+    "@aemvite/vite-plugin-glob": "^0.5.0"
   },
   "peerDependencies": {
     "esbuild": "^0.28",