std-react-bindings 0.0.1

package/lib/mjs/utility-hooks/use-callback-ref.js

@@ -0,0 +1,11 @@
+import React, { useRef } from 'react';
+const noDeps = Object.freeze([]);
+/** Creates a wrapper function that can be updated on each render without updating the resulting function */
+export const useCallbackRef = (func) => {
+    const latest = useRef(func);
+    latest.current = func;
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    const caller = React.useCallback((...args) => latest.current(...args), noDeps);
+    return caller;
+};
+//# sourceMappingURL=use-callback-ref.js.map

package/lib/mjs/utility-hooks/use-callback-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-callback-ref.js","sourceRoot":"","sources":["../../../src/utility-hooks/use-callback-ref.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEtC,MAAM,MAAM,GAAmB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEjD,4GAA4G;AAC5G,MAAM,CAAC,MAAM,cAAc,GAAG,CAA+B,IAAiC,EAAE,EAAE;IAChG,MAAM,MAAM,GAAG,MAAM,CAA8B,IAAI,CAAC,CAAC;IACzD,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAEtB,uDAAuD;IACvD,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,IAAW,EAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IAE/F,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/lib/mjs/utility-hooks/use-stable-value.js

@@ -0,0 +1,14 @@
+import { useRef } from 'react';
+import { areEqual } from '../config/are-equal';
+/**
+ * Remembers the specified value across renders and compares it against a stored value, which is returned.  The stored value is only updated
+ * if the specified value really changes, using `areEqual` to compare.
+ */
+export const useStableValue = (instableValue) => {
+    const stableValue = useRef(instableValue);
+    if (!areEqual(instableValue, stableValue.current)) {
+        stableValue.current = instableValue;
+    }
+    return stableValue.current;
+};
+//# sourceMappingURL=use-stable-value.js.map

package/lib/mjs/utility-hooks/use-stable-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-stable-value.js","sourceRoot":"","sources":["../../../src/utility-hooks/use-stable-value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAI,aAAgB,EAAE,EAAE;IACpD,MAAM,WAAW,GAAG,MAAM,CAAI,aAAa,CAAC,CAAC;IAE7C,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE;QACjD,WAAW,CAAC,OAAO,GAAG,aAAa,CAAC;KACrC;IAED,OAAO,WAAW,CAAC,OAAO,CAAC;AAC7B,CAAC,CAAC"}

package/lib/resolveable/exports.d.ts

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

package/lib/resolveable/exports.d.ts.map

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

package/lib/resolveable/types.d.ts

@@ -0,0 +1,10 @@
+import type { ReadonlyBinding } from '../binding/types/readonly-binding';
+/** Either an immediate value or a value that can be retrieved by calling a function */
+export type TypeOrDeferredType<T> = T | (() => T);
+/** Either an immediate value or a value that can be retrieved by calling a function with args */
+export type TypeOrDeferredTypeWithArgs<T, ArgsT extends any[]> = T | ((...args: ArgsT) => T);
+/** Either an immediate value or a binding that stores a value */
+export type TypeOrBindingType<T> = T | ReadonlyBinding<T>;
+/** Either an immediate value or a value that can be retrieved by calling a function or a binding that stores a value */
+export type TypeOrDeferredTypeOrBindingType<T> = T | (() => T) | ReadonlyBinding<T>;
+//# sourceMappingURL=types.d.ts.map

package/lib/resolveable/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/resolveable/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEzE,uFAAuF;AACvF,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAElD,iGAAiG;AACjG,MAAM,MAAM,0BAA0B,CAAC,CAAC,EAAE,KAAK,SAAS,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC;AAE7F,iEAAiE;AACjE,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;AAE1D,wHAAwH;AACxH,MAAM,MAAM,+BAA+B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC"}

package/lib/resolveable/utils.d.ts

