@atlaskit/top-layer 0.12.2 → 0.13.0

package/dist/es2019/focus/focus.js

@@ -1,158 +0,0 @@
-/**
- * Focusable element selectors and navigation helpers.
- *
- * Uses CSS selectors to discover focusable elements within a container,
- * avoiding the need for a manual registration system. Disabled elements
- * (both HTML `disabled` attribute and `aria-disabled="true"`) and elements
- * with `tabindex="-1"` are excluded automatically.
- *
- * All public functions accept an optional `filter` callback to further
- * restrict which focusable elements are included.
- */
-
-import { getDocument } from '@atlaskit/browser-apis';
-const selectors = (() => {
-  // Common exclusion filter applied to every selector.
-  const not = ':not([tabindex="-1"]):not([aria-disabled="true"]):not([aria-hidden="true"])';
-  const notDisabled = `:not([disabled])${not}`;
-  const focusable = [`a[href]${not}`, `area[href]${not}`, `input${notDisabled}:not([type="hidden"])`, `select${notDisabled}`, `textarea${notDisabled}`, `button${notDisabled}`, `iframe${not}`, `audio[controls]${not}`, `video[controls]${not}`, `[contenteditable]:not([contenteditable="false"])${not}`, `[tabindex]${notDisabled}${not}`];
-  return {
-    focusable: focusable.join(','),
-    // Build the `:focus` selector
-    focused: focusable.map(selector => `${selector}:focus`).join(',')
-  };
-})();
-const topLayerSelector = '[popover], dialog, [role="dialog"], [role="alertdialog"]';
-
-/**
- * Returns true when `element` and `container` resolve to the same nearest
- * top-layer host (or both resolve to `null`, meaning the document layer).
- */
-function isInSameLayer({
-  element,
-  container
-}) {
-  const elementLayer = element.closest(topLayerSelector);
-  const containerLayer = container.closest(topLayerSelector);
-  // Both elements are in the "document" layer
-  if (!elementLayer && !containerLayer) {
-    return true;
-  }
-  return elementLayer === containerLayer;
-}
-
-/**
- * Returns `true` when `document.activeElement` is inside a nested top-layer
- * descendant of `container` (a `[popover]`, `<dialog>`, `[role="dialog"]` or
- * `[role="alertdialog"]` that is itself a descendant of `container`).
- */
-export function isNestedLayerFocused({
-  container
-}) {
-  var _getDocument;
-  const focused = (_getDocument = getDocument()) === null || _getDocument === void 0 ? void 0 : _getDocument.activeElement;
-  if (!(focused instanceof HTMLElement)) {
-    return false;
-  }
-
-  // Cannot be in a nested layer if it is not in the container
-  if (!container.contains(focused)) {
-    return false;
-  }
-
-  // If not in the same layer, must be in a nested layer
-  return !isInSameLayer({
-    element: focused,
-    container
-  });
-}
-
-/**
- * An optional callback to restrict which focusable elements are included.
- * Return `true` to include the element, `false` to skip it.
- */
-
-/**
- * Returns all focusable HTMLElements within the container, optionally filtered.
- *
- * Focusables that belong to a nested top-layer scope (a `[popover]` or
- * `<dialog>` descendant of the container) are excluded - those elements
- * are owned by the inner layer's focus management. The container itself
- * is allowed to be a popover/dialog; only nested ones are filtered.
- */
-function getFocusables({
-  container,
-  filter
-}) {
-  return Array.from(container.querySelectorAll(selectors.focusable)).filter(element => element instanceof HTMLElement).filter(element => isInSameLayer({
-    element,
-    container
-  })).filter(element => !filter || filter(element, container));
-}
-
-/**
- * Returns the first focusable element within the container.
- */
-// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
-export function getFirstFocusable({
-  container,
-  filter
-}) {
-  const items = getFocusables({
-    container,
-    filter
-  });
-  return items.length > 0 ? items[0] : null;
-}
-
-/**
- * Returns the last focusable element within the container.
- */
-// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
-export function getLastFocusable({
-  container,
-  filter
-}) {
-  const items = getFocusables({
-    container,
-    filter
-  });
-  return items.length > 0 ? items[items.length - 1] : null;
-}
-
-/**
- * Returns the next focusable element in the given direction relative to the
- * currently focused element within the container. Wraps around at both ends.
- *
- * Returns `null` if there is no focused element within the container or if
- * the focused element is not in the list of focusable elements.
- */
-// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
-export function getNextFocusable({
-  container,
-  direction,
-  filter
-}) {
-  var _all$nextIndex;
-  const all = getFocusables({
-    container,
-    filter
-  });
-  const current = container.querySelector(selectors.focused);
-  if (!(current instanceof HTMLElement)) {
-    return null;
-  }
-  const index = all.indexOf(current);
-  if (index === -1) {
-    return null;
-  }
-  const nextIndex = (() => {
-    if (direction === 'forwards') {
-      return (index + 1) % all.length;
-    }
-    const proposed = index - 1;
-    // if going into negative numbers, loop back to the last item
-    return proposed < 0 ? all.length - 1 : proposed;
-  })();
-  return (_all$nextIndex = all[nextIndex]) !== null && _all$nextIndex !== void 0 ? _all$nextIndex : null;
-}

