@flare-engine/a11y 0.2.1 → 0.3.1

package/dist/index.js

@@ -1,156 +1,180 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  A11yManager: () => A11yManager,
-  auditColors: () => auditColors,
-  contrastRatio: () => contrastRatio,
-  createA11yBridge: () => createA11yBridge,
-  dampenedMotion: () => dampenedMotion,
-  deltaE: () => deltaE,
-  isDistinguishable: () => isDistinguishable,
-  motionScale: () => motionScale,
-  pickContrast: () => pickContrast,
-  wcagLevel: () => wcagLevel
-});
-module.exports = __toCommonJS(index_exports);
-
-// src/manager.ts
-var import_events = require("@flare-engine/events");
-var DEFAULTS = {
-  reducedMotion: false,
-  contrast: "normal",
-  uiScale: 1
-};
-var A11yManager = class {
-  onChange = new import_events.Signal();
-  _settings;
-  constructor(options = {}) {
-    this._settings = { ...DEFAULTS, ...options.initial };
-  }
-  get settings() {
-    return this._settings;
-  }
-  get reducedMotion() {
-    return this._settings.reducedMotion;
-  }
-  get contrast() {
-    return this._settings.contrast;
-  }
-  get uiScale() {
-    return this._settings.uiScale;
-  }
-  update(patch) {
-    const next = { ...this._settings, ...patch };
-    if (next.reducedMotion === this._settings.reducedMotion && next.contrast === this._settings.contrast && next.uiScale === this._settings.uiScale) {
-      return;
-    }
-    this._settings = next;
-    this.onChange.emit(next);
-  }
-  setReducedMotion(v) {
-    this.update({ reducedMotion: v });
-  }
-  setContrast(v) {
-    this.update({ contrast: v });
-  }
-  setUiScale(v) {
-    this.update({ uiScale: v });
-  }
-};
-
-// src/helpers.ts
-function motionScale(settings, base = 1) {
-  return settings.reducedMotion ? 0 : base;
-}
-function dampenedMotion(settings, base, reducedFactor = 0.2) {
-  return settings.reducedMotion ? base * reducedFactor : base;
-}
-function pickContrast(settings, normal, high) {
-  return settings.contrast === "high" ? high : normal;
-}
-
-// src/bridge.ts
-function createA11yBridge(options = {}) {
-  const manager = options.manager ?? new A11yManager({ initial: options.initial });
-  function attach(target) {
-    const apply = () => {
-      target.setMotionScale(motionScale(manager.settings));
-    };
-    apply();
-    manager.onChange.add(apply);
-    return () => manager.onChange.remove(apply);
-  }
-  return {
-    manager,
-    attach,
-    attachCamera: attach,
-    attachPostfx: attach
-  };
-}
-
-// src/audit.ts
-var import_math = require("@flare-engine/math");
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _flare_engine_math = require("@flare-engine/math");
+let _flare_engine_events = require("@flare-engine/events");
+//#region src/audit.ts
+/**
+* WCAG 2.x contrast ratio between two colors. Order-independent; range [1, 21].
+* Delegates to Color.contrastRatio (relative luminance formula).
+*/
 function contrastRatio(fg, bg) {
-  return import_math.Color.contrastRatio(fg, bg);
+	return _flare_engine_math.Color.contrastRatio(fg, bg);
 }
+/**
+* Classify a contrast ratio against WCAG 2.x thresholds.
+*
+* Normal text (largeText = false):
+*   ratio >= 7.0 → AAA, ratio >= 4.5 → AA, else fail
+* Large text (largeText = true, >= 18pt normal / >= 14pt bold):
+*   ratio >= 4.5 → AAA, ratio >= 3.0 → AA, else fail
+*/
 function wcagLevel(ratio, largeText = false) {
-  if (largeText) {
-    if (ratio >= 4.5) return "AAA";
-    if (ratio >= 3) return "AA";
-    return "fail";
-  }
-  if (ratio >= 7) return "AAA";
-  if (ratio >= 4.5) return "AA";
-  return "fail";
+	if (largeText) {
+		if (ratio >= 4.5) return "AAA";
+		if (ratio >= 3) return "AA";
+		return "fail";
+	}
+	if (ratio >= 7) return "AAA";
+	if (ratio >= 4.5) return "AA";
+	return "fail";
 }
+/**
+* Perceptual distinguishability between two colors in OKLab space.
+* Returns the Euclidean ΔE distance (OKLab). Delegates to Color.deltaEOk.
+* Rule of thumb: < 0.05 ≈ imperceptibly similar; > 0.1 ≈ distinguishable.
+*/
 function deltaE(a, b) {
-  return import_math.Color.deltaEOk(a, b);
+	return _flare_engine_math.Color.deltaEOk(a, b);
 }
