@giro3d/piero 25.10.0-beta.10

package/dist/src/types/configuration/datasets/ply.d.ts

@@ -0,0 +1,10 @@
+import { UrlOrDataMixin } from '../../../giro3d/sources/mixins';
+import { SourceConfigLocationMixin } from '../sources/core/baseConfig';
+import { DatasetConfigBase } from './core';
+/** PLY source configuration */
+export interface PLYDatasetSourceConfig extends UrlOrDataMixin, Required<SourceConfigLocationMixin> {
+}
+/** PLY dataset configuration */
+export interface PLYDatasetConfig extends DatasetConfigBase<'ply'> {
+    source: PLYDatasetSourceConfig;
+}

package/dist/src/types/configuration/datasets/pointCloud.d.ts

@@ -0,0 +1,12 @@
+import { PointCloudSourceOptions } from '../../../giro3d/entities/PointCloudEntity';
+import { DatasetConfigBase, DatasetConfigMaskingMixin, DatasetSourceConfigBase } from './core';
+export interface CSVPointCloudSourceConfig extends DatasetSourceConfigBase<'csv'>, PointCloudSourceOptions {
+}
+export interface COPCPointCloudSourceConfig extends DatasetSourceConfigBase<'copc'>, PointCloudSourceOptions {
+}
+export interface LASPointCloudSourceConfig extends DatasetSourceConfigBase<'las'>, PointCloudSourceOptions {
+}
+export type PointCloudSourceConfig = CSVPointCloudSourceConfig | LASPointCloudSourceConfig | COPCPointCloudSourceConfig;
+export interface PointCloudDatasetConfig extends DatasetConfigBase<'flatPointcloud'>, DatasetConfigMaskingMixin {
+    source: PointCloudSourceConfig;
+}

package/dist/src/types/configuration/datasets/potreePointCloud.d.ts

@@ -0,0 +1,10 @@
+import { SourceConfigUrlMixin } from '../sources/core/baseConfig';
+import { DatasetConfigBase, DatasetSourceConfigBase } from './core';
+/** Potree PointCloud source configuration */
+export interface PotreePointCloudDatasetSourceConfig extends DatasetSourceConfigBase<'potree'>, SourceConfigUrlMixin {
+    filename?: string;
+}
+/** Potree PointCloud dataset configuration */
+export interface PotreePointCloudDatasetConfig extends DatasetConfigBase<'potree'> {
+    source: PotreePointCloudDatasetSourceConfig;
+}

package/dist/src/types/configuration/datasets/tiledIfc.d.ts

@@ -0,0 +1,9 @@
+import { Tiles3dSource } from '../../../giro3d/entities/Tiles3dEntity';
+import { DatasetConfigBase } from './core';
+/** 3DTiles IFC source configuration */
+export interface TiledIfcDatasetSourceConfig extends Tiles3dSource {
+}
+/** 3DTiles IFC dataset configuration */
+export interface TiledIfcDatasetConfig extends DatasetConfigBase<'tiledIfc'> {
+    source: TiledIfcDatasetSourceConfig;
+}

package/dist/src/types/configuration/datasets/tiledPointCloud.d.ts

@@ -0,0 +1,9 @@
+import { TiledPointCloudSource } from '../../../giro3d/entities/TiledPointCloudEntity';
+import { DatasetConfigBase, DatasetConfigMaskingMixin } from './core';
+/** 3D-Tiles PointCloud source configuration */
+export interface TiledPointCloudSourceConfig extends Omit<TiledPointCloudSource, 'name'> {
+}
+/** 3D-Tiles PointCloud dataset configuration */
+export interface TiledPointCloudDatasetConfig extends DatasetConfigBase<'pointcloud'>, DatasetConfigMaskingMixin {
+    source: TiledPointCloudSourceConfig;
+}

package/dist/src/types/configuration/datasets/vector.d.ts

