@fabric-msft/fabric-web 5.0.0 → 5.0.1

package/dist/esm/util/debug.js

@@ -0,0 +1,74 @@
+//-----------------------------------------------------------------------
+// <copyright company="Microsoft Corporation">
+//        Copyright (c) Microsoft Corporation.  All rights reserved.
+// </copyright>
+//-----------------------------------------------------------------------
+/**
+ * Holds a collection of debug-related functions. When the instance is not in debug mode, most/all of
+ * the side-effects will be disabled.
+ */
+class debug {
+  static setAssertFailFunction(f) {
+    debug.assertFailFunction = f;
+  }
+  /**
+   * Asserts that the condition is true, fails otherwise.
+   */
+  static assert(conditionFunc, message) {
+    if (!this.enabled) return;
+    const condition = conditionFunc();
+    message = message !== null && message !== void 0 ? message : "condition: " + condition;
+    if (condition !== true) {
+      debug.assertFail(message);
+    }
+  }
+  /**
+   * Asserts that the value is neither null nor undefined, fails otherwise.
+   */
+  static assertDefined(value, message) {
+    if (!this.enabled) return;
+    debug.assert(() => value !== null && value !== undefined, message);
+  }
+  /**
+   * Asserts that the value is neither null nor undefined, and has a length property that returns greater than zero, fails otherwise.
+   */
+  static assertNonEmpty(value, message) {
+    if (!this.enabled) return;
+    debug.assert(() => value != null && value.length > 0, message);
+  }
+  /**
+   * Asserts that this function is never called. This is to be used
+   */
+  static assertNever(neverValue) {
+    if (!this.enabled) return;
+    debug.assertFail("Expected to never have value " + neverValue);
+  }
+  static assertFail(message) {
+    if (!this.enabled) return;
+    (debug.assertFailFunction || alert)(`Debug Assert failed: ${message}`);
+  }
+  static log(message, ...optionalParams) {
+    if (!this.enabled) return;
+    console.log(message, ...(optionalParams || []));
+  }
+  static logDebug(message, ...optionalParams) {
+    if (!this.enabled) return;
+    console.debug(message, ...(optionalParams || []));
+  }
+  static warn(message, ...optionalParams) {
+    if (!this.enabled) return;
+    if (console && console.warn) {
+      console.warn(message, ...(optionalParams || []));
+    }
+  }
+  static execute(action) {
+    if (!this.enabled) return;
+    action();
+  }
+  static enable() {
+    this.enabled = true;
+  }
+}
+debug.enabled = false;
+
+export { debug };

package/dist/esm/util/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../../../../../src/util/debug.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,8CAA8C;AAC9C,oEAAoE;AACpE,eAAe;AACf,yEAAyE;AAEzE;;;GAGG;AACH,MAAM,OAAO,KAAK;IAET,MAAM,CAAC,qBAAqB,CAAC,CAA4B;QAC9D,KAAK,CAAC,kBAAkB,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,MAAM,CAAC,aAA4B,EAAE,OAAgB;QACjE,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;QAClC,OAAO,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,aAAa,GAAG,SAAS,CAAC;QAC/C,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,aAAa,CAAI,KAAQ,EAAE,OAAe;QACtD,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,cAAc,CAAI,KAAmB,EAAE,OAAe;QAClE,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,WAAW,CAAC,UAAiB;QACzC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,KAAK,CAAC,UAAU,CAAC,+BAA+B,GAAG,UAAU,CAAC,CAAC;IACjE,CAAC;IAEM,MAAM,CAAC,UAAU,CAAC,OAAe;QACtC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,CAAC,KAAK,CAAC,kBAAkB,IAAI,KAAK,CAAC,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAEM,MAAM,CAAC,GAAG,CAAC,OAAe,EAAE,GAAG,cAAyB;QAC7D,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC;IAEM,MAAM,CAAC,QAAQ,CAAC,OAAe,EAAE,GAAG,cAAyB;QAClE,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,CAAC;IACpD,CAAC;IAEM,MAAM,CAAC,IAAI,CAAC,OAAe,EAAE,GAAG,cAAyB;QAC9D,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAEM,MAAM,CAAC,OAAO,CAAC,MAAkB;QACtC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,MAAM,EAAE,CAAC;IACX,CAAC;IAIM,MAAM,CAAC,MAAM;QAClB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;;AAJc,aAAO,GAAG,KAAK,CAAC"}

package/dist/esm/util/direction.js

