@maplibre-yaml/core 0.1.0-alpha.0 → 0.1.1

package/dist/schemas/index.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-export { h as BackgroundLayerSchema, B as BaseLayerPropertiesSchema, d as CircleLayerSchema, k as ControlPositionSchema, C as ControlsConfigSchema, f as FillExtrusionLayerSchema, F as FillLayerSchema, H as HeatmapLayerSchema, g as HillshadeLayerSchema, I as InteractiveConfigSchema, j as LayerOrReferenceSchema, i as LayerReferenceSchema, L as LayerSchema, a as LegendConfigSchema, c as LegendItemSchema, e as LineLayerSchema, l as MapBlockSchema, M as MapConfigSchema, m as MapFullPageBlockSchema, b as PopupContentItemSchema, P as PopupContentSchema, R as RasterLayerSchema, S as SymbolLayerSchema } from '../map.schema-EnZRrtIh.js';
+export { j as BackgroundLayerSchema, B as BaseLayerPropertiesSchema, p as BlockSchema, e as CircleLayerSchema, m as ControlPositionSchema, C as ControlsConfigSchema, h as FillExtrusionLayerSchema, F as FillLayerSchema, G as GlobalConfigSchema, H as HeatmapLayerSchema, i as HillshadeLayerSchema, I as InteractiveConfigSchema, l as LayerOrReferenceSchema, k as LayerReferenceSchema, L as LayerSchema, a as LegendConfigSchema, d as LegendItemSchema, f as LineLayerSchema, M as MapBlockSchema, b as MapConfigSchema, n as MapFullPageBlockSchema, o as MixedBlockSchema, q as PageSchema, c as PopupContentItemSchema, P as PopupContentSchema, g as RasterLayerSchema, R as RootSchema, S as SymbolLayerSchema } from '../page.schema-CzdCyPFI.js';
 
 /**
  * @file Base schemas for maplibre-yaml
@@ -515,7 +515,7 @@ declare const GeoJSONSourceSchema: z.ZodEffects<z.ZodObject<{
         ttl?: number | undefined;
     }>>;
     cluster: z.ZodOptional<z.ZodBoolean>;
-    clusterRadius: z.ZodDefault<z.ZodNumber>;
+    clusterRadius: z.ZodOptional<z.ZodNumber>;
     clusterMaxZoom: z.ZodOptional<z.ZodNumber>;
     clusterMinPoints: z.ZodOptional<z.ZodNumber>;
     clusterProperties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
@@ -622,7 +622,7 @@ declare const GeoJSONSourceSchema: z.ZodEffects<z.ZodObject<{
         ttl?: number | undefined;
     }>>;
     cluster: z.ZodOptional<z.ZodBoolean>;
-    clusterRadius: z.ZodDefault<z.ZodNumber>;
+    clusterRadius: z.ZodOptional<z.ZodNumber>;
     clusterMaxZoom: z.ZodOptional<z.ZodNumber>;
     clusterMinPoints: z.ZodOptional<z.ZodNumber>;
     clusterProperties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
@@ -729,7 +729,7 @@ declare const GeoJSONSourceSchema: z.ZodEffects<z.ZodObject<{
         ttl?: number | undefined;
     }>>;
     cluster: z.ZodOptional<z.ZodBoolean>;
-    clusterRadius: z.ZodDefault<z.ZodNumber>;
+    clusterRadius: z.ZodOptional<z.ZodNumber>;
     clusterMaxZoom: z.ZodOptional<z.ZodNumber>;
     clusterMinPoints: z.ZodOptional<z.ZodNumber>;
     clusterProperties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
@@ -836,7 +836,7 @@ declare const GeoJSONSourceSchema: z.ZodEffects<z.ZodObject<{
         ttl?: number | undefined;
     }>>;
     cluster: z.ZodOptional<z.ZodBoolean>;
-    clusterRadius: z.ZodDefault<z.ZodNumber>;
+    clusterRadius: z.ZodOptional<z.ZodNumber>;
     clusterMaxZoom: z.ZodOptional<z.ZodNumber>;
     clusterMinPoints: z.ZodOptional<z.ZodNumber>;
     clusterProperties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
@@ -943,7 +943,7 @@ declare const GeoJSONSourceSchema: z.ZodEffects<z.ZodObject<{
         ttl?: number | undefined;
     }>>;
     cluster: z.ZodOptional<z.ZodBoolean>;
-    clusterRadius: z.ZodDefault<z.ZodNumber>;
+    clusterRadius: z.ZodOptional<z.ZodNumber>;
     clusterMaxZoom: z.ZodOptional<z.ZodNumber>;
     clusterMinPoints: z.ZodOptional<z.ZodNumber>;
     clusterProperties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
@@ -1304,7 +1304,7 @@ declare const LayerSourceSchema: z.ZodUnion<[z.ZodEffects<z.ZodObject<{
         ttl?: number | undefined;
     }>>;
     cluster: z.ZodOptional<z.ZodBoolean>;
-    clusterRadius: z.ZodDefault<z.ZodNumber>;
+    clusterRadius: z.ZodOptional<z.ZodNumber>;
     clusterMaxZoom: z.ZodOptional<z.ZodNumber>;
     clusterMinPoints: z.ZodOptional<z.ZodNumber>;
     clusterProperties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
@@ -1411,7 +1411,7 @@ declare const LayerSourceSchema: z.ZodUnion<[z.ZodEffects<z.ZodObject<{
         ttl?: number | undefined;
     }>>;
     cluster: z.ZodOptional<z.ZodBoolean>;
-    clusterRadius: z.ZodDefault<z.ZodNumber>;
+    clusterRadius: z.ZodOptional<z.ZodNumber>;
     clusterMaxZoom: z.ZodOptional<z.ZodNumber>;
     clusterMinPoints: z.ZodOptional<z.ZodNumber>;
     clusterProperties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
@@ -1518,7 +1518,7 @@ declare const LayerSourceSchema: z.ZodUnion<[z.ZodEffects<z.ZodObject<{
         ttl?: number | undefined;
     }>>;
     cluster: z.ZodOptional<z.ZodBoolean>;
-    clusterRadius: z.ZodDefault<z.ZodNumber>;
+    clusterRadius: z.ZodOptional<z.ZodNumber>;
     clusterMaxZoom: z.ZodOptional<z.ZodNumber>;
     clusterMinPoints: z.ZodOptional<z.ZodNumber>;
     clusterProperties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
@@ -1625,7 +1625,7 @@ declare const LayerSourceSchema: z.ZodUnion<[z.ZodEffects<z.ZodObject<{
         ttl?: number | undefined;
     }>>;
     cluster: z.ZodOptional<z.ZodBoolean>;
-    clusterRadius: z.ZodDefault<z.ZodNumber>;
+    clusterRadius: z.ZodOptional<z.ZodNumber>;
     clusterMaxZoom: z.ZodOptional<z.ZodNumber>;
     clusterMinPoints: z.ZodOptional<z.ZodNumber>;
     clusterProperties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
@@ -1732,7 +1732,7 @@ declare const LayerSourceSchema: z.ZodUnion<[z.ZodEffects<z.ZodObject<{
         ttl?: number | undefined;
     }>>;
     cluster: z.ZodOptional<z.ZodBoolean>;
-    clusterRadius: z.ZodDefault<z.ZodNumber>;
+    clusterRadius: z.ZodOptional<z.ZodNumber>;
     clusterMaxZoom: z.ZodOptional<z.ZodNumber>;
     clusterMinPoints: z.ZodOptional<z.ZodNumber>;
     clusterProperties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
@@ -2741,411 +2741,4 @@ declare const ChapterSchema: z.ZodObject<{
  */
 declare const ScrollytellingBlockSchema: z.ZodObject<any>;
 
