@emulsify/core 4.3.2 → 4.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emulsify/core",
-  "version": "4.3.2",
+  "version": "4.5.0",
   "description": "Bundled tooling for Storybook development + Vite Build",
   "keywords": [
     "component library",
@@ -52,6 +52,7 @@
     "assets/**/*",
     "config/.prettierrc.json",
     "config/.stylelintrc.json",
+    "config/a11y-wcag22.js",
     "config/a11y.config.js",
     "config/babel.config.js",
     "config/eslint.config.js",
@@ -59,11 +60,18 @@
     "config/vite/entries.js",
     "config/vite/environment.js",
     "config/vite/platforms.js",
+    "config/vite/plugins.js",
+    "config/vite/plugins/assets/asset-url-rebase.js",
     "config/vite/plugins/assets/copy-src-assets.js",
     "config/vite/plugins/assets/copy-twig-files.js",
+    "config/vite/plugins/assets/css-asset-rebase.js",
     "config/vite/plugins/assets/css-asset-relativizer.js",
+    "config/vite/plugins/assets/development-source-maps.js",
     "config/vite/plugins/assets/mirror-components.js",
+    "config/vite/plugins/assets/output-freshness.js",
     "config/vite/plugins/assets/source-file-index.js",
+    "config/vite/plugins/assets/stable-watch-output.js",
+    "config/vite/plugins/assets/storybook-output.js",
     "config/vite/plugins/assets/svg-sprite.js",
     "config/vite/plugins/index.js",
     "config/vite/plugins/reporter/asset-resolver.js",
@@ -74,6 +82,7 @@
     "config/vite/plugins/reporter/render.js",
     "config/vite/plugins/reporter/sass-logger.js",
     "config/vite/plugins/reporter/source-roots.js",
+    "config/vite/plugins/reporter/strict-mode.js",
     "config/vite/plugins/reporter/verbosity.js",
     "config/vite/plugins/reporter/vite-logger.js",
     "config/vite/plugins/reporter/watch-mode.js",
@@ -85,23 +94,24 @@
     "config/vite/plugins/twig/virtual-twig-globs.js",
     "config/vite/plugins/twig/vituum-patch.js",
     "config/vite/plugins/yaml-module.js",
-    "config/vite/plugins.js",
     "config/vite/project-config.js",
     "config/vite/project-extensions.js",
     "config/vite/project-structure.js",
+    "config/vite/utils/asset-roots.js",
+    "config/vite/utils/css-urls.js",
     "config/vite/utils/fs-safe.js",
     "config/vite/utils/lru.js",
     "config/vite/utils/package-version.js",
     "config/vite/utils/paths.js",
     "config/vite/utils/react-singleton.js",
+    "config/vite/utils/source-directory-skips.js",
+    "config/vite/utils/source-maps.js",
+    "config/vite/utils/twig-component-resolver.js",
     "config/vite/vite.config.js",
     "scripts/a11y.js",
+    "scripts/audit-twig-stories.js",
     "scripts/audit.js",
     "scripts/audit/**/*.js",
-    "!scripts/audit/**/*.test.js",
-    "!scripts/audit/**/__snapshots__/**",
-    "!scripts/audit/test-utils.js",
-    "scripts/audit-twig-stories.js",
     "scripts/check-node-version.js",
     "scripts/inspect-components.js",
     "scripts/lib/cli.js",
@@ -139,7 +149,10 @@
     "src/storybook/twig/resolver.js",
     "src/storybook/twig/setup.js",
     "src/storybook/twig/source-function.js",
-    "src/storybook/twig/source.js"
+    "src/storybook/twig/source.js",
+    "!scripts/audit/**/*.test.js",
+    "!scripts/audit/**/__snapshots__/**",
+    "!scripts/audit/test-utils.js"
   ],
   "exports": {
     ".": "./src/extensions/index.js",
@@ -151,13 +164,15 @@
     "./storybook/twig/include-function": "./src/storybook/twig/include-function.js",
     "./storybook/twig/source-function": "./src/storybook/twig/source-function.js",
     "./storybook/twig/source": "./src/storybook/twig/source.js",
+    "./a11y/wcag22": "./config/a11y-wcag22.js",
     "./vite": "./config/vite/vite.config.js",
     "./vite/plugins": "./config/vite/plugins.js",
     "./vite/platforms": "./config/vite/platforms.js",
     "./package.json": "./package.json"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   },
   "config": {
     "scripts-prepend-node-path": "auto"
@@ -184,7 +199,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}\"",
     "release:analyze": "npm run check-node-version && node scripts/verify-release-analysis.js",
-    "release:verify": "npm run check-node-version && npm run lint && npm test && npm run storybook-build && npm run fixtures:release && npm run fixtures:consumer && npm run pack:dry-run && npm run smoke:pack && npm run release:analyze",
+    "release:verify": "node scripts/release-evidence.js verify",
     "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",
