@maplibre-yaml/core 0.1.0-alpha.0

package/dist/schemas/index.js

@@ -0,0 +1,710 @@
+import { z } from 'zod';
+
+// @maplibre-yaml/core - Declarative web maps with YAML
+
+var LongitudeSchema = z.number().min(-180, "Longitude must be >= -180").max(180, "Longitude must be <= 180").describe("Longitude in degrees (-180 to 180)");
+var LatitudeSchema = z.number().min(-90, "Latitude must be >= -90").max(90, "Latitude must be <= 90").describe("Latitude in degrees (-90 to 90)");
+var LngLatSchema = z.tuple([LongitudeSchema, LatitudeSchema]).describe("Geographic coordinates as [longitude, latitude]");
+var LngLatBoundsSchema = z.tuple([
+  LongitudeSchema,
+  // west
+  LatitudeSchema,
+  // south
+  LongitudeSchema,
+  // east
+  LatitudeSchema
+  // north
+]).describe("Bounding box as [west, south, east, north]");
+var ColorSchema = z.string().refine(
+  (val) => {
+    if (val.startsWith("#")) {
+      return /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(val);
+    }
+    if (val.startsWith("rgb")) {
+      return /^rgba?\s*\([^)]+\)$/.test(val);
+    }
+    if (val.startsWith("hsl")) {
+      return /^hsla?\s*\([^)]+\)$/.test(val);
+    }
+    return true;
+  },
+  {
+    message: "Invalid color format. Use hex (#rgb, #rrggbb), rgb(), rgba(), hsl(), hsla(), or named colors."
+  }
+).describe("CSS color value");
+var ExpressionSchema = z.array(z.any()).refine((val) => val.length > 0 && typeof val[0] === "string", {
+  message: 'Expression must be an array starting with a string operator (e.g., ["get", "property"])'
+}).describe("MapLibre expression for data-driven styling");
+var NumberOrExpressionSchema = z.union([z.number(), ExpressionSchema]).describe("Number value or MapLibre expression");
+var ColorOrExpressionSchema = z.union([ColorSchema, ExpressionSchema]).describe("Color value or MapLibre expression");
+var ZoomLevelSchema = z.number().min(0, "Zoom level must be >= 0").max(24, "Zoom level must be <= 24").describe("Map zoom level (0-24)");
+var StreamConfigSchema = z.object({
+  type: z.enum(["websocket", "sse"]).describe("Streaming connection type"),
+  url: z.string().url().optional().describe("WebSocket or SSE endpoint URL"),
+  reconnect: z.boolean().default(true).describe("Automatically reconnect on disconnect"),
+  reconnectMaxAttempts: z.number().min(0).default(10).describe("Maximum number of reconnection attempts"),
+  reconnectDelay: z.number().min(100).default(1e3).describe("Initial delay in milliseconds before reconnecting"),
+  reconnectMaxDelay: z.number().min(1e3).default(3e4).describe("Maximum delay in milliseconds for exponential backoff"),
+  eventTypes: z.array(z.string()).optional().describe("Event types to listen for (SSE only)"),
+  protocols: z.union([z.string(), z.array(z.string())]).optional().describe("WebSocket sub-protocols (WebSocket only)")
+});
+var LoadingConfigSchema = z.object({
+  enabled: z.boolean().default(false).describe("Enable loading UI overlays"),
+  message: z.string().optional().describe("Custom loading message to display"),
+  showErrorOverlay: z.boolean().default(true).describe("Show error overlay on fetch failure")
+});
+var CacheConfigSchema = z.object({
+  enabled: z.boolean().default(true).describe("Enable HTTP caching"),
+  ttl: z.number().positive().optional().describe("Cache TTL in milliseconds (overrides default)")
+});
+var RefreshConfigSchema = z.object({
+  refreshInterval: z.number().min(1e3).optional().describe("Polling interval in milliseconds (minimum 1000ms)"),
+  updateStrategy: z.enum(["replace", "merge", "append-window"]).default("replace").describe("How to merge incoming data with existing data"),
+  updateKey: z.string().optional().describe("Property key for merge strategy (required for merge)"),
+  windowSize: z.number().positive().optional().describe("Maximum features to keep (append-window)"),
+  windowDuration: z.number().positive().optional().describe("Maximum age in milliseconds (append-window)"),
+  timestampField: z.string().optional().describe("Property field containing timestamp (append-window)")
+}).refine((data) => !(data.updateStrategy === "merge" && !data.updateKey), {
+  message: "updateKey is required when updateStrategy is 'merge'"
+});
+var GeoJSONSourceSchema = z.object({
+  type: z.literal("geojson").describe("Source type"),
+  url: z.string().url().optional().describe("URL to fetch GeoJSON data"),
+  data: z.any().optional().describe("Inline GeoJSON object"),
+  prefetchedData: z.any().optional().describe("Pre-fetched data from build time"),
+  fetchStrategy: z.enum(["runtime", "build", "hybrid"]).default("runtime").describe("When to fetch data: runtime (default), build, or hybrid"),
+  stream: StreamConfigSchema.optional().describe(
+    "WebSocket/SSE streaming configuration"
+  ),
+  refresh: RefreshConfigSchema.optional().describe(
+    "Polling refresh configuration"
+  ),
+  // Legacy support for direct refresh properties
+  refreshInterval: z.number().min(1e3).optional().describe("Polling interval in milliseconds (legacy, use refresh.refreshInterval)"),
+  updateStrategy: z.enum(["replace", "merge", "append-window"]).optional().describe("Update strategy (legacy, use refresh.updateStrategy)"),
+  updateKey: z.string().optional().describe("Update key (legacy, use refresh.updateKey)"),
+  loading: LoadingConfigSchema.optional().describe(
+    "Loading UI configuration"
+  ),
+  cache: CacheConfigSchema.optional().describe("Cache configuration"),
+  // MapLibre clustering options
+  cluster: z.boolean().optional().describe("Enable point clustering"),
+  clusterRadius: z.number().int().min(0).default(50).describe("Cluster radius in pixels"),
+  clusterMaxZoom: z.number().min(0).max(24).optional().describe("Maximum zoom level to cluster points"),
+  clusterMinPoints: z.number().int().min(2).optional().describe("Minimum points to form a cluster"),
+  clusterProperties: z.record(z.any()).optional().describe("Aggregate cluster properties"),
+  // Additional MapLibre options (passthrough)
+  tolerance: z.number().optional(),
+  buffer: z.number().optional(),
+  lineMetrics: z.boolean().optional(),
+  generateId: z.boolean().optional(),
+  promoteId: z.union([z.string(), z.record(z.string())]).optional(),
+  attribution: z.string().optional()
+}).passthrough().refine((data) => data.url || data.data || data.prefetchedData, {
+  message: 'GeoJSON source requires at least one of: url, data, or prefetchedData. Use "url" to fetch from an endpoint, "data" for inline GeoJSON, or "prefetchedData" for build-time fetched data.'
+});
+var VectorSourceSchema = z.object({
+  type: z.literal("vector").describe("Source type"),
+  url: z.string().url().optional().describe("TileJSON URL"),
+  tiles: z.array(z.string().url()).optional().describe("Tile URL template array"),
+  minzoom: z.number().min(0).max(24).optional().describe("Minimum zoom level"),
+  maxzoom: z.number().min(0).max(24).optional().describe("Maximum zoom level"),
+  bounds: z.tuple([z.number(), z.number(), z.number(), z.number()]).optional().describe("Bounding box [west, south, east, north]"),
+  scheme: z.enum(["xyz", "tms"]).optional().describe("Tile coordinate scheme"),
+  attribution: z.string().optional().describe("Attribution text"),
+  promoteId: z.union([z.string(), z.record(z.string())]).optional(),
+  volatile: z.boolean().optional()
+}).passthrough().refine((data) => data.url || data.tiles, {
+  message: 'Vector source requires either "url" (TileJSON) or "tiles" (tile URL array). Provide at least one of these properties.'
+});
+var RasterSourceSchema = z.object({
+  type: z.literal("raster").describe("Source type"),
+  url: z.string().url().optional().describe("TileJSON URL"),
+  tiles: z.array(z.string().url()).optional().describe("Tile URL template array"),
+  tileSize: z.number().int().min(1).default(512).describe("Tile size in pixels"),
+  minzoom: z.number().min(0).max(24).optional().describe("Minimum zoom level"),
+  maxzoom: z.number().min(0).max(24).optional().describe("Maximum zoom level"),
+  bounds: z.tuple([z.number(), z.number(), z.number(), z.number()]).optional().describe("Bounding box [west, south, east, north]"),
+  scheme: z.enum(["xyz", "tms"]).optional().describe("Tile coordinate scheme"),
+  attribution: z.string().optional().describe("Attribution text"),
+  volatile: z.boolean().optional()
+}).passthrough().refine((data) => data.url || data.tiles, {
+  message: 'Raster source requires either "url" (TileJSON) or "tiles" (tile URL array). Provide at least one of these properties.'
+});
+var ImageSourceSchema = z.object({
+  type: z.literal("image").describe("Source type"),
+  url: z.string().url().describe("Image URL"),
+  coordinates: z.tuple([LngLatSchema, LngLatSchema, LngLatSchema, LngLatSchema]).describe(
+    "Four corner coordinates [topLeft, topRight, bottomRight, bottomLeft]"
+  )
+}).passthrough();
+var VideoSourceSchema = z.object({
+  type: z.literal("video").describe("Source type"),
+  urls: z.array(z.string().url()).min(1).describe("Array of video URLs for browser compatibility"),
+  coordinates: z.tuple([LngLatSchema, LngLatSchema, LngLatSchema, LngLatSchema]).describe(
+    "Four corner coordinates [topLeft, topRight, bottomRight, bottomLeft]"
+  )
+}).passthrough();
+var LayerSourceSchema = z.union([
+  GeoJSONSourceSchema,
+  VectorSourceSchema,
+  RasterSourceSchema,
+  ImageSourceSchema,
+  VideoSourceSchema
+]);
+var PopupContentItemSchema = z.object({
+  str: z.string().optional().describe("Static text string"),
+  property: z.string().optional().describe("Feature property name"),
+  else: z.string().optional().describe("Fallback value if property missing"),
+  format: z.string().optional().describe('Number format string (e.g., ",.0f")'),
+  href: z.string().url().optional().describe("Link URL"),
+  text: z.string().optional().describe("Link text"),
+  src: z.string().url().optional().describe("Image/iframe source"),
+  alt: z.string().optional().describe("Image alt text")
+}).passthrough().describe("Popup content item with static or dynamic values");
+var PopupContentSchema = z.array(z.record(z.array(PopupContentItemSchema))).describe("Popup content structure as array of HTML elements");
+var InteractiveConfigSchema = z.object({
+  hover: z.object({
+    cursor: z.string().optional().describe('CSS cursor style (e.g., "pointer")'),
+    highlight: z.boolean().optional().describe("Highlight feature on hover")
+  }).optional().describe("Hover behavior"),
+  click: z.object({
+    popup: PopupContentSchema.optional().describe(
+      "Popup content to display"
+    ),
+    action: z.string().optional().describe("Custom action name to trigger"),
+    flyTo: z.object({
+      center: z.tuple([z.number(), z.number()]).optional(),
+      zoom: ZoomLevelSchema.optional(),
+      duration: z.number().optional()
+    }).optional().describe("Fly to location on click")
+  }).optional().describe("Click behavior"),
+  mouseenter: z.object({
+    action: z.string().optional().describe("Custom action on mouse enter")
+  }).optional(),
+  mouseleave: z.object({
+    action: z.string().optional().describe("Custom action on mouse leave")
+  }).optional()
+}).optional().describe("Interactive event configuration");
+var LegendItemSchema = z.object({
+  color: z.string().describe("CSS color value"),
+  label: z.string().describe("Legend label text"),
+  shape: z.enum(["circle", "square", "line", "icon"]).default("square").describe("Symbol shape"),
+  icon: z.string().optional().describe("Icon name or URL (for shape: icon)")
+}).describe("Legend item configuration");
+var BaseLayerPropertiesSchema = z.object({
+  id: z.string().describe("Unique layer identifier"),
+  label: z.string().optional().describe("Human-readable layer label"),
+  source: z.union([LayerSourceSchema, z.string()]).describe("Layer source (inline definition or source ID reference)"),
+  "source-layer": z.string().optional().describe("Source layer name (for vector sources)"),
+  minzoom: ZoomLevelSchema.optional().describe(
+    "Minimum zoom level to show layer"
+  ),
+  maxzoom: ZoomLevelSchema.optional().describe(
+    "Maximum zoom level to show layer"
+  ),
+  filter: ExpressionSchema.optional().describe("MapLibre filter expression"),
+  visible: z.boolean().default(true).describe("Initial visibility state"),
+  toggleable: z.boolean().default(true).describe("Allow users to toggle visibility"),
+  before: z.string().optional().describe("Layer ID to insert this layer before"),
+  interactive: InteractiveConfigSchema.describe(
+    "Interactive event configuration"
+  ),
+  legend: LegendItemSchema.optional().describe("Legend configuration"),
+  metadata: z.record(z.any()).optional().describe("Custom metadata")
+});
+var CircleLayerSchema = BaseLayerPropertiesSchema.extend({
+  type: z.literal("circle").describe("Layer type"),
+  paint: z.object({
+    "circle-radius": NumberOrExpressionSchema.optional(),
+    "circle-color": ColorOrExpressionSchema.optional(),
+    "circle-blur": NumberOrExpressionSchema.optional(),
+    "circle-opacity": NumberOrExpressionSchema.optional(),
+    "circle-stroke-width": NumberOrExpressionSchema.optional(),
+    "circle-stroke-color": ColorOrExpressionSchema.optional(),
+    "circle-stroke-opacity": NumberOrExpressionSchema.optional(),
+    "circle-pitch-scale": z.enum(["map", "viewport"]).optional(),
+    "circle-pitch-alignment": z.enum(["map", "viewport"]).optional(),
+    "circle-translate": z.tuple([z.number(), z.number()]).optional(),
+    "circle-translate-anchor": z.enum(["map", "viewport"]).optional()
+  }).passthrough().optional().describe("Circle paint properties"),
+  layout: z.object({}).passthrough().optional().describe("Circle layout properties")
+}).passthrough();
+var LineLayerSchema = BaseLayerPropertiesSchema.extend({
+  type: z.literal("line").describe("Layer type"),
+  paint: z.object({
+    "line-opacity": NumberOrExpressionSchema.optional(),
+    "line-color": ColorOrExpressionSchema.optional(),
+    "line-width": NumberOrExpressionSchema.optional(),
+    "line-gap-width": NumberOrExpressionSchema.optional(),
+    "line-offset": NumberOrExpressionSchema.optional(),
+    "line-blur": NumberOrExpressionSchema.optional(),
+    "line-dasharray": z.array(z.number()).optional(),
+    "line-pattern": z.string().optional(),
+    "line-gradient": ColorOrExpressionSchema.optional(),
+    "line-translate": z.tuple([z.number(), z.number()]).optional(),
+    "line-translate-anchor": z.enum(["map", "viewport"]).optional()
+  }).passthrough().optional().describe("Line paint properties"),
+  layout: z.object({
+    "line-cap": z.enum(["butt", "round", "square"]).optional(),
+    "line-join": z.enum(["bevel", "round", "miter"]).optional(),
+    "line-miter-limit": z.number().optional(),
+    "line-round-limit": z.number().optional(),
+    "line-sort-key": NumberOrExpressionSchema.optional()
+  }).passthrough().optional().describe("Line layout properties")
+}).passthrough();
+var FillLayerSchema = BaseLayerPropertiesSchema.extend({
+  type: z.literal("fill").describe("Layer type"),
+  paint: z.object({
+    "fill-antialias": z.boolean().optional(),
+    "fill-opacity": NumberOrExpressionSchema.optional(),
+    "fill-color": ColorOrExpressionSchema.optional(),
+    "fill-outline-color": ColorOrExpressionSchema.optional(),
+    "fill-translate": z.tuple([z.number(), z.number()]).optional(),
+    "fill-translate-anchor": z.enum(["map", "viewport"]).optional(),
+    "fill-pattern": z.string().optional()
+  }).passthrough().optional().describe("Fill paint properties"),
+  layout: z.object({
+    "fill-sort-key": NumberOrExpressionSchema.optional()
+  }).passthrough().optional().describe("Fill layout properties")
+}).passthrough();
+var SymbolLayerSchema = BaseLayerPropertiesSchema.extend({
+  type: z.literal("symbol").describe("Layer type"),
+  layout: z.object({
+    "symbol-placement": z.enum(["point", "line", "line-center"]).optional(),
+    "symbol-spacing": z.number().optional(),
+    "symbol-avoid-edges": z.boolean().optional(),
+    "symbol-sort-key": NumberOrExpressionSchema.optional(),
+    "symbol-z-order": z.enum(["auto", "viewport-y", "source"]).optional(),
+    "icon-allow-overlap": z.boolean().optional(),
+    "icon-ignore-placement": z.boolean().optional(),
+    "icon-optional": z.boolean().optional(),
+    "icon-rotation-alignment": z.enum(["map", "viewport", "auto"]).optional(),
+    "icon-size": NumberOrExpressionSchema.optional(),
+    "icon-text-fit": z.enum(["none", "width", "height", "both"]).optional(),
+    "icon-text-fit-padding": z.tuple([z.number(), z.number(), z.number(), z.number()]).optional(),
+    "icon-image": z.union([z.string(), ExpressionSchema]).optional(),
+    "icon-rotate": NumberOrExpressionSchema.optional(),
+    "icon-padding": z.number().optional(),
+    "icon-keep-upright": z.boolean().optional(),
+    "icon-offset": z.tuple([z.number(), z.number()]).optional(),
+    "icon-anchor": z.enum([
+      "center",
+      "left",
+      "right",
+      "top",
+      "bottom",
+      "top-left",
+      "top-right",
+      "bottom-left",
+      "bottom-right"
+    ]).optional(),
+    "icon-pitch-alignment": z.enum(["map", "viewport", "auto"]).optional(),
+    "text-pitch-alignment": z.enum(["map", "viewport", "auto"]).optional(),
+    "text-rotation-alignment": z.enum(["map", "viewport", "auto"]).optional(),
+    "text-field": z.union([z.string(), ExpressionSchema]).optional(),
+    "text-font": z.array(z.string()).optional(),
+    "text-size": NumberOrExpressionSchema.optional(),
+    "text-max-width": NumberOrExpressionSchema.optional(),
+    "text-line-height": z.number().optional(),
+    "text-letter-spacing": z.number().optional(),
+    "text-justify": z.enum(["auto", "left", "center", "right"]).optional(),
+    "text-radial-offset": z.number().optional(),
+    "text-variable-anchor": z.array(
+      z.enum([
+        "center",
+        "left",
+        "right",
+        "top",
+        "bottom",
+        "top-left",
+        "top-right",
+        "bottom-left",
+        "bottom-right"
+      ])
+    ).optional(),
+    "text-anchor": z.enum([
+      "center",
+      "left",
+      "right",
+      "top",
+      "bottom",
+      "top-left",
+      "top-right",
+      "bottom-left",
+      "bottom-right"
+    ]).optional(),
+    "text-max-angle": z.number().optional(),
+    "text-rotate": NumberOrExpressionSchema.optional(),
+    "text-padding": z.number().optional(),
+    "text-keep-upright": z.boolean().optional(),
+    "text-transform": z.enum(["none", "uppercase", "lowercase"]).optional(),
+    "text-offset": z.tuple([z.number(), z.number()]).optional(),
+    "text-allow-overlap": z.boolean().optional(),
+    "text-ignore-placement": z.boolean().optional(),
+    "text-optional": z.boolean().optional()
+  }).passthrough().optional().describe("Symbol layout properties"),
+  paint: z.object({
+    "icon-opacity": NumberOrExpressionSchema.optional(),
+    "icon-color": ColorOrExpressionSchema.optional(),
+    "icon-halo-color": ColorOrExpressionSchema.optional(),
+    "icon-halo-width": NumberOrExpressionSchema.optional(),
+    "icon-halo-blur": NumberOrExpressionSchema.optional(),
+    "icon-translate": z.tuple([z.number(), z.number()]).optional(),
+    "icon-translate-anchor": z.enum(["map", "viewport"]).optional(),
+    "text-opacity": NumberOrExpressionSchema.optional(),
+    "text-color": ColorOrExpressionSchema.optional(),
+    "text-halo-color": ColorOrExpressionSchema.optional(),
+    "text-halo-width": NumberOrExpressionSchema.optional(),
+    "text-halo-blur": NumberOrExpressionSchema.optional(),
+    "text-translate": z.tuple([z.number(), z.number()]).optional(),
+    "text-translate-anchor": z.enum(["map", "viewport"]).optional()
+  }).passthrough().optional().describe("Symbol paint properties")
+}).passthrough();
+var RasterLayerSchema = BaseLayerPropertiesSchema.extend({
+  type: z.literal("raster").describe("Layer type"),
+  paint: z.object({
+    "raster-opacity": NumberOrExpressionSchema.optional(),
+    "raster-hue-rotate": NumberOrExpressionSchema.optional(),
+    "raster-brightness-min": NumberOrExpressionSchema.optional(),
+    "raster-brightness-max": NumberOrExpressionSchema.optional(),
+    "raster-saturation": NumberOrExpressionSchema.optional(),
+    "raster-contrast": NumberOrExpressionSchema.optional(),
+    "raster-resampling": z.enum(["linear", "nearest"]).optional(),
+    "raster-fade-duration": z.number().optional()
+  }).passthrough().optional().describe("Raster paint properties"),
+  layout: z.object({}).passthrough().optional().describe("Raster layout properties")
+}).passthrough();
+var FillExtrusionLayerSchema = BaseLayerPropertiesSchema.extend({
+  type: z.literal("fill-extrusion").describe("Layer type"),
+  paint: z.object({
+    "fill-extrusion-opacity": NumberOrExpressionSchema.optional(),
+    "fill-extrusion-color": ColorOrExpressionSchema.optional(),
+    "fill-extrusion-translate": z.tuple([z.number(), z.number()]).optional(),
+    "fill-extrusion-translate-anchor": z.enum(["map", "viewport"]).optional(),
+    "fill-extrusion-pattern": z.string().optional(),
+    "fill-extrusion-height": NumberOrExpressionSchema.optional(),
+    "fill-extrusion-base": NumberOrExpressionSchema.optional(),
+    "fill-extrusion-vertical-gradient": z.boolean().optional()
+  }).passthrough().optional().describe("Fill extrusion paint properties"),
+  layout: z.object({}).passthrough().optional().describe("Fill extrusion layout properties")
+}).passthrough();
+var HeatmapLayerSchema = BaseLayerPropertiesSchema.extend({
+  type: z.literal("heatmap").describe("Layer type"),
+  paint: z.object({
+    "heatmap-radius": NumberOrExpressionSchema.optional(),
+    "heatmap-weight": NumberOrExpressionSchema.optional(),
+    "heatmap-intensity": NumberOrExpressionSchema.optional(),
+    "heatmap-color": ColorOrExpressionSchema.optional(),
+    "heatmap-opacity": NumberOrExpressionSchema.optional()
+  }).passthrough().optional().describe("Heatmap paint properties"),
+  layout: z.object({}).passthrough().optional().describe("Heatmap layout properties")
+}).passthrough();
+var HillshadeLayerSchema = BaseLayerPropertiesSchema.extend({
+  type: z.literal("hillshade").describe("Layer type"),
+  paint: z.object({
+    "hillshade-illumination-direction": z.number().optional(),
+    "hillshade-illumination-anchor": z.enum(["map", "viewport"]).optional(),
+    "hillshade-exaggeration": NumberOrExpressionSchema.optional(),
+    "hillshade-shadow-color": ColorOrExpressionSchema.optional(),
+    "hillshade-highlight-color": ColorOrExpressionSchema.optional(),
+    "hillshade-accent-color": ColorOrExpressionSchema.optional()
+  }).passthrough().optional().describe("Hillshade paint properties"),
+  layout: z.object({}).passthrough().optional().describe("Hillshade layout properties")
+}).passthrough();
+var BackgroundLayerSchema = z.object({
+  id: z.string().describe("Unique layer identifier"),
+  type: z.literal("background").describe("Layer type"),
+  paint: z.object({
+    "background-color": ColorOrExpressionSchema.optional(),
+    "background-pattern": z.string().optional(),
+    "background-opacity": NumberOrExpressionSchema.optional()
+  }).passthrough().optional().describe("Background paint properties"),
+  layout: z.object({}).passthrough().optional().describe("Background layout properties"),
+  metadata: z.record(z.any()).optional().describe("Custom metadata")
+}).passthrough();
+var LayerSchema = z.union([
+  CircleLayerSchema,
+  LineLayerSchema,
+  FillLayerSchema,
+  SymbolLayerSchema,
+  RasterLayerSchema,
+  FillExtrusionLayerSchema,
+  HeatmapLayerSchema,
+  HillshadeLayerSchema,
+  BackgroundLayerSchema
+]);
+var LayerReferenceSchema = z.object({
+  $ref: z.string().describe('Reference to global layer (e.g., "#/layers/bikeLayer")')
+}).describe("Layer reference");
+var LayerOrReferenceSchema = z.union([
+  LayerSchema,
+  LayerReferenceSchema
+]);
+var ValidTagNames = [
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  "p",
+  "span",
+  "div",
+  "a",
+  "strong",
+  "em",
+  "code",
+  "pre",
+  "img",
+  "iframe",
+  "ul",
+  "ol",
+  "li",
+  "blockquote",
+  "hr",
+  "br"
+];
+var ContentElementSchema = z.object({
+  // Content
+  str: z.string().optional().describe("Static text string"),
+  property: z.string().optional().describe("Dynamic property from context"),
+  else: z.string().optional().describe("Fallback value if property missing"),
+  // Styling
+  classList: z.union([z.string(), z.array(z.string())]).optional().describe("CSS class names (space-separated string or array)"),
+  id: z.string().optional().describe("Element ID attribute"),
+  style: z.string().optional().describe("Inline CSS styles"),
+  // Links
+  href: z.string().url().optional().describe("Link URL"),
+  target: z.string().optional().describe("Link target (_blank, _self, _parent, _top)"),
+  // Media
+  src: z.string().url().optional().describe("Source URL for img or iframe"),
+  alt: z.string().optional().describe("Alternative text for images"),
+  width: z.union([z.string(), z.number()]).optional().describe("Width (pixels or %)"),
+  height: z.union([z.string(), z.number()]).optional().describe("Height (pixels or %)")
+}).passthrough().describe("Content element with styling and properties");
+var ContentItemSchema = z.record(z.enum(ValidTagNames), z.array(ContentElementSchema)).describe("Content item mapping tag to elements");
+var ContentBlockSchema = z.object({
+  type: z.literal("content").describe("Block type"),
+  id: z.string().optional().describe("Unique block identifier"),
+  className: z.string().optional().describe("CSS class name for the block container"),
+  style: z.string().optional().describe("Inline CSS styles for the block container"),
+  content: z.array(ContentItemSchema).describe("Array of content items to render")
+}).describe("Content block for rich text and media");
+var ControlPositionSchema = z.enum([
+  "top-left",
+  "top-right",
+  "bottom-left",
+  "bottom-right"
+]);
+var ControlConfigSchema = z.union([
+  z.boolean(),
+  z.object({
+    enabled: z.boolean().describe("Whether control is enabled"),
+    position: ControlPositionSchema.optional().describe("Control position")
+  })
+]);
+var ControlsConfigSchema = z.object({
+  navigation: ControlConfigSchema.optional().describe(
+    "Navigation controls (zoom, rotation)"
+  ),
+  geolocate: ControlConfigSchema.optional().describe("Geolocation control"),
+  scale: ControlConfigSchema.optional().describe("Scale control"),
+  fullscreen: ControlConfigSchema.optional().describe("Fullscreen control"),
+  attribution: ControlConfigSchema.optional().describe("Attribution control")
+}).describe("Map controls configuration");
+var LegendConfigSchema = z.object({
+  position: ControlPositionSchema.default("top-left").describe("Legend position"),
+  title: z.string().optional().describe("Legend title"),
+  collapsed: z.boolean().default(false).describe("Start collapsed"),
+  items: z.array(
+    z.object({
+      color: z.string().describe("Item color"),
+      label: z.string().describe("Item label"),
+      shape: z.enum(["circle", "square", "line", "icon"]).default("square").describe("Symbol shape"),
+      icon: z.string().optional().describe("Icon name/URL (for shape: icon)")
+    })
+  ).optional().describe("Custom legend items (overrides layer legends)")
+}).describe("Legend configuration");
+var MapConfigSchema = z.object({
+  // Required
+  center: LngLatSchema.describe("Initial map center [longitude, latitude]"),
+  zoom: ZoomLevelSchema.describe("Initial zoom level (0-24)"),
+  mapStyle: z.union([z.string().url(), z.any()]).describe("MapLibre style URL or style object"),
+  // View
+  pitch: z.number().min(0).max(85).default(0).describe("Camera pitch angle in degrees (0-85)"),
+  bearing: z.number().min(-180).max(180).default(0).describe("Camera bearing (rotation) in degrees (-180 to 180)"),
+  bounds: z.union([LngLatBoundsSchema, z.array(z.number())]).optional().describe("Fit map to bounds"),
+  // Constraints
+  minZoom: ZoomLevelSchema.optional().describe("Minimum zoom level"),
+  maxZoom: ZoomLevelSchema.optional().describe("Maximum zoom level"),
+  minPitch: z.number().min(0).max(85).optional().describe("Minimum pitch"),
+  maxPitch: z.number().min(0).max(85).optional().describe("Maximum pitch"),
+  maxBounds: LngLatBoundsSchema.optional().describe(
+    "Maximum geographic bounds"
+  ),
+  // Interaction
+  interactive: z.boolean().default(true).describe("Enable map interaction"),
+  scrollZoom: z.boolean().optional().describe("Enable scroll to zoom"),
+  boxZoom: z.boolean().optional().describe("Enable box zoom (shift+drag)"),
+  dragRotate: z.boolean().optional().describe("Enable drag to rotate"),
+  dragPan: z.boolean().optional().describe("Enable drag to pan"),
+  keyboard: z.boolean().optional().describe("Enable keyboard shortcuts"),
+  doubleClickZoom: z.boolean().optional().describe("Enable double-click zoom"),
+  touchZoomRotate: z.boolean().optional().describe("Enable touch zoom/rotate"),
+  touchPitch: z.boolean().optional().describe("Enable touch pitch"),
+  // Display
+  hash: z.boolean().optional().describe("Sync map state with URL hash"),
+  attributionControl: z.boolean().optional().describe("Show attribution control"),
+  logoPosition: ControlPositionSchema.optional().describe(
+    "MapLibre logo position"
+  ),
+  fadeDuration: z.number().optional().describe("Fade duration in milliseconds"),
+  crossSourceCollisions: z.boolean().optional().describe("Check for cross-source collisions"),
+  // Rendering
+  antialias: z.boolean().optional().describe("Enable antialiasing"),
+  refreshExpiredTiles: z.boolean().optional().describe("Refresh expired tiles"),
+  renderWorldCopies: z.boolean().optional().describe("Render multiple world copies"),
+  locale: z.record(z.string()).optional().describe("Localization strings"),
+  // Performance
+  maxTileCacheSize: z.number().optional().describe("Maximum tiles to cache"),
+  localIdeographFontFamily: z.string().optional().describe("Font for CJK characters"),
+  trackResize: z.boolean().optional().describe("Track container resize"),
+  preserveDrawingBuffer: z.boolean().optional().describe("Preserve drawing buffer"),
+  failIfMajorPerformanceCaveat: z.boolean().optional().describe("Fail if major performance caveat")
+}).passthrough().describe("Map configuration with MapLibre options");
+var MapBlockSchema = z.object({
+  type: z.literal("map").describe("Block type"),
+  id: z.string().describe("Unique block identifier"),
+  className: z.string().optional().describe("CSS class name for container"),
+  style: z.string().optional().describe("Inline CSS styles for container"),
+  config: MapConfigSchema.describe("Map configuration"),
+  layers: z.array(LayerOrReferenceSchema).default([]).describe("Map layers"),
+  controls: ControlsConfigSchema.optional().describe("Map controls"),
+  legend: LegendConfigSchema.optional().describe("Legend configuration")
+}).describe("Standard map block");
+var MapFullPageBlockSchema = z.object({
+  type: z.literal("map-fullpage").describe("Block type"),
+  id: z.string().describe("Unique block identifier"),
+  className: z.string().optional().describe("CSS class name for container"),
+  style: z.string().optional().describe("Inline CSS styles for container"),
+  config: MapConfigSchema.describe("Map configuration"),
+  layers: z.array(LayerOrReferenceSchema).default([]).describe("Map layers"),
+  controls: ControlsConfigSchema.optional().describe("Map controls"),
+  legend: LegendConfigSchema.optional().describe("Legend configuration")
+}).describe("Full-page map block");
+var ChapterActionSchema = z.object({
+  action: z.enum([
+    "setFilter",
+    "setPaintProperty",
+    "setLayoutProperty",
+    "flyTo",
+    "easeTo",
+    "fitBounds",
+    "custom"
+  ]).describe("Action type"),
+  layer: z.string().optional().describe("Target layer ID"),
+  property: z.string().optional().describe("Property name (for setPaintProperty/setLayoutProperty)"),
+  value: z.any().optional().describe("Property value"),
+  filter: ExpressionSchema.nullable().optional().describe("Filter expression (for setFilter, null to clear)"),
+  bounds: z.array(z.number()).optional().describe("Bounds array (for fitBounds)"),
+  options: z.record(z.any()).optional().describe("Additional options")
+}).describe("Chapter action for map state changes");
+var ChapterLayersSchema = z.object({
+  show: z.array(z.string()).default([]).describe("Layer IDs to show"),
+  hide: z.array(z.string()).default([]).describe("Layer IDs to hide")
+}).describe("Chapter layer visibility configuration");
+var ChapterSchema = z.object({
+  // Required
+  id: z.string().describe("Unique chapter identifier"),
+  title: z.string().describe("Chapter title"),
+  center: LngLatSchema.describe("Map center [longitude, latitude]"),
+  zoom: z.number().describe("Zoom level"),
+  // Content
+  description: z.string().optional().describe("Chapter description (HTML/markdown supported)"),
+  image: z.string().url().optional().describe("Hero image URL"),
+  video: z.string().url().optional().describe("Video URL"),
+  // Camera
+  pitch: z.number().min(0).max(85).default(0).describe("Camera pitch angle (0-85)"),
+  bearing: z.number().min(-180).max(180).default(0).describe("Camera bearing (-180 to 180)"),
+  speed: z.number().min(0).max(2).default(0.6).describe("Animation speed multiplier (0-2)"),
+  curve: z.number().min(0).max(2).default(1).describe("Animation curve (0=linear, 1=default, 2=steep)"),
+  animation: z.enum(["flyTo", "easeTo", "jumpTo"]).default("flyTo").describe("Animation type"),
+  // Rotation animation
+  rotateAnimation: z.boolean().optional().describe("Enable continuous rotation animation"),
+  spinGlobe: z.boolean().optional().describe("Spin globe animation (for low zoom levels)"),
+  // Layout
+  alignment: z.enum(["left", "right", "center", "full"]).default("center").describe("Content alignment"),
+  hidden: z.boolean().default(false).describe("Hide chapter content (map-only)"),
+  // Layers
+  layers: ChapterLayersSchema.optional().describe("Layer visibility control"),
+  // Actions
+  onChapterEnter: z.array(ChapterActionSchema).default([]).describe("Actions when entering chapter"),
+  onChapterExit: z.array(ChapterActionSchema).default([]).describe("Actions when exiting chapter"),
+  // Custom
+  callback: z.string().optional().describe("Custom callback function name")
+}).describe("Scrollytelling chapter");
+var ScrollytellingBlockSchema = z.object({
+  type: z.literal("scrollytelling").describe("Block type"),
+  id: z.string().describe("Unique block identifier"),
+  className: z.string().optional().describe("CSS class name for container"),
+  style: z.string().optional().describe("Inline CSS styles for container"),
+  // Base config
+  config: MapConfigSchema.describe("Base map configuration"),
+  // Theme
+  theme: z.enum(["light", "dark"]).default("light").describe("Visual theme"),
+  // Markers
+  showMarkers: z.boolean().default(false).describe("Show chapter markers on map"),
+  markerColor: z.string().default("#3FB1CE").describe("Chapter marker color"),
+  // Layers (persistent across all chapters)
+  layers: z.array(LayerOrReferenceSchema).default([]).describe("Persistent layers (visible throughout story)"),
+  // Chapters
+  chapters: z.array(ChapterSchema).min(1, "At least one chapter is required for scrollytelling").describe("Story chapters"),
+  // Footer
+  footer: z.string().optional().describe("Footer content (HTML)")
+}).describe("Scrollytelling block for narrative map stories");
+var MixedBlockSchema = z.lazy(
+  () => z.object({
+    type: z.literal("mixed").describe("Block type"),
+    id: z.string().optional().describe("Unique block identifier"),
+    className: z.string().optional().describe("CSS class name for container"),
+    style: z.string().optional().describe("Inline CSS styles for container"),
+    layout: z.enum(["row", "column", "grid"]).default("row").describe("Layout direction"),
+    gap: z.string().optional().describe("Gap between blocks (CSS gap property)"),
+    blocks: z.array(BlockSchema).describe("Child blocks")
+  }).describe("Mixed block for combining multiple block types")
+);
+var BlockSchema = z.union([
+  ContentBlockSchema,
+  MapBlockSchema,
+  MapFullPageBlockSchema,
+  ScrollytellingBlockSchema,
+  MixedBlockSchema
+]);
+var PageSchema = z.object({
+  path: z.string().describe('URL path (e.g., "/", "/about")'),
+  title: z.string().describe("Page title"),
+  description: z.string().optional().describe("Page description for SEO"),
+  blocks: z.array(BlockSchema).describe("Page content blocks")
+}).describe("Page configuration");
+var GlobalConfigSchema = z.object({
+  title: z.string().optional().describe("Application title"),
+  description: z.string().optional().describe("Application description"),
+  defaultMapStyle: z.string().url().optional().describe("Default map style URL"),
+  theme: z.enum(["light", "dark"]).default("light").describe("Default theme"),
+  dataFetching: z.object({
+    defaultStrategy: z.enum(["runtime", "build", "hybrid"]).default("runtime").describe("Default fetch strategy"),
+    timeout: z.number().min(1e3).default(3e4).describe("Default timeout in milliseconds"),
+    retryAttempts: z.number().int().min(0).default(3).describe("Default retry attempts")
+  }).optional().describe("Data fetching configuration")
+}).describe("Global configuration");
+var RootSchema = z.object({
+  config: GlobalConfigSchema.optional().describe("Global configuration"),
+  layers: z.record(LayerSchema).optional().describe("Named layer definitions for reuse"),
+  sources: z.record(LayerSourceSchema).optional().describe("Named source definitions for reuse"),
+  pages: z.array(PageSchema).min(1, "At least one page is required").describe("Page definitions")
+}).describe("Root configuration schema");
+
+export { BackgroundLayerSchema, BaseLayerPropertiesSchema, BlockSchema, ChapterActionSchema, ChapterLayersSchema, ChapterSchema, CircleLayerSchema, ColorOrExpressionSchema, ColorSchema, ContentBlockSchema, ContentElementSchema, ContentItemSchema, ControlPositionSchema, ControlsConfigSchema, ExpressionSchema, FillExtrusionLayerSchema, FillLayerSchema, GeoJSONSourceSchema, GlobalConfigSchema, HeatmapLayerSchema, HillshadeLayerSchema, ImageSourceSchema, InteractiveConfigSchema, LatitudeSchema, LayerOrReferenceSchema, LayerReferenceSchema, LayerSchema, LayerSourceSchema, LegendConfigSchema, LegendItemSchema, LineLayerSchema, LngLatBoundsSchema, LngLatSchema, LoadingConfigSchema, LongitudeSchema, MapBlockSchema, MapConfigSchema, MapFullPageBlockSchema, MixedBlockSchema, NumberOrExpressionSchema, PageSchema, PopupContentItemSchema, PopupContentSchema, RasterLayerSchema, RasterSourceSchema, RootSchema, ScrollytellingBlockSchema, StreamConfigSchema, SymbolLayerSchema, ValidTagNames, VectorSourceSchema, VideoSourceSchema, ZoomLevelSchema };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map