@@ -0,0 +1,10 @@
+import type { TypeOrBindingType, TypeOrDeferredType, TypeOrDeferredTypeOrBindingType, TypeOrDeferredTypeWithArgs } from './types';
+/** Resolves the value out of a TypeOrBindingType */
+export declare const resolveTypeOrBindingType: <T>(value: TypeOrBindingType<T>) => T;
+/** Resolves the value out of a TypeOrDeferredType */
+export declare const resolveTypeOrDeferredType: <T>(value: TypeOrDeferredType<T>) => T;
+/** Resolves the value out of a TypeOrDeferredTypeOrBindingType */
+export declare const resolveTypeOrDeferredTypeOrBindingType: <T>(value: TypeOrDeferredTypeOrBindingType<T>) => T;
+/** Resolves the value out of a TypeOrDeferredType */
+export declare const resolveTypeOrDeferredTypeWithArgs: <T, ArgsT extends any[]>(value: TypeOrDeferredTypeWithArgs<T, ArgsT>, args: ArgsT) => T;
+//# sourceMappingURL=utils.d.ts.map

package/lib/resolveable/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/resolveable/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,+BAA+B,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAElI,oDAAoD;AACpD,eAAO,MAAM,wBAAwB,uCAA+E,CAAC;AAErH,qDAAqD;AACrD,eAAO,MAAM,yBAAyB,wCAC6B,CAAC;AAEpE,kEAAkE;AAClE,eAAO,MAAM,sCAAsC,qDACiD,CAAC;AAErG,qDAAqD;AACrD,eAAO,MAAM,iCAAiC,yFAC0C,CAAC"}

package/lib/specialized-bindings/const-binding.d.ts

@@ -0,0 +1,10 @@
+import type { ReadonlyBinding } from '../binding/types/readonly-binding';
+export interface ConstBindingArgs {
+    /** A technical, but human-readable ID, which isn't guaranteed to be unique */
+    id: string;
+}
+/** Makes a const binding without using any React contexts. */
+export declare const makeConstBinding: <GetT>(value: GetT, { id }: ConstBindingArgs) => ReadonlyBinding<GetT>;
+/** Use for cases where a binding is required in an interface but the underlying value is constant with respect to a single render */
+export declare const useConstBinding: <GetT>(value: GetT, { id }: ConstBindingArgs) => ReadonlyBinding<GetT>;
+//# sourceMappingURL=const-binding.d.ts.map

package/lib/specialized-bindings/const-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"const-binding.d.ts","sourceRoot":"","sources":["../../src/specialized-bindings/const-binding.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAGzE,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB,8BAA+B,gBAAgB,0BAA4D,CAAC;AAEzI,qIAAqI;AACrI,eAAO,MAAM,eAAe,8BAA+B,gBAAgB,0BAK1E,CAAC"}

package/lib/specialized-bindings/derived-binding/exports.d.ts

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

package/lib/specialized-bindings/derived-binding/exports.d.ts.map

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

package/lib/specialized-bindings/derived-binding/options.d.ts

