@warp-drive/core 5.6.0-alpha.11

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

@@ -0,0 +1,255 @@
+import type { Future } from '../../../request.ts';
+import type { ImmutableRequestInfo, ResponseInfo, StructuredErrorDocument } from '../../../types/request.ts';
+import type { PendingPromise, RejectedPromise, ResolvedPromise } from './promise-state.ts';
+/**
+ * Lazily consumes the stream of a request, providing a number of
+ * reactive properties that can be used to build UIs that respond
+ * to the progress of a request.
+ *
+ */
+export declare class RequestLoadingState {
+    _sizeHint: number;
+    _bytesLoaded: number;
+    _startTime: number;
+    _endTime: number;
+    _lastPacketTime: number;
+    _isPending: boolean;
+    _isStarted: boolean;
+    _isComplete: boolean;
+    _isCancelled: boolean;
+    _isErrored: boolean;
+    _error: Error | null;
+    _stream: TransformStream | null;
+    _future: Future<unknown>;
+    _triggered: boolean;
+    _trigger(): void;
+    promise: Promise<void> | null;
+    get isPending(): boolean;
+    get sizeHint(): number;
+    get stream(): ReadableStream | null;
+    get isStarted(): boolean;
+    get bytesLoaded(): number;
+    get startTime(): number;
+    get endTime(): number;
+    get lastPacketTime(): number;
+    get isComplete(): boolean;
+    get isCancelled(): boolean;
+    get isErrored(): boolean;
+    get error(): Error | null;
+    get elapsedTime(): number;
+    get completedRatio(): number;
+    get remainingRatio(): number;
+    get duration(): number;
+    get speed(): number;
+    constructor(future: Future<unknown>);
+    abort: () => void;
+}
+/**
+ * The state of a request in the "pending"
+ * state. This is the default initial state.
+ *
+ * Extends the {@link PendingPromise} interface.
+ *
+ */
+export interface PendingRequest extends PendingPromise {
+    /**
+     * Whether the request is cancelled.
+     *
+     */
+    isCancelled: false;
+    loadingState: RequestLoadingState;
+    request: null;
+    response: null;
+}
+/**
+ * The state of a request in the "fulfilled" state.
+ * This is the state of a request that has resolved
+ * successfully.
+ *
+ * Extends the {@link ResolvedPromise} interface.
+ *
+ */
+export interface ResolvedRequest<RT, T> extends ResolvedPromise<RT> {
+    /**
+     * Whether the request is cancelled.
+     *
+     */
+    isCancelled: false;
+    loadingState: RequestLoadingState;
+    request: ImmutableRequestInfo<RT, T> | null;
+    response: Response | ResponseInfo | null;
+}
+/**
+ * The state of a request in the "rejected" state.
+ * This is the state of a request that has rejected
+ * with an error.
+ *
+ * Extends the {@link RejectedPromise} interface.
+ *
+ */
+export interface RejectedRequest<RT, T, E extends StructuredErrorDocument = StructuredErrorDocument> extends RejectedPromise<E> {
+    /**
+     * Whether the request is cancelled.
+     *
+     */
+    isCancelled: false;
+    loadingState: RequestLoadingState;
+    request: ImmutableRequestInfo<RT, T> | null;
+    response: Response | ResponseInfo | null;
+}
+/**
+ * The state of a request in the "cancelled" state.
+ * This is the state of a promise that has been
+ * cancelled.
+ *
+ */
+export interface CancelledRequest<RT, T, E extends StructuredErrorDocument = StructuredErrorDocument> {
+    /**
+     * The status of the request.
+     *
+     */
+    status: 'cancelled';
+    /**
+     * Whether the request is pending.
+     *
+     */
+    isPending: false;
+    /**
+     * Whether the request is pending.
+     *
+     */
+    isLoading: false;
+    /**
+     * Whether the request has resolved
+     * successfully.
+     *
+     */
+    isSuccess: false;
+    /**
+     * Whether the request has rejected
+     * with an error.
+     *
+     */
+    isError: true;
+    /**
+     * Once the request has resolved, this will
+     * be the value the request resolved to.
+     *
+     */
+    value: null;
+    /**
+     * Once the request has resolved, this will
+     * be the value the request resolved to.
+     *
+     * @deprecated use `value` instead
+     */
+    result: null;
+    /**
+     * Once the request has rejected, this will
+     * be the error the request rejected with.
+     *
+     *
+     * @deprecated use `reason` instead
+     */
+    error: E;
+    /**
+     * Once the request has rejected, this will
+     * be the error the request rejected with.
+     *
+     */
+    reason: E;
+    /**
+     * Whether the request is cancelled.
+     *
+     */
+    isCancelled: true;
+    loadingState: RequestLoadingState;
+    request: ImmutableRequestInfo<RT, T> | null;
+    response: Response | ResponseInfo | null;
+}
+/**
+ * RequestState extends the concept of PromiseState to provide a reactive
+ * wrapper for a request `Future` which allows you write declarative code
+ * around a Future's control flow.
+ *
+ * It is useful in both Template and JavaScript contexts, allowing you
+ * to quickly derive behaviors and data from pending, error and success
+ * states.
+ *
+ * The key difference between a Promise and a Future is that Futures provide
+ * access to a stream of their content, the identity of the request (if any)
+ * as well as the ability to attempt to abort the request.
+ *
+ * ```ts
+ * interface Future<T> extends Promise<T>> {
+ *   getStream(): Promise<ReadableStream>;
+ *   abort(): void;
+ *   lid: StableDocumentIdentifier | null;
+ * }
+ * ```
+ *
+ * These additional APIs allow us to craft even richer state experiences.
+ *
+ * To get the state of a request, use `getRequestState`.
+ *
+ * See also:
+ * - {@link PendingRequest}
+ * - {@link ResolvedRequest}
+ * - {@link RejectedRequest}
+ * - {@link CancelledRequest}
+ *
+ */
+export type RequestCacheRequestState<RT = unknown, T = unknown, E extends StructuredErrorDocument = StructuredErrorDocument> = PendingRequest | ResolvedRequest<RT, T> | RejectedRequest<RT, T, E> | CancelledRequest<RT, T, E>;
+export declare function createRequestState<RT, T, E>(future: Future<RT>): Readonly<RequestCacheRequestState<RT, T, StructuredErrorDocument<E>>>;
+/**
+ * `getRequestState` can be used in both JavaScript and Template contexts.
+ *
+ * ```ts
+ * import { getRequestState } from '@warp-drive/ember';
+ *
+ * const state = getRequestState(future);
+ * ```
+ *
+ * For instance, we could write a getter on a component that updates whenever
+ * the request state advances or the future changes, by combining the function
+ * with the use of `@cached`
+ *
+ * ```ts
+ * class Component {
+ *   @cached
+ *   get title() {
+ *     const state = getRequestState(this.args.request);
+ *     if (state.isPending) {
+ *       return 'loading...';
+ *     }
+ *     if (state.isError) { return null; }
+ *     return state.result.title;
+ *   }
+ * }
+ * ```
+ *
+ * Or in a template as a helper:
+ *
+ * ```gjs
+ * import { getRequestState } from '@warp-drive/ember';
+ *
+ * <template>
+ *   {{#let (getRequestState @request) as |state|}}
+ *     {{#if state.isPending}}
+ *       <Spinner />
+ *     {{else if state.isError}}
+ *       <ErrorForm @error={{state.error}} />
+ *     {{else}}
+ *       <h1>{{state.result.title}}</h1>
+ *     {{/if}}
+ *   {{/let}}
+ * </template>
+ * ```
+ *
+ * If looking to use in a template, consider also the `<Request />` component
+ * which offers a numbe of additional capabilities for requests *beyond* what
+ * `RequestState` provides.
+ *
+ */
+export declare function getRequestState<RT, T, E>(future: Future<RT>): Readonly<RequestCacheRequestState<RT, T, StructuredErrorDocument<E>>>;
+//# sourceMappingURL=request-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"request-state.d.ts","sourceRoot":"","sources":["../../../../src/store/-private/new-core-tmp/request-state.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,141 @@
+import type { BaseFinderOptions } from '../../../types';
+import type { LocalRelationshipOperation } from '../../../types/graph.ts';
+import type { StableDocumentIdentifier, StableRecordIdentifier } from '../../../types/identifier.ts';
+import type { TypeFromInstanceOrString } from '../../../types/record.ts';
+import type { ImmutableRequestInfo } from '../../../types/request.ts';
+import type { Links, PaginationLinks } from '../../../types/spec/json-api-raw.ts';
+import type { RecordArrayManager } from '../managers/record-array-manager.ts';
+import type { WarpDriveSignal } from '../new-core-tmp/reactivity/internal.ts';
+import { ARRAY_SIGNAL } from '../new-core-tmp/reactivity/internal.ts';
+import type { Store } from '../store-service.ts';
+import { NativeProxy } from './native-proxy-type-fix.ts';
+export declare const SOURCE: "___(unique) Symbol(#source)";
+export declare const MUTATE: "___(unique) Symbol(#update)";
+declare const IS_COLLECTION: "___(unique) Symbol(IS_COLLECTION)";
+export type IdentifierArrayCreateOptions<T = unknown> = {
+    identifiers: StableRecordIdentifier<TypeFromInstanceOrString<T>>[];
+    type?: TypeFromInstanceOrString<T>;
+    store: Store;
+    allowMutation: boolean;
+    manager: MinimumManager;
+    links?: Links | PaginationLinks | null;
+    meta?: Record<string, unknown> | null;
+    identifier?: StableDocumentIdentifier | null;
+};
+type PromiseTo<T> = Omit<Promise<T>, typeof Symbol.toStringTag>;
+type PromiseManyArray<T> = {
+    length: number;
+    content: IdentifierArray<T> | null;
+    promise: Promise<IdentifierArray<T>> | null;
+} & PromiseTo<IdentifierArray<T>>;
+export type MinimumManager = {
+    _syncArray: (array: IdentifierArray) => void;
+    mutate?(mutation: LocalRelationshipOperation): void;
+    reloadHasMany?<T>(key: string, options?: BaseFinderOptions): Promise<IdentifierArray<T>> | PromiseManyArray<T>;
+};
+/**
+  A record array is an array that contains records of a certain type (or modelName).
+  The record array materializes records as needed when they are retrieved for the first
+  time. You should not create record arrays yourself. Instead, an instance of
+  `RecordArray` or its subclasses will be returned by your application's store
+  in response to queries.
+
+  This class should not be imported and instantiated by consuming applications.
+
+  @class RecordArray
+  @public
+*/
+export interface IdentifierArray<T = unknown> extends Omit<Array<T>, '[]'> {
+    [MUTATE]?(target: StableRecordIdentifier[], receiver: typeof NativeProxy<StableRecordIdentifier[], T[]>, prop: string, args: unknown[], _SIGNAL: WarpDriveSignal): unknown;
+}
+export declare class IdentifierArray<T = unknown> {
+    DEPRECATED_CLASS_NAME: string;
+    /**
+      The flag to signal a `RecordArray` is currently loading data.
+      Example
+      ```javascript
+      let people = store.peekAll('person');
+      people.isUpdating; // false
+      people.update();
+      people.isUpdating; // true
+      ```
+      @property isUpdating
+      @public
+      @type Boolean
+    */
+    isUpdating: boolean;
+    isLoaded: boolean;
+    isDestroying: boolean;
+    isDestroyed: boolean;
+    _updatingPromise: Promise<IdentifierArray<T>> | null;
+    readonly identifier: StableDocumentIdentifier | null;
+    [IS_COLLECTION]: boolean;
+    [ARRAY_SIGNAL]: WarpDriveSignal;
+    [SOURCE]: StableRecordIdentifier[];
+    links: Links | PaginationLinks | null;
+    meta: Record<string, unknown> | null;
+    modelName?: TypeFromInstanceOrString<T>;
+    /**
+      The store that created this record array.
+  
+      @property store
+      @private
+      @type Store
+      */
+    store: Store;
+    _manager: MinimumManager;
+    destroy(clear: boolean): void;
+    constructor(options: IdentifierArrayCreateOptions<T>);
+    /**
+      Used to get the latest version of all of the records in this array
+      from the adapter.
+  
+      Example
+  
+      ```javascript
+      let people = store.peekAll('person');
+      people.isUpdating; // false
+  
+      people.update().then(function() {
+        people.isUpdating; // false
+      });
+  
+      people.isUpdating; // true
+      ```
+  
+      @public
+    */
+    update(): Promise<IdentifierArray<T>>;
+    _update(): Promise<IdentifierArray<T>>;
+    /**
+      Saves all of the records in the `RecordArray`.
+  
+      Example
+  
+      ```javascript
+      let messages = store.peekAll('message');
+      messages.forEach(function(message) {
+        message.hasBeenSeen = true;
+      });
+      messages.save();
+      ```
+  
+      @public
+      @return {Promise<IdentifierArray>} promise
+    */
+    save(): Promise<IdentifierArray>;
+}
+export type CollectionCreateOptions = IdentifierArrayCreateOptions & {
+    manager: RecordArrayManager;
+    query: ImmutableRequestInfo | Record<string, unknown> | null;
+    isLoaded: boolean;
+};
+export declare class Collection<T = unknown> extends IdentifierArray<T> {
+    query: ImmutableRequestInfo | Record<string, unknown> | null;
+    _manager: RecordArrayManager;
+    constructor(options: CollectionCreateOptions);
+    _update(): Promise<Collection<T>>;
+    destroy(clear: boolean): void;
+}
+export {};
+//# sourceMappingURL=identifier-array.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identifier-array.d.ts","sourceRoot":"","sources":["../../../../src/store/-private/record-arrays/identifier-array.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,199 @@
+import type { BaseFinderOptions, ModelSchema, StableRecordIdentifier } from '../../../types.ts';
+import type { Cache } from '../../../types/cache.ts';
+import type { TypedRecordInstance, TypeFromInstance, TypeFromInstanceOrString } from '../../../types/record.ts';
+import type { Links, PaginationLinks } from '../../../types/spec/json-api-raw.ts';
+import { type WarpDriveSignal } from '../new-core-tmp/reactivity/internal.ts';
+import type { CreateRecordProperties, Store } from '../store-service.ts';
+import type { MinimumManager } from './identifier-array.ts';
+import { IdentifierArray, MUTATE } from './identifier-array.ts';
+import type { NativeProxy } from './native-proxy-type-fix.ts';
+export interface ManyArrayCreateArgs<T> {
+    identifiers: StableRecordIdentifier<TypeFromInstanceOrString<T>>[];
+    type: TypeFromInstanceOrString<T>;
+    store: Store;
+    allowMutation: boolean;
+    manager: MinimumManager;
+    identifier: StableRecordIdentifier;
+    cache: Cache;
+    meta: Record<string, unknown> | null;
+    links: Links | PaginationLinks | null;
+    key: string;
+    isPolymorphic: boolean;
+    isAsync: boolean;
+    _inverseIsAsync: boolean;
+    isLoaded: boolean;
+}
+/**
+  A `ManyArray` is a `MutableArray` that represents the contents of a has-many
+  relationship.
+
+  The `ManyArray` is instantiated lazily the first time the relationship is
+  requested.
+
+  This class is not intended to be directly instantiated by consuming applications.
+
+  ### Inverses
+
+  Often, the relationships in Ember Data applications will have
+  an inverse. For example, imagine the following models are
+  defined:
+
+  ```js [app/models/post.js]
+  import Model, { hasMany } from '@ember-data/model';
+
+  export default class PostModel extends Model {
+    @hasMany('comment') comments;
+  }
+  ```
+
+  ```js [app/models/comment.js]
+  import { Model, belongsTo } from '@warp-drive/legacy/model';
+
+  export default class CommentModel extends Model {
+    @belongsTo('post') post;
+  }
+  ```
+
+  If you created a new instance of `Post` and added
+  a `Comment` record to its `comments` has-many
+  relationship, you would expect the comment's `post`
+  property to be set to the post that contained
+  the has-many.
+
+  We call the record to which a relationship belongs-to the
+  relationship's _owner_.
+
+  @class ManyArray
+  @public
+*/
+export declare class RelatedCollection<T = unknown> extends IdentifierArray<T> {
+    isAsync: boolean;
+    /**
+      The loading state of this array
+  
+      @property isLoaded
+      @type {Boolean}
+      @public
+      */
+    isLoaded: boolean;
+    /**
+      `true` if the relationship is polymorphic, `false` otherwise.
+  
+      @property isPolymorphic
+      @type {Boolean}
+      @private
+      */
+    isPolymorphic: boolean;
+    _inverseIsAsync: boolean;
+    /**
+      Metadata associated with the request for async hasMany relationships.
+  
+      Example
+  
+      Given that the server returns the following JSON payload when fetching a
+      hasMany relationship:
+  
+      ```js
+      {
+        "comments": [{
+          "id": 1,
+          "comment": "This is the first comment",
+        }, {
+      // ...
+        }],
+  
+        "meta": {
+          "page": 1,
+          "total": 5
+        }
+      }
+      ```
+  
+      You can then access the meta data via the `meta` property:
+  
+      ```js
+      let comments = await post.comments;
+      let meta = comments.meta;
+  
+      // meta.page => 1
+      // meta.total => 5
+      ```
+  
+      @property meta
+      @type {Object | null}
+      @public
+      */
+    meta: Record<string, unknown> | null;
+    /**
+       * Retrieve the links for this relationship
+       *
+       @property links
+       @type {Object | null}
+       @public
+       */
+    links: Links | PaginationLinks | null;
+    identifier: StableRecordIdentifier;
+    cache: Cache;
+    _manager: MinimumManager;
+    store: Store;
+    key: string;
+    type: ModelSchema;
+    modelName: T extends TypedRecordInstance ? TypeFromInstance<T> : string;
+    constructor(options: ManyArrayCreateArgs<T>);
+    [MUTATE](target: StableRecordIdentifier[], receiver: typeof NativeProxy<StableRecordIdentifier[], T[]>, prop: string, args: unknown[], _SIGNAL: WarpDriveSignal): unknown;
+    notify(): void;
+    /**
+      Reloads all of the records in the manyArray. If the manyArray
+      holds a relationship that was originally fetched using a links url
+      WarpDrive will revisit the original links url to repopulate the
+      relationship.
+  
+      If the ManyArray holds the result of a `store.query()` reload will
+      re-run the original query.
+  
+      Example
+  
+      ```javascript
+      let user = store.peekRecord('user', '1')
+      await login(user);
+  
+      let permissions = await user.permissions;
+      await permissions.reload();
+      ```
+  
+      @public
+    */
+    reload(options?: BaseFinderOptions): Promise<this>;
+    /**
+      Create a child record within the owner
+  
+      @public
+      @param {Object} hash
+      @return {Model} record
+    */
+    createRecord(hash: CreateRecordProperties<T>): T;
+    /**
+      Saves all of the records in the `ManyArray`.
+  
+      Note: this API can only be used in legacy mode with a configured Adapter.
+  
+      Example
+  
+      ```javascript
+      const { content: { data: inbox } } = await store.request(findRecord({ type: 'inbox', id: '1' }));
+  
+      let messages = await inbox.messages;
+      messages.forEach((message) => {
+        message.isRead = true;
+      });
+      messages.save();
+      ```
+  
+      @public
+      @return {PromiseArray} promise
+    */
+    save: () => Promise<IdentifierArray<T>>;
+    /** @internal */
+    destroy(): void;
+}
+//# sourceMappingURL=many-array.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"many-array.d.ts","sourceRoot":"","sources":["../../../../src/store/-private/record-arrays/many-array.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAEV,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAGlF,OAAO,EAAsC,KAAK,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAClH,OAAO,KAAK,EAAE,sBAAsB,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,EAAU,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAI9D,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,WAAW,EAAE,sBAAsB,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC;IAClC,KAAK,EAAE,KAAK,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,cAAc,CAAC;IAExB,UAAU,EAAE,sBAAsB,CAAC;IACnC,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACrC,KAAK,EAAE,KAAK,GAAG,eAAe,GAAG,IAAI,CAAC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;CACnB;AACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0CE;AACF,qBAAa,iBAAiB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,eAAe,CAAC,CAAC,CAAC;IAC5D,OAAO,EAAE,OAAO,CAAC;IACzB;;;;;;QAMI;IAEI,QAAQ,EAAE,OAAO,CAAC;IAC1B;;;;;;QAMI;IACI,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAqCI;IACI,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7C;;;;;;SAMK;IACG,KAAK,EAAE,KAAK,GAAG,eAAe,GAAG,IAAI,CAAC;IACtC,UAAU,EAAE,sBAAsB,CAAC;IACnC,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,CAAC,SAAS,mBAAmB,GAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;gBAEpE,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAS3C,CAAC,MAAM,CAAC,CACN,MAAM,EAAE,sBAAsB,EAAE,EAChC,QAAQ,EAAE,OAAO,WAAW,CAAC,sBAAsB,EAAE,EAAE,CAAC,EAAE,CAAC,EAC3D,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EAAE,EACf,OAAO,EAAE,eAAe,GACvB,OAAO;IA4MV,MAAM;IAIN;;;;;;;;;;;;;;;;;;;;MAoBE;IACF,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IASlD;;;;;;MAME;IACF,YAAY,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,CAAC;IAShD;;;;;;;;;;;;;;;;;;;MAmBE;IACM,IAAI,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhD,gBAAgB;IAChB,OAAO;CAGR"}