Version 0.16.3

What's Changed

Added

• New re-exports from @zeix/cause-effect: createSignal, unown, untrack, isObjectOfType, SKIP_EQUALITY, and error classes ReadonlySignalError, RequiredOwnerError, UnsetSignalValueError — previously omitted from Le Truc's public API surface.

Changed

• @zeix/cause-effect upgraded to 0.18.5: Adds unown() and fixes a scope disposal bug in components connected inside re-runnable effects (see Fixed below).
• form-checkbox, form-radiogroup, and form-spinbutton examples updated: All three examples now support controlled component usage, accepting externally managed state in addition to their built-in uncontrolled behaviour.

Fixed

• Scope disposal bug when connectedCallback fires inside a re-runnable effect: createScope inside a reactive effect (e.g. a list-sync effect) registered its dispose on that effect's cleanup list. When the effect re-ran — for example because a MutationObserver fired — it disposed all child scopes including those of already-connected components, silently removing their live event listeners and reactive subscriptions. Fixed by wrapping the connectedCallback body in unown(), detaching each component's scope from the surrounding effect's ownership tree so effect re-runs no longer dispose it.

---

Full Changelog: v0.16.2...v0.16.3

Version 0.16.2

What's Changed

Added

• asParser(fn): Brands a custom parser with PARSER_BRAND so isParser() can identify it reliably regardless of function.length. Use this for any custom two-argument parser (especially those using default parameters or destructuring).
• asMethod(fn): Brands a side-effect initializer with METHOD_BRAND, producing a MethodProducer that defineComponent dispatches explicitly rather than treating as a Reader.
• isMethodProducer(value): Type guard that checks for METHOD_BRAND. Replaces the old implicit isFunction fallback for method producers.

Changed

• isParser() checks PARSER_BRAND first: Falls back to fn.length >= 2 for backward compatibility, but emits a console.warn in DEV_MODE when the fallback path is taken. Migrate custom parsers to asParser() to silence the warning.
• defineComponent signal dispatch is explicit: Initialization order is now Parser → MethodProducer → Reader → static/Signal. Previously, method producers and readers were both handled by an isFunction branch with no distinction.
• on() and pass() wrap their body in createScope(): Both effects now own a reactive scope internally. This ensures proper child-effect disposal and signal restoration when the component disconnects, without requiring callers to manage scopes.
• pass() captures and restores the original Slot signal on cleanup: When the parent disconnects, the child's Slot is restored to the signal it held before pass() ran, so the child regains its own independent state after detachment.
• pass() is scoped to Le Truc components only: The [Reactive, callback] two-way binding form has been removed from PassedProp. For non-Le Truc custom elements, use setProperty() instead.
• RESET sentinel replaced by undefined: resolveReactive() now returns undefined on error. updateElement treats undefined the same way it treated RESET — restoring the original DOM fallback value.
• resolveReactive() warns on missing property names in DEV_MODE: When a string reactive refers to a property that does not exist on the host, a console.warn is emitted. This catches typos for JavaScript consumers not covered by TypeScript's keyof P guard.
• EventHandler type is now documented: JSDoc on EventHandler explains both the side-effect-only (void) and property-update-shortcut ({ prop: value }) return modes. on() JSDoc includes @example blocks for both forms.

Fixed

• pass() no longer silently drops bindings on child detach: The original Slot signal is captured before replacement and restored on cleanup, preventing stale parent signals from persisting in detached children.
• pass() warns in DEV_MODE when target property is not Slot-backed: Emits console.warn and skips the binding (instead of silently doing nothing) when pass() is used on a non-Le Truc element.
• MethodProducer cleanup correctly composed with effect cleanup: Cleanup functions returned by method producers are now composed with the surrounding effect cleanup in defineComponent, preventing disposal leaks.

---

Full Changelog: v0.16.1...v0.16.2

Version 0.16.1

What's Changed

Changed

• createElementsMemo mutation filtering: The MutationObserver callback now uses a couldMatch helper to filter mutations, only invalidating when added/removed nodes match or contain matches for the selector. This prevents spurious effect re-runs caused by mutations inside matched elements (e.g., innerHTML changes on option buttons).
• createElementsMemo custom equals: The memo now compares arrays by element identity (length + every).
• Effect system simplified: runEffects now uses createScope() to own all child effects. Dynamic collections are handled by a single createEffect() whose ownership graph automatically disposes per-element effects on re-run. The former runElementsEffects and runElementEffects helpers have been inlined.

Removed

• runEffects and runElementEffects removed from public API: These were never intended for userland use and calling them directly could corrupt disposal. runEffects remains as internal helper.

Fixed

