@mmstack/primitives 21.0.26 → 22.0.1

package/fesm2022/mmstack-primitives.mjs

@@ -311,7 +311,8 @@ function debounced(initial, opt) {
  */
 function debounce(source, opt) {
     const ms = opt?.ms ?? 0;
-    const trigger = signal(false, ...(ngDevMode ? [{ debugName: "trigger" }] : /* istanbul ignore next */ []));
+    const trigger = signal(false, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "trigger" }] : /* istanbul ignore next */ []));
     let timeout;
     try {
         const destroyRef = opt?.destroyRef ?? inject(DestroyRef, { optional: true });
@@ -661,7 +662,8 @@ function createItemSignal(source, index, setter, opt) {
 }
 function indexArray(source, map, opt = {}) {
     const data = isSignal(source) ? source : computed(source);
-    const len = computed(() => data().length, ...(ngDevMode ? [{ debugName: "len" }] : /* istanbul ignore next */ []));
+    const len = computed(() => data().length, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "len" }] : /* istanbul ignore next */ []));
     const setter = createSetter(data);
     const writableData = isWritableSignal(data)
         ? data
@@ -789,7 +791,8 @@ function keyArray(source, mapFn, options = {}) {
                 for (j = 0; j < newLen; j++) {
                     item = newItems[j];
                     items[j] = item;
-                    const indexSignal = signal(j, ...(ngDevMode ? [{ debugName: "indexSignal" }] : /* istanbul ignore next */ []));
+                    const indexSignal = signal(j, /* @ts-ignore */
+                    ...(ngDevMode ? [{ debugName: "indexSignal" }] : /* istanbul ignore next */ []));
                     newIndexes[j] = indexSignal;
                     newMapped[j] = mapFn(item, indexSignal);
                 }
@@ -839,7 +842,8 @@ function keyArray(source, mapFn, options = {}) {
                         newIndexes[j].set(j);
                     }
                     else {
-                        const indexSignal = signal(j, ...(ngDevMode ? [{ debugName: "indexSignal" }] : /* istanbul ignore next */ []));
+                        const indexSignal = signal(j, /* @ts-ignore */
+                        ...(ngDevMode ? [{ debugName: "indexSignal" }] : /* istanbul ignore next */ []));
                         newIndexes[j] = indexSignal;
                         newMapped[j] = mapFn(newItems[j], indexSignal);
                     }
@@ -1276,7 +1280,8 @@ function clipboard(debugName = 'clipboard') {
         !navigator.clipboard) {
         const sig = computed(() => '', { debugName });
         sig.copy = () => Promise.resolve();
-        sig.isSupported = computed(() => false, ...(ngDevMode ? [{ debugName: "isSupported" }] : /* istanbul ignore next */ []));
+        sig.isSupported = computed(() => false, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "isSupported" }] : /* istanbul ignore next */ []));
         return sig;
     }
     const state = signal('', { ...(ngDevMode ? { debugName: "state" } : /* istanbul ignore next */ {}), debugName });
@@ -1295,7 +1300,8 @@ function clipboard(debugName = 'clipboard') {
         await navigator.clipboard.writeText(value);
         state.set(value);
     };
-    sig.isSupported = computed(() => true, ...(ngDevMode ? [{ debugName: "isSupported" }] : /* istanbul ignore next */ []));
+    sig.isSupported = computed(() => true, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "isSupported" }] : /* istanbul ignore next */ []));
     return sig;
 }
 
@@ -1368,7 +1374,9 @@ function elementSize(target = inject(ElementRef), opt) {
             return;
         let observer = null;
         observer = new ResizeObserver(([entry]) => {
+            // eslint-disable-next-line no-useless-assignment
             let width = 0;
+            // eslint-disable-next-line no-useless-assignment
             let height = 0;
             const boxOption = opt?.box ?? 'border-box';
             if (boxOption === 'border-box' && entry.borderBoxSize?.length > 0) {
@@ -1458,7 +1466,8 @@ function elementVisibility(target = inject(ElementRef), opt) {
         const base = computed(() => undefined, {
             debugName: opt?.debugName,
         });
-        base.visible = computed(() => false, ...(ngDevMode ? [{ debugName: "visible" }] : /* istanbul ignore next */ []));
+        base.visible = computed(() => false, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "visible" }] : /* istanbul ignore next */ []));
         return base;
     }
     const state = signal(undefined, {
@@ -1495,7 +1504,8 @@ function elementVisibility(target = inject(ElementRef), opt) {
         if (!s)
             return false;
         return s.isIntersecting;
-    }, ...(ngDevMode ? [{ debugName: "visible" }] : /* istanbul ignore next */ []));
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "visible" }] : /* istanbul ignore next */ []));
     return base;
 }
 
