std-react-bindings 0.0.1

package/lib/mjs/make-bindable-component/make-bindable-component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-bindable-component.js","sourceRoot":"","sources":["../../../src/make-bindable-component/make-bindable-component.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAqBhE,MAAM,UAAU,qBAAqB,CACnC,4BAAmH,EACnH,sBAAuD;IAEvD,MAAM,EAAE,QAAQ,EAAE,qBAAqB,EAAE,GACvC,OAAO,4BAA4B,KAAK,UAAU;QAChD,CAAC,CAAC,CAAC,EAA+D,CAAC;QACnE,CAAC,CAAC,4BAA4B,CAAC;IACnC,MAAM,mBAAmB,GAAG,CAAC,OAAO,4BAA4B,KAAK,UAAU,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,sBAAsB,CAAE,CAAC;IAE1I,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,CAAC,CAAC;IAE5C,OAAO,CAAC,KAAmD,EAAE,EAAE;QAC7D,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QACpD,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAC3B,oBAAC,gBAAgB,oBAAK,qBAAqB,IAAE,QAAQ,EAAE,QAAQ,KAC5D,GAAG,EAAE,CAAC,mBAAmB,CAAC,eAAe,CAAC,KAAK,EAAE,WAAW,CAAW,CAAC,CACxD,CACpB,CAAC,CAAC,CAAC,CACF,mBAAmB,CAAC,KAAe,CAAC,CACrC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED,UAAU;AAEV,MAAM,cAAc,GAAG,CAAC,GAAwB,EAAE,QAAqB,EAAE,EAAE;IACzE,MAAM,MAAM,GAAsB,EAAE,CAAC;IAErC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QAC9C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE;YAC1C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SACpB;KACF;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAqC,KAAa,EAAE,QAAqB,EAAU,EAAE,CAC3G,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;IACjD,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QACrB,mEAAmE;QACnE,GAAG,CAAC,GAAmB,CAAC,GAAG,KAAK,CAAC;QAEjC,OAAO,GAAG,CAAC;KACZ;IAED,mEAAmE;IACnE,GAAG,CAAC,GAAmB,CAAC,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAE3D,OAAO,GAAG,CAAC;AACb,CAAC,EAAE,EAAqB,CAAW,CAAC"}

package/lib/mjs/make-bindable-component/types/exports.js

@@ -0,0 +1,3 @@
+export * from './make-bindable-component-options';
+export * from './upgrade-to-binding-props';
+//# sourceMappingURL=exports.js.map

package/lib/mjs/make-bindable-component/types/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../../../../src/make-bindable-component/types/exports.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC"}

package/lib/mjs/make-bindable-component/types/make-bindable-component-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=make-bindable-component-options.js.map

package/lib/mjs/make-bindable-component/types/make-bindable-component-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-bindable-component-options.js","sourceRoot":"","sources":["../../../../src/make-bindable-component/types/make-bindable-component-options.ts"],"names":[],"mappings":""}

package/lib/mjs/make-bindable-component/types/upgrade-to-binding-props.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=upgrade-to-binding-props.js.map

package/lib/mjs/make-bindable-component/types/upgrade-to-binding-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-to-binding-props.js","sourceRoot":"","sources":["../../../../src/make-bindable-component/types/upgrade-to-binding-props.tsx"],"names":[],"mappings":""}

package/lib/mjs/resolveable/exports.js

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './utils';
+//# sourceMappingURL=exports.js.map

package/lib/mjs/resolveable/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../../../src/resolveable/exports.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/lib/mjs/resolveable/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/mjs/resolveable/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/resolveable/types.ts"],"names":[],"mappings":""}

package/lib/mjs/resolveable/utils.js

@@ -0,0 +1,10 @@
+import { isBinding } from '../binding-utils/type-utils';
+/** Resolves the value out of a TypeOrBindingType */
+export const resolveTypeOrBindingType = (value) => (isBinding(value) ? value.get() : value);
+/** Resolves the value out of a TypeOrDeferredType */
+export const resolveTypeOrDeferredType = (value) => typeof value === 'function' ? value() : value;
+/** Resolves the value out of a TypeOrDeferredTypeOrBindingType */
+export const resolveTypeOrDeferredTypeOrBindingType = (value) => isBinding(value) ? value.get() : typeof value === 'function' ? value() : value;
+/** Resolves the value out of a TypeOrDeferredType */
+export const resolveTypeOrDeferredTypeWithArgs = (value, args) => typeof value === 'function' ? value(...args) : value;
+//# sourceMappingURL=utils.js.map

