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

package/dist/index.cjs

@@ -29,8 +29,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
-var index_exports = {};
-__export(index_exports, {
+var src_exports = {};
+__export(src_exports, {
   Accordion: () => Accordion,
   AccordionContent: () => AccordionContent,
   AccordionItem: () => AccordionItem,
@@ -149,7 +149,10 @@ __export(index_exports, {
   SheetPortal: () => SheetPortal,
   SheetTitle: () => SheetTitle,
   SheetTrigger: () => SheetTrigger,
+  ShortcutProvider: () => ShortcutProvider,
+  ShortcutScope: () => ShortcutScope,
   Skeleton: () => Skeleton,
+  Slider: () => Slider,
   Spinner: () => Spinner,
   Stack: () => Stack,
   Stat: () => Stat,
@@ -183,16 +186,21 @@ __export(index_exports, {
   badgeVariants: () => badgeVariants,
   buttonVariants: () => buttonVariants,
   cardVariants: () => cardVariants,
+  createShortcutManager: () => createShortcutManager,
   dialogContentVariants: () => dialogContentVariants,
   inputVariants: () => inputVariants,
+  parseKeys: () => parseKeys,
   progressVariants: () => progressVariants,
   selectTriggerVariants: () => selectTriggerVariants,
   sheetVariants: () => sheetVariants,
   spinnerVariants: () => spinnerVariants,
   toast: () => import_sonner.toast,
-  usePortalContainer: () => usePortalContainer
+  useActiveShortcuts: () => useActiveShortcuts,
+  usePortalContainer: () => usePortalContainer,
+  useShortcutManager: () => useShortcutManager,
+  useShortcuts: () => useShortcuts
 });
-module.exports = __toCommonJS(index_exports);
+module.exports = __toCommonJS(src_exports);
 
 // src/components/button.tsx
 var import_react_slot = require("@radix-ui/react-slot");
@@ -216,11 +224,15 @@ var buttonVariants = (0, import_class_variance_authority.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
@@ -2809,6 +2821,836 @@ var TreeView = React10.forwardRef(
   }
 );
 TreeView.displayName = "TreeView";
+
+// src/components/slider.tsx
+var SliderPrimitive = __toESM(require("@radix-ui/react-slider"), 1);
+var React11 = __toESM(require("react"), 1);
+
+// 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
+var import_jsx_runtime37 = (
+  // `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.
+  require("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 /* @__PURE__ */ (0, import_jsx_runtime37.jsxs)(
+      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__ */ (0, import_jsx_runtime37.jsx)(
+            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__ */ (0, import_jsx_runtime37.jsx)(
+                SliderPrimitive.Range,
+                {
+                  className: cn(
+                    "bg-primary absolute",
+                    isVertical ? "w-full" : "h-full"
+                  )
+                }
+              )
+            }
+          ),
+          Array.from({ length: count }, (_, i) => /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(
+            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
+var React12 = __toESM(require("react"), 1);
+
+// 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
+var import_jsx_runtime38 = require("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__ */ (0, import_jsx_runtime38.jsx)(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__ */ (0, import_jsx_runtime38.jsx)(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
+  );
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Accordion,
@@ -2929,7 +3771,10 @@ TreeView.displayName = "TreeView";
   SheetPortal,
   SheetTitle,
   SheetTrigger,
+  ShortcutProvider,
+  ShortcutScope,
   Skeleton,
+  Slider,
   Spinner,
   Stack,
   Stat,
@@ -2963,13 +3808,18 @@ TreeView.displayName = "TreeView";
   badgeVariants,
   buttonVariants,
   cardVariants,
+  createShortcutManager,
   dialogContentVariants,
   inputVariants,
+  parseKeys,
   progressVariants,
   selectTriggerVariants,
   sheetVariants,
   spinnerVariants,
   toast,
-  usePortalContainer
+  useActiveShortcuts,
+  usePortalContainer,
+  useShortcutManager,
+  useShortcuts
 });
 //# sourceMappingURL=index.cjs.map