yummies 7.11.0 → 7.12.0

package/mobx.cjs

@@ -1,202 +1,361 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const mobx = require("mobx");
-const typeGuard = require("yummies/type-guard");
-const applyObservable = (context, annotationsArray, useDecorators) => {
-  if (useDecorators) {
-    annotationsArray.forEach(([annotation, ...fields]) => {
-      fields.forEach((field) => {
-        annotation(context, field);
-      });
-    });
-    mobx.makeObservable(context);
-  } else {
-    const annotationsObject = {};
-    annotationsArray.forEach(([annotation, ...fields]) => {
-      fields.forEach((field) => {
-        annotationsObject[field] = annotation;
-      });
-    });
-    mobx.makeObservable(context, annotationsObject);
-  }
+require("./chunk-CVq3Gv4J.cjs");
+let yummies_type_guard = require("yummies/type-guard");
+let mobx = require("mobx");
+//#region src/mobx/apply-observable.ts
+/**
+* Applies a compact list of MobX annotations to an object using either
+* decorator-style invocation or the annotation map form accepted by `makeObservable`.
+*
+* @template T Target object type.
+* @param context Object that should become observable.
+* @param annotationsArray Tuples of annotation followed by annotated field names.
+* @param useDecorators Enables decorator-style application before calling `makeObservable`.
+*
+* @example
+* ```ts
+* applyObservable(store, [[observable, 'items'], [action, 'setItems']]);
+* ```
+*
+* @example
+* ```ts
+* applyObservable(viewModel, [[computed, 'fullName']], true);
+* ```
+*/
+var applyObservable = (context, annotationsArray, useDecorators) => {
+	if (useDecorators) {
+		annotationsArray.forEach(([annotation, ...fields]) => {
+			fields.forEach((field) => {
+				annotation(context, field);
+			});
+		});
+		(0, mobx.makeObservable)(context);
+	} else {
+		const annotationsObject = {};
+		annotationsArray.forEach(([annotation, ...fields]) => {
+			fields.forEach((field) => {
+				annotationsObject[field] = annotation;
+			});
+		});
+		(0, mobx.makeObservable)(context, annotationsObject);
+	}
 };
-const createEnhancedAtom = (name, onBecomeObservedHandler, onBecomeUnobservedHandler, meta) => {
-  const atom = mobx.createAtom(
-    name,
-    onBecomeObservedHandler && (() => onBecomeObservedHandler(atom)),
-    onBecomeUnobservedHandler && (() => onBecomeUnobservedHandler(atom))
-  );
-  atom.meta = meta ?? {};
-  atom.reportChanged = atom.reportChanged.bind(atom);
-  atom.reportObserved = atom.reportObserved.bind(atom);
-  return atom;
+//#endregion
+//#region src/mobx/create-enhanced-atom.ts
+/**
+* Creates a MobX atom extended with metadata and bound reporting methods.
+*
+* @template TMeta Metadata object stored on the atom.
+* @param name Atom name used by MobX for debugging.
+* @param onBecomeObservedHandler Callback fired when the atom becomes observed.
+* @param onBecomeUnobservedHandler Callback fired when the atom is no longer observed.
+* @param meta Optional metadata attached to the atom.
+* @returns Atom instance with `meta`, `reportChanged` and `reportObserved`.
+*
+* @example
+* ```ts
+* const atom = createEnhancedAtom('user-status');
+* atom.reportChanged();
+* ```
+*
+* @example
+* ```ts
+* const atom = createEnhancedAtom('cache', undefined, undefined, { scope: 'users' });
+* atom.meta.scope;
+* ```
+*/
+var createEnhancedAtom = (name, onBecomeObservedHandler, onBecomeUnobservedHandler, meta) => {
+	const atom = (0, mobx.createAtom)(name, onBecomeObservedHandler && (() => onBecomeObservedHandler(atom)), onBecomeUnobservedHandler && (() => onBecomeUnobservedHandler(atom)));
+	atom.meta = meta ?? {};
+	atom.reportChanged = atom.reportChanged.bind(atom);
+	atom.reportObserved = atom.reportObserved.bind(atom);
+	return atom;
 };
-const createRef = (cfg) => {
-  let lastValue;
-  const comparer = cfg?.comparer ?? mobx.comparer.default;
-  const setValue = (value) => {
-    const nextValue = value ?? null;
-    if (comparer(ref.current, nextValue)) {
-      return;
-    }
-    mobx.runInAction(() => {
-      const prevLastValue = lastValue;
-      lastValue = ref.current ?? void 0;
-      ref.current = nextValue;
-      let isNextValueIgnored = false;
-      ref.listeners.forEach((listener) => {
-        const listenerResult = listener(ref.current, lastValue);
-        if (listenerResult === false) {
-          isNextValueIgnored = true;
-        }
-      });
-      if (isNextValueIgnored) {
-        lastValue = prevLastValue;
-        ref.current = lastValue ?? null;
-      } else if (ref.current === null && lastValue !== void 0) {
-        lastValue = void 0;
-      }
-    });
-  };
-  const ref = setValue;
-  ref.set = setValue;
-  ref.listeners = new Set(cfg?.onChange ? [cfg.onChange] : []);
-  if (cfg?.onSet || cfg?.onUnset) {
-    ref.listeners.add((value, prevValue) => {
-      if (value) {
-        cfg.onSet?.(value, prevValue);
-      } else {
-        cfg.onUnset?.(prevValue);
-      }
-    });
-  }
-  ref.current = cfg?.initial ?? null;
-  ref.meta = cfg?.meta ?? {};
-  mobx.makeObservable(ref, {
-    current: mobx.observable.ref,
-    meta: mobx.observable
-  });
-  return ref;
+//#endregion
+//#region src/mobx/create-ref.ts
+/**
+* Creates a MobX-aware ref that behaves like a callback ref and exposes
+* observable `current` and `meta` fields.
+*
+* @template T Referenced value type.
+* @template TMeta Additional observable metadata stored on the ref.
+* @param cfg Optional callbacks, initial value and comparer configuration.
+* @returns Observable ref function object.
+*
+* @example
+* ```ts
+* const inputRef = createRef<HTMLInputElement>();
+* inputRef.set(document.createElement('input'));
+* ```
+*
+* @example
+* ```ts
+* const ref = createRef<number>();
+* ref(3);
+* ref.current; // 3
+* ```
+*
+* @example
+* ```ts
+* const nodeRef = createRef({
+*   onUnset: () => console.log('detached'),
+*   meta: { mounted: false },
+* });
+* ```
+*/
+var createRef = (cfg) => {
+	let lastValue;
+	const comparer = cfg?.comparer ?? mobx.comparer.default;
+	const setValue = (value) => {
+		const nextValue = value ?? null;
+		if (comparer(ref.current, nextValue)) return;
+		(0, mobx.runInAction)(() => {
+			const prevLastValue = lastValue;
+			lastValue = ref.current ?? void 0;
+			ref.current = nextValue;
+			let isNextValueIgnored = false;
+			ref.listeners.forEach((listener) => {
+				if (listener(ref.current, lastValue) === false) isNextValueIgnored = true;
+			});
+			if (isNextValueIgnored) {
+				lastValue = prevLastValue;
+				ref.current = lastValue ?? null;
+			} else if (ref.current === null && lastValue !== void 0) lastValue = void 0;
+		});
+	};
+	const ref = setValue;
+	ref.set = setValue;
+	ref.listeners = new Set(cfg?.onChange ? [cfg.onChange] : []);
+	if (cfg?.onSet || cfg?.onUnset) ref.listeners.add((value, prevValue) => {
+		if (value) cfg.onSet?.(value, prevValue);
+		else cfg.onUnset?.(prevValue);
+	});
+	ref.current = cfg?.initial ?? null;
+	ref.meta = cfg?.meta ?? {};
+	(0, mobx.makeObservable)(ref, {
+		current: mobx.observable.ref,
+		meta: mobx.observable
+	});
+	return ref;
 };
-const isRef = (value) => {
-  return typeof value === "function" && "current" in value;
+/**
+* Checks whether the provided value is a ref created by `createRef`.
+*
+* @template T Referenced value type.
+* @template TMeta Ref metadata type.
+* @param value Value to inspect.
+* @returns `true` when the value is a ref-like function with `current`.
+*
+* @example
+* ```ts
+* const ref = createRef<number>();
+* isRef(ref); // true
+* ```
+*
+* @example
+* ```ts
+* isRef({ current: 1 }); // false
+* ```
+*/
+var isRef = (value) => {
+	return typeof value === "function" && "current" in value;
 };
-const toRef = (value, cfg) => {
-  return isRef(value) ? value : createRef({ initial: value, ...cfg });
+/**
+* Normalizes a plain value or an existing ref into a `Ref` instance.
+*
+* @template T Referenced value type.
+* @template TMeta Ref metadata type.
+* @param value Existing ref or initial plain value.
+* @param cfg Optional ref configuration applied when a new ref is created.
+* @returns Existing ref or a newly created ref initialized with `value`.
+*
+* @example
+* ```ts
+* const ref = toRef(document.body);
+* ref.current === document.body;
+* ```
+*
+* @example
+* ```ts
+* const existingRef = createRef<number>();
+* const sameRef = toRef(existingRef);
+* ```
+*/
+var toRef = (value, cfg) => {
+	return isRef(value) ? value : createRef({
+		initial: value,
+		...cfg
+	});
 };
-class DeepObservableStruct {
-  data;
-  constructor(data) {
-    this.data = data;
-    mobx.makeObservable(this, {
-      data: mobx.observable.deep,
-      set: mobx.action
-    });
-  }
-  set(newData) {
-    const stack = Object.keys(this.data).map((key) => [
-      key,
-      this.data,
-      newData
-    ]);
-    let currentIndex = 0;
-    let stackLength = stack.length;
-    while (currentIndex < stackLength) {
-      const [key, currObservableData, newData2] = stack[currentIndex];
-      const newValue = newData2[key];
-      const currValue = currObservableData[key];
-      currentIndex++;
-      if (key in newData2) {
-        if (typeGuard.typeGuard.isObject(newValue) && typeGuard.typeGuard.isObject(currValue)) {
-          const newValueKeys = Object.keys(newValue);
-          Object.keys(currValue).forEach((childKey) => {
-            if (!(childKey in newValue)) {
-              delete currObservableData[key][childKey];
-            }
-          });
-          newValueKeys.forEach((childKey) => {
-            const length = stack.push([
-              childKey,
-              currObservableData[key],
-              newValue
-            ]);
-            stackLength = length;
-          });
-        } else if (newValue !== currValue) {
-          currObservableData[key] = newValue;
-        }
-      } else {
-        delete currObservableData[key];
-      }
-    }
-    Object.keys(newData).forEach((newDataKey) => {
-      if (!this.data[newDataKey]) {
-        this.data[newDataKey] = newData[newDataKey];
-      }
-    });
-  }
-}
-const getMobxAdministration = (context) => context[mobx.$mobx];
-const lazyObserve = ({
-  context,
-  property,
-  onStart,
-  onEnd,
-  endDelay = false
-}) => {
-  let timeoutId;
-  let metaData;
-  const observingProps = /* @__PURE__ */ new Set();
-  const properties = Array.isArray(property) ? property : [property];
-  const cleanup = () => {
-    observingProps.clear();
-    if (endDelay === false) {
-      onEnd?.(metaData, cleanup);
-      metaData = void 0;
-      return;
-    }
-    if (timeoutId) {
-      clearTimeout(timeoutId);
-      timeoutId = void 0;
-    }
-    timeoutId = setTimeout(() => {
-      onEnd?.(metaData, cleanup);
-      timeoutId = void 0;
-      metaData = void 0;
-    }, endDelay);
-  };
-  const start = (property2) => {
-    const isAlreadyObserving = observingProps.size > 0;
-    observingProps.add(property2);
-    if (isAlreadyObserving) {
-      return;
-    }
-    if (timeoutId) {
-      clearTimeout(timeoutId);
-      timeoutId = void 0;
-    }
-    metaData = onStart?.();
-  };
-  const stop = (property2) => {
-    const isAlreadyNotObserving = !observingProps.size;
-    observingProps.delete(property2);
-    const isObserving = observingProps.size > 0;
-    if (isAlreadyNotObserving || isObserving) {
-      return;
-    }
-    cleanup();
-  };
-  properties.forEach((property2) => {
-    if (context) {
-      mobx.onBecomeObserved(context, property2, () => start(property2));
-      mobx.onBecomeUnobserved(context, property2, () => stop(property2));
-    } else {
-      mobx.onBecomeObserved(property2, () => start(property2));
-      mobx.onBecomeUnobserved(property2, () => stop(property2));
-    }
-  });
-  return cleanup;
+//#endregion
+//#region src/mobx/deep-observable-struct.ts
+/**
+* Wraps a plain object into a deeply observable structure and allows
+* patch-like updates while preserving nested observable references where possible.
+*
+* @template TData Observable object shape.
+*
+* @example
+* ```ts
+* const state = new DeepObservableStruct({ user: { name: 'Ann' } });
+* state.set({ user: { name: 'Bob' } });
+* ```
+*
+* @example
+* ```ts
+* const state = new DeepObservableStruct({ filters: { active: true } });
+* state.set({ filters: { active: false, archived: true } });
+* ```
+*/
+var DeepObservableStruct = class {
+	data;
+	constructor(data) {
+		this.data = data;
+		(0, mobx.makeObservable)(this, {
+			data: mobx.observable.deep,
+			set: mobx.action
+		});
+	}
+	set(newData) {
+		const stack = Object.keys(this.data).map((key) => [
+			key,
+			this.data,
+			newData
+		]);
+		let currentIndex = 0;
+		let stackLength = stack.length;
+		while (currentIndex < stackLength) {
+			const [key, currObservableData, newData] = stack[currentIndex];
+			const newValue = newData[key];
+			const currValue = currObservableData[key];
+			currentIndex++;
+			if (key in newData) {
+				if (yummies_type_guard.typeGuard.isObject(newValue) && yummies_type_guard.typeGuard.isObject(currValue)) {
+					const newValueKeys = Object.keys(newValue);
+					Object.keys(currValue).forEach((childKey) => {
+						if (!(childKey in newValue)) delete currObservableData[key][childKey];
+					});
+					newValueKeys.forEach((childKey) => {
+						stackLength = stack.push([
+							childKey,
+							currObservableData[key],
+							newValue
+						]);
+					});
+				} else if (newValue !== currValue) currObservableData[key] = newValue;
+			} else delete currObservableData[key];
+		}
+		Object.keys(newData).forEach((newDataKey) => {
+			if (!this.data[newDataKey]) this.data[newDataKey] = newData[newDataKey];
+		});
+	}
 };
+//#endregion
+//#region src/mobx/get-mobx-administration.ts
+/**
+* Returns the internal MobX administration object associated with an observable target.
+*
+* @param context Observable object instance.
+* @returns MobX administration internals stored under `$mobx`.
+*
+* @example
+* ```ts
+* const admin = getMobxAdministration(store);
+* admin.name_;
+* ```
+*
+* @example
+* ```ts
+* const values = getMobxAdministration(formState).values_;
+* ```
+*/
+var getMobxAdministration = (context) => context[mobx.$mobx];
+//#endregion
+//#region src/mobx/lazy-observe.ts
+/**
+* Starts side effects only while one or more MobX observables are being observed.
+*
+* When the first property becomes observed, `onStart` is called. When all tracked
+* properties become unobserved, `onEnd` is called with the value returned by
+* `onStart`. Cleanup can be delayed via `endDelay`.
+*
+* It uses MobX `onBecomeObserved` and `onBecomeUnobserved` hooks to perform
+* lazy subscription management.
+*
+* @template TMetaData Data returned from `onStart` and forwarded to `onEnd`.
+* @param config Configuration for tracked properties and lifecycle callbacks.
+* @returns Cleanup function that clears the tracked state and runs `onEnd`.
+*
+* @example
+* ```ts
+* const stop = lazyObserve({
+*   context: store,
+*   property: 'items',
+*   onStart: () => api.subscribe(),
+*   onEnd: (subscription) => subscription.unsubscribe(),
+* });
+* ```
+*
+* @example
+* ```ts
+* lazyObserve({
+*   property: [boxA, boxB],
+*   onStart: () => console.log('observed'),
+*   endDelay: 300,
+* });
+* ```
+*/
+var lazyObserve = ({ context, property, onStart, onEnd, endDelay = false }) => {
+	let timeoutId;
+	let metaData;
+	const observingProps = /* @__PURE__ */ new Set();
+	const properties = Array.isArray(property) ? property : [property];
+	const cleanup = () => {
+		observingProps.clear();
+		if (endDelay === false) {
+			onEnd?.(metaData, cleanup);
+			metaData = void 0;
+			return;
+		}
+		if (timeoutId) {
+			clearTimeout(timeoutId);
+			timeoutId = void 0;
+		}
+		timeoutId = setTimeout(() => {
+			onEnd?.(metaData, cleanup);
+			timeoutId = void 0;
+			metaData = void 0;
+		}, endDelay);
+	};
+	const start = (property) => {
+		const isAlreadyObserving = observingProps.size > 0;
+		observingProps.add(property);
+		if (isAlreadyObserving) return;
+		if (timeoutId) {
+			clearTimeout(timeoutId);
+			timeoutId = void 0;
+		}
+		metaData = onStart?.();
+	};
+	const stop = (property) => {
+		const isAlreadyNotObserving = !observingProps.size;
+		observingProps.delete(property);
+		const isObserving = observingProps.size > 0;
+		if (isAlreadyNotObserving || isObserving) return;
+		cleanup();
+	};
+	properties.forEach((property) => {
+		if (context) {
+			(0, mobx.onBecomeObserved)(context, property, () => start(property));
+			(0, mobx.onBecomeUnobserved)(context, property, () => stop(property));
+		} else {
+			(0, mobx.onBecomeObserved)(property, () => start(property));
+			(0, mobx.onBecomeUnobserved)(property, () => stop(property));
+		}
+	});
+	return cleanup;
+};
+//#endregion
 exports.DeepObservableStruct = DeepObservableStruct;
 exports.applyObservable = applyObservable;
 exports.createEnhancedAtom = createEnhancedAtom;
@@ -205,4 +364,5 @@ exports.getMobxAdministration = getMobxAdministration;
 exports.isRef = isRef;
 exports.lazyObserve = lazyObserve;
 exports.toRef = toRef;
-//# sourceMappingURL=mobx.cjs.map
+
+//# sourceMappingURL=mobx.cjs.map

package/mobx.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"mobx.cjs","sources":["../src/mobx/apply-observable.ts","../src/mobx/create-enhanced-atom.ts","../src/mobx/create-ref.ts","../src/mobx/deep-observable-struct.ts","../src/mobx/get-mobx-administration.ts","../src/mobx/lazy-observe.ts"],"sourcesContent":["import { type AnnotationMapEntry, makeObservable } from 'mobx';\nimport type { AnyObject } from 'yummies/types';\n\nexport type ObservableAnnotationsArray<T extends AnyObject = AnyObject> = [\n  AnnotationMapEntry,\n  ...(keyof T | (string & {}))[],\n][];\n\n/**\n * Applies a compact list of MobX annotations to an object using either\n * decorator-style invocation or the annotation map form accepted by `makeObservable`.\n *\n * @template T Target object type.\n * @param context Object that should become observable.\n * @param annotationsArray Tuples of annotation followed by annotated field names.\n * @param useDecorators Enables decorator-style application before calling `makeObservable`.\n *\n * @example\n * ```ts\n * applyObservable(store, [[observable, 'items'], [action, 'setItems']]);\n * ```\n *\n * @example\n * ```ts\n * applyObservable(viewModel, [[computed, 'fullName']], true);\n * ```\n */\nexport const applyObservable = <T extends AnyObject>(\n  context: T,\n  annotationsArray: ObservableAnnotationsArray<T>,\n  useDecorators?: boolean,\n) => {\n  if (useDecorators) {\n    annotationsArray.forEach(([annotation, ...fields]) => {\n      fields.forEach((field) => {\n        // @ts-expect-error\n        annotation(context, field);\n      });\n    });\n\n    makeObservable(context);\n  } else {\n    const annotationsObject: AnyObject = {};\n\n    annotationsArray.forEach(([annotation, ...fields]) => {\n      fields.forEach((field) => {\n        annotationsObject[field] = annotation;\n      });\n    });\n\n    makeObservable(context, annotationsObject);\n  }\n};\n","import { createAtom, type IAtom } from 'mobx';\nimport type { AnyObject } from 'yummies/types';\n\nexport interface IEnhancedAtom<TMeta extends AnyObject = AnyObject>\n  extends IAtom {\n  meta: TMeta;\n}\n\n/**\n * Creates a MobX atom extended with metadata and bound reporting methods.\n *\n * @template TMeta Metadata object stored on the atom.\n * @param name Atom name used by MobX for debugging.\n * @param onBecomeObservedHandler Callback fired when the atom becomes observed.\n * @param onBecomeUnobservedHandler Callback fired when the atom is no longer observed.\n * @param meta Optional metadata attached to the atom.\n * @returns Atom instance with `meta`, `reportChanged` and `reportObserved`.\n *\n * @example\n * ```ts\n * const atom = createEnhancedAtom('user-status');\n * atom.reportChanged();\n * ```\n *\n * @example\n * ```ts\n * const atom = createEnhancedAtom('cache', undefined, undefined, { scope: 'users' });\n * atom.meta.scope;\n * ```\n */\nexport const createEnhancedAtom = <TMeta extends AnyObject>(\n  name: string,\n  onBecomeObservedHandler?: (atom: IEnhancedAtom<TMeta>) => void,\n  onBecomeUnobservedHandler?: (atom: IEnhancedAtom<TMeta>) => void,\n  meta?: TMeta,\n): IEnhancedAtom<TMeta> => {\n  const atom = createAtom(\n    name,\n    onBecomeObservedHandler && (() => onBecomeObservedHandler(atom)),\n    onBecomeUnobservedHandler && (() => onBecomeUnobservedHandler(atom)),\n  ) as IEnhancedAtom<TMeta>;\n  atom.meta = meta ?? ({} as TMeta);\n  atom.reportChanged = atom.reportChanged.bind(atom);\n  atom.reportObserved = atom.reportObserved.bind(atom);\n  return atom;\n};\n","import {\n  type IEqualsComparer,\n  makeObservable,\n  comparer as mobxComparer,\n  observable,\n  runInAction,\n} from 'mobx';\nimport type { AnyObject, Maybe } from 'yummies/types';\n\n/**\n * You can return `false` if you don't want to change the value in this ref\n */\nexport type RefChangeListener<T> = (\n  value: T | null,\n  prevValue: T | undefined,\n) => void | false;\n\n/**\n * Alternative to React.createRef but works in MobX world.\n * Typically it the should be the same React.LegacyRef (fn style)\n */\nexport interface Ref<T = any, TMeta = AnyObject> {\n  /**\n   * Setter function\n   */\n  (value: Maybe<T>): void;\n\n  set(value: Maybe<T>): void;\n  listeners: Set<RefChangeListener<NoInfer<T>>>;\n  current: NoInfer<T> | null;\n  meta: TMeta;\n}\n\nexport interface CreateRefConfig<T = any, TMeta = AnyObject> {\n  onSet?: (node: T, prevValue: T | undefined) => void;\n  onUnset?: (lastValue: T | undefined) => void;\n  onChange?: RefChangeListener<T>;\n  meta?: TMeta;\n  initial?: Maybe<T>;\n  comparer?: IEqualsComparer<T | null>;\n}\n\n/**\n * Creates a MobX-aware ref that behaves like a callback ref and exposes\n * observable `current` and `meta` fields.\n *\n * @template T Referenced value type.\n * @template TMeta Additional observable metadata stored on the ref.\n * @param cfg Optional callbacks, initial value and comparer configuration.\n * @returns Observable ref function object.\n *\n * @example\n * ```ts\n * const inputRef = createRef<HTMLInputElement>();\n * inputRef.set(document.createElement('input'));\n * ```\n *\n * @example\n * ```ts\n * const nodeRef = createRef({\n *   onUnset: () => console.log('detached'),\n *   meta: { mounted: false },\n * });\n * ```\n */\nexport const createRef = <T = any, TMeta = AnyObject>(\n  cfg?: CreateRefConfig<T, TMeta>,\n): Ref<T, TMeta> => {\n  let lastValue: T | undefined;\n  const comparer = cfg?.comparer ?? mobxComparer.default;\n\n  const setValue: Ref<T, TMeta>['set'] = (value) => {\n    const nextValue = value ?? null;\n\n    if (comparer(ref.current, nextValue)) {\n      return;\n    }\n\n    runInAction(() => {\n      const prevLastValue = lastValue;\n      lastValue = ref.current ?? undefined;\n      ref.current = nextValue;\n\n      let isNextValueIgnored = false;\n\n      ref.listeners.forEach((listener) => {\n        const listenerResult = listener(ref.current, lastValue);\n\n        if (listenerResult === false) {\n          isNextValueIgnored = true;\n        }\n      });\n\n      if (isNextValueIgnored) {\n        lastValue = prevLastValue;\n        ref.current = lastValue ?? null;\n      } else if (ref.current === null && lastValue !== undefined) {\n        lastValue = undefined;\n      }\n    });\n  };\n\n  const ref = setValue as Ref<T, TMeta>;\n\n  ref.set = setValue;\n\n  ref.listeners = new Set(cfg?.onChange ? [cfg.onChange] : []);\n\n  if (cfg?.onSet || cfg?.onUnset) {\n    ref.listeners.add((value, prevValue) => {\n      if (value) {\n        cfg.onSet?.(value, prevValue);\n      } else {\n        cfg.onUnset?.(prevValue);\n      }\n    });\n  }\n\n  ref.current = cfg?.initial ?? null;\n  ref.meta = cfg?.meta ?? ({} as TMeta);\n\n  makeObservable(ref, {\n    current: observable.ref,\n    meta: observable,\n  });\n\n  return ref;\n};\n\n/**\n * Checks whether the provided value is a ref created by `createRef`.\n *\n * @template T Referenced value type.\n * @template TMeta Ref metadata type.\n * @param value Value to inspect.\n * @returns `true` when the value is a ref-like function with `current`.\n *\n * @example\n * ```ts\n * const ref = createRef<number>();\n * isRef(ref); // true\n * ```\n *\n * @example\n * ```ts\n * isRef({ current: 1 }); // false\n * ```\n */\nexport const isRef = <T, TMeta = any>(\n  value: T | Ref<T, TMeta>,\n): value is Ref<T, TMeta> => {\n  return typeof value === 'function' && 'current' in value;\n};\n\n/**\n * Normalizes a plain value or an existing ref into a `Ref` instance.\n *\n * @template T Referenced value type.\n * @template TMeta Ref metadata type.\n * @param value Existing ref or initial plain value.\n * @param cfg Optional ref configuration applied when a new ref is created.\n * @returns Existing ref or a newly created ref initialized with `value`.\n *\n * @example\n * ```ts\n * const ref = toRef(document.body);\n * ref.current === document.body;\n * ```\n *\n * @example\n * ```ts\n * const existingRef = createRef<number>();\n * const sameRef = toRef(existingRef);\n * ```\n */\nexport const toRef = <T, TMeta = any>(\n  value: T | Ref<T, TMeta>,\n  cfg?: Omit<CreateRefConfig<T, TMeta>, 'initial'>,\n): Ref<T, TMeta> => {\n  return isRef(value) ? value : createRef({ initial: value, ...cfg });\n};\n","import { action, makeObservable, observable } from 'mobx';\nimport { typeGuard } from 'yummies/type-guard';\nimport type { AnyObject } from 'yummies/types';\n\n/**\n * Wraps a plain object into a deeply observable structure and allows\n * patch-like updates while preserving nested observable references where possible.\n *\n * @template TData Observable object shape.\n *\n * @example\n * ```ts\n * const state = new DeepObservableStruct({ user: { name: 'Ann' } });\n * state.set({ user: { name: 'Bob' } });\n * ```\n *\n * @example\n * ```ts\n * const state = new DeepObservableStruct({ filters: { active: true } });\n * state.set({ filters: { active: false, archived: true } });\n * ```\n */\nexport class DeepObservableStruct<TData extends AnyObject> {\n  data: TData;\n\n  constructor(data: TData) {\n    this.data = data;\n\n    makeObservable(this, {\n      data: observable.deep,\n      set: action,\n    });\n  }\n\n  set(newData: Partial<TData>) {\n    type StackItem = [key: string, currObservable: AnyObject, new: AnyObject];\n\n    const stack: StackItem[] = Object.keys(this.data).map((key) => [\n      key,\n      this.data,\n      newData,\n    ]);\n\n    let currentIndex = 0;\n    let stackLength = stack.length;\n\n    while (currentIndex < stackLength) {\n      const [key, currObservableData, newData] = stack[currentIndex];\n      const newValue = newData[key];\n      const currValue = currObservableData[key];\n\n      currentIndex++;\n\n      if (key in newData) {\n        if (typeGuard.isObject(newValue) && typeGuard.isObject(currValue)) {\n          const newValueKeys = Object.keys(newValue);\n\n          Object.keys(currValue).forEach((childKey) => {\n            if (!(childKey in newValue)) {\n              delete currObservableData[key][childKey];\n            }\n          });\n\n          newValueKeys.forEach((childKey) => {\n            const length = stack.push([\n              childKey,\n              currObservableData[key],\n              newValue,\n            ]);\n            stackLength = length;\n          });\n        } else if (newValue !== currValue) {\n          currObservableData[key] = newValue;\n        }\n      } else {\n        delete currObservableData[key];\n      }\n    }\n\n    Object.keys(newData).forEach((newDataKey) => {\n      if (!this.data[newDataKey]) {\n        // @ts-expect-error\n        this.data[newDataKey] = newData[newDataKey];\n      }\n    });\n  }\n}\n","import { $mobx, type AnnotationMapEntry } from 'mobx';\nimport type { AnyObject } from 'yummies/types';\n\ntype ObservableObjectAdministration = Parameters<\n  Exclude<AnnotationMapEntry, boolean>['make_']\n>[0];\n\n/**\n * Returns the internal MobX administration object associated with an observable target.\n *\n * @param context Observable object instance.\n * @returns MobX administration internals stored under `$mobx`.\n *\n * @example\n * ```ts\n * const admin = getMobxAdministration(store);\n * admin.name_;\n * ```\n *\n * @example\n * ```ts\n * const values = getMobxAdministration(formState).values_;\n * ```\n */\nexport const getMobxAdministration = (\n  context: AnyObject,\n): ObservableObjectAdministration => context[$mobx];\n","import { onBecomeObserved, onBecomeUnobserved } from 'mobx';\n\n/**\n * Starts side effects only while one or more MobX observables are being observed.\n *\n * When the first property becomes observed, `onStart` is called. When all tracked\n * properties become unobserved, `onEnd` is called with the value returned by\n * `onStart`. Cleanup can be delayed via `endDelay`.\n *\n * It uses MobX `onBecomeObserved` and `onBecomeUnobserved` hooks to perform\n * lazy subscription management.\n *\n * @template TMetaData Data returned from `onStart` and forwarded to `onEnd`.\n * @param config Configuration for tracked properties and lifecycle callbacks.\n * @returns Cleanup function that clears the tracked state and runs `onEnd`.\n *\n * @example\n * ```ts\n * const stop = lazyObserve({\n *   context: store,\n *   property: 'items',\n *   onStart: () => api.subscribe(),\n *   onEnd: (subscription) => subscription.unsubscribe(),\n * });\n * ```\n *\n * @example\n * ```ts\n * lazyObserve({\n *   property: [boxA, boxB],\n *   onStart: () => console.log('observed'),\n *   endDelay: 300,\n * });\n * ```\n */\nexport const lazyObserve = <TMetaData = void>({\n  context,\n  property,\n  onStart,\n  onEnd,\n  endDelay = false,\n}: {\n  context?: any;\n  property: any | any[];\n  onStart?: () => TMetaData;\n  onEnd?: (metaData: TMetaData, cleanupFn: VoidFunction) => void;\n  endDelay?: number | false;\n}) => {\n  let timeoutId: ReturnType<typeof setTimeout> | undefined;\n  let metaData: TMetaData | undefined;\n  const observingProps = new Set<string>();\n  const properties = Array.isArray(property) ? property : [property];\n\n  const cleanup = () => {\n    observingProps.clear();\n\n    if (endDelay === false) {\n      onEnd?.(metaData!, cleanup);\n      metaData = undefined;\n      return;\n    }\n\n    if (timeoutId) {\n      clearTimeout(timeoutId);\n      timeoutId = undefined;\n    }\n\n    timeoutId = setTimeout(() => {\n      onEnd?.(metaData!, cleanup);\n      timeoutId = undefined;\n      metaData = undefined;\n    }, endDelay);\n  };\n\n  const start = (property: string) => {\n    const isAlreadyObserving = observingProps.size > 0;\n    observingProps.add(property);\n\n    if (isAlreadyObserving) {\n      return;\n    }\n\n    if (timeoutId) {\n      clearTimeout(timeoutId);\n      timeoutId = undefined;\n    }\n\n    metaData = onStart?.();\n  };\n\n  const stop = (property: string) => {\n    const isAlreadyNotObserving = !observingProps.size;\n\n    observingProps.delete(property);\n\n    const isObserving = observingProps.size > 0;\n\n    if (isAlreadyNotObserving || isObserving) {\n      return;\n    }\n\n    cleanup();\n  };\n\n  properties.forEach((property) => {\n    if (context) {\n      onBecomeObserved(context, property, () => start(property));\n      onBecomeUnobserved(context, property, () => stop(property));\n    } else {\n      onBecomeObserved(property, () => start(property));\n      onBecomeUnobserved(property, () => stop(property));\n    }\n  });\n\n  return cleanup;\n};\n"],"names":["makeObservable","createAtom","mobxComparer","runInAction","observable","action","newData","typeGuard","$mobx","property","onBecomeObserved","onBecomeUnobserved"],"mappings":"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"}
+{"version":3,"file":"mobx.cjs","names":[],"sources":["../src/mobx/apply-observable.ts","../src/mobx/create-enhanced-atom.ts","../src/mobx/create-ref.ts","../src/mobx/deep-observable-struct.ts","../src/mobx/get-mobx-administration.ts","../src/mobx/lazy-observe.ts"],"sourcesContent":["import { type AnnotationMapEntry, makeObservable } from 'mobx';\nimport type { AnyObject } from 'yummies/types';\n\nexport type ObservableAnnotationsArray<T extends AnyObject = AnyObject> = [\n  AnnotationMapEntry,\n  ...(keyof T | (string & {}))[],\n][];\n\n/**\n * Applies a compact list of MobX annotations to an object using either\n * decorator-style invocation or the annotation map form accepted by `makeObservable`.\n *\n * @template T Target object type.\n * @param context Object that should become observable.\n * @param annotationsArray Tuples of annotation followed by annotated field names.\n * @param useDecorators Enables decorator-style application before calling `makeObservable`.\n *\n * @example\n * ```ts\n * applyObservable(store, [[observable, 'items'], [action, 'setItems']]);\n * ```\n *\n * @example\n * ```ts\n * applyObservable(viewModel, [[computed, 'fullName']], true);\n * ```\n */\nexport const applyObservable = <T extends AnyObject>(\n  context: T,\n  annotationsArray: ObservableAnnotationsArray<T>,\n  useDecorators?: boolean,\n) => {\n  if (useDecorators) {\n    annotationsArray.forEach(([annotation, ...fields]) => {\n      fields.forEach((field) => {\n        // @ts-expect-error\n        annotation(context, field);\n      });\n    });\n\n    makeObservable(context);\n  } else {\n    const annotationsObject: AnyObject = {};\n\n    annotationsArray.forEach(([annotation, ...fields]) => {\n      fields.forEach((field) => {\n        annotationsObject[field] = annotation;\n      });\n    });\n\n    makeObservable(context, annotationsObject);\n  }\n};\n","import { createAtom, type IAtom } from 'mobx';\nimport type { AnyObject } from 'yummies/types';\n\nexport interface IEnhancedAtom<TMeta extends AnyObject = AnyObject>\n  extends IAtom {\n  meta: TMeta;\n}\n\n/**\n * Creates a MobX atom extended with metadata and bound reporting methods.\n *\n * @template TMeta Metadata object stored on the atom.\n * @param name Atom name used by MobX for debugging.\n * @param onBecomeObservedHandler Callback fired when the atom becomes observed.\n * @param onBecomeUnobservedHandler Callback fired when the atom is no longer observed.\n * @param meta Optional metadata attached to the atom.\n * @returns Atom instance with `meta`, `reportChanged` and `reportObserved`.\n *\n * @example\n * ```ts\n * const atom = createEnhancedAtom('user-status');\n * atom.reportChanged();\n * ```\n *\n * @example\n * ```ts\n * const atom = createEnhancedAtom('cache', undefined, undefined, { scope: 'users' });\n * atom.meta.scope;\n * ```\n */\nexport const createEnhancedAtom = <TMeta extends AnyObject>(\n  name: string,\n  onBecomeObservedHandler?: (atom: IEnhancedAtom<TMeta>) => void,\n  onBecomeUnobservedHandler?: (atom: IEnhancedAtom<TMeta>) => void,\n  meta?: TMeta,\n): IEnhancedAtom<TMeta> => {\n  const atom = createAtom(\n    name,\n    onBecomeObservedHandler && (() => onBecomeObservedHandler(atom)),\n    onBecomeUnobservedHandler && (() => onBecomeUnobservedHandler(atom)),\n  ) as IEnhancedAtom<TMeta>;\n  atom.meta = meta ?? ({} as TMeta);\n  atom.reportChanged = atom.reportChanged.bind(atom);\n  atom.reportObserved = atom.reportObserved.bind(atom);\n  return atom;\n};\n","import {\n  type IEqualsComparer,\n  makeObservable,\n  comparer as mobxComparer,\n  observable,\n  runInAction,\n} from 'mobx';\nimport type { AnyObject, Maybe } from 'yummies/types';\n\n/**\n * You can return `false` if you don't want to change the value in this ref\n */\nexport type RefChangeListener<T> = (\n  value: T | null,\n  prevValue: T | undefined,\n) => void | false;\n\n/**\n * Alternative to React.createRef but works in MobX world.\n * Typically it the should be the same React.LegacyRef (fn style)\n */\nexport interface Ref<T = any, TMeta = AnyObject> {\n  /**\n   * Setter function\n   */\n  (value: Maybe<T>): void;\n\n  set(value: Maybe<T>): void;\n  listeners: Set<RefChangeListener<NoInfer<T>>>;\n  current: NoInfer<T> | null;\n  meta: TMeta;\n}\n\nexport interface CreateRefConfig<T = any, TMeta = AnyObject> {\n  onSet?: (node: T, prevValue: T | undefined) => void;\n  onUnset?: (lastValue: T | undefined) => void;\n  onChange?: RefChangeListener<T>;\n  meta?: TMeta;\n  initial?: Maybe<T>;\n  comparer?: IEqualsComparer<T | null>;\n}\n\n/**\n * Creates a MobX-aware ref that behaves like a callback ref and exposes\n * observable `current` and `meta` fields.\n *\n * @template T Referenced value type.\n * @template TMeta Additional observable metadata stored on the ref.\n * @param cfg Optional callbacks, initial value and comparer configuration.\n * @returns Observable ref function object.\n *\n * @example\n * ```ts\n * const inputRef = createRef<HTMLInputElement>();\n * inputRef.set(document.createElement('input'));\n * ```\n *\n * @example\n * ```ts\n * const ref = createRef<number>();\n * ref(3);\n * ref.current; // 3\n * ```\n *\n * @example\n * ```ts\n * const nodeRef = createRef({\n *   onUnset: () => console.log('detached'),\n *   meta: { mounted: false },\n * });\n * ```\n */\nexport const createRef = <T = any, TMeta = AnyObject>(\n  cfg?: CreateRefConfig<T, TMeta>,\n): Ref<T, TMeta> => {\n  let lastValue: T | undefined;\n  const comparer = cfg?.comparer ?? mobxComparer.default;\n\n  const setValue: Ref<T, TMeta>['set'] = (value) => {\n    const nextValue = value ?? null;\n\n    if (comparer(ref.current, nextValue)) {\n      return;\n    }\n\n    runInAction(() => {\n      const prevLastValue = lastValue;\n      lastValue = ref.current ?? undefined;\n      ref.current = nextValue;\n\n      let isNextValueIgnored = false;\n\n      ref.listeners.forEach((listener) => {\n        const listenerResult = listener(ref.current, lastValue);\n\n        if (listenerResult === false) {\n          isNextValueIgnored = true;\n        }\n      });\n\n      if (isNextValueIgnored) {\n        lastValue = prevLastValue;\n        ref.current = lastValue ?? null;\n      } else if (ref.current === null && lastValue !== undefined) {\n        lastValue = undefined;\n      }\n    });\n  };\n\n  const ref = setValue as Ref<T, TMeta>;\n\n  ref.set = setValue;\n\n  ref.listeners = new Set(cfg?.onChange ? [cfg.onChange] : []);\n\n  if (cfg?.onSet || cfg?.onUnset) {\n    ref.listeners.add((value, prevValue) => {\n      if (value) {\n        cfg.onSet?.(value, prevValue);\n      } else {\n        cfg.onUnset?.(prevValue);\n      }\n    });\n  }\n\n  ref.current = cfg?.initial ?? null;\n  ref.meta = cfg?.meta ?? ({} as TMeta);\n\n  makeObservable(ref, {\n    current: observable.ref,\n    meta: observable,\n  });\n\n  return ref;\n};\n\n/**\n * Checks whether the provided value is a ref created by `createRef`.\n *\n * @template T Referenced value type.\n * @template TMeta Ref metadata type.\n * @param value Value to inspect.\n * @returns `true` when the value is a ref-like function with `current`.\n *\n * @example\n * ```ts\n * const ref = createRef<number>();\n * isRef(ref); // true\n * ```\n *\n * @example\n * ```ts\n * isRef({ current: 1 }); // false\n * ```\n */\nexport const isRef = <T, TMeta = any>(\n  value: T | Ref<T, TMeta>,\n): value is Ref<T, TMeta> => {\n  return typeof value === 'function' && 'current' in value;\n};\n\n/**\n * Normalizes a plain value or an existing ref into a `Ref` instance.\n *\n * @template T Referenced value type.\n * @template TMeta Ref metadata type.\n * @param value Existing ref or initial plain value.\n * @param cfg Optional ref configuration applied when a new ref is created.\n * @returns Existing ref or a newly created ref initialized with `value`.\n *\n * @example\n * ```ts\n * const ref = toRef(document.body);\n * ref.current === document.body;\n * ```\n *\n * @example\n * ```ts\n * const existingRef = createRef<number>();\n * const sameRef = toRef(existingRef);\n * ```\n */\nexport const toRef = <T, TMeta = any>(\n  value: T | Ref<T, TMeta>,\n  cfg?: Omit<CreateRefConfig<T, TMeta>, 'initial'>,\n): Ref<T, TMeta> => {\n  return isRef(value) ? value : createRef({ initial: value, ...cfg });\n};\n","import { action, makeObservable, observable } from 'mobx';\nimport { typeGuard } from 'yummies/type-guard';\nimport type { AnyObject } from 'yummies/types';\n\n/**\n * Wraps a plain object into a deeply observable structure and allows\n * patch-like updates while preserving nested observable references where possible.\n *\n * @template TData Observable object shape.\n *\n * @example\n * ```ts\n * const state = new DeepObservableStruct({ user: { name: 'Ann' } });\n * state.set({ user: { name: 'Bob' } });\n * ```\n *\n * @example\n * ```ts\n * const state = new DeepObservableStruct({ filters: { active: true } });\n * state.set({ filters: { active: false, archived: true } });\n * ```\n */\nexport class DeepObservableStruct<TData extends AnyObject> {\n  data: TData;\n\n  constructor(data: TData) {\n    this.data = data;\n\n    makeObservable(this, {\n      data: observable.deep,\n      set: action,\n    });\n  }\n\n  set(newData: Partial<TData>) {\n    type StackItem = [key: string, currObservable: AnyObject, new: AnyObject];\n\n    const stack: StackItem[] = Object.keys(this.data).map((key) => [\n      key,\n      this.data,\n      newData,\n    ]);\n\n    let currentIndex = 0;\n    let stackLength = stack.length;\n\n    while (currentIndex < stackLength) {\n      const [key, currObservableData, newData] = stack[currentIndex];\n      const newValue = newData[key];\n      const currValue = currObservableData[key];\n\n      currentIndex++;\n\n      if (key in newData) {\n        if (typeGuard.isObject(newValue) && typeGuard.isObject(currValue)) {\n          const newValueKeys = Object.keys(newValue);\n\n          Object.keys(currValue).forEach((childKey) => {\n            if (!(childKey in newValue)) {\n              delete currObservableData[key][childKey];\n            }\n          });\n\n          newValueKeys.forEach((childKey) => {\n            const length = stack.push([\n              childKey,\n              currObservableData[key],\n              newValue,\n            ]);\n            stackLength = length;\n          });\n        } else if (newValue !== currValue) {\n          currObservableData[key] = newValue;\n        }\n      } else {\n        delete currObservableData[key];\n      }\n    }\n\n    Object.keys(newData).forEach((newDataKey) => {\n      if (!this.data[newDataKey]) {\n        // @ts-expect-error\n        this.data[newDataKey] = newData[newDataKey];\n      }\n    });\n  }\n}\n","import { $mobx, type AnnotationMapEntry } from 'mobx';\nimport type { AnyObject } from 'yummies/types';\n\ntype ObservableObjectAdministration = Parameters<\n  Exclude<AnnotationMapEntry, boolean>['make_']\n>[0];\n\n/**\n * Returns the internal MobX administration object associated with an observable target.\n *\n * @param context Observable object instance.\n * @returns MobX administration internals stored under `$mobx`.\n *\n * @example\n * ```ts\n * const admin = getMobxAdministration(store);\n * admin.name_;\n * ```\n *\n * @example\n * ```ts\n * const values = getMobxAdministration(formState).values_;\n * ```\n */\nexport const getMobxAdministration = (\n  context: AnyObject,\n): ObservableObjectAdministration => context[$mobx];\n","import { onBecomeObserved, onBecomeUnobserved } from 'mobx';\n\n/**\n * Starts side effects only while one or more MobX observables are being observed.\n *\n * When the first property becomes observed, `onStart` is called. When all tracked\n * properties become unobserved, `onEnd` is called with the value returned by\n * `onStart`. Cleanup can be delayed via `endDelay`.\n *\n * It uses MobX `onBecomeObserved` and `onBecomeUnobserved` hooks to perform\n * lazy subscription management.\n *\n * @template TMetaData Data returned from `onStart` and forwarded to `onEnd`.\n * @param config Configuration for tracked properties and lifecycle callbacks.\n * @returns Cleanup function that clears the tracked state and runs `onEnd`.\n *\n * @example\n * ```ts\n * const stop = lazyObserve({\n *   context: store,\n *   property: 'items',\n *   onStart: () => api.subscribe(),\n *   onEnd: (subscription) => subscription.unsubscribe(),\n * });\n * ```\n *\n * @example\n * ```ts\n * lazyObserve({\n *   property: [boxA, boxB],\n *   onStart: () => console.log('observed'),\n *   endDelay: 300,\n * });\n * ```\n */\nexport const lazyObserve = <TMetaData = void>({\n  context,\n  property,\n  onStart,\n  onEnd,\n  endDelay = false,\n}: {\n  context?: any;\n  property: any | any[];\n  onStart?: () => TMetaData;\n  onEnd?: (metaData: TMetaData, cleanupFn: VoidFunction) => void;\n  endDelay?: number | false;\n}) => {\n  let timeoutId: ReturnType<typeof setTimeout> | undefined;\n  let metaData: TMetaData | undefined;\n  const observingProps = new Set<string>();\n  const properties = Array.isArray(property) ? property : [property];\n\n  const cleanup = () => {\n    observingProps.clear();\n\n    if (endDelay === false) {\n      onEnd?.(metaData!, cleanup);\n      metaData = undefined;\n      return;\n    }\n\n    if (timeoutId) {\n      clearTimeout(timeoutId);\n      timeoutId = undefined;\n    }\n\n    timeoutId = setTimeout(() => {\n      onEnd?.(metaData!, cleanup);\n      timeoutId = undefined;\n      metaData = undefined;\n    }, endDelay);\n  };\n\n  const start = (property: string) => {\n    const isAlreadyObserving = observingProps.size > 0;\n    observingProps.add(property);\n\n    if (isAlreadyObserving) {\n      return;\n    }\n\n    if (timeoutId) {\n      clearTimeout(timeoutId);\n      timeoutId = undefined;\n    }\n\n    metaData = onStart?.();\n  };\n\n  const stop = (property: string) => {\n    const isAlreadyNotObserving = !observingProps.size;\n\n    observingProps.delete(property);\n\n    const isObserving = observingProps.size > 0;\n\n    if (isAlreadyNotObserving || isObserving) {\n      return;\n    }\n\n    cleanup();\n  };\n\n  properties.forEach((property) => {\n    if (context) {\n      onBecomeObserved(context, property, () => start(property));\n      onBecomeUnobserved(context, property, () => stop(property));\n    } else {\n      onBecomeObserved(property, () => start(property));\n      onBecomeUnobserved(property, () => stop(property));\n    }\n  });\n\n  return cleanup;\n};\n"],"mappings":"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"}

package/mobx.d.ts

@@ -96,6 +96,13 @@ interface CreateRefConfig<T = any, TMeta = AnyObject> {
  *
  * @example
  * ```ts
+ * const ref = createRef<number>();
+ * ref(3);
+ * ref.current; // 3
+ * ```
+ *
+ * @example
+ * ```ts
  * const nodeRef = createRef({
  *   onUnset: () => console.log('detached'),
  *   meta: { mounted: false },