@@ -1,5 +1,88 @@
-//Copied from @microsoft/fast-foundation
-import { Direction } from "@microsoft/fast-web-utilities";
+import { Direction } from '@microsoft/fast-web-utilities';
+
+/**
+ * This module provides a composable system for detecting and monitoring text direction
+ * (LTR/RTL) changes in web applications. It follows a strategy/observer pattern to allow
+ * flexibility for the many ways that direction can be controlled in the document.
+ *
+ * ## Architecture
+ *
+ * The system uses two complementary interfaces:
+ *
+ * - **DirectionStrategy**: Detection - reads direction from a source (CSS, attributes, etc.)
+ * - **DirectionObserver**: Change monitoring - watches for direction changes and notifies
+ *
+ * The `DirectionDetector` class combines the detection and observer strategies to provide
+ * robust direction detection with automatic change notifications.
+ *
+ * ## Built-in Strategies
+ *
+ * - `DirAttributeStrategy`: Reads the `dir` attribute from elements
+ * - `ElementCssStrategy`: Reads computed CSS `direction` property
+ *
+ * ## Built-in Observers
+ *
+ * - `DirAttributeObserver`: Watches for `dir` attribute mutations via MutationObserver
+ *
+ * ## Global DirectionDetector
+ *
+ * A singleton detector is available via `globalDirectionDetector()`. By default, it
+ * monitors the `dir` attribute on the `<html>` element. This is the detector used by the
+ * components in this package to correctly adjust layout, keyboard navigation, etc.
+ *
+ * To customize the global detector, call `setGlobalDirectionDetector()`:
+ *
+ * ```typescript
+ * import {
+ *   setGlobalDirectionDetector,
+ *   DirectionDetector,
+ *   DirAttributeStrategy,
+ *   DirAttributeObserver
+ * } from "@fabric-msft/fabric-web";
+ *
+ * setGlobalDirectionDetector(
+ *   new DirectionDetector({
+ *     strategies: [new DirAttributeStrategy([document.documentElement])],
+ *     observers: [new DirAttributeObserver("html")],
+ *     onChange: (dir) => console.log("Global direction:", dir)
+ *   })
+ * );
+ * ```
+ *
+ * ## Defaults
+ *
+ * The default global DirectionDetector will monitor the `dir` attribute on the
+ * `html` element. You do not need to set anything if this is the strategy that your app
+ * uses to control document direction.
+ *
+ * ```html
+ * <html dir="rtl">
+ * ```
+ *
+ * ## Custom DirectionDetector
+ *
+ * ```typescript
+ * import {
+ *   DirectionDetector,
+ *   DirAttributeStrategy,
+ *   DirAttributeObserver
+ * } from "@fabric-msft/fabric-web";
+ *
+ * const detector = new DirectionDetector({
+ *   strategies: [new DirAttributeStrategy([document.documentElement])],
+ *   observers: [new DirAttributeObserver("html")],
+ *   onChange: (dir, { previous }) => {
+ *     console.log(`Direction changed: ${previous} → ${dir}`);
+ *   }
+ * });
+ *
+ * // Access current direction
+ * console.log(detector.value); // 'ltr' or 'rtl'
+ *
+ * // Clean up when done
+ * detector.stop();
+ * ```
+ */
 /**
  * Determines the current localization direction of an element.
  *
@@ -8,10 +91,159 @@ import { Direction } from "@microsoft/fast-web-utilities";
  *
  * @public
  */
