react-actionkit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ActionKit contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,126 @@
+# ActionKit
+
+ActionKit is a small headless React library for centralized application actions, keyboard shortcuts, and command palette state.
+
+Register an action once, then expose it through shortcuts, search, settings, menus, or any UI you build yourself.
+
+```tsx
+import { ActionKitProvider, useRegisterAction } from "react-actionkit";
+
+function SaveAction() {
+  useRegisterAction({
+    id: "save-document",
+    title: "Save Document",
+    description: "Save the current document",
+    shortcut: "mod+s",
+    execute: saveDocument
+  });
+
+  return null;
+}
+
+export function App() {
+  return (
+    <ActionKitProvider>
+      <SaveAction />
+    </ActionKitProvider>
+  );
+}
+```
+
+ActionKit ships no styled UI. Build your own command palette with `useCommandPalette`, render actions however you like, and keep business logic registered once.
+
+## Install
+
+```sh
+npm install react-actionkit
+```
+
+React and React DOM are peer dependencies.
+
+## Core API
+
+```tsx
+import {
+  ActionKitProvider,
+  createLocalStorageAdapter,
+  useCommandPalette,
+  useRegisterAction,
+  useShortcutBindings
+} from "react-actionkit";
+```
+
+### Provider
+
+```tsx
+const shortcutStorage = createLocalStorageAdapter("my-app:shortcuts");
+
+export function Root() {
+  return (
+    <ActionKitProvider storage={shortcutStorage}>
+      <App />
+    </ActionKitProvider>
+  );
+}
+```
+
+### Custom Command Palette
+
+```tsx
+function CommandPalette() {
+  const { actions, closePalette, executeAction, open, query, setQuery } = useCommandPalette();
+
+  if (!open) {
+    return null;
+  }
+
+  return (
+    <div role="dialog" aria-modal="true">
+      <input value={query} onChange={(event) => setQuery(event.target.value)} />
+      {actions.map((action) => (
+        <button
+          key={action.id}
+          type="button"
+          onClick={async () => {
+            await executeAction(action.id);
+            closePalette();
+          }}
+        >
+          {action.title}
+        </button>
+      ))}
+    </div>
+  );
+}
+```
+
+### Shortcut Settings
+
+```tsx
+function ShortcutSettings() {
+  const { clearShortcutOverride, getEffectiveShortcut, setShortcutOverride } = useShortcutBindings();
+
+  return (
+    <section>
+      <p>Save draft: {getEffectiveShortcut("save-draft")}</p>
+      <button type="button" onClick={() => setShortcutOverride("save-draft", "alt+s")}>
+        Use Alt+S
+      </button>
+      <button type="button" onClick={() => clearShortcutOverride("save-draft")}>
+        Reset
+      </button>
+    </section>
+  );
+}
+```
+
+## Demo
+
+```sh
+npm install
+npm run demo
+```
+
+Then open `http://127.0.0.1:5173`.
+
+The demo is intentionally styled in the example app only. The library does not ship CSS or visual components.

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var Y=Object.defineProperty;var $=(t,e,r)=>e in t?Y(t,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):t[e]=r;var T=(t,e,r)=>$(t,typeof e!="symbol"?e+"":e,r);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const q=require("react/jsx-runtime"),c=require("react");class D{constructor(){T(this,"actionsById",new Map)}register(e){const r=X(e);return this.actionsById.set(r.id,r),()=>{this.actionsById.get(r.id)===r&&this.actionsById.delete(r.id)}}get(e){return this.actionsById.get(e)}getAll(){return Array.from(this.actionsById.values())}async execute(e){const r=this.actionsById.get(e);return!r||r.disabled?!1:(await r.execute(),!0)}}function N(t){return!t.hidden}function X(t){return{...t,keywords:t.keywords?[...t.keywords]:void 0}}function C(t,e){const r=t.filter(N),n=d(e);return n?r.map(o=>({action:o,score:Z(o,n)})).filter(o=>o.score>0).sort(tt).map(o=>o.action):et(r)}function Z(t,e){var i;const r=d(t.title),n=d(t.description),o=d(t.group),a=d((i=t.keywords)==null?void 0:i.join(" "));return A(r,e,1e3,700,500)+A(a,e,650,450,300)+A(o,e,400,275,175)+A(n,e,250,175,100)}function A(t,e,r,n,o){return t?t===e?r:t.startsWith(e)?n:t.includes(e)?o:rt(e,t)?Math.floor(o/2):0:0}function tt(t,e){return e.score!==t.score?e.score-t.score:t.action.title.localeCompare(e.action.title)}function et(t){return[...t].sort((e,r)=>e.title.localeCompare(r.title))}function d(t){return(t==null?void 0:t.trim().toLowerCase())??""}function rt(t,e){let r=0;for(const n of e)if(n===t[r]&&(r+=1),r===t.length)return!0;return!1}const b=["mod","ctrl","meta","alt","shift"],nt=new Map([["cmd","mod"],["command","mod"],["option","alt"],["control","ctrl"],["esc","escape"],["return","enter"],["plus","+"],["space"," "]]);function h(t){const e=t.split("+").map(o=>G(o)).filter(Boolean),r=new Set(e.filter(S)),n=e.find(o=>!S(o));return n?[...Array.from(r).sort(z),n].join("+"):Array.from(r).sort(z).join("+")}function g(t,e){const n=e[t.id]??t.shortcut;return n?h(n):void 0}function V(t,e,r){return e.find(n=>{if(n.disabled||n.hidden)return!1;const o=g(n,r);return o?Q(o,t):!1})}function _(t,e,r,n){const o=h(e);return r.some(a=>a.id===t?!1:g(a,n)===o)}function J(t){if(!(t instanceof HTMLElement))return!1;if(t.isContentEditable)return!0;const e=t.tagName.toLowerCase();return e==="input"||e==="textarea"||e==="select"}function Q(t,e){const n=h(t).split("+"),o=n.find(i=>!S(i)),a=new Set(n.filter(S));return!o||o!==ct(e.key)?!1:ot(a,e)}function ot(t,e){const r=t.has("mod"),n=t.has("ctrl"),o=t.has("meta"),a=st(),i=a?e.metaKey:e.ctrlKey;return r&&!i||!r&&e.ctrlKey!==n||!r&&e.metaKey!==o||r&&a&&e.ctrlKey!==n||r&&!a&&e.metaKey!==o?!1:e.altKey===t.has("alt")&&e.shiftKey===t.has("shift")}function G(t){const e=t.trim().toLowerCase();return nt.get(e)??e}function ct(t){return G(t.length===1?t.toLowerCase():t)}function S(t){return b.some(e=>e===t)}function z(t,e){return j(t)-j(e)}function j(t){const e=b.findIndex(r=>r===t);return e===-1?b.length:e}function st(){return typeof navigator>"u"?!0:/Mac|iPhone|iPad|iPod/.test(navigator.platform)}const H=c.createContext(null);function it({children:t,storage:e,ignoreEditableElements:r=!0}){const n=c.useRef(new D),[o,a]=c.useState([]),[i,m]=c.useState({}),[O,v]=c.useState(!1),[p,U]=c.useState("");c.useEffect(()=>{let s=!0;async function u(){const l=await(e==null?void 0:e.loadShortcutOverrides());!s||!l||m(l)}return u(),()=>{s=!1}},[e]);const w=c.useCallback(()=>{a(n.current.getAll())},[]),k=c.useCallback(s=>{const u=n.current.register(s);return w(),()=>{u(),w()}},[w]),K=c.useCallback(async s=>n.current.execute(s),[]),E=c.useCallback(s=>n.current.get(s),[]),P=c.useCallback(s=>{const u=n.current.get(s);return u?g(u,i):void 0},[i]),y=c.useCallback(s=>{m(s),e==null||e.saveShortcutOverrides(s)},[e]),I=c.useCallback((s,u)=>{const l=h(u);return _(s,l,n.current.getAll(),i)?!1:(y({...i,[s]:l}),!0)},[y,i]),M=c.useCallback(s=>{const u={...i};delete u[s],y(u)},[y,i]),x=c.useCallback(()=>v(!1),[]),R=c.useCallback(()=>v(!0),[]),L=c.useCallback(()=>v(s=>!s),[]),B=c.useMemo(()=>C(o,p),[o,p]);c.useEffect(()=>{function s(u){if(r&&J(u.target))return;const l=V(u,n.current.getAll(),i);l&&(u.preventDefault(),n.current.execute(l.id))}return window.addEventListener("keydown",s),()=>window.removeEventListener("keydown",s)},[r,i]);const W=c.useMemo(()=>({actions:o,shortcutOverrides:i,registerAction:k,executeAction:K,getAction:E,getEffectiveShortcut:P,setShortcutOverride:I,clearShortcutOverride:M,paletteOpen:O,paletteQuery:p,paletteActions:B,openPalette:R,closePalette:x,togglePalette:L,setPaletteQuery:U}),[o,M,x,K,E,P,R,B,O,p,k,I,i,L]);return q.jsx(H.Provider,{value:W,children:t})}function f(){const t=c.useContext(H);if(!t)throw new Error("ActionKit hooks must be used inside ActionKitProvider.");return t}function ut(t){const{registerAction:e}=f(),r=c.useRef(t),n=mt(t);r.current=t,c.useEffect(()=>e({...t,execute:()=>r.current.execute()}),[n,e])}function at(t){const{actions:e}=f();return c.useMemo(()=>e.find(r=>r.id===t),[t,e])}function lt(){const{actions:t}=f();return t}function ft(){const{paletteOpen:t,paletteQuery:e,paletteActions:r,openPalette:n,closePalette:o,togglePalette:a,setPaletteQuery:i,executeAction:m}=f();return{open:t,query:e,actions:r,openPalette:n,closePalette:o,togglePalette:a,setQuery:i,executeAction:m}}function dt(){const{shortcutOverrides:t,getEffectiveShortcut:e,setShortcutOverride:r,clearShortcutOverride:n}=f();return{shortcutOverrides:t,getEffectiveShortcut:e,setShortcutOverride:r,clearShortcutOverride:n}}function ht(t){const{actions:e}=f();return c.useMemo(()=>C(e,t),[e,t])}function mt(t){return JSON.stringify({id:t.id,title:t.title,description:t.description,group:t.group,keywords:t.keywords,shortcut:t.shortcut,disabled:t.disabled,hidden:t.hidden})}const pt="actionkit:shortcut-overrides";function yt(t=pt){return{loadShortcutOverrides(){if(!F())return{};const e=window.localStorage.getItem(t);return e?At(e):{}},saveShortcutOverrides(e){F()&&window.localStorage.setItem(t,JSON.stringify(e))}}}function At(t){try{const e=JSON.parse(t);return St(e)?e:{}}catch{return{}}}function St(t){return!t||typeof t!="object"||Array.isArray(t)?!1:Object.values(t).every(e=>e===void 0||typeof e=="string")}function F(){return typeof window<"u"&&!!window.localStorage&&typeof window.localStorage.getItem=="function"&&typeof window.localStorage.setItem=="function"}exports.ActionKitProvider=it;exports.ActionRegistry=D;exports.createLocalStorageAdapter=yt;exports.findActionForKeyboardEvent=V;exports.getEffectiveShortcut=g;exports.isVisibleAction=N;exports.normalizeShortcut=h;exports.searchActions=C;exports.shortcutConflicts=_;exports.shortcutMatchesEvent=Q;exports.shouldIgnoreKeyboardTarget=J;exports.useAction=at;exports.useActionKitContext=f;exports.useActions=lt;exports.useCommandPalette=ft;exports.useFilteredActions=ht;exports.useRegisterAction=ut;exports.useShortcutBindings=dt;

