@arcgis/core 5.0.0-next.51 → 5.0.0-next.53

package/core/Error.d.ts

@@ -1,4 +1,55 @@
-import "../interfaces";
+import type Message from "./Message.js";
 
-import Error = __esri.Error;
-export default Error;
+/**
+ * Error is a class that enhances the debugging and error handling process. Rather than returning a generic
+ * [JavaScript error](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error),
+ * this Error returns a standardized error object with several properties. The error class can be useful
+ * in many scenarios, such as working with promises, the [esriRequest](https://developers.arcgis.com/javascript/latest/api-reference/esri-request.html) module, and many different layers and widgets.
+ *
+ * @since 4.5
+ * @see [request](https://developers.arcgis.com/javascript/latest/api-reference/esri-request.html)
+ * @example
+ * button.on("click", function() {
+ *   esriRequest(url, options).then(function(response) {
+ *     // do something useful
+ *   }).catch(function(error){
+ *     console.log("informative error message: ", error.message);
+ *   });
+ * });
+ */
+export default class Error<T = any> extends Message<T> {
+  constructor(name: string, message: string, details?: T);
+  /**
+   * The details object provides additional details specific to the error,
+   * giving more information about why the error was raised. For example, the details object for
+   * [esriRequest](https://developers.arcgis.com/javascript/latest/api-reference/esri-request-interfaces.html#RequestErrorDetails) includes
+   * additional information to help the developer diagnose issues with a problematic request.
+   *
+   * @example
+   * someAsyncFunction.then(callback)
+   *   .catch(function(error){
+   *     console.log("Error details: ", error.details);
+   * });
+   */
+  details?: T | null;
+  /**
+   * Message describing the error.
+   *
+   * @example
+   * someAsyncFunction.then(callback)
+   *   .catch(function(error){
+   *     console.log("Error message: ", error.message);
+   * });
+   */
+  message: string;
+  /**
+   * A unique error name. This can be used to map to a localized error message to present to the user.
+   *
+   * @example
+   * someAsyncFunction.then(callback)
+   *   .catch(function(error){
+   *     console.log("Error name: ", error.name);
+   * });
+   */
+  name: string;
+}

package/core/Evented.d.ts

@@ -1,4 +1,64 @@
-import "../interfaces";
+import type Accessor from "./Accessor.js";
+import type { ResourceHandle } from "./Handles.js";
 
-import Evented = __esri.Evented;
-export { Evented };
+export interface EventedMixinProperties {}
+
+/** @since 4.0 */
+export abstract class EventedMixin {
+  constructor(...args: any[]);
+  /**
+   * @deprecated
+   * Do not directly reference this property.
+   * Use EventNames and EventTypes helpers from \@arcgis/core/Evented
+   */
+  readonly "@eventTypes": unknown;
+  /**
+   * Emits an event on the instance. This method should only be used when creating subclasses of this class.
+   *
+   * @param type - The name of the event.
+   * @param event - The event payload.
+   * @returns `true` if a listener was notified
+   * @since 4.5
+   */
+  emit<Type extends EventNames<this>>(type: Type, event?: this["@eventTypes"][Type]): boolean;
+  /**
+   * Indicates whether there is an event listener on the instance that matches
+   * the provided event name.
+   *
+   * @param type - The name of the event.
+   * @returns Returns true if the class supports the input event.
+   */
+  hasEventListener<Type extends EventNames<this>>(type: Type): boolean;
+  /**
+   * Registers an event handler on the instance. Call this method to hook an event with a listener.
+   *
+   * @param type - An {@link core/Evented!EventedEvents event} or an array of events to listen for.
+   * @param listener - The function to call when the event fires.
+   * @returns Returns an event handler with a `remove()` method that should be called to stop listening for the event(s).
+   *
+   * Property | Type | Description
+   * ------------|--------|----------------
+   * remove | Function | When called, removes the listener from the event.
+   * @example
+   * view.on("click", function(event){
+   *   // event is the event handle returned after the event fires.
+   *   console.log(event.mapPoint);
+   * });
+   */
+  on<Type extends EventNames<this>>(type: Type, listener: EventedCallback<this["@eventTypes"][Type]>): ResourceHandle;
+}
+
+/** Evented is a base class for objects that can emit events. It is used by many classes in the ArcGIS API for JavaScript to provide event handling capabilities. */
+export abstract class Evented extends EventedMixin {}
+
+export abstract class EventedAccessor extends EventedAccessorSuperclass {}
+declare const EventedAccessorSuperclass: & typeof Accessor & typeof EventedMixin
+
+export type EventedCallback<T = any> = ((event: T) => void) | WeakRef<(event: T) => void>;
+
+export type EventNames<Evented extends {
+    "@eventTypes": unknown;
+}> = keyof Evented["@eventTypes"] &
+  string;
+
+export type EventTypes<T> = T extends EventedMixin ? T["@eventTypes"] : never;

package/core/Handles.d.ts

@@ -1,4 +1,92 @@
-import "../interfaces";
+import type Collection from "./Collection.js";
 
