lume-js 2.1.0 → 2.2.0

package/dist/shared-Dcokqj5a.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"shared-Dcokqj5a.mjs","sources":["../src/utils/log.js","../src/core/state.js","../src/core/effect.js"],"sourcesContent":["/**\n * Environment-safe logging utilities for constrained runtimes\n * (e.g. service workers, embedded engines, SSR environments).\n *\n * All core and addon files should import these instead of\n * calling console.* directly to avoid ReferenceError when\n * console is not defined.\n */\n\nexport function logWarn(msg, ...rest) {\n  if (typeof console !== 'undefined' && typeof console.warn === 'function') {\n    console.warn(msg, ...rest);\n  }\n}\n\nexport function logError(msg, ...rest) {\n  if (typeof console !== 'undefined' && typeof console.error === 'function') {\n    console.error(msg, ...rest);\n  }\n}\n","/**\n * Lume-JS Reactive State Core\n *\n * Provides minimal reactive state with standard JavaScript.\n * Features automatic microtask batching for performance.\n * Read tracking is opt-in via withReadObserver — state.js has zero permanent\n * dependency on effect.js or any other module.\n *\n * Features:\n * - Lightweight and Go-style\n * - Explicit nested states\n * - $subscribe for listening to key changes\n * - Cleanup with unsubscribe\n * - Per-state microtask batching for writes\n * - Scope-based read tracking via withReadObserver (multi-observer safe)\n *\n * Usage:\n *   import { state } from \"lume-js\";\n *\n *   const store = state({ count: 0 });\n *   const unsub = store.$subscribe(\"count\", val => console.log(val));\n *   unsub(); // cleanup\n */\n\nimport { logError } from '../utils/log.js';\n\n// Per-state batching – each state object maintains its own microtask flush.\n// This keeps effects simple and aligned with Lume's minimal philosophy.\n\n/**\n * Creates a reactive state object.\n *\n * @param {Object} obj - Initial state object (must be plain object)\n * @returns {Proxy} Reactive proxy with $subscribe method\n *\n * @example\n * const store = state({ count: 0 });\n */\n\n// Active read observers — only populated during withReadObserver scopes.\n// This keeps state.js pure: tracking only happens when someone explicitly\n// asks to observe reads within a synchronous function call.\n//\n// Note: This Set is module-level, so all reactive state instances and effects\n// within the SAME module instance share it. This is standard behavior for\n// auto-tracking reactive libraries (Vue, MobX, Solid, etc.). Multiple copies\n// of the lume-js module (e.g. from different bundled chunks) each get their\n// own independent Set via ES module / CommonJS isolation.\nconst readers = new Set();\n\n/**\n * Run a function with a read observer active.\n * The observer receives (proxy, key, registerEffect) for every property read.\n * Multiple observers can be active simultaneously (nested effects, devtools, etc.)\n *\n * Internal API — used by effect.js for auto-tracking. May be stabilized\n * for third-party addons in a future release.\n * @param {function} onRead - Called on each property access inside fn\n * @param {function} fn - The function to run under observation\n */\nexport function withReadObserver(onRead, fn) {\n  readers.add(onRead);\n  try {\n    return fn();\n  } finally {\n    readers.delete(onRead);\n  }\n}\n\nexport function state(obj) {\n  // Validate input\n  if (!obj || typeof obj !== 'object' || Array.isArray(obj)) {\n    throw new Error('state() requires a plain object');\n  }\n  if (Object.isFrozen(obj) || Object.isSealed(obj)) {\n    throw new Error('state() requires a mutable plain object');\n  }\n\n  // Object.create(null) - no prototype chain lookups\n  const listeners = Object.create(null);\n  const pendingNotifications = new Map(); // Per-state pending changes\n  const pendingEffects = new Set(); // Dedupe effects per state\n  const beforeFlushHooks = [];\n  let flushScheduled = false;\n\n  /**\n   * Schedule a single microtask flush for this state object.\n   *\n   * Flush order per state:\n   * 1) Notify subscribers for changed keys (key → subscribers)\n   * 2) Run each queued effect exactly once (Set-based dedupe)\n   * 3) Repeat up to 100 iterations to handle cascading updates,\n   *    then log an error to prevent infinite loops.\n   *\n   * Notes:\n   * - Batching is per state; effects that depend on multiple states\n   *   may run once per state that changed (by design).\n   */\n  function scheduleFlush() {\n    if (flushScheduled) return;\n\n    flushScheduled = true;\n    queueMicrotask(() => {\n      let iterations = 0;\n      const MAX_ITERATIONS = 100;\n\n      try {\n        while ((pendingNotifications.size > 0 || pendingEffects.size > 0) && iterations < MAX_ITERATIONS) {\n          iterations++;\n\n          // Run registered before-flush hooks (e.g. plugin onNotify)\n          for (let i = 0; i < beforeFlushHooks.length; i++) {\n            try {\n              beforeFlushHooks[i]();\n            } catch (err) {\n              logError('[Lume.js state] Error in beforeFlush hook:', err);\n            }\n          }\n\n          // Notify all subscribers of changed keys\n          for (const [key, value] of pendingNotifications) {\n            if (listeners[key]) {\n              const subs = listeners[key];\n              let i = 0;\n              while (i < subs.length) {\n                const fn = subs[i];\n                try {\n                  fn(value);\n                } catch (err) {\n                  logError(`[Lume.js state] Error notifying subscriber for key \"${String(key)}\":`, err);\n                }\n                // Only advance if fn wasn't removed (something shifted into its place)\n                if (subs[i] === fn) i++;\n              }\n            }\n          }\n\n          pendingNotifications.clear();\n\n          // Run each effect exactly once (Set deduplicates)\n          const effects = new Array(pendingEffects.size);\n          let idx = 0;\n          for (const effect of pendingEffects) {\n            effects[idx++] = effect;\n          }\n          pendingEffects.clear();\n          for (let i = 0; i < effects.length; i++) {\n            try {\n              effects[i]();\n            } catch (err) {\n              logError('[Lume.js state] Error in effect:', err);\n            }\n          }\n        }\n      } finally {\n        flushScheduled = false;\n      }\n\n      if (iterations >= MAX_ITERATIONS) {\n        logError(\n          '[Lume.js state] Maximum flush iterations reached (100). ' +\n          'This usually indicates an infinite loop caused by an effect or computed mutating state it depends on.'\n        );\n      }\n    });\n  }\n\n  // Brand symbol for type-level reactive identification\n  const REACTIVE_BRAND = Symbol('lume.reactive');\n  obj[REACTIVE_BRAND] = true;\n\n  // Defined once per state instance — not per property read — to avoid per-read closure allocation.\n  const registerEffect = (key, executeFn) => {\n    if (!listeners[key]) listeners[key] = [];\n\n    const callback = () => {\n      pendingEffects.add(executeFn);\n    };\n\n    listeners[key].push(callback);\n\n    return () => {\n      if (listeners[key]) {\n        const idx = listeners[key].indexOf(callback);\n        if (idx !== -1) {\n          listeners[key].splice(idx, 1);\n          if (listeners[key].length === 0) delete listeners[key];\n        }\n      }\n    };\n  };\n\n  const proxy = new Proxy(obj, {\n    get(target, key) {\n      // Skip effect tracking for internal meta methods (e.g. $subscribe)\n      if (typeof key === 'string' && key.startsWith('$')) {\n        return target[key];\n      }\n\n      const value = target[key];\n\n      // Notify active read observers (effects, devtools, etc.)\n      if (readers.size > 0) {\n        for (const reader of readers) {\n          reader(proxy, key, registerEffect);\n        }\n      }\n\n      return value;\n    },\n\n    set(target, key, value) {\n      const oldValue = target[key];\n\n      // Skip update if value unchanged - Object.is() handles NaN and -0 correctly\n      if (Object.is(oldValue, value)) return true;\n\n      target[key] = value;\n\n      // Batch notifications at the state level (per-state, not global)\n      pendingNotifications.set(key, value);\n      scheduleFlush();\n\n      return true;\n    }\n  });\n\n  /**\n   * Subscribe to changes for a specific key.\n   * Calls the callback immediately with the current value.\n   * Returns an unsubscribe function for cleanup.\n   *\n   * @param {string} key - Property key to watch\n   * @param {function} fn - Callback function\n   * @returns {function} Unsubscribe function\n   */\n  // Set on obj (not proxy) to avoid triggering the set trap.\n  // The get trap already returns target[key] directly for $-prefixed keys.\n  /**\n   * Register a callback to run before each flush.\n   * Returns an unsubscribe function.\n   */\n  obj.$beforeFlush = (fn) => {\n    if (typeof fn !== 'function') {\n      throw new Error('$beforeFlush requires a function');\n    }\n    if (beforeFlushHooks.indexOf(fn) === -1) {\n      beforeFlushHooks.push(fn);\n    }\n    return () => {\n      const idx = beforeFlushHooks.indexOf(fn);\n      if (idx !== -1) {\n        beforeFlushHooks.splice(idx, 1);\n      }\n    };\n  };\n\n  obj.$subscribe = (key, fn) => {\n    if (typeof fn !== 'function') {\n      throw new Error('Subscriber must be a function');\n    }\n\n    if (!listeners[key]) listeners[key] = [];\n    listeners[key].push(fn);\n\n    // Call immediately with current value (NOT batched)\n    fn(proxy[key]);\n\n    // Return unsubscribe function\n    return () => {\n      if (listeners[key]) {\n        const idx = listeners[key].indexOf(fn);\n        if (idx !== -1) {\n          listeners[key].splice(idx, 1);\n          if (listeners[key].length === 0) delete listeners[key];\n        }\n      }\n    };\n  };\n\n  return proxy;\n}\n","import { withReadObserver } from './state.js';\nimport { logError } from '../utils/log.js';\n\n/**\n * Lume-JS Effect\n *\n * Reactive effects with two modes:\n * 1. Auto-tracking (default): Tracks dependencies automatically via withReadObserver\n * 2. Explicit deps: You specify exactly what triggers re-runs\n *\n * Auto-tracking uses scope-based read observation — state.js has zero permanent\n * dependency on this module. Read tracking is only active during the synchronous\n * execution of an effect's body.\n *\n * Usage:\n *   import { effect } from \"lume-js\";\n *\n *   // Auto-tracking mode (existing behavior)\n *   effect(() => {\n *     console.log('Count is:', store.count);\n *     // Automatically re-runs when store.count changes\n *   });\n *\n *   // Explicit deps mode (new - no magic)\n *   effect(() => {\n *     console.log('Count is:', store.count);\n *   }, [[store, 'count']]);  // Only re-runs when store.count changes\n *\n * Features:\n * - Automatic dependency collection via withReadObserver scope (default)\n * - Explicit dependencies for side-effects\n * - Returns cleanup function\n * - Compatible with per-state batching\n */\n\n// Module-scoped effect context (prevents third-party spoofing via globalThis)\nlet currentEffect = null;\n\n// withReadObserver is used below to scope read tracking to synchronous effect execution.\n\n/**\n * Creates an effect that runs reactively\n *\n * @param {function} fn - Function to run reactively\n * @param {Array<[object, string]>} [deps] - Optional explicit dependencies as [store, key] tuples\n * @returns {function} Cleanup function to stop the effect\n *\n * @example\n * // Auto-tracking (default)\n * const store = state({ count: 0 });\n * effect(() => {\n *   document.title = `Count: ${store.count}`;\n * });\n * \n * @example\n * // Explicit deps (no magic)\n * effect(() => {\n *   analytics.log(store.count);  // Won't track store.count automatically\n * }, [[store, 'count']]);        // Explicit: only re-run on store.count\n */\nexport function effect(fn, deps) {\n  if (typeof fn !== 'function') {\n    throw new Error('effect() requires a function');\n  }\n\n  const cleanups = [];\n  let isRunning = false;\n\n  /**\n   * Execute the effect function\n   */\n  const execute = () => {\n    /* v8 ignore next -- re-entry guard: unreachable because $subscribe fires via microtask after isRunning resets in finally */\n    if (isRunning) return;\n    isRunning = true;\n\n    try {\n      fn();\n    } catch (error) {\n      logError('[Lume.js effect] Error in effect:', error);\n      throw error;\n    } finally {\n      isRunning = false;\n    }\n  };\n\n  // EXPLICIT DEPS MODE: deps array provided\n  if (Array.isArray(deps)) {\n    // Subscribe to each [store, key1, key2, ...] tuple explicitly\n    for (const dep of deps) {\n      if (Array.isArray(dep) && dep.length >= 2) {\n        const [store, ...keys] = dep;\n        if (store && typeof store.$subscribe === 'function') {\n          // Subscribe to each key in this tuple\n          for (const key of keys) {\n            // $subscribe calls immediately, then on changes\n            // We want: call execute immediately once, then on changes\n            let isFirst = true;\n            const unsub = store.$subscribe(key, () => {\n              if (isFirst) {\n                isFirst = false;\n                return; // Skip first call, we'll run execute() below\n              }\n              execute();\n            });\n            cleanups.push(unsub);\n          }\n        }\n      }\n    }\n    // Run immediately\n    execute();\n  }\n  // AUTO-TRACKING MODE: no deps (existing behavior)\n  else {\n    const executeWithTracking = () => {\n      /* v8 ignore next -- defensive guard: synchronous re-entry is unreachable through the public API */\n      if (isRunning) return;\n\n      // Save previous subscriptions instead of cleaning immediately.\n      // If fn() doesn't read any state (early return / error), we restore\n      // them so the effect stays reactive.\n      const oldCleanups = cleanups.splice(0);\n\n      // Create effect context for tracking\n      const myContext = {\n        fn,\n        cleanups,\n        execute: executeWithTracking,\n        tracking: {}\n      };\n\n      // Set as current effect (for state.js to detect)\n      // Save previous context to support nested effects/computed\n      const previousEffect = currentEffect;\n      currentEffect = myContext;\n      isRunning = true;\n\n      try {\n        const onRead = (proxy, key, registerEffect) => {\n          // Only the currently active effect (not a nested one) creates subscriptions\n          if (currentEffect !== myContext) return;\n          if (myContext.tracking[key]) return;\n          myContext.tracking[key] = true;\n          myContext.cleanups.push(registerEffect(key, myContext.execute));\n        };\n        withReadObserver(onRead, fn);\n      } catch (error) {\n        // On error, restore old subscriptions so the effect stays reactive\n        cleanups.length = 0;\n        cleanups.push(...oldCleanups);\n        logError('[Lume.js effect] Error in effect:', error);\n        throw error;\n      } finally {\n        // Restore previous context (not undefined) to support nesting\n        currentEffect = previousEffect;\n        isRunning = false;\n      }\n\n      // If fn() created new subscriptions, clean old ones.\n      // If it didn't (e.g., early return), keep old subscriptions intact.\n      if (cleanups.length > 0) {\n        for (const cleanup of oldCleanups) cleanup();\n      } else {\n        cleanups.push(...oldCleanups);\n      }\n    };\n\n    // Run immediately to collect initial dependencies\n    executeWithTracking();\n  }\n\n  // Return cleanup function\n  return () => {\n    // while/pop is faster than forEach\n    while (cleanups.length) cleanups.pop()();\n  };\n}"],"names":["effect"],"mappings":"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"}
+{"version":3,"file":"shared-Dcokqj5a.mjs","sources":["../src/utils/log.js","../src/core/state.js","../src/core/effect.js"],"sourcesContent":["/**\n * Environment-safe logging utilities for constrained runtimes\n * (e.g. service workers, embedded engines, SSR environments).\n *\n * All core and addon files should import these instead of\n * calling console.* directly to avoid ReferenceError when\n * console is not defined.\n */\n\nexport function logWarn(msg, ...rest) {\n  if (typeof console !== 'undefined' && typeof console.warn === 'function') {\n    console.warn(msg, ...rest);\n  }\n}\n\nexport function logError(msg, ...rest) {\n  if (typeof console !== 'undefined' && typeof console.error === 'function') {\n    console.error(msg, ...rest);\n  }\n}\n","/**\n * Lume-JS Reactive State Core\n *\n * Provides minimal reactive state with standard JavaScript.\n * Features automatic microtask batching for performance.\n * Read tracking is opt-in via withReadObserver — state.js has zero permanent\n * dependency on effect.js or any other module.\n *\n * Features:\n * - Lightweight and Go-style\n * - Explicit nested states\n * - $subscribe for listening to key changes\n * - Cleanup with unsubscribe\n * - Per-state microtask batching for writes\n * - Scope-based read tracking via withReadObserver (multi-observer safe)\n *\n * Usage:\n *   import { state } from \"lume-js\";\n *\n *   const store = state({ count: 0 });\n *   const unsub = store.$subscribe(\"count\", val => console.log(val));\n *   unsub(); // cleanup\n */\n\nimport { logError } from '../utils/log.js';\n\n// Per-state batching – each state object maintains its own microtask flush.\n// This keeps effects simple and aligned with Lume's minimal philosophy.\n\n/**\n * Creates a reactive state object.\n *\n * @param {Object} obj - Initial state object (must be plain object)\n * @returns {Proxy} Reactive proxy with $subscribe method\n *\n * @example\n * const store = state({ count: 0 });\n */\n\n// Active read observers — only populated during withReadObserver scopes.\n// This keeps state.js pure: tracking only happens when someone explicitly\n// asks to observe reads within a synchronous function call.\n//\n// Note: This Set is module-level, so all reactive state instances and effects\n// within the SAME module instance share it. This is standard behavior for\n// auto-tracking reactive libraries (Vue, MobX, Solid, etc.). Multiple copies\n// of the lume-js module (e.g. from different bundled chunks) each get their\n// own independent Set via ES module / CommonJS isolation.\nconst readers = new Set();\n\n/**\n * Run a function with a read observer active.\n * The observer receives (proxy, key, registerEffect) for every property read.\n * Multiple observers can be active simultaneously (nested effects, devtools, etc.)\n *\n * Internal API — used by effect.js for auto-tracking. May be stabilized\n * for third-party addons in a future release.\n * @param {function} onRead - Called on each property access inside fn\n * @param {function} fn - The function to run under observation\n */\nexport function withReadObserver(onRead, fn) {\n  readers.add(onRead);\n  try {\n    return fn();\n  } finally {\n    readers.delete(onRead);\n  }\n}\n\nexport function state(obj) {\n  // Validate input\n  if (!obj || typeof obj !== 'object' || Array.isArray(obj)) {\n    throw new Error('state() requires a plain object');\n  }\n  if (Object.isFrozen(obj) || Object.isSealed(obj)) {\n    throw new Error('state() requires a mutable plain object');\n  }\n\n  // Object.create(null) - no prototype chain lookups\n  const listeners = Object.create(null);\n  const pendingNotifications = new Map(); // Per-state pending changes\n  const pendingEffects = new Set(); // Dedupe effects per state\n  const beforeFlushHooks = [];\n  let flushScheduled = false;\n\n  /**\n   * Schedule a single microtask flush for this state object.\n   *\n   * Flush order per state:\n   * 1) Notify subscribers for changed keys (key → subscribers)\n   * 2) Run each queued effect exactly once (Set-based dedupe)\n   * 3) Repeat up to 100 iterations to handle cascading updates,\n   *    then log an error to prevent infinite loops.\n   *\n   * Notes:\n   * - Batching is per state; effects that depend on multiple states\n   *   may run once per state that changed (by design).\n   */\n  function scheduleFlush() {\n    if (flushScheduled) return;\n\n    flushScheduled = true;\n    // eslint-disable-next-line sonarjs/cognitive-complexity -- single-pass flush loop: hooks → subscribers → effects → cycle detection; must stay atomic\n    queueMicrotask(() => {\n      let iterations = 0;\n      const MAX_ITERATIONS = 100;\n\n      try {\n        while ((pendingNotifications.size > 0 || pendingEffects.size > 0) && iterations < MAX_ITERATIONS) {\n          iterations++;\n\n          // Run registered before-flush hooks (e.g. plugin onNotify)\n          for (let i = 0; i < beforeFlushHooks.length; i++) {\n            try {\n              beforeFlushHooks[i]();\n            } catch (err) {\n              logError('[Lume.js state] Error in beforeFlush hook:', err);\n            }\n          }\n\n          // Notify all subscribers of changed keys\n          for (const [key, value] of pendingNotifications) {\n            if (listeners[key]) {\n              const subs = listeners[key];\n              let i = 0;\n              while (i < subs.length) {\n                const fn = subs[i];\n                try {\n                  fn(value);\n                } catch (err) {\n                  logError(`[Lume.js state] Error notifying subscriber for key \"${String(key)}\":`, err);\n                }\n                // Only advance if fn wasn't removed (something shifted into its place)\n                if (subs[i] === fn) i++;\n              }\n            }\n          }\n\n          pendingNotifications.clear();\n\n          // Run each effect exactly once (Set deduplicates)\n          const effects = new Array(pendingEffects.size);\n          let idx = 0;\n          for (const effect of pendingEffects) {\n            effects[idx++] = effect;\n          }\n          pendingEffects.clear();\n          for (let i = 0; i < effects.length; i++) {\n            try {\n              effects[i]();\n            } catch (err) {\n              logError('[Lume.js state] Error in effect:', err);\n            }\n          }\n        }\n      } finally {\n        flushScheduled = false;\n      }\n\n      if (iterations >= MAX_ITERATIONS) {\n        logError(\n          '[Lume.js state] Maximum flush iterations reached (100). ' +\n          'This usually indicates an infinite loop caused by an effect or computed mutating state it depends on.'\n        );\n      }\n    });\n  }\n\n  // Brand symbol for type-level reactive identification\n  const REACTIVE_BRAND = Symbol('lume.reactive');\n  obj[REACTIVE_BRAND] = true;\n\n  // Defined once per state instance — not per property read — to avoid per-read closure allocation.\n  const registerEffect = (key, executeFn) => {\n    if (!listeners[key]) listeners[key] = [];\n\n    const callback = () => {\n      pendingEffects.add(executeFn);\n    };\n\n    listeners[key].push(callback);\n\n    return () => {\n      if (listeners[key]) {\n        const idx = listeners[key].indexOf(callback);\n        if (idx !== -1) {\n          listeners[key].splice(idx, 1);\n          if (listeners[key].length === 0) delete listeners[key];\n        }\n      }\n    };\n  };\n\n  const proxy = new Proxy(obj, {\n    get(target, key) {\n      // Skip effect tracking for internal meta methods (e.g. $subscribe)\n      if (typeof key === 'string' && key.startsWith('$')) {\n        return target[key];\n      }\n\n      const value = target[key];\n\n      // Notify active read observers (effects, devtools, etc.)\n      if (readers.size > 0) {\n        for (const reader of readers) {\n          reader(proxy, key, registerEffect);\n        }\n      }\n\n      return value;\n    },\n\n    set(target, key, value) {\n      const oldValue = target[key];\n\n      // Skip update if value unchanged - Object.is() handles NaN and -0 correctly\n      if (Object.is(oldValue, value)) return true;\n\n      target[key] = value;\n\n      // Batch notifications at the state level (per-state, not global)\n      pendingNotifications.set(key, value);\n      scheduleFlush();\n\n      return true;\n    }\n  });\n\n  /**\n   * Subscribe to changes for a specific key.\n   * Calls the callback immediately with the current value.\n   * Returns an unsubscribe function for cleanup.\n   *\n   * @param {string} key - Property key to watch\n   * @param {function} fn - Callback function\n   * @returns {function} Unsubscribe function\n   */\n  // Set on obj (not proxy) to avoid triggering the set trap.\n  // The get trap already returns target[key] directly for $-prefixed keys.\n  /**\n   * Register a callback to run before each flush.\n   * Returns an unsubscribe function.\n   */\n  obj.$beforeFlush = (fn) => {\n    if (typeof fn !== 'function') {\n      throw new Error('$beforeFlush requires a function');\n    }\n    if (beforeFlushHooks.indexOf(fn) === -1) {\n      beforeFlushHooks.push(fn);\n    }\n    return () => {\n      const idx = beforeFlushHooks.indexOf(fn);\n      if (idx !== -1) {\n        beforeFlushHooks.splice(idx, 1);\n      }\n    };\n  };\n\n  obj.$subscribe = (key, fn) => {\n    if (typeof fn !== 'function') {\n      throw new Error('Subscriber must be a function');\n    }\n\n    if (!listeners[key]) listeners[key] = [];\n    listeners[key].push(fn);\n\n    // Call immediately with current value (NOT batched)\n    fn(proxy[key]);\n\n    // Return unsubscribe function\n    return () => {\n      if (listeners[key]) {\n        const idx = listeners[key].indexOf(fn);\n        if (idx !== -1) {\n          listeners[key].splice(idx, 1);\n          if (listeners[key].length === 0) delete listeners[key];\n        }\n      }\n    };\n  };\n\n  return proxy;\n}\n","import { withReadObserver } from './state.js';\nimport { logError } from '../utils/log.js';\n\n/**\n * Lume-JS Effect\n *\n * Reactive effects with two modes:\n * 1. Auto-tracking (default): Tracks dependencies automatically via withReadObserver\n * 2. Explicit deps: You specify exactly what triggers re-runs\n *\n * Auto-tracking uses scope-based read observation — state.js has zero permanent\n * dependency on this module. Read tracking is only active during the synchronous\n * execution of an effect's body.\n *\n * Usage:\n *   import { effect } from \"lume-js\";\n *\n *   // Auto-tracking mode (existing behavior)\n *   effect(() => {\n *     console.log('Count is:', store.count);\n *     // Automatically re-runs when store.count changes\n *   });\n *\n *   // Explicit deps mode (new - no magic)\n *   effect(() => {\n *     console.log('Count is:', store.count);\n *   }, [[store, 'count']]);  // Only re-runs when store.count changes\n *\n * Features:\n * - Automatic dependency collection via withReadObserver scope (default)\n * - Explicit dependencies for side-effects\n * - Returns cleanup function\n * - Compatible with per-state batching\n */\n\n// Module-scoped effect context (prevents third-party spoofing via globalThis)\nlet currentEffect = null;\n\n// withReadObserver is used below to scope read tracking to synchronous effect execution.\n\n/**\n * Creates an effect that runs reactively\n *\n * @param {function} fn - Function to run reactively\n * @param {Array<[object, string]>} [deps] - Optional explicit dependencies as [store, key] tuples\n * @returns {function} Cleanup function to stop the effect\n *\n * @example\n * // Auto-tracking (default)\n * const store = state({ count: 0 });\n * effect(() => {\n *   document.title = `Count: ${store.count}`;\n * });\n * \n * @example\n * // Explicit deps (no magic)\n * effect(() => {\n *   analytics.log(store.count);  // Won't track store.count automatically\n * }, [[store, 'count']]);        // Explicit: only re-run on store.count\n */\n// eslint-disable-next-line sonarjs/cognitive-complexity -- handles both auto-tracking and explicit-deps modes with cleanup; splitting would require exporting internal state\nexport function effect(fn, deps) {\n  if (typeof fn !== 'function') {\n    throw new Error('effect() requires a function');\n  }\n\n  const cleanups = [];\n  let isRunning = false;\n\n  /**\n   * Execute the effect function\n   */\n  const execute = () => {\n    /* v8 ignore next -- re-entry guard: unreachable because $subscribe fires via microtask after isRunning resets in finally */\n    if (isRunning) return;\n    isRunning = true;\n\n    try {\n      fn();\n    } catch (error) {\n      logError('[Lume.js effect] Error in effect:', error);\n      throw error;\n    } finally {\n      isRunning = false;\n    }\n  };\n\n  // EXPLICIT DEPS MODE: deps array provided\n  if (Array.isArray(deps)) {\n    // Subscribe to each [store, key1, key2, ...] tuple explicitly\n    for (const dep of deps) {\n      if (Array.isArray(dep) && dep.length >= 2) {\n        const [store, ...keys] = dep;\n        if (store && typeof store.$subscribe === 'function') {\n          // Subscribe to each key in this tuple\n          for (const key of keys) {\n            // $subscribe calls immediately, then on changes\n            // We want: call execute immediately once, then on changes\n            let isFirst = true;\n            const unsub = store.$subscribe(key, () => {\n              if (isFirst) {\n                isFirst = false;\n                return; // Skip first call, we'll run execute() below\n              }\n              execute();\n            });\n            cleanups.push(unsub);\n          }\n        }\n      }\n    }\n    // Run immediately\n    execute();\n  }\n  // AUTO-TRACKING MODE: no deps (existing behavior)\n  else {\n    const executeWithTracking = () => {\n      /* v8 ignore next -- defensive guard: synchronous re-entry is unreachable through the public API */\n      if (isRunning) return;\n\n      // Save previous subscriptions instead of cleaning immediately.\n      // If fn() doesn't read any state (early return / error), we restore\n      // them so the effect stays reactive.\n      const oldCleanups = cleanups.splice(0);\n\n      // Create effect context for tracking\n      const myContext = {\n        fn,\n        cleanups,\n        execute: executeWithTracking,\n        tracking: {}\n      };\n\n      // Set as current effect (for state.js to detect)\n      // Save previous context to support nested effects/computed\n      const previousEffect = currentEffect;\n      currentEffect = myContext;\n      isRunning = true;\n\n      try {\n        const onRead = (proxy, key, registerEffect) => {\n          // Only the currently active effect (not a nested one) creates subscriptions\n          if (currentEffect !== myContext) return;\n          if (myContext.tracking[key]) return;\n          myContext.tracking[key] = true;\n          myContext.cleanups.push(registerEffect(key, myContext.execute));\n        };\n        withReadObserver(onRead, fn);\n      } catch (error) {\n        // On error, restore old subscriptions so the effect stays reactive\n        cleanups.length = 0;\n        cleanups.push(...oldCleanups);\n        logError('[Lume.js effect] Error in effect:', error);\n        throw error;\n      } finally {\n        // Restore previous context (not undefined) to support nesting\n        currentEffect = previousEffect;\n        isRunning = false;\n      }\n\n      // If fn() created new subscriptions, clean old ones.\n      // If it didn't (e.g., early return), keep old subscriptions intact.\n      if (cleanups.length > 0) {\n        for (const cleanup of oldCleanups) cleanup();\n      } else {\n        cleanups.push(...oldCleanups);\n      }\n    };\n\n    // Run immediately to collect initial dependencies\n    executeWithTracking();\n  }\n\n  // Return cleanup function\n  return () => {\n    // while/pop is faster than forEach\n    while (cleanups.length) cleanups.pop()();\n  };\n}"],"names":["effect"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lume-js",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Minimal reactive state management using only standard JavaScript and HTML - no custom syntax, no build step required",
   "main": "dist/index.mjs",
   "module": "dist/index.mjs",
@@ -28,15 +28,19 @@
     "dev": "vite",
     "dev:site": "node scripts/build-site-assets.js && vite -c vite.site.config.js",
     "build:site": "node scripts/build-site-assets.js && vite build -c vite.site.config.js",
-    "preview:site": "node scripts/build-site-assets.js && vite build -c vite.site.config.js --base / && vite preview -c vite.site.config.js",
+    "preview:site": "node scripts/build-site-assets.js && vite build -c vite.site.config.js --base / && vite preview -c vite.site.config.js --base /",
     "build": "node scripts/build.js",
-    "size": "node scripts/check-size.js",
+    "size": "npm run build && node scripts/check-size.js",
+    "size:ci": "node scripts/check-size.js",
+    "bench": "npm run build && node scripts/bench-core.js",
+    "complexity": "node scripts/complexity.js",
+    "lint": "eslint src/",
     "test": "vitest run",
     "test:watch": "vitest",
     "coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit",
-    "validate": "npm run size && npm run typecheck && npm test",
-    "prepublishOnly": "npm run build && npm run validate"
+    "validate": "npm run build && node scripts/check-size.js && node scripts/complexity.js && npm run lint && npm run typecheck && npm run coverage",
+    "prepublishOnly": "npm run validate"
   },
   "files": [
     "dist",
@@ -78,6 +82,8 @@
     "@tailwindcss/typography": "^0.5.19",
     "@vitest/coverage-v8": "^2.1.4",
     "autoprefixer": "^10.4.22",
+    "eslint": "^10.3.0",
+    "eslint-plugin-sonarjs": "^4.0.3",
     "highlight.js": "^11.11.1",
     "jsdom": "^25.0.1",
     "marked": "^17.0.1",
@@ -91,4 +97,4 @@
   "engines": {
     "node": ">=20.19.0"
   }
-}
+}