@@ -0,0 +1,52 @@
+import type { DependencyList } from 'react';
+import type { LimiterOptions } from '../../limiter/types/LimiterOptions';
+export interface DerivedBindingOptions<GetT> extends LimiterOptions {
+    /** A technical, but human-readable ID, which isn't guaranteed to be unique */
+    id: string;
+    /**
+     * On a rerender, deps changes are treated like bindings changes.  That is, if they change between renders, the input change detection
+     * logic is run (using the `areInputValuesEqual`, `detectInputChanges`, and `makeComparableInputValue` values) using the limiter (see
+     * `LimiterOptions`).
+     */
+    deps?: DependencyList;
+    /**
+     * If specified, overrides the function used to compare input values
+     *
+     * @defaultValue `_.isEqual`, which can be globally overridden using `setAreEqual`
+     */
+    areInputValuesEqual?: (a: any, b: any) => boolean;
+    /**
+     * - If `true` – `areInputValuesEqual` is used to compare the old and new results of `makeComparableInputValue` when any of the input
+     * bindings or `deps` are changed.  If the values are equal, the transformer won't be run.  If they're unequal, the transformer will be
+     * run.
+     * - If `false` – old and new values aren't compared, the transformer will always be run.
+     *
+     * @defaultValue `true`
+     */
+    detectInputChanges?: boolean;
+    /**
+     * By default, when `detectInputChanges` is `true`, the input is compared using all specified bindings.  This behavior can be overridden
+     * by providing this function to generate a value that can be compared instead.  The generated value will be remembered until the next
+     * comparison is needed.  Comparisons are performed using `areInputValuesEqual`
+     *
+     * @defaultValue A function that returns the values of all input bindings and the deps
+     */
+    makeComparableInputValue?: () => any;
+    /**
+     * If specified, overrides the function used to compare output values
+     *
+     * @defaultValue `_.isEqual`, which can be globally overridden using `setAreEqual`
+     */
+    areOutputValuesEqual?: (a: GetT, b: GetT) => boolean;
+    /**
+     * - If `true` – `areOutputValuesEqual` is used to compare the old and new results of the transformer function, each time it's run.  If the
+     * values are equal, the derived binding's value won't be changed.  If they're unequal, the binding value will be changed and listeners
+     * will be notified.
+     * - If `false` – old and new results of the transformer function aren't compared.  The derived binding's value will always be changed each
+     * time the transformer function is run.
+     *
+     * @defaultValue `true`
+     */
+    detectOutputChanges?: boolean;
+}
+//# sourceMappingURL=options.d.ts.map

package/lib/specialized-bindings/derived-binding/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/specialized-bindings/derived-binding/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,WAAW,qBAAqB,CAAC,IAAI,CAAE,SAAQ,cAAc;IACjE,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;IAEX;;;;OAIG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC;IAClD;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;;OAMG;IACH,wBAAwB,CAAC,EAAE,MAAM,GAAG,CAAC;IAErC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,KAAK,OAAO,CAAC;IACrD;;;;;;;;OAQG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B"}

package/lib/specialized-bindings/derived-binding/use-derived-binding.d.ts

@@ -0,0 +1,16 @@
+import type { BindingDependencies } from '../../binding/types/binding-dependencies';
+import type { InferBindingValueTypes } from '../../binding/types/infer-binding-value-types';
+import type { ReadonlyBinding } from '../../binding/types/readonly-binding';
+import type { DerivedBindingOptions } from './options';
+/**
+ * Called to compute the derived value on the initial render and anytime the dependencies change.
+ *
+ * @param bindingValues - The extracted values of the bindings.
+ * @param bindings - The original bindings
+ *
+ * @returns The derived value
+ */
+export type UseDerivedBindingTransformer<GetT, DependenciesT extends BindingDependencies> = (bindingValues: InferBindingValueTypes<DependenciesT>, bindings: DependenciesT) => GetT;
+/** A derived binding is a binding derived from zero or more other bindings */
+export declare const useDerivedBinding: <GetT, DependenciesT extends BindingDependencies>(bindings: DependenciesT | undefined, transformer: UseDerivedBindingTransformer<GetT, DependenciesT>, options: DerivedBindingOptions<GetT>) => ReadonlyBinding<GetT>;
+//# sourceMappingURL=use-derived-binding.d.ts.map

package/lib/specialized-bindings/derived-binding/use-derived-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-derived-binding.d.ts","sourceRoot":"","sources":["../../../src/specialized-bindings/derived-binding/use-derived-binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAA4B,MAAM,0CAA0C,CAAC;AAC9G,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AAC5F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAS5E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,MAAM,4BAA4B,CAAC,IAAI,EAAE,aAAa,SAAS,mBAAmB,IAAI,CAC1F,aAAa,EAAE,sBAAsB,CAAC,aAAa,CAAC,EACpD,QAAQ,EAAE,aAAa,KACpB,IAAI,CAAC;AAEV,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,uNAiD7B,CAAC"}