package/lib/mjs/resolveable/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/resolveable/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAGxD,oDAAoD;AACpD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAI,KAA2B,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAErH,qDAAqD;AACrD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAI,KAA4B,EAAK,EAAE,CAC9E,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAE,KAAiB,EAAE,CAAC,CAAC,CAAE,KAAW,CAAC;AAEpE,kEAAkE;AAClE,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAI,KAAyC,EAAE,EAAE,CACrG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAE,KAAiB,EAAE,CAAC,CAAC,CAAE,KAAW,CAAC;AAErG,qDAAqD;AACrD,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAyB,KAA2C,EAAE,IAAW,EAAK,EAAE,CACvI,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAE,KAA+B,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAE,KAAW,CAAC"}

package/lib/mjs/specialized-bindings/const-binding.js

@@ -0,0 +1,11 @@
+import { makeBinding } from '../binding/make-binding';
+import { useBinding } from '../binding/use-binding';
+/** Makes a const binding without using any React contexts. */
+export const makeConstBinding = (value, { id }) => makeBinding(() => value, { id });
+/** Use for cases where a binding is required in an interface but the underlying value is constant with respect to a single render */
+export const useConstBinding = (value, { id }) => {
+    const internalBinding = useBinding(() => value, { id, detectChanges: true });
+    internalBinding.setRaw(value);
+    return internalBinding;
+};
+//# sourceMappingURL=const-binding.js.map

package/lib/mjs/specialized-bindings/const-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"const-binding.js","sourceRoot":"","sources":["../../../src/specialized-bindings/const-binding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAOpD,8DAA8D;AAC9D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAO,KAAW,EAAE,EAAE,EAAE,EAAoB,EAAyB,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAEzI,qIAAqI;AACrI,MAAM,CAAC,MAAM,eAAe,GAAG,CAAO,KAAW,EAAE,EAAE,EAAE,EAAoB,EAAyB,EAAE;IACpG,MAAM,eAAe,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE9B,OAAO,eAAe,CAAC;AACzB,CAAC,CAAC"}

package/lib/mjs/specialized-bindings/derived-binding/exports.js

@@ -0,0 +1,3 @@
+export * from './options';
+export * from './use-derived-binding';
+//# sourceMappingURL=exports.js.map

package/lib/mjs/specialized-bindings/derived-binding/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../../../../src/specialized-bindings/derived-binding/exports.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,uBAAuB,CAAC"}

package/lib/mjs/specialized-bindings/derived-binding/options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=options.js.map

package/lib/mjs/specialized-bindings/derived-binding/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../src/specialized-bindings/derived-binding/options.ts"],"names":[],"mappings":""}

package/lib/mjs/specialized-bindings/derived-binding/use-derived-binding.js

@@ -0,0 +1,40 @@
+import { useBinding } from '../../binding/use-binding';
+import { isBinding } from '../../binding-utils/type-utils';
+import { getStatsHandler } from '../../config/stats-handler';
+import { extractBindingDependencyValues } from '../../internal-utils/extract-binding-dependency-values';
+import { getTypedKeys } from '../../internal-utils/get-typed-keys';
+import { pickLimiterOptions } from '../../limiter/pick-limiter-options';
+import { useBindingEffect } from '../../use-binding-effect/use-binding-effect';
+import { useCallbackRef } from '../../utility-hooks/use-callback-ref';
+/** A derived binding is a binding derived from zero or more other bindings */
+export const useDerivedBinding = (bindings, transformer, options) => {
+    const { id, deps, areInputValuesEqual, detectInputChanges = true, makeComparableInputValue, areOutputValuesEqual, detectOutputChanges = true } = options;
+    const limiterOptions = pickLimiterOptions(options);
+    const isNonNamedBindings = Array.isArray(bindings) || isBinding(bindings);
+    const namedBindings = isNonNamedBindings ? undefined : bindings;
+    const namedBindingsKeys = namedBindings !== undefined ? getTypedKeys(namedBindings) : undefined;
+    // Doesn't need to be stable since Refreshable will always get rendered with the latest anyway
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+    const getDependencyValues = () => extractBindingDependencyValues({ bindings, namedBindingsKeys });
+    const measuredTransformer = useCallbackRef((dependencyValues = getDependencyValues()) => {
+        var _a, _b;
+        const startMSec = performance.now();
+        try {
+            return transformer(dependencyValues, bindings !== null && bindings !== void 0 ? bindings : undefined);
+        }
+        finally {
+            (_b = (_a = getStatsHandler()).trackDerivedBindingTransformerDidRun) === null || _b === void 0 ? void 0 : _b.call(_a, { id, durationMSec: performance.now() - startMSec });
+        }
+    });
+    const internalBinding = useBinding(() => measuredTransformer(), {
+        id,
+        areEqual: areOutputValuesEqual,
+        detectChanges: detectOutputChanges
+    });
+    useBindingEffect(bindings, (namedBindingValues) => internalBinding.set(measuredTransformer(namedBindingValues)), Object.assign({ deps,
+        areInputValuesEqual,
+        detectInputChanges,
+        makeComparableInputValue }, limiterOptions));
+    return internalBinding;
+};
+//# sourceMappingURL=use-derived-binding.js.map

