npm - @fabric-msft/fabric-web - Versions diffs - 4.0.0 → 5.0.1 - Mend

@fabric-msft/fabric-web 4.0.0 → 5.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (435) hide show

package/dist/esm/util/direction.js CHANGED Viewed

@@ -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 CHANGED Viewed

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

package/dist/esm/util/dom.js ADDED Viewed

@@ -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 ADDED Viewed

	@@ -0,0 +1 @@
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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/esm/util/focus-management.js ADDED Viewed

@@ -0,0 +1,247 @@
+import { keyHome, keyEnd, keyArrowUp, keyArrowRight, keyArrowLeft, keyArrowDown } from '@microsoft/fast-web-utilities';
+/**
+ * Default disabled check: matches disabled, aria-disabled="true", or inert attributes.
+ */
+const defaultIsDisabled = el => el.matches('[disabled], [aria-disabled="true"], [inert]');
+/**
+ * Creates a roving focus controller for managing keyboard navigation
+ * across a list of elements using the roving tabindex pattern.
+ *
+ * @example
+ * ```typescript
+ * const controller = createRovingFocusController({
+ *   items: () => this.slottedPills ?? [],
+ *   orientation: "vertical",
+ *   enableHomeEnd: true,
+ *   wrap: true
+ * });
+ *
+ * // In connectedCallback or setup:
+ * controller.applyTabindex();
+ *
+ * // In keydown handler:
+ * if (controller.handleKeydown(event)) return;
+ * // ...handle other keys like Escape
+ * ```
+ *
+ * @public
+ */
+function createRovingFocusController(options) {
+  const {
+    items,
+    isDisabled = defaultIsDisabled,
+    orientation = "vertical",
+    enableHomeEnd = true,
+    wrap = true,
+    preventDefault = true,
+    focusItem,
+    onFocusChange,
+    isRtl
+  } = options;
+  /**
+   * Find the currently active item (the one with tabindex="0").
+   */
+  const findActiveItem = () => {
+    var _a;
+    const allItems = items();
+    return (_a = allItems.find(el => el.getAttribute("tabindex") === "0")) !== null && _a !== void 0 ? _a : null;
+  };
+  /**
+   * Set tabindex on all items, making the specified element active.
+   * Disabled items are always set to -1 regardless of activeEl.
+   */
+  const setActive = (activeEl, allItems) => {
+    const list = allItems !== null && allItems !== void 0 ? allItems : items();
+    for (const el of list) {
+      const shouldBeActive = el === activeEl && !isDisabled(el);
+      el.tabIndex = shouldBeActive ? 0 : -1;
+      el.setAttribute("tabindex", shouldBeActive ? "0" : "-1");
+    }
+  };
+  /**
+   * Focus an element using custom focusItem or default focus().
+   */
+  const doFocus = el => {
+    if (focusItem) {
+      focusItem(el);
+    } else {
+      el.focus();
+    }
+  };
+  /**
+   * Activate an item: set tabindex, optionally focus, and fire callback.
+   * Centralizes the repeated setActive + doFocus + onFocusChange pattern.
+   */
+  const activate = (el, enabledIndex, shouldFocus, allItems) => {
+    setActive(el, allItems);
+    if (shouldFocus) doFocus(el);
+    if (enabledIndex !== null) onFocusChange === null || onFocusChange === void 0 ? void 0 : onFocusChange(el, enabledIndex);
+  };
+  /**
+   * Apply roving tabindex. Preserves current active if still valid;
+   * otherwise falls back to first enabled.
+   */
+  const applyTabindex = () => {
+    const allItems = items();
+    if (allItems.length === 0) return;
+    const enabled = allItems.filter(el => !isDisabled(el));
+    if (enabled.length === 0) {
+      // No enabled items - all get -1
+      setActive(null, allItems);
+      return;
+    }
+    // Try to preserve current active if still valid and enabled
+    const currentActive = findActiveItem();
+    if (currentActive && enabled.includes(currentActive)) {
+      // Current active is still valid - keep it
+      setActive(currentActive, allItems);
+      return;
+    }
+    // Fall back to first enabled
+    setActive(enabled[0], allItems);
+  };
+  /**
+   * Move focus by delta, with optional wrapping.
+   * Uses tabindex=0 to determine current position (Shadow DOM safe).
+   */
+  const move = delta => {
+    const allItems = items();
+    const enabled = allItems.filter(el => !isDisabled(el));
+    if (enabled.length === 0) return false;
+    // Single item: nowhere to move
+    if (enabled.length === 1) return false;
+    // Find current index via tabindex=0 (not document.activeElement - Shadow DOM safe)
+    const currentActive = findActiveItem();
+    let currentIndex = currentActive ? enabled.indexOf(currentActive) : -1;
+    if (currentIndex === -1) currentIndex = 0;
+    // Calculate next index
+    let nextIndex = currentIndex + delta;
+    if (wrap) {
+      nextIndex = (nextIndex + enabled.length) % enabled.length;
+    } else {
+      // Clamp to bounds
+      if (nextIndex < 0 || nextIndex >= enabled.length) {
+        return false; // At boundary, can't move
+      }
+    }
+    const nextEl = enabled[nextIndex];
+    activate(nextEl, nextIndex, true, allItems);
+    return true;
+  };
+  /**
+   * Focus first enabled item.
+   */
+  const focusFirst = () => {
+    const allItems = items();
+    const enabled = allItems.filter(el => !isDisabled(el));
+    if (enabled.length === 0) return false;
+    activate(enabled[0], 0, true, allItems);
+    return true;
+  };
+  /**
+   * Focus last enabled item.
+   */
+  const focusLast = () => {
+    const allItems = items();
+    const enabled = allItems.filter(el => !isDisabled(el));
+    if (enabled.length === 0) return false;
+    const lastIndex = enabled.length - 1;
+    activate(enabled[lastIndex], lastIndex, true, allItems);
+    return true;
+  };
+  /**
+   * Focus specific item.
+   */
+  const focus = item => {
+    const allItems = items();
+    if (!allItems.includes(item)) return false;
+    if (isDisabled(item)) return false;
+    const enabled = allItems.filter(el => !isDisabled(el));
+    const index = enabled.indexOf(item);
+    activate(item, index !== -1 ? index : null, true, allItems);
+    return true;
+  };
+  /**
+   * Sync tabindex to target without focusing (for click/focusin handlers).
+   * Fires onFocusChange to maintain consistency with other activation methods.
+   */
+  const sync = target => {
+    if (!target || !(target instanceof HTMLElement)) return false;
+    const allItems = items();
+    // Find the closest managed item (target might be a child of a managed item)
+    const item = allItems.find(el => el === target || el.contains(target));
+    if (!item) return false;
+    if (isDisabled(item)) return false;
+    const enabled = allItems.filter(el => !isDisabled(el));
+    const index = enabled.indexOf(item);
+    // Use activate with shouldFocus=false to avoid refocus jump
+    activate(item, index !== -1 ? index : null, false, allItems);
+    return true;
+  };
+  /**
+   * Check if a key matches the navigation direction.
+   * Respects RTL mode for horizontal navigation.
+   */
+  const isNavigationKey = (key, direction) => {
+    const rtl = isRtl();
+    if (direction === "prev") {
+      if (orientation === "vertical" || orientation === "both") {
+        if (key === keyArrowUp) return true;
+      }
+      if (orientation === "horizontal" || orientation === "both") {
+        // In RTL, ArrowRight goes to previous
+        if (rtl ? key === keyArrowRight : key === keyArrowLeft) return true;
+      }
+    } else {
+      if (orientation === "vertical" || orientation === "both") {
+        if (key === keyArrowDown) return true;
+      }
+      if (orientation === "horizontal" || orientation === "both") {
+        // In RTL, ArrowLeft goes to next
+        if (rtl ? key === keyArrowLeft : key === keyArrowRight) return true;
+      }
+    }
+    return false;
+  };
+  /**
+   * Handle keydown event.
+   */
+  const handleKeydown = event => {
+    const {
+      key
+    } = event;
+    let handled = false;
+    if (isNavigationKey(key, "prev")) {
+      handled = move(-1);
+    } else if (isNavigationKey(key, "next")) {
+      handled = move(1);
+    } else if (enableHomeEnd && key === keyHome) {
+      handled = focusFirst();
+    } else if (enableHomeEnd && key === keyEnd) {
+      handled = focusLast();
+    }
+    if (handled && preventDefault) {
+      event.preventDefault();
+    }
+    return handled;
+  };
+  /**
+   * Cleanup (no-op for now, kept for lifecycle symmetry).
+   */
+  const destroy = () => {
+    // No listeners to clean up - component handles that
+  };
+  return {
+    applyTabindex,
+    move,
+    focusFirst,
+    focusLast,
+    focus,
+    sync,
+    handleKeydown,
+    destroy
+  };
+}
+export { createRovingFocusController };

package/dist/esm/util/focus-management.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"focus-management.js","sourceRoot":"","sources":["../../../../../../src/util/focus-management.ts"],"names":[],"mappings":"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"}

package/dist/esm/util/hash-utilities.js ADDED Viewed

@@ -0,0 +1,12 @@
+/**
+ * Creates a unique ID string using a prefix and counter as salt for the random hex.
+ * @param prefix - The prefix string for the ID
+ * @param counter - Optional. A counter value used as salt for additional uniqueness
+ * @returns A unique ID string in the format `{prefix}{counter}-{randomHex}`
+ */
+function createUniqueId(prefix, counter = 0) {
+  const randomHex = Math.round((Math.random() + counter) * 0x10000).toString(16).slice(0, 8);
+  return `${prefix}${counter}-${randomHex}`;
+}
+export { createUniqueId };

package/dist/esm/util/hash-utilities.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"hash-utilities.js","sourceRoot":"","sources":["../../../../../../src/util/hash-utilities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,UAAkB,CAAC;IAChE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC;SAC9D,QAAQ,CAAC,EAAE,CAAC;SACZ,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACf,OAAO,GAAG,MAAM,GAAG,OAAO,IAAI,SAAS,EAAE,CAAC;AAC5C,CAAC"}