npm - maplibre-gl - Versions diffs - 3.0.1 → 3.2.0-pre.1 - Mend

maplibre-gl 3.0.1 → 3.2.0-pre.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (399) hide show

package/README.md +7 -7
package/build/generate-doc-images.ts +73 -0
package/build/generate-docs.ts +100 -0
package/build/generate-shaders.ts +39 -6
package/build/generate-struct-arrays.ts +9 -12
package/build/readme.md +0 -5
package/dist/maplibre-gl-csp-worker.js +1 -1
package/dist/maplibre-gl-csp-worker.js.map +1 -1
package/dist/maplibre-gl-csp.js +1 -1
package/dist/maplibre-gl-csp.js.map +1 -1
package/dist/maplibre-gl-dev.js +3368 -3420
package/dist/maplibre-gl-dev.js.map +1 -1
package/dist/maplibre-gl.d.ts +3861 -3489
package/dist/maplibre-gl.js +4 -4
package/dist/maplibre-gl.js.map +1 -1
package/package.json +44 -40
package/src/data/array_types.g.ts +14 -48
package/src/data/bucket/circle_bucket.ts +11 -14
package/src/data/bucket/fill_bucket.test.ts +6 -6
package/src/data/bucket/fill_bucket.ts +10 -12
package/src/data/bucket/fill_extrusion_bucket.ts +11 -13
package/src/data/bucket/heatmap_bucket.ts +3 -6
package/src/data/bucket/line_attributes.ts +1 -2
package/src/data/bucket/line_attributes_ext.ts +1 -2
package/src/data/bucket/line_bucket.test.ts +5 -5
package/src/data/bucket/line_bucket.ts +18 -21
package/src/data/bucket/pattern_attributes.ts +1 -3
package/src/data/bucket/pattern_bucket_features.ts +3 -3
package/src/data/bucket/symbol_bucket.test.ts +5 -5
package/src/data/bucket/symbol_bucket.ts +12 -15
package/src/data/bucket.ts +7 -11
package/src/data/dem_data.test.ts +1 -1
package/src/data/dem_data.ts +1 -1
package/src/data/evaluation_feature.ts +4 -5
package/src/data/extent.ts +1 -4
package/src/data/feature_index.ts +14 -13
package/src/data/feature_position_map.test.ts +4 -4
package/src/data/feature_position_map.ts +1 -1
package/src/data/index_array_type.ts +0 -1
package/src/data/load_geometry.test.ts +1 -1
package/src/data/load_geometry.ts +3 -4
package/src/data/program_configuration.ts +6 -11
package/src/data/segment.ts +9 -6
package/src/geo/edge_insets.test.ts +1 -1
package/src/geo/edge_insets.ts +34 -24
package/src/geo/lng_lat.test.ts +1 -1
package/src/geo/lng_lat.ts +60 -43
package/src/geo/lng_lat_bounds.test.ts +2 -2
package/src/geo/lng_lat_bounds.ts +88 -68
package/src/geo/mercator_coordinate.test.ts +2 -2
package/src/geo/mercator_coordinate.ts +33 -26
package/src/geo/transform.test.ts +3 -3
package/src/geo/transform.ts +58 -79
package/src/gl/color_mode.ts +1 -3
package/src/gl/context.ts +39 -21
package/src/gl/cull_face_mode.ts +1 -3
package/src/gl/depth_mode.ts +1 -3
package/src/gl/framebuffer.ts +5 -4
package/src/gl/index_buffer.ts +5 -4
package/src/gl/render_pool.test.ts +2 -2
package/src/gl/render_pool.ts +5 -5
package/src/gl/state.test.ts +1 -1
package/src/gl/stencil_mode.ts +1 -3
package/src/gl/types.ts +14 -14
package/src/gl/value.ts +12 -4
package/src/gl/vertex_buffer.test.ts +2 -2
package/src/gl/vertex_buffer.ts +10 -16
package/src/gl/webgl2.ts +12 -0
package/src/index.test.ts +2 -2
package/src/index.ts +121 -113
package/src/render/draw_background.ts +7 -9
package/src/render/draw_circle.ts +13 -15
package/src/render/draw_collision_debug.ts +11 -13
package/src/render/draw_custom.ts +6 -8
package/src/render/draw_debug.test.ts +4 -4
package/src/render/draw_debug.ts +8 -10
package/src/render/draw_fill.test.ts +13 -13
package/src/render/draw_fill.ts +9 -11
package/src/render/draw_fill_extrusion.ts +10 -12
package/src/render/draw_heatmap.ts +13 -14
package/src/render/draw_hillshade.ts +10 -12
package/src/render/draw_line.ts +9 -9
package/src/render/draw_raster.ts +9 -11
package/src/render/draw_symbol.test.ts +16 -16
package/src/render/draw_symbol.ts +15 -16
package/src/render/draw_terrain.ts +11 -11
package/src/render/glyph_atlas.ts +10 -1
package/src/render/glyph_manager.test.ts +3 -3
package/src/render/glyph_manager.ts +7 -7
package/src/render/image_atlas.ts +6 -3
package/src/render/image_manager.ts +3 -5
package/src/render/line_atlas.test.ts +1 -1
package/src/render/line_atlas.ts +19 -14
package/src/render/painter.ts +86 -66
package/src/render/program/background_program.ts +2 -2
package/src/render/program/circle_program.ts +5 -5
package/src/render/program/clipping_mask_program.ts +1 -1
package/src/render/program/collision_program.ts +4 -4
package/src/render/program/debug_program.ts +1 -1
package/src/render/program/fill_extrusion_program.ts +3 -3
package/src/render/program/fill_program.ts +3 -3
package/src/render/program/heatmap_program.ts +5 -5
package/src/render/program/hillshade_program.ts +7 -7
package/src/render/program/line_program.ts +6 -6
package/src/render/program/pattern.ts +3 -3
package/src/render/program/raster_program.ts +2 -2
package/src/render/program/symbol_program.ts +2 -2
package/src/render/program/terrain_program.ts +1 -1
package/src/render/program.ts +19 -20
package/src/render/render_to_texture.test.ts +15 -15
package/src/render/render_to_texture.ts +10 -10
package/src/render/terrain.test.ts +38 -7
package/src/render/terrain.ts +103 -67
package/src/render/texture.ts +9 -8
package/src/render/uniform_binding.test.ts +1 -1
package/src/render/uniform_binding.ts +8 -2
package/src/render/update_pattern_positions_in_program.ts +5 -5
package/src/render/vertex_array_object.ts +9 -8
package/src/shaders/README.md +2 -2
package/src/shaders/_prelude.fragment.glsl.g.ts +1 -1
package/src/shaders/_prelude.vertex.glsl.g.ts +1 -1
package/src/shaders/background.fragment.glsl.g.ts +1 -1
package/src/shaders/background.vertex.glsl.g.ts +1 -1
package/src/shaders/background_pattern.fragment.glsl.g.ts +1 -1
package/src/shaders/background_pattern.vertex.glsl.g.ts +1 -1
package/src/shaders/circle.fragment.glsl.g.ts +1 -1
package/src/shaders/circle.vertex.glsl.g.ts +1 -1
package/src/shaders/clipping_mask.fragment.glsl.g.ts +1 -1
package/src/shaders/clipping_mask.vertex.glsl.g.ts +1 -1
package/src/shaders/collision_box.fragment.glsl.g.ts +1 -1
package/src/shaders/collision_box.vertex.glsl.g.ts +1 -1
package/src/shaders/collision_circle.fragment.glsl.g.ts +1 -1
package/src/shaders/collision_circle.vertex.glsl.g.ts +1 -1
package/src/shaders/debug.fragment.glsl.g.ts +1 -1
package/src/shaders/debug.vertex.glsl.g.ts +1 -1
package/src/shaders/encode_attribute.ts +0 -2
package/src/shaders/fill.fragment.glsl.g.ts +1 -1
package/src/shaders/fill.vertex.glsl.g.ts +1 -1
package/src/shaders/fill_extrusion.fragment.glsl.g.ts +1 -1
package/src/shaders/fill_extrusion.vertex.glsl.g.ts +1 -1
package/src/shaders/fill_extrusion_pattern.fragment.glsl.g.ts +1 -1
package/src/shaders/fill_extrusion_pattern.vertex.glsl.g.ts +1 -1
package/src/shaders/fill_outline.fragment.glsl.g.ts +1 -1
package/src/shaders/fill_outline.vertex.glsl.g.ts +1 -1
package/src/shaders/fill_outline_pattern.fragment.glsl.g.ts +1 -1
package/src/shaders/fill_outline_pattern.vertex.glsl.g.ts +1 -1
package/src/shaders/fill_pattern.fragment.glsl.g.ts +1 -1
package/src/shaders/fill_pattern.vertex.glsl.g.ts +1 -1
package/src/shaders/heatmap.fragment.glsl.g.ts +1 -1
package/src/shaders/heatmap.vertex.glsl.g.ts +1 -1
package/src/shaders/heatmap_texture.fragment.glsl.g.ts +1 -1
package/src/shaders/heatmap_texture.vertex.glsl.g.ts +1 -1
package/src/shaders/hillshade.fragment.glsl.g.ts +1 -1
package/src/shaders/hillshade.vertex.glsl.g.ts +1 -1
package/src/shaders/hillshade_prepare.fragment.glsl.g.ts +1 -1
package/src/shaders/hillshade_prepare.vertex.glsl.g.ts +1 -1
package/src/shaders/line.fragment.glsl.g.ts +1 -1
package/src/shaders/line.vertex.glsl.g.ts +1 -1
package/src/shaders/line_gradient.fragment.glsl.g.ts +1 -1
package/src/shaders/line_gradient.vertex.glsl.g.ts +1 -1
package/src/shaders/line_pattern.fragment.glsl.g.ts +1 -1
package/src/shaders/line_pattern.vertex.glsl.g.ts +1 -1
package/src/shaders/line_sdf.fragment.glsl.g.ts +1 -1
package/src/shaders/line_sdf.vertex.glsl.g.ts +1 -1
package/src/shaders/raster.fragment.glsl.g.ts +1 -1
package/src/shaders/raster.vertex.glsl.g.ts +1 -1
package/src/shaders/shaders.ts +6 -8
package/src/shaders/symbol_icon.fragment.glsl.g.ts +1 -1
package/src/shaders/symbol_icon.vertex.glsl.g.ts +1 -1
package/src/shaders/symbol_sdf.fragment.glsl.g.ts +1 -1
package/src/shaders/symbol_sdf.vertex.glsl.g.ts +1 -1
package/src/shaders/symbol_text_and_icon.fragment.glsl.g.ts +1 -1
package/src/shaders/symbol_text_and_icon.vertex.glsl.g.ts +1 -1
package/src/shaders/terrain.fragment.glsl.g.ts +1 -1
package/src/shaders/terrain.vertex.glsl.g.ts +1 -1
package/src/shaders/terrain_coords.fragment.glsl.g.ts +1 -1
package/src/shaders/terrain_depth.fragment.glsl.g.ts +1 -1
package/src/source/canvas_source.test.ts +6 -6
package/src/source/canvas_source.ts +46 -60
package/src/source/geojson_source.test.ts +5 -5
package/src/source/geojson_source.ts +71 -55
package/src/source/geojson_source_diff.ts +39 -2
package/src/source/geojson_worker_source.test.ts +3 -3
package/src/source/geojson_worker_source.ts +20 -26
package/src/source/geojson_wrapper.test.ts +3 -3
package/src/source/geojson_wrapper.ts +2 -4
package/src/source/image_source.test.ts +9 -8
package/src/source/image_source.ts +49 -35
package/src/source/load_tilejson.ts +2 -2
package/src/source/pixels_to_tile_units.ts +2 -3
package/src/source/query_features.test.ts +3 -3
package/src/source/query_features.ts +50 -19
package/src/source/raster_dem_tile_source.test.ts +3 -3
package/src/source/raster_dem_tile_source.ts +28 -14
package/src/source/raster_dem_tile_worker_source.test.ts +2 -2
package/src/source/raster_dem_tile_worker_source.ts +3 -5
package/src/source/raster_tile_source.test.ts +3 -3
package/src/source/raster_tile_source.ts +38 -11
package/src/source/rtl_text_plugin.ts +4 -1
package/src/source/source.ts +67 -59
package/src/source/source_cache.test.ts +7 -7
package/src/source/source_cache.ts +24 -40
package/src/source/source_state.ts +2 -5
package/src/source/terrain_source_cache.test.ts +8 -8
package/src/source/terrain_source_cache.ts +42 -27
package/src/source/tile.test.ts +3 -3
package/src/source/tile.ts +32 -38
package/src/source/tile_bounds.ts +2 -4
package/src/source/tile_cache.test.ts +2 -2
package/src/source/tile_cache.ts +20 -30
package/src/source/tile_id.ts +11 -2
package/src/source/vector_tile_source.test.ts +14 -14
package/src/source/vector_tile_source.ts +32 -22
package/src/source/vector_tile_worker_source.test.ts +4 -4
package/src/source/vector_tile_worker_source.ts +12 -24
package/src/source/video_source.test.ts +5 -5
package/src/source/video_source.ts +20 -27
package/src/source/worker.ts +6 -8
package/src/source/worker_source.ts +6 -8
package/src/source/worker_tile.test.ts +5 -5
package/src/source/worker_tile.ts +13 -16
package/src/style/create_style_layer.ts +31 -26
package/src/style/evaluation_parameters.ts +5 -4
package/src/style/format_section_override.test.ts +2 -2
package/src/style/format_section_override.ts +1 -1
package/src/style/light.test.ts +2 -2
package/src/style/light.ts +3 -5
package/src/style/load_glyph_range.test.ts +1 -1
package/src/style/load_glyph_range.ts +3 -3
package/src/style/load_sprite.test.ts +1 -1
package/src/style/load_sprite.ts +3 -3
package/src/style/parse_glyph_pbf.ts +1 -1
package/src/style/pauseable_placement.ts +7 -9
package/src/style/properties.ts +4 -53
package/src/style/query_utils.ts +3 -3
package/src/style/style.test.ts +22 -19
package/src/style/style.ts +118 -84
package/src/style/style_glyph.ts +6 -0
package/src/style/style_image.ts +38 -32
package/src/style/style_layer/background_style_layer.ts +2 -4
package/src/style/style_layer/circle_style_layer.ts +7 -6
package/src/style/style_layer/custom_style_layer.ts +26 -51
package/src/style/style_layer/fill_extrusion_style_layer.ts +4 -6
package/src/style/style_layer/fill_style_layer.ts +5 -7
package/src/style/style_layer/heatmap_style_layer.ts +8 -7
package/src/style/style_layer/hillshade_style_layer.ts +2 -4
package/src/style/style_layer/line_style_layer.ts +6 -8
package/src/style/style_layer/overlap_mode.test.ts +3 -3
package/src/style/style_layer/overlap_mode.ts +3 -0
package/src/style/style_layer/raster_style_layer.ts +2 -4
package/src/style/style_layer/symbol_style_layer.ts +6 -8
package/src/style/style_layer/typed_style_layer.ts +7 -7
package/src/style/style_layer.test.ts +5 -5
package/src/style/style_layer.ts +7 -6
package/src/style/style_layer_index.test.ts +1 -1
package/src/style/style_layer_index.ts +3 -5
package/src/style/zoom_history.ts +1 -3
package/src/symbol/anchor.test.ts +1 -1
package/src/symbol/anchor.ts +1 -3
package/src/symbol/check_max_angle.test.ts +8 -2
package/src/symbol/check_max_angle.ts +10 -13
package/src/symbol/clip_line.test.ts +1 -1
package/src/symbol/clip_line.ts +6 -9
package/src/symbol/collision_feature.test.ts +2 -2
package/src/symbol/collision_feature.ts +7 -12
package/src/symbol/collision_index.test.ts +2 -2
package/src/symbol/collision_index.ts +5 -11
package/src/symbol/cross_tile_symbol_index.test.ts +2 -2
package/src/symbol/cross_tile_symbol_index.ts +5 -7
package/src/symbol/get_anchors.ts +2 -2
package/src/symbol/grid_index.test.ts +1 -1
package/src/symbol/grid_index.ts +4 -5
package/src/symbol/merge_lines.test.ts +1 -1
package/src/symbol/merge_lines.ts +1 -1
package/src/symbol/opacity_state.ts +1 -3
package/src/symbol/path_interpolator.test.ts +1 -1
package/src/symbol/path_interpolator.ts +1 -3
package/src/symbol/placement.ts +9 -9
package/src/symbol/projection.ts +61 -34
package/src/symbol/quads.ts +7 -11
package/src/symbol/shaping.ts +1 -1
package/src/symbol/symbol_layout.ts +9 -12
package/src/symbol/symbol_size.ts +1 -1
package/src/symbol/symbol_style_layer.test.ts +4 -4
package/src/symbol/transform_text.ts +2 -2
package/src/types/callback.ts +14 -14
package/src/types/cancelable.ts +3 -0
package/src/types/transferable.ts +3 -0
package/src/ui/anchor.ts +4 -0
package/src/ui/camera.test.ts +6 -6
package/src/ui/camera.ts +378 -347
package/src/ui/control/attribution_control.test.ts +1 -1
package/src/ui/control/attribution_control.ts +34 -30
package/src/ui/control/control.ts +14 -20
package/src/ui/control/fullscreen_control.test.ts +1 -1
package/src/ui/control/fullscreen_control.ts +20 -25
package/src/ui/control/geolocate_control.test.ts +5 -5
package/src/ui/control/geolocate_control.ts +180 -193
package/src/ui/control/logo_control.ts +20 -16
package/src/ui/control/navigation_control.test.ts +1 -1
package/src/ui/control/navigation_control.ts +44 -40
package/src/ui/control/scale_control.test.ts +1 -1
package/src/ui/control/scale_control.ts +30 -21
package/src/ui/control/terrain_control.test.ts +1 -1
package/src/ui/control/terrain_control.ts +15 -20
package/src/ui/default_locale.ts +1 -3
package/src/ui/events.ts +544 -1255
package/src/ui/handler/box_zoom.test.ts +2 -2
package/src/ui/handler/box_zoom.ts +16 -11
package/src/ui/handler/click_zoom.ts +11 -3
package/src/ui/handler/cooperative_gestures.test.ts +3 -3
package/src/ui/handler/dblclick_zoom.test.ts +1 -1
package/src/ui/handler/drag_handler.ts +30 -22
package/src/ui/handler/drag_move_state_manager.ts +1 -1
package/src/ui/handler/drag_pan.test.ts +2 -2
package/src/ui/handler/drag_rotate.test.ts +3 -3
package/src/ui/handler/keyboard.test.ts +2 -2
package/src/ui/handler/keyboard.ts +22 -13
package/src/ui/handler/map_event.test.ts +2 -2
package/src/ui/handler/map_event.ts +1 -1
package/src/ui/handler/mouse.ts +1 -1
package/src/ui/handler/mouse_rotate.test.ts +3 -3
package/src/ui/handler/scroll_zoom.test.ts +3 -3
package/src/ui/handler/scroll_zoom.ts +45 -52
package/src/ui/handler/shim/dblclick_zoom.ts +12 -6
package/src/ui/handler/shim/drag_pan.ts +34 -14
package/src/ui/handler/shim/drag_rotate.ts +20 -12
package/src/ui/handler/shim/two_fingers_touch.ts +24 -18
package/src/ui/handler/tap_drag_zoom.test.ts +113 -0
package/src/ui/handler/tap_drag_zoom.ts +18 -10
package/src/ui/handler/tap_recognizer.ts +1 -1
package/src/ui/handler/tap_zoom.ts +4 -3
package/src/ui/handler/touch_pan.ts +3 -2
package/src/ui/handler/transform-provider.ts +4 -6
package/src/ui/handler/two_fingers_touch.test.ts +3 -3
package/src/ui/handler/two_fingers_touch.ts +64 -47
package/src/ui/handler_inertia.ts +4 -4
package/src/ui/handler_manager.ts +86 -52
package/src/ui/hash.test.ts +1 -1
package/src/ui/hash.ts +21 -28
package/src/ui/map/isMoving.test.ts +3 -3
package/src/ui/map/isRotating.test.ts +3 -3
package/src/ui/map/isZooming.test.ts +3 -3
package/src/ui/map.test.ts +107 -7
package/src/ui/map.ts +831 -670
package/src/ui/map_events.test.ts +1 -1
package/src/ui/marker.test.ts +35 -15
package/src/ui/marker.ts +214 -135
package/src/ui/popup.test.ts +2 -2
package/src/ui/popup.ts +167 -135
package/src/util/actor.test.ts +7 -7
package/src/util/actor.ts +25 -22
package/src/util/ajax.ts +37 -17
package/src/util/browser.test.ts +1 -1
package/src/util/browser.ts +4 -8
package/src/util/classify_rings.test.ts +1 -1
package/src/util/classify_rings.ts +1 -1
package/src/util/color_ramp.ts +0 -2
package/src/util/config.ts +8 -3
package/src/util/debug.ts +0 -2
package/src/util/dictionary_coder.ts +1 -4
package/src/util/dispatcher.test.ts +3 -3
package/src/util/dispatcher.ts +4 -9
package/src/util/dom.ts +1 -1
package/src/util/evented.ts +23 -18
package/src/util/find_pole_of_inaccessibility.test.ts +1 -1
package/src/util/find_pole_of_inaccessibility.ts +4 -5
package/src/util/global_worker_pool.ts +2 -3
package/src/util/image.ts +10 -4
package/src/util/image_request.test.ts +3 -3
package/src/util/image_request.ts +15 -14
package/src/util/is_char_in_unicode_block.ts +1 -3
package/src/util/offscreen_canvas_supported.ts +1 -1
package/src/util/performance.ts +1 -2
package/src/util/request_manager.ts +4 -0
package/src/util/resolve_tokens.test.ts +1 -1
package/src/util/resolve_tokens.ts +3 -6
package/src/util/script_detection.ts +1 -4
package/src/util/smart_wrap.ts +3 -5
package/src/util/struct_array.ts +18 -14
package/src/util/style.ts +2 -2
package/src/util/task_queue.test.ts +1 -1
package/src/util/task_queue.ts +1 -3
package/src/util/test/mock_webgl.ts +10 -1
package/src/util/test/util.ts +2 -2
package/src/util/throttle.test.ts +1 -1
package/src/util/throttle.ts +1 -2
package/src/util/throttled_invoker.ts +1 -5
package/src/util/transferable_grid_index.test.ts +1 -1
package/src/util/transferable_grid_index.ts +1 -3
package/src/util/util.test.ts +1 -14
package/src/util/util.ts +44 -107
package/src/util/vectortile_to_geojson.ts +13 -3
package/src/util/verticalize_punctuation.ts +1 -1
package/src/util/web_worker.ts +2 -2
package/src/util/web_worker_transfer.ts +11 -8
package/src/util/webp_supported.ts +5 -7
package/src/util/worker_pool.test.ts +1 -1
package/src/util/worker_pool.ts +4 -5