package/lib/mjs/specialized-bindings/derived-binding/use-derived-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-derived-binding.js","sourceRoot":"","sources":["../../../../src/specialized-bindings/derived-binding/use-derived-binding.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,8BAA8B,EAAE,MAAM,wDAAwD,CAAC;AACxG,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAgBtE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,QAAmC,EACnC,WAA8D,EAC9D,OAAoC,EACb,EAAE;IACzB,MAAM,EACJ,EAAE,EACF,IAAI,EACJ,mBAAmB,EACnB,kBAAkB,GAAG,IAAI,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,GAAG,IAAI,EAC3B,GAAG,OAAO,CAAC;IAEZ,MAAM,cAAc,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAEnD,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC1E,MAAM,aAAa,GAAG,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,QAAqC,CAAC;IAC9F,MAAM,iBAAiB,GAAG,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEhG,8FAA8F;IAC9F,+DAA+D;IAC/D,MAAM,mBAAmB,GAAG,GAAG,EAAE,CAAC,8BAA8B,CAAgB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAEjH,MAAM,mBAAmB,GAAG,cAAc,CAAC,CAAC,mBAA0D,mBAAmB,EAAE,EAAE,EAAE;;QAC7H,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACpC,IAAI;YACF,OAAO,WAAW,CAAC,gBAAgB,EAAE,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAK,SAAkC,CAAC,CAAC;SACvF;gBAAS;YACR,MAAA,MAAA,eAAe,EAAE,EAAC,oCAAoC,mDAAG,EAAE,EAAE,EAAE,YAAY,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;SAC/G;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,mBAAmB,EAAE,EAAE;QAC9D,EAAE;QACF,QAAQ,EAAE,oBAAoB;QAC9B,aAAa,EAAE,mBAAmB;KACnC,CAAC,CAAC;IAEH,gBAAgB,CAAC,QAAQ,EAAE,CAAC,kBAAkB,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,CAAC,kBAC7G,IAAI;QACJ,mBAAmB;QACnB,kBAAkB;QAClB,wBAAwB,IACrB,cAAc,EACjB,CAAC;IAEH,OAAO,eAAe,CAAC;AACzB,CAAC,CAAC"}

package/lib/mjs/specialized-bindings/exports.js

@@ -0,0 +1,5 @@
+export * from './const-binding';
+export * from './derived-binding/exports';
+export * from './flattened-binding';
+export * from './transient-derived-binding/exports';
+//# sourceMappingURL=exports.js.map

package/lib/mjs/specialized-bindings/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../../../src/specialized-bindings/exports.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qCAAqC,CAAC"}

package/lib/mjs/specialized-bindings/flattened-binding.js