package/src/addons/index.d.ts

@@ -56,26 +56,44 @@ export interface Computed<T> {
  */
 export function computed<T>(fn: () => T): Computed<T>;
 
+export interface WatchOptions {
+  /**
+   * Whether to call the callback immediately with the current value (default: true).
+   * Set to false to skip the initial call and only react to future changes.
+   */
+  immediate?: boolean;
+}
+
 /**
  * Watch a single key on a reactive state object; convenience wrapper around $subscribe.
- * 
+ *
+ * By default the callback fires immediately with the current value, then on every change.
+ * Pass `{ immediate: false }` to skip the initial call and only react to future changes.
+ *
  * @param store - Reactive state object created with state().
  * @param key - Property key to observe.
- * @param callback - Invoked immediately and on subsequent changes.
+ * @param callback - Called with new value on change (and immediately unless immediate=false).
+ * @param options - Watch options
  * @returns Unsubscribe function for cleanup
  * @throws {Error} If store is not a reactive state object
- * 
+ *
  * @example
  * ```typescript
  * import { state } from 'lume-js';
  * import { watch } from 'lume-js/addons';
- * 
+ *
  * const store = state({ count: 0 });
- * 
+ *
+ * // Fires immediately with 0, then on every change
  * const unwatch = watch(store, 'count', (value) => {
  *   console.log('Count is now:', value);
  * });
- * 
+ *
+ * // Only fires on future changes (not the initial value)
+ * watch(store, 'count', (value) => {
+ *   console.log('Count changed to:', value);
+ * }, { immediate: false });
+ *
  * // Cleanup
  * unwatch();
  * ```
@@ -83,7 +101,8 @@ export function computed<T>(fn: () => T): Computed<T>;
 export function watch<T extends object, K extends keyof T>(
   store: ReactiveState<T>,
   key: K,
-  callback: Subscriber<T[K]>
+  callback: Subscriber<T[K]>,
+  options?: WatchOptions
 ): Unsubscribe;
 
 /**

package/src/addons/repeat.js

@@ -259,6 +259,7 @@ export function repeat(container, store, arrayKey, options) {
     if (restoreScroll) restoreScroll();
   }
 
+  // eslint-disable-next-line sonarjs/cognitive-complexity -- keyed DOM reconciliation: create/reuse/remove nodes, key dedup, scroll/focus preservation
   function updateList() {
     const items = store[arrayKey];
 
@@ -332,6 +333,7 @@ export function repeat(container, store, arrayKey, options) {
       nextEls.push(el);
     }
 
+    // eslint-disable-next-line sonarjs/cognitive-complexity -- DOM cleanup pass: remove stale nodes, call per-item cleanup callbacks, update maps
     applyPreservation(containerEl, () => {
       reconcileDOM(containerEl, nextEls);
 

package/src/addons/watch.js

@@ -3,11 +3,20 @@
  * @param {Object} store - reactive store created with state()
  * @param {string} key - key in store to watch
  * @param {Function} callback - called with new value
+ * @param {Object} [options]
+ * @param {boolean} [options.immediate=true] - call callback immediately with current value
  * @returns {Function} unsubscribe function
  */
-export function watch(store, key, callback) {
+export function watch(store, key, callback, { immediate = true } = {}) {
   if (!store.$subscribe) {
     throw new Error("store must be created with state()");
   }
+  if (!immediate) {
+    let skipped = false;
+    return store.$subscribe(key, (val) => {
+      if (!skipped) { skipped = true; return; }
+      callback(val);
+    });
+  }
   return store.$subscribe(key, callback);
 }

package/src/core/effect.js

@@ -58,6 +58,7 @@ let currentEffect = null;
  *   analytics.log(store.count);  // Won't track store.count automatically
  * }, [[store, 'count']]);        // Explicit: only re-run on store.count
  */