package/dist/index.d.ts

@@ -0,0 +1,111 @@
+import { JSX } from 'react';
+import { ReactNode } from 'react';
+
+export declare interface ActionDefinition {
+    id: string;
+    title: string;
+    description?: string;
+    group?: string;
+    keywords?: string[];
+    shortcut?: string;
+    disabled?: boolean;
+    hidden?: boolean;
+    execute: ActionExecute;
+}
+
+export declare type ActionExecute = () => void | Promise<void>;
+
+export declare interface ActionKitContextValue {
+    actions: RegisteredAction[];
+    shortcutOverrides: ShortcutOverrides;
+    registerAction: (action: ActionDefinition) => () => void;
+    executeAction: (actionId: string) => Promise<boolean>;
+    getAction: (actionId: string) => RegisteredAction | undefined;
+    getEffectiveShortcut: (actionId: string) => string | undefined;
+    setShortcutOverride: (actionId: string, shortcut: string) => boolean;
+    clearShortcutOverride: (actionId: string) => void;
+    paletteOpen: boolean;
+    paletteQuery: string;
+    paletteActions: RegisteredAction[];
+    openPalette: () => void;
+    closePalette: () => void;
+    togglePalette: () => void;
+    setPaletteQuery: (query: string) => void;
+}
+
+export declare function ActionKitProvider({ children, storage, ignoreEditableElements }: ActionKitProviderProps): JSX.Element;
+
+export declare interface ActionKitProviderProps {
+    children: ReactNode;
+    storage?: ActionKitStorage;
+    ignoreEditableElements?: boolean;
+}
+
+export declare interface ActionKitStorage {
+    loadShortcutOverrides: () => ShortcutOverrides | Promise<ShortcutOverrides>;
+    saveShortcutOverrides: (overrides: ShortcutOverrides) => void | Promise<void>;
+}
+
+export declare class ActionRegistry {
+    private readonly actionsById;
+    register(action: ActionDefinition): () => void;
+    get(actionId: string): RegisteredAction | undefined;
+    getAll(): RegisteredAction[];
+    execute(actionId: string): Promise<boolean>;
+}
+
+export declare function createLocalStorageAdapter(storageKey?: string): ActionKitStorage;
+
+export declare function findActionForKeyboardEvent(event: KeyboardEvent, actions: RegisteredAction[], shortcutOverrides: ShortcutOverrides): RegisteredAction | undefined;
+
+export declare function getEffectiveShortcut(action: RegisteredAction, shortcutOverrides: ShortcutOverrides): string | undefined;
+
+export declare function isVisibleAction(action: RegisteredAction): boolean;
+
+export declare function normalizeShortcut(shortcut: string): string;
+
+export declare interface RegisteredAction extends ActionDefinition {
+    shortcut?: string;
+}
+
+export declare function searchActions(actions: RegisteredAction[], query: string): RegisteredAction[];
+
+export declare function shortcutConflicts(actionId: string, shortcut: string, actions: RegisteredAction[], shortcutOverrides: ShortcutOverrides): boolean;
+
+export declare function shortcutMatchesEvent(shortcut: string, event: KeyboardEvent): boolean;
+
+export declare interface ShortcutOverrides {
+    [actionId: string]: string | undefined;
+}
+
+export declare function shouldIgnoreKeyboardTarget(target: EventTarget | null): boolean;
+
+export declare function useAction(actionId: string): RegisteredAction | undefined;
+
+export declare function useActionKitContext(): ActionKitContextValue;
+
+export declare function useActions(): RegisteredAction[];
+
+export declare function useCommandPalette(): {
+    open: boolean;
+    query: string;
+    actions: RegisteredAction[];
+    openPalette: () => void;
+    closePalette: () => void;
+    togglePalette: () => void;
+    setQuery: (query: string) => void;
+    executeAction: (actionId: string) => Promise<boolean>;
+};
+
+export declare function useFilteredActions(query: string): RegisteredAction[];
+
+export declare function useRegisterAction(action: ActionDefinition): void;
+
+export declare function useShortcutBindings(): {
+    shortcutOverrides: ShortcutOverrides;
+    getEffectiveShortcut: (actionId: string) => string | undefined;
+    setShortcutOverride: (actionId: string, shortcut: string) => boolean;
+    clearShortcutOverride: (actionId: string) => void;
+};
+
+export { }

