@arcgis/lumina 4.32.0-next.20 → 4.32.0-next.22

package/dist/jsx/jsx.d.ts

@@ -27,13 +27,13 @@ export declare const Fragment: (props: {
     children?: JsxNode;
 }) => TemplateResult;
 /**
- * @internal
+ * @private
  * The references to this function are removed at build time. You do not need
  * to import it directly
  */
 export declare function jsx(type: string, props: unknown, key?: unknown): JsxNode;
 /**
- * @internal
+ * @private
  * The references to this function are removed at build time. You do not need
  * to import it directly
  */
@@ -200,6 +200,26 @@ export type ToElement<Component> = Omit<Component, LuminaJsx.ExcludedProperties>
 export type ToJsx<Component extends {
     el: unknown;
 }> = LuminaJsx.HTMLAttributes<Component["el"]> & LuminaJsx.RemapEvents<Component> & Partial<Omit<Component, LuminaJsx.ExcludedProperties | keyof HTMLElement | keyof LuminaJsx.RemapEvents<Component>>>;
+/**
+ * This interface will be automatically extended in src/lumina.ts files to add
+ * typings for Stencil elements usages in Lumina. You do not need to manually
+ * extend this interface.
+ *
+ * @example
+ * ```ts
+ * import type { JSX as CalciteJSX } from "@esri/calcite-components/dist/types/components";
+ * import type { JSX as CommonComponentsJsx } from "@arcgis/common-components/dist/types/components";
+ *
+ * declare module "@arcgis/lumina" {
+ *   interface ImportStencilElements
+ *     extends CalciteJSX.IntrinsicElements,
+ *     CommonComponentsJsx.IntrinsicElements {
+ *   }
+ * }
+ * ```
+ */
+export interface ImportStencilElements {
+}
 /**
  * Get the type of all events for a given component. Includes native DOM events
  * and custom events.
@@ -207,9 +227,9 @@ export type ToJsx<Component extends {
  * @example
  * ```tsx
  * render() {
- *   return <arcgis-counter onArcgisOverflow={this._handleOverflow} />
+ *   return <arcgis-map onArcgisViewClick={this._handleViewClick} />
  * }
- * _handleOverflow(event: ToEvents<ArcgisCounter>["arcgisOverflow"]) {
+ * _handleViewClick(event: ToEvents<HTMLArcgisMapElement>["arcgisViewClick"]) {
  *   // event.detail
  *   // event.currentTarget
  * }
@@ -251,6 +271,12 @@ type GlobalEventTypes<Target = HTMLElement> = {
 type ListenerToPayloadType<Listener> = unknown extends Listener ? void : Listener extends {
     emit: (...rest: never[]) => infer PayloadType;
 } ? PayloadType : Listener extends CustomEvent ? Listener : void;
+/**
+ * Defined Lumina custom elements. This interface is used only for internal
+ * type-checking only.
+ */
+export interface DeclareElements {
+}
 /**
  * These typings are based on dom-expressions typings:
  * https://github.com/ryansolid/dom-expressions/blob/main/packages/dom-expressions/src/jsx.d.ts
@@ -306,7 +332,7 @@ export declare namespace LuminaJsx {
          */
         key?: unknown;
     }
