sibujs 1.0.7 → 1.0.8

package/dist/customElement-D2DJp_xn.d.cts

@@ -0,0 +1,313 @@
+type ValidatorFn<T = unknown> = (value: T) => string | null;
+interface FieldConfig<T = unknown> {
+    initial: T;
+    validators?: ValidatorFn<T>[];
+}
+type FormConfig<T extends Record<string, unknown>> = {
+    [K in keyof T]: FieldConfig<T[K]>;
+};
+interface FormField<T = unknown> {
+    value: () => T;
+    set: (v: T) => void;
+    error: () => string | null;
+    touched: () => boolean;
+    touch: () => void;
+    reset: () => void;
+}
+interface FormReturn<T extends Record<string, unknown>> {
+    fields: {
+        [K in keyof T]: FormField<T[K]>;
+    };
+    errors: () => Partial<Record<keyof T, string | null>>;
+    isValid: () => boolean;
+    isDirty: () => boolean;
+    touched: () => Partial<Record<keyof T, boolean>>;
+    values: () => T;
+    handleSubmit: (onSubmit: (values: T) => void | Promise<void>) => (e?: Event) => void;
+    reset: () => void;
+    setError: (field: keyof T, message: string) => void;
+}
+declare function required(message?: string): ValidatorFn<unknown>;
+declare function minLength(min: number, message?: string): ValidatorFn<string>;
+declare function maxLength(max: number, message?: string): ValidatorFn<string>;
+declare function matchesPattern(regex: RegExp, message?: string): ValidatorFn<string>;
+declare function email(message?: string): ValidatorFn<string>;
+declare function min(minVal: number, message?: string): ValidatorFn<number>;
+declare function max(maxVal: number, message?: string): ValidatorFn<number>;
+declare function custom<T>(fn: (value: T) => boolean, message: string): ValidatorFn<T>;
+/**
+ * Props returned by bindField, ready to spread into an input tag factory.
+ */
+interface BoundFieldProps {
+    value: () => unknown;
+    on: {
+        input: (e: Event) => void;
+        change: (e: Event) => void;
+        blur: () => void;
+    };
+    [attr: string]: unknown;
+}
+/**
+ * Bind a FormField to an input element, eliminating the value/input/blur boilerplate.
+ *
+ * Works with text inputs (`input` event) and selects/checkboxes (`change` event).
+ *
+ * @param field A FormField from form().fields
+ * @param extras Additional props to merge (placeholder, class, disabled, etc.)
+ * @returns Props object ready to pass directly to a tag factory
+ *
+ * @example
+ * ```ts
+ * const f = form({ email: { initial: "", validators: [required(), email()] } });
+ *
+ * // Before — verbose
+ * input({ value: f.fields.email.value(), on: { input: e => f.fields.email.set(e.target.value), blur: () => f.fields.email.touch() } })
+ *
+ * // After — one-liner
+ * input(bindField(f.fields.email, { type: "email", placeholder: "Email" }))
+ * ```
+ */
+declare function bindField<T>(field: FormField<T>, extras?: Record<string, unknown>): BoundFieldProps;
+declare function form<T extends Record<string, unknown>>(config: FormConfig<T>): FormReturn<T>;
+
+interface VirtualListProps<T> {
+    items: () => T[];
+    itemHeight: number;
+    containerHeight: number;
+    overscan?: number;
+    renderItem: (item: T, index: number) => HTMLElement;
+    class?: string;
+}
+/**
+ * VirtualList renders only visible items for efficient large-list rendering.
+ */
+declare function VirtualList<T>(props: VirtualListProps<T>): HTMLElement;
+
+interface IntersectionResult {
+    isIntersecting: () => boolean;
+    intersectionRatio: () => number;
+    observe: (element: HTMLElement) => void;
+    unobserve: () => void;
+}
+/**
+ * intersection provides reactive intersection observer state.
+ */
+declare function intersection(options?: IntersectionObserverInit): IntersectionResult;
+/**
+ * Lazy-load utility using IntersectionObserver.
+ * Calls the loader function when element becomes visible.
+ */
+declare function lazyLoad(element: HTMLElement, loader: () => void, options?: IntersectionObserverInit): () => void;
+
+interface MaskOptions {
+    /** Pattern: 9 = digit, A = letter, * = any, other chars are literals */
+    pattern: string;
+    /** Placeholder character for unfilled positions */
+    placeholder?: string;
+}
+/**
+ * inputMask applies a mask to an input element.
+ * Returns reactive value and ref binding.
+ */
+declare function inputMask(options: MaskOptions): {
+    value: () => string;
+    rawValue: () => string;
+    bind: (input: HTMLInputElement) => void;
+};
+/** Phone number mask: (999) 999-9999 */
+declare function phoneMask(): MaskOptions;
+/** Date mask: 99/99/9999 */
+declare function dateMask(): MaskOptions;
+/** Credit card mask: 9999 9999 9999 9999 */
+declare function creditCardMask(): MaskOptions;
+/** Time mask: 99:99 */
+declare function timeMask(): MaskOptions;
+/** SSN mask: 999-99-9999 */
+declare function ssnMask(): MaskOptions;
+/** ZIP code mask: 99999 */
+declare function zipMask(): MaskOptions;
+
+/**
+ * aria applies reactive ARIA attributes to an element.
+ */
+declare function aria(element: HTMLElement, attrs: Record<string, string | boolean | (() => string | boolean)>): void;
+/**
+ * focus manages focus state for an element.
+ */
+declare function focus(): {
+    isFocused: () => boolean;
+    focus: () => void;
+    blur: () => void;
+    bind: (element: HTMLElement) => void;
+};
+/**
+ * FocusTrap traps focus within a container element.
+ * Tab cycling stays inside the container.
+ */
+declare function FocusTrap(nodes: HTMLElement, options?: {
+    autoFocus?: boolean;
+    restoreFocus?: boolean;
+}): HTMLElement;
+/**
+ * hotkey registers a keyboard shortcut handler.
+ * Returns a cleanup function.
+ *
+ * Supports two calling styles:
+ * - String combo:   hotkey("ctrl+shift+z", handler)
+ * - Explicit flags: hotkey("z", handler, { ctrl: true, shift: true })
+ */
+declare function hotkey(combo: string, handler: (e: KeyboardEvent) => void, options?: {
+    ctrl?: boolean;
+    shift?: boolean;
+    alt?: boolean;
+    meta?: boolean;
+    global?: boolean;
+    preventDefault?: boolean;
+}): () => void;
+/**
+ * announce creates a screen reader announcement using ARIA live regions.
+ */
+declare function announce(message: string, priority?: "polite" | "assertive"): void;
+
+/**
+ * scopedStyle creates component-scoped CSS by generating a unique scope ID
+ * and prefixing all selectors.
+ * Returns the scope attribute name and injects the CSS into the document.
+ *
+ * CSS is sanitized to remove dangerous patterns (`url()`, `@import`,
+ * `expression()`, `-moz-binding`, `behavior`). If you need `url()` for
+ * background images, use inline styles via the `style` prop instead.
+ */
+declare function scopedStyle(css: string): {
+    scope: string;
+    attr: string;
+};
+/**
+ * withScopedStyle wraps a component function to auto-apply scoped styles.
+ * The component and all its children get the scope attribute.
+ */
+declare function withScopedStyle<P>(css: string, component: (props: P) => HTMLElement): (props: P) => HTMLElement;
+/**
+ * Removes a scoped style by its scope ID.
+ */
+declare function removeScopedStyle(scopeId: string): void;
+
+/**
+ * Bind multiple reactive attributes to an element.
+ * Each attribute value can be a static value or a reactive getter.
+ * Returns a single teardown function that stops all bindings.
+ */
+declare function bindAttrs(el: HTMLElement, attrs: Record<string, string | number | boolean | (() => string | number | boolean)>): () => void;
+/**
+ * Reactively toggle a boolean attribute (like disabled, readonly, hidden).
+ * When the value is truthy the attribute is present (set to ""),
+ * when falsy the attribute is removed entirely.
+ * Returns a teardown function to stop reactive tracking.
+ */
+declare function bindBoolAttr(el: HTMLElement, attr: string, getter: boolean | (() => boolean)): () => void;
+/**
+ * Bind a data-* attribute reactively.
+ * Shorthand for `bindAttribute(el, "data-<key>", getter)`.
+ * Returns a teardown function to stop reactive tracking.
+ */
+declare function bindData(el: HTMLElement, key: string, getter: string | (() => string)): () => void;
+
+/**
+ * dialog provides reactive dialog state management with escape-to-close support.
+ */
+declare function dialog(): {
+    open: () => void;
+    close: () => void;
+    isOpen: () => boolean;
+    toggle: () => void;
+};
+
+/**
+ * Toast notification system with auto-dismiss and max toast limits.
+ */
+interface Toast {
+    id: string;
+    message: string;
+    type?: "info" | "success" | "error" | "warning";
+}
+interface ToastInstance {
+    toasts: () => Toast[];
+    show: (message: string, type?: Toast["type"]) => string;
+    /** Show an info toast. */
+    info: (message: string) => string;
+    /** Show a success toast. */
+    success: (message: string) => string;
+    /** Show an error toast. */
+    error: (message: string) => string;
+    /** Show a warning toast. */
+    warning: (message: string) => string;
+    dismiss: (id: string) => void;
+    dismissAll: () => void;
+}
+declare function toast(options?: {
+    duration?: number;
+    maxToasts?: number;
+}): ToastInstance;
+
+/**
+ * infiniteScroll combines IntersectionObserver with a data-fetching trigger
+ * to implement infinite scroll behavior.
+ */
+declare function infiniteScroll(options: {
+    onLoadMore: () => Promise<void>;
+    hasMore: () => boolean;
+    threshold?: number;
+}): {
+    sentinelRef: {
+        current: HTMLElement | null;
+    };
+    loading: () => boolean;
+    dispose: () => void;
+};
+
+/**
+ * pagination provides reactive pagination state and controls.
+ */
+declare function pagination(options: {
+    totalItems: () => number;
+    pageSize?: number;
+    initialPage?: number;
+}): {
+    page: () => number;
+    pageSize: () => number;
+    totalPages: () => number;
+    next: () => void;
+    prev: () => void;
+    goTo: (page: number) => void;
+    startIndex: () => number;
+    endIndex: () => number;
+};
+
+/**
+ * eventBus creates a typed publish/subscribe event system.
+ * No reactive state needed -- pure event dispatching.
+ */
+declare function eventBus<T extends Record<string, unknown>>(): {
+    on: <K extends keyof T>(event: K, handler: (data: T[K]) => void) => () => void;
+    emit: <K extends keyof T>(event: K, data: T[K]) => void;
+    off: <K extends keyof T>(event: K, handler: (data: T[K]) => void) => void;
+    clear: () => void;
+};
+
+interface CustomElementOptions {
+    shadow?: boolean;
+    mode?: "open" | "closed";
+    styles?: string;
+    observedAttributes?: string[];
+    extends?: string;
+}
+/**
+ * defineElement creates a Web Component wrapping a SibuJS component function.
+ */
+declare function defineElement(name: string, component: (props: Record<string, unknown>, element: HTMLElement) => HTMLElement, options?: CustomElementOptions): void;
+/**
+ * Creates an SVG element with proper namespace.
+ */
+declare function svgElement(tag: string, props?: Record<string, unknown>, ...nodes: (SVGElement | string)[]): SVGElement;
+
+export { lazyLoad as A, type BoundFieldProps as B, type CustomElementOptions as C, matchesPattern as D, max as E, type FieldConfig as F, maxLength as G, min as H, type IntersectionResult as I, minLength as J, pagination as K, phoneMask as L, type MaskOptions as M, removeScopedStyle as N, required as O, scopedStyle as P, ssnMask as Q, svgElement as R, timeMask as S, type Toast as T, toast as U, type ValidatorFn as V, withScopedStyle as W, zipMask as X, FocusTrap as a, type FormConfig as b, type FormField as c, type FormReturn as d, type ToastInstance as e, VirtualList as f, type VirtualListProps as g, announce as h, aria as i, bindAttrs as j, bindBoolAttr as k, bindData as l, bindField as m, creditCardMask as n, custom as o, dateMask as p, defineElement as q, dialog as r, email as s, eventBus as t, focus as u, form as v, hotkey as w, infiniteScroll as x, inputMask as y, intersection as z };

