sibujs 3.3.1 → 3.3.2

package/dist/devtools.cjs

@@ -609,7 +609,7 @@ function forEachSubscriber(signal2, visit) {
 
 // src/reactivity/track.ts
 var _isDev3 = isDev();
-var _runtimeVersion = typeof __SIBU_VERSION__ !== "undefined" ? __SIBU_VERSION__ : "dev";
+var _runtimeVersion = true ? "3.3.2" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g = globalThis;
@@ -1767,23 +1767,29 @@ function formatError(error, context, seen = /* @__PURE__ */ new Set([error])) {
 }
 
 // src/core/ssr-context.ts
-var als = null;
-try {
-  if (typeof process !== "undefined" && process.versions && process.versions.node) {
-    let mod = null;
-    const getBuiltin = process.getBuiltinModule;
-    if (typeof getBuiltin === "function") {
-      mod = getBuiltin("node:async_hooks");
-    } else {
-      const req = Function("return typeof require==='function'?require:null")();
-      if (req) mod = req("node:async_hooks");
+var SSR_KEY = /* @__PURE__ */ Symbol.for("sibujs.ssr.v1");
+function detectSSRShared() {
+  let detected = null;
+  try {
+    if (typeof process !== "undefined" && process.versions && process.versions.node) {
+      let mod = null;
+      const getBuiltin = process.getBuiltinModule;
+      if (typeof getBuiltin === "function") {
+        mod = getBuiltin("node:async_hooks");
+      } else {
+        const req = Function("return typeof require==='function'?require:null")();
+        if (req) mod = req("node:async_hooks");
+      }
+      if (mod) detected = new mod.AsyncLocalStorage();
     }
-    if (mod) als = new mod.AsyncLocalStorage();
+  } catch {
+    detected = null;
   }
-} catch {
-  als = null;
+  return { als: detected, fallbackStore: { ssr: false, suspenseIdCounter: 0 } };
 }
-var fallbackStore = { ssr: false, suspenseIdCounter: 0 };
+var _shared = globalThis[SSR_KEY] ?? (globalThis[SSR_KEY] = detectSSRShared());
+var als = _shared.als;
+var fallbackStore = _shared.fallbackStore;
 function getSSRStore() {
   if (als) {
     const s = als.getStore();

package/dist/devtools.js

@@ -35,13 +35,13 @@ import {
   trackCleanup,
   walkDependencyGraph,
   withErrorTracking
-} from "./chunk-ULLTNDRA.js";
+} from "./chunk-AEOLHSSQ.js";
 import "./chunk-5VGSK6D2.js";
 import "./chunk-L3GAGWCC.js";
-import "./chunk-MHBCEJQO.js";
-import "./chunk-GOJMFRBL.js";
-import "./chunk-WZG2SZOT.js";
-import "./chunk-TEFZT5PJ.js";
+import "./chunk-N5TQVEKE.js";
+import "./chunk-S3NFJO6L.js";
+import "./chunk-JCQG2I2G.js";
+import "./chunk-4NJEAPLI.js";
 import {
   isDev
 } from "./chunk-COY6PUD2.js";

package/dist/ecosystem.cjs

@@ -469,7 +469,7 @@ function forEachSubscriber(signal2, visit) {
 
 // src/reactivity/track.ts
 var _isDev3 = isDev();
-var _runtimeVersion = typeof __SIBU_VERSION__ !== "undefined" ? __SIBU_VERSION__ : "dev";
+var _runtimeVersion = true ? "3.3.2" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g = globalThis;
@@ -526,23 +526,29 @@ var getSubscriberDeps2 = API.getSubscriberDeps;
 var forEachSubscriber2 = API.forEachSubscriber;
 
 // src/core/ssr-context.ts
-var als = null;
-try {
-  if (typeof process !== "undefined" && process.versions && process.versions.node) {
-    let mod = null;
-    const getBuiltin = process.getBuiltinModule;
-    if (typeof getBuiltin === "function") {
-      mod = getBuiltin("node:async_hooks");
-    } else {
-      const req = Function("return typeof require==='function'?require:null")();
-      if (req) mod = req("node:async_hooks");
+var SSR_KEY = /* @__PURE__ */ Symbol.for("sibujs.ssr.v1");
+function detectSSRShared() {
+  let detected = null;
+  try {
+    if (typeof process !== "undefined" && process.versions && process.versions.node) {
+      let mod = null;
+      const getBuiltin = process.getBuiltinModule;
+      if (typeof getBuiltin === "function") {
+        mod = getBuiltin("node:async_hooks");
+      } else {
+        const req = Function("return typeof require==='function'?require:null")();
+        if (req) mod = req("node:async_hooks");
+      }
+      if (mod) detected = new mod.AsyncLocalStorage();
     }
-    if (mod) als = new mod.AsyncLocalStorage();
+  } catch {
+    detected = null;
   }
-} catch {
-  als = null;
+  return { als: detected, fallbackStore: { ssr: false, suspenseIdCounter: 0 } };
 }
-var fallbackStore = { ssr: false, suspenseIdCounter: 0 };
+var _shared = globalThis[SSR_KEY] ?? (globalThis[SSR_KEY] = detectSSRShared());
+var als = _shared.als;
+var fallbackStore = _shared.fallbackStore;
 function getSSRStore() {
   if (als) {
     const s = als.getStore();

package/dist/ecosystem.js

@@ -7,17 +7,17 @@ import {
   mobXAdapter,
   reduxAdapter,
   zustandAdapter
-} from "./chunk-4UUMSLSL.js";
+} from "./chunk-P7C7SEJV.js";
 import "./chunk-3JHCYHWN.js";
-import "./chunk-LU2MQXQQ.js";
-import "./chunk-NHKQKKZU.js";
-import "./chunk-WW6DAGGR.js";
+import "./chunk-ZEUP4TUD.js";
+import "./chunk-QCFBIVIQ.js";
+import "./chunk-G6N3LMO2.js";
 import "./chunk-5VGSK6D2.js";
 import "./chunk-L3GAGWCC.js";
-import "./chunk-MHBCEJQO.js";
-import "./chunk-GOJMFRBL.js";
-import "./chunk-WZG2SZOT.js";
-import "./chunk-TEFZT5PJ.js";
+import "./chunk-N5TQVEKE.js";
+import "./chunk-S3NFJO6L.js";
+import "./chunk-JCQG2I2G.js";
+import "./chunk-4NJEAPLI.js";
 import "./chunk-COY6PUD2.js";
 export {
   antdAdapter,

package/dist/extras.cjs

@@ -753,7 +753,7 @@ function forEachSubscriber(signal2, visit) {
 
 // src/reactivity/track.ts
 var _isDev3 = isDev();
-var _runtimeVersion = typeof __SIBU_VERSION__ !== "undefined" ? __SIBU_VERSION__ : "dev";
+var _runtimeVersion = true ? "3.3.2" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g2 = globalThis;
@@ -889,23 +889,29 @@ function derived(getter, options) {
 }
 
 // src/core/ssr-context.ts
-var als = null;
-try {
-  if (typeof process !== "undefined" && process.versions && process.versions.node) {
-    let mod = null;
-    const getBuiltin = process.getBuiltinModule;
-    if (typeof getBuiltin === "function") {
-      mod = getBuiltin("node:async_hooks");
-    } else {
-      const req = Function("return typeof require==='function'?require:null")();
-      if (req) mod = req("node:async_hooks");
+var SSR_KEY = /* @__PURE__ */ Symbol.for("sibujs.ssr.v1");
+function detectSSRShared() {
+  let detected = null;
+  try {
+    if (typeof process !== "undefined" && process.versions && process.versions.node) {
+      let mod = null;
+      const getBuiltin = process.getBuiltinModule;
+      if (typeof getBuiltin === "function") {
+        mod = getBuiltin("node:async_hooks");
+      } else {
+        const req = Function("return typeof require==='function'?require:null")();
+        if (req) mod = req("node:async_hooks");
+      }
+      if (mod) detected = new mod.AsyncLocalStorage();
     }
-    if (mod) als = new mod.AsyncLocalStorage();
+  } catch {
+    detected = null;
   }
-} catch {
-  als = null;
+  return { als: detected, fallbackStore: { ssr: false, suspenseIdCounter: 0 } };
 }
-var fallbackStore = { ssr: false, suspenseIdCounter: 0 };
+var _shared = globalThis[SSR_KEY] ?? (globalThis[SSR_KEY] = detectSSRShared());
+var als = _shared.als;
+var fallbackStore = _shared.fallbackStore;
 function getSSRStore() {
   if (als) {
     const s2 = als.getStore();
@@ -4836,23 +4842,18 @@ function custom(fn, message) {
   return (value) => fn(value) ? null : message;
 }
 function bindField(field, extras) {
+  const readControlValue = (target) => {
+    if ("checked" in target && target.type === "checkbox") {
+      return target.checked;
+    }
+    if (target instanceof HTMLSelectElement && target.multiple) {
+      return Array.from(target.selectedOptions, (o) => o.value);
+    }
+    return target.value;
+  };
   const fieldOn = {
-    input: (e) => {
-      const target = e.target;
-      if (target.type === "checkbox") {
-        field.set(target.checked);
-      } else {
-        field.set(target.value);
-      }
-    },
-    change: (e) => {
-      const target = e.target;
-      if ("checked" in target && target.type === "checkbox") {
-        field.set(target.checked);
-      } else {
-        field.set(target.value);
-      }
-    },
+    input: (e) => field.set(readControlValue(e.target)),
+    change: (e) => field.set(readControlValue(e.target)),
     blur: () => field.touch()
   };
   const { on: extraOn, value: _ignoreValue, ...restExtras } = extras ?? {};

package/dist/extras.js

@@ -5,7 +5,7 @@ import {
   optimisticList,
   persisted,
   timeline
-} from "./chunk-XH2RTYEQ.js";
+} from "./chunk-655B7MMR.js";
 import {
   DOMPool,
   Features,
@@ -41,7 +41,7 @@ import {
   transitionState,
   uniqueId,
   yieldToMain
-} from "./chunk-M5KBNOSJ.js";
+} from "./chunk-YUR5SX7F.js";
 import {
   VERSION,
   bundlerMetadata,
@@ -62,7 +62,7 @@ import {
   preloadCritical,
   prerenderRoutes,
   satisfies
-} from "./chunk-ZUVLC7TM.js";
+} from "./chunk-FJIRS3FM.js";
 import {
   Head,
   clearWasmCache,
@@ -87,7 +87,7 @@ import {
   wasm,
   worker,
   workerFn
-} from "./chunk-6LTFHJQG.js";
+} from "./chunk-A7CZH3GN.js";
 import {
   FocusTrap,
   VirtualList,
@@ -128,7 +128,7 @@ import {
   toast,
   withScopedStyle,
   zipMask
-} from "./chunk-RYMOSG5B.js";
+} from "./chunk-62V653X2.js";
 import {
   RenderProp,
   assertType,
@@ -155,7 +155,7 @@ import {
   select,
   tabs,
   tooltip
-} from "./chunk-Z37APKBV.js";
+} from "./chunk-FJO2ZL4Q.js";
 import {
   animationFrame,
   battery,
@@ -193,7 +193,7 @@ import {
   visibility,
   wakeLock,
   windowSize
-} from "./chunk-VOVVTOEA.js";
+} from "./chunk-Q46YIQYW.js";
 import "./chunk-H3SRKIYX.js";
 import {
   __resetQueryCache,
@@ -217,7 +217,7 @@ import {
   syncAdapter,
   throttle,
   withRetry
-} from "./chunk-AMIKDMLP.js";
+} from "./chunk-YUBEOWII.js";
 import {
   SibuError,
   checkLeaks,
@@ -255,7 +255,7 @@ import {
   trackCleanup,
   walkDependencyGraph,
   withErrorTracking
-} from "./chunk-ULLTNDRA.js";
+} from "./chunk-AEOLHSSQ.js";
 import {
   antdAdapter,
   chakraAdapter,
@@ -265,7 +265,7 @@ import {
   mobXAdapter,
   reduxAdapter,
   zustandAdapter
-} from "./chunk-4UUMSLSL.js";
+} from "./chunk-P7C7SEJV.js";
 import {
   createPlugin,
   createPluginRegistry,
@@ -277,8 +277,8 @@ import {
   triggerPluginMount,
   triggerPluginUnmount
 } from "./chunk-3JHCYHWN.js";
-import "./chunk-37BUKSLH.js";
-import "./chunk-SLMFA3ZZ.js";
+import "./chunk-6TCOWMGY.js";
+import "./chunk-RLTFJYDN.js";
 import {
   collectStream,
   deserializeState,
@@ -298,15 +298,15 @@ import {
   ssrSuspense,
   suspenseSwapScript,
   trustHTML
-} from "./chunk-R3QEDXFS.js";
-import "./chunk-F7FXQ3QS.js";
-import "./chunk-LU2MQXQQ.js";
-import "./chunk-NHKQKKZU.js";
-import "./chunk-WW6DAGGR.js";
+} from "./chunk-EX77FXTT.js";
+import "./chunk-5VH3GIDX.js";
+import "./chunk-ZEUP4TUD.js";
+import "./chunk-QCFBIVIQ.js";
+import "./chunk-G6N3LMO2.js";
 import "./chunk-5VGSK6D2.js";
 import "./chunk-L3GAGWCC.js";
-import "./chunk-MHBCEJQO.js";
-import "./chunk-GOJMFRBL.js";
+import "./chunk-N5TQVEKE.js";
+import "./chunk-S3NFJO6L.js";
 import {
   TransitionGroup,
   animate,
@@ -328,9 +328,9 @@ import {
   stagger,
   transition,
   viewTransition
-} from "./chunk-WL7BIR6O.js";
-import "./chunk-WZG2SZOT.js";
-import "./chunk-TEFZT5PJ.js";
+} from "./chunk-IQJ36UTJ.js";
+import "./chunk-JCQG2I2G.js";
+import "./chunk-4NJEAPLI.js";
 import "./chunk-COY6PUD2.js";
 export {
   DOMPool,

package/dist/index.cjs

@@ -99,6 +99,7 @@ __export(index_exports, {
   footer: () => footer,
   form: () => form,
   g: () => g,
+  getAction: () => getAction,
   getRequestScopedCache: () => getRequestScopedCache,
   getSSRStore: () => getSSRStore,
   getSlot: () => getSlot,
@@ -167,6 +168,7 @@ __export(index_exports, {
   reactiveArray: () => reactiveArray,
   rect: () => rect,
   ref: () => ref,
+  registerAction: () => registerAction,
   registerComponent: () => registerComponent,
   registerDisposer: () => registerDisposer,
   resolveComponent: () => resolveComponent,
@@ -755,7 +757,7 @@ function forEachSubscriber(signal2, visit) {
 
 // src/reactivity/track.ts
 var _isDev3 = isDev();
-var _runtimeVersion = typeof __SIBU_VERSION__ !== "undefined" ? __SIBU_VERSION__ : "dev";
+var _runtimeVersion = true ? "3.3.2" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g2 = globalThis;
@@ -2329,7 +2331,21 @@ function KeepAlive(activeKey, cases, options) {
 }
 
 // src/core/rendering/action.ts
-function action(element, actionFn, param2) {
+var ACTIONS_KEY = /* @__PURE__ */ Symbol.for("sibujs.actions.v1");
+var _actions = globalThis[ACTIONS_KEY] ?? (globalThis[ACTIONS_KEY] = /* @__PURE__ */ new Map());
+function registerAction(name, fn) {
+  _actions.set(name, fn);
+}
+function getAction(name) {
+  return _actions.get(name);
+}
+function action(element, action2, param2) {
+  const actionFn = typeof action2 === "string" ? getAction(action2) : action2;
+  if (!actionFn) {
+    throw new Error(
+      `[SibuJS] No action registered under the name "${action2}". Register it with registerAction() before applying it by name.`
+    );
+  }
   const cleanup3 = actionFn(element, param2);
   if (typeof cleanup3 === "function") {
     registerDisposer(element, cleanup3);
@@ -2406,6 +2422,11 @@ var trapFocus = (element) => {
   element.addEventListener("keydown", handler);
   return () => element.removeEventListener("keydown", handler);
 };
+registerAction("clickOutside", clickOutside);
+registerAction("longPress", longPress);
+registerAction("copyOnClick", copyOnClick);
+registerAction("autoResize", autoResize);
+registerAction("trapFocus", trapFocus);
 
 // src/core/rendering/catch.ts
 var globalErrorHandler = null;
@@ -2454,13 +2475,14 @@ function setGlobalErrorHandler(handler) {
 }
 
 // src/core/rendering/createId.ts
-var idCounter = 0;
+var COUNTER_KEY = /* @__PURE__ */ Symbol.for("sibujs.createId.v1");
+var _counter = globalThis[COUNTER_KEY] ?? (globalThis[COUNTER_KEY] = { n: 0 });
 function createId(prefix = "sibu") {
-  idCounter++;
-  return `${prefix}-${idCounter}`;
+  _counter.n++;
+  return `${prefix}-${_counter.n}`;
 }
 function __resetIdCounter() {
-  idCounter = 0;
+  _counter.n = 0;
 }
 
 // src/reactivity/batch.ts
@@ -2584,23 +2606,29 @@ function signal(initial, options) {
 }
 
 // src/core/ssr-context.ts
-var als = null;
-try {
-  if (typeof process !== "undefined" && process.versions && process.versions.node) {
-    let mod = null;
-    const getBuiltin = process.getBuiltinModule;
-    if (typeof getBuiltin === "function") {
-      mod = getBuiltin("node:async_hooks");
-    } else {
-      const req = Function("return typeof require==='function'?require:null")();
-      if (req) mod = req("node:async_hooks");
+var SSR_KEY = /* @__PURE__ */ Symbol.for("sibujs.ssr.v1");
+function detectSSRShared() {
+  let detected = null;
+  try {
+    if (typeof process !== "undefined" && process.versions && process.versions.node) {
+      let mod = null;
+      const getBuiltin = process.getBuiltinModule;
+      if (typeof getBuiltin === "function") {
+        mod = getBuiltin("node:async_hooks");
+      } else {
+        const req = Function("return typeof require==='function'?require:null")();
+        if (req) mod = req("node:async_hooks");
+      }
+      if (mod) detected = new mod.AsyncLocalStorage();
     }
-    if (mod) als = new mod.AsyncLocalStorage();
+  } catch {
+    detected = null;
   }
-} catch {
-  als = null;
+  return { als: detected, fallbackStore: { ssr: false, suspenseIdCounter: 0 } };
 }
-var fallbackStore = { ssr: false, suspenseIdCounter: 0 };
+var _shared = globalThis[SSR_KEY] ?? (globalThis[SSR_KEY] = detectSSRShared());
+var als = _shared.als;
+var fallbackStore = _shared.fallbackStore;
 function getSSRStore() {
   if (als) {
     const s2 = als.getStore();
@@ -4724,6 +4752,7 @@ function Loading(props = {}) {
   footer,
   form,
   g,
+  getAction,
   getRequestScopedCache,
   getSSRStore,
   getSlot,
@@ -4792,6 +4821,7 @@ function Loading(props = {}) {
   reactiveArray,
   rect,
   ref,
+  registerAction,
   registerComponent,
   registerDisposer,
   resolveComponent,

package/dist/index.d.cts

@@ -525,29 +525,42 @@ declare function KeepAlive(activeKey: () => string, cases: Record<string, () =>
  * a cleanup function that runs when the element is disposed.
  */
 type ActionFn<T = void> = (element: HTMLElement, param: T) => (() => void) | undefined;
+/**
+ * Register a reusable action under a name so it can be applied by string —
+ * `action(el, "name", param)` — or looked up via {@link getAction}.
+ *
+ * Re-registering the same name overwrites the previous action. The built-in
+ * actions (`clickOutside`, `longPress`, `copyOnClick`, `autoResize`,
+ * `trapFocus`) are auto-registered under their export names.
+ */
+declare function registerAction<T>(name: string, fn: ActionFn<T>): void;
+/** Look up a registered action by name, or `undefined` if none is registered. */
+declare function getAction<T = unknown>(name: string): ActionFn<T> | undefined;
 /**
  * Attach a reusable action (element-level behavior) to an element.
  * The action's cleanup function (if returned) is automatically registered
  * via `registerDisposer`, so it runs when the element is disposed.
  *
- * Actions are composable — multiple can be applied to the same element.
+ * The action may be passed directly, or by the name it was registered under
+ * (see {@link registerAction}). Actions are composable — multiple can be
+ * applied to the same element.
  *
  * @param element The target element
- * @param actionFn The action function
+ * @param action The action function, or the name of a registered action
  * @param param Optional parameter passed to the action
  *
  * @example
  * ```ts
  * div({
  *   onElement: (el) => {
- *     action(el, clickOutside, () => setOpen(false));
- *     action(el, longPress, { duration: 500, callback: onLongPress });
+ *     action(el, clickOutside, () => setOpen(false));     // by reference
+ *     action(el, "longPress", { duration: 500, callback: onLongPress }); // by name
  *   },
  * }, "Content");
  * ```
  */
-declare function action<T>(element: HTMLElement, actionFn: ActionFn<T>, param: T): void;
-declare function action(element: HTMLElement, actionFn: ActionFn<void>): void;
+declare function action<T>(element: HTMLElement, action: ActionFn<T> | string, param: T): void;
+declare function action(element: HTMLElement, action: ActionFn<void> | string): void;
 /**
  * Fires a callback when the user clicks outside the element.
  * Useful for closing dropdowns, modals, and popovers.
@@ -1615,4 +1628,4 @@ interface LoadingProps {
  */
 declare function Loading(props?: LoadingProps): HTMLElement;
 
-export { type Accessor, type ActionFn, type AnchorProps, type ArrayActions, type AsyncDerivedState, type AudioProps, type ButtonProps, type Context, DynamicComponent, type EffectBody, type EffectOptions, ErrorBoundary, type ErrorBoundaryOptions, type ErrorBoundaryProps, ErrorDisplay, type ErrorDisplayProps, type ErrorSeverity, type FormProps, Fragment, type ImgProps, type InputProps, type InputType, KeepAlive, type KeepAliveOptions, type LabelProps, Loading, type LoadingProps, type LongPressOptions, type MediaProps, NodeChild, NodeChildren, type OnCleanup, type OptionProps, Portal, type Ref, type SSRStore, type SelectProps, type SignalOptions, type SlotFn, type Slots, type StoreActions, Suspense, type SuspenseProps, TagProps, type TextareaProps, type TypedTagFunction, type VideoProps, __resetIdCounter, a, abbr, action, address, area, array, article, aside, asyncDerived, audio, autoResize, b, base, batch, bdi, bdo, bindDynamic, blockquote, body, br, button, canvas, caption, catchError, catchErrorAsync, center, checkLeaks, circle, cite, clickOutside, clipPath, code, col, colgroup, context, copyOnClick, createId, customElement, data, datalist, dd, deepEqual, deepSignal, defer, defs, del, derived, details, dfn, dialog, disableSSR, dispose, div, dl, dt, each, effect, ellipse, em, embed, enableSSR, enqueueBatchedSignal, fieldset, figcaption, figure, font, footer, form, g, getRequestScopedCache, getSSRStore, getSlot, h1, h2, h3, h4, h5, h6, head, header, hr, html, i, iframe, img, input, ins, isBatching, isSSR, kbd, label, lazy, legend, li, line, linearGradient, link, longPress, main, map, mark, marker, marquee, mask, match, math, menu, meta, meter, mount, nav, nextTick, noscript, object, ol, on, onCleanup, onMount, onUnmount, optgroup, option, output, p, param, path, pattern, picture, polygon, polyline, portal, pre, progress, q, radialGradient, reactiveArray, rect, ref, registerComponent, registerDisposer, resolveComponent, retrack, rp, rt, ruby, runInSSRContext, s, samp, script, section, select, setGlobalErrorHandler, setMaxDrainIterations, show, signal, slot, small, source, span, stop, store, strict, strictEffect, strong, style, sub, summary, sup, svg, symbol, table, takePendingError, tbody, td, template, text, textarea, tfoot, th, thead, time, title, tr, track$1 as track, transition, trapFocus, tspan, u, ul, unregisterComponent, untracked, use, var_, video, watch, when, withSSR, writable };
+export { type Accessor, type ActionFn, type AnchorProps, type ArrayActions, type AsyncDerivedState, type AudioProps, type ButtonProps, type Context, DynamicComponent, type EffectBody, type EffectOptions, ErrorBoundary, type ErrorBoundaryOptions, type ErrorBoundaryProps, ErrorDisplay, type ErrorDisplayProps, type ErrorSeverity, type FormProps, Fragment, type ImgProps, type InputProps, type InputType, KeepAlive, type KeepAliveOptions, type LabelProps, Loading, type LoadingProps, type LongPressOptions, type MediaProps, NodeChild, NodeChildren, type OnCleanup, type OptionProps, Portal, type Ref, type SSRStore, type SelectProps, type SignalOptions, type SlotFn, type Slots, type StoreActions, Suspense, type SuspenseProps, TagProps, type TextareaProps, type TypedTagFunction, type VideoProps, __resetIdCounter, a, abbr, action, address, area, array, article, aside, asyncDerived, audio, autoResize, b, base, batch, bdi, bdo, bindDynamic, blockquote, body, br, button, canvas, caption, catchError, catchErrorAsync, center, checkLeaks, circle, cite, clickOutside, clipPath, code, col, colgroup, context, copyOnClick, createId, customElement, data, datalist, dd, deepEqual, deepSignal, defer, defs, del, derived, details, dfn, dialog, disableSSR, dispose, div, dl, dt, each, effect, ellipse, em, embed, enableSSR, enqueueBatchedSignal, fieldset, figcaption, figure, font, footer, form, g, getAction, getRequestScopedCache, getSSRStore, getSlot, h1, h2, h3, h4, h5, h6, head, header, hr, html, i, iframe, img, input, ins, isBatching, isSSR, kbd, label, lazy, legend, li, line, linearGradient, link, longPress, main, map, mark, marker, marquee, mask, match, math, menu, meta, meter, mount, nav, nextTick, noscript, object, ol, on, onCleanup, onMount, onUnmount, optgroup, option, output, p, param, path, pattern, picture, polygon, polyline, portal, pre, progress, q, radialGradient, reactiveArray, rect, ref, registerAction, registerComponent, registerDisposer, resolveComponent, retrack, rp, rt, ruby, runInSSRContext, s, samp, script, section, select, setGlobalErrorHandler, setMaxDrainIterations, show, signal, slot, small, source, span, stop, store, strict, strictEffect, strong, style, sub, summary, sup, svg, symbol, table, takePendingError, tbody, td, template, text, textarea, tfoot, th, thead, time, title, tr, track$1 as track, transition, trapFocus, tspan, u, ul, unregisterComponent, untracked, use, var_, video, watch, when, withSSR, writable };

package/dist/index.d.ts

@@ -525,29 +525,42 @@ declare function KeepAlive(activeKey: () => string, cases: Record<string, () =>
  * a cleanup function that runs when the element is disposed.
  */
 type ActionFn<T = void> = (element: HTMLElement, param: T) => (() => void) | undefined;
+/**
+ * Register a reusable action under a name so it can be applied by string —
+ * `action(el, "name", param)` — or looked up via {@link getAction}.
+ *
+ * Re-registering the same name overwrites the previous action. The built-in
+ * actions (`clickOutside`, `longPress`, `copyOnClick`, `autoResize`,
+ * `trapFocus`) are auto-registered under their export names.
+ */
+declare function registerAction<T>(name: string, fn: ActionFn<T>): void;
+/** Look up a registered action by name, or `undefined` if none is registered. */
+declare function getAction<T = unknown>(name: string): ActionFn<T> | undefined;
 /**
  * Attach a reusable action (element-level behavior) to an element.
  * The action's cleanup function (if returned) is automatically registered
  * via `registerDisposer`, so it runs when the element is disposed.
  *
- * Actions are composable — multiple can be applied to the same element.
+ * The action may be passed directly, or by the name it was registered under
+ * (see {@link registerAction}). Actions are composable — multiple can be
+ * applied to the same element.
  *
  * @param element The target element
- * @param actionFn The action function
+ * @param action The action function, or the name of a registered action
  * @param param Optional parameter passed to the action
  *
  * @example
  * ```ts
  * div({
  *   onElement: (el) => {
- *     action(el, clickOutside, () => setOpen(false));
- *     action(el, longPress, { duration: 500, callback: onLongPress });
+ *     action(el, clickOutside, () => setOpen(false));     // by reference
+ *     action(el, "longPress", { duration: 500, callback: onLongPress }); // by name
  *   },
  * }, "Content");
  * ```
  */
-declare function action<T>(element: HTMLElement, actionFn: ActionFn<T>, param: T): void;
-declare function action(element: HTMLElement, actionFn: ActionFn<void>): void;
+declare function action<T>(element: HTMLElement, action: ActionFn<T> | string, param: T): void;
+declare function action(element: HTMLElement, action: ActionFn<void> | string): void;
 /**
  * Fires a callback when the user clicks outside the element.
  * Useful for closing dropdowns, modals, and popovers.
@@ -1615,4 +1628,4 @@ interface LoadingProps {
  */
 declare function Loading(props?: LoadingProps): HTMLElement;
 
-export { type Accessor, type ActionFn, type AnchorProps, type ArrayActions, type AsyncDerivedState, type AudioProps, type ButtonProps, type Context, DynamicComponent, type EffectBody, type EffectOptions, ErrorBoundary, type ErrorBoundaryOptions, type ErrorBoundaryProps, ErrorDisplay, type ErrorDisplayProps, type ErrorSeverity, type FormProps, Fragment, type ImgProps, type InputProps, type InputType, KeepAlive, type KeepAliveOptions, type LabelProps, Loading, type LoadingProps, type LongPressOptions, type MediaProps, NodeChild, NodeChildren, type OnCleanup, type OptionProps, Portal, type Ref, type SSRStore, type SelectProps, type SignalOptions, type SlotFn, type Slots, type StoreActions, Suspense, type SuspenseProps, TagProps, type TextareaProps, type TypedTagFunction, type VideoProps, __resetIdCounter, a, abbr, action, address, area, array, article, aside, asyncDerived, audio, autoResize, b, base, batch, bdi, bdo, bindDynamic, blockquote, body, br, button, canvas, caption, catchError, catchErrorAsync, center, checkLeaks, circle, cite, clickOutside, clipPath, code, col, colgroup, context, copyOnClick, createId, customElement, data, datalist, dd, deepEqual, deepSignal, defer, defs, del, derived, details, dfn, dialog, disableSSR, dispose, div, dl, dt, each, effect, ellipse, em, embed, enableSSR, enqueueBatchedSignal, fieldset, figcaption, figure, font, footer, form, g, getRequestScopedCache, getSSRStore, getSlot, h1, h2, h3, h4, h5, h6, head, header, hr, html, i, iframe, img, input, ins, isBatching, isSSR, kbd, label, lazy, legend, li, line, linearGradient, link, longPress, main, map, mark, marker, marquee, mask, match, math, menu, meta, meter, mount, nav, nextTick, noscript, object, ol, on, onCleanup, onMount, onUnmount, optgroup, option, output, p, param, path, pattern, picture, polygon, polyline, portal, pre, progress, q, radialGradient, reactiveArray, rect, ref, registerComponent, registerDisposer, resolveComponent, retrack, rp, rt, ruby, runInSSRContext, s, samp, script, section, select, setGlobalErrorHandler, setMaxDrainIterations, show, signal, slot, small, source, span, stop, store, strict, strictEffect, strong, style, sub, summary, sup, svg, symbol, table, takePendingError, tbody, td, template, text, textarea, tfoot, th, thead, time, title, tr, track$1 as track, transition, trapFocus, tspan, u, ul, unregisterComponent, untracked, use, var_, video, watch, when, withSSR, writable };
+export { type Accessor, type ActionFn, type AnchorProps, type ArrayActions, type AsyncDerivedState, type AudioProps, type ButtonProps, type Context, DynamicComponent, type EffectBody, type EffectOptions, ErrorBoundary, type ErrorBoundaryOptions, type ErrorBoundaryProps, ErrorDisplay, type ErrorDisplayProps, type ErrorSeverity, type FormProps, Fragment, type ImgProps, type InputProps, type InputType, KeepAlive, type KeepAliveOptions, type LabelProps, Loading, type LoadingProps, type LongPressOptions, type MediaProps, NodeChild, NodeChildren, type OnCleanup, type OptionProps, Portal, type Ref, type SSRStore, type SelectProps, type SignalOptions, type SlotFn, type Slots, type StoreActions, Suspense, type SuspenseProps, TagProps, type TextareaProps, type TypedTagFunction, type VideoProps, __resetIdCounter, a, abbr, action, address, area, array, article, aside, asyncDerived, audio, autoResize, b, base, batch, bdi, bdo, bindDynamic, blockquote, body, br, button, canvas, caption, catchError, catchErrorAsync, center, checkLeaks, circle, cite, clickOutside, clipPath, code, col, colgroup, context, copyOnClick, createId, customElement, data, datalist, dd, deepEqual, deepSignal, defer, defs, del, derived, details, dfn, dialog, disableSSR, dispose, div, dl, dt, each, effect, ellipse, em, embed, enableSSR, enqueueBatchedSignal, fieldset, figcaption, figure, font, footer, form, g, getAction, getRequestScopedCache, getSSRStore, getSlot, h1, h2, h3, h4, h5, h6, head, header, hr, html, i, iframe, img, input, ins, isBatching, isSSR, kbd, label, lazy, legend, li, line, linearGradient, link, longPress, main, map, mark, marker, marquee, mask, match, math, menu, meta, meter, mount, nav, nextTick, noscript, object, ol, on, onCleanup, onMount, onUnmount, optgroup, option, output, p, param, path, pattern, picture, polygon, polyline, portal, pre, progress, q, radialGradient, reactiveArray, rect, ref, registerAction, registerComponent, registerDisposer, resolveComponent, retrack, rp, rt, ruby, runInSSRContext, s, samp, script, section, select, setGlobalErrorHandler, setMaxDrainIterations, show, signal, slot, small, source, span, stop, store, strict, strictEffect, strong, style, sub, summary, sup, svg, symbol, table, takePendingError, tbody, td, template, text, textarea, tfoot, th, thead, time, title, tr, track$1 as track, transition, trapFocus, tspan, u, ul, unregisterComponent, untracked, use, var_, video, watch, when, withSSR, writable };