-import Handles = __esri.Handles;
-export default Handles;
+/**
+ * This class helps manage a group of handles.
+ *
+ * @since 4.7
+ */
+export default class Handles<T = string, H extends ResourceHandle = ResourceHandle> {
+  constructor();
+  /**
+   * Adds a group of handles.
+   *
+   * @param handles - An array or collection handles to group.
+   * @param groupKey - Key identifying the group to which the handles should be added. All the handles in the group
+   *    can later be removed with [remove()](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Handles.html#remove). If no
+   *    key is provided the handles are added to a default group.
+   * @example
+   * let handles = new Handles();
+   *
+   * handles.add(handle); // added to the default group
+   * handles.add([handle1, handle2]); // added to the default group
+   *
+   * handles.add(handle, "handle-group");
+   * handles.add([handle1, handle2], "other-handle-group");
+   * @example
+   * let handles = new Handles();
+   *
+   * handles.add(reactiveUtils.when(
+   *   () => !view.updating,
+   *   () => {
+   *     wkidSelect.disabled = false;
+   *   },
+   *   { once: true }
+   * ));
+   */
+  add(handles: (H | null | undefined) | (H | null | undefined)[] | Collection<H | null | undefined>, groupKey?: T): this;
+  /**
+   * Destroys the object, removing all the handles.
+   *
+   * @example
+   * let handles = new Handles();
+   *
+   * handles.add(reactiveUtils.when(
+   *   () => !view.updating,
+   *   () => {
+   *     wkidSelect.disabled = false;
+   *   },
+   *   { once: true }
+   * ));
+   *
+   * handles.destroy();
+   */
+  destroy(): void;
+  /**
+   * Returns true if a group exists for the provided group key, false otherwise.
+   *
+   * @param groupKey - group handle key
+   */
+  has(groupKey?: T): boolean;
+  /**
+   * Removes a group of handles.
+   *
+   * @param groupKey - A group key or an array or collection of group keys to remove.
+   * @example
+   * let handles = new Handles();
+   *
+   * handles.remove(); // removes handles from default group
+   *
+   * handles.remove("handle-group");
+   * handles.remove("other-handle-group");
+   */
+  remove(groupKey?: T | T[] | Collection<T>): this;
+  /** Removes all handles. */
+  removeAll(): this;
+}
+
+/**
+ * Represents a watch or event handler which can be removed.
+ *
+ * @example
+ * let handle = reactiveUtils.watch(() => map.basemap, (newVal) => {
+ *   // Each time the value of map.basemap changes, it is logged in the console
+ *   console.log("new basemap: ", newVal);
+ * });
+ *
+ * // When remove() is called on the watch handle, the map no longer watches for changes to basemap
+ * handle.remove();
+ */
+export interface ResourceHandle {
+  /** Removes the handle. */
+  remove(): void;
+}

package/core/Identifiable.d.ts

@@ -1,4 +1,20 @@
-import "../interfaces";
 
-import Identifiable = __esri.Identifiable;
-export { Identifiable };
+export interface IdentifiableMixinProperties {}
+
+/**
+ * Mixin that adds a unique identifier property to instances.
+ *
+ * @since 4.0
+ */
+export abstract class IdentifiableMixin {
+  constructor(...args: any[]);
+  /**
+   * An automatically generated unique identifier assigned to the instance. The unique id is generated each
+   * time the application is loaded.
+   *
+   * @since 4.33
+   */
+  readonly uid: string;
+}
+
+export abstract class Identifiable extends IdentifiableMixin {}

package/core/JSONSupport.d.ts

@@ -1,4 +1,39 @@
-import "../interfaces";
+import type Accessor from "./Accessor.js";
 
-import JSONSupport = __esri.JSONSupport;
-export { JSONSupport };
+export interface JSONSupportMixinProperties {}
+
+/**
+ * JSONSupport provides an Accessor subclass,
+ * which offers the capability of hydrating objects from a JSON object.
+ *
+ * It includes support methods for working with JSON.
+ *
+ * @since 4.0
+ */
+export abstract class JSONSupportMixin {
+  constructor(...args: any[]);
+  /**
+   * Creates a new instance of this class and initializes it with values from a JSON object
+   * generated from an ArcGIS product. The object passed into the input `json`
+   * parameter often comes from a response to a query operation in the REST API or a
+   * [toJSON()](https://pro.arcgis.com/en/pro-app/latest/tool-reference/conversion/features-to-json.htm)
+   * method from another ArcGIS product. See the [Using fromJSON()](https://developers.arcgis.com/javascript/latest/using-fromjson)
+   * topic in the Guide for details and examples of when and how to use this function.
+   *
+   * @param json - A JSON representation of the instance in the ArcGIS format. See
+   *                      the [ArcGIS REST API documentation](https://developers.arcgis.com/documentation/common-data-types/overview-of-common-data-types.htm) for examples of the structure of
+   *                       various input JSON objects.
+   * @returns Returns a new instance of this class.
+   */
+  static fromJSON(json: any): any;
+  /**
+   * Converts an instance of this class to its [ArcGIS portal JSON](https://developers.arcgis.com/documentation/common-data-types/geometry-objects.htm) representation.
+   * See the [Using fromJSON()](https://developers.arcgis.com/javascript/latest/using-fromjson) guide topic for more information.
+   *
+   * @returns The [ArcGIS portal JSON](https://developers.arcgis.com/documentation/common-data-types/geometry-objects.htm) representation of an instance of this class.
+   */
+  toJSON(): any;
+}
+
+export abstract class JSONSupport extends JSONSupportSuperclass {}
+declare const JSONSupportSuperclass: & typeof Accessor & typeof JSONSupportMixin