package/README.md CHANGED Viewed

@@ -2,12 +2,12 @@
 # MapLibre GL JS
+[![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg?style=flat)](LICENSE.txt) [![Version](https://img.shields.io/npm/v/maplibre-gl?style=flat)](https://www.npmjs.com/package/maplibre-gl) [![CI](https://github.com/maplibre/maplibre-gl-js/actions/workflows/ci.yml/badge.svg)](https://github.com/maplibre/maplibre-gl-js/actions/workflows/ci.yml) [![PRs](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat)](https://opensource.org/licenses/BSD-3-Clause) [![codecov](https://codecov.io/gh/maplibre/maplibre-gl-js/branch/main/graph/badge.svg)](https://codecov.io/gh/maplibre/maplibre-gl-js)
 **[MapLibre GL JS](https://maplibre.org/maplibre-gl-js-docs/api/)** is an open-source library for publishing maps on your websites or webview based apps. Fast displaying of maps is possible thanks to GPU-accelerated vector tile rendering.
 It originated as an open-source fork of [mapbox-gl-js](https://github.com/mapbox/mapbox-gl-js), before their switch to a non-OSS license in December 2020. The library's initial versions (1.x) were intended to be a drop-in replacement for the Mapbox’s OSS version (1.x) with additional functionality, but have evolved a lot since then.
-[![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg?style=flat)](LICENSE.txt)[![Version](https://img.shields.io/npm/v/maplibre-gl?style=flat)](https://www.npmjs.com/package/maplibre-gl)[![CI](https://github.com/maplibre/maplibre-gl-js/actions/workflows/ci.yml/badge.svg)](https://github.com/maplibre/maplibre-gl-js/actions/workflows/ci.yml)[![PRs](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat)](https://opensource.org/licenses/BSD-3-Clause)
 ## Getting Started
 Include the JavaScript and CSS files in the `<head>` of your HTML file.
@@ -64,11 +64,11 @@ The overall migration happens by uninstalling `mapbox-gl` and installing `maplib
 #### Compatibility branch
-Maplibre v1 is completely backward compatible with Mapbox v1. This compatibility branch (named 1.x) is tagged v1 on npm, and its current version is 1.15.3.
+MapLibre GL JS v1 is completely backward compatible with Mapbox GL JS v1. This compatibility branch (named 1.x) is tagged v1 on npm, and its current version is 1.15.3.
 #### CDN Links
-> MapLibre GL JS is distributed via [unpkg.com](https://unpkg.com). For more information, please see [MapLibre GL is on unpkg.com](./documents_and_diagrams/README-unpkg.md#maplibre-gl-on-unpkgcom).
+> MapLibre GL JS is distributed via [unpkg.com](https://unpkg.com). For more information, please see [MapLibre GL JS is on unpkg.com](./documents_and_diagrams/README-unpkg.md#maplibre-gl-on-unpkgcom).
 ```diff
 -    <script src="https://api.mapbox.com/mapbox-gl-js/v#.#.#/mapbox-gl.js"></script>
@@ -105,10 +105,10 @@ You can find the official status of the backing community and steering committee
 ### Avoid Fragmentation
-If you depend on a free software alternative to `mapbox-gl-js`, please consider joining our effort! Anyone with a stake in a healthy community-led fork is welcome to help us figure out our next steps. We welcome contributors and leaders! MapLibre GL already represents the combined efforts of a few early fork efforts, and we all benefit from "one project" rather than "our way". If you know of other forks, please reach out to them and direct them here.
+If you depend on a free software alternative to `mapbox-gl-js`, please consider joining our effort! Anyone with a stake in a healthy community-led fork is welcome to help us figure out our next steps. We welcome contributors and leaders! MapLibre GL JS already represents the combined efforts of a few early fork efforts, and we all benefit from "one project" rather than "our way". If you know of other forks, please reach out to them and direct them here.
-> **MapLibre GL** is developed following [Semantic Versioning (2.0.0)](https://semver.org/spec/v2.0.0.html).
+> **MapLibre GL JS** is developed following [Semantic Versioning (2.0.0)](https://semver.org/spec/v2.0.0.html).
 ### Bounties
@@ -187,4 +187,4 @@ Please keep in mind: Unauthorized backports are the biggest threat to the MapLib
 ## License
-**MapLibre GL** is licensed under the [3-Clause BSD license](./LICENSE.txt).
+**MapLibre GL JS** is licensed under the [3-Clause BSD license](./LICENSE.txt).

package/build/generate-doc-images.ts ADDED Viewed

@@ -0,0 +1,73 @@
+import path from 'path';
+import fs from 'fs';
+import puppeteer from 'puppeteer';
+import packageJson from '../package.json' assert { type: 'json' };
+const exampleName = process.argv[2];
+const examplePath = path.resolve('test', 'examples');
+const browser = await puppeteer.launch({headless: exampleName === 'all'});
+const page = await browser.newPage();
+// set viewport and double deviceScaleFactor to get a closer shot of the map
+await page.setViewport({
+    width: 600,
+    height: 250,
+    deviceScaleFactor: 2
+});
+async function createImage(exampleName) {
+    // get the example contents
+    const html = fs.readFileSync(path.resolve(examplePath, `${exampleName}.html`), 'utf-8');
+    await page.setContent(html.replaceAll('../../dist', `https://unpkg.com/maplibre-gl@${packageJson.version}/dist`));
+    // Wait for map to load, then wait two more seconds for images, etc. to load.
+    await page
+        .waitForFunction('map.loaded()')
+        .then(async () => {
+            // Wait for 5 seconds on 3d model examples, since this takes longer to load.
+            const waitTime = exampleName.includes('3d-model') ? 5000 : 1500;
+            await new Promise((resolve) => {
+                console.log(`waiting for ${waitTime} ms`);
+                setTimeout(resolve, waitTime);
+            });
+        })
+        // map.loaded() does not evaluate to true within 3 seconds, it's probably an animated example.
+        // In this case we take the screenshot immediately.
+        .catch(() => {
+            console.log(`Timed out waiting for map load on ${exampleName}.`);
+        });
+    await page
+        .screenshot({
+            path: `./docs/assets/examples/${exampleName}.png`,
+            type: 'png',
+            clip: {
+                x: 0,
+                y: 0,
+                width: 600,
+                height: 250
+            }
+        })
+        .then(() => console.log(`Created ./docs/assets/examples/${exampleName}.png`))
+        .catch((err) => {
+            console.log(err);
+        });
+}
+if (exampleName === 'all') {
+    const allFiles = fs.readdirSync(examplePath).filter(f => f.endsWith('html'));
+    console.log(`Generating ${allFiles.length} images.`);
+    for (const file of allFiles) {
+        await createImage(file);
+    }
+} else if (exampleName) {
+    await createImage(exampleName);
+} else {
+    throw new Error(
+        '\n  Usage: npm run generate-images <file-name|all>\nExample: npm run generate-images 3d-buildings'
+    );
+}
+await browser.close();

package/build/generate-docs.ts ADDED Viewed

@@ -0,0 +1,100 @@
+import fs from 'fs';
+import path from 'path';
+import typedocConfig from '../typedoc.json' assert {type: 'json'};
+import packageJson from '../package.json' assert {type: 'json'};
+type HtmlDoc = {
+    title: string;
+    description: string;
+    mdFileName: string;
+}
+function generateAPIIntroMarkdown(lines: string[]): string {
+    let intro = `# Intro
+This file is intended as a reference for the important and public classes of this API.
+We reccomend looking at the [expamples](../example/index.md) as they will help you the most to start with MapLibre.
+Most of the classes wirtten here have an "Options" object for initialization, it is recommended to check which options exist.
+`;
+    intro += lines.map(l => l.replace('../', './')).join('\n');
+    return intro;
+}
+function generateMarkdownForExample(title: string, description: string, file: string, htmlContent: string): string {
+    return `
+# ${title}
+${description}
+<iframe src="../${file}" width="100%" style="border:none; height:400px"></iframe>
+\`\`\`html
+${htmlContent}
+\`\`\`
+`;
+}
+function generateMarkdownIndexFileOfAllExamples(indexArray: HtmlDoc[]): string {
+    let indexMarkdown = '# Overview \n\n';
+    for (const indexArrayItem of indexArray) {
+        indexMarkdown += `
+## [${indexArrayItem.title}](./${indexArrayItem.mdFileName})
+![${indexArrayItem.description}](../assets/examples/${indexArrayItem.mdFileName!.replace('.md', '.png')})
+${indexArrayItem.description}
+`;
+    }
+    return indexMarkdown;
+}
+if (!fs.existsSync(typedocConfig.out)) {
+    throw new Error('Please run typedoc generation first!');
+}
+fs.rmSync(path.join(typedocConfig.out, 'README.md'));
+fs.rmSync(path.join(typedocConfig.out, 'modules.md'));
+// Intro file for the API
+const modulesFolder = path.join(typedocConfig.out, 'modules');
+const content = fs.readFileSync(path.join(modulesFolder, `${typedocConfig.internalModule}.md`), 'utf-8');
+let lines = content.split('\n');
+const classesLineIndex = lines.indexOf(lines.find(l => l.endsWith('Classes')) as string);
+lines = lines.splice(2, classesLineIndex - 2);
+const contentString = generateAPIIntroMarkdown(lines);
+fs.writeFileSync(path.join(typedocConfig.out, 'README.md'), contentString);
+// Examples manupilation
+const examplesDocsFolder = path.join('docs', 'examples');
+if (fs.existsSync(examplesDocsFolder)) {
+    fs.rmSync(examplesDocsFolder, {recursive: true, force: true});
+}
+fs.mkdirSync(examplesDocsFolder);
+const examplesFolder = path.join('test', 'examples');
+const files = fs.readdirSync(examplesFolder).filter(f => f.endsWith('html'));
+const maplibreUnpgk = `https://unpkg.com/maplibre-gl@${packageJson.version}/`;
+const indexArray = [] as HtmlDoc[];
+for (const file of files) {
+    const htmlFile = path.join(examplesFolder, file);
+    let htmlContent = fs.readFileSync(htmlFile, 'utf-8');
+    htmlContent = htmlContent.replace(/\.\.\/\.\.\//g, maplibreUnpgk);
+    htmlContent = htmlContent.replace(/-dev.js/g, '.js');
+    const htmlContentLines = htmlContent.split('\n');
+    const title = htmlContentLines.find(l => l.includes('<title'))?.replace('<title>', '').replace('</title>', '').trim();
+    const description = htmlContentLines.find(l => l.includes('og:description'))?.replace(/.*content=\"(.*)\".*/, '$1');
+    fs.writeFileSync(path.join(examplesDocsFolder, file), htmlContent);
+    const mdFileName = file.replace('.html', '.md');
+    indexArray.push({
+        title: title!,
+        description: description!,
+        mdFileName
+    });
+    const exampleMarkdown = generateMarkdownForExample(title, description, file, htmlContent);
+    fs.writeFileSync(path.join(examplesDocsFolder, mdFileName), exampleMarkdown);
+}
+const indexMarkdown = generateMarkdownIndexFileOfAllExamples(indexArray);
+fs.writeFileSync(path.join(examplesDocsFolder, 'index.md'), indexMarkdown);
+console.log('Docs generation completed, to see it in action run\n docker run --rm -it -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material');

package/build/generate-shaders.ts CHANGED Viewed

@@ -12,18 +12,51 @@ console.log('Generating shaders');
  * It will also create a simple package.json file to allow importing this package in webpack
  */
-const files = globSync('./src/shaders/*.glsl');
-for (const file of files) {
+const vertex = globSync('./src/shaders/*.vertex.glsl');
+for (const file of vertex) {
     const code = fs.readFileSync(file, 'utf8');
-    const content = glslToTs(code);
+    const content = glslToTs(code, 'vertex');
     const fileName = path.join('.', 'src', 'shaders', `${file.split(path.sep).splice(-1)}.g.ts`);
     fs.writeFileSync(fileName, content);
 }
-console.log(`Finished converting ${files.length} glsl files`);
-function glslToTs(code: string): string {
+console.log(`Finished converting ${vertex.length} vertex shaders`);
+const fragment = globSync('./src/shaders/*.fragment.glsl');
+for (const file of fragment) {
+    const code = fs.readFileSync(file, 'utf8');
+    const content = glslToTs(code, 'fragment');
+    const fileName = path.join('.', 'src', 'shaders', `${file.split(path.sep).splice(-1)}.g.ts`);
+    fs.writeFileSync(fileName, content);
+}
+console.log(`Finished converting ${fragment.length} fragment shaders`);
+function glslToTs(code: string, type: 'fragment'|'vertex'): string {
+    code = code
+        .trim(); // strip whitespace at the start/end
+    // WebGL1 Compat -- Start
+    if (type === 'fragment') {
+        code = code
+            .replace(/\bin\s/g, 'varying ') // For fragment shaders, replace "in " with "varying "
+            .replace('out highp vec4 fragColor;', '');
+    }
+    if (type === 'vertex') {
+        code = code
+            .replace(/\bin\s/g, 'attribute ') // For vertex shaders, replace "in " with "attribute "
+            .replace(/\bout\s/g, 'varying '); // For vertex shaders, replace "out " with "varying "
+    }
+    code = code
+        .replace(/fragColor/g, 'gl_FragColor')
+        .replace(/texture\(/g, 'texture2D(');
+    // WebGL1 Compat -- End
     code = code
-        .trim() // strip whitespace at the start/end
         .replace(/\s*\/\/[^\n]*\n/g, '\n') // strip double-slash comments
         .replace(/\n+/g, '\n') // collapse multi line breaks
         .replace(/\n\s+/g, '\n') // strip indentation

package/build/generate-struct-arrays.ts CHANGED Viewed

@@ -19,9 +19,9 @@ import rasterBoundsAttributes from '../src/data/raster_bounds_attributes';
 import circleAttributes from '../src/data/bucket/circle_attributes';
 import fillAttributes from '../src/data/bucket/fill_attributes';
 import fillExtrusionAttributes from '../src/data/bucket/fill_extrusion_attributes';
-import lineAttributes from '../src/data/bucket/line_attributes';
-import lineAttributesExt from '../src/data/bucket/line_attributes_ext';
-import patternAttributes from '../src/data/bucket/pattern_attributes';
+import {lineLayoutAttributes} from '../src/data/bucket/line_attributes';
+import {lineLayoutAttributesExt} from '../src/data/bucket/line_attributes_ext';
+import {patternAttributes} from '../src/data/bucket/pattern_attributes';
 // symbol layer specific arrays
 import {
     symbolLayoutAttributes,
@@ -144,8 +144,8 @@ const layoutAttributes = {
     fill: fillAttributes,
     'fill-extrusion': fillExtrusionAttributes,
     heatmap: circleAttributes,
-    line: lineAttributes,
-    lineExt: lineAttributesExt,
+    line: lineLayoutAttributes,
+    lineExt: lineLayoutAttributesExt,
     pattern: patternAttributes
 };
 for (const name in layoutAttributes) {
@@ -236,7 +236,6 @@ function emitStructArrayLayout(locals) {
     output.push(
         ` *
- * @private
  */
 class ${structArrayLayoutClass} extends StructArray {`);
@@ -349,7 +348,8 @@ function emitStructArray(locals) {
     if (includeStructAccessors && !useComponentGetters) {
         output.push(
-            `class ${structTypeClass} extends Struct {
+            `/** */
+class ${structTypeClass} extends Struct {
     _structArray: ${structArrayClass};`);
         for (const {name, member, component} of components) {
@@ -384,9 +384,7 @@ export type ${structTypeClass.replace('Struct', '')} = ${structTypeClass};
     } // end 'if (includeStructAccessors)'
     output.push(
-        `/**
- * @private
- */
+        `/** */
 export class ${structArrayClass} extends ${structArrayLayoutClass} {`);
     if (useComponentGetters) {
@@ -407,8 +405,7 @@ export class ${structArrayClass} extends ${structArrayLayoutClass} {`);
         output.push(
             `    /**
      * Return the ${structTypeClass} at the given location in the array.
-     * @param {number} index The index of the element.
-     * @private
+     * @param index The index of the element.
      */
     get(index: number): ${structTypeClass} {
         return new ${structTypeClass}(this, index);

package/build/readme.md CHANGED Viewed

@@ -29,9 +29,6 @@ Rollup is generating 3 files throughout the process of bundling:
 These 3 files are then referenced and used by the `bundle_prelude.js` file. It allows loading the web wroker code automatically in web workers without any extra effort from someone who would like to use the library, i.e. it simply works.
-### check-bundle-size.js
-This file is used by CI to make sure the bundle size is kept constant
 <hr>
 ### `npm run codegen`
@@ -43,8 +40,6 @@ Generates `data/array_types.ts`, which consists of:
  - Specific named `StructArray` subclasses, when type-specific struct accessors are needed (e.g., `CollisionBoxArray`)
 #### generate-style-code.ts
 Generates the various `style/style_layer/[layer type]_style_layer_properties.ts` code files based on the content of `v8.json`. These files provide the type signatures for the paint and layout properties for each type of style layer.
-#### generate-style-spec.ts
-Generates `style-spec/types.ts` based on the content of `v8.json`. This provides the type signatures for a style specification (sources, layers, etc.).
 <hr>
 ### Generate Release Nodes