@emulsify/core 4.1.0 → 4.2.0

package/config/vite/platforms.js

@@ -5,7 +5,21 @@
  * decisions can be used by Node-side Vite config and Storybook browser code.
  */
 
-const noneAdapter = {
+/**
+ * Freeze adapter definition data while preserving cloneable plain objects.
+ *
+ * @param {object} adapter - Adapter definition.
+ * @returns {object} Frozen adapter definition.
+ */
+function freezeAdapter(adapter) {
+  return Object.freeze({
+    ...adapter,
+    storybook: Object.freeze({ ...adapter.storybook }),
+    build: Object.freeze({ ...adapter.build }),
+  });
+}
+
+const noneAdapter = freezeAdapter({
   name: 'none',
   outputStrategy: 'dist',
   storybook: {
@@ -18,9 +32,9 @@ const noneAdapter = {
   build: {
     mirrorDistComponentsToRoot: false,
   },
-};
+});
 
-const drupalAdapter = {
+const drupalAdapter = freezeAdapter({
   name: 'drupal',
   outputStrategy: 'drupal-sdc',
   storybook: {
@@ -33,13 +47,29 @@ const drupalAdapter = {
   build: {
     mirrorDistComponentsToRoot: true,
   },
-};
+});
 
-const adapters = {
+const wordpressAdapter = freezeAdapter({
+  name: 'wordpress',
+  outputStrategy: 'dist',
+  storybook: {
+    loadDrupalBehaviorShim: false,
+    attachDrupalBehaviors: false,
+    registerDrupalTwigFilters: false,
+    loadMirroredComponentCss: false,
+    allowSyncXhrSource: false,
+  },
+  build: {
+    mirrorDistComponentsToRoot: false,
+  },
+});
+
+const adapters = Object.freeze({
   none: noneAdapter,
   generic: noneAdapter,
   drupal: drupalAdapter,
-};
+  wordpress: wordpressAdapter,
+});
 
 /**
  * Deep-clone an adapter so callers can safely serialize or extend it.
@@ -80,10 +110,7 @@ export function normalizePlatformName(platform = 'none') {
  */
 export function getPlatformAdapter(platform = 'none') {
   const key = normalizePlatformName(platform);
-  if (key === 'drupal') {
-    return cloneAdapter(drupalAdapter);
-  }
-  return cloneAdapter(noneAdapter);
+  return cloneAdapter(adapters[key] || noneAdapter);
 }
 
 export { adapters };

package/config/vite/plugins/virtual-twig-asset-sources.js

@@ -16,6 +16,7 @@ export const VIRTUAL_TWIG_ASSET_SOURCES_ID =
   'virtual:emulsify-twig-asset-sources';
 const RESOLVED_VIRTUAL_TWIG_ASSET_SOURCES_ID = `\0${VIRTUAL_TWIG_ASSET_SOURCES_ID}`;
 const GENERATED_ASSET_ALIASES = new Set(['icons.svg']);
+const GENERATED_ASSET_ROOTS = ['/dist/assets'];
 const PUBLIC_ASSET_ROOTS = new Map([
   ['/assets', '/assets'],
   ['/dist/assets', '/assets'],
@@ -116,14 +117,21 @@ export function assetSourceRoots(env) {
  */
 export function generatedAssetSourceRoots(env) {
   return unique(
-    ['/dist/assets']
-      .map((root) => toAbsoluteAssetRoot(env?.projectDir, root))
+    GENERATED_ASSET_ROOTS.map((root) =>
+      toAbsoluteAssetRoot(env?.projectDir, root),
+    )
       .filter((root) => root && safeExists(root))
       .map((root) => toRootRelativePath(env?.projectDir, root))
       .filter(Boolean),
   );
 }
 
+function generatedAssetRootPrefixes() {
+  return GENERATED_ASSET_ROOTS.map((root) =>
+    `${root}/`.replace(/\/{2,}/g, '/'),
+  );
+}
+
 /**
  * Build Vite glob patterns from text asset roots.
  *
@@ -216,6 +224,20 @@ export function publicAssetSourceEntries(env) {
     }
   }
 
+  for (const root of generatedAssetRootPrefixes()) {
+    const publicBase = publicAssetBaseForRoot(root);
+    if (!publicBase) continue;
+
+    for (const alias of GENERATED_ASSET_ALIASES) {
+      const key = `${root.replace(/\/+$/, '')}/${alias}`.replace(
+        /\/{2,}/g,
+        '/',
+      );
+      const url = `${publicBase}${alias}`.replace(/\/{2,}/g, '/');
+      entries.set(key, { key, url });
+    }
+  }
+
   return Array.from(entries.values());
 }
 
@@ -232,6 +254,10 @@ export function generateVirtualTwigAssetSourcesModule(env) {
   const generatedRootPrefixes = generatedAssetSourceRoots(env).map((root) =>
     `${root === '/' ? '' : root}/`.replace(/\/{2,}/g, '/'),
   );
+  const allGeneratedRootPrefixes = unique([
+    ...generatedRootPrefixes,
+    ...generatedAssetRootPrefixes(),
+  ]);
   const patterns = assetSourceGlobPatterns(env);
   const globEntries = patterns.length
     ? patterns
@@ -255,7 +281,7 @@ export function generateVirtualTwigAssetSourcesModule(env) {
  */
 
 export const assetRootPrefixes = ${JSON.stringify(rootPrefixes)};
-export const generatedAssetRootPrefixes = ${JSON.stringify(generatedRootPrefixes)};
+export const generatedAssetRootPrefixes = ${JSON.stringify(allGeneratedRootPrefixes)};
 export const generatedAssetAliases = ${JSON.stringify(
     Array.from(GENERATED_ASSET_ALIASES),
   )};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emulsify/core",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "description": "Bundled tooling for Storybook development + Vite Build",
   "keywords": [
     "component library",
@@ -38,7 +38,10 @@
     ".storybook/css-components.js",
     ".storybook/css-dist.js",
     ".storybook/emulsifyTheme.js",
+    ".storybook/main-static-assets.js",
+    ".storybook/main-vite.js",
     ".storybook/main.js",
+    ".storybook/manager-head.css",
     ".storybook/manager.js",
     ".storybook/preview.js",
     ".storybook/utils.js",
@@ -124,6 +127,7 @@
     "./storybook/twig/source": "./src/storybook/twig/source.js",
     "./vite": "./config/vite/vite.config.js",
     "./vite/plugins": "./config/vite/plugins.js",
+    "./vite/platforms": "./config/vite/platforms.js",
     "./package.json": "./package.json"
   },
   "publishConfig": {
@@ -150,6 +154,7 @@
     "prettier": "npm run check-node-version && prettier --check --config config/.prettierrc.json --ignore-unknown \"**/*.{js,mjs,cjs,jsx,json,yml,yaml,scss,md,twig}\"",
     "prettier-fix": "npm run check-node-version && prettier --config config/.prettierrc.json --write --ignore-unknown \"**/*.{js,mjs,cjs,jsx,json,yml,yaml,scss,md,twig}\"",
     "semantic-release": "npm run check-node-version && semantic-release --config ./release.config.cjs",
+    "smoke:pack": "npm run check-node-version && node scripts/smoke-pack.js",
     "version:develop": "npm run check-node-version && node scripts/bump-version-from-commits.js",
     "storybook": "npm run check-node-version && NODE_OPTIONS=--no-deprecation storybook dev -p 6006 --no-open --exact-port",
     "storybook-build": "npm run check-node-version && storybook build -o .out",
@@ -161,7 +166,7 @@
     "@babel/core": "^7.29.7",
     "@babel/eslint-parser": "^7.28.6",
     "@babel/preset-env": "^7.28.3",
-    "@emulsify/cli": "^1.11.4",
+    "@emulsify/cli": "^2.2.0",
     "@eslint/js": "^9.39.4",
     "@storybook/addon-a11y": "^10.1.4",
     "@storybook/addon-links": "^10.1.4",
@@ -169,31 +174,27 @@
     "@storybook/react": "^10.1.4",
     "@storybook/react-vite": "^10.1.4",
     "@vituum/vite-plugin-twig": "^1.1.0",
-    "autoprefixer": "^10.4.21",
+    "autoprefixer": "^10.5.2",
     "axe-core": "^4.11.4",
     "babel-preset-minify": "^0.5.2",
     "concurrently": "^9.2.3",
     "eslint": "^9.39.4",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-jest": "^29.0.1",
+    "eslint-plugin-jest": "^29.15.4",
     "eslint-plugin-prettier": "^5.5.4",
-    "eslint-plugin-security": "^4.0.0",
-    "eslint-plugin-storybook": "^10.1.4",
-    "fs-extra": "^11.3.1",
+    "eslint-plugin-security": "^4.0.1",
+    "eslint-plugin-storybook": "^10.4.6",
     "glob": "^13.0.6",
-    "graceful-fs": "^4.2.11",
     "jest": "^30.2.0",
     "jest-environment-jsdom": "^30.2.0",
     "js-yaml": "^4.1.0",
     "normalize.css": "^8.0.1",
     "open-cli": "^9.0.0",
     "pa11y": "^9.0.1",
-    "postcss": "^8.5.4",
+    "postcss": "^8.5.16",
     "postcss-scss": "^4.0.9",
-    "ramda": "^0.32.0",
-    "regenerator-runtime": "^0.14.1",
-    "sass": "^1.93.2",
+    "sass": "^1.101.0",
     "storybook": "^10.1.4",
     "stylelint": "^17.12.0",
     "stylelint-config-standard-scss": "^17.0.0",
@@ -208,18 +209,18 @@
     "yaml": "^2.8.1"
   },
   "devDependencies": {
-    "@commitlint/cli": "^21.0.1",
-    "@commitlint/config-conventional": "^21.0.1",
+    "@commitlint/cli": "^21.2.0",
+    "@commitlint/config-conventional": "^21.2.0",
     "@semantic-release/changelog": "^6.0.2",
     "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/git": "^10.0.1",
-    "@semantic-release/github": "^12.0.8",
+    "@semantic-release/github": "^12.0.9",
     "@semantic-release/npm": "^13.1.5",
     "@semantic-release/release-notes-generator": "^14.1.0",
     "husky": "^9.1.7",
-    "lint-staged": "^17.0.5",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
+    "lint-staged": "^17.0.8",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
     "semantic-release": "^25.0.3"
   },
   "peerDependencies": {

package/scripts/a11y.js

@@ -8,7 +8,6 @@
 import { existsSync, readFileSync } from 'fs';
 import path from 'path';
 import { fileURLToPath, pathToFileURL } from 'url';
-import * as R from 'ramda';
 import pa11y from 'pa11y';
 
 import a11yConfig from '../config/a11y.config.js';
@@ -210,11 +209,12 @@ const resolvePa11yStoryIds = ({
  * @param {'error'|'warning'|'notice'} severity
  * @returns {'red'|'yellow'|'blue'|undefined}
  */
-const severityToColor = R.cond([
-  [R.equals('error'), R.always('red')],
-  [R.equals('warning'), R.always('yellow')],
-  [R.equals('notice'), R.always('blue')],
-]);
+const severityToColor = (severity) =>
+  ({
+    error: 'red',
+    warning: 'yellow',
+    notice: 'blue',
+  })[severity];
 
 /**
  * @typedef {Object} Pa11yIssue
@@ -297,25 +297,20 @@ const lintComponent = async (name) =>
  * @param {string[]} names - List of Storybook story IDs.
  * @returns {Promise<void>}
  */
-const lintReportAndExit = R.pipe(
-  /** @param {string[]} list */
-  (list) => list.map(lintComponent),
-  (promises) => Promise.all(promises),
-  R.andThen(
-    R.pipe(
-      /** @param {Array<{issues: Pa11yIssue[], pageUrl: string}>} results */
-      (results) => results.map(logReport),
-      R.reject(R.equals(false)),
-      R.unless(R.isEmpty, () => process.exit(1)),
-    ),
-  ),
-);
+const lintReportAndExit = async (names) => {
+  const results = await Promise.all(names.map(lintComponent));
+  const hasIssues = results.map(logReport).some(Boolean);
+
+  if (hasIssues) {
+    process.exit(1);
+  }
+};
 
 // Only perform linting/reporting when instructed via "-r".
 /* istanbul ignore next */
-if (R.includes(process.argv[2], ['-h', '--help'])) {
+if (['-h', '--help'].includes(process.argv[2])) {
   printHelp();
-} else if (R.pathEq(['argv', 2], '-r')(process)) {
+} else if (process.argv[2] === '-r') {
   loadProjectA11yConfig().then((projectConfig) => {
     applyProjectA11yConfig(projectConfig);
     return lintReportAndExit(resolvePa11yStoryIds());

package/src/storybook/twig/source-function.js

@@ -84,7 +84,7 @@ function warnTextAssetSource(relPath, reason) {
 
   warnedAssetSources.add(relPath);
   console.warn(
-    `source(): ${reason} for @assets/${relPath}. Synchronous XHR fallback is disabled by default because it blocks Storybook rendering. Move the asset under a configured asset root such as src/assets or assets, or temporarily enable platformAdapter.storybook.allowSyncXhrSource. The sync-XHR fallback is deprecated and will be removed in 4.2.`,
+    `source(): ${reason} for @assets/${relPath}. Synchronous XHR fallback is disabled by default because it blocks Storybook rendering. Move the asset under a configured asset root such as src/assets or assets, or temporarily enable platformAdapter.storybook.allowSyncXhrSource. The sync-XHR fallback is deprecated and scheduled for removal in a future major release.`,
   );
 }