package/core/Loadable.d.ts

@@ -1,4 +1,50 @@
-import "../interfaces";
+import type EsriError from "./Error.js";
+import type { EsriPromise } from "./Promise.js";
+import type { AbortOptions } from "./promiseUtils.js";
 
-import Loadable = __esri.Loadable;
-export { Loadable };
+export interface LoadableMixinProperties {}
+
+/** @since 4.0 */
+export abstract class LoadableMixin {
+  constructor(...args: any[]);
+  /** The Error object returned if an error occurred while loading. */
+  get loadError(): EsriError | null | undefined;
+  /**
+   * Represents the status of a [load()](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Loadable.html#load) operation.
+   *
+   * Value | Description
+   * ------|------------
+   * not-loaded | The object's resources have not loaded.
+   * loading | The object's resources are currently loading.
+   * loaded | The object's resources have loaded without errors.
+   * failed | The object's resources failed to load. See [loadError](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Loadable.html#loadError) for more details.
+   *
+   * @default "not-loaded"
+   */
+  get loadStatus(): "not-loaded" | "loading" | "failed" | "loaded";
+  /** A list of warnings which occurred while loading. */
+  get loadWarnings(): any[];
+  /** Cancels a [load()](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Loadable.html#load) operation if it is already in progress. */
+  cancelLoad(): this;
+  /**
+   * Loads the resources referenced by this class. This method automatically
+   * executes for a [View](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html) and all of the resources
+   * it references in [Map](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html) if the view is constructed with
+   * a map instance.
+   *
+   * This method must be called by the developer when accessing a resource that will not be
+   * loaded in a [View](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html).
+   *
+   * The `load()` method only triggers the loading of the resource the first time it is called. The subsequent calls return the same promise.
+   *
+   * It's possible to provide a `signal` to stop being interested into a `Loadable` instance load status.
+   * When the signal is aborted, the instance does not stop its loading process, only [cancelLoad()](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Loadable.html#cancelLoad) can abort it.
+   *
+   * @param options - Additional options.
+   * @returns Resolves when the resources have {@link core/Loadable#loaded}.
+   */
+  load(options?: AbortOptions | null | undefined): Promise<this>;
+}
+
+export abstract class Loadable extends LoadableSuperclass {}
+declare const LoadableSuperclass: & typeof EsriPromise & typeof LoadableMixin

package/core/Logger.d.ts

@@ -0,0 +1,29 @@
+
+/**
+ * A custom log interceptor function.
+ *
+ * @param level - The level of the message.
+ * @param module - The module from which the log message originated.
+ * @param args - Arguments of any type to be logged.
+ * @returns Return true to indicate the log message has been handled and should no longer be processed
+ * (neither by other interceptors nor by the default handler which logs messages to the console).
+ * @example
+ * // Only show error messages, not warnings nor info messages
+ * esriConfig.log.level = "error";
+ *
+ * esriConfig.log.interceptors.push(function(level, module, ...args) {
+ *   // Send all messages to a REST end-point
+ *   request(loggingUrl, {
+ *     method: "post",
+ *     body: {
+ *             level: level,
+ *             module: module,
+ *             details: JSON.stringify(args)
+ *           }
+ *   });
+ *
+ *   // Return false so that the default log handler still writes log messages to the console
+ *   return false;
+ * });
+ */
+export type LogInterceptor = (level: "error" | "warn" | "info", module: string, ...args: any[]) => boolean;

package/core/Message.d.ts

@@ -0,0 +1,2 @@
+
+export default abstract class Message<T = any> {}

package/core/MultiOriginJSONSupport.d.ts

@@ -0,0 +1,13 @@
+import type Accessor from "./Accessor.js";
+import type { ReadOnlyMultiOriginJSONMixin, ReadOnlyMultiOriginJSONMixinProperties } from "./ReadOnlyMultiOriginJSONSupport.js";
+import type { WriteableMultiOriginJSONMixin, WriteableMultiOriginJSONMixinProperties } from "./WriteableMultiOriginJSONMixin.js";
+
+export interface MultiOriginJSONMixinProperties extends WriteableMultiOriginJSONMixinProperties, ReadOnlyMultiOriginJSONMixinProperties {}
+
+export abstract class MultiOriginJSONMixin extends MultiOriginJSONMixinSuperclass {
+  constructor(...args: any[]);
+}
+declare const MultiOriginJSONMixinSuperclass: & typeof WriteableMultiOriginJSONMixin & typeof ReadOnlyMultiOriginJSONMixin
+
+export abstract class MultiOriginJSONSupport extends MultiOriginJSONSupportSuperclass {}
+declare const MultiOriginJSONSupportSuperclass: & typeof Accessor & typeof MultiOriginJSONMixin

package/core/NumericIdentifiable.d.ts

@@ -0,0 +1,6 @@
+
+export interface NumericIdentifiableMixinProperties {}
+
+export abstract class NumericIdentifiableMixin {
+  constructor(...args: any[]);
+}

package/core/Promise.d.ts

@@ -1,4 +1,51 @@
-import "../interfaces";
+import type Accessor from "./Accessor.js";
 
