@warp-drive/core 5.7.0-alpha.27 → 5.7.0-alpha.28

package/declarations/store/-private/new-core-tmp/reactivity/configure.d.ts

@@ -1,44 +1,6 @@
 export declare const ARRAY_SIGNAL: "___(unique) Symbol(#[])";
 export declare const OBJECT_SIGNAL: "___(unique) Symbol(#{})";
 /**
-* Requirements:
-*
-* Signal:
-*
-* - signal: a way of creating a reference that we can dirty when we desire to notify
-*         - @signal: a way of creating an accessor on an object that subscribes to a signal on access
-*                    and notifies the signal on set, or of upgrading a descriptor to be such an accessor
-*         - defineSignal: a way of creating a signal on an object
-*         - notifySignal: a way of notifying the underlying signal that it has been dirtied
-*         - peekSignal: a way of inspecting the signal without notifying it
-*
-*  - gate: a memoized getter function that re-runs when on access if its signal is dirty
-*          conceptually, a gate is a tightly coupled signal and memo
-*         - @gate: a way of creating a gate on an object or upgrading a descriptor with a getter
-*                  to be a gate
-*         - defineGate: a way of creating a gate on an object
-*         - notifySignal: a way of notifying the signal for a gate that it has been dirtied
-*
-* - memo:
-*        - @memo: a way of creating a memoized getter on an object or upgrading a descriptor with a getter
-*                 to be a memo
-*        - defineMemo: a way of creating a memo on an object
-*
-* - signalStore: storage bucket for signals associated to an object
-*        - withSignalStore: a way of pre-creating a signal store on an object
-*
-*
-* @internal
-*/
-/**
-* An Opaque type that represents a framework specific or TC39 signal.
-*
-* It may be an array of signals or a single signal.
-*
-* @internal
-*/
-export type SignalRef = unknown;
-/**
 * The hooks which MUST be configured in order to use reactive arrays,
 * resources and documents with framework specfic signals or TC39 signals.
 *
@@ -156,19 +118,19 @@ export declare function setupSignals<T>(buildConfig: (options: HooksOptions) =>
 /**
 * Internal method for consuming the configured `createSignal` hook
 *
-* @internal
+* @private
 */
 export declare function createSignal(obj: object, key: string | symbol): SignalRef;
 /**
 * Internal method for consuming the configured `consumeSignal` hook
 *
-* @internal
+* @private
 */
 export declare function consumeSignal(signal: SignalRef): void;
 /**
 * Internal method for consuming the configured `notifySignal` hook
 *
-* @internal
+* @private
 */
 export declare function notifySignal(signal: SignalRef): void;
 export declare function createMemo<T>(object: object, key: string | symbol, fn: () => T): () => T;

package/declarations/store/-private/new-core-tmp/reactivity/internal.d.ts

@@ -31,30 +31,9 @@ export declare function makeInitializer(fn: () => unknown): Initializer;
 * - the "key" or "name" of the signal
 * - the "object identity" or "context" to which the signal is attached
 *
-* @internal
+* @private
 */
 export interface WarpDriveSignal {
-	/**
-	* The "key" or "name" of the signal.
-	* This is usually (but not always) the name of a property
-	* on the object to which the signal is attached.
-	*
-	* This is used for debugging purposes.
-	* It is not used for any other purpose.
-	*
-	* @internal
-	*/
-	key: string | symbol;
-	/**
-	* The "object identity" or "context" to which the
-	* signal is attached.
-	*
-	* This is used for debugging purposes.
-	* It is not used for any other purpose.
-	*
-	* @internal
-	*/
-	context: object;
 	/**
 	* The underlying signal(s) in-use.
 	*
@@ -98,14 +77,14 @@ export interface WarpDriveSignal {
 	*   },
 	* });
 	*
-	* @internal
+	* @private
 	*/
 	signal: SignalRef;
 	/**
 	* The last "value" computed for this signal when
 	* a signal is also used for storage.
 	*
-	* @internal
+	* @private
 	*/
 	value: unknown;
 	/**
@@ -114,7 +93,7 @@ export interface WarpDriveSignal {
 	* `value` cache and when using the signal as a
 	* "gate"
 	*
-	* @internal
+	* @private
 	*/
 	isStale: boolean;
 }