package/dist/es2019/focus/index.js

@@ -1 +0,0 @@
-export { getFirstFocusable, getLastFocusable, getNextFocusable } from './focus';

package/dist/esm/focus/focus.js

@@ -1,160 +0,0 @@
-/**
- * Focusable element selectors and navigation helpers.
- *
- * Uses CSS selectors to discover focusable elements within a container,
- * avoiding the need for a manual registration system. Disabled elements
- * (both HTML `disabled` attribute and `aria-disabled="true"`) and elements
- * with `tabindex="-1"` are excluded automatically.
- *
- * All public functions accept an optional `filter` callback to further
- * restrict which focusable elements are included.
- */
-
-import { getDocument } from '@atlaskit/browser-apis';
-var selectors = function () {
-  // Common exclusion filter applied to every selector.
-  var not = ':not([tabindex="-1"]):not([aria-disabled="true"]):not([aria-hidden="true"])';
-  var notDisabled = ":not([disabled])".concat(not);
-  var focusable = ["a[href]".concat(not), "area[href]".concat(not), "input".concat(notDisabled, ":not([type=\"hidden\"])"), "select".concat(notDisabled), "textarea".concat(notDisabled), "button".concat(notDisabled), "iframe".concat(not), "audio[controls]".concat(not), "video[controls]".concat(not), "[contenteditable]:not([contenteditable=\"false\"])".concat(not), "[tabindex]".concat(notDisabled).concat(not)];
-  return {
-    focusable: focusable.join(','),
-    // Build the `:focus` selector
-    focused: focusable.map(function (selector) {
-      return "".concat(selector, ":focus");
-    }).join(',')
-  };
-}();
-var topLayerSelector = '[popover], dialog, [role="dialog"], [role="alertdialog"]';
-
-/**
- * Returns true when `element` and `container` resolve to the same nearest
- * top-layer host (or both resolve to `null`, meaning the document layer).
- */
-function isInSameLayer(_ref) {
-  var element = _ref.element,
-    container = _ref.container;
-  var elementLayer = element.closest(topLayerSelector);
-  var containerLayer = container.closest(topLayerSelector);
-  // Both elements are in the "document" layer
-  if (!elementLayer && !containerLayer) {
-    return true;
-  }
-  return elementLayer === containerLayer;
-}
-
-/**
- * Returns `true` when `document.activeElement` is inside a nested top-layer
- * descendant of `container` (a `[popover]`, `<dialog>`, `[role="dialog"]` or
- * `[role="alertdialog"]` that is itself a descendant of `container`).
- */
-export function isNestedLayerFocused(_ref2) {
-  var _getDocument;
-  var container = _ref2.container;
-  var focused = (_getDocument = getDocument()) === null || _getDocument === void 0 ? void 0 : _getDocument.activeElement;
-  if (!(focused instanceof HTMLElement)) {
-    return false;
-  }
-
-  // Cannot be in a nested layer if it is not in the container
-  if (!container.contains(focused)) {
-    return false;
-  }
-
-  // If not in the same layer, must be in a nested layer
-  return !isInSameLayer({
-    element: focused,
-    container: container
-  });
-}
-
-/**
- * An optional callback to restrict which focusable elements are included.
- * Return `true` to include the element, `false` to skip it.
- */
-
-/**
- * Returns all focusable HTMLElements within the container, optionally filtered.
- *
- * Focusables that belong to a nested top-layer scope (a `[popover]` or
- * `<dialog>` descendant of the container) are excluded - those elements
- * are owned by the inner layer's focus management. The container itself
- * is allowed to be a popover/dialog; only nested ones are filtered.
- */
-function getFocusables(_ref3) {
-  var container = _ref3.container,
-    filter = _ref3.filter;
-  return Array.from(container.querySelectorAll(selectors.focusable)).filter(function (element) {
-    return element instanceof HTMLElement;
-  }).filter(function (element) {
-    return isInSameLayer({
-      element: element,
-      container: container
-    });
-  }).filter(function (element) {
-    return !filter || filter(element, container);
-  });
-}
-
-/**
- * Returns the first focusable element within the container.
- */
-// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
-export function getFirstFocusable(_ref4) {
-  var container = _ref4.container,
-    filter = _ref4.filter;
-  var items = getFocusables({
-    container: container,
-    filter: filter
-  });
-  return items.length > 0 ? items[0] : null;
-}
-
-/**
- * Returns the last focusable element within the container.
- */
-// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
-export function getLastFocusable(_ref5) {
-  var container = _ref5.container,
-    filter = _ref5.filter;
-  var items = getFocusables({
-    container: container,
-    filter: filter
-  });
-  return items.length > 0 ? items[items.length - 1] : null;
-}
-
-/**
- * Returns the next focusable element in the given direction relative to the
- * currently focused element within the container. Wraps around at both ends.
- *
- * Returns `null` if there is no focused element within the container or if
- * the focused element is not in the list of focusable elements.
- */
-// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
-export function getNextFocusable(_ref6) {
-  var _all$nextIndex;
-  var container = _ref6.container,
-    direction = _ref6.direction,
-    filter = _ref6.filter;
-  var all = getFocusables({
-    container: container,
-    filter: filter
-  });
-  var current = container.querySelector(selectors.focused);
-  if (!(current instanceof HTMLElement)) {
-    return null;
-  }
-  var index = all.indexOf(current);
-  if (index === -1) {
-    return null;
-  }
-  var nextIndex = function () {
-    if (direction === 'forwards') {
-      return (index + 1) % all.length;
-    }
-    var proposed = index - 1;
-    // if going into negative numbers, loop back to the last item
-    return proposed < 0 ? all.length - 1 : proposed;
-  }();
-  return (_all$nextIndex = all[nextIndex]) !== null && _all$nextIndex !== void 0 ? _all$nextIndex : null;
-}