-import corePromise = __esri.corePromise;
-export { corePromise };
+export interface EsriPromiseMixinProperties {}
+
+/** Promise mixin. */
+export abstract class EsriPromiseMixin {
+  constructor(...args: any[]);
+  /**
+   * `isFulfilled()` may be used to verify if creating an instance of the class is fulfilled (either resolved or rejected).
+   * If it is fulfilled, `true` will be returned.
+   *
+   * @returns Indicates whether creating an instance of the class has been fulfilled (either resolved or rejected).
+   */
+  isFulfilled(): boolean;
+  /**
+   * `isRejected()` may be used to verify if creating an instance of the class is rejected.
+   * If it is rejected, `true` will be returned.
+   *
+   * @returns Indicates whether creating an instance of the class has been rejected.
+   */
+  isRejected(): boolean;
+  /**
+   * `isResolved()` may be used to verify if creating an instance of the class is resolved.
+   * If it is resolved, `true` will be returned.
+   *
+   * @returns Indicates whether creating an instance of the class has been resolved.
+   */
+  isResolved(): boolean;
+  /**
+   * `when()` may be leveraged once an instance of the class is created. This method takes two input parameters: a `onFulfilled` function and an `onRejected` function.
+   * The `onFulfilled` executes when the instance of the class loads. The
+   * `onRejected` executes if the instance of the class fails to load.
+   *
+   * @param onFulfilled - The function to call when the promise resolves.
+   * @param onRejected - The function to execute when the promise fails.
+   * @returns Returns a new promise for the result of `onFulfilled` that may be used to chain additional functions.
+   * @since 4.6
+   * @example
+   * // Although this example uses MapView, any class instance that is a promise may use when() in the same way
+   * let view = new MapView();
+   * view.when(function(){
+   *   // This function will execute once the promise is resolved
+   * }, function(error){
+   *   // This function will execute if the promise is rejected due to an error
+   * });
+   */
+  when<TResult1 = this, TResult2 = never>(onFulfilled?: ((value: this) => TResult1 | PromiseLike<TResult1>) | null | undefined, onRejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null | undefined): Promise<TResult1 | TResult2>;
+}
+
+export abstract class EsriPromise extends EsriPromiseSuperclass {}
+declare const EsriPromiseSuperclass: & typeof Accessor & typeof EsriPromiseMixin

package/core/ReadOnlyMultiOriginJSONSupport.d.ts

@@ -0,0 +1,6 @@
+
+export interface ReadOnlyMultiOriginJSONMixinProperties {}
+
+export abstract class ReadOnlyMultiOriginJSONMixin {
+  constructor(...args: any[]);
+}

package/core/Version.d.ts

@@ -0,0 +1,7 @@
+
+export abstract class Version {
+  /** The major version of the WebMap or WebScene. */
+  readonly major: number;
+  /** The minor version of the WebMap or WebScene. */
+  readonly minor: number;
+}

package/core/WriteableMultiOriginJSONMixin.d.ts

@@ -0,0 +1,6 @@
+
+export interface WriteableMultiOriginJSONMixinProperties {}
+
+export abstract class WriteableMultiOriginJSONMixin {
+  constructor(...args: any[]);
+}

package/core/accessorSupport/ObservableBase.js

@@ -2,4 +2,4 @@
 All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
 */
-import{makeHandle as e}from"../handleUtils.js";import{ObservationHandle as s}from"./tracking/ObservationHandle.js";class r{constructor(){this._observers=null,this.destroyed=!1}observe(e){if(this.destroyed||e.destroyed)return t;null==this._observers&&(this._observers=[]);const r=this._observers;let o=!1,i=!1;const n=r.length;for(let s=0;s<n;++s){const t=r[s];if(t.destroyed)i=!0;else if(t===e){o=!0;break}}return o||(r.push(e),i&&this._removeDestroyedObservers()),new s(r,e)}_removeDestroyedObservers(){const e=this._observers;if(!e||0===e.length)return;const s=e.length;let r=0;for(let t=0;t<s;++t){for(;t+r<s;){if(!e[t+r].destroyed)break;++r}if(r>0){if(!(t+r<s))break;e[t]=e[t+r]}}e.length=s-r}destroy(){if(this.destroyed)return;this.destroyed=!0;const e=this._observers;if(null!=e){for(const s of e)s.onCommitted();this._observers=null}}}const t=e();export{r as ObservableBase};
+import{makeHandle as e}from"../handleUtils.js";import{ObservationHandle as r}from"./tracking/ObservationHandle.js";class s{constructor(){this._observers=null,this.destroyed=!1}observe(e){if(this.destroyed||e.destroyed)return t;null==this._observers&&(this._observers=[]);const s=this._observers;let o=!1,i=!1;for(const r of s)if(r.destroyed)i=!0;else if(r===e){o=!0;break}return o||(s.push(e),i&&this._removeDestroyedObservers()),new r(s,e)}_removeDestroyedObservers(){const e=this._observers;if(!e)return;const r=e.length;if(0===r)return;let s=0;for(let t=0;t<r;++t){for(;t+s<r;){if(!e[t+s].destroyed)break;++s}if(s>0){if(!(t+s<r))break;e[t]=e[t+s]}}e.length=r-s}destroy(){if(this.destroyed)return;this.destroyed=!0;const e=this._observers;if(null!=e){for(const r of e)r.onCommitted();this._observers=null}}}const t=e();export{s as ObservableBase};

package/core/accessorSupport/Properties.js