-export const getDirection = (rootNode) => {
-    var _a;
-    return ((_a = rootNode.closest("[dir]")) === null || _a === void 0 ? void 0 : _a.dir) === "rtl"
-        ? Direction.rtl
-        : Direction.ltr;
+const getDirection = rootNode => {
+  var _a;
+  return ((_a = rootNode.closest("[dir]")) === null || _a === void 0 ? void 0 : _a.dir) === "rtl" ? Direction.rtl : Direction.ltr;
 };
-//# sourceMappingURL=direction.js.map
+function isRtl() {
+  return globalDirectionDetector().value === Direction.rtl;
+}
+/**
+ * Strategy that reads direction from the dir attribute.
+ * Takes a list of elements and checks each element until it finds one with a "dir" attribute specified.
+ * @public
+ */
+class DirAttributeStrategy {
+  constructor(elements) {
+    this.elements = elements;
+  }
+  getDirection() {
+    var _a;
+    for (const el of this.elements) {
+      const raw = ((_a = el.getAttribute("dir")) !== null && _a !== void 0 ? _a : "").trim().toLowerCase();
+      if (raw === Direction.rtl || raw === Direction.ltr) return raw;
+      if (raw === "auto") return null;
+    }
+    return null;
+  }
+}
+/**
+ * Observer that watches for dir attribute changes using MutationObserver.
+ * @public
+ */
+class DirAttributeObserver {
+  constructor(target = "html", doc = document) {
+    this.mo = null;
+    this.target = target;
+    this.doc = doc;
+  }
+  start(notify) {
+    var _a;
+    if (this.mo) return;
+    const observeEl = typeof this.target === "string" ? (_a = this.doc.querySelector(this.target)) !== null && _a !== void 0 ? _a : this.doc.documentElement : this.target;
+    if (!observeEl) return;
+    this.mo = new MutationObserver(() => notify());
+    this.mo.observe(observeEl, {
+      attributes: true,
+      attributeFilter: ["dir"]
+    });
+  }
+  stop() {
+    var _a;
+    (_a = this.mo) === null || _a === void 0 ? void 0 : _a.disconnect();
+    this.mo = null;
+  }
+}
+/**
+ * Detects and (optionally) observes direction using a chain of strategies.
+ * The first strategy to return a non-null direction wins.
+ * @public
+ */
+class DirectionDetector {
+  constructor(options) {
+    var _a;
+    this.rafId = null;
+    this._value = null;
+    this.observing = false;
+    this.strategies = options.strategies;
+    this.observers = (_a = options.observers) !== null && _a !== void 0 ? _a : [];
+    this.onChange = options.onChange;
+    this._value = this.computeDirection();
+    if (this.observers.length > 0) this.start();
+  }
+  get value() {
+    var _a;
+    return (_a = this._value) !== null && _a !== void 0 ? _a : Direction.ltr;
+  }
+  /**
+   * Start all observers.
+   */
+  start() {
+    if (this.observing) return;
+    this.observing = true;
+    const scheduleRefresh = () => {
+      if (this.rafId != null) return;
+      if (typeof requestAnimationFrame === "undefined") {
+        this.refresh();
+        return;
+      }
+      this.rafId = requestAnimationFrame(() => {
+        this.rafId = null;
+        this.refresh();
+      });
+    };
+    for (const observer of this.observers) {
+      observer.start(scheduleRefresh);
+    }
+    // Initial refresh after starting observation
+    this.refresh();
+  }
+  /**
+   * Stop observing and cancel any scheduled refresh.
+   */
+  stop() {
+    if (this.rafId != null && typeof cancelAnimationFrame !== "undefined") {
+      cancelAnimationFrame(this.rafId);
+    }
+    this.rafId = null;
+    for (const observer of this.observers) {
+      observer.stop();
+    }
+    this.observing = false;
+  }
+  stable() {
+    return this.rafId == null;
+  }
+  /**
+   * Force recomputation; invokes onChange only if the resolved direction changed.
+   */
+  refresh() {
+    var _a;
+    const previous = this._value;
+    const next = this.computeDirection();
+    if (next !== previous) {
+      this._value = next;
+      try {
+        (_a = this.onChange) === null || _a === void 0 ? void 0 : _a.call(this, next, {
+          previous
+        });
+      } catch {
+        // ignore callback errors
+      }
+    }
+    return this._value;
+  }
+  computeDirection() {
+    for (const strategy of this.strategies) {
+      const dir = strategy.getDirection();
+      if (dir) return dir;
+    }
+    return null;
+  }
+}
+let _globalDetector = null;
+function setGlobalDirectionDetector(detector) {
+  _globalDetector = detector;
+}
+function globalDirectionDetector() {
+  if (!_globalDetector) {
+    // Default to a strategy that expects dir to be on the root html element.
+    _globalDetector = new DirectionDetector({
+      strategies: [new DirAttributeStrategy([document.documentElement])],
+      observers: [new DirAttributeObserver("html")]
+    });
+  }
+  return _globalDetector;
+}
+
+export { DirAttributeObserver, DirAttributeStrategy, DirectionDetector, getDirection, globalDirectionDetector, isRtl, setGlobalDirectionDetector };

package/dist/esm/util/direction.js.map

@@ -1 +1 @@
-{"version":3,"file":"direction.js","sourceRoot":"","sources":["../../../../../../src/util/direction.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAqB,EAAa,EAAE;;IAC/D,OAAO,CAAA,MAAA,QAAQ,CAAC,OAAO,CAAc,OAAO,CAAC,0CAAE,GAAG,MAAK,KAAK;QAC1D,CAAC,CAAC,SAAS,CAAC,GAAG;QACf,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC;AACpB,CAAC,CAAC"}
+{"version":3,"file":"direction.js","sourceRoot":"","sources":["../../../../../../src/util/direction.ts"],"names":[],"mappings":"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"}

package/dist/esm/util/dom.js

@@ -0,0 +1,3 @@
+const inputElementMethods = ["blur", "click", "focus", "select", "setSelectionRange", "setRangeText", "setCustomValidity", "showPicker", "checkValidity", "reportValidity", "stepUp", "stepDown"];
+
+export { inputElementMethods };

package/dist/esm/util/dom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.js","sourceRoot":"","sources":["../../../../../../src/util/dom.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,MAAM;IACN,OAAO;IACP,OAAO;IACP,QAAQ;IACR,mBAAmB;IACnB,cAAc;IACd,mBAAmB;IACnB,YAAY;IACZ,eAAe;IACf,gBAAgB;IAChB,QAAQ;IACR,UAAU;CACX,CAAC"}

package/dist/esm/util/element-internal-mocks.js

@@ -0,0 +1,114 @@
+class MockElementInternals {
+  constructor(element) {
+    this.ariaDescription = null;
+    this.ariaBrailleLabel = null;
+    this.ariaBrailleRoleDescription = null;
+    this._form = null;
+    this._labels = document.createDocumentFragment().childNodes;
+    // ARIA properties
+    this.role = "";
+    this.ariaAtomic = "";
+    this.ariaAutoComplete = "";
+    this.ariaBusy = "";
+    this.ariaChecked = "";
+    this.ariaColCount = "";
+    this.ariaColIndex = "";
+    this.ariaColIndexText = "";
+    this.ariaColSpan = "";
+    this.ariaCurrent = "";
+    this.ariaDisabled = "";
+    this.ariaExpanded = "";
+    this.ariaHasPopup = "";
+    this.ariaHidden = "";
+    this.ariaInvalid = "";
+    this.ariaKeyShortcuts = "";
+    this.ariaLabel = "";
+    this.ariaLevel = "";
+    this.ariaLive = "";
+    this.ariaModal = "";
+    this.ariaMultiLine = "";
+    this.ariaMultiSelectable = "";
+    this.ariaOrientation = "";
+    this.ariaPlaceholder = "";
+    this.ariaPosInSet = "";
+    this.ariaPressed = "";
+    this.ariaReadOnly = "";
+    this.ariaRelevant = "";
+    this.ariaRequired = "";
+    this.ariaRoleDescription = "";
+    this.ariaRowCount = "";
+    this.ariaRowIndex = "";
+    this.ariaRowIndexText = "";
+    this.ariaRowSpan = "";
+    this.ariaSelected = "";
+    this.ariaSetSize = "";
+    this.ariaSort = "";
+    this.ariaValueMax = "";
+    this.ariaValueMin = "";
+    this.ariaValueNow = "";
+    this.ariaValueText = "";
+    // add the element to the MockElementInternals class
+    // the constructor is called when attachInternals is called on the element using ElementInternals.
+    this._element = element;
+  }
+  get form() {
+    if (!this._form) {
+      // get the closest form element from the element
+      this._form = this._element.closest("form");
+    }
+    return this._form;
+  }
+  get labels() {
+    return this._labels;
+  }
+  get shadowRoot() {
+    return null;
+  }
+  get states() {
+    return new Set();
+  }
+  // Validation properties
+  get validationMessage() {
+    return "";
+  }
+  get validity() {
+    return {
+      badInput: false,
+      customError: false,
+      patternMismatch: false,
+      rangeOverflow: false,
+      rangeUnderflow: false,
+      stepMismatch: false,
+      tooLong: false,
+      tooShort: false,
+      typeMismatch: false,
+      valid: true,
+      valueMissing: false
+    };
+  }
+  get willValidate() {
+    return true;
+  }
+  // Methods
+  checkValidity() {
+    return true;
+  }
+  reportValidity() {
+    return true;
+  }
+  setFormValue(_value, _state) {}
+  setValidity(_flags, _message, _anchor) {}
+}
+/**
+ * If the HTMLElement prototype does not have the attachInternals method, add it.
+ * This is used to create a new MockElementInternals instance when the element is attached to the DOM.
+ */
+function attachMockElementInternals() {
+  if (!HTMLElement.prototype.attachInternals) {
+    HTMLElement.prototype.attachInternals = function () {
+      return new MockElementInternals(this);
+    };
+  }
+}
+
+export { MockElementInternals, attachMockElementInternals };

package/dist/esm/util/element-internal-mocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-internal-mocks.js","sourceRoot":"","sources":["../../../../../../src/util/element-internal-mocks.ts"],"names":[],"mappings":"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"}