package/lib/specialized-bindings/exports.d.ts

@@ -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.d.ts.map

package/lib/specialized-bindings/exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.d.ts","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/specialized-bindings/flattened-binding.d.ts

@@ -0,0 +1,16 @@
+import type { BindingDependencies } from '../binding/types/binding-dependencies';
+import type { InferBindingValueTypes } from '../binding/types/infer-binding-value-types';
+import type { ReadonlyBinding } from '../binding/types/readonly-binding';
+import type { DerivedBindingOptions } from './derived-binding/options';
+/**
+ * Called to extract the second-level binding on the initial render and anytime the dependencies change.
+ *
+ * @param bindingValues - The extracted values of bindings.
+ * @param bindings - The original bindings.
+ *
+ * @returns The second-level binding (i.e. a binding determined dynamically by executing this function)
+ */
+export type UseFlattenedBindingTransformer<GetT, DependenciesT extends BindingDependencies> = (bindingValues: InferBindingValueTypes<DependenciesT>, bindings: DependenciesT) => ReadonlyBinding<GetT>;
+/** Use when a binding contains another binding, to listen to the second-level binding if either the first or second levels change */
+export declare const useFlattenedBinding: <GetT, DependenciesT extends BindingDependencies>(bindings: DependenciesT | undefined, transformer: UseFlattenedBindingTransformer<GetT, DependenciesT>, options: DerivedBindingOptions<GetT>) => ReadonlyBinding<GetT>;
+//# sourceMappingURL=flattened-binding.d.ts.map

package/lib/specialized-bindings/flattened-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flattened-binding.d.ts","sourceRoot":"","sources":["../../src/specialized-bindings/flattened-binding.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAA4B,MAAM,uCAAuC,CAAC;AAC3G,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AASzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE;;;;;;;GAOG;AACH,MAAM,MAAM,8BAA8B,CAAC,IAAI,EAAE,aAAa,SAAS,mBAAmB,IAAI,CAC5F,aAAa,EAAE,sBAAsB,CAAC,aAAa,CAAC,EACpD,QAAQ,EAAE,aAAa,KACpB,eAAe,CAAC,IAAI,CAAC,CAAC;AAE3B,qIAAqI;AACrI,eAAO,MAAM,mBAAmB,yNA0E/B,CAAC"}

package/lib/specialized-bindings/transient-derived-binding/exports.d.ts

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

package/lib/specialized-bindings/transient-derived-binding/exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.d.ts","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/specialized-bindings/transient-derived-binding/make-transient-derived-binding.d.ts

@@ -0,0 +1,12 @@
+import type { BindingDependencies } from '../../binding/types/binding-dependencies';
+import type { ReadonlyBinding } from '../../binding/types/readonly-binding';
+import type { UseDerivedBindingTransformer } from '../derived-binding/use-derived-binding';
+import type { MakeTransientDerivedBindingArgs } from './types/transient-derived-binding-args';
+/**
+ * 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 declare const makeTransientDerivedBinding: <GetT, DependenciesT extends BindingDependencies>(bindings: DependenciesT | undefined, transformer: UseDerivedBindingTransformer<GetT, DependenciesT>, { id }?: MakeTransientDerivedBindingArgs) => ReadonlyBinding<GetT>;
+//# sourceMappingURL=make-transient-derived-binding.d.ts.map

package/lib/specialized-bindings/transient-derived-binding/make-transient-derived-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-transient-derived-binding.d.ts","sourceRoot":"","sources":["../../../src/specialized-bindings/transient-derived-binding/make-transient-derived-binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA4B,mBAAmB,EAA4B,MAAM,0CAA0C,CAAC;AACxI,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAQ5E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAC3F,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,wCAAwC,CAAC;AAI9F;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,kKAG9B,+BAA+B,0BAuCxC,CAAC"}

package/lib/specialized-bindings/transient-derived-binding/types/exports.d.ts

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

package/lib/specialized-bindings/transient-derived-binding/types/exports.d.ts.map

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

package/lib/specialized-bindings/transient-derived-binding/types/transient-derived-binding-args.d.ts

@@ -0,0 +1,10 @@
+import type { DependencyList } from 'react';
+export interface MakeTransientDerivedBindingArgs {
+    /** A technical, but human-readable ID, which isn't guaranteed to be unique */
+    id?: string;
+}
+export interface UseTransientDerivedBindingArgs extends MakeTransientDerivedBindingArgs {
+    /** Hook dependencies */
+    deps?: DependencyList;
+}
+//# sourceMappingURL=transient-derived-binding-args.d.ts.map