package/dist/esm/focus/index.js

@@ -1 +0,0 @@
-export { getFirstFocusable, getLastFocusable, getNextFocusable } from './focus';

package/dist/types/focus/focus.d.ts

@@ -1,50 +0,0 @@
-/**
- * Focusable element selectors and navigation helpers.
- *
- * Uses CSS selectors to discover focusable elements within a container,
- * avoiding the need for a manual registration system. Disabled elements
- * (both HTML `disabled` attribute and `aria-disabled="true"`) and elements
- * with `tabindex="-1"` are excluded automatically.
- *
- * All public functions accept an optional `filter` callback to further
- * restrict which focusable elements are included.
- */
-/**
- * Returns `true` when `document.activeElement` is inside a nested top-layer
- * descendant of `container` (a `[popover]`, `<dialog>`, `[role="dialog"]` or
- * `[role="alertdialog"]` that is itself a descendant of `container`).
- */
-export declare function isNestedLayerFocused({ container }: {
-    container: HTMLElement;
-}): boolean;
-/**
- * An optional callback to restrict which focusable elements are included.
- * Return `true` to include the element, `false` to skip it.
- */
-export type TFocusableFilter = (element: HTMLElement, container: HTMLElement) => boolean;
-/**
- * Returns the first focusable element within the container.
- */
-export declare function getFirstFocusable({ container, filter, }: {
-    container: HTMLElement;
-    filter?: TFocusableFilter;
-}): HTMLElement | null;
-/**
- * Returns the last focusable element within the container.
- */
-export declare function getLastFocusable({ container, filter, }: {
-    container: HTMLElement;
-    filter?: TFocusableFilter;
-}): HTMLElement | null;
-/**
- * Returns the next focusable element in the given direction relative to the
- * currently focused element within the container. Wraps around at both ends.
- *
- * Returns `null` if there is no focused element within the container or if
- * the focused element is not in the list of focusable elements.
- */
-export declare function getNextFocusable({ container, direction, filter, }: {
-    container: HTMLElement;
-    direction: 'forwards' | 'backwards';
-    filter?: TFocusableFilter;
-}): HTMLElement | null;