@@ -197,61 +212,60 @@
   "dependencies": {
     "@babel/core": "^7.29.7",
     "@babel/eslint-parser": "^7.29.7",
+    "@babel/parser": "^7.29.8",
     "@babel/preset-env": "^7.29.7",
-    "@emulsify/cli": "^2.2.0",
+    "@emulsify/cli": "^2.4.1",
     "@eslint/js": "^9.39.5",
     "@mlnop/vite-plugin-sass-glob-import": "^6.2.0",
-    "@storybook/addon-a11y": "^10.5.4",
-    "@storybook/addon-links": "^10.5.4",
-    "@storybook/addon-themes": "^10.5.4",
-    "@storybook/react": "^10.5.4",
-    "@storybook/react-vite": "^10.5.4",
+    "@storybook/addon-a11y": "^10.6.0",
+    "@storybook/addon-links": "^10.6.0",
+    "@storybook/addon-themes": "^10.6.0",
+    "@storybook/react": "^10.6.0",
+    "@storybook/react-vite": "^10.6.0",
     "@vituum/vite-plugin-twig": "^2.0.1",
-    "autoprefixer": "^10.5.4",
-    "axe-core": "^4.12.1",
+    "autoprefixer": "^10.5.6",
+    "axe-core": "^4.13.0",
     "babel-preset-minify": "^0.5.2",
-    "concurrently": "^10.0.4",
+    "concurrently": "^10.0.5",
     "eslint": "^9.39.5",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-jest": "^29.16.0",
+    "eslint-plugin-jest": "^29.16.6",
     "eslint-plugin-prettier": "^5.5.6",
     "eslint-plugin-security": "^4.0.1",
-    "eslint-plugin-storybook": "^10.5.4",
+    "eslint-plugin-storybook": "^10.6.0",
     "glob": "^13.0.6",
-    "jest": "^30.4.2",
-    "jest-environment-jsdom": "^30.4.1",
-    "js-yaml": "^5.2.2",
+    "jest": "^30.5.1",
+    "jest-environment-jsdom": "^30.5.1",
+    "js-yaml": "^5.4.1",
     "normalize.css": "^8.0.1",
     "open-cli": "^9.0.0",
     "pa11y": "^9.1.1",
-    "postcss": "^8.5.23",
+    "postcss": "^8.5.28",
     "postcss-scss": "^4.0.9",
-    "sass": "^1.102.0",
-    "storybook": "^10.5.4",
-    "stylelint": "^17.14.1",
+    "sass": "^1.104.0",
+    "storybook": "^10.6.0",
+    "stylelint": "^17.15.0",
     "stylelint-config-standard-scss": "^17.0.0",
     "stylelint-prettier": "^5.0.3",
     "stylelint-selector-bem-pattern": "^5.0.0",
     "twig": "^3.0.0",
     "twig-drupal-filters": "^3.2.0",
-    "vite": "^8.1.5"
+    "vite": "^8.3.0"
   },
   "devDependencies": {
-    "@commitlint/cli": "^21.2.1",
-    "@commitlint/config-conventional": "^21.2.0",
-    "@semantic-release/changelog": "^7.0.0",
+    "@commitlint/cli": "^21.2.2",
+    "@commitlint/config-conventional": "^21.2.2",
     "@semantic-release/commit-analyzer": "^13.0.1",
-    "@semantic-release/git": "^11.0.1",
     "@semantic-release/github": "^12.0.9",
     "@semantic-release/npm": "^13.1.5",
     "@semantic-release/release-notes-generator": "^14.1.1",
     "husky": "^9.1.7",
-    "lint-staged": "^17.2.0",
-    "puppeteer": "^25.3.0",
-    "react": "^19.2.8",
-    "react-dom": "^19.2.8",
-    "semantic-release": "^25.0.8"
+    "lint-staged": "^17.5.1",
+    "puppeteer": "^25.10.0",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "semantic-release": "^25.0.9"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
@@ -263,11 +277,11 @@
     "minimatch@3.0.x": "^3.1.5"
   },
   "allowScripts": {
+    "fsevents@2.3.3": true,
+    "unrs-resolver@1.12.2": true,
     "@parcel/watcher@2.6.0": true,
     "esbuild@0.28.1": true,
-    "fsevents@2.3.3": true,
     "puppeteer@24.43.1": true,
-    "unrs-resolver@1.12.2": true,
-    "puppeteer@25.4.0": true
+    "puppeteer@25.10.0": true
   }
 }

package/scripts/a11y.js