@@ -0,0 +1,34 @@
+import { VectorLabelOptions } from '../../../giro3d/entities/VectorLabelsEntity';
+import { VectorMeshSourceOptions } from '../../../giro3d/entities/VectorMeshEntity';
+import { GeopackageSourceParameters } from '../../../giro3d/sources/GeopackageSource';
+import { ShapefileSourceParameters } from '../../../giro3d/sources/ShapefileSource';
+import { default as FeatureFormat } from 'ol/format/Feature';
+import { DatasetConfigBase, DatasetSourceConfigBase } from './core';
+export interface OlMeshSourceConfig extends DatasetSourceConfigBase<'ol'>, Omit<VectorMeshSourceOptions, 'featureProjection'> {
+    format: FeatureFormat;
+}
+export interface GpxMeshSourceConfig extends DatasetSourceConfigBase<'gpx'>, Omit<VectorMeshSourceOptions, 'featureProjection'> {
+}
+export interface KmlMeshSourceConfig extends DatasetSourceConfigBase<'kml'>, Omit<VectorMeshSourceOptions, 'featureProjection'> {
+}
+export interface GeoJsonMeshSourceConfig extends DatasetSourceConfigBase<'geojson'>, Omit<VectorMeshSourceOptions, 'featureProjection'> {
+}
+export interface GeopackageMeshSourceConfig extends DatasetSourceConfigBase<'geopackage'>, Omit<GeopackageSourceParameters, 'featureProjection'> {
+}
+export interface ShapefileMeshSourceConfig extends DatasetSourceConfigBase<'shapefile'>, Omit<ShapefileSourceParameters, 'featureProjection'> {
+}
+export type VectorMeshDatasetSourceConfig = GpxMeshSourceConfig | KmlMeshSourceConfig | GeoJsonMeshSourceConfig | GeopackageMeshSourceConfig | ShapefileMeshSourceConfig | OlMeshSourceConfig;
+export interface VectorMeshDatasetConfig extends DatasetConfigBase<'vector'> {
+    source: VectorMeshDatasetSourceConfig | VectorMeshDatasetSourceConfig[];
+    rendering?: 'mesh';
+}
+export interface VectorShapeDatasetConfig extends DatasetConfigBase<'vector'> {
+    source: VectorMeshDatasetSourceConfig;
+    rendering: 'shape';
+}
+export interface VectorLabelsDatasetConfig extends DatasetConfigBase<'vector'>, VectorLabelOptions {
+    source: VectorMeshDatasetSourceConfig | VectorMeshDatasetSourceConfig[];
+    rendering: 'label';
+}
+export type VectorDatasetConfig = VectorMeshDatasetConfig | VectorShapeDatasetConfig | VectorLabelsDatasetConfig;
+export type VectorDatasetRendering = NonNullable<VectorDatasetConfig['rendering']>;

package/dist/src/types/configuration/features.d.ts

@@ -0,0 +1,2 @@
+/** Available experimental features */
+export type ExperimentalFeatures = 'measurements';

package/dist/src/types/configuration/geographic.d.ts

@@ -0,0 +1,51 @@
+/**
+ * CRS name.
+ *
+ * Requires the CRS to be registered in [`src/services/Giro3DManager.ts`](../services/Giro3DManager.ts)
+ * @example `EPSG:2154`
+ * @example `IGNF:WGS84G`
+ */
+export type CRS = string;
+export interface Vec2 {
+    x: number;
+    y: number;
+}
+/**
+ * 2D Position
+ *
+ * If the CRS is not provided, we use `default_crs`
+ *
+ * @example `{ crs: 'EPSG:2154', x: 842022, y: 6516602 }`
+ */
+export interface GeoVec2 extends Vec2 {
+    crs?: CRS;
+}
+export interface Vec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * 3D Position
+ *
+ * If the CRS is not provided, we use `default_crs`
+ *
+ * @example `{ crs: 'EPSG:2154', x: 842022, y: 6516602, z: 725 }`
+ */
+export interface GeoVec3 extends Vec3 {
+    crs?: CRS;
+}
+/**
+ * Extent
+ *
+ * If the CRS is not provided, we use `default_crs`
+ *
+ * @example `{ crs: 'EPSG:2154', west: -111629.52, east: 1275028.84, south: 5976033.79, north: 7230161.64 }`
+ */
+export interface GeoExtent {
+    crs?: string;
+    west: number;
+    east: number;
+    south: number;
+    north: number;
+}

package/dist/src/types/configuration/layers/core.d.ts

