@geoscene/map-components 4.34.9 → 5.0.20

package/dist/components/geoscene-daylight/customElement.d.ts

@@ -1,257 +1,292 @@
-/// <reference types="@geoscene/core/interfaces.d.ts" />
 /// <reference path="../../index.d.ts" />
-import { Use } from '@geoscene/lumina/controllers';
-import { PublicLitElement as LitElement, JsxNode, TargetedEvent } from '@geoscene/lumina';
-import { GeosceneReferenceElement } from '../../utils/component-utils';
-import { HeadingLevel } from '../../support/heading';
-import { Season } from './daylight-utils';
-import { useView } from '../../controllers/useView';
-import { default as SceneView } from '@geoscene/core/views/SceneView';
-import { PropertyValues } from 'lit';
+import type SceneView from "@geoscene/core/views/SceneView.js";
+import type { PublicLitElement as LitElement } from "@geoscene/lumina";
+import type { GeosceneReferenceElement, HeadingLevel } from "../types.js";
+import type { Season } from "./types.js";
+import type { T9nMeta } from "@geoscene/lumina/controllers";
+import type { Icon as Icon } from "@geoscene/calcite-components/components/calcite-icon";
 
 /**
- * The Daylight component can be used to manipulate the lighting conditions of a
- * [Scene](https://doc.geoscene.cn/javascript/4.33/references/map-components/geoscene-scene/).
+ * The Daylight component can be used to manipulate the lighting conditions of an
+ * [geoscene-scene](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-scene/).
  * To achieve this, the component modifies the `lighting` property of the
- * [environment](https://doc.geoscene.cn/javascript/4.33/references/map-components/geoscene-scene/#environment) of the Scene component.
+ * [geoscene-scene.environment](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-scene/#environment) of the Scene component.
  *
  * To illuminate the scene, one can either use a configuration of date and time to position the
- * [sun](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-3d-environment-SunLighting.html) or switch to the
- * [virtual](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-3d-environment-VirtualLighting.html) mode,
+ * [sun](https://doc.geoscene.cn/javascript/5.0/references/core/views/3d/environment/SunLighting/) or switch to the
+ * [virtual](https://doc.geoscene.cn/javascript/5.0/references/core/views/3d/environment/VirtualLighting/) mode,
  * where the light source is relative to the camera.
  *
- * When illuminating the scene with **[sunlight](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-3d-environment-SunLighting.html)**
+ * When illuminating the scene with **[sunlight](https://doc.geoscene.cn/javascript/5.0/references/core/views/3d/environment/SunLighting/)**
  * and adjusting the time and date, the positions of the sun and stars are updated accordingly. This also updates the
- * [date](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-3d-environment-SunLighting.html#date) property of
- * [environment.lighting](https://doc.geoscene.cn/javascript/4.33/references/map-components/geoscene-scene/#environment).
+ * [date](https://doc.geoscene.cn/javascript/5.0/references/core/views/3d/environment/SunLighting/#date) property of
+ * [geoscene-scene.environment](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-scene/#environment).
  *
- * [![daylight-default](https://doc.geoscene.cn/javascript/4.33/assets/img/apiref/components/daylight/daylight-default.png)](https://doc.geoscene.cn/javascript/4.33/sample-code/daylight/)
+ * [![daylight-default](https://doc.geoscene.cn/javascript/5.0/assets/references/core/components/daylight/daylight-default.png)](https://doc.geoscene.cn/javascript/5.0/sample-code/daylight/)
  *
  * The component has an option to select the timezone. When the user makes any adjustments here, a new time
  * in the chosen timezone is calculated and displayed in the slider. The timezone selector can be disabled
- * by using the [hideTimezone](#hideTimezone) property.
+ * by using the [hideTimezone](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-daylight/#hideTimezone) property.
  *
  * By default, a calendar is displayed to select the day, month, and year.
- * With the [dateOrSeason](#dateOrSeason) property, the calendar can be replaced with
+ * With the [dateOrSeason](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-daylight/#dateOrSeason) property, the calendar can be replaced with
  * a dropdown menu where a season can be selected instead:
  *
- * ![daylight-seasons](https://doc.geoscene.cn/javascript/4.33/assets/img/apiref/components/daylight/daylight-seasons.png)
+ * ![daylight-seasons](https://doc.geoscene.cn/javascript/5.0/assets/references/core/components/daylight/daylight-seasons.png)
  *
  * There are two play buttons: one corresponds to the time-of-day slider and animates the lighting
  * over the course of a day, while the other corresponds to the date picker
  * and animates the lighting over the course of a year (month by month). The speed of the time-of-day animation can
- * be set using the [playSpeedMultiplier](#playSpeedMultiplier) property.
+ * be set using the [playSpeedMultiplier](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-daylight/#playSpeedMultiplier) property.
  *
- * ![daylight-animation](https://doc.geoscene.cn/javascript/4.33/assets/img/apiref/components/daylight/daylight-animation.gif)
+ * ![daylight-animation](https://doc.geoscene.cn/javascript/5.0/assets/references/core/components/daylight/daylight-animation.gif)
  *
  * Except for the daytime slider, all the elements in the Daylight component can be hidden:
  *
- * ![daylight-no-elements](https://doc.geoscene.cn/javascript/4.33/assets/img/apiref/components/daylight/daylight-no-elements.png)
+ * ![daylight-no-elements](https://doc.geoscene.cn/javascript/5.0/assets/references/core/components/daylight/daylight-no-elements.png)
  *
  * Whenever the sun position option is unchecked, the scene applies the
- * **[virtual light](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-3d-environment-VirtualLighting.html)** source relative to the camera.
+ * **[virtual light](https://doc.geoscene.cn/javascript/5.0/references/core/views/3d/environment/VirtualLighting/)** source relative to the camera.
  * With this, the component's time slider, timezone, and date picker get automatically disabled:
  *
- * ![daylight-virtual](https://doc.geoscene.cn/javascript/4.33/assets/img/apiref/components/daylight/daylight-virtual.png)
+ * ![daylight-virtual](https://doc.geoscene.cn/javascript/5.0/assets/references/core/components/daylight/daylight-virtual.png)
  *
  * **Things to consider**
  *
- * * Daylight is only supported in a 3D [Scene](https://doc.geoscene.cn/javascript/4.33/references/map-components/geoscene-scene/) component.
+ * * Daylight is only supported in a 3D [geoscene-scene](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-scene/) component.
  * * The Daylight component uses UTC time and does not account for the daylight savings times in different countries and regions of the world.
- * * When using the [virtual light](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-3d-environment-VirtualLighting.html),
+ * * When using the [virtual light](https://doc.geoscene.cn/javascript/5.0/references/core/views/3d/environment/VirtualLighting/),
  * setting the time and date programmatically does not have an influence on the lighting conditions of the scene.
- * * When using the [sunlight](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-3d-environment-SunLighting.html),
+ * * When using the [sunlight](https://doc.geoscene.cn/javascript/5.0/references/core/views/3d/environment/SunLighting/),
  * the time slider and time zone automatically react to the changes of the camera (e.g., position, rotation, pan, zoom) because the position of the simulated sun
  * is updated to maintain a consistent solar time of day based on the camera's current longitude. This can be adjusted using the
- * [cameraTrackingEnabled](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-3d-environment-SunLighting.html#cameraTrackingEnabled)
- * property on [environment.lighting](https://doc.geoscene.cn/javascript/4.33/references/map-components/geoscene-scene/#environment).
+ * [cameraTrackingEnabled](https://doc.geoscene.cn/javascript/5.0/references/core/views/3d/environment/SunLighting/#cameraTrackingEnabled)
+ * property on [geoscene-scene.environment](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-scene/#environment).
  *
- * [Read more...](https://doc.geoscene.cn/javascript/4.33/references/map-components/geoscene-daylight/)
- *
- * @see [Environment](https://doc.geoscene.cn/javascript/4.33/references/map-components/geoscene-scene/#environment)
- * @see [SunLighting](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-3d-environment-SunLighting.html)
- * @see [VirtualLighting](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-3d-environment-VirtualLighting.html)
- * @see [Sample - Daylight component](https://doc.geoscene.cn/javascript/4.33/sample-code/daylight/)
+ * @see [geoscene-scene.environment](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-scene/#environment)
+ * @see [SunLighting](https://doc.geoscene.cn/javascript/5.0/references/core/views/3d/environment/SunLighting/)
+ * @see [VirtualLighting](https://doc.geoscene.cn/javascript/5.0/references/core/views/3d/environment/VirtualLighting/)
+ * @see [Sample - Daylight component](https://doc.geoscene.cn/javascript/5.0/sample-code/daylight/)
  * @since 4.28
  */
