@bquery/bquery 1.2.0 → 1.3.0

package/dist/component.es.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"component.es.mjs","sources":["../src/component/index.ts"],"sourcesContent":["/**\r\n * Minimal Web Component helper for building custom elements.\r\n *\r\n * This module provides a declarative API for defining Web Components\r\n * without complex build steps. Features include:\r\n * - Type-safe props with automatic attribute coercion\r\n * - Reactive state management\r\n * - Shadow DOM encapsulation with scoped styles\r\n * - Lifecycle hooks (connected, disconnected)\r\n * - Event emission helpers\r\n *\r\n * @module bquery/component\r\n *\r\n * @example\r\n * ```ts\r\n * import { component, html } from 'bquery/component';\r\n *\r\n * component('user-card', {\r\n *   props: {\r\n *     username: { type: String, required: true },\r\n *     avatar: { type: String, default: '/default-avatar.png' },\r\n *   },\r\n *   styles: `\r\n *     .card { padding: 1rem; border: 1px solid #ccc; }\r\n *   `,\r\n *   render({ props }) {\r\n *     return html`\r\n *       <div class=\"card\">\r\n *         <img src=\"${props.avatar}\" alt=\"${props.username}\" />\r\n *         <h3>${props.username}</h3>\r\n *       </div>\r\n *     `;\r\n *   },\r\n * });\r\n * ```\r\n */\r\n\r\n/**\r\n * Defines a single prop's type and configuration.\r\n *\r\n * @template T - The TypeScript type of the prop value\r\n *\r\n * @example\r\n * ```ts\r\n * const myProp: PropDefinition<number> = {\r\n *   type: Number,\r\n *   required: false,\r\n *   default: 0,\r\n * };\r\n * ```\r\n */\r\nexport type PropDefinition<T = unknown> = {\r\n  /** Constructor or converter function for the prop type */\r\n  type:\r\n    | StringConstructor\r\n    | NumberConstructor\r\n    | BooleanConstructor\r\n    | ObjectConstructor\r\n    | ArrayConstructor\r\n    | { new (value: unknown): T }\r\n    | ((value: unknown) => T);\r\n  /** Whether the prop must be provided */\r\n  required?: boolean;\r\n  /** Default value when prop is not provided */\r\n  default?: T;\r\n  /** Optional validator function to validate prop values */\r\n  validator?: (value: T) => boolean;\r\n};\r\n\r\n/**\r\n * Complete component definition including props, state, styles, and lifecycle.\r\n *\r\n * @template TProps - Type of the component's props\r\n */\r\nexport type ComponentDefinition<TProps extends Record<string, unknown> = Record<string, unknown>> =\r\n  {\r\n    /** Prop definitions with types and defaults */\r\n    props?: Record<keyof TProps, PropDefinition>;\r\n    /** Initial internal state */\r\n    state?: Record<string, unknown>;\r\n    /** CSS styles scoped to the component's shadow DOM */\r\n    styles?: string;\r\n    /** Lifecycle hook called before the component mounts (before first render) */\r\n    beforeMount?: () => void;\r\n    /** Lifecycle hook called when component is added to DOM */\r\n    connected?: () => void;\r\n    /** Lifecycle hook called when component is removed from DOM */\r\n    disconnected?: () => void;\r\n    /** Lifecycle hook called before an update render; return false to prevent */\r\n    beforeUpdate?: (props: TProps) => boolean | void;\r\n    /** Lifecycle hook called after reactive updates trigger a render */\r\n    updated?: () => void;\r\n    /** Error handler for errors during rendering or lifecycle */\r\n    onError?: (error: Error) => void;\r\n    /** Render function returning HTML string */\r\n    render: (context: {\r\n      props: TProps;\r\n      state: Record<string, unknown>;\r\n      emit: (event: string, detail?: unknown) => void;\r\n    }) => string;\r\n  };\r\n\r\n/**\r\n * Coerces a string attribute value into a typed prop value.\r\n * Supports String, Number, Boolean, Object, Array, and custom converters.\r\n *\r\n * @internal\r\n * @template T - The target type\r\n * @param rawValue - The raw string value from the attribute\r\n * @param config - The prop definition with type information\r\n * @returns The coerced value of type T\r\n */\r\nconst coercePropValue = <T>(rawValue: string, config: PropDefinition<T>): T => {\r\n  const { type } = config;\r\n\r\n  if (type === String) return rawValue as T;\r\n\r\n  if (type === Number) {\r\n    const parsed = Number(rawValue);\r\n    return (Number.isNaN(parsed) ? rawValue : parsed) as T;\r\n  }\r\n\r\n  if (type === Boolean) {\r\n    const normalized = rawValue.trim().toLowerCase();\r\n    if (normalized === '' || normalized === 'true' || normalized === '1') {\r\n      return true as T;\r\n    }\r\n    if (normalized === 'false' || normalized === '0') {\r\n      return false as T;\r\n    }\r\n    return Boolean(rawValue) as T;\r\n  }\r\n\r\n  if (type === Object || type === Array) {\r\n    try {\r\n      return JSON.parse(rawValue) as T;\r\n    } catch {\r\n      return rawValue as T;\r\n    }\r\n  }\r\n\r\n  if (typeof type === 'function') {\r\n    const callable = type as (value: unknown) => T;\r\n    const constructable = type as new (value: unknown) => T;\r\n    try {\r\n      return callable(rawValue);\r\n    } catch {\r\n      return new constructable(rawValue);\r\n    }\r\n  }\r\n\r\n  return rawValue as T;\r\n};\r\n\r\n/**\r\n * Tagged template literal for creating HTML strings.\r\n *\r\n * This function handles interpolation of values into HTML templates,\r\n * converting null/undefined to empty strings.\r\n *\r\n * @param strings - Template literal string parts\r\n * @param values - Interpolated values\r\n * @returns Combined HTML string\r\n *\r\n * @example\r\n * ```ts\r\n * const name = 'World';\r\n * const greeting = html`<h1>Hello, ${name}!</h1>`;\r\n * // Result: '<h1>Hello, World!</h1>'\r\n * ```\r\n */\r\nexport const html = (strings: TemplateStringsArray, ...values: unknown[]): string => {\r\n  return strings.reduce((acc, part, index) => `${acc}${part}${values[index] ?? ''}`, '');\r\n};\r\n\r\n/**\r\n * Escapes HTML entities in interpolated values for XSS prevention.\r\n * Use this when you need to safely embed user content in templates.\r\n *\r\n * @param strings - Template literal string parts\r\n * @param values - Interpolated values to escape\r\n * @returns Combined HTML string with escaped values\r\n *\r\n * @example\r\n * ```ts\r\n * const userInput = '<script>alert(\"xss\")</script>';\r\n * const safe = safeHtml`<div>${userInput}</div>`;\r\n * // Result: '<div>&lt;script&gt;alert(\"xss\")&lt;/script&gt;</div>'\r\n * ```\r\n */\r\nexport const safeHtml = (strings: TemplateStringsArray, ...values: unknown[]): string => {\r\n  const escapeMap: Record<string, string> = {\r\n    '&': '&amp;',\r\n    '<': '&lt;',\r\n    '>': '&gt;',\r\n    '\"': '&quot;',\r\n    \"'\": '&#x27;',\r\n    '`': '&#x60;',\r\n  };\r\n\r\n  const escape = (value: unknown): string => {\r\n    const str = String(value ?? '');\r\n    return str.replace(/[&<>\"'`]/g, (char) => escapeMap[char]);\r\n  };\r\n\r\n  return strings.reduce((acc, part, index) => `${acc}${part}${escape(values[index])}`, '');\r\n};\r\n\r\n/**\r\n * Defines and registers a custom Web Component.\r\n *\r\n * This function creates a new custom element with the given tag name\r\n * and configuration. The component uses Shadow DOM for encapsulation\r\n * and automatically re-renders when observed attributes change.\r\n *\r\n * @template TProps - Type of the component's props\r\n * @param tagName - The custom element tag name (must contain a hyphen)\r\n * @param definition - The component configuration\r\n *\r\n * @example\r\n * ```ts\r\n * component('counter-button', {\r\n *   props: {\r\n *     start: { type: Number, default: 0 },\r\n *   },\r\n *   state: { count: 0 },\r\n *   styles: `\r\n *     button { padding: 0.5rem 1rem; }\r\n *   `,\r\n *   connected() {\r\n *     console.log('Counter mounted');\r\n *   },\r\n *   render({ props, state, emit }) {\r\n *     return html`\r\n *       <button onclick=\"this.getRootNode().host.increment()\">\r\n *         Count: ${state.count}\r\n *       </button>\r\n *     `;\r\n *   },\r\n * });\r\n * ```\r\n */\r\nexport const component = <TProps extends Record<string, unknown>>(\r\n  tagName: string,\r\n  definition: ComponentDefinition<TProps>\r\n): void => {\r\n  /**\r\n   * Internal Web Component class created for each component definition.\r\n   * @internal\r\n   */\r\n  class BQueryComponent extends HTMLElement {\r\n    /** Internal state object for the component */\r\n    private readonly state = { ...(definition.state ?? {}) };\r\n    /** Typed props object populated from attributes */\r\n    private props = {} as TProps;\r\n\r\n    constructor() {\r\n      super();\r\n      this.attachShadow({ mode: 'open' });\r\n      this.syncProps();\r\n    }\r\n\r\n    /**\r\n     * Returns the list of attributes to observe for changes.\r\n     */\r\n    static get observedAttributes(): string[] {\r\n      return Object.keys(definition.props ?? {});\r\n    }\r\n\r\n    /**\r\n     * Called when the element is added to the DOM.\r\n     */\r\n    connectedCallback(): void {\r\n      try {\r\n        definition.beforeMount?.call(this);\r\n        definition.connected?.call(this);\r\n        this.render();\r\n      } catch (error) {\r\n        this.handleError(error as Error);\r\n      }\r\n    }\r\n\r\n    /**\r\n     * Called when the element is removed from the DOM.\r\n     */\r\n    disconnectedCallback(): void {\r\n      try {\r\n        definition.disconnected?.call(this);\r\n      } catch (error) {\r\n        this.handleError(error as Error);\r\n      }\r\n    }\r\n\r\n    /**\r\n     * Called when an observed attribute changes.\r\n     */\r\n    attributeChangedCallback(): void {\r\n      try {\r\n        this.syncProps();\r\n        this.render(true);\r\n      } catch (error) {\r\n        this.handleError(error as Error);\r\n      }\r\n    }\r\n\r\n    /**\r\n     * Handles errors during component lifecycle.\r\n     * @internal\r\n     */\r\n    private handleError(error: Error): void {\r\n      if (definition.onError) {\r\n        definition.onError.call(this, error);\r\n      } else {\r\n        console.error(`bQuery component error in <${tagName}>:`, error);\r\n      }\r\n    }\r\n\r\n    /**\r\n     * Updates a state property and triggers a re-render.\r\n     *\r\n     * @param key - The state property key\r\n     * @param value - The new value\r\n     */\r\n    setState(key: string, value: unknown): void {\r\n      this.state[key] = value;\r\n      this.render(true);\r\n    }\r\n\r\n    /**\r\n     * Gets a state property value.\r\n     *\r\n     * @param key - The state property key\r\n     * @returns The current value\r\n     */\r\n    getState<T = unknown>(key: string): T {\r\n      return this.state[key] as T;\r\n    }\r\n\r\n    /**\r\n     * Synchronizes props from attributes.\r\n     * @internal\r\n     */\r\n    private syncProps(): void {\r\n      const props = definition.props ?? {};\r\n      for (const [key, config] of Object.entries(props) as [string, PropDefinition][]) {\r\n        const attrValue = this.getAttribute(key);\r\n        let value: unknown;\r\n\r\n        if (attrValue == null) {\r\n          if (config.required && config.default === undefined) {\r\n            throw new Error(`bQuery component: missing required prop \"${key}\"`);\r\n          }\r\n          value = config.default ?? undefined;\r\n        } else {\r\n          value = coercePropValue(attrValue, config);\r\n        }\r\n\r\n        // Validate the prop value if a validator is provided\r\n        if (config.validator && value !== undefined) {\r\n          const isValid = config.validator(value);\r\n          if (!isValid) {\r\n            throw new Error(\r\n              `bQuery component: validation failed for prop \"${key}\" with value ${JSON.stringify(value)}`\r\n            );\r\n          }\r\n        }\r\n\r\n        (this.props as Record<string, unknown>)[key] = value;\r\n      }\r\n    }\r\n\r\n    /**\r\n     * Renders the component to its shadow root.\r\n     * @internal\r\n     */\r\n    private render(triggerUpdated = false): void {\r\n      try {\r\n        // Check beforeUpdate hook if this is an update\r\n        if (triggerUpdated && definition.beforeUpdate) {\r\n          const shouldUpdate = definition.beforeUpdate.call(this, this.props);\r\n          if (shouldUpdate === false) return;\r\n        }\r\n\r\n        /**\r\n         * Emits a custom event from the component.\r\n         */\r\n        const emit = (event: string, detail?: unknown): void => {\r\n          this.dispatchEvent(new CustomEvent(event, { detail, bubbles: true, composed: true }));\r\n        };\r\n\r\n        if (!this.shadowRoot) return;\r\n\r\n        const markup = definition.render({\r\n          props: this.props,\r\n          state: this.state,\r\n          emit,\r\n        });\r\n\r\n        const styles = definition.styles ? `<style>${definition.styles}</style>` : '';\r\n        this.shadowRoot.innerHTML = `${styles}${markup}`;\r\n\r\n        if (triggerUpdated) {\r\n          definition.updated?.call(this);\r\n        }\r\n      } catch (error) {\r\n        this.handleError(error as Error);\r\n      }\r\n    }\r\n  }\r\n\r\n  if (!customElements.get(tagName)) {\r\n    customElements.define(tagName, BQueryComponent);\r\n  }\r\n};\r\n"],"names":["coercePropValue","rawValue","config","type","parsed","normalized","callable","constructable","html","strings","values","acc","part","index","safeHtml","escapeMap","escape","value","char","component","tagName","definition","BQueryComponent","error","key","props","attrValue","triggerUpdated","emit","event","detail","markup","styles"],"mappings":"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"}
+{"version":3,"file":"component.es.mjs","sources":["../src/component/props.ts","../src/component/component.ts","../src/component/html.ts"],"sourcesContent":["/**\n * Prop coercion utilities.\n *\n * @module bquery/component\n */\n\nimport type { PropDefinition } from './types';\n\n/**\n * Coerces a string attribute value into a typed prop value.\n * Supports String, Number, Boolean, Object, Array, and custom converters.\n *\n * @internal\n * @template T - The target type\n * @param rawValue - The raw string value from the attribute\n * @param config - The prop definition with type information\n * @returns The coerced value of type T\n */\nexport const coercePropValue = <T>(rawValue: string, config: PropDefinition<T>): T => {\n  const { type } = config;\n\n  if (type === String) return rawValue as T;\n\n  if (type === Number) {\n    return Number(rawValue) as T;\n  }\n\n  if (type === Boolean) {\n    const normalized = rawValue.trim().toLowerCase();\n    if (normalized === '' || normalized === 'true' || normalized === '1') {\n      return true as T;\n    }\n    if (normalized === 'false' || normalized === '0') {\n      return false as T;\n    }\n    return Boolean(rawValue) as T;\n  }\n\n  if (type === Object || type === Array) {\n    try {\n      return JSON.parse(rawValue) as T;\n    } catch {\n      return rawValue as T;\n    }\n  }\n\n  if (typeof type === 'function') {\n    const callable = type as (value: unknown) => T;\n    const constructable = type as new (value: unknown) => T;\n\n    // Explicit construct mode takes precedence\n    if (config.construct === true) {\n      return Reflect.construct(constructable, [rawValue]) as T;\n    }\n    if (config.construct === false) {\n      return callable(rawValue);\n    }\n\n    // Auto-detect: Check if type is constructable\n    // A function is considered constructable if:\n    // 1. It has a prototype with properties beyond just constructor, OR\n    // 2. Its prototype.constructor is not itself (inherited), OR\n    // 3. It's a class (toString starts with \"class\")\n    const hasPrototype = type.prototype !== undefined && type.prototype !== null;\n    const prototypeProps = hasPrototype ? Object.getOwnPropertyNames(type.prototype) : [];\n    const hasPrototypeMethods = prototypeProps.length > 1;\n    const hasInheritedConstructor = hasPrototype && type.prototype.constructor !== type;\n    const isClassSyntax = /^class\\s/.test(Function.prototype.toString.call(type));\n\n    const isConstructable = hasPrototypeMethods || hasInheritedConstructor || isClassSyntax;\n\n    // For constructable types (e.g. Date, custom classes), prefer `new` to avoid\n    // silent wrong-type returns (Date() returns string, new Date() returns Date)\n    if (isConstructable) {\n      try {\n        return Reflect.construct(constructable, [rawValue]) as T;\n      } catch {\n        // Fall back to calling as function if construction fails\n        return callable(rawValue);\n      }\n    }\n\n    // For non-constructable types (arrow functions, plain functions), call directly\n    // but fall back to constructor if result is undefined (common for function constructors)\n    try {\n      const result = callable(rawValue);\n\n      // If calling without `new` returned undefined and the function has a prototype,\n      // it's likely a function constructor that should be called with `new`\n      if (result === undefined && hasPrototype) {\n        try {\n          return Reflect.construct(constructable, [rawValue]) as T;\n        } catch {\n          // Construction also failed, return the undefined\n          return result as T;\n        }\n      }\n\n      return result as T;\n    } catch (error) {\n      // Fall back to constructor if error indicates 'new' is required\n      const isNewRequired =\n        error instanceof TypeError &&\n        /cannot be invoked without 'new'|is not a function/i.test(error.message);\n\n      if (isNewRequired) {\n        return Reflect.construct(constructable, [rawValue]) as T;\n      }\n\n      // Rethrow original error for non-constructable converters\n      throw error;\n    }\n  }\n\n  return rawValue as T;\n};\n","/**\n * Web Component factory and registry.\n *\n * @module bquery/component\n */\n\nimport { sanitizeHtml } from '../security/sanitize';\nimport { coercePropValue } from './props';\nimport type { ComponentDefinition, PropDefinition } from './types';\n\n/**\n * Creates a custom element class for a component definition.\n *\n * This is useful when you want to extend or register the class manually\n * (e.g. with different tag names in tests or custom registries).\n *\n * @template TProps - Type of the component's props\n * @param tagName - The custom element tag name (used for diagnostics)\n * @param definition - The component configuration\n */\nexport const defineComponent = <TProps extends Record<string, unknown>>(\n  tagName: string,\n  definition: ComponentDefinition<TProps>\n): typeof HTMLElement => {\n  class BQueryComponent extends HTMLElement {\n    /** Internal state object for the component */\n    private readonly state = { ...(definition.state ?? {}) };\n    /** Typed props object populated from attributes */\n    private props = {} as TProps;\n    /** Tracks missing required props for validation during connectedCallback */\n    private missingRequiredProps = new Set<string>();\n    /** Tracks whether the component has completed its initial mount */\n    private hasMounted = false;\n\n    constructor() {\n      super();\n      this.attachShadow({ mode: 'open' });\n      this.syncProps();\n    }\n\n    /**\n     * Returns the list of attributes to observe for changes.\n     */\n    static get observedAttributes(): string[] {\n      return Object.keys(definition.props ?? {});\n    }\n\n    /**\n     * Called when the element is added to the DOM.\n     */\n    connectedCallback(): void {\n      try {\n        // Defer initial render until all required props are present\n        // This allows attributes to be set after element creation\n        if (this.missingRequiredProps.size > 0) {\n          // Component will mount once all required props are satisfied\n          // via attributeChangedCallback\n          return;\n        }\n        this.mount();\n      } catch (error) {\n        this.handleError(error as Error);\n      }\n    }\n\n    /**\n     * Performs the initial mount of the component.\n     * Called when the element is connected and all required props are present.\n     * @internal\n     */\n    private mount(): void {\n      if (this.hasMounted) return;\n      definition.beforeMount?.call(this);\n      definition.connected?.call(this);\n      this.render();\n      this.hasMounted = true;\n    }\n\n    /**\n     * Called when the element is removed from the DOM.\n     */\n    disconnectedCallback(): void {\n      try {\n        definition.disconnected?.call(this);\n      } catch (error) {\n        this.handleError(error as Error);\n      }\n    }\n\n    /**\n     * Called when an observed attribute changes.\n     */\n    attributeChangedCallback(\n      _name: string,\n      _oldValue: string | null,\n      _newValue: string | null\n    ): void {\n      try {\n        this.syncProps();\n\n        if (this.hasMounted) {\n          // Component already mounted - trigger update render\n          this.render(true);\n        } else if (this.isConnected && this.missingRequiredProps.size === 0) {\n          // All required props are now satisfied and element is connected\n          // Trigger the deferred initial mount\n          this.mount();\n        }\n      } catch (error) {\n        this.handleError(error as Error);\n      }\n    }\n\n    /**\n     * Handles errors during component lifecycle.\n     * @internal\n     */\n    private handleError(error: Error): void {\n      if (definition.onError) {\n        definition.onError.call(this, error);\n      } else {\n        console.error(`bQuery component error in <${tagName}>:`, error);\n      }\n    }\n\n    /**\n     * Updates a state property and triggers a re-render.\n     *\n     * @param key - The state property key\n     * @param value - The new value\n     */\n    setState(key: string, value: unknown): void {\n      this.state[key] = value;\n      this.render(true);\n    }\n\n    /**\n     * Gets a state property value.\n     *\n     * @param key - The state property key\n     * @returns The current value\n     */\n    getState<T = unknown>(key: string): T {\n      return this.state[key] as T;\n    }\n\n    /**\n     * Synchronizes props from attributes.\n     * @internal\n     */\n    private syncProps(): void {\n      const props = definition.props ?? {};\n      for (const [key, config] of Object.entries(props) as [string, PropDefinition][]) {\n        const attrValue = this.getAttribute(key);\n        let value: unknown;\n\n        if (attrValue == null) {\n          if (config.required && config.default === undefined) {\n            // Mark as missing instead of throwing - validate during connectedCallback\n            this.missingRequiredProps.add(key);\n            value = undefined;\n          } else {\n            value = config.default ?? undefined;\n          }\n        } else {\n          // Attribute is present, remove from missing set if it was there\n          if (this.missingRequiredProps.has(key)) {\n            this.missingRequiredProps.delete(key);\n          }\n          value = coercePropValue(attrValue, config);\n        }\n\n        if (config.validator && value !== undefined) {\n          const isValid = config.validator(value);\n          if (!isValid) {\n            throw new Error(\n              `bQuery component: validation failed for prop \"${key}\" with value ${JSON.stringify(value)}`\n            );\n          }\n        }\n\n        (this.props as Record<string, unknown>)[key] = value;\n      }\n    }\n\n    /**\n     * Renders the component to its shadow root.\n     * @internal\n     */\n    private render(triggerUpdated = false): void {\n      try {\n        if (triggerUpdated && definition.beforeUpdate) {\n          const shouldUpdate = definition.beforeUpdate.call(this, this.props);\n          if (shouldUpdate === false) return;\n        }\n\n        const emit = (event: string, detail?: unknown): void => {\n          this.dispatchEvent(new CustomEvent(event, { detail, bubbles: true, composed: true }));\n        };\n\n        if (!this.shadowRoot) return;\n\n        const markup = definition.render({\n          props: this.props,\n          state: this.state,\n          emit,\n        });\n\n        const sanitizedMarkup = sanitizeHtml(markup);\n        this.shadowRoot.innerHTML = sanitizedMarkup;\n\n        if (definition.styles) {\n          const styleElement = document.createElement('style');\n          styleElement.textContent = definition.styles;\n          this.shadowRoot.prepend(styleElement);\n        }\n\n        if (triggerUpdated) {\n          definition.updated?.call(this);\n        }\n      } catch (error) {\n        this.handleError(error as Error);\n      }\n    }\n  }\n\n  return BQueryComponent;\n};\n\n/**\n * Defines and registers a custom Web Component.\n *\n * This function creates a new custom element with the given tag name\n * and configuration. The component uses Shadow DOM for encapsulation\n * and automatically re-renders when observed attributes change.\n *\n * @template TProps - Type of the component's props\n * @param tagName - The custom element tag name (must contain a hyphen)\n * @param definition - The component configuration\n *\n * @example\n * ```ts\n * component('counter-button', {\n *   props: {\n *     start: { type: Number, default: 0 },\n *   },\n *   state: { count: 0 },\n *   styles: `\n *     button { padding: 0.5rem 1rem; }\n *   `,\n *   connected() {\n *     // Use event delegation on shadow root so handler survives re-renders\n *     const handleClick = (event: Event) => {\n *       const target = event.target as HTMLElement | null;\n *       if (target?.matches('button')) {\n *         this.setState('count', (this.getState('count') as number) + 1);\n *       }\n *     };\n *     this.shadowRoot?.addEventListener('click', handleClick);\n *     // Store handler for cleanup\n *     (this as any)._handleClick = handleClick;\n *   },\n *   disconnected() {\n *     // Clean up event listener to prevent memory leaks\n *     const handleClick = (this as any)._handleClick;\n *     if (handleClick) {\n *       this.shadowRoot?.removeEventListener('click', handleClick);\n *     }\n *   },\n *   render({ props, state }) {\n *     return html`\n *       <button>\n *         Count: ${state.count}\n *       </button>\n *     `;\n *   },\n * });\n * ```\n */\nexport const component = <TProps extends Record<string, unknown>>(\n  tagName: string,\n  definition: ComponentDefinition<TProps>\n): void => {\n  const elementClass = defineComponent(tagName, definition);\n\n  if (!customElements.get(tagName)) {\n    customElements.define(tagName, elementClass);\n  }\n};\n","/**\n * Tagged template literal for creating HTML strings.\n *\n * This function handles interpolation of values into HTML templates,\n * converting null/undefined to empty strings.\n *\n * @param strings - Template literal string parts\n * @param values - Interpolated values\n * @returns Combined HTML string\n *\n * @example\n * ```ts\n * const name = 'World';\n * const greeting = html`<h1>Hello, ${name}!</h1>`;\n * // Result: '<h1>Hello, World!</h1>'\n * ```\n */\nexport const html = (strings: TemplateStringsArray, ...values: unknown[]): string => {\n  return strings.reduce((acc, part, index) => `${acc}${part}${values[index] ?? ''}`, '');\n};\n\n/**\n * Escapes HTML entities in interpolated values for XSS prevention.\n * Use this when you need to safely embed user content in templates.\n *\n * @param strings - Template literal string parts\n * @param values - Interpolated values to escape\n * @returns Combined HTML string with escaped values\n *\n * @example\n * ```ts\n * const userInput = '<script>alert(\"xss\")</script>';\n * const safe = safeHtml`<div>${userInput}</div>`;\n * // Result: '<div>&lt;script&gt;alert(\"xss\")&lt;/script&gt;</div>'\n * ```\n */\nexport const safeHtml = (strings: TemplateStringsArray, ...values: unknown[]): string => {\n  const escapeMap: Record<string, string> = {\n    '&': '&amp;',\n    '<': '&lt;',\n    '>': '&gt;',\n    '\"': '&quot;',\n    \"'\": '&#x27;',\n    '`': '&#x60;',\n  };\n\n  const escape = (value: unknown): string => {\n    const str = String(value ?? '');\n    return str.replace(/[&<>\"'`]/g, (char) => escapeMap[char]);\n  };\n\n  return strings.reduce((acc, part, index) => `${acc}${part}${escape(values[index])}`, '');\n};\n"],"names":["coercePropValue","rawValue","config","type","normalized","callable","constructable","hasPrototype","hasPrototypeMethods","hasInheritedConstructor","isClassSyntax","result","error","defineComponent","tagName","definition","BQueryComponent","_name","_oldValue","_newValue","key","value","props","attrValue","triggerUpdated","emit","event","detail","markup","sanitizedMarkup","sanitizeHtml","styleElement","component","elementClass","html","strings","values","acc","part","index","safeHtml","escapeMap","escape","char"],"mappings":"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"}

