@primitiv-ui/react 0.1.38 → 0.1.39

package/src/utils/deriveId.ts

@@ -1,31 +0,0 @@
-/**
- * Builds a deterministic sub-id from a stable root id (typically the
- * value returned by React's `useId()`), a fixed role suffix, and a
- * per-item value. Used to wire `aria-controls`, `aria-labelledby`, and
- * matching DOM `id` attributes between paired sub-components such as
- * Tabs.Trigger ↔ Tabs.Content and Accordion.Trigger ↔ Accordion.Content
- * without each compound component re-deriving the same template literal.
- *
- * @example Inside a Tabs.Trigger
- * ```ts
- * const triggerId = deriveId(tabsId, "trigger", value);
- * const panelId = deriveId(tabsId, "panel", value);
- * ```
- *
- * @param rootId - The shared id for the compound component, normally
- *   from `useId()`. Any string is accepted, including React 18's
- *   colon-bracketed ids (`":r1:"`).
- * @param suffix - The role of the derived id within the compound,
- *   e.g. `"trigger"`, `"panel"`, `"heading"`.
- * @param value - The per-item discriminator (the value prop on the
- *   trigger / panel pair).
- *
- * @returns The concatenation `${rootId}-${suffix}-${value}`.
- */
-export function deriveId(
-  rootId: string,
-  suffix: string,
-  value: string,
-): string {
-  return `${rootId}-${suffix}-${value}`;
-}

package/src/utils/focusable.ts

@@ -1,15 +0,0 @@
-/**
- * Elements that can receive keyboard focus and take part in the natural tab
- * order. Two consumers rely on it: moving initial focus into a surface when it
- * opens (e.g. `Popover`), and locating the boundary elements of a focus trap
- * (e.g. `Modal`). `[tabindex="-1"]` is excluded because such elements are only
- * programmatically focusable, not tabbable.
- */
-export const FOCUSABLE_SELECTOR = [
-  "a[href]",
-  "button:not([disabled])",
-  "input:not([disabled])",
-  "select:not([disabled])",
-  "textarea:not([disabled])",
-  '[tabindex]:not([tabindex="-1"])',
-].join(",");

package/src/utils/getKeyToActionMap.ts

@@ -1,95 +0,0 @@
-/**
- * The abstract roving-tabindex action that a keyboard event maps to.
- *
- * Consumers translate the action into whatever "go to" semantics suit
- * their pattern (focus only, focus + activate, focus + select, etc.).
- */
-export type RovingKeyAction = "next" | "prev" | "first" | "last" | "activate";
-
-type GetKeyToActionMapOptions = {
-  /**
-   * Which arrow-key axis is active. `"horizontal"` enables Arrow Left/Right,
-   * `"vertical"` enables Arrow Up/Down, `"both"` enables all four. RTL
-   * inversion (see {@link GetKeyToActionMapOptions.dir | `dir`}) swaps the
-   * horizontal pair for both `"horizontal"` and `"both"`; the vertical pair
-   * is never swapped, since vertical reading order does not depend on
-   * direction.
-   */
-  orientation: "horizontal" | "vertical" | "both";
-  /**
-   * Reading direction. When `"rtl"`, swaps the meaning of Arrow Left and
-   * Arrow Right — applied for both `"horizontal"` and `"both"` orientation
-   * (never the vertical pair). Defaults to `"ltr"`.
-   */
-  dir?: "ltr" | "rtl";
-  /**
-   * When `true`, Home maps to `"first"` and End to `"last"`. Use for
-   * patterns where Home/End jumping is part of the keyboard contract
-   * (Tabs, Accordion). Defaults to `false`.
-   */
-  homeEnd?: boolean;
-  /**
-   * When `true`, Enter and Space map to `"activate"`. Use for patterns
-   * where the focused item can be confirmed via the keyboard (Tabs in
-   * `"manual"` activation mode). Defaults to `false`.
-   */
-  activate?: boolean;
-};
-
-/**
- * Builds the keyboard-key → roving-tabindex-action map for a single
- * focusable item in a compound widget. Each consumer shares the same
- * RTL / orientation / Home-End / Enter-Space conventions and just needs
- * to translate the abstract action ("next", "prev", "first", "last",
- * "activate") into its own movement / activation logic.
- *
- * Returns a plain `Record<string, RovingKeyAction>` so call sites can do
- * `const action = map[event.key]; if (action === "next") ...`.
- *
- * @example Tabs trigger (horizontal, RTL, all features)
- * ```ts
- * const map = getKeyToActionMap({
- *   orientation: "horizontal",
- *   dir,
- *   homeEnd: true,
- *   activate: true,
- * });
- * const action = map[event.key];
- * ```
- *
- * @example Accordion trigger (vertical, no Enter/Space — handled separately)
- * ```ts
- * const map = getKeyToActionMap({ orientation: "vertical", homeEnd: true });
- * ```
- */
-export function getKeyToActionMap({
-  orientation,
-  dir = "ltr",
-  homeEnd = false,
-  activate = false,
-}: GetKeyToActionMapOptions): Record<string, RovingKeyAction> {
-  const map: Record<string, RovingKeyAction> = {};
-
-  if (orientation === "horizontal" || orientation === "both") {
-    const forward = dir === "rtl" ? "ArrowLeft" : "ArrowRight";
-    const backward = dir === "rtl" ? "ArrowRight" : "ArrowLeft";
-    map[forward] = "next";
-    map[backward] = "prev";
-  }
-  if (orientation === "vertical" || orientation === "both") {
-    map.ArrowDown = "next";
-    map.ArrowUp = "prev";
-  }
-
-  if (homeEnd) {
-    map.Home = "first";
-    map.End = "last";
-  }
-
-  if (activate) {
-    map.Enter = "activate";
-    map[" "] = "activate";
-  }
-
-  return map;
-}

package/src/utils/index.ts

@@ -1,4 +0,0 @@
-export { createStrictContext } from "./createStrictContext";
-export { deriveId } from "./deriveId";
-export { FOCUSABLE_SELECTOR } from "./focusable";
-export { getKeyToActionMap, type RovingKeyAction } from "./getKeyToActionMap";