package/lib/specialized-bindings/transient-derived-binding/types/transient-derived-binding-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transient-derived-binding-args.d.ts","sourceRoot":"","sources":["../../../../src/specialized-bindings/transient-derived-binding/types/transient-derived-binding-args.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C,MAAM,WAAW,+BAA+B;IAC9C,8EAA8E;IAC9E,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,8BAA+B,SAAQ,+BAA+B;IACrF,wBAAwB;IACxB,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB"}

package/lib/specialized-bindings/transient-derived-binding/use-transient-derived-binding.d.ts

@@ -0,0 +1,13 @@
+import type { BindingDependencies } from '../../binding/types/binding-dependencies';
+import type { ReadonlyBinding } from '../../binding/types/readonly-binding';
+import type { UseDerivedBindingTransformer } from '../derived-binding/use-derived-binding';
+import type { UseTransientDerivedBindingArgs } from './types/transient-derived-binding-args';
+/**
+ * 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 declare const useTransientDerivedBinding: <GetT, DependenciesT extends BindingDependencies>(bindings: DependenciesT | undefined, transformer: UseDerivedBindingTransformer<GetT, DependenciesT>, args?: UseTransientDerivedBindingArgs) => ReadonlyBinding<GetT>;
+//# sourceMappingURL=use-transient-derived-binding.d.ts.map

package/lib/specialized-bindings/transient-derived-binding/use-transient-derived-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-transient-derived-binding.d.ts","sourceRoot":"","sources":["../../../src/specialized-bindings/transient-derived-binding/use-transient-derived-binding.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAE3F,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAI7F;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,gKAG/B,8BAA8B,0BAGgF,CAAC"}

package/lib/synchronization/exports.d.ts

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

package/lib/synchronization/exports.d.ts.map

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

package/lib/synchronization/types/exports.d.ts

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

package/lib/synchronization/types/exports.d.ts.map

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

package/lib/synchronization/types/options.d.ts

@@ -0,0 +1,13 @@
+import type { DependencyList } from 'react';
+import type { LimiterOptions } from '../../limiter/types/LimiterOptions';
+export interface UseBindingSyncOptions extends LimiterOptions {
+    /** A technical but human-readable ID */
+    id?: string;
+    /**
+     * On a rerender, deps changes are treated like bindings changes.  That is, if they change between renders, the input change detection
+     * logic is run (using the `areInputValuesEqual`, `detectInputChanges`, and `makeComparableInputValue` values) using the limiter (see
+     * `LimiterOptions`).
+     */
+    deps?: DependencyList;
+}
+//# sourceMappingURL=options.d.ts.map

package/lib/synchronization/types/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/synchronization/types/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D,wCAAwC;IACxC,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;;;OAIG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB"}

package/lib/synchronization/use-bi-dir-binding-sync.d.ts