package/dist/index.js

@@ -0,0 +1,344 @@
+var U = Object.defineProperty;
+var W = (t, e, r) => e in t ? U(t, e, { enumerable: !0, configurable: !0, writable: !0, value: r }) : t[e] = r;
+var D = (t, e, r) => W(t, typeof e != "symbol" ? e + "" : e, r);
+import { jsx as Y } from "react/jsx-runtime";
+import { useRef as _, useState as y, useEffect as K, useCallback as a, useMemo as S, useContext as $, createContext as X } from "react";
+class Z {
+  constructor() {
+    D(this, "actionsById", /* @__PURE__ */ new Map());
+  }
+  register(e) {
+    const r = tt(e);
+    return this.actionsById.set(r.id, r), () => {
+      this.actionsById.get(r.id) === r && this.actionsById.delete(r.id);
+    };
+  }
+  get(e) {
+    return this.actionsById.get(e);
+  }
+  getAll() {
+    return Array.from(this.actionsById.values());
+  }
+  async execute(e) {
+    const r = this.actionsById.get(e);
+    return !r || r.disabled ? !1 : (await r.execute(), !0);
+  }
+}
+function q(t) {
+  return !t.hidden;
+}
+function tt(t) {
+  return {
+    ...t,
+    keywords: t.keywords ? [...t.keywords] : void 0
+  };
+}
+function J(t, e) {
+  const r = t.filter(q), n = d(e);
+  return n ? r.map((o) => ({ action: o, score: et(o, n) })).filter((o) => o.score > 0).sort(rt).map((o) => o.action) : nt(r);
+}
+function et(t, e) {
+  var c;
+  const r = d(t.title), n = d(t.description), o = d(t.group), u = d((c = t.keywords) == null ? void 0 : c.join(" "));
+  return A(r, e, 1e3, 700, 500) + A(u, e, 650, 450, 300) + A(o, e, 400, 275, 175) + A(n, e, 250, 175, 100);
+}
+function A(t, e, r, n, o) {
+  return t ? t === e ? r : t.startsWith(e) ? n : t.includes(e) ? o : ot(e, t) ? Math.floor(o / 2) : 0 : 0;
+}
+function rt(t, e) {
+  return e.score !== t.score ? e.score - t.score : t.action.title.localeCompare(e.action.title);
+}
+function nt(t) {
+  return [...t].sort((e, r) => e.title.localeCompare(r.title));
+}
+function d(t) {
+  return (t == null ? void 0 : t.trim().toLowerCase()) ?? "";
+}
+function ot(t, e) {
+  let r = 0;
+  for (const n of e)
+    if (n === t[r] && (r += 1), r === t.length)
+      return !0;
+  return !1;
+}
+const E = ["mod", "ctrl", "meta", "alt", "shift"], it = /* @__PURE__ */ new Map([
+  ["cmd", "mod"],
+  ["command", "mod"],
+  ["option", "alt"],
+  ["control", "ctrl"],
+  ["esc", "escape"],
+  ["return", "enter"],
+  ["plus", "+"],
+  ["space", " "]
+]);
+function w(t) {
+  const e = t.split("+").map((o) => Q(o)).filter(Boolean), r = new Set(e.filter(g)), n = e.find((o) => !g(o));
+  return n ? [...Array.from(r).sort(j), n].join("+") : Array.from(r).sort(j).join("+");
+}
+function I(t, e) {
+  const n = e[t.id] ?? t.shortcut;
+  return n ? w(n) : void 0;
+}
+function ct(t, e, r) {
+  return e.find((n) => {
+    if (n.disabled || n.hidden)
+      return !1;
+    const o = I(n, r);
+    return o ? at(o, t) : !1;
+  });
+}
+function st(t, e, r, n) {
+  const o = w(e);
+  return r.some((u) => u.id === t ? !1 : I(u, n) === o);
+}
+function ut(t) {
+  if (!(t instanceof HTMLElement))
+    return !1;
+  if (t.isContentEditable)
+    return !0;
+  const e = t.tagName.toLowerCase();
+  return e === "input" || e === "textarea" || e === "select";
+}
+function at(t, e) {
+  const n = w(t).split("+"), o = n.find((c) => !g(c)), u = new Set(n.filter(g));
+  return !o || o !== lt(e.key) ? !1 : ft(u, e);
+}
+function ft(t, e) {
+  const r = t.has("mod"), n = t.has("ctrl"), o = t.has("meta"), u = dt(), c = u ? e.metaKey : e.ctrlKey;
+  return r && !c || !r && e.ctrlKey !== n || !r && e.metaKey !== o || r && u && e.ctrlKey !== n || r && !u && e.metaKey !== o ? !1 : e.altKey === t.has("alt") && e.shiftKey === t.has("shift");
+}
+function Q(t) {
+  const e = t.trim().toLowerCase();
+  return it.get(e) ?? e;
+}
+function lt(t) {
+  return Q(t.length === 1 ? t.toLowerCase() : t);
+}
+function g(t) {
+  return E.some((e) => e === t);
+}
+function j(t, e) {
+  return F(t) - F(e);
+}
+function F(t) {
+  const e = E.findIndex((r) => r === t);
+  return e === -1 ? E.length : e;
+}
+function dt() {
+  return typeof navigator > "u" ? !0 : /Mac|iPhone|iPad|iPod/.test(navigator.platform);
+}
+const V = X(null);
+function wt({ children: t, storage: e, ignoreEditableElements: r = !0 }) {
+  const n = _(new Z()), [o, u] = y([]), [c, h] = y({}), [P, v] = y(!1), [p, G] = y("");
+  K(() => {
+    let i = !0;
+    async function s() {
+      const f = await (e == null ? void 0 : e.loadShortcutOverrides());
+      !i || !f || h(f);
+    }
+    return s(), () => {
+      i = !1;
+    };
+  }, [e]);
+  const O = a(() => {
+    u(n.current.getAll());
+  }, []), k = a(
+    (i) => {
+      const s = n.current.register(i);
+      return O(), () => {
+        s(), O();
+      };
+    },
+    [O]
+  ), x = a(async (i) => n.current.execute(i), []), C = a((i) => n.current.get(i), []), b = a(
+    (i) => {
+      const s = n.current.get(i);
+      return s ? I(s, c) : void 0;
+    },
+    [c]
+  ), m = a(
+    (i) => {
+      h(i), e == null || e.saveShortcutOverrides(i);
+    },
+    [e]
+  ), M = a(
+    (i, s) => {
+      const f = w(s);
+      return st(i, f, n.current.getAll(), c) ? !1 : (m({
+        ...c,
+        [i]: f
+      }), !0);
+    },
+    [m, c]
+  ), L = a(
+    (i) => {
+      const s = { ...c };
+      delete s[i], m(s);
+    },
+    [m, c]
+  ), B = a(() => v(!1), []), R = a(() => v(!0), []), T = a(() => v((i) => !i), []), z = S(() => J(o, p), [o, p]);
+  K(() => {
+    function i(s) {
+      if (r && ut(s.target))
+        return;
+      const f = ct(s, n.current.getAll(), c);
+      f && (s.preventDefault(), n.current.execute(f.id));
+    }
+    return window.addEventListener("keydown", i), () => window.removeEventListener("keydown", i);
+  }, [r, c]);
+  const H = S(
+    () => ({
+      actions: o,
+      shortcutOverrides: c,
+      registerAction: k,
+      executeAction: x,
+      getAction: C,
+      getEffectiveShortcut: b,
+      setShortcutOverride: M,
+      clearShortcutOverride: L,
+      paletteOpen: P,
+      paletteQuery: p,
+      paletteActions: z,
+      openPalette: R,
+      closePalette: B,
+      togglePalette: T,
+      setPaletteQuery: G
+    }),
+    [
+      o,
+      L,
+      B,
+      x,
+      C,
+      b,
+      R,
+      z,
+      P,
+      p,
+      k,
+      M,
+      c,
+      T
+    ]
+  );
+  return /* @__PURE__ */ Y(V.Provider, { value: H, children: t });
+}
+function l() {
+  const t = $(V);
+  if (!t)
+    throw new Error("ActionKit hooks must be used inside ActionKitProvider.");
+  return t;
+}
+function vt(t) {
+  const { registerAction: e } = l(), r = _(t), n = ht(t);
+  r.current = t, K(
+    () => e({
+      ...t,
+      execute: () => r.current.execute()
+    }),
+    [n, e]
+  );
+}
+function Ot(t) {
+  const { actions: e } = l();
+  return S(() => e.find((r) => r.id === t), [t, e]);
+}
+function Kt() {
+  const { actions: t } = l();
+  return t;
+}
+function Et() {
+  const {
+    paletteOpen: t,
+    paletteQuery: e,
+    paletteActions: r,
+    openPalette: n,
+    closePalette: o,
+    togglePalette: u,
+    setPaletteQuery: c,
+    executeAction: h
+  } = l();
+  return {
+    open: t,
+    query: e,
+    actions: r,
+    openPalette: n,
+    closePalette: o,
+    togglePalette: u,
+    setQuery: c,
+    executeAction: h
+  };
+}
+function It() {
+  const { shortcutOverrides: t, getEffectiveShortcut: e, setShortcutOverride: r, clearShortcutOverride: n } = l();
+  return {
+    shortcutOverrides: t,
+    getEffectiveShortcut: e,
+    setShortcutOverride: r,
+    clearShortcutOverride: n
+  };
+}
+function Pt(t) {
+  const { actions: e } = l();
+  return S(() => J(e, t), [e, t]);
+}
+function ht(t) {
+  return JSON.stringify({
+    id: t.id,
+    title: t.title,
+    description: t.description,
+    group: t.group,
+    keywords: t.keywords,
+    shortcut: t.shortcut,
+    disabled: t.disabled,
+    hidden: t.hidden
+  });
+}
+const pt = "actionkit:shortcut-overrides";
+function kt(t = pt) {
+  return {
+    loadShortcutOverrides() {
+      if (!N())
+        return {};
+      const e = window.localStorage.getItem(t);
+      return e ? mt(e) : {};
+    },
+    saveShortcutOverrides(e) {
+      N() && window.localStorage.setItem(t, JSON.stringify(e));
+    }
+  };
+}
+function mt(t) {
+  try {
+    const e = JSON.parse(t);
+    return yt(e) ? e : {};
+  } catch {
+    return {};
+  }
+}
+function yt(t) {
+  return !t || typeof t != "object" || Array.isArray(t) ? !1 : Object.values(t).every((e) => e === void 0 || typeof e == "string");
+}
+function N() {
+  return typeof window < "u" && !!window.localStorage && typeof window.localStorage.getItem == "function" && typeof window.localStorage.setItem == "function";
+}
+export {
+  wt as ActionKitProvider,
+  Z as ActionRegistry,
+  kt as createLocalStorageAdapter,
+  ct as findActionForKeyboardEvent,
+  I as getEffectiveShortcut,
+  q as isVisibleAction,
+  w as normalizeShortcut,
+  J as searchActions,
+  st as shortcutConflicts,
+  at as shortcutMatchesEvent,
+  ut as shouldIgnoreKeyboardTarget,
+  Ot as useAction,
+  l as useActionKitContext,
+  Kt as useActions,
+  Et as useCommandPalette,
+  Pt as useFilteredActions,
+  vt as useRegisterAction,
+  It as useShortcutBindings
+};

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "react-actionkit",
+  "version": "0.1.0",
+  "description": "Headless React actions, keyboard shortcuts, and command palette state.",
+  "type": "module",
+  "license": "MIT",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/saicharanar/actionkit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/saicharanar/actionkit/issues"
+  },
+  "homepage": "https://github.com/saicharanar/actionkit#readme",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "ci": "npm run typecheck && npm run test && npm run build && npm audit",
+    "demo": "vite --config examples/demo/vite.config.ts --host 127.0.0.1",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
+  },
+  "peerDependencies": {
+    "react": ">=18.2.0 || >=19.0.0",
+    "react-dom": ">=18.2.0 || >=19.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.1.0",
+    "@types/node": "^26.0.1",
+    "@types/react": "^19.0.2",
+    "@types/react-dom": "^19.0.2",
+    "@vitejs/plugin-react": "^4.3.4",
+    "jsdom": "^25.0.1",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "typescript": "^5.7.2",
+    "vite": "^6.0.5",
+    "vite-plugin-dts": "^4.4.0",
+    "vitest": "^4.1.9"
+  }
+}