@warp-drive/core 5.6.0-alpha.15 → 5.6.0-alpha.17

package/declarations/store/-private/record-arrays/native-proxy-type-fix.d.ts

@@ -1,116 +1,126 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/*
+We redefine Proxy because the native Proxy type treats the `target` and
+`receiver` as the same type incorrectly.
+
+We ported this from Typescript's own Proxy types on 3/10/2024.
+*/
 interface ProxyHandler<T extends object> {
-    /**
-     * A trap method for a function call.
-     * @param target The original callable object which is being proxied.
-     * @internal
-     */
-    apply?(target: T, thisArg: any, argArray: any[]): any;
-    /**
-     * A trap for the `new` operator.
-     * @param target The original object which is being proxied.
-     * @param newTarget The constructor that was originally called.
-     * @internal
-     */
-    construct?(target: T, argArray: any[], newTarget: Function): object;
-    /**
-     * A trap for `Object.defineProperty()`.
-     * @param target The original object which is being proxied.
-     * @return A `Boolean` indicating whether or not the property has been defined.
-     * @internal
-     */
-    defineProperty?(target: T, property: string | symbol, attributes: PropertyDescriptor): boolean;
-    /**
-     * A trap for the `delete` operator.
-     * @param target The original object which is being proxied.
-     * @param p The name or `Symbol` of the property to delete.
-     * @return A `Boolean` indicating whether or not the property was deleted.
-     * @internal
-     */
-    deleteProperty?(target: T, p: string | symbol): boolean;
-    /**
-     * A trap for getting a property value.
-     * @param target The original object which is being proxied.
-     * @param p The name or `Symbol` of the property to get.
-     * @param receiver The proxy or an object that inherits from the proxy.
-     * @internal
-     */
-    get?(target: T, p: string | symbol, receiver: any): any;
-    /**
-     * A trap for `Object.getOwnPropertyDescriptor()`.
-     * @param target The original object which is being proxied.
-     * @param p The name of the property whose description should be retrieved.
-     * @internal
-     */
-    getOwnPropertyDescriptor?(target: T, p: string | symbol): PropertyDescriptor | undefined;
-    /**
-     * A trap for the `[[GetPrototypeOf]]` internal method.
-     * @param target The original object which is being proxied.
-     * @internal
-     */
-    getPrototypeOf?(target: T): object | null;
-    /**
-     * A trap for the `in` operator.
-     * @param target The original object which is being proxied.
-     * @param p The name or `Symbol` of the property to check for existence.
-     * @internal
-     */
-    has?(target: T, p: string | symbol): boolean;
-    /**
-     * A trap for `Object.isExtensible()`.
-     * @param target The original object which is being proxied.
-     * @internal
-     */
-    isExtensible?(target: T): boolean;
-    /**
-     * A trap for `Reflect.ownKeys()`.
-     * @param target The original object which is being proxied.
-     * @internal
-     */
-    ownKeys?(target: T): ArrayLike<string | symbol>;
-    /**
-     * A trap for `Object.preventExtensions()`.
-     * @param target The original object which is being proxied.
-     * @internal
-     */
-    preventExtensions?(target: T): boolean;
-    /**
-     * A trap for setting a property value.
-     * @param target The original object which is being proxied.
-     * @param p The name or `Symbol` of the property to set.
-     * @param receiver The object to which the assignment was originally directed.
-     * @return A `Boolean` indicating whether or not the property was set.
-     * @internal
-     */
-    set?(target: T, p: string | symbol, newValue: any, receiver: any): boolean;
-    /**
-     * A trap for `Object.setPrototypeOf()`.
-     * @param target The original object which is being proxied.
-     * @param newPrototype The object's new prototype or `null`.
-     * @internal
-     */
-    setPrototypeOf?(target: T, v: object | null): boolean;
+	/**
+	* A trap method for a function call.
+	* @param target The original callable object which is being proxied.
+	* @internal
+	*/
+	apply?(target: T, thisArg: any, argArray: any[]): any;
+	/**
+	* A trap for the `new` operator.
+	* @param target The original object which is being proxied.
+	* @param newTarget The constructor that was originally called.
+	* @internal
+	*/
+	// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+	construct?(target: T, argArray: any[], newTarget: Function): object;
+	/**
+	* A trap for `Object.defineProperty()`.
+	* @param target The original object which is being proxied.
+	* @return A `Boolean` indicating whether or not the property has been defined.
+	* @internal
+	*/
+	defineProperty?(target: T, property: string | symbol, attributes: PropertyDescriptor): boolean;
+	/**
+	* A trap for the `delete` operator.
+	* @param target The original object which is being proxied.
+	* @param p The name or `Symbol` of the property to delete.
+	* @return A `Boolean` indicating whether or not the property was deleted.
+	* @internal
+	*/
+	deleteProperty?(target: T, p: string | symbol): boolean;
+	/**
+	* A trap for getting a property value.
+	* @param target The original object which is being proxied.
+	* @param p The name or `Symbol` of the property to get.
+	* @param receiver The proxy or an object that inherits from the proxy.
+	* @internal
+	*/
+	get?(target: T, p: string | symbol, receiver: any): any;
+	/**
+	* A trap for `Object.getOwnPropertyDescriptor()`.
+	* @param target The original object which is being proxied.
+	* @param p The name of the property whose description should be retrieved.
+	* @internal
+	*/
+	getOwnPropertyDescriptor?(target: T, p: string | symbol): PropertyDescriptor | undefined;
+	/**
+	* A trap for the `[[GetPrototypeOf]]` internal method.
+	* @param target The original object which is being proxied.
+	* @internal
+	*/
+	getPrototypeOf?(target: T): object | null;
+	/**
+	* A trap for the `in` operator.
+	* @param target The original object which is being proxied.
+	* @param p The name or `Symbol` of the property to check for existence.
+	* @internal
+	*/
+	has?(target: T, p: string | symbol): boolean;
+	/**
+	* A trap for `Object.isExtensible()`.
+	* @param target The original object which is being proxied.
+	* @internal
+	*/
+	isExtensible?(target: T): boolean;
+	/**
+	* A trap for `Reflect.ownKeys()`.
+	* @param target The original object which is being proxied.
+	* @internal
+	*/
+	ownKeys?(target: T): ArrayLike<string | symbol>;
+	/**
+	* A trap for `Object.preventExtensions()`.
+	* @param target The original object which is being proxied.
+	* @internal
+	*/
+	preventExtensions?(target: T): boolean;
+	/**
+	* A trap for setting a property value.
+	* @param target The original object which is being proxied.
+	* @param p The name or `Symbol` of the property to set.
+	* @param receiver The object to which the assignment was originally directed.
+	* @return A `Boolean` indicating whether or not the property was set.
+	* @internal
+	*/
+	set?(target: T, p: string | symbol, newValue: any, receiver: any): boolean;
+	/**
+	* A trap for `Object.setPrototypeOf()`.
+	* @param target The original object which is being proxied.
+	* @param newPrototype The object's new prototype or `null`.
+	* @internal
+	*/
+	setPrototypeOf?(target: T, v: object | null): boolean;
 }
 interface ProxyConstructor {
-    /**
-     * Creates a revocable Proxy object.
-     * @param target A target object to wrap with Proxy.
-     * @param handler An object whose properties define the behavior of Proxy when an operation is attempted on it.
-     * @internal
-     */
-    revocable<T extends object>(target: T, handler: ProxyHandler<T>): {
-        proxy: T;
-        revoke: () => void;
-    };
-    /**
-     * Creates a Proxy object. The Proxy object allows you to create an object that can be used in place of the
-     * original object, but which may redefine fundamental Object operations like getting, setting, and defining
-     * properties. Proxy objects are commonly used to log property accesses, validate, format, or sanitize inputs.
-     * @param target A target object to wrap with Proxy.
-     * @param handler An object whose properties define the behavior of Proxy when an operation is attempted on it.
-     * @internal
-     */
-    new <TSource extends object, TTarget extends object>(target: TSource, handler: ProxyHandler<TSource>): TTarget;
+	/**
+	* Creates a revocable Proxy object.
+	* @param target A target object to wrap with Proxy.
+	* @param handler An object whose properties define the behavior of Proxy when an operation is attempted on it.
+	* @internal
+	*/
+	revocable<T extends object>(target: T, handler: ProxyHandler<T>): {
+		proxy: T;
+		revoke: () => void;
+	};
+	/**
+	* Creates a Proxy object. The Proxy object allows you to create an object that can be used in place of the
+	* original object, but which may redefine fundamental Object operations like getting, setting, and defining
+	* properties. Proxy objects are commonly used to log property accesses, validate, format, or sanitize inputs.
+	* @param target A target object to wrap with Proxy.
+	* @param handler An object whose properties define the behavior of Proxy when an operation is attempted on it.
+	* @internal
+	*/
+	new <
+		TSource extends object,
+		TTarget extends object
+	>(target: TSource, handler: ProxyHandler<TSource>): TTarget;
 }
 export declare const NativeProxy: ProxyConstructor;
 export {};
-//# sourceMappingURL=native-proxy-type-fix.d.ts.map