@signality/core 0.0.1-alpha.2

package/fesm2022/signality-core-forms-cva.mjs

@@ -0,0 +1,140 @@
+import { inject, signal, afterNextRender } from '@angular/core';
+import { NgControl, RequiredValidator, Validators, NgModel } from '@angular/forms';
+import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
+import { timer, switchMap, EMPTY, startWith, map } from 'rxjs';
+import { setupContext, ALWAYS_FALSE_FN } from '@signality/core/internal';
+import { watcher } from '@signality/core/reactivity/watcher';
+
+/**
+ * Reactive wrapper around the [Angular Forms](https://angular.dev/guide/forms) Control Value Accessor (CVA) pattern.
+ * Integrates seamlessly with both template-driven and reactive forms.
+ *
+ * @param options - Configuration options including the value signal
+ * @returns A CvaRef with reactive form control state signals
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   selector: 'app-currency-input',
+ *   template: `
+ *     <input
+ *       type="text"
+ *       [value]="displayValue()"
+ *       [required]="cva.required()"
+ *       (input)="handleInput($any($event.target).value)"
+ *       (blur)="cva.touched.set(true)"
+ *     />
+ *   `,
+ * })
+ * export class CurrencyInput {
+ *   readonly value = model(0);
+ *   readonly cva = cva({ value: this.value });
+ *
+ *   readonly displayValue = computed(() => {
+ *     return this.value()
+ *       .toFixed(2)
+ *       .replace(/\B(?=(\d{3})+(?!\d))/g, ','); // Shows "1,234.56"
+ *   });
+ *
+ *   handleInput(input: string) {
+ *     const num = parseFloat(input.replace(/[^0-9.]/g, ''));
+ *     if (!isNaN(num)) {
+ *       this.value.set(num);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+function cva(options) {
+    const { runInContext } = setupContext(options?.injector, cva);
+    return runInContext(({ injector }) => {
+        const ngControl = inject(NgControl, { self: true, optional: true });
+        const ngModelRequired = inject(RequiredValidator, { self: true, optional: true });
+        const initialValue = options.value();
+        const { value, 
+        // Use ALWAYS_FALSE_FN to ensure touched signal always triggers watcher updates.
+        // This is critical for controls with `updateOn: 'blur'` - when blur occurs, the control
+        // may update its value, but control.touched remains true. Without forcing signal updates,
+        // the watcher won't fire and the control won't properly synchronize its value after blur.
+        touched = signal(false, { equal: ALWAYS_FALSE_FN }), disabled = signal(false), required = signal(false), invalid = signal(false), pending = signal(false), dirty = signal(false), errors = signal(null), } = options;
+        const cvaRef = {
+            value,
+            touched,
+            disabled: disabled.asReadonly(),
+            required: required.asReadonly(),
+            invalid: invalid.asReadonly(),
+            pending: pending.asReadonly(),
+            dirty: dirty.asReadonly(),
+            errors: errors.asReadonly(),
+            reset: () => value.set(initialValue),
+        };
+        if (!ngControl) {
+            return cvaRef;
+        }
+        let touchedFn;
+        let updateFn;
+        let scheduledModelUpdate;
+        const runModelUpdate = (fn) => {
+            scheduledModelUpdate?.destroy();
+            fn();
+            scheduledModelUpdate = afterNextRender(() => {
+                scheduledModelUpdate = null;
+            }, { injector });
+        };
+        watcher(touched, isTouched => {
+            if (isTouched) {
+                touchedFn?.();
+            }
+        });
+        watcher(value, v => {
+            if (scheduledModelUpdate) {
+                scheduledModelUpdate.destroy();
+                scheduledModelUpdate = null;
+            }
+            else {
+                updateFn?.(v);
+            }
+        });
+        // the control instance isn't available immediately inside FormControl or FormControlName,
+        // because they depend on [inputs]. That's why we schedule the subscription asynchronously.
+        timer(0)
+            .pipe(switchMap(() => {
+            const { control } = ngControl;
+            if (!control) {
+                return EMPTY;
+            }
+            return control.events.pipe(startWith(null), map(() => control));
+        }), takeUntilDestroyed())
+            .subscribe(control => {
+            required.set(control.hasValidator(Validators.required) ||
+                // cannot compare references because `RequiredValidator` wraps `requiredValidator` fn
+                // (https://github.com/angular/angular/blob/19.1.0/packages/forms/src/directives/validators.ts#L398)
+                !!ngModelRequired?.required);
+            touched.set(control.touched);
+            invalid.set(control.invalid);
+            pending.set(control.pending);
+            errors.set(control.errors);
+            dirty.set(control.dirty);
+        });
+        ngControl.valueAccessor = {
+            writeValue: (rawValue) => {
+                runModelUpdate(() => {
+                    // fix (https://github.com/angular/angular/issues/14988)
+                    const modelValue = ngControl instanceof NgModel ? ngControl.model : rawValue;
+                    value.set(modelValue);
+                });
+            },
+            registerOnChange: fn => (updateFn = fn),
+            registerOnTouched: fn => (touchedFn = fn),
+            setDisabledState: isDisabled => disabled?.set(isDisabled),
+        };
+        return cvaRef;
+    });
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { cva };
+//# sourceMappingURL=signality-core-forms-cva.mjs.map

package/fesm2022/signality-core-forms-cva.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-forms-cva.mjs","sources":["../../../projects/core/forms/cva/index.ts","../../../projects/core/forms/cva/signality-core-forms-cva.ts"],"sourcesContent":["import {\n  afterNextRender,\n  type AfterRenderRef,\n  inject,\n  type Signal,\n  signal,\n  type WritableSignal,\n} from '@angular/core';\nimport {\n  NgControl,\n  NgModel,\n  RequiredValidator,\n  type ValidationErrors,\n  Validators,\n} from '@angular/forms';\nimport { takeUntilDestroyed } from '@angular/core/rxjs-interop';\nimport { EMPTY, map, startWith, switchMap, timer } from 'rxjs';\nimport { ALWAYS_FALSE_FN, setupContext } from '@signality/core/internal';\nimport type { WithInjector } from '@signality/core/types';\nimport { watcher } from '@signality/core/reactivity/watcher';\n\nexport type CvaOptions<T> = Omit<Partial<MakeWritable<CvaRef<T>>>, 'value'> &\n  Pick<CvaRef<T>, 'value'> &\n  WithInjector;\n\nexport interface CvaRef<T> {\n  readonly value: WritableSignal<T>;\n  readonly touched: WritableSignal<boolean>;\n  readonly disabled: Signal<boolean>;\n  readonly required: Signal<boolean>;\n  readonly invalid: Signal<boolean>;\n  readonly pending: Signal<boolean>;\n  readonly dirty: Signal<boolean>;\n  readonly errors: Signal<ValidationErrors | null>;\n  readonly reset: () => void;\n}\n\n/**\n * Reactive wrapper around the [Angular Forms](https://angular.dev/guide/forms) Control Value Accessor (CVA) pattern.\n * Integrates seamlessly with both template-driven and reactive forms.\n *\n * @param options - Configuration options including the value signal\n * @returns A CvaRef with reactive form control state signals\n *\n * @example\n * ```typescript\n * @Component({\n *   selector: 'app-currency-input',\n *   template: `\n *     <input\n *       type=\"text\"\n *       [value]=\"displayValue()\"\n *       [required]=\"cva.required()\"\n *       (input)=\"handleInput($any($event.target).value)\"\n *       (blur)=\"cva.touched.set(true)\"\n *     />\n *   `,\n * })\n * export class CurrencyInput {\n *   readonly value = model(0);\n *   readonly cva = cva({ value: this.value });\n *\n *   readonly displayValue = computed(() => {\n *     return this.value()\n *       .toFixed(2)\n *       .replace(/\\B(?=(\\d{3})+(?!\\d))/g, ','); // Shows \"1,234.56\"\n *   });\n *\n *   handleInput(input: string) {\n *     const num = parseFloat(input.replace(/[^0-9.]/g, ''));\n *     if (!isNaN(num)) {\n *       this.value.set(num);\n *     }\n *   }\n * }\n * ```\n */\nexport function cva<T>(options: CvaOptions<T>): CvaRef<T> {\n  const { runInContext } = setupContext(options?.injector, cva);\n\n  return runInContext(({ injector }) => {\n    const ngControl = inject(NgControl, { self: true, optional: true });\n    const ngModelRequired = inject(RequiredValidator, { self: true, optional: true });\n\n    const initialValue = options.value();\n\n    const {\n      value,\n      // Use ALWAYS_FALSE_FN to ensure touched signal always triggers watcher updates.\n      // This is critical for controls with `updateOn: 'blur'` - when blur occurs, the control\n      // may update its value, but control.touched remains true. Without forcing signal updates,\n      // the watcher won't fire and the control won't properly synchronize its value after blur.\n      touched = signal(false, { equal: ALWAYS_FALSE_FN }),\n      disabled = signal(false),\n      required = signal(false),\n      invalid = signal(false),\n      pending = signal(false),\n      dirty = signal(false),\n      errors = signal(null),\n    } = options;\n\n    const cvaRef: CvaRef<T> = {\n      value,\n      touched,\n      disabled: disabled.asReadonly(),\n      required: required.asReadonly(),\n      invalid: invalid.asReadonly(),\n      pending: pending.asReadonly(),\n      dirty: dirty.asReadonly(),\n      errors: errors.asReadonly(),\n      reset: () => value.set(initialValue),\n    };\n\n    if (!ngControl) {\n      return cvaRef;\n    }\n\n    let touchedFn: () => void;\n    let updateFn: (v: T) => void;\n    let scheduledModelUpdate: AfterRenderRef | null;\n\n    const runModelUpdate = (fn: () => void) => {\n      scheduledModelUpdate?.destroy();\n\n      fn();\n\n      scheduledModelUpdate = afterNextRender(\n        () => {\n          scheduledModelUpdate = null;\n        },\n        { injector }\n      );\n    };\n\n    watcher(touched, isTouched => {\n      if (isTouched) {\n        touchedFn?.();\n      }\n    });\n\n    watcher(value, v => {\n      if (scheduledModelUpdate) {\n        scheduledModelUpdate.destroy();\n        scheduledModelUpdate = null;\n      } else {\n        updateFn?.(v);\n      }\n    });\n\n    // the control instance isn't available immediately inside FormControl or FormControlName,\n    // because they depend on [inputs]. That's why we schedule the subscription asynchronously.\n    timer(0)\n      .pipe(\n        switchMap(() => {\n          const { control } = ngControl;\n\n          if (!control) {\n            return EMPTY;\n          }\n\n          return control.events.pipe(\n            startWith(null),\n            map(() => control)\n          );\n        }),\n        takeUntilDestroyed()\n      )\n      .subscribe(control => {\n        required.set(\n          control.hasValidator(Validators.required) ||\n            // cannot compare references because `RequiredValidator` wraps `requiredValidator` fn\n            // (https://github.com/angular/angular/blob/19.1.0/packages/forms/src/directives/validators.ts#L398)\n            !!ngModelRequired?.required\n        );\n        touched.set(control.touched);\n        invalid.set(control.invalid);\n        pending.set(control.pending);\n        errors.set(control.errors);\n        dirty.set(control.dirty);\n      });\n\n    ngControl.valueAccessor = {\n      writeValue: (rawValue: T | null) => {\n        runModelUpdate(() => {\n          // fix (https://github.com/angular/angular/issues/14988)\n          const modelValue = ngControl instanceof NgModel ? ngControl.model : rawValue;\n          value.set(modelValue);\n        });\n      },\n      registerOnChange: fn => (updateFn = fn),\n      registerOnTouched: fn => (touchedFn = fn),\n      setDisabledState: isDisabled => disabled?.set(isDisabled),\n    };\n\n    return cvaRef;\n  });\n}\n\ntype MakeWritable<T extends object> = {\n  [K in keyof T]: T[K] extends Signal<infer U> ? WritableSignal<U> : never;\n};\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/fesm2022/signality-core-forms.mjs

@@ -0,0 +1,6 @@
+export * from '@signality/core/forms/cva';
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+//# sourceMappingURL=signality-core-forms.mjs.map

package/fesm2022/signality-core-forms.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-forms.mjs","sources":["../../../projects/core/forms/signality-core-forms.ts"],"sourcesContent":["/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;AAAA;;AAEG"}

package/fesm2022/signality-core-internal.mjs

@@ -0,0 +1,268 @@
+import { InjectionToken, inject, PLATFORM_ID, assertInInjectionContext, INJECTOR, runInInjectionContext, DestroyRef, untracked, isSignal, ElementRef } from '@angular/core';
+import { isPlatformBrowser, isPlatformServer } from '@angular/common';
+import { SIGNAL, SIGNAL_NODE } from '@angular/core/primitives/signals';
+
+const MOBILE_REGEX = /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i;
+
+/**
+ * Empty synchronous function stub.
+ * Used for SSR compatibility when returning method functions in Ref objects that should do nothing on the server.
+ *
+ * Example: `close: NOOP_FN` in {@link WebNotificationRef}
+ */
+const NOOP_FN = () => {
+    /* empty */
+};
+/**
+ * Empty asynchronous function stub that returns a resolved Promise.
+ * Used for SSR compatibility when returning async method functions in Ref objects that should do nothing on the server.
+ *
+ * Example: `share: NOOP_ASYNC_FN` in {@link WebShareRef}
+ */
+const NOOP_ASYNC_FN = () => Promise.resolve();
+/**
+ * Frozen EffectRef stub with a no-op destroy method.
+ * Used for SSR compatibility when returning EffectRef from observer utilities (ResizeObserver, MutationObserver, etc.)
+ * that cannot run on the server. Prevents errors when calling destroy() on server-rendered refs.
+ *
+ * Example: `return NOOP_EFFECT_REF` in {@link resizeObserver}
+ */
+const NOOP_EFFECT_REF = { destroy: NOOP_FN };
+/**
+ * Equality function that always returns false, forcing signal updates on every change.
+ * Used for signals that hold mutable objects (like Selection, Range) where reference equality is not sufficient
+ * and we need to detect changes even when the object structure appears the same.
+ *
+ * Example: `signal<Selection | null>(null, { equal: ALWAYS_FALSE_FN })` in {@link textSelection}
+ */
+const ALWAYS_FALSE_FN = () => false;
+
+const IS_BROWSER = new InjectionToken(ngDevMode ? 'IS_BROWSER' : '', {
+    providedIn: 'platform',
+    factory: () => isPlatformBrowser(inject(PLATFORM_ID)),
+});
+
+const IS_MOBILE = new InjectionToken(ngDevMode ? 'IS_MOBILE' : '', {
+    providedIn: 'platform',
+    factory: () => {
+        return inject(IS_BROWSER) ? MOBILE_REGEX.test(navigator.userAgent) : false;
+    },
+});
+
+const IS_SERVER = new InjectionToken(ngDevMode ? 'IS_SERVER' : '', {
+    providedIn: 'platform',
+    factory: () => isPlatformServer(inject(PLATFORM_ID)),
+});
+
+function isWindow(obj) {
+    return !!obj && obj.window === obj;
+}
+
+function getActiveElement(document) {
+    let activeElement = document.activeElement;
+    while (activeElement && activeElement.shadowRoot) {
+        const newActiveElement = activeElement.shadowRoot.activeElement;
+        if (newActiveElement === activeElement) {
+            break;
+        }
+        else {
+            activeElement = newActiveElement;
+        }
+    }
+    return activeElement;
+}
+
+function getEventTarget(event) {
+    return (event.composedPath ? event.composedPath()[0] : event.target);
+}
+
+function getPipElement(document) {
+    let pipElement = document.pictureInPictureElement;
+    while (pipElement && pipElement.shadowRoot) {
+        const newPipElement = pipElement.shadowRoot.pictureInPictureElement;
+        if (newPipElement === pipElement) {
+            break;
+        }
+        else {
+            pipElement = newPipElement;
+        }
+    }
+    return pipElement;
+}
+
+function getShadowRoot(element) {
+    const rootNode = element?.getRootNode ? element.getRootNode() : null;
+    if (rootNode instanceof ShadowRoot) {
+        return rootNode;
+    }
+    return null;
+}
+
+function isElement(obj) {
+    return !!obj && obj.nodeType === Node.ELEMENT_NODE;
+}
+
+function isNodeWithin(node, root) {
+    return root === node || root.contains(node) || (root.shadowRoot?.contains(node) ?? false);
+}
+
+/**
+ * @internal
+ *
+ * @param injector - injector to use for context
+ * @param debugFn - context owner function
+ */
+function setupContext(injector, debugFn) {
+    if (typeof ngDevMode !== 'undefined' && ngDevMode && !injector) {
+        assertInInjectionContext(debugFn || setupContext);
+    }
+    const ctxInjector = injector || inject(INJECTOR);
+    return {
+        runInContext(fn) {
+            return runInContextImpl(fn, ctxInjector, debugFn || setupContext);
+        },
+    };
+}
+function runInContextImpl(fn, injector, debugFn) {
+    const result = runInInjectionContext(injector, () => {
+        const isBrowser = inject(IS_BROWSER);
+        const isServer = inject(IS_SERVER);
+        const isMobile = inject(IS_MOBILE);
+        const destroyRef = inject(DestroyRef);
+        const onCleanup = (cleanupFn) => {
+            destroyRef.onDestroy(cleanupFn);
+        };
+        return untracked(() => fn({ injector, isBrowser, isServer, isMobile, onCleanup }));
+    });
+    if (typeof ngDevMode !== 'undefined' && ngDevMode && result != null) {
+        setupDebugInfo(result, debugFn);
+    }
+    return result;
+}
+function setupDebugInfo(value, debugFn) {
+    if (isSignal(value)) {
+        setDebugName(value, debugFn);
+    }
+    else if (value && typeof value === 'object') {
+        for (const [postfix, maybeSignal] of Object.entries(value)) {
+            if (isSignal(maybeSignal)) {
+                setDebugName(maybeSignal, debugFn, postfix);
+            }
+        }
+    }
+    return value;
+}
+function setDebugName(signal, debugFn, postfix) {
+    const node = signal[SIGNAL];
+    if (node.debugName === undefined) {
+        node.debugName = debugFn.name + (postfix ? '.' + postfix : '');
+    }
+}
+
+/**
+ * Creates an Angular InjectionToken with a factory function.
+ * @internal
+ */
+function createToken(factory, providedIn = 'root') {
+    return new InjectionToken(ngDevMode ? factory.name : '', { factory, providedIn });
+}
+
+/**
+ * Determines if a signal is a query signal (viewChild, contentChild).
+ * Query signals have a special internal structure with a `_dirtyCounter` property that tracks
+ * when query results change.
+
+ * See: https://github.com/angular/angular/blob/main/packages/core/src/render3/queries/query_reactive.ts#L43
+ * @internal
+ */
+function isQuerySignal(val) {
+    if (!isSignal(val)) {
+        return false;
+    }
+    const node = val[SIGNAL];
+    return '_dirtyCounter' in node;
+}
+
+function isPlainObject(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === null || prototype === Object.prototype;
+}
+
+/***
+ * Creates a lightweight, readonly signal.
+ * This is primarily used to provide fallback values for states that cannot be
+ * computed in the current environment. For example:
+ * - During SSR where browser-only APIs are unavailable
+ * - In environments that lack support for specific APIs
+ * @internal
+ */
+function constSignal(value) {
+    const node = Object.create(SIGNAL_NODE);
+    node.value = value;
+    const getter = (() => node.value);
+    getter[SIGNAL] = node;
+    if (typeof ngDevMode !== 'undefined' && ngDevMode) {
+        const debugName = node.debugName ? ' (' + node.debugName + ')' : '';
+        getter.toString = () => `[Signal${debugName}: ${String(node.value)}]`;
+    }
+    return getter;
+}
+
+function proxySignal(source, handler) {
+    const node = source[SIGNAL];
+    const isWritable = 'set' in source && typeof source.set === 'function';
+    const proxy = (handler.get ? () => handler.get(source) : () => source());
+    proxy[SIGNAL] = node;
+    // @TODO: consider (original toString internally reads from the original getter, bypassing the proxy)
+    proxy.toString = source.toString;
+    if (isWritable) {
+        const set = handler.set
+            ? (value) => untracked(() => handler.set(value, source))
+            : (value) => source.set(value);
+        const update = (updater) => set(updater(node.value));
+        proxy.set = set;
+        proxy.update = update;
+        proxy.asReadonly = () => {
+            const getter = source.asReadonly();
+            return proxySignal(getter, { get: handler.get?.bind(handler) });
+        };
+    }
+    return proxy;
+}
+
+// @TODO: Consider moving it out of internal
+const toValue = (() => {
+    const fn = toValueFn;
+    fn.untracked = v => toValueFn(v, true);
+    return fn;
+})();
+function toValueFn(maybeSignal, untracked$1 = false) {
+    if (isSignal(maybeSignal)) {
+        return untracked$1 ? untracked(maybeSignal) : maybeSignal();
+    }
+    return maybeSignal;
+}
+
+// @TODO: Consider moving it out of internal
+const toElement = (() => {
+    const fn = toElementFn;
+    fn.untracked = v => toElementFn(v, true);
+    return fn;
+})();
+function toElementFn(maybeSignal, untracked = false) {
+    const value = untracked ? toValue.untracked(maybeSignal) : toValue(maybeSignal);
+    if (value instanceof ElementRef) {
+        return value.nativeElement;
+    }
+    return value;
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { ALWAYS_FALSE_FN, IS_BROWSER, IS_MOBILE, IS_SERVER, MOBILE_REGEX, NOOP_ASYNC_FN, NOOP_EFFECT_REF, NOOP_FN, constSignal, createToken, getActiveElement, getEventTarget, getPipElement, getShadowRoot, isElement, isNodeWithin, isPlainObject, isQuerySignal, isWindow, proxySignal, setupContext, toElement, toValue };
+//# sourceMappingURL=signality-core-internal.mjs.map

package/fesm2022/signality-core-internal.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-internal.mjs","sources":["../../../projects/core/internal/constants/mobile-regex.ts","../../../projects/core/internal/constants/stubs.ts","../../../projects/core/internal/providers/is-browser.ts","../../../projects/core/internal/providers/is-mobile.ts","../../../projects/core/internal/providers/is-server.ts","../../../projects/core/internal/utils/bom/is-window.ts","../../../projects/core/internal/utils/dom/get-active-element.ts","../../../projects/core/internal/utils/dom/get-event-target.ts","../../../projects/core/internal/utils/dom/get-pip-element.ts","../../../projects/core/internal/utils/dom/get-shadow-root.ts","../../../projects/core/internal/utils/dom/is-element.ts","../../../projects/core/internal/utils/dom/is-node-within.ts","../../../projects/core/internal/utils/context.ts","../../../projects/core/internal/utils/create-token.ts","../../../projects/core/internal/utils/is-query-signal.ts","../../../projects/core/internal/utils/is-plain-object.ts","../../../projects/core/internal/utils/const-signal.ts","../../../projects/core/internal/utils/proxy-signal.ts","../../../projects/core/internal/utils/to-value.ts","../../../projects/core/internal/utils/to-element.ts","../../../projects/core/internal/signality-core-internal.ts"],"sourcesContent":["export const MOBILE_REGEX = /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i;\n","/**\n * Empty synchronous function stub.\n * Used for SSR compatibility when returning method functions in Ref objects that should do nothing on the server.\n *\n * Example: `close: NOOP_FN` in {@link WebNotificationRef}\n */\nexport const NOOP_FN: (...args: any[]) => void = () => {\n  /* empty */\n};\n\n/**\n * Empty asynchronous function stub that returns a resolved Promise.\n * Used for SSR compatibility when returning async method functions in Ref objects that should do nothing on the server.\n *\n * Example: `share: NOOP_ASYNC_FN` in {@link WebShareRef}\n */\nexport const NOOP_ASYNC_FN = () => Promise.resolve();\n\n/**\n * Frozen EffectRef stub with a no-op destroy method.\n * Used for SSR compatibility when returning EffectRef from observer utilities (ResizeObserver, MutationObserver, etc.)\n * that cannot run on the server. Prevents errors when calling destroy() on server-rendered refs.\n *\n * Example: `return NOOP_EFFECT_REF` in {@link resizeObserver}\n */\nexport const NOOP_EFFECT_REF = { destroy: NOOP_FN };\n\n/**\n * Equality function that always returns false, forcing signal updates on every change.\n * Used for signals that hold mutable objects (like Selection, Range) where reference equality is not sufficient\n * and we need to detect changes even when the object structure appears the same.\n *\n * Example: `signal<Selection | null>(null, { equal: ALWAYS_FALSE_FN })` in {@link textSelection}\n */\nexport const ALWAYS_FALSE_FN = () => false;\n","import { inject, InjectionToken, PLATFORM_ID } from '@angular/core';\nimport { isPlatformBrowser } from '@angular/common';\n\nexport const IS_BROWSER = new InjectionToken<boolean>(ngDevMode ? 'IS_BROWSER' : '', {\n  providedIn: 'platform',\n  factory: () => isPlatformBrowser(inject(PLATFORM_ID)),\n});\n","import { inject, InjectionToken } from '@angular/core';\nimport { MOBILE_REGEX } from '../constants';\nimport { IS_BROWSER } from './is-browser';\n\nexport const IS_MOBILE = new InjectionToken<boolean>(ngDevMode ? 'IS_MOBILE' : '', {\n  providedIn: 'platform',\n  factory: () => {\n    return inject(IS_BROWSER) ? MOBILE_REGEX.test(navigator.userAgent) : false;\n  },\n});\n","import { inject, InjectionToken, PLATFORM_ID } from '@angular/core';\nimport { isPlatformServer } from '@angular/common';\n\nexport const IS_SERVER = new InjectionToken<boolean>(ngDevMode ? 'IS_SERVER' : '', {\n  providedIn: 'platform',\n  factory: () => isPlatformServer(inject(PLATFORM_ID)),\n});\n","export function isWindow(obj: object | null): obj is Window {\n  return !!obj && (obj as Window).window === obj;\n}\n","export function getActiveElement(document: Document): Element | null {\n  let activeElement = document.activeElement;\n\n  while (activeElement && activeElement.shadowRoot) {\n    const newActiveElement = activeElement.shadowRoot.activeElement;\n    if (newActiveElement === activeElement) {\n      break;\n    } else {\n      activeElement = newActiveElement;\n    }\n  }\n\n  return activeElement;\n}\n","export function getEventTarget<T extends EventTarget>(event: Event): T | null {\n  return (event.composedPath ? event.composedPath()[0] : event.target) as T | null;\n}\n","export function getPipElement(document: Document): Element | null {\n  let pipElement = document.pictureInPictureElement;\n\n  while (pipElement && pipElement.shadowRoot) {\n    const newPipElement = pipElement.shadowRoot.pictureInPictureElement;\n    if (newPipElement === pipElement) {\n      break;\n    } else {\n      pipElement = newPipElement;\n    }\n  }\n\n  return pipElement;\n}\n","export function getShadowRoot(element: Element | null): ShadowRoot | null {\n  const rootNode = element?.getRootNode ? element.getRootNode() : null;\n\n  if (rootNode instanceof ShadowRoot) {\n    return rootNode;\n  }\n\n  return null;\n}\n","export function isElement(obj: Element | EventTarget | Node | object | null): obj is Element {\n  return !!obj && (obj as Element).nodeType === Node.ELEMENT_NODE;\n}\n","export function isNodeWithin(node: Node, root: Element): boolean {\n  return root === node || root.contains(node) || (root.shadowRoot?.contains(node) ?? false);\n}\n","import {\n  assertInInjectionContext,\n  DestroyRef,\n  inject,\n  type Injector,\n  INJECTOR,\n  isSignal,\n  runInInjectionContext,\n  type Signal,\n  untracked,\n} from '@angular/core';\nimport { SIGNAL, type SignalNode } from '@angular/core/primitives/signals';\nimport { IS_BROWSER, IS_MOBILE, IS_SERVER } from '../providers';\n\nexport interface ContextRef {\n  readonly injector: Injector;\n  readonly isServer: boolean;\n  readonly isBrowser: boolean;\n  readonly isMobile: boolean;\n  readonly onCleanup: (cleanupFn: () => void) => void;\n}\n\nexport interface SetupContextRef {\n  runInContext<T>(fn: (context: ContextRef) => T): T;\n}\n\n/**\n * @internal\n *\n * @param injector - injector to use for context\n * @param debugFn - context owner function\n */\nexport function setupContext(\n  injector?: Injector,\n  debugFn?: (...args: any[]) => any\n): SetupContextRef {\n  if (typeof ngDevMode !== 'undefined' && ngDevMode && !injector) {\n    assertInInjectionContext(debugFn || setupContext);\n  }\n\n  const ctxInjector = injector || inject(INJECTOR);\n\n  return {\n    runInContext<T>(fn: (context: ContextRef) => T): T {\n      return runInContextImpl(fn, ctxInjector, debugFn || setupContext);\n    },\n  };\n}\n\nfunction runInContextImpl<T>(\n  fn: (context: ContextRef) => T,\n  injector: Injector,\n  debugFn: (...args: any[]) => any\n): T {\n  const result = runInInjectionContext(injector, () => {\n    const isBrowser = inject(IS_BROWSER);\n    const isServer = inject(IS_SERVER);\n    const isMobile = inject(IS_MOBILE);\n    const destroyRef = inject(DestroyRef);\n\n    const onCleanup = (cleanupFn: () => void) => {\n      destroyRef.onDestroy(cleanupFn);\n    };\n\n    return untracked(() => fn({ injector, isBrowser, isServer, isMobile, onCleanup }));\n  });\n\n  if (typeof ngDevMode !== 'undefined' && ngDevMode && result != null) {\n    setupDebugInfo(result, debugFn);\n  }\n\n  return result;\n}\n\nfunction setupDebugInfo<T>(value: T, debugFn: (...args: any[]) => any): T {\n  if (isSignal(value)) {\n    setDebugName(value, debugFn);\n  } else if (value && typeof value === 'object') {\n    for (const [postfix, maybeSignal] of Object.entries(value)) {\n      if (isSignal(maybeSignal)) {\n        setDebugName(maybeSignal, debugFn, postfix);\n      }\n    }\n  }\n\n  return value;\n}\n\nfunction setDebugName(\n  signal: Signal<unknown>,\n  debugFn: (...args: any[]) => any,\n  postfix?: string\n): void {\n  const node = signal[SIGNAL] as SignalNode<unknown>;\n\n  if (node.debugName === undefined) {\n    node.debugName = debugFn.name + (postfix ? '.' + postfix : '');\n  }\n}\n","import { InjectionToken, type ProviderToken } from '@angular/core';\n\n/**\n * Creates an Angular InjectionToken with a factory function.\n * @internal\n */\nexport function createToken<T>(\n  factory: () => T,\n  providedIn: ProvidedIn = 'root'\n): ProviderToken<T> {\n  return new InjectionToken(ngDevMode ? factory.name : '', { factory, providedIn });\n}\n\ntype ProvidedIn = NonNullable<ConstructorParameters<typeof InjectionToken>[1]>['providedIn'];\n","import { isSignal, type Signal } from '@angular/core';\nimport { SIGNAL } from '@angular/core/primitives/signals';\n\n/**\n * Determines if a signal is a query signal (viewChild, contentChild).\n * Query signals have a special internal structure with a `_dirtyCounter` property that tracks\n * when query results change.\n\n * See: https://github.com/angular/angular/blob/main/packages/core/src/render3/queries/query_reactive.ts#L43\n * @internal\n */\nexport function isQuerySignal(val: unknown): val is Signal<unknown> {\n  if (!isSignal(val)) {\n    return false;\n  }\n\n  const node = val[SIGNAL] as object;\n  return '_dirtyCounter' in node;\n}\n","export function isPlainObject(value: unknown): value is Record<PropertyKey, unknown> {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n\n  const prototype = Object.getPrototypeOf(value);\n  return prototype === null || prototype === Object.prototype;\n}\n","import type { Signal } from '@angular/core';\nimport {\n  SIGNAL,\n  SIGNAL_NODE,\n  type SignalGetter,\n  type SignalNode,\n} from '@angular/core/primitives/signals';\n\n/***\n * Creates a lightweight, readonly signal.\n * This is primarily used to provide fallback values for states that cannot be\n * computed in the current environment. For example:\n * - During SSR where browser-only APIs are unavailable\n * - In environments that lack support for specific APIs\n * @internal\n */\nexport function constSignal<T>(value: T): Signal<T> {\n  const node: SignalNode<T> = Object.create(SIGNAL_NODE);\n  node.value = value;\n\n  const getter = (() => node.value) as SignalGetter<T>;\n  (getter as any)[SIGNAL] = node;\n\n  if (typeof ngDevMode !== 'undefined' && ngDevMode) {\n    const debugName = node.debugName ? ' (' + node.debugName + ')' : '';\n    getter.toString = () => `[Signal${debugName}: ${String(node.value)}]`;\n  }\n\n  return getter;\n}\n","import { type Signal, untracked, type WritableSignal } from '@angular/core';\nimport { SIGNAL, type SignalNode } from '@angular/core/primitives/signals';\n\n/**\n * @internal\n */\nexport interface SignalProxyHandler<T> {\n  get?(source: Signal<T>): T;\n  set?(value: T, source: WritableSignal<T>): void;\n}\n\n/**\n * Creates a proxy wrapper around a {@link Signal}\n * @internal\n */\nexport function proxySignal<T>(\n  source: Signal<T>,\n  handler: Omit<SignalProxyHandler<T>, 'set'>\n): Signal<T>;\n\n/**\n * Creates a proxy wrapper around a {@link WritableSignal}\n * @internal\n */\nexport function proxySignal<T>(\n  source: WritableSignal<T>,\n  handler: SignalProxyHandler<T>\n): WritableSignal<T>;\n\nexport function proxySignal<T>(\n  source: Signal<T> | WritableSignal<T>,\n  handler: SignalProxyHandler<T>\n): Signal<T> | WritableSignal<T> {\n  const node = source[SIGNAL] as SignalNode<T>;\n  const isWritable = 'set' in source && typeof source.set === 'function';\n\n  const proxy = (handler.get ? () => handler.get!(source) : () => source()) as Signal<T>;\n\n  proxy[SIGNAL] = node;\n\n  // @TODO: consider (original toString internally reads from the original getter, bypassing the proxy)\n  proxy.toString = source.toString;\n\n  if (isWritable) {\n    const set = handler.set\n      ? (value: T) => untracked(() => handler.set!(value, source))\n      : (value: T) => source.set(value);\n\n    const update = (updater: (current: T) => T) => set(updater(node.value));\n\n    (proxy as WritableSignal<T>).set = set;\n    (proxy as WritableSignal<T>).update = update;\n    (proxy as WritableSignal<T>).asReadonly = () => {\n      const getter = source.asReadonly();\n      return proxySignal(getter, { get: handler.get?.bind(handler) });\n    };\n  }\n\n  return proxy;\n}\n","import { isSignal, untracked as _untracked } from '@angular/core';\nimport type { MaybeSignal } from '@signality/core/types';\n\nexport interface ToValueFn {\n  <T>(maybeSignal: MaybeSignal<T>): T;\n  untracked: <T>(maybeSignal: MaybeSignal<T>) => T;\n}\n\n// @TODO: Consider moving it out of internal\nexport const toValue: ToValueFn = (() => {\n  const fn = toValueFn as ToValueFn;\n  fn.untracked = v => toValueFn(v, true);\n  return fn;\n})();\n\nfunction toValueFn<T>(maybeSignal: MaybeSignal<T>, untracked = false): T {\n  if (isSignal(maybeSignal)) {\n    return untracked ? _untracked(maybeSignal) : maybeSignal();\n  }\n  return maybeSignal;\n}\n","import { ElementRef, type Signal } from '@angular/core';\nimport type { MaybeElementSignal } from '@signality/core/types';\nimport { toValue } from './to-value';\n\nexport interface ToElementFn extends ToElementBase {\n  untracked: ToElementBase;\n}\n\nexport interface ToElementBase {\n  <T extends Element>(element: T | ElementRef<T>): T;\n  <T extends Element>(element: Signal<T | ElementRef<T> | null>): T | null;\n  <T extends Element>(element: Signal<T | ElementRef<T> | undefined>): T | undefined;\n  <T extends Element>(element: Signal<T | ElementRef<T> | null | undefined>): T | null | undefined;\n  <T extends Element>(element: T | ElementRef<T> | Signal<T | ElementRef<T> | null | undefined>):\n    | T\n    | null\n    | undefined;\n}\n\n// @TODO: Consider moving it out of internal\nexport const toElement: ToElementFn = (() => {\n  const fn = toElementFn as ToElementFn;\n  fn.untracked = v => toElementFn(v, true);\n  return fn;\n})();\n\nfunction toElementFn<T extends Element>(\n  maybeSignal: MaybeElementSignal<T>,\n  untracked = false\n): T | null | undefined {\n  const value = untracked ? toValue.untracked(maybeSignal) : toValue(maybeSignal);\n\n  if (value instanceof ElementRef) {\n    return value.nativeElement;\n  }\n\n  return value;\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":["untracked","_untracked"],"mappings":"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"}

package/fesm2022/signality-core-observers-intersection-observer.mjs

@@ -0,0 +1,70 @@
+import { afterRenderEffect } from '@angular/core';
+import { setupContext, NOOP_EFFECT_REF, toElement, toValue } from '@signality/core/internal';
+
+/**
+ * Low-level utility for observing element intersection with viewport using the [Intersection Observer API](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API).
+ * Provides fine-grained control over the observation lifecycle.
+ *
+ * @param target - Element(s) to observe
+ * @param callback - Callback function called when intersection changes
+ * @param options - Optional configuration (see {@link IntersectionObserverInitOptions})
+ * @returns An IntersectionObserverRef with a `destroy()` method to stop observing the element(s)
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <div #section>Section content</div>
+ *     @if (isVisible()) {
+ *       <p>Section is visible!</p>
+ *     }
+ *   `
+ * })
+ * class IntersectionComponent {
+ *   readonly section = viewChild<ElementRef>('section');
+ *   readonly isVisible = signal(false);
+ *
+ *   constructor() {
+ *     intersectionObserver(this.section, entries => {
+ *       this.isVisible.set(entries[0].isIntersecting);
+ *     }, { threshold: 0.5 });
+ *   }
+ * }
+ * ```
+ */
+function intersectionObserver(target, callback, options) {
+    const { runInContext } = setupContext(options?.injector, intersectionObserver);
+    return runInContext(({ isServer }) => {
+        if (isServer) {
+            return NOOP_EFFECT_REF;
+        }
+        const targets = Array.isArray(target) ? target : [target];
+        const setupObserver = (onCleanup) => {
+            const els = targets.map(toElement).filter(Boolean);
+            if (!els.length) {
+                return;
+            }
+            const root = options?.root
+                ? options.root instanceof Document
+                    ? options.root
+                    : toElement(options.root)
+                : null;
+            const rootMargin = toValue(options?.rootMargin);
+            const threshold = toValue(options?.threshold);
+            const observer = new IntersectionObserver(callback, { root, rootMargin, threshold });
+            for (const el of els) {
+                observer.observe(el);
+            }
+            onCleanup(observer.disconnect.bind(observer));
+        };
+        const effectRef = afterRenderEffect({ read: setupObserver }, options);
+        return { destroy: () => effectRef.destroy() };
+    });
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { intersectionObserver };
+//# sourceMappingURL=signality-core-observers-intersection-observer.mjs.map

package/fesm2022/signality-core-observers-intersection-observer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signality-core-observers-intersection-observer.mjs","sources":["../../../projects/core/observers/intersection-observer/index.ts","../../../projects/core/observers/intersection-observer/signality-core-observers-intersection-observer.ts"],"sourcesContent":["import {\n  afterRenderEffect,\n  type CreateEffectOptions,\n  type EffectCleanupRegisterFn,\n} from '@angular/core';\nimport { NOOP_EFFECT_REF, setupContext, toElement, toValue } from '@signality/core/internal';\nimport type { MaybeElementSignal, MaybeSignal } from '@signality/core/types';\n\nexport interface IntersectionObserverInitOptions\n  extends Omit<CreateEffectOptions, 'allowSignalWrites'> {\n  readonly root?: MaybeElementSignal<Element> | Document | null;\n  readonly rootMargin?: MaybeSignal<string>;\n  readonly threshold?: MaybeSignal<number | number[]>;\n}\n\nexport interface IntersectionObserverRef {\n  readonly destroy: () => void;\n}\n\n/**\n * Low-level utility for observing element intersection with viewport using the [Intersection Observer API](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API).\n * Provides fine-grained control over the observation lifecycle.\n *\n * @param target - Element(s) to observe\n * @param callback - Callback function called when intersection changes\n * @param options - Optional configuration (see {@link IntersectionObserverInitOptions})\n * @returns An IntersectionObserverRef with a `destroy()` method to stop observing the element(s)\n *\n * @example\n * ```typescript\n * @Component({\n *   template: `\n *     <div #section>Section content</div>\n *     @if (isVisible()) {\n *       <p>Section is visible!</p>\n *     }\n *   `\n * })\n * class IntersectionComponent {\n *   readonly section = viewChild<ElementRef>('section');\n *   readonly isVisible = signal(false);\n *\n *   constructor() {\n *     intersectionObserver(this.section, entries => {\n *       this.isVisible.set(entries[0].isIntersecting);\n *     }, { threshold: 0.5 });\n *   }\n * }\n * ```\n */\nexport function intersectionObserver(\n  target: MaybeElementSignal<Element> | MaybeElementSignal<Element>[],\n  callback: (entries: readonly IntersectionObserverEntry[], observer: IntersectionObserver) => void,\n  options?: IntersectionObserverInitOptions\n): IntersectionObserverRef {\n  const { runInContext } = setupContext(options?.injector, intersectionObserver);\n\n  return runInContext(({ isServer }) => {\n    if (isServer) {\n      return NOOP_EFFECT_REF;\n    }\n\n    const targets = Array.isArray(target) ? target : [target];\n\n    const setupObserver = (onCleanup: EffectCleanupRegisterFn) => {\n      const els = targets.map(toElement).filter(Boolean);\n\n      if (!els.length) {\n        return;\n      }\n\n      const root = options?.root\n        ? options.root instanceof Document\n          ? options.root\n          : toElement(options.root)\n        : null;\n      const rootMargin = toValue(options?.rootMargin);\n      const threshold = toValue(options?.threshold);\n\n      const observer = new IntersectionObserver(callback, { root, rootMargin, threshold });\n\n      for (const el of els) {\n        observer.observe(el!);\n      }\n\n      onCleanup(observer.disconnect.bind(observer));\n    };\n\n    const effectRef = afterRenderEffect({ read: setupObserver }, options);\n\n    return { destroy: () => effectRef.destroy() };\n  });\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;AAmBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BG;SACa,oBAAoB,CAClC,MAAmE,EACnE,QAAiG,EACjG,OAAyC,EAAA;AAEzC,IAAA,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,oBAAoB,CAAC;AAE9E,IAAA,OAAO,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAI;QACnC,IAAI,QAAQ,EAAE;AACZ,YAAA,OAAO,eAAe;QACxB;AAEA,QAAA,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC;AAEzD,QAAA,MAAM,aAAa,GAAG,CAAC,SAAkC,KAAI;AAC3D,YAAA,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;AAElD,YAAA,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE;gBACf;YACF;AAEA,YAAA,MAAM,IAAI,GAAG,OAAO,EAAE;AACpB,kBAAE,OAAO,CAAC,IAAI,YAAY;sBACtB,OAAO,CAAC;AACV,sBAAE,SAAS,CAAC,OAAO,CAAC,IAAI;kBACxB,IAAI;YACR,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC;YAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC;AAE7C,YAAA,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AAEpF,YAAA,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE;AACpB,gBAAA,QAAQ,CAAC,OAAO,CAAC,EAAG,CAAC;YACvB;YAEA,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC/C,QAAA,CAAC;AAED,QAAA,MAAM,SAAS,GAAG,iBAAiB,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,OAAO,CAAC;QAErE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC,OAAO,EAAE,EAAE;AAC/C,IAAA,CAAC,CAAC;AACJ;;AC5FA;;AAEG;;;;"}

package/fesm2022/signality-core-observers-mutation-observer.mjs

@@ -0,0 +1,77 @@
+import { afterRenderEffect } from '@angular/core';
+import { setupContext, NOOP_EFFECT_REF, toElement, toValue } from '@signality/core/internal';
+
+/**
+ * Low-level utility for observing DOM tree changes using the [MutationObserver API](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver).
+ * Provides fine-grained control over the observation lifecycle.
+ *
+ * @param target - Element(s) to observe
+ * @param callback - Callback function called when DOM mutations occur
+ * @param options - Optional configuration (see {@link MutationObserverInitOptions})
+ * @returns MutationObserverRef with a `destroy()` method to stop observing the element(s)
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     <div #container>
+ *       <p>Children: {{ childCount() }}</p>
+ *     </div>
+ *   `
+ * })
+ * class MutationComponent {
+ *   readonly container = viewChild<ElementRef>('container');
+ *   readonly childCount = signal(0);
+ *
+ *   constructor() {
+ *     mutationObserver(this.container, mutations => {
+ *       this.childCount.set(mutations[0].target.childNodes.length);
+ *     }, { childList: true });
+ *   }
+ * }
+ * ```
+ */
+function mutationObserver(target, callback, options) {
+    const { runInContext } = setupContext(options.injector, mutationObserver);
+    return runInContext(({ isServer }) => {
+        if (isServer) {
+            return NOOP_EFFECT_REF;
+        }
+        const targets = Array.isArray(target) ? target : [target];
+        const setupObserver = (onCleanup) => {
+            const els = targets.map(toElement).filter(Boolean);
+            if (!els.length) {
+                return;
+            }
+            const childList = toValue(options.childList);
+            const attributes = toValue(options.attributes);
+            const characterData = toValue(options.characterData);
+            const subtree = toValue(options.subtree);
+            const attributeOldValue = toValue(options.attributeOldValue);
+            const characterDataOldValue = toValue(options.characterDataOldValue);
+            const attributeFilter = toValue(options.attributeFilter);
+            const observer = new MutationObserver(callback);
+            for (const el of els) {
+                observer.observe(el, {
+                    childList,
+                    attributes,
+                    characterData,
+                    subtree,
+                    attributeOldValue,
+                    characterDataOldValue,
+                    attributeFilter,
+                });
+            }
+            onCleanup(observer.disconnect.bind(observer));
+        };
+        const effectRef = afterRenderEffect({ read: setupObserver }, options);
+        return { destroy: () => effectRef.destroy() };
+    });
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { mutationObserver };
+//# sourceMappingURL=signality-core-observers-mutation-observer.mjs.map