@@ -15,6 +15,7 @@ import a11yConfig from '../config/a11y.config.js';
 
 // Project-specific configuration.
 let {
+  concurrency = 2,
   ignore = {},
   components = [],
   discoverStories = true,
@@ -49,10 +50,16 @@ const loadProjectA11yConfig = async (projectDir = process.cwd()) => {
 /**
  * Apply project-specific a11y config values over shared defaults.
  *
- * @param {{ignore?: object, components?: string[], discoverStories?: boolean, storybookBuildDir?: string, pa11y?: object}} config - Project config.
+ * @param {{concurrency?: number, ignore?: object, components?: string[], discoverStories?: boolean, storybookBuildDir?: string, pa11y?: object}} config - Project config.
  * @returns {void}
  */
 const applyProjectA11yConfig = (config = {}) => {
+  if (config.concurrency !== undefined) {
+    if (!Number.isSafeInteger(config.concurrency) || config.concurrency < 1) {
+      throw new Error('Accessibility concurrency must be a positive integer.');
+    }
+    concurrency = config.concurrency;
+  }
   ignore = config.ignore || ignore;
   components = Array.isArray(config.components)
     ? config.components
@@ -353,14 +360,23 @@ const logReport = ({ issues, pageUrl }) => {
   return hasIssues;
 };
 
+/**
+ * Build the requested URL consistently for scans and execution-failure reports.
+ * @param {string} name - Story ID.
+ * @param {{baseUrl?: string}} [options={}] - Storybook origin options.
+ * @returns {string} Requested story URL.
+ */
+const storyUrl = (name, { baseUrl } = {}) =>
+  `${baseUrl || resolveStorybookIframe()}?id=${name}`;
+
 /**
  * Run pa11y on a single Storybook story by its ID.
  * @param {string} name - Story ID (e.g., "components-button--primary").
  * @param {{baseUrl?: string}} [options={}] - Storybook origin options.
  * @returns {Promise<{ issues: Pa11yIssue[], pageUrl: string }>} Pa11y result.
  */
-const lintComponent = async (name, { baseUrl } = {}) =>
-  pa11y(`${baseUrl || resolveStorybookIframe()}?id=${name}`, {
+const lintComponent = async (name, options = {}) =>
+  pa11y(storyUrl(name, options), {
     includeNotices: true,
     includeWarnings: true,
     runners: ['axe'],
@@ -368,19 +384,82 @@ const lintComponent = async (name, { baseUrl } = {}) =>
   });
 
 /**
- * Lint a list of components, log reports, and exit(1) if any have issues.
+ * @typedef {Object} StoryOutcome
+ * @property {string} storyId - Selected Storybook story ID.
+ * @property {string} url - Requested story URL, even when navigation fails.
+ * @property {'completed'|'failed'} status - Scan execution outcome.
+ * @property {object} [report] - Completed Pa11y report.
+ * @property {Error} [error] - Contextual execution error with the original cause.
+ */
+
+/**
+ * Lint every selected story and report all outcomes before rejecting failures.
+ *
+ * Reportable findings set a nonzero exit status. Execution failures also reject
+ * with an AggregateError whose errors preserve story context and original causes.
  * @param {string[]} names - List of Storybook story IDs.
  * @param {{baseUrl?: string}} [options={}] - Storybook origin options.
  * @returns {Promise<void>}
  */
 const lintReportAndExit = async (names, options = {}) => {
-  const results = await Promise.all(
-    names.map((name) => lintComponent(name, options)),
+  /** @type {StoryOutcome[]} */
+  const outcomes = new Array(names.length);
+  let nextIndex = 0;
+  const worker = async () => {
+    while (nextIndex < names.length) {
+      const index = nextIndex;
+      nextIndex += 1;
+      const storyId = names[index];
+      const url = storyUrl(storyId, options);
+      try {
+        const report = await lintComponent(storyId, options);
+        outcomes[index] = { storyId, url, status: 'completed', report };
+      } catch (cause) {
+        const error = new Error(
+          `Accessibility check failed for story "${storyId}" (${url}): ${cause?.message || cause}`,
+          { cause },
+        );
+        Object.assign(error, { storyId, url });
+        outcomes[index] = { storyId, url, status: 'failed', error };
+      }
+    }
+  };
+  // Pa11y releases its browsers before settling. Drain every worker before
+  // reporting or rejecting so the caller can safely close the Storybook server.
+  await Promise.all(
+    Array.from({ length: Math.min(concurrency, names.length) }, worker),
   );
-  const hasIssues = results.map(logReport).some(Boolean);
 
-  if (hasIssues) {
-    process.exit(1);
+  const failures = [];
+  let clean = 0;
+  let withFindings = 0;
+  for (const outcome of outcomes) {
+    if (outcome.status === 'failed') {
+      failures.push(outcome.error);
+      // Use the same output stream as completed reports to retain input order.
+      // Logging the original error object keeps its stack and nested causes.
+      console.log(
+        `Execution failed for story: ${outcome.storyId}\nURL: ${outcome.url}`,
+        outcome.error.cause,
+      );
+    } else if (logReport(outcome.report)) {
+      withFindings += 1;
+    } else {
+      clean += 1;
+    }
+  }
+  console.log(
+    `Accessibility summary: ${outcomes.length} attempted, ${clean} clean, ${withFindings} with findings, ${failures.length} failed to execute.`,
+  );
+
+  if ((withFindings || failures.length) && !process.exitCode) {
+    process.exitCode = 1;
+  }
+  if (failures.length) {
+    throw new AggregateError(
+      failures,
+      `Accessibility execution failed for ${failures.length} ${failures.length === 1 ? 'story' : 'stories'}.`,
+    );
   }
 };