@takram/three-geospatial 0.0.1-alpha.4 → 0.0.1-alpha.6

package/types/DataLoader.d.ts

@@ -1,67 +1,37 @@
 import { Callable } from './types';
-import { Float32ArrayLoader, Int16ArrayLoader, Uint16ArrayLoader, TypedArrayLoader } from './TypedArrayLoader';
-import { Class } from 'type-fest';
-import { Data3DTexture, DataTexture, Loader, Texture, TypedArray } from 'three';
+import { TypedArrayParser } from './typedArrayParsers';
+import { TypedArrayLoader } from './TypedArrayLoader';
+import { Class, WritableKeysOf } from 'type-fest';
+import { Data3DTexture, DataTexture, Loader, TypedArray } from 'three';
 
-export interface ImageSize {
-    width: number;
-    height: number;
+type ParameterProperties<T> = {
+    [K in WritableKeysOf<T> as T[K] extends Callable ? never : K]: T[K];
+};
+export type DataTextureParameters = Omit<Partial<ParameterProperties<DataTexture>>, 'image'> & {
+    width?: number;
+    height?: number;
+};
+export type Data3DTextureParameters = Omit<Partial<ParameterProperties<Data3DTexture>>, 'image'> & {
+    width?: number;
+    height?: number;
     depth?: number;
-}
-export type DataTextureParameters = Omit<Partial<{
-    [K in keyof Texture as Texture[K] extends Callable ? never : K]: Texture[K];
-}>, 'image'>;
-export declare abstract class DataLoader<T extends DataTexture | Data3DTexture, U extends TypedArray> extends Loader<T> {
+};
+export declare abstract class DataLoader<T extends DataTexture | Data3DTexture = DataTexture | Data3DTexture, U extends TypedArray = TypedArray> extends Loader<T> {
     abstract readonly Texture: Class<T>;
     abstract readonly TypedArrayLoader: Class<TypedArrayLoader<U>>;
-    readonly parameters?: DataTextureParameters;
+    readonly parameters: DataTextureParameters & Data3DTextureParameters;
     load(url: string, onLoad: (data: T) => void, onProgress?: (event: ProgressEvent) => void, onError?: (error: unknown) => void): void;
 }
-export declare class Int16Data2DLoader extends DataLoader<DataTexture, Int16Array> {
-    readonly Texture: typeof DataTexture;
-    readonly TypedArrayLoader: typeof Int16ArrayLoader;
-    readonly parameters: {
-        type: 1015;
-        format: 1023;
-        wrapS: 1001;
-        wrapT: 1001;
-        minFilter: 1006;
-        magFilter: 1006;
-    };
-}
-export declare class Uint16Data2DLoader extends DataLoader<DataTexture, Uint16Array> {
-    readonly Texture: typeof DataTexture;
-    readonly TypedArrayLoader: typeof Uint16ArrayLoader;
-    readonly parameters: {
-        type: 1015;
-        format: 1023;
-        wrapS: 1001;
-        wrapT: 1001;
-        minFilter: 1006;
-        magFilter: 1006;
-    };
-}
-export declare class Float32Data2DLoader extends DataLoader<DataTexture, Float32Array> {
-    readonly Texture: typeof DataTexture;
-    readonly TypedArrayLoader: typeof Float32ArrayLoader;
-    readonly parameters: {
-        type: 1015;
-        format: 1023;
-        wrapS: 1001;
-        wrapT: 1001;
-        minFilter: 1006;
-        magFilter: 1006;
-    };
-}
-export declare class Float32Data3DLoader extends DataLoader<Data3DTexture, Float32Array> {
-    readonly Texture: typeof Data3DTexture;
-    readonly TypedArrayLoader: typeof Float32ArrayLoader;
-    readonly parameters: {
-        type: 1015;
-        format: 1023;
-        wrapS: 1001;
-        wrapT: 1001;
-        minFilter: 1006;
-        magFilter: 1006;
-    };
-}
+export declare function createData3DTextureLoaderClass<T extends TypedArray>(parser: TypedArrayParser<T>, parameters?: Data3DTextureParameters): Class<DataLoader<Data3DTexture, T>>;
+export declare function createDataTextureLoaderClass<T extends TypedArray>(parser: TypedArrayParser<T>, parameters?: DataTextureParameters): Class<DataLoader<DataTexture, T>>;
+export declare function createData3DTextureLoader<T extends TypedArray>(parser: TypedArrayParser<T>, parameters?: Data3DTextureParameters): DataLoader<Data3DTexture, T>;
+export declare function createDataTextureLoader<T extends TypedArray>(parser: TypedArrayParser<T>, parameters?: DataTextureParameters): DataLoader<DataTexture, T>;
+/** @deprecated Use createDataTextureLoaderClass instead. */
+export declare const Int16Data2DLoader: Class<DataLoader<DataTexture, Int16Array<ArrayBufferLike>>>;
+/** @deprecated Use createDataTextureLoaderClass instead. */
+export declare const Uint16Data2DLoader: Class<DataLoader<DataTexture, Uint16Array<ArrayBufferLike>>>;
+/** @deprecated Use createDataTextureLoaderClass instead. */
+export declare const Float32Data2DLoader: Class<DataLoader<DataTexture, Float32Array<ArrayBufferLike>>>;
+/** @deprecated Use createData3DTextureLoaderClass instead. */
+export declare const Float32Data3DLoader: Class<DataLoader<Data3DTexture, Float32Array<ArrayBufferLike>>>;
+export {};

package/types/Texture3DLoader.d.ts

@@ -0,0 +1,5 @@
+import { Data3DTexture, Loader } from 'three';
+
+export declare class Texture3DLoader extends Loader<Data3DTexture> {
+    load(url: string, onLoad: (data: Data3DTexture) => void, onProgress?: (event: ProgressEvent) => void, onError?: (error: unknown) => void): void;
+}

package/types/TypedArrayLoader.d.ts

@@ -1,16 +1,16 @@
-import { parseFloat32Array, parseInt16Array, parseUint16Array } from './typedArray';
+import { TypedArrayParser } from './typedArrayParsers';
+import { Class } from 'type-fest';
 import { Loader, TypedArray } from 'three';
 
 export declare abstract class TypedArrayLoader<T extends TypedArray> extends Loader<T> {
     abstract parseTypedArray(buffer: ArrayBuffer): T;
     load(url: string, onLoad: (data: T) => void, onProgress?: (event: ProgressEvent) => void, onError?: (error: unknown) => void): void;
 }
-export declare class Int16ArrayLoader extends TypedArrayLoader<Int16Array> {
-    readonly parseTypedArray: typeof parseInt16Array;
-}
-export declare class Uint16ArrayLoader extends TypedArrayLoader<Uint16Array> {
-    readonly parseTypedArray: typeof parseUint16Array;
-}
-export declare class Float32ArrayLoader extends TypedArrayLoader<Float32Array> {
-    readonly parseTypedArray: typeof parseFloat32Array;
-}
+export declare function createTypedArrayLoaderClass<T extends TypedArray>(parser: TypedArrayParser<T>): Class<TypedArrayLoader<T>>;
+export declare function createTypedArrayLoader<T extends TypedArray>(parser: TypedArrayParser<T>): TypedArrayLoader<T>;
+/** @deprecated Use createTypedArrayLoaderClass instead. */
+export declare const Int16ArrayLoader: Class<TypedArrayLoader<Int16Array<ArrayBufferLike>>>;
+/** @deprecated Use createTypedArrayLoaderClass instead. */
+export declare const Uint16ArrayLoader: Class<TypedArrayLoader<Uint16Array<ArrayBufferLike>>>;
+/** @deprecated Use createTypedArrayLoaderClass instead. */
+export declare const Float32ArrayLoader: Class<TypedArrayLoader<Float32Array<ArrayBufferLike>>>;

package/types/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const STBN_TEXTURE_WIDTH = 128;
+export declare const STBN_TEXTURE_HEIGHT = 128;
+export declare const STBN_TEXTURE_DEPTH = 64;

package/types/index.d.ts

@@ -1,9 +1,7 @@
-export declare const depthShader: string;
-export declare const packingShader: string;
-export declare const transformShader: string;
 export * from './ArrayBufferLoader';
 export * from './assertions';
 export * from './bufferGeometry';
+export * from './constants';
 export * from './DataLoader';
 export * from './Ellipsoid';
 export * from './EllipsoidGeometry';
@@ -11,8 +9,11 @@ export * from './Geodetic';
 export * from './math';
 export * from './PointOfView';
 export * from './Rectangle';
+export * from './resolveIncludes';
 export * from './TileCoordinate';
 export * from './TilingScheme';
 export * from './typedArray';
 export * from './TypedArrayLoader';
+export * from './typedArrayParsers';
 export * from './types';
+export * from './unrollLoops';

package/types/math.d.ts

@@ -8,6 +8,7 @@ export declare const isPowerOfTwo: typeof import('three/src/math/MathUtils.js').
 export declare const ceilPowerOfTwo: typeof import('three/src/math/MathUtils.js').ceilPowerOfTwo;
 export declare const floorPowerOfTwo: typeof import('three/src/math/MathUtils.js').floorPowerOfTwo;
 export declare const normalize: typeof import('three/src/math/MathUtils.js').normalize;
+export declare const remap: typeof import('three/src/math/MathUtils.js').mapLinear;
 export declare function smoothstep(min: number, max: number, x: number): number;
 export declare function saturate(x: number): number;
 export declare function closeTo(a: number, b: number, relativeEpsilon: number, absoluteEpsilon?: number): boolean;

package/types/r3f/index.d.ts

@@ -1,2 +1,3 @@
 export * from './EastNorthUpFrame';
 export * from './EllipsoidMesh';
+export * from './types';

package/types/r3f/types.d.ts

@@ -0,0 +1,22 @@
+import { Callable } from '../types';
+import { WritableKeysOf } from 'type-fest';
+import { Vector2 as Vector2Impl, Vector3 as Vector3Impl, Vector4 as Vector4Impl } from 'three';
+import { Color, ExtendedColors, NodeProps, Overwrite, Vector2, Vector3, Vector4 } from '@react-three/fiber';
+
+export type ExtendedVectors<T> = {
+    [K in keyof T]: Vector2Impl extends T[K] ? Vector2 | T[K] : Vector3Impl extends T[K] ? Vector3 | T[K] : Vector4Impl extends T[K] ? Vector4 | T[K] : T[K];
+};
+export type ExtendedProps<T> = ExtendedColors<ExtendedVectors<T>>;
+type NonFunctionKeys<T> = keyof {
+    [K in keyof T as Callable extends T[K] ? never : K]: any;
+};
+type WritableNonExtendableKeysOf<T> = WritableKeysOf<T> | keyof {
+    [K in keyof T as Vector2Impl extends T[K] ? K : Vector3Impl extends T[K] ? K : Vector4Impl extends T[K] ? K : Color extends T[K] ? K : never]: any;
+};
+export type PassThoughInstanceProps<RefType, Args extends readonly any[], Props> = Overwrite<ExtendedProps<{
+    [K in NonFunctionKeys<Props> as K extends WritableNonExtendableKeysOf<Props> ? K : never]: Props[K];
+}>, NodeProps<RefType, Args>>;
+export type ExpandNestedProps<T, Prop extends keyof T & string> = {
+    [K in keyof T[Prop] as K extends string ? `${Prop}-${K}` : never]: T[Prop][K];
+};
+export {};

package/types/resolveIncludes.d.ts

@@ -0,0 +1,5 @@
+interface Includes {
+    [key: string]: string | Includes;
+}
+export declare function resolveIncludes(source: string, includes: Includes): string;
+export {};

package/types/shaders/index.d.ts

@@ -0,0 +1,8 @@
+export declare const depth: string;
+export declare const generators: string;
+export declare const math: string;
+export declare const packing: string;
+export declare const poissonDisk: string;
+export declare const raySphereIntersection: string;
+export declare const transform: string;
+export declare const turbo: string;

package/types/typedArray.d.ts

@@ -1,10 +1,4 @@
 export type TypedArray = Int8Array | Uint8Array | Uint8ClampedArray | Int16Array | Uint16Array | Int32Array | Uint32Array | Float32Array | Float64Array;
 export type TypedArrayConstructor = Int8ArrayConstructor | Uint8ArrayConstructor | Uint8ClampedArrayConstructor | Int16ArrayConstructor | Uint16ArrayConstructor | Int32ArrayConstructor | Uint32ArrayConstructor | Float32ArrayConstructor | Float64ArrayConstructor;
-type GetValue = keyof {
-    [K in keyof DataView as DataView[K] extends (byteOffset: number) => number ? K : never]: DataView[K];
-};
-export declare function parseTypedArray<T extends TypedArrayConstructor, K extends GetValue>(buffer: ArrayBuffer, TypedArray: T, getValue: K, littleEndian?: boolean): InstanceType<T>;
-export declare function parseInt16Array(buffer: ArrayBuffer, littleEndian?: boolean): Int16Array;
-export declare function parseUint16Array(buffer: ArrayBuffer, littleEndian?: boolean): Uint16Array;
-export declare function parseFloat32Array(buffer: ArrayBuffer, littleEndian?: boolean): Float32Array;
-export {};
+export type TypedArrayElementType = 'int8' | 'uint8' | 'int16' | 'uint16' | 'int32' | 'uint32' | 'float32' | 'float64';
+export declare function getTypedArrayElementType(array: TypedArray): TypedArrayElementType;

package/types/typedArrayParsers.d.ts

@@ -0,0 +1,11 @@
+import { TypedArray } from './typedArray';
+
+export type TypedArrayParser<T extends TypedArray> = (buffer: ArrayBuffer, littleEndian?: boolean) => T;
+export declare const parseUint8Array: TypedArrayParser<Uint8Array>;
+export declare const parseInt8Array: TypedArrayParser<Int8Array>;
+export declare const parseUint16Array: TypedArrayParser<Uint16Array>;
+export declare const parseInt16Array: TypedArrayParser<Int16Array>;
+export declare const parseInt32Array: TypedArrayParser<Int32Array>;
+export declare const parseUint32Array: TypedArrayParser<Uint32Array>;
+export declare const parseFloat32Array: TypedArrayParser<Float32Array>;
+export declare const parseFloat64Array: TypedArrayParser<Float64Array>;

package/types/types.d.ts

@@ -1,22 +1,7 @@
-import { ReadonlyTuple } from 'type-fest';
-import { Matrix2, Matrix3, Matrix4, Vector2, Vector3, Vector4 } from 'three';
+import { Uniform } from 'three';
 
 export type Callable = (...args: any) => any;
-export type ReadonlyTuple2<T = number> = ReadonlyTuple<T, 2>;
-export type ReadonlyTuple3<T = number> = ReadonlyTuple<T, 3>;
-export type ReadonlyTuple4<T = number> = ReadonlyTuple<T, 4>;
-type BuildTupleHelper<Element, Length extends number, Rest extends Element[]> = Rest['length'] extends Length ? [...Rest] : BuildTupleHelper<Element, Length, [Element, ...Rest]>;
-export type Tuple<T, Length extends number> = number extends Length ? readonly T[] : BuildTupleHelper<T, Length, []>;
-export type Tuple2<T = number> = BuildTupleHelper<T, 2, []>;
-export type Tuple3<T = number> = BuildTupleHelper<T, 3, []>;
-export type Tuple4<T = number> = BuildTupleHelper<T, 4, []>;
-type ReadonlyThreeInstance<T> = Readonly<{
-    [K in keyof T as T[K] extends Callable ? ReturnType<T[K]> extends T ? K extends 'clone' ? K : never : K : K]: T[K];
-}>;
-export type ReadonlyVector2 = ReadonlyThreeInstance<Vector2>;
-export type ReadonlyVector3 = ReadonlyThreeInstance<Vector3>;
-export type ReadonlyVector4 = ReadonlyThreeInstance<Vector4>;
-export type ReadonlyMatrix2 = ReadonlyThreeInstance<Matrix2>;
-export type ReadonlyMatrix3 = ReadonlyThreeInstance<Matrix3>;
-export type ReadonlyMatrix4 = ReadonlyThreeInstance<Matrix4>;
-export {};
+export type UniformMap<T> = Omit<Map<string, Uniform>, 'get'> & {
+    get: <K extends keyof T>(key: K) => T[K];
+    set: <K extends keyof T>(key: K, value: T[K]) => void;
+};

package/types/unrollLoops.d.ts

@@ -0,0 +1 @@
+export declare function unrollLoops(string: string): string;