@@ -0,0 +1,10 @@
+import type { Binding } from '../binding/types/binding';
+import type { UseBindingSyncOptions } from './types/options';
+/**
+ * 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 declare const useBiDirBindingSync: <T>(a: Binding<T>, b: Binding<T>, options?: UseBindingSyncOptions) => void;
+//# sourceMappingURL=use-bi-dir-binding-sync.d.ts.map

package/lib/synchronization/use-bi-dir-binding-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-bi-dir-binding-sync.d.ts","sourceRoot":"","sources":["../../src/synchronization/use-bi-dir-binding-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7D;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,8CAA+C,qBAAqB,SAGnG,CAAC"}

package/lib/synchronization/use-uni-dir-binding-sync.d.ts

@@ -0,0 +1,6 @@
+import type { Binding } from '../binding/types/binding';
+import type { ReadonlyBinding } from '../binding/types/readonly-binding';
+import type { UseBindingSyncOptions } from './types/options';
+/** Synchronizes a source binding into a destination binding */
+export declare const useUniDirBindingSync: <T>(source: ReadonlyBinding<T>, dest: Binding<T>, options?: UseBindingSyncOptions) => void;
+//# sourceMappingURL=use-uni-dir-binding-sync.d.ts.map

package/lib/synchronization/use-uni-dir-binding-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-uni-dir-binding-sync.d.ts","sourceRoot":"","sources":["../../src/synchronization/use-uni-dir-binding-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7D,+DAA+D;AAC/D,eAAO,MAAM,oBAAoB,8DAA+D,qBAAqB,SAEpH,CAAC"}

package/lib/types/array-like.d.ts

@@ -0,0 +1,3 @@
+/** A single instance or an array of instances */
+export type SingleOrArray<T> = T | T[];
+//# sourceMappingURL=array-like.d.ts.map

package/lib/types/array-like.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-like.d.ts","sourceRoot":"","sources":["../../src/types/array-like.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC"}

package/lib/types/empty.d.ts

@@ -0,0 +1,3 @@
+/** An empty object */
+export type EmptyObject = Record<string, never>;
+//# sourceMappingURL=empty.d.ts.map

package/lib/types/empty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty.d.ts","sourceRoot":"","sources":["../../src/types/empty.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC"}

package/lib/types/exports.d.ts

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

package/lib/types/exports.d.ts.map

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

package/lib/use-binding-effect/exports.d.ts

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

package/lib/use-binding-effect/exports.d.ts.map

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

package/lib/use-binding-effect/types/exports.d.ts

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

package/lib/use-binding-effect/types/exports.d.ts.map

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

package/lib/use-binding-effect/types/options.d.ts

@@ -0,0 +1,46 @@
+import type { DependencyList } from 'react';
+import type { LimiterOptions } from '../../limiter/types/LimiterOptions';
+export interface UseBindingEffectOptions extends LimiterOptions {
+    /** A technical but human-readable ID */
+    id?: string;
+    /**
+     * On a rerender, deps changes are treated like bindings changes.  That is, if they change between renders, the input change detection
+     * logic is run (using the `areInputValuesEqual`, `detectInputChanges`, and `makeComparableInputValue` values) using the limiter (see
+     * `LimiterOptions`).
+     */
+    deps?: DependencyList;
+    /**
+     * If specified, overrides the function used to compare input values
+     *
+     * @defaultValue `_.isEqual`, which can be globally overridden using `setAreEqual`
+     */
+    areInputValuesEqual?: (a: any, b: any) => boolean;
+    /**
+     * - If `true` – `areInputValuesEqual` is used to compare the old and new results of `makeComparableInputValue` when any of the input
+     * bindings or `deps` are changed.  If the values are equal, the transformer won't be run.  If they're unequal, the transformer will be
+     * run.
+     * - If `false` – old and new values aren't compared, the transformer will always be run.
+     *
+     * @defaultValue `false`
+     */
+    detectInputChanges?: boolean;
+    /**
+     * By default, when `detectInputChanges` is true, the input is compared using all specified bindings.  This behavior can be overridden by
+     * providing this function to generate a value that can be compared instead.  This value will be remembered until the next comparison is
+     * needed.  Comparisons are performed using `areInputValuesEqual`
+     *
+     * @defaultValue A function that returns the values of all input bindings (including any additional bindings) and the deps
+     */
+    makeComparableInputValue?: () => any;
+    /**
+     * - If `true`, the callback is triggered every time this is mounted in addition to whenever the input bindings change.
+     * - If `false`, the callback is only triggered when the input bindings change.
+     * - If `'first'`, the callback is triggered on the first mount and whenever the input bindings change
+     * - If `'if-input-changed'`, the callback is triggered on mount if the bindings have changed since the last evaluation of the
+     * transformer
+     *
+     * @defaultValue `'if-input-changed'`
+     */
+    triggerOnMount?: boolean | 'first' | 'if-input-changed';
+}
+//# sourceMappingURL=options.d.ts.map

