@arcgis/lumina 4.33.0-next.97 → 4.33.0-next.99

package/dist/controllers/index.js

@@ -1,8 +1,6 @@
-import { C as Controller, s as setAmbientComponent, i as isPromise, a as setParentController, b as retrieveParentControllers, t as trackKey, w as watch, r as retrieveComponent, d as createEventFactory, P as PropTypes } from "../useWatch-CFtSpNnN.js";
-import { G, h, g, k, f, e } from "../useWatch-CFtSpNnN.js";
-import { u } from "../ControllerManager-B2comd8J.js";
-import { p as proxyExports } from "../proxyExports-Dl5CHmHQ.js";
-import { a, b, c, d, g as g2, r } from "../proxyExports-Dl5CHmHQ.js";
+import { C as Controller, s as setAmbientComponent, i as isPromise, e as setParentController, f as retrieveParentControllers, t as trackKey, r as retrieveComponent, g as createEventFactory } from "../Controller-CZ8Djohh.js";
+import { G, h, l, j, c, o, k, n, m } from "../Controller-CZ8Djohh.js";
+import { p as proxyExports } from "../proxyExports-CK5BLFLO.js";
 import { observeAncestorsMutation, isEsriInternalEnv, getElementAttribute, getElementLocales, startLocaleObserver } from "@arcgis/components-utils";
 const makeController = (constructor) => proxy(void 0, constructor);
 const makeGenericController = (constructor) => (component) => proxy(
@@ -135,11 +133,7 @@ const makeT9nController = (getAssetPath) => (options = {}) => (
   // eslint-disable-next-line @typescript-eslint/promise-function-async
   makeController((component, controller) => {
     const locale = getElementLocales(component.el);
-    const pending = {
-      _lang: locale.lang,
-      _t9nLocale: locale.t9nLocale,
-      _loading: true
-    };
+    const pending = { _lang: locale.lang, _t9nLocale: locale.t9nLocale, _loading: true };
     const componentWithOverrides = component;
     controller.onLifecycle(
       () => startLocaleObserver(
@@ -172,7 +166,11 @@ const makeT9nController = (getAssetPath) => (options = {}) => (
       controller.exports = updated;
     }
     if ("messageOverrides" in componentWithOverrides) {
-      controller.onLifecycle(() => watch(componentWithOverrides, "messageOverrides", applyOverrides));
+      controller.onUpdate((changes) => {
+        if (changes.has("messageOverrides")) {
+          applyOverrides(componentWithOverrides.messageOverrides);
+        }
+      });
     }
     if (options.blocking) {
       controller.setProvisionalExports(pending, false);
@@ -200,44 +198,31 @@ const usePropertyChange = (_component) => propertyChangeController;
 const eventName = "arcgisPropertyChange";
 function propertyChangeController(...toWatch) {
   const component = retrieveComponent();
-  const eventedComponent = component;
-  let eventEmitter = eventedComponent[eventName];
-  if (component.manager.isLit) {
-    eventEmitter = createEventFactory(eventName, void 0, component);
-    if (process.env.NODE_ENV !== "production" && isEsriInternalEnv()) {
-      if (typeof eventEmitter !== "object" || eventEmitter === null || !("emit" in eventEmitter) || typeof eventEmitter.emit !== "function") {
-        throw new Error(`Expected to find $createEvent static property on Lumina's LitElement"`);
-      }
-    }
-  }
+  const eventEmitter = createEventFactory(eventName, void 0, component);
   if (process.env.NODE_ENV !== "production" && isEsriInternalEnv()) {
-    if (typeof eventEmitter !== "object" || eventEmitter === null || !("emit" in eventEmitter) || typeof eventEmitter.emit !== "function") {
-      throw new Error(
-        `For consistency, usePropertyChange must be assigned to an arcgisPropertyChange property that has an @Event() decorator`
-      );
-    }
-    const allProps = new Set(
-      Object.entries(component.manager.internals.members).filter(([_name, [propType]]) => (propType & PropTypes.Prop) !== 0).map(([name]) => name)
-    );
     toWatch.forEach((prop) => {
-      if (!allProps.has(prop)) {
+      const descriptor = component.constructor.elementProperties.get(prop);
+      const isProp = descriptor !== void 0 && descriptor.state !== true;
+      if (!isProp) {
         throw new Error(
-          prop in component ? `For usePropertyChange to emit event on "${prop}" property change, you should add @${component.manager.isLit ? "property" : "Prop"}() to ${prop} in ${component.el.localName}` : `usePropertyChange can't emit event on "${prop}" property change as such property does not exist in ${component.el.localName}`
+          `For usePropertyChange to emit event on "${prop}" property change, you should add @property() to ${prop} in ${component.el.localName}`
         );
       }
     });
   }
-  component.manager.onLoad(
-    () => component.manager.onLifecycle(
-      () => toWatch.map(
-        (name) => (
-          // Casting to 'el' to simplify dynamic prop name typing
-          watch(component, name, () => eventEmitter.emit({ name }))
-        )
-      )
-    )
-  );
-  if (process.env.NODE_ENV !== "production" && isEsriInternalEnv() && component.manager.isLit) {
+  let isFirst = true;
+  component.manager.onUpdated((changes) => {
+    if (isFirst || !component.el.isConnected) {
+      isFirst = false;
+      return;
+    }
+    for (const name of toWatch) {
+      if (changes.has(name)) {
+        eventEmitter.emit({ name });
+      }
+    }
+  });
+  if (process.env.NODE_ENV !== "production" && isEsriInternalEnv()) {
     trackKey(
       component,
       (resolution) => {
@@ -255,29 +240,24 @@ function propertyChangeController(...toWatch) {
 export {
   Controller,
   G as GenericController,
-  a as bypassGetter,
-  b as bypassReadOnly,
-  c as bypassSetter,
-  h as controllerSymbol,
-  d as dynamicGetSet,
-  g2 as getSet,
-  g as isController,
+  h as bypassGetter,
+  l as bypassReadOnly,
+  j as bypassSetter,
+  c as controllerSymbol,
+  o as isController,
   k as keyTrackResolve,
   load,
   makeController,
   makeGenericController,
   makeT9nController,
   proxyExports,
-  r as readonly,
   retrieveComponent,
   toFunction,
   trackKey,
-  f as trackPropKey,
-  e as trackPropertyKey,
-  u as useControllerManager,
+  n as trackPropKey,
+  m as trackPropertyKey,
   useDirection,
   useMedia,
   usePropertyChange,
-  useWatchAttributes,
-  watch
+  useWatchAttributes
 };

package/dist/controllers/proxyExports.d.ts

@@ -24,4 +24,4 @@ import { ControllerLifecycleMethods } from './types';
  * is necessary for proxyExports() to receive a reference to your object
  * implicitly, and before any of your default values are assigned.
  */
-export declare const proxyExports: <Exports, const Parameters extends unknown[]>(Class: new (...args: Parameters) => ControllerLifecycleMethods & Pick<Controller<Exports>, "component" | "exports" | "watchExports">) => ((...args: Parameters) => Exports);
+export declare const proxyExports: <Exports, const Parameters extends unknown[]>(Class: new (...args: Parameters) => ControllerLifecycleMethods & Pick<Controller<Exports>, "component" | "exports" | "onUpdate" | "watchExports">) => ((...args: Parameters) => Exports);

package/dist/controllers/trackKey.d.ts

@@ -1,8 +1,8 @@
-import { TrackKeyResolution } from './ComponentInternals';
-import { BaseComponent, BaseController } from './types';
+import { LitElement } from '../LitElement';
+import { BaseController, TrackKeyResolution } from './types';
 /**
  * A combination of trackPropertyKey() and trackPropKey(). For usage when
  * you want to track a property, but don't know if it will be defined with the
- * \@Prop() decorator or not
+ * \@property() decorator or not
  */
-export declare function trackKey<T>(hostsCandidates: ((BaseComponent | BaseController)[] | BaseComponent | BaseController) | undefined, onResolved: (resolution: TrackKeyResolution | undefined) => void, defaultValue: T): T;
+export declare function trackKey<T>(hostsCandidates: ((BaseController | LitElement)[] | BaseController | LitElement) | undefined, onResolved: (resolution: TrackKeyResolution | undefined) => void, defaultValue: T): T;

package/dist/controllers/trackPropKey.d.ts

@@ -1,6 +1,6 @@
-import { BaseComponent } from './types';
+import { LitElement } from '../LitElement';
 /**
- * Like manager.trackPropertyKey(), but for props that have \@State() or \@Prop()
+ * Like trackPropertyKey(), but for props that have \@state() or \@property()
  * decorator
  *
  * @example
@@ -10,12 +10,12 @@ import { BaseComponent } from './types';
  *   return trackPropKey(component, (key)=>console.log(key), defaultValue);
  * }
  *
- * class MyComponent extends BaseComponent {
+ * class MyComponent extends LitElement {
  *   // Will console log "myProp"
- *   @Prop() myProp = trackMe();
+ *   \@property() myProp = trackMe();
  *
  *   // Will console log "myState"
- *   @State() myState = trackMe();
+ *   \@state() myState = trackMe();
  * }
  */
-export declare function trackPropKey<T>(component: BaseComponent, onResolved: (key: string | undefined) => void, defaultValue: T): T;
+export declare function trackPropKey<T>(component: LitElement, onResolved: (key: string | undefined) => void, defaultValue: T): T;

package/dist/controllers/trackPropertyKey.d.ts

@@ -1,25 +1,26 @@
-import { BaseComponent, BaseController } from './types';
+import { LitElement } from '../LitElement';
+import { BaseController } from './types';
 /**
  * A magical solution to finding out what property name a given controller
  * on a given object was assigned to.
  *
  * @remarks
- * This does not work for properties that have \@Prop() or \@State()
- * decorator - for those, use manager.trackPropKey() instead.
+ * This does not work for properties that have \@property() or \@state()
+ * decorator - for those, use trackPropKey() instead.
  *
  * @example
- * function trackMe<T>(defaultValue:T, component:BaseComponent):T {
- *   component.manager.trackPropertyKey(component, (key)=>console.log(key), defaultValue);
+ * function trackMe<T>(defaultValue: T, component: LitElement):T {
+ *   trackPropertyKey(component, (key)=>console.log(key), defaultValue);
  *   return defaultValue;
  * }
  *
- * class MyComponent extends BaseComponent {
+ * class MyComponent extends LitElement {
  *   // Will console log "myProp"
  *   myProp = trackMe('a', this);
  * }
  *
  */
-export declare function trackPropertyKey<T>(object: BaseComponent | BaseController, onResolved: (key: string | undefined) => void, defaultValue: T): T;
+export declare function trackPropertyKey<T>(object: BaseController | LitElement, onResolved: (key: string | undefined) => void, defaultValue: T): T;
 /**
  * Resolve all pending trackPropertyKey() calls. This must be called after a
  * property you are trying to resolve had it's default value set, thus after

package/dist/controllers/types.d.ts

@@ -1,20 +1,13 @@
 import { IHandle } from '@arcgis/components-utils';
 import { ReactiveControllerHost, ReactiveController, PropertyDeclaration, PropertyValues } from 'lit';
 import { LitElement } from '../LitElement';
-/**
- * Explicitly picking rather than extending everything because the interface
- * has "[memberName: string]: any;", which ruins type-safety of components
- *
- * @deprecated use LitElement instead
- */
-export type StencilLifecycles = {
-    connectedCallback?: () => void;
-    disconnectedCallback?: () => void;
-    componentWillLoad?: () => Promise<void> | void;
-    componentDidLoad?: () => void;
-    componentShouldUpdate?: (newVal: any, oldVal: any, propName: string) => boolean | void;
-    componentWillUpdate?: () => Promise<void> | void;
-    componentDidUpdate?: () => void;
+export type TrackKeyResolution = {
+    readonly key: string;
+    readonly host: BaseController | LitElement;
+    /**
+     * True if property is decorated with a `@state()` or `@property()` decorator
+     */
+    readonly isReactive: boolean;
 };
 /**
  * @deprecated use LitElement instead
@@ -28,9 +21,7 @@ export type BaseComponent = Omit<LitElement, "componentOnReady"> & {
  * "implements"
  * @example
  * const useHomeViewModel = makeViewModelController(newWidgetsHomeHomeViewModel);
- * export class Home implements Use<typeof useHomeViewModel> {
- * // No need for "implements BaseComponent" as that's already included in
- * // every controller
+ * export class Home extends LitElement implements Use<typeof useHomeViewModel> {
  *
  * @remarks
  * TypeScript detects errors even without Use<typeof useHomeViewModel>, but Use
@@ -38,33 +29,26 @@ export type BaseComponent = Omit<LitElement, "componentOnReady"> & {
  */
 export type Use<Callback extends (component: any) => unknown> = Parameters<Callback>[0];
 /**
- * Base API for a controller. Compatible with both Lit's Reactive controllers
- * and Stencil's lifecycle
+ * Base API for a controller. Compatible with Lit's Reactive controllers
  */
 export type ControllerLifecycleMethods = {
     readonly hostConnected?: ReactiveController["hostConnected"];
     readonly hostDisconnected?: ReactiveController["hostDisconnected"];
-    readonly hostLoad?: StencilLifecycles["componentWillLoad"];
-    readonly hostLoaded?: StencilLifecycles["componentDidLoad"];
+    readonly hostLoad?: () => Promise<void> | void;
+    readonly hostLoaded?: () => void;
     /**
      * Called during the client-side host update, just before the host calls
      * its own update.
      *
      * Code in `update()` can depend on the DOM as it is not called in
      * server-side rendering.
-     *
-     * @remarks
-     * The `changes` parameter will only be present in Lumina, not in Stencil
      */
-    readonly hostUpdate?: (changes: PropertyValues) => void;
+    hostUpdate?(changes: PropertyValues): void;
     /**
      * Called after a host update, just before the host calls firstUpdated and
      * updated. It is not called in server-side rendering.
-     *
-     * @remarks
-     * The `changes` parameter will only be present in Lumina, not in Stencil
      */
-    readonly hostUpdated?: (changes: PropertyValues) => void;
+    hostUpdated?(changes: PropertyValues): void;
     /**
      * Called when the component is finally being destroyed (rather than
      * temporary disconnected from the DOM)
@@ -92,6 +76,8 @@ export type ControllerLifecycleMethods = {
  * Controller host interface, compatible with both Lit's Reactive controllers
  * and Stencil's lifecycle.
  * These members are added to the component instance by ControllerManager.
+ *
+ * @deprecated use LitElement instead
  */
 export type ControllerHost = {
     /**
@@ -110,10 +96,6 @@ export type ControllerHost = {
      * be waited on via the `updateComplete` property.
      *
      * @remarks
-     * In Stencil:
-     * This method will re-render your component. All passed parameters are ignored
-     *
-     * In Lit:
      * It is recommended to provide the property name describing what property
      * triggered the update - property name will be provided to the willUpdate()
      * lifecycle hook, giving it the ability to react to the change.
@@ -135,18 +117,6 @@ export declare const controllerSymbol: unique symbol;
 export type BaseController = ControllerLifecycleMethods & {
     readonly [controllerSymbol]?: true;
 };
-/**
- * A reference to Lit's map of changed properties that triggered the update
- */
-export type LitElementWithChangedPropertiesMap = {
-    $changes: PropertyValues;
-};
-/**
- * An event emitter object
- */
-export type EventEmitter<T = undefined> = {
-    emit(payload: T extends undefined ? void : T): CustomEvent<T>;
-};
 /**
  * Property declaration with additional `reaDonly` option (handled by Controllers)
  */

package/dist/controllers/usePropertyChange.d.ts

@@ -1,5 +1,6 @@
-import { BaseComponent, EventEmitter } from './types';
-type PropertyChangeController<Component extends BaseComponent> = <ToWatch extends keyof Component>(...toWatch: ToWatch[]) => EventEmitter<{
+import { EventEmitter } from '../createEvent';
+import { LitElement } from '../LitElement';
+type PropertyChangeController<Component extends LitElement> = <ToWatch extends keyof Component>(...toWatch: ToWatch[]) => EventEmitter<{
     name: ToWatch & string;
 }>;
 /**
@@ -7,5 +8,5 @@ type PropertyChangeController<Component extends BaseComponent> = <ToWatch extend
  *
  * Documentation: https://qawebgis.esri.com/components/lumina/controllers/usePropertyChange
  */
-export declare const usePropertyChange: <Component extends BaseComponent>(_component?: BaseComponent) => PropertyChangeController<Component>;
+export declare const usePropertyChange: <Component extends LitElement>(_component?: LitElement) => PropertyChangeController<Component>;
 export {};

package/dist/controllers/useT9n.d.ts

@@ -10,7 +10,7 @@ export type T9nMeta<T9nStrings extends GenericT9nStrings> = {
      * @example
      * ```ts
      *   // Type of the messageOverrides is set automatically based on _overrides:
-     *   @Prop() messageOverrides?: typeof this.messages._overrides;
+     *   @property() messageOverrides?: typeof this.messages._overrides;
      * ```
      */
     _overrides: DeepPartial<T9nStrings>;

package/dist/createEvent.d.ts

@@ -1,4 +1,9 @@
-import { BaseComponent, EventEmitter } from './controllers/types';
+/**
+ * An event emitter object
+ */
+export type EventEmitter<T = undefined> = {
+    emit(payload: T extends undefined ? void : T): CustomEvent<T>;
+};
 /**
  * While these defaults don't match DOM defaults (all false), they match
  * Stencil and Shoelace defaults. Also, they make more sense for our
@@ -27,7 +32,7 @@ export type EventOptions = {
      */
     composed?: boolean;
 };
-export declare const createEventFactory: <T = undefined>(eventName?: string, options?: EventOptions, component?: BaseComponent) => EventEmitter<T>;
+export declare const createEventFactory: <T = undefined>(eventName?: string, options?: EventOptions, component?: import('./LitElement').LitElement) => EventEmitter<T>;
 /**
  * Creates an event emitter.
  * Events emitted by your component will be included in the documentation.

package/dist/hmrSupport.js

@@ -1,4 +1,4 @@
-import { n as noShadowRoot, P as ProxyComponent } from "./utils-GhKD5Lo-.js";
+import { n as noShadowRoot, P as ProxyComponent } from "./utils-DBdf1Dqp.js";
 import { camelToKebab } from "@arcgis/components-utils";
 function handleHmrUpdate(newModules) {
   newModules.forEach((newModule) => {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { useContextProvider, useContextConsumer } from './context';
-export type { EventOptions } from './createEvent';
+export type { EventEmitter, EventOptions } from './createEvent';
 export { createEvent } from './createEvent';
 export { state, property, method } from './decorators';
 export type { DefineCustomElements, LazyLoadOptions, GlobalThisWithPuppeteerEnv } from './lazyLoad';