package/dist/customElement-D2DJp_xn.d.ts

@@ -0,0 +1,313 @@
+type ValidatorFn<T = unknown> = (value: T) => string | null;
+interface FieldConfig<T = unknown> {
+    initial: T;
+    validators?: ValidatorFn<T>[];
+}
+type FormConfig<T extends Record<string, unknown>> = {
+    [K in keyof T]: FieldConfig<T[K]>;
+};
+interface FormField<T = unknown> {
+    value: () => T;
+    set: (v: T) => void;
+    error: () => string | null;
+    touched: () => boolean;
+    touch: () => void;
+    reset: () => void;
+}
+interface FormReturn<T extends Record<string, unknown>> {
+    fields: {
+        [K in keyof T]: FormField<T[K]>;
+    };
+    errors: () => Partial<Record<keyof T, string | null>>;
+    isValid: () => boolean;
+    isDirty: () => boolean;
+    touched: () => Partial<Record<keyof T, boolean>>;
+    values: () => T;
+    handleSubmit: (onSubmit: (values: T) => void | Promise<void>) => (e?: Event) => void;
+    reset: () => void;
+    setError: (field: keyof T, message: string) => void;
+}
+declare function required(message?: string): ValidatorFn<unknown>;
+declare function minLength(min: number, message?: string): ValidatorFn<string>;
+declare function maxLength(max: number, message?: string): ValidatorFn<string>;
+declare function matchesPattern(regex: RegExp, message?: string): ValidatorFn<string>;
+declare function email(message?: string): ValidatorFn<string>;
+declare function min(minVal: number, message?: string): ValidatorFn<number>;
+declare function max(maxVal: number, message?: string): ValidatorFn<number>;
+declare function custom<T>(fn: (value: T) => boolean, message: string): ValidatorFn<T>;
+/**
+ * Props returned by bindField, ready to spread into an input tag factory.
+ */
+interface BoundFieldProps {
+    value: () => unknown;
+    on: {
+        input: (e: Event) => void;
+        change: (e: Event) => void;
+        blur: () => void;
+    };
+    [attr: string]: unknown;
+}
+/**
+ * Bind a FormField to an input element, eliminating the value/input/blur boilerplate.
+ *
+ * Works with text inputs (`input` event) and selects/checkboxes (`change` event).
+ *
+ * @param field A FormField from form().fields
+ * @param extras Additional props to merge (placeholder, class, disabled, etc.)
+ * @returns Props object ready to pass directly to a tag factory
+ *
+ * @example
+ * ```ts
+ * const f = form({ email: { initial: "", validators: [required(), email()] } });
+ *
+ * // Before — verbose
+ * input({ value: f.fields.email.value(), on: { input: e => f.fields.email.set(e.target.value), blur: () => f.fields.email.touch() } })
+ *
+ * // After — one-liner
+ * input(bindField(f.fields.email, { type: "email", placeholder: "Email" }))
+ * ```
+ */
+declare function bindField<T>(field: FormField<T>, extras?: Record<string, unknown>): BoundFieldProps;
+declare function form<T extends Record<string, unknown>>(config: FormConfig<T>): FormReturn<T>;
+
+interface VirtualListProps<T> {
+    items: () => T[];
+    itemHeight: number;
+    containerHeight: number;
+    overscan?: number;
+    renderItem: (item: T, index: number) => HTMLElement;
+    class?: string;
+}
+/**
+ * VirtualList renders only visible items for efficient large-list rendering.
+ */
+declare function VirtualList<T>(props: VirtualListProps<T>): HTMLElement;
+
+interface IntersectionResult {
+    isIntersecting: () => boolean;
+    intersectionRatio: () => number;
+    observe: (element: HTMLElement) => void;
+    unobserve: () => void;
+}
+/**
+ * intersection provides reactive intersection observer state.
+ */
+declare function intersection(options?: IntersectionObserverInit): IntersectionResult;
+/**
+ * Lazy-load utility using IntersectionObserver.
+ * Calls the loader function when element becomes visible.
+ */
+declare function lazyLoad(element: HTMLElement, loader: () => void, options?: IntersectionObserverInit): () => void;
+
+interface MaskOptions {
+    /** Pattern: 9 = digit, A = letter, * = any, other chars are literals */
+    pattern: string;
+    /** Placeholder character for unfilled positions */
+    placeholder?: string;
+}
+/**
+ * inputMask applies a mask to an input element.
+ * Returns reactive value and ref binding.
+ */
+declare function inputMask(options: MaskOptions): {
+    value: () => string;
+    rawValue: () => string;
+    bind: (input: HTMLInputElement) => void;
+};
+/** Phone number mask: (999) 999-9999 */
+declare function phoneMask(): MaskOptions;
+/** Date mask: 99/99/9999 */
+declare function dateMask(): MaskOptions;
+/** Credit card mask: 9999 9999 9999 9999 */
+declare function creditCardMask(): MaskOptions;
+/** Time mask: 99:99 */
+declare function timeMask(): MaskOptions;
+/** SSN mask: 999-99-9999 */
+declare function ssnMask(): MaskOptions;
+/** ZIP code mask: 99999 */
+declare function zipMask(): MaskOptions;
+
+/**
+ * aria applies reactive ARIA attributes to an element.
+ */
+declare function aria(element: HTMLElement, attrs: Record<string, string | boolean | (() => string | boolean)>): void;
+/**
+ * focus manages focus state for an element.
+ */
+declare function focus(): {
+    isFocused: () => boolean;
+    focus: () => void;
+    blur: () => void;
+    bind: (element: HTMLElement) => void;
+};
+/**
+ * FocusTrap traps focus within a container element.
+ * Tab cycling stays inside the container.
+ */
+declare function FocusTrap(nodes: HTMLElement, options?: {
+    autoFocus?: boolean;
+    restoreFocus?: boolean;
+}): HTMLElement;
+/**
+ * hotkey registers a keyboard shortcut handler.
+ * Returns a cleanup function.
+ *
+ * Supports two calling styles:
+ * - String combo:   hotkey("ctrl+shift+z", handler)
+ * - Explicit flags: hotkey("z", handler, { ctrl: true, shift: true })
+ */
+declare function hotkey(combo: string, handler: (e: KeyboardEvent) => void, options?: {
+    ctrl?: boolean;
+    shift?: boolean;
+    alt?: boolean;
+    meta?: boolean;
+    global?: boolean;
+    preventDefault?: boolean;
+}): () => void;
+/**
+ * announce creates a screen reader announcement using ARIA live regions.
+ */
+declare function announce(message: string, priority?: "polite" | "assertive"): void;
+
+/**
+ * scopedStyle creates component-scoped CSS by generating a unique scope ID
+ * and prefixing all selectors.
+ * Returns the scope attribute name and injects the CSS into the document.
+ *
+ * CSS is sanitized to remove dangerous patterns (`url()`, `@import`,
+ * `expression()`, `-moz-binding`, `behavior`). If you need `url()` for
+ * background images, use inline styles via the `style` prop instead.
+ */
+declare function scopedStyle(css: string): {
+    scope: string;
+    attr: string;
+};
+/**
+ * withScopedStyle wraps a component function to auto-apply scoped styles.
+ * The component and all its children get the scope attribute.
+ */
+declare function withScopedStyle<P>(css: string, component: (props: P) => HTMLElement): (props: P) => HTMLElement;
+/**
+ * Removes a scoped style by its scope ID.
+ */
+declare function removeScopedStyle(scopeId: string): void;
+
+/**
+ * Bind multiple reactive attributes to an element.
+ * Each attribute value can be a static value or a reactive getter.
+ * Returns a single teardown function that stops all bindings.
+ */
+declare function bindAttrs(el: HTMLElement, attrs: Record<string, string | number | boolean | (() => string | number | boolean)>): () => void;
+/**
+ * Reactively toggle a boolean attribute (like disabled, readonly, hidden).
+ * When the value is truthy the attribute is present (set to ""),
+ * when falsy the attribute is removed entirely.
+ * Returns a teardown function to stop reactive tracking.
+ */
+declare function bindBoolAttr(el: HTMLElement, attr: string, getter: boolean | (() => boolean)): () => void;
+/**
+ * Bind a data-* attribute reactively.
+ * Shorthand for `bindAttribute(el, "data-<key>", getter)`.
+ * Returns a teardown function to stop reactive tracking.
+ */
+declare function bindData(el: HTMLElement, key: string, getter: string | (() => string)): () => void;
+
+/**
+ * dialog provides reactive dialog state management with escape-to-close support.
+ */
+declare function dialog(): {
+    open: () => void;
+    close: () => void;
+    isOpen: () => boolean;
+    toggle: () => void;
+};
+
+/**
+ * Toast notification system with auto-dismiss and max toast limits.
+ */
+interface Toast {
+    id: string;
+    message: string;
+    type?: "info" | "success" | "error" | "warning";
+}
+interface ToastInstance {
+    toasts: () => Toast[];
+    show: (message: string, type?: Toast["type"]) => string;
+    /** Show an info toast. */
+    info: (message: string) => string;
+    /** Show a success toast. */
+    success: (message: string) => string;
+    /** Show an error toast. */
+    error: (message: string) => string;
+    /** Show a warning toast. */
+    warning: (message: string) => string;
+    dismiss: (id: string) => void;
+    dismissAll: () => void;
+}
+declare function toast(options?: {
+    duration?: number;
+    maxToasts?: number;
+}): ToastInstance;
+
+/**
+ * infiniteScroll combines IntersectionObserver with a data-fetching trigger
+ * to implement infinite scroll behavior.
+ */
+declare function infiniteScroll(options: {
+    onLoadMore: () => Promise<void>;
+    hasMore: () => boolean;
+    threshold?: number;
+}): {
+    sentinelRef: {
+        current: HTMLElement | null;
+    };
+    loading: () => boolean;
+    dispose: () => void;
+};
+
+/**
+ * pagination provides reactive pagination state and controls.
+ */
+declare function pagination(options: {
+    totalItems: () => number;
+    pageSize?: number;
+    initialPage?: number;
+}): {
+    page: () => number;
+    pageSize: () => number;
+    totalPages: () => number;
+    next: () => void;
+    prev: () => void;
+    goTo: (page: number) => void;
+    startIndex: () => number;
+    endIndex: () => number;
+};
+
+/**
+ * eventBus creates a typed publish/subscribe event system.
+ * No reactive state needed -- pure event dispatching.
+ */
+declare function eventBus<T extends Record<string, unknown>>(): {
+    on: <K extends keyof T>(event: K, handler: (data: T[K]) => void) => () => void;
+    emit: <K extends keyof T>(event: K, data: T[K]) => void;
+    off: <K extends keyof T>(event: K, handler: (data: T[K]) => void) => void;
+    clear: () => void;
+};
+
+interface CustomElementOptions {
+    shadow?: boolean;
+    mode?: "open" | "closed";
+    styles?: string;
+    observedAttributes?: string[];
+    extends?: string;
+}
+/**
+ * defineElement creates a Web Component wrapping a SibuJS component function.
+ */
+declare function defineElement(name: string, component: (props: Record<string, unknown>, element: HTMLElement) => HTMLElement, options?: CustomElementOptions): void;
+/**
+ * Creates an SVG element with proper namespace.
+ */
+declare function svgElement(tag: string, props?: Record<string, unknown>, ...nodes: (SVGElement | string)[]): SVGElement;
+
+export { lazyLoad as A, type BoundFieldProps as B, type CustomElementOptions as C, matchesPattern as D, max as E, type FieldConfig as F, maxLength as G, min as H, type IntersectionResult as I, minLength as J, pagination as K, phoneMask as L, type MaskOptions as M, removeScopedStyle as N, required as O, scopedStyle as P, ssnMask as Q, svgElement as R, timeMask as S, type Toast as T, toast as U, type ValidatorFn as V, withScopedStyle as W, zipMask as X, FocusTrap as a, type FormConfig as b, type FormField as c, type FormReturn as d, type ToastInstance as e, VirtualList as f, type VirtualListProps as g, announce as h, aria as i, bindAttrs as j, bindBoolAttr as k, bindData as l, bindField as m, creditCardMask as n, custom as o, dateMask as p, defineElement as q, dialog as r, email as s, eventBus as t, focus as u, form as v, hotkey as w, infiniteScroll as x, inputMask as y, intersection as z };