@@ -2,4 +2,4 @@
 All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
 */
-import"../has.js";import{equals as t}from"../lang.js";import"../Logger.js";import e from"../ObjectPool.js";import{Lifecycle as i}from"./Lifecycle.js";import{Property as s}from"./Property.js";import{idToName as r,nameToId as n}from"./PropertyOrigin.js";import{Store as o}from"./Store.js";import{trackAccess as a,runTracked as c,initializeDependencyTracking as l}from"./tracking.js";import{Flags as h}from"./tracking/Flags.js";import{TrackingTarget as g}from"./tracking/TrackingTarget.js";function f(t,e,i){return void 0!==t}function p(t,e,s,r){return void 0!==t&&(!(null==s&&t.flags&h.NonNullable)||(r.lifecycle,i.INITIALIZING,!1))}class m{constructor(t){this.host=t,this.propertiesByName=new Map,this.ctorArgs=null,this.lifecycle=i.INITIALIZING,this.store=new o,this.mutable=!0,this._origin=7;const e=this.host.constructor.__accessorMetadata__;for(const i in e){const t=new s(i,e[i]);this.propertiesByName.set(i,t)}this.metadata=e}initialize(){this.lifecycle=i.CONSTRUCTING}constructed(){this.lifecycle=i.CONSTRUCTED}destroy(){this.lifecycle=i.DESTROYED,this.propertiesByName.forEach(t=>t.destroy())}get initialized(){return this.lifecycle!==i.INITIALIZING}get(t){const e=this.propertiesByName.get(t);if(!f(e))return;const i=e.metadata.get;if(i)return e.getComputed(this,i);this.mutable&&a(e);const s=this.store;return s.has(t)?s.get(t):e.metadata.value}originOf(t){const e=this.store.originOf(t);if(void 0===e){const e=this.propertiesByName.get(t);if(void 0!==e&&e.flags&h.HasDefaultValue)return"defaults"}return r(e)}has(t){return this.propertiesByName.has(t)&&this.store.has(t)}keys(){return[...this.propertiesByName.keys()]}internalGet(t){const e=this.propertiesByName.get(t);if(f(e))return this.store.has(t)?this.store.get(t):e.metadata.value}internalSet(t,e){const i=this.propertiesByName.get(t);f(i)&&this._internalSet(i,e)}getDependsInfo(t,e,i){const r=this.propertiesByName.get(e);if(!f(r))return"";const n=new g,o=c(n,()=>r.metadata.get?.call(t));let a=`${i}${t.declaredClass.split(".").pop()}.${e}: ${o}\n`;const l=n.accessed??new Set;if(0===l.size)return a;i+="  ";for(const c of l){if(!(c instanceof s))continue;a+=`${i}${c.propertyName}: undefined\n`}return a}setAtOrigin(t,e,i){const s=this.propertiesByName.get(t);if(f(s))return this._setAtOrigin(s,e,i)}isOverridden(t){const e=this.propertiesByName.get(t);return void 0!==e&&!!(e.flags&h.Overridden)}clearOrigin(t,e){const i=this.store,s=this.propertiesByName.get(t);if(!f(s))return;const r=i.isAtOrigin(t,e)&&!(s.flags&h.Overridden);i.delete(t,e),r&&s.notifyChange()}clearOverride(t){const e=this.propertiesByName.get(t);e&&e.flags&h.Overridden&&(e.flags&=~h.Overridden,e.notifyChange())}override(t,e){const i=this.propertiesByName.get(t);if(!p(i,t,e,this))return;const s=i.metadata.cast;if(s){const t=this._cast(s,e),{valid:i,value:r}=t;if(d.release(t),!i)return;e=r}i.flags|=h.Overridden,this._internalSet(i,e)}set(t,e){const i=this.propertiesByName.get(t);if(!p(i,t,e,this))return;const s=i.metadata.cast;if(s){const t=this._cast(s,e),{valid:i,value:r}=t;if(d.release(t),!i)return;e=r}const r=i.metadata.set;r?r.call(this.host,e):this._internalSet(i,e)}setDefaultOrigin(t){this._origin=n(t)}getDefaultOrigin(){return r(this._origin)}notifyChange(t){const e=this.propertiesByName.get(t);void 0!==e&&e.notifyChange()}invalidate(t){const e=this.propertiesByName.get(t);void 0!==e&&e.invalidate()}commit(t){const e=this.propertiesByName.get(t);void 0!==e&&e.commit()}_internalSet(t,e){const s=this.lifecycle!==i.INITIALIZING?this._origin:0;this._setAtOrigin(t,e,s)}_setAtOrigin(e,i,s){const r=this.store,n=e.propertyName;if(r.isAtOrigin(n,s)&&t(i,r.get(n))&&~e.flags&h.Overridden)return;const o=r.isBelowOrigin(n,s)||r.isAtOrigin(n,s);o&&e.invalidate(),r.set(n,i,s),o&&e.commit(),l(this.host,e)}_cast(t,e){const i=d.acquire();return i.valid=!0,i.value=e,t&&(i.value=t.call(this.host,e,i)),i}}class u{constructor(){this.value=null,this.valid=!0}acquire(){this.valid=!0}release(){this.value=null}}const d=new e(()=>new u);export{m as default};
+import"../has.js";import{equals as t}from"../lang.js";import"../Logger.js";import e from"../ObjectPool.js";import{Lifecycle as i}from"./Lifecycle.js";import{Property as s}from"./Property.js";import{idToName as r,nameToId as n}from"./PropertyOrigin.js";import{Store as a}from"./Store.js";import{trackAccess as o,runTracked as c,initializeDependencyTracking as l}from"./tracking.js";import{Flags as h}from"./tracking/Flags.js";import{TrackingTarget as g}from"./tracking/TrackingTarget.js";function f(t,e,i){return void 0!==t}function p(t,e,s,r){return void 0!==t&&(!(null==s&&t.flags&h.NonNullable)||(r.lifecycle,i.INITIALIZING,!1))}class m{constructor(t){this.host=t,this.propertiesByName=new Map,this.ctorArgs=null,this.lifecycle=i.INITIALIZING,this.store=new a,this.mutable=!0,this._origin=7;const e=this.host.constructor.__accessorMetadata__;for(const i in e){const t=new s(i,e[i]);this.propertiesByName.set(i,t)}this.metadata=e}initialize(){this.lifecycle=i.CONSTRUCTING}constructed(){this.lifecycle=i.CONSTRUCTED}destroy(){this.lifecycle=i.DESTROYED,this.propertiesByName.forEach(t=>t.destroy())}get initialized(){return this.lifecycle!==i.INITIALIZING}get(t){const e=this.propertiesByName.get(t);if(!f(e))return;const i=e.metadata.get;if(i)return e.getComputed(this,i);this.mutable&&o(e);const s=this.store;return s.has(t)?s.get(t):e.metadata.value}originOf(t){const e=this.store.originOf(t);if(void 0===e){const e=this.propertiesByName.get(t);if(void 0!==e&&e.flags&h.HasDefaultValue)return"defaults"}return r(e)}has(t){return this.propertiesByName.has(t)&&this.store.has(t)}keys(){return[...this.propertiesByName.keys()]}internalGet(t){const e=this.propertiesByName.get(t);if(f(e))return this.store.has(t)?this.store.get(t):e.metadata.value}internalSet(t,e){const i=this.propertiesByName.get(t);f(i)&&this._internalSet(i,e)}getDependsInfo(t,e,i){const r=this.propertiesByName.get(e);if(!f(r))return"";const n=new g,a=c(n,()=>r.metadata.get?.call(t));let o=`${i}${t.declaredClass.split(".").pop()}.${e}: ${a}\n`;const l=n.accessed??new Set;if(0===l.size)return o;i+="  ";for(const c of l){if(!(c instanceof s))continue;o+=`${i}${c.propertyName}: undefined\n`}return o}setAtOrigin(t,e,i){const s=this.propertiesByName.get(t);if(f(s))return this._setAtOrigin(s,e,i)}isOverridden(t){const e=this.propertiesByName.get(t);return void 0!==e&&!!(e.flags&h.Overridden)}clearOrigin(t,e){const i=this.store,s=this.propertiesByName.get(t);if(!f(s))return;const r=i.isAtOrigin(t,e)&&!(s.flags&h.Overridden);i.delete(t,e),r&&s.notifyChange()}clearOverride(t){const e=this.propertiesByName.get(t);e&&e.flags&h.Overridden&&(e.flags&=~h.Overridden,e.notifyChange())}override(t,e){const i=this.propertiesByName.get(t);if(!p(i,t,e,this))return;const s=i.metadata.cast;if(s){const t=this._cast(s,e),{valid:i,value:r}=t;if(d.release(t),!i)return;e=r}i.flags|=h.Overridden,this._internalSet(i,e)}set(t,e){const i=this.propertiesByName.get(t);if(!p(i,t,e,this))return;const s=i.metadata.cast;if(s){const t=this._cast(s,e),{valid:i,value:r}=t;if(d.release(t),!i)return;e=r}const r=i.metadata.set;r?r.call(this.host,e):this._internalSet(i,e)}setDefaultOrigin(t){this._origin=n(t)}getDefaultOrigin(){return r(this._origin)}notifyChange(t){this.propertiesByName.get(t)?.notifyChange()}invalidate(t){this.propertiesByName.get(t)?.invalidate()}commit(t){this.propertiesByName.get(t)?.commit()}_internalSet(t,e){const s=this.lifecycle!==i.INITIALIZING?this._origin:0;this._setAtOrigin(t,e,s)}_setAtOrigin(e,i,s){const r=this.store,n=e.propertyName,a=r.isAtOrigin(n,s);if(a&&~e.flags&h.Overridden&&t(i,r.get(n)))return;const o=r.isBelowOrigin(n,s)||a;o&&e.invalidate(),r.set(n,i,s),o&&e.commit(),l(this.host,e)}_cast(t,e){const i=d.acquire();return i.valid=!0,i.value=e,t&&(i.value=t.call(this.host,e,i)),i}}class u{constructor(){this.value=null,this.valid=!0}acquire(){this.valid=!0}release(){this.value=null}}const d=new e(()=>new u);export{m as default};