@@ -1577,15 +1587,19 @@ function geolocation(opt) {
         const sig = computed(() => null, {
             debugName: opt?.debugName ?? 'geolocation',
         });
-        sig.error = computed(() => null, ...(ngDevMode ? [{ debugName: "error" }] : /* istanbul ignore next */ []));
-        sig.loading = computed(() => false, ...(ngDevMode ? [{ debugName: "loading" }] : /* istanbul ignore next */ []));
+        sig.error = computed(() => null, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "error" }] : /* istanbul ignore next */ []));
+        sig.loading = computed(() => false, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "loading" }] : /* istanbul ignore next */ []));
         return sig;
     }
     const position = signal(null, {
         debugName: opt?.debugName ?? 'geolocation',
     });
-    const error = signal(null, ...(ngDevMode ? [{ debugName: "error" }] : /* istanbul ignore next */ []));
-    const loading = signal(true, ...(ngDevMode ? [{ debugName: "loading" }] : /* istanbul ignore next */ []));
+    const error = signal(null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "error" }] : /* istanbul ignore next */ []));
+    const loading = signal(true, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "loading" }] : /* istanbul ignore next */ []));
     const onSuccess = (p) => {
         position.set(p);
         error.set(null);
@@ -1636,13 +1650,15 @@ function idle(opt) {
         const sig = computed(() => false, {
             debugName: opt?.debugName ?? 'idle',
         });
-        sig.since = computed(() => serverDate$1, ...(ngDevMode ? [{ debugName: "since" }] : /* istanbul ignore next */ []));
+        sig.since = computed(() => serverDate$1, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "since" }] : /* istanbul ignore next */ []));
         return sig;
     }
     const ms = opt?.ms ?? 60_000;
     const events = opt?.events ?? DEFAULT_EVENTS;
     const state = signal(false, { debugName: opt?.debugName ?? 'idle' });
-    const since = signal(new Date(), ...(ngDevMode ? [{ debugName: "since" }] : /* istanbul ignore next */ []));
+    const since = signal(new Date(), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "since" }] : /* istanbul ignore next */ []));
     let timer;
     const goIdle = () => {
         if (state())
@@ -1840,7 +1856,8 @@ function throttle(source, opt) {
     const ms = opt?.ms ?? 0;
     const leading = opt?.leading ?? false;
     const trailing = opt?.trailing ?? true;
-    const trigger = signal(false, ...(ngDevMode ? [{ debugName: "trigger" }] : /* istanbul ignore next */ []));
+    const trigger = signal(false, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "trigger" }] : /* istanbul ignore next */ []));
     const fire = () => trigger.update((c) => !c);
     let timeout;
     let pendingTrailing = false;
@@ -2007,11 +2024,13 @@ function networkStatus(debugName = 'networkStatus') {
         const sig = computed(() => true, {
             debugName,
         });
-        sig.since = computed(() => serverDate, ...(ngDevMode ? [{ debugName: "since" }] : /* istanbul ignore next */ []));
+        sig.since = computed(() => serverDate, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "since" }] : /* istanbul ignore next */ []));
         return sig;
     }
     const state = signal(navigator.onLine, { ...(ngDevMode ? { debugName: "state" } : /* istanbul ignore next */ {}), debugName });