-function isDistinguishable(a, b, threshold = 0.1) {
-  return import_math.Color.deltaEOk(a, b) >= threshold;
+/**
+* Returns true when two colors are perceptually distinguishable.
+* Uses OKLab ΔE with a caller-supplied threshold (default 0.1).
+* The threshold is a design-level constant — tune per visual layer.
+*/
+function isDistinguishable(a, b, threshold = .1) {
+	return _flare_engine_math.Color.deltaEOk(a, b) >= threshold;
 }
+/**
+* Run contrast ratio + distinguishability check in one call.
+* Returns structured results, never throws.
+*/
 function auditColors(fg, bg, options) {
-  const largeText = options?.largeText ?? false;
-  const threshold = options?.deltaEThreshold ?? 0.1;
-  const ratio = import_math.Color.contrastRatio(fg, bg);
-  const de = import_math.Color.deltaEOk(fg, bg);
-  return {
-    contrastRatio: ratio,
-    wcagLevel: wcagLevel(ratio, largeText),
-    deltaE: de,
-    distinguishable: de >= threshold
-  };
+	const largeText = options?.largeText ?? false;
+	const threshold = options?.deltaEThreshold ?? .1;
+	const ratio = _flare_engine_math.Color.contrastRatio(fg, bg);
+	const de = _flare_engine_math.Color.deltaEOk(fg, bg);
+	return {
+		contrastRatio: ratio,
+		wcagLevel: wcagLevel(ratio, largeText),
+		deltaE: de,
+		distinguishable: de >= threshold
+	};
+}
+//#endregion
+//#region src/helpers.ts
+/**
+* Strength multiplier used by animation + postfx systems. Caller chooses a
+* base intensity; this function clamps it for reduced-motion users.
+*/
+function motionScale(settings, base = 1) {
+	return settings.reducedMotion ? 0 : base;
+}
+/**
+* Returns a second, dampened intensity. Useful for effects you want to keep
+* but soften (camera shake, chromatic aberration). `reducedFactor` controls
+* how much survives when reduced-motion is on (default 20%).
+*/
+function dampenedMotion(settings, base, reducedFactor = .2) {
+	return settings.reducedMotion ? base * reducedFactor : base;
+}
+/**
+* Helper for UI layers: pick a color based on contrast preference.
+*/
+function pickContrast(settings, normal, high) {
+	return settings.contrast === "high" ? high : normal;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  A11yManager,
-  auditColors,
-  contrastRatio,
-  createA11yBridge,
-  dampenedMotion,
-  deltaE,
-  isDistinguishable,
-  motionScale,
-  pickContrast,
-  wcagLevel
-});
+//#endregion
+//#region src/manager.ts
+const DEFAULTS = {
+	reducedMotion: false,
+	contrast: "normal",
+	uiScale: 1
+};
+/**
+* Central accessibility state. Systems subscribe via `onChange` and read the
+* current snapshot via `settings`. The manager owns no platform wiring — a
+* host app may bridge OS preferences (e.g., `AccessibilityInfo.isReduceMotionEnabled`)
+* by pushing values in on startup.
+*/
+var A11yManager = class {
+	onChange = new _flare_engine_events.Signal();
+	_settings;
+	constructor(options = {}) {
+		this._settings = {
+			...DEFAULTS,
+			...options.initial
+		};
+	}
+	get settings() {
+		return this._settings;
+	}
+	get reducedMotion() {
+		return this._settings.reducedMotion;
+	}
+	get contrast() {
+		return this._settings.contrast;
+	}
+	get uiScale() {
+		return this._settings.uiScale;
+	}
+	update(patch) {
+		const next = {
+			...this._settings,
+			...patch
+		};
+		if (next.reducedMotion === this._settings.reducedMotion && next.contrast === this._settings.contrast && next.uiScale === this._settings.uiScale) return;
+		this._settings = next;
+		this.onChange.emit(next);
+	}
+	setReducedMotion(v) {
+		this.update({ reducedMotion: v });
+	}
+	setContrast(v) {
+		this.update({ contrast: v });
+	}
+	setUiScale(v) {
+		this.update({ uiScale: v });
+	}
+};
+//#endregion
+//#region src/bridge.ts
+/**
+* A11yBridge — one-liner wiring of an `A11yManager` into runtime systems that
+* expose `setMotionScale(k)`. Typical targets: `Camera2D` (screen-shake) and
+* `PostFxController` (global effect intensity).
+*
+* The bridge owns no platform wiring — callers push OS preferences (e.g.
+* `AccessibilityInfo.isReduceMotionEnabled()`) into the manager; the bridge
+* forwards the derived motion scale to every attached target.
+*
+* Duck-typed on the target side so `@flare-engine/a11y` stays dependency-free.
+*/
+function createA11yBridge(options = {}) {
+	const manager = options.manager ?? new A11yManager({ initial: options.initial });
+	function attach(target) {
+		const apply = () => {
+			target.setMotionScale(motionScale(manager.settings));
+		};
+		apply();
+		manager.onChange.add(apply);
+		return () => manager.onChange.remove(apply);
+	}
+	return {
+		manager,
+		attach,
+		attachCamera: attach,
+		attachPostfx: attach
+	};
+}
+//#endregion
+exports.A11yManager = A11yManager;
+exports.auditColors = auditColors;
+exports.contrastRatio = contrastRatio;
+exports.createA11yBridge = createA11yBridge;
+exports.dampenedMotion = dampenedMotion;
+exports.deltaE = deltaE;
+exports.isDistinguishable = isDistinguishable;
+exports.motionScale = motionScale;
+exports.pickContrast = pickContrast;
+exports.wcagLevel = wcagLevel;
+
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/manager.ts","../src/helpers.ts","../src/bridge.ts","../src/audit.ts"],"sourcesContent":["export {\n  A11yManager,\n  type A11yManagerOptions,\n  type A11ySettings,\n  type ContrastLevel,\n} from './manager.js';\nexport { motionScale, dampenedMotion, pickContrast } from './helpers.js';\nexport {\n  type A11yBridge,\n  type A11yBridgeOptions,\n  type MotionScaleTarget,\n  createA11yBridge,\n} from './bridge.js';\nexport {\n  contrastRatio,\n  wcagLevel,\n  deltaE,\n  isDistinguishable,\n  auditColors,\n  type WcagLevel,\n  type AuditResult,\n  type AuditOptions,\n} from './audit.js';\n","import { Signal } from '@flare-engine/events';\n\nexport type ContrastLevel = 'normal' | 'high';\n\nexport interface A11ySettings {\n  /** When true, animations and heavy postfx should be minimized. */\n  reducedMotion: boolean;\n  /** Current contrast preference — UI tokens swap accordingly. */\n  contrast: ContrastLevel;\n  /** Global UI scale multiplier (`1` = default). */\n  uiScale: number;\n}\n\nexport interface A11yManagerOptions {\n  initial?: Partial<A11ySettings>;\n}\n\nconst DEFAULTS: A11ySettings = {\n  reducedMotion: false,\n  contrast: 'normal',\n  uiScale: 1,\n};\n\n/**\n * Central accessibility state. Systems subscribe via `onChange` and read the\n * current snapshot via `settings`. The manager owns no platform wiring — a\n * host app may bridge OS preferences (e.g., `AccessibilityInfo.isReduceMotionEnabled`)\n * by pushing values in on startup.\n */\nexport class A11yManager {\n  readonly onChange = new Signal<A11ySettings>();\n  private _settings: A11ySettings;\n\n  constructor(options: A11yManagerOptions = {}) {\n    this._settings = { ...DEFAULTS, ...options.initial };\n  }\n\n  get settings(): A11ySettings {\n    return this._settings;\n  }\n\n  get reducedMotion(): boolean {\n    return this._settings.reducedMotion;\n  }\n\n  get contrast(): ContrastLevel {\n    return this._settings.contrast;\n  }\n\n  get uiScale(): number {\n    return this._settings.uiScale;\n  }\n\n  update(patch: Partial<A11ySettings>): void {\n    const next: A11ySettings = { ...this._settings, ...patch };\n    if (\n      next.reducedMotion === this._settings.reducedMotion &&\n      next.contrast === this._settings.contrast &&\n      next.uiScale === this._settings.uiScale\n    ) {\n      return;\n    }\n    this._settings = next;\n    this.onChange.emit(next);\n  }\n\n  setReducedMotion(v: boolean): void {\n    this.update({ reducedMotion: v });\n  }\n\n  setContrast(v: ContrastLevel): void {\n    this.update({ contrast: v });\n  }\n\n  setUiScale(v: number): void {\n    this.update({ uiScale: v });\n  }\n}\n","import type { A11ySettings } from './manager.js';\n\n/**\n * Strength multiplier used by animation + postfx systems. Caller chooses a\n * base intensity; this function clamps it for reduced-motion users.\n */\nexport function motionScale(settings: { reducedMotion: boolean }, base = 1): number {\n  return settings.reducedMotion ? 0 : base;\n}\n\n/**\n * Returns a second, dampened intensity. Useful for effects you want to keep\n * but soften (camera shake, chromatic aberration). `reducedFactor` controls\n * how much survives when reduced-motion is on (default 20%).\n */\nexport function dampenedMotion(\n  settings: { reducedMotion: boolean },\n  base: number,\n  reducedFactor = 0.2,\n): number {\n  return settings.reducedMotion ? base * reducedFactor : base;\n}\n\n/**\n * Helper for UI layers: pick a color based on contrast preference.\n */\nexport function pickContrast<T>(settings: Pick<A11ySettings, 'contrast'>, normal: T, high: T): T {\n  return settings.contrast === 'high' ? high : normal;\n}\n","/**\n * A11yBridge — one-liner wiring of an `A11yManager` into runtime systems that\n * expose `setMotionScale(k)`. Typical targets: `Camera2D` (screen-shake) and\n * `PostFxController` (global effect intensity).\n *\n * The bridge owns no platform wiring — callers push OS preferences (e.g.\n * `AccessibilityInfo.isReduceMotionEnabled()`) into the manager; the bridge\n * forwards the derived motion scale to every attached target.\n *\n * Extracted from Pan Tvardowski per Phase 11.14. Duck-typed on the target\n * side so `@flare-engine/a11y` stays dependency-free.\n */\n\nimport { motionScale } from './helpers.js';\nimport { A11yManager, type A11yManagerOptions } from './manager.js';\n\n/** Minimal structural contract. `Camera2D` and `PostFxController` both match. */\nexport interface MotionScaleTarget {\n  setMotionScale(k: number): void;\n}\n\nexport interface A11yBridge {\n  readonly manager: A11yManager;\n  /**\n   * Apply the current motion scale to `target` and subscribe for updates.\n   * Returns an unsubscribe fn — call on target disposal.\n   */\n  attach(target: MotionScaleTarget): () => void;\n  /** Alias of `attach` with a name that documents intent at call sites. */\n  attachCamera(camera: MotionScaleTarget): () => void;\n  /** Alias of `attach` with a name that documents intent at call sites. */\n  attachPostfx(postfx: MotionScaleTarget): () => void;\n}\n\nexport interface A11yBridgeOptions extends A11yManagerOptions {\n  /** Provide an existing manager — otherwise one is constructed from `initial`. */\n  readonly manager?: A11yManager;\n}\n\nexport function createA11yBridge(options: A11yBridgeOptions = {}): A11yBridge {\n  const manager = options.manager ?? new A11yManager({ initial: options.initial });\n\n  function attach(target: MotionScaleTarget): () => void {\n    const apply = (): void => {\n      target.setMotionScale(motionScale(manager.settings));\n    };\n    apply();\n    manager.onChange.add(apply);\n    return () => manager.onChange.remove(apply);\n  }\n\n  return {\n    manager,\n    attach,\n    attachCamera: attach,\n    attachPostfx: attach,\n  };\n}\n","import { Color } from '@flare-engine/math';\nimport type { Color as ColorType } from '@flare-engine/math';\n\n/** WCAG 2.x conformance level for a contrast ratio. */\nexport type WcagLevel = 'fail' | 'AA' | 'AAA';\n\n/**\n * WCAG 2.x contrast ratio between two colors. Order-independent; range [1, 21].\n * Delegates to Color.contrastRatio (relative luminance formula).\n */\nexport function contrastRatio(fg: ColorType, bg: ColorType): number {\n  return Color.contrastRatio(fg, bg);\n}\n\n/**\n * Classify a contrast ratio against WCAG 2.x thresholds.\n *\n * Normal text (largeText = false):\n *   ratio >= 7.0 → AAA, ratio >= 4.5 → AA, else fail\n * Large text (largeText = true, >= 18pt normal / >= 14pt bold):\n *   ratio >= 4.5 → AAA, ratio >= 3.0 → AA, else fail\n */\nexport function wcagLevel(ratio: number, largeText = false): WcagLevel {\n  if (largeText) {\n    if (ratio >= 4.5) return 'AAA';\n    if (ratio >= 3.0) return 'AA';\n    return 'fail';\n  }\n  if (ratio >= 7.0) return 'AAA';\n  if (ratio >= 4.5) return 'AA';\n  return 'fail';\n}\n\n/**\n * Perceptual distinguishability between two colors in OKLab space.\n * Returns the Euclidean ΔE distance (OKLab). Delegates to Color.deltaEOk.\n * Rule of thumb: < 0.05 ≈ imperceptibly similar; > 0.1 ≈ distinguishable.\n */\nexport function deltaE(a: ColorType, b: ColorType): number {\n  return Color.deltaEOk(a, b);\n}\n\n/**\n * Returns true when two colors are perceptually distinguishable.\n * Uses OKLab ΔE with a caller-supplied threshold (default 0.1).\n * The threshold is a design-level constant — tune per visual layer.\n */\nexport function isDistinguishable(a: ColorType, b: ColorType, threshold = 0.1): boolean {\n  return Color.deltaEOk(a, b) >= threshold;\n}\n\n/** Structured result from auditColors. */\nexport interface AuditResult {\n  readonly contrastRatio: number;\n  readonly wcagLevel: WcagLevel;\n  readonly deltaE: number;\n  readonly distinguishable: boolean;\n}\n\nexport interface AuditOptions {\n  /** When true, applies large-text WCAG thresholds. Default false. */\n  largeText?: boolean;\n  /** OKLab ΔE threshold for isDistinguishable. Default 0.1. */\n  deltaEThreshold?: number;\n}\n\n/**\n * Run contrast ratio + distinguishability check in one call.\n * Returns structured results, never throws.\n */\nexport function auditColors(fg: ColorType, bg: ColorType, options?: AuditOptions): AuditResult {\n  const largeText = options?.largeText ?? false;\n  const threshold = options?.deltaEThreshold ?? 0.1;\n  const ratio = Color.contrastRatio(fg, bg);\n  const de = Color.deltaEOk(fg, bg);\n  return {\n    contrastRatio: ratio,\n    wcagLevel: wcagLevel(ratio, largeText),\n    deltaE: de,\n    distinguishable: de >= threshold,\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"file":"index.js","names":["Color","Signal"],"sources":["../src/audit.ts","../src/helpers.ts","../src/manager.ts","../src/bridge.ts"],"sourcesContent":["import type { Color as ColorType } from '@flare-engine/math';\nimport { Color } from '@flare-engine/math';\n\n/** WCAG 2.x conformance level for a contrast ratio. */\nexport type WcagLevel = 'fail' | 'AA' | 'AAA';\n\n/**\n * WCAG 2.x contrast ratio between two colors. Order-independent; range [1, 21].\n * Delegates to Color.contrastRatio (relative luminance formula).\n */\nexport function contrastRatio(fg: ColorType, bg: ColorType): number {\n  return Color.contrastRatio(fg, bg);\n}\n\n/**\n * Classify a contrast ratio against WCAG 2.x thresholds.\n *\n * Normal text (largeText = false):\n *   ratio >= 7.0 → AAA, ratio >= 4.5 → AA, else fail\n * Large text (largeText = true, >= 18pt normal / >= 14pt bold):\n *   ratio >= 4.5 → AAA, ratio >= 3.0 → AA, else fail\n */\nexport function wcagLevel(ratio: number, largeText = false): WcagLevel {\n  if (largeText) {\n    if (ratio >= 4.5) return 'AAA';\n    if (ratio >= 3.0) return 'AA';\n    return 'fail';\n  }\n  if (ratio >= 7.0) return 'AAA';\n  if (ratio >= 4.5) return 'AA';\n  return 'fail';\n}\n\n/**\n * Perceptual distinguishability between two colors in OKLab space.\n * Returns the Euclidean ΔE distance (OKLab). Delegates to Color.deltaEOk.\n * Rule of thumb: < 0.05 ≈ imperceptibly similar; > 0.1 ≈ distinguishable.\n */\nexport function deltaE(a: ColorType, b: ColorType): number {\n  return Color.deltaEOk(a, b);\n}\n\n/**\n * Returns true when two colors are perceptually distinguishable.\n * Uses OKLab ΔE with a caller-supplied threshold (default 0.1).\n * The threshold is a design-level constant — tune per visual layer.\n */\nexport function isDistinguishable(a: ColorType, b: ColorType, threshold = 0.1): boolean {\n  return Color.deltaEOk(a, b) >= threshold;\n}\n\n/** Structured result from auditColors. */\nexport interface AuditResult {\n  readonly contrastRatio: number;\n  readonly wcagLevel: WcagLevel;\n  readonly deltaE: number;\n  readonly distinguishable: boolean;\n}\n\nexport interface AuditOptions {\n  /** When true, applies large-text WCAG thresholds. Default false. */\n  largeText?: boolean;\n  /** OKLab ΔE threshold for isDistinguishable. Default 0.1. */\n  deltaEThreshold?: number;\n}\n\n/**\n * Run contrast ratio + distinguishability check in one call.\n * Returns structured results, never throws.\n */\nexport function auditColors(fg: ColorType, bg: ColorType, options?: AuditOptions): AuditResult {\n  const largeText = options?.largeText ?? false;\n  const threshold = options?.deltaEThreshold ?? 0.1;\n  const ratio = Color.contrastRatio(fg, bg);\n  const de = Color.deltaEOk(fg, bg);\n  return {\n    contrastRatio: ratio,\n    wcagLevel: wcagLevel(ratio, largeText),\n    deltaE: de,\n    distinguishable: de >= threshold,\n  };\n}\n","import type { A11ySettings } from './manager.js';\n\n/**\n * Strength multiplier used by animation + postfx systems. Caller chooses a\n * base intensity; this function clamps it for reduced-motion users.\n */\nexport function motionScale(settings: { reducedMotion: boolean }, base = 1): number {\n  return settings.reducedMotion ? 0 : base;\n}\n\n/**\n * Returns a second, dampened intensity. Useful for effects you want to keep\n * but soften (camera shake, chromatic aberration). `reducedFactor` controls\n * how much survives when reduced-motion is on (default 20%).\n */\nexport function dampenedMotion(\n  settings: { reducedMotion: boolean },\n  base: number,\n  reducedFactor = 0.2,\n): number {\n  return settings.reducedMotion ? base * reducedFactor : base;\n}\n\n/**\n * Helper for UI layers: pick a color based on contrast preference.\n */\nexport function pickContrast<T>(settings: Pick<A11ySettings, 'contrast'>, normal: T, high: T): T {\n  return settings.contrast === 'high' ? high : normal;\n}\n","import { Signal } from '@flare-engine/events';\n\nexport type ContrastLevel = 'normal' | 'high';\n\nexport interface A11ySettings {\n  /** When true, animations and heavy postfx should be minimized. */\n  reducedMotion: boolean;\n  /** Current contrast preference — UI tokens swap accordingly. */\n  contrast: ContrastLevel;\n  /** Global UI scale multiplier (`1` = default). */\n  uiScale: number;\n}\n\nexport interface A11yManagerOptions {\n  initial?: Partial<A11ySettings>;\n}\n\nconst DEFAULTS: A11ySettings = {\n  reducedMotion: false,\n  contrast: 'normal',\n  uiScale: 1,\n};\n\n/**\n * Central accessibility state. Systems subscribe via `onChange` and read the\n * current snapshot via `settings`. The manager owns no platform wiring — a\n * host app may bridge OS preferences (e.g., `AccessibilityInfo.isReduceMotionEnabled`)\n * by pushing values in on startup.\n */\nexport class A11yManager {\n  readonly onChange = new Signal<A11ySettings>();\n  private _settings: A11ySettings;\n\n  constructor(options: A11yManagerOptions = {}) {\n    this._settings = { ...DEFAULTS, ...options.initial };\n  }\n\n  get settings(): A11ySettings {\n    return this._settings;\n  }\n\n  get reducedMotion(): boolean {\n    return this._settings.reducedMotion;\n  }\n\n  get contrast(): ContrastLevel {\n    return this._settings.contrast;\n  }\n\n  get uiScale(): number {\n    return this._settings.uiScale;\n  }\n\n  update(patch: Partial<A11ySettings>): void {\n    const next: A11ySettings = { ...this._settings, ...patch };\n    if (\n      next.reducedMotion === this._settings.reducedMotion &&\n      next.contrast === this._settings.contrast &&\n      next.uiScale === this._settings.uiScale\n    ) {\n      return;\n    }\n    this._settings = next;\n    this.onChange.emit(next);\n  }\n\n  setReducedMotion(v: boolean): void {\n    this.update({ reducedMotion: v });\n  }\n\n  setContrast(v: ContrastLevel): void {\n    this.update({ contrast: v });\n  }\n\n  setUiScale(v: number): void {\n    this.update({ uiScale: v });\n  }\n}\n","/**\n * A11yBridge — one-liner wiring of an `A11yManager` into runtime systems that\n * expose `setMotionScale(k)`. Typical targets: `Camera2D` (screen-shake) and\n * `PostFxController` (global effect intensity).\n *\n * The bridge owns no platform wiring — callers push OS preferences (e.g.\n * `AccessibilityInfo.isReduceMotionEnabled()`) into the manager; the bridge\n * forwards the derived motion scale to every attached target.\n *\n * Duck-typed on the target side so `@flare-engine/a11y` stays dependency-free.\n */\n\nimport { motionScale } from './helpers.js';\nimport { A11yManager, type A11yManagerOptions } from './manager.js';\n\n/** Minimal structural contract. `Camera2D` and `PostFxController` both match. */\nexport interface MotionScaleTarget {\n  setMotionScale(k: number): void;\n}\n\nexport interface A11yBridge {\n  readonly manager: A11yManager;\n  /**\n   * Apply the current motion scale to `target` and subscribe for updates.\n   * Returns an unsubscribe fn — call on target disposal.\n   */\n  attach(target: MotionScaleTarget): () => void;\n  /** Alias of `attach` with a name that documents intent at call sites. */\n  attachCamera(camera: MotionScaleTarget): () => void;\n  /** Alias of `attach` with a name that documents intent at call sites. */\n  attachPostfx(postfx: MotionScaleTarget): () => void;\n}\n\nexport interface A11yBridgeOptions extends A11yManagerOptions {\n  /** Provide an existing manager — otherwise one is constructed from `initial`. */\n  readonly manager?: A11yManager;\n}\n\nexport function createA11yBridge(options: A11yBridgeOptions = {}): A11yBridge {\n  const manager = options.manager ?? new A11yManager({ initial: options.initial });\n\n  function attach(target: MotionScaleTarget): () => void {\n    const apply = (): void => {\n      target.setMotionScale(motionScale(manager.settings));\n    };\n    apply();\n    manager.onChange.add(apply);\n    return () => manager.onChange.remove(apply);\n  }\n\n  return {\n    manager,\n    attach,\n    attachCamera: attach,\n    attachPostfx: attach,\n  };\n}\n"],"mappings":";;;;;;;;AAUA,SAAgB,cAAc,IAAe,IAAuB;CAClE,OAAOA,mBAAAA,MAAM,cAAc,IAAI,EAAE;AACnC;;;;;;;;;AAUA,SAAgB,UAAU,OAAe,YAAY,OAAkB;CACrE,IAAI,WAAW;EACb,IAAI,SAAS,KAAK,OAAO;EACzB,IAAI,SAAS,GAAK,OAAO;EACzB,OAAO;CACT;CACA,IAAI,SAAS,GAAK,OAAO;CACzB,IAAI,SAAS,KAAK,OAAO;CACzB,OAAO;AACT;;;;;;AAOA,SAAgB,OAAO,GAAc,GAAsB;CACzD,OAAOA,mBAAAA,MAAM,SAAS,GAAG,CAAC;AAC5B;;;;;;AAOA,SAAgB,kBAAkB,GAAc,GAAc,YAAY,IAAc;CACtF,OAAOA,mBAAAA,MAAM,SAAS,GAAG,CAAC,KAAK;AACjC;;;;;AAqBA,SAAgB,YAAY,IAAe,IAAe,SAAqC;CAC7F,MAAM,YAAY,SAAS,aAAa;CACxC,MAAM,YAAY,SAAS,mBAAmB;CAC9C,MAAM,QAAQA,mBAAAA,MAAM,cAAc,IAAI,EAAE;CACxC,MAAM,KAAKA,mBAAAA,MAAM,SAAS,IAAI,EAAE;CAChC,OAAO;EACL,eAAe;EACf,WAAW,UAAU,OAAO,SAAS;EACrC,QAAQ;EACR,iBAAiB,MAAM;CACzB;AACF;;;;;;;AC3EA,SAAgB,YAAY,UAAsC,OAAO,GAAW;CAClF,OAAO,SAAS,gBAAgB,IAAI;AACtC;;;;;;AAOA,SAAgB,eACd,UACA,MACA,gBAAgB,IACR;CACR,OAAO,SAAS,gBAAgB,OAAO,gBAAgB;AACzD;;;;AAKA,SAAgB,aAAgB,UAA0C,QAAW,MAAY;CAC/F,OAAO,SAAS,aAAa,SAAS,OAAO;AAC/C;;;ACXA,MAAM,WAAyB;CAC7B,eAAe;CACf,UAAU;CACV,SAAS;AACX;;;;;;;AAQA,IAAa,cAAb,MAAyB;CACvB,WAAoB,IAAIC,qBAAAA,OAAqB;CAC7C;CAEA,YAAY,UAA8B,CAAC,GAAG;EAC5C,KAAK,YAAY;GAAE,GAAG;GAAU,GAAG,QAAQ;EAAQ;CACrD;CAEA,IAAI,WAAyB;EAC3B,OAAO,KAAK;CACd;CAEA,IAAI,gBAAyB;EAC3B,OAAO,KAAK,UAAU;CACxB;CAEA,IAAI,WAA0B;EAC5B,OAAO,KAAK,UAAU;CACxB;CAEA,IAAI,UAAkB;EACpB,OAAO,KAAK,UAAU;CACxB;CAEA,OAAO,OAAoC;EACzC,MAAM,OAAqB;GAAE,GAAG,KAAK;GAAW,GAAG;EAAM;EACzD,IACE,KAAK,kBAAkB,KAAK,UAAU,iBACtC,KAAK,aAAa,KAAK,UAAU,YACjC,KAAK,YAAY,KAAK,UAAU,SAEhC;EAEF,KAAK,YAAY;EACjB,KAAK,SAAS,KAAK,IAAI;CACzB;CAEA,iBAAiB,GAAkB;EACjC,KAAK,OAAO,EAAE,eAAe,EAAE,CAAC;CAClC;CAEA,YAAY,GAAwB;EAClC,KAAK,OAAO,EAAE,UAAU,EAAE,CAAC;CAC7B;CAEA,WAAW,GAAiB;EAC1B,KAAK,OAAO,EAAE,SAAS,EAAE,CAAC;CAC5B;AACF;;;;;;;;;;;;;;ACvCA,SAAgB,iBAAiB,UAA6B,CAAC,GAAe;CAC5E,MAAM,UAAU,QAAQ,WAAW,IAAI,YAAY,EAAE,SAAS,QAAQ,QAAQ,CAAC;CAE/E,SAAS,OAAO,QAAuC;EACrD,MAAM,cAAoB;GACxB,OAAO,eAAe,YAAY,QAAQ,QAAQ,CAAC;EACrD;EACA,MAAM;EACN,QAAQ,SAAS,IAAI,KAAK;EAC1B,aAAa,QAAQ,SAAS,OAAO,KAAK;CAC5C;CAEA,OAAO;EACL;EACA;EACA,cAAc;EACd,cAAc;CAChB;AACF"}

package/dist/index.mjs

@@ -1,120 +1,170 @@
-// src/manager.ts
-import { Signal } from "@flare-engine/events";
-var DEFAULTS = {
-  reducedMotion: false,
-  contrast: "normal",
-  uiScale: 1
-};
-var A11yManager = class {
-  onChange = new Signal();
-  _settings;
-  constructor(options = {}) {
-    this._settings = { ...DEFAULTS, ...options.initial };
-  }
-  get settings() {
-    return this._settings;
-  }
-  get reducedMotion() {
-    return this._settings.reducedMotion;
-  }
-  get contrast() {
-    return this._settings.contrast;
-  }
-  get uiScale() {
-    return this._settings.uiScale;
-  }
-  update(patch) {
-    const next = { ...this._settings, ...patch };
-    if (next.reducedMotion === this._settings.reducedMotion && next.contrast === this._settings.contrast && next.uiScale === this._settings.uiScale) {
-      return;
-    }
-    this._settings = next;
-    this.onChange.emit(next);
-  }
-  setReducedMotion(v) {
-    this.update({ reducedMotion: v });
-  }
-  setContrast(v) {
-    this.update({ contrast: v });
-  }
-  setUiScale(v) {
-    this.update({ uiScale: v });
-  }
-};
-
-// src/helpers.ts
-function motionScale(settings, base = 1) {
-  return settings.reducedMotion ? 0 : base;
-}
-function dampenedMotion(settings, base, reducedFactor = 0.2) {
-  return settings.reducedMotion ? base * reducedFactor : base;
-}
-function pickContrast(settings, normal, high) {
-  return settings.contrast === "high" ? high : normal;
-}
-
-// src/bridge.ts
-function createA11yBridge(options = {}) {
-  const manager = options.manager ?? new A11yManager({ initial: options.initial });
-  function attach(target) {
-    const apply = () => {
-      target.setMotionScale(motionScale(manager.settings));
-    };
-    apply();
-    manager.onChange.add(apply);
-    return () => manager.onChange.remove(apply);
-  }
-  return {
-    manager,
-    attach,
-    attachCamera: attach,
-    attachPostfx: attach
-  };
-}
-
-// src/audit.ts
 import { Color } from "@flare-engine/math";
+import { Signal } from "@flare-engine/events";
+//#region src/audit.ts
+/**
+* WCAG 2.x contrast ratio between two colors. Order-independent; range [1, 21].
+* Delegates to Color.contrastRatio (relative luminance formula).
+*/
 function contrastRatio(fg, bg) {
-  return Color.contrastRatio(fg, bg);
+	return Color.contrastRatio(fg, bg);
 }
+/**
+* Classify a contrast ratio against WCAG 2.x thresholds.
+*
+* Normal text (largeText = false):
+*   ratio >= 7.0 → AAA, ratio >= 4.5 → AA, else fail
+* Large text (largeText = true, >= 18pt normal / >= 14pt bold):
+*   ratio >= 4.5 → AAA, ratio >= 3.0 → AA, else fail
+*/
 function wcagLevel(ratio, largeText = false) {
-  if (largeText) {
-    if (ratio >= 4.5) return "AAA";
-    if (ratio >= 3) return "AA";
-    return "fail";
-  }
-  if (ratio >= 7) return "AAA";
-  if (ratio >= 4.5) return "AA";
-  return "fail";
+	if (largeText) {
+		if (ratio >= 4.5) return "AAA";
+		if (ratio >= 3) return "AA";
+		return "fail";
+	}
+	if (ratio >= 7) return "AAA";
+	if (ratio >= 4.5) return "AA";
+	return "fail";
 }
+/**
+* Perceptual distinguishability between two colors in OKLab space.
+* Returns the Euclidean ΔE distance (OKLab). Delegates to Color.deltaEOk.
+* Rule of thumb: < 0.05 ≈ imperceptibly similar; > 0.1 ≈ distinguishable.
+*/
 function deltaE(a, b) {
-  return Color.deltaEOk(a, b);
+	return Color.deltaEOk(a, b);
 }
-function isDistinguishable(a, b, threshold = 0.1) {
-  return Color.deltaEOk(a, b) >= threshold;
+/**
+* Returns true when two colors are perceptually distinguishable.
+* Uses OKLab ΔE with a caller-supplied threshold (default 0.1).
+* The threshold is a design-level constant — tune per visual layer.
+*/
+function isDistinguishable(a, b, threshold = .1) {
+	return Color.deltaEOk(a, b) >= threshold;
 }
+/**
+* Run contrast ratio + distinguishability check in one call.
+* Returns structured results, never throws.
+*/
 function auditColors(fg, bg, options) {
-  const largeText = options?.largeText ?? false;
-  const threshold = options?.deltaEThreshold ?? 0.1;
-  const ratio = Color.contrastRatio(fg, bg);
-  const de = Color.deltaEOk(fg, bg);
-  return {
-    contrastRatio: ratio,
-    wcagLevel: wcagLevel(ratio, largeText),
-    deltaE: de,
-    distinguishable: de >= threshold
-  };
+	const largeText = options?.largeText ?? false;
+	const threshold = options?.deltaEThreshold ?? .1;
+	const ratio = Color.contrastRatio(fg, bg);
+	const de = Color.deltaEOk(fg, bg);
+	return {
+		contrastRatio: ratio,
+		wcagLevel: wcagLevel(ratio, largeText),
+		deltaE: de,
+		distinguishable: de >= threshold
+	};
+}
+//#endregion
+//#region src/helpers.ts
+/**
+* Strength multiplier used by animation + postfx systems. Caller chooses a
+* base intensity; this function clamps it for reduced-motion users.
+*/
+function motionScale(settings, base = 1) {
+	return settings.reducedMotion ? 0 : base;
+}
+/**
+* Returns a second, dampened intensity. Useful for effects you want to keep
+* but soften (camera shake, chromatic aberration). `reducedFactor` controls
+* how much survives when reduced-motion is on (default 20%).
+*/
+function dampenedMotion(settings, base, reducedFactor = .2) {
+	return settings.reducedMotion ? base * reducedFactor : base;
+}
+/**
+* Helper for UI layers: pick a color based on contrast preference.
+*/
+function pickContrast(settings, normal, high) {
+	return settings.contrast === "high" ? high : normal;
 }
-export {
-  A11yManager,
-  auditColors,
-  contrastRatio,
-  createA11yBridge,
-  dampenedMotion,
-  deltaE,
-  isDistinguishable,
-  motionScale,
-  pickContrast,
-  wcagLevel
+//#endregion
+//#region src/manager.ts
+const DEFAULTS = {
+	reducedMotion: false,
+	contrast: "normal",
+	uiScale: 1
+};
+/**
+* Central accessibility state. Systems subscribe via `onChange` and read the
+* current snapshot via `settings`. The manager owns no platform wiring — a
+* host app may bridge OS preferences (e.g., `AccessibilityInfo.isReduceMotionEnabled`)
+* by pushing values in on startup.
+*/
+var A11yManager = class {
+	onChange = new Signal();
+	_settings;
+	constructor(options = {}) {
+		this._settings = {
+			...DEFAULTS,
+			...options.initial
+		};
+	}
+	get settings() {
+		return this._settings;
+	}
+	get reducedMotion() {
+		return this._settings.reducedMotion;
+	}
+	get contrast() {
+		return this._settings.contrast;
+	}
+	get uiScale() {
+		return this._settings.uiScale;
+	}
+	update(patch) {
+		const next = {
+			...this._settings,
+			...patch
+		};
+		if (next.reducedMotion === this._settings.reducedMotion && next.contrast === this._settings.contrast && next.uiScale === this._settings.uiScale) return;
+		this._settings = next;
+		this.onChange.emit(next);
+	}
+	setReducedMotion(v) {
+		this.update({ reducedMotion: v });
+	}
+	setContrast(v) {
+		this.update({ contrast: v });
+	}
+	setUiScale(v) {
+		this.update({ uiScale: v });
+	}
 };
+//#endregion
+//#region src/bridge.ts
+/**
+* A11yBridge — one-liner wiring of an `A11yManager` into runtime systems that
+* expose `setMotionScale(k)`. Typical targets: `Camera2D` (screen-shake) and
+* `PostFxController` (global effect intensity).
+*
+* The bridge owns no platform wiring — callers push OS preferences (e.g.
+* `AccessibilityInfo.isReduceMotionEnabled()`) into the manager; the bridge
+* forwards the derived motion scale to every attached target.
+*
+* Duck-typed on the target side so `@flare-engine/a11y` stays dependency-free.
+*/
+function createA11yBridge(options = {}) {
+	const manager = options.manager ?? new A11yManager({ initial: options.initial });
+	function attach(target) {
+		const apply = () => {
+			target.setMotionScale(motionScale(manager.settings));
+		};
+		apply();
+		manager.onChange.add(apply);
+		return () => manager.onChange.remove(apply);
+	}
+	return {
+		manager,
+		attach,
+		attachCamera: attach,
+		attachPostfx: attach
+	};
+}
+//#endregion
+export { A11yManager, auditColors, contrastRatio, createA11yBridge, dampenedMotion, deltaE, isDistinguishable, motionScale, pickContrast, wcagLevel };
+
 //# sourceMappingURL=index.mjs.map