-    interface IntrinsicElements extends HTMLElementTags, SVGElementTags, ReMappedComponents<globalThis.DeclareElements>, Omit<ReMapStencilComponents<globalThis.ImportStencilElements>, keyof HTMLElementTags | keyof SVGElementTags> {
+    interface IntrinsicElements extends HTMLElementTags, SVGElementTags, ReMappedComponents<DeclareElements>, Omit<ReMapStencilComponents<ImportStencilElements>, keyof HTMLElementTags | keyof SVGElementTags> {
     }
     /**
      * By not requiring to have some sort of typings generation watcher to run
@@ -842,6 +868,7 @@ export declare namespace LuminaJsx {
     }
     interface HTMLAttributes<T = HTMLElement> extends AriaAttributes, DOMAttributes<T>, RdfaAttributes {
         accessKey?: string;
+        autofocus?: boolean;
         dir?: HTMLDir;
         draggable?: boolean;
         hidden?: boolean | "hidden" | "until-found";
@@ -921,7 +948,6 @@ export declare namespace LuminaJsx {
         cite?: string;
     }
     interface ButtonHTMLAttributes<T> extends HTMLAttributes<T> {
-        autofocus?: boolean;
         disabled?: boolean;
         form?: string;
         name?: string;
@@ -1030,7 +1056,6 @@ export declare namespace LuminaJsx {
         autocomplete?: AutoFill;
         accept?: string;
         alt?: string;
-        autofocus?: boolean;
         capture?: boolean | string;
         checked?: boolean;
         disabled?: boolean;
@@ -1312,7 +1337,6 @@ export declare namespace LuminaJsx {
         referrerPolicy?: HTMLReferrerPolicy;
     }
     interface SelectHTMLAttributes<T> extends HTMLAttributes<T> {
-        autofocus?: boolean;
         disabled?: boolean;
         form?: string;
         multiple?: boolean;
@@ -1349,7 +1373,6 @@ export declare namespace LuminaJsx {
     }
     interface TextareaHTMLAttributes<T> extends HTMLAttributes<T> {
         children?: "Error: Use value property instead. See https://lit.dev/docs/templates/expressions/#invalid-locations";
-        autofocus?: boolean;
         cols?: number | string;
         dirname?: string;
         disabled?: boolean;

package/dist/lazyLoad.d.ts

@@ -2,7 +2,6 @@ import { Deferred } from "@arcgis/components-utils";
 import type { LitElement } from "./LitElement";
 import type { Runtime } from "./runtime";
 import type { ControllerManager } from "@arcgis/components-controllers";
-import type { PublicLitElement } from "./PublicLitElement";
 /**
  * Defines lazy-loading proxy components for all web components in this package.
  *
@@ -16,6 +15,9 @@ export interface DefineCustomElements {
 export type LazyLoadOptions = {
     readonly resourcesUrl?: string;
 };
+interface CommonInterface extends HTMLElement {
+    componentOnReady: () => Promise<this>;
+}
 export declare const makeDefineCustomElements: (runtime: Runtime, structure: Readonly<Record<string, CompactMeta>>) => DefineCustomElements;
 /**
  * Use compact meta to reduce bundle size (otherwise, it would be ~65kb for
@@ -106,7 +108,7 @@ export declare abstract class ProxyComponent extends HtmlElement {
     /**
      * Direct offspring that should be awaited before loaded() is emitted
      */
-    _offspring: (PublicLitElement & {
+    _offspring: (CommonInterface & {
         manager?: LitElement["manager"];
     })[];
     /**
@@ -153,7 +155,16 @@ export declare abstract class ProxyComponent extends HtmlElement {
     componentOnReady(): Promise<this>;
     /** @internal */
     _initializeComponent(module: Record<string, typeof LitElement>): void;
+    /**
+     * Implemented on the proxy for compatibility with Lit Context.
+     */
+    addController(): void;
+    /**
+     * Implemented on the proxy for compatibility with Lit Context.
+     */
+    requestUpdate(): void;
 }
+/** @private */
 export type GlobalThisWithPuppeteerEnv = typeof globalThis & {
     devOnly$createdElements?: WeakRef<ProxyComponent>[];
 };

package/dist/runtime.d.ts

@@ -92,6 +92,8 @@ export declare function makeRuntime(options?: RuntimeOptions): Runtime;
 /**
  * Exposing the reference to the runtime globally when in tests or development.
  * This is primarily for usage by dynamically created components in tests
+ *
+ * @private
  */
 export type DevOnlyGlobalRuntime = typeof globalThis & {
     devOnly$luminaRuntime?: Runtime;
@@ -99,6 +101,8 @@ export type DevOnlyGlobalRuntime = typeof globalThis & {
 /**
  * Called from the component constructor when in development or test mode.
  * Used primarily by mount to get a reference to the rendered component.
+ *
+ * @private
  */
 export type DevOnlyGlobalComponentRefCallback = typeof globalThis & {
     devOnly$luminaComponentRefCallback?: (component: LitElement) => void;

package/dist/typings/jsxGlobals.d.ts

@@ -1,4 +1,8 @@
-export {};
+/**
+ * This file is used for internal type checking only. It should not be
+ * referenced in public types of your package to not pollute the global types
+ * namespace
+ */
 declare global {
     /**
      * This interface will be extended in each source file that defines a LitElement.
@@ -19,23 +23,17 @@ declare global {
     };
     interface HTMLElementTagNameMap extends ReMappedDeclareElements {
     }
-    /**
-     * Extend this interface with Stencil web components that you wish to use
-     * in Lit
-     *
-     * @example
-     * ```ts
-     * import type { JSX as CalciteJSX } from "@esri/calcite-components/dist/types/components";
-     * import type { JSX as CommonComponentsJsx } from "@arcgis/common-components/dist/types/components";
-     *
-     * declare global {
-     *   interface ImportStencilElements
-     *     extends CalciteJSX.IntrinsicElements,
-     *     CommonComponentsJsx.IntrinsicElements {
-     *   }
-     * }
-     * ```
-     */
-    export interface ImportStencilElements {
+}
+export interface DeclareElements extends globalThis.DeclareElements {
+}
+/**
+ * In the component files, we declare "DeclareElements" interface on the
+ * `declare global` namespace as it's shorter than writing
+ * `declare module "@arcgis/lumina"`. However, we want to avoid polluting
+ * global typings with this interface - thus we use namespace merging to
+ * extend the namespaced DeclareElements based on the global DeclareElements.
+ */
+declare module "../jsx/jsx" {
+    interface DeclareElements extends globalThis.DeclareElements {
     }
 }

package/dist/wrappersUtils.d.ts

@@ -5,5 +5,7 @@
  * Because the custom element may not yet be defined in global scope when
  * `createPrototypeProxy()` is called, this small proxy delays retrieving the custom
  * element prototype until it is actually needed, and caches the result for future calls.
+ *
+ * @private
  */
 export declare function createPrototypeProxy<T extends HTMLElement>(tagName: string): new () => T;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/lumina",
-  "version": "4.32.0-next.20",
+  "version": "4.32.0-next.22",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -8,6 +8,7 @@
   "exports": {
     ".": "./dist/index.js",
     "./config": "./dist/config.js",
+    "./hmrSupport": "./dist/hmrSupport.js",
     "./stencilSsrCompatibility": "./dist/stencilSsrCompatibility/index.js",
     "./typings": {
       "types": "./dist/typings/index.d.ts"
@@ -19,10 +20,11 @@
   ],
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
-    "@arcgis/components-controllers": "4.32.0-next.20",
-    "@arcgis/components-utils": "4.32.0-next.20",
+    "@arcgis/components-controllers": "4.32.0-next.22",
+    "@arcgis/components-utils": "4.32.0-next.22",
     "@lit-labs/ssr": "^3.2.2",
     "@lit-labs/ssr-client": "^1.1.7",
+    "@lit/context": "^1.1.3",
     "csstype": "^3.1.3",
     "lit": "^3.2.0",
     "tslib": "^2.7.0"