@versatiles/style 5.5.2 → 5.7.0

package/src/color/rgb.test.ts

@@ -134,94 +134,62 @@ describe('RGB Class', () => {
 			return cb(new RGB(50, 150, 200, 0.8)).round().asArray();
 		}
 
-		describe('gamma', () => {
-			test('adjusts gamma correctly', () => {
-				expect(pc(c => c.gamma(2.2))).toStrictEqual([7, 79, 149, 0.8]);
-			});
-
-			test('clamps extreme gamma values', () => {
-				expect(pc(c => c.gamma(0.001))).toStrictEqual([255, 255, 255, 0.8]);
-				expect(pc(c => c.gamma(1000))).toStrictEqual([0, 0, 0, 0.8]);
-			});
+		test('adjusts gamma correctly', () => {
+			expect(pc(c => c.gamma(2.2))).toStrictEqual([7, 79, 149, 0.8]);
+			expect(pc(c => c.gamma(0.001))).toStrictEqual([255, 255, 255, 0.8]);
+			expect(pc(c => c.gamma(1000))).toStrictEqual([0, 0, 0, 0.8]);
 		});
 
-		describe('invert', () => {
-			test('inverts RGB values correctly', () => {
-				expect(pc(c => c.invert())).toStrictEqual([205, 105, 55, 0.8]);
-			});
+		test('inverts RGB values correctly', () => {
+			expect(pc(c => c.invert())).toStrictEqual([205, 105, 55, 0.8]);
 		});
 
-		describe('contrast', () => {
-			test('adjusts contrast correctly', () => {
-				expect(pc(c => c.contrast(1.5))).toStrictEqual([11, 161, 236, 0.8]);
-			});
-
-			test('clamps extreme contrast values', () => {
-				expect(pc(c => c.contrast(1e6))).toStrictEqual([0, 255, 255, 0.8]);
-				expect(pc(c => c.contrast(0))).toStrictEqual([128, 128, 128, 0.8]);
-			});
+		test('adjusts contrast correctly', () => {
+			expect(pc(c => c.contrast(1.5))).toStrictEqual([11, 161, 236, 0.8]);
+			expect(pc(c => c.contrast(1e6))).toStrictEqual([0, 255, 255, 0.8]);
+			expect(pc(c => c.contrast(0))).toStrictEqual([128, 128, 128, 0.8]);
 		});
 
-		describe('brightness', () => {
-			test('increases brightness correctly', () => {
-				expect(pc(c => c.brightness(0.5))).toStrictEqual([153, 203, 228, 0.8]);
-			});
-
-			test('decreases brightness correctly', () => {
-				expect(pc(c => c.brightness(-0.5))).toStrictEqual([25, 75, 100, 0.8]);
-			});
-
-			test('clamps brightness values', () => {
-				expect(pc(c => c.brightness(2))).toStrictEqual([255, 255, 255, 0.8]);
-				expect(pc(c => c.brightness(-2))).toStrictEqual([0, 0, 0, 0.8]);
-			});
+		test('increases brightness correctly', () => {
+			expect(pc(c => c.brightness(0.5))).toStrictEqual([153, 203, 228, 0.8]);
+			expect(pc(c => c.brightness(-0.5))).toStrictEqual([25, 75, 100, 0.8]);
+			expect(pc(c => c.brightness(2))).toStrictEqual([255, 255, 255, 0.8]);
+			expect(pc(c => c.brightness(-2))).toStrictEqual([0, 0, 0, 0.8]);
 		});
 
-		describe('tint', () => {
-			test('tints color correctly', () => {
-				const tintColor = new RGB(255, 0, 0);
-				expect(pc(c => c.tint(0.5, tintColor))).toStrictEqual([125, 100, 125, 0.8]);
-			});
-
-			test('handles extreme tint values', () => {
-				const tintColor = new RGB(255, 0, 0);
-				expect(pc(c => c.tint(1, tintColor))).toStrictEqual([200, 50, 50, 0.8]);
-				expect(pc(c => c.tint(0, tintColor))).toStrictEqual([50, 150, 200, 0.8]);
-			});
+		test('tints color correctly', () => {
+			const tintColor = new RGB(255, 0, 0);
+			expect(pc(c => c.tint(0.5, tintColor))).toStrictEqual([125, 100, 125, 0.8]);
+			expect(pc(c => c.tint(1, tintColor))).toStrictEqual([200, 50, 50, 0.8]);
+			expect(pc(c => c.tint(0, tintColor))).toStrictEqual([50, 150, 200, 0.8]);
 		});
 
-		describe('lighten', () => {
-			test('lightens the color correctly', () => {
-				expect(pc(c => c.lighten(0.5))).toStrictEqual([153, 203, 228, 0.8]);
-			});
-
-			test('clamps lighten ratio', () => {
-				expect(pc(c => c.lighten(2))).toStrictEqual([255, 255, 255, 0.8]);
-			});
+		test('blends color correctly', () => {
+			const blendColor = new RGB(255, 0, 0);
+			expect(pc(c => c.blend(0.2, blendColor))).toStrictEqual([91, 120, 160, 0.8]);
+			expect(pc(c => c.blend(0.5, blendColor))).toStrictEqual([153, 75, 100, 0.8]);
+			expect(pc(c => c.blend(0.8, blendColor))).toStrictEqual([214, 30, 40, 0.8]);
+			expect(pc(c => c.blend(1, blendColor))).toStrictEqual([255, 0, 0, 0.8]);
+			expect(pc(c => c.blend(0, blendColor))).toStrictEqual([50, 150, 200, 0.8]);
 		});
 
-		describe('darken', () => {
-			test('darkens the color correctly', () => {
-				expect(pc(c => c.darken(0.5))).toStrictEqual([25, 75, 100, 0.8]);
-			});
-
-			test('clamps darken ratio', () => {
-				expect(pc(c => c.darken(1))).toStrictEqual([0, 0, 0, 0.8]);
-				expect(pc(c => c.darken(2))).toStrictEqual([0, 0, 0, 0.8]);
-			});
+		test('lightens the color correctly', () => {
+			expect(pc(c => c.lighten(0.5))).toStrictEqual([153, 203, 228, 0.8]);
+			expect(pc(c => c.lighten(2))).toStrictEqual([255, 255, 255, 0.8]);
 		});
 
-		describe('fade', () => {
-			test('reduces alpha correctly', () => {
-				expect(pc(c => c.fade(0.5))).toStrictEqual([50, 150, 200, 0.4]);
-			});
+		test('darkens the color correctly', () => {
+			expect(pc(c => c.darken(0.5))).toStrictEqual([25, 75, 100, 0.8]);
+			expect(pc(c => c.darken(1))).toStrictEqual([0, 0, 0, 0.8]);
+			expect(pc(c => c.darken(2))).toStrictEqual([0, 0, 0, 0.8]);
+		});
 
-			test('handles extreme fade values', () => {
-				expect(pc(c => c.fade(1))).toStrictEqual([50, 150, 200, 0]);
+		test('fades color correctly', () => {
+			expect(pc(c => c.fade(0.5))).toStrictEqual([50, 150, 200, 0.4]);
+			expect(pc(c => c.fade(1))).toStrictEqual([50, 150, 200, 0]);
 
-				const fullyOpaque = new RGB(50, 150, 200, 1);
-				expect(fullyOpaque.fade(0).asArray()).toStrictEqual([50, 150, 200, 1]);
-			});
+			const fullyOpaque = new RGB(50, 150, 200, 1);
+			expect(fullyOpaque.fade(0).asArray()).toStrictEqual([50, 150, 200, 1]);
 		});
 	});
 });

package/src/color/rgb.ts

@@ -3,12 +3,40 @@ import { HSV } from './hsv.js';
 import { Color } from './abstract.js';
 import { clamp, formatFloat } from './utils.js';
 
+/**
+ * Represents an RGB color with optional alpha transparency.
+ * 
+ * @extends Color
+ */
 export class RGB extends Color {
-	readonly r: number = 0; // between 0 and 255
-	readonly g: number = 0;	// between 0 and 255
-	readonly b: number = 0;	// between 0 and 255
-	readonly a: number = 1;	// between 0 and 1
-
+	/**
+	 * Red component (0-255).
+	 */
+	readonly r;
+
+	/**
+	 * Green component (0-255).
+	 */
+	readonly g;
+
+	/**
+	 * Blue component (0-255).
+	 */
+	readonly b;
+
+	/**
+	 * Alpha component (0-1).
+	 */
+	readonly a;
+
+	/**
+	 * Creates an instance of RGB.
+	 * 
+	 * @param r - Red component (0-255).
+	 * @param g - Green component (0-255).
+	 * @param b - Blue component (0-255).
+	 * @param a - Alpha component (0-1), defaults to 1.
+	 */
 	constructor(r: number, g: number, b: number, a: number = 1) {
 		super();
 		this.r = clamp(r, 0, 255);
@@ -17,14 +45,29 @@ export class RGB extends Color {
 		this.a = clamp(a, 0, 1);
 	}
 
+	/**
+	 * Creates a clone of the current RGB color.
+	 * 
+	 * @returns A new RGB instance with the same color values.
+	 */
 	clone(): RGB {
 		return new RGB(this.r, this.g, this.b, this.a);
 	}
 
+	/**
+	 * Returns the RGB color as an array.
+	 * 
+	 * @returns An array containing the red, green, blue, and alpha components.
+	 */
 	asArray(): [number, number, number, number] {
 		return [this.r, this.g, this.b, this.a];
 	}
 
+	/**
+	 * Rounds the RGB color components to the nearest integer.
+	 * 
+	 * @returns A new RGB instance with rounded color values.
+	 */
 	round(): RGB {
 		return new RGB(
 			Math.round(this.r),
@@ -34,6 +77,11 @@ export class RGB extends Color {
 		);
 	}
 
+	/**
+	 * Returns the RGB color as a string.
+	 * 
+	 * @returns A string representation of the RGB color in either `rgb` or `rgba` format.
+	 */
 	asString(): string {
 		if (this.a === 1) {
 			return `rgb(${this.r.toFixed(0)},${this.g.toFixed(0)},${this.b.toFixed(0)})`;
@@ -42,6 +90,11 @@ export class RGB extends Color {
 		}
 	}
 
+	/**
+	 * Returns the RGB color as a hexadecimal string.
+	 * 
+	 * @returns A string representation of the RGB color in hexadecimal format.
+	 */
 	asHex(): string {
 		const r = Math.round(this.r).toString(16).padStart(2, '0');
 		const g = Math.round(this.g).toString(16).padStart(2, '0');
@@ -55,6 +108,11 @@ export class RGB extends Color {
 		}
 	}
 
+	/**
+	 * Converts the RGB color to an HSL color.
+	 * 
+	 * @returns An HSL instance representing the same color.
+	 */
 	asHSL(): HSL {
 		const r = this.r / 255;
 		const g = this.g / 255;
@@ -82,6 +140,11 @@ export class RGB extends Color {
 		return new HSL(h, s * 100, l * 100, this.a);
 	};
 
+	/**
+	 * Converts the RGB color to an HSV color.
+	 * 
+	 * @returns An HSV instance representing the same color.
+	 */
 	asHSV(): HSV {
 		const r = this.r / 255;
 		const g = this.g / 255;
@@ -112,14 +175,31 @@ export class RGB extends Color {
 		return new HSV(h * 360, s * 100, v * 100, this.a);
 	}
 
+	/**
+	 * Returns the RGB color.
+	 * 
+	 * @returns The current RGB instance.
+	 */
 	asRGB(): RGB {
 		return this.clone();
 	}
 
+	/**
+	 * Returns the RGB color.
+	 * 
+	 * @returns The current RGB instance.
+	 */
 	toRGB(): RGB {
 		return this;
 	}
 
+	/**
+	 * Parses a string or Color instance into an RGB color.
+	 * 
+	 * @param input - The input string or Color instance to parse.
+	 * @returns A new RGB instance representing the parsed color.
+	 * @throws Will throw an error if the input string is not a valid RGB color string.
+	 */
 	static parse(input: string | Color): RGB {
 		if (input instanceof Color) return input.asRGB();
 
@@ -167,7 +247,12 @@ export class RGB extends Color {
 		throw new Error(`Invalid RGB color string: "${input}"`);
 	}
 
-
+	/**
+	 * Adjusts the gamma of the RGB color.
+	 * 
+	 * @param value - The gamma value to apply.
+	 * @returns A new RGB instance with the adjusted gamma.
+	 */
 	gamma(value: number): RGB {
 		if (value < 1e-3) value = 1e-3;
 		if (value > 1e3) value = 1e3;
@@ -179,6 +264,11 @@ export class RGB extends Color {
 		);
 	}
 
+	/**
+	 * Inverts the RGB color.
+	 * 
+	 * @returns A new RGB instance with the inverted color values.
+	 */
 	invert(): RGB {
 		return new RGB(
 			255 - this.r,
@@ -188,6 +278,12 @@ export class RGB extends Color {
 		);
 	}
 
+	/**
+	 * Adjusts the contrast of the RGB color.
+	 * 
+	 * @param value - The contrast value to apply.
+	 * @returns A new RGB instance with the adjusted contrast.
+	 */
 	contrast(value: number): RGB {
 		if (value < 0) value = 0;
 		if (value > 1e6) value = 1e6;
@@ -199,6 +295,12 @@ export class RGB extends Color {
 		);
 	}
 
+	/**
+	 * Adjusts the brightness of the RGB color.
+	 * 
+	 * @param value - The brightness value to apply.
+	 * @returns A new RGB instance with the adjusted brightness.
+	 */
 	brightness(value: number): RGB {
 		if (value < -1) value = -1;
 		if (value > 1) value = 1;
@@ -212,10 +314,17 @@ export class RGB extends Color {
 		);
 	}
 
+	/**
+	 * Tints the RGB color with another color.
+	 * 
+	 * @param value - The tint value to apply.
+	 * @param tintColor - The color to use for tinting.
+	 * @returns A new RGB instance with the applied tint.
+	 */
 	tint(value: number, tintColor: Color): RGB {
 		if (value < 0) value = 0;
 		if (value > 1) value = 1;
-		const rgbNew = this.setHue(tintColor.toHSV().h).toRGB();
+		const rgbNew = this.setHue(tintColor.asHSV().h).asRGB();
 		return new RGB(
 			this.r * (1 - value) + value * rgbNew.r,
 			this.g * (1 - value) + value * rgbNew.g,
@@ -224,6 +333,30 @@ export class RGB extends Color {
 		)
 	}
 
+	/**
+	 * Blends the RGB color with another color.
+	 * 
+	 * @param value - The blend value to apply.
+	 * @param blendColor - The color to blend with.
+	 * @returns A new RGB instance with the blended color.
+	 */
+	blend(value: number, blendColor: Color): RGB {
+		value = clamp(value ?? 0, 0, 1);
+		const rgbNew = blendColor.asRGB();
+		return new RGB(
+			this.r * (1 - value) + value * rgbNew.r,
+			this.g * (1 - value) + value * rgbNew.g,
+			this.b * (1 - value) + value * rgbNew.b,
+			this.a
+		);
+	}
+
+	/**
+	 * Lightens the RGB color.
+	 * 
+	 * @param ratio - The ratio to lighten the color by.
+	 * @returns A new RGB instance with the lightened color.
+	 */
 	lighten(ratio: number): RGB {
 		return new RGB(
 			clamp(255 - (255 - this.r) * (1 - ratio), 0, 255),
@@ -233,6 +366,12 @@ export class RGB extends Color {
 		);
 	}
 
+	/**
+	 * Darkens the RGB color.
+	 * 
+	 * @param ratio - The ratio to darken the color by.
+	 * @returns A new RGB instance with the darkened color.
+	 */
 	darken(ratio: number): RGB {
 		return new RGB(
 			clamp(this.r * (1 - ratio), 0, 255),
@@ -242,6 +381,12 @@ export class RGB extends Color {
 		);
 	}
 
+	/**
+	 * Fades the RGB color by reducing its alpha value.
+	 * 
+	 * @param value - The fade value to apply.
+	 * @returns A new RGB instance with the faded color.
+	 */
 	fade(value: number): RGB {
 		return new RGB(this.r, this.g, this.b, this.a * (1 - value));
 	}

package/src/color/utils.ts

@@ -1,11 +1,17 @@
 
 
-export function clamp(num: number, min: number, max: number): number {
-	return Math.min(Math.max(min, num), max);
+export function clamp(value: number, min: number, max: number): number {
+	if (value == null || isNaN(value)) return min;
+	if (value < min) return min;
+	if (value > max) return max;
+	return value;
 }
 
-export function mod(num: number, max: number): number {
-	return ((num % max) + max) % max;
+export function mod(value: number, max: number): number {
+	value = value % max;
+	if (value < 0) value += max;
+	if (value == 0) return 0;
+	return value;
 }
 
 export function formatFloat(num: number, precision: number): string {

package/src/guess_style/guess_style.test.ts

@@ -61,7 +61,7 @@ describe('guessStyle', () => {
 	it('should build shortbread vector styles', () => {
 		const style = guessStyle({ tiles, vector_layers: vectorLayersShortbread }, { baseUrl: 'http://example.com' });
 
-		expect(style.layers.length).toBe(297);
+		expect(style.layers.length).toBe(309);
 		style.layers = [];
 
 		expect(style).toStrictEqual({

package/src/guess_style/guess_style.ts

@@ -3,15 +3,38 @@ import { isTileJSONSpecification } from '../types/index.js';
 import { deepClone, resolveUrl } from '../lib/utils.js';
 import type { BackgroundLayerSpecification, CircleLayerSpecification, FillLayerSpecification, LineLayerSpecification, RasterSourceSpecification, SourceSpecification, SpriteSpecification, StyleSpecification, VectorSourceSpecification } from '@maplibre/maplibre-gl-style-spec';
 import { colorful } from '../styles/index.js';
-import { Color } from '../color/index.js';
 import { isRasterTileJSONSpecification } from '../types/tilejson.js';
+import randomColor from '../color/random.js';
 
+/**
+ * Options for guessing the style of a map.
+ */
 export interface GuessStyleOptions {
+	/**
+	 * Base URL to resolve URLs for tile sources, glyphs, and sprites.
+	 */
 	baseUrl?: string;
+	/**
+	 * URL template for glyphs.
+	 */
 	glyphs?: string;
+	/**
+	 * URL template for sprites. See also {@link SpriteSpecification}.
+	 */
 	sprite?: SpriteSpecification;
 }
 
+/**
+ * Generates a style specification based on the provided TileJSON specification and optional parameters.
+ *
+ * @param {TileJSONSpecification} tileJSON - The TileJSON specification to generate the style from.
+ * @param {GuessStyleOptions} [options] - Optional parameters to customize the style generation.
+ * @param {string} [options.baseUrl] - Base URL to resolve tile URLs.
+ * @param {string} [options.glyphs] - URL template for glyphs.
+ * @param {string} [options.sprite] - URL template for sprites.
+ * @returns {StyleSpecification} The generated style specification.
+ * @throws {Error} If the provided TileJSON specification is invalid.
+ */
 export function guessStyle(tileJSON: TileJSONSpecification, options?: GuessStyleOptions): StyleSpecification {
 	tileJSON = deepClone(tileJSON);
 
@@ -60,6 +83,23 @@ function getShortbreadStyle(spec: TileJSONSpecificationVector, builderOption: {
 	});
 }
 
+/**
+ * Generates a Mapbox GL style specification based on the provided TileJSON vector specification.
+ *
+ * @param {TileJSONSpecificationVector} spec - The TileJSON vector specification containing vector layers.
+ * @returns {StyleSpecification} The generated Mapbox GL style specification.
+ *
+ * This function creates a style specification with background, circle, line, and fill layers.
+ * It assigns colors to the layers based on the vector layer IDs using predefined rules for hue, luminosity, and saturation.
+ *
+ * The resulting style specification includes:
+ * - A white background layer.
+ * - Circle layers for point features.
+ * - Line layers for line features.
+ * - Fill layers for polygon features.
+ *
+ * The source for the layers is created using the `sourceFromSpec` function with the provided vector specification.
+ */
 function getInspectorStyle(spec: TileJSONSpecificationVector): StyleSpecification {
 	const sourceName = 'vectorSource';
 
@@ -88,7 +128,7 @@ function getInspectorStyle(spec: TileJSONSpecificationVector): StyleSpecificatio
 			luminosity = 'light';
 		}
 
-		const color = Color.random({
+		const color = randomColor({
 			hue,
 			luminosity,
 			saturation,

package/src/index.test.ts

@@ -3,13 +3,14 @@ import { VectorSourceSpecification } from '@maplibre/maplibre-gl-style-spec';
 import type { VectorLayer } from './index.js';
 import { guessStyle, styles } from './index.js';
 
-const { colorful, eclipse, graybeard, neutrino } = styles;
+const { colorful, eclipse, graybeard, neutrino, shadow } = styles;
 
 describe('styles', () => {
 	[
 		{ name: 'colorful', builder: colorful },
 		{ name: 'eclipse', builder: eclipse },
 		{ name: 'graybeard', builder: graybeard },
+		{ name: 'shadow', builder: shadow },
 		{ name: 'neutrino', builder: neutrino },
 	].forEach(({ name, builder }) => {
 		it(`should create and test an instance of ${name}`, () => {

package/src/index.ts

@@ -1,18 +1,103 @@
-export { colorful, eclipse, graybeard, neutrino, type StyleBuilderFunction } from './styles/index.js';
-import { colorful, eclipse, graybeard, neutrino } from './styles/index.js';
+/**
+ * This library provides everything you need to build a map style.
+ * 
+ * You can use it in the browser:
+ * ```html
+ * <html>
+ *   <head>
+ *     <script src="https://tiles.versatiles.org/assets/lib/versatiles-style/versatiles-style.js"></script>
+ *   </head>
+ *   <body>
+ *     <!-- ... -->
+ *     <script>
+ *       const style = VersatilesStyle.colorful();
+ *       // ...
+ *     </script>
+ *   </body>
+ * </html>
+ * ```
+ * 
+ * or in Node.js:
+ * ```shell
+ * npm i @versatiles/style
+ * ```
+ * ```
+ * import { colorful } from 'versatiles-style';
+ * // OR: const { colorful } = require('versatiles-style');
+ * const style = colorful();
+ * ```
+ * 
+ * You probably want to use one of the following functions:
+ * 
+ * ---
+ * 
+ * ## Generate a style for OpenStreetMap data:
+ * 
+ * To generate a style from scratch you can use on of the prepared style functions:
+ * - {@link colorful}
+ * - {@link eclipse}
+ * - {@link graybeard}
+ * - {@link neutrino}
+ * - {@link shadow}
+ * 
+ * Each function accepts optional {@link StyleBuilderOptions} as argument to customize the style.
+ * 
+ * Example:
+ * ```
+ * import { colorful } from 'versatiles-style';
+ * const style = colorful({
+ *   baseUrl: 'https://tiles.example.org',
+ *   recolor: {
+ *     blend: 0.5,
+ *     blendColor: '#FFF', // make all colors lighter
+ *   }
+ * });
+ * ```
+ * 
+ * ---
+ * 
+ * ## Guess a style based on a TileJSON:
+ * 
+ * To guess a style from a TileJSON you can use {@link guessStyle}.
+ * This function needs a {@link TileJSONSpecification} and an optional {@link GuessStyleOptions} object.
+ * Example:
+ * ```
+ * import { guessStyle } from 'versatiles-style';
+ * const style = guessStyle(tilejson);
+ * ```
+ * 
+ * ---
+ * 
+ * ## Please help us to improve this library:
+ * 
+ * This library is used in quite some projects of the VersaTiles ecosystem but it is still in an early stage.
+ * We are always looking for feedback, contributions, ideas, bug reports and help with the documentation.
+ * 
+ * If you have any suggestions, please [open an issue](https://github.com/versatiles-org/versatiles-style/issues) or a pull request on [GitHub](https://github.com/versatiles-org/versatiles-style).
+ * 
+ * If you want to know more about the VersaTiles project, please visit [versatiles.org](https://versatiles.org).
+ * 
+ * @module
+ */
+
+export { colorful, eclipse, graybeard, neutrino, shadow, type StyleBuilderFunction } from './styles/index.js';
+import { colorful, eclipse, graybeard, neutrino, shadow } from './styles/index.js';
 export const styles = {
 	colorful,
 	eclipse,
 	graybeard,
+	shadow,
 	neutrino,
 };
 
 export type { GuessStyleOptions } from './guess_style/index.js';
-export type { RGB, HSL, HSV, RandomColorOptions } from './color/index.js';
+export type { RGB, HSL, HSV } from './color/index.js';
 export type { TileJSONSpecification, TileJSONSpecificationRaster, TileJSONSpecificationVector } from './types/tilejson.js';
 export type { VectorLayer } from './types/index.js';
-export type { StyleBuilderOptions, Language, StyleBuilderColors, StyleBuilderColorsEnsured, StyleBuilderFonts } from './style_builder/types.js';
+export type { StyleBuilderOptions, Language, StyleBuilderColors, StyleBuilderColorKey, StyleBuilderFonts } from './style_builder/types.js';
 export type { RecolorOptions } from './style_builder/recolor.js';
 
 export { guessStyle } from './guess_style/index.js';
 export { Color } from './color/index.js';
+
+export type { SpriteSpecification } from '@maplibre/maplibre-gl-style-spec';