@@ -0,0 +1,55 @@
+import { useEffect, useRef } from 'react';
+import { useBinding } from '../binding/use-binding';
+import { isBinding } from '../binding-utils/type-utils';
+import { useIsMountedRef } from '../internal-hooks/use-is-mounted-ref';
+import { extractBindingDependencyValues } from '../internal-utils/extract-binding-dependency-values';
+import { getTypedKeys } from '../internal-utils/get-typed-keys';
+import { pickLimiterOptions } from '../limiter/pick-limiter-options';
+import { useBindingEffect } from '../use-binding-effect/use-binding-effect';
+import { useStableValue } from '../utility-hooks/use-stable-value';
+/** Use when a binding contains another binding, to listen to the second-level binding if either the first or second levels change */
+export const useFlattenedBinding = (bindings, transformer, options) => {
+    const { id, deps = [], areInputValuesEqual, detectInputChanges = true, makeComparableInputValue, areOutputValuesEqual, detectOutputChanges = true } = options;
+    const limiterOptions = pickLimiterOptions(options);
+    const isMounted = useIsMountedRef();
+    const isNonNamedBindings = Array.isArray(bindings) || isBinding(bindings);
+    const namedBindings = useStableValue(isNonNamedBindings ? undefined : bindings);
+    const namedBindingsKeys = namedBindings !== undefined ? getTypedKeys(namedBindings) : undefined;
+    // Doesn't need to be stable since Refreshable will always get rendered with the latest anyway
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+    const getDependencyValues = () => extractBindingDependencyValues({ bindings, namedBindingsKeys });
+    const internalBinding = useBinding(() => transformer(getDependencyValues(), bindings !== null && bindings !== void 0 ? bindings : undefined).get(), {
+        id,
+        areEqual: areOutputValuesEqual,
+        detectChanges: detectOutputChanges
+    });
+    const secondLevelBindingListenerRemover = useRef(undefined);
+    useBindingEffect(bindings, (dependencyValues) => {
+        var _a, _b;
+        (_a = secondLevelBindingListenerRemover.current) === null || _a === void 0 ? void 0 : _a.call(secondLevelBindingListenerRemover);
+        secondLevelBindingListenerRemover.current = undefined;
+        const secondLevelBinding = transformer(dependencyValues, bindings !== null && bindings !== void 0 ? bindings : undefined);
+        internalBinding.set(secondLevelBinding.get());
+        if ((_b = isMounted.current) !== null && _b !== void 0 ? _b : false) {
+            secondLevelBindingListenerRemover.current = secondLevelBinding.addChangeListener(() => {
+                internalBinding.set(secondLevelBinding.get());
+            });
+        }
+    }, Object.assign({ deps,
+        areInputValuesEqual,
+        detectInputChanges,
+        makeComparableInputValue, triggerOnMount: true }, limiterOptions));
+    useEffect(() => {
+        const secondLevelBinding = transformer(getDependencyValues(), bindings !== null && bindings !== void 0 ? bindings : undefined);
+        secondLevelBindingListenerRemover.current = secondLevelBinding.addChangeListener(() => {
+            internalBinding.set(secondLevelBinding.get());
+        });
+        return () => {
+            var _a;
+            (_a = secondLevelBindingListenerRemover.current) === null || _a === void 0 ? void 0 : _a.call(secondLevelBindingListenerRemover);
+            secondLevelBindingListenerRemover.current = undefined;
+        };
+    });
+    return internalBinding;
+};
+//# sourceMappingURL=flattened-binding.js.map

package/lib/mjs/specialized-bindings/flattened-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flattened-binding.js","sourceRoot":"","sources":["../../../src/specialized-bindings/flattened-binding.ts"],"names":[],"mappings":"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"}

package/lib/mjs/specialized-bindings/transient-derived-binding/exports.js

@@ -0,0 +1,4 @@
+export * from './make-transient-derived-binding';
+export * from './types/exports';
+export * from './use-transient-derived-binding';
+//# sourceMappingURL=exports.js.map

package/lib/mjs/specialized-bindings/transient-derived-binding/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../../../../src/specialized-bindings/transient-derived-binding/exports.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,iBAAiB,CAAC;AAChC,cAAc,iCAAiC,CAAC"}

package/lib/mjs/specialized-bindings/transient-derived-binding/make-transient-derived-binding.js