-    const since = signal(new Date(), ...(ngDevMode ? [{ debugName: "since" }] : /* istanbul ignore next */ []));
+    const since = signal(new Date(), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "since" }] : /* istanbul ignore next */ []));
     const goOnline = () => {
         state.set(true);
         since.set(new Date());
@@ -2399,6 +2418,12 @@ function signalFromEvent(target, eventName, initial, projectOrOpt, maybeOpt) {
     return untracked(() => state.asReadonly());
 }
 
+/**
+ * Runtime marker + compile-time brand for an opaque value. A `const`-declared `Symbol`
+ * has a `unique symbol` type, so the same symbol serves as both the property key written
+ * by {@link opaque} and the type-level brand carried by {@link Opaque}.
+ */
+const OPAQUE = Symbol('MMSTACK::OPAQUE');
 const IS_STORE = Symbol('MMSTACK::IS_STORE');
 const SCOPE_PARENT = Symbol('MMSTACK::SCOPE_PARENT');
 /**
@@ -2436,6 +2461,8 @@ function isStore(value) {
 function isRecord(value) {
     if (value === null || typeof value !== 'object')
         return false;
+    if (value[OPAQUE] === true)
+        return false; // opaque → leaf
     const proto = Object.getPrototypeOf(value);
     return proto === Object.prototype || proto === null;
 }
@@ -2470,7 +2497,8 @@ function toArrayStore(source, injector, vivify) {
         if (!Array.isArray(v))
             return 0;
         return v.length;
-    }, ...(ngDevMode ? [{ debugName: "lengthSignal" }] : /* istanbul ignore next */ []));
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "lengthSignal" }] : /* istanbul ignore next */ []));
     return new Proxy(source, {
         has(_, prop) {
             if (prop === 'length')
@@ -2717,7 +2745,8 @@ function scopedStore(parent, seed, kind, injector) {
     const view = computed(() => ({
         ...parent(),
         ...local(),
-    }), ...(ngDevMode ? [{ debugName: "view" }] : /* istanbul ignore next */ []));
+    }), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "view" }] : /* istanbul ignore next */ []));
     const splitSet = (next) => {
         const lv = localValue();
         const pv = parentValue();
@@ -2793,6 +2822,22 @@ function store(value, opt) {
 function mutableStore(value, opt) {
     return toStore(mutable(value, opt), opt?.injector, opt?.vivify ?? false);
 }
+/**
+ * Marks a plain object as opaque so {@link store} treats it as an indivisible leaf
+ * (returned whole, never deep-proxied) — the same way it treats a `Date` or `RegExp`.
+ * The marker is a non-enumerable symbol, so it never appears in spreads or iteration.
+ * Idempotent. Call before freezing (`defineProperty` fails on a frozen object).
+ *
+ * @example
+ * const s = store({ config: opaque({ theme: 'dark', nested: { a: 1 } }) });
+ * s.config();        // the whole object, not a child store
+ * s.config.set(opaque({ theme: 'light', nested: { a: 2 } }));
+ */
+function opaque(value) {
+    if (value[OPAQUE] !== true)
+        Object.defineProperty(value, OPAQUE, { value: true, enumerable: false });
+    return value;
+}
 
 // Internal dummy store for server-side rendering
 const noopStore = {
@@ -2981,10 +3026,10 @@ class MessageBus {
         this.channel.removeEventListener('message', listener);
         this.listeners.delete(id);
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.12", ngImport: i0, type: MessageBus, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.12", ngImport: i0, type: MessageBus, providedIn: 'root' });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.0", ngImport: i0, type: MessageBus, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.0", ngImport: i0, type: MessageBus, providedIn: 'root' });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.12", ngImport: i0, type: MessageBus, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.0", ngImport: i0, type: MessageBus, decorators: [{
             type: Injectable,
             args: [{
                     providedIn: 'root',
@@ -3058,7 +3103,8 @@ function tabSync(sig, opt) {
             return;
         }
         post(val);
-    }, ...(ngDevMode ? [{ debugName: "effectRef" }] : /* istanbul ignore next */ []));
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "effectRef" }] : /* istanbul ignore next */ []));
     inject(DestroyRef).onDestroy(() => {
         effectRef.destroy();
         unsub();
@@ -3258,9 +3304,12 @@ function withHistory(sourceOrValue, opt) {
         history.set([]);
         redoArray.set([]);
     };
-    internal.canUndo = computed(() => history().length > 0, ...(ngDevMode ? [{ debugName: "canUndo" }] : /* istanbul ignore next */ []));
-    internal.canRedo = computed(() => redoArray().length > 0, ...(ngDevMode ? [{ debugName: "canRedo" }] : /* istanbul ignore next */ []));
-    internal.canClear = computed(() => internal.canUndo() || internal.canRedo(), ...(ngDevMode ? [{ debugName: "canClear" }] : /* istanbul ignore next */ []));
+    internal.canUndo = computed(() => history().length > 0, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "canUndo" }] : /* istanbul ignore next */ []));
+    internal.canRedo = computed(() => redoArray().length > 0, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "canRedo" }] : /* istanbul ignore next */ []));
+    internal.canClear = computed(() => internal.canUndo() || internal.canRedo(), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "canClear" }] : /* istanbul ignore next */ []));
     return internal;
 }
 
@@ -3268,5 +3317,5 @@ function withHistory(sourceOrValue, opt) {
  * Generated bundle index. Do not edit.
  */
 
-export { batteryStatus, chunked, clipboard, combineWith, debounce, debounced, derived, distinct, elementSize, elementVisibility, filter, filterWith, focusWithin, geolocation, idle, indexArray, isDerivation, isMutable, isStore, keyArray, map, mapArray, mapObject, mediaQuery, mousePosition, mutable, mutableStore, nestedEffect, networkStatus, orientation, pageVisibility, pairwise, pipeable, piped, pooled, pooledArray, pooledMap, pooledSet, prefersDarkMode, prefersReducedMotion, scan, scrollPosition, select, sensor, sensors, signalFromEvent, startWith, store, stored, tabSync, tap, throttle, throttled, toFakeDerivation, toFakeSignalDerivation, toStore, toWritable, until, windowSize, withHistory };
+export { batteryStatus, chunked, clipboard, combineWith, debounce, debounced, derived, distinct, elementSize, elementVisibility, filter, filterWith, focusWithin, geolocation, idle, indexArray, isDerivation, isMutable, isStore, keyArray, map, mapArray, mapObject, mediaQuery, mousePosition, mutable, mutableStore, nestedEffect, networkStatus, opaque, orientation, pageVisibility, pairwise, pipeable, piped, pooled, pooledArray, pooledMap, pooledSet, prefersDarkMode, prefersReducedMotion, scan, scrollPosition, select, sensor, sensors, signalFromEvent, startWith, store, stored, tabSync, tap, throttle, throttled, toFakeDerivation, toFakeSignalDerivation, toStore, toWritable, until, windowSize, withHistory };
 //# sourceMappingURL=mmstack-primitives.mjs.map