ol 7.1.1-dev.1663240093930 → 7.1.1-dev.1663334047420

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ol",
-  "version": "7.1.1-dev.1663240093930",
+  "version": "7.1.1-dev.1663334047420",
   "description": "OpenLayers mapping library",
   "keywords": [
     "map",

package/proj/proj4.d.ts

@@ -1,3 +1,11 @@
+/**
+ * @return {boolean} Proj4 has been registered.
+ */
+export function isRegistered(): boolean;
+/**
+ * Unsets the shared proj4 previsouly set with register.
+ */
+export function unregister(): void;
 /**
  * Make projections defined in proj4 (with `proj4.defs()`) available in
  * OpenLayers. Requires proj4 >= 2.8.0.
@@ -6,8 +14,40 @@
  * registry, e.g. after calling `proj4.defs()`. Existing transforms will not be
  * modified by this function.
  *
- * @param {?} proj4 Proj4.
+ * @param {import("proj4")} proj4 Proj4.
+ * @api
+ */
+export function register(proj4: typeof import("proj4")): void;
+/**
+ * Set the lookup function for getting proj4 definitions given an EPSG code.
+ * By default, the {@link module:ol/proj/proj4.fromEPSGCode} function uses the
+ * epsg.io website for proj4 definitions.  This can be changed by providing a
+ * different lookup function.
+ *
+ * @param {function(number):Promise<string>} func The lookup function.
+ * @api
+ */
+export function setEPSGLookup(func: (arg0: number) => Promise<string>): void;
+/**
+ * Get the current EPSG lookup function.
+ *
+ * @return {function(number):Promise<string>} The EPSG lookup function.
+ */
+export function getEPSGLookup(): (arg0: number) => Promise<string>;
+/**
+ * Get a projection from an EPSG code.  This function fetches the projection
+ * definition from the epsg.io website, registers this definition for use with
+ * proj4, and returns a configured projection.  You must call import proj4 and
+ * call {@link module:ol/proj/proj4.register} before using this function.
+ *
+ * If the projection definition is already registered with proj4, it will not
+ * be fetched again (so it is ok to call this function multiple times with the
+ * same code).
+ *
+ * @param {number|string} code The EPSG code (e.g. 4326 or 'EPSG:4326').
+ * @return {Promise<Projection>} The projection.
  * @api
  */
-export function register(proj4: unknown): void;
+export function fromEPSGCode(code: number | string): Promise<Projection>;
+import Projection from "./Projection.js";
 //# sourceMappingURL=proj4.d.ts.map

package/proj/proj4.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proj4.d.ts","sourceRoot":"","sources":["proj4.js"],"names":[],"mappings":"AAaA;;;;;;;;;;GAUG;AACH,+CA2CC"}
+{"version":3,"file":"proj4.d.ts","sourceRoot":"","sources":["proj4.js"],"names":[],"mappings":"AAkBA;;GAEG;AACH,gCAFY,OAAO,CAIlB;AAED;;GAEG;AACH,mCAEC;AAED;;;;;;;;;;GAUG;AACH,8DA6CC;AAcD;;;;;;;;GAQG;AACH,2CAHoB,MAAM,KAAE,QAAQ,MAAM,CAAC,QAK1C;AAED;;;;GAIG;AACH,wCAFqB,MAAM,KAAE,QAAQ,MAAM,CAAC,CAI3C;AAED;;;;;;;;;;;;;GAaG;AACH,mCAJW,MAAM,GAAC,MAAM,GACZ,QAAQ,UAAU,CAAC,CAsB9B"}

package/proj/proj4.js

@@ -11,6 +11,25 @@ import {
 } from '../proj.js';
 import {get as getTransform} from './transforms.js';
 
+/**
+ * @type {import("proj4")|null}
+ */
+let registered = null;
+
+/**
+ * @return {boolean} Proj4 has been registered.
+ */
+export function isRegistered() {
+  return !!registered;
+}
+
+/**
+ * Unsets the shared proj4 previsouly set with register.
+ */
+export function unregister() {
+  registered = null;
+}
+
 /**
  * Make projections defined in proj4 (with `proj4.defs()`) available in
  * OpenLayers. Requires proj4 >= 2.8.0.
@@ -19,10 +38,12 @@ import {get as getTransform} from './transforms.js';
  * registry, e.g. after calling `proj4.defs()`. Existing transforms will not be
  * modified by this function.
  *
- * @param {?} proj4 Proj4.
+ * @param {import("proj4")} proj4 Proj4.
  * @api
  */
 export function register(proj4) {
+  registered = proj4;
+
   const projCodes = Object.keys(proj4.defs);
   const len = projCodes.length;
   let i, j;
@@ -30,7 +51,7 @@ export function register(proj4) {
     const code = projCodes[i];
     if (!get(code)) {
       const def = proj4.defs(code);
-      let units = def.units;
+      let units = /** @type {import("./Units.js").Units} */ (def.units);
       if (!units && def.projName === 'longlat') {
         units = 'degrees';
       }
@@ -66,3 +87,72 @@ export function register(proj4) {
     }
   }
 }
+
+/**
+ * @param {number} code The EPSG code.
+ * @return {Promise<string>} The proj4 definition.
+ */
+let epsgLookup = async function (code) {
+  const response = await fetch(`https://epsg.io/${code}.proj4`);
+  if (!response.ok) {
+    throw new Error(`Unexpected response from epsg.io: ${response.status}`);
+  }
+  return response.text();
+};
+
+/**
+ * Set the lookup function for getting proj4 definitions given an EPSG code.
+ * By default, the {@link module:ol/proj/proj4.fromEPSGCode} function uses the
+ * epsg.io website for proj4 definitions.  This can be changed by providing a
+ * different lookup function.
+ *
+ * @param {function(number):Promise<string>} func The lookup function.
+ * @api
+ */
+export function setEPSGLookup(func) {
+  epsgLookup = func;
+}
+
+/**
+ * Get the current EPSG lookup function.
+ *
+ * @return {function(number):Promise<string>} The EPSG lookup function.
+ */
+export function getEPSGLookup() {
+  return epsgLookup;
+}
+
+/**
+ * Get a projection from an EPSG code.  This function fetches the projection
+ * definition from the epsg.io website, registers this definition for use with
+ * proj4, and returns a configured projection.  You must call import proj4 and
+ * call {@link module:ol/proj/proj4.register} before using this function.
+ *
+ * If the projection definition is already registered with proj4, it will not
+ * be fetched again (so it is ok to call this function multiple times with the
+ * same code).
+ *
+ * @param {number|string} code The EPSG code (e.g. 4326 or 'EPSG:4326').
+ * @return {Promise<Projection>} The projection.
+ * @api
+ */
+export async function fromEPSGCode(code) {
+  if (typeof code === 'string') {
+    code = parseInt(code.split(':').pop(), 10);
+  }
+
+  const proj4 = registered;
+  if (!proj4) {
+    throw new Error('Proj4 must be registered first with register(proj4)');
+  }
+
+  const epsgCode = 'EPSG:' + code;
+  if (proj4.defs(epsgCode)) {
+    return get(epsgCode);
+  }
+
+  proj4.defs(epsgCode, await epsgLookup(code));
+  register(proj4);
+
+  return get(epsgCode);
+}

package/util.js

@@ -33,4 +33,4 @@ export function getUid(obj) {
  * OpenLayers version.
  * @type {string}
  */
-export const VERSION = '7.1.1-dev.1663240093930';
+export const VERSION = '7.1.1-dev.1663334047420';