@@ -0,0 +1,50 @@
+import { ColorMapConfig } from '../color';
+import { GeoExtent } from '../geographic';
+import { LayerSourceConfig } from '.';
+import { ColorLayerOptions } from '@giro3d/giro3d/core/layer/ColorLayer';
+import { ElevationLayerOptions } from '@giro3d/giro3d/core/layer/ElevationLayer';
+import { Mode as InterpretationMode, InterpretationOptions } from '@giro3d/giro3d/core/layer/Interpretation';
+import { LayerOptions } from '@giro3d/giro3d/core/layer/Layer';
+import { MaskLayerOptions } from '@giro3d/giro3d/core/layer/MaskLayer';
+/** Mixin configuration for layer options */
+export interface LayerConfigMixin extends Pick<LayerOptions, 'showTileBorders' | 'showEmptyTextures' | 'noDataOptions' | 'preloadImages' | 'resolutionFactor' | 'minFilter' | 'magFilter'> {
+    /** Restrict the extent of the data */
+    extent?: GeoExtent;
+    /** Interpretation mode of the data */
+    interpretation?: InterpretationOptions & {
+        mode: InterpretationMode;
+    };
+    /** Color map for displaying the layer */
+    colorMap?: ColorMapConfig;
+    /** Background color of the layer */
+    backgroundColor?: string;
+}
+/** Basemap layer configuration */
+export interface LayerConfigBase<TLayerType extends string> extends LayerConfigMixin {
+    /** Type of layer */
+    type: TLayerType;
+    /** Name of the layer displayed in the UI */
+    name: string;
+    /** Source configuration */
+    source: LayerSourceConfig;
+    /** Indicates if the layer should be loaded by default */
+    visible: boolean;
+}
+/** Mixin configuration for color layer options */
+export interface ColorLayerConfigMixin extends Pick<ColorLayerOptions, 'elevationRange' | 'opacity' | 'minFilter' | 'magFilter'> {
+}
+/** Mixin configuration for elevation layer options */
+export interface ElevationLayerConfigMixin extends Pick<ElevationLayerOptions, 'minmax'> {
+}
+/** Mixin configuration for mask layer options */
+export interface MaskLayerConfigMixin extends Pick<MaskLayerOptions, 'maskMode'> {
+}
+/** Color layer configuration */
+export interface ColorLayerConfig extends LayerConfigBase<'color'>, ColorLayerConfigMixin {
+}
+/** Elevation layer configuration */
+export interface ElevationLayerConfig extends LayerConfigBase<'elevation'>, ElevationLayerConfigMixin {
+}
+/** Mask layer configuration */
+export interface MaskLayerConfig extends LayerConfigBase<'mask'>, MaskLayerConfigMixin {
+}

package/dist/src/types/configuration/layers/index.d.ts