-export declare class GeosceneDaylight extends LitElement {
-    /**
-     * The view associated with the component.
-     *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the Daylight component will be associated with a map or scene component rather than using the `view` property.
-     */
-    view?: SceneView;
-    /**
-     * If true, the component will not be destroyed automatically when it is
-     * disconnected from the document. This is useful when you want to move the
-     * component to a different place on the page, or temporarily hide it. If this
-     * is set, make sure to call the [destroy](https://doc.geoscene.cn/javascript/4.33/references/map-components/geoscene-daylight/#destroy) method when you are done to
-     * prevent memory leaks.
-     *
-     * @default false
-     */
-    autoDestroyDisabled: boolean;
-    /**
-     * Sets the season that is used when the component displays the season picker.
-     * Each season uses a fixed date corresponding to the seasonal equinoxes and solstices.
-     *
-     * @see [dateOrSeason](#dateOrSeason)
-     */
-    get currentSeason(): Season;
-    set currentSeason(season: Season);
-    /**
-     * Controls whether the component displays a date or a season picker. When the date picker is set, the user selects the date from a calendar. The season picker allows the user to choose a season from a drop-down list. Each season uses a fixed date corresponding to the equinoxes and solstices of 2014.
-     *
-     * @default "date"
-     */
-    dateOrSeason: "date" | "season";
-    /**
-     * Starts or pauses the daytime animation cycling through the minutes of the day.
-     * Set the property to `true` to start the animation and to `false` to pause it.
-     *
-     * @default false
-     */
-    get dayPlaying(): boolean;
-    set dayPlaying(playing: boolean);
-    /**
-     * Indicates the heading level to use for the component title.
-     *
-     * @default 2
-     */
-    headingLevel: HeadingLevel;
-    /** @default false */
-    hideDatePicker: boolean;
-    /** @default false */
-    hideHeader: boolean;
-    /** @default false */
-    hidePlayButtons: boolean;
-    /** @default false */
-    hideShadowsToggle: boolean;
-    /** @default false */
-    hideSunLightingToggle: boolean;
-    /** @default false */
-    hideTimezone: boolean;
-    /**
-     * Icon which represents the component. Typically used when the component is controlled by another component (e.g. by the Expand component).
-     *
-     * @see [Calcite Icons](https://doc.geoscene.cn/calcite-design-system/icons/)
-     * @default "brightness"
-     */
-    icon?: HTMLCalciteIconElement["icon"];
-    /** The component's default label. */
-    label?: string;
-    /**
-     * Controls the daytime animation speed.
-     *
-     * @example
-     * ```js
-     * // Plays the daylight animation at half of the default speed
-     * daylight.playSpeedMultiplier = 0.5;
-     * ```
-     * @default 1.0
-     */
-    playSpeedMultiplier: number;
-    /** @deprecated since 4.34, use [`slot`](https://doc.geoscene.cn/javascript/4.33/building-your-ui/#slots) instead. */
-    position?: __geoscene.UIPosition;
-    /**
-     * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
-     *
-     * @see [Associate components with a Map or Scene component](https://doc.geoscene.cn/javascript/4.33/programming-patterns/#associate-components-with-a-map-or-scene-component)
-     */
-    referenceElement?: GeosceneReferenceElement | string;
-    /**
-     * Sets the interval, in minutes, with which the time slider increments or decrements as it is dragged or changed via the keyboard.
-     *
-     * @example
-     * ```js
-     * // Set steps at an interval of 60. Then, the slider thumb snaps at each hour of the day.
-     * daylight.timeSliderSteps = 60;
-     * ```
-     * @default 5
-     */
-    timeSliderSteps: number[] | number;
-    /**
-     * The difference in hours between UTC time and the time displayed in the component.
-     *
-     * @example
-     * ```js
-     * daylight.utcOffset = -8;
-     * ```
-     * @example
-     * ```js
-     * // Alternatively, the UTC offset can be set by configuring the `displayUTCOffset` property of `SunLighting`.
-     * viewElement.environment.lighting = new SunLighting({
-     *   displayUTCOffset: -8
-     * });
-     * ```
-     * @since 4.34
-     */
-    get utcOffset(): nullish | number;
-    set utcOffset(value: nullish | number);
-    /**
-     * Slider position for the time of day in the timezone
-     * given by [utcOffset](#utcOffset). The position represents the time
-     * of the day in minutes. Possible values range between 0 and 1440.
-     *
-     * @example
-     * ```js
-     * // Set the time to 4:00 PM (16:00) in the given timezone.
-     * daylight.timeSliderPosition = 16 * 60;
-     * ```
-     * @example
-     * ```js
-     * // Alternatively, the time can be set by configuring the `date` property of `SunLighting`.
-     * // Then, the time slider gets updated automatically.
-     * viewElement.environment.lighting = new SunLighting({
-     *   date: new Date("2005-08-25T16:00:00")
-     * });
-     * ```
-     * @since 4.34
-     */
-    get timeSliderPosition(): nullish | number;
-    set timeSliderPosition(value: nullish | number);
-    /**
-     * The calendar date in the timezone given by [utcOffset](#utcOffset).
-     *
-     * @example
-     * ```js
-     * daylight.localDate = new Date("2005-08-25");
-     * ```
-     * @example
-     * ```js
-     * // Alternatively, the date can be set by configuring the `date` property of `SunLighting`.
-     * viewElement.environment.lighting = new SunLighting({
-     *   date: new Date("2005-08-25T16:00:00")
-     * });
-     * ```
-     * @since 4.34
-     */
-    get localDate(): Date;
-    set localDate(value: Date | number | string);
-    /**
-     * Starts or pauses the date animation cycling through the months of the year.
-     * Set the property to `true` to start the animation and to `false` to pause it.
-     *
-     * @default false
-     */
-    get yearPlaying(): boolean;
-    set yearPlaying(playing: boolean);
-    /** Permanently destroy the component. */
-    destroy(): Promise<void>;
-    /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
-    readonly geosceneReady: TargetedEvent<this, void>;
-    /**
-     * Fires when the user changes the date or time in the component by interacting with the slider, the date picker, the
-     * season selector or the play buttons.
-     *
-     * @since 4.33
-     */
-    readonly geosceneUserDateTimeChange: TargetedEvent<this, void>;
-    readonly _setterTypes: {
-        localDate?: Date | number | string;
-    };
-}
-export interface LocaleParts {
-    language: string;
-    extlang?: string;
-    region?: string;
+export abstract class GeosceneDaylight extends LitElement {
+  /**
+   * If true, the component will not be destroyed automatically when it is
+   * disconnected from the document. This is useful when you want to move the
+   * component to a different place on the page, or temporarily hide it. If this
+   * is set, make sure to call the [destroy()](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-daylight/#destroy) method when you are done to
+   * prevent memory leaks.
+   *
+   * @default false
+   */
+  accessor autoDestroyDisabled: boolean;
+  /**
+   * Sets the season that is used when the component displays the season picker.
+   * Each season uses a fixed date corresponding to the seasonal equinoxes and solstices.
+   *
+   * @see [dateOrSeason](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-daylight/#dateOrSeason)
+   */
+  accessor currentSeason: Season;
+  /**
+   * Controls whether the component displays a date or a season picker. When the date picker is set, the user selects the date from a calendar. The season picker allows the user to choose a season from a drop-down list. Each season uses a fixed date corresponding to the equinoxes and solstices of 2014.
+   *
+   * @default "date"
+   */
+  accessor dateOrSeason: "date" | "season";
+  /**
+   * Starts or pauses the daytime animation cycling through the minutes of the day.
+   * Set the property to `true` to start the animation and to `false` to pause it.
+   *
+   * @default false
+   */
+  accessor dayPlaying: boolean;
+  /**
+   * Indicates the heading level to use for the component title.
+   *
+   * @default 2
+   */
+  accessor headingLevel: HeadingLevel;
+  /** @default false */
+  accessor hideDatePicker: boolean;
+  /** @default false */
+  accessor hideHeader: boolean;
+  /** @default false */
+  accessor hidePlayButtons: boolean;
+  /** @default false */
+  accessor hideShadowsToggle: boolean;
+  /** @default false */
+  accessor hideSunLightingToggle: boolean;
+  /** @default false */
+  accessor hideTimezone: boolean;
+  /**
+   * Icon which represents the component. Typically used when the component is controlled by another component (e.g. by the Expand component).
+   *
+   * @default "brightness"
+   * @see [Calcite Icons](https://doc.geoscene.cn/calcite-design-system/icons/)
+   */
+  accessor icon: Icon["icon"] | undefined;
+  /** The component's default label. */
+  accessor label: string | undefined;
+  /**
+   * The calendar date in the timezone given by [utcOffset](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-daylight/#utcOffset).
+   *
+   * @example
+   * ```js
+   * daylight.localDate = new Date("2005-08-25");
+   * ```
+   * @example
+   * ```js
+   * // Alternatively, the date can be set by configuring the `date` property of `SunLighting`.
+   * viewElement.environment.lighting = new SunLighting({
+   *   date: new Date("2005-08-25T16:00:00")
+   * });
+   * ```
+   * @since 4.34
+   */
+  get localDate(): Date;
+  set localDate(value: Date | number | string);
+  /** @internal */
+  protected messages: {
+      componentLabel: string;
+      title: string;
+      shadowsToggle: {
+          label: string;
+          tooltip: string;
+      };
+      sunLightingToggle: {
+          label: string;
+          tooltip: string;
+      };
+      unsupported: string;
+      playDay: string;
+      playYear: string;
+      pause: string;
+      season: string;
+      spring: string;
+      summer: string;
+      winter: string;
+      fall: string;
+      date: string;
+      timezone: string;
+      timeSliderLabel: string;
+  } & T9nMeta<{
+      componentLabel: string;
+      title: string;
+      shadowsToggle: {
+          label: string;
+          tooltip: string;
+      };
+      sunLightingToggle: {
+          label: string;
+          tooltip: string;
+      };
+      unsupported: string;
+      playDay: string;
+      playYear: string;
+      pause: string;
+      season: string;
+      spring: string;
+      summer: string;
+      winter: string;
+      fall: string;
+      date: string;
+      timezone: string;
+      timeSliderLabel: string;
+  }>;
+  /**
+   * Controls the daytime animation speed.
+   *
+   * @default 1.0
+   * @example
+   * ```js
+   * // Plays the daylight animation at half of the default speed
+   * daylight.playSpeedMultiplier = 0.5;
+   * ```
+   */
+  accessor playSpeedMultiplier: number;
+  /**
+   * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
+   *
+   * @see [Associate components with a Map or Scene component](https://doc.geoscene.cn/javascript/5.0/programming-patterns/#associate-components-with-a-map-or-scene-component)
+   */
+  accessor referenceElement: GeosceneReferenceElement | string | undefined;
+  /**
+   * Slider position for the time of day in the timezone
+   * given by [utcOffset](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-daylight/#utcOffset). The position represents the time
+   * of the day in minutes. Possible values range between 0 and 1440.
+   *
+   * @example
+   * ```js
+   * // Set the time to 4:00 PM (16:00) in the given timezone.
+   * daylight.timeSliderPosition = 16 * 60;
+   * ```
+   * @example
+   * ```js
+   * // Alternatively, the time can be set by configuring the `date` property of `SunLighting`.
+   * // Then, the time slider gets updated automatically.
+   * viewElement.environment.lighting = new SunLighting({
+   *   date: new Date("2005-08-25T16:00:00")
+   * });
+   * ```
+   * @since 4.34
+   */
+  accessor timeSliderPosition: number | null | undefined;
+  /**
+   * Sets the interval, in minutes, with which the time slider increments or decrements as it is dragged or changed via the keyboard.
+   *
+   * @default 5
+   * @example
+   * ```js
+   * // Set steps at an interval of 60. Then, the slider thumb snaps at each hour of the day.
+   * daylight.timeSliderSteps = 60;
+   * ```
+   */
+  accessor timeSliderSteps: number[] | number;
+  /**
+   * The difference in hours between UTC time and the time displayed in the component.
+   *
+   * @example
+   * ```js
+   * daylight.utcOffset = -8;
+   * ```
+   * @example
+   * ```js
+   * // Alternatively, the UTC offset can be set by configuring the `displayUTCOffset` property of `SunLighting`.
+   * viewElement.environment.lighting = new SunLighting({
+   *   displayUTCOffset: -8
+   * });
+   * ```
+   * @since 4.34
+   */
+  accessor utcOffset: number | null | undefined;
+  /**
+   * The view associated with the component. 
+   *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the geoscene-daylight component will be associated with a map or scene component rather than using the `view` property.
+   */
+  accessor view: SceneView | undefined;
+  /**
+   * Starts or pauses the date animation cycling through the months of the year.
+   * Set the property to `true` to start the animation and to `false` to pause it.
+   *
+   * @default false
+   */
+  accessor yearPlaying: boolean;
+  /** Permanently destroy the component. */
+  destroy(): Promise<void>;
+  "@setterTypes": {
+    localDate?: Date | number | string;
+  };
+  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  readonly geosceneReady: import("@geoscene/lumina").TargetedEvent<this, void>;
+  /**
+   * Fires when the user changes the date or time in the component by interacting with the slider, the date picker, the
+   * season selector or the play buttons.
+   *
+   * @since 4.33
+   */
+  readonly geosceneUserDateTimeChange: import("@geoscene/lumina").TargetedEvent<this, void>;
+  readonly "@eventTypes": {
+    geosceneReady: GeosceneDaylight["geosceneReady"]["detail"];
+    geosceneUserDateTimeChange: GeosceneDaylight["geosceneUserDateTimeChange"]["detail"];
+  };
 }