@arcgis/api-extractor 5.2.0-next.13 → 5.2.0-next.130

package/LICENSE.md

@@ -1,12 +1,14 @@
 # Licensing
 
-COPYRIGHT © Esri
+COPYRIGHT Esri
 
 All rights reserved under the copyright laws of the United States and applicable international laws, treaties, and conventions.
 
-This material is licensed for use under the [Esri Master License Agreement (MLA)](https://www.esri.com/content/dam/esrisites/en-us/media/legal/ma-full/ma-full.pdf), and is bound by the terms of that agreement.
+This material is licensed for use under the Esri Master License Agreement (MLA), and is bound by the terms of that agreement.
 You may redistribute and use this code without modification, provided you adhere to the terms of the MLA and include this copyright notice.
 
+See use restrictions at https://www.esri.com/content/dam/esrisites/en-us/media/legal/ma-full/ma-full.pdf.
+
 For additional information, contact:
 Environmental Systems Research Institute, Inc.
 Attn: Contracts and Legal Services Department

package/README.md

@@ -8,5 +8,5 @@ It is not intended to be used directly, but rather used as a dependency by other
 
 ## License
 
-This package is licensed under the terms described in the `LICENSE.md` file, located in the root of the package, and at https://js.arcgis.com/5.1/LICENSE.txt.
-For third party notices, see https://js.arcgis.com/5.1/third-party-notices.txt.
+This package is licensed under the terms described in the `LICENSE.md` file, located in the root of the package, and at https://js.arcgis.com/5.2/LICENSE.txt.
+For third party notices, see https://js.arcgis.com/5.2/third-party-notices.txt.

package/dist/apiJson.d.ts

@@ -452,23 +452,14 @@ export interface ApiWithInheritance {
 }
 
 /** @see [MDN Slot](https://developer.mozilla.org/docs/Web/HTML/Element/slot) */
-export interface ApiSlot extends ApiWithDescription, ApiWithUnusedSummary {
+export interface ApiSlot extends ApiWithDescription, ApiWithDocsTags, ApiWithDeprecated, ApiWithUnusedSummary {
   /**
    * The slot name, or the empty string for an unnamed slot.
    *
    * @example "header"
    */
   name: string;
-  /**
-   * Whether the slot is deprecated.
-   * If the value is a string, it's the reason for the deprecation.
-   *
-   * @deprecated
-   * Not used by `@arcgis/api-extractor`. Preserved in types for compatibility
-   * with custom-elements-manifest.
-   * @default false
-   */
-  deprecated?: string | true;
+  type?: ApiType;
 }
 
 /**
@@ -476,19 +467,10 @@ export interface ApiSlot extends ApiWithDescription, ApiWithUnusedSummary {
  *
  * @see https://developer.mozilla.org/docs/Web/CSS/CSS_shadow_parts
  */
-export interface ApiCssPart extends ApiWithDescription, ApiWithUnusedSummary {
+export interface ApiCssPart extends ApiWithDescription, ApiWithDocsTags, ApiWithDeprecated, ApiWithUnusedSummary {
   /** @example "tab" */
   name: string;
-  /**
-   * Whether the CSS shadow part is deprecated.
-   * If the value is a string, it's the reason for the deprecation.
-   *
-   * @deprecated
-   * Not used by `@arcgis/api-extractor`. Preserved in types for compatibility
-   * with custom-elements-manifest.
-   * @default false
-   */
-  deprecated?: string | true;
+  type?: ApiType;
 }
 
 /**
@@ -496,7 +478,7 @@ export interface ApiCssPart extends ApiWithDescription, ApiWithUnusedSummary {
  *
  * @see https://developer.mozilla.org/docs/Web/API/CustomStateSet
  */
-export interface ApiCssCustomState extends ApiWithDescription, ApiWithUnusedSummary {
+export interface ApiCssCustomState extends ApiWithDescription, ApiWithDocsTags, ApiWithDeprecated, ApiWithUnusedSummary {
   /**
    * The name of the state. Note: Unlike CSS custom properties, custom states
    * do not have a leading `--`.
@@ -504,55 +486,28 @@ export interface ApiCssCustomState extends ApiWithDescription, ApiWithUnusedSumm
    * @example "active"
    */
   name: string;
-  /**
-   * Whether the CSS custom state is deprecated.
-   * If the value is a string, it's the reason for the deprecation.
-   *
-   * @deprecated
-   * Not used by `@arcgis/api-extractor`. Preserved in types for compatibility
-   * with custom-elements-manifest.
-   * @default false
-   */
-  deprecated?: string | true;
 }
 
-export interface ApiCssCustomProperty extends ApiWithDescription, ApiWithUnusedSummary {
+export interface ApiCssCustomProperty extends ApiWithDescription, ApiWithDocsTags, ApiWithDeprecated, ApiWithUnusedSummary {
   /**
    * The name of the property, including leading `--`.
    *
    * @example "--calcite-text-color"
    */
   name: string;
+  type?: ApiType;
   /**
-   * The expected syntax of the defined property. Defaults to "*".
-   *
-   * The syntax must be a valid CSS
-   * [syntax string](https://developer.mozilla.org/docs/Web/CSS/@property/syntax)
-   * as defined in the CSS Properties and Values API.
-   *
-   * Examples:
-   *
-   * "<color>": accepts a color
-   * "<length> | <percentage>": accepts lengths or percentages but not calc expressions with a combination of the two
-   * "small | medium | large": accepts one of these values set as custom indents.
-   * "*": any valid token
+   * A [CSS syntax string](https://developer.mozilla.org/en-US/docs/Web/CSS/@property/syntax)
    *
    * @deprecated
    * Not used by `@arcgis/api-extractor`. Preserved in types for compatibility
    * with custom-elements-manifest.
+   *
+   * We use [ApiCssCustomProperty](https://developers.arcgis.com/javascript/latest/references/api-extractor/apiJson/#ApiCssCustomProperty-) instead, which is more
+   * powerful, and we have existing utils for dealing with it.
    */
   syntax?: string;
   default?: string;
-  /**
-   * Whether the CSS custom property is deprecated.
-   * If the value is a string, it's the reason for the deprecation.
-   *
-   * @deprecated
-   * Not used by `@arcgis/api-extractor`. Preserved in types for compatibility
-   * with custom-elements-manifest.
-   * @default false
-   */
-  deprecated?: string | true;
 }
 
 export interface ApiType extends ApiWithUnusedSource {
@@ -646,6 +601,7 @@ export interface ApiTypeParameter {
 /** The common interface of classes and mixins. */
 export interface ApiClassDeclaration extends ApiObjectLikeDeclaration, ApiWithEvents {
   kind: "class";
+  abstract?: true;
   /**
    * The superclass of this class.
    *
@@ -775,7 +731,7 @@ export interface ApiCustomElementField extends ApiClassField {
    *
    * > Not present in vanilla custom-elements-manifest.
    *
-   * @deprecated fuse regular .readonly field instead
+   * @deprecated use regular .readonly field instead
    * @default false
    */
   docsOnlyReadonly?: true;