@@ -0,0 +1,49 @@
+import { BingMapsSourceConfig } from '../sources/bingMaps';
+import { CustomVectorSourceConfig } from '../sources/customVector';
+import { CustomVectorTileSourceConfig } from '../sources/customVectorTile';
+import { GeoJSONAsLayerSourceConfig } from '../sources/geojson';
+import { GeoTIFFSourceConfig } from '../sources/geotiff';
+import { GPXAsLayerSourceConfig } from '../sources/gpx';
+import { KMLAsLayerSourceConfig } from '../sources/kml';
+import { MVTSourceConfig } from '../sources/mvt';
+import { OSMSourceConfig } from '../sources/osm';
+import { StadiaMapsSourceConfig } from '../sources/stadiaMaps';
+import { WMSSourceConfig } from '../sources/wms';
+import { WMTSSourceConfig } from '../sources/wmts';
+import { XYZSourceConfig } from '../sources/xyz';
+import { ColorLayerConfig, ElevationLayerConfig, MaskLayerConfig } from './core';
+/** Supported layer sources */
+export type LayerSourceConfig = BingMapsSourceConfig | GeoTIFFSourceConfig | CustomVectorSourceConfig | CustomVectorTileSourceConfig | GeoJSONAsLayerSourceConfig | GPXAsLayerSourceConfig | KMLAsLayerSourceConfig | MVTSourceConfig | OSMSourceConfig | StadiaMapsSourceConfig | WMSSourceConfig | WMTSSourceConfig | XYZSourceConfig;
+/** Supported layer source types */
+export type LayerSourceType = LayerSourceConfig['type'];
+/** Available configuration for layer sources */
+export type BasemapLayerSourceConfig = LayerSourceConfig;
+/** Available configuration for overlay sources */
+export type OverlaySourceConfig = LayerSourceConfig;
+/** Overlay configuration */
+export interface OverlayConfig extends Omit<ColorLayerConfig, 'type'> {
+    /** Source configuration */
+    source: OverlaySourceConfig;
+}
+/**
+ * Vector overlay configuration
+ *
+ * @deprecated Use 'source' field instead. Will be removed in release v24.7.
+ */
+export type OverlayVectorConfigDeprecated = Omit<OverlayConfig, 'source'> & (GeoJSONAsLayerSourceConfig | GPXAsLayerSourceConfig | KMLAsLayerSourceConfig);
+/**
+ * Vector tile overlay configuration
+ *
+ * @deprecated Use 'source' field instead. Will be removed in release v24.7.
+ */
+export type OverlayVectorTileConfigDeprecated = Omit<OverlayConfig, 'source'> & MVTSourceConfig;
+/**
+ * Raster overlay configuration
+ *
+ * @deprecated Use 'source' field instead. Will be removed in release v24.7.
+ */
+export type OverlayRasterConfigDeprecated = OverlayConfig & (WMSSourceConfig | WMTSSourceConfig);
+/** Layer configuration */
+export type LayerConfig = ColorLayerConfig | ElevationLayerConfig | MaskLayerConfig;
+/** Supported Giro3D layer types */
+export type LayerType = LayerConfig['type'];

package/dist/src/types/configuration/sources/bingMaps.d.ts

@@ -0,0 +1,5 @@
+import { Options as BingMapsOptions } from 'ol/source/BingMaps';
+import { ImageSourceConfigMixin, SourceConfigBase } from './core/baseConfig';
+/** Bing maps source configuration */
+export interface BingMapsSourceConfig extends SourceConfigBase<'bingmaps'>, ImageSourceConfigMixin, Pick<BingMapsOptions, 'hidpi' | 'culture' | 'key' | 'imagerySet'> {
+}

package/dist/src/types/configuration/sources/core/baseConfig.d.ts

@@ -0,0 +1,70 @@
+import { CRS, GeoVec3 } from '../../geographic';
+import { UrlOrData } from '../../../../utils/Fetcher';
+import { ImageSourceOptions } from '@giro3d/giro3d/sources/ImageSource';
+/** Base configuration for all sources (layers, overlays and datasets) */
+export interface SourceConfigBase<TSourceType extends string> {
+    /** Type of source */
+    type: TSourceType;
+}
+/** Mixin configuration for sources that require a URL */
+export interface SourceConfigUrlMixin {
+    /** URL of the source */
+    url: string;
+}
+/** Mixin configuration for sources that require a URL or Blob */
+export interface SourceConfigUrlOrDataMixin {
+    /** URL of the source */
+    url: UrlOrData;
+}
+/** Mixin configuration for sources that may set their geolocation */
+export interface SourceConfigLocationMixin {
+    /** Location */
+    position?: GeoVec3;
+}
+/** Mixin configuration for sources that may have a data projection */
+export interface SourceConfigProjectionMixin {
+    /** CRS of the source - must be registered first */
+    dataProjection?: CRS;
+}
+/** Mixin configuration for sources that may require elevation configuration */
+export interface SourceConfigElevationMixin {
+    /**
+     * Elevation of data
+     *
+     * @defaultValue 0
+     */
+    elevation?: number;
+    /**
+     * Fetch elevation from provider
+     *
+     * @defaultValue false
+     */
+    fetchElevation?: boolean;
+    /**
+     * Fetch elevation from map instead of API
+     *
+     * @defaultValue false
+     */
+    fetchElevationFast?: boolean;
+    /**
+     * When fetching elevation, add this offset
+     *
+     * @defaultValue 0.1
+     */
+    fetchElevationOffset?: number;
+    /**
+     * When fetching or setting elevation, consider this value as no data
+     *
+     * @defaultValue 0
+     */
+    noDataValue?: number;
+}
+/** Mixin configuration for layers and overlays sources */
+export interface ImageSourceConfigMixin extends Pick<ImageSourceOptions, 'flipY' | 'is8bit' | 'colorSpace'> {
+    /**
+     * The relative resolution of the layer.
+     * If greater than 1, the resolution will be greater, at the cost of performance and memory usage.
+     * @defaultValue 1
+     */
+    resolution?: number;
+}

