@tileflow/static 0.1.0-alpha.20 → 0.1.0-alpha.21

package/dist/manifest.js

@@ -5,9 +5,9 @@ import {
   staticRenderManifestSchema,
   staticRendererSchemaVersion,
   validateStaticRenderManifest
-} from "./chunk-HKYA7ZIU.js";
-import "./chunk-ROBEGDDY.js";
-import "./chunk-YUG3PBK2.js";
+} from "./chunk-S3WXE5P4.js";
+import "./chunk-NHQK5UZ2.js";
+import "./chunk-MGQCHCU3.js";
 export {
   createRenderManifest,
   hashRenderManifest,

package/dist/overlays.d.ts

@@ -1,12 +1,14 @@
 import { z } from 'zod';
-import { h as circleOverlaySchema, a as StaticOverlay, l as lineOverlaySchema, m as markerOverlaySchema, p as polygonOverlaySchema } from './scene-contract-DzsUeJ_V.js';
-export { b as StaticOverlayInput, s as staticOverlaySchema } from './scene-contract-DzsUeJ_V.js';
+import { i as circleOverlaySchema, a as StaticOverlay, l as lineOverlaySchema, m as markerOverlaySchema, p as polygonOverlaySchema } from './scene-contract-DZMhLDnf.js';
+export { b as StaticOverlayInput, s as staticOverlaySchema } from './scene-contract-DZMhLDnf.js';
 
 declare function line(input: Omit<z.input<typeof lineOverlaySchema>, 'type'>): StaticOverlay;
 declare function circle(input: Omit<z.input<typeof circleOverlaySchema>, 'type'>): StaticOverlay;
 declare function marker(input: Omit<z.input<typeof markerOverlaySchema>, 'type'>): StaticOverlay;
 declare function polygon(input: Omit<z.input<typeof polygonOverlaySchema>, 'type'>): StaticOverlay;
-declare function compileStaticOverlays(overlays: StaticOverlay[]): {
+declare function compileStaticOverlays(overlays: StaticOverlay[], options?: {
+    longitudeOffsets?: readonly number[];
+}): {
     layers: Record<string, unknown>[];
     sources: Record<string, Record<string, unknown>>;
 };

package/dist/overlays.js

@@ -4,10 +4,10 @@ import {
   line,
   marker,
   polygon
-} from "./chunk-LGEYA6FQ.js";
+} from "./chunk-KPT7PASB.js";
 import {
   staticOverlaySchema
-} from "./chunk-YUG3PBK2.js";
+} from "./chunk-MGQCHCU3.js";
 export {
   circle,
   compileStaticOverlays,

package/dist/{scene-contract-DzsUeJ_V.d.ts → scene-contract-DZMhLDnf.d.ts}

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 
 declare const staticSceneSchemaVersion = 1;
+declare const MAX_OVERLAY_LATITUDE = 85.051129;
 declare const staticSceneLimits: {
     readonly maxDimension: 1280;
     readonly maxGeoJsonBytes: 96000;
@@ -10,6 +11,12 @@ declare const staticSceneLimits: {
     readonly minDimension: 64;
 };
 declare const coordinateSchema: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+declare const staticPaddingSchema: z.ZodObject<{
+    bottom: z.ZodNumber;
+    left: z.ZodNumber;
+    right: z.ZodNumber;
+    top: z.ZodNumber;
+}, z.core.$strict>;
 declare const lineOverlaySchema: z.ZodObject<{
     color: z.ZodDefault<z.ZodString>;
     coordinates: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
@@ -90,6 +97,16 @@ declare const staticSceneSchema: z.ZodObject<{
         bounds: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
         padding: z.ZodOptional<z.ZodNumber>;
         type: z.ZodLiteral<"bounds">;
+    }, z.core.$strip>, z.ZodObject<{
+        bearing: z.ZodOptional<z.ZodNumber>;
+        maxZoom: z.ZodOptional<z.ZodNumber>;
+        padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+            bottom: z.ZodOptional<z.ZodNumber>;
+            left: z.ZodOptional<z.ZodNumber>;
+            right: z.ZodOptional<z.ZodNumber>;
+            top: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>>;
+        type: z.ZodLiteral<"auto">;
     }, z.core.$strip>], "type">;
     map: z.ZodString;
     overlays: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -133,9 +150,10 @@ declare const staticSceneSchema: z.ZodObject<{
     theme: z.ZodString;
 }, z.core.$strip>;
 type StaticCoordinate = z.infer<typeof coordinateSchema>;
+type StaticPadding = z.infer<typeof staticPaddingSchema>;
 type StaticSceneInput = z.input<typeof staticSceneSchema>;
 type StaticScene = z.infer<typeof staticSceneSchema>;
 type StaticOverlayInput = z.input<typeof staticOverlaySchema>;
 type StaticOverlay = z.infer<typeof staticOverlaySchema>;
 
-export { type StaticCoordinate as S, type StaticOverlay as a, type StaticOverlayInput as b, type StaticScene as c, type StaticSceneInput as d, staticSceneLimits as e, staticSceneSchema as f, staticSceneSchemaVersion as g, circleOverlaySchema as h, lineOverlaySchema as l, markerOverlaySchema as m, polygonOverlaySchema as p, staticOverlaySchema as s };
+export { MAX_OVERLAY_LATITUDE as M, type StaticCoordinate as S, type StaticOverlay as a, type StaticOverlayInput as b, type StaticPadding as c, type StaticScene as d, type StaticSceneInput as e, staticSceneLimits as f, staticSceneSchema as g, staticSceneSchemaVersion as h, circleOverlaySchema as i, lineOverlaySchema as l, markerOverlaySchema as m, polygonOverlaySchema as p, staticOverlaySchema as s };

package/dist/scene.d.ts

@@ -1,6 +1,183 @@
-import { d as StaticSceneInput, c as StaticScene } from './scene-contract-DzsUeJ_V.js';
-export { S as StaticCoordinate, e as staticSceneLimits, f as staticSceneSchema, g as staticSceneSchemaVersion } from './scene-contract-DzsUeJ_V.js';
-import 'zod';
+import { z } from 'zod';
+import { e as StaticSceneInput, d as StaticScene } from './scene-contract-DZMhLDnf.js';
+export { M as MAX_OVERLAY_LATITUDE, S as StaticCoordinate, c as StaticPadding, f as staticSceneLimits, g as staticSceneSchema, h as staticSceneSchemaVersion } from './scene-contract-DZMhLDnf.js';
+
+declare const autoFitDetailsSchema: z.ZodObject<{
+    overlay: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        index: z.ZodNumber;
+        type: z.ZodEnum<{
+            line: "line";
+            circle: "circle";
+            marker: "marker";
+            polygon: "polygon";
+        }>;
+    }, z.core.$strict>>;
+    padding: z.ZodOptional<z.ZodObject<{
+        bottom: z.ZodNumber;
+        left: z.ZodNumber;
+        right: z.ZodNumber;
+        top: z.ZodNumber;
+    }, z.core.$strict>>;
+    projection: z.ZodOptional<z.ZodEnum<{
+        globe: "globe";
+        mercator: "mercator";
+    }>>;
+    requiredInsets: z.ZodOptional<z.ZodObject<{
+        bottom: z.ZodNumber;
+        left: z.ZodNumber;
+        right: z.ZodNumber;
+        top: z.ZodNumber;
+    }, z.core.$strict>>;
+    ringIndex: z.ZodOptional<z.ZodNumber>;
+    segmentIndex: z.ZodOptional<z.ZodNumber>;
+    viewport: z.ZodOptional<z.ZodObject<{
+        height: z.ZodNumber;
+        width: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type StaticAutoFitDetails = z.infer<typeof autoFitDetailsSchema>;
+declare const staticOverlayInvalidDetailsSchema: z.ZodObject<{
+    latitude: z.ZodNumber;
+    limit: z.ZodLiteral<85.051129>;
+    overlay: z.ZodObject<{
+        id: z.ZodString;
+        index: z.ZodNumber;
+        type: z.ZodEnum<{
+            line: "line";
+            circle: "circle";
+            marker: "marker";
+            polygon: "polygon";
+        }>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type StaticMapRequestErrorDetails = StaticAutoFitDetails | z.infer<typeof staticOverlayInvalidDetailsSchema>;
+declare const staticMapRequestErrorResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    code: z.ZodLiteral<"AUTO_FIT_EMPTY">;
+    reason: z.ZodLiteral<"NO_FITTABLE_OVERLAYS">;
+    error: z.ZodString;
+    retryable: z.ZodLiteral<false>;
+}, z.core.$strict>, z.ZodObject<{
+    code: z.ZodLiteral<"AUTO_FIT_AMBIGUOUS">;
+    details: z.ZodObject<{
+        overlay: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            index: z.ZodNumber;
+            type: z.ZodEnum<{
+                line: "line";
+                circle: "circle";
+                marker: "marker";
+                polygon: "polygon";
+            }>;
+        }, z.core.$strict>>;
+        padding: z.ZodOptional<z.ZodObject<{
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+            right: z.ZodNumber;
+            top: z.ZodNumber;
+        }, z.core.$strict>>;
+        projection: z.ZodOptional<z.ZodEnum<{
+            globe: "globe";
+            mercator: "mercator";
+        }>>;
+        requiredInsets: z.ZodOptional<z.ZodObject<{
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+            right: z.ZodNumber;
+            top: z.ZodNumber;
+        }, z.core.$strict>>;
+        ringIndex: z.ZodOptional<z.ZodNumber>;
+        segmentIndex: z.ZodOptional<z.ZodNumber>;
+        viewport: z.ZodOptional<z.ZodObject<{
+            height: z.ZodNumber;
+            width: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    reason: z.ZodLiteral<"ANTIMERIDIAN_WRAP_REQUIRED">;
+    error: z.ZodString;
+    retryable: z.ZodLiteral<false>;
+}, z.core.$strict>, z.ZodObject<{
+    code: z.ZodLiteral<"AUTO_FIT_IMPOSSIBLE">;
+    details: z.ZodOptional<z.ZodObject<{
+        overlay: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            index: z.ZodNumber;
+            type: z.ZodEnum<{
+                line: "line";
+                circle: "circle";
+                marker: "marker";
+                polygon: "polygon";
+            }>;
+        }, z.core.$strict>>;
+        padding: z.ZodOptional<z.ZodObject<{
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+            right: z.ZodNumber;
+            top: z.ZodNumber;
+        }, z.core.$strict>>;
+        projection: z.ZodOptional<z.ZodEnum<{
+            globe: "globe";
+            mercator: "mercator";
+        }>>;
+        requiredInsets: z.ZodOptional<z.ZodObject<{
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+            right: z.ZodNumber;
+            top: z.ZodNumber;
+        }, z.core.$strict>>;
+        ringIndex: z.ZodOptional<z.ZodNumber>;
+        segmentIndex: z.ZodOptional<z.ZodNumber>;
+        viewport: z.ZodOptional<z.ZodObject<{
+            height: z.ZodNumber;
+            width: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    reason: z.ZodEnum<{
+        GLOBE_NOT_SIMULTANEOUSLY_VISIBLE: "GLOBE_NOT_SIMULTANEOUSLY_VISIBLE";
+        INSUFFICIENT_VIEWPORT: "INSUFFICIENT_VIEWPORT";
+        CAMERA_UNRESOLVABLE: "CAMERA_UNRESOLVABLE";
+        PROJECTED_FOOTPRINT_OUTSIDE_VIEWPORT: "PROJECTED_FOOTPRINT_OUTSIDE_VIEWPORT";
+    }>;
+    error: z.ZodString;
+    retryable: z.ZodLiteral<false>;
+}, z.core.$strict>, z.ZodObject<{
+    code: z.ZodLiteral<"STATIC_OVERLAY_INVALID">;
+    details: z.ZodObject<{
+        latitude: z.ZodNumber;
+        limit: z.ZodLiteral<85.051129>;
+        overlay: z.ZodObject<{
+            id: z.ZodString;
+            index: z.ZodNumber;
+            type: z.ZodEnum<{
+                line: "line";
+                circle: "circle";
+                marker: "marker";
+                polygon: "polygon";
+            }>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    reason: z.ZodLiteral<"OVERLAY_LATITUDE_OUT_OF_RANGE">;
+    error: z.ZodString;
+    retryable: z.ZodLiteral<false>;
+}, z.core.$strict>], "code">;
+type StaticMapRequestErrorResponse = z.infer<typeof staticMapRequestErrorResponseSchema>;
+type StaticAutoFitErrorResponse = Extract<StaticMapRequestErrorResponse, {
+    code: `AUTO_FIT_${string}`;
+}>;
+declare class StaticMapRequestError extends Error {
+    readonly code: StaticMapRequestErrorResponse['code'];
+    readonly details?: StaticMapRequestErrorDetails;
+    readonly reason: StaticMapRequestErrorResponse['reason'];
+    readonly retryable = false;
+    readonly status: number;
+    constructor(response: StaticMapRequestErrorResponse, status?: number);
+}
+type StaticAutoFitFailure = StaticAutoFitErrorResponse & {
+    ok: false;
+};
+type StaticMapRequestFailure = StaticMapRequestErrorResponse & {
+    ok: false;
+};
 
 declare function validateStaticScene(input: unknown): {
     ok: true;
@@ -8,7 +185,7 @@ declare function validateStaticScene(input: unknown): {
 } | {
     error: string;
     ok: false;
-};
+} | StaticMapRequestFailure;
 declare function normalizeStaticScene(scene: StaticSceneInput): StaticScene;
 
-export { StaticScene, StaticSceneInput, normalizeStaticScene, validateStaticScene };
+export { type StaticAutoFitErrorResponse, type StaticAutoFitFailure, StaticMapRequestError, type StaticMapRequestErrorResponse, type StaticMapRequestFailure, StaticScene, StaticSceneInput, normalizeStaticScene, staticMapRequestErrorResponseSchema, validateStaticScene };

package/dist/scene.js

@@ -1,14 +1,20 @@
 import {
+  StaticMapRequestError,
   normalizeStaticScene,
+  staticMapRequestErrorResponseSchema,
   validateStaticScene
-} from "./chunk-ROBEGDDY.js";
+} from "./chunk-NHQK5UZ2.js";
 import {
+  MAX_OVERLAY_LATITUDE,
   staticSceneLimits,
   staticSceneSchema,
   staticSceneSchemaVersion
-} from "./chunk-YUG3PBK2.js";
+} from "./chunk-MGQCHCU3.js";
 export {
+  MAX_OVERLAY_LATITUDE,
+  StaticMapRequestError,
   normalizeStaticScene,
+  staticMapRequestErrorResponseSchema,
   staticSceneLimits,
   staticSceneSchema,
   staticSceneSchemaVersion,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tileflow/static",
-  "version": "0.1.0-alpha.20",
+  "version": "0.1.0-alpha.21",
   "license": "Apache-2.0",
   "description": "Static map request schemas and helpers for Tileflow.",
   "type": "module",

package/dist/chunk-ROBEGDDY.js

@@ -1,63 +0,0 @@
-import {
-  jsonByteLength,
-  normalizeStaticCoordinate,
-  normalizeStaticOverlay,
-  roundNumber,
-  staticSceneLimits,
-  staticSceneSchema,
-  stripUndefined
-} from "./chunk-YUG3PBK2.js";
-
-// src/scene.ts
-function validateStaticScene(input) {
-  const parsed = staticSceneSchema.safeParse(input);
-  if (!parsed.success) {
-    return {
-      error: parsed.error.issues.map((issue) => `${issue.path.join(".") || "scene"}: ${issue.message}`).join("; "),
-      ok: false
-    };
-  }
-  if (jsonByteLength(parsed.data.overlays) > staticSceneLimits.maxGeoJsonBytes) {
-    return {
-      error: `overlays exceed ${staticSceneLimits.maxGeoJsonBytes} bytes`,
-      ok: false
-    };
-  }
-  return { ok: true, scene: normalizeParsedStaticScene(parsed.data) };
-}
-function normalizeStaticScene(scene) {
-  return normalizeParsedStaticScene(staticSceneSchema.parse(scene));
-}
-function normalizeParsedStaticScene(parsed) {
-  return stripUndefined({
-    camera: parsed.camera.type === "center" ? {
-      bearing: roundNumber(parsed.camera.bearing ?? 0),
-      center: normalizeStaticCoordinate(parsed.camera.center),
-      type: "center",
-      zoom: roundNumber(parsed.camera.zoom)
-    } : {
-      bearing: roundNumber(parsed.camera.bearing ?? 0),
-      bounds: parsed.camera.bounds.map(roundNumber),
-      padding: parsed.camera.padding ?? 32,
-      type: "bounds"
-    },
-    map: parsed.map,
-    overlays: parsed.overlays.map(
-      (overlay, index) => normalizeStaticOverlay({
-        ...overlay,
-        id: overlay.id ?? `overlay-${index + 1}`
-      })
-    ),
-    size: {
-      dpr: parsed.size.dpr ?? 1,
-      height: parsed.size.height,
-      width: parsed.size.width
-    },
-    theme: parsed.theme
-  });
-}
-
-export {
-  validateStaticScene,
-  normalizeStaticScene
-};