@flare-engine/a11y 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Grzegorz Otto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,29 @@
+# @flare-engine/a11y
+
+Central accessibility state for `@flare-engine/animation`, `@flare-engine/postfx`, and `@flare-engine/ui` to dampen or neutralize motion / contrast / scale per user preference. Light surface — full screen-reader pass deferred to 0.3.0. Hosts bridge OS prefs (`AccessibilityInfo.isReduceMotionEnabled`, `prefers-reduced-motion`) by calling `update()` on startup.
+
+## Install
+
+```sh
+bun add @flare-engine/a11y
+```
+
+## Usage
+
+```ts
+import { A11yManager, motionScale, dampenedMotion, pickContrast } from '@flare-engine/a11y';
+
+const a11y = new A11yManager();
+a11y.update({ reducedMotion: true, contrast: 'high' });
+a11y.onChange.add((settings) => console.log(settings));
+
+const shakeIntensity = motionScale(a11y.settings, 8); // 0 under reduced motion
+const vignettePulse = dampenedMotion(a11y.settings, 0.4); // softens but preserves
+const fg = pickContrast(a11y.settings, 0xff_cc_cc_cc, 0xff_ff_ff_ff);
+```
+
+See [API spec](../../docs/design/api-specs.md#flare-enginea11y--2kb-raw-light) and [skill reference](../../.github/skills/flare-a11y/SKILL.md).
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,90 @@
+import { Signal } from '@flare-engine/events';
+
+type ContrastLevel = 'normal' | 'high';
+interface A11ySettings {
+    /** When true, animations and heavy postfx should be minimized. */
+    reducedMotion: boolean;
+    /** Current contrast preference — UI tokens swap accordingly. */
+    contrast: ContrastLevel;
+    /** Global UI scale multiplier (`1` = default). */
+    uiScale: number;
+}
+interface A11yManagerOptions {
+    initial?: Partial<A11ySettings>;
+}
+/**
+ * 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.
+ */
+declare class A11yManager {
+    readonly onChange: Signal<A11ySettings>;
+    private _settings;
+    constructor(options?: A11yManagerOptions);
+    get settings(): A11ySettings;
+    get reducedMotion(): boolean;
+    get contrast(): ContrastLevel;
+    get uiScale(): number;
+    update(patch: Partial<A11ySettings>): void;
+    setReducedMotion(v: boolean): void;
+    setContrast(v: ContrastLevel): void;
+    setUiScale(v: number): void;
+}
+
+/**
+ * Strength multiplier used by animation + postfx systems. Caller chooses a
+ * base intensity; this function clamps it for reduced-motion users.
+ */
+declare function motionScale(settings: {
+    reducedMotion: boolean;
+}, base?: number): number;
+/**
+ * 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%).
+ */
+declare function dampenedMotion(settings: {
+    reducedMotion: boolean;
+}, base: number, reducedFactor?: number): number;
+/**
+ * Helper for UI layers: pick a color based on contrast preference.
+ */
+declare function pickContrast<T>(settings: Pick<A11ySettings, 'contrast'>, normal: T, high: T): T;
+
+/**
+ * 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.
+ *
+ * Extracted from Pan Tvardowski per Phase 11.14. Duck-typed on the target
+ * side so `@flare-engine/a11y` stays dependency-free.
+ */
+
+/** Minimal structural contract. `Camera2D` and `PostFxController` both match. */
+interface MotionScaleTarget {
+    setMotionScale(k: number): void;
+}
+interface A11yBridge {
+    readonly manager: A11yManager;
+    /**
+     * Apply the current motion scale to `target` and subscribe for updates.
+     * Returns an unsubscribe fn — call on target disposal.
+     */
+    attach(target: MotionScaleTarget): () => void;
+    /** Alias of `attach` with a name that documents intent at call sites. */
+    attachCamera(camera: MotionScaleTarget): () => void;
+    /** Alias of `attach` with a name that documents intent at call sites. */
+    attachPostfx(postfx: MotionScaleTarget): () => void;
+}
+interface A11yBridgeOptions extends A11yManagerOptions {
+    /** Provide an existing manager — otherwise one is constructed from `initial`. */
+    readonly manager?: A11yManager;
+}
+declare function createA11yBridge(options?: A11yBridgeOptions): A11yBridge;
+
+export { type A11yBridge, type A11yBridgeOptions, A11yManager, type A11yManagerOptions, type A11ySettings, type ContrastLevel, type MotionScaleTarget, createA11yBridge, dampenedMotion, motionScale, pickContrast };

package/dist/index.d.ts

@@ -0,0 +1,90 @@
+import { Signal } from '@flare-engine/events';
+
+type ContrastLevel = 'normal' | 'high';
+interface A11ySettings {
+    /** When true, animations and heavy postfx should be minimized. */
+    reducedMotion: boolean;
+    /** Current contrast preference — UI tokens swap accordingly. */
+    contrast: ContrastLevel;
+    /** Global UI scale multiplier (`1` = default). */
+    uiScale: number;
+}
+interface A11yManagerOptions {
+    initial?: Partial<A11ySettings>;
+}
+/**
+ * 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.
+ */
+declare class A11yManager {
+    readonly onChange: Signal<A11ySettings>;
+    private _settings;
+    constructor(options?: A11yManagerOptions);
+    get settings(): A11ySettings;
+    get reducedMotion(): boolean;
+    get contrast(): ContrastLevel;
+    get uiScale(): number;
+    update(patch: Partial<A11ySettings>): void;
+    setReducedMotion(v: boolean): void;
+    setContrast(v: ContrastLevel): void;
+    setUiScale(v: number): void;
+}
+
+/**
+ * Strength multiplier used by animation + postfx systems. Caller chooses a
+ * base intensity; this function clamps it for reduced-motion users.
+ */
+declare function motionScale(settings: {
+    reducedMotion: boolean;
+}, base?: number): number;
+/**
+ * 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%).
+ */
+declare function dampenedMotion(settings: {
+    reducedMotion: boolean;
+}, base: number, reducedFactor?: number): number;
+/**
+ * Helper for UI layers: pick a color based on contrast preference.
+ */
+declare function pickContrast<T>(settings: Pick<A11ySettings, 'contrast'>, normal: T, high: T): T;
+
+/**
+ * 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.
+ *
+ * Extracted from Pan Tvardowski per Phase 11.14. Duck-typed on the target
+ * side so `@flare-engine/a11y` stays dependency-free.
+ */
+
+/** Minimal structural contract. `Camera2D` and `PostFxController` both match. */
+interface MotionScaleTarget {
+    setMotionScale(k: number): void;
+}
+interface A11yBridge {
+    readonly manager: A11yManager;
+    /**
+     * Apply the current motion scale to `target` and subscribe for updates.
+     * Returns an unsubscribe fn — call on target disposal.
+     */
+    attach(target: MotionScaleTarget): () => void;
+    /** Alias of `attach` with a name that documents intent at call sites. */
+    attachCamera(camera: MotionScaleTarget): () => void;
+    /** Alias of `attach` with a name that documents intent at call sites. */
+    attachPostfx(postfx: MotionScaleTarget): () => void;
+}
+interface A11yBridgeOptions extends A11yManagerOptions {
+    /** Provide an existing manager — otherwise one is constructed from `initial`. */
+    readonly manager?: A11yManager;
+}
+declare function createA11yBridge(options?: A11yBridgeOptions): A11yBridge;
+
+export { type A11yBridge, type A11yBridgeOptions, A11yManager, type A11yManagerOptions, type A11ySettings, type ContrastLevel, type MotionScaleTarget, createA11yBridge, dampenedMotion, motionScale, pickContrast };

package/dist/index.js

@@ -0,0 +1,112 @@
+"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,
+  createA11yBridge: () => createA11yBridge,
+  dampenedMotion: () => dampenedMotion,
+  motionScale: () => motionScale,
+  pickContrast: () => pickContrast
+});
+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
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  A11yManager,
+  createA11yBridge,
+  dampenedMotion,
+  motionScale,
+  pickContrast
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/manager.ts","../src/helpers.ts","../src/bridge.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';\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"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,oBAAuB;AAiBvB,IAAM,WAAyB;AAAA,EAC7B,eAAe;AAAA,EACf,UAAU;AAAA,EACV,SAAS;AACX;AAQO,IAAM,cAAN,MAAkB;AAAA,EACd,WAAW,IAAI,qBAAqB;AAAA,EACrC;AAAA,EAER,YAAY,UAA8B,CAAC,GAAG;AAC5C,SAAK,YAAY,EAAE,GAAG,UAAU,GAAG,QAAQ,QAAQ;AAAA,EACrD;AAAA,EAEA,IAAI,WAAyB;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,gBAAyB;AAC3B,WAAO,KAAK,UAAU;AAAA,EACxB;AAAA,EAEA,IAAI,WAA0B;AAC5B,WAAO,KAAK,UAAU;AAAA,EACxB;AAAA,EAEA,IAAI,UAAkB;AACpB,WAAO,KAAK,UAAU;AAAA,EACxB;AAAA,EAEA,OAAO,OAAoC;AACzC,UAAM,OAAqB,EAAE,GAAG,KAAK,WAAW,GAAG,MAAM;AACzD,QACE,KAAK,kBAAkB,KAAK,UAAU,iBACtC,KAAK,aAAa,KAAK,UAAU,YACjC,KAAK,YAAY,KAAK,UAAU,SAChC;AACA;AAAA,IACF;AACA,SAAK,YAAY;AACjB,SAAK,SAAS,KAAK,IAAI;AAAA,EACzB;AAAA,EAEA,iBAAiB,GAAkB;AACjC,SAAK,OAAO,EAAE,eAAe,EAAE,CAAC;AAAA,EAClC;AAAA,EAEA,YAAY,GAAwB;AAClC,SAAK,OAAO,EAAE,UAAU,EAAE,CAAC;AAAA,EAC7B;AAAA,EAEA,WAAW,GAAiB;AAC1B,SAAK,OAAO,EAAE,SAAS,EAAE,CAAC;AAAA,EAC5B;AACF;;;ACvEO,SAAS,YAAY,UAAsC,OAAO,GAAW;AAClF,SAAO,SAAS,gBAAgB,IAAI;AACtC;AAOO,SAAS,eACd,UACA,MACA,gBAAgB,KACR;AACR,SAAO,SAAS,gBAAgB,OAAO,gBAAgB;AACzD;AAKO,SAAS,aAAgB,UAA0C,QAAW,MAAY;AAC/F,SAAO,SAAS,aAAa,SAAS,OAAO;AAC/C;;;ACWO,SAAS,iBAAiB,UAA6B,CAAC,GAAe;AAC5E,QAAM,UAAU,QAAQ,WAAW,IAAI,YAAY,EAAE,SAAS,QAAQ,QAAQ,CAAC;AAE/E,WAAS,OAAO,QAAuC;AACrD,UAAM,QAAQ,MAAY;AACxB,aAAO,eAAe,YAAY,QAAQ,QAAQ,CAAC;AAAA,IACrD;AACA,UAAM;AACN,YAAQ,SAAS,IAAI,KAAK;AAC1B,WAAO,MAAM,QAAQ,SAAS,OAAO,KAAK;AAAA,EAC5C;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,cAAc;AAAA,IACd,cAAc;AAAA,EAChB;AACF;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,81 @@
+// 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
+  };
+}
+export {
+  A11yManager,
+  createA11yBridge,
+  dampenedMotion,
+  motionScale,
+  pickContrast
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/manager.ts","../src/helpers.ts","../src/bridge.ts"],"sourcesContent":["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"],"mappings":";AAAA,SAAS,cAAc;AAiBvB,IAAM,WAAyB;AAAA,EAC7B,eAAe;AAAA,EACf,UAAU;AAAA,EACV,SAAS;AACX;AAQO,IAAM,cAAN,MAAkB;AAAA,EACd,WAAW,IAAI,OAAqB;AAAA,EACrC;AAAA,EAER,YAAY,UAA8B,CAAC,GAAG;AAC5C,SAAK,YAAY,EAAE,GAAG,UAAU,GAAG,QAAQ,QAAQ;AAAA,EACrD;AAAA,EAEA,IAAI,WAAyB;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,gBAAyB;AAC3B,WAAO,KAAK,UAAU;AAAA,EACxB;AAAA,EAEA,IAAI,WAA0B;AAC5B,WAAO,KAAK,UAAU;AAAA,EACxB;AAAA,EAEA,IAAI,UAAkB;AACpB,WAAO,KAAK,UAAU;AAAA,EACxB;AAAA,EAEA,OAAO,OAAoC;AACzC,UAAM,OAAqB,EAAE,GAAG,KAAK,WAAW,GAAG,MAAM;AACzD,QACE,KAAK,kBAAkB,KAAK,UAAU,iBACtC,KAAK,aAAa,KAAK,UAAU,YACjC,KAAK,YAAY,KAAK,UAAU,SAChC;AACA;AAAA,IACF;AACA,SAAK,YAAY;AACjB,SAAK,SAAS,KAAK,IAAI;AAAA,EACzB;AAAA,EAEA,iBAAiB,GAAkB;AACjC,SAAK,OAAO,EAAE,eAAe,EAAE,CAAC;AAAA,EAClC;AAAA,EAEA,YAAY,GAAwB;AAClC,SAAK,OAAO,EAAE,UAAU,EAAE,CAAC;AAAA,EAC7B;AAAA,EAEA,WAAW,GAAiB;AAC1B,SAAK,OAAO,EAAE,SAAS,EAAE,CAAC;AAAA,EAC5B;AACF;;;ACvEO,SAAS,YAAY,UAAsC,OAAO,GAAW;AAClF,SAAO,SAAS,gBAAgB,IAAI;AACtC;AAOO,SAAS,eACd,UACA,MACA,gBAAgB,KACR;AACR,SAAO,SAAS,gBAAgB,OAAO,gBAAgB;AACzD;AAKO,SAAS,aAAgB,UAA0C,QAAW,MAAY;AAC/F,SAAO,SAAS,aAAa,SAAS,OAAO;AAC/C;;;ACWO,SAAS,iBAAiB,UAA6B,CAAC,GAAe;AAC5E,QAAM,UAAU,QAAQ,WAAW,IAAI,YAAY,EAAE,SAAS,QAAQ,QAAQ,CAAC;AAE/E,WAAS,OAAO,QAAuC;AACrD,UAAM,QAAQ,MAAY;AACxB,aAAO,eAAe,YAAY,QAAQ,QAAQ,CAAC;AAAA,IACrD;AACA,UAAM;AACN,YAAQ,SAAS,IAAI,KAAK;AAC1B,WAAO,MAAM,QAAQ,SAAS,OAAO,KAAK;AAAA,EAC5C;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,cAAc;AAAA,IACd,cAAc;AAAA,EAChB;AACF;","names":[]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@flare-engine/a11y",
+  "version": "0.1.0",
+  "description": "Accessibility primitives — reduced motion, contrast tokens",
+  "keywords": ["flare-engine", "a11y", "accessibility", "reduced-motion"],
+  "license": "MIT",
+  "author": "Grzegorz Otto",
+  "homepage": "https://github.com/grzott/flare-engine#readme",
+  "bugs": {
+    "url": "https://github.com/grzott/flare-engine/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grzott/flare-engine.git",
+    "directory": "packages/a11y"
+  },
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsup",
+    "test": "bun test",
+    "lint": "biome check src/",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@flare-engine/events": "^0.1.0"
+  },
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "sideEffects": false
+}