package/dist/src/types/configuration/sources/core/tiled.d.ts

@@ -0,0 +1,19 @@
+import { GeoExtent } from '../../geographic';
+import { TiledImageSourceOptions } from '@giro3d/giro3d/sources/TiledImageSource';
+import { ImageSourceConfigMixin } from './baseConfig';
+/** Format for decoding the data */
+export type DecodingFormat = 'Bil' | 'MapboxTerrain' | 'GeoTIFF';
+/** Mixin configuration for tiled layers */
+export interface TiledImageSourceConfigMixin extends ImageSourceConfigMixin, Pick<TiledImageSourceOptions, 'noDataValue' | 'httpTimeout' | 'retries'> {
+    /** Mime-type (`image/png`, `image/jpg`, etc.) */
+    format?: string;
+    /** Decoding format. Required for Mapbox Terrain for instance. */
+    imageFormat?: DecodingFormat;
+    /** Restrict the extent of the data */
+    extent?: GeoExtent;
+    /**
+     * No data value, if any
+     * @deprecated Use `noDataValue` instead. Will be removed in v24.10
+     */
+    nodata?: number;
+}

package/dist/src/types/configuration/sources/core/vector.d.ts

@@ -0,0 +1,13 @@
+import { VectorStyle } from '../../../VectorStyle';
+import { CRS } from '../../geographic';
+import { ImageSourceConfigMixin, SourceConfigProjectionMixin, SourceConfigUrlOrDataMixin } from './baseConfig';
+/** Mixin configuration for vector sources, common to meshes and map layers */
+export interface VectorSourceConfigMixin extends SourceConfigProjectionMixin {
+    /** @deprecated Use {@link dataProjection} instead, will be removed in 24.10 */
+    projection?: CRS;
+}
+/** Mixin configuration for vector sources displayed as map layers */
+export interface VectorAsLayerSourceConfigMixin extends VectorSourceConfigMixin, SourceConfigUrlOrDataMixin, ImageSourceConfigMixin {
+    /** Style */
+    style: VectorStyle;
+}

package/dist/src/types/configuration/sources/core/vectorTile.d.ts

@@ -0,0 +1,8 @@
+import { VectorStyle } from '../../../VectorStyle';
+import { VectorTileSourceOptions } from '@giro3d/giro3d/sources/VectorTileSource';
+import { ImageSourceConfigMixin } from './baseConfig';
+/** Mixin configuration for vector tiled layers */
+export interface VectorTileSourceConfigMixin extends Pick<VectorTileSourceOptions, 'url' | 'backgroundColor'>, ImageSourceConfigMixin {
+    /** Style */
+    style: VectorStyle;
+}

package/dist/src/types/configuration/sources/customVector.d.ts

@@ -0,0 +1,7 @@
+import { SourceConfigBase } from './core/baseConfig';
+import { VectorAsLayerSourceConfigMixin } from './core/vector';
+import { default as FeatureFormat } from 'ol/format/Feature';
+/** Vector source with custom format */
+export interface CustomVectorSourceConfig extends SourceConfigBase<'vector'>, VectorAsLayerSourceConfigMixin {
+    format: FeatureFormat;
+}

package/dist/src/types/configuration/sources/customVectorTile.d.ts

@@ -0,0 +1,8 @@
+import { SourceConfigBase } from './core/baseConfig';
+import { VectorTileSourceConfigMixin } from './core/vectorTile';
+import { default as FeatureFormat } from 'ol/format/Feature';
+import { default as RenderFeature } from 'ol/render/Feature';
+/** VectorTile source with custom format */
+export interface CustomVectorTileSourceConfig extends SourceConfigBase<'vector-tile'>, VectorTileSourceConfigMixin {
+    format: FeatureFormat<typeof RenderFeature>;
+}

