@versatiles/style 5.8.4 → 5.9.1

package/README.md

@@ -18,6 +18,7 @@
 | **eclipse**   | <img width="384" src="https://versatiles.org/versatiles-style/eclipse.png" alt="eclipse style" />     |
 | **neutrino**  | <img width="384" src="https://versatiles.org/versatiles-style/neutrino.png" alt="neutrino style" />   |
 | **shadow**    | <img width="384" src="https://versatiles.org/versatiles-style/shadow.png" alt="shadow style" />       |
+| **satellite** | <img width="384" src="https://versatiles.org/versatiles-style/satellite.png" alt="satellite style" /> |
 
 ---
 
@@ -95,8 +96,10 @@ The library offers the following style generation methods:
 - `graybeard(options)` - [Documentation](https://versatiles.org/versatiles-style/functions/graybeard.html)
 - `neutrino(options)` - [Documentation](https://versatiles.org/versatiles-style/functions/neutrino.html)
 - `shadow(options)` - [Documentation](https://versatiles.org/versatiles-style/functions/shadow.html)
+- `satellite(options)` - [Documentation](https://versatiles.org/versatiles-style/functions/satellite.html)
 
 **`options`**: An optional object to customize the styles. [Learn more](https://versatiles.org/versatiles-style/interfaces/StyleBuilderOptions.html)
+`satellite` uses a different options type: [SatelliteStyleOptions](https://versatiles.org/versatiles-style/interfaces/SatelliteStyleOptions.html)
 
 ### Guess Style Method
 
@@ -159,7 +162,7 @@ subgraph 1["color"]
 end
 subgraph 9["guess_style"]
 A["guess_style.ts"]
-Z["index.ts"]
+10["index.ts"]
 end
 subgraph B["lib"]
 C["utils.ts"]
@@ -171,7 +174,8 @@ Q["eclipse.ts"]
 R["empty.ts"]
 S["graybeard.ts"]
 T["neutrino.ts"]
-U["shadow.ts"]
+U["satellite.ts"]
+V["shadow.ts"]
 end
 subgraph G["style_builder"]
 H["style_builder.ts"]
@@ -185,13 +189,13 @@ K["layers.ts"]
 L["template.ts"]
 N["properties.ts"]
 end
-subgraph V["types"]
-W["index.ts"]
-X["tilejson.ts"]
-Y["vector_layer.ts"]
-11["maplibre.ts"]
+subgraph W["types"]
+X["index.ts"]
+Y["tilejson.ts"]
+Z["vector_layer.ts"]
+12["maplibre.ts"]
 end
-10["index.ts"]
+11["index.ts"]
 end
 3-->2
 3-->4
@@ -215,8 +219,8 @@ end
 A-->5
 A-->C
 A-->E
-A-->W
 A-->X
+A-->Y
 C-->8
 E-->F
 E-->Q
@@ -224,6 +228,7 @@ E-->R
 E-->S
 E-->T
 E-->U
+E-->V
 F-->H
 H-->8
 H-->C
@@ -241,15 +246,16 @@ Q-->F
 R-->F
 S-->F
 T-->F
-U-->F
-W-->X
-W-->Y
-Z-->A
-10-->8
-10-->Z
-10-->E
-
-class 0,1,9,B,D,G,I,V subgraphs;
+U-->S
+V-->F
+X-->Y
+X-->Z
+10-->A
+11-->8
+11-->10
+11-->E
+
+class 0,1,9,B,D,G,I,W subgraphs;
 classDef subgraphs fill-opacity:0.1, fill:#888, color:#888, stroke:#888;
 ```
 

package/dist/index.d.ts

@@ -88,12 +88,6 @@ declare class RGB extends Color {
      * @returns The current RGB instance.
      */
     asRGB(): RGB;
-    /**
-     * Returns the RGB color.
-     *
-     * @returns The current RGB instance.
-     */
-    toRGB(): RGB;
     /**
      * Parses a string or Color instance into an RGB color.
      *
@@ -306,11 +300,6 @@ declare class HSL extends Color {
      * @returns The current HSL color.
      */
     asHSL(): HSL;
-    /**
-     * Returns the current HSL color.
-     * @returns The current HSL color.
-     */
-    toHSL(): HSL;
     /**
      * Converts the HSL color to an HSV color.
      * @returns A new HSV color representing the same color.
@@ -667,7 +656,8 @@ interface StyleBuilderOptions {
      */
     recolor?: RecolorOptions;
 }
-type StyleBuilderColorKey = 'agriculture' | 'boundary' | 'building' | 'buildingbg' | 'burial' | 'commercial' | 'construction' | 'cycle' | 'danger' | 'disputed' | 'education' | 'foot' | 'glacier' | 'grass' | 'hospital' | 'industrial' | 'label' | 'labelHalo' | 'land' | 'leisure' | 'motorway' | 'motorwaybg' | 'park' | 'parking' | 'poi' | 'prison' | 'rail' | 'residential' | 'rock' | 'sand' | 'shield' | 'street' | 'streetbg' | 'subway' | 'symbol' | 'trunk' | 'trunkbg' | 'waste' | 'water' | 'wetland' | 'wood';
+declare const styleBuilderColorKeys: readonly ["agriculture", "boundary", "building", "buildingbg", "burial", "commercial", "construction", "cycle", "danger", "disputed", "education", "foot", "glacier", "grass", "hospital", "industrial", "label", "labelHalo", "land", "leisure", "motorway", "motorwaybg", "park", "parking", "poi", "prison", "rail", "residential", "rock", "sand", "shield", "street", "streetbg", "subway", "symbol", "trunk", "trunkbg", "waste", "water", "wetland", "wood"];
+type StyleBuilderColorKey = (typeof styleBuilderColorKeys)[number];
 /** Records string values for color properties in a style builder. */
 type StyleBuilderColors<T = Color | string> = Record<StyleBuilderColorKey, T>;
 /** Records string values for font properties in a style builder. */
@@ -676,6 +666,21 @@ type StyleBuilderFonts = {
     bold: string;
 };
 
+interface SatelliteStyleOptions {
+    baseUrl?: string;
+    rasterTiles?: string[];
+    overlayTiles?: string[];
+    overlay?: boolean;
+    language?: Language;
+    rasterOpacity?: number;
+    rasterHueRotate?: number;
+    rasterBrightnessMin?: number;
+    rasterBrightnessMax?: number;
+    rasterSaturation?: number;
+    rasterContrast?: number;
+}
+declare function buildSatelliteStyle(options?: SatelliteStyleOptions): StyleSpecification;
+
 interface StyleBuilderFunction {
     (options?: StyleBuilderOptions): StyleSpecification;
     getOptions(): StyleBuilderOptions;
@@ -757,7 +762,8 @@ declare const styles: {
     graybeard: StyleBuilderFunction;
     shadow: StyleBuilderFunction;
     neutrino: StyleBuilderFunction;
+    satellite: typeof buildSatelliteStyle;
 };
 
-export { Color, HSL, HSV, RGB, colorful, eclipse, graybeard, guessStyle, neutrino, shadow, styles };
-export type { GuessStyleOptions, Language, RandomColorOptions, RecolorOptions, StyleBuilderColorKey, StyleBuilderColors, StyleBuilderFonts, StyleBuilderFunction, StyleBuilderOptions, TileJSONSpecification, TileJSONSpecificationRaster, TileJSONSpecificationVector, VectorLayer };
+export { Color, HSL, HSV, RGB, colorful, eclipse, graybeard, guessStyle, neutrino, buildSatelliteStyle as satellite, shadow, styles };
+export type { GuessStyleOptions, Language, RandomColorOptions, RecolorOptions, SatelliteStyleOptions, StyleBuilderColorKey, StyleBuilderColors, StyleBuilderFonts, StyleBuilderFunction, StyleBuilderOptions, TileJSONSpecification, TileJSONSpecificationRaster, TileJSONSpecificationVector, VectorLayer };

package/dist/index.js

@@ -145,7 +145,7 @@ function mod(value, max) {
     value = value % max;
     if (value < 0)
         value += max;
-    if (value == 0)
+    if (value === 0)
         return 0;
     return value;
 }
@@ -347,7 +347,7 @@ function getColorInfo(hue) {
             return color;
         }
     }
-    throw Error('Color hue value not found');
+    throw new Error(`getColorInfo: No color info found for hue value ${hue}. This indicates a gap in the color dictionary hue ranges.`);
 }
 
 /**
@@ -519,14 +519,6 @@ class RGB extends Color {
     asRGB() {
         return this.clone();
     }
-    /**
-     * Returns the RGB color.
-     *
-     * @returns The current RGB instance.
-     */
-    toRGB() {
-        return this;
-    }
     /**
      * Parses a string or Color instance into an RGB color.
      *
@@ -750,7 +742,7 @@ class HSV extends Color {
         const v = this.v / 100;
         const k = (2 - s) * v;
         const q = k < 1 ? k : 2 - k;
-        return new HSL(this.h, q == 0 ? 0 : (100 * s * v) / q, (100 * k) / 2, this.a);
+        return new HSL(this.h, q === 0 ? 0 : (100 * s * v) / q, (100 * k) / 2, this.a);
     }
     /**
      * Returns the current HSV color.
@@ -917,13 +909,6 @@ class HSL extends Color {
     asHSL() {
         return this.clone();
     }
-    /**
-     * Returns the current HSL color.
-     * @returns The current HSL color.
-     */
-    toHSL() {
-        return this;
-    }
     /**
      * Converts the HSL color to an HSV color.
      * @returns A new HSV color representing the same color.
@@ -1031,7 +1016,7 @@ Color.parse = function (input) {
         case 'hsla(':
             return HSL.parse(input);
         default:
-            throw Error('Unknown color format: ' + input);
+            throw new Error(`Color.parse: Unknown color format "${input}". Expected formats: "#RRGGBB", "#RGB", "rgb(...)", "rgba(...)", "hsl(...)", or "hsla(...)".`);
     }
 };
 Color.HSL = HSL;
@@ -2070,9 +2055,7 @@ function deepClone(obj) {
     }
     if (obj == null)
         return obj;
-    console.log('obj', obj);
-    console.log('obj.prototype', Object.getPrototypeOf(obj));
-    throw Error();
+    throw new Error(`deepClone: Unsupported object type "${Object.getPrototypeOf(obj)?.constructor?.name ?? 'unknown'}"`);
 }
 function isSimpleObject(item) {
     if (item === null)
@@ -2098,7 +2081,7 @@ function isBasicType(item) {
         case 'object':
             return false;
         default:
-            throw Error('unknown type: ' + typeof item);
+            throw new Error(`isBasicType: Unknown type "${typeof item}"`);
     }
 }
 function deepMerge(source0, ...sources) {
@@ -2110,9 +2093,7 @@ function deepMerge(source0, ...sources) {
             if (!(key in source))
                 continue;
             const sourceValue = source[key];
-            // *********
-            // overwrite
-            // *********
+            // Handle basic types (number, string, boolean) - always overwrite
             switch (typeof sourceValue) {
                 case 'number':
                 case 'string':
@@ -2120,28 +2101,23 @@ function deepMerge(source0, ...sources) {
                     target[key] = sourceValue;
                     continue;
             }
+            // If target is a basic type, overwrite with deep clone of source
             if (isBasicType(target[key])) {
                 target[key] = deepClone(sourceValue);
                 continue;
             }
+            // Handle Color instances - clone the source color
             if (sourceValue instanceof Color) {
                 target[key] = sourceValue.clone();
                 continue;
             }
+            // If both are simple objects, merge them recursively
             if (isSimpleObject(target[key]) && isSimpleObject(sourceValue)) {
                 target[key] = deepMerge(target[key], sourceValue);
                 continue;
             }
-            // *********
-            // merge
-            // *********
-            if (isSimpleObject(target[key]) && isSimpleObject(sourceValue)) {
-                target[key] = deepMerge(target[key], sourceValue);
-                continue;
-            }
-            console.log('target[key]:', target[key]);
-            console.log('source[key]:', source[key]);
-            throw Error('unpredicted case');
+            // Incompatible types - throw error
+            throw new Error(`deepMerge: Cannot merge incompatible types for key "${String(key)}" (target: ${typeof target[key]}, source: ${typeof sourceValue})`);
         }
     }
     return target;
@@ -2183,7 +2159,7 @@ function decorate(layers, rules, recolor) {
             const regExpString = id.replace(/[^a-z_:-]/g, (c) => {
                 if (c === '*')
                     return '[a-z_-]*';
-                throw new Error('unknown char to process. Do not know how to make a RegExp from: ' + JSON.stringify(c));
+                throw new Error(`decorator: Invalid character ${JSON.stringify(c)} in layer ID pattern "${id}". Only alphanumeric, underscore, colon, hyphen, and asterisk are allowed.`);
             });
             const regExp = new RegExp(`^${regExpString}$`, 'i');
             return layerIds.filter((layerId) => regExp.test(layerId));
@@ -2233,27 +2209,24 @@ function decorate(layers, rules, recolor) {
                         value = processExpression(value);
                         break;
                     default:
-                        throw new Error(`unknown propertyDef.valueType "${propertyDef.valueType}" for key "${key}"`);
+                        throw new Error(`decorator: Unknown property value type "${propertyDef.valueType}" for key "${key}" on layer type "${layer.type}". This may indicate a MapLibre property definition mismatch.`);
                 }
                 switch (propertyDef.parent) {
                     case 'layer':
-                        // @ts-expect-error: too complex to handle
                         layer[key] = value;
                         break;
                     case 'layout':
                         if (!layer.layout)
                             layer.layout = {};
-                        // @ts-expect-error: too complex to handle
                         layer.layout[key] = value;
                         break;
                     case 'paint':
                         if (!layer.paint)
                             layer.paint = {};
-                        // @ts-expect-error: too complex to handle
                         layer.paint[key] = value;
                         break;
                     default:
-                        throw new Error(`unknown parent "${propertyDef.parent}" for key "${key}"`);
+                        throw new Error(`decorator: Unknown property parent "${propertyDef.parent}" for key "${key}" on layer type "${layer.type}". Expected "layer", "layout", or "paint".`);
                 }
             });
         }
@@ -2264,12 +2237,12 @@ function decorate(layers, rules, recolor) {
                 const color = recolor.do(value);
                 return color.asString();
             }
-            throw new Error(`unknown color type "${typeof value}"`);
+            throw new Error(`decorator.processColor: Expected a color string or Color instance, but got ${typeof value}. Value: ${JSON.stringify(value)}`);
         }
         function processFont(value) {
             if (typeof value === 'string')
                 return [value];
-            throw new Error(`unknown font type "${typeof value}"`);
+            throw new Error(`decorator.processFont: Expected a font name string, but got ${typeof value}. Value: ${JSON.stringify(value)}`);
         }
         function processExpression(value, cbValue) {
             if (typeof value === 'object') {
@@ -2316,7 +2289,7 @@ function getDefaultRecolorFlags() {
  * Checks if the given options object contains any active recolor transformations.
  * @param opt The recolor options to validate.
  */
-function isValidRecolorOptions(opt) {
+function hasActiveRecolorOptions(opt) {
     if (!opt)
         return false;
     return (opt.invertBrightness ||
@@ -2337,14 +2310,20 @@ class CachedRecolor {
     skip;
     opt;
     cache;
+    parsedTintColor;
+    parsedBlendColor;
     /**
      * Creates a cached recolor instance.
      * @param opt Optional recolor options.
      */
     constructor(opt) {
-        this.skip = !isValidRecolorOptions(opt);
+        this.skip = !hasActiveRecolorOptions(opt);
         this.cache = new Map();
         this.opt = opt;
+        if (opt?.tint && opt.tintColor != null)
+            this.parsedTintColor = Color.parse(opt.tintColor);
+        if (opt?.blend && opt.blendColor != null)
+            this.parsedBlendColor = Color.parse(opt.blendColor);
     }
     /**
      * Applies cached recoloring to a given color.
@@ -2357,7 +2336,7 @@ class CachedRecolor {
         const key = color.asHex();
         if (this.cache.has(key))
             return this.cache.get(key);
-        const recolored = recolor(color, this.opt);
+        const recolored = recolor(color, this.opt, this.parsedTintColor, this.parsedBlendColor);
         this.cache.set(key, recolored);
         return recolored;
     }
@@ -2366,10 +2345,12 @@ class CachedRecolor {
  * Applies the specified recoloring transformations to a single color.
  * @param color The original color.
  * @param opt Optional recolor options.
+ * @param parsedTintColor Optional pre-parsed tint color to avoid repeated parsing.
+ * @param parsedBlendColor Optional pre-parsed blend color to avoid repeated parsing.
  * @returns A new `Color` instance with applied transformations.
  */
-function recolor(color, opt) {
-    if (!isValidRecolorOptions(opt))
+function recolor(color, opt, parsedTintColor, parsedBlendColor) {
+    if (!hasActiveRecolorOptions(opt))
         return color;
     if (opt.invertBrightness)
         color = color.invertLuminosity();
@@ -2377,16 +2358,16 @@ function recolor(color, opt) {
         color = color.rotateHue(opt.rotate);
     if (opt.saturate)
         color = color.saturate(opt.saturate);
-    if (opt.gamma != null && opt.gamma != 1)
+    if (opt.gamma != null && opt.gamma !== 1)
         color = color.gamma(opt.gamma);
-    if (opt.contrast != null && opt.contrast != 1)
+    if (opt.contrast != null && opt.contrast !== 1)
         color = color.contrast(opt.contrast);
     if (opt.brightness)
         color = color.brightness(opt.brightness);
     if (opt.tint && opt.tintColor != null)
-        color = color.tint(opt.tint, Color.parse(opt.tintColor));
+        color = color.tint(opt.tint, parsedTintColor ?? Color.parse(opt.tintColor));
     if (opt.blend && opt.blendColor != null)
-        color = color.blend(opt.blend, Color.parse(opt.blendColor));
+        color = color.blend(opt.blend, parsedBlendColor ?? Color.parse(opt.blendColor));
     return color;
 }
 
@@ -2478,7 +2459,8 @@ class StyleBuilder {
         // get shortbread layers
         const layerDefinitions = getShortbreadLayers({ language });
         let layers = layerDefinitions.map((layer) => {
-            switch (layer.type) {
+            const { type, id } = layer;
+            switch (type) {
                 case 'background':
                     return layer;
                 case 'fill':
@@ -2489,7 +2471,7 @@ class StyleBuilder {
                         ...layer,
                     };
             }
-            throw Error('unknown layer type');
+            throw new Error(`StyleBuilder: Unknown layer type "${type}" for layer "${id}". Expected "background", "fill", "line", or "symbol".`);
         });
         // apply layer rules
         layers = decorate(layers, layerStyleRules, new CachedRecolor(recolorOptions));
@@ -2499,7 +2481,7 @@ class StyleBuilder {
         style.layers = layers;
         style.name = 'versatiles-' + this.name.toLowerCase();
         style.glyphs = resolveUrl(baseUrl, glyphs);
-        if (typeof sprite == 'string') {
+        if (typeof sprite === 'string') {
             style.sprite = [{ id: basename(sprite), url: resolveUrl(baseUrl, sprite) }];
         }
         else {
@@ -4061,6 +4043,92 @@ class Empty extends Colorful {
     }
 }
 
+function buildSatelliteStyle(options) {
+    options ??= {};
+    const baseUrl = options.baseUrl ?? 'https://tiles.versatiles.org';
+    const rasterTiles = options.rasterTiles ?? [`${baseUrl}/tiles/satellite/{z}/{x}/{y}`];
+    const overlay = options.overlay ?? true;
+    let style;
+    if (overlay) {
+        // Generate graybeard style for overlay
+        style = new Graybeard().build({
+            baseUrl,
+            tiles: options.overlayTiles,
+            language: options.language,
+        });
+        // Filter out background, fill layers, and unwanted layer groups
+        style.layers = style.layers.filter((l) => l.id !== 'background' && l.type !== 'fill' && !/^(land|water|site|airport|tunnel)-/.test(l.id));
+        // Modify remaining layers
+        for (const layer of style.layers) {
+            if (layer.type === 'symbol') {
+                // Bold font, white text, black halo
+                if (layer.layout?.['text-font']) {
+                    layer.layout['text-font'] = ['noto_sans_bold'];
+                }
+                if (layer.paint) {
+                    layer.paint['text-color'] = '#fff';
+                    layer.paint['text-halo-color'] = '#000';
+                    if ('text-halo-blur' in layer.paint)
+                        layer.paint['text-halo-blur'] = 0;
+                    if ('text-halo-width' in layer.paint)
+                        layer.paint['text-halo-width'] = 1;
+                }
+            }
+            if (layer.type === 'line' && layer.paint) {
+                // Multiply existing opacity by 0.2
+                const v = layer.paint['line-opacity'];
+                if (v == null) {
+                    layer.paint['line-opacity'] = 0.2;
+                }
+                else if (typeof v === 'number') {
+                    layer.paint['line-opacity'] = v * 0.2;
+                }
+                else if (typeof v === 'object' && 'stops' in v) {
+                    v.stops = v.stops.map((s) => [s[0], s[1] * 0.2]);
+                }
+            }
+        }
+    }
+    else {
+        // Minimal style with no overlay
+        style = { version: 8, sources: {}, layers: [] };
+    }
+    // Build raster paint properties
+    const rasterPaint = {};
+    if (options.rasterOpacity != null)
+        rasterPaint['raster-opacity'] = options.rasterOpacity;
+    if (options.rasterHueRotate != null)
+        rasterPaint['raster-hue-rotate'] = options.rasterHueRotate;
+    if (options.rasterBrightnessMin != null)
+        rasterPaint['raster-brightness-min'] = options.rasterBrightnessMin;
+    if (options.rasterBrightnessMax != null)
+        rasterPaint['raster-brightness-max'] = options.rasterBrightnessMax;
+    if (options.rasterSaturation != null)
+        rasterPaint['raster-saturation'] = options.rasterSaturation;
+    if (options.rasterContrast != null)
+        rasterPaint['raster-contrast'] = options.rasterContrast;
+    // Add raster source
+    style.sources.satellite = {
+        type: 'raster',
+        tiles: rasterTiles,
+        tileSize: 512,
+        attribution: "<a href='https://versatiles.org/sources/'>VersaTiles sources</a>",
+        bounds: [-180, -86, 180, 86],
+        minzoom: 0,
+        maxzoom: 17,
+    };
+    // Add raster layer at bottom
+    style.layers.unshift({
+        id: 'satellite',
+        type: 'raster',
+        source: 'satellite',
+        minzoom: 0,
+        ...(Object.keys(rasterPaint).length > 0 ? { paint: rasterPaint } : {}),
+    });
+    style.name = 'versatiles-satellite';
+    return style;
+}
+
 // import styles
 function getStyleBuilder(styleBuilder) {
     const fn = function (options) {
@@ -4083,76 +4151,76 @@ getStyleBuilder(Empty);
  */
 function isTileJSONSpecification(spec) {
     if (typeof spec !== 'object' || spec === null) {
-        throw Error('spec must be an object');
+        throw new Error(`TileJSON validation: spec must be an object, but got ${typeof spec}`);
     }
     const obj = spec;
     // Common property validation
     if (obj.data != null && obj.tilejson !== '3.0.0') {
-        throw Error('spec.tilejson must be "3.0.0"');
+        throw new Error(`TileJSON validation: spec.tilejson must be "3.0.0", but got "${obj.tilejson}"`);
     }
     if (obj.attribution != null && typeof obj.attribution !== 'string') {
-        throw Error('spec.attribution must be a string if present');
+        throw new Error(`TileJSON validation: spec.attribution must be a string if present, but got ${typeof obj.attribution}`);
     }
     if (obj.bounds != null) {
         if (!Array.isArray(obj.bounds) || obj.bounds.length !== 4 || obj.bounds.some((num) => typeof num !== 'number')) {
-            throw Error('spec.bounds must be an array of four numbers if present');
+            throw new Error(`TileJSON validation: spec.bounds must be an array of four numbers if present, but got ${JSON.stringify(obj.bounds)}`);
         }
         const a = obj.bounds;
         if (a[0] < -180 || a[0] > 180)
-            throw Error('spec.bounds[0] must be between -180 and 180');
+            throw new Error(`TileJSON validation: spec.bounds[0] (longitude) must be between -180 and 180, but got ${a[0]}`);
         if (a[1] < -90 || a[1] > 90)
-            throw Error('spec.bounds[1] must be between -90 and 90');
+            throw new Error(`TileJSON validation: spec.bounds[1] (latitude) must be between -90 and 90, but got ${a[1]}`);
         if (a[2] < -180 || a[2] > 180)
-            throw Error('spec.bounds[2] must be between -180 and 180');
+            throw new Error(`TileJSON validation: spec.bounds[2] (longitude) must be between -180 and 180, but got ${a[2]}`);
         if (a[3] < -90 || a[3] > 90)
-            throw Error('spec.bounds[3] must be between -90 and 90');
+            throw new Error(`TileJSON validation: spec.bounds[3] (latitude) must be between -90 and 90, but got ${a[3]}`);
         if (a[0] > a[2])
-            throw Error('spec.bounds[0] must be smaller than spec.bounds[2]');
+            throw new Error(`TileJSON validation: spec.bounds[0] must be smaller than spec.bounds[2] (min longitude < max longitude), but got [${a[0]}, ${a[2]}]`);
         if (a[1] > a[3])
-            throw Error('spec.bounds[1] must be smaller than spec.bounds[3]');
+            throw new Error(`TileJSON validation: spec.bounds[1] must be smaller than spec.bounds[3] (min latitude < max latitude), but got [${a[1]}, ${a[3]}]`);
     }
     if (obj.center != null) {
         if (!Array.isArray(obj.center) || obj.center.length !== 2 || obj.center.some((num) => typeof num !== 'number')) {
-            throw Error('spec.center must be an array of two numbers if present');
+            throw new Error(`TileJSON validation: spec.center must be an array of two numbers if present, but got ${JSON.stringify(obj.center)}`);
         }
         const a = obj.center;
         if (a[0] < -180 || a[0] > 180)
-            throw Error('spec.center[0] must be between -180 and 180');
+            throw new Error(`TileJSON validation: spec.center[0] (longitude) must be between -180 and 180, but got ${a[0]}`);
         if (a[1] < -90 || a[1] > 90)
-            throw Error('spec.center[1] must be between -90 and 90');
+            throw new Error(`TileJSON validation: spec.center[1] (latitude) must be between -90 and 90, but got ${a[1]}`);
     }
     if (obj.data != null && (!Array.isArray(obj.data) || obj.data.some((url) => typeof url !== 'string'))) {
-        throw Error('spec.data must be an array of strings if present');
+        throw new Error('TileJSON validation: spec.data must be an array of strings if present');
     }
     if (obj.description != null && typeof obj.description !== 'string') {
-        throw Error('spec.description must be a string if present');
+        throw new Error(`TileJSON validation: spec.description must be a string if present, but got ${typeof obj.description}`);
     }
     if (obj.fillzoom != null && (typeof obj.fillzoom !== 'number' || obj.fillzoom < 0)) {
-        throw Error('spec.fillzoom must be a positive integer if present');
+        throw new Error(`TileJSON validation: spec.fillzoom must be a positive integer if present, but got ${obj.fillzoom}`);
     }
     if (obj.grids != null && (!Array.isArray(obj.grids) || obj.grids.some((url) => typeof url !== 'string'))) {
-        throw Error('spec.grids must be an array of strings if present');
+        throw new Error('TileJSON validation: spec.grids must be an array of strings if present');
     }
     if (obj.legend != null && typeof obj.legend !== 'string') {
-        throw Error('spec.legend must be a string if present');
+        throw new Error(`TileJSON validation: spec.legend must be a string if present, but got ${typeof obj.legend}`);
     }
     if (obj.minzoom != null && (typeof obj.minzoom !== 'number' || obj.minzoom < 0)) {
-        throw Error('spec.minzoom must be a positive integer if present');
+        throw new Error(`TileJSON validation: spec.minzoom must be a positive integer if present, but got ${obj.minzoom}`);
     }
     if (obj.maxzoom != null && (typeof obj.maxzoom !== 'number' || obj.maxzoom < 0)) {
-        throw Error('spec.maxzoom must be a positive integer if present');
+        throw new Error(`TileJSON validation: spec.maxzoom must be a positive integer if present, but got ${obj.maxzoom}`);
     }
     if (obj.name != null && typeof obj.name !== 'string') {
-        throw Error('spec.name must be a string if present');
+        throw new Error(`TileJSON validation: spec.name must be a string if present, but got ${typeof obj.name}`);
     }
     if (obj.scheme != null && obj.scheme !== 'xyz' && obj.scheme !== 'tms') {
-        throw Error('spec.scheme must be "tms" or "xyz" if present');
+        throw new Error(`TileJSON validation: spec.scheme must be "tms" or "xyz" if present, but got "${obj.scheme}"`);
     }
     if (obj.template != null && typeof obj.template !== 'string') {
-        throw Error('spec.template must be a string if present');
+        throw new Error(`TileJSON validation: spec.template must be a string if present, but got ${typeof obj.template}`);
     }
     if (!Array.isArray(obj.tiles) || obj.tiles.length === 0 || obj.tiles.some((url) => typeof url !== 'string')) {
-        throw Error('spec.tiles must be an array of strings');
+        throw new Error('TileJSON validation: spec.tiles must be a non-empty array of strings');
     }
     return true;
 }
@@ -4181,8 +4249,7 @@ function guessStyle(tileJSON, options) {
         const { baseUrl } = options;
         tileJSON.tiles = tileJSON.tiles.map((url) => resolveUrl(baseUrl, url));
     }
-    if (!isTileJSONSpecification(tileJSON))
-        ;
+    if (!isTileJSONSpecification(tileJSON)) ;
     let style;
     if (isRasterTileJSONSpecification(tileJSON)) {
         style = getRasterStyle(tileJSON);
@@ -4445,7 +4512,8 @@ const styles = {
     graybeard,
     shadow,
     neutrino,
+    satellite: buildSatelliteStyle,
 };
 
-export { Color, colorful, eclipse, graybeard, guessStyle, neutrino, shadow, styles };
+export { Color, colorful, eclipse, graybeard, guessStyle, neutrino, buildSatelliteStyle as satellite, shadow, styles };
 //# sourceMappingURL=index.js.map