[#3857]: Upgrade stencil

packages/canary-docs/docs.d.ts

@@ -1,4 +1,3 @@
-
 /**
  * This is an autogenerated file created by the Stencil compiler.
  * DO NOT MODIFY IT MANUALLY
@@ -21,7 +20,10 @@ interface ComponentCompilerPropertyComplexType {
    */
   references: ComponentCompilerTypeReferences;
 }
-type ComponentCompilerTypeReferences = Record<string, ComponentCompilerTypeReference>;
+type ComponentCompilerTypeReferences = Record<
+  string,
+  ComponentCompilerTypeReference
+>;
 interface ComponentCompilerTypeReference {
   /**
    * A type may be defined:
@@ -38,6 +40,17 @@ interface ComponentCompilerTypeReference {
    * An ID for this type which is unique within a Stencil project.
    */
   id: string;
+  /**
+   * Whether this type was imported as a default import (e.g., `import MyEnum from './my-enum'`)
+   * vs a named import (e.g., `import { MyType } from './my-type'`)
+   */
+  isDefault?: boolean;
+  /**
+   * The name used in the import statement (before any user-defined alias).
+   * For `import { XAxisOption as moo }`, this would be "XAxisOption".
+   * This is the name exported by the source module.
+   */
+  referenceLocation?: string;
 }
 interface ComponentCompilerReferencedType {
   /**
@@ -75,7 +88,10 @@ interface ComponentCompilerMethodComplexType {
  * This information is included in the file written by the `docs-json` output
  * target (see {@link JsonDocs.typeLibrary}).
  */
-export type JsonDocsTypeLibrary = Record<string, ComponentCompilerReferencedType>;
+export type JsonDocsTypeLibrary = Record<
+  string,
+  ComponentCompilerReferencedType
+>;
 /**
  * A container for JSDoc metadata for a project
  */
@@ -196,6 +212,10 @@ export interface JsonDocsComponent {
    * Array of component Parts information, generate from `@part` tags
    */
   parts: JsonDocsPart[];
+  /**
+   * Array of custom states defined via @AttachInternals({ states: {...} })
+   */
+  customStates: JsonDocsCustomState[];
   /**
    * Array of metadata describing where the current component is used
    */
@@ -413,6 +433,28 @@ export interface JsonDocsPart {
    */
   docs: string;
 }
+/**
+ * A descriptor for a Custom State defined via @AttachInternals({ states: {...} })
+ *
+ * Custom states are exposed via the ElementInternals.states CustomStateSet
+ * and can be targeted with the CSS `:state()` pseudo-class.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/CustomStateSet
+ */
+export interface JsonDocsCustomState {
+  /**
+   * The name of the custom state (without dashes)
+   */
+  name: string;
+  /**
+   * The initial/default value of the state
+   */
+  initialValue: boolean;
+  /**
+   * A textual description of the custom state
+   */
+  docs: string;
+}
 /**
  * Represents a parsed block comment in a CSS, Sass, etc. file for a custom property.
  */