package/dist/src/types/configuration/sources/geojson.d.ts

@@ -0,0 +1,5 @@
+import { SourceConfigBase } from './core/baseConfig';
+import { VectorAsLayerSourceConfigMixin } from './core/vector';
+/** GeoJSON source configuration when displayed as a map layer */
+export interface GeoJSONAsLayerSourceConfig extends SourceConfigBase<'geojson'>, VectorAsLayerSourceConfigMixin {
+}

package/dist/src/types/configuration/sources/geotiff.d.ts

@@ -0,0 +1,8 @@
+import { CRS } from '../geographic';
+import { GeoTIFFSourceOptions } from '@giro3d/giro3d/sources/GeoTIFFSource';
+import { ImageSourceConfigMixin, SourceConfigBase, SourceConfigProjectionMixin } from './core/baseConfig';
+/** COG source configuration */
+export interface GeoTIFFSourceConfig extends SourceConfigBase<'cog'>, ImageSourceConfigMixin, SourceConfigProjectionMixin, Pick<GeoTIFFSourceOptions, 'url' | 'channels'> {
+    /** @deprecated Use {@link dataProjection} instead, will be removed in 24.10 */
+    projection: CRS;
+}

package/dist/src/types/configuration/sources/gpx.d.ts

@@ -0,0 +1,5 @@
+import { SourceConfigBase } from './core/baseConfig';
+import { VectorAsLayerSourceConfigMixin } from './core/vector';
+/** GPX source configuration when displayed as a map layer */
+export interface GPXAsLayerSourceConfig extends SourceConfigBase<'gpx'>, VectorAsLayerSourceConfigMixin {
+}

package/dist/src/types/configuration/sources/kml.d.ts

@@ -0,0 +1,5 @@
+import { SourceConfigBase } from './core/baseConfig';
+import { VectorAsLayerSourceConfigMixin } from './core/vector';
+/** KML source configuration when displayed as a map layer */
+export interface KMLAsLayerSourceConfig extends SourceConfigBase<'kml'>, VectorAsLayerSourceConfigMixin {
+}

package/dist/src/types/configuration/sources/mvt.d.ts

@@ -0,0 +1,10 @@
+import { SourceConfigBase } from './core/baseConfig';
+import { VectorTileSourceConfigMixin } from './core/vectorTile';
+/** MVT source configuration */
+export interface MVTSourceConfig extends SourceConfigBase<'mvt'>, VectorTileSourceConfigMixin {
+    /**
+     * URL of the source.
+     * Should include `{x},{y},{z}` components, e.g. `https://3d.oslandia.com/mysource/{z}/{x}/{y}.pbf`
+     * */
+    url: string;
+}

package/dist/src/types/configuration/sources/osm.d.ts

@@ -0,0 +1,5 @@
+import { Options as OSMOptions } from 'ol/source/OSM';
+import { ImageSourceConfigMixin, SourceConfigBase } from './core/baseConfig';
+/** OSM source configuration */
+export interface OSMSourceConfig extends SourceConfigBase<'osm'>, ImageSourceConfigMixin, Pick<OSMOptions, 'url'> {
+}

package/dist/src/types/configuration/sources/stadiaMaps.d.ts

@@ -0,0 +1,5 @@
+import { Options as StadiaMapsOptions } from 'ol/source/StadiaMaps';
+import { ImageSourceConfigMixin, SourceConfigBase } from './core/baseConfig';
+/** StadiaMaps source configuration */
+export interface StadiaMapsSourceConfig extends SourceConfigBase<'stadiamaps'>, ImageSourceConfigMixin, Pick<StadiaMapsOptions, 'layer' | 'url' | 'apiKey'> {
+}

package/dist/src/types/configuration/sources/wms.d.ts

@@ -0,0 +1,15 @@
+import { CRS } from '../geographic';
+import { SourceConfigBase, SourceConfigProjectionMixin } from './core/baseConfig';
+import { TiledImageSourceConfigMixin } from './core/tiled';
+/** WMS source configuration */
+export interface WMSSourceConfig extends SourceConfigBase<'wms'>, TiledImageSourceConfigMixin, SourceConfigProjectionMixin {
+    /** @deprecated Use {@link dataProjection} instead, will be removed in 24.10 */
+    projection?: CRS;
+    /** Name of the layer, as available in the `getCapabilities` of the source */
+    layer: string | string[];
+    /**
+     * URL of the source.
+     * Should be the endpoint without parameters, e.g. `'https://data.geopf.fr/wms-r'`
+     */
+    url: string;
+}