@@ -0,0 +1,49 @@
+import { isBinding } from '../../binding-utils/type-utils';
+import { getLogger } from '../../config/logging';
+import { normalizeAsArray } from '../../internal-utils/array-like';
+import { extractBindingDependencyValues } from '../../internal-utils/extract-binding-dependency-values';
+import { getTypedKeys } from '../../internal-utils/get-typed-keys';
+import { makeUID } from '../../internal-utils/uid';
+const emptyNamedBindings = Object.freeze({});
+/**
+ * Similar to `useDerivedBinding` except that this binding doesn't persist any values internally.  The derivative is computed each time the
+ * getter is accessed and listeners are immediately triggered any time any of the dependencies change.
+ *
+ * This is most useful for inline declarations of derivatives that would feel too-heavy to declare elsewhere.
+ */
+export const makeTransientDerivedBinding = (bindings, transformer, { id } = {}) => {
+    const isNonNamedBindings = Array.isArray(bindings) || isBinding(bindings);
+    const nonNamedBindings = isNonNamedBindings ? bindings : undefined;
+    const namedBindings = isNonNamedBindings ? undefined : bindings;
+    const namedBindingsKeys = namedBindings !== undefined ? getTypedKeys(namedBindings) : undefined;
+    const allBindings = isNonNamedBindings ? normalizeAsArray(nonNamedBindings) : Object.values(namedBindings !== null && namedBindings !== void 0 ? namedBindings : emptyNamedBindings);
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+    const getDependencyValues = () => extractBindingDependencyValues({ bindings, namedBindingsKeys });
+    const uid = makeUID();
+    return {
+        isBinding: true,
+        id: id !== null && id !== void 0 ? id : uid,
+        uid,
+        addChangeListener: (listener) => {
+            const removers = allBindings.map((b) => b === null || b === void 0 ? void 0 : b.addChangeListener(listener));
+            let alreadyRemoved = false;
+            return () => {
+                var _a, _b;
+                if (alreadyRemoved) {
+                    (_b = (_a = getLogger()).debug) === null || _b === void 0 ? void 0 : _b.call(_a, `A change listener for binding ${id !== null && id !== void 0 ? id : uid} was removed more than once`);
+                    return;
+                }
+                alreadyRemoved = true;
+                for (const remover of removers) {
+                    return remover === null || remover === void 0 ? void 0 : remover();
+                }
+            };
+        },
+        get: () => transformer(getDependencyValues(), bindings !== null && bindings !== void 0 ? bindings : undefined),
+        getChangeUid: () => allBindings.map((b) => { var _a; return (_a = b === null || b === void 0 ? void 0 : b.getChangeUid()) !== null && _a !== void 0 ? _a : ''; }).join('+'),
+        isModified: () => false,
+        isLocked: () => true,
+        lock: () => () => { }
+    };
+};
+//# sourceMappingURL=make-transient-derived-binding.js.map

package/lib/mjs/specialized-bindings/transient-derived-binding/make-transient-derived-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-transient-derived-binding.js","sourceRoot":"","sources":["../../../../src/specialized-bindings/transient-derived-binding/make-transient-derived-binding.ts"],"names":[],"mappings":"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"}

package/lib/mjs/specialized-bindings/transient-derived-binding/types/exports.js

@@ -0,0 +1,2 @@
+export * from './transient-derived-binding-args';
+//# sourceMappingURL=exports.js.map

package/lib/mjs/specialized-bindings/transient-derived-binding/types/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../../../../../src/specialized-bindings/transient-derived-binding/types/exports.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC"}

package/lib/mjs/specialized-bindings/transient-derived-binding/types/transient-derived-binding-args.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transient-derived-binding-args.js.map

package/lib/mjs/specialized-bindings/transient-derived-binding/types/transient-derived-binding-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transient-derived-binding-args.js","sourceRoot":"","sources":["../../../../../src/specialized-bindings/transient-derived-binding/types/transient-derived-binding-args.ts"],"names":[],"mappings":""}

package/lib/mjs/specialized-bindings/transient-derived-binding/use-transient-derived-binding.js

@@ -0,0 +1,14 @@
+import { useMemo } from 'react';
+import { makeTransientDerivedBinding } from './make-transient-derived-binding';
+const emptyDeps = Object.freeze([]);
+/**
+ * Similar to `useDerivedBinding` except that this binding doesn't persist any values internally.  The derivative is computed each time the
+ * getter is accessed and listeners are immediately triggered any time any of the dependencies change.
+ *
+ * This is most useful for cases where bindings need to have up to date values even when unmounted (though this still wont be proactively
+ * triggered when unmounted).
+ */
+export const useTransientDerivedBinding = (bindings, transformer, args = {}) => { var _a; 
+// eslint-disable-next-line react-hooks/exhaustive-deps
+return useMemo(() => makeTransientDerivedBinding(bindings, transformer, args), (_a = args.deps) !== null && _a !== void 0 ? _a : emptyDeps); };
+//# sourceMappingURL=use-transient-derived-binding.js.map