package/dist/core/collection.d.ts

@@ -1,3 +1,4 @@
+import { type InsertableContent } from './dom';
 import { BQueryElement } from './element';
 /**
  * Wrapper for multiple DOM elements.
@@ -114,6 +115,8 @@ export declare class BQueryCollection {
      * @returns The instance for method chaining
      */
     removeAttr(name: string): this;
+    /** Toggle an attribute on all elements. */
+    toggleAttr(name: string, force?: boolean): this;
     /**
      * Sets text content on all elements or gets from first.
      *
@@ -136,6 +139,14 @@ export declare class BQueryCollection {
      * @warning Bypasses XSS protection
      */
     htmlUnsafe(value: string): this;
+    /** Append content to all elements. */
+    append(content: InsertableContent): this;
+    /** Prepend content to all elements. */
+    prepend(content: InsertableContent): this;
+    /** Insert content before all elements. */
+    before(content: InsertableContent): this;
+    /** Insert content after all elements. */
+    after(content: InsertableContent): this;
     /**
      * Applies CSS styles to all elements.
      *
@@ -144,6 +155,29 @@ export declare class BQueryCollection {
      * @returns The instance for method chaining
      */
     css(property: string | Record<string, string>, value?: string): this;
+    /** Wrap each element with a wrapper element or tag. */
+    wrap(wrapper: string | Element): this;
+    /**
+     * Remove the parent element of each element, keeping the elements in place.
+     *
+     * **Important**: This method unwraps ALL children of each parent element,
+     * not just the elements in the collection. If you call `unwrap()` on a
+     * collection containing only some children of a parent, all siblings will
+     * also be unwrapped. This behavior is consistent with jQuery's `.unwrap()`.
+     *
+     * @returns The collection for chaining
+     *
+     * @example
+     * ```ts
+     * // HTML: <div><section><span>A</span><span>B</span></section></div>
+     * const spans = $$('span');
+     * spans.unwrap(); // Removes <section>, both spans move to <div>
+     * // Result: <div><span>A</span><span>B</span></div>
+     * ```
+     */
+    unwrap(): this;
+    /** Replace each element with provided content. */
+    replaceWith(content: string | Element): BQueryCollection;
     /**
      * Shows all elements.
      *
@@ -240,5 +274,7 @@ export declare class BQueryCollection {
      * @returns The instance for method chaining
      */
     empty(): this;