package/dist/src/types/configuration/sources/wmts.d.ts

@@ -0,0 +1,15 @@
+import { CRS } from '../geographic';
+import { SourceConfigBase, SourceConfigProjectionMixin } from './core/baseConfig';
+import { TiledImageSourceConfigMixin } from './core/tiled';
+/** WMTS source configuration */
+export interface WMTSSourceConfig extends SourceConfigBase<'wmts'>, TiledImageSourceConfigMixin, SourceConfigProjectionMixin {
+    /** @deprecated Use {@link dataProjection} instead, will be removed in 24.10 */
+    projection?: CRS;
+    /** Name of the layer, as available in the `getCapabilities` of the source */
+    layer: string;
+    /**
+     * URL of the source.
+     * Should be the URL pointing to the `getCapabilities`, e.g. `https://data.geopf.fr/wmts?SERVICE=WMTS&VERSION=1.0.0&REQUEST=GetCapabilities`,
+     */
+    url: string;
+}

package/dist/src/types/configuration/sources/xyz.d.ts

@@ -0,0 +1,9 @@
+import { CRS } from '../geographic';
+import { Options as XYZOptions } from 'ol/source/XYZ';
+import { SourceConfigBase, SourceConfigProjectionMixin } from './core/baseConfig';
+import { TiledImageSourceConfigMixin } from './core/tiled';
+/** XYZ source configuration */
+export interface XYZSourceConfig extends SourceConfigBase<'xyz'>, TiledImageSourceConfigMixin, SourceConfigProjectionMixin, Pick<XYZOptions, 'url' | 'urls'> {
+    /** @deprecated Use {@link dataProjection} instead, will be removed in 24.10 */
+    projection?: CRS;
+}

package/dist/src/types/utilities.d.ts

@@ -0,0 +1,5 @@
+/** Keys of optional properties of T */
+export type OptionalPropertyOf<T extends object> = Exclude<{
+    [K in keyof T]: T extends Record<K, T[K]> ? never : K;
+}[keyof T], undefined>;
+export type ExtractOptional<T extends object> = Pick<T, OptionalPropertyOf<T>>;

package/dist/src/utils/Components.d.ts

@@ -0,0 +1,8 @@
+import { Ref } from 'vue';
+/**
+ * Stores reference and watches for changes on a property of an object
+ * @param object - Object
+ * @param propName - Property name
+ * @returns Watched reference to the property
+ */
+export declare function refAndWatch<T, K extends keyof T>(object: T, propName: K): Ref<T[K]>;

package/dist/src/utils/Configuration.d.ts

@@ -0,0 +1,15 @@
+import { ColorMapConfig } from '../types/configuration/color';
+import { ExperimentalFeatures } from '../types/configuration/features';
+import { GeoExtent, GeoVec3 } from '../types/configuration/geographic';
+import { default as ColorMap } from '@giro3d/giro3d/core/ColorMap';
+import { default as Coordinates } from '@giro3d/giro3d/core/geographic/Coordinates';
+import { default as Extent } from '@giro3d/giro3d/core/geographic/Extent';
+export declare function getPublicFolderUrl(url: string): string;
+export declare function hasExperimentalFeature(feature: ExperimentalFeatures): boolean;
+export declare function getColorMap(config: ColorMapConfig): ColorMap;
+export declare function getCoordinates(geovec3: GeoVec3): Coordinates;
+export declare function getCoordinates(): undefined;
+export declare function getCoordinates(geovec3?: GeoVec3): Coordinates | undefined;
+export declare function getExtent(extent: GeoExtent): Extent;
+export declare function getExtent(): undefined;
+export declare function getExtent(extent?: GeoExtent): Extent | undefined;

package/dist/src/utils/Download.d.ts

