@math.gl/crs 4.2.0-alpha.5

package/LICENSE

@@ -0,0 +1,140 @@
+MIT License
+
+Copyright (c) 2017 Uber Technologies, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+---
+
+Some primitive tessellation approaches were originally inspired by the TDL WebGL samples under
+the New BSD License:
+
+Copyright (c) 2011, Google Inc. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted
+provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions
+   and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice, this list of
+   conditions and the following disclaimer in the documentation and/or other materials provided
+   with the distribution.
+3. Neither the name of Google Inc. nor the names of its contributors may be used to endorse or
+   promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+---
+
+math.gl builds on docs and code from "gl-matrix", which is MIT licensed as follows:
+
+Copyright (c) 2015, Brandon Jones, Colin MacKenzie IV.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+--
+
+math.gl builds on docs and code from THREE.js, which is MIT licensed as follows:
+
+The MIT License
+
+Copyright © 2010-2017 three.js authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+---
+
+math.gl includes certain files from Cesium (https://github.com/AnalyticalGraphicsInc/cesium) under the Apache 2 License:
+
+Copyright 2011-2018 CesiumJS Contributors
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and limitations under the License.
+
+Cesium-derived code can be found in the submodule: modules/3d-tiles
+
+---
+
+The @math.gl/geometry primitive tessellators are adapted from luma.gl under the MIT License:
+
+Copyright (c) 2020 vis.gl contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,40 @@
+# @math.gl/crs
+
+Proj4-independent coordinate reference system definitions shared by math.gl integrations.
+
+PROJJSON is an OSGeo/PROJ specification, not an independently published OGC or ISO standard. It
+is designed as a lossless JSON encoding of OGC WKT2:2019 / ISO 19162:2019 and is referenced by OGC
+standards. This package uses strict PROJJSON v0.7 as its semantic CRS object model. Authority codes,
+PROJ strings, WKT2, WKT1, and vendor WKT dialects remain string serializations. WKT and PROJ
+syntax trees preserve the serializations without claiming semantic conversion to PROJJSON.
+
+```ts
+import {parsePROJString, parseWKTCRS} from '@math.gl/crs';
+import type {CRSDefinition, PROJJSONCRS} from '@math.gl/crs';
+
+const authorityCode: CRSDefinition = 'EPSG:4326';
+const projString: CRSDefinition = '+proj=longlat +datum=WGS84 +no_defs';
+const projjson: PROJJSONCRS = {
+  type: 'GeographicCRS',
+  name: 'WGS 84',
+  datum: {
+    name: 'World Geodetic System 1984',
+    ellipsoid: {
+      name: 'WGS 84',
+      semi_major_axis: 6378137,
+      inverse_flattening: 298.257223563
+    }
+  }
+};
+
+const wkt = parseWKTCRS('GEOGCRS["WGS 84",ID["EPSG",4326]]');
+const proj = parsePROJString('+proj=longlat +datum=WGS84 +no_defs');
+```
+
+The official PROJJSON v0.7 JSON Schema is vendored unchanged under its MIT license and exported as
+`@math.gl/crs/projjson.schema.json`. It is the source of truth for the checked-in generated
+TypeScript declarations. This package has no runtime dependencies. Its runtime APIs parse, encode,
+and validate serialization syntax only: they do not perform registry lookup, semantic equivalence,
+coordinate transformation, or general conversion between WKT, PROJ, and PROJJSON.
+
+See the [PROJJSON specification](https://proj.org/en/stable/specifications/projjson.html).

package/dist/crs.d.ts

@@ -0,0 +1,22 @@
+import type { PROJJSONCRS } from "./projjson-types.js";
+/** A registered or named CRS identifier, such as `EPSG:4326` or `WGS84`. */
+export type CRSIdentifier = string;
+/** A coordinate reference system serialized using WKT1 or WKT2. */
+export type WKTCRSDefinition = string;
+/** A coordinate reference system serialized using PROJ string syntax. */
+export type PROJStringDefinition = string;
+/** A serialized or named coordinate reference system definition. */
+export type CRSStringDefinition = CRSIdentifier | WKTCRSDefinition | PROJStringDefinition;
+/** Top-level coordinate reference system object types defined by PROJJSON v0.7. */
+export type PROJJSONCRSType = NonNullable<PROJJSONCRS['type']>;
+type PROJJSONCRSBranchByType<CRS, T> = CRS extends {
+    type?: infer Type;
+} ? T extends Type ? CRS & {
+    type: T;
+} : never : never;
+/** Selects PROJJSON CRS objects with a specific required top-level `type`. */
+export type PROJJSONCRSByType<T extends PROJJSONCRSType> = T extends unknown ? PROJJSONCRSBranchByType<PROJJSONCRS, T> : never;
+/** A serialized CRS definition or a standards-based PROJJSON CRS object. */
+export type CRSDefinition<T extends PROJJSONCRS = PROJJSONCRS> = CRSStringDefinition | T;
+export type { PROJJSONCRS };
+//# sourceMappingURL=crs.d.ts.map

package/dist/crs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crs.d.ts","sourceRoot":"","sources":["../src/crs.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,WAAW,EAAC,4BAAyB;AAElD,4EAA4E;AAC5E,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAEnC,mEAAmE;AACnE,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEtC,yEAAyE;AACzE,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAE1C,oEAAoE;AACpE,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,gBAAgB,GAAG,oBAAoB,CAAC;AAE1F,mFAAmF;AACnF,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;AAE/D,KAAK,uBAAuB,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,SAAS;IAAC,IAAI,CAAC,EAAE,MAAM,IAAI,CAAA;CAAC,GAClE,CAAC,SAAS,IAAI,GACZ,GAAG,GAAG;IAAC,IAAI,EAAE,CAAC,CAAA;CAAC,GACf,KAAK,GACP,KAAK,CAAC;AAEV,8EAA8E;AAC9E,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,eAAe,IAAI,CAAC,SAAS,OAAO,GACxE,uBAAuB,CAAC,WAAW,EAAE,CAAC,CAAC,GACvC,KAAK,CAAC;AAEV,4EAA4E;AAC5E,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI,mBAAmB,GAAG,CAAC,CAAC;AAEzF,YAAY,EAAC,WAAW,EAAC,CAAC"}

package/dist/crs.js

@@ -0,0 +1,5 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+export {};
+//# sourceMappingURL=crs.js.map

package/dist/crs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crs.js","sourceRoot":"","sources":["../src/crs.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,oCAAoC"}