lume-js 2.0.1 → 2.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +54 -11
- package/dist/addons.min.mjs +1 -1
- package/dist/addons.mjs +61 -2
- package/dist/addons.mjs.map +1 -1
- package/dist/handlers.min.mjs +1 -1
- package/dist/handlers.mjs +15 -8
- package/dist/handlers.mjs.map +1 -1
- package/dist/lume.global.js +1 -1
- package/dist/lume.global.js.map +1 -1
- package/dist/shared-Dcokqj5a.mjs.map +1 -1
- package/package.json +12 -5
- package/src/addons/index.d.ts +26 -7
- package/src/addons/repeat.js +63 -3
- package/src/addons/watch.js +10 -1
- package/src/core/effect.js +1 -0
- package/src/core/state.js +1 -0
- package/src/handlers/ariaAttr.js +14 -0
- package/src/handlers/boolAttr.js +14 -0
- package/src/handlers/className.js +5 -0
- package/src/handlers/classToggle.js +14 -0
- package/src/handlers/htmlAttrs.js +57 -0
- package/src/handlers/index.d.ts +13 -0
- package/src/handlers/index.js +8 -196
- package/src/handlers/presets.js +14 -0
- package/src/handlers/show.js +5 -0
- package/src/handlers/stringAttr.js +16 -0
package/dist/lume.global.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"lume.global.js","sources":["../src/utils/log.js","../src/core/state.js","../src/core/bindDom.js","../src/core/effect.js","../src/addons/repeat.js","../src/addons/debug.js","../src/handlers/index.js","../src/addons/computed.js","../src/addons/cleanupGroup.js","../src/addons/hydrateState.js","../src/addons/index.js","../src/addons/watch.js","../src/addons/withPlugins.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","// src/core/bindDom.js\n/**\n * Lume-JS DOM Binding\n *\n * Binds reactive state to DOM elements using data-* attributes.\n *\n * Built-in attributes (always available):\n * data-bind=\"key\" → Two-way binding for inputs, textContent for others\n * data-hidden=\"key\" → Toggles hidden (truthy = hidden)\n * data-disabled=\"key\" → Toggles disabled (truthy = disabled)\n * data-checked=\"key\" → Toggles checked (for checkboxes/radios)\n * data-required=\"key\" → Toggles required (truthy = required)\n * data-aria-expanded=\"key\" → Sets aria-expanded to \"true\"/\"false\"\n * data-aria-hidden=\"key\" → Sets aria-hidden to \"true\"/\"false\"\n *\n * Extensible via handlers option:\n * import { show, classToggle } from 'lume-js/handlers';\n * bindDom(root, store, { handlers: [show, classToggle('active')] });\n *\n * Custom handlers:\n * const tooltip = { attr: 'data-tooltip', apply(el, val) { el.title = val ?? ''; } };\n * bindDom(root, store, { handlers: [tooltip] });\n *\n * Usage:\n * import { bindDom } from \"lume-js\";\n * const cleanup = bindDom(document.body, store);\n */\n\nimport { logWarn } from '../utils/log.js';\n\n// --- Default Handlers (always active, backwards compatible) ---\n\nconst boolHandler = (name) => ({\n attr: `data-${name}`,\n apply(el, val) { el[name] = Boolean(val); }\n});\n\nconst ariaHandler = (name) => ({\n attr: `data-${name}`,\n apply(el, val) { el.setAttribute(name, val ? 'true' : 'false'); }\n});\n\nconst DEFAULT_HANDLERS = [\n boolHandler('hidden'),\n boolHandler('disabled'),\n boolHandler('checked'),\n boolHandler('required'),\n ariaHandler('aria-expanded'),\n ariaHandler('aria-hidden'),\n];\n\n/**\n * Merge default and user handlers.\n * User handlers override defaults with same attr (Map deduplicates).\n * User handler arrays are flattened one level (supports classToggle()).\n */\nfunction mergeHandlers(defaults, userHandlers) {\n if (!userHandlers.length) return defaults;\n const merged = new Map();\n for (const h of defaults) merged.set(h.attr, h);\n for (const h of userHandlers.flat()) merged.set(h.attr, h);\n return [...merged.values()];\n}\n\n/**\n * DOM binding for reactive state\n */\nexport function bindDom(root, store, options = {}) {\n if (!(root instanceof HTMLElement)) {\n throw new Error('bindDom() requires a valid HTMLElement as root');\n }\n if (!store || typeof store !== 'object') {\n throw new Error('bindDom() requires a reactive state object');\n }\n\n const { immediate = false, handlers: userHandlers = [] } = options;\n const handlers = mergeHandlers(DEFAULT_HANDLERS, userHandlers);\n\n const performBinding = () => {\n const cleanups = [];\n const bindingMap = new WeakMap();\n\n // Build compiled selector: data-bind (always) + all handler attrs\n const selector = ['[data-bind]', ...handlers.map(h => `[${h.attr}]`)].join(',');\n const elements = root.querySelectorAll(selector);\n\n for (const el of elements) {\n // data-bind (two-way) — always in core, special handling\n if (el.hasAttribute('data-bind')) {\n const c = handleDataBind(el, store, el.getAttribute('data-bind'), bindingMap);\n if (c) cleanups.push(c);\n }\n\n // All registered handlers (default + user)\n for (const handler of handlers) {\n if (el.hasAttribute(handler.attr)) {\n const c = applyHandler(el, store, el.getAttribute(handler.attr), handler);\n if (c) cleanups.push(c);\n }\n }\n }\n\n // Event delegation for two-way bindings\n const inputHandler = e => {\n const binding = bindingMap.get(e.target);\n if (binding) binding.target[binding.key] = getInputValue(e.target);\n };\n root.addEventListener(\"input\", inputHandler);\n cleanups.push(() => root.removeEventListener(\"input\", inputHandler));\n\n return () => cleanups.forEach(c => c());\n };\n\n // Auto-wait for DOM if needed\n if (!immediate && document.readyState === 'loading') {\n let cleanup = null;\n const onReady = () => { cleanup = performBinding(); };\n document.addEventListener('DOMContentLoaded', onReady, { once: true });\n return () => cleanup ? cleanup() : document.removeEventListener('DOMContentLoaded', onReady);\n }\n\n return performBinding();\n}\n\n/**\n * Apply a handler to an element via subscription.\n * Resolves the state path and subscribes to changes.\n */\nfunction applyHandler(el, store, path, handler) {\n const result = resolveProp(store, path);\n if (!result) return null;\n const { target, key } = result;\n return target.$subscribe(key, val => handler.apply(el, val));\n}\n\n/**\n * Handle data-bind (two-way for inputs, textContent for others)\n */\nfunction handleDataBind(el, store, path, bindingMap) {\n const result = resolveProp(store, path);\n if (!result) return null;\n\n const { target, key } = result;\n const unsub = target.$subscribe(key, val => updateElement(el, val));\n\n if (isFormInput(el)) {\n bindingMap.set(el, { target, key });\n }\n\n return unsub;\n}\n\n/**\n * Resolve a nested path in an object.\n * Example: resolvePath(obj, ['user', 'address']) returns obj.user.address\n */\nfunction resolvePath(obj, pathArr) {\n if (!pathArr || pathArr.length === 0) {\n return obj;\n }\n let current = obj;\n for (let i = 0; i < pathArr.length; i++) {\n const key = pathArr[i];\n if (current === null || current === undefined) {\n return null;\n }\n if (!(key in current)) {\n return null;\n }\n current = current[key];\n }\n return current;\n}\n\n/**\n * Resolve path to target and key.\n *\n * ⚠️ Path bindings are resolved once at bind time. If an intermediate\n * object in the path is null/undefined at bindDom call time, the binding\n * is permanently dead and will not self-heal when the path later becomes valid.\n */\nfunction resolveProp(store, path) {\n if (!path) return null;\n\n const pathArr = path.split(\".\");\n const key = pathArr.pop();\n const target = resolvePath(store, pathArr);\n\n if (target === null || target === undefined) {\n logWarn(`[Lume.js] Invalid path \"${path}\"`);\n return null;\n }\n\n if (!target?.$subscribe) {\n logWarn(`[Lume.js] Target for \"${path}\" is not reactive`);\n return null;\n }\n\n return { target, key };\n}\n\n/**\n * Update element with value (for data-bind)\n */\nfunction updateElement(el, val) {\n if (el.tagName === \"INPUT\") {\n if (el.type === \"checkbox\") el.checked = Boolean(val);\n else if (el.type === \"radio\") el.checked = el.value === String(val);\n else el.value = val ?? '';\n } else if (el.tagName === \"TEXTAREA\" || el.tagName === \"SELECT\") {\n el.value = val ?? '';\n } else {\n el.textContent = val ?? '';\n }\n}\n\n/**\n * Get value from input\n */\nfunction getInputValue(el) {\n if (el.type === \"checkbox\") return el.checked;\n if (el.type === \"number\" || el.type === \"range\") return el.valueAsNumber;\n return el.value;\n}\n\n/**\n * Check if element is form input\n */\nfunction isFormInput(el) {\n return el.tagName === \"INPUT\" || el.tagName === \"TEXTAREA\" || el.tagName === \"SELECT\";\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}","/**\n * Lume-JS List Rendering (Addon)\n *\n * Renders lists with automatic subscription and element reuse by key.\n * \n * Core guarantees:\n * Element reuse by key (same DOM nodes, not recreated)\n * Minimal DOM operations (only updates what changed)\n * Memory efficiency (cleanup on remove)\n * \n * Default behavior (can be disabled/customized):\n * ✅ Focus preservation (maintains activeElement and selection)\n * ✅ Scroll preservation (intelligent positioning for add/remove/reorder)\n * \n * Philosophy: No artificial limitations\n * - All preservation logic is overridable via options\n * - Set to null/false to disable, or provide custom functions\n * - Export utilities so you can wrap/extend them\n *\n * ⚠️ IMPORTANT: Arrays must be updated immutably!\n * store.items.push(x) // ❌ Won't trigger update\n * store.items = [...items] // ✅ Triggers update\n * \n * ═══════════════════════════════════════════════════════════════════════\n * PATTERN 1: Simple (render only) - for simple cases or backward compat\n * ═══════════════════════════════════════════════════════════════════════\n * \n * repeat('#list', store, 'todos', {\n * key: todo => todo.id,\n * render: (todo, el) => {\n * el.textContent = todo.name; // Called on every update\n * }\n * });\n *\n * ═══════════════════════════════════════════════════════════════════════\n * PATTERN 2: Clean separation (create + update) - recommended\n * ═══════════════════════════════════════════════════════════════════════\n * \n * repeat('#list', store, 'todos', {\n * key: todo => todo.id,\n * create: (todo, el) => {\n * // Called ONCE when element is created - build DOM structure\n * const nameSpan = document.createElement('span');\n * nameSpan.className = 'name';\n * el.appendChild(nameSpan);\n * const btn = document.createElement('button');\n * btn.textContent = 'Delete';\n * btn.onclick = () => deleteTodo(todo.id);\n * el.appendChild(btn);\n * },\n * update: (todo, el, index, { isFirstRender }) => {\n * // Called on every update - bind data\n * // isFirstRender = true on initial render, false on subsequent\n * // Skipped if same object reference (optimization)\n * el.querySelector('.name').textContent = todo.name;\n * }\n * });\n *\n * ═══════════════════════════════════════════════════════════════════════\n * ADVANCED: Custom preservation strategies\n * ═══════════════════════════════════════════════════════════════════════\n * \n * import { defaultFocusPreservation, defaultScrollPreservation } from \"lume-js/addons\";\n * \n * repeat('#list', store, 'items', {\n * key: item => item.id,\n * create: (item, el) => { ... },\n * update: (item, el) => { ... },\n * preserveFocus: null, // disable focus preservation\n * preserveScroll: (container, context) => {\n * const restore = defaultScrollPreservation(container, context);\n * return () => { restore(); console.log('Scroll restored!'); };\n * }\n * });\n */\nimport { logWarn, logError } from '../utils/log.js';\n\n/**\n * Default focus preservation strategy\n * Saves activeElement and selection state before DOM updates\n * \n * @param {HTMLElement} container - The list container\n * @returns {Function|null} Restore function, or null if nothing to restore\n */\nexport function defaultFocusPreservation(container) {\n const activeEl = document.activeElement;\n const shouldRestore = container.contains(activeEl);\n\n if (!shouldRestore) return null;\n\n let selectionStart = null;\n let selectionEnd = null;\n\n if (activeEl.tagName === 'INPUT' || activeEl.tagName === 'TEXTAREA') {\n selectionStart = activeEl.selectionStart;\n selectionEnd = activeEl.selectionEnd;\n }\n\n return () => {\n if (document.body.contains(activeEl)) {\n activeEl.focus();\n if (selectionStart !== null && selectionEnd !== null) {\n activeEl.setSelectionRange(selectionStart, selectionEnd);\n }\n }\n };\n}\n\n/**\n * Default scroll preservation strategy\n * Uses anchor-based preservation for add/remove, pixel position for reorder\n * \n * @param {HTMLElement} container - The list container\n * @param {Object} context - Additional context\n * @param {boolean} context.isReorder - Whether this is a reorder operation\n * @returns {Function} Restore function\n */\nexport function defaultScrollPreservation(container, context = {}) {\n const { isReorder = false } = context;\n const scrollTop = container.scrollTop;\n\n // Early return if no scroll\n if (scrollTop === 0) {\n return () => { container.scrollTop = 0; };\n }\n\n let anchorElement = null;\n let anchorOffset = 0;\n\n // Only use anchor-based preservation for add/remove, not reorder\n if (!isReorder) {\n const containerRect = container.getBoundingClientRect();\n // Avoid Array.from - iterate children directly\n for (let child = container.firstElementChild; child; child = child.nextElementSibling) {\n const rect = child.getBoundingClientRect();\n\n if (rect.bottom > containerRect.top) {\n anchorElement = child;\n anchorOffset = rect.top - containerRect.top;\n break;\n }\n }\n }\n\n return () => {\n if (anchorElement && document.body.contains(anchorElement)) {\n const newRect = anchorElement.getBoundingClientRect();\n const containerRect = container.getBoundingClientRect();\n const currentOffset = newRect.top - containerRect.top;\n const scrollAdjustment = currentOffset - anchorOffset;\n\n container.scrollTop = container.scrollTop + scrollAdjustment;\n } else {\n container.scrollTop = scrollTop;\n }\n };\n}\n\n/**\n * Efficiently render a list with element reuse\n * \n * @param {string|HTMLElement} container - Container element or selector\n * @param {Object} store - Reactive state object\n * @param {string} arrayKey - Key in store containing the array\n * @param {Object} options - Configuration\n * @param {Function} options.key - Function to extract unique key: (item) => key\n * @param {Function} [options.render] - Function to render item (called for all items): (item, element, index) => void\n * @param {Function} [options.create] - Function for new elements only: (item, element, index) => void\n * @param {Function} [options.update] - Function for data binding: (item, element, index, { isFirstRender }) => void. Skipped if same item reference AND same index.\n * @param {string|Function} [options.element='div'] - Element tag name or factory function\n * @param {Function|null} [options.preserveFocus=defaultFocusPreservation] - Focus preservation strategy (null to disable)\n * @param {Function|null} [options.preserveScroll=defaultScrollPreservation] - Scroll preservation strategy (null to disable)\n * @returns {Function} Cleanup function\n */\n\nexport function repeat(container, store, arrayKey, options) {\n const {\n key,\n render,\n create,\n update,\n element = 'div',\n preserveFocus = defaultFocusPreservation,\n preserveScroll = defaultScrollPreservation\n } = options;\n\n // Resolve container\n const containerEl =\n typeof container === 'string'\n ? document.querySelector(container)\n : container;\n\n if (!containerEl) {\n logWarn(`[Lume.js] repeat(): container \"${container}\" not found`);\n return () => { };\n }\n\n if (typeof key !== 'function') {\n throw new Error('[Lume.js] repeat(): options.key must be a function');\n }\n\n if (typeof render !== 'function' && typeof create !== 'function') {\n throw new Error('[Lume.js] repeat(): options.render or options.create must be a function');\n }\n\n // key -> HTMLElement\n const elementsByKey = new Map();\n // key -> previous item (for reference comparison)\n const prevItemsByKey = new Map();\n // key -> previous index (for reorder detection)\n const prevIndexByKey = new Map();\n const seenKeys = new Set();\n\n function createElement() {\n return typeof element === 'function'\n ? element()\n : document.createElement(element);\n }\n\n function reconcileDOM(container, nextEls) {\n let ptr = container.firstChild;\n\n for (let i = 0; i < nextEls.length; i++) {\n const desired = nextEls[i];\n\n if (ptr === desired) {\n ptr = ptr.nextSibling;\n continue;\n }\n\n container.insertBefore(desired, ptr);\n }\n\n // Remove leftover children not in nextEls\n while (ptr) {\n const next = ptr.nextSibling;\n container.removeChild(ptr);\n ptr = next;\n }\n }\n\n function applyPreservation(container, fn, isReorder) {\n const shouldPreserve = document.body.contains(container);\n const restoreFocus = shouldPreserve && preserveFocus ? preserveFocus(container) : null;\n const restoreScroll = shouldPreserve && preserveScroll ? preserveScroll(container, { isReorder }) : null;\n\n fn();\n\n if (restoreFocus) restoreFocus();\n if (restoreScroll) restoreScroll();\n }\n\n function updateList() {\n const items = store[arrayKey];\n\n if (!Array.isArray(items)) {\n logWarn(`[Lume.js] repeat(): store.${arrayKey} is not an array`);\n return;\n }\n\n // Only compute isReorder if scroll preservation needs it.\n // Uses elementsByKey (previous state) and items directly — no Set allocations.\n let isReorder = false;\n if (preserveScroll && elementsByKey.size === items.length) {\n isReorder = true;\n for (let i = 0; i < items.length; i++) {\n if (!elementsByKey.has(key(items[i]))) { isReorder = false; break; }\n }\n }\n\n seenKeys.clear();\n const nextEls = [];\n\n // Build ordered list of DOM nodes (created or reused)\n for (let i = 0; i < items.length; i++) {\n const item = items[i];\n const k = key(item);\n\n if (seenKeys.has(k)) {\n logWarn(`[Lume.js] repeat(): duplicate key \"${k}\"`);\n continue;\n }\n seenKeys.add(k);\n\n let el = elementsByKey.get(k);\n const isFirstRender = !el;\n\n if (isFirstRender) {\n el = createElement();\n elementsByKey.set(k, el);\n }\n\n try {\n // Call create for new elements (DOM structure)\n if (isFirstRender && create) {\n create(item, el, i);\n }\n\n // Call update for data binding (new and existing elements)\n // Skip if same item reference AND same index (optimization)\n const prevItem = prevItemsByKey.get(k);\n const prevIndex = prevIndexByKey.get(k);\n if (update) {\n if (prevItem !== item || prevIndex !== i) {\n update(item, el, i, { isFirstRender });\n }\n } else if (render) {\n // Backward compatibility: render handles both create and update\n render(item, el, i);\n }\n\n // Store reference and index for next comparison\n prevItemsByKey.set(k, item);\n prevIndexByKey.set(k, i);\n\n } catch (err) {\n logError(`[Lume.js] repeat(): error rendering key \"${k}\":`, err);\n }\n\n nextEls.push(el);\n }\n\n applyPreservation(containerEl, () => {\n reconcileDOM(containerEl, nextEls);\n\n // Clean maps: remove keys not in seenKeys (new state)\n if (elementsByKey.size !== seenKeys.size) {\n for (const k of elementsByKey.keys()) {\n if (!seenKeys.has(k)) {\n elementsByKey.delete(k);\n prevItemsByKey.delete(k);\n prevIndexByKey.delete(k);\n }\n }\n }\n }, isReorder);\n }\n\n // Subscription — $subscribe calls updateList immediately (initial render),\n // so no separate updateList() call is needed for reactive stores.\n let unsubscribe;\n if (typeof store.$subscribe === 'function') {\n unsubscribe = store.$subscribe(arrayKey, updateList);\n } else if (typeof store.subscribe === 'function') {\n // Generic subscribe (e.g. computed) — subscribe first, then initial render\n const subResult = store.subscribe(() => updateList());\n updateList();\n // Normalize both function-style and object-style (RxJS Subscription) returns\n unsubscribe = typeof subResult === 'function'\n ? subResult\n : () => { subResult?.unsubscribe?.(); };\n } else {\n // Non-reactive store — render once and return cleanup\n updateList();\n logWarn('[Lume.js] repeat(): store is not reactive (no $subscribe or subscribe method)');\n return () => {\n containerEl.replaceChildren();\n elementsByKey.clear();\n prevItemsByKey.clear();\n prevIndexByKey.clear();\n seenKeys.clear();\n };\n }\n\n return () => {\n if (typeof unsubscribe === 'function') {\n unsubscribe();\n }\n // Clear DOM elements (replaceChildren is faster than loop)\n containerEl.replaceChildren();\n elementsByKey.clear();\n prevItemsByKey.clear();\n prevIndexByKey.clear();\n seenKeys.clear();\n };\n}\n","/**\n * Lume-JS Debug Addon\n * \n * Developer-friendly logging and inspection of reactive state operations.\n * Critical for adoption - hard to debug = hard to adopt.\n * \n * Usage:\n * import { state } from \"lume-js\";\n * import { withPlugins, createDebugPlugin, debug } from \"lume-js/addons\";\n * \n * const store = withPlugins(state({ count: 0 }), [createDebugPlugin({ label: 'myStore' })]);\n * \n * debug.enable(); // Enable logging\n * debug.filter('count'); // Only log 'count' key\n * debug.stats(); // Show statistics\n * \n * @module addons/debug\n */\n\n// Global debug state\nlet globalEnabled = true;\nlet globalFilter = null; // string, RegExp, or null\nconst stats = new Map(); // label -> { gets: Map, sets: Map, notifies: Map }\n\n/**\n * Check if a key matches the current filter\n * @param {string} key\n * @returns {boolean}\n */\nfunction matchesFilter(key) {\n if (globalFilter === null) return true;\n if (typeof globalFilter === 'string') {\n return key.includes(globalFilter);\n }\n if (globalFilter instanceof RegExp) {\n return globalFilter.test(key);\n }\n return true;\n}\n\n/**\n * Get or create stats entry for a label\n * @param {string} label\n * @returns {object}\n */\nfunction getStats(label) {\n if (!stats.has(label)) {\n stats.set(label, {\n gets: new Map(),\n sets: new Map(),\n notifies: new Map()\n });\n }\n return stats.get(label);\n}\n\n/**\n * Increment a stat counter\n * @param {string} label\n * @param {'gets'|'sets'|'notifies'} type\n * @param {string} key\n */\nfunction incrementStat(label, type, key) {\n const s = getStats(label);\n const map = s[type];\n map.set(key, (map.get(key) || 0) + 1);\n}\n\nconst MAX_LOG_LEN = 100;\nconst TRUNCATED_LEN = MAX_LOG_LEN - 3;\n\n/**\n * Format value for logging (truncate long values)\n * @param {any} value\n * @returns {string}\n */\nfunction formatValue(value) {\n try {\n const json = JSON.stringify(value);\n if (json.length > MAX_LOG_LEN) {\n return json.slice(0, TRUNCATED_LEN) + '...';\n }\n return json;\n } catch {\n return String(value);\n }\n}\n\n/**\n * Create a debug plugin instance for a reactive state store.\n * \n * @param {object} [options] - Configuration options\n * @param {string} [options.label='store'] - Label for log messages\n * @param {boolean} [options.logGet=false] - Log property reads (can be noisy)\n * @param {boolean} [options.logSet=true] - Log property writes\n * @param {boolean} [options.logNotify=true] - Log subscriber notifications\n * @param {boolean} [options.trace=false] - Show stack trace for SET operations\n * @returns {object} Plugin object for state()\n * \n * @example\n * const store = withPlugins(state({ count: 0 }), [createDebugPlugin({ label: 'counter' })]);\n * \n * @example\n * // With stack traces for debugging where state changes originate\n * const store = withPlugins(state({ count: 0 }), [createDebugPlugin({ label: 'counter', trace: true })]);\n */\nexport function createDebugPlugin(options = {}) {\n const label = options.label ?? 'store';\n\n // IMPORTANT: Do NOT destructure options here!\n // Options may contain getters for dynamic runtime toggling (e.g., from UI).\n // Destructuring would copy values once at creation time, breaking reactivity.\n // Use getOpt() helper to read options dynamically in each hook.\n const getOpt = (name, defaultVal) => {\n const val = options[name];\n return val !== undefined ? val : defaultVal;\n };\n\n return {\n name: `debug:${label}`,\n\n onInit: () => {\n if (globalEnabled) {\n console.log(`%c[${label}]%c initialized`, 'color: #888; font-weight: bold', 'color: inherit');\n }\n },\n\n onGet: (key, value) => {\n // Skip internal properties\n if (typeof key === 'string' && key.startsWith('$')) {\n return value;\n }\n\n incrementStat(label, 'gets', key);\n\n if (globalEnabled && getOpt('logGet', false) && matchesFilter(key)) {\n console.log(\n `%c[${label}]%c GET %c${key}%c = ${formatValue(value)}`,\n 'color: #888; font-weight: bold',\n 'color: #4CAF50',\n 'color: #2196F3; font-weight: bold',\n 'color: inherit'\n );\n }\n\n return value;\n },\n\n onSet: (key, newValue, oldValue) => {\n // Skip internal properties\n if (typeof key === 'string' && key.startsWith('$')) {\n return newValue;\n }\n\n incrementStat(label, 'sets', key);\n\n if (globalEnabled && getOpt('logSet', true) && matchesFilter(key)) {\n console.log(\n `%c[${label}]%c SET %c${key}%c: ${formatValue(oldValue)} → ${formatValue(newValue)}`,\n 'color: #888; font-weight: bold',\n 'color: #FF9800',\n 'color: #2196F3; font-weight: bold',\n 'color: inherit'\n );\n\n // Show stack trace if enabled (helps find where state changes originate)\n if (getOpt('trace', false)) {\n console.trace(`%c[${label}] Stack trace for ${key}`, 'color: #888');\n }\n }\n\n return newValue;\n },\n\n onSubscribe: (key) => {\n if (globalEnabled && matchesFilter(key)) {\n console.log(\n `%c[${label}]%c SUBSCRIBE %c${key}`,\n 'color: #888; font-weight: bold',\n 'color: #9C27B0',\n 'color: #2196F3; font-weight: bold'\n );\n }\n },\n\n onNotify: (key, value) => {\n // Skip internal properties\n if (typeof key === 'string' && key.startsWith('$')) {\n return;\n }\n\n incrementStat(label, 'notifies', key);\n\n if (globalEnabled && getOpt('logNotify', true) && matchesFilter(key)) {\n console.log(\n `%c[${label}]%c NOTIFY %c${key}%c = ${formatValue(value)}`,\n 'color: #888; font-weight: bold',\n 'color: #E91E63',\n 'color: #2196F3; font-weight: bold',\n 'color: inherit'\n );\n }\n }\n };\n}\n\n/**\n * Global debug controls\n */\nexport const debug = {\n /**\n * Enable debug logging globally\n */\n enable() {\n globalEnabled = true;\n console.log('%c[lume-debug]%c Logging enabled', 'color: #888; font-weight: bold', 'color: #4CAF50');\n },\n\n /**\n * Disable debug logging globally\n */\n disable() {\n globalEnabled = false;\n console.log('%c[lume-debug]%c Logging disabled', 'color: #888; font-weight: bold', 'color: #F44336');\n },\n\n /**\n * Check if debug logging is currently enabled\n * @returns {boolean}\n */\n isEnabled() {\n return globalEnabled;\n },\n\n /**\n * Filter logs by key pattern\n * @param {string|RegExp|null} pattern - Pattern to match, or null to clear filter\n */\n filter(pattern) {\n globalFilter = pattern;\n if (pattern === null) {\n console.log('%c[lume-debug]%c Filter cleared', 'color: #888; font-weight: bold', 'color: inherit');\n } else {\n console.log(`%c[lume-debug]%c Filter set: ${pattern}`, 'color: #888; font-weight: bold', 'color: inherit');\n }\n },\n\n /**\n * Get current filter pattern\n * @returns {string|RegExp|null}\n */\n getFilter() {\n return globalFilter;\n },\n\n /**\n * Get statistics data (silent - no console output)\n * Use logStats() if you want to see stats in console.\n * @returns {object} Stats object for programmatic access\n */\n stats() {\n const result = {};\n\n for (const [label, data] of stats) {\n result[label] = {\n gets: Object.fromEntries(data.gets),\n sets: Object.fromEntries(data.sets),\n notifies: Object.fromEntries(data.notifies)\n };\n }\n\n return result;\n },\n\n /**\n * Log statistics summary to console (with formatting)\n * @returns {object} Stats object for programmatic access\n */\n logStats() {\n const result = this.stats();\n\n if (Object.keys(result).length === 0) {\n console.log('%c[lume-debug]%c No stats collected yet', 'color: #888; font-weight: bold', 'color: inherit');\n return result;\n }\n\n console.group('%c[lume-debug] Statistics', 'color: #888; font-weight: bold');\n\n for (const [label, data] of Object.entries(result)) {\n console.group(`%c${label}`, 'color: #2196F3; font-weight: bold');\n\n // Use console.table for better formatted output\n const tableData = [];\n const allKeys = new Set([\n ...Object.keys(data.gets),\n ...Object.keys(data.sets),\n ...Object.keys(data.notifies)\n ]);\n\n for (const key of allKeys) {\n tableData.push({\n key,\n gets: data.gets[key] || 0,\n sets: data.sets[key] || 0,\n notifies: data.notifies[key] || 0\n });\n }\n\n if (tableData.length > 0) {\n console.table(tableData);\n }\n\n console.groupEnd();\n }\n\n console.groupEnd();\n\n return result;\n },\n\n /**\n * Reset all collected statistics\n */\n resetStats() {\n stats.clear();\n console.log('%c[lume-debug]%c Stats reset', 'color: #888; font-weight: bold', 'color: inherit');\n }\n};\n","/**\n * Lume-JS DOM Binding Handlers\n *\n * Extend bindDom() with additional reactive data-* attribute capabilities.\n * Each handler is a plain object — no framework API, no registration.\n *\n * Usage:\n * import { state, bindDom } from 'lume-js';\n * import { show, classToggle } from 'lume-js/handlers';\n *\n * const store = state({ isVisible: true, isActive: false });\n * bindDom(document.body, store, { handlers: [show, classToggle('active')] });\n *\n * Custom handlers:\n * const tooltip = { attr: 'data-tooltip', apply(el, val) { el.title = val ?? ''; } };\n * bindDom(root, store, { handlers: [tooltip] });\n *\n * Handler contract:\n * { attr: string, apply(el: HTMLElement, val: any): void }\n */\n\n// --- Ready-to-use Handlers ---\n\n/**\n * data-show=\"key\" → el.hidden = !Boolean(val)\n * Shows element when state value is truthy (inverse of built-in data-hidden).\n */\nexport const show = {\n attr: 'data-show',\n apply(el, val) { el.hidden = !Boolean(val); }\n};\n\n// --- Factory Functions ---\n\n/**\n * Create a handler for any HTML boolean attribute.\n * Uses toggleAttribute() — works correctly with any attribute name\n * (readonly, contenteditable, etc.) without worrying about camelCase property names.\n *\n * Note: built-in boolean handlers (hidden, disabled, checked, required) use\n * property assignment directly. This factory uses toggleAttribute for broader\n * attribute name compatibility.\n *\n * @param {string} name - Attribute name (e.g., 'readonly', 'open', 'contenteditable')\n * @returns {{ attr: string, apply: function }}\n *\n * @example\n * bindDom(root, store, { handlers: [boolAttr('readonly')] });\n * // <input data-readonly=\"isReadonly\" />\n */\nexport function boolAttr(name) {\n return {\n attr: `data-${name}`,\n apply(el, val) { el.toggleAttribute(name, Boolean(val)); }\n };\n}\n\n/**\n * Create a handler for an ARIA attribute.\n * Use for ARIA attrs beyond the built-in aria-expanded/aria-hidden.\n *\n * @param {string} name - ARIA name, with or without \"aria-\" prefix\n * @returns {{ attr: string, apply: function }}\n *\n * @example\n * bindDom(root, store, { handlers: [ariaAttr('pressed'), ariaAttr('selected')] });\n * // <button data-aria-pressed=\"isPressed\">Toggle</button>\n */\nexport function ariaAttr(name) {\n const fullName = name.startsWith('aria-') ? name : `aria-${name}`;\n return {\n attr: `data-${fullName}`,\n apply(el, val) { el.setAttribute(fullName, val ? 'true' : 'false'); }\n };\n}\n\n/**\n * Create handlers for CSS class toggling.\n * Each name creates a handler: data-class-{name}=\"key\" → el.classList.toggle(name, Boolean(val))\n *\n * Returns an array — pass directly to handlers (auto-flattened by bindDom).\n *\n * @param {...string} names - CSS class names to create handlers for\n * @returns {Array<{ attr: string, apply: function }>}\n *\n * @example\n * bindDom(root, store, { handlers: [classToggle('active', 'loading', 'error')] });\n * // <div data-class-active=\"isActive\" data-class-loading=\"isLoading\">\n */\nexport function classToggle(...names) {\n return names.map(name => ({\n attr: `data-class-${name}`,\n apply(el, val) { el.classList.toggle(name, Boolean(val)); }\n }));\n}\n\n/**\n * Create a handler for any string attribute (href, src, title, alt, action, etc.)\n * Sets the attribute value as a string. Removes attribute when value is null/undefined.\n *\n * @param {string} name - HTML attribute name (e.g., 'href', 'src', 'title')\n * @returns {{ attr: string, apply: function }}\n *\n * @example\n * bindDom(root, store, { handlers: [stringAttr('href'), stringAttr('src')] });\n * // <a data-href=\"profileUrl\">Profile</a>\n * // <img data-src=\"imageUrl\" />\n */\nexport function stringAttr(name) {\n return {\n attr: `data-${name}`,\n apply(el, val) {\n if (val == null) el.removeAttribute(name);\n else el.setAttribute(name, String(val));\n }\n };\n}\n\n// --- Presets ---\n\n/** Form-related handlers (beyond built-in disabled/checked/required) */\nexport const formHandlers = [\n boolAttr('readonly'),\n];\n\n/** Additional ARIA handlers (beyond built-in aria-expanded/aria-hidden) */\nexport const a11yHandlers = [\n ariaAttr('pressed'),\n ariaAttr('selected'),\n ariaAttr('disabled'),\n];\n\n// --- htmlAttrs() — All Standard HTML Attributes ---\n\n/**\n * Standard HTML boolean attributes (beyond built-in hidden/disabled/checked/required).\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes#boolean_attributes\n */\nconst BOOL_ATTRS = [\n 'readonly', 'open', 'novalidate', 'formnovalidate', 'multiple',\n 'autofocus', 'autoplay', 'controls', 'loop', 'muted', 'defer',\n 'async', 'reversed', 'selected', 'inert', 'allowfullscreen',\n];\n\n/**\n * Standard HTML string attributes.\n * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes\n */\nconst STRING_ATTRS = [\n 'href', 'src', 'alt', 'title', 'placeholder', 'action', 'method',\n 'target', 'rel', 'type', 'name', 'role', 'lang', 'tabindex',\n 'pattern', 'min', 'max', 'step', 'minlength', 'maxlength',\n 'width', 'height', 'for', 'form', 'accept', 'autocomplete',\n 'loading', 'decoding', 'inputmode', 'enterkeyhint', 'draggable',\n 'contenteditable', 'spellcheck', 'translate', 'dir', 'id',\n 'poster', 'preload', 'download', 'media', 'sizes', 'srcset',\n 'colspan', 'rowspan', 'scope', 'headers', 'wrap', 'sandbox',\n];\n\n/**\n * ARIA boolean state attributes — toggled between \"true\" and \"false\".\n * Use ariaAttr() for these (coerces to \"true\"/\"false\" string).\n * @see https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes\n */\nconst ARIA_BOOL_ATTRS = [\n 'pressed', 'selected', 'disabled', 'checked', 'invalid', 'required',\n 'busy', 'modal', 'multiselectable', 'multiline', 'readonly', 'atomic',\n];\n\n/**\n * ARIA string/token/numeric attributes — value passed through as-is.\n * Use stringAttr() with \"aria-\" prefix for these.\n * @see https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes\n */\nconst ARIA_STRING_ATTRS = [\n 'current', 'live', 'relevant', 'haspopup',\n 'sort', 'autocomplete', 'orientation',\n 'label', 'describedby', 'labelledby', 'controls', 'owns',\n 'activedescendant', 'errormessage', 'details', 'flowto',\n 'valuenow', 'valuemin', 'valuemax', 'valuetext',\n 'colcount', 'colindex', 'colspan', 'rowcount', 'rowindex', 'rowspan',\n 'level', 'setsize', 'posinset', 'placeholder', 'roledescription',\n 'keyshortcuts', 'braillelabel', 'brailleroledescription',\n];\n\n/**\n * One-import preset that enables all standard HTML attributes as reactive handlers.\n *\n * Includes:\n * - Boolean attributes: readonly, open, autofocus, controls, muted, inert, etc.\n * - String attributes: href, src, alt, title, placeholder, role, tabindex, etc.\n * - ARIA attributes: aria-pressed, aria-label, aria-describedby, aria-valuenow, etc.\n * - Show handler: data-show (inverse of data-hidden)\n *\n * Returns a flat array — pass directly to handlers option.\n *\n * @returns {Array<{ attr: string, apply: function }>}\n *\n * @example\n * import { htmlAttrs } from 'lume-js/handlers';\n *\n * bindDom(document.body, store, { handlers: [htmlAttrs()] });\n * // Now use any data-* attribute:\n * // <a data-href=\"url\">Link</a>\n * // <input data-readonly=\"isLocked\" />\n * // <div data-aria-label=\"labelText\">...</div>\n * // <div data-show=\"isVisible\">...</div>\n */\nexport function htmlAttrs() {\n return [\n show,\n ...BOOL_ATTRS.map(name => boolAttr(name)),\n ...STRING_ATTRS.map(name => stringAttr(name)),\n ...ARIA_BOOL_ATTRS.map(name => ariaAttr(name)),\n ...ARIA_STRING_ATTRS.map(name => stringAttr(`aria-${name}`)),\n ];\n}\n","/**\n * Lume-JS Computed Addon\n * \n * Creates computed values that automatically update when dependencies change.\n * Uses core effect() for automatic dependency tracking.\n * \n * Usage:\n * import { computed } from \"lume-js/addons/computed\";\n * \n * const doubled = computed(() => store.count * 2);\n * console.log(doubled.value); // Auto-updates when store.count changes\n * \n * Features:\n * - Automatic dependency tracking (no manual recompute)\n * - Cached values (only recomputes when dependencies change)\n * - Subscribe to changes\n * - Cleanup with dispose()\n * \n * @module addons/computed\n */\n\nimport { effect } from '../core/effect.js';\nimport { logError } from '../utils/log.js';\n\n/**\n * Creates a computed value with automatic dependency tracking\n * \n * The computation function runs immediately and tracks which state\n * properties are accessed. When any dependency changes, the value\n * is automatically recomputed.\n *\n * ⚠️ Circular self-mutations are automatically suppressed. If a computed\n * mutates a state property it depends on, the flush triggered by that\n * mutation is skipped to prevent an infinite microtask loop.\n *\n * @param {function} fn - Function that computes the value\n * @returns {object} Object with .value property and methods\n * \n * @example\n * const store = state({ count: 5 });\n * \n * const doubled = computed(() => store.count * 2);\n * console.log(doubled.value); // 10\n * \n * store.count = 10;\n * // After microtask:\n * console.log(doubled.value); // 20 (auto-updated)\n * \n * @example\n * // Subscribe to changes\n * const unsub = doubled.subscribe(value => {\n * console.log('Doubled changed to:', value);\n * });\n * \n * @example\n * // Cleanup\n * doubled.dispose();\n */\nexport function computed(fn) {\n if (typeof fn !== 'function') {\n throw new Error('computed() requires a function');\n }\n\n let cachedValue;\n let isInitialized = false;\n let isInComputation = false;\n let disposed = false;\n const subscribers = [];\n\n // Use effect to automatically track dependencies\n const cleanupEffect = effect(() => {\n // Skip re-entry from a flush triggered by our own synchronous mutation.\n // The mutation inside fn() queues a microtask flush; we stay flagged\n // until a subsequent microtask clears it, so that flush is dropped.\n if (isInComputation || disposed) return;\n\n isInComputation = true;\n\n try {\n const newValue = fn();\n\n // Check if value actually changed - Object.is() handles NaN and -0\n if (!isInitialized || !Object.is(newValue, cachedValue)) {\n cachedValue = newValue;\n isInitialized = true;\n\n // Notify all subscribers\n subscribers.forEach(callback => callback(cachedValue));\n }\n } catch (error) {\n logError('[Lume.js computed] Error in computation:', error);\n // Set to undefined on error, mark as initialized\n if (!isInitialized || cachedValue !== undefined) {\n cachedValue = undefined;\n isInitialized = true;\n\n // Notify subscribers of error state\n subscribers.forEach(callback => callback(cachedValue));\n }\n } finally {\n // Defer clearing the flag so any flush microtask queued by fn()\n // sees it still set and skips re-entry.\n queueMicrotask(() => {\n if (!disposed) {\n isInComputation = false;\n }\n });\n }\n });\n\n return {\n /**\n * Get the current computed value\n */\n get value() {\n if (!isInitialized) {\n throw new Error('Computed value accessed before initialization');\n }\n return cachedValue;\n },\n\n /**\n * Subscribe to changes in computed value\n * \n * @param {function} callback - Called when value changes\n * @returns {function} Unsubscribe function\n */\n subscribe(callback) {\n if (typeof callback !== 'function') {\n throw new Error('subscribe() requires a function');\n }\n\n subscribers.push(callback);\n\n // Call immediately with current value\n if (isInitialized) {\n callback(cachedValue);\n }\n\n // Return unsubscribe function\n return () => {\n const index = subscribers.indexOf(callback);\n if (index > -1) {\n subscribers.splice(index, 1);\n }\n };\n },\n\n /**\n * Clean up computed value and stop tracking\n */\n dispose() {\n disposed = true;\n cleanupEffect();\n subscribers.length = 0;\n isInitialized = false;\n isInComputation = false;\n }\n };\n}","/**\n * Creates a cleanup group that can collect and dispose multiple\n * cleanup/unsubscribe functions at once.\n *\n * @returns {CleanupGroup}\n *\n * @example\n * ```js\n * import { createCleanupGroup } from 'lume-js/addons';\n *\n * const group = createCleanupGroup();\n * group.add(bindDom(root, store));\n * group.add(effect(() => { ... }));\n * group.add(store.$subscribe('key', fn));\n *\n * // Dispose everything at once\n * group.dispose();\n * ```\n */\nexport function createCleanupGroup() {\n const cleanups = [];\n\n return {\n /**\n * Add a cleanup function to the group.\n * @param {Function} fn - Cleanup/unsubscribe function\n */\n add(fn) {\n if (typeof fn === 'function') {\n cleanups.push(fn);\n }\n },\n\n /**\n * Run all collected cleanup functions and clear the group.\n */\n dispose() {\n while (cleanups.length) {\n const fn = cleanups.pop();\n try { fn(); } catch (e) { /* ignore cleanup errors */ }\n }\n },\n };\n}\n","/**\n * Reads initial state from a `<script type=\"application/json\">` element\n * embedded in the server-rendered HTML. Useful for SSR / hydration patterns.\n *\n * @param {string} [selector='#__LUME_DATA__'] - CSS selector for the script element\n * @returns {object} Parsed JSON object, or empty object if not found / invalid\n *\n * @example\n * ```html\n * <script id=\"__LUME_DATA__\" type=\"application/json\">\n * {\"title\": \"Welcome\", \"count\": 42}\n * </script>\n * ```\n *\n * ```js\n * import { state } from 'lume-js';\n * import { hydrateState } from 'lume-js/addons';\n *\n * const store = state(hydrateState());\n * ```\n */\nexport function hydrateState(selector = '#__LUME_DATA__') {\n const el = typeof document !== 'undefined' ? document.querySelector(selector) : null;\n if (!el) return {};\n try {\n return JSON.parse(el.textContent);\n } catch {\n return {};\n }\n}\n","export { computed } from \"./computed.js\";\nexport { watch } from \"./watch.js\";\nexport { repeat, defaultFocusPreservation, defaultScrollPreservation } from \"./repeat.js\";\nexport { createDebugPlugin, debug } from \"./debug.js\";\nexport { withPlugins } from \"./withPlugins.js\";\nexport { createCleanupGroup } from \"./cleanupGroup.js\";\nexport { hydrateState } from \"./hydrateState.js\";\n\n/**\n * Returns true if the value is a Lume reactive proxy created by state().\n * Uses duck-typing: checks for the presence of $subscribe.\n * @param {any} obj\n * @returns {boolean}\n */\nexport function isReactive(obj) {\n return !!(obj && typeof obj === 'object' && typeof obj.$subscribe === 'function');\n}\n","/**\n * watch - observes changes to a state key and triggers callback\n * @param {Object} store - reactive store created with state()\n * @param {string} key - key in store to watch\n * @param {Function} callback - called with new value\n * @returns {Function} unsubscribe function\n */\nexport function watch(store, key, callback) {\n if (!store.$subscribe) {\n throw new Error(\"store must be created with state()\");\n }\n return store.$subscribe(key, callback);\n}","/**\n * Lume-JS withPlugins Addon\n *\n * Wraps a reactive state proxy with a plugin layer that intercepts\n * get/set/notify/subscribe operations via plugin hooks.\n *\n * Only stores that opt into debugging or custom behaviors need this.\n * Core state() is not aware of plugins.\n *\n * Usage:\n * import { state } from \"lume-js\";\n * import { withPlugins, createDebugPlugin } from \"lume-js/addons\";\n *\n * const store = withPlugins(state({ count: 0 }), [createDebugPlugin({ label: 'counter' })]);\n */\n\n/**\n * Wrap a reactive state proxy with plugin hooks.\n *\n * Plugin hooks (all optional):\n * onInit() — called once at wrap time\n * onGet(key, value) → value|void — intercept/transform reads\n * onSet(key, newVal, oldVal) → val|void — intercept/transform writes\n * onNotify(key, value) — called before subscribers are notified\n * onSubscribe(key) — called when $subscribe is invoked\n *\n * @param {object} store - A reactive proxy from state()\n * @param {Array<object>} plugins - Array of plugin objects\n * @returns {Proxy} A new proxy wrapping the store with plugin behavior\n */\nimport { logError } from '../utils/log.js';\n\nexport function withPlugins(store, plugins = []) {\n if (!plugins.length) return store;\n\n // Call onInit hooks once at wrap time\n for (const p of plugins) {\n try {\n p.onInit?.();\n } catch (e) {\n logError(`[Lume.js] Plugin \"${p.name}\" error in onInit:`, e);\n }\n }\n\n // Track pending notifications for onNotify hooks.\n // Instead of a separate microtask, we hook into the underlying state's\n // flush via $beforeFlush so onNotify and subscribers share one microtask.\n const pendingNotifications = new Map();\n\n function runNotifyHooks() {\n for (const [key, value] of pendingNotifications) {\n for (const p of plugins) {\n try {\n p.onNotify?.(key, value);\n } catch (e) {\n logError(`[Lume.js] Plugin \"${p.name}\" error in onNotify:`, e);\n }\n }\n }\n pendingNotifications.clear();\n }\n\n // Register once on the underlying state; capture unsubscribe for cleanup.\n let flushUnsub;\n if (typeof store.$beforeFlush === 'function') {\n flushUnsub = store.$beforeFlush(runNotifyHooks);\n }\n\n return new Proxy(store, {\n get(target, key) {\n // $dispose — remove the beforeFlush hook and clear pending state\n if (key === '$dispose') {\n return () => {\n if (flushUnsub) flushUnsub();\n pendingNotifications.clear();\n };\n }\n\n // Pass $-prefixed meta methods through without interception\n if (typeof key === 'string' && key.startsWith('$')) {\n const method = target[key];\n if (key === '$subscribe' && typeof method === 'function') {\n // Wrap $subscribe to call onSubscribe hooks\n return (subKey, fn) => {\n for (const p of plugins) {\n try {\n p.onSubscribe?.(subKey);\n } catch (e) {\n logError(`[Lume.js] Plugin \"${p.name}\" error in onSubscribe:`, e);\n }\n }\n return method(subKey, fn);\n };\n }\n return method;\n }\n\n let value = target[key];\n\n // onGet chain\n for (const p of plugins) {\n try {\n const r = p.onGet?.(key, value);\n if (r !== undefined) value = r;\n } catch (e) {\n logError(`[Lume.js] Plugin \"${p.name}\" error in onGet:`, e);\n }\n }\n\n return value;\n },\n\n set(target, key, value) {\n const oldValue = target[key];\n let newValue = value;\n\n // onSet chain\n for (const p of plugins) {\n try {\n const r = p.onSet?.(key, newValue, oldValue);\n if (r !== undefined) newValue = r;\n } catch (e) {\n logError(`[Lume.js] Plugin \"${p.name}\" error in onSet:`, e);\n }\n }\n\n // Only queue onNotify if the value actually changed after plugin chain\n if (!Object.is(newValue, oldValue)) {\n pendingNotifications.set(key, newValue);\n }\n\n target[key] = newValue;\n return true;\n }\n });\n}\n"],"names":["logWarn","msg","rest","console","warn","logError","error","readers","Set","withReadObserver","onRead","fn","add","delete","boolHandler","name","attr","apply","el","val","ariaHandler","setAttribute","DEFAULT_HANDLERS","applyHandler","store","path","handler","result","resolveProp","target","key","$subscribe","handleDataBind","bindingMap","unsub","tagName","type","checked","value","String","textContent","updateElement","isFormInput","set","pathArr","split","pop","obj","length","current","i","resolvePath","currentEffect","effect","deps","Error","cleanups","isRunning","execute","Array","isArray","dep","keys","isFirst","push","executeWithTracking","oldCleanups","splice","myContext","tracking","previousEffect","proxy","registerEffect","cleanup","defaultFocusPreservation","container","activeEl","document","activeElement","contains","selectionStart","selectionEnd","body","focus","setSelectionRange","defaultScrollPreservation","context","isReorder","scrollTop","anchorElement","anchorOffset","containerRect","getBoundingClientRect","child","firstElementChild","nextElementSibling","rect","bottom","top","newRect","scrollAdjustment","globalEnabled","globalFilter","stats","Map","matchesFilter","includes","RegExp","test","incrementStat","label","s","has","gets","sets","notifies","get","getStats","map","formatValue","json","JSON","stringify","slice","MAX_LOG_LEN","debug","enable","log","disable","isEnabled","filter","pattern","getFilter","data","Object","fromEntries","logStats","this","group","entries","tableData","allKeys","table","groupEnd","resetStats","clear","show","hidden","boolAttr","toggleAttribute","ariaAttr","fullName","startsWith","stringAttr","removeAttribute","formHandlers","a11yHandlers","BOOL_ATTRS","STRING_ATTRS","ARIA_BOOL_ATTRS","ARIA_STRING_ATTRS","root","options","HTMLElement","immediate","handlers","userHandlers","defaults","merged","h","flat","values","mergeHandlers","performBinding","WeakMap","selector","join","elements","querySelectorAll","hasAttribute","c","getAttribute","inputHandler","e","binding","valueAsNumber","addEventListener","removeEventListener","forEach","readyState","onReady","once","names","classList","toggle","cachedValue","isInitialized","isInComputation","disposed","subscribers","cleanupEffect","newValue","is","callback","queueMicrotask","subscribe","index","indexOf","dispose","getOpt","defaultVal","onInit","onGet","onSet","oldValue","trace","onSubscribe","onNotify","querySelector","parse","arrayKey","render","create","update","element","preserveFocus","preserveScroll","containerEl","elementsByKey","prevItemsByKey","prevIndexByKey","seenKeys","createElement","updateList","items","size","nextEls","item","k","isFirstRender","prevItem","prevIndex","err","shouldPreserve","restoreFocus","restoreScroll","ptr","firstChild","desired","insertBefore","nextSibling","next","removeChild","reconcileDOM","applyPreservation","unsubscribe","replaceChildren","subResult","isFrozen","isSealed","listeners","pendingNotifications","pendingEffects","beforeFlushHooks","flushScheduled","Symbol","executeFn","idx","Proxy","reader","iterations","subs","effects","$beforeFlush","plugins","p","flushUnsub","method","subKey","r"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"lume.global.js","sources":["../src/utils/log.js","../src/core/state.js","../src/core/bindDom.js","../src/core/effect.js","../src/addons/repeat.js","../src/addons/debug.js","../src/handlers/show.js","../src/handlers/className.js","../src/handlers/boolAttr.js","../src/handlers/ariaAttr.js","../src/handlers/stringAttr.js","../src/handlers/htmlAttrs.js","../src/handlers/presets.js","../src/handlers/classToggle.js","../src/addons/computed.js","../src/addons/cleanupGroup.js","../src/addons/hydrateState.js","../src/addons/index.js","../src/addons/watch.js","../src/addons/withPlugins.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","// src/core/bindDom.js\n/**\n * Lume-JS DOM Binding\n *\n * Binds reactive state to DOM elements using data-* attributes.\n *\n * Built-in attributes (always available):\n * data-bind=\"key\" → Two-way binding for inputs, textContent for others\n * data-hidden=\"key\" → Toggles hidden (truthy = hidden)\n * data-disabled=\"key\" → Toggles disabled (truthy = disabled)\n * data-checked=\"key\" → Toggles checked (for checkboxes/radios)\n * data-required=\"key\" → Toggles required (truthy = required)\n * data-aria-expanded=\"key\" → Sets aria-expanded to \"true\"/\"false\"\n * data-aria-hidden=\"key\" → Sets aria-hidden to \"true\"/\"false\"\n *\n * Extensible via handlers option:\n * import { show, classToggle } from 'lume-js/handlers';\n * bindDom(root, store, { handlers: [show, classToggle('active')] });\n *\n * Custom handlers:\n * const tooltip = { attr: 'data-tooltip', apply(el, val) { el.title = val ?? ''; } };\n * bindDom(root, store, { handlers: [tooltip] });\n *\n * Usage:\n * import { bindDom } from \"lume-js\";\n * const cleanup = bindDom(document.body, store);\n */\n\nimport { logWarn } from '../utils/log.js';\n\n// --- Default Handlers (always active, backwards compatible) ---\n\nconst boolHandler = (name) => ({\n attr: `data-${name}`,\n apply(el, val) { el[name] = Boolean(val); }\n});\n\nconst ariaHandler = (name) => ({\n attr: `data-${name}`,\n apply(el, val) { el.setAttribute(name, val ? 'true' : 'false'); }\n});\n\nconst DEFAULT_HANDLERS = [\n boolHandler('hidden'),\n boolHandler('disabled'),\n boolHandler('checked'),\n boolHandler('required'),\n ariaHandler('aria-expanded'),\n ariaHandler('aria-hidden'),\n];\n\n/**\n * Merge default and user handlers.\n * User handlers override defaults with same attr (Map deduplicates).\n * User handler arrays are flattened one level (supports classToggle()).\n */\nfunction mergeHandlers(defaults, userHandlers) {\n if (!userHandlers.length) return defaults;\n const merged = new Map();\n for (const h of defaults) merged.set(h.attr, h);\n for (const h of userHandlers.flat()) merged.set(h.attr, h);\n return [...merged.values()];\n}\n\n/**\n * DOM binding for reactive state\n */\nexport function bindDom(root, store, options = {}) {\n if (!(root instanceof HTMLElement)) {\n throw new Error('bindDom() requires a valid HTMLElement as root');\n }\n if (!store || typeof store !== 'object') {\n throw new Error('bindDom() requires a reactive state object');\n }\n\n const { immediate = false, handlers: userHandlers = [] } = options;\n const handlers = mergeHandlers(DEFAULT_HANDLERS, userHandlers);\n\n const performBinding = () => {\n const cleanups = [];\n const bindingMap = new WeakMap();\n\n // Build compiled selector: data-bind (always) + all handler attrs\n const selector = ['[data-bind]', ...handlers.map(h => `[${h.attr}]`)].join(',');\n const elements = root.querySelectorAll(selector);\n\n for (const el of elements) {\n // data-bind (two-way) — always in core, special handling\n if (el.hasAttribute('data-bind')) {\n const c = handleDataBind(el, store, el.getAttribute('data-bind'), bindingMap);\n if (c) cleanups.push(c);\n }\n\n // All registered handlers (default + user)\n for (const handler of handlers) {\n if (el.hasAttribute(handler.attr)) {\n const c = applyHandler(el, store, el.getAttribute(handler.attr), handler);\n if (c) cleanups.push(c);\n }\n }\n }\n\n // Event delegation for two-way bindings\n const inputHandler = e => {\n const binding = bindingMap.get(e.target);\n if (binding) binding.target[binding.key] = getInputValue(e.target);\n };\n root.addEventListener(\"input\", inputHandler);\n cleanups.push(() => root.removeEventListener(\"input\", inputHandler));\n\n return () => cleanups.forEach(c => c());\n };\n\n // Auto-wait for DOM if needed\n if (!immediate && document.readyState === 'loading') {\n let cleanup = null;\n const onReady = () => { cleanup = performBinding(); };\n document.addEventListener('DOMContentLoaded', onReady, { once: true });\n return () => cleanup ? cleanup() : document.removeEventListener('DOMContentLoaded', onReady);\n }\n\n return performBinding();\n}\n\n/**\n * Apply a handler to an element via subscription.\n * Resolves the state path and subscribes to changes.\n */\nfunction applyHandler(el, store, path, handler) {\n const result = resolveProp(store, path);\n if (!result) return null;\n const { target, key } = result;\n return target.$subscribe(key, val => handler.apply(el, val));\n}\n\n/**\n * Handle data-bind (two-way for inputs, textContent for others)\n */\nfunction handleDataBind(el, store, path, bindingMap) {\n const result = resolveProp(store, path);\n if (!result) return null;\n\n const { target, key } = result;\n const unsub = target.$subscribe(key, val => updateElement(el, val));\n\n if (isFormInput(el)) {\n bindingMap.set(el, { target, key });\n }\n\n return unsub;\n}\n\n/**\n * Resolve a nested path in an object.\n * Example: resolvePath(obj, ['user', 'address']) returns obj.user.address\n */\nfunction resolvePath(obj, pathArr) {\n if (!pathArr || pathArr.length === 0) {\n return obj;\n }\n let current = obj;\n for (let i = 0; i < pathArr.length; i++) {\n const key = pathArr[i];\n if (current === null || current === undefined) {\n return null;\n }\n if (!(key in current)) {\n return null;\n }\n current = current[key];\n }\n return current;\n}\n\n/**\n * Resolve path to target and key.\n *\n * ⚠️ Path bindings are resolved once at bind time. If an intermediate\n * object in the path is null/undefined at bindDom call time, the binding\n * is permanently dead and will not self-heal when the path later becomes valid.\n */\nfunction resolveProp(store, path) {\n if (!path) return null;\n\n const pathArr = path.split(\".\");\n const key = pathArr.pop();\n const target = resolvePath(store, pathArr);\n\n if (target === null || target === undefined) {\n logWarn(`[Lume.js] Invalid path \"${path}\"`);\n return null;\n }\n\n if (!target?.$subscribe) {\n logWarn(`[Lume.js] Target for \"${path}\" is not reactive`);\n return null;\n }\n\n return { target, key };\n}\n\n/**\n * Update element with value (for data-bind)\n */\nfunction updateElement(el, val) {\n if (el.tagName === \"INPUT\") {\n if (el.type === \"checkbox\") el.checked = Boolean(val);\n else if (el.type === \"radio\") el.checked = el.value === String(val);\n else el.value = val ?? '';\n } else if (el.tagName === \"TEXTAREA\" || el.tagName === \"SELECT\") {\n el.value = val ?? '';\n } else {\n el.textContent = val ?? '';\n }\n}\n\n/**\n * Get value from input\n */\nfunction getInputValue(el) {\n if (el.type === \"checkbox\") return el.checked;\n if (el.type === \"number\" || el.type === \"range\") return el.valueAsNumber;\n return el.value;\n}\n\n/**\n * Check if element is form input\n */\nfunction isFormInput(el) {\n return el.tagName === \"INPUT\" || el.tagName === \"TEXTAREA\" || el.tagName === \"SELECT\";\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}","/**\n * Lume-JS List Rendering (Addon)\n *\n * Renders lists with automatic subscription and element reuse by key.\n * \n * Core guarantees:\n * Element reuse by key (same DOM nodes, not recreated)\n * Minimal DOM operations (only updates what changed)\n * Memory efficiency (cleanup on remove)\n * \n * Default behavior (can be disabled/customized):\n * ✅ Focus preservation (maintains activeElement and selection)\n * ✅ Scroll preservation (intelligent positioning for add/remove/reorder)\n * \n * Philosophy: No artificial limitations\n * - All preservation logic is overridable via options\n * - Set to null/false to disable, or provide custom functions\n * - Export utilities so you can wrap/extend them\n *\n * ⚠️ IMPORTANT: Arrays must be updated immutably!\n * store.items.push(x) // ❌ Won't trigger update\n * store.items = [...items] // ✅ Triggers update\n * \n * ═══════════════════════════════════════════════════════════════════════\n * PATTERN 1: Simple (render only) - for simple cases or backward compat\n * ═══════════════════════════════════════════════════════════════════════\n * \n * repeat('#list', store, 'todos', {\n * key: todo => todo.id,\n * render: (todo, el) => {\n * el.textContent = todo.name; // Called on every update\n * }\n * });\n *\n * ═══════════════════════════════════════════════════════════════════════\n * PATTERN 2: Clean separation (create + update) - recommended\n * ═══════════════════════════════════════════════════════════════════════\n *\n * repeat('#list', store, 'todos', {\n * key: todo => todo.id,\n * create: (todo, el) => {\n * // Called ONCE when element is created - build DOM structure\n * const nameSpan = document.createElement('span');\n * nameSpan.className = 'name';\n * el.appendChild(nameSpan);\n * const btn = document.createElement('button');\n * btn.textContent = 'Delete';\n * btn.onclick = () => deleteTodo(todo.id);\n * el.appendChild(btn);\n *\n * // Return a cleanup function — called automatically when element is removed\n * return () => {\n * // Unsubscribe from external listeners, remove timers, etc.\n * };\n * },\n * update: (todo, el, index, { isFirstRender }) => {\n * // Called on every update - bind data\n * // isFirstRender = true on initial render, false on subsequent\n * // Skipped if same object reference (optimization)\n * el.querySelector('.name').textContent = todo.name;\n * }\n * });\n *\n * ═══════════════════════════════════════════════════════════════════════\n * ADVANCED: Custom preservation strategies\n * ═══════════════════════════════════════════════════════════════════════\n * \n * import { defaultFocusPreservation, defaultScrollPreservation } from \"lume-js/addons\";\n * \n * repeat('#list', store, 'items', {\n * key: item => item.id,\n * create: (item, el) => { ... },\n * update: (item, el) => { ... },\n * preserveFocus: null, // disable focus preservation\n * preserveScroll: (container, context) => {\n * const restore = defaultScrollPreservation(container, context);\n * return () => { restore(); console.log('Scroll restored!'); };\n * }\n * });\n */\nimport { logWarn, logError } from '../utils/log.js';\n\n/**\n * Default focus preservation strategy\n * Saves activeElement and selection state before DOM updates\n * \n * @param {HTMLElement} container - The list container\n * @returns {Function|null} Restore function, or null if nothing to restore\n */\nexport function defaultFocusPreservation(container) {\n const activeEl = document.activeElement;\n const shouldRestore = container.contains(activeEl);\n\n if (!shouldRestore) return null;\n\n let selectionStart = null;\n let selectionEnd = null;\n\n if (activeEl.tagName === 'INPUT' || activeEl.tagName === 'TEXTAREA') {\n selectionStart = activeEl.selectionStart;\n selectionEnd = activeEl.selectionEnd;\n }\n\n return () => {\n if (document.body.contains(activeEl)) {\n activeEl.focus();\n if (selectionStart !== null && selectionEnd !== null) {\n activeEl.setSelectionRange(selectionStart, selectionEnd);\n }\n }\n };\n}\n\n/**\n * Default scroll preservation strategy\n * Uses anchor-based preservation for add/remove, pixel position for reorder\n * \n * @param {HTMLElement} container - The list container\n * @param {Object} context - Additional context\n * @param {boolean} context.isReorder - Whether this is a reorder operation\n * @returns {Function} Restore function\n */\nexport function defaultScrollPreservation(container, context = {}) {\n const { isReorder = false } = context;\n const scrollTop = container.scrollTop;\n\n // Early return if no scroll\n if (scrollTop === 0) {\n return () => { container.scrollTop = 0; };\n }\n\n let anchorElement = null;\n let anchorOffset = 0;\n\n // Only use anchor-based preservation for add/remove, not reorder\n if (!isReorder) {\n const containerRect = container.getBoundingClientRect();\n // Avoid Array.from - iterate children directly\n for (let child = container.firstElementChild; child; child = child.nextElementSibling) {\n const rect = child.getBoundingClientRect();\n\n if (rect.bottom > containerRect.top) {\n anchorElement = child;\n anchorOffset = rect.top - containerRect.top;\n break;\n }\n }\n }\n\n return () => {\n if (anchorElement && document.body.contains(anchorElement)) {\n const newRect = anchorElement.getBoundingClientRect();\n const containerRect = container.getBoundingClientRect();\n const currentOffset = newRect.top - containerRect.top;\n const scrollAdjustment = currentOffset - anchorOffset;\n\n container.scrollTop = container.scrollTop + scrollAdjustment;\n } else {\n container.scrollTop = scrollTop;\n }\n };\n}\n\n/**\n * Efficiently render a list with element reuse\n * \n * @param {string|HTMLElement} container - Container element or selector\n * @param {Object} store - Reactive state object\n * @param {string} arrayKey - Key in store containing the array\n * @param {Object} options - Configuration\n * @param {Function} options.key - Function to extract unique key: (item) => key\n * @param {Function} [options.render] - Function to render item (called for all items): (item, element, index) => void\n * @param {Function} [options.create] - Function for new elements only: (item, element, index) => void | Function. If a function is returned, it is registered as the element's cleanup and called automatically when the element is removed (by list update or full cleanup).\n * @param {Function} [options.update] - Function for data binding: (item, element, index, { isFirstRender }) => void. Skipped if same item reference AND same index.\n * @param {Function} [options.remove] - Additional cleanup when element is removed: (item, element) => void. Called after any cleanup function returned by create(). Optional — prefer returning a cleanup from create() for automatic lifecycle management.\n * @param {string|Function} [options.element='div'] - Element tag name or factory function\n * @param {Function|null} [options.preserveFocus=defaultFocusPreservation] - Focus preservation strategy (null to disable)\n * @param {Function|null} [options.preserveScroll=defaultScrollPreservation] - Scroll preservation strategy (null to disable)\n * @returns {Function} Cleanup function\n */\n\nexport function repeat(container, store, arrayKey, options) {\n const {\n key,\n render,\n create,\n update,\n remove,\n element = 'div',\n preserveFocus = defaultFocusPreservation,\n preserveScroll = defaultScrollPreservation\n } = options;\n\n // Resolve container\n const containerEl =\n typeof container === 'string'\n ? document.querySelector(container)\n : container;\n\n if (!containerEl) {\n logWarn(`[Lume.js] repeat(): container \"${container}\" not found`);\n return () => { };\n }\n\n if (typeof key !== 'function') {\n throw new Error('[Lume.js] repeat(): options.key must be a function');\n }\n\n if (typeof render !== 'function' && typeof create !== 'function') {\n throw new Error('[Lume.js] repeat(): options.render or options.create must be a function');\n }\n\n // key -> HTMLElement\n const elementsByKey = new Map();\n // key -> previous item (for reference comparison)\n const prevItemsByKey = new Map();\n // key -> previous index (for reorder detection)\n const prevIndexByKey = new Map();\n // key -> cleanup function returned by create()\n const cleanupByKey = new Map();\n const seenKeys = new Set();\n\n function createElement() {\n return typeof element === 'function'\n ? element()\n : document.createElement(element);\n }\n\n function reconcileDOM(container, nextEls) {\n let ptr = container.firstChild;\n\n for (let i = 0; i < nextEls.length; i++) {\n const desired = nextEls[i];\n\n if (ptr === desired) {\n ptr = ptr.nextSibling;\n continue;\n }\n\n container.insertBefore(desired, ptr);\n }\n\n // Remove leftover children not in nextEls\n while (ptr) {\n const next = ptr.nextSibling;\n container.removeChild(ptr);\n ptr = next;\n }\n }\n\n function applyPreservation(container, fn, isReorder) {\n const shouldPreserve = document.body.contains(container);\n const restoreFocus = shouldPreserve && preserveFocus ? preserveFocus(container) : null;\n const restoreScroll = shouldPreserve && preserveScroll ? preserveScroll(container, { isReorder }) : null;\n\n fn();\n\n if (restoreFocus) restoreFocus();\n if (restoreScroll) restoreScroll();\n }\n\n // eslint-disable-next-line sonarjs/cognitive-complexity -- keyed DOM reconciliation: create/reuse/remove nodes, key dedup, scroll/focus preservation\n function updateList() {\n const items = store[arrayKey];\n\n if (!Array.isArray(items)) {\n logWarn(`[Lume.js] repeat(): store.${arrayKey} is not an array`);\n return;\n }\n\n // Only compute isReorder if scroll preservation needs it.\n // Uses elementsByKey (previous state) and items directly — no Set allocations.\n let isReorder = false;\n if (preserveScroll && elementsByKey.size === items.length) {\n isReorder = true;\n for (let i = 0; i < items.length; i++) {\n if (!elementsByKey.has(key(items[i]))) { isReorder = false; break; }\n }\n }\n\n seenKeys.clear();\n const nextEls = [];\n\n // Build ordered list of DOM nodes (created or reused)\n for (let i = 0; i < items.length; i++) {\n const item = items[i];\n const k = key(item);\n\n if (seenKeys.has(k)) {\n logWarn(`[Lume.js] repeat(): duplicate key \"${k}\"`);\n continue;\n }\n seenKeys.add(k);\n\n let el = elementsByKey.get(k);\n const isFirstRender = !el;\n\n if (isFirstRender) {\n el = createElement();\n elementsByKey.set(k, el);\n }\n\n try {\n // Call create for new elements (DOM structure)\n if (isFirstRender && create) {\n const cleanup = create(item, el, i);\n if (typeof cleanup === 'function') {\n cleanupByKey.set(k, cleanup);\n }\n }\n\n // Call update for data binding (new and existing elements)\n // Skip if same item reference AND same index (optimization)\n const prevItem = prevItemsByKey.get(k);\n const prevIndex = prevIndexByKey.get(k);\n if (update) {\n if (prevItem !== item || prevIndex !== i) {\n update(item, el, i, { isFirstRender });\n }\n } else if (render) {\n // Backward compatibility: render handles both create and update\n render(item, el, i);\n }\n\n // Store reference and index for next comparison\n prevItemsByKey.set(k, item);\n prevIndexByKey.set(k, i);\n\n } catch (err) {\n logError(`[Lume.js] repeat(): error rendering key \"${k}\":`, err);\n }\n\n nextEls.push(el);\n }\n\n // eslint-disable-next-line sonarjs/cognitive-complexity -- DOM cleanup pass: remove stale nodes, call per-item cleanup callbacks, update maps\n applyPreservation(containerEl, () => {\n reconcileDOM(containerEl, nextEls);\n\n // Clean maps: remove keys not in seenKeys (new state)\n if (elementsByKey.size !== seenKeys.size) {\n for (const k of elementsByKey.keys()) {\n if (!seenKeys.has(k)) {\n const el = elementsByKey.get(k);\n const prevItem = prevItemsByKey.get(k);\n // Call create-returned cleanup first, then remove callback\n const cleanup = cleanupByKey.get(k);\n if (typeof cleanup === 'function') {\n try {\n cleanup();\n } catch (err) {\n logError(`[Lume.js] repeat(): cleanup error for key \"${k}\":`, err);\n }\n }\n if (typeof remove === 'function' && el) {\n remove(prevItem, el);\n }\n elementsByKey.delete(k);\n prevItemsByKey.delete(k);\n prevIndexByKey.delete(k);\n cleanupByKey.delete(k);\n }\n }\n }\n }, isReorder);\n }\n\n // Subscription — $subscribe calls updateList immediately (initial render),\n // so no separate updateList() call is needed for reactive stores.\n let unsubscribe;\n if (typeof store.$subscribe === 'function') {\n unsubscribe = store.$subscribe(arrayKey, updateList);\n } else if (typeof store.subscribe === 'function') {\n // Generic subscribe (e.g. computed) — subscribe first, then initial render\n const subResult = store.subscribe(() => updateList());\n updateList();\n // Normalize both function-style and object-style (RxJS Subscription) returns\n unsubscribe = typeof subResult === 'function'\n ? subResult\n : () => { subResult?.unsubscribe?.(); };\n } else {\n // Non-reactive store — render once and return cleanup\n updateList();\n logWarn('[Lume.js] repeat(): store is not reactive (no $subscribe or subscribe method)');\n return () => {\n for (const [k, el] of elementsByKey) {\n const prevItem = prevItemsByKey.get(k);\n const cleanup = cleanupByKey.get(k);\n if (typeof cleanup === 'function') {\n try {\n cleanup();\n } catch (err) {\n logError(`[Lume.js] repeat(): cleanup error for key \"${k}\":`, err);\n }\n }\n if (typeof remove === 'function') {\n remove(prevItem, el);\n }\n }\n containerEl.replaceChildren();\n elementsByKey.clear();\n prevItemsByKey.clear();\n prevIndexByKey.clear();\n cleanupByKey.clear();\n seenKeys.clear();\n };\n }\n\n return () => {\n if (typeof unsubscribe === 'function') {\n unsubscribe();\n }\n // Invoke cleanup and remove callback for all remaining elements before clearing\n for (const [k, el] of elementsByKey) {\n const prevItem = prevItemsByKey.get(k);\n const cleanup = cleanupByKey.get(k);\n if (typeof cleanup === 'function') {\n try {\n cleanup();\n } catch (err) {\n logError(`[Lume.js] repeat(): cleanup error for key \"${k}\":`, err);\n }\n }\n if (typeof remove === 'function') {\n remove(prevItem, el);\n }\n }\n // Clear DOM elements (replaceChildren is faster than loop)\n containerEl.replaceChildren();\n elementsByKey.clear();\n prevItemsByKey.clear();\n prevIndexByKey.clear();\n cleanupByKey.clear();\n seenKeys.clear();\n };\n}\n","/**\n * Lume-JS Debug Addon\n * \n * Developer-friendly logging and inspection of reactive state operations.\n * Critical for adoption - hard to debug = hard to adopt.\n * \n * Usage:\n * import { state } from \"lume-js\";\n * import { withPlugins, createDebugPlugin, debug } from \"lume-js/addons\";\n * \n * const store = withPlugins(state({ count: 0 }), [createDebugPlugin({ label: 'myStore' })]);\n * \n * debug.enable(); // Enable logging\n * debug.filter('count'); // Only log 'count' key\n * debug.stats(); // Show statistics\n * \n * @module addons/debug\n */\n\n// Global debug state\nlet globalEnabled = true;\nlet globalFilter = null; // string, RegExp, or null\nconst stats = new Map(); // label -> { gets: Map, sets: Map, notifies: Map }\n\n/**\n * Check if a key matches the current filter\n * @param {string} key\n * @returns {boolean}\n */\nfunction matchesFilter(key) {\n if (globalFilter === null) return true;\n if (typeof globalFilter === 'string') {\n return key.includes(globalFilter);\n }\n if (globalFilter instanceof RegExp) {\n return globalFilter.test(key);\n }\n return true;\n}\n\n/**\n * Get or create stats entry for a label\n * @param {string} label\n * @returns {object}\n */\nfunction getStats(label) {\n if (!stats.has(label)) {\n stats.set(label, {\n gets: new Map(),\n sets: new Map(),\n notifies: new Map()\n });\n }\n return stats.get(label);\n}\n\n/**\n * Increment a stat counter\n * @param {string} label\n * @param {'gets'|'sets'|'notifies'} type\n * @param {string} key\n */\nfunction incrementStat(label, type, key) {\n const s = getStats(label);\n const map = s[type];\n map.set(key, (map.get(key) || 0) + 1);\n}\n\nconst MAX_LOG_LEN = 100;\nconst TRUNCATED_LEN = MAX_LOG_LEN - 3;\n\n/**\n * Format value for logging (truncate long values)\n * @param {any} value\n * @returns {string}\n */\nfunction formatValue(value) {\n try {\n const json = JSON.stringify(value);\n if (json.length > MAX_LOG_LEN) {\n return json.slice(0, TRUNCATED_LEN) + '...';\n }\n return json;\n } catch {\n return String(value);\n }\n}\n\n/**\n * Create a debug plugin instance for a reactive state store.\n * \n * @param {object} [options] - Configuration options\n * @param {string} [options.label='store'] - Label for log messages\n * @param {boolean} [options.logGet=false] - Log property reads (can be noisy)\n * @param {boolean} [options.logSet=true] - Log property writes\n * @param {boolean} [options.logNotify=true] - Log subscriber notifications\n * @param {boolean} [options.trace=false] - Show stack trace for SET operations\n * @returns {object} Plugin object for state()\n * \n * @example\n * const store = withPlugins(state({ count: 0 }), [createDebugPlugin({ label: 'counter' })]);\n * \n * @example\n * // With stack traces for debugging where state changes originate\n * const store = withPlugins(state({ count: 0 }), [createDebugPlugin({ label: 'counter', trace: true })]);\n */\nexport function createDebugPlugin(options = {}) {\n const label = options.label ?? 'store';\n\n // IMPORTANT: Do NOT destructure options here!\n // Options may contain getters for dynamic runtime toggling (e.g., from UI).\n // Destructuring would copy values once at creation time, breaking reactivity.\n // Use getOpt() helper to read options dynamically in each hook.\n const getOpt = (name, defaultVal) => {\n const val = options[name];\n return val !== undefined ? val : defaultVal;\n };\n\n return {\n name: `debug:${label}`,\n\n onInit: () => {\n if (globalEnabled) {\n console.log(`%c[${label}]%c initialized`, 'color: #888; font-weight: bold', 'color: inherit');\n }\n },\n\n onGet: (key, value) => {\n // Skip internal properties\n if (typeof key === 'string' && key.startsWith('$')) {\n return value;\n }\n\n incrementStat(label, 'gets', key);\n\n if (globalEnabled && getOpt('logGet', false) && matchesFilter(key)) {\n console.log(\n `%c[${label}]%c GET %c${key}%c = ${formatValue(value)}`,\n 'color: #888; font-weight: bold',\n 'color: #4CAF50',\n 'color: #2196F3; font-weight: bold',\n 'color: inherit'\n );\n }\n\n return value;\n },\n\n onSet: (key, newValue, oldValue) => {\n // Skip internal properties\n if (typeof key === 'string' && key.startsWith('$')) {\n return newValue;\n }\n\n incrementStat(label, 'sets', key);\n\n if (globalEnabled && getOpt('logSet', true) && matchesFilter(key)) {\n console.log(\n `%c[${label}]%c SET %c${key}%c: ${formatValue(oldValue)} → ${formatValue(newValue)}`,\n 'color: #888; font-weight: bold',\n 'color: #FF9800',\n 'color: #2196F3; font-weight: bold',\n 'color: inherit'\n );\n\n // Show stack trace if enabled (helps find where state changes originate)\n if (getOpt('trace', false)) {\n console.trace(`%c[${label}] Stack trace for ${key}`, 'color: #888');\n }\n }\n\n return newValue;\n },\n\n onSubscribe: (key) => {\n if (globalEnabled && matchesFilter(key)) {\n console.log(\n `%c[${label}]%c SUBSCRIBE %c${key}`,\n 'color: #888; font-weight: bold',\n 'color: #9C27B0',\n 'color: #2196F3; font-weight: bold'\n );\n }\n },\n\n onNotify: (key, value) => {\n // Skip internal properties\n if (typeof key === 'string' && key.startsWith('$')) {\n return;\n }\n\n incrementStat(label, 'notifies', key);\n\n if (globalEnabled && getOpt('logNotify', true) && matchesFilter(key)) {\n console.log(\n `%c[${label}]%c NOTIFY %c${key}%c = ${formatValue(value)}`,\n 'color: #888; font-weight: bold',\n 'color: #E91E63',\n 'color: #2196F3; font-weight: bold',\n 'color: inherit'\n );\n }\n }\n };\n}\n\n/**\n * Global debug controls\n */\nexport const debug = {\n /**\n * Enable debug logging globally\n */\n enable() {\n globalEnabled = true;\n console.log('%c[lume-debug]%c Logging enabled', 'color: #888; font-weight: bold', 'color: #4CAF50');\n },\n\n /**\n * Disable debug logging globally\n */\n disable() {\n globalEnabled = false;\n console.log('%c[lume-debug]%c Logging disabled', 'color: #888; font-weight: bold', 'color: #F44336');\n },\n\n /**\n * Check if debug logging is currently enabled\n * @returns {boolean}\n */\n isEnabled() {\n return globalEnabled;\n },\n\n /**\n * Filter logs by key pattern\n * @param {string|RegExp|null} pattern - Pattern to match, or null to clear filter\n */\n filter(pattern) {\n globalFilter = pattern;\n if (pattern === null) {\n console.log('%c[lume-debug]%c Filter cleared', 'color: #888; font-weight: bold', 'color: inherit');\n } else {\n console.log(`%c[lume-debug]%c Filter set: ${pattern}`, 'color: #888; font-weight: bold', 'color: inherit');\n }\n },\n\n /**\n * Get current filter pattern\n * @returns {string|RegExp|null}\n */\n getFilter() {\n return globalFilter;\n },\n\n /**\n * Get statistics data (silent - no console output)\n * Use logStats() if you want to see stats in console.\n * @returns {object} Stats object for programmatic access\n */\n stats() {\n const result = {};\n\n for (const [label, data] of stats) {\n result[label] = {\n gets: Object.fromEntries(data.gets),\n sets: Object.fromEntries(data.sets),\n notifies: Object.fromEntries(data.notifies)\n };\n }\n\n return result;\n },\n\n /**\n * Log statistics summary to console (with formatting)\n * @returns {object} Stats object for programmatic access\n */\n logStats() {\n const result = this.stats();\n\n if (Object.keys(result).length === 0) {\n console.log('%c[lume-debug]%c No stats collected yet', 'color: #888; font-weight: bold', 'color: inherit');\n return result;\n }\n\n console.group('%c[lume-debug] Statistics', 'color: #888; font-weight: bold');\n\n for (const [label, data] of Object.entries(result)) {\n console.group(`%c${label}`, 'color: #2196F3; font-weight: bold');\n\n // Use console.table for better formatted output\n const tableData = [];\n const allKeys = new Set([\n ...Object.keys(data.gets),\n ...Object.keys(data.sets),\n ...Object.keys(data.notifies)\n ]);\n\n for (const key of allKeys) {\n tableData.push({\n key,\n gets: data.gets[key] || 0,\n sets: data.sets[key] || 0,\n notifies: data.notifies[key] || 0\n });\n }\n\n if (tableData.length > 0) {\n console.table(tableData);\n }\n\n console.groupEnd();\n }\n\n console.groupEnd();\n\n return result;\n },\n\n /**\n * Reset all collected statistics\n */\n resetStats() {\n stats.clear();\n console.log('%c[lume-debug]%c Stats reset', 'color: #888; font-weight: bold', 'color: inherit');\n }\n};\n","/** data-show=\"key\" → el.hidden = !Boolean(val) */\nexport const show = {\n attr: 'data-show',\n apply(el, val) { el.hidden = !Boolean(val); }\n};\n","/** data-classname=\"key\" → el.className = val || '' */\nexport const className = {\n attr: 'data-classname',\n apply(el, val) { el.className = val || ''; }\n};\n","/**\n * Create a handler for any HTML boolean attribute.\n * Uses toggleAttribute() — works correctly with any attribute name\n * (readonly, contenteditable, etc.) without worrying about camelCase property names.\n *\n * @param {string} name - Attribute name (e.g., 'readonly', 'open', 'contenteditable')\n * @returns {{ attr: string, apply: function }}\n */\nexport function boolAttr(name) {\n return {\n attr: `data-${name}`,\n apply(el, val) { el.toggleAttribute(name, Boolean(val)); }\n };\n}\n","/**\n * Create a handler for an ARIA attribute.\n * Coerces value to \"true\"/\"false\" string — use stringAttr(\"aria-X\") for token/string ARIA attrs.\n *\n * @param {string} name - ARIA name, with or without \"aria-\" prefix\n * @returns {{ attr: string, apply: function }}\n */\nexport function ariaAttr(name) {\n const fullName = name.startsWith('aria-') ? name : `aria-${name}`;\n return {\n attr: `data-${fullName}`,\n apply(el, val) { el.setAttribute(fullName, val ? 'true' : 'false'); }\n };\n}\n","/**\n * Create a handler for any string attribute (href, src, title, alt, action, etc.)\n * Sets the attribute value as a string. Removes the attribute when value is null/undefined.\n *\n * @param {string} name - HTML attribute name (e.g., 'href', 'src', 'title')\n * @returns {{ attr: string, apply: function }}\n */\nexport function stringAttr(name) {\n return {\n attr: `data-${name}`,\n apply(el, val) {\n if (val == null) el.removeAttribute(name);\n else el.setAttribute(name, String(val));\n }\n };\n}\n","import { show } from './show.js';\nimport { boolAttr } from './boolAttr.js';\nimport { ariaAttr } from './ariaAttr.js';\nimport { stringAttr } from './stringAttr.js';\n\n/** @see https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes#boolean_attributes */\nconst BOOL_ATTRS = [\n 'readonly', 'open', 'novalidate', 'formnovalidate', 'multiple',\n 'autofocus', 'autoplay', 'controls', 'loop', 'muted', 'defer',\n 'async', 'reversed', 'selected', 'inert', 'allowfullscreen',\n];\n\n/** @see https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes */\nconst STRING_ATTRS = [\n 'href', 'src', 'alt', 'title', 'placeholder', 'action', 'method',\n 'target', 'rel', 'type', 'name', 'role', 'lang', 'tabindex',\n 'pattern', 'min', 'max', 'step', 'minlength', 'maxlength',\n 'width', 'height', 'for', 'form', 'accept', 'autocomplete',\n 'loading', 'decoding', 'inputmode', 'enterkeyhint', 'draggable',\n 'contenteditable', 'spellcheck', 'translate', 'dir', 'id',\n 'poster', 'preload', 'download', 'media', 'sizes', 'srcset',\n 'colspan', 'rowspan', 'scope', 'headers', 'wrap', 'sandbox',\n];\n\n/** ARIA boolean state attributes — coerced to \"true\"/\"false\" string. */\nconst ARIA_BOOL_ATTRS = [\n 'pressed', 'selected', 'disabled', 'checked', 'invalid', 'required',\n 'busy', 'modal', 'multiselectable', 'multiline', 'readonly', 'atomic',\n];\n\n/** ARIA string/token/numeric attributes — value passed through as-is. */\nconst ARIA_STRING_ATTRS = [\n 'current', 'live', 'relevant', 'haspopup',\n 'sort', 'autocomplete', 'orientation',\n 'label', 'describedby', 'labelledby', 'controls', 'owns',\n 'activedescendant', 'errormessage', 'details', 'flowto',\n 'valuenow', 'valuemin', 'valuemax', 'valuetext',\n 'colcount', 'colindex', 'colspan', 'rowcount', 'rowindex', 'rowspan',\n 'level', 'setsize', 'posinset', 'placeholder', 'roledescription',\n 'keyshortcuts', 'braillelabel', 'brailleroledescription',\n];\n\n/**\n * One-import preset that enables all standard HTML attributes as reactive handlers.\n * Returns a flat array — pass directly to handlers option.\n *\n * @returns {Array<{ attr: string, apply: function }>}\n */\nexport function htmlAttrs() {\n return [\n show,\n ...BOOL_ATTRS.map(name => boolAttr(name)),\n ...STRING_ATTRS.map(name => stringAttr(name)),\n ...ARIA_BOOL_ATTRS.map(name => ariaAttr(name)),\n ...ARIA_STRING_ATTRS.map(name => stringAttr(`aria-${name}`)),\n ];\n}\n","import { boolAttr } from './boolAttr.js';\nimport { ariaAttr } from './ariaAttr.js';\n\n/** Form-related handlers (beyond built-in disabled/checked/required) */\nexport const formHandlers = [\n boolAttr('readonly'),\n];\n\n/** Additional ARIA handlers (beyond built-in aria-expanded/aria-hidden) */\nexport const a11yHandlers = [\n ariaAttr('pressed'),\n ariaAttr('selected'),\n ariaAttr('disabled'),\n];\n","/**\n * Create handlers for CSS class toggling.\n * Each name creates a handler: data-class-{name}=\"key\" → el.classList.toggle(name, Boolean(val))\n * Returns an array — pass directly to handlers (auto-flattened by bindDom).\n *\n * @param {...string} names - CSS class names to create handlers for\n * @returns {Array<{ attr: string, apply: function }>}\n */\nexport function classToggle(...names) {\n return names.map(name => ({\n attr: `data-class-${name}`,\n apply(el, val) { el.classList.toggle(name, Boolean(val)); }\n }));\n}\n","/**\n * Lume-JS Computed Addon\n * \n * Creates computed values that automatically update when dependencies change.\n * Uses core effect() for automatic dependency tracking.\n * \n * Usage:\n * import { computed } from \"lume-js/addons/computed\";\n * \n * const doubled = computed(() => store.count * 2);\n * console.log(doubled.value); // Auto-updates when store.count changes\n * \n * Features:\n * - Automatic dependency tracking (no manual recompute)\n * - Cached values (only recomputes when dependencies change)\n * - Subscribe to changes\n * - Cleanup with dispose()\n * \n * @module addons/computed\n */\n\nimport { effect } from '../core/effect.js';\nimport { logError } from '../utils/log.js';\n\n/**\n * Creates a computed value with automatic dependency tracking\n * \n * The computation function runs immediately and tracks which state\n * properties are accessed. When any dependency changes, the value\n * is automatically recomputed.\n *\n * ⚠️ Circular self-mutations are automatically suppressed. If a computed\n * mutates a state property it depends on, the flush triggered by that\n * mutation is skipped to prevent an infinite microtask loop.\n *\n * @param {function} fn - Function that computes the value\n * @returns {object} Object with .value property and methods\n * \n * @example\n * const store = state({ count: 5 });\n * \n * const doubled = computed(() => store.count * 2);\n * console.log(doubled.value); // 10\n * \n * store.count = 10;\n * // After microtask:\n * console.log(doubled.value); // 20 (auto-updated)\n * \n * @example\n * // Subscribe to changes\n * const unsub = doubled.subscribe(value => {\n * console.log('Doubled changed to:', value);\n * });\n * \n * @example\n * // Cleanup\n * doubled.dispose();\n */\nexport function computed(fn) {\n if (typeof fn !== 'function') {\n throw new Error('computed() requires a function');\n }\n\n let cachedValue;\n let isInitialized = false;\n let isInComputation = false;\n let disposed = false;\n const subscribers = [];\n\n // Use effect to automatically track dependencies\n const cleanupEffect = effect(() => {\n // Skip re-entry from a flush triggered by our own synchronous mutation.\n // The mutation inside fn() queues a microtask flush; we stay flagged\n // until a subsequent microtask clears it, so that flush is dropped.\n if (isInComputation || disposed) return;\n\n isInComputation = true;\n\n try {\n const newValue = fn();\n\n // Check if value actually changed - Object.is() handles NaN and -0\n if (!isInitialized || !Object.is(newValue, cachedValue)) {\n cachedValue = newValue;\n isInitialized = true;\n\n // Notify all subscribers\n subscribers.forEach(callback => callback(cachedValue));\n }\n } catch (error) {\n logError('[Lume.js computed] Error in computation:', error);\n // Set to undefined on error, mark as initialized\n if (!isInitialized || cachedValue !== undefined) {\n cachedValue = undefined;\n isInitialized = true;\n\n // Notify subscribers of error state\n subscribers.forEach(callback => callback(cachedValue));\n }\n } finally {\n // Defer clearing the flag so any flush microtask queued by fn()\n // sees it still set and skips re-entry.\n queueMicrotask(() => {\n if (!disposed) {\n isInComputation = false;\n }\n });\n }\n });\n\n return {\n /**\n * Get the current computed value\n */\n get value() {\n if (!isInitialized) {\n throw new Error('Computed value accessed before initialization');\n }\n return cachedValue;\n },\n\n /**\n * Subscribe to changes in computed value\n * \n * @param {function} callback - Called when value changes\n * @returns {function} Unsubscribe function\n */\n subscribe(callback) {\n if (typeof callback !== 'function') {\n throw new Error('subscribe() requires a function');\n }\n\n subscribers.push(callback);\n\n // Call immediately with current value\n if (isInitialized) {\n callback(cachedValue);\n }\n\n // Return unsubscribe function\n return () => {\n const index = subscribers.indexOf(callback);\n if (index > -1) {\n subscribers.splice(index, 1);\n }\n };\n },\n\n /**\n * Clean up computed value and stop tracking\n */\n dispose() {\n disposed = true;\n cleanupEffect();\n subscribers.length = 0;\n isInitialized = false;\n isInComputation = false;\n }\n };\n}","/**\n * Creates a cleanup group that can collect and dispose multiple\n * cleanup/unsubscribe functions at once.\n *\n * @returns {CleanupGroup}\n *\n * @example\n * ```js\n * import { createCleanupGroup } from 'lume-js/addons';\n *\n * const group = createCleanupGroup();\n * group.add(bindDom(root, store));\n * group.add(effect(() => { ... }));\n * group.add(store.$subscribe('key', fn));\n *\n * // Dispose everything at once\n * group.dispose();\n * ```\n */\nexport function createCleanupGroup() {\n const cleanups = [];\n\n return {\n /**\n * Add a cleanup function to the group.\n * @param {Function} fn - Cleanup/unsubscribe function\n */\n add(fn) {\n if (typeof fn === 'function') {\n cleanups.push(fn);\n }\n },\n\n /**\n * Run all collected cleanup functions and clear the group.\n */\n dispose() {\n while (cleanups.length) {\n const fn = cleanups.pop();\n try { fn(); } catch (e) { /* ignore cleanup errors */ }\n }\n },\n };\n}\n","/**\n * Reads initial state from a `<script type=\"application/json\">` element\n * embedded in the server-rendered HTML. Useful for SSR / hydration patterns.\n *\n * @param {string} [selector='#__LUME_DATA__'] - CSS selector for the script element\n * @returns {object} Parsed JSON object, or empty object if not found / invalid\n *\n * @example\n * ```html\n * <script id=\"__LUME_DATA__\" type=\"application/json\">\n * {\"title\": \"Welcome\", \"count\": 42}\n * </script>\n * ```\n *\n * ```js\n * import { state } from 'lume-js';\n * import { hydrateState } from 'lume-js/addons';\n *\n * const store = state(hydrateState());\n * ```\n */\nexport function hydrateState(selector = '#__LUME_DATA__') {\n const el = typeof document !== 'undefined' ? document.querySelector(selector) : null;\n if (!el) return {};\n try {\n return JSON.parse(el.textContent);\n } catch {\n return {};\n }\n}\n","export { computed } from \"./computed.js\";\nexport { watch } from \"./watch.js\";\nexport { repeat, defaultFocusPreservation, defaultScrollPreservation } from \"./repeat.js\";\nexport { createDebugPlugin, debug } from \"./debug.js\";\nexport { withPlugins } from \"./withPlugins.js\";\nexport { createCleanupGroup } from \"./cleanupGroup.js\";\nexport { hydrateState } from \"./hydrateState.js\";\n\n/**\n * Returns true if the value is a Lume reactive proxy created by state().\n * Uses duck-typing: checks for the presence of $subscribe.\n * @param {any} obj\n * @returns {boolean}\n */\nexport function isReactive(obj) {\n return !!(obj && typeof obj === 'object' && typeof obj.$subscribe === 'function');\n}\n","/**\n * watch - observes changes to a state key and triggers callback\n * @param {Object} store - reactive store created with state()\n * @param {string} key - key in store to watch\n * @param {Function} callback - called with new value\n * @param {Object} [options]\n * @param {boolean} [options.immediate=true] - call callback immediately with current value\n * @returns {Function} unsubscribe function\n */\nexport function watch(store, key, callback, { immediate = true } = {}) {\n if (!store.$subscribe) {\n throw new Error(\"store must be created with state()\");\n }\n if (!immediate) {\n let skipped = false;\n return store.$subscribe(key, (val) => {\n if (!skipped) { skipped = true; return; }\n callback(val);\n });\n }\n return store.$subscribe(key, callback);\n}","/**\n * Lume-JS withPlugins Addon\n *\n * Wraps a reactive state proxy with a plugin layer that intercepts\n * get/set/notify/subscribe operations via plugin hooks.\n *\n * Only stores that opt into debugging or custom behaviors need this.\n * Core state() is not aware of plugins.\n *\n * Usage:\n * import { state } from \"lume-js\";\n * import { withPlugins, createDebugPlugin } from \"lume-js/addons\";\n *\n * const store = withPlugins(state({ count: 0 }), [createDebugPlugin({ label: 'counter' })]);\n */\n\n/**\n * Wrap a reactive state proxy with plugin hooks.\n *\n * Plugin hooks (all optional):\n * onInit() — called once at wrap time\n * onGet(key, value) → value|void — intercept/transform reads\n * onSet(key, newVal, oldVal) → val|void — intercept/transform writes\n * onNotify(key, value) — called before subscribers are notified\n * onSubscribe(key) — called when $subscribe is invoked\n *\n * @param {object} store - A reactive proxy from state()\n * @param {Array<object>} plugins - Array of plugin objects\n * @returns {Proxy} A new proxy wrapping the store with plugin behavior\n */\nimport { logError } from '../utils/log.js';\n\nexport function withPlugins(store, plugins = []) {\n if (!plugins.length) return store;\n\n // Call onInit hooks once at wrap time\n for (const p of plugins) {\n try {\n p.onInit?.();\n } catch (e) {\n logError(`[Lume.js] Plugin \"${p.name}\" error in onInit:`, e);\n }\n }\n\n // Track pending notifications for onNotify hooks.\n // Instead of a separate microtask, we hook into the underlying state's\n // flush via $beforeFlush so onNotify and subscribers share one microtask.\n const pendingNotifications = new Map();\n\n function runNotifyHooks() {\n for (const [key, value] of pendingNotifications) {\n for (const p of plugins) {\n try {\n p.onNotify?.(key, value);\n } catch (e) {\n logError(`[Lume.js] Plugin \"${p.name}\" error in onNotify:`, e);\n }\n }\n }\n pendingNotifications.clear();\n }\n\n // Register once on the underlying state; capture unsubscribe for cleanup.\n let flushUnsub;\n if (typeof store.$beforeFlush === 'function') {\n flushUnsub = store.$beforeFlush(runNotifyHooks);\n }\n\n return new Proxy(store, {\n get(target, key) {\n // $dispose — remove the beforeFlush hook and clear pending state\n if (key === '$dispose') {\n return () => {\n if (flushUnsub) flushUnsub();\n pendingNotifications.clear();\n };\n }\n\n // Pass $-prefixed meta methods through without interception\n if (typeof key === 'string' && key.startsWith('$')) {\n const method = target[key];\n if (key === '$subscribe' && typeof method === 'function') {\n // Wrap $subscribe to call onSubscribe hooks\n return (subKey, fn) => {\n for (const p of plugins) {\n try {\n p.onSubscribe?.(subKey);\n } catch (e) {\n logError(`[Lume.js] Plugin \"${p.name}\" error in onSubscribe:`, e);\n }\n }\n return method(subKey, fn);\n };\n }\n return method;\n }\n\n let value = target[key];\n\n // onGet chain\n for (const p of plugins) {\n try {\n const r = p.onGet?.(key, value);\n if (r !== undefined) value = r;\n } catch (e) {\n logError(`[Lume.js] Plugin \"${p.name}\" error in onGet:`, e);\n }\n }\n\n return value;\n },\n\n set(target, key, value) {\n const oldValue = target[key];\n let newValue = value;\n\n // onSet chain\n for (const p of plugins) {\n try {\n const r = p.onSet?.(key, newValue, oldValue);\n if (r !== undefined) newValue = r;\n } catch (e) {\n logError(`[Lume.js] Plugin \"${p.name}\" error in onSet:`, e);\n }\n }\n\n // Only queue onNotify if the value actually changed after plugin chain\n if (!Object.is(newValue, oldValue)) {\n pendingNotifications.set(key, newValue);\n }\n\n target[key] = newValue;\n return true;\n }\n });\n}\n"],"names":["logWarn","msg","rest","console","warn","logError","error","readers","Set","withReadObserver","onRead","fn","add","delete","boolHandler","name","attr","apply","el","val","ariaHandler","setAttribute","DEFAULT_HANDLERS","applyHandler","store","path","handler","result","resolveProp","target","key","$subscribe","handleDataBind","bindingMap","unsub","tagName","type","checked","value","String","textContent","updateElement","isFormInput","set","pathArr","split","pop","obj","length","current","i","resolvePath","currentEffect","effect","deps","Error","cleanups","isRunning","execute","Array","isArray","dep","keys","isFirst","push","executeWithTracking","oldCleanups","splice","myContext","tracking","previousEffect","proxy","registerEffect","cleanup","defaultFocusPreservation","container","activeEl","document","activeElement","contains","selectionStart","selectionEnd","body","focus","setSelectionRange","defaultScrollPreservation","context","isReorder","scrollTop","anchorElement","anchorOffset","containerRect","getBoundingClientRect","child","firstElementChild","nextElementSibling","rect","bottom","top","newRect","scrollAdjustment","globalEnabled","globalFilter","stats","Map","matchesFilter","includes","RegExp","test","incrementStat","label","s","has","gets","sets","notifies","get","getStats","map","formatValue","json","JSON","stringify","slice","MAX_LOG_LEN","debug","enable","log","disable","isEnabled","filter","pattern","getFilter","data","Object","fromEntries","logStats","this","group","entries","tableData","allKeys","table","groupEnd","resetStats","clear","show","hidden","className","boolAttr","toggleAttribute","ariaAttr","fullName","startsWith","stringAttr","removeAttribute","BOOL_ATTRS","STRING_ATTRS","ARIA_BOOL_ATTRS","ARIA_STRING_ATTRS","formHandlers","a11yHandlers","root","options","HTMLElement","immediate","handlers","userHandlers","defaults","merged","h","flat","values","mergeHandlers","performBinding","WeakMap","selector","join","elements","querySelectorAll","hasAttribute","c","getAttribute","inputHandler","e","binding","valueAsNumber","addEventListener","removeEventListener","forEach","readyState","onReady","once","names","classList","toggle","cachedValue","isInitialized","isInComputation","disposed","subscribers","cleanupEffect","newValue","is","callback","queueMicrotask","subscribe","index","indexOf","dispose","getOpt","defaultVal","onInit","onGet","onSet","oldValue","trace","onSubscribe","onNotify","querySelector","parse","arrayKey","render","create","update","remove","element","preserveFocus","preserveScroll","containerEl","elementsByKey","prevItemsByKey","prevIndexByKey","cleanupByKey","seenKeys","createElement","updateList","items","size","nextEls","item","k","isFirstRender","prevItem","prevIndex","err","shouldPreserve","restoreFocus","restoreScroll","ptr","firstChild","desired","insertBefore","nextSibling","next","removeChild","reconcileDOM","applyPreservation","unsubscribe","replaceChildren","subResult","isFrozen","isSealed","listeners","pendingNotifications","pendingEffects","beforeFlushHooks","flushScheduled","Symbol","executeFn","idx","Proxy","reader","iterations","subs","effects","$beforeFlush","skipped","plugins","p","flushUnsub","method","subKey","r"],"mappings":"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"}
|
|
@@ -1 +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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"}
|
|
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 // 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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"}
|