package/lib/mjs/specialized-bindings/transient-derived-binding/use-transient-derived-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-transient-derived-binding.js","sourceRoot":"","sources":["../../../../src/specialized-bindings/transient-derived-binding/use-transient-derived-binding.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAKhC,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAG/E,MAAM,SAAS,GAAmB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,QAAmC,EACnC,WAA8D,EAC9D,OAAuC,EAAE,EAClB,EAAE;AACzB,uDAAuD;AACvD,OAAA,OAAO,CAAC,GAAG,EAAE,CAAC,2BAA2B,CAAsB,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,MAAA,IAAI,CAAC,IAAI,mCAAI,SAAS,CAAC,CAAA,EAAA,CAAC"}

package/lib/mjs/synchronization/exports.js

@@ -0,0 +1,4 @@
+export * from './types/exports';
+export * from './use-bi-dir-binding-sync';
+export * from './use-uni-dir-binding-sync';
+//# sourceMappingURL=exports.js.map

package/lib/mjs/synchronization/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../../../src/synchronization/exports.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC"}

package/lib/mjs/synchronization/types/exports.js

@@ -0,0 +1,2 @@
+export * from './options';
+//# sourceMappingURL=exports.js.map

package/lib/mjs/synchronization/types/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../../../../src/synchronization/types/exports.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

package/lib/mjs/synchronization/types/options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=options.js.map

package/lib/mjs/synchronization/types/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../src/synchronization/types/options.ts"],"names":[],"mappings":""}

package/lib/mjs/synchronization/use-bi-dir-binding-sync.js

@@ -0,0 +1,12 @@
+import { useBindingEffect } from '../use-binding-effect/use-binding-effect';
+/**
+ * Synchronizes two bindings bidirectionally so that any change in one will also affect the other.
+ *
+ * It's the responsibility of the bindings themselves to make sure this doesn't result in an infinite update.  For example, the bindings
+ * could be configured to use `detectChanges: true`, so that trivial changes doesn't result in triggers.
+ */
+export const useBiDirBindingSync = (a, b, options) => {
+    useBindingEffect(a, (a) => b.set(a), Object.assign(Object.assign({}, options), { triggerOnMount: true }));
+    useBindingEffect(b, (b) => a.set(b), Object.assign(Object.assign({}, options), { triggerOnMount: true }));
+};
+//# sourceMappingURL=use-bi-dir-binding-sync.js.map

package/lib/mjs/synchronization/use-bi-dir-binding-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-bi-dir-binding-sync.js","sourceRoot":"","sources":["../../../src/synchronization/use-bi-dir-binding-sync.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAG5E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAI,CAAa,EAAE,CAAa,EAAE,OAA+B,EAAE,EAAE;IACtG,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,kCAAO,OAAO,KAAE,cAAc,EAAE,IAAI,IAAG,CAAC;IAC3E,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,kCAAO,OAAO,KAAE,cAAc,EAAE,IAAI,IAAG,CAAC;AAC7E,CAAC,CAAC"}

package/lib/mjs/synchronization/use-uni-dir-binding-sync.js

@@ -0,0 +1,6 @@
+import { useBindingEffect } from '../use-binding-effect/use-binding-effect';
+/** Synchronizes a source binding into a destination binding */
+export const useUniDirBindingSync = (source, dest, options) => {
+    useBindingEffect(source, (source) => dest.set(source), Object.assign(Object.assign({}, options), { triggerOnMount: true }));
+};
+//# sourceMappingURL=use-uni-dir-binding-sync.js.map

package/lib/mjs/synchronization/use-uni-dir-binding-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-uni-dir-binding-sync.js","sourceRoot":"","sources":["../../../src/synchronization/use-uni-dir-binding-sync.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAG5E,+DAA+D;AAC/D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAI,MAA0B,EAAE,IAAgB,EAAE,OAA+B,EAAE,EAAE;IACvH,gBAAgB,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,kCAAO,OAAO,KAAE,cAAc,EAAE,IAAI,IAAG,CAAC;AAC/F,CAAC,CAAC"}

package/lib/mjs/types/array-like.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=array-like.js.map

package/lib/mjs/types/array-like.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-like.js","sourceRoot":"","sources":["../../../src/types/array-like.ts"],"names":[],"mappings":""}