@@ -134,14 +113,14 @@ export interface WarpDriveSignal {
 * initializeSignalStore(obj);
 * ```
 *
-* @internal
+* @private
 */
 export declare const Signals: "___(unique) Symbol(Signals)";
 export type SignalStore = Map<string | symbol, WarpDriveSignal>;
 /**
 * A type util to recast the object as having a signal store.
 *
-* @internal
+* @private
 */
 export declare function upgradeWithSignals<T extends object>(obj: T): asserts obj is T & {
 	[Signals]: SignalStore;
@@ -151,7 +130,7 @@ export declare function upgradeWithSignals<T extends object>(obj: T): asserts ob
 * if it does not already exist and returns the associated
 * signal store.
 *
-* @internal
+* @private
 */
 export declare function withSignalStore<T extends object>(obj: T): SignalStore;
 /**
@@ -161,7 +140,7 @@ export declare function withSignalStore<T extends object>(obj: T): SignalStore;
 * Useful for pre-warming the shape of an object to ensure
 * a key-transition to add it is not required later.
 *
-* @internal
+* @private
 */
 export declare function initializeSignalStore<T extends object>(obj: T): asserts obj is T & {
 	[Signals]: SignalStore;

package/declarations/store/-private/new-core-tmp/reactivity/signal.d.ts

@@ -4,7 +4,7 @@ import type { SignalStore, WarpDriveSignal } from "./internal.js";
 *
 * Use when you need to ensure a signal exists and is subscribed to.
 *
-* @internal
+* @private
 */
 export declare function entangleSignal<T extends object>(signals: SignalStore, obj: T, key: string | symbol, initialValue: unknown): WarpDriveSignal;
 export declare function createSignalDescriptor(key: string | symbol, intialValue: unknown): PropertyDescriptor;
@@ -16,13 +16,13 @@ export declare function createSignalDescriptor(key: string | symbol, intialValue
 * The signal will be lazily created when accessed and scoped to the
 * instance of the object.
 *
-* @internal
+* @private
 */
 export declare function defineSignal<T extends object>(obj: T, key: string, v?: unknown): void;
 /**
 * Define a non-enumerable signal property.
 *
-* @internal
+* @private
 */
 export declare function defineNonEnumerableSignal<T extends object>(obj: T, key: string, v?: unknown): void;
 interface DecoratorPropertyDescriptor extends PropertyDescriptor {
@@ -44,6 +44,8 @@ export declare function memoized<
 >(target: T, key: K, descriptor: PropertyDescriptor): PropertyDescriptor;
 /**
 * Decorator version of creating a gate.
+*
+* @private
 */
 export declare function gate<
 	T extends object,

package/declarations/store/-private/new-core-tmp/request-subscription.d.ts

@@ -149,82 +149,11 @@ export declare class RequestSubscription<
 	*/
 	isRefreshing: boolean;
 	/**
-	* The most recent blocking request that was made, typically
-	* the result of a reload.
-	*
-	* This will never be the original request passed as an arg to
-	* the component.
-	*
-	* @internal
-	*/
-	private _localRequest;
-	/**
-	* The most recent request that was made, typically due to either a
-	* reload or a refresh.
-	*
-	* This will never be the original request passed as an arg to
-	* the component.
-	*
-	* @internal
-	*/
-	private _latestRequest;
-	/**
-	* The time at which the network was reported as offline.
-	*
-	* @internal
-	*/
-	private _unavailableStart;
-	/** @internal */
-	private _intervalStart;
-	/** @internal */
-	private _nextInterval;
-	/** @internal */
-	private _invalidated;
-	/** @internal */
-	private _isUpdating;
-	/** @internal */
-	private isDestroyed;
-	/**
-	* The event listener for network status changes,
-	* cached to use the reference for removal.
-	*
-	* @internal
-	*/
-	private _onlineChanged;
-	/**
-	* The event listener for visibility status changes,
-	* cached to use the reference for removal.
-	*
-	* @internal
+	* The Store this subscription subscribes to or the RequestManager
+	* which issues this request.
 	*/
-	private _backgroundChanged;
-	/**
-	* The last request passed as an arg to the component,
-	* cached for comparison.
-	*
-	* @internal
-	*/
-	private _originalRequest;
-	/**
-	* The last query passed as an arg to the component,
-	* cached for comparison.
-	*
-	* @internal
-	*/
-	private _originalQuery;
-	/** @internal */
-	private _subscription;
-	/** @internal */
-	private _subscribedTo;
-	/** @internal */
-	private _args;
-	/** @internal */
 	store: Store | RequestManager;
 	constructor(store: Store | RequestManager, args: SubscriptionArgs<RT, E>);
-	/**
-	* @internal
-	*/
-	private _beginPolling;
 	get isIdle(): boolean;
 	get autorefreshTypes(): Set<AutorefreshBehaviorType>;
 	// we only run this function on component creation
@@ -238,39 +167,6 @@ export declare class RequestSubscription<
 	private _scheduleInterval;
 	private _clearInterval;
 	/**
-	* @internal
-	*/
-	private _updateSubscriptions;
-	/**
-	* @internal
-	*/
-	private _removeSubscriptions;
-	/**
-	* Install the event listeners for network and visibility changes.
-	* This is only done in browser environments with a global `window`.
-	*
-	* @internal
-	*/
-	private _installListeners;
-	/**
-	* If the network is online and the tab is visible, either reload or refresh the request
-	* based on the component's configuration and the requested update mode.
-	*
-	* Valid modes are:
-	*
-	* - `'reload'`: Force a reload of the request.
-	* - `'refresh'`: Refresh the request in the background.
-	* - `'policy'`: Make the request, letting the store's configured CachePolicy decide whether to reload, refresh, or do nothing.
-	* - `undefined`: Make the request using the component's autorefreshBehavior setting if the autorefreshThreshold has passed.
-	*
-	* @internal
-	*/
-	private _maybeUpdate;
-	/**
-	* @internal
-	*/
-	private _getRequester;
-	/**
 	* Retry the request, reloading it from the server.
 	*/
 	retry: () => Promise<void>;
@@ -286,10 +182,6 @@ export declare class RequestSubscription<
 	* features to yield to the content slot of a component
 	*/
 	get contentFeatures(): ContentFeatures<RT>;
-	/**
-	* @internal
-	*/
-	get _request(): Future<RT>;
 	get request(): Future<RT>;
 	get reqState(): RequestState<RT, StructuredErrorDocument<E>>;
 	get result(): RT;

package/declarations/store/-private/record-arrays/-utils.d.ts

@@ -20,8 +20,6 @@ export interface LegacyArray<T = unknown> extends ReactiveResourceArray<T> {
 	```
 	*/
 	isUpdating: boolean;
-	/** @internal */
-	_updatingPromise: Promise<LegacyArray<T>> | null;
 	/**
 	Used to get the latest version of all of the records in this array
 	from the adapter.

package/declarations/store/-private/record-arrays/legacy-live-array.d.ts

@@ -66,14 +66,12 @@ import type { LegacyArray, MinimumManager } from "./-utils.js";
 */
 export interface LegacyLiveArray<T = unknown> extends LegacyArray<T> {
 	isLoaded: boolean;
-	/** @internal */
-	DEPRECATED_CLASS_NAME: string;
 	modelName: TypeFromInstanceOrString<T>;
 }
 /**
 * The options for {@link createLegacyLiveArray}
 *
-* @internal
+* @private
 */
 export interface LegacyLiveArrayCreateOptions {
 	store: Store;
@@ -81,9 +79,3 @@ export interface LegacyLiveArrayCreateOptions {
 	source: ResourceKey[];
 	type: string;
 }
-/**
-* Creates a {@link LegacyLiveArray}
-*
-* @internal
-*/
-export declare function createLegacyLiveArray(options: LegacyLiveArrayCreateOptions): LegacyLiveArray;

package/declarations/store/-private/record-arrays/legacy-many-array.d.ts

@@ -50,21 +50,15 @@ relationship's _owner_.
 export interface LegacyManyArray<T = unknown> extends ReactiveResourceArray<T> {
 	meta: Meta | null;
 	links: Links | PaginationLinks | null;
-	/** @internal */
-	isPolymorphic: boolean;
-	/** @internal */
-	isAsync: boolean;
-	/** @internal */
+	/** @private */
 	key: string;
-	/** @internal */
+	/** @private */
 	modelName: T extends TypedRecordInstance ? TypeFromInstance<T> : string;
 	/**
 	The loading state of this array
 	@public
 	*/
 	isLoaded: boolean;
-	/** @internal */
-	notify(): void;
 	/**
 	Reloads all of the records in the manyArray. If the manyArray
 	holds a relationship that was originally fetched using a links url
@@ -113,13 +107,13 @@ export interface LegacyManyArray<T = unknown> extends ReactiveResourceArray<T> {
 	@public
 	*/
 	save: () => Promise<LegacyManyArray<T>>;
-	/** @internal */
+	/** @private */
 	destroy: () => void;
 }
 /**
 * The options for {@link createLegacyManyArray}
 *
-* @internal
+* @private
 */
 export interface LegacyManyArrayCreateOptions extends LegacyLiveArrayCreateOptions {
 	isLoaded: boolean;
@@ -134,6 +128,6 @@ export interface LegacyManyArrayCreateOptions extends LegacyLiveArrayCreateOptio
 /**
 * Creates a {@link LegacyManyArray}
 *
-* @internal
+* @private
 */
 export declare function createLegacyManyArray<T>(options: LegacyManyArrayCreateOptions): LegacyManyArray<T>;

package/declarations/store/-private/record-arrays/legacy-query.d.ts

@@ -1,6 +1,6 @@
 import type { ImmutableRequestInfo } from "../../../types/request.js";
 import type { Links, Meta, PaginationLinks } from "../../../types/spec/json-api-raw.js";
-import type { LegacyLiveArray, LegacyLiveArrayCreateOptions } from "./legacy-live-array.js";
+import type { LegacyLiveArray } from "./legacy-live-array.js";
 /**
 * QueryArrays contain the primary records returned when querying
 * for records by `ResourceType`.
@@ -79,25 +79,3 @@ export interface LegacyQueryArray<T = unknown> extends LegacyLiveArray<T> {
 	links: PaginationLinks | Links | null;
 	meta: Meta | null;
 }
-/**
-* The options for {@link createLegacyQueryArray}
-*
-* See also {@link LegacyLiveArrayCreateOptions} which
-* this extends.
-*
-* @internal
-*/
-export interface LegacyQueryArrayCreateOptions extends LegacyLiveArrayCreateOptions {
-	query: ImmutableRequestInfo | Record<string, unknown> | null;
-	isLoaded: boolean;
-	links: PaginationLinks | Links | null;
-	meta: Meta | null;
-}
-/**
-* Creates a {@link LegacyQueryArray}
-*
-* Options: {@link LegacyQueryArrayCreateOptions}
-*
-* @internal
-*/
-export declare function createLegacyQueryArray<T = unknown>(options: LegacyQueryArrayCreateOptions): LegacyQueryArray<T>;

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

@@ -1,126 +1,3 @@
-/* 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
-	*/
-	// 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;
-}
+interface ProxyConstructor {}
 export declare const NativeProxy: ProxyConstructor;
 export {};

package/declarations/store/-private/record-arrays/resource-array.d.ts

@@ -36,22 +36,15 @@ interface ReactiveResourceArrayContext extends ReactiveResourceArrayCreateOption
 	transaction: boolean;
 	boundFns: Map<KeyType, ProxiedMethod>;
 }
-export interface ReactiveResourceArray<T = unknown> extends Omit<Array<T>, "[]"> {
-	/** @internal */
+export interface ReactiveResourceArray<T = unknown> extends Omit<Array<T>, "[]"> {}
+export interface PrivateReactiveResourceArray<T = unknown> extends Omit<Array<T>, "[]"> {
 	isDestroying: boolean;
-	/** @internal */
 	isDestroyed: boolean;
-	/** @internal */
 	destroy: (this: ReactiveResourceArray, clear: boolean) => void;
-	/** @internal */
 	[IS_COLLECTION]: boolean;
-	/** @internal */
-	[Context]: ReactiveResourceArrayContext;
-}
-export interface TargetArray extends Array<ResourceKey> {
-	/** @internal */
 	[Context]: ReactiveResourceArrayContext;
 }
+export interface TargetArray extends Array<ResourceKey> {}
 export declare function createReactiveResourceArray<T>(options: ReactiveResourceArrayCreateOptions): ReactiveResourceArray<T>;
 export declare function destroy(this: ReactiveResourceArray, clear: boolean): void;
 export interface ReactiveRequestCollectionCreateArgs {