-/**
- * @file Page and root configuration schemas for maplibre-yaml
- * @module @maplibre-yaml/core/schemas/page
- *
- * @description
- * Zod schemas for pages, global configuration, and the root schema.
- * Includes recursive MixedBlock for complex layouts.
- *
- * @example
- * ```typescript
- * import { RootSchema, PageSchema } from '@maplibre-yaml/core/schemas';
- * ```
- */
-
-/**
- * Mixed block for combining multiple block types.
- *
- * @remarks
- * MixedBlock allows you to create complex layouts by combining
- * content, map, and scrollytelling blocks. Uses z.lazy() for recursion.
- *
- * **Layout Options:**
- * - `row` - Horizontal layout (default)
- * - `column` - Vertical layout
- * - `grid` - CSS Grid layout
- *
- * @example Row Layout
- * ```yaml
- * - type: mixed
- *   layout: row
- *   blocks:
- *     - type: content
- *       content:
- *         - h2: [{ str: "Left Column" }]
- *     - type: map
- *       id: side-map
- *       config:
- *         center: [0, 0]
- *         zoom: 2
- *         mapStyle: "..."
- * ```
- *
- * @example Grid Layout
- * ```yaml
- * - type: mixed
- *   layout: grid
- *   style: "grid-template-columns: repeat(2, 1fr); gap: 20px;"
- *   blocks:
- *     - type: content
- *       content: [...]
- *     - type: content
- *       content: [...]
- *     - type: map
- *       id: map1
- *       config: {...}
- *     - type: map
- *       id: map2
- *       config: {...}
- * ```
- *
- * @example Nested Mixed Blocks
- * ```yaml
- * - type: mixed
- *   layout: column
- *   blocks:
- *     - type: content
- *       content: [...]
- *     - type: mixed
- *       layout: row
- *       blocks:
- *         - type: map
- *           id: left-map
- *           config: {...}
- *         - type: map
- *           id: right-map
- *           config: {...}
- * ```
- */
-declare const MixedBlockSchema: z.ZodType<any>;
-/**
- * Union of all block types.
- *
- * @remarks
- * Blocks are the building blocks of pages. Each page contains an
- * array of blocks that are rendered in order.
- *
- * **Block Types:**
- * - `content` - Rich text and media
- * - `map` - Standard map
- * - `map-fullpage` - Full viewport map
- * - `scrollytelling` - Narrative map story
- * - `mixed` - Layout container for other blocks
- */
-declare const BlockSchema: z.ZodType<any>;
-/**
- * Page configuration.
- *
- * @remarks
- * A page represents a single route/URL in your application.
- * Pages contain blocks that define the content and maps.
- *
- * **Required:**
- * - `path` - URL path (e.g., "/", "/about", "/map")
- * - `title` - Page title (used for browser tab and SEO)
- * - `blocks` - Array of content/map blocks
- *
- * **Optional:**
- * - `description` - Meta description for SEO
- *
- * @example Home Page
- * ```yaml
- * - path: "/"
- *   title: "Home"
- *   description: "Welcome to our mapping application"
- *   blocks:
- *     - type: content
- *       content:
- *         - h1: [{ str: "Welcome" }]
- *     - type: map
- *       id: home-map
- *       config:
- *         center: [0, 0]
- *         zoom: 2
- *         mapStyle: "..."
- * ```
- *
- * @example Story Page
- * ```yaml
- * - path: "/story"
- *   title: "Our Story"
- *   description: "An interactive map story"
- *   blocks:
- *     - type: scrollytelling
- *       id: main-story
- *       config: {...}
- *       chapters: [...]
- * ```
- *
- * @example Complex Layout
- * ```yaml
- * - path: "/dashboard"
- *   title: "Dashboard"
- *   blocks:
- *     - type: content
- *       content:
- *         - h1: [{ str: "Dashboard" }]
- *     - type: mixed
- *       layout: row
- *       blocks:
- *         - type: map
- *           id: map1
- *           config: {...}
- *         - type: map
- *           id: map2
- *           config: {...}
- * ```
- */
-declare const PageSchema: z.ZodObject<{
-    path: z.ZodString;
-    title: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    blocks: z.ZodArray<z.ZodType<any, z.ZodTypeDef, any>, "many">;
-}, "strip", z.ZodTypeAny, {
-    path: string;
-    title: string;
-    blocks: any[];
-    description?: string | undefined;
-}, {
-    path: string;
-    title: string;
-    blocks: any[];
-    description?: string | undefined;
-}>;
-/**
- * Global configuration.
- *
- * @remarks
- * Global settings that apply across all pages.
- *
- * **General:**
- * - `title` - Application title
- * - `description` - Application description
- * - `defaultMapStyle` - Default map style for all maps
- * - `theme` - Default theme (light/dark)
- *
- * **Data Fetching:**
- * - `defaultStrategy` - Default fetch strategy (runtime, build, hybrid)
- * - `timeout` - Default fetch timeout
- * - `retryAttempts` - Default retry attempts
- *
- * @example Basic Config
- * ```yaml
- * config:
- *   title: "My Map App"
- *   description: "Interactive maps and stories"
- *   defaultMapStyle: "https://demotiles.maplibre.org/style.json"
- * ```
- *
- * @example With Data Fetching
- * ```yaml
- * config:
- *   title: "My Map App"
- *   defaultMapStyle: "https://demotiles.maplibre.org/style.json"
- *   theme: dark
- *   dataFetching:
- *     defaultStrategy: build
- *     timeout: 15000
- *     retryAttempts: 5
- * ```
- */
-declare const GlobalConfigSchema: z.ZodObject<{
-    title: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
-    defaultMapStyle: z.ZodOptional<z.ZodString>;
-    theme: z.ZodDefault<z.ZodEnum<["light", "dark"]>>;
-    dataFetching: z.ZodOptional<z.ZodObject<{
-        defaultStrategy: z.ZodDefault<z.ZodEnum<["runtime", "build", "hybrid"]>>;
-        timeout: z.ZodDefault<z.ZodNumber>;
-        retryAttempts: z.ZodDefault<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        defaultStrategy: "runtime" | "build" | "hybrid";
-        timeout: number;
-        retryAttempts: number;
-    }, {
-        defaultStrategy?: "runtime" | "build" | "hybrid" | undefined;
-        timeout?: number | undefined;
-        retryAttempts?: number | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    theme: "light" | "dark";
-    title?: string | undefined;
-    description?: string | undefined;
-    defaultMapStyle?: string | undefined;
-    dataFetching?: {
-        defaultStrategy: "runtime" | "build" | "hybrid";
-        timeout: number;
-        retryAttempts: number;
-    } | undefined;
-}, {
-    title?: string | undefined;
-    description?: string | undefined;
-    theme?: "light" | "dark" | undefined;
-    defaultMapStyle?: string | undefined;
-    dataFetching?: {
-        defaultStrategy?: "runtime" | "build" | "hybrid" | undefined;
-        timeout?: number | undefined;
-        retryAttempts?: number | undefined;
-    } | undefined;
-}>;
-/**
- * Root configuration schema.
- *
- * @remarks
- * The root schema represents the entire maplibre-yaml configuration.
- * This is the top-level structure for YAML files.
- *
- * **Structure:**
- * 1. `config` - Global settings (optional)
- * 2. `layers` - Named layer definitions for reuse (optional)
- * 3. `sources` - Named source definitions for reuse (optional)
- * 4. `pages` - Page definitions (required, minimum 1)
- *
- * **Global Layers and Sources:**
- * Define layers and sources once, reference them anywhere using `$ref`.
- *
- * @example Minimal Configuration
- * ```yaml
- * pages:
- *   - path: "/"
- *     title: "Home"
- *     blocks:
- *       - type: map
- *         id: main-map
- *         config:
- *           center: [0, 0]
- *           zoom: 2
- *           mapStyle: "https://demotiles.maplibre.org/style.json"
- * ```
- *
- * @example With Global Config
- * ```yaml
- * config:
- *   title: "My App"
- *   defaultMapStyle: "https://demotiles.maplibre.org/style.json"
- *
- * pages:
- *   - path: "/"
- *     title: "Home"
- *     blocks:
- *       - type: map
- *         id: main-map
- *         config:
- *           center: [0, 0]
- *           zoom: 2
- * ```
- *
- * @example With Global Layers
- * ```yaml
- * config:
- *   defaultMapStyle: "https://demotiles.maplibre.org/style.json"
- *
- * layers:
- *   bikeLayer:
- *     id: bikes
- *     type: line
- *     source:
- *       type: geojson
- *       url: "https://example.com/bikes.geojson"
- *     paint:
- *       line-color: "#00ff00"
- *       line-width: 2
- *
- *   parkLayer:
- *     id: parks
- *     type: fill
- *     source:
- *       type: geojson
- *       url: "https://example.com/parks.geojson"
- *     paint:
- *       fill-color: "#228B22"
- *       fill-opacity: 0.5
- *
- * pages:
- *   - path: "/"
- *     title: "Home"
- *     blocks:
- *       - type: map
- *         id: main-map
- *         config:
- *           center: [-74.006, 40.7128]
- *           zoom: 12
- *         layers:
- *           - $ref: "#/layers/bikeLayer"
- *           - $ref: "#/layers/parkLayer"
- * ```
- *
- * @example With Global Sources
- * ```yaml
- * sources:
- *   earthquakeSource:
- *     type: geojson
- *     url: "https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/all_day.geojson"
- *     refreshInterval: 60000
- *
- * layers:
- *   earthquakes:
- *     id: earthquakes
- *     type: circle
- *     source: earthquakeSource
- *     paint:
- *       circle-radius: 8
- *       circle-color: "#ff0000"
- *
- * pages:
- *   - path: "/"
- *     title: "Earthquakes"
- *     blocks:
- *       - type: map
- *         id: quake-map
- *         config:
- *           center: [0, 0]
- *           zoom: 2
- *           mapStyle: "..."
- *         layers:
- *           - $ref: "#/layers/earthquakes"
- * ```
- *
- * @example Multi-Page Application
- * ```yaml
- * config:
- *   title: "Multi-Page Map App"
- *   defaultMapStyle: "https://demotiles.maplibre.org/style.json"
- *
- * pages:
- *   - path: "/"
- *     title: "Home"
- *     blocks:
- *       - type: content
- *         content:
- *           - h1: [{ str: "Welcome" }]
- *
- *   - path: "/map"
- *     title: "Interactive Map"
- *     blocks:
- *       - type: map
- *         id: main-map
- *         config:
- *           center: [0, 0]
- *           zoom: 2
- *
- *   - path: "/story"
- *     title: "Our Story"
- *     blocks:
- *       - type: scrollytelling
- *         id: story
- *         config:
- *           center: [0, 0]
- *           zoom: 2
- *         chapters:
- *           - id: intro
- *             title: "Introduction"
- *             center: [0, 0]
- *             zoom: 3
- * ```
- */
-declare const RootSchema: z.ZodType<any>;
-
-export { BlockSchema, ChapterActionSchema, ChapterLayersSchema, ChapterSchema, ColorOrExpressionSchema, ColorSchema, ContentBlockSchema, ContentElementSchema, ContentItemSchema, ExpressionSchema, GeoJSONSourceSchema, GlobalConfigSchema, ImageSourceSchema, LatitudeSchema, LayerSourceSchema, LngLatBoundsSchema, LngLatSchema, LoadingConfigSchema, LongitudeSchema, MixedBlockSchema, NumberOrExpressionSchema, PageSchema, RasterSourceSchema, RootSchema, ScrollytellingBlockSchema, StreamConfigSchema, ValidTagNames, VectorSourceSchema, VideoSourceSchema, ZoomLevelSchema };
+export { ChapterActionSchema, ChapterLayersSchema, ChapterSchema, ColorOrExpressionSchema, ColorSchema, ContentBlockSchema, ContentElementSchema, ContentItemSchema, ExpressionSchema, GeoJSONSourceSchema, ImageSourceSchema, LatitudeSchema, LayerSourceSchema, LngLatBoundsSchema, LngLatSchema, LoadingConfigSchema, LongitudeSchema, NumberOrExpressionSchema, RasterSourceSchema, ScrollytellingBlockSchema, StreamConfigSchema, ValidTagNames, VectorSourceSchema, VideoSourceSchema, ZoomLevelSchema };

package/dist/schemas/index.js

@@ -80,7 +80,9 @@ var GeoJSONSourceSchema = z.object({
     "Polling refresh configuration"
   ),
   // Legacy support for direct refresh properties
-  refreshInterval: z.number().min(1e3).optional().describe("Polling interval in milliseconds (legacy, use refresh.refreshInterval)"),
+  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(
@@ -89,7 +91,7 @@ var GeoJSONSourceSchema = z.object({
   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"),
+  clusterRadius: z.number().int().min(0).optional().describe("Cluster radius in pixels (default: 50)"),
   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"),