package/lib/mjs/types/empty.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=empty.js.map

package/lib/mjs/types/empty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty.js","sourceRoot":"","sources":["../../../src/types/empty.ts"],"names":[],"mappings":""}

package/lib/mjs/types/exports.js

@@ -0,0 +1,3 @@
+export * from './array-like';
+export * from './empty';
+//# sourceMappingURL=exports.js.map

package/lib/mjs/types/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../../../src/types/exports.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC"}

package/lib/mjs/use-binding-effect/exports.js

@@ -0,0 +1,3 @@
+export * from './types/exports';
+export * from './use-binding-effect';
+//# sourceMappingURL=exports.js.map

package/lib/mjs/use-binding-effect/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../../../src/use-binding-effect/exports.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC"}

package/lib/mjs/use-binding-effect/types/exports.js

@@ -0,0 +1,2 @@
+export * from './options';
+//# sourceMappingURL=exports.js.map

package/lib/mjs/use-binding-effect/types/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../../../../src/use-binding-effect/types/exports.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

package/lib/mjs/use-binding-effect/types/options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=options.js.map

package/lib/mjs/use-binding-effect/types/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../src/use-binding-effect/types/options.ts"],"names":[],"mappings":""}

package/lib/mjs/use-binding-effect/use-binding-effect.js

