@fabric-msft/fabric-web 5.0.0 → 5.0.1

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

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

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

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

@@ -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"}

package/dist/esm/util/index.js

@@ -1,11 +1,18 @@
+export * from "./accessibility-utilities.js";
+export * from "./apply-mixins.js";
+export * from "./attribute-utilities.js";
+export * from "./debounce.js";
+export * from "./debug.js";
 export * from "./descendants.js";
 export * from "./direction.js";
-export * from "./typings.js";
-export * from "./template-helpers.js";
-export * from "./match-media-stylesheet-behaviors.js";
+export * from "./dom.js";
+export * from "./element-internal-mocks.js";
 export * from "./element-internals.js";
-export * from "./apply-mixins.js";
-export * from "./whitespace-filter.js";
+export * from "./focus-management.js";
+export * from "./hash-utilities.js";
+export * from "./match-media-stylesheet-behaviors.js";
 export * from "./support.js";
-export * from "./positioning.js";
+export * from "./template-helpers.js";
+export * from "./typings.js";
+export * from "./whitespace-filter.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/util/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uCAAuC,CAAC;AACtD,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/util/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uCAAuC,CAAC;AACtD,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC"}

package/dist/esm/util/positioning/flexible-position-strategy.js

@@ -0,0 +1,232 @@
+import { getBoundaryBounds, getViewportBounds, getEffectiveBoundary, getOriginPoint, getOverlayPoint, getOverlayFit, applyPositionStyles } from './position-calculator.js';
+
+/**
+ * Flexible position strategy - main positioning engine.
+ * Orchestrates position calculation, fallback selection, and style application.
+ * Inspired by Angular CDK's FlexibleConnectedPositionStrategy.
+ */
+/**
+ * Flexible position strategy implementation.
+ * Main entry point for positioning overlays with fallback logic.
+ */
+class FlexiblePositionStrategy {
+  constructor(config) {
+    var _a, _b, _c, _d;
+    this.origin = config.origin;
+    this.overlay = config.overlay;
+    this.positions = config.positions;
+    this.boundaryElement = (_a = config.boundaryElement) !== null && _a !== void 0 ? _a : null;
+    this.offsetParent = (_b = config.offsetParent) !== null && _b !== void 0 ? _b : null;
+    this.viewportMargin = (_c = config.viewportMargin) !== null && _c !== void 0 ? _c : 0;
+    this.resize = (_d = config.resize) !== null && _d !== void 0 ? _d : false;
+    this.resizeMinHeight = config.resizeMinHeight;
+  }
+  /**
+   * Get the effective boundary (custom boundary or viewport).
+   */
+  getBoundary() {
+    const rawBoundary = this.boundaryElement ? getBoundaryBounds(this.boundaryElement) : getViewportBounds();
+    return getEffectiveBoundary(rawBoundary, this.viewportMargin);
+  }
+  /**
+   * Returns the configured candidate positions.
+   */
+  getCandidates() {
+    return [...this.positions];
+  }
+  /**
+   * Evaluate a single position against the current boundary.
+   * Returns the computed PositionResult without applying any styles.
+   */
+  evaluatePosition(position) {
+    const originRect = this.origin.getBoundingClientRect();
+    const overlayRect = this.overlay.getBoundingClientRect();
+    const boundary = this.getBoundary();
+    const originPoint = getOriginPoint(originRect, position);
+    const overlayPoint = getOverlayPoint(originPoint, overlayRect, position);
+    const fit = getOverlayFit(overlayPoint, overlayRect, boundary);
+    return {
+      position,
+      originPoint,
+      overlayPoint,
+      fit
+    };
+  }
+  /**
+   * Selects the best position from the candidates list.
+   *
+   * 1. First candidate that fits completely wins immediately.
+   * 2. If nothing fits and resize is enabled, picks the one with most
+   *    available space (best candidate for resize).
+   * 3. Otherwise picks the position with the most visible area.
+   */
+  selectBestPosition() {
+    const candidates = this.getCandidates();
+    let bestResult = this.evaluatePosition(candidates[0]);
+    let bestArea = bestResult.fit.visibleArea;
+    if (bestResult.fit.isCompletelyWithinViewport) {
+      return bestResult;
+    }
+    for (let i = 1; i < candidates.length; i++) {
+      const result = this.evaluatePosition(candidates[i]);
+      if (result.fit.isCompletelyWithinViewport) {
+        return result;
+      }
+      if (result.fit.visibleArea > bestArea) {
+        bestResult = result;
+        bestArea = result.fit.visibleArea;
+      }
+    }
+    // Nothing fits. If resize is enabled, prefer the candidate with most room.
+    if (this.resize && candidates.length > 1) {
+      let bestSpace = this.getAvailableSpace(candidates[0]);
+      let bestSpaceCandidate = candidates[0];
+      for (let i = 1; i < candidates.length; i++) {
+        const space = this.getAvailableSpace(candidates[i]);
+        if (space > bestSpace) {
+          bestSpace = space;
+          bestSpaceCandidate = candidates[i];
+        }
+      }
+      if (bestSpaceCandidate !== bestResult.position) {
+        return this.evaluatePosition(bestSpaceCandidate);
+      }
+    }
+    return bestResult;
+  }
+  /**
+   * Apply position result to the overlay element.
+   */
+  applyPositionResult(result) {
+    applyPositionStyles(this.overlay, result.overlayPoint, result.position, this.offsetParent);
+  }
+  /**
+   * Get the available space for the overlay in a given position.
+   * Measures the distance from the anchor edge to the boundary edge in the
+   * relevant direction based on the position's connection points.
+   *
+   * @param position - The connected position to measure space for.
+   * @returns Available space in pixels.
+   */
+  getAvailableSpace(position) {
+    var _a;
+    const originRect = this.origin.getBoundingClientRect();
+    const boundary = this.getBoundary();
+    // Determine direction based on the connection points.
+    // "above" style: overlayY === bottom, originY === top → space above anchor
+    // "below" style: overlayY === top, originY === bottom → space below anchor
+    if (position.overlayY === "bottom" && position.originY === "top") {
+      // Overlay sits above the anchor
+      return Math.max(0, originRect.top - boundary.top);
+    }
+    if (position.overlayY === "top" && position.originY === "bottom") {
+      // Overlay sits below the anchor
+      return Math.max(0, boundary.bottom - originRect.bottom);
+    }
+    // Horizontal cases (start/end)
+    if (position.overlayX === "end" && position.originX === "start") {
+      return Math.max(0, originRect.left - boundary.left);
+    }
+    if (position.overlayX === "start" && position.originX === "end") {
+      return Math.max(0, boundary.right - originRect.right);
+    }
+    // Fallback: return full boundary height
+    return Math.max(0, ((_a = boundary.height) !== null && _a !== void 0 ? _a : boundary.bottom - boundary.top) || 0);
+  }
+  /**
+   * Applies a resize constraint to the overlay element if it
+   * does not fit in the available space for the given position.
+   *
+   * @param position - The connected position to measure available space for.
+   * @returns Whether a constraint was applied and the max-height value.
+   */
+  tryResize(position) {
+    if (!this.resize) {
+      return {
+        resized: false,
+        maxHeight: null
+      };
+    }
+    const overlayHeight = this.overlay.getBoundingClientRect().height;
+    const available = this.getAvailableSpace(position);
+    if (overlayHeight <= available) {
+      return {
+        resized: false,
+        maxHeight: null
+      };
+    }
+    if (this.resizeMinHeight !== undefined && available < this.resizeMinHeight) {
+      return {
+        resized: false,
+        maxHeight: null
+      };
+    }
+    this.overlay.style.maxHeight = `${available}px`;
+    this.overlay.style.overflow = "auto";
+    return {
+      resized: true,
+      maxHeight: available
+    };
+  }
+  /**
+   * High-level reposition entry point.
+   *
+   * 1. Clears any previous resize constraint so the overlay is evaluated
+   *    at its natural size.
+   * 2. Selects the best position from the positions array.
+   * 3. Applies a resize constraint if the overlay still overflows.
+   * 4. Applies the final position.
+   *
+   * The component controls flip vs auto behavior by choosing which
+   * positions to provide:
+   * - Flip: `[original, opposite]`
+   * - Auto: `[original, ...allOtherCandidates]`
+   *
+   * @returns A {@link RepositionResult} describing what happened, or `null`
+   *   if no positions or resize are provided.
+   */
+  reposition() {
+    const candidates = this.getCandidates();
+    if (candidates.length === 0 && !this.resize) {
+      return null;
+    }
+    // Clear any previous resize constraint to evaluate natural size
+    this.clearResize();
+    // Step 1: Select the best position (evaluated at natural overlay size)
+    let positionResult = this.selectBestPosition();
+    // Step 2: Apply resize constraint if enabled
+    let resized = false;
+    let maxHeight = null;
+    if (this.resize) {
+      ({
+        resized,
+        maxHeight
+      } = this.tryResize(positionResult.position));
+      if (resized) {
+        // Re-evaluate the overlay point now that the element has been resized.
+        // The post-resize dimensions are smaller, so any position that depends
+        // on overlay height (e.g. "above" where overlayY === "bottom") would
+        // produce a stale — and incorrect — overlayPoint if we skipped this.
+        positionResult = this.evaluatePosition(positionResult.position);
+      }
+    }
+    // Step 3: Apply the selected position
+    this.applyPositionResult(positionResult);
+    return {
+      resized,
+      maxHeight,
+      positionResult
+    };
+  }
+  /**
+   * Clear any resize constraint applied to the overlay element.
+   */
+  clearResize() {
+    if (this.resize) {
+      this.overlay.style.maxHeight = "";
+      this.overlay.style.overflow = "";
+    }
+  }
+}
+
+export { FlexiblePositionStrategy };

package/dist/esm/util/positioning/flexible-position-strategy.js.map

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

package/dist/esm/util/positioning/index.js

@@ -0,0 +1,10 @@
+/**
+ * Positioning utilities - Angular CDK-inspired positioning engine.
+ * @packageDocumentation
+ */
+export { HorizontalConnectionPositions, VerticalConnectionPositions, CollisionEdges, RepositionModes, DEFAULT_ROOT_MARGIN } from "./types.js";
+// Position Calculator
+export { getViewportBounds, getBoundaryBounds, getEffectiveBoundary, getOriginPoint, getOverlayPoint, getOverlayFit, applyPositionStyles } from "./position-calculator.js";
+// Flexible Position Strategy
+export { FlexiblePositionStrategy } from "./flexible-position-strategy.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/util/positioning/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/util/positioning/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH,OAAO,EACL,6BAA6B,EAC7B,2BAA2B,EAC3B,cAAc,EACd,eAAe,EACf,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,sBAAsB;AACtB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,aAAa,EACb,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAElC,6BAA6B;AAC7B,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC"}