+// eslint-disable-next-line sonarjs/cognitive-complexity -- handles both auto-tracking and explicit-deps modes with cleanup; splitting would require exporting internal state
 export function effect(fn, deps) {
   if (typeof fn !== 'function') {
     throw new Error('effect() requires a function');

package/src/core/state.js

@@ -100,6 +100,7 @@ export function state(obj) {
     if (flushScheduled) return;
 
     flushScheduled = true;
+    // eslint-disable-next-line sonarjs/cognitive-complexity -- single-pass flush loop: hooks → subscribers → effects → cycle detection; must stay atomic
     queueMicrotask(() => {
       let iterations = 0;
       const MAX_ITERATIONS = 100;

package/src/handlers/ariaAttr.js

@@ -0,0 +1,14 @@
+/**
+ * Create a handler for an ARIA attribute.
+ * Coerces value to "true"/"false" string — use stringAttr("aria-X") for token/string ARIA attrs.
+ *
+ * @param {string} name - ARIA name, with or without "aria-" prefix
+ * @returns {{ attr: string, apply: function }}
+ */
+export function ariaAttr(name) {
+  const fullName = name.startsWith('aria-') ? name : `aria-${name}`;
+  return {
+    attr: `data-${fullName}`,
+    apply(el, val) { el.setAttribute(fullName, val ? 'true' : 'false'); }
+  };
+}

package/src/handlers/boolAttr.js

@@ -0,0 +1,14 @@
+/**
+ * Create a handler for any HTML boolean attribute.
+ * Uses toggleAttribute() — works correctly with any attribute name
+ * (readonly, contenteditable, etc.) without worrying about camelCase property names.
+ *
+ * @param {string} name - Attribute name (e.g., 'readonly', 'open', 'contenteditable')
+ * @returns {{ attr: string, apply: function }}
+ */
+export function boolAttr(name) {
+  return {
+    attr: `data-${name}`,
+    apply(el, val) { el.toggleAttribute(name, Boolean(val)); }
+  };
+}

package/src/handlers/className.js

@@ -0,0 +1,5 @@
+/** data-classname="key" → el.className = val || '' */
+export const className = {
+  attr: 'data-classname',
+  apply(el, val) { el.className = val || ''; }
+};

package/src/handlers/classToggle.js

@@ -0,0 +1,14 @@
+/**
+ * Create handlers for CSS class toggling.
+ * Each name creates a handler: data-class-{name}="key" → el.classList.toggle(name, Boolean(val))
+ * Returns an array — pass directly to handlers (auto-flattened by bindDom).
+ *
+ * @param {...string} names - CSS class names to create handlers for
+ * @returns {Array<{ attr: string, apply: function }>}
+ */
+export function classToggle(...names) {
+  return names.map(name => ({
+    attr: `data-class-${name}`,
+    apply(el, val) { el.classList.toggle(name, Boolean(val)); }
+  }));
+}

package/src/handlers/htmlAttrs.js

@@ -0,0 +1,57 @@
+import { show }       from './show.js';
+import { boolAttr }   from './boolAttr.js';
+import { ariaAttr }   from './ariaAttr.js';
+import { stringAttr } from './stringAttr.js';
+
+/** @see https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes#boolean_attributes */
+const BOOL_ATTRS = [
+  'readonly', 'open', 'novalidate', 'formnovalidate', 'multiple',
+  'autofocus', 'autoplay', 'controls', 'loop', 'muted', 'defer',
+  'async', 'reversed', 'selected', 'inert', 'allowfullscreen',
+];
+
+/** @see https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes */
+const STRING_ATTRS = [
+  'href', 'src', 'alt', 'title', 'placeholder', 'action', 'method',
+  'target', 'rel', 'type', 'name', 'role', 'lang', 'tabindex',
+  'pattern', 'min', 'max', 'step', 'minlength', 'maxlength',
+  'width', 'height', 'for', 'form', 'accept', 'autocomplete',
+  'loading', 'decoding', 'inputmode', 'enterkeyhint', 'draggable',
+  'contenteditable', 'spellcheck', 'translate', 'dir', 'id',
+  'poster', 'preload', 'download', 'media', 'sizes', 'srcset',
+  'colspan', 'rowspan', 'scope', 'headers', 'wrap', 'sandbox',
+];
+
+/** ARIA boolean state attributes — coerced to "true"/"false" string. */
+const ARIA_BOOL_ATTRS = [
+  'pressed', 'selected', 'disabled', 'checked', 'invalid', 'required',
+  'busy', 'modal', 'multiselectable', 'multiline', 'readonly', 'atomic',
+];
+
+/** ARIA string/token/numeric attributes — value passed through as-is. */
+const ARIA_STRING_ATTRS = [
+  'current', 'live', 'relevant', 'haspopup',
+  'sort', 'autocomplete', 'orientation',
+  'label', 'describedby', 'labelledby', 'controls', 'owns',
+  'activedescendant', 'errormessage', 'details', 'flowto',
+  'valuenow', 'valuemin', 'valuemax', 'valuetext',
+  'colcount', 'colindex', 'colspan', 'rowcount', 'rowindex', 'rowspan',
+  'level', 'setsize', 'posinset', 'placeholder', 'roledescription',
+  'keyshortcuts', 'braillelabel', 'brailleroledescription',
+];
+
+/**
+ * One-import preset that enables all standard HTML attributes as reactive handlers.
+ * Returns a flat array — pass directly to handlers option.
+ *
+ * @returns {Array<{ attr: string, apply: function }>}
+ */
+export function htmlAttrs() {
+  return [
+    show,
+    ...BOOL_ATTRS.map(name => boolAttr(name)),
+    ...STRING_ATTRS.map(name => stringAttr(name)),
+    ...ARIA_BOOL_ATTRS.map(name => ariaAttr(name)),
+    ...ARIA_STRING_ATTRS.map(name => stringAttr(`aria-${name}`)),
+  ];
+}

package/src/handlers/index.d.ts

@@ -14,6 +14,19 @@ import type { Handler } from '../index.js';
  */
 export const show: Handler;
 
+/**
+ * data-classname="key" → el.className = val (replaces full class string)
+ * Use classToggle() for toggling individual classes.
+ *
+ * @example
+ * ```typescript
+ * bindDom(root, store, { handlers: [className] });
+ * // <div data-classname="cardClass">...</div>
+ * // store.cardClass = 'card card--error card--large';
+ * ```
+ */
+export const className: Handler;
+
 /**
  * Create a handler for any HTML boolean property.
  * Use for properties beyond the built-in hidden/disabled/checked/required.

package/src/handlers/index.js

@@ -19,199 +19,11 @@
  *   { attr: string, apply(el: HTMLElement, val: any): void }
  */
 
-// --- Ready-to-use Handlers ---
-
-/**
- * data-show="key" → el.hidden = !Boolean(val)
- * Shows element when state value is truthy (inverse of built-in data-hidden).
- */
-export const show = {
-  attr: 'data-show',
-  apply(el, val) { el.hidden = !Boolean(val); }
-};
-
-// --- Factory Functions ---
-
-/**
- * Create a handler for any HTML boolean attribute.
- * Uses toggleAttribute() — works correctly with any attribute name
- * (readonly, contenteditable, etc.) without worrying about camelCase property names.
- *
- * Note: built-in boolean handlers (hidden, disabled, checked, required) use
- * property assignment directly. This factory uses toggleAttribute for broader
- * attribute name compatibility.
- *
- * @param {string} name - Attribute name (e.g., 'readonly', 'open', 'contenteditable')
- * @returns {{ attr: string, apply: function }}
- *
- * @example
- * bindDom(root, store, { handlers: [boolAttr('readonly')] });
- * // <input data-readonly="isReadonly" />
- */
-export function boolAttr(name) {
-  return {
-    attr: `data-${name}`,
-    apply(el, val) { el.toggleAttribute(name, Boolean(val)); }
-  };
-}
-
-/**
- * Create a handler for an ARIA attribute.
- * Use for ARIA attrs beyond the built-in aria-expanded/aria-hidden.
- *
- * @param {string} name - ARIA name, with or without "aria-" prefix
- * @returns {{ attr: string, apply: function }}
- *
- * @example
- * bindDom(root, store, { handlers: [ariaAttr('pressed'), ariaAttr('selected')] });
- * // <button data-aria-pressed="isPressed">Toggle</button>
- */
-export function ariaAttr(name) {
-  const fullName = name.startsWith('aria-') ? name : `aria-${name}`;
-  return {
-    attr: `data-${fullName}`,
-    apply(el, val) { el.setAttribute(fullName, val ? 'true' : 'false'); }
-  };
-}
-
-/**
- * Create handlers for CSS class toggling.
- * Each name creates a handler: data-class-{name}="key" → el.classList.toggle(name, Boolean(val))
- *
- * Returns an array — pass directly to handlers (auto-flattened by bindDom).
- *
- * @param {...string} names - CSS class names to create handlers for
- * @returns {Array<{ attr: string, apply: function }>}
- *
- * @example
- * bindDom(root, store, { handlers: [classToggle('active', 'loading', 'error')] });
- * // <div data-class-active="isActive" data-class-loading="isLoading">
- */
-export function classToggle(...names) {
-  return names.map(name => ({
-    attr: `data-class-${name}`,
-    apply(el, val) { el.classList.toggle(name, Boolean(val)); }
-  }));
-}
-
-/**
- * Create a handler for any string attribute (href, src, title, alt, action, etc.)
- * Sets the attribute value as a string. Removes attribute when value is null/undefined.
- *
- * @param {string} name - HTML attribute name (e.g., 'href', 'src', 'title')
- * @returns {{ attr: string, apply: function }}
- *
- * @example
- * bindDom(root, store, { handlers: [stringAttr('href'), stringAttr('src')] });
- * // <a data-href="profileUrl">Profile</a>
- * // <img data-src="imageUrl" />
- */
-export function stringAttr(name) {
-  return {
-    attr: `data-${name}`,
-    apply(el, val) {
-      if (val == null) el.removeAttribute(name);
-      else el.setAttribute(name, String(val));
-    }
-  };
-}
-
-// --- Presets ---
-
-/** Form-related handlers (beyond built-in disabled/checked/required) */
-export const formHandlers = [
-  boolAttr('readonly'),
-];
-
-/** Additional ARIA handlers (beyond built-in aria-expanded/aria-hidden) */
-export const a11yHandlers = [
-  ariaAttr('pressed'),
-  ariaAttr('selected'),
-  ariaAttr('disabled'),
-];
-
-// --- htmlAttrs() — All Standard HTML Attributes ---
-
-/**
- * Standard HTML boolean attributes (beyond built-in hidden/disabled/checked/required).
- * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes#boolean_attributes
- */
-const BOOL_ATTRS = [
-  'readonly', 'open', 'novalidate', 'formnovalidate', 'multiple',
-  'autofocus', 'autoplay', 'controls', 'loop', 'muted', 'defer',
-  'async', 'reversed', 'selected', 'inert', 'allowfullscreen',
-];
-
-/**
- * Standard HTML string attributes.
- * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes
- */
-const STRING_ATTRS = [
-  'href', 'src', 'alt', 'title', 'placeholder', 'action', 'method',
-  'target', 'rel', 'type', 'name', 'role', 'lang', 'tabindex',
-  'pattern', 'min', 'max', 'step', 'minlength', 'maxlength',
-  'width', 'height', 'for', 'form', 'accept', 'autocomplete',
-  'loading', 'decoding', 'inputmode', 'enterkeyhint', 'draggable',
-  'contenteditable', 'spellcheck', 'translate', 'dir', 'id',
-  'poster', 'preload', 'download', 'media', 'sizes', 'srcset',
-  'colspan', 'rowspan', 'scope', 'headers', 'wrap', 'sandbox',
-];
-
-/**
- * ARIA boolean state attributes — toggled between "true" and "false".
- * Use ariaAttr() for these (coerces to "true"/"false" string).
- * @see https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes
- */
-const ARIA_BOOL_ATTRS = [
-  'pressed', 'selected', 'disabled', 'checked', 'invalid', 'required',
-  'busy', 'modal', 'multiselectable', 'multiline', 'readonly', 'atomic',
-];
-
-/**
- * ARIA string/token/numeric attributes — value passed through as-is.
- * Use stringAttr() with "aria-" prefix for these.
- * @see https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes
- */
-const ARIA_STRING_ATTRS = [
-  'current', 'live', 'relevant', 'haspopup',
-  'sort', 'autocomplete', 'orientation',
-  'label', 'describedby', 'labelledby', 'controls', 'owns',
-  'activedescendant', 'errormessage', 'details', 'flowto',
-  'valuenow', 'valuemin', 'valuemax', 'valuetext',
-  'colcount', 'colindex', 'colspan', 'rowcount', 'rowindex', 'rowspan',
-  'level', 'setsize', 'posinset', 'placeholder', 'roledescription',
-  'keyshortcuts', 'braillelabel', 'brailleroledescription',
-];
-
-/**
- * One-import preset that enables all standard HTML attributes as reactive handlers.
- *
- * Includes:
- * - Boolean attributes: readonly, open, autofocus, controls, muted, inert, etc.
- * - String attributes: href, src, alt, title, placeholder, role, tabindex, etc.
- * - ARIA attributes: aria-pressed, aria-label, aria-describedby, aria-valuenow, etc.
- * - Show handler: data-show (inverse of data-hidden)
- *
- * Returns a flat array — pass directly to handlers option.
- *
- * @returns {Array<{ attr: string, apply: function }>}
- *
- * @example
- * import { htmlAttrs } from 'lume-js/handlers';
- *
- * bindDom(document.body, store, { handlers: [htmlAttrs()] });
- * // Now use any data-* attribute:
- * //   <a data-href="url">Link</a>
- * //   <input data-readonly="isLocked" />
- * //   <div data-aria-label="labelText">...</div>
- * //   <div data-show="isVisible">...</div>
- */
-export function htmlAttrs() {
-  return [
-    show,
-    ...BOOL_ATTRS.map(name => boolAttr(name)),
-    ...STRING_ATTRS.map(name => stringAttr(name)),
-    ...ARIA_BOOL_ATTRS.map(name => ariaAttr(name)),
-    ...ARIA_STRING_ATTRS.map(name => stringAttr(`aria-${name}`)),
-  ];
-}
+export { show }                    from './show.js';
+export { className }               from './className.js';
+export { boolAttr }                from './boolAttr.js';
+export { ariaAttr }                from './ariaAttr.js';
+export { classToggle }             from './classToggle.js';
+export { stringAttr }              from './stringAttr.js';
+export { htmlAttrs }               from './htmlAttrs.js';
+export { formHandlers, a11yHandlers } from './presets.js';

package/src/handlers/presets.js

@@ -0,0 +1,14 @@
+import { boolAttr } from './boolAttr.js';
+import { ariaAttr } from './ariaAttr.js';
+
+/** Form-related handlers (beyond built-in disabled/checked/required) */
+export const formHandlers = [
+  boolAttr('readonly'),
+];
+
+/** Additional ARIA handlers (beyond built-in aria-expanded/aria-hidden) */
+export const a11yHandlers = [
+  ariaAttr('pressed'),
+  ariaAttr('selected'),
+  ariaAttr('disabled'),
+];

package/src/handlers/show.js

@@ -0,0 +1,5 @@
+/** data-show="key" → el.hidden = !Boolean(val) */
+export const show = {
+  attr: 'data-show',
+  apply(el, val) { el.hidden = !Boolean(val); }
+};

package/src/handlers/stringAttr.js

@@ -0,0 +1,16 @@
+/**
+ * Create a handler for any string attribute (href, src, title, alt, action, etc.)
+ * Sets the attribute value as a string. Removes the attribute when value is null/undefined.
+ *
+ * @param {string} name - HTML attribute name (e.g., 'href', 'src', 'title')
+ * @returns {{ attr: string, apply: function }}
+ */
+export function stringAttr(name) {
+  return {
+    attr: `data-${name}`,
+    apply(el, val) {
+      if (val == null) el.removeAttribute(name);
+      else el.setAttribute(name, String(val));
+    }
+  };
+}