@@ -0,0 +1,141 @@
+import { useEffect, useRef } from 'react';
+import { isBinding } from '../binding-utils/type-utils';
+import { areEqual } from '../config/are-equal';
+import { normalizeAsArray } from '../internal-utils/array-like';
+import { extractBindingDependencyValues } from '../internal-utils/extract-binding-dependency-values';
+import { getTypedKeys } from '../internal-utils/get-typed-keys';
+import { pickLimiterOptions } from '../limiter/pick-limiter-options';
+import { useLimiter } from '../limiter/use-limiter';
+import { useCallbackRef } from '../utility-hooks/use-callback-ref';
+import { useStableValue } from '../utility-hooks/use-stable-value';
+const emptyDependencies = Object.freeze({});
+/**
+ * Calls the specified callback function any time any of the specified bindings are changed.
+ *
+ * Most of the time you should use this hook rather than addChangeListener.
+ *
+ * @returns a function that can be called anytime to cancel the most recent limited callback.  This is useful, for example, if the the
+ * callback would have triggered a re-render that we, by other means, know to be unnecessary.
+ */
+export const useBindingEffect = (bindings, callback, options = {}) => {
+    const { id, deps, areInputValuesEqual = areEqual, detectInputChanges = false, makeComparableInputValue, triggerOnMount = 'if-input-changed' } = options;
+    const limiterOptions = pickLimiterOptions(options);
+    const isNonNamedBindings = Array.isArray(bindings) || isBinding(bindings);
+    const nonNamedBindings = isNonNamedBindings ? bindings : undefined;
+    const namedBindings = isNonNamedBindings ? undefined : bindings;
+    const namedBindingsKeys = namedBindings !== undefined ? getTypedKeys(namedBindings) : undefined;
+    const stableAllBindings = useStableValue(isNonNamedBindings ? normalizeAsArray(nonNamedBindings) : Object.values(namedBindings !== null && namedBindings !== void 0 ? namedBindings : emptyDependencies));
+    // Doesn't need to be stable since always used in a callback ref
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+    const getDependencyValues = () => extractBindingDependencyValues({ bindings, namedBindingsKeys });
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+    const comparableInputValueMaker = makeComparableInputValue !== null && makeComparableInputValue !== void 0 ? makeComparableInputValue : getDependencyValues;
+    const lastComparableInputValue = useRef(detectInputChanges && (triggerOnMount === false || triggerOnMount === 'if-input-changed') ? comparableInputValueMaker() : undefined);
+    /** Only used when `detectInputChanges` is `false` and `triggerOnMount` is `'if-input-changed'` */
+    const lastChangeUids = useRef();
+    const limiter = useLimiter(Object.assign({ id: id !== null && id !== void 0 ? id : 'use-binding-effect', cancelOnUnmount: true }, limiterOptions));
+    const checkAndUpdateIfInputChanged = useCallbackRef(() => {
+        if (detectInputChanges) {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+            const nextComparableInputValue = comparableInputValueMaker();
+            if (areInputValuesEqual(lastComparableInputValue.current, nextComparableInputValue)) {
+                return false;
+            }
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+            lastComparableInputValue.current = nextComparableInputValue;
+            return true;
+        }
+        else if (triggerOnMount === 'if-input-changed') {
+            const newChangeUids = makeChangeUidsString(stableAllBindings);
+            if (newChangeUids === lastChangeUids.current) {
+                return false;
+            }
+            lastChangeUids.current = newChangeUids;
+            return true;
+        }
+        else {
+            return true;
+        }
+    });
+    const isFirstRender = useRef(true);
+    const needsTrigger = useRef(false);
+    const triggerCallback = useCallbackRef((needsInputChangeTrackingUpdate) => {
+        needsTrigger.current = false;
+        if (needsInputChangeTrackingUpdate) {
+            // We don't care about the result here -- just want to update the tracking
+            checkAndUpdateIfInputChanged();
+        }
+        callback(getDependencyValues(), bindings !== null && bindings !== void 0 ? bindings : emptyDependencies);
+    });
+    const performChecksAndTriggerCallbackIfNeeded = useCallbackRef(() => {
+        if (needsTrigger.current) {
+            triggerCallback(true);
+        }
+        else {
+            const didChange = checkAndUpdateIfInputChanged();
+            if (detectInputChanges && !didChange) {
+                return; // No change
+            }
+            triggerCallback(false);
+        }
+    });
+    if (isFirstRender.current) {
+        isFirstRender.current = false;
+        if (!detectInputChanges && triggerOnMount === 'if-input-changed') {
+            lastChangeUids.current = makeChangeUidsString(stableAllBindings);
+        }
+    }
+    useEffect(() => {
+        const addedBindingUids = new Set();
+        const removers = [];
+        for (const b of stableAllBindings) {
+            if (b !== undefined && !addedBindingUids.has(b.uid)) {
+                // Making sure we only listen for changes once per binding, even if the same binding is listed multiple times
+                addedBindingUids.add(b.uid);
+                removers.push(b.addChangeListener(() => limiter.limit(performChecksAndTriggerCallbackIfNeeded)));
+            }
+        }
+        return () => {
+            for (const remover of removers) {
+                remover();
+            }
+            removers.length = 0;
+        };
+    }, [limiter, performChecksAndTriggerCallbackIfNeeded, stableAllBindings]);
+    const isFirstMount = useRef(true);
+    useEffect(() => {
+        if (needsTrigger.current ||
+            triggerOnMount === true ||
+            (isFirstMount.current && triggerOnMount === 'first') ||
+            (triggerOnMount === 'if-input-changed' && checkAndUpdateIfInputChanged())) {
+            needsTrigger.current = true;
+            limiter.limit(() => triggerCallback(true));
+        }
+        isFirstMount.current = false;
+    });
+    // If the deps changed,
+    const lastDepsValue = useRef(deps);
+    if (!areEqual(lastDepsValue.current, deps)) {
+        lastDepsValue.current = deps;
+        needsTrigger.current = true;
+        limiter.limit(() => triggerCallback(true));
+    }
+    // If the upcoming callback is canceled, it's assumed we have already dealt with the input in a different way, so we need to update the
+    // tracking info to make sure we don't reprocess the same thing later
+    return () => {
+        limiter.cancel();
+        needsTrigger.current = false;
+        // We don't care about the result here -- just want to update the tracking
+        checkAndUpdateIfInputChanged();
+    };
+};
+// Helpers
+const makeChangeUidsString = (bindings) => {
+    var _a;
+    const array = [];
+    for (const b of bindings) {
+        array.push((_a = b === null || b === void 0 ? void 0 : b.getChangeUid()) !== null && _a !== void 0 ? _a : '');
+    }
+    return array.join(',');
+};
+//# sourceMappingURL=use-binding-effect.js.map

package/lib/mjs/use-binding-effect/use-binding-effect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-binding-effect.js","sourceRoot":"","sources":["../../../src/use-binding-effect/use-binding-effect.ts"],"names":[],"mappings":"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"}

package/lib/mjs/utility-hooks/exports.js

@@ -0,0 +1,3 @@
+export * from './use-callback-ref';
+export * from './use-stable-value';
+//# sourceMappingURL=exports.js.map

package/lib/mjs/utility-hooks/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../../../src/utility-hooks/exports.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}