@@ -0,0 +1,11 @@
+declare function downloadBlob(object: Blob | MediaSource, filename: string): void;
+declare function downloadAsJson(object: object, filename: string): void;
+declare function setBaseUrl(url: string): void;
+declare function getBaseUrl(fallback?: string): string;
+declare const _default: {
+    downloadBlob: typeof downloadBlob;
+    downloadAsJson: typeof downloadAsJson;
+    getBaseUrl: typeof getBaseUrl;
+    setBaseUrl: typeof setBaseUrl;
+};
+export default _default;

package/dist/src/utils/Fetcher.d.ts

@@ -0,0 +1,77 @@
+/** URL to load or Blob (drag-and-drop) */
+export type UrlOrData = string | Blob;
+/** URL to load, or Response (already loaded), or Blob (drag-and-drop) */
+export type UrlOrFetchedData = string | Response | Blob;
+/**
+ * Info on a file.
+ * Inspired by loaders.gl LoaderContext
+ */
+export interface FetchContext {
+    /** Full URL of the resource (without query string) */
+    baseUrl: string;
+    /** Query string (beginning with the leading `?` character) */
+    queryString?: string;
+    /** Directory name (`baseUrl` up to the filename) */
+    dirname: string;
+    /** Filename */
+    filename: string;
+    /** File extension */
+    fileext?: string;
+}
+/**
+ * Checks a host is parsable and starts with `http(s)://`.
+ * This is useful when passing hosts to Giro3D's HttpConfiguration.
+ *
+ * @param host - Host (e.g. https://example.com/foobar)
+ * @returns true if valid
+ */
+declare function checkAbsoluteHost(host: string): boolean;
+/**
+ * Fetcher that is able to fetch a URL (if string) or make a Response from a File-object.
+ *
+ * This redefines loaders.gl's fetch function to use Giro3D's fetcher.
+ *
+ * @param urlOrData - URL to fetch or Blob
+ * @param fetchOptions - fetch options
+ * @returns The response object
+ */
+declare function fetchInternal(urlOrData: UrlOrData, fetchOptions?: RequestInit): Promise<Response>;
+declare function toDataURL(url: UrlOrData): Promise<string>;
+/**
+ * Fetches a url, Blob-like object and returns an ArrayBuffer object
+ * @param url - URL or Blob-like object
+ * @param fetchOptions - fetch options
+ * @returns ArrayBuffer
+ */
+declare function fetchArrayBuffer(url: UrlOrData, fetchOptions?: RequestInit): Promise<ArrayBuffer>;
+/**
+ * Fetches a url or Blob-like object and returns the content as a string
+ * @param url - URL or Blob-like object
+ * @param fetchOptions - fetch options
+ * @returns Content as string
+ */
+declare function fetchText(url: UrlOrData, fetchOptions?: RequestInit): Promise<string>;
+/**
+ * Fetches a url or Blob-like object and returns the content as a JSON object
+ * @param params - URL or Blob-like object
+ * @param fetchOptions - fetch options
+ * @returns Content as JSON object
+ * @typeParam T - Type of the JSON object returned
+ */
+declare function fetchJson<T extends object = object>(url: UrlOrData, fetchOptions?: RequestInit): Promise<T>;
+/**
+ * Gets the context from a url, Response or Blob-like object
+ * @param urlOrFetchedData - URL, Response or Blob-like object
+ * @returns Fetch context
+ */
+declare function getContext(urlOrFetchedData: UrlOrFetchedData): FetchContext;
+declare const _default: {
+    checkAbsoluteHost: typeof checkAbsoluteHost;
+    fetch: typeof fetchInternal;
+    fetchArrayBuffer: typeof fetchArrayBuffer;
+    fetchText: typeof fetchText;
+    fetchJson: typeof fetchJson;
+    getContext: typeof getContext;
+    toDataURL: typeof toDataURL;
+};
+export default _default;

package/dist/src/utils/Measure.d.ts

@@ -0,0 +1,7 @@
+import { default as Shape } from '@giro3d/giro3d/entities/Shape';
+import { Vector3 } from '../../../../node_modules/three';
+declare function getMinMaxAltitudes(coordsOrDrawing: Shape | Vector3[]): [number, number];
+declare const _default: {
+    getMinMaxAltitudes: typeof getMinMaxAltitudes;
+};
+export default _default;