package/lib/use-binding-effect/types/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/use-binding-effect/types/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,WAAW,uBAAwB,SAAQ,cAAc;IAC7D,wCAAwC;IACxC,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;;;OAIG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC;IAClD;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;;OAMG;IACH,wBAAwB,CAAC,EAAE,MAAM,GAAG,CAAC;IAErC;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,kBAAkB,CAAC;CACzD"}

package/lib/use-binding-effect/use-binding-effect.d.ts

@@ -0,0 +1,21 @@
+import type { BindingDependencies } from '../binding/types/binding-dependencies';
+import type { InferBindingValueTypes } from '../binding/types/infer-binding-value-types';
+import type { UseBindingEffectOptions } from './types/options';
+/**
+ * Called when the associated bindings change, depending on the options provided to `useBindingEffect`.
+ *
+ * @param bindingValues - The extracted values of the associated named bindings.  If named bindings aren't used, this will be an empty
+ * object.
+ * @param bindings - The original named bindings if named bindings are used or an empty object otherwise.
+ */
+export type UseBindingEffectCallback<DependenciesT extends BindingDependencies> = (bindingValues: InferBindingValueTypes<DependenciesT>, bindings: DependenciesT) => void;
+/**
+ * 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 declare const useBindingEffect: <DependenciesT extends BindingDependencies>(bindings: DependenciesT | undefined, callback: UseBindingEffectCallback<DependenciesT>, options?: UseBindingEffectOptions) => (() => void);
+//# sourceMappingURL=use-binding-effect.d.ts.map

package/lib/use-binding-effect/use-binding-effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-binding-effect.d.ts","sourceRoot":"","sources":["../../src/use-binding-effect/use-binding-effect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA4B,mBAAmB,EAA4B,MAAM,uCAAuC,CAAC;AAErI,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAYzF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAI/D;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,CAAC,aAAa,SAAS,mBAAmB,IAAI,CAChF,aAAa,EAAE,sBAAsB,CAAC,aAAa,CAAC,EACpD,QAAQ,EAAE,aAAa,KACpB,IAAI,CAAC;AAEV;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,gJAGlB,uBAAuB,KAC/B,CAAC,MAAM,IAAI,CAqJb,CAAC"}

package/lib/utility-hooks/exports.d.ts

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

package/lib/utility-hooks/exports.d.ts.map

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

package/lib/utility-hooks/use-callback-ref.d.ts

@@ -0,0 +1,3 @@
+/** Creates a wrapper function that can be updated on each render without updating the resulting function */
+export declare const useCallbackRef: <ArgsT extends any[], ReturnT>(func: (...args: ArgsT) => ReturnT) => (...args: ArgsT) => ReturnT;
+//# sourceMappingURL=use-callback-ref.d.ts.map

package/lib/utility-hooks/use-callback-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-callback-ref.d.ts","sourceRoot":"","sources":["../../src/utility-hooks/use-callback-ref.ts"],"names":[],"mappings":"AAKA,4GAA4G;AAC5G,eAAO,MAAM,cAAc,kGAQ1B,CAAC"}