package/core/accessorSupport/Property.js

@@ -2,4 +2,4 @@
 All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
 */
-import{ObservableBase as t}from"./ObservableBase.js";import{trackAccess as i,runTracked as s,trackExplicitDependencies as e,runUntracked as a}from"./tracking.js";import{Flags as o}from"./tracking/Flags.js";import{TrackingTarget as r}from"./tracking/TrackingTarget.js";class n extends t{constructor(t,i){super(),this.propertyName=t,this.metadata=i,this.trackingTarget=new r(this),this.flags=0,this.flags=o.Dirty|(i.nonNullable?o.NonNullable:0)|(i.hasOwnProperty("value")?o.HasDefaultValue:0)|(void 0===i.get?o.DepTrackingInitialized:0)|(void 0===i.dependsOn?o.AutoTracked:0)}destroy(){this.flags&o.Dirty&&this.onCommitted(),super.destroy(),this.trackingTarget.destroy()}getComputed(t,r){t.mutable&&i(this);const n=t.store,l=this.propertyName,g=this.flags,h=n.get(l);if(g&o.Computing)return h;if(~g&o.Dirty&&n.has(l))return h;this.flags|=o.Computing;const d=t.host;let m;g&o.AutoTracked?m=s(this.trackingTarget,r,d):(e(d,this),m=this.metadata.get.call(d)),this.flags|=o.DepTrackingInitialized,n.set(l,m,1);const c=n.get(l);return c===h?this.flags&=~o.Dirty:a(this.commit,this),this.flags&=~o.Computing,c}notifyChange(){this.onInvalidated(),this.onCommitted()}invalidate(){this.onInvalidated()}commit(){this.flags&=~o.Dirty,this.onCommitted()}onInvalidated(){~this.flags&o.Overridden&&(this.flags|=o.Dirty);const t=this._observers;if(t&&t.length>0)for(const i of t)i.onInvalidated()}onCommitted(){const t=this._observers;if(t&&t.length>0){const i=t.slice();for(const t of i)t.onCommitted()}}}export{n as Property};
+import{ObservableBase as t}from"./ObservableBase.js";import{trackAccess as i,runTracked as s,trackExplicitDependencies as e,runUntracked as o}from"./tracking.js";import{Flags as r}from"./tracking/Flags.js";import{TrackingTarget as a}from"./tracking/TrackingTarget.js";class n extends t{constructor(t,i){super(),this.propertyName=t,this.metadata=i,this.trackingTarget=new a(this),this.flags=0,this.flags=r.Dirty|(i.nonNullable?r.NonNullable:0)|(i.hasOwnProperty("value")?r.HasDefaultValue:0)|(void 0===i.get?r.DepTrackingInitialized:0)|(void 0===i.dependsOn?r.AutoTracked:0)}destroy(){this.flags&r.Dirty&&this.onCommitted(),super.destroy(),this.trackingTarget.destroy()}getComputed(t,a){t.mutable&&i(this);const n=t.store,l=this.propertyName,g=this.flags,h=n.get(l);if(g&r.Computing)return h;if(!(g&r.Dirty)&&n.has(l))return h;let d;this.flags|=r.Computing;const{host:m}=t;g&r.AutoTracked?d=s(this.trackingTarget,a,m):(e(m,this),d=a.call(m)),this.flags|=r.DepTrackingInitialized,n.set(l,d,1);const c=n.get(l);return c===h?this.flags&=~r.Dirty:o(this.commit,this),this.flags&=~r.Computing,c}notifyChange(){this.onInvalidated(),this.onCommitted()}invalidate(){this.onInvalidated()}commit(){this.flags&=~r.Dirty,this.onCommitted()}onInvalidated(){~this.flags&r.Overridden&&(this.flags|=r.Dirty);const t=this._observers;if(t&&t.length>0)for(const i of t)i.onInvalidated()}onCommitted(){const t=this._observers;if(t&&t.length>0){const i=t.slice();for(const t of i)t.onCommitted()}}}export{n as Property};