+    /** @internal */
+    private insertAll;
 }
 //# sourceMappingURL=collection.d.ts.map

package/dist/core/collection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../src/core/collection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../src/core/collection.ts"],"names":[],"mappings":"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"}

package/dist/core/dom.d.ts

@@ -0,0 +1,6 @@
+export type InsertableContent = string | Element | Element[];
+export declare const sanitizeContent: (html: string) => string;
+export declare const setHtml: (element: Element, html: string) => void;
+export declare const createElementFromHtml: (html: string) => Element;
+export declare const insertContent: (target: Element, content: InsertableContent, position: InsertPosition) => void;
+//# sourceMappingURL=dom.d.ts.map

package/dist/core/dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/core/dom.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,CAAC;AAE7D,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAA4B,CAAC;AAE5E,eAAO,MAAM,OAAO,GAAI,SAAS,OAAO,EAAE,MAAM,MAAM,KAAG,IAExD,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,KAAG,OAIpD,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,QAAQ,OAAO,EACf,SAAS,iBAAiB,EAC1B,UAAU,cAAc,KACvB,IAgBF,CAAC"}

package/dist/core/element.d.ts

@@ -29,6 +29,10 @@ export declare class BQueryElement {
     toggleClass(className: string, force?: boolean): this;
     /** Get or set an attribute. */
     attr(name: string, value?: string): string | this;
+    /** Remove an attribute. */
+    removeAttr(name: string): this;
+    /** Toggle an attribute on/off. */
+    toggleAttr(name: string, force?: boolean): this;
     /** Get or set a property. */
     prop<T extends keyof Element>(name: T, value?: Element[T]): Element[T] | this;
     /** Read or write data attributes in camelCase. */
@@ -121,6 +125,10 @@ export declare class BQueryElement {
      * Removes the parent element, keeping this element in its place.
      * Essentially the opposite of wrap().
      *
+     * **Important**: This method only moves the current element out of its parent
+     * before removing the parent. Any sibling elements will be removed along with
+     * the parent. For unwrapping multiple siblings, use a collection: `$$(siblings).unwrap()`.
+     *
      * @returns The instance for method chaining
      *
      * @example

package/dist/core/element.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../../src/core/element.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../../src/core/element.ts"],"names":[],"mappings":"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"}

package/dist/core/index.d.ts

@@ -2,4 +2,5 @@ export { BQueryCollection } from './collection';
 export { BQueryElement } from './element';
 export { $, $$ } from './selector';
 export { utils } from './utils';
+export { chunk, compact, ensureArray, flatten, unique, debounce, noop, once, throttle, isEmpty, parseJson, sleep, uid, clamp, inRange, randomInt, toNumber, clone, hasOwn, isPlainObject, merge, omit, pick, capitalize, escapeRegExp, slugify, toCamelCase, toKebabCase, truncate, isArray, isBoolean, isCollection, isDate, isElement, isFunction, isNumber, isObject, isPromise, isString, } from './utils';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EACL,KAAK,EACL,OAAO,EACP,WAAW,EACX,OAAO,EACP,MAAM,EACN,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,SAAS,EACT,KAAK,EACL,GAAG,EACH,KAAK,EACL,OAAO,EACP,SAAS,EACT,QAAQ,EACR,KAAK,EACL,MAAM,EACN,aAAa,EACb,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,OAAO,EACP,WAAW,EACX,WAAW,EACX,QAAQ,EACR,OAAO,EACP,SAAS,EACT,YAAY,EACZ,MAAM,EACN,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,MAAM,SAAS,CAAC"}

package/dist/core/utils/array.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Array-focused utility helpers.
+ *
+ * @module bquery/core/utils/array
+ */
+/**
+ * Ensures the input is always returned as an array.
+ *
+ * @template T - The item type
+ * @param value - A single value, array, or nullish value
+ * @returns An array (empty if nullish)
+ *
+ * @example
+ * ```ts
+ * ensureArray('a'); // ['a']
+ * ensureArray(['a', 'b']); // ['a', 'b']
+ * ensureArray(null); // []
+ * ```
+ */
+export declare function ensureArray<T>(value: T | T[] | null | undefined): T[];
+/**
+ * Removes duplicate entries from an array.
+ *
+ * @template T - The item type
+ * @param items - The array to deduplicate
+ * @returns A new array with unique items
+ *
+ * @example
+ * ```ts
+ * unique([1, 2, 2, 3]); // [1, 2, 3]
+ * ```
+ */
+export declare function unique<T>(items: T[]): T[];
+/**
+ * Splits an array into chunks of a given size.
+ *
+ * @template T - The item type
+ * @param items - The array to chunk
+ * @param size - The maximum size of each chunk
+ * @returns An array of chunks
+ *
+ * @example
+ * ```ts
+ * chunk([1, 2, 3, 4, 5], 2); // [[1,2],[3,4],[5]]
+ * ```
+ */
+export declare function chunk<T>(items: T[], size: number): T[][];
+/**
+ * Removes falsy values from an array.
+ *
+ * @template T - The item type
+ * @param items - The array to compact
+ * @returns A new array without falsy values
+ *
+ * @example
+ * ```ts
+ * compact([0, 1, '', 'ok', null]); // [1, 'ok']
+ * ```
+ */
+export declare function compact<T>(items: Array<T | null | undefined | false | 0 | ''>): T[];
+/**
+ * Flattens a single level of nested arrays.
+ *
+ * @template T - The item type
+ * @param items - The array to flatten
+ * @returns A new flattened array
+ *
+ * @example
+ * ```ts
+ * flatten([1, [2, 3], 4]); // [1, 2, 3, 4]
+ * ```
+ */
+export declare function flatten<T>(items: Array<T | T[]>): T[];
+//# sourceMappingURL=array.d.ts.map

package/dist/core/utils/array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../../src/core/utils/array.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,CAAC,EAAE,CAGrE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAEzC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAOxD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAEnF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAUrD"}

package/dist/core/utils/function.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Function-focused utility helpers.
+ *
+ * @module bquery/core/utils/function
+ */
+/**
+ * Creates a debounced function that delays execution until after
+ * the specified delay has elapsed since the last call.
+ *
+ * @template TArgs - The argument types of the function
+ * @param fn - The function to debounce
+ * @param delayMs - Delay in milliseconds
+ * @returns A debounced version of the function
+ *
+ * @example
+ * ```ts
+ * const search = debounce((query: string) => {
+ *   console.log('Searching:', query);
+ * }, 300);
+ *
+ * search('h');
+ * search('he');
+ * search('hello'); // Only this call executes after 300ms
+ * ```
+ */
+export declare function debounce<TArgs extends unknown[]>(fn: (...args: TArgs) => void, delayMs: number): (...args: TArgs) => void;
+/**
+ * Creates a throttled function that runs at most once per interval.
+ *
+ * @template TArgs - The argument types of the function
+ * @param fn - The function to throttle
+ * @param intervalMs - Minimum interval between calls in milliseconds
+ * @returns A throttled version of the function
+ *
+ * @example
+ * ```ts
+ * const handleScroll = throttle(() => {
+ *   console.log('Scroll position:', window.scrollY);
+ * }, 100);
+ *
+ * window.addEventListener('scroll', handleScroll);
+ * ```
+ */
+export declare function throttle<TArgs extends unknown[]>(fn: (...args: TArgs) => void, intervalMs: number): (...args: TArgs) => void;
+/**
+ * Ensures a function only runs once. Subsequent calls return the first result.
+ *
+ * @template TArgs - The argument types of the function
+ * @template TResult - The return type of the function
+ * @param fn - The function to wrap
+ * @returns A function that only runs once
+ *
+ * @example
+ * ```ts
+ * const init = once(() => ({ ready: true }));
+ * init();
+ * init(); // only runs once
+ * ```
+ */
+export declare function once<TArgs extends unknown[], TResult>(fn: (...args: TArgs) => TResult): (...args: TArgs) => TResult;
+/**
+ * A no-operation function.
+ *
+ * @example
+ * ```ts
+ * noop();
+ * ```
+ */
+export declare function noop(): void;
+//# sourceMappingURL=function.d.ts.map

package/dist/core/utils/function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function.d.ts","sourceRoot":"","sources":["../../../src/core/utils/function.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,SAAS,OAAO,EAAE,EAC9C,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,IAAI,EAC5B,OAAO,EAAE,MAAM,GACd,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,IAAI,CAQ1B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,SAAS,OAAO,EAAE,EAC9C,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,IAAI,EAC5B,UAAU,EAAE,MAAM,GACjB,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,IAAI,CAS1B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,IAAI,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,EACnD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,GAC9B,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAU7B;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,IAAI,IAAI,CAE3B"}

package/dist/core/utils/index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Utility helpers used across the framework.
+ * These are intentionally small and framework-agnostic to keep the core tiny.
+ *
+ * @module bquery/core/utils
+ */
+export * from './array';
+export * from './function';
+export * from './misc';
+export * from './number';
+export * from './object';
+export * from './string';
+export * from './type-guards';
+import { chunk, compact, ensureArray, flatten, unique } from './array';
+import { debounce, noop, once, throttle } from './function';
+import { isEmpty, parseJson, sleep, uid } from './misc';
+import { clamp, inRange, randomInt, toNumber } from './number';
+import { clone, hasOwn, isPlainObject, merge, omit, pick } from './object';
+import { capitalize, escapeRegExp, slugify, toCamelCase, toKebabCase, truncate } from './string';
+import { isArray, isBoolean, isCollection, isDate, isElement, isFunction, isNumber, isObject, isPromise, isString } from './type-guards';
+/**
+ * Utility object containing common helper functions.
+ * All utilities are designed to be tree-shakeable and have zero dependencies.
+ *
+ * Note: `isPrototypePollutionKey` is intentionally excluded from this namespace
+ * as it is an internal security helper. It remains available as a named export
+ * for internal framework use.
+ */
+export declare const utils: {
+    clone: typeof clone;
+    merge: typeof merge;
+    pick: typeof pick;
+    omit: typeof omit;
+    hasOwn: typeof hasOwn;
+    debounce: typeof debounce;
+    throttle: typeof throttle;
+    once: typeof once;
+    noop: typeof noop;
+    uid: typeof uid;
+    isElement: typeof isElement;
+    isCollection: typeof isCollection;
+    isEmpty: typeof isEmpty;
+    isPlainObject: typeof isPlainObject;
+    isFunction: typeof isFunction;
+    isString: typeof isString;
+    isNumber: typeof isNumber;
+    isBoolean: typeof isBoolean;
+    isArray: typeof isArray;
+    isDate: typeof isDate;
+    isPromise: typeof isPromise;
+    isObject: typeof isObject;
+    parseJson: typeof parseJson;
+    sleep: typeof sleep;
+    randomInt: typeof randomInt;
+    clamp: typeof clamp;
+    inRange: typeof inRange;
+    toNumber: typeof toNumber;
+    capitalize: typeof capitalize;
+    toKebabCase: typeof toKebabCase;
+    toCamelCase: typeof toCamelCase;
+    truncate: typeof truncate;
+    slugify: typeof slugify;
+    escapeRegExp: typeof escapeRegExp;
+    ensureArray: typeof ensureArray;
+    unique: typeof unique;
+    chunk: typeof chunk;
+    compact: typeof compact;
+    flatten: typeof flatten;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/core/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAE9B,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACjG,OAAO,EACL,OAAO,EACP,SAAS,EACT,YAAY,EACZ,MAAM,EACN,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,EACT,MAAM,eAAe,CAAC;AAEvB;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCjB,CAAC"}

package/dist/core/utils/misc.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Miscellaneous utility helpers.
+ *
+ * @module bquery/core/utils/misc
+ */
+/**
+ * Creates a stable unique ID for DOM usage.
+ *
+ * @param prefix - Optional prefix for the ID (default: 'bQuery')
+ * @returns A unique identifier string
+ *
+ * @example
+ * ```ts
+ * const id = uid('modal'); // 'modal_x7k2m9p'
+ * ```
+ */
+export declare function uid(prefix?: string): string;
+/**
+ * Delays execution for a specified number of milliseconds.
+ *
+ * @param ms - Milliseconds to delay
+ * @returns A promise that resolves after the delay
+ *
+ * @example
+ * ```ts
+ * await sleep(1000); // Wait 1 second
+ * console.log('Done!');
+ * ```
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Safely parses a JSON string, returning a default value on error.
+ *
+ * @template T - The expected type of the parsed value
+ * @param json - The JSON string to parse
+ * @param fallback - The default value if parsing fails
+ * @returns The parsed value or the fallback
+ *
+ * @example
+ * ```ts
+ * parseJson('{"name":"bQuery"}', {}); // { name: 'bQuery' }
+ * parseJson('invalid', {}); // {}
+ * ```
+ */
+export declare function parseJson<T>(json: string, fallback: T): T;
+/**
+ * Checks for emptiness across common value types.
+ *
+ * @param value - The value to check
+ * @returns True if the value is empty (null, undefined, empty string, empty array, or empty object)
+ *
+ * @example
+ * ```ts
+ * isEmpty('');       // true
+ * isEmpty([]);       // true
+ * isEmpty({});       // true
+ * isEmpty(null);     // true
+ * isEmpty('hello');  // false
+ * isEmpty([1, 2]);   // false
+ * ```
+ */
+export declare function isEmpty(value: unknown): boolean;
+//# sourceMappingURL=misc.d.ts.map

package/dist/core/utils/misc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../../src/core/utils/misc.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,GAAG,CAAC,MAAM,SAAW,GAAG,MAAM,CAE7C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAMzD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAM/C"}

package/dist/core/utils/number.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Number-focused utility helpers.
+ *
+ * @module bquery/core/utils/number
+ */
+/**
+ * Generates a random integer between min and max (inclusive).
+ *
+ * @param min - Minimum value
+ * @param max - Maximum value
+ * @returns A random integer in the range [min, max]
+ *
+ * @example
+ * ```ts
+ * const roll = randomInt(1, 6); // Random dice roll
+ * ```
+ */
+export declare function randomInt(min: number, max: number): number;
+/**
+ * Clamps a number between a minimum and maximum value.
+ *
+ * @param value - The value to clamp
+ * @param min - Minimum value
+ * @param max - Maximum value
+ * @returns The clamped value
+ *
+ * @example
+ * ```ts
+ * clamp(150, 0, 100); // 100
+ * clamp(-10, 0, 100); // 0
+ * clamp(50, 0, 100);  // 50
+ * ```
+ */
+export declare function clamp(value: number, min: number, max: number): number;
+/**
+ * Checks if a number is within a range.
+ *
+ * @param value - The value to check
+ * @param min - Minimum value
+ * @param max - Maximum value
+ * @param inclusive - Whether the range is inclusive (default: true)
+ * @returns True if the value is within the range
+ *
+ * @example
+ * ```ts
+ * inRange(5, 1, 10); // true
+ * inRange(10, 1, 10, false); // false
+ * ```
+ */
+export declare function inRange(value: number, min: number, max: number, inclusive?: boolean): boolean;
+/**
+ * Converts a value to a number with a fallback on NaN.
+ *
+ * @param value - The value to convert
+ * @param fallback - The fallback value if conversion fails (default: 0)
+ * @returns The parsed number or the fallback
+ *
+ * @example
+ * ```ts
+ * toNumber('42'); // 42
+ * toNumber('nope', 10); // 10
+ * ```
+ */
+export declare function toNumber(value: unknown, fallback?: number): number;
+//# sourceMappingURL=number.d.ts.map

package/dist/core/utils/number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../../src/core/utils/number.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,UAAO,GAAG,OAAO,CAG1F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAI,GAAG,MAAM,CAG7D"}