package/lib/utility-hooks/use-stable-value.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Remembers the specified value across renders and compares it against a stored value, which is returned.  The stored value is only updated
+ * if the specified value really changes, using `areEqual` to compare.
+ */
+export declare const useStableValue: <T>(instableValue: T) => T;
+//# sourceMappingURL=use-stable-value.d.ts.map

package/lib/utility-hooks/use-stable-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-stable-value.d.ts","sourceRoot":"","sources":["../../src/utility-hooks/use-stable-value.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,eAAO,MAAM,cAAc,4BAQ1B,CAAC"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "std-react-bindings",
+  "version": "0.0.1",
+  "description": "Data bindings for React",
+  "keywords": [
+    "bindings",
+    "observable",
+    "react",
+    "react-native",
+    "typescript"
+  ],
+  "main": "lib/cjs/index.js",
+  "module": "lib/mjs/index.js",
+  "types": "lib/index.d.ts",
+  "repository": "",
+  "homepage": "",
+  "license": "MIT",
+  "private": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.cjs.json && tsc -p tsconfig.mjs.json",
+    "build:dev": "trash dev-build && yarn build && mkdir dev-build && cp -r lib dev-build && cp package.json dev-build && (cd dev-build && echo 'package' `pwd`)",
+    "clean": "trash coverage dev-build docs lib",
+    "generate:docs": "npx typedoc src/index.ts --skipErrorChecking",
+    "lint": "eslint 'src/**/*.ts?(x)' --max-warnings 0",
+    "prepublishOnly": "yarn clean && yarn test && yarn clean && yarn build",
+    "test": "yarn test:check-circular-dependencies && yarn test:unit-tests",
+    "test:audit": "yarn audit --level moderate; [[ $? -ge 4 ]] && exit 1 || exit 0",
+    "test:check-circular-dependencies": "yarn build && npx madge --circular ./lib",
+    "test:unit-tests:": "NODE_OPTIONS=--experimental-vm-modules npx jest --runInBand --coverage",
+    "test:unit-tests": "yarn test:unit-tests: src"
+  },
+  "peerDependencies": {
+    "react": ">=16.9.0",
+    "react-dom": ">=16.9.0"
+  },
+  "dependencies": {
+    "std-client-run-queue": "0.0.1",
+    "is-promise": "^4.0.0",
+    "lodash": "^4.17.21"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^14.0.0",
+    "@types/jest": "^29.5.5",
+    "@types/lodash": "4.14.199",
+    "@types/react": "18.2.28",
+    "@types/react-dom": "18.2.13",
+    "@typescript-eslint/eslint-plugin": "^6.7.5",
+    "@typescript-eslint/parser": "^6.7.5",
+    "eslint": "8.51.0",
+    "eslint-config-prettier": "^9.0.0",
+    "eslint-import-resolver-typescript": "^3.6.1",
+    "eslint-plugin-import": "^2.28.1",
+    "eslint-plugin-prefer-arrow": "^1.2.3",
+    "eslint-plugin-prettier": "^5.0.0",
+    "eslint-plugin-react": "^7.33.2",
+    "eslint-plugin-react-hooks": "^4.6.0",
+    "eslint-plugin-simple-import-sort": "^10.0.0",
+    "eslint-plugin-tsdoc": "^0.2.17",
+    "jest": "29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "madge": "6.1.0",
+    "prettier": "3.0.3",
+    "react": "18.2.0",
+    "react-dom": "18.2.0",
+    "trash-cli": "5.0.0",
+    "ts-jest": "^29.1.1",
+    "typedoc": "^0.25.2",
+    "typescript": "5.2.2"
+  }
+}

package/src/__test_dependency__/index.ts

@@ -0,0 +1,4 @@
+/* istanbul ignore file */
+
+export * from './run-in-dom';
+export * from './sleep';