package/core/accessorSupport/PropertyOrigin.d.ts

@@ -0,0 +1,2 @@
+
+export type OriginName = "defaults" | "service" | "portal-item" | "web-scene" | "web-map" | "link-chart" | "user";

package/core/accessorSupport/decorators/subclass.js

@@ -2,4 +2,4 @@
 All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
 */
-import"../../has.js";import e from"../../Logger.js";import{beforeDestroySymbol as t}from"../beforeDestroy.js";import{Lifecycle as r}from"../Lifecycle.js";import{getPropertiesMetadata as o}from"../metadata.js";import{trackAccess as s}from"../tracking.js";import{processPrototypePropertyMetadata as i}from"../extensions/serializableProperty.js";const n=new Set,c=new Set;function a(e){return s=>{e??="esri.core.Accessor",s.prototype.declaredClass=e,p(s);const i=[],a=[];let l=s.prototype;for(;l;)l.hasOwnProperty("initialize")&&!n.has(l.initialize)&&(n.add(l.initialize),i.push(l.initialize)),l.hasOwnProperty("destroy")&&!c.has(l.destroy)&&(c.add(l.destroy),a.push(l.destroy)),l=Object.getPrototypeOf(l);n.clear(),c.clear();const u=class extends s{constructor(...e){if(super(...e),this.constructor===u&&"function"==typeof this.postscript){if(i.length&&Object.defineProperty(this,"initialize",{enumerable:!1,configurable:!0,value(){for(let e=i.length-1;e>=0;e--)i[e].call(this)}}),a.length){let e=!1;const o=this[t];Object.defineProperty(this,"destroy",{enumerable:!1,configurable:!0,value(){if(!e){this.__accessor__.lifecycle=r.DESTROYING,e=!0,o.call(this);for(let e=0;e<a.length;e++)a[e].call(this)}}})}Object.defineProperty(this,Symbol.dispose,{enumerable:!1,configurable:!0,value(){this.destroy()}}),this.postscript()}}};u.__accessorMetadata__=o(s.prototype),u.prototype.declaredClass=e;const f=(e||"AccessorSubclass").split(".").slice(-1)[0];return Object.defineProperty(u,"name",{value:f,configurable:!0}),u}}function l(e,{get:t,value:r}){return null==t?function(){const t=this.__accessor__,o=t.propertiesByName.get(e);if(void 0===o)return;t.mutable&&s(o);const i=t.store;return i.has(e)?i.get(e):r}:function(){const r=this.__accessor__;return r.propertiesByName.get(e)?.getComputed(r,t)}}function p(e){const t=e.prototype,s=o(t),n={};for(const o of Object.getOwnPropertyNames(s)){const e=s[o];i(e),n[o]={enumerable:!0,configurable:!0,get:l(o,e),set(t){const s=this.__accessor__;if(void 0!==s){if(s.mutable)return s.initialized&&e.readOnly?u("read-only",o):s.lifecycle===r.CONSTRUCTED&&e.constructOnly?u("construct-only",o):void s.set(o,t)}else Object.defineProperty(this,o,{enumerable:!0,configurable:!0,writable:!0,value:t})}}}Object.defineProperties(e.prototype,n)}const u=(t,r)=>{e.getLogger("esri.core.Accessor").error(`cannot assign to ${t} property '${r}'`)};export{p as finalizeClass,a as subclass};
+import"../../has.js";import e from"../../Logger.js";import{beforeDestroySymbol as t}from"../beforeDestroy.js";import{Lifecycle as r}from"../Lifecycle.js";import{getPropertiesMetadata as o}from"../metadata.js";import{trackAccess as s}from"../tracking.js";import{processPrototypePropertyMetadata as i}from"../extensions/serializableProperty.js";const n=new Set,c=new Set;function l(e){return s=>{e??="esri.core.Accessor",s.prototype.declaredClass=e,p(s);const i=[],l=[];let a=s.prototype;for(;a;)a.hasOwnProperty("initialize")&&!n.has(a.initialize)&&(n.add(a.initialize),i.push(a.initialize)),a.hasOwnProperty("destroy")&&!c.has(a.destroy)&&(c.add(a.destroy),l.push(a.destroy)),a=Object.getPrototypeOf(a);n.clear(),c.clear();const u=class extends s{constructor(...e){if(super(...e),this.constructor===u&&"function"==typeof this.postscript){if(i.length&&Object.defineProperty(this,"initialize",{enumerable:!1,configurable:!0,value(){for(let e=i.length-1;e>=0;e--)i[e].call(this)}}),l.length){let e=!1;const o=this[t];Object.defineProperty(this,"destroy",{enumerable:!1,configurable:!0,value(){if(!e){this.__accessor__.lifecycle=r.DESTROYING,e=!0,o.call(this);for(let e=0;e<l.length;e++)l[e].call(this)}}})}Object.defineProperty(this,Symbol.dispose,{enumerable:!1,configurable:!0,value(){this.destroy()}}),this.postscript()}}};u.__accessorMetadata__=o(s.prototype),u.prototype.declaredClass=e;const f=(e||"AccessorSubclass").split(".").slice(-1)[0];return Object.defineProperty(u,"name",{value:f,configurable:!0}),u}}function a(e,{get:t,value:r}){return null==t?function(){const t=this.__accessor__,o=t.propertiesByName.get(e);if(void 0===o)return;t.mutable&&s(o);const i=t.store;return i.has(e)?i.get(e):r}:function(){const r=this.__accessor__;return r.propertiesByName.get(e)?.getComputed(r,t)}}function u(e,t,r){Object.defineProperty(e,t,{enumerable:!0,configurable:!0,writable:!0,value:r})}function f(e,t){return t.readOnly&&t.constructOnly?function(o){const s=this.__accessor__;if(s){if(s.mutable)return s.initialized&&t.readOnly?y("read-only",e):s.lifecycle===r.CONSTRUCTED&&t.constructOnly?y("construct-only",e):void s.set(e,o)}else u(this,e,o)}:t.readOnly?function(r){const o=this.__accessor__;if(o){if(o.mutable)return o.initialized&&t.readOnly?y("read-only",e):void o.set(e,r)}else u(this,e,r)}:t.constructOnly?function(o){const s=this.__accessor__;if(s){if(s.mutable)return s.lifecycle===r.CONSTRUCTED&&t.constructOnly?y("construct-only",e):void s.set(e,o)}else u(this,e,o)}:function(t){const r=this.__accessor__;r?r.mutable&&r.set(e,t):u(this,e,t)}}function p(e){const t=e.prototype,r=o(t),s={};for(const o of Object.getOwnPropertyNames(r)){const e=r[o];i(e),s[o]={enumerable:!0,configurable:!0,get:a(o,e),set:f(o,e)}}Object.defineProperties(e.prototype,s)}const y=(t,r)=>{e.getLogger("esri.core.Accessor").error(`cannot assign to ${t} property '${r}'`)};export{p as finalizeClass,l as subclass};