package/dist/types/focus/index.d.ts

@@ -1,2 +0,0 @@
-export { getFirstFocusable, getLastFocusable, getNextFocusable } from './focus';
-export type { TFocusableFilter } from './focus';

package/dist/types-ts4.5/focus/focus.d.ts

@@ -1,50 +0,0 @@
-/**
- * Focusable element selectors and navigation helpers.
- *
- * Uses CSS selectors to discover focusable elements within a container,
- * avoiding the need for a manual registration system. Disabled elements
- * (both HTML `disabled` attribute and `aria-disabled="true"`) and elements
- * with `tabindex="-1"` are excluded automatically.
- *
- * All public functions accept an optional `filter` callback to further
- * restrict which focusable elements are included.
- */
-/**
- * Returns `true` when `document.activeElement` is inside a nested top-layer
- * descendant of `container` (a `[popover]`, `<dialog>`, `[role="dialog"]` or
- * `[role="alertdialog"]` that is itself a descendant of `container`).
- */
-export declare function isNestedLayerFocused({ container }: {
-    container: HTMLElement;
-}): boolean;
-/**
- * An optional callback to restrict which focusable elements are included.
- * Return `true` to include the element, `false` to skip it.
- */
-export type TFocusableFilter = (element: HTMLElement, container: HTMLElement) => boolean;
-/**
- * Returns the first focusable element within the container.
- */
-export declare function getFirstFocusable({ container, filter, }: {
-    container: HTMLElement;
-    filter?: TFocusableFilter;
-}): HTMLElement | null;
-/**
- * Returns the last focusable element within the container.
- */
-export declare function getLastFocusable({ container, filter, }: {
-    container: HTMLElement;
-    filter?: TFocusableFilter;
-}): HTMLElement | null;
-/**
- * Returns the next focusable element in the given direction relative to the
- * currently focused element within the container. Wraps around at both ends.
- *
- * Returns `null` if there is no focused element within the container or if
- * the focused element is not in the list of focusable elements.
- */
-export declare function getNextFocusable({ container, direction, filter, }: {
-    container: HTMLElement;
-    direction: 'forwards' | 'backwards';
-    filter?: TFocusableFilter;
-}): HTMLElement | null;

package/dist/types-ts4.5/focus/index.d.ts

@@ -1,2 +0,0 @@
-export { getFirstFocusable, getLastFocusable, getNextFocusable } from './focus';
-export type { TFocusableFilter } from './focus';