jmapcloud-ng-core-types 1.1.42 → 2.0.0

package/README.md

@@ -2,6 +2,6 @@
 
 JMap Cloud NG Core
 
-The latest version of the JMap Cloud NG Core Javascript API documentation is available <a href="https://k2geospatial.github.io/jmapcloud-frontend/jmapcloud-ng-core-types/latest" target="_blank">here</a>.
+The latest version of the JMap Cloud NG Javascript API documentation, including Core types and API, is available <a href="https://k2geospatial.github.io/jmapcloud-frontend/jmapcloud-ng-types/latest" target="_blank">here</a>.
 
 Examples and user documentation are available <a href="https://docs.jmapcloud.io/en/jmap-ng/jmap-ng-developer-documentation" target="_blank">here</a>.

package/all-enums.ts

@@ -21,6 +21,7 @@ import {
   JLAYER_STYLE_LINE_JOIN,
   JLAYER_STYLE_RULE_CONDITION_EXPRESSION_OPERATORS,
   JLAYER_STYLE_TYPES,
+  JAPP_MESSAGE_SEVERITIES,
   JLAYER_THEMATIC_FAMILY_TYPES,
   JLAYER_THEMATIC_TYPES,
   JLOCALES,
@@ -259,6 +260,8 @@ export const ALL_ROLES: ROLES[] = [ROLES.ORG_ADMIN, ROLES.ORG_EDITOR, ROLES.ORG_
 
 export const ALL_MEMBER_ROLES: MEMBER_ROLES[] = [ROLES.ORG_ADMIN, ROLES.ORG_EDITOR, ROLES.ORG_VIEWER]
 
+export const ALL_APP_MESSAGE_SEVERITIES: JAPP_MESSAGE_SEVERITIES[] = [JAPP_MESSAGE_SEVERITIES.SUCCESS, JAPP_MESSAGE_SEVERITIES.INFO, JAPP_MESSAGE_SEVERITIES.WARNING, JAPP_MESSAGE_SEVERITIES.ERROR]
+
 export const ALL_TABLE_ATTRIBUTE_TYPES: JTABLE_ATTRIBUTE_TYPES[] = [
   JTABLE_ATTRIBUTE_TYPES.BINARY,
   JTABLE_ATTRIBUTE_TYPES.BOOLEAN,

package/enums.ts

@@ -365,6 +365,30 @@ export enum JMAP_CONTEXT_SORT_BY_DIRECTIONS {
   DESC = "desc"
 }
 
+// From message.d.ts
+export enum JAPP_MESSAGE_SEVERITIES {
+  SUCCESS = "success",
+  INFO = "info",
+  WARNING = "warning",
+  ERROR = "error"
+}
+
+// From message.d.ts — cross-bundle action-type contract; string values must
+// stay in sync with ACTIONS.APP_MESSAGE_* in core/store/actions.ts.
+export enum MESSAGE_ACTION_TYPES {
+  ADD_MESSAGE = "APP_MESSAGE_ADD_MESSAGE",
+  SET_MESSAGE_EXPIRED = "APP_MESSAGE_SET_MESSAGE_EXPIRED",
+  SET_CONFIRM_MESSAGE = "APP_MESSAGE_SET_CONFIRM_MESSAGE",
+  ADD_OVERLAY_MESSAGE = "APP_MESSAGE_ADD_OVERLAY_MESSAGE",
+  DELETE_OVERLAY_MESSAGES = "APP_MESSAGE_DELETE_OVERLAY_MESSAGES"
+}
+
+// From user.d.ts — cross-bundle action-type contract; string value must
+// stay in sync with ACTIONS.APP_USER_SET_ACTIONS in core/store/actions.ts.
+export enum USER_ACTION_TYPES {
+  SET_ACTIONS = "APP_USER_SET_ACTIONS"
+}
+
 // From server.d.ts
 export enum JSERVER_MICRO_SERVICE_STATUSES {
   STARTING = "STARTING",

package/index.d.ts

@@ -23,6 +23,8 @@ export type {
   JUIState,
   JUserState
 } from "./public/state.d.ts"
+export type { JAppConfirmMessage, JAppMessage, JAppMessageOptions, JAppMessageService, JAppMessageState, JAppOverlayMessage } from "./public/jmap/message.d.ts"
+export type { JAppUserAction } from "./public/jmap/user.d.ts"
 
 export interface JCoreService extends JCoreMainService {
   Project: JProjectService
@@ -54,6 +56,7 @@ export interface JCoreService extends JCoreMainService {
 
 export interface JUIService {
   setMainLayoutVisibility(isVisible: boolean): void
+  setExtensionRoot(node: unknown): void
   openIFramePopup(params: JIFramePopupParams): void
   closeIFramePopup(): void
   getContainerWidth(): number
@@ -197,6 +200,11 @@ export interface JGeolocationService {
   isSupportedByBrowser(): boolean
   isEnabled(): boolean
   getMyLocation(): Promise<JLocation>
+  followMyLocation(options?: JPanAndZoomOptions): Promise<JLocation>
+  stopFollowingMyLocation(): void
+  /**
+   * @deprecated Use followMyLocation instead.
+   */
   goToMyLocation(options?: JPanAndZoomOptions): Promise<JLocation>
 }
 
@@ -405,7 +413,7 @@ export interface JAttachmentService {
   update(dataSourceId: string, dataSourceOrganizationId: string, attachmentId: string, params: JUpdateAttachmentParams): Promise<string>
   download(dataSourceId: string, dataSourceOrganizationId: string, attachmentId: string): Promise<{ data: Blob; headers: any }>
   downloadToDevice(attachment: JAttachmentFile, dataSourceId: string, dataSourceOrganizationId: string): Promise<void>
-  previewAttachments(attachment: JAttachmentFile, dataSourceId: string, dataSourceOrganizationId: string): Promise<void>
+  previewAttachments(attachmentId: string, dataSourceId: string, dataSourceOrganizationId: string, itemId: JId): void
 }
 
 export interface JFormService {
@@ -516,6 +524,7 @@ export interface JMapService {
   getMap(): maplibregl.Map
   getMapJSLib(): any
   getDomContainerId(): string
+  getMaplibreContainerElement(): HTMLElement | null
   getAllDistanceUnits(): JMAP_DISTANCE_UNITS[]
   getDistanceUnit(): JMAP_DISTANCE_UNITS
   setDistanceUnit(distanceUnit: JMAP_DISTANCE_UNITS): void
@@ -545,6 +554,9 @@ export interface JMapService {
   setTerrainControlVisibility(isVisible: boolean): void
   isMapInfoControlExpanded(): boolean
   setMapInfoControlExpansion(isExpanded: boolean): void
+  isInitialExtentControlVisible(): boolean
+  setInitialExtentControlVisibility(isVisible: boolean): void
+  zoomToProjectInitialExtent(): Promise<void>
   getMaplibreSupportedJMapLayerIds(): JId[]
   getMaplibreSupportedJMapLayerIdBefore(layerId: JId): JId | undefined
   getMaplibreSupportedJMapLayerIdAfter(layerId: JId): JId | undefined
@@ -582,10 +594,18 @@ export interface JMapService {
   openModificationPopupForCenter(): void
   openModificationPopupForScale(): void
   closeModificationPopup(): void
+  /** @deprecated Use JMap.Map.getLayerTransparency to read overridden transparency. For non-overridden layers, use JMap.Map.getRasterLayerInitialTransparency. */
   getRasterLayerTransparency(layerId: JId): number
+  /** @deprecated This method is unreliable when style opacity is expression-based and will be removed in a future version. */
   getRasterLayerInitialTransparency(layerId: JId): number
+  /** @deprecated Use JMap.Map.resetLayerTransparency instead. It manages all supported map layer types (vector and raster), not only raster layers. */
   resetRasterLayerTransparency(layerId: JId): number
+  /** @deprecated Use JMap.Map.setLayerTransparency instead. It manages all supported map layer types (vector and raster), not only raster layers. */
   setRasterLayerTransparency(layerId: JId, transparency: number): void
+  getLayerTransparency(layerId: JId): number | undefined
+  isLayerTransparencyOverridden(layerId: JId): boolean
+  setLayerTransparency(layerId: JId, transparency: number): void
+  resetLayerTransparency(layerId: JId): void
   setPixelRatio(pixelRatio: number): boolean
   getPixelRatio(): number
 }
@@ -695,6 +715,7 @@ export interface JLayerService {
   getLayerTreeElementsById(): { [key in JId]: JLayerTreeElement }
   getLayers(): JLayer[]
   getLayerIds(): JId[]
+  setLayersMapOrder(layerIds: JId[]): void
   getVectorLayers(): JLayer[]
   getVectorLayerIds(): JId[]
   getLayerAttributes(layerId: JId): JLayerAttribute[]
@@ -782,7 +803,7 @@ export interface JUserService {
   removePreference(name: string): Promise<string | null>
   setPreference(name: string, value: string | undefined): Promise<void>
   setToken(token: string, organizationId?: string): Promise<JSessionData>
-  login(login?: string, password?: string): Promise<JSessionData> | Promise<void>
+  login(login?: string, password?: string, connectionName?: string): Promise<JSessionData> | Promise<void>
   loginIntoOrganization(organizationId: string): Promise<JSessionData> | Promise<void>
   loginWithIdentityProvider(providerId: string): void
   logout(): Promise<void>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jmapcloud-ng-core-types",
-  "version": "1.1.42",
+  "version": "2.0.0",
   "description": "JMap Cloud specific version of JMap Cloud NG Core types and interfaces",
   "main": "index.js",
   "types": "ambient.d.ts",
@@ -27,6 +27,7 @@
   },
   "homepage": "https://github.com/k2geospatial/jmapcloud-ng-core-types#readme",
   "devDependencies": {
+    "rollup-plugin-visualizer": "^5.14.0",
     "typedoc": "^0.25.13"
   },
   "dependencies": {

package/public/core.d.ts

@@ -461,9 +461,41 @@ export namespace JMap {
      * ```
      */
     function getMyLocation(): Promise<JLocation>
+    /**
+     * **JMap.Geolocation.followMyLocation**
+     *
+     * Returns the user current location if promise succeed, pan and zoom to this location and starts monitoring the user location.
+     *
+     * @throws if browser doesn't support geolocation, if geolocation is disabled, if an unexpected error occurs while getting location from browser
+     * @param options pan and zoom options
+     * @example
+     *  ```ts
+     * // pan and zoom to the user location and start monitoring location updates
+     * JMap.Geolocation.followMyLocation()
+     *    .then(location => console.info("Paned and zommed to user location ", location))
+     *    .error(error => console.error("Cannot get my location : ", error))
+     * ```
+     */
+    function followMyLocation(options?: JPanAndZoomOptions): Promise<JLocation>
+
+    /**
+     * **JMap.Geolocation.stopFollowingMyLocation**
+     *
+     * Stops following the user location and hides the geolocation marker.
+     *
+     * @example
+     *  ```ts
+     * // stop following user location updates
+     * JMap.Geolocation.stopFollowingMyLocation()
+     * ```
+     */
+    function stopFollowingMyLocation(): void
+
     /**
      * **JMap.Geolocation.goToMyLocation**
      *
+     * @deprecated Use JMap.Geolocation.followMyLocation instead.
+     *
      * Returns the user current location if promise succeed, and pan and zoom to this location.
      *
      * @throws if browser doesn't support geolocation, if geolocation is disabled, if an unexpected error occurs while getting location from browser
@@ -1908,6 +1940,30 @@ export namespace JMap {
      * ```
      */
     function getLayerIds(): JId[]
+    /**
+     * **JMap.Layer.setLayersMapOrder**
+     *
+     * Sets the display order on the map of supported layers for the current NG session.
+     *
+     * The provided array must contain exactly the same layer ids returned by `JMap.Map.getMaplibreSupportedJMapLayerIds()`,
+     * but in the desired order.
+     *
+     * This only updates the client session state. It does not persist the order on the server.
+     *
+     * @throws Error if the array contains missing ids, extra ids, duplicates, or non-layer ids.
+     * @param layerIds the complete ordered array of map-supported layer ids
+     * @example
+     * ```ts
+     * // move first layer to the end
+     * const orderedIds = JMap.Map.getMaplibreSupportedJMapLayerIds()
+     * const firstId = orderedIds.shift()
+     * if (firstId !== undefined) {
+     *   orderedIds.push(firstId)
+     *   JMap.Layer.setLayersMapOrder(orderedIds)
+     * }
+     * ```
+     */
+    function setLayersMapOrder(layerIds: JId[]): void
     /**
      * **JMap.Layer.getVectorLayers**
      *
@@ -2983,15 +3039,39 @@ export namespace JMap {
     /**
      * ***JMap.Map.getDomContainerId***
      *
-     * Returns the map div container id, where the map is or will be created.
+     * Returns the id of the JMap UI wrapper. In library-in-host-div mode this is the id the embedder
+     * set on the host div; in standalone mode it is the auto-created container id (default `"jmap-map"`).
+     *
+     * Since the shell-decoupling refactor, this id refers to the WRAPPER, not the maplibre attach point.
+     * Use `JMap.Map.getMaplibreContainerElement()` if you specifically need a reference to the maplibre
+     * container.
      *
      * @example
      * ```ts
-     * // returns the map div container id
+     * // returns the wrapper div id (e.g. "my-map" if the embedder set JMAP_OPTIONS.map.containerId)
      * JMap.Map.getDomContainerId()
      * ```
      */
     function getDomContainerId(): string
+    /**
+     * ***JMap.Map.getMaplibreContainerElement***
+     *
+     * Returns the internal `#jmap-maplibre-host` div where maplibre-gl is attached, or `null` if the
+     * DOM has not been initialized yet (i.e., before the project bootstrapper runs).
+     *
+     * Embedders rarely need this — most legitimate uses of "the map container" want the wrapper, which
+     * is what `JMap.Map.getDomContainerId()` returns. Provided as a defensive helper for embedders that
+     * previously resolved the maplibre container by id directly.
+     *
+     * @example
+     * ```ts
+     * const maplibreEl = JMap.Map.getMaplibreContainerElement()
+     * if (maplibreEl) {
+     *   maplibreEl.style.cursor = "crosshair"
+     * }
+     * ```
+     */
+    function getMaplibreContainerElement(): HTMLElement | null
     /**
      * **JMap.Map.getAllDistanceUnits**
      *
@@ -3311,6 +3391,48 @@ export namespace JMap {
      * ```
      */
     function setTerrainActive(active: boolean): void
+    /**
+     * ***JMap.Map.isInitialExtentControlVisible***
+     *
+     * Returns true if the initial extent control is visible, false otherwise.
+     *
+     * @example
+     * ```ts
+     * // returns true if the initial extent control is visible, false otherwise
+     * JMap.Map.isInitialExtentControlVisible()
+     * ```
+     */
+    function isInitialExtentControlVisible(): boolean
+    /**
+     * ***JMap.Map.setInitialExtentControlVisibility***
+     *
+     * Changes the initial extent control visibility on the map.
+     *
+     * @param isVisible true to display the initial extent control, false to hide
+     *
+     * @example
+     * ```ts
+     * // displays the initial extent control on the map
+     * JMap.Map.setInitialExtentControlVisibility(true)
+     *
+     * // hides the initial extent control on the map
+     * JMap.Map.setInitialExtentControlVisibility(false)
+     * ```
+     */
+    function setInitialExtentControlVisibility(isVisible: boolean): void
+    /**
+     * ***JMap.Map.zoomToProjectInitialExtent***
+     *
+     * Zooms to the active project's initial extent. If the project has no initial extent, will zoom to the world's extent
+     *
+     * @throws Error if no project is active
+     * @example
+     * ```ts
+     * // zoom to the active project's extent
+     * JMap.Map.zoomToProjectInitialExtent()
+     * ```
+     */
+    function zoomToProjectInitialExtent(): Promise<void>
     /**
      * ***JMap.Map.setSelectionStyle***
      *
@@ -4122,30 +4244,43 @@ export namespace JMap {
     /**
      * **JMap.Map.getRasterLayerTransparency**
      *
-     * Returns the transparency for a given raster layer
+     * Returns the transparency for a given raster layer.
+     *
+     * If the transparency is currently overridden (for example via `JMap.Map.setLayerTransparency`),
+     * this overridden transparency is returned.
+     *
+     * Otherwise, transparencies are read from all associated style layers:
+     * if they are all identical, that value is returned; if they differ, the lowest transparency value is returned.
+     *
+     * @deprecated Use {@link JMap.Map.getLayerTransparency} to read overridden transparency.
+     * For non-overridden layers, use {@link JMap.Map.getRasterLayerInitialTransparency}.
      *
      * @throws Error if layer not found or not a raster layer
      * @param layerId The JMap layer id
      * @returns the current transparency value
      * @example
      * ```ts
-     *  // returns the transparency of raster layer id=4
-     *  JMap.Map.getRasterLayerTransparency(4)
+     *  // returns the transparency of raster layer id="6a8b1f8c-3f0a-4d4b-9b8f-31a6ad8d11a2"
+     *  JMap.Map.getRasterLayerTransparency("6a8b1f8c-3f0a-4d4b-9b8f-31a6ad8d11a2")
      * ```
      */
     function getRasterLayerTransparency(layerId: JId): number
     /**
      * **JMap.Map.getRasterLayerInitialTransparency**
      *
-     * Return the initial transparency (defined on the layer style) for a  given raster layer
+     * Returns the initial transparency for a given raster layer.
+     *
+     * If many style layers/properties are present with different initial transparency values, the lowest transparency is returned.
+     *
+     * @deprecated This method is unreliable when style opacity is expression-based and will be removed in a future version.
      *
      * @throws Error if layer not found or not a raster layer
      * @param layerId The JMap layer id
      * @returns the initial transparency value
      * @example
      * ```ts
-     *  // returns the initial transparency of raster layer id=4
-     *  JMap.Map.getRasterLayerInitialTransparency(4)
+     *  // returns the initial transparency of raster layer id="6a8b1f8c-3f0a-4d4b-9b8f-31a6ad8d11a2"
+     *  JMap.Map.getRasterLayerInitialTransparency("6a8b1f8c-3f0a-4d4b-9b8f-31a6ad8d11a2")
      * ```
      */
     function getRasterLayerInitialTransparency(layerId: JId): number
@@ -4154,16 +4289,50 @@ export namespace JMap {
      *
      * Sets the transparency for a given raster layer
      *
+     * @deprecated Use {@link JMap.Map.setLayerTransparency} instead. The replacement method manages all supported map layer types (vector and raster), not only raster layers.
+     *
      * @throws Error if layer is not found, not a raster layer or transparency is invalid
      * @param layerId The JMap layer id
      * @param transparency the new layer transparency between 0 and 1
      * @example
      * ```ts
-     * // Make raster layer id=10 transparent
-     * JMap.Map.setRasterLayerTransparency(10, 1)
+     * // Make raster layer id="f2c9a34d-0d6f-4f98-bf6f-22e1e0f4bf7d" transparent
+     * JMap.Map.setRasterLayerTransparency("f2c9a34d-0d6f-4f98-bf6f-22e1e0f4bf7d", 1)
      * ```
      */
     function setRasterLayerTransparency(layerId: JId, transparency: number): void
+    /**
+     * **JMap.Map.getLayerTransparency**
+     *
+     * Returns the currently overridden transparency value for a map layer (vector or raster).
+     *
+     * If the layer transparency is not currently overridden, returns `undefined`.
+     *
+     * @throws Error if layer is not found or not supported by map
+     * @param layerId The JMap layer id
+     * @returns The current overridden transparency value between 0 and 1, or `undefined` if not overridden
+     * @example
+     * ```ts
+     * // returns undefined if no override is applied
+     * const transparency = JMap.Map.getLayerTransparency("f2c9a34d-0d6f-4f98-bf6f-22e1e0f4bf7d")
+     * ```
+     */
+    function getLayerTransparency(layerId: JId): number | undefined
+    /**
+     * **JMap.Map.isLayerTransparencyOverridden**
+     *
+     * Returns true when a layer transparency is currently overridden, else false.
+     *
+     * @throws Error if layer is not found or not supported by map
+     * @param layerId The JMap layer id
+     * @example
+     * ```ts
+     * if (JMap.Map.isLayerTransparencyOverridden("f2c9a34d-0d6f-4f98-bf6f-22e1e0f4bf7d")) {
+     *   console.info("Layer transparency has been overridden")
+     * }
+     * ```
+     */
+    function isLayerTransparencyOverridden(layerId: JId): boolean
     /**
      * ***JMap.Map.setPixelRatio***
      *
@@ -4194,18 +4363,53 @@ export namespace JMap {
      *
      * Resets the raster layer transparency to its initial value as defined on the server
      *
+     * @deprecated Use {@link JMap.Map.resetLayerTransparency} instead. The replacement method manages all supported map layer types (vector and raster), not only raster layers.
+     *
      * @throws Error if layer is not found or not a raster layer
      * @param layerId The JMap layer id
      * @returns the initial transparency value
      * @example
      * ```ts
-     * // Make raster layer id=3 transparent
-     * JMap.Map.setRasterLayerTransparency(10, 1)
+     * // Make raster layer id="f2c9a34d-0d6f-4f98-bf6f-22e1e0f4bf7d" transparent
+     * JMap.Map.setRasterLayerTransparency("f2c9a34d-0d6f-4f98-bf6f-22e1e0f4bf7d", 1)
      * // Reset to its initial opacity
-     * JMap.Map.resetRasterLayerTransparency(3)
+     * JMap.Map.resetRasterLayerTransparency("f2c9a34d-0d6f-4f98-bf6f-22e1e0f4bf7d")
      * ```
      */
     function resetRasterLayerTransparency(layerId: JId): number
+    /**
+     * **JMap.Map.setLayerTransparency**
+     *
+     * Sets the map transparency of a given JMap layer (vector or raster).
+     *
+     * This method applies the same transparency to all style layers associated to the specified JMap layer.
+     *
+     * @throws Error if layer is not found, not supported by map or transparency is invalid
+     * @param layerId The JMap layer id
+     * @param transparency The new transparency value between 0 and 1
+     * @example
+     * ```ts
+     * // Make layer id="f2c9a34d-0d6f-4f98-bf6f-22e1e0f4bf7d" fully transparent
+     * JMap.Map.setLayerTransparency("f2c9a34d-0d6f-4f98-bf6f-22e1e0f4bf7d", 1)
+     * ```
+     */
+    function setLayerTransparency(layerId: JId, transparency: number): void
+    /**
+     * **JMap.Map.resetLayerTransparency**
+     *
+     * Resets a layer map transparency to its initial style opacity values.
+     *
+     * This restores each style layer opacity property to the original values received from the map style.
+     *
+     * @throws Error if layer is not found or not supported by map
+     * @param layerId The JMap layer id
+     * @example
+     * ```ts
+     * JMap.Map.setLayerTransparency("f2c9a34d-0d6f-4f98-bf6f-22e1e0f4bf7d", 1)
+     * JMap.Map.resetLayerTransparency("f2c9a34d-0d6f-4f98-bf6f-22e1e0f4bf7d")
+     * ```
+     */
+    function resetLayerTransparency(layerId: JId): void
     /**
      * **JMap.Map.Interaction**
      *
@@ -6123,7 +6327,8 @@ export namespace JMap {
      *
      * @throws Error if bad credentials or server error.
      * @param login The user's username (when using {@link JCoreOptions.legacyAuthentication})
-     * @param password The user's password (when using {@link JCoreOptions.legacyAuthentication}
+     * @param password The user's password (when using {@link JCoreOptions.legacyAuthentication})
+     * @param connectionName Optional Auth0 database connection name to use for authentication flow.
      * @example
      * ```ts
      * const userLogin = "jdo@mycompany.com"
@@ -6140,7 +6345,7 @@ export namespace JMap {
      *    })
      * ```
      */
-    function login(login?: string, password?: string): Promise<void> | Promise<JSessionData>
+    function login(login?: string, password?: string, connectionName?: string): Promise<void> | Promise<JSessionData>
     /**
      * **JMap.User.loginIntoOrganization**
      *
@@ -8280,7 +8485,12 @@ export namespace JMap {
         /**
          * ***JMap.Event.Map.on.mapLoad***
          *
-         * This event is triggered when the map is created and ready.
+         * This event is triggered when the map is created and ready. It fires after the
+         * map's first idle, when both the basemap style is parseable AND project layers
+         * (if any) have been added. Subscribers may safely query layer-related map state.
+         *
+         * For "basemap visible" timing (e.g. to remove a boot spinner before project layers
+         * finish loading), read the `isStyleLoaded` flag on the map redux state instead.
          *
          * @param listenerId Your listener id (must be unique for all map events)
          * @param fn Your listener function
@@ -9648,33 +9858,28 @@ export namespace JMap {
     /**
      * ***JMap.Attachment.previewAttachments***
      *
-     * Opens a client-side preview modal for the provided file attachment.
+     * Opens a client-side preview modal for a feature's image attachments.
      *
-     * The preview currently supports standard images and 360° panoramas; other file types will fall back to a download message.
+     * The viewer fetches the feature's attachments itself, filters to image attachments, and orders them
+     * the same way the mouseover popup does (subjects sorted alphabetically, then images within each subject
+     * sorted by name). When more than one image is available, the viewer shows prev/next arrows, a position
+     * counter, and supports arrow-key navigation. Standard images and 360° panoramas are supported.
      *
-     * @param attachment the attachment to download
+     * @param attachmentId the id of the attachment to display first
      * @param dataSourceId the JMap data source id
      * @param dataSourceOrganizationId the id of the organization to which the data source belongs
+     * @param itemId the id of the feature/item whose attachments should be loaded
      * @example
      * ```ts
-     * JMap.Attachment
-     *  .previewAttachments(
-     *    {
-     *      id: "c56a4180-65aa-42ec-a945-5fd21dec0538",
-     *      organizationId: "c56a4180-65aa-42ec-a945-5fd21dec0538",
-     *      thumbnail: "",
-     *      fileId: "d9428888-122b-11e1-b85c-61cd3cbb3210",
-     *      fileName: "panorama.jpg",
-     *      fileSize: 8675309,
-     *      mimeType: "image/jpeg"
-     *    },
-     *    "f47ac10b-58cc-4372-a567-0e02b2c3d479"
-     *  )
-     *  .then(() => console.log("Preview opened"))
-     *  .catch(error => console.error("Preview failed", error))
+     * JMap.Attachment.previewAttachments(
+     *   "c56a4180-65aa-42ec-a945-5fd21dec0538",
+     *   "f47ac10b-58cc-4372-a567-0e02b2c3d479",
+     *   "9b2c4180-65aa-42ec-a945-5fd21dec0538",
+     *   "feature-123"
+     * )
      * ```
      */
-    function previewAttachments(attachment: JAttachmentFile, dataSourceId: string, dataSourceOrganizationId: string): Promise<void>
+    function previewAttachments(attachmentId: string, dataSourceId: string, dataSourceOrganizationId: string, itemId: JId): void
   }
   /**
    * **JMap.DataSource**
@@ -12106,20 +12311,12 @@ export namespace JMap {
     /**
      * **JMap.UI.setMainLayoutVisibility**
      *
-     * Set the main UI layout visibility.
-     *
-     * By default main UI layout is visible.
+     * @deprecated This method has no effect. Control the shell with the `ui` startup option
+     * (`"full"` | `"minimal"`) or the `?ngUi=` URL parameter instead. The function is kept
+     * for source compatibility and will be removed in a future major version.
      *
      * @throws if isVisible is not boolean value
-     * @param isVisible false to hide, true to show
-     * @example
-     * ```ts
-     * // display main layout
-     * JMap.UI.setMainLayoutVisibility(true)
-     *
-     * // hide main layout
-     * JMap.UI.setMainLayoutVisibility(false)
-     * ```
+     * @param isVisible ignored
      */
     function setMainLayoutVisibility(isVisible: boolean): void
     /**

package/public/global-aliases.d.ts

@@ -17,6 +17,7 @@ import type * as layer from "./jmap/layer"
 import type * as main from "./jmap/main"
 import type * as mapcontext from "./jmap/map-context"
 import type * as map from "./jmap/map"
+import type * as message from "./jmap/message"
 import type * as mouseover from "./jmap/mouseover"
 import type * as photos from "./jmap/photos"
 import type * as project from "./jmap/project"
@@ -357,6 +358,16 @@ declare global {
   /** @internal */ type JZoomOptions = map.JZoomOptions
   /** @internal */ type JPanAndZoomOptions = map.JPanAndZoomOptions
   /** @internal */ type JCoreMapOptions = map.JCoreMapOptions
+  /** @internal */ type JAPP_MESSAGE_SEVERITIES = message.JAPP_MESSAGE_SEVERITIES
+  /** @internal */ const JAPP_MESSAGE_SEVERITIES: typeof message.JAPP_MESSAGE_SEVERITIES
+  /** @internal */ type MESSAGE_ACTION_TYPES = message.MESSAGE_ACTION_TYPES
+  /** @internal */ const MESSAGE_ACTION_TYPES: typeof message.MESSAGE_ACTION_TYPES
+  /** @internal */ type JAppMessage = message.JAppMessage
+  /** @internal */ type JAppOverlayMessage = message.JAppOverlayMessage
+  /** @internal */ type JAppConfirmMessage = message.JAppConfirmMessage
+  /** @internal */ type JAppMessageOptions = message.JAppMessageOptions
+  /** @internal */ type JAppMessageState = message.JAppMessageState
+  /** @internal */ type JAppMessageService = message.JAppMessageService
   /** @internal */ type JMapMouseOver = mouseover.JMapMouseOver
   /** @internal */ type JMouseOverContent = mouseover.JMouseOverContent
   /** @internal */ type JMouseOverOpenPopupParams = mouseover.JMouseOverOpenPopupParams
@@ -423,6 +434,7 @@ declare global {
   /** @internal */ type JUserEventSessionChangedParams = user.JUserEventSessionChangedParams
   /** @internal */ type JTokenInfo = user.JTokenInfo
   /** @internal */ type JSessionData = user.JSessionData
+  /** @internal */ type JIdentity = user.JIdentity
   /** @internal */ type JUser = user.JUser
   /** @internal */ type JUserInfo = user.JUserInfo
   /** @internal */ type JOrganizationInfo = user.JOrganizationInfo
@@ -449,4 +461,7 @@ declare global {
   /** @internal */ type JUserViewPermissionType = user.JUserViewPermissionType
   /** @internal */ type JUserResourcePermissionParams = user.JUserResourcePermissionParams
   /** @internal */ type JUserResourcePermissionsResponse = user.JUserResourcePermissionsResponse
+  /** @internal */ type USER_ACTION_TYPES = user.USER_ACTION_TYPES
+  /** @internal */ const USER_ACTION_TYPES: typeof user.USER_ACTION_TYPES
+  /** @internal */ type JAppUserAction = user.JAppUserAction
 }

package/public/jmap/attachment.d.ts

@@ -1,36 +1,19 @@
-export {}
-export interface JAttachmentBase {
-  id: string
-  organizationId: string
-  dataSourceId: string
-  subject?: string
-  description?: string
-  thumbnail: string
-}
+import type {
+  AttachmentBaseDTO,
+  AttachmentDTO,
+  AttachmentFileDTO,
+  AttachmentUrlDTO,
+  CreateAttachmentFileParams,
+  CreateAttachmentParams,
+  CreateAttachmentUrlParams,
+  UpdateAttachmentParams
+} from "jmapcloud-types"
 
-export interface JAttachmentFile extends JAttachmentBase {
-  fileName: string
-  fileSize: number
-  fileId: string
-  mimeType: string
-}
-
-export interface JAttachmentUrl extends JAttachmentBase {
-  url: string
-}
-
-export type JAttachment = JAttachmentUrl | JAttachmentFile
-
-export type JCreateAttachmentUrlParams = {
-  itemId: number
-} & Pick<JAttachmentUrl, "subject" | "description" | "url">
-
-export type JCreateAttachmentFileParams = {
-  itemId: number
-} & Pick<JAttachmentFile, "subject" | "description"> & {
-    file: File
-  }
-
-export type JCreateAttachmentParams = JCreateAttachmentFileParams | JCreateAttachmentUrlParams
-
-export type JUpdateAttachmentParams = Partial<Pick<JAttachmentUrl, "subject" | "description" | "url"> | Pick<JAttachmentFile, "subject" | "description">>
+export type JAttachmentBase = AttachmentBaseDTO
+export type JAttachmentFile = AttachmentFileDTO
+export type JAttachmentUrl = AttachmentUrlDTO
+export type JAttachment = AttachmentDTO
+export type JCreateAttachmentUrlParams = CreateAttachmentUrlParams
+export type JCreateAttachmentFileParams = CreateAttachmentFileParams
+export type JCreateAttachmentParams = CreateAttachmentParams
+export type JUpdateAttachmentParams = UpdateAttachmentParams

package/public/jmap/datasource.ts

@@ -9,7 +9,10 @@ export interface JDataSourceDataParams {
   startIndex?: number
   limit?: number
   filter?: string
+  // Tabular data source rows: SQL-style "FIELD ASC, FIELD2 DESC".
   sort?: string
+  // OGC API Features (collections/items): property names with `-` prefix for descending, e.g. ["property1", "-property2"].
+  sortBy?: string[]
   attributes?: string[]
 }
 

package/public/jmap/layer.d.ts

@@ -1,4 +1,4 @@
-import type { JAnyFilterCondition, JAttribute, JDynamicFilterGraphQL } from "jmapcloud-types"
+import type { JAnyFilterCondition, JAttribute, JDynamicFilterGraphQL, UserMetadata } from "jmapcloud-types"
 import type { JFORM_TYPES } from "./form.d.ts"
 import type { JBoundaryBox } from "./geometry.d.ts"
 import type { JId } from "./main.d.ts"
@@ -302,6 +302,7 @@ export interface JLayer extends JLayerTreeElement {
   useClientCache: boolean
   defaultMetadatas: JLayerMetadata[]
   metadataSections: JLayerMetadataSection[]
+  userMetadata: UserMetadata<string>[]
   attributes: JLayerAttribute[]
   JMCAttributes: JAttribute[]
   mouseOver: JMapMouseOver

package/public/jmap/map-context.d.ts

@@ -67,6 +67,7 @@ export interface JMapContextDataLayer extends JMapContextDataLayerElement {
   // TODO JMAP8-3266 :  replace this with new dynamic filters
   dynamicFilterConditions: JDynamicFilterCondition[]
   dynamicFilterIsActive: boolean
+  // Defined only when layer transparency has been explicitly overridden
   transparency?: number
 }
 

package/public/jmap/map.d.ts

@@ -466,6 +466,29 @@ export interface JCoreMapOptions {
    * ```
    */
   terrainControlVisible?: boolean
+  /**
+   * By default the Initial Extent control is visible.
+   *
+   * But if ***initialExtentControlVisible*** is false, it will be hidden on the map.
+   *
+   * ```html
+   * <html>
+   *   ...
+   *   <body>
+   *     <script type="text/javascript">
+   *       window.JMAP_OPTIONS = {
+   *         ...
+   *         map: {
+   *           initialExtentControlVisible: false,
+   *         }
+   *       }
+   *     </script>
+   *     ...
+   *   </body>
+   * </html>
+   * ```
+   */
+  initialExtentControlVisible?: boolean
   /**
    * You can choose the position of the scale control on the map.
    *

package/public/jmap/message.d.ts

@@ -0,0 +1,69 @@
+import type { JLOCALES } from "./language.d.ts"
+export {}
+
+// ALL_APP_MESSAGE_SEVERITIES in all-enums.ts
+export enum JAPP_MESSAGE_SEVERITIES {
+  SUCCESS = "success",
+  INFO = "info",
+  WARNING = "warning",
+  ERROR = "error"
+}
+
+// Cross-bundle action-type contract. NG dispatches actions whose `type` matches
+// these strings, and ng-core's reducer reads them via its local ACTIONS enum.
+// The string values must stay in sync with ng-core/src/core/store/actions.ts.
+export enum MESSAGE_ACTION_TYPES {
+  ADD_MESSAGE = "APP_MESSAGE_ADD_MESSAGE",
+  SET_MESSAGE_EXPIRED = "APP_MESSAGE_SET_MESSAGE_EXPIRED",
+  SET_CONFIRM_MESSAGE = "APP_MESSAGE_SET_CONFIRM_MESSAGE",
+  ADD_OVERLAY_MESSAGE = "APP_MESSAGE_ADD_OVERLAY_MESSAGE",
+  DELETE_OVERLAY_MESSAGES = "APP_MESSAGE_DELETE_OVERLAY_MESSAGES"
+}
+
+export interface JAppMessage {
+  id: string
+  text: string
+  severity: JAPP_MESSAGE_SEVERITIES
+  expired: boolean
+  duration: number | null
+}
+
+export interface JAppOverlayMessage {
+  id: string
+  text: string
+}
+
+export interface JAppConfirmMessage {
+  message: string
+  title: string
+  isInputMessage?: boolean
+  isInputOptional?: boolean
+  inputPlaceholder?: string
+  confirmButtonLabel?: string
+  cancelButtonLabel?: string
+  locale?: JLOCALES
+  onSuccess: (input: string) => any
+  onCancel?: () => any
+}
+
+export interface JAppMessageOptions {
+  severity?: JAPP_MESSAGE_SEVERITIES
+  duration?: number | null
+}
+
+export interface JAppMessageState {
+  messages: JAppMessage[]
+  overlayMessages: JAppOverlayMessage[]
+  confirmMessage: JAppConfirmMessage | undefined
+}
+
+export interface JAppMessageService {
+  error(message: string, options?: JAppMessageOptions): void
+  warning(message: string, options?: JAppMessageOptions): void
+  info(message: string, options?: JAppMessageOptions): void
+  success(message: string, options?: JAppMessageOptions): void
+  confirmMessage(params: JAppConfirmMessage): void
+  display(message: string, options?: JAppMessageOptions): void
+  displayWaitingOverlay(message: string): string
+  closeWaitingOverlay(messageId?: string): void
+}

package/public/jmap/startup-options.d.ts

@@ -496,14 +496,35 @@ export interface JCoreOptions {
    */
   extensionsUrlOverride?: JExtensionServerOverride[]
   /**
-   * By default NG Core provide a main layout in order to display:
-   *  - a loader incating NG Core is loading
-   *  - a login panel
-   *  - a project selection panel
+   * @deprecated Has no effect and is ignored at runtime. Control the shell with the `ui`
+   * startup option (`"full"` | `"minimal"`) or the `?ngUi=` URL parameter instead. Kept
+   * for source compatibility and will be removed in a future major version.
    *
-   * But you can avoid this UI by setting this option to true.
-   *
-   * For example NG don't need NG Core minimal UI and use this option.
+   * Previously: setting this to `true` suppressed NG Core's built-in main layout
+   * (loader, login panel, project selection panel).
    */
   hideMainLayout?: boolean
+  /**
+   * Selects which UI shell ng renders on top of the always-loaded core map.
+   *
+   *  - `"full"` (default) loads the full NG side-panel UI as a lazy chunk.
+   *  - `"minimal"` boots only the core map and skips the full-UI chunk entirely.
+   *
+   * Equivalent to the `?ngUi=full|minimal` URL parameter (also accepted as `#ngUi=…`); this
+   * option wins when both are set.
+   */
+  ui?: "full" | "minimal"
+  /**
+   * Test-only: pin the AppShell to a specific boot stage so containment / visual specs
+   * can drive every pre-app surface deterministically without sequencing a real boot.
+   *
+   * Accepted values: `"connecting" | "login" | "orgs" | "projects" | "openingProject" |
+   * "chunkError" | "error.serverInfo" | "error.anonymousLogin"`.
+   *
+   * Also accepts a `?__bootStage=<stage>` URL query parameter (useful for iframe
+   * scenarios where `JMAP_OPTIONS` is set inside the framed document). This is
+   * wired up exclusively for the rendering-tests harness; do not set it in any
+   * production boot.
+   */
+  testBootStageOverride?: string
 }

package/public/jmap/user.d.ts

@@ -1,3 +1,4 @@
+import type { JTranslationItem } from "./language.d.ts"
 import type { JProjectServerExtension } from "./project.d.ts"
 export {}
 // ALL_LOGIN_STATUS in all-enum.ts
@@ -56,9 +57,12 @@ export interface JTokenInfo {
 export interface JSessionData extends JUser, JTokenInfo {
   /**
    * The user permission to change his password
-   * @deprecated
    */
   changePasswordAllowed: boolean
+  /**
+   * The user permission to change his full name.
+   */
+  changeFullNameAllowed: boolean
   /**
    * Infos about the user's organizations.
    */
@@ -69,11 +73,20 @@ export interface JSessionData extends JUser, JTokenInfo {
   currentOrganization: JOrganization
 }
 
+export interface JIdentity {
+  name: string
+  auth0UserId: string
+  connection: string
+  provider: string
+  isPrimary: boolean
+}
+
 export interface JUser {
   name: string
   email: string
   organizationInfos: JOrganizationInfo[]
   roles: ROLES[]
+  identities?: JIdentity[]
 }
 
 export interface JUserInfo {
@@ -176,3 +189,24 @@ export interface JUserResourcePermissionsResponse {
   permissions: JUserResourcePermissionType[]
   principal: string
 }
+
+// Cross-bundle action-type contract for the user-actions slice. NG dispatches
+// actions tagged with these strings; ng-core's reducer reads them via its
+// local ACTIONS enum. The string values must stay in sync with
+// ng-core/src/core/store/actions.ts.
+export enum USER_ACTION_TYPES {
+  SET_ACTIONS = "APP_USER_SET_ACTIONS"
+}
+
+export interface JAppUserAction {
+  id: string
+  label: string | JTranslationItem
+  /**
+   * must be a fontawsome IconDefinition or a valid <img> src (url or base64 data)
+   */
+  icon: import("@fortawesome/fontawesome-svg-core").IconDefinition | string
+  isHelp?: boolean
+  href?: string
+  disabled?: boolean
+  onClick?: import("react").MouseEventHandler<HTMLLIElement>
+}

package/public/state.d.ts

@@ -3,6 +3,7 @@ import type { JGeocodingResult } from "./jmap/geocoding.d.ts"
 import type { JBoundaryBox, JLocation } from "./jmap/geometry.d.ts"
 import type { JLOCALES } from "./jmap/language.d.ts"
 import type { JLayerMetadataSchemaItem, JLayerStyleSamplesById, JLayerTree, JLayerTreeElement } from "./jmap/layer.d.ts"
+import type { JAppMessageState } from "./jmap/message.d.ts"
 import type { JId } from "./jmap/main.d.ts"
 import type { JMAP_CONTEXT_SORT_BY_DIRECTIONS, JMAP_CONTEXT_SORT_BY_OPTIONS, JMAP_CONTEXT_TABS, JMapContext } from "./jmap/map-context.d.ts"
 import type { JBasemap, JMAP_DISTANCE_UNITS, JMAP_MODIFICATION_TYPES, JMAP_POSITIONS, JMapAttribution, JMapNavigationStep, JMapSelection, JProjection, JZoomOptions } from "./jmap/map.d.ts"
@@ -11,7 +12,7 @@ import type { JSERVER_IDENTITY_PROVIDER_TYPES, JServerInfo } from "./jmap/server
 import type { JSimpleSearchResult } from "./jmap/simple-search.d.ts"
 import type { JTable } from "./jmap/table.d.ts"
 import type { JIFramePopup } from "./jmap/ui.d.ts"
-import type { JOrganization, JOrganizationInfo, JTokenInfo, JUser, JUserInfo, LOGIN_STATUS } from "./jmap/user.d.ts"
+import type { JAppUserAction, JOrganization, JOrganizationInfo, JTokenInfo, JUser, JUserInfo, LOGIN_STATUS } from "./jmap/user.d.ts"
 export {}
 
 export interface JCoreState {
@@ -28,12 +29,19 @@ export interface JCoreState {
   server: JServerState
   mapContext: JMapContextState
   ui: JUIState
+  message: JAppMessageState
   external?: any
 }
 
 export interface JUIState {
+  /**
+   * @deprecated No longer drives rendering and is always `true`. The shell is selected
+   * by the `ui` startup option (`"full"` | `"minimal"`) or `?ngUi=`. Kept for source
+   * compatibility; will be removed in a future major version.
+   */
   isMainLayoutVisible: boolean
   iframePopup: JIFramePopup
+  chunkLoadError: boolean
 }
 
 export interface JMapContextState {
@@ -95,6 +103,7 @@ export interface JMapState {
   rotation: number
   bearing: number
   isLoaded: boolean
+  isStyleLoaded: boolean
   hasFirstLoaded: boolean
   hasLoadingError: boolean
   navigationHistory: JMapNavigationStep[]
@@ -112,6 +121,7 @@ export interface JMapState {
   isTerrainAvailable: boolean
   isTerrainActive: boolean
   isScaleControlVisible: boolean
+  isInitialExtentControlVisible: boolean
   isMapRotationControlVisible: boolean
   isTerrainControlVisible: boolean
   isMapInfoControlVisible: boolean
@@ -121,7 +131,7 @@ export interface JMapState {
   containerHeight: number
   modificationType: JMAP_MODIFICATION_TYPES
   attributions: JMapAttribution[]
-  rasterOpacityByLayerId: { [id: JId]: number }
+  overriddenTransparencyByLayerId: { [id: JId]: number }
   projection: JProjection
 }
 
@@ -131,6 +141,11 @@ export interface JProjectState {
   allProjects: JProject[]
   selectedProject: JProject
   disableProjectChange: boolean
+  // True iff a specific project target was requested at boot (URL hash,
+  // JMAP_OPTIONS, or remembered storage), or the user clicked one in the list.
+  // Drives the boot state machine to render `openingProject` (minimal spinner)
+  // instead of briefly flashing the project list.
+  hasRequestedTarget: boolean
 }
 
 export interface JLayerState {
@@ -162,10 +177,12 @@ export interface JUserState extends JTokenInfo {
   organizationInfos: JOrganizationInfo[]
   informations: JUserInfo[]
   changePasswordAllowed: boolean
+  changeFullNameAllowed: boolean
   identityProviderType: JSERVER_IDENTITY_PROVIDER_TYPES
   loginStatus: LOGIN_STATUS
   loginStatusDetailTranslationKey: string
   callbackAtTokenRefresh: (() => void) | null
+  actions: JAppUserAction[]
 }
 
 export interface JLanguageState {