@nextlyhq/ui 0.0.2-alpha.52 → 0.0.2-alpha.56

package/dist/index.mjs

@@ -22,11 +22,15 @@ var buttonVariants = cva(
       variant: {
         default: "bg-primary text-primary-foreground border border-transparent hover:opacity-90",
         primary: "bg-primary text-primary-foreground border border-transparent hover:opacity-90",
-        // Solid fill uses the emphasis token so white on-color text stays AA in
-        // dark mode (the base token is the readable text color, too light here).
-        // Hover darkens to a deeper shade instead of opacity-90, which would
-        // composite the fill toward the page and drop white text under 4.5:1.
-        destructive: "bg-destructive-solid text-destructive-foreground border border-transparent hover:bg-destructive-700",
+        // Solid fill uses the emphasis token so on-color text stays AA in dark
+        // mode (the base token is the readable text color, too light here).
+        // Hover darkens to a deeper shade rather than opacity-90, which would
+        // composite the fill toward the page and drop the label under 4.5:1.
+        // One step, not two: the label is white in light mode and black in
+        // dark, so mixing the fill toward black moves it away from the label in
+        // one mode and into it in the other. `-600` clears both (5.92:1 light,
+        // 5.67:1 dark); `-700` reads at 3.70:1 against the dark label.
+        destructive: "bg-destructive-solid text-destructive-foreground border border-transparent hover:bg-destructive-600",
         // border-border is the decorative separator token, and it is the right
         // one here: a button is identified by its label and fill, so its edge
         // carries no meaning on its own and is not held to the 3:1 minimum that
@@ -2317,6 +2321,1155 @@ var ResizableHandle = ({
     ]
   }
 );
+
+// src/components/tree-view.tsx
+import { useVirtualizer } from "@tanstack/react-virtual";
+import { ChevronRight as ChevronRight3 } from "lucide-react";
+import * as React10 from "react";
+import { jsx as jsx36, jsxs as jsxs15 } from "react/jsx-runtime";
+var ROW_HEIGHT = 28;
+var INDENT_PER_LEVEL = 12;
+function textOf(node) {
+  if (typeof node.textValue === "string") return node.textValue;
+  return typeof node.label === "string" ? node.label : "";
+}
+function flatten(nodes, expanded) {
+  const rows = [];
+  const pending = [{ list: nodes, index: 0, level: 0 }];
+  while (pending.length > 0) {
+    const frame = pending[pending.length - 1];
+    if (frame === void 0 || frame.index >= frame.list.length) {
+      pending.pop();
+      continue;
+    }
+    const node = frame.list[frame.index];
+    const posInSet = frame.index;
+    frame.index += 1;
+    if (node === void 0) continue;
+    const hasChildren = node.children !== void 0;
+    rows.push({
+      node,
+      level: frame.level,
+      setSize: frame.list.length,
+      posInSet,
+      parentId: frame.parentId,
+      hasChildren
+    });
+    if (hasChildren && expanded.has(node.id)) {
+      pending.push({
+        list: node.children ?? [],
+        index: 0,
+        level: frame.level + 1,
+        parentId: node.id
+      });
+    }
+  }
+  return rows;
+}
+function useControllable(controlled, fallback) {
+  const [uncontrolled, setUncontrolled] = React10.useState(fallback);
+  return [
+    controlled === void 0 ? uncontrolled : controlled,
+    setUncontrolled
+  ];
+}
+var TreeView = React10.forwardRef(
+  ({
+    nodes,
+    expandedIds,
+    defaultExpandedIds,
+    onExpandedChange,
+    selectedId,
+    defaultSelectedId,
+    onSelectedChange,
+    className,
+    "aria-label": ariaLabel,
+    "aria-labelledby": ariaLabelledBy,
+    "aria-describedby": ariaDescribedBy,
+    ...props
+  }, forwardedRef) => {
+    const scrollRef = React10.useRef(null);
+    const attachScroll = React10.useCallback(
+      (node) => {
+        scrollRef.current = node;
+        if (typeof forwardedRef === "function") forwardedRef(node);
+        else if (forwardedRef !== null && forwardedRef !== void 0) {
+          forwardedRef.current = node;
+        }
+      },
+      [forwardedRef]
+    );
+    const [expandedState, setExpandedState] = useControllable(
+      expandedIds === void 0 ? void 0 : [...expandedIds],
+      [...defaultExpandedIds ?? []]
+    );
+    const expanded = React10.useMemo(
+      () => new Set(expandedIds ?? expandedState),
+      [expandedIds, expandedState]
+    );
+    const [selected, setSelected] = useControllable(
+      selectedId === void 0 ? void 0 : selectedId,
+      defaultSelectedId ?? null
+    );
+    const rows = React10.useMemo(
+      () => flatten(nodes, expanded),
+      [nodes, expanded]
+    );
+    const [activeId, setActiveId] = React10.useState(null);
+    const activeIndex = Math.max(
+      0,
+      rows.findIndex((row) => row.node.id === (activeId ?? selected))
+    );
+    const virtualizer = useVirtualizer({
+      count: rows.length,
+      getScrollElement: () => scrollRef.current,
+      estimateSize: () => ROW_HEIGHT,
+      overscan: 8
+    });
+    const commitExpanded = (next) => {
+      const ids = [...next];
+      if (expandedIds === void 0) setExpandedState(ids);
+      onExpandedChange?.(ids);
+    };
+    const setExpansion = (id, open) => {
+      const next = new Set(expanded);
+      if (open) next.add(id);
+      else next.delete(id);
+      commitExpanded(next);
+    };
+    const choose = (id) => {
+      if (selectedId === void 0) setSelected(id);
+      onSelectedChange?.(id);
+    };
+    const focusRow = (index) => {
+      const row = rows[index];
+      if (row === void 0) return;
+      setActiveId(row.node.id);
+      virtualizer.scrollToIndex(index, { align: "auto" });
+      requestAnimationFrame(() => {
+        const element = scrollRef.current?.querySelector(
+          `[data-tree-index="${index}"]`
+        );
+        element?.focus();
+      });
+    };
+    const step = (from, delta) => {
+      for (let index = from + delta; index >= 0 && index < rows.length; index += delta) {
+        if (rows[index]?.node.disabled !== true) return index;
+      }
+      return from;
+    };
+    const typeahead = React10.useRef({ query: "", at: 0 });
+    const onKeyDown = (event) => {
+      const index = activeIndex;
+      const row = rows[index];
+      if (row === void 0) return;
+      switch (event.key) {
+        case "ArrowDown":
+          event.preventDefault();
+          focusRow(step(index, 1));
+          return;
+        case "ArrowUp":
+          event.preventDefault();
+          focusRow(step(index, -1));
+          return;
+        case "ArrowRight":
+          event.preventDefault();
+          if (row.hasChildren && !expanded.has(row.node.id)) {
+            setExpansion(row.node.id, true);
+          } else if (row.hasChildren) {
+            for (let child = index + 1; child < rows.length && (rows[child]?.level ?? 0) > row.level; child += 1) {
+              if (rows[child]?.parentId === row.node.id && rows[child]?.node.disabled !== true) {
+                focusRow(child);
+                break;
+              }
+            }
+          }
+          return;
+        case "ArrowLeft":
+          event.preventDefault();
+          if (row.hasChildren && expanded.has(row.node.id)) {
+            setExpansion(row.node.id, false);
+          } else if (row.parentId !== void 0) {
+            let ancestor = row.parentId;
+            while (ancestor !== void 0) {
+              const at = rows.findIndex(
+                (candidate) => candidate.node.id === ancestor
+              );
+              if (at < 0) break;
+              if (rows[at]?.node.disabled !== true) {
+                focusRow(at);
+                break;
+              }
+              ancestor = rows[at]?.parentId;
+            }
+          }
+          return;
+        case "Home":
+          event.preventDefault();
+          focusRow(rows[0]?.node.disabled === true ? step(0, 1) : 0);
+          return;
+        case "End": {
+          event.preventDefault();
+          const last = rows.length - 1;
+          focusRow(rows[last]?.node.disabled === true ? step(last, -1) : last);
+          return;
+        }
+        case "Enter":
+        case " ":
+          event.preventDefault();
+          if (row.node.disabled !== true) choose(row.node.id);
+          return;
+        case "*": {
+          event.preventDefault();
+          const next = new Set(expanded);
+          for (const sibling of rows) {
+            if (sibling.parentId === row.parentId && sibling.hasChildren) {
+              next.add(sibling.node.id);
+            }
+          }
+          commitExpanded(next);
+          return;
+        }
+        default:
+          break;
+      }
+      if (event.key.length !== 1 || event.metaKey || event.ctrlKey || event.altKey) {
+        return;
+      }
+      event.preventDefault();
+      const now = Date.now();
+      const state = typeahead.current;
+      state.query = now - state.at > 500 ? event.key : state.query + event.key;
+      state.at = now;
+      const query = state.query.toLowerCase();
+      for (let offset = 1; offset <= rows.length; offset += 1) {
+        const candidate = rows[(index + offset) % rows.length];
+        if (candidate === void 0 || candidate.node.disabled === true)
+          continue;
+        if (textOf(candidate.node).toLowerCase().startsWith(query)) {
+          focusRow(rows.indexOf(candidate));
+          return;
+        }
+      }
+    };
+    const virtualItems = virtualizer.getVirtualItems();
+    const usable = (index) => rows[index]?.node.disabled !== true;
+    const tabStopIndex = virtualItems.some((item) => item.index === activeIndex) && usable(activeIndex) ? activeIndex : virtualItems.find((item) => usable(item.index))?.index ?? -1;
+    return /* @__PURE__ */ jsx36(
+      "div",
+      {
+        ref: attachScroll,
+        className: cn("overflow-auto", className),
+        ...props,
+        children: /* @__PURE__ */ jsx36(
+          "div",
+          {
+            role: "tree",
+            "aria-label": ariaLabel,
+            "aria-labelledby": ariaLabelledBy,
+            "aria-describedby": ariaDescribedBy,
+            onKeyDown,
+            style: { height: virtualizer.getTotalSize(), position: "relative" },
+            children: virtualItems.map((item) => {
+              const row = rows[item.index];
+              if (row === void 0) return null;
+              const isSelected = selected === row.node.id;
+              return /* @__PURE__ */ jsxs15(
+                "div",
+                {
+                  "data-tree-index": item.index,
+                  role: "treeitem",
+                  "aria-level": row.level + 1,
+                  "aria-setsize": row.setSize,
+                  "aria-posinset": row.posInSet + 1,
+                  "aria-selected": isSelected,
+                  "aria-expanded": row.hasChildren ? expanded.has(row.node.id) : void 0,
+                  "aria-disabled": row.node.disabled === true ? true : void 0,
+                  tabIndex: item.index === tabStopIndex ? 0 : -1,
+                  onFocus: () => setActiveId(row.node.id),
+                  onClick: () => {
+                    if (row.node.disabled === true) return;
+                    setActiveId(row.node.id);
+                    choose(row.node.id);
+                  },
+                  className: cn(
+                    "absolute left-0 flex w-full select-none items-center gap-1 rounded-sm pr-2 text-sm outline-none",
+                    "focus-visible:ring-1 focus-visible:ring-ring",
+                    row.node.disabled === true ? "pointer-events-none opacity-50" : "cursor-pointer",
+                    isSelected ? "bg-muted text-foreground" : "hover:bg-muted/50"
+                  ),
+                  style: {
+                    height: item.size,
+                    transform: `translateY(${item.start}px)`,
+                    paddingLeft: 4 + row.level * INDENT_PER_LEVEL
+                  },
+                  children: [
+                    /* @__PURE__ */ jsx36(
+                      "span",
+                      {
+                        "aria-hidden": "true",
+                        className: "flex size-4 shrink-0 items-center justify-center",
+                        onClick: (event) => {
+                          if (!row.hasChildren) return;
+                          event.stopPropagation();
+                          setExpansion(row.node.id, !expanded.has(row.node.id));
+                        },
+                        children: row.hasChildren ? /* @__PURE__ */ jsx36(
+                          ChevronRight3,
+                          {
+                            className: cn(
+                              "size-3.5 text-muted-foreground transition-transform",
+                              expanded.has(row.node.id) && "rotate-90"
+                            )
+                          }
+                        ) : null
+                      }
+                    ),
+                    row.node.icon !== void 0 ? /* @__PURE__ */ jsx36("span", { className: "flex size-4 shrink-0 items-center justify-center text-muted-foreground", children: row.node.icon }) : null,
+                    /* @__PURE__ */ jsx36("span", { className: "truncate", children: row.node.label })
+                  ]
+                },
+                row.node.id
+              );
+            })
+          }
+        )
+      }
+    );
+  }
+);
+TreeView.displayName = "TreeView";
+
+// src/components/slider.tsx
+import * as SliderPrimitive from "@radix-ui/react-slider";
+import * as React11 from "react";
+
+// src/lib/dev-warn.ts
+var emitted = /* @__PURE__ */ new Set();
+var SPEAKING_ENVIRONMENTS = /* @__PURE__ */ new Set(["development", "test"]);
+function isDevelopmentRuntime() {
+  if (typeof process === "undefined") return false;
+  const env = process?.env?.NODE_ENV;
+  return env !== void 0 && SPEAKING_ENVIRONMENTS.has(env);
+}
+function devWarnOnce(condition, message) {
+  if (condition) return;
+  if (!isDevelopmentRuntime()) return;
+  if (emitted.has(message)) return;
+  emitted.add(message);
+  console.warn(`[@nextlyhq/ui] ${message}`);
+}
+
+// src/components/slider.tsx
+import { jsx as jsx37, jsxs as jsxs16 } from "react/jsx-runtime";
+function thumbCount(value, defaultValue) {
+  return Math.max(1, value?.length ?? defaultValue?.length ?? 1);
+}
+function hasAccessibleName(value) {
+  return value !== void 0 && value.trim() !== "";
+}
+var Slider = React11.forwardRef(
+  ({
+    className,
+    value,
+    defaultValue,
+    thumbs,
+    orientation = "horizontal",
+    "aria-label": ariaLabel,
+    "aria-labelledby": ariaLabelledBy,
+    ...props
+  }, ref) => {
+    const initialUncontrolledCount = React11.useRef(
+      thumbCount(void 0, defaultValue)
+    ).current;
+    const count = value?.length ?? initialUncontrolledCount;
+    const isEmptyDefault = defaultValue !== void 0 && defaultValue.length === 0;
+    const isEmptyControlled = value !== void 0 && value.length === 0;
+    devWarnOnce(
+      !isEmptyDefault && !isEmptyControlled,
+      "Slider: `value`/`defaultValue` must hold one number per thumb, and an empty array holds none \u2014 the control has nothing to slide. An empty `defaultValue` falls back to `min`; an empty `value` renders nothing at all, because a controlled slider cannot be given a value without taking state the caller owns. Render nothing until the value is loaded rather than passing `[]`."
+    );
+    if (isEmptyControlled) return null;
+    const isNamed = (index) => {
+      const own = thumbs?.[index];
+      if (hasAccessibleName(own?.["aria-label"])) return true;
+      if (hasAccessibleName(own?.["aria-labelledby"])) return true;
+      return count === 1 && (hasAccessibleName(ariaLabel) || hasAccessibleName(ariaLabelledBy));
+    };
+    devWarnOnce(
+      Array.from({ length: count }).every((_, i) => isNamed(i)),
+      "Slider: every thumb needs an accessible name. A single thumb may take it from the root's `aria-label`/`aria-labelledby`; a range needs one `thumbs` entry per thumb, because the root's name is not inherited and two thumbs sharing one name are announced identically."
+    );
+    const ariaFor = (index) => {
+      const supplied = thumbs?.[index] ?? {};
+      const ownLabel = hasAccessibleName(supplied["aria-label"]) ? supplied["aria-label"] : void 0;
+      const ownLabelledBy = hasAccessibleName(supplied["aria-labelledby"]) ? supplied["aria-labelledby"] : void 0;
+      if (count !== 1) {
+        return {
+          ...supplied,
+          "aria-label": ownLabel,
+          "aria-labelledby": ownLabelledBy
+        };
+      }
+      const namesItself = ownLabel !== void 0 || ownLabelledBy !== void 0;
+      return {
+        "aria-label": namesItself ? ownLabel : ariaLabel,
+        "aria-labelledby": namesItself ? ownLabelledBy : ariaLabelledBy,
+        "aria-valuetext": supplied["aria-valuetext"],
+        "aria-describedby": supplied["aria-describedby"]
+      };
+    };
+    const isVertical = orientation === "vertical";
+    return (
+      // `aria-label`/`aria-labelledby` are destructured out above rather than
+      // spread here: left on the root they would be a second, roleless copy
+      // of a name only the thumb is read for.
+      /* @__PURE__ */ jsxs16(
+        SliderPrimitive.Root,
+        {
+          ref,
+          className: cn(
+            "relative flex touch-none select-none items-center",
+            // WCAG 2.5.8 wants a 24px target. Padding alone does not reach it: the
+            // thumb is absolutely positioned, so the cross-axis size is the 6px
+            // track plus the padding — 22px with `py-2`. An explicit minimum
+            // states the target rather than leaving it to arithmetic that moves
+            // whenever the track thickness does.
+            isVertical ? (
+              // A vertical slider needs a LENGTH, and it cannot inherit one:
+              // `h-full` inside an auto-height parent resolves to zero, leaving
+              // a control with no track to drag along. A concrete default is
+              // usable everywhere and, being a plain utility, is replaced by a
+              // caller's own `h-*` — including `h-full`, for the fill-the-parent
+              // case this default gives up.
+              "h-44 min-w-6 flex-col px-2"
+            ) : "min-h-6 w-full py-2",
+            "data-[disabled]:pointer-events-none data-[disabled]:opacity-50",
+            className
+          ),
+          orientation,
+          value,
+          defaultValue: isEmptyDefault ? void 0 : defaultValue,
+          ...props,
+          children: [
+            /* @__PURE__ */ jsx37(
+              SliderPrimitive.Track,
+              {
+                className: cn(
+                  "bg-secondary relative grow overflow-hidden rounded-full",
+                  isVertical ? "h-full w-1.5" : "h-1.5 w-full"
+                ),
+                children: /* @__PURE__ */ jsx37(
+                  SliderPrimitive.Range,
+                  {
+                    className: cn(
+                      "bg-primary absolute",
+                      isVertical ? "w-full" : "h-full"
+                    )
+                  }
+                )
+              }
+            ),
+            Array.from({ length: count }, (_, i) => /* @__PURE__ */ jsx37(
+              SliderPrimitive.Thumb,
+              {
+                ...ariaFor(i),
+                className: cn(
+                  "border-primary bg-background block h-4 w-4 rounded-full border-2",
+                  "ring-offset-background transition-colors",
+                  "focus-visible:ring-ring focus-visible:outline-none focus-visible:ring-2",
+                  "focus-visible:ring-offset-2",
+                  "disabled:pointer-events-none disabled:opacity-50"
+                )
+              },
+              i
+            ))
+          ]
+        }
+      )
+    );
+  }
+);
+Slider.displayName = SliderPrimitive.Root.displayName;
+
+// src/lib/shortcuts/react.tsx
+import * as React12 from "react";
+
+// src/lib/shortcuts/key-spec.ts
+function normalizeKey(key) {
+  return [...key].length === 1 ? key.toLowerCase() : key;
+}
+function shiftIsMeaningful(key) {
+  if (key.length > 1) return true;
+  if (key === " ") return true;
+  return /[\p{L}\p{N}]/u.test(key);
+}
+function parseKeys(spec) {
+  const steps = spec.trim().split(/\s+/).filter(Boolean);
+  if (steps.length === 0) {
+    throw new Error(`Shortcut spec is empty: ${JSON.stringify(spec)}`);
+  }
+  return steps.map((step) => parseChord(step, spec));
+}
+function parseChord(step, spec) {
+  const trailingPlusIsKey = step.length > 2 && step.endsWith("++");
+  const body = trailingPlusIsKey ? step.slice(0, -1) : step;
+  const parts = step === "+" ? ["+"] : body.split("+").filter(Boolean);
+  let mod = false;
+  let ctrl = false;
+  let meta = false;
+  let alt = false;
+  let shift = false;
+  let key;
+  for (const raw of parts) {
+    switch (raw.toLowerCase()) {
+      case "mod":
+        mod = true;
+        break;
+      case "ctrl":
+      case "control":
+        ctrl = true;
+        break;
+      case "meta":
+      case "cmd":
+      case "command":
+        meta = true;
+        break;
+      case "alt":
+      case "option":
+        alt = true;
+        break;
+      case "shift":
+        shift = true;
+        break;
+      case "space":
+        key = " ";
+        break;
+      default:
+        if (key !== void 0) {
+          throw new Error(
+            `Shortcut step "${step}" names two keys ("${key}" and "${raw}") in ${JSON.stringify(spec)}`
+          );
+        }
+        key = raw;
+    }
+  }
+  if (trailingPlusIsKey) {
+    if (key !== void 0) {
+      throw new Error(
+        `Shortcut step has more than one key: ${JSON.stringify(step)} in ${JSON.stringify(spec)}`
+      );
+    }
+    key = "+";
+  }
+  if (key === void 0) {
+    throw new Error(
+      `Shortcut step "${step}" names modifiers but no key, in ${JSON.stringify(spec)}`
+    );
+  }
+  return { key: normalizeKey(key), mod, ctrl, meta, alt, shift };
+}
+function chordMatches(chord, key, state, isApple) {
+  if (normalizeKey(key) !== chord.key) return false;
+  const wantsCtrl = chord.ctrl || chord.mod && !isApple;
+  const wantsMeta = chord.meta || chord.mod && isApple;
+  if (state.metaKey !== wantsMeta) return false;
+  const altGraph = state.getModifierState?.("AltGraph") ?? false;
+  const synthetic = altGraph && [...chord.key].length === 1 && !wantsCtrl && !chord.alt;
+  if (!synthetic) {
+    if (state.ctrlKey !== wantsCtrl) return false;
+    if (state.altKey !== chord.alt) return false;
+  }
+  if (shiftIsMeaningful(chord.key) && state.shiftKey !== chord.shift)
+    return false;
+  return true;
+}
+function detectApplePlatform() {
+  if (typeof navigator === "undefined") return false;
+  const candidate = navigator;
+  const platform = candidate.userAgentData?.platform ?? navigator.platform ?? "";
+  return /mac|iphone|ipad|ipod/i.test(platform);
+}
+
+// src/lib/shortcuts/manager.ts
+var DEFAULT_SEQUENCE_TIMEOUT_MS = 1e3;
+function signature(event) {
+  return event.code || event.key;
+}
+function eventTarget(event) {
+  const path = event.composedPath?.();
+  return path && path.length > 0 ? path[0] ?? null : event.target;
+}
+function asElement(target) {
+  if (target === null || typeof target !== "object") return null;
+  const node = target;
+  if (node.nodeType !== 1 || typeof node.tagName !== "string") return null;
+  return target;
+}
+function inputType(element) {
+  if (element.tagName !== "INPUT") return "";
+  const value = element.type;
+  return typeof value === "string" ? value.toLowerCase() : "";
+}
+function controlOwnsKey(target, event) {
+  if (event.ctrlKey || event.metaKey || event.altKey) return false;
+  const element = asElement(target);
+  if (!element) return false;
+  const tag = element.tagName;
+  const type = inputType(element);
+  if (tag === "BUTTON" || type === "button" || type === "submit" || type === "reset" || type === "image") {
+    return event.key === " " || event.key === "Enter";
+  }
+  if (tag === "A" && element.getAttribute("href") !== null) {
+    return event.key === "Enter";
+  }
+  if (tag === "SUMMARY") return event.key === " " || event.key === "Enter";
+  if (type === "checkbox") return event.key === " ";
+  if (type === "color") return event.key === " " || event.key === "Enter";
+  if (type === "file") return event.key === " " || event.key === "Enter";
+  if (type === "range") {
+    return event.key.startsWith("Arrow") || RANGE_KEYS.has(event.key);
+  }
+  if (type === "radio") {
+    return event.key === " " || event.key.startsWith("Arrow");
+  }
+  return false;
+}
+function isTypingTarget(target) {
+  const element = asElement(target);
+  if (!element) return false;
+  if (element.isContentEditable) return true;
+  const tag = element.tagName;
+  if (tag === "TEXTAREA") return true;
+  if (tag === "SELECT") return true;
+  if (tag === "INPUT") {
+    return !NON_TEXT_INPUT_TYPES.has(inputType(element));
+  }
+  const role = element.getAttribute("role");
+  return role !== null && TYPE_AHEAD_ROLES.has(role);
+}
+var NON_TEXT_INPUT_TYPES = /* @__PURE__ */ new Set([
+  "button",
+  "checkbox",
+  "color",
+  "file",
+  "hidden",
+  "image",
+  "radio",
+  "range",
+  "reset",
+  "submit"
+]);
+function firesWhileTyping(prepared) {
+  const explicit = prepared.binding.whenTyping;
+  if (explicit !== void 0) return explicit;
+  const first = prepared.keys[0];
+  if (first === void 0) return false;
+  return first.mod || first.ctrl || first.meta || first.alt || first.key === "Escape";
+}
+function createShortcutManager(options = {}) {
+  const isApple = options.isApple ?? detectApplePlatform();
+  const sequenceTimeoutMs = options.sequenceTimeoutMs ?? DEFAULT_SEQUENCE_TIMEOUT_MS;
+  const now = options.now ?? (() => Date.now());
+  const layers = /* @__PURE__ */ new Set();
+  let nextSequence = 0;
+  let pendingAt = null;
+  let pendingLayer = null;
+  const consumedPresses = /* @__PURE__ */ new Map();
+  let pendingKey = null;
+  function layerShape(bindings, options2) {
+    const keys = bindings.map((b) => b.binding.keys).join("\0");
+    return `${keys}
${options2.depth}
${options2.blocking === true}
${options2.enabled !== false}`;
+  }
+  function blocking() {
+    return ordered().some((layer) => layer.options.blocking === true);
+  }
+  function abandonSequence() {
+    pendingAt = null;
+    pressedEvents.length = 0;
+    pendingLayer = null;
+    pendingKey = null;
+  }
+  function prepare(bindings) {
+    return bindings.map((binding) => ({
+      binding,
+      keys: parseKeys(binding.keys)
+    }));
+  }
+  function ordered() {
+    return [...layers].filter((layer) => layer.options.enabled !== false).sort(
+      (a, b) => b.options.depth - a.options.depth || b.sequence - a.sequence
+    );
+  }
+  function matchDepth(prepared, pressed) {
+    if (pressed.length > prepared.keys.length) return "none";
+    for (let i = 0; i < pressed.length; i++) {
+      const chord = prepared.keys[i];
+      const event = pressed[i];
+      if (chord === void 0 || event === void 0) return "none";
+      if (!chordMatches(chord, event.key, event, isApple)) return "none";
+    }
+    return pressed.length === prepared.keys.length ? "exact" : "prefix";
+  }
+  function fire(prepared, event, invoke) {
+    if (prepared.binding.preventDefault !== false) event.preventDefault();
+    if (invoke) prepared.binding.run(event);
+  }
+  function insertsText(event, typing) {
+    if (event.key === "Tab")
+      return !event.ctrlKey && !event.metaKey && !event.altKey;
+    if (!typing) return false;
+    const altGraph = event.getModifierState?.("AltGraph") ?? false;
+    if (!altGraph && (event.ctrlKey || event.metaKey)) {
+      const letter = event.key.length === 1 ? event.key.toLowerCase() : event.key;
+      if (letter === "z" && event.shiftKey) return !event.altKey;
+      if (letter === REDO_LETTER)
+        return !isApple && !event.shiftKey && !event.altKey;
+      if (EDITING_NAVIGATION.has(event.key)) return !event.altKey || isApple;
+      if (event.shiftKey || event.altKey) return false;
+      return EDITING_LETTERS.has(letter);
+    }
+    if (!altGraph && event.altKey) {
+      if ((event.key === "ArrowDown" || event.key === "ArrowUp") && asElement(eventTarget(event))?.tagName === "SELECT") {
+        return true;
+      }
+      if (!isApple) return false;
+      if (EDITING_NAVIGATION.has(event.key)) return true;
+    }
+    if (event.key === "Dead" || event.key === "Process") return true;
+    if ([...event.key].length === 1) return true;
+    if (AMBIGUOUS_KEYS.has(event.key)) return targetOwnsAmbiguousKey(event);
+    return FIELD_KEYS.has(event.key);
+  }
+  function offer(pressed, event, typing, invoke) {
+    for (const layer of ordered()) {
+      const mayMatch = pressed.length <= 1 || pendingLayer === null || layer === pendingLayer;
+      if (mayMatch) {
+        let prefixed = false;
+        for (const prepared of layer.bindings) {
+          if (typing && !firesWhileTyping(prepared)) continue;
+          if (prepared.binding.when && !prepared.binding.when()) continue;
+          const depth = matchDepth(prepared, pressed);
+          if (depth === "exact") {
+            fire(prepared, event, invoke);
+            return "fired";
+          }
+          if (depth === "prefix") prefixed = true;
+        }
+        if (prefixed) {
+          pendingLayer = layer;
+          event.preventDefault();
+          return "pending";
+        }
+      }
+      if (layer.options.blocking) return "blocked";
+    }
+    return "none";
+  }
+  function warnOnPrefixConflicts(prepared, layerName) {
+    const resolved = (chord) => {
+      const ctrl = chord.ctrl || chord.mod && !isApple;
+      const meta = chord.meta || chord.mod && isApple;
+      const shift = shiftIsMeaningful(chord.key) ? chord.shift : false;
+      return `${chord.key}\0${ctrl}${meta}${chord.alt}${shift}`;
+    };
+    const sameChord = (a, b) => resolved(a) === resolved(b);
+    for (const short of prepared) {
+      for (const long of prepared) {
+        if (short === long || short.keys.length >= long.keys.length) continue;
+        if (short.binding.when !== void 0) continue;
+        if (!firesWhileTyping(short) && firesWhileTyping(long)) continue;
+        if (short.keys.every((chord, i) => sameChord(chord, long.keys[i]))) {
+          devWarnOnce(
+            false,
+            `shortcuts: in layer "${layerName}", "${short.binding.keys}" is a prefix of "${long.binding.keys}", so the longer one can never fire. Bind one or the other.`
+          );
+        }
+      }
+    }
+  }
+  const watchers = /* @__PURE__ */ new Set();
+  let snapshot = null;
+  function computeSnapshot() {
+    return ordered().flatMap(
+      (layer) => layer.bindings.map((prepared) => ({
+        keys: prepared.binding.keys,
+        description: prepared.binding.description,
+        layer: layer.options.name
+      }))
+    );
+  }
+  function sameShortcuts(a, b) {
+    return a.length === b.length && a.every(
+      (entry, index) => entry.keys === b[index]?.keys && entry.description === b[index]?.description && entry.layer === b[index]?.layer
+    );
+  }
+  function changed() {
+    const previous = snapshot;
+    snapshot = null;
+    if (watchers.size === 0) return;
+    const next = computeSnapshot();
+    if (previous && sameShortcuts(previous, next)) {
+      snapshot = previous;
+      return;
+    }
+    snapshot = next;
+    for (const watcher of watchers) watcher();
+  }
+  const pressedEvents = [];
+  function runOffer(pressed, event, typing) {
+    try {
+      return offer(pressed, event, typing, true);
+    } catch (error) {
+      abandonSequence();
+      consumedPresses.delete(signature(event));
+      throw error;
+    }
+  }
+  function handle(event) {
+    if (event.defaultPrevented) {
+      abandonSequence();
+      return true;
+    }
+    if (event.isComposing) {
+      abandonSequence();
+      return true;
+    }
+    if (MODIFIER_KEYS.has(event.key)) return blocking();
+    if (controlOwnsKey(eventTarget(event), event)) {
+      abandonSequence();
+      return true;
+    }
+    const typing = isTypingTarget(eventTarget(event));
+    if (event.repeat) {
+      if (pendingKey !== signature(event)) {
+        abandonSequence();
+      }
+      const held = consumedPresses.get(signature(event));
+      if (held) {
+        if (held.prevented) {
+          event.preventDefault();
+        } else {
+          const still = offer([event], event, typing, false);
+          if (still !== "fired" && !insertsText(event, typing)) {
+            event.preventDefault();
+          }
+        }
+        return true;
+      }
+      const repeated = offer([event], event, typing, false);
+      if (repeated === "blocked" && !insertsText(event, typing)) {
+        event.preventDefault();
+      }
+      return repeated !== "none";
+    }
+    if (pendingAt !== null && now() - pendingAt > sequenceTimeoutMs) {
+      abandonSequence();
+    }
+    pressedEvents.push(event);
+    let outcome = runOffer(pressedEvents, event, typing);
+    if (pressedEvents.length > 1 && (outcome === "none" || outcome === "blocked")) {
+      abandonSequence();
+      pressedEvents.push(event);
+      outcome = runOffer(pressedEvents, event, typing);
+    }
+    if (outcome === "pending") {
+      pendingAt = now();
+      pendingKey = signature(event);
+      consumedPresses.set(signature(event), {
+        prevented: event.defaultPrevented
+      });
+      return true;
+    }
+    abandonSequence();
+    if (outcome === "blocked") {
+      if (!insertsText(event, typing)) event.preventDefault();
+    }
+    const consumed = outcome === "fired" || outcome === "blocked";
+    if (consumed) {
+      consumedPresses.set(signature(event), {
+        prevented: event.defaultPrevented
+      });
+    } else {
+      consumedPresses.delete(signature(event));
+    }
+    return consumed;
+  }
+  return {
+    register(bindings, layerOptions) {
+      const prepared = prepare(bindings);
+      const layer = {
+        options: layerOptions,
+        bindings: prepared,
+        sequence: nextSequence++,
+        shape: layerShape(prepared, layerOptions)
+      };
+      warnOnPrefixConflicts(layer.bindings, layerOptions.name);
+      layers.add(layer);
+      changed();
+      return {
+        update(nextBindings, nextOptions) {
+          layer.bindings = prepare(nextBindings);
+          layer.options = nextOptions;
+          warnOnPrefixConflicts(layer.bindings, nextOptions.name);
+          const shape = layerShape(layer.bindings, nextOptions);
+          const shapeChanged = shape !== layer.shape;
+          layer.shape = shape;
+          if (shapeChanged && pendingLayer === layer) abandonSequence();
+          changed();
+        },
+        dispose() {
+          layers.delete(layer);
+          changed();
+          if (pendingLayer === layer) abandonSequence();
+        }
+      };
+    },
+    handle,
+    attach(target) {
+      const listener = (event) => {
+        try {
+          if (handle(event)) event.stopPropagation();
+        } catch (error) {
+          event.stopPropagation();
+          throw error;
+        }
+      };
+      target.addEventListener("keydown", listener);
+      return () => {
+        target.removeEventListener("keydown", listener);
+        abandonSequence();
+        consumedPresses.clear();
+      };
+    },
+    subscribe(onChange) {
+      watchers.add(onChange);
+      return () => {
+        watchers.delete(onChange);
+      };
+    },
+    activeBindings() {
+      if (snapshot) return snapshot;
+      snapshot = computeSnapshot();
+      return snapshot;
+    }
+  };
+}
+var MODIFIER_KEYS = /* @__PURE__ */ new Set([
+  "Control",
+  "Meta",
+  "Alt",
+  "Shift",
+  // A dedicated AltGraph key reports its own keydown before the character-producing one. Without
+  // it here, pressing AltGraph mid-sequence abandons the sequence before the character that would
+  // have completed it ever arrives.
+  "AltGraph"
+]);
+var TYPE_AHEAD_ROLES = /* @__PURE__ */ new Set([
+  "textbox",
+  "combobox",
+  "listbox",
+  // The focused element inside an open listbox is the OPTION, and it is what the event reports;
+  // the listbox itself is only its ancestor.
+  "option",
+  "menu",
+  "menuitem",
+  "menuitemcheckbox",
+  "menuitemradio"
+]);
+var RANGE_KEYS = /* @__PURE__ */ new Set(["Home", "End", "PageUp", "PageDown"]);
+var EDITING_LETTERS = /* @__PURE__ */ new Set(["a", "c", "v", "x", "z"]);
+var REDO_LETTER = "y";
+var EDITING_NAVIGATION = /* @__PURE__ */ new Set([
+  "Insert",
+  "ArrowLeft",
+  "ArrowRight",
+  "ArrowUp",
+  "ArrowDown",
+  "Home",
+  "End",
+  "Backspace",
+  "Delete"
+]);
+var AMBIGUOUS_KEYS = /* @__PURE__ */ new Set(["Enter", "PageUp", "PageDown"]);
+function targetOwnsAmbiguousKey(event) {
+  const element = asElement(eventTarget(event));
+  if (element === null) return false;
+  const multiline = element.tagName === "TEXTAREA" || element.isContentEditable;
+  if (event.key === "Enter") return multiline;
+  return multiline || element.tagName === "SELECT";
+}
+var FIELD_KEYS = /* @__PURE__ */ new Set([
+  "Backspace",
+  "Delete",
+  "ArrowUp",
+  "ArrowDown",
+  "ArrowLeft",
+  "ArrowRight",
+  "Home",
+  "End",
+  // Shift+Insert pastes and carries no ctrl or meta, so it arrives here rather than at the
+  // chord branch where Ctrl+Insert is recognised.
+  "Insert",
+  // Tab moves focus, and a blocking layer must NOT take it. The documented case for blocking is
+  // a modal, whose focus trap only calls `preventDefault()` at the first and last tabbable
+  // element — ordinary moves between the controls inside it rely on the browser default.
+  // Suppressing every Tab therefore pinned focus to one control in exactly the situation
+  // blocking exists to serve. A layer that genuinely wants Tab binds it.
+  "Tab"
+]);
+
+// src/lib/shortcuts/react.tsx
+import { jsx as jsx38 } from "react/jsx-runtime";
+var ShortcutContext = React12.createContext(null);
+var ownersByTarget = /* @__PURE__ */ new WeakMap();
+var useIsomorphicLayoutEffect = typeof document === "undefined" ? React12.useEffect : React12.useLayoutEffect;
+function optionsFingerprint(options) {
+  return [
+    options.isApple ?? "auto",
+    options.sequenceTimeoutMs ?? "default",
+    options.now ? "clock" : "no-clock"
+  ].join("\0");
+}
+function ShortcutProvider({
+  children,
+  target,
+  ...managerOptions
+}) {
+  const parent = React12.useContext(ShortcutContext);
+  const resolvedTarget = target === null ? null : target ?? (typeof document === "undefined" ? null : document);
+  const nestedOnSameTarget = parent !== null && parent.target === resolvedTarget;
+  const optionsRef = React12.useRef(managerOptions);
+  const ownManagers = React12.useRef(/* @__PURE__ */ new WeakMap());
+  const ownDetached = React12.useRef(null);
+  const detached = React12.useMemo(() => {
+    if (resolvedTarget === null) {
+      ownDetached.current ??= createShortcutManager(optionsRef.current);
+      return ownDetached.current;
+    }
+    const existing = ownManagers.current.get(resolvedTarget);
+    if (existing) return existing;
+    const created = createShortcutManager(optionsRef.current);
+    ownManagers.current.set(resolvedTarget, created);
+    return created;
+  }, [resolvedTarget]);
+  let owner = resolvedTarget === null ? null : ownersByTarget.get(resolvedTarget);
+  const fingerprint = optionsFingerprint(optionsRef.current);
+  if (resolvedTarget !== null && (!owner || owner.retired)) {
+    owner = {
+      manager: detached,
+      providers: 0,
+      retired: false,
+      options: fingerprint
+    };
+    ownersByTarget.set(resolvedTarget, owner);
+  }
+  const adoptedDiffers = Boolean(owner) && owner?.options !== fingerprint || nestedOnSameTarget && parent !== null && parent.options !== fingerprint;
+  devWarnOnce(
+    !adoptedDiffers,
+    "ShortcutProvider: another provider is already listening on this target with different options, so the ones passed here are being ignored. Managers are shared per target; give the providers matching options, or a target of their own."
+  );
+  const manager = nestedOnSameTarget && parent ? parent.manager : owner ? owner.manager : detached;
+  useIsomorphicLayoutEffect(() => {
+    if (resolvedTarget === null) return;
+    let entry = ownersByTarget.get(resolvedTarget);
+    if (!entry) {
+      entry = {
+        manager,
+        providers: 0,
+        retired: false,
+        options: optionsFingerprint(optionsRef.current)
+      };
+      ownersByTarget.set(resolvedTarget, entry);
+    }
+    const owned = entry;
+    owned.providers += 1;
+    owned.retired = false;
+    if (owned.providers === 1) {
+      owned.detach = owned.manager.attach(resolvedTarget);
+    }
+    return () => {
+      owned.providers -= 1;
+      if (owned.providers === 0) {
+        owned.detach?.();
+        owned.detach = void 0;
+        owned.retired = true;
+      }
+    };
+  }, [resolvedTarget, manager]);
+  const depth = nestedOnSameTarget && parent ? parent.depth : 0;
+  const value = React12.useMemo(
+    () => ({ manager, depth, target: resolvedTarget, options: fingerprint }),
+    [manager, depth, resolvedTarget, fingerprint]
+  );
+  return /* @__PURE__ */ jsx38(ShortcutContext.Provider, { value, children });
+}
+function ShortcutScope({
+  children
+}) {
+  const parent = React12.useContext(ShortcutContext);
+  if (!parent) {
+    throw new Error("ShortcutScope must be rendered inside a ShortcutProvider");
+  }
+  const value = React12.useMemo(
+    () => ({
+      manager: parent.manager,
+      depth: parent.depth + 1,
+      target: parent.target,
+      // Inherited: a scope raises precedence, it does not build a manager, so the options in force
+      // are still the ones the provider above it used.
+      options: parent.options
+    }),
+    [parent.manager, parent.depth, parent.target, parent.options]
+  );
+  return /* @__PURE__ */ jsx38(ShortcutContext.Provider, { value, children });
+}
+function useShortcuts(bindings, options) {
+  const context = React12.useContext(ShortcutContext);
+  if (!context) {
+    throw new Error("useShortcuts must be called inside a ShortcutProvider");
+  }
+  const { manager, depth } = context;
+  const registration = React12.useRef(null);
+  const latest = React12.useRef({ bindings, options });
+  useIsomorphicLayoutEffect(() => {
+    registration.current = manager.register([], {
+      name: latest.current.options.name,
+      depth
+    });
+    return () => {
+      registration.current?.dispose();
+      registration.current = null;
+    };
+  }, [manager, depth]);
+  useIsomorphicLayoutEffect(() => {
+    latest.current = { bindings, options };
+    registration.current?.update(bindings, {
+      name: options.name,
+      depth,
+      enabled: options.enabled,
+      blocking: options.blocking
+    });
+  });
+}
+function useShortcutManager() {
+  const context = React12.useContext(ShortcutContext);
+  if (!context) {
+    throw new Error(
+      "useShortcutManager must be called inside a ShortcutProvider"
+    );
+  }
+  return context.manager;
+}
+function useActiveShortcuts() {
+  const manager = useShortcutManager();
+  return React12.useSyncExternalStore(
+    manager.subscribe,
+    manager.activeBindings,
+    manager.activeBindings
+  );
+}
 export {
   Accordion,
   AccordionContent,
@@ -2436,7 +3589,10 @@ export {
   SheetPortal,
   SheetTitle,
   SheetTrigger,
+  ShortcutProvider,
+  ShortcutScope,
   Skeleton,
+  Slider,
   Spinner,
   Stack,
   Stat,
@@ -2464,18 +3620,24 @@ export {
   TooltipContent,
   TooltipProvider,
   TooltipTrigger,
+  TreeView,
   alertVariants,
   avatarVariants,
   badgeVariants,
   buttonVariants,
   cardVariants,
+  createShortcutManager,
   dialogContentVariants,
   inputVariants,
+  parseKeys,
   progressVariants,
   selectTriggerVariants,
   sheetVariants,
   spinnerVariants,
   toast,
-  usePortalContainer
+  useActiveShortcuts,
+  usePortalContainer,
+  useShortcutManager,
+  useShortcuts
 };
 //# sourceMappingURL=index.mjs.map