axle-storybook 0.1.0

package/README.md

@@ -0,0 +1,98 @@
+# axle-storybook
+
+Storybook addon — runs **axe-core 4.11** against every story and shows WCAG 2.2 AA violations in a Storybook panel. Same engine as [axle](https://axle-iota.vercel.app)'s GitHub Action and CLI.
+
+## Why use this and not `@storybook/addon-a11y`
+
+Both addons run axe-core, so the engine is identical. The differences:
+
+- `@storybook/addon-a11y` is the official, broadly-compatible addon focused on a panel + a11y testing during dev.
+- `axle-storybook` is the same engine **packaged for the same compliance workflow as the axle GitHub Action**. Stories that fail the addon will fail axle CI on PR. The output schema matches the rest of the axle ecosystem (CLI, Vercel/Netlify/Cloudflare plugins, VS Code extension), so you can reason about a single set of rules across surfaces.
+
+If you're already happy with `@storybook/addon-a11y` and don't use axle's CI, stick with it. If you do use axle CI and want consistency between dev (Storybook) and CI, use this.
+
+## Install
+
+```sh
+npm install --save-dev axle-storybook
+```
+
+Add to `.storybook/main.ts`:
+
+```ts
+import type { StorybookConfig } from "@storybook/your-framework";
+
+const config: StorybookConfig = {
+  // ...
+  addons: [
+    "@storybook/addon-essentials",
+    "axle-storybook",
+  ],
+};
+export default config;
+```
+
+That's all. Open Storybook → switch stories — the **a11y / WCAG** panel will populate.
+
+## Configuration
+
+Per-story or per-component:
+
+```ts
+import type { Meta, StoryObj } from "@storybook/react";
+import MyButton from "./MyButton";
+
+const meta: Meta<typeof MyButton> = {
+  component: MyButton,
+  parameters: {
+    axle: {
+      // disable the addon for this component (e.g., demo of a known
+      // failure case)
+      disable: false,
+      // override axe-core options
+      options: {
+        runOnly: { type: "tag", values: ["wcag2aa", "wcag22aa"] },
+      },
+    },
+  },
+};
+export default meta;
+
+export const Primary: StoryObj<typeof MyButton> = {};
+```
+
+Globally in `.storybook/preview.ts`:
+
+```ts
+import type { Preview } from "@storybook/react";
+
+const preview: Preview = {
+  parameters: {
+    axle: {
+      options: {
+        runOnly: { type: "tag", values: ["wcag2aa", "wcag22aa"] },
+      },
+    },
+  },
+};
+export default preview;
+```
+
+## Companion tools
+
+| Surface | Package |
+|---|---|
+| GitHub Action | `asafamos/axle-action@v1` |
+| npm CLI | `axle-cli` |
+| Netlify plugin | `axle-netlify-plugin` |
+| Cloudflare Pages plugin | `axle-cloudflare-plugin` |
+| Vercel plugin | `axle-vercel-plugin` |
+| WordPress plugin | "AsafAmos Accessibility Scanner" on WP.org |
+| VS Code extension | `axle-a11y` on VS Code Marketplace |
+| Web (no install) | [axle-iota.vercel.app](https://axle-iota.vercel.app) |
+
+All of these use the same axe-core 4.11 engine and the same rule set, so violations are consistent across surfaces.
+
+## License
+
+MIT.

package/dist/chunk-6DZX6EAA.mjs

@@ -0,0 +1,37 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __commonJS = (cb, mod) => function __require2() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+export {
+  __require,
+  __commonJS,
+  __toESM
+};

package/dist/chunk-PKTMWBKS.mjs

@@ -0,0 +1,16 @@
+// src/constants.ts
+var ADDON_ID = "axle-a11y";
+var PANEL_ID = `${ADDON_ID}/panel`;
+var PARAM_KEY = "axle";
+var EVENTS = {
+  RESULT: `${ADDON_ID}/result`,
+  ERROR: `${ADDON_ID}/error`,
+  RUNNING: `${ADDON_ID}/running`
+};
+
+export {
+  ADDON_ID,
+  PANEL_ID,
+  PARAM_KEY,
+  EVENTS
+};

package/dist/index.d.mts

@@ -0,0 +1,15 @@
+/**
+ * Server-side entrypoint registered by Storybook's `addons` array in
+ * .storybook/main.ts. We don't need any preset configuration for this
+ * addon — the panel and decorator are wired through manager.tsx and
+ * preview.ts respectively, which Storybook auto-discovers because of
+ * the `exports` map in package.json.
+ *
+ * Kept as an empty preset so Storybook resolves `axle-storybook`
+ * cleanly when listed in `addons`.
+ */
+declare const managerEntries: string[];
+declare const previewAnnotations: string[];
+declare const _default: {};
+
+export { _default as default, managerEntries, previewAnnotations };

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Server-side entrypoint registered by Storybook's `addons` array in
+ * .storybook/main.ts. We don't need any preset configuration for this
+ * addon — the panel and decorator are wired through manager.tsx and
+ * preview.ts respectively, which Storybook auto-discovers because of
+ * the `exports` map in package.json.
+ *
+ * Kept as an empty preset so Storybook resolves `axle-storybook`
+ * cleanly when listed in `addons`.
+ */
+declare const managerEntries: string[];
+declare const previewAnnotations: string[];
+declare const _default: {};
+
+export { _default as default, managerEntries, previewAnnotations };

package/dist/index.js

@@ -0,0 +1,45 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  default: () => index_default,
+  managerEntries: () => managerEntries,
+  previewAnnotations: () => previewAnnotations
+});
+module.exports = __toCommonJS(index_exports);
+var managerEntries = [require.resolve("./manager")];
+var previewAnnotations = [require.resolve("./preview")];
+var index_default = {};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  managerEntries,
+  previewAnnotations
+});

package/dist/index.mjs

@@ -0,0 +1,13 @@
+import {
+  __require
+} from "./chunk-6DZX6EAA.mjs";
+
+// src/index.ts
+var managerEntries = [__require.resolve("./manager")];
+var previewAnnotations = [__require.resolve("./preview")];
+var index_default = {};
+export {
+  index_default as default,
+  managerEntries,
+  previewAnnotations
+};

package/dist/manager.d.mts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/manager.d.ts

@@ -0,0 +1,2 @@
+
+export {  }