• innerHTML on matched elements no longer destroys reactivity: Setting innerHTML on elements matched by createElementsMemo (e.g., button[role="option"]) previously caused the MutationObserver to fire spuriously, re-running and disposing effects without properly re-attaching them. Fixed by combining mutation filtering with ownership-based cleanup.

Full Changelog: v0.16.0...v0.16.1

Version 0.16.0

What's Changed

Added

• createElementsMemo(parent, selector): New function returning a Memo<E[]> of elements matching a CSS selector, backed by a lazy MutationObserver that activates only when read from within a reactive effect.
• createEventsSensor(init, key, events): New function producing an event-driven Sensor from transformed event data, replacing the old Le Truc-specific createSensor.
• New re-exports from @zeix/cause-effect v0.18: createCollection, createList, createMemo, createMutableSignal, createScope, createSensor, createTask, createStore, match, and their associated types and type guards.
• New type exports: MethodProducer, ContextCallback, UpdateOperation, SensorEventHandler, AllElements, FirstElement, ElementFromSelector, and CSS selector type utilities (ElementFromSingleSelector, ElementsFromSelectorArray, ExtractRightmostSelector, ExtractTag, KnownTag, SplitByComma, TrimWhitespace).
• MaybeSignal<T> now accepts TaskCallback<T>, enabling async task-based property initializers.

Changed

• @zeix/cause-effect upgraded from ^0.16.1 to ^0.18.3. This drives most API changes below.
• Element queries use Memo<E[]> instead of Collection<E>: The all() query helper returns Memo<ElementFromSelector<S>[]>. The UI type is now Record<string, Element | Memo<Element[]>>.
• pass() effect rewritten to use Slot signals: Uses getSignals() and slot.replace() instead of overwriting property descriptors. Works regardless of descriptor configurability and avoids state leaks on cleanup.
• requestContext returns Memo<T> instead of Computed<T>.
• Component property accessors use Slot signals: #setAccessor in defineComponent now uses createSlot for mutable signals, with slot.replace() for signal swapping.
• Computed renamed to Memo and ComputedCallback renamed to MemoCallback in type signatures (from upstream cause-effect v0.18).
• updateElement: The unset sentinel changed from UNSET to null.
• Eliminated index.dev.ts: Both index.js (minified) and index.dev.js (unminified) are now built from the single index.ts entry point.

Removed

• src/signals/collection.ts: The Le Truc-specific Collection signal type with MutationObserver, Proxy, and add/remove listeners has been removed. Element collection functionality is replaced by createElementsMemo. Collection is now re-exported from cause-effect (a different, upstream type).
• src/signals/sensor.ts: The Le Truc-specific createSensor and SensorEvents type have been removed, replaced by createEventsSensor and the upstream createSensor from cause-effect.
• Removed re-exports: diff, resolve, toError, toSignal, UNSET, isAbortError, isNumber, isRecordOrArray, isString, isSymbol, Computed, ComputedCallback, DiffResult, ResolveResult, StoreKeyExistsError, StoreKeyRangeError, StoreKeyReadonlyError.

Fixed

• pass() no longer requires configurable property descriptors on the target element and no longer leaks state on cleanup.
• pass() now warns in dev mode when a property doesn't exist on the target (likely a typo) or has no Slot (non-Le Truc element), instead of silently doing nothing.
• dangerouslySetInnerHTML script cloning now copies all functional and security-hardening attributes (src, async, defer, nomodule, crossorigin, integrity, referrerpolicy, fetchpriority) instead of only type. External scripts with src no longer become empty inline scripts.
• createEventsSensor now reacts to collection changes: For Memo-backed element collections, getTarget() reads the current elements on each event instead of a stale snapshot captured at sensor creation time. Static single-element targets use a fast path with no array overhead.
• Dependency resolution no longer swallows errors silently: DependencyTimeoutError is now logged via console.warn in dev mode. Previously, the .catch handler discarded all errors without any output.
• Dependency resolution filters out already-defined components: A microtask defer before Promise.race filters out components that were defined synchronously after queries ran (e.g. co-bundled components), avoiding unnecessary waits.
• Dependency timeout increased from 50ms to 200ms: Now that structural (CSS-only) custom elements and co-bundled components are filtered out, the timeout only applies to genuinely pending async dependencies and gives them a more realistic window.
• module-dialog effect cleanup no longer resets host.open to false, which was causing all dialog tests to fail.
• form-listbox keyboard navigation now uses direct querySelectorAll instead of a watched Memo that never activated its MutationObserver outside reactive contexts.

---

Full Changelog: v0.15.0...v0.16.0

Version 0.15.0

What's Changed

• First release under the new name "Le Truc" (was UIElement in v0.14.2: https://github.com/zeixcom/ui-element)
• Release Candidate for Version 1.0