@bquery/bquery 1.3.0 → 1.5.0

package/dist/component-CY5MVoYN.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-CY5MVoYN.js","names":[],"sources":["../src/component/props.ts","../src/component/component.ts","../src/component/html.ts","../src/component/library.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","/**\r\n * Web Component factory and registry.\r\n *\r\n * @module bquery/component\r\n */\r\n\r\nimport { sanitizeHtml } from '../security/sanitize';\r\nimport { coercePropValue } from './props';\r\nimport type { ComponentDefinition, PropDefinition } from './types';\r\n\r\n/**\r\n * Creates a custom element class for a component definition.\r\n *\r\n * This is useful when you want to extend or register the class manually\r\n * (e.g. with different tag names in tests or custom registries).\r\n *\r\n * @template TProps - Type of the component's props\r\n * @param tagName - The custom element tag name (used for diagnostics)\r\n * @param definition - The component configuration\r\n */\r\nexport const defineComponent = <TProps extends Record<string, unknown>>(\r\n  tagName: string,\r\n  definition: ComponentDefinition<TProps>\r\n): typeof HTMLElement => {\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    /** Tracks missing required props for validation during connectedCallback */\r\n    private missingRequiredProps = new Set<string>();\r\n    /** Tracks whether the component has completed its initial mount */\r\n    private hasMounted = false;\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        // Defer initial render until all required props are present\r\n        // This allows attributes to be set after element creation\r\n        if (this.missingRequiredProps.size > 0) {\r\n          // Component will mount once all required props are satisfied\r\n          // via attributeChangedCallback\r\n          return;\r\n        }\r\n        this.mount();\r\n      } catch (error) {\r\n        this.handleError(error as Error);\r\n      }\r\n    }\r\n\r\n    /**\r\n     * Performs the initial mount of the component.\r\n     * Called when the element is connected and all required props are present.\r\n     * @internal\r\n     */\r\n    private mount(): void {\r\n      if (this.hasMounted) return;\r\n      definition.beforeMount?.call(this);\r\n      definition.connected?.call(this);\r\n      this.render();\r\n      this.hasMounted = true;\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(\r\n      _name: string,\r\n      _oldValue: string | null,\r\n      _newValue: string | null\r\n    ): void {\r\n      try {\r\n        this.syncProps();\r\n\r\n        if (this.hasMounted) {\r\n          // Component already mounted - trigger update render\r\n          this.render(true);\r\n        } else if (this.isConnected && this.missingRequiredProps.size === 0) {\r\n          // All required props are now satisfied and element is connected\r\n          // Trigger the deferred initial mount\r\n          this.mount();\r\n        }\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            // Mark as missing instead of throwing - validate during connectedCallback\r\n            this.missingRequiredProps.add(key);\r\n            value = undefined;\r\n          } else {\r\n            value = config.default ?? undefined;\r\n          }\r\n        } else {\r\n          // Attribute is present, remove from missing set if it was there\r\n          if (this.missingRequiredProps.has(key)) {\r\n            this.missingRequiredProps.delete(key);\r\n          }\r\n          value = coercePropValue(attrValue, config);\r\n        }\r\n\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        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        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        // Component render output is authored by the component definition itself,\r\n        // so we can explicitly preserve shadow-DOM-specific markup such as <slot>,\r\n        // the stylistic `part` attribute, and standard form/input attributes without\r\n        // relaxing the global DOM sanitization rules.\r\n        const sanitizedMarkup = sanitizeHtml(markup, {\r\n          allowTags: ['slot'],\r\n          allowAttributes: [\r\n            'part',\r\n            // Standard form attributes required by interactive shadow DOM content\r\n            'disabled',\r\n            'checked',\r\n            'placeholder',\r\n            'value',\r\n            'rows',\r\n            'cols',\r\n            'readonly',\r\n            'required',\r\n            'maxlength',\r\n            'minlength',\r\n            'max',\r\n            'min',\r\n            'step',\r\n            'pattern',\r\n            'autocomplete',\r\n            'autofocus',\r\n            'for',\r\n            'multiple',\r\n            'selected',\r\n            'wrap',\r\n          ],\r\n        });\r\n        this.shadowRoot.innerHTML = sanitizedMarkup;\r\n\r\n        if (definition.styles) {\r\n          const styleElement = document.createElement('style');\r\n          styleElement.textContent = definition.styles;\r\n          this.shadowRoot.prepend(styleElement);\r\n        }\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  return BQueryComponent;\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 *     // Use event delegation on shadow root so handler survives re-renders\r\n *     const handleClick = (event: Event) => {\r\n *       const target = event.target as HTMLElement | null;\r\n *       if (target?.matches('button')) {\r\n *         this.setState('count', (this.getState('count') as number) + 1);\r\n *       }\r\n *     };\r\n *     this.shadowRoot?.addEventListener('click', handleClick);\r\n *     // Store handler for cleanup\r\n *     (this as any)._handleClick = handleClick;\r\n *   },\r\n *   disconnected() {\r\n *     // Clean up event listener to prevent memory leaks\r\n *     const handleClick = (this as any)._handleClick;\r\n *     if (handleClick) {\r\n *       this.shadowRoot?.removeEventListener('click', handleClick);\r\n *     }\r\n *   },\r\n *   render({ props, state }) {\r\n *     return html`\r\n *       <button>\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  const elementClass = defineComponent(tagName, definition);\r\n\r\n  if (!customElements.get(tagName)) {\r\n    customElements.define(tagName, elementClass);\r\n  }\r\n};\r\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","/**\r\n * Default component library based on native Web Components.\r\n *\r\n * @module bquery/component\r\n */\r\n\r\nimport { getBqueryConfig } from '../platform/config';\r\nimport { escapeHtml } from '../security';\r\nimport { component } from './component';\r\nimport { html } from './html';\r\n\r\n/** Options for registering the default component library. */\r\nexport interface DefaultComponentLibraryOptions {\r\n  /** Prefix used for all registered component tags. Defaults to `bq`. */\r\n  prefix?: string;\r\n}\r\n\r\n/** Tag names returned by registerDefaultComponents(). */\r\nexport interface RegisteredDefaultComponents {\r\n  /** Button component tag name. */\r\n  button: string;\r\n  /** Card component tag name. */\r\n  card: string;\r\n  /** Input component tag name. */\r\n  input: string;\r\n  /** Textarea component tag name. */\r\n  textarea: string;\r\n  /** Checkbox component tag name. */\r\n  checkbox: string;\r\n}\r\n\r\nconst baseStyles = `\r\n  :host {\r\n    color: inherit;\r\n    font: inherit;\r\n  }\r\n`;\r\n\r\nconst controlStyles = `\r\n  ${baseStyles}\r\n  .field {\r\n    display: inline-flex;\r\n    flex-direction: column;\r\n    gap: 0.375rem;\r\n    width: 100%;\r\n  }\r\n  .label {\r\n    color: #334155;\r\n    font-size: 0.875rem;\r\n    font-weight: 600;\r\n  }\r\n  .control {\r\n    border: 1px solid #cbd5e1;\r\n    border-radius: 0.75rem;\r\n    box-sizing: border-box;\r\n    font: inherit;\r\n    min-height: 2.75rem;\r\n    outline: none;\r\n    padding: 0.75rem 0.875rem;\r\n    width: 100%;\r\n    background: #fff;\r\n    color: #0f172a;\r\n    transition: border-color 160ms ease, box-shadow 160ms ease;\r\n  }\r\n  .control:focus {\r\n    border-color: #2563eb;\r\n    box-shadow: 0 0 0 3px rgba(37, 99, 235, 0.15);\r\n  }\r\n  .control:disabled {\r\n    background: #f8fafc;\r\n    color: #94a3b8;\r\n    cursor: not-allowed;\r\n  }\r\n`;\r\n\r\nconst escapeProp = (value: string): string => escapeHtml(value);\r\n\r\nconst handlerStore = new WeakMap<HTMLElement, Record<string, EventListener>>();\r\n\r\nconst readHandler = (element: HTMLElement, key: string): EventListener | undefined => {\r\n  return handlerStore.get(element)?.[key];\r\n};\r\n\r\nconst storeHandler = (element: HTMLElement, key: string, value: EventListener): void => {\r\n  const handlers = handlerStore.get(element) ?? {};\r\n  handlers[key] = value;\r\n  handlerStore.set(element, handlers);\r\n};\r\n\r\nconst getShadowLabelText = (element: HTMLElement): string => {\r\n  return element.shadowRoot?.querySelector('.label')?.textContent ?? '';\r\n};\r\n\r\n/**\r\n * Detect a value-only input update, patch the live control in place, and\r\n * return whether the component can skip a full shadow DOM re-render.\r\n *\r\n * @param element - The host custom element whose shadow DOM is being updated\r\n * @param props - The next reflected input props for the pending update\r\n */\r\nconst canSkipInputRender = (\r\n  element: HTMLElement,\r\n  props: {\r\n    label: string;\r\n    type: string;\r\n    value: string;\r\n    placeholder: string;\r\n    name: string;\r\n    disabled: boolean;\r\n  }\r\n): boolean => {\r\n  const control = element.shadowRoot?.querySelector('input.control') as HTMLInputElement | null;\r\n  if (!control) return false;\r\n\r\n  if (getShadowLabelText(element) !== props.label) return false;\r\n  if ((control.getAttribute('type') ?? 'text') !== props.type) return false;\r\n  if ((control.getAttribute('placeholder') ?? '') !== props.placeholder) return false;\r\n  if ((control.getAttribute('name') ?? '') !== props.name) return false;\r\n  if (control.disabled !== props.disabled) return false;\r\n\r\n  if (control.value !== props.value) {\r\n    control.value = props.value;\r\n  }\r\n\r\n  return true;\r\n};\r\n\r\n/**\r\n * Detect a value-only textarea update, patch the live control in place, and\r\n * return whether the component can skip a full shadow DOM re-render.\r\n *\r\n * @param element - The host custom element whose shadow DOM is being updated\r\n * @param props - The next reflected textarea props for the pending update\r\n */\r\nconst canSkipTextareaRender = (\r\n  element: HTMLElement,\r\n  props: {\r\n    label: string;\r\n    value: string;\r\n    placeholder: string;\r\n    name: string;\r\n    rows: number;\r\n    disabled: boolean;\r\n  }\r\n): boolean => {\r\n  const control = element.shadowRoot?.querySelector(\r\n    'textarea.control'\r\n  ) as HTMLTextAreaElement | null;\r\n  if (!control) return false;\r\n\r\n  if (getShadowLabelText(element) !== props.label) return false;\r\n  if ((control.getAttribute('placeholder') ?? '') !== props.placeholder) return false;\r\n  if ((control.getAttribute('name') ?? '') !== props.name) return false;\r\n  if (control.getAttribute('rows') !== String(props.rows)) return false;\r\n  if (control.disabled !== props.disabled) return false;\r\n\r\n  if (control.value !== props.value) {\r\n    control.value = props.value;\r\n  }\r\n  return true;\r\n};\r\n\r\nconst renderTextareaControl = (props: {\r\n  value: string;\r\n  placeholder: string;\r\n  name: string;\r\n  rows: number;\r\n  disabled: boolean;\r\n}): string => {\r\n  return [\r\n    '<textarea',\r\n    ' part=\"control\"',\r\n    ' class=\"control\"',\r\n    ` placeholder=\"${escapeProp(props.placeholder)}\"`,\r\n    ` name=\"${escapeProp(props.name)}\"`,\r\n    ` rows=\"${props.rows}\"`,\r\n    props.disabled ? ' disabled' : '',\r\n    `>${escapeProp(props.value)}</textarea>`,\r\n  ].join('');\r\n};\r\n\r\n/**\r\n * Register a default set of foundational UI components.\r\n *\r\n * The library is intentionally small and dependency-free, providing common\r\n * primitives that can be themed via shadow parts and CSS custom properties.\r\n *\r\n * @param options - Optional registration settings such as a custom tag prefix\r\n * @returns The registered tag names for each component\r\n */\r\nexport const registerDefaultComponents = (\r\n  options: DefaultComponentLibraryOptions = {}\r\n): RegisteredDefaultComponents => {\r\n  const prefix = options.prefix ?? getBqueryConfig().components?.prefix ?? 'bq';\r\n  const tags: RegisteredDefaultComponents = {\r\n    button: `${prefix}-button`,\r\n    card: `${prefix}-card`,\r\n    input: `${prefix}-input`,\r\n    textarea: `${prefix}-textarea`,\r\n    checkbox: `${prefix}-checkbox`,\r\n  };\r\n\r\n  component<{\r\n    label: string;\r\n    variant: string;\r\n    size: string;\r\n    type: string;\r\n    disabled: boolean;\r\n  }>(tags.button, {\r\n    props: {\r\n      label: { type: String, default: '' },\r\n      variant: { type: String, default: 'primary' },\r\n      size: { type: String, default: 'md' },\r\n      type: { type: String, default: 'button' },\r\n      disabled: { type: Boolean, default: false },\r\n    },\r\n    styles: `\r\n      ${baseStyles}\r\n      button {\r\n        appearance: none;\r\n        border: 0;\r\n        border-radius: 999px;\r\n        cursor: pointer;\r\n        display: inline-flex;\r\n        align-items: center;\r\n        justify-content: center;\r\n        font: inherit;\r\n        font-weight: 600;\r\n        gap: 0.5rem;\r\n        min-height: 2.5rem;\r\n        padding: 0.65rem 1rem;\r\n        transition: transform 160ms ease, opacity 160ms ease, background 160ms ease;\r\n        background: #2563eb;\r\n        color: #fff;\r\n      }\r\n      button[data-variant='secondary'] {\r\n        background: #e2e8f0;\r\n        color: #0f172a;\r\n      }\r\n      button[data-size='sm'] {\r\n        min-height: 2.125rem;\r\n        padding: 0.5rem 0.875rem;\r\n      }\r\n      button[data-size='lg'] {\r\n        min-height: 3rem;\r\n        padding: 0.875rem 1.25rem;\r\n      }\r\n      button:hover:not(:disabled) {\r\n        transform: translateY(-1px);\r\n      }\r\n      button:disabled {\r\n        cursor: not-allowed;\r\n        opacity: 0.6;\r\n      }\r\n    `,\r\n    render: ({ props }) => html`\r\n      <button\r\n        part=\"button\"\r\n        type=\"${escapeProp(props.type)}\"\r\n        data-variant=\"${escapeProp(props.variant)}\"\r\n        data-size=\"${escapeProp(props.size)}\"\r\n        ${props.disabled ? 'disabled' : ''}\r\n      >\r\n        <slot>${escapeProp(props.label)}</slot>\r\n      </button>\r\n    `,\r\n  });\r\n\r\n  component<{ title: string; footer: string; elevated: boolean }>(tags.card, {\r\n    props: {\r\n      title: { type: String, default: '' },\r\n      footer: { type: String, default: '' },\r\n      elevated: { type: Boolean, default: true },\r\n    },\r\n    styles: `\r\n      ${baseStyles}\r\n      article {\r\n        background: #fff;\r\n        border: 1px solid #e2e8f0;\r\n        border-radius: 1rem;\r\n        box-shadow: 0 10px 25px rgba(15, 23, 42, 0.08);\r\n        color: #0f172a;\r\n        display: block;\r\n        padding: 1rem;\r\n      }\r\n      article[data-elevated='false'] {\r\n        box-shadow: none;\r\n      }\r\n      header, footer {\r\n        color: #475569;\r\n        font-size: 0.95rem;\r\n        font-weight: 600;\r\n      }\r\n      header {\r\n        margin-bottom: 0.75rem;\r\n      }\r\n      footer {\r\n        margin-top: 0.75rem;\r\n      }\r\n    `,\r\n    render: ({ props }) => html`\r\n      <article part=\"card\" data-elevated=\"${String(props.elevated)}\">\r\n        ${props.title ? `<header part=\"header\">${escapeProp(props.title)}</header>` : ''}\r\n        <section part=\"body\"><slot></slot></section>\r\n        ${props.footer ? `<footer part=\"footer\">${escapeProp(props.footer)}</footer>` : ''}\r\n      </article>\r\n    `,\r\n  });\r\n\r\n  component<{\r\n    label: string;\r\n    type: string;\r\n    value: string;\r\n    placeholder: string;\r\n    name: string;\r\n    disabled: boolean;\r\n  }>(tags.input, {\r\n    props: {\r\n      label: { type: String, default: '' },\r\n      type: { type: String, default: 'text' },\r\n      value: { type: String, default: '' },\r\n      placeholder: { type: String, default: '' },\r\n      name: { type: String, default: '' },\r\n      disabled: { type: Boolean, default: false },\r\n    },\r\n    styles: controlStyles,\r\n    /**\r\n     * Skip the full shadow DOM re-render when only the reflected input value\r\n     * changed, because the live control has already been patched in place.\r\n     */\r\n    beforeUpdate(props) {\r\n      if (canSkipInputRender(this, props)) {\r\n        return false;\r\n      }\r\n      return true;\r\n    },\r\n    connected() {\r\n      const handleInput = (event: Event) => {\r\n        const target = event.target as HTMLInputElement | null;\r\n        if (!target?.matches('input')) return;\r\n        event.stopPropagation();\r\n        this.setAttribute('value', target.value);\r\n        this.dispatchEvent(\r\n          new CustomEvent('input', {\r\n            detail: { value: target.value },\r\n            bubbles: true,\r\n            composed: true,\r\n          })\r\n        );\r\n      };\r\n      storeHandler(this, '__bqueryInputHandler', handleInput);\r\n      this.shadowRoot?.addEventListener('input', handleInput);\r\n    },\r\n    disconnected() {\r\n      const handleInput = readHandler(this, '__bqueryInputHandler');\r\n      if (handleInput) {\r\n        this.shadowRoot?.removeEventListener('input', handleInput);\r\n      }\r\n    },\r\n    render: ({ props }) => html`\r\n      <label part=\"field\" class=\"field\">\r\n        ${props.label ? `<span part=\"label\" class=\"label\">${escapeProp(props.label)}</span>` : ''}\r\n        <input\r\n          part=\"control\"\r\n          class=\"control\"\r\n          type=\"${escapeProp(props.type)}\"\r\n          value=\"${escapeProp(props.value)}\"\r\n          placeholder=\"${escapeProp(props.placeholder)}\"\r\n          name=\"${escapeProp(props.name)}\"\r\n          ${props.disabled ? 'disabled' : ''}\r\n        />\r\n      </label>\r\n    `,\r\n  });\r\n\r\n  component<{\r\n    label: string;\r\n    value: string;\r\n    placeholder: string;\r\n    name: string;\r\n    rows: number;\r\n    disabled: boolean;\r\n  }>(tags.textarea, {\r\n    props: {\r\n      label: { type: String, default: '' },\r\n      value: { type: String, default: '' },\r\n      placeholder: { type: String, default: '' },\r\n      name: { type: String, default: '' },\r\n      rows: { type: Number, default: 4 },\r\n      disabled: { type: Boolean, default: false },\r\n    },\r\n    styles: `${controlStyles}\r\n      textarea.control {\r\n        min-height: 6rem;\r\n        resize: vertical;\r\n      }\r\n    `,\r\n    /**\r\n     * Skip the full shadow DOM re-render when only the reflected textarea value\r\n     * changed, because the live control has already been patched in place.\r\n     */\r\n    beforeUpdate(props) {\r\n      if (canSkipTextareaRender(this, props)) {\r\n        return false;\r\n      }\r\n      return true;\r\n    },\r\n    connected() {\r\n      const handleInput = (event: Event) => {\r\n        const target = event.target as HTMLTextAreaElement | null;\r\n        if (!target?.matches('textarea')) return;\r\n        event.stopPropagation();\r\n        this.setAttribute('value', target.value);\r\n        this.dispatchEvent(\r\n          new CustomEvent('input', {\r\n            detail: { value: target.value },\r\n            bubbles: true,\r\n            composed: true,\r\n          })\r\n        );\r\n      };\r\n      storeHandler(this, '__bqueryTextareaHandler', handleInput);\r\n      this.shadowRoot?.addEventListener('input', handleInput);\r\n    },\r\n    disconnected() {\r\n      const handleInput = readHandler(this, '__bqueryTextareaHandler');\r\n      if (handleInput) {\r\n        this.shadowRoot?.removeEventListener('input', handleInput);\r\n      }\r\n    },\r\n    render: ({ props }) => html`\r\n      <label part=\"field\" class=\"field\">\r\n        ${props.label ? `<span part=\"label\" class=\"label\">${escapeProp(props.label)}</span>` : ''}\r\n        ${renderTextareaControl(props)}\r\n      </label>\r\n    `,\r\n  });\r\n\r\n  component<{ label: string; checked: boolean; disabled: boolean }>(tags.checkbox, {\r\n    props: {\r\n      label: { type: String, default: '' },\r\n      checked: { type: Boolean, default: false },\r\n      disabled: { type: Boolean, default: false },\r\n    },\r\n    styles: `\r\n      ${baseStyles}\r\n      label {\r\n        align-items: center;\r\n        color: #0f172a;\r\n        cursor: pointer;\r\n        display: inline-flex;\r\n        gap: 0.625rem;\r\n      }\r\n      input {\r\n        accent-color: #2563eb;\r\n        block-size: 1rem;\r\n        inline-size: 1rem;\r\n      }\r\n      input:disabled {\r\n        cursor: not-allowed;\r\n      }\r\n    `,\r\n    connected() {\r\n      const handleChange = (event: Event) => {\r\n        const target = event.target as HTMLInputElement | null;\r\n        if (!target?.matches('input[type=\"checkbox\"]')) return;\r\n        event.stopPropagation();\r\n        if (target.checked) {\r\n          this.setAttribute('checked', 'true');\r\n        } else {\r\n          this.removeAttribute('checked');\r\n        }\r\n        this.dispatchEvent(\r\n          new CustomEvent('change', {\r\n            detail: { checked: target.checked },\r\n            bubbles: true,\r\n            composed: true,\r\n          })\r\n        );\r\n      };\r\n      storeHandler(this, '__bqueryCheckboxHandler', handleChange);\r\n      this.shadowRoot?.addEventListener('change', handleChange);\r\n    },\r\n    disconnected() {\r\n      const handleChange = readHandler(this, '__bqueryCheckboxHandler');\r\n      if (handleChange) {\r\n        this.shadowRoot?.removeEventListener('change', handleChange);\r\n      }\r\n    },\r\n    render: ({ props }) => html`\r\n      <label part=\"label\">\r\n        <input\r\n          part=\"control\"\r\n          type=\"checkbox\"\r\n          ${props.checked ? 'checked' : ''}\r\n          ${props.disabled ? 'disabled' : ''}\r\n        />\r\n        <span part=\"text\"><slot>${escapeProp(props.label)}</slot></span>\r\n      </label>\r\n    `,\r\n  });\r\n\r\n  return tags;\r\n};\r\n"],"mappings":"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"}

package/dist/component.es.mjs

@@ -1,186 +1,8 @@
-import { s as h } from "./sanitize-1FBEPAFH.js";
-const p = (e, r) => {
-  const { type: s } = r;
-  if (s === String) return e;
-  if (s === Number)
-    return Number(e);
-  if (s === Boolean) {
-    const c = e.trim().toLowerCase();
-    return c === "" || c === "true" || c === "1" ? !0 : c === "false" || c === "0" ? !1 : !!e;
-  }
-  if (s === Object || s === Array)
-    try {
-      return JSON.parse(e);
-    } catch {
-      return e;
-    }
-  if (typeof s == "function") {
-    const c = s, t = s;
-    if (r.construct === !0)
-      return Reflect.construct(t, [e]);
-    if (r.construct === !1)
-      return c(e);
-    const o = s.prototype !== void 0 && s.prototype !== null, u = (o ? Object.getOwnPropertyNames(s.prototype) : []).length > 1, n = o && s.prototype.constructor !== s, l = /^class\s/.test(Function.prototype.toString.call(s));
-    if (u || n || l)
-      try {
-        return Reflect.construct(t, [e]);
-      } catch {
-        return c(e);
-      }
-    try {
-      const a = c(e);
-      if (a === void 0 && o)
-        try {
-          return Reflect.construct(t, [e]);
-        } catch {
-          return a;
-        }
-      return a;
-    } catch (a) {
-      if (a instanceof TypeError && /cannot be invoked without 'new'|is not a function/i.test(a.message))
-        return Reflect.construct(t, [e]);
-      throw a;
-    }
-  }
-  return e;
-}, d = (e, r) => {
-  class s extends HTMLElement {
-    constructor() {
-      super(), this.state = { ...r.state ?? {} }, this.props = {}, this.missingRequiredProps = /* @__PURE__ */ new Set(), this.hasMounted = !1, this.attachShadow({ mode: "open" }), this.syncProps();
-    }
-    /**
-     * Returns the list of attributes to observe for changes.
-     */
-    static get observedAttributes() {
-      return Object.keys(r.props ?? {});
-    }
-    /**
-     * Called when the element is added to the DOM.
-     */
-    connectedCallback() {
-      try {
-        if (this.missingRequiredProps.size > 0)
-          return;
-        this.mount();
-      } catch (t) {
-        this.handleError(t);
-      }
-    }
-    /**
-     * Performs the initial mount of the component.
-     * Called when the element is connected and all required props are present.
-     * @internal
-     */
-    mount() {
-      this.hasMounted || (r.beforeMount?.call(this), r.connected?.call(this), this.render(), this.hasMounted = !0);
-    }
-    /**
-     * Called when the element is removed from the DOM.
-     */
-    disconnectedCallback() {
-      try {
-        r.disconnected?.call(this);
-      } catch (t) {
-        this.handleError(t);
-      }
-    }
-    /**
-     * Called when an observed attribute changes.
-     */
-    attributeChangedCallback(t, o, i) {
-      try {
-        this.syncProps(), this.hasMounted ? this.render(!0) : this.isConnected && this.missingRequiredProps.size === 0 && this.mount();
-      } catch (u) {
-        this.handleError(u);
-      }
-    }
-    /**
-     * Handles errors during component lifecycle.
-     * @internal
-     */
-    handleError(t) {
-      r.onError ? r.onError.call(this, t) : console.error(`bQuery component error in <${e}>:`, t);
-    }
-    /**
-     * Updates a state property and triggers a re-render.
-     *
-     * @param key - The state property key
-     * @param value - The new value
-     */
-    setState(t, o) {
-      this.state[t] = o, this.render(!0);
-    }
-    /**
-     * Gets a state property value.
-     *
-     * @param key - The state property key
-     * @returns The current value
-     */
-    getState(t) {
-      return this.state[t];
-    }
-    /**
-     * Synchronizes props from attributes.
-     * @internal
-     */
-    syncProps() {
-      const t = r.props ?? {};
-      for (const [o, i] of Object.entries(t)) {
-        const u = this.getAttribute(o);
-        let n;
-        if (u == null ? i.required && i.default === void 0 ? (this.missingRequiredProps.add(o), n = void 0) : n = i.default ?? void 0 : (this.missingRequiredProps.has(o) && this.missingRequiredProps.delete(o), n = p(u, i)), i.validator && n !== void 0 && !i.validator(n))
-          throw new Error(
-            `bQuery component: validation failed for prop "${o}" with value ${JSON.stringify(n)}`
-          );
-        this.props[o] = n;
-      }
-    }
-    /**
-     * Renders the component to its shadow root.
-     * @internal
-     */
-    render(t = !1) {
-      try {
-        if (t && r.beforeUpdate && r.beforeUpdate.call(this, this.props) === !1)
-          return;
-        const o = (n, l) => {
-          this.dispatchEvent(new CustomEvent(n, { detail: l, bubbles: !0, composed: !0 }));
-        };
-        if (!this.shadowRoot) return;
-        const i = r.render({
-          props: this.props,
-          state: this.state,
-          emit: o
-        }), u = h(i);
-        if (this.shadowRoot.innerHTML = u, r.styles) {
-          const n = document.createElement("style");
-          n.textContent = r.styles, this.shadowRoot.prepend(n);
-        }
-        t && r.updated?.call(this);
-      } catch (o) {
-        this.handleError(o);
-      }
-    }
-  }
-  return s;
-}, b = (e, r) => {
-  const s = d(e, r);
-  customElements.get(e) || customElements.define(e, s);
-}, E = (e, ...r) => e.reduce((s, c, t) => `${s}${c}${r[t] ?? ""}`, ""), g = (e, ...r) => {
-  const s = {
-    "&": "&amp;",
-    "<": "&lt;",
-    ">": "&gt;",
-    '"': "&quot;",
-    "'": "&#x27;",
-    "`": "&#x60;"
-  }, c = (t) => String(t ?? "").replace(/[&<>"'`]/g, (i) => s[i]);
-  return e.reduce((t, o, i) => `${t}${o}${c(r[i])}`, "");
-};
+import { a as t, i as o, n as a, r as n, t as s } from "./component-CY5MVoYN.js";
 export {
-  b as component,
-  d as defineComponent,
-  E as html,
-  g as safeHtml
+  o as component,
+  t as defineComponent,
+  a as html,
+  s as registerDefaultComponents,
+  n as safeHtml
 };
-//# sourceMappingURL=component.es.mjs.map

package/dist/config-DRmZZno3.js

@@ -0,0 +1,40 @@
+import { i as o, r as f } from "./object-qGpWr6-J.js";
+var s = {
+  fetch: {
+    headers: {},
+    parseAs: "json"
+  },
+  cookies: {
+    path: "/",
+    sameSite: "Lax",
+    secure: !1
+  },
+  announcer: {
+    politeness: "polite",
+    atomic: !0,
+    delay: 16,
+    clearDelay: 1e3
+  },
+  pageMeta: {},
+  transitions: {
+    skipOnReducedMotion: !1,
+    classes: [],
+    types: []
+  },
+  components: { prefix: "bq" }
+}, r = (e) => {
+  if (typeof Headers < "u" && e instanceof Headers) return new Headers(e);
+  if (Array.isArray(e)) return e.map((n) => r(n));
+  if (f(e)) {
+    const n = {};
+    for (const [a, i] of Object.entries(e)) n[a] = r(i);
+    return n;
+  }
+  return e;
+}, t = r(s), d = (e) => (t = r(o(s, t, e)), c()), c = () => r(t);
+export {
+  c as n,
+  d as t
+};
+
+//# sourceMappingURL=config-DRmZZno3.js.map

package/dist/config-DRmZZno3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-DRmZZno3.js","names":[],"sources":["../src/platform/config.ts"],"sourcesContent":["/**\r\n * Global bQuery configuration helpers.\r\n *\r\n * @module bquery/platform\r\n */\r\n\r\nimport { isPlainObject, merge } from '../core/utils/object';\r\n\r\n/** Supported response parsing strategies for fetch composables. */\r\nexport type BqueryFetchParseAs = 'json' | 'text' | 'blob' | 'arrayBuffer' | 'formData' | 'response';\r\n\r\n/** Global fetch defaults used by useFetch(). */\r\nexport interface BqueryFetchConfig {\r\n  /** Optional base URL prepended to relative request URLs. */\r\n  baseUrl?: string;\r\n  /** Default request headers. */\r\n  headers?: HeadersInit;\r\n  /** Default response parser. */\r\n  parseAs?: BqueryFetchParseAs;\r\n}\r\n\r\n/** Global cookie defaults used by useCookie(). */\r\nexport interface BqueryCookieConfig {\r\n  /** Default cookie path. */\r\n  path?: string;\r\n  /** Default SameSite mode. */\r\n  sameSite?: 'Strict' | 'Lax' | 'None';\r\n  /** Whether cookies should be marked secure by default. */\r\n  secure?: boolean;\r\n}\r\n\r\n/** Global announcer defaults used by useAnnouncer(). */\r\nexport interface BqueryAnnouncerConfig {\r\n  /** Default politeness level. */\r\n  politeness?: 'polite' | 'assertive';\r\n  /** Whether announcements should be treated atomically. */\r\n  atomic?: boolean;\r\n  /** Delay before writing the message into the live region. */\r\n  delay?: number;\r\n  /** Delay after which the live region is cleared automatically. */\r\n  clearDelay?: number;\r\n}\r\n\r\n/** Global page meta defaults used by definePageMeta(). */\r\nexport interface BqueryPageMetaConfig {\r\n  /** Optional title template function. */\r\n  titleTemplate?: (title: string) => string;\r\n}\r\n\r\n/** Global motion defaults used by transition(). */\r\nexport interface BqueryTransitionConfig {\r\n  /** Skip transitions when reduced motion is preferred. */\r\n  skipOnReducedMotion?: boolean;\r\n  /** Classes applied to the root element during transitions. */\r\n  classes?: string[];\r\n  /** Transition type identifiers added when supported by the browser. */\r\n  types?: string[];\r\n}\r\n\r\n/** Global default component library configuration. */\r\nexport interface BqueryComponentLibraryConfig {\r\n  /** Prefix used by registerDefaultComponents(). */\r\n  prefix?: string;\r\n}\r\n\r\n/** Complete global bQuery configuration object. */\r\nexport interface BqueryConfig {\r\n  /** Fetch composable defaults. */\r\n  fetch?: BqueryFetchConfig;\r\n  /** Cookie composable defaults. */\r\n  cookies?: BqueryCookieConfig;\r\n  /** Announcer composable defaults. */\r\n  announcer?: BqueryAnnouncerConfig;\r\n  /** Page metadata defaults. */\r\n  pageMeta?: BqueryPageMetaConfig;\r\n  /** View transition defaults. */\r\n  transitions?: BqueryTransitionConfig;\r\n  /** Default component library options. */\r\n  components?: BqueryComponentLibraryConfig;\r\n}\r\n\r\nconst defaultConfig: BqueryConfig = {\r\n  fetch: {\r\n    headers: {},\r\n    parseAs: 'json',\r\n  },\r\n  cookies: {\r\n    path: '/',\r\n    sameSite: 'Lax',\r\n    secure: false,\r\n  },\r\n  announcer: {\r\n    politeness: 'polite',\r\n    atomic: true,\r\n    delay: 16,\r\n    clearDelay: 1000,\r\n  },\r\n  pageMeta: {},\r\n  transitions: {\r\n    skipOnReducedMotion: false,\r\n    classes: [],\r\n    types: [],\r\n  },\r\n  components: {\r\n    prefix: 'bq',\r\n  },\r\n};\r\n\r\nconst cloneConfigValue = <T>(value: T): T => {\r\n  if (typeof Headers !== 'undefined' && value instanceof Headers) {\r\n    return new Headers(value) as T;\r\n  }\r\n\r\n  if (Array.isArray(value)) {\r\n    return value.map((entry) => cloneConfigValue(entry)) as T;\r\n  }\r\n\r\n  if (isPlainObject(value)) {\r\n    const result: Record<string, unknown> = {};\r\n    for (const [key, entry] of Object.entries(value)) {\r\n      result[key] = cloneConfigValue(entry);\r\n    }\r\n    return result as T;\r\n  }\r\n\r\n  return value;\r\n};\r\n\r\nlet currentConfig: BqueryConfig = cloneConfigValue(defaultConfig);\r\n\r\n/**\r\n * Define or extend the global bQuery configuration.\r\n *\r\n * @param config - Partial configuration values to merge into the current config\r\n * @returns The resolved configuration after merging\r\n *\r\n * @example\r\n * ```ts\r\n * defineBqueryConfig({\r\n *   fetch: { baseUrl: 'https://api.example.com' },\r\n *   components: { prefix: 'ui' },\r\n * });\r\n * ```\r\n */\r\nexport const defineBqueryConfig = (config: BqueryConfig): BqueryConfig => {\r\n  currentConfig = cloneConfigValue(\r\n    merge(\r\n      defaultConfig as Record<string, unknown>,\r\n      currentConfig as Record<string, unknown>,\r\n      config as Record<string, unknown>\r\n    ) as BqueryConfig\r\n  );\r\n  return getBqueryConfig();\r\n};\r\n\r\n/**\r\n * Get the currently resolved bQuery configuration.\r\n *\r\n * @returns A cloned snapshot of the active configuration\r\n */\r\nexport const getBqueryConfig = (): BqueryConfig => {\r\n  return cloneConfigValue(currentConfig);\r\n};\r\n"],"mappings":";AAiFA,IAAM,IAA8B;AAAA,EAClC,OAAO;AAAA,IACL,SAAS,CAAA;AAAA,IACT,SAAS;AAAA;EAEX,SAAS;AAAA,IACP,MAAM;AAAA,IACN,UAAU;AAAA,IACV,QAAQ;AAAA;EAEV,WAAW;AAAA,IACT,YAAY;AAAA,IACZ,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,YAAY;AAAA;EAEd,UAAU,CAAA;AAAA,EACV,aAAa;AAAA,IACX,qBAAqB;AAAA,IACrB,SAAS,CAAA;AAAA,IACT,OAAO,CAAA;AAAA;EAET,YAAY,EACV,QAAQ,KAAA;GAIN,IAAA,CAAuB,MAAgB;AAC3C,MAAI,OAAO,UAAY,OAAe,aAAiB,QACrD,QAAO,IAAI,QAAQ,CAAA;AAGrB,MAAI,MAAM,QAAQ,CAAA,EAChB,QAAO,EAAM,IAAA,CAAK,MAAU,EAAiB,CAAA,CAAM;AAGrD,MAAI,EAAc,CAAA,GAAQ;AACxB,UAAM,IAAkC,CAAA;AACxC,eAAW,CAAC,GAAK,CAAA,KAAU,OAAO,QAAQ,CAAA,EACxC,CAAA,EAAO,CAAA,IAAO,EAAiB,CAAA;AAEjC,WAAO;AAAA;AAGT,SAAO;GAGL,IAA8B,EAAiB,CAAA,GAgBtC,IAAA,CAAsB,OACjC,IAAgB,EACd,EACE,GACA,GACA,CAAA,CACD,GAEI,EAAA,IAQI,IAAA,MACJ,EAAiB,CAAA"}

package/dist/core/collection.d.ts

@@ -148,13 +148,16 @@ export declare class BQueryCollection {
     /** Insert content after all elements. */
     after(content: InsertableContent): this;
     /**
-     * Applies CSS styles to all elements.
+     * Gets or sets CSS styles on all elements.
+     * When getting, returns the computed style value from the first element.
      *
      * @param property - Property name or object of properties
      * @param value - Value when setting single property
-     * @returns The instance for method chaining
+     * @returns The computed style value when getting, instance when setting
      */
-    css(property: string | Record<string, string>, value?: string): this;
+    css(property: string): string;
+    css(property: string, value: string): this;
+    css(property: Record<string, string>): this;
     /** Wrap each element with a wrapper element or tag. */
     wrap(wrapper: string | Element): this;
     /**
@@ -262,6 +265,19 @@ export declare class BQueryCollection {
      * ```
      */
     undelegate(event: string, selector: string, handler: (event: Event, target: Element) => void): this;
+    /**
+     * Finds all descendant elements matching the selector across all elements
+     * in the collection. Returns a new BQueryCollection with the results.
+     *
+     * @param selector - CSS selector to match
+     * @returns A new BQueryCollection with all matching descendants
+     *
+     * @example
+     * ```ts
+     * $$('.container').find('.item').addClass('highlight');
+     * ```
+     */
+    find(selector: string): BQueryCollection;
     /**
      * Removes all elements from the DOM.
      *

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/element.d.ts

@@ -68,18 +68,23 @@ export declare class BQueryElement {
      *
      * @param property - A CSS property name or an object of property-value pairs
      * @param value - The value when setting a single property
-     * @returns The instance for method chaining
+     * @returns The computed style value when getting a single property, or the instance for method chaining when setting
      *
      * @example
      * ```ts
-     * // Single property
+     * // Get a computed style value
+     * const color = $('#box').css('color');
+     *
+     * // Set a single property
      * $('#box').css('color', 'red');
      *
-     * // Multiple properties
+     * // Set multiple properties
      * $('#box').css({ color: 'red', 'font-size': '16px' });
      * ```
      */
-    css(property: string | Record<string, string>, value?: string): this;
+    css(property: string): string;
+    css(property: string, value: string): this;
+    css(property: Record<string, string>): this;
     /**
      * Appends HTML or elements to the end of the element.
      *
@@ -313,6 +318,20 @@ export declare class BQueryElement {
      * @returns True if the element matches the selector
      */
     matches(selector: string): boolean;
+    /**
+     * Alias for `matches()`. Checks if the element matches a CSS selector.
+     *
+     * @param selector - CSS selector to match against
+     * @returns True if the element matches the selector
+     *
+     * @example
+     * ```ts
+     * if ($('#el').is('.active')) {
+     *   console.log('Element is active');
+     * }
+     * ```
+     */
+    is(selector: string): boolean;
     /**
      * Checks if the element has a specific class.
      *

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

@@ -3,4 +3,5 @@ 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';
+export type { DebouncedFn, ThrottledFn } 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;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"}
+{"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;AACjB,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

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

@@ -3,6 +3,18 @@
  *
  * @module bquery/core/utils/function
  */
+/** A debounced function with a cancel method to clear the pending timeout. */
+export interface DebouncedFn<TArgs extends unknown[]> {
+    (...args: TArgs): void;
+    /** Cancels the pending debounced invocation. */
+    cancel(): void;
+}
+/** A throttled function with a cancel method to reset the throttle timer. */
+export interface ThrottledFn<TArgs extends unknown[]> {
+    (...args: TArgs): void;
+    /** Resets the throttle timer, allowing the next call to execute immediately. */
+    cancel(): void;
+}
 /**
  * Creates a debounced function that delays execution until after
  * the specified delay has elapsed since the last call.
@@ -10,7 +22,7 @@
  * @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
+ * @returns A debounced version of the function with a `cancel()` method
  *
  * @example
  * ```ts
@@ -21,16 +33,19 @@
  * search('h');
  * search('he');
  * search('hello'); // Only this call executes after 300ms
+ *
+ * search('cancel me');
+ * search.cancel(); // Cancels the pending invocation
  * ```
  */
-export declare function debounce<TArgs extends unknown[]>(fn: (...args: TArgs) => void, delayMs: number): (...args: TArgs) => void;
+export declare function debounce<TArgs extends unknown[]>(fn: (...args: TArgs) => void, delayMs: number): DebouncedFn<TArgs>;
 /**
  * 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
+ * @returns A throttled version of the function with a `cancel()` method
  *
  * @example
  * ```ts
@@ -39,9 +54,11 @@ export declare function debounce<TArgs extends unknown[]>(fn: (...args: TArgs) =
  * }, 100);
  *
  * window.addEventListener('scroll', handleScroll);
+ *
+ * handleScroll.cancel(); // Resets throttle, next call executes immediately
  * ```
  */
-export declare function throttle<TArgs extends unknown[]>(fn: (...args: TArgs) => void, intervalMs: number): (...args: TArgs) => void;
+export declare function throttle<TArgs extends unknown[]>(fn: (...args: TArgs) => void, intervalMs: number): ThrottledFn<TArgs>;
 /**
  * Ensures a function only runs once. Subsequent calls return the first result.
  *

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

@@ -1 +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"}
+{"version":3,"file":"function.d.ts","sourceRoot":"","sources":["../../../src/core/utils/function.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8EAA8E;AAC9E,MAAM,WAAW,WAAW,CAAC,KAAK,SAAS,OAAO,EAAE;IAClD,CAAC,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IACvB,gDAAgD;IAChD,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,6EAA6E;AAC7E,MAAM,WAAW,WAAW,CAAC,KAAK,SAAS,OAAO,EAAE;IAClD,CAAC,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IACvB,gFAAgF;IAChF,MAAM,IAAI,IAAI,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,SAAS,OAAO,EAAE,EAC9C,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,IAAI,EAC5B,OAAO,EAAE,MAAM,GACd,WAAW,CAAC,KAAK,CAAC,CAsBpB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,SAAS,OAAO,EAAE,EAC9C,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,IAAI,EAC5B,UAAU,EAAE,MAAM,GACjB,WAAW,CAAC,KAAK,CAAC,CAiBpB;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"}