pdf-mapview 0.1.0

package/dist/ingest-sfbf6503.d.ts

@@ -0,0 +1,647 @@
+import { z } from 'zod';
+
+interface NormalizedPoint {
+    x: number;
+    y: number;
+}
+interface NormalizedRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface PixelSize {
+    width: number;
+    height: number;
+}
+declare function clamp01(value: number): number;
+declare function clampNormalizedPoint(point: NormalizedPoint): NormalizedPoint;
+declare function clampNormalizedRect(rect: NormalizedRect): NormalizedRect;
+declare function normalizedToPixels(point: NormalizedPoint, size: PixelSize): NormalizedPoint;
+declare function pixelsToNormalized(point: NormalizedPoint, size: PixelSize): NormalizedPoint;
+declare function rectCenter(rect: NormalizedRect): NormalizedPoint;
+declare function unionRects(rects: readonly NormalizedRect[]): NormalizedRect | null;
+
+type RegionGeometryType = "polygon" | "rectangle" | "point" | "label";
+interface PolygonGeometry {
+    type: "polygon";
+    points: NormalizedPoint[];
+}
+interface RectangleGeometry {
+    type: "rectangle";
+    rect: NormalizedRect;
+}
+interface PointGeometry {
+    type: "point";
+    point: NormalizedPoint;
+    radius?: number;
+}
+interface LabelGeometry {
+    type: "label";
+    point: NormalizedPoint;
+    text: string;
+}
+type RegionGeometry = PolygonGeometry | RectangleGeometry | PointGeometry | LabelGeometry;
+interface RegionFeature<Metadata = Record<string, unknown>> {
+    id: string;
+    geometry: RegionGeometry;
+    label?: string;
+    metadata?: Metadata;
+}
+interface RegionCollection<Metadata = Record<string, unknown>> {
+    type: "FeatureCollection";
+    regions: RegionFeature<Metadata>[];
+}
+declare const regionFeatureSchema: z.ZodObject<{
+    id: z.ZodString;
+    geometry: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"polygon">;
+        points: z.ZodArray<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            x: number;
+            y: number;
+        }, {
+            x: number;
+            y: number;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "polygon";
+        points: {
+            x: number;
+            y: number;
+        }[];
+    }, {
+        type: "polygon";
+        points: {
+            x: number;
+            y: number;
+        }[];
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"rectangle">;
+        rect: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }, {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        type: "rectangle";
+        rect: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+    }, {
+        type: "rectangle";
+        rect: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"point">;
+        point: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            x: number;
+            y: number;
+        }, {
+            x: number;
+            y: number;
+        }>;
+        radius: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        point: {
+            x: number;
+            y: number;
+        };
+        type: "point";
+        radius?: number | undefined;
+    }, {
+        point: {
+            x: number;
+            y: number;
+        };
+        type: "point";
+        radius?: number | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"label">;
+        point: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            x: number;
+            y: number;
+        }, {
+            x: number;
+            y: number;
+        }>;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        point: {
+            x: number;
+            y: number;
+        };
+        type: "label";
+        text: string;
+    }, {
+        point: {
+            x: number;
+            y: number;
+        };
+        type: "label";
+        text: string;
+    }>]>;
+    label: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    geometry: {
+        type: "polygon";
+        points: {
+            x: number;
+            y: number;
+        }[];
+    } | {
+        type: "rectangle";
+        rect: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+    } | {
+        point: {
+            x: number;
+            y: number;
+        };
+        type: "point";
+        radius?: number | undefined;
+    } | {
+        point: {
+            x: number;
+            y: number;
+        };
+        type: "label";
+        text: string;
+    };
+    label?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    id: string;
+    geometry: {
+        type: "polygon";
+        points: {
+            x: number;
+            y: number;
+        }[];
+    } | {
+        type: "rectangle";
+        rect: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+    } | {
+        point: {
+            x: number;
+            y: number;
+        };
+        type: "point";
+        radius?: number | undefined;
+    } | {
+        point: {
+            x: number;
+            y: number;
+        };
+        type: "label";
+        text: string;
+    };
+    label?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+declare const regionCollectionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"FeatureCollection">;
+    regions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        geometry: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"polygon">;
+            points: z.ZodArray<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                x: number;
+                y: number;
+            }, {
+                x: number;
+                y: number;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            type: "polygon";
+            points: {
+                x: number;
+                y: number;
+            }[];
+        }, {
+            type: "polygon";
+            points: {
+                x: number;
+                y: number;
+            }[];
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"rectangle">;
+            rect: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                x: number;
+                y: number;
+                width: number;
+                height: number;
+            }, {
+                x: number;
+                y: number;
+                width: number;
+                height: number;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            type: "rectangle";
+            rect: {
+                x: number;
+                y: number;
+                width: number;
+                height: number;
+            };
+        }, {
+            type: "rectangle";
+            rect: {
+                x: number;
+                y: number;
+                width: number;
+                height: number;
+            };
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"point">;
+            point: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                x: number;
+                y: number;
+            }, {
+                x: number;
+                y: number;
+            }>;
+            radius: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            point: {
+                x: number;
+                y: number;
+            };
+            type: "point";
+            radius?: number | undefined;
+        }, {
+            point: {
+                x: number;
+                y: number;
+            };
+            type: "point";
+            radius?: number | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"label">;
+            point: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                x: number;
+                y: number;
+            }, {
+                x: number;
+                y: number;
+            }>;
+            text: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            point: {
+                x: number;
+                y: number;
+            };
+            type: "label";
+            text: string;
+        }, {
+            point: {
+                x: number;
+                y: number;
+            };
+            type: "label";
+            text: string;
+        }>]>;
+        label: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        geometry: {
+            type: "polygon";
+            points: {
+                x: number;
+                y: number;
+            }[];
+        } | {
+            type: "rectangle";
+            rect: {
+                x: number;
+                y: number;
+                width: number;
+                height: number;
+            };
+        } | {
+            point: {
+                x: number;
+                y: number;
+            };
+            type: "point";
+            radius?: number | undefined;
+        } | {
+            point: {
+                x: number;
+                y: number;
+            };
+            type: "label";
+            text: string;
+        };
+        label?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    }, {
+        id: string;
+        geometry: {
+            type: "polygon";
+            points: {
+                x: number;
+                y: number;
+            }[];
+        } | {
+            type: "rectangle";
+            rect: {
+                x: number;
+                y: number;
+                width: number;
+                height: number;
+            };
+        } | {
+            point: {
+                x: number;
+                y: number;
+            };
+            type: "point";
+            radius?: number | undefined;
+        } | {
+            point: {
+                x: number;
+                y: number;
+            };
+            type: "label";
+            text: string;
+        };
+        label?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "FeatureCollection";
+    regions: {
+        id: string;
+        geometry: {
+            type: "polygon";
+            points: {
+                x: number;
+                y: number;
+            }[];
+        } | {
+            type: "rectangle";
+            rect: {
+                x: number;
+                y: number;
+                width: number;
+                height: number;
+            };
+        } | {
+            point: {
+                x: number;
+                y: number;
+            };
+            type: "point";
+            radius?: number | undefined;
+        } | {
+            point: {
+                x: number;
+                y: number;
+            };
+            type: "label";
+            text: string;
+        };
+        label?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    }[];
+}, {
+    type: "FeatureCollection";
+    regions: {
+        id: string;
+        geometry: {
+            type: "polygon";
+            points: {
+                x: number;
+                y: number;
+            }[];
+        } | {
+            type: "rectangle";
+            rect: {
+                x: number;
+                y: number;
+                width: number;
+                height: number;
+            };
+        } | {
+            point: {
+                x: number;
+                y: number;
+            };
+            type: "point";
+            radius?: number | undefined;
+        } | {
+            point: {
+                x: number;
+                y: number;
+            };
+            type: "label";
+            text: string;
+        };
+        label?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    }[];
+}>;
+declare function normalizeRegions(input?: RegionCollection | RegionFeature[] | null): RegionFeature[];
+
+interface TileLevelManifest {
+    z: number;
+    width: number;
+    height: number;
+    columns: number;
+    rows: number;
+    scale: number;
+}
+interface PdfMapManifest {
+    version: 1;
+    kind: "pdf-map";
+    id: string;
+    source: {
+        type: "pdf" | "image";
+        originalFilename?: string;
+        page?: number;
+        width: number;
+        height: number;
+        mimeType?: string;
+    };
+    coordinateSpace: {
+        normalized: true;
+        width: number;
+        height: number;
+    };
+    tiles: {
+        tileSize: number;
+        format: TileFormat;
+        minZoom: number;
+        maxZoom: number;
+        pathTemplate: string;
+        levels: TileLevelManifest[];
+    };
+    view: {
+        defaultCenter: [number, number];
+        defaultZoom: number;
+        minZoom: number;
+        maxZoom: number;
+    };
+    overlays?: {
+        inline?: RegionCollection;
+        url?: string;
+    };
+    assets?: {
+        preview?: string;
+    };
+    metadata?: {
+        title?: string;
+        createdAt?: string;
+        [key: string]: unknown;
+    };
+}
+interface CreateManifestInput extends Omit<PdfMapManifest, "version" | "kind"> {
+}
+interface ResolveTileUrlArgs {
+    manifest: PdfMapManifest;
+    z: number;
+    x: number;
+    y: number;
+    baseUrl?: string;
+    overrideTemplate?: string;
+}
+declare const manifestSchema: z.ZodType<PdfMapManifest>;
+declare function createManifest(input: CreateManifestInput): PdfMapManifest;
+declare function parseManifest(input: unknown): PdfMapManifest;
+declare function resolveTileUrl(args: ResolveTileUrlArgs): string;
+
+type TileFormat = "webp" | "jpeg" | "png";
+interface OutputArtifact {
+    kind: "tile" | "manifest" | "preview" | "overlay";
+    path: string;
+    contentType: string;
+    bytes: Uint8Array;
+}
+interface StoredArtifact {
+    kind: OutputArtifact["kind"];
+    path: string;
+    contentType: string;
+    size: number;
+    url?: string;
+    metadata?: Record<string, string>;
+}
+interface StorageFinalizeResult {
+    artifacts: StoredArtifact[];
+    baseUrl?: string;
+    metadata?: Record<string, unknown>;
+}
+interface WriteTileArgs {
+    z: number;
+    x: number;
+    y: number;
+    ext: string;
+    bytes: Uint8Array;
+    contentType: string;
+}
+interface WriteManifestArgs {
+    path: string;
+    bytes: Uint8Array;
+    contentType: "application/json";
+}
+interface WriteAssetArgs {
+    kind: "preview" | "overlay";
+    path: string;
+    bytes: Uint8Array;
+    contentType: string;
+}
+interface FinalizeStorageArgs {
+    manifest: PdfMapManifest;
+    artifacts: StoredArtifact[];
+}
+interface StorageAdapter {
+    writeTile(args: WriteTileArgs): Promise<StoredArtifact>;
+    writeManifest(args: WriteManifestArgs): Promise<StoredArtifact>;
+    writeAsset?(args: WriteAssetArgs): Promise<StoredArtifact>;
+    finalize(args: FinalizeStorageArgs): Promise<StorageFinalizeResult>;
+}
+interface IngestCommonOptions {
+    id?: string;
+    title?: string;
+    tileSize?: 256 | 512;
+    tileFormat?: TileFormat;
+    tileQuality?: number;
+    maxDimension?: number;
+    rasterDpi?: number;
+    background?: string;
+    overlays?: RegionCollection | string;
+    baseUrl?: string;
+    storage?: StorageAdapter;
+}
+interface IngestPdfOptions extends IngestCommonOptions {
+    input: string | Buffer | Uint8Array | ArrayBuffer;
+    page?: number;
+}
+interface IngestImageOptions extends IngestCommonOptions {
+    input: string | Buffer | Uint8Array | ArrayBuffer;
+}
+interface IngestResult {
+    manifest: PdfMapManifest;
+    width: number;
+    height: number;
+    tileCount: number;
+    files: OutputArtifact[];
+    uploaded: StoredArtifact[];
+    warnings: string[];
+    storage: StorageFinalizeResult;
+}
+
+export { rectCenter as A, regionCollectionSchema as B, type CreateManifestInput as C, regionFeatureSchema as D, resolveTileUrl as E, type FinalizeStorageArgs as F, unionRects as G, type IngestCommonOptions as I, type LabelGeometry as L, type NormalizedPoint as N, type OutputArtifact as O, type PdfMapManifest as P, type RectangleGeometry as R, type StorageAdapter as S, type TileFormat as T, type WriteAssetArgs as W, type IngestImageOptions as a, type IngestPdfOptions as b, type IngestResult as c, type NormalizedRect as d, type PixelSize as e, type PointGeometry as f, type PolygonGeometry as g, type RegionCollection as h, type RegionFeature as i, type RegionGeometry as j, type RegionGeometryType as k, type ResolveTileUrlArgs as l, type StorageFinalizeResult as m, type StoredArtifact as n, type TileLevelManifest as o, type WriteManifestArgs as p, type WriteTileArgs as q, clamp01 as r, clampNormalizedPoint as s, clampNormalizedRect as t, createManifest as u, manifestSchema as v, normalizeRegions as w, normalizedToPixels as x, parseManifest as y, pixelsToNormalized as z };