package/dist/extras.cjs

@@ -3320,18 +3320,31 @@ function FocusTrap(nodes, options = {}) {
   }
   return container;
 }
-function hotkey(key, handler, options = {}) {
+function hotkey(combo, handler, options = {}) {
+  let key = combo;
+  let needCtrl = options.ctrl ?? false;
+  let needShift = options.shift ?? false;
+  let needAlt = options.alt ?? false;
+  let needMeta = options.meta ?? false;
+  if (combo.includes("+")) {
+    const parts = combo.toLowerCase().split("+");
+    key = parts[parts.length - 1];
+    for (let i2 = 0; i2 < parts.length - 1; i2++) {
+      const mod = parts[i2];
+      if (mod === "ctrl" || mod === "control") needCtrl = true;
+      else if (mod === "shift") needShift = true;
+      else if (mod === "alt") needAlt = true;
+      else if (mod === "meta" || mod === "cmd" || mod === "command") needMeta = true;
+    }
+  }
   const listener = (e) => {
     const ke = e;
     if (ke.key.toLowerCase() !== key.toLowerCase()) return;
-    if (options.ctrl && !ke.ctrlKey) return;
-    if (!options.ctrl && ke.ctrlKey) return;
-    if (options.shift && !ke.shiftKey) return;
-    if (!options.shift && ke.shiftKey) return;
-    if (options.alt && !ke.altKey) return;
-    if (!options.alt && ke.altKey) return;
-    if (options.meta && !ke.metaKey) return;
-    if (!options.meta && ke.metaKey) return;
+    if (needCtrl !== ke.ctrlKey) return;
+    if (needShift !== ke.shiftKey) return;
+    if (needAlt !== ke.altKey) return;
+    if (needMeta !== ke.metaKey) return;
+    if (options.preventDefault) ke.preventDefault();
     handler(ke);
   };
   document.addEventListener("keydown", listener);

package/dist/extras.d.cts

@@ -3,7 +3,7 @@ export { battery, clipboard, colorScheme, draggable, dropZone, formatCurrency, f
 export { GlobalStore, MachineConfig, MachineReturn, Middleware, OptimisticAction, PersistOptions, Selector, TimeTravelReturn, createEffect, createMemo, createSignal, globalStore, machine, optimistic, optimisticList, persisted, timeline } from './patterns.cjs';
 export { C as ComponentProps, P as PropDef, a as PropSchema, R as RenderProp, V as Validator, b as assertType, c as composable, d as compose, e as createGuard, f as createSlots, g as defineComponent, h as defineSlottedComponent, i as defineStrictComponent, v as validateProps, j as validators, w as withBoundary, k as withDefaults, l as withProps, m as withWrapper } from './contracts-DOrhwbke.cjs';
 export { AnimationPreset, PresetOptions, SlideDirection, SpringOptions, TransitionGroup, TransitionGroupOptions, TransitionOptions, animate, bounceIn, bounceOut, fadeIn, fadeOut, flipIn, pulse, reducedMotion, scaleDown, scaleUp, sequence, shake, slideIn, slideOut, spring, springSignal, stagger, transition, viewTransition } from './motion.cjs';
-export { B as BoundFieldProps, C as CustomElementOptions, F as FieldConfig, a as FocusTrap, b as FormConfig, c as FormField, d as FormReturn, I as IntersectionResult, M as MaskOptions, T as Toast, e as ToastInstance, V as ValidatorFn, f as VirtualList, g as VirtualListProps, h as announce, i as aria, j as bindAttrs, k as bindBoolAttr, l as bindData, m as bindField, n as creditCardMask, o as custom, p as dateMask, q as defineElement, r as dialog, s as email, t as eventBus, u as focus, v as form, w as hotkey, x as infiniteScroll, y as inputMask, z as intersection, A as lazyLoad, D as matchesPattern, E as max, G as maxLength, H as min, J as minLength, K as pagination, L as phoneMask, N as removeScopedStyle, O as required, P as scopedStyle, Q as ssnMask, R as svgElement, S as timeMask, U as toast, W as withScopedStyle, X as zipMask } from './customElement-yz8uyk-0.cjs';
+export { B as BoundFieldProps, C as CustomElementOptions, F as FieldConfig, a as FocusTrap, b as FormConfig, c as FormField, d as FormReturn, I as IntersectionResult, M as MaskOptions, T as Toast, e as ToastInstance, V as ValidatorFn, f as VirtualList, g as VirtualListProps, h as announce, i as aria, j as bindAttrs, k as bindBoolAttr, l as bindData, m as bindField, n as creditCardMask, o as custom, p as dateMask, q as defineElement, r as dialog, s as email, t as eventBus, u as focus, v as form, w as hotkey, x as infiniteScroll, y as inputMask, z as intersection, A as lazyLoad, D as matchesPattern, E as max, G as maxLength, H as min, J as minLength, K as pagination, L as phoneMask, N as removeScopedStyle, O as required, P as scopedStyle, Q as ssnMask, R as svgElement, S as timeMask, U as toast, W as withScopedStyle, X as zipMask } from './customElement-D2DJp_xn.cjs';
 export { ChunkConfig, DOMPool, Features, NormalizeResult, NormalizedEntities, NormalizedSchema, NormalizedState, NormalizedStoreActions, Priority, PriorityLevel, block, cloneTemplate, conditional, createChunkRegistry, deferredValue, denormalize, devOnly, domPool, flushScheduler, hoistable, lazyChunk, noSideEffect, normalize, normalizedStore, pendingTasks, precompile, prefetch, preloadImage, preloadModule, preloadModules, preloadResource, processInChunks, pure, resetIdCounter, scheduleUpdate, setIdPrefix, startTransition, staticTemplate, transitionState, uniqueId, yieldToMain } from './performance.cjs';
 export { ActionFn, ActionResult, Head, ISROptions, MicroApp, MicroAppConfig, MiddlewareFn, SSGOptions, SSGResult, ScrollRestorationOptions, ServiceWorkerState, SharedScope, UseWorkerFnReturn, UseWorkerReturn, WasmConfig, WasmModuleState, WorkerPool, clearWasmCache, composeMiddleware, createAction, createISR, createMicroApp, createMiddlewareChain, createSharedScope, createWasmBridge, createWorkerPool, defineRemoteComponent, generateStaticSite, isWasmCached, loadRemoteModule, loadWasmModule, preloadWasm, scrollRestoration, serviceWorker, setCanonical, setStructuredData, wasm, worker, workerFn } from './ssr.cjs';
 export { T as TrustedHTML, c as collectStream, d as deserializeState, h as hydrate, a as hydrateIslands, b as hydrateProgressively, i as island, r as renderToDocument, e as renderToReadableStream, f as renderToStream, g as renderToString, j as renderToSuspenseStream, k as resetSSRState, s as serializeState, l as ssrSuspense, m as suspenseSwapScript, t as trustHTML } from './ssr-BA6sxxUd.cjs';