{"version":3,"file":"app.mjs","sources":["../../../packages/british-isles-gridrefs/src/constants.js","../../../packages/british-isles-gridrefs/src/LatLng/LatLng.js","../../../packages/british-isles-gridrefs/src/LatLng/LatLngWGS84.js","../../../packages/british-isles-gridrefs/src/LatLng/LatLngGB.js","../../../packages/british-isles-gridrefs/src/LatLng/LatLngIE.js","../../../packages/british-isles-gridrefs/src/LatLng/LatLngCI.js","../../../packages/british-isles-gridrefs/src/GridCoords/GridCoords.js","../../../packages/british-isles-gridrefs/src/GridRef/GridRef.js","../../../packages/british-isles-gridrefs/src/GridRef/GridRefCI.js","../../../packages/british-isles-gridrefs/src/GridRef/GridRefGB.js","../../../packages/british-isles-gridrefs/src/GridRef/GridRefIE.js","../../../packages/british-isles-gridrefs/src/GridRef/parser.js","../../../packages/bsbi-app-framework/src/utils/LogBuffer.js","../../../packages/bsbi-app-framework/src/utils/Logger.js","../../../packages/bsbi-app-framework/src/framework/EventHarness.js","../../../packages/bsbi-app-framework/src/framework/AppEvents.js","../../../packages/bsbi-app-framework/src/controllers/AppController.js","../../../packages/bsbi-app-framework/src/controllers/StaticContentController.js","../../../packages/bsbi-app-framework/src/utils/exceptions/NotFoundError.js","../../../node_modules/localforage/dist/localforage.js","../../../packages/bsbi-app-framework/src/utils/constants.js","../../../packages/bsbi-app-framework/src/serviceworker/responses/ResponseFactory.js","../../../packages/bsbi-app-framework/src/utils/syncBatching.js","../../../packages/bsbi-app-framework/src/models/Model.js","../../../packages/bsbi-app-framework/src/utils/escapeHTML.js","../../../packages/bsbi-app-framework/src/utils/DeviceType.js","../../../packages/bsbi-app-framework/src/models/Track.js","../../../packages/bsbi-app-framework/src/models/Survey.js","../../../packages/bsbi-app-framework/src/utils/exceptions/InternalAppError.js","../../../packages/bsbi-app-framework/src/utils/exceptions/TaxonError.js","../../../packages/bsbi-app-framework/src/models/Taxon.js","../../../packages/bsbi-app-framework/src/models/Occurrence.js","../../../packages/bsbi-app-framework/src/utils/forageDriver.js","../../../packages/bsbi-app-framework/src/framework/ImageFileStore.js","../../../packages/bsbi-app-framework/src/models/OccurrenceImage.js","../../../packages/bsbi-app-framework/src/utils/schedulerYield.js","../../../packages/bsbi-app-framework/src/models/SurveyDefinition.js","../../../packages/bsbi-app-framework/src/serviceworker/responses/LocalResponse.js","../../../packages/bsbi-app-framework/src/serviceworker/responses/ImageResponse.js","../../../packages/bsbi-app-framework/src/serviceworker/responses/SurveyResponse.js","../../../packages/bsbi-app-framework/src/serviceworker/responses/OccurrenceResponse.js","../../../packages/bsbi-app-framework/src/framework/App.js","../../../packages/bsbi-app-framework/src/controllers/SurveyPickerController.js","../../../packages/bsbi-app-framework/src/serviceworker/responses/TrackResponse.js","../../../packages/bsbi-app-framework/src/serviceworker/responses/SurveyDefinitionResponse.js","../../../packages/bsbi-app-framework/src/models/Party.js","../../../packages/bsbi-app-framework/src/utils/formattedImplode.js","../../../node_modules/navigo/src/index.js","../../../node_modules/bootstrap/js/src/dom/data.js","../../../node_modules/bootstrap/js/src/util/index.js","../../../node_modules/bootstrap/js/src/dom/event-handler.js","../../../node_modules/bootstrap/js/src/dom/manipulator.js","../../../node_modules/bootstrap/js/src/util/config.js","../../../node_modules/bootstrap/js/src/base-component.js","../../../node_modules/bootstrap/js/src/dom/selector-engine.js","../../../node_modules/bootstrap/js/src/tab.js","../../../node_modules/bootstrap/js/src/util/backdrop.js","../../../node_modules/bootstrap/js/src/util/component-functions.js","../../../node_modules/bootstrap/js/src/util/focustrap.js","../../../node_modules/bootstrap/js/src/util/scrollbar.js","../../../node_modules/bootstrap/js/src/modal.js","../../../node_modules/mapbox-gl/node_modules/gl-matrix/esm/common.js","../../../node_modules/mapbox-gl/node_modules/gl-matrix/esm/mat2.js","../../../node_modules/mapbox-gl/node_modules/gl-matrix/esm/mat3.js","../../../node_modules/mapbox-gl/node_modules/gl-matrix/esm/mat4.js","../../../node_modules/mapbox-gl/node_modules/gl-matrix/esm/vec3.js","../../../node_modules/mapbox-gl/node_modules/gl-matrix/esm/vec4.js","../../../node_modules/mapbox-gl/node_modules/gl-matrix/esm/quat.js","../../../node_modules/mapbox-gl/node_modules/gl-matrix/esm/vec2.js","../../../node_modules/mapbox-gl/node_modules/@mapbox/unitbezier/index.js","../../../node_modules/mapbox-gl/node_modules/@mapbox/point-geometry/index.js","../../../node_modules/mapbox-gl/src/style-spec/util/deep_equal.ts","../../../node_modules/mapbox-gl/node_modules/quickselect/index.js","../../../node_modules/mapbox-gl/src/style-spec/util/geometry_util.ts","../../../node_modules/mapbox-gl/src/util/util.ts","../../../node_modules/mapbox-gl/src/util/offscreen_canvas_supported.ts","../../../node_modules/mapbox-gl/src/util/browser.ts","../../../node_modules/mapbox-gl/src/util/is_wasm_simd_supported.ts","../../../node_modules/mapbox-gl/src/util/config.ts","../../../node_modules/mapbox-gl/src/util/webp_supported.ts","../../../node_modules/mapbox-gl/src/util/url.ts","../../../node_modules/mapbox-gl/src/util/tile_request_cache.ts","../../../node_modules/mapbox-gl/src/util/mapbox_url.ts","../../../node_modules/mapbox-gl/src/util/ajax.ts","../../../node_modules/mapbox-gl/src/util/murmur3.ts","../../../node_modules/mapbox-gl/src/util/evented.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/types/image_id.ts","../../../node_modules/mapbox-gl/node_modules/csscolorparser/csscolorparser.js","../../../node_modules/mapbox-gl/src/style-spec/util/lerp.ts","../../../node_modules/mapbox-gl/src/style-spec/util/color.ts","../../../node_modules/mapbox-gl/src/style-spec/util/interpolate.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/parsing_error.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/scope.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/types.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/types/collator.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/types/formatted.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/types/image_variant.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/types/resolved_image.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/values.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/literal.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/runtime_error.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/assertion.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/format.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/image.ts","../../../node_modules/mapbox-gl/src/style-spec/util/get_type.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/coercion.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/evaluation_context.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/compound_expression.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/collator.ts","../../../node_modules/mapbox-gl/src/style-spec/util/mercator.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/within.ts","../../../node_modules/mapbox-gl/node_modules/tinyqueue/index.js","../../../node_modules/mapbox-gl/src/style-spec/data/extent.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/distance.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/is_constant.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/config.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/var.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/parsing_context.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/stops.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/step.ts","../../../node_modules/mapbox-gl/src/style-spec/util/color_spaces.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/interpolate.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/coalesce.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/let.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/at.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/at_interpolated.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/in.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/index_of.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/match.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/case.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/slice.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/split.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/comparison.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/number_format.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/length.ts","../../../node_modules/mapbox-gl/src/style-spec/util/random.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/definitions/index.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/expression_dependencies.ts","../../../node_modules/mapbox-gl/src/style-spec/util/result.ts","../../../node_modules/mapbox-gl/src/style-spec/util/properties.ts","../../../node_modules/mapbox-gl/src/style-spec/function/index.ts","../../../node_modules/mapbox-gl/src/style-spec/expression/index.ts","../../../node_modules/mapbox-gl/src/symbol/grid_index.ts","../../../node_modules/mapbox-gl/src/util/web_worker_transfer.ts","../../../node_modules/mapbox-gl/src/util/is_char_in_unicode_block.ts","../../../node_modules/mapbox-gl/src/util/script_detection.ts","../../../node_modules/mapbox-gl/src/source/rtl_text_plugin.ts","../../../node_modules/mapbox-gl/src/style/evaluation_parameters.ts","../../../node_modules/mapbox-gl/src/style/properties.ts","../../../node_modules/mapbox-gl/src/style-spec/reference/v8.json","../../../node_modules/mapbox-gl/src/style-spec/util/unbundle_jsonlint.ts","../../../node_modules/mapbox-gl/src/style-spec/feature_filter/index.ts","../../../node_modules/mapbox-gl/src/util/fqid.ts","../../../node_modules/mapbox-gl/src/style/appearance_properties.ts","../../../node_modules/mapbox-gl/src/style/appearance.ts","../../../node_modules/mapbox-gl/src/style/style_layer.ts","../../../node_modules/mapbox-gl/node_modules/earcut/src/earcut.js","../../../node_modules/mapbox-gl/src/data/bucket/pattern_bucket_features.ts","../../../node_modules/mapbox-gl/src/geo/projection/globe_constants.ts","../../../node_modules/mapbox-gl/src/geo/lng_lat.ts","../../../node_modules/mapbox-gl/src/geo/mercator_coordinate.ts","../../../node_modules/mapbox-gl/src/geo/projection/resample.ts","../../../node_modules/mapbox-gl/src/data/load_geometry.ts","../../../node_modules/mapbox-gl/src/data/evaluation_feature.ts","../../../node_modules/mapbox-gl/src/util/struct_array.ts","../../../node_modules/mapbox-gl/src/data/array_types.ts","../../../node_modules/mapbox-gl/src/data/bucket/fill_attributes.ts","../../../node_modules/mapbox-gl/src/data/segment.ts","../../../node_modules/mapbox-gl/src/shaders/encode_attribute.ts","../../../node_modules/mapbox-gl/src/data/bucket/pattern_attributes.ts","../../../node_modules/mapbox-gl/src/data/bucket/dash_attributes.ts","../../../node_modules/mapbox-gl/src/data/feature_position_map.ts","../../../node_modules/mapbox-gl/src/render/uniform_binding.ts","../../../node_modules/mapbox-gl/src/data/program_configuration.ts","../../../node_modules/mapbox-gl/src/data/bucket/fill_buffer_data.ts","../../../node_modules/mapbox-gl/src/data/bucket/fill_bucket.ts","../../../node_modules/mapbox-gl/src/data/bucket/line_attributes.ts","../../../node_modules/mapbox-gl/src/data/bucket/line_attributes_ext.ts","../../../node_modules/mapbox-gl/src/data/bucket/line_attributes_pattern.ts","../../../node_modules/mapbox-gl/node_modules/@mapbox/vector-tile/index.js","../../../node_modules/mapbox-gl/src/util/intersection_tests.ts","../../../node_modules/mapbox-gl/src/util/line_clipping.ts","../../../node_modules/mapbox-gl/src/util/image.ts","../../../node_modules/mapbox-gl/src/render/line_atlas.ts","../../../node_modules/mapbox-gl/3d-style/elevation/elevation_constants.ts","../../../node_modules/mapbox-gl/src/data/bucket/line_bucket.ts","../../../node_modules/mapbox-gl/src/data/bucket/circle_attributes.ts","../../../node_modules/mapbox-gl/src/data/bucket/circle_bucket.ts","../../../node_modules/mapbox-gl/src/data/bucket/symbol_attributes.ts","../../../node_modules/mapbox-gl/src/data/bucket/symbol_properties_ubo.ts","../../../node_modules/mapbox-gl/src/data/bucket/symbol_property_binder_ubo.ts","../../../node_modules/mapbox-gl/src/symbol/one_em.ts","../../../node_modules/mapbox-gl/src/symbol/transform_text.ts","../../../node_modules/mapbox-gl/src/util/verticalize_punctuation.ts","../../../node_modules/mapbox-gl/node_modules/pbf/index.js","../../../node_modules/mapbox-gl/src/style/parse_glyph_pbf.ts","../../../node_modules/mapbox-gl/src/symbol/shaping.ts","../../../node_modules/mapbox-gl/src/symbol/symbol_size.ts","../../../node_modules/mapbox-gl/src/symbol/anchor.ts","../../../node_modules/mapbox-gl/src/symbol/check_max_angle.ts","../../../node_modules/mapbox-gl/src/symbol/get_anchors.ts","../../../node_modules/mapbox-gl/node_modules/potpack/index.js","../../../node_modules/mapbox-gl/src/render/atlas_content_descriptor.ts","../../../node_modules/mapbox-gl/src/render/texture.ts","../../../node_modules/mapbox-gl/src/render/image_atlas.ts","../../../node_modules/mapbox-gl/src/style/glyph_loader.ts","../../../node_modules/mapbox-gl/src/style/load_glyph_range.ts","../../../node_modules/mapbox-gl/node_modules/@mapbox/tiny-sdf/index.js","../../../node_modules/mapbox-gl/src/render/glyph_manager.ts","../../../node_modules/mapbox-gl/src/symbol/quads.ts","../../../node_modules/mapbox-gl/src/util/find_pole_of_inaccessibility.ts","../../../node_modules/mapbox-gl/src/util/object.ts","../../../node_modules/mapbox-gl/src/symbol/symbol_layout.ts","../../../node_modules/mapbox-gl/src/terrain/globe_attributes.ts","../../../node_modules/mapbox-gl/src/data/pos_attributes.ts","../../../node_modules/mapbox-gl/src/util/primitives.ts","../../../node_modules/mapbox-gl/src/geo/projection/globe_util.ts","../../../node_modules/mapbox-gl/src/geo/projection/far_z.ts","../../../node_modules/mapbox-gl/src/source/tile_id.ts","../../../node_modules/mapbox-gl/src/geo/projection/tile_transform.ts","../../../node_modules/mapbox-gl/src/geo/projection/projection.ts","../../../node_modules/mapbox-gl/src/geo/projection/albers.ts","../../../node_modules/mapbox-gl/src/geo/projection/equal_earth.ts","../../../node_modules/mapbox-gl/src/geo/projection/equirectangular.ts","../../../node_modules/mapbox-gl/src/geo/projection/lambert.ts","../../../node_modules/mapbox-gl/src/geo/projection/mercator.ts","../../../node_modules/mapbox-gl/src/geo/projection/natural_earth.ts","../../../node_modules/mapbox-gl/src/geo/projection/winkel_tripel.ts","../../../node_modules/mapbox-gl/src/geo/projection/cylindrical_equal_area.ts","../../../node_modules/mapbox-gl/src/geo/projection/globe.ts","../../../node_modules/mapbox-gl/src/geo/projection/index.ts","../../../node_modules/mapbox-gl/3d-style/source/replacement_source.ts","../../../node_modules/mapbox-gl/src/data/bucket/feature_appearances.ts","../../../node_modules/mapbox-gl/src/data/bucket/symbol_bucket.ts","../../../node_modules/mapbox-gl/src/symbol/mergelines.ts","../../../node_modules/mapbox-gl/3d-style/data/bucket/elevated_fill_buffer_data.ts","../../../node_modules/mapbox-gl/3d-style/elevation/elevation_graph.ts","../../../node_modules/mapbox-gl/3d-style/elevation/elevated_structures.ts","../../../node_modules/mapbox-gl/3d-style/elevation/elevation_feature_parser.ts","../../../node_modules/mapbox-gl/3d-style/elevation/elevation_feature.ts","../../../node_modules/mapbox-gl/3d-style/elevation/get_elevation_feature.ts","../../../node_modules/mapbox-gl/node_modules/splaytree/index.js","../../../node_modules/mapbox-gl/node_modules/robust-predicates/esm/util.js","../../../node_modules/mapbox-gl/node_modules/robust-predicates/esm/orient2d.js","../../../node_modules/mapbox-gl/node_modules/martinez-polygon-clipping/dist/martinez.js","../../../node_modules/mapbox-gl/3d-style/util/polygon_clipping_hd.ts","../../../node_modules/mapbox-gl/3d-style/data/frc_segment_builder.ts","../../../node_modules/mapbox-gl/3d-style/data/frc_road_classes.ts","../../../node_modules/mapbox-gl/3d-style/data/bucket/fill_hd_extension.ts","../../../node_modules/mapbox-gl/3d-style/data/bucket/line_hd_extension.ts","../../../node_modules/mapbox-gl/3d-style/data/bucket/circle_hd_extension.ts","../../../node_modules/mapbox-gl/3d-style/data/bucket/symbol_hd_extension.ts","../../../node_modules/mapbox-gl/3d-style/util/loaders.ts","../../../node_modules/mapbox-gl/3d-style/util/draco_decoder_gltf.ts","../../../node_modules/mapbox-gl/3d-style/util/meshopt_decoder.ts","../../../node_modules/mapbox-gl/src/util/triangle_grid_index.ts","../../../node_modules/mapbox-gl/3d-style/data/model_attributes.ts","../../../node_modules/mapbox-gl/src/geo/projection/adjustments.ts","../../../node_modules/mapbox-gl/3d-style/util/model_util.ts","../../../node_modules/mapbox-gl/3d-style/data/model.ts","../../../node_modules/mapbox-gl/3d-style/source/model_bvh.ts","../../../node_modules/mapbox-gl/3d-style/source/model_loader.ts","../../../node_modules/mapbox-gl/3d-style/data/building_attributes.ts","../../../node_modules/mapbox-gl/src/data/bucket/fill_extrusion_attributes.ts","../../../node_modules/mapbox-gl/src/util/polygon_clipping.ts","../../../node_modules/mapbox-gl/3d-style/util/conflation.ts","../../../node_modules/mapbox-gl/src/geo/line_geometry.ts","../../../node_modules/mapbox-gl/src/data/bucket/fill_extrusion_bucket.ts","../../../node_modules/mapbox-gl/3d-style/util/building_gen.ts","../../../node_modules/mapbox-gl/3d-style/data/bucket/building_bucket_flags.ts","../../../node_modules/mapbox-gl/3d-style/data/bucket/building_bucket.ts","../../../node_modules/mapbox-gl/src/style/style_layer/circle_style_layer_properties.ts","../../../node_modules/mapbox-gl/src/source/frc_coverage_snapshot.ts","../../../node_modules/mapbox-gl/modules/hd_worker.ts","../../../node_modules/mapbox-gl/src/style/query_utils.ts","../../../node_modules/mapbox-gl/src/render/program/circle_program.ts","../../../node_modules/mapbox-gl/src/style/style_layer/circle_style_layer.ts","../../../node_modules/mapbox-gl/src/data/bucket/heatmap_bucket.ts","../../../node_modules/mapbox-gl/src/style/style_layer/heatmap_style_layer_properties.ts","../../../node_modules/mapbox-gl/src/style/style_layer/hillshade_style_layer_properties.ts","../../../node_modules/mapbox-gl/src/style/style_layer/fill_style_layer_properties.ts","../../../node_modules/mapbox-gl/src/style/style_layer/clip_style_layer_properties.ts","../../../node_modules/mapbox-gl/src/style/style_layer/fill_extrusion_style_layer_properties.ts","../../../node_modules/mapbox-gl/3d-style/style/style_layer/building_style_layer_properties.ts","../../../node_modules/mapbox-gl/src/style/style_layer/line_style_layer_properties.ts","../../../node_modules/mapbox-gl/src/util/color_ramp.ts","../../../node_modules/mapbox-gl/src/data/bucket/clip_bucket.ts","../../../node_modules/mapbox-gl/src/style/style_layer/fill_extrusion_style_layer.ts","../../../node_modules/mapbox-gl/src/source/pixels_to_tile_units.ts","../../../node_modules/mapbox-gl/src/render/program/line_program.ts","../../../node_modules/mapbox-gl/src/style/style_layer/line_style_layer.ts","../../../node_modules/mapbox-gl/src/style/style_layer/symbol_style_layer_properties.ts","../../../node_modules/mapbox-gl/src/style/style_layer/symbol_style_layer.ts","../../../node_modules/mapbox-gl/src/util/resolve_tokens.ts","../../../node_modules/mapbox-gl/src/style/format_section_override.ts","../../../node_modules/mapbox-gl/src/style/style_layer/background_style_layer_properties.ts","../../../node_modules/mapbox-gl/src/style/style_layer/raster_style_layer_properties.ts","../../../node_modules/mapbox-gl/src/style/style_layer/raster_style_layer.ts","../../../node_modules/mapbox-gl/src/style/style_layer/raster_particle_style_layer_properties.ts","../../../node_modules/mapbox-gl/src/style/style_layer/sky_style_layer_properties.ts","../../../node_modules/mapbox-gl/src/style/style_layer/slot_style_layer_properties.ts","../../../node_modules/mapbox-gl/3d-style/style/style_layer/model_style_layer_properties.ts","../../../node_modules/mapbox-gl/src/style/style_layer/raster_particle_style_layer.ts","../../../node_modules/mapbox-gl/src/style/style_layer/custom_style_layer.ts","../../../node_modules/mapbox-gl/src/style/style_layer/sky_style_layer.ts","../../../node_modules/mapbox-gl/3d-style/data/bucket/model_bucket.ts","../../../node_modules/mapbox-gl/src/terrain/elevation.ts","../../../node_modules/mapbox-gl/3d-style/data/bucket/tiled_3d_model_bucket.ts","../../../node_modules/mapbox-gl/src/util/vectortile_to_geojson.ts","../../../node_modules/mapbox-gl/3d-style/source/model_source.ts","../../../node_modules/mapbox-gl/3d-style/style/style_layer/model_style_layer.ts","../../../node_modules/mapbox-gl/src/style/create_style_layer.ts","../../../node_modules/mapbox-gl/src/style/style_layer/heatmap_style_layer.ts","../../../node_modules/mapbox-gl/src/style/style_layer/hillshade_style_layer.ts","../../../node_modules/mapbox-gl/src/style/style_layer/fill_style_layer.ts","../../../node_modules/mapbox-gl/3d-style/style/style_layer/building_style_layer.ts","../../../node_modules/mapbox-gl/src/style/style_layer/background_style_layer.ts","../../../node_modules/mapbox-gl/src/style/style_layer/slot_style_layer.ts","../../../node_modules/mapbox-gl/modules/standard_worker.ts","../../../node_modules/mapbox-gl/src/style/style_layer/clip_style_layer.ts","../../../node_modules/mapbox-gl/src/util/lru.ts","../../../node_modules/mapbox-gl/src/util/throttled_invoker.ts","../../../node_modules/mapbox-gl/src/source/render_source_type.ts","../../../node_modules/mapbox-gl/src/util/scheduler.ts","../../../node_modules/mapbox-gl/src/util/actor.ts","../../../node_modules/mapbox-gl/src/util/dictionary_coder.ts","../../../node_modules/mapbox-gl/src/data/feature_index.ts","../../../node_modules/mapbox-gl/src/data/mrt/mrt.esm.js","../../../node_modules/mapbox-gl/src/source/load_tilejson.ts","../../../node_modules/mapbox-gl/src/data/mrt_data.ts","../../../node_modules/mapbox-gl/src/source/tile_provider.ts","../../../node_modules/mapbox-gl/src/data/dem_tree.ts","../../../node_modules/mapbox-gl/src/data/dem_data.ts","../../../node_modules/mapbox-gl/node_modules/kdbush/index.js","../../../node_modules/mapbox-gl/3d-style/style/indoor_active_floor_strategy.ts","../../../node_modules/mapbox-gl/src/source/load_vector_tile.ts","../../../node_modules/mapbox-gl/src/style-spec/util/ref_properties.ts","../../../node_modules/mapbox-gl/src/util/performance.ts","../../../node_modules/mapbox-gl/3d-style/elevation/parse_elevation_features.ts","../../../node_modules/mapbox-gl/3d-style/elevation/evaluate_portal_graphs.ts","../../../node_modules/mapbox-gl/3d-style/source/frc_coverage_parser.ts","../../../node_modules/mapbox-gl/3d-style/symbol/frc_symbol_filter.ts","../../../node_modules/mapbox-gl/3d-style/source/indoor_parser.ts","../../../node_modules/mapbox-gl/modules/hd_worker_imports.ts","../../../node_modules/mapbox-gl/src/style-spec/group_by_layout.ts","../../../node_modules/mapbox-gl/src/style/style_layer_index.ts","../../../node_modules/mapbox-gl/src/render/glyph_atlas.ts","../../../node_modules/mapbox-gl/src/source/worker_tile.ts","../../../node_modules/mapbox-gl/src/source/vector_tile_worker_source.ts","../../../node_modules/mapbox-gl/src/source/raster_dem_tile_worker_source.ts","../../../node_modules/mapbox-gl/src/source/raster_array_tile_worker_source.ts","../../../node_modules/mapbox-gl/src/source/geojson_wrapper.ts","../../../node_modules/mapbox-gl/src/source/geojson_rt.ts","../../../node_modules/mapbox-gl/src/source/vector_tile_to_pbf.ts","../../../node_modules/mapbox-gl/node_modules/supercluster/index.js","../../../node_modules/mapbox-gl/node_modules/geojson-vt/src/simplify.js","../../../node_modules/mapbox-gl/node_modules/geojson-vt/src/feature.js","../../../node_modules/mapbox-gl/node_modules/geojson-vt/src/convert.js","../../../node_modules/mapbox-gl/node_modules/geojson-vt/src/clip.js","../../../node_modules/mapbox-gl/node_modules/geojson-vt/src/wrap.js","../../../node_modules/mapbox-gl/node_modules/geojson-vt/src/transform.js","../../../node_modules/mapbox-gl/node_modules/geojson-vt/src/tile.js","../../../node_modules/mapbox-gl/node_modules/geojson-vt/src/index.js","../../../node_modules/mapbox-gl/src/source/geojson_worker_source.ts","../../../node_modules/mapbox-gl/3d-style/source/tiled_3d_model_worker_source.ts","../../../node_modules/mapbox-gl/src/source/worker.ts","../../../node_modules/mapbox-gl/node_modules/@mapbox/mapbox-gl-supported/index.js","../../../node_modules/mapbox-gl/src/util/dom.ts","../../../node_modules/mapbox-gl/src/util/sku_token.ts","../../../node_modules/mapbox-gl/src/util/live_performance.ts","../../../node_modules/mapbox-gl/src/util/mapbox.ts","../../../node_modules/mapbox-gl/src/style/style_changes.ts","../../../node_modules/mapbox-gl/src/style/layer_expression_dependencies.ts","../../../node_modules/mapbox-gl/src/style/style_image.ts","../../../node_modules/mapbox-gl/src/data/usvg/usvg_pb_decoder.ts","../../../node_modules/mapbox-gl/src/data/usvg/usvg_pb_renderer.ts","../../../node_modules/mapbox-gl/src/render/image_rasterizer.ts","../../../node_modules/mapbox-gl/src/render/image_manager.ts","../../../node_modules/mapbox-gl/src/style-spec/error/validation_error.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_array.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_number.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_function.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_expression.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_enum.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_filter.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_property.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_paint_property.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_layout_property.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_layer.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_appearance.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_string.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_source.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_model.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_light.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_lights.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_terrain.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_fog.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_boolean.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_color.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_formatted.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_image.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_projection.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_import.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_iconset.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_option.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_object.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_glyphs_url.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_style.ts","../../../node_modules/mapbox-gl/src/style-spec/validate_style.min.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_snow.ts","../../../node_modules/mapbox-gl/src/style-spec/validate/validate_rain.ts","../../../node_modules/mapbox-gl/src/style/validate_style.ts","../../../node_modules/mapbox-gl/src/style/light.ts","../../../node_modules/mapbox-gl/src/style/terrain.ts","../../../node_modules/mapbox-gl/src/style/fog_helpers.ts","../../../node_modules/mapbox-gl/src/style/fog.ts","../../../node_modules/mapbox-gl/3d-style/style/snow_properties.ts","../../../node_modules/mapbox-gl/3d-style/style/rain_properties.ts","../../../node_modules/mapbox-gl/src/style/snow.ts","../../../node_modules/mapbox-gl/src/style/rain.ts","../../../node_modules/mapbox-gl/src/util/worker_class.ts","../../../node_modules/mapbox-gl/src/util/web_worker.ts","../../../node_modules/mapbox-gl/src/util/worker_pool.ts","../../../node_modules/mapbox-gl/src/util/dispatcher.ts","../../../node_modules/mapbox-gl/3d-style/style/lights.ts","../../../node_modules/mapbox-gl/3d-style/style/ambient_light_properties.ts","../../../node_modules/mapbox-gl/3d-style/style/directional_light_properties.ts","../../../node_modules/mapbox-gl/3d-style/render/program/building_program.ts","../../../node_modules/mapbox-gl/src/gl/cull_face_mode.ts","../../../node_modules/mapbox-gl/src/gl/depth_mode.ts","../../../node_modules/mapbox-gl/src/geo/edge_insets.ts","../../../node_modules/mapbox-gl/src/ui/free_camera.ts","../../../node_modules/mapbox-gl/src/symbol/projection.ts","../../../node_modules/mapbox-gl/src/geo/transform.ts","../../../node_modules/mapbox-gl/src/render/cutoff.ts","../../../node_modules/mapbox-gl/src/gl/stencil_mode.ts","../../../node_modules/mapbox-gl/3d-style/render/draw_ground_effect.ts","../../../node_modules/mapbox-gl/src/gl/color_mode.ts","../../../node_modules/mapbox-gl/src/render/program/pattern.ts","../../../node_modules/mapbox-gl/src/render/program/fill_extrusion_program.ts","../../../node_modules/mapbox-gl/3d-style/render/shadow_utils.ts","../../../node_modules/mapbox-gl/3d-style/render/texture_slots.ts","../../../node_modules/mapbox-gl/3d-style/render/program/model_program.ts","../../../node_modules/mapbox-gl/src/render/program/debug_program.ts","../../../node_modules/mapbox-gl/3d-style/render/draw_model.ts","../../../node_modules/mapbox-gl/src/shaders/_prelude.glsl","../../../node_modules/mapbox-gl/src/shaders/_prelude.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/_prelude.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/skybox.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/_prelude_terrain.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/_prelude_fog.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/_prelude_fog.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/_prelude_lighting.glsl","../../../node_modules/mapbox-gl/src/shaders/_prelude_raster_array.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/_prelude_shadow.vertex.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/_prelude_shadow.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/shaders.ts","../../../node_modules/mapbox-gl/src/shaders/_prelude_material_table.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/_prelude_indicator_cutout.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/background.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/background.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/background_pattern.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/background_pattern.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/circle.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/circle.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/clipping_mask.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/clipping_mask.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/heatmap.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/heatmap.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/heatmap_texture.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/heatmap_texture.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/collision_box.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/collision_box.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/collision_circle.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/collision_circle.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/debug.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/debug.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/fill.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/fill.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/fill_outline.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/fill_outline.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/fill_outline_pattern.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/fill_outline_pattern.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/fill_pattern.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/fill_pattern.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/line_blend_composite.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/line_blend_composite.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/line_blend_reduce.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/line_blend_reduce.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/fill_extrusion.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/fill_extrusion.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/fill_extrusion_pattern.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/fill_extrusion_pattern.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/hillshade_prepare.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/hillshade_prepare.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/hillshade.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/hillshade.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/line.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/line.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/line_pattern.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/line_pattern.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/raster.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/raster.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/symbol.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/symbol.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/terrain_raster.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/terrain_raster.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/terrain_depth.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/terrain_depth.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/skybox.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/skybox_gradient.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/skybox_capture.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/skybox_capture.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/globe_raster.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/globe_raster.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/atmosphere.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/atmosphere.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/stars.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/stars.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/occlusion.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/occlusion.vertex.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/model.vertex.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/shaders_standard.ts","../../../node_modules/mapbox-gl/3d-style/shaders/model.fragment.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/model_depth.fragment.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/model_depth.vertex.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/fill_extrusion_depth.fragment.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/fill_extrusion_depth.vertex.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/fill_extrusion_ground_effect.fragment.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/fill_extrusion_ground_effect.vertex.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/ground_shadow.fragment.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/ground_shadow.vertex.glsl","../../../node_modules/mapbox-gl/3d-style/render/program/ground_shadow_program.ts","../../../node_modules/mapbox-gl/3d-style/render/program/program_uniforms_standard.ts","../../../node_modules/mapbox-gl/3d-style/render/shadow_renderer.ts","../../../node_modules/mapbox-gl/modules/standard_main_imports.ts","../../../node_modules/mapbox-gl/3d-style/render/shadow_uniforms.ts","../../../node_modules/mapbox-gl/modules/standard_main.ts","../../../node_modules/mapbox-gl/src/render/draw_fill_extrusion.ts","../../../node_modules/mapbox-gl/3d-style/render/draw_building.ts","../../../node_modules/mapbox-gl/3d-style/style/indoor_building_detection.ts","../../../node_modules/mapbox-gl/src/render/program/raster_particle_program.ts","../../../node_modules/mapbox-gl/src/render/raster.ts","../../../node_modules/mapbox-gl/src/data/bucket.ts","../../../node_modules/mapbox-gl/src/source/tile_mesh.ts","../../../node_modules/mapbox-gl/src/data/bounds_attributes.ts","../../../node_modules/mapbox-gl/src/source/tile.ts","../../../node_modules/mapbox-gl/src/source/raster_array_tile.ts","../../../node_modules/mapbox-gl/src/source/tile_bounds.ts","../../../node_modules/mapbox-gl/src/source/raster_tile_source.ts","../../../node_modules/mapbox-gl/src/data/mrt/mrt.query.ts","../../../node_modules/mapbox-gl/src/source/raster_array_tile_source.ts","../../../node_modules/mapbox-gl/src/data/particle_attributes.ts","../../../node_modules/mapbox-gl/src/render/raster_particle_state.ts","../../../node_modules/mapbox-gl/src/render/raster_fade.ts","../../../node_modules/mapbox-gl/src/render/draw_raster_particle.ts","../../../node_modules/mapbox-gl/3d-style/shaders/building.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/_prelude_raster_particle.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/shaders_hd.ts","../../../node_modules/mapbox-gl/3d-style/shaders/building.vertex.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/building_bloom.fragment.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/building_bloom.vertex.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/building_depth.fragment.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/building_depth.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/raster_particle.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/raster_particle.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/raster_particle_draw.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/raster_particle_draw.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/raster_particle_texture.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/raster_particle_texture.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/raster_particle_update.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/raster_particle_update.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/snow_particle.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/snow_particle.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/rain_particle.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/rain_particle.vertex.glsl","../../../node_modules/mapbox-gl/src/shaders/vignette.fragment.glsl","../../../node_modules/mapbox-gl/src/shaders/vignette.vertex.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/elevated_structures_depth.fragment.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/elevated_structures_depth.vertex.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/elevated_structures_model.fragment.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/elevated_structures_model.vertex.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/elevated_structures_depth_reconstruct.fragment.glsl","../../../node_modules/mapbox-gl/3d-style/shaders/elevated_structures_depth_reconstruct.vertex.glsl","../../../node_modules/mapbox-gl/src/precipitation/rain_program.ts","../../../node_modules/mapbox-gl/src/precipitation/rain_attributes.ts","../../../node_modules/mapbox-gl/src/precipitation/vignette_attributes.ts","../../../node_modules/mapbox-gl/src/precipitation/vignette.ts","../../../node_modules/mapbox-gl/src/precipitation/vignette_program.ts","../../../node_modules/mapbox-gl/src/precipitation/common.ts","../../../node_modules/mapbox-gl/src/precipitation/snow_program.ts","../../../node_modules/mapbox-gl/src/precipitation/snow_attributes.ts","../../../node_modules/mapbox-gl/3d-style/render/program/elevated_structures_program.ts","../../../node_modules/mapbox-gl/3d-style/render/program/program_uniforms_hd.ts","../../../node_modules/mapbox-gl/3d-style/render/draw_elevated_fill.ts","../../../node_modules/mapbox-gl/3d-style/source/frc_coverage_snapshot.ts","../../../node_modules/mapbox-gl/3d-style/source/frc_coverage_manager.ts","../../../node_modules/mapbox-gl/src/source/tile_cache.ts","../../../node_modules/mapbox-gl/src/source/source_state.ts","../../../node_modules/mapbox-gl/src/source/source_cache.ts","../../../node_modules/mapbox-gl/3d-style/source/elevation_coverage_snapshot.ts","../../../node_modules/mapbox-gl/3d-style/source/elevation_coverage_manager.ts","../../../node_modules/mapbox-gl/3d-style/style/elevation_coverage_style.ts","../../../node_modules/mapbox-gl/src/render/program/clipping_mask_program.ts","../../../node_modules/mapbox-gl/3d-style/render/frc_coverage_second_pass.ts","../../../node_modules/mapbox-gl/3d-style/render/frc_coverage_renderer.ts","../../../node_modules/mapbox-gl/3d-style/render/draw_frc_coverage.ts","../../../node_modules/mapbox-gl/modules/hd_main_imports.ts","../../../node_modules/mapbox-gl/3d-style/render/building_tile_border_manager.ts","../../../node_modules/mapbox-gl/src/precipitation/draw_rain.ts","../../../node_modules/mapbox-gl/src/precipitation/draw_snow.ts","../../../node_modules/mapbox-gl/3d-style/style/indoor_manager.ts","../../../node_modules/mapbox-gl/3d-style/style/frc_coverage_style.ts","../../../node_modules/mapbox-gl/3d-style/style/frc_coverage_eager.ts","../../../node_modules/mapbox-gl/modules/hd_main.ts","../../../node_modules/mapbox-gl/src/style/query_geometry.ts","../../../node_modules/mapbox-gl/src/source/vector_tile_source.ts","../../../node_modules/mapbox-gl/src/source/image_source.ts","../../../node_modules/mapbox-gl/src/source/source.ts","../../../node_modules/mapbox-gl/src/source/raster_dem_tile_source.ts","../../../node_modules/mapbox-gl/src/source/geojson_source.ts","../../../node_modules/mapbox-gl/src/source/video_source.ts","../../../node_modules/mapbox-gl/3d-style/source/tiled_3d_model_source.ts","../../../node_modules/mapbox-gl/src/source/canvas_source.ts","../../../node_modules/mapbox-gl/src/source/custom_source.ts","../../../node_modules/mapbox-gl/src/source/query_features.ts","../../../node_modules/mapbox-gl/src/source/building_index.ts","../../../node_modules/mapbox-gl/src/util/worker_pool_factory.ts","../../../node_modules/mapbox-gl/src/style-spec/deref.ts","../../../node_modules/mapbox-gl/src/style-spec/diff.ts","../../../node_modules/mapbox-gl/src/geo/projection/projection_util.ts","../../../node_modules/mapbox-gl/src/symbol/placement.ts","../../../node_modules/mapbox-gl/src/symbol/path_interpolator.ts","../../../node_modules/mapbox-gl/src/symbol/collision_index.ts","../../../node_modules/mapbox-gl/src/symbol/placement_algorithms/index.ts","../../../node_modules/mapbox-gl/src/symbol/placement_algorithms/default.ts","../../../node_modules/mapbox-gl/src/style/pauseable_placement.ts","../../../node_modules/mapbox-gl/src/symbol/cross_tile_symbol_index.ts","../../../node_modules/mapbox-gl/3d-style/render/model_manager.ts","../../../node_modules/mapbox-gl/src/render/program_precompiler.ts","../../../node_modules/mapbox-gl/src/util/lut.ts","../../../node_modules/mapbox-gl/src/style/load_iconset.ts","../../../node_modules/mapbox-gl/src/render/image_provider.ts","../../../node_modules/mapbox-gl/src/style/style.ts","../../../node_modules/mapbox-gl/src/style-spec/empty.ts","../../../node_modules/mapbox-gl/src/style/load_sprite.ts","../../../node_modules/mapbox-gl/src/render/vertex_array_object.ts","../../../node_modules/mapbox-gl/src/render/program/hillshade_program.ts","../../../node_modules/mapbox-gl/src/render/draw_hillshade.ts","../../../node_modules/mapbox-gl/src/gl/value.ts","../../../node_modules/mapbox-gl/src/terrain/terrain_raster_program.ts","../../../node_modules/mapbox-gl/src/terrain/globe_raster_program.ts","../../../node_modules/mapbox-gl/src/terrain/draw_terrain_raster.ts","../../../node_modules/mapbox-gl/src/terrain/terrain.ts","../../../node_modules/mapbox-gl/3d-style/render/lights.ts","../../../node_modules/mapbox-gl/src/render/program.ts","../../../node_modules/mapbox-gl/src/render/fog.ts","../../../node_modules/mapbox-gl/src/render/program/fill_program.ts","../../../node_modules/mapbox-gl/src/render/program/line_blend_reduce_program.ts","../../../node_modules/mapbox-gl/src/render/program/collision_program.ts","../../../node_modules/mapbox-gl/src/render/program/heatmap_program.ts","../../../node_modules/mapbox-gl/src/render/program/raster_program.ts","../../../node_modules/mapbox-gl/src/render/program/symbol_program.ts","../../../node_modules/mapbox-gl/src/render/program/background_program.ts","../../../node_modules/mapbox-gl/src/render/program/program_uniforms.ts","../../../node_modules/mapbox-gl/src/render/program/line_blend_composite_program.ts","../../../node_modules/mapbox-gl/src/render/program/skybox_program.ts","../../../node_modules/mapbox-gl/src/render/program/skybox_capture_program.ts","../../../node_modules/mapbox-gl/src/terrain/stars_program.ts","../../../node_modules/mapbox-gl/src/render/program/occlusion_program.ts","../../../node_modules/mapbox-gl/src/gl/index_buffer.ts","../../../node_modules/mapbox-gl/src/gl/vertex_buffer.ts","../../../node_modules/mapbox-gl/src/gl/framebuffer.ts","../../../node_modules/mapbox-gl/src/gl/context.ts","../../../node_modules/mapbox-gl/src/render/draw_collision_debug.ts","../../../node_modules/mapbox-gl/src/render/draw_symbol.ts","../../../node_modules/mapbox-gl/src/render/draw_line.ts","../../../node_modules/mapbox-gl/src/render/draw_fill.ts","../../../node_modules/mapbox-gl/src/render/draw_raster.ts","../../../node_modules/mapbox-gl/src/render/draw_background.ts","../../../node_modules/mapbox-gl/src/render/draw_debug.ts","../../../node_modules/mapbox-gl/src/render/skybox_attributes.ts","../../../node_modules/mapbox-gl/src/render/skybox_geometry.ts","../../../node_modules/mapbox-gl/src/render/draw_sky.ts","../../../node_modules/mapbox-gl/src/render/atmosphere_attributes.ts","../../../node_modules/mapbox-gl/src/render/atmosphere_buffer.ts","../../../node_modules/mapbox-gl/src/render/stars_attributes.ts","../../../node_modules/mapbox-gl/src/render/draw_atmosphere.ts","../../../node_modules/mapbox-gl/src/render/wireframe_cache.ts","../../../node_modules/mapbox-gl/src/render/occlusion_params.ts","../../../node_modules/mapbox-gl/src/render/painter.ts","../../../node_modules/mapbox-gl/src/render/draw_circle.ts","../../../node_modules/mapbox-gl/src/render/draw_heatmap.ts","../../../node_modules/mapbox-gl/src/render/draw_custom.ts","../../../node_modules/mapbox-gl/src/util/throttle.ts","../../../node_modules/mapbox-gl/src/ui/hash.ts","../../../node_modules/mapbox-gl/src/ui/handler_inertia.ts","../../../node_modules/mapbox-gl/src/ui/events.ts","../../../node_modules/mapbox-gl/src/ui/handler/map_event.ts","../../../node_modules/mapbox-gl/src/ui/handler/box_zoom.ts","../../../node_modules/mapbox-gl/src/ui/handler/handler_util.ts","../../../node_modules/mapbox-gl/src/ui/handler/tap_recognizer.ts","../../../node_modules/mapbox-gl/src/ui/handler/tap_zoom.ts","../../../node_modules/mapbox-gl/src/ui/handler/mouse.ts","../../../node_modules/mapbox-gl/src/ui/handler/touch_pan.ts","../../../node_modules/mapbox-gl/src/ui/handler/touch_zoom_rotate.ts","../../../node_modules/mapbox-gl/src/ui/handler/keyboard.ts","../../../node_modules/mapbox-gl/src/ui/handler/scroll_zoom.ts","../../../node_modules/mapbox-gl/src/ui/handler/shim/dblclick_zoom.ts","../../../node_modules/mapbox-gl/src/ui/handler/click_zoom.ts","../../../node_modules/mapbox-gl/src/ui/handler/tap_drag_zoom.ts","../../../node_modules/mapbox-gl/src/ui/handler/shim/drag_pan.ts","../../../node_modules/mapbox-gl/src/ui/handler/shim/drag_rotate.ts","../../../node_modules/mapbox-gl/src/ui/handler/shim/touch_zoom_rotate.ts","../../../node_modules/mapbox-gl/src/ui/handler_manager.ts","../../../node_modules/mapbox-gl/src/ui/camera.ts","../../../node_modules/mapbox-gl/src/util/sanitize.ts","../../../node_modules/mapbox-gl/src/ui/control/attribution_control.ts","../../../node_modules/mapbox-gl/src/ui/control/logo_control.ts","../../../node_modules/mapbox-gl/src/util/task_queue.ts","../../../node_modules/mapbox-gl/src/util/eased_variable.ts","../../../node_modules/mapbox-gl/src/ui/default_locale.ts","../../../node_modules/mapbox-gl/src/ui/interactions.ts","../../../node_modules/mapbox-gl/src/ui/map.ts","../../../node_modules/mapbox-gl/src/ui/control/navigation_control.ts","../../../node_modules/mapbox-gl/src/util/smart_wrap.ts","../../../node_modules/mapbox-gl/src/ui/anchor.ts","../../../node_modules/mapbox-gl/src/ui/marker.ts","../../../node_modules/mapbox-gl/src/ui/control/geolocate_control.ts","../../../node_modules/mapbox-gl/src/ui/control/scale_control.ts","../../../node_modules/mapbox-gl/src/ui/popup.ts","../../../node_modules/mapbox-gl/src/index.ts","../../../node_modules/mapbox-gl/src/ui/control/fullscreen_control.ts","../../../node_modules/mapbox-gl/src/ui/control/indoor_control.ts","../../../node_modules/mapbox-gl/rollup/mapboxgl.js","../../../node_modules/xtend/immutable.js","../../../node_modules/fuzzy/lib/fuzzy.js","../../../node_modules/suggestions/src/list.js","../../../node_modules/suggestions/src/suggestions.js","../../../node_modules/suggestions/index.js","../../../node_modules/lodash.debounce/index.js","../../../node_modules/events/events.js","../../../node_modules/@mapbox/mapbox-gl-geocoder/lib/exceptions.js","../../../node_modules/@mapbox/mapbox-sdk/lib/helpers/parse-link-header.js","../../../node_modules/@mapbox/mapbox-sdk/lib/classes/mapi-response.js","../../../node_modules/@mapbox/mapbox-sdk/lib/constants.js","../../../node_modules/@mapbox/mapbox-sdk/lib/classes/mapi-error.js","../../../node_modules/@mapbox/mapbox-sdk/lib/helpers/parse-headers.js","../../../node_modules/@mapbox/mapbox-sdk/lib/browser/browser-layer.js","../../../node_modules/base-64/base64.js","../../../node_modules/@mapbox/parse-mapbox-token/index.js","../../../node_modules/eventemitter3/index.js","../../../node_modules/@mapbox/mapbox-sdk/lib/helpers/url-utils.js","../../../node_modules/@mapbox/mapbox-sdk/lib/classes/mapi-request.js","../../../node_modules/@mapbox/mapbox-sdk/lib/classes/mapi-client.js","../../../node_modules/@mapbox/mapbox-sdk/lib/browser/browser-client.js","../../../node_modules/@mapbox/mapbox-sdk/index.js","../../../node_modules/is-plain-obj/index.js","../../../node_modules/@mapbox/fusspot/lib/index.js","../../../node_modules/@mapbox/mapbox-sdk/services/service-helpers/validator.js","../../../node_modules/@mapbox/mapbox-sdk/services/service-helpers/pick.js","../../../node_modules/@mapbox/mapbox-sdk/services/service-helpers/object-map.js","../../../node_modules/@mapbox/mapbox-sdk/services/service-helpers/stringify-booleans.js","../../../node_modules/@mapbox/mapbox-sdk/services/service-helpers/create-service-factory.js","../../../node_modules/@mapbox/mapbox-sdk/services/geocoding.js","../../../node_modules/nanoid/url-alphabet/index.js","../../../node_modules/nanoid/index.browser.js","../../../node_modules/@mapbox/mapbox-gl-geocoder/lib/events.js","../../../node_modules/@mapbox/mapbox-gl-geocoder/lib/localization.js","../../../node_modules/subtag/subtag.js","../../../node_modules/@mapbox/mapbox-gl-geocoder/lib/geolocation.js","../../../node_modules/@mapbox/mapbox-gl-geocoder/lib/utils.js","../../../node_modules/@mapbox/mapbox-gl-geocoder/lib/index.js","../../../packages/bsbi-app-framework-view/src/utils/stopDoubleClick.js","../../../packages/bsbi-app-framework-view/src/utils/PatchedNavigo.js","../../../packages/bsbi-app-framework-view/src/utils/vclookup/vcdata.js","../../../packages/bsbi-app-framework-view/src/utils/vclookup/VCLookup.js","../../../packages/bsbi-app-framework-view/src/utils/escapeRegExp.js","../../../packages/bsbi-app-framework-view/src/utils/taxonpicker/TaxonSearch.js","../../../packages/bsbi-app-framework-view/src/utils/regexReplaceArray.js","../../../packages/bsbi-app-framework-view/src/utils/NameMisparseError.js","../../../packages/bsbi-app-framework-view/src/utils/PartyNameParserName.js","../../../packages/bsbi-app-framework-view/src/utils/PartyNameParser.js","../../../packages/bsbi-app-framework-view/src/utils/PartySearch.js","../../../packages/bsbi-app-framework-view/src/utils/dropdownPopover.js","../../../packages/bsbi-app-framework-view/src/views/formfields/FormField.js","../../../packages/bsbi-app-framework-view/src/utils/flexibleDate.js","../../../packages/bsbi-app-framework-view/src/views/formfields/DateField.js","../../../packages/bsbi-app-framework-view/src/views/forms/Form.js","../../../packages/bsbi-app-framework-view/src/utils/PlantNet.js","../../../packages/bsbi-app-framework-view/src/views/MapMarker.js","../../../packages/bsbi-app-framework-view/src/utils/georefValidity.js","../../../packages/bsbi-app-framework-view/src/utils/GPSRequest.js","../../../packages/bsbi-app-framework-view/src/utils/gpsDateGate.js","../../../packages/bsbi-app-framework-view/src/utils/OccurrenceValidation.js","../../../packages/bsbi-app-framework-view/src/views/formfields/TextGeorefField.js","../../../packages/bsbi-app-framework-view/src/views/formfields/GeorefMapPopup.js","../../../node_modules/@turf/destination/node_modules/@turf/helpers/dist/es/index.js","../../../node_modules/@turf/invariant/dist/es/index.js","../../../node_modules/@turf/destination/dist/es/index.js","../../../node_modules/@turf/circle/node_modules/@turf/helpers/dist/es/index.js","../../../node_modules/@turf/circle/dist/es/index.js","../../../packages/bsbi-app-framework-view/src/utils/MapLayerControl.js","../../../packages/bsbi-app-framework-view/src/utils/AreaSearch.js","../../../node_modules/@turf/helpers/index.ts","../../../node_modules/@turf/distance/node_modules/@turf/invariant/index.ts","../../../node_modules/@turf/distance/index.ts","../../../node_modules/@turf/meta/index.ts","../../../node_modules/@turf/nearest-point-on-line/node_modules/@turf/invariant/index.ts","../../../node_modules/@turf/nearest-point-on-line/index.ts","../../../node_modules/@turf/point-to-line-distance/node_modules/@turf/invariant/index.ts","../../../node_modules/@turf/rhumb-distance/node_modules/@turf/invariant/index.ts","../../../node_modules/@turf/rhumb-distance/index.ts","../../../node_modules/@turf/point-to-line-distance/index.ts","../../../packages/bsbi-app-framework-view/src/views/formfields/MapGeorefField.js","../../../packages/bsbi-app-framework-view/src/views/formfields/PartyField.js","../../../packages/bsbi-app-framework-view/src/views/formfields/TextAreaField.js","../../../packages/bsbi-app-framework-view/src/views/formfields/ImageField.js","../../../packages/bsbi-app-framework-view/src/utils/emailvalidator/validate.js","../../../packages/bsbi-app-framework-view/src/views/formfields/InputField.js","../../../packages/bsbi-app-framework-view/src/views/formfields/BooleanField.js","../../../packages/bsbi-app-framework-view/src/views/formfields/SelectField.js","../../../packages/bsbi-app-framework-view/src/views/formfields/AbstractSuggestListField.js","../../../packages/bsbi-app-framework-view/src/views/formfields/SelectSingleField.js","../../../packages/bsbi-app-framework-view/src/views/formfields/TaxonPickerField.js","../../../packages/bsbi-app-framework-view/src/views/formfields/AreaField.js","../../../packages/bsbi-app-framework-view/src/utils/habitat/habitatTerms.js","../../../packages/bsbi-app-framework-view/src/views/formfields/HabitatField.js","../../../packages/bsbi-app-framework-view/src/utils/vclookup/viceCountyTerms.js","../../../packages/bsbi-app-framework-view/src/views/formfields/ViceCountyTextField.js","../../../packages/bsbi-app-framework-view/src/utils/vclookup/bsbiViceCountyTerms.js","../../../packages/bsbi-app-framework-view/src/utils/vclookup/bsbiViceCountyScheme.js","../../../packages/bsbi-app-framework-view/src/utils/habitat/bsbiHabitatTerms.js","../../../packages/bsbi-app-framework-view/src/utils/habitat/bsbiHabitatScheme.js","../../../packages/bsbi-app-framework-view/src/views/formfields/RepeaterField.js","../../../packages/bsbi-app-framework-view/src/views/formfields/FieldGroup.js","../../../packages/bsbi-app-framework-view/src/views/formfields/HiddenField.js","../../../packages/bsbi-app-framework-view/src/views/formfields/ViceCountyField.js","../../../packages/bsbi-app-framework-view/src/views/formfields/SampleUnitField.js","../../../packages/bsbi-app-framework-view/src/views/Page.js","../../../packages/bsbi-app-framework-view/src/views/NotFoundView.js","../../../packages/bsbi-app-framework-view/src/views/forms/OccurrenceForm.js","../../../packages/bsbi-app-framework-view/src/views/forms/SurveyForm.js","../../../packages/bsbi-app-framework-view/src/views/layout/Layout.js","../../../packages/bsbi-app-framework-view/src/views/SurveyPickerView.js","../../../packages/bsbi-app-framework-view/src/utils/VersionNotification.js","../src/framework/RecordingAppEvents.js","../src/framework/constants.js","../src/utils/draftRules.js","../src/controllers/MainController.js","../src/utils/SpeechSynth.js","../src/views/layout/RecordingAppLayout.js","../src/controllers/SurveyModeController.js","../src/views/formfields/SurveyTemplateField.js","../src/controllers/FlowersCountModeController.js","../src/framework/RecordingApp.js","../src/views/forms/RecordingAppSurveyFormSection.js","../src/views/forms/statusAttributes.js","../src/views/formfields/TaxonStatusSelectField.js","../src/views/MainView.js","../src/views/formfields/UserAttributeField.js","../src/views/forms/formSurveyAttributes.js","../src/views/forms/RecordingAppSurveyFormAboutSection.js","../src/views/forms/RecordingAppSurveyForm.js","../src/views/forms/occurrenceAttributeDefinitions.js","../src/views/forms/formOccurrenceAttributes.js","../src/views/forms/formAbundanceAttribute.js","../src/views/forms/formHabitatAttribute.js","../src/views/formfields/PhenologySelectField.js","../src/views/forms/formPhenologyAttribute.js","../src/views/forms/formParasiteAttribute.js","../src/views/formfields/DraftField.js","../src/views/forms/RecordingAppOccurrenceForm.js","../../../node_modules/bootstrap/js/src/collapse.js","../src/views/SurveyMainView.js","../src/views/forms/RecordingAppCasualSurveyForm.js","../src/views/forms/RecordingAppCasualSurveyFormAboutSection.js","../src/views/forms/formAbundanceAttributeNoDAFOR.js","../src/views/forms/RecordingAppSingleOccurrenceForm.js","../src/utils/CasualOccurrenceValidation.js","../src/views/SingleMainView.js","../src/views/SubsidiaryView.js","../src/views/HelpView.js","../../../node_modules/dialog-polyfill/dist/dialog-polyfill.esm.js","../src/utils/isProbableCrawler.js","../../../node_modules/bootstrap/js/src/offcanvas.js","../../../node_modules/@popperjs/core/lib/enums.js","../../../node_modules/@popperjs/core/lib/dom-utils/getNodeName.js","../../../node_modules/@popperjs/core/lib/dom-utils/getWindow.js","../../../node_modules/@popperjs/core/lib/dom-utils/instanceOf.js","../../../node_modules/@popperjs/core/lib/modifiers/applyStyles.js","../../../node_modules/@popperjs/core/lib/utils/getBasePlacement.js","../../../node_modules/@popperjs/core/lib/utils/math.js","../../../node_modules/@popperjs/core/lib/utils/userAgent.js","../../../node_modules/@popperjs/core/lib/dom-utils/isLayoutViewport.js","../../../node_modules/@popperjs/core/lib/dom-utils/getBoundingClientRect.js","../../../node_modules/@popperjs/core/lib/dom-utils/getLayoutRect.js","../../../node_modules/@popperjs/core/lib/dom-utils/contains.js","../../../node_modules/@popperjs/core/lib/dom-utils/getComputedStyle.js","../../../node_modules/@popperjs/core/lib/dom-utils/isTableElement.js","../../../node_modules/@popperjs/core/lib/dom-utils/getDocumentElement.js","../../../node_modules/@popperjs/core/lib/dom-utils/getParentNode.js","../../../node_modules/@popperjs/core/lib/dom-utils/getOffsetParent.js","../../../node_modules/@popperjs/core/lib/utils/getMainAxisFromPlacement.js","../../../node_modules/@popperjs/core/lib/utils/within.js","../../../node_modules/@popperjs/core/lib/utils/getFreshSideObject.js","../../../node_modules/@popperjs/core/lib/utils/mergePaddingObject.js","../../../node_modules/@popperjs/core/lib/utils/expandToHashMap.js","../../../node_modules/@popperjs/core/lib/modifiers/arrow.js","../../../node_modules/@popperjs/core/lib/utils/getVariation.js","../../../node_modules/@popperjs/core/lib/modifiers/computeStyles.js","../../../node_modules/@popperjs/core/lib/modifiers/eventListeners.js","../../../node_modules/@popperjs/core/lib/utils/getOppositePlacement.js","../../../node_modules/@popperjs/core/lib/utils/getOppositeVariationPlacement.js","../../../node_modules/@popperjs/core/lib/dom-utils/getWindowScroll.js","../../../node_modules/@popperjs/core/lib/dom-utils/getWindowScrollBarX.js","../../../node_modules/@popperjs/core/lib/dom-utils/getViewportRect.js","../../../node_modules/@popperjs/core/lib/dom-utils/getDocumentRect.js","../../../node_modules/@popperjs/core/lib/dom-utils/isScrollParent.js","../../../node_modules/@popperjs/core/lib/dom-utils/getScrollParent.js","../../../node_modules/@popperjs/core/lib/dom-utils/listScrollParents.js","../../../node_modules/@popperjs/core/lib/utils/rectToClientRect.js","../../../node_modules/@popperjs/core/lib/dom-utils/getClippingRect.js","../../../node_modules/@popperjs/core/lib/utils/computeOffsets.js","../../../node_modules/@popperjs/core/lib/utils/detectOverflow.js","../../../node_modules/@popperjs/core/lib/utils/computeAutoPlacement.js","../../../node_modules/@popperjs/core/lib/modifiers/flip.js","../../../node_modules/@popperjs/core/lib/modifiers/hide.js","../../../node_modules/@popperjs/core/lib/modifiers/offset.js","../../../node_modules/@popperjs/core/lib/modifiers/popperOffsets.js","../../../node_modules/@popperjs/core/lib/utils/getAltAxis.js","../../../node_modules/@popperjs/core/lib/modifiers/preventOverflow.js","../../../node_modules/@popperjs/core/lib/dom-utils/getHTMLElementScroll.js","../../../node_modules/@popperjs/core/lib/dom-utils/getNodeScroll.js","../../../node_modules/@popperjs/core/lib/dom-utils/getCompositeRect.js","../../../node_modules/@popperjs/core/lib/utils/orderModifiers.js","../../../node_modules/@popperjs/core/lib/utils/debounce.js","../../../node_modules/@popperjs/core/lib/utils/mergeByName.js","../../../node_modules/@popperjs/core/lib/createPopper.js","../../../node_modules/@popperjs/core/lib/popper-lite.js","../../../node_modules/@popperjs/core/lib/popper.js","../../../node_modules/bootstrap/js/src/dropdown.js","../src/framework/AppSession.js","../src/views/AccountView.js","../src/controllers/AccountController.js","../src/controllers/CasualRecordingModeController.js","../src/views/forms/NyphSurveyForm.js","../src/views/forms/NyphOccurrenceForm.js","../src/views/forms/NyphSurveyFormSurveySection.js","../../../node_modules/bootstrap/js/src/util/swipe.js","../../../node_modules/bootstrap/js/src/carousel.js","../src/utils/nyphFeaturedTaxa.js","../src/views/NyphMainView.js","../src/controllers/MultiSurveyPickerController.js","../src/views/MultiSurveyPickerView.js","../src/controllers/HomePageController.js","../src/views/HomeView.js","../src/controllers/HelpController.js","../src/views/forms/SettingsForm.js","../src/models/Settings.js","../src/controllers/SettingsController.js","../src/views/SettingsView.js","../src/controllers/NYPHModeController.js","../src/utils/NyphOccurrenceValidation.js","../src/utils/absenceRules.js","../src/utils/TranscribedOccurrenceValidation.js","../src/utils/WorkerBootstrap.js","../src/utils/getFeaturedTaxaPhotoUrls.js","../src/config.js","../src/controllers/SCMModeController.js","../src/views/forms/RecordingAppSCMSurveyFormAboutSection.js","../src/views/forms/RecordingAppSCMOccurrenceForm.js","../src/views/forms/RecordingAppSCMSurveyForm.js","../src/views/SCMMainView.js","../src/controllers/MoreSurveysController.js","../../../packages/bsbi-datatable/src/lib/DataSource.js","../../../packages/bsbi-datatable/src/lib/escapeHtml.js","../../../packages/bsbi-datatable/src/lib/icons.js","../../../packages/bsbi-datatable/src/lib/columnWidths.js","../../../packages/bsbi-datatable/src/lib/TableHeader.js","../../../packages/bsbi-datatable/src/lib/orderRows.js","../../../packages/bsbi-datatable/src/lib/focusGuard.js","../../../packages/bsbi-datatable/src/lib/gridKeyboard.js","../../../packages/bsbi-datatable/src/lib/caretBoundary.js","../../../packages/bsbi-datatable/src/lib/EditableTable.js","../../../packages/bsbi-datatable/src/lib/TableRow.js","../../../packages/bsbi-datatable/src/lib/entryOrder.js","../../../packages/bsbi-datatable/src/lib/cloneDetached.js","../src/utils/surveylist/surveyListRows.js","../src/utils/surveylist/surveyListCells.js","../src/utils/surveylist/AppSurveysList.mjs","../src/views/MoreSurveysView.js","../src/controllers/FlowersCountSurveyDefinitionController.js","../src/views/widgets/RouteEditor.js","../src/views/formfields/TransectField.js","../src/views/forms/FlowersCountSetupForm.js","../src/views/FlowersCountSetupView.js","../src/views/forms/FlowersCountOccurrenceForm.js","../src/views/forms/FlowersCountSurveyForm.js","../src/views/forms/FlowersCountSurveyEventSection.js","../src/views/forms/FlowersCountSurveySegmentSection.js","../src/views/FlowersCountMainView.js","../src/controllers/TranscriptionModeController.js","../src/utils/rowValidity.js","../src/views/forms/formHabitatField.js","../src/views/formfields/AbsenceField.js","../src/views/forms/formAbsenceField.js","../src/views/forms/formViceCountyTextField.js","../src/utils/abundanceCount.js","../src/views/formfields/AbundanceCountField.js","../src/utils/transcriptionMetadata.js","../src/utils/occurrenceAttributeColumns.js","../src/views/forms/transcriptionColumns.js","../src/views/forms/TranscriptionOccurrenceRow.js","../src/views/forms/TranscriptionOccurrenceForm.js","../src/views/forms/TranscriptionSurveyForm.js","../src/views/forms/TranscriptionSurveyFormAboutSection.js","../src/views/TranscriptionMainView.js","../src/main.js"],"sourcesContent":["export const deg2rad = Math.PI / 180;\r\nexport const rad2deg = 180.0 / Math.PI;\r\n\r\n","import {deg2rad} from '../constants';\r\n\r\nexport class LatLng {\r\n\r\n\t/**\r\n\t * @type {number}\r\n\t */\r\n\tlat;\r\n\r\n\t/**\r\n\t * @type {number}\r\n\t */\r\n\tlng;\r\n\r\n\t/**\r\n\t * represents lat lng\r\n\t *\r\n\t * @param {number} lat\r\n\t * @param {number} lng\r\n\t * @constructor\r\n\t */\r\n\tconstructor(lat, lng) {\r\n\t\tthis.lat = lat;\r\n\t\tthis.lng = lng;\r\n\t};\r\n\r\n\tstatic _transform(lat, lon, a, e, h, a2, e2, xp, yp, zp, xr, yr, zr, s) {\r\n\t\t// convert to cartesian; lat, lon are radians\r\n\t\tconst sf = s * 0.000001;\r\n\t\tlet v = a / (Math.sqrt(1 - (e * (Math.sin(lat) * Math.sin(lat)))));\r\n\t\tconst x = (v + h) * Math.cos(lat) * Math.cos(lon);\r\n\t\tconst y = (v + h) * Math.cos(lat) * Math.sin(lon);\r\n\t\tconst z = ((1 - e) * v + h) * Math.sin(lat);\r\n\t\t// transform cartesian\r\n\t\tconst xrot = (xr / 3600) * deg2rad;\r\n\t\tconst yrot = (yr / 3600) * deg2rad;\r\n\t\tconst zrot = (zr / 3600) * deg2rad;\r\n\t\tconst hx = x + (x * sf) - (y * zrot) + (z * yrot) + xp;\r\n\t\tconst hy = (x * zrot) + y + (y * sf) - (z * xrot) + yp;\r\n\t\tconst hz = (-1 * x * yrot) + (y * xrot) + z + (z * sf) + zp;\r\n\t\t// Convert back to lat, lon\r\n\t\tlon = Math.atan(hy / hx);\r\n\t\tconst p = Math.sqrt((hx * hx) + (hy * hy));\r\n\t\tlat = Math.atan(hz / (p * (1 - e2)));\r\n\t\tv = a2 / (Math.sqrt(1 - e2 * (Math.sin(lat) * Math.sin(lat))));\r\n\t\tlet errvalue = 1.0;\r\n\t\tlet lat0 = 0;\r\n\t\twhile (errvalue > 0.001) {\r\n\t\t\tlat0 = Math.atan((hz + e2 * v * Math.sin(lat)) / p);\r\n\t\t\terrvalue = Math.abs(lat0 - lat);\r\n\t\t\tlat = lat0;\r\n\t\t}\r\n\t\t//h = p / Math.cos(lat) - v;\r\n\t\t//var geo = { latitude: lat, longitude: lon, height: h }; // object to hold lat and lon\r\n\t\treturn (new LatLng(lat, lon));\r\n\t}\r\n\r\n\t//helper\r\n\tstatic _marc(bf0, n, phi0, phi) {\r\n\t\treturn bf0 * (((1 + n + ((5 / 4) * (n * n)) + ((5 / 4) * (n * n * n))) * (phi - phi0))\r\n\t\t\t- (((3 * n) + (3 * (n * n)) + ((21 / 8) * (n * n * n))) * (Math.sin(phi - phi0)) * (Math.cos(phi + phi0)))\r\n\t\t\t+ ((((15 / 8) * (n * n)) + ((15 / 8) * (n * n * n))) * (Math.sin(2 * (phi - phi0))) * (Math.cos(2 * (phi + phi0))))\r\n\t\t\t- (((35 / 24) * (n * n * n)) * (Math.sin(3 * (phi - phi0))) * (Math.cos(3 * (phi + phi0)))));\r\n\t};\r\n\r\n}\r\n","/**\r\n * represents lat lng as WGS84 (the Google Maps form)\r\n *\r\n * @param {number} lat\r\n * @param {number} lng\r\n * @constructor\r\n */\r\nimport {LatLng} from \"./LatLng\";\r\n\r\nexport class LatLngWGS84 extends LatLng {\r\n\tconstructor(lat, lng) {\r\n\t\tsuper(lat, lng);\r\n\t}\r\n}\r\n","import {LatLng} from './LatLng';\r\nimport {LatLngWGS84} from './LatLngWGS84';\r\nimport {deg2rad, rad2deg} from '../constants';\r\n\r\n/**\r\n * represents lat lng as OSGB1936 (Ordnance Survey projection)\r\n *\r\n * @param {number} lat\r\n * @param {number} lng\r\n * @constructor\r\n */\r\nexport class LatLngGB extends LatLng {\r\n\r\n\tconstructor(lat, lng) {\r\n\t\tsuper(lat, lng);\r\n\t}\r\n\r\n\r\n\t/**\r\n\t *\r\n\t * @returns {LatLngWGS84}\r\n\t */\r\n\ttoWGS84() {\r\n\t\t//airy1830 = new RefEll(6377563.396, 6356256.909);\r\n\t\tlet a = 6377563.396; //airy1830.maj;\r\n\t\t//var b = 6356256.909; //airy1830.min;\r\n\t\tlet eSquared = 0.00667054007; // ((maj * maj) - (min * min)) / (maj * maj); // airy1830.ecc;\r\n\t\tconst phi = this.lat * deg2rad; // (Math.PI / 180)(this.lat);\r\n\t\tconst sinPhi = Math.sin(phi);\r\n\t\tconst lambda = this.lng * deg2rad; // (Math.PI / 180)(this.lng);\r\n\t\tconst v = a / (Math.sqrt(1 - eSquared * (sinPhi * sinPhi)));\r\n\t\t//H = 0; // height\r\n\t\tconst x = v * Math.cos(phi) * Math.cos(lambda);\r\n\t\tconst y = v * Math.cos(phi) * Math.sin(lambda);\r\n\t\tconst z = ((1 - eSquared) * v) * sinPhi;\r\n\r\n\t\tconst tx = 446.448;\r\n\t\tconst ty = -124.157;\r\n\t\tconst tz = 542.060;\r\n\t\tconst s = -0.0000204894;\r\n\t\tconst rx = 0.000000728190110241429; // (Math.PI / 180)( 0.00004172222);\r\n\t\tconst ry = 0.000001197489772948010; // (Math.PI / 180)( 0.00006861111);\r\n\t\tconst rz = 0.000004082615892268120; // (Math.PI / 180)( 0.00023391666);\r\n\r\n\t\tconst xB = tx + (x * (1 + s)) + (-rx * y) + (ry * z);\r\n\t\tconst yB = ty + (rz * x) + (y * (1 + s)) + (-rx * z);\r\n\t\tconst zB = tz + (-ry * x) + (rx * y) + (z * (1 + s));\r\n\r\n\t\t//wgs84 = new RefEll(6378137.000, 6356752.3141);\r\n\t\ta = 6378137.000; // wgs84.maj;\r\n\t\t//var b = 6356752.3141; // wgs84.min;\r\n\t\teSquared = 0.00669438003;// ((maj * maj) - (min * min)) / (maj * maj); //wgs84.ecc;\r\n\r\n\t\t//lambdaB = (180 / Math.PI)(Math.atan(yB / xB));\r\n\t\tconst p = Math.sqrt((xB * xB) + (yB * yB));\r\n\t\tlet phiN = Math.atan(zB / (p * (1 - eSquared)));\r\n\r\n\t\tfor (let i = 1; i < 10; ++i) {\r\n\t\t\tlet sinPhiN = Math.sin(phiN); // this must be in the for loop as phiN is variable\r\n\t\t\tphiN = Math.atan((zB + (eSquared * (a / (Math.sqrt(1 - eSquared * (sinPhiN * sinPhiN)))) * sinPhiN)) / p);\r\n\t\t}\r\n\r\n\t\t//this.lat = rad2deg * phiN;\r\n\t\t//this.lng = rad2deg * (Math.atan(yB / xB)); // lambdaB;\r\n\r\n\t\treturn new LatLngWGS84(rad2deg * phiN, rad2deg * (Math.atan(yB / xB)));\r\n\t};\r\n\r\n// /**\r\n// * converts lat and lon (OSGB36) to OS northings and eastings\r\n// *\r\n// * @returns {GridCoordsGB}\r\n// */\r\n// LatLngGB.prototype.to_os_coords = function() {\r\n// var phi = this.lat * deg2rad; // convert latitude to radians\r\n// var lam = this.lng * deg2rad; // convert longitude to radians\r\n// var a = 6377563.396; // OSGB semi-major axis\r\n// var b = 6356256.91; // OSGB semi-minor axis\r\n// var e0 = 400000; // easting of false origin\r\n// var n0 = -100000; // northing of false origin\r\n// var f0 = 0.9996012717; // OSGB scale factor on central meridian\r\n// var e2 = 0.0066705397616; // OSGB eccentricity squared\r\n// var lam0 = -0.034906585039886591; // OSGB false east\r\n// var phi0 = 0.85521133347722145; // OSGB false north\r\n// var af0 = a * f0;\r\n// var bf0 = b * f0;\r\n//\r\n// // easting\r\n// var slat2 = Math.sin(phi) * Math.sin(phi);\r\n// var nu = af0 / (Math.sqrt(1 - (e2 * (slat2))));\r\n// var rho = (nu * (1 - e2)) / (1 - (e2 * slat2));\r\n// var eta2 = (nu / rho) - 1;\r\n// var p = lam - lam0;\r\n// var IV = nu * Math.cos(phi);\r\n// var clat3 = Math.pow(Math.cos(phi), 3);\r\n// var tlat2 = Math.tan(phi) * Math.tan(phi);\r\n// var V = (nu / 6) * clat3 * ((nu / rho) - tlat2);\r\n// var clat5 = Math.pow(Math.cos(phi), 5);\r\n// var tlat4 = Math.pow(Math.tan(phi), 4);\r\n// var VI = (nu / 120) * clat5 * ((5 - (18 * tlat2)) + tlat4 + (14 * eta2) - (58 * tlat2 * eta2));\r\n// var east = e0 + (p * IV) + (Math.pow(p, 3) * V) + (Math.pow(p, 5) * VI);\r\n//\r\n// // northing\r\n// var n = (af0 - bf0) / (af0 + bf0);\r\n// var M = LatLng._Marc(bf0, n, phi0, phi);\r\n// var I = M + (n0);\r\n// var II = (nu / 2) * Math.sin(phi) * Math.cos(phi);\r\n// var III = ((nu / 24) * Math.sin(phi) * Math.pow(Math.cos(phi), 3)) * (5 - Math.pow(Math.tan(phi), 2) + (9 * eta2));\r\n// var IIIA = ((nu / 720) * Math.sin(phi) * clat5) * (61 - (58 * tlat2) + tlat4);\r\n// var north = I + ((p * p) * II) + (Math.pow(p, 4) * III) + (Math.pow(p, 6) * IIIA);\r\n//\r\n// \treturn new GridCoordsGB(Math.round(east), Math.round(north));\r\n// };\r\n\r\n\t/**\r\n\t *\r\n\t * @param {LatLngWGS84} latLngWGS84\r\n\t * @returns {LatLngGB}\r\n\t */\r\n\tstatic fromWGS84(latLngWGS84) {\r\n\r\n\t\t//first off convert to radians\r\n\t\tconst radWGlat = latLngWGS84.lat * deg2rad;\r\n\t\tconst radWGlon = latLngWGS84.lng * deg2rad;\r\n\t\t//these are the values for WGS84(GRS80) to OSGB36(Airy)\r\n\t\tconst a = 6378137; // WGS84_AXIS\r\n\t\tconst e = 0.00669438037928458; // WGS84_ECCENTRIC\r\n\t\t//var h = height; // height above datum (from GPGGA sentence)\r\n\t\tconst h = 0;\r\n\t\tconst a2 = 6377563.396; // OSGB_AXIS\r\n\t\tconst e2 = 0.0066705397616; // OSGB_ECCENTRIC\r\n\t\tconst xp = -446.448;\r\n\t\tconst yp = 125.157;\r\n\t\tconst zp = -542.06;\r\n\t\tconst xr = -0.1502;\r\n\t\tconst yr = -0.247;\r\n\t\tconst zr = -0.8421;\r\n\t\tconst s = 20.4894;\r\n\r\n\t\t// convert to cartesian; lat, lon are in radians\r\n\t\tconst sf = s * 0.000001;\r\n\t\tlet v = a / (Math.sqrt(1 - (e * Math.sin(radWGlat) * Math.sin(radWGlat))));\r\n\t\tconst x = (v + h) * Math.cos(radWGlat) * Math.cos(radWGlon);\r\n\t\tconst y = (v + h) * Math.cos(radWGlat) * Math.sin(radWGlon);\r\n\t\tconst z = ((1 - e) * v + h) * Math.sin(radWGlat);\r\n\r\n\t\t// transform cartesian\r\n\t\tconst xrot = (xr / 3600) * deg2rad;\r\n\t\tconst yrot = (yr / 3600) * deg2rad;\r\n\t\tconst zrot = (zr / 3600) * deg2rad;\r\n\t\tconst hx = x + (x * sf) - (y * zrot) + (z * yrot) + xp;\r\n\t\tconst hy = (x * zrot) + y + (y * sf) - (z * xrot) + yp;\r\n\t\tconst hz = (-1 * x * yrot) + (y * xrot) + z + (z * sf) + zp;\r\n\r\n\t\t// Convert back to lat, lon\r\n\t\tconst newLon = Math.atan(hy / hx);\r\n\t\tconst p = Math.sqrt((hx * hx) + (hy * hy));\r\n\t\tlet newLat = Math.atan(hz / (p * (1 - e2)));\r\n\t\tv = a2 / (Math.sqrt(1 - e2 * (Math.sin(newLat) * Math.sin(newLat))));\r\n\t\tlet errvalue = 1.0;\r\n\t\tlet lat0 = 0;\r\n\t\twhile (errvalue > 0.001) {\r\n\t\t\tlat0 = Math.atan((hz + e2 * v * Math.sin(newLat)) / p);\r\n\t\t\terrvalue = Math.abs(lat0 - newLat);\r\n\t\t\tnewLat = lat0;\r\n\t\t}\r\n\r\n\t\treturn new LatLngGB(newLat * rad2deg, newLon * rad2deg);\r\n\t}\r\n}\r\n","import {LatLng} from './LatLng';\r\nimport {LatLngWGS84} from './LatLngWGS84';\r\n// import { GridCoordsIE } from '../GridCoords/GridCoordsIE';\r\nimport {deg2rad, rad2deg} from '../constants';\r\n\r\n\r\n/**\r\n * represents lat lng as Modified Airy (Irish grid projection)\r\n *\r\n */\r\nexport class LatLngIE extends LatLng {\r\n\r\n\t/**\r\n\t *\r\n\t * @param {number} lat\r\n\t * @param {number} lng\r\n\t */\r\n\tconstructor(lat, lng) {\r\n\t\tsuper(lat, lng);\r\n\t};\r\n\r\n// /**\r\n// * converts lat and lon (modified Airy) to OSI northings and eastings\r\n// *\r\n// * @returns {GridCoordsIE}\r\n// */\r\n// to_os_coords() {\r\n// //var deg2rad = Math.PI / 180;\r\n// //var rad2deg = 180.0 / Math.PI;\r\n//\r\n// var phi = this.lat * deg2rad; // convert latitude to radians\r\n// var lam = this.lng * deg2rad; // convert longitude to radians\r\n// var a = 6377340.189; // OSI semi-major\r\n// var b = 6356034.447; // OSI semi-minor\r\n// var e0 = 200000; // OSI easting of false origin\r\n// var n0 = 250000; // OSI northing of false origin\r\n// var f0 = 1.000035; // OSI scale factor on central meridian\r\n// var e2 = 0.00667054015; // OSI eccentricity squared\r\n// var lam0 = -0.13962634015954636615389526147909; // OSI false east\r\n// var phi0 = 0.93375114981696632365417456114141; // OSI false north\r\n// var af0 = a * f0;\r\n// var bf0 = b * f0;\r\n//\r\n// // easting\r\n// var slat2 = Math.sin(phi) * Math.sin(phi);\r\n// var nu = af0 / (Math.sqrt(1 - (e2 * (slat2))));\r\n// var rho = (nu * (1 - e2)) / (1 - (e2 * slat2));\r\n// var eta2 = (nu / rho) - 1;\r\n// var p = lam - lam0;\r\n// var IV = nu * Math.cos(phi);\r\n// var clat3 = Math.pow(Math.cos(phi), 3);\r\n// var tlat2 = Math.tan(phi) * Math.tan(phi);\r\n// var V = (nu / 6) * clat3 * ((nu / rho) - tlat2);\r\n// var clat5 = Math.pow(Math.cos(phi), 5);\r\n// var tlat4 = Math.pow(Math.tan(phi), 4);\r\n// var VI = (nu / 120) * clat5 * ((5 - (18 * tlat2)) + tlat4 + (14 * eta2) - (58 * tlat2 * eta2));\r\n// var east = e0 + (p * IV) + (Math.pow(p, 3) * V) + (Math.pow(p, 5) * VI);\r\n//\r\n// // northing\r\n// var n = (af0 - bf0) / (af0 + bf0);\r\n// var M = LatLng._Marc(bf0, n, phi0, phi);\r\n// var I = M + (n0);\r\n// var II = (nu / 2) * Math.sin(phi) * Math.cos(phi);\r\n// var III = ((nu / 24) * Math.sin(phi) * Math.pow(Math.cos(phi), 3)) * (5 - Math.pow(Math.tan(phi), 2) + (9 * eta2));\r\n// var IIIA = ((nu / 720) * Math.sin(phi) * clat5) * (61 - (58 * tlat2) + tlat4);\r\n// var north = I + ((p * p) * II) + (Math.pow(p, 4) * III) + (Math.pow(p, 6) * IIIA);\r\n//\r\n// \t//return {x: Math.round(east), y: Math.round(north)};\r\n//\r\n// \t/*\r\n// \treturn (east > 0 && north > 0) ?\r\n// \t\tnew GridCoordsIE(Math.round(east), Math.round(north))\r\n// \t\t:\r\n// \t\tnull;\r\n// \t*/\r\n// return new GridCoordsIE(Math.round(east), Math.round(north));\r\n// };\r\n\r\n\t/**\r\n\t * convert Irish projection to WGS84 (for Google Maps)\r\n\t * see http://www.carabus.co.uk/ll_ngr.html\r\n\t */\r\n\ttoWGS84() {\r\n\t\tconst IRISH_AXIS = 6377340.189;\r\n\t\tconst IRISH_ECCENTRIC = 0.00667054015;\r\n\r\n\t\tconst WGS84_AXIS = 6378137;\r\n\t\tconst WGS84_ECCENTRIC = 0.00669438037928458;\r\n\r\n\t\t/*\r\n\t\t * IE\r\n\t\ta = 6377340.189; // OSI semi-major\r\n\t\tb = 6356034.447; // OSI semi-minor\r\n\t\te0 = 200000; // OSI easting of false origin\r\n\t\tn0 = 250000; // OSI northing of false origin\r\n\t\tf0 = 1.000035; // OSI scale factor on central meridian\r\n\t\te2 = 0.00667054015; // OSI eccentricity squared\r\n\t\tlam0 = -0.13962634015954636615389526147909; // OSI false east\r\n\t\tphi0 = 0.93375114981696632365417456114141; // OSI false north\r\n\t\t*/\r\n\r\n\t\t//height = 0;\r\n\r\n\t\tconst latLngRadians = LatLng._transform(this.lat * deg2rad, this.lng * deg2rad, IRISH_AXIS, IRISH_ECCENTRIC, 0, WGS84_AXIS, WGS84_ECCENTRIC,\r\n\t\t\t482.53, -130.596, 564.557, -1.042, -0.214, -0.631, -8.15);\r\n\r\n\t\treturn new LatLngWGS84(latLngRadians.lat * rad2deg, latLngRadians.lng * rad2deg);\r\n\t};\r\n\r\n\t/**\r\n\t *\r\n\t * @param {LatLngWGS84} latLngWGS84\r\n\t * @returns {LatLngIE}\r\n\t */\r\n\tstatic fromWGS84(latLngWGS84) {\r\n\t\tconst phip = latLngWGS84.lat * deg2rad;\r\n\t\tconst lambdap = latLngWGS84.lng * deg2rad;\r\n\r\n\t\tconst IRISH_AXIS = 6377340.189;\r\n\t\tconst IRISH_ECCENTRIC = 0.00667054015;\r\n\r\n\t\tconst WGS84_AXIS = 6378137;\r\n\t\tconst WGS84_ECCENTRIC = 0.00669438037928458;\r\n\r\n\r\n\t\t/*\r\n\t\t * IE\r\n\t\ta = 6377340.189; // OSI semi-major\r\n\t\tb = 6356034.447; // OSI semi-minor\r\n\t\te0 = 200000; // OSI easting of false origin\r\n\t\tn0 = 250000; // OSI northing of false origin\r\n\t\tf0 = 1.000035; // OSI scale factor on central meridian\r\n\t\te2 = 0.00667054015; // OSI eccentricity squared\r\n\t\tlam0 = -0.13962634015954636615389526147909; // OSI false east\r\n\t\tphi0 = 0.93375114981696632365417456114141; // OSI false north\r\n\t\t */\r\n\r\n\t\tconst height = 0;\r\n\t\tconst latlng = LatLng._transform(phip, lambdap, WGS84_AXIS, WGS84_ECCENTRIC, height, IRISH_AXIS, IRISH_ECCENTRIC,\r\n\t\t\t-482.53, 130.596, -564.557, 1.042, 0.214, 0.631, 8.15);\r\n\r\n\t\treturn new LatLngIE(latlng.lat * rad2deg, latlng.lng * rad2deg);\r\n\t}\r\n}\r\n","import {LatLng} from './LatLng';\r\nimport {rad2deg, deg2rad} from '../constants';\r\n\r\nexport class LatLngCI extends LatLng {\r\n\t/**\r\n\t * represents lat lng as INT24 (CI grid projection)\r\n\t *\r\n\t * @constructor\r\n\t * @param {number} lat\r\n\t * @param {number} lng\r\n\t */\r\n\tconstructor(lat, lng) {\r\n\t\tsuper(lat, lng);\r\n\t};\r\n\r\n\t// /**\r\n\t// * converts lat and lon to CI northings and eastings\r\n\t// *\r\n\t// * @returns GridCoordsCI\r\n\t// */\r\n\t// to_os_coords() {\r\n\t// \tvar phi = this.lat * deg2rad; // convert latitude to radians\r\n\t// \tvar lam = this.lng * deg2rad; // convert longitude to radians\r\n\t// \tvar a = 6378388.000; // OSI semi-major\r\n\t// \tvar b = 6356911.946; // OSI semi-minor\r\n\t// \tvar e0 = 500000; // OSI easting of false origin\r\n\t// \tvar n0 = 0; // OSI northing of false origin\r\n\t// \tvar f0 = 0.9996; // OSI scale factor on central meridian\r\n\t// \tvar e2 = 0.0067226700223333; // OSI eccentricity squared\r\n\t// \tvar lam0 = -0.0523598775598; // OSI false east\r\n\t// \tvar phi0 = 0; // OSI false north\r\n\t// \tvar af0 = a * f0;\r\n\t// \tvar bf0 = b * f0;\r\n\t//\r\n\t// \t// easting\r\n\t// \tvar slat2 = Math.sin(phi) * Math.sin(phi);\r\n\t// \tvar nu = af0 / (Math.sqrt(1 - (e2 * (slat2))));\r\n\t// \tvar rho = (nu * (1 - e2)) / (1 - (e2 * slat2));\r\n\t// \tvar eta2 = (nu / rho) - 1;\r\n\t// \tvar p = lam - lam0;\r\n\t// \tvar IV = nu * Math.cos(phi);\r\n\t// \tvar clat3 = Math.pow(Math.cos(phi), 3);\r\n\t// \tvar tlat2 = Math.tan(phi) * Math.tan(phi);\r\n\t// \tvar V = (nu / 6) * clat3 * ((nu / rho) - tlat2);\r\n\t// \tvar clat5 = Math.pow(Math.cos(phi), 5);\r\n\t// \tvar tlat4 = Math.pow(Math.tan(phi), 4);\r\n\t// \tvar VI = (nu / 120) * clat5 * ((5 - (18 * tlat2)) + tlat4 + (14 * eta2) - (58 * tlat2 * eta2));\r\n\t// \tvar east = e0 + (p * IV) + (Math.pow(p, 3) * V) + (Math.pow(p, 5) * VI);\r\n\t//\r\n\t// \t// northing\r\n\t// \tvar n = (af0 - bf0) / (af0 + bf0);\r\n\t// \tvar M = LatLng._Marc(bf0, n, phi0, phi);\r\n\t// \tvar I = M + (n0);\r\n\t// \tvar II = (nu / 2) * Math.sin(phi) * Math.cos(phi);\r\n\t// \tvar III = ((nu / 24) * Math.sin(phi) * Math.pow(Math.cos(phi), 3)) * (5 - Math.pow(Math.tan(phi), 2) + (9 * eta2));\r\n\t// \tvar IIIA = ((nu / 720) * Math.sin(phi) * clat5) * (61 - (58 * tlat2) + tlat4);\r\n\t// \tvar north = I + ((p * p) * II) + (Math.pow(p, 4) * III) + (Math.pow(p, 6) * IIIA);\r\n\t//\r\n\t// \t\t//return {x: Math.round(east), y: Math.round(north)};\r\n\t// \treturn new GridCoordsCI(Math.round(east), Math.round(north));\r\n\t// };\r\n\r\n\t/**\r\n\t *\r\n\t * @param {LatLngWGS84} latLngWGS84\r\n\t * @returns {LatLngCI}\r\n\t */\r\n\tstatic fromWGS84(latLngWGS84) {\r\n\t\tconst phip = latLngWGS84.lat * deg2rad;\r\n\t\tconst lambdap = latLngWGS84.lng * deg2rad;\r\n\r\n\t\tconst CI_AXIS = 6378388.000;\r\n\t\tconst CI_ECCENTRIC = 0.0067226700223333;\r\n\r\n\t\tconst WGS84_AXIS = 6378137;\r\n\t\tconst WGS84_ECCENTRIC = 0.00669438037928458;\r\n\r\n\r\n\t\t/*\r\n\t\t * CI\r\n\t\t a = 6378388.000; // INT24 ED50 semi-major\r\n\t\t b = 6356911.946; // INT24 ED50 semi-minor\r\n\t\t e0 = 500000; // CI easting of false origin\r\n\t\t n0 = 0; // CI northing of false origin\r\n\t\t f0 = 0.9996; // INT24 ED50 scale factor on central meridian\r\n\t\t e2 = 0.0067226700223333; // INT24 ED50 eccentricity squared\r\n\t\t lam0 = -0.0523598775598; // CI false east\r\n\t\t phi0 = 0 * deg2rad; // CI false north\r\n\t\t */\r\n\r\n\t\tconst height = 0;\r\n\t\tconst latlng = LatLng._transform(phip, lambdap, WGS84_AXIS, WGS84_ECCENTRIC, height, CI_AXIS, CI_ECCENTRIC,\r\n\t\t\t83.901, 98.127, 118.635, 0, 0, 0, 0);\r\n\r\n\t\treturn new LatLngCI(latlng.lat * rad2deg, latlng.lng * rad2deg);\r\n\t};\r\n}\r\n","import {LatLngGB} from '../LatLng/LatLngGB'\r\nimport {LatLngIE} from '../LatLng/LatLngIE';\r\nimport {LatLngCI} from '../LatLng/LatLngCI';\r\nimport {LatLngWGS84} from '../LatLng/LatLngWGS84';\r\nimport {deg2rad, rad2deg} from \"../constants\";\r\nimport {LatLng} from \"../LatLng/LatLng\";\r\n\r\n/**\r\n * tetrad letters ordered by easting then northing (steps of 2000 m)\r\n * i.e. (x * 4) + y\r\n *\r\n * where x and y are the integer of (10 km remainder / 2)\r\n * @type {string}\r\n */\r\nexport const TETRAD_LETTERS = 'ABCDEFGHIJKLMNPQRSTUVWXYZ';\r\n\r\n/**\r\n * abstract representation of a grid-ref co-ordinate pair\r\n * ( *not a grid-ref string* )\r\n *\r\n */\r\nexport class GridCoords {\r\n\r\n\t/**\r\n\t * @type {number}\r\n\t */\r\n\tx;\r\n\r\n\t/**\r\n\t * @type {number}\r\n\t */\r\n\ty;\r\n\r\n\t/**\r\n\t * @type {('GB'|'IE'|'CI')}\r\n\t */\r\n\tcountry;\r\n\r\n\tconstructor() {\r\n\t}\r\n\r\n\t/**\r\n\t * convert easting,northing to a WGS84 lat lng\r\n\t * @abstract\r\n\t * @returns {LatLngWGS84}\r\n\t */\r\n\ttoLatLng() {\r\n\t}\r\n\r\n\t/**\r\n\t *\r\n\t * @param {number} precision metres\r\n\t * @abstract\r\n\t * @returns {string}\r\n\t */\r\n\ttoGridRefString(precision) {\r\n\t}\r\n\r\n\t/**\r\n\t *\r\n\t * @param {number} precision metres\r\n\t * @returns {{gridRef: string, lx: number, ly: number, hx: number, hy: number}}\r\n\t */\r\n\ttoGridRefStringDescriptor(precision) {\r\n\t\tconst lx = Math.trunc(this.x / precision) * precision;\r\n\t\tconst ly = Math.trunc(this.y / precision) * precision;\r\n\r\n\t\treturn {\r\n\t\t\tgridRef : this.toGridRefString(precision),\r\n\t\t\tlx,\r\n\t\t\tly,\r\n\t\t\thx: lx + precision,\r\n\t\t\thy: ly + precision,\r\n\t\t};\r\n\t}\r\n\r\n\t/**\r\n\t *\r\n\t * @abstract\r\n\t * @returns {?string}\r\n\t */\r\n\ttoHectad() {\r\n\t}\r\n\r\n\t/**\r\n\t *\r\n\t * @returns {{gridRef: string, lx: number, ly: number, hx: number, hy: number}}\r\n\t */\r\n\ttoHectadDescriptor() {\r\n\t\tconst lx = Math.trunc(this.x / 10000) * 10000;\r\n\t\tconst ly = Math.trunc(this.y / 10000) * 10000;\r\n\r\n\t\treturn {\r\n\t\t\tgridRef : this.toGridRefString(precision),\r\n\t\t\tlx,\r\n\t\t\tly,\r\n\t\t\thx: lx + 10000,\r\n\t\t\thy: ly + 10000,\r\n\t\t};\r\n\t}\r\n\r\n\t// /**\r\n\t// * tetrad letters ordered by northing then easting (steps of 2000 m)\r\n\t// * i.e. (y*5) + x\r\n\t// *\r\n\t// * where x and y are the integer of (10 km remainder / 2)\r\n\t// *\r\n\t// * @type {string}\r\n\t// */\r\n\t// static tetradLettersRowFirst = 'AFKQVBGLRWCHMSXDINTYEJPUZ';\r\n\r\n\t/**\r\n\t *\r\n\t * @param {number} lat WGS84 degrees\r\n\t * @param {number} lng WGS84 degrees\r\n\t * @returns {GridCoords|null}\r\n\t */\r\n\tstatic fromLatLng(lat, lng) {\r\n\t\t// test if GB\r\n\t\tif (lng >= -8.74 && lat > 49.88) {\r\n\t\t\t// lng extreme must accommodate St Kilda\r\n\r\n\t\t\t//let os = LatLngGB.fromWGS84(new LatLngWGS84(lat, lng)).to_os_coords();\r\n\t\t\tconst os = GridCoords._from_gb_latlng(LatLngGB.fromWGS84(new LatLngWGS84(lat, lng)));\r\n\t\t\tif (os.x >= 0 && os.is_gb_hectad()) {\r\n\t\t\t\treturn os;\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\t// test if Irish\r\n\t\tif (lng < -5.3 && lat > 51.34 && lng > -11 && lat < 55.73) {\r\n\t\t\t//let osI = LatLngIE.fromWGS84(new LatLngWGS84(lat, lng)).to_os_coords();\r\n\t\t\tconst osI = GridCoords._from_ie_latlng(LatLngIE.fromWGS84(new LatLngWGS84(lat, lng)));\r\n\r\n\t\t\tif (osI.x < 0 || osI.y < 0) {\r\n\t\t\t\treturn null;\r\n\t\t\t} else {\r\n\t\t\t\treturn osI;\r\n\t\t\t}\r\n\t\t} else {\r\n\t\t\t//let osCi = LatLngCI.fromWGS84(new LatLngWGS84(lat, lng)).to_os_coords();\r\n\t\t\tconst osCi = GridCoords._from_ci_latlng(LatLngCI.fromWGS84(new LatLngWGS84(lat, lng)));\r\n\r\n\t\t\tif (osCi.x >= 500000 && osCi.x < 600000 && osCi.y >= 5400000 && osCi.y < 5600000) {\r\n\t\t\t\treturn osCi;\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\treturn null; //not a valid location\r\n\t}\r\n\r\n\t// noinspection JSUnusedGlobalSymbols\r\n\t/**\r\n\t *\r\n\t * @param {GridCoords} otherGridCoords\r\n\t * @returns {null|number}\r\n\t */\r\n\tdistanceFrom(otherGridCoords) {\r\n\t\tif (this.country !== otherGridCoords.country) {\r\n\t\t\treturn null;\r\n\t\t}\r\n\r\n\t\tconst dX = otherGridCoords.x - this.x;\r\n\t\tconst dY = otherGridCoords.y - this.y;\r\n\r\n\t\treturn Math.sqrt((dX * dX) + (dY * dY));\r\n\t}\r\n\r\n\t/**\r\n\t *\r\n\t * @param {LatLngGB} latLng GB projected latitude / longitude (degrees)\r\n\t */\r\n\tstatic _from_gb_latlng(latLng) {\r\n\t\tconst phi = latLng.lat * deg2rad; // convert latitude to radians\r\n\t\tconst lam = latLng.lng * deg2rad; // convert longitude to radians\r\n\t\tconst a = 6377563.396; // OSGB semi-major axis\r\n\t\tconst b = 6356256.91; // OSGB semi-minor axis\r\n\t\tconst e0 = 400000; // easting of false origin\r\n\t\tconst n0 = -100000; // northing of false origin\r\n\t\tconst f0 = 0.9996012717; // OSGB scale factor on central meridian\r\n\t\tconst e2 = 0.0066705397616; // OSGB eccentricity squared\r\n\t\tconst lam0 = -0.034906585039886591; // OSGB false east\r\n\t\tconst phi0 = 0.85521133347722145; // OSGB false north\r\n\t\tconst af0 = a * f0;\r\n\t\tconst bf0 = b * f0;\r\n\r\n\t\t// easting\r\n\t\tconst slat2 = Math.sin(phi) * Math.sin(phi);\r\n\t\tconst nu = af0 / (Math.sqrt(1 - (e2 * (slat2))));\r\n\t\tconst rho = (nu * (1 - e2)) / (1 - (e2 * slat2));\r\n\t\tconst eta2 = (nu / rho) - 1;\r\n\t\tconst p = lam - lam0;\r\n\t\tconst IV = nu * Math.cos(phi);\r\n\t\tconst clat3 = Math.pow(Math.cos(phi), 3);\r\n\t\tconst tlat2 = Math.tan(phi) * Math.tan(phi);\r\n\t\tconst V = (nu / 6) * clat3 * ((nu / rho) - tlat2);\r\n\t\tconst clat5 = Math.pow(Math.cos(phi), 5);\r\n\t\tconst tlat4 = Math.pow(Math.tan(phi), 4);\r\n\t\tconst VI = (nu / 120) * clat5 * ((5 - (18 * tlat2)) + tlat4 + (14 * eta2) - (58 * tlat2 * eta2));\r\n\t\tconst east = e0 + (p * IV) + (Math.pow(p, 3) * V) + (Math.pow(p, 5) * VI);\r\n\r\n\t\t// northing\r\n\t\tconst n = (af0 - bf0) / (af0 + bf0);\r\n\t\tconst M = LatLng._marc(bf0, n, phi0, phi);\r\n\t\tconst I = M + (n0);\r\n\t\tconst II = (nu / 2) * Math.sin(phi) * Math.cos(phi);\r\n\t\tconst III = ((nu / 24) * Math.sin(phi) * Math.pow(Math.cos(phi), 3)) * (5 - Math.pow(Math.tan(phi), 2) + (9 * eta2));\r\n\t\tconst IIIA = ((nu / 720) * Math.sin(phi) * clat5) * (61 - (58 * tlat2) + tlat4);\r\n\t\tconst north = I + ((p * p) * II) + (Math.pow(p, 4) * III) + (Math.pow(p, 6) * IIIA);\r\n\r\n\t\treturn new GridCoordsGB(Math.round(east), Math.round(north));\r\n\t}\r\n\r\n\t/**\r\n\t * converts lat and lon (modified Airy) to OSI northings and eastings\r\n\t *\r\n\t * @param {LatLngIE} latLng Irish projected latitude / longitude (degrees)\r\n\t * @returns {GridCoordsIE}\r\n\t */\r\n\tstatic _from_ie_latlng(latLng) {\r\n\t\tconst phi = latLng.lat * deg2rad; // convert latitude to radians\r\n\t\tconst lam = latLng.lng * deg2rad; // convert longitude to radians\r\n\t\tconst a = 6377340.189; // OSI semi-major\r\n\t\tconst b = 6356034.447; // OSI semi-minor\r\n\t\tconst e0 = 200000; // OSI easting of false origin\r\n\t\tconst n0 = 250000; // OSI northing of false origin\r\n\t\tconst f0 = 1.000035; // OSI scale factor on central meridian\r\n\t\tconst e2 = 0.00667054015; // OSI eccentricity squared\r\n\t\tconst lam0 = -0.13962634015954636615389526147909; // OSI false east\r\n\t\tconst phi0 = 0.93375114981696632365417456114141; // OSI false north\r\n\t\tconst af0 = a * f0;\r\n\t\tconst bf0 = b * f0;\r\n\r\n\t\t// easting\r\n\t\tconst slat2 = Math.sin(phi) * Math.sin(phi);\r\n\t\tconst nu = af0 / (Math.sqrt(1 - (e2 * (slat2))));\r\n\t\tconst rho = (nu * (1 - e2)) / (1 - (e2 * slat2));\r\n\t\tconst eta2 = (nu / rho) - 1;\r\n\t\tconst p = lam - lam0;\r\n\t\tconst IV = nu * Math.cos(phi);\r\n\t\tconst clat3 = Math.pow(Math.cos(phi), 3);\r\n\t\tconst tlat2 = Math.tan(phi) * Math.tan(phi);\r\n\t\tconst V = (nu / 6) * clat3 * ((nu / rho) - tlat2);\r\n\t\tconst clat5 = Math.pow(Math.cos(phi), 5);\r\n\t\tconst tlat4 = Math.pow(Math.tan(phi), 4);\r\n\t\tconst VI = (nu / 120) * clat5 * ((5 - (18 * tlat2)) + tlat4 + (14 * eta2) - (58 * tlat2 * eta2));\r\n\t\tconst east = e0 + (p * IV) + (Math.pow(p, 3) * V) + (Math.pow(p, 5) * VI);\r\n\r\n\t\t// northing\r\n\t\tconst n = (af0 - bf0) / (af0 + bf0);\r\n\t\tconst M = LatLng._marc(bf0, n, phi0, phi);\r\n\t\tconst I = M + (n0);\r\n\t\tconst II = (nu / 2) * Math.sin(phi) * Math.cos(phi);\r\n\t\tconst III = ((nu / 24) * Math.sin(phi) * Math.pow(Math.cos(phi), 3)) * (5 - Math.pow(Math.tan(phi), 2) + (9 * eta2));\r\n\t\tconst IIIA = ((nu / 720) * Math.sin(phi) * clat5) * (61 - (58 * tlat2) + tlat4);\r\n\t\tconst north = I + ((p * p) * II) + (Math.pow(p, 4) * III) + (Math.pow(p, 6) * IIIA);\r\n\r\n\t\treturn new GridCoordsIE(Math.round(east), Math.round(north));\r\n\t}\r\n\r\n\t/**\r\n\t * converts lat and lon to CI northings and eastings\r\n\t * @param {LatLngCI} latLng Channel Islands projected latitude / longitude (degrees)\r\n\t *\r\n\t * @returns GridCoordsCI\r\n\t */\r\n\tstatic _from_ci_latlng(latLng) {\r\n\t\tconst phi = latLng.lat * deg2rad; // convert latitude to radians\r\n\t\tconst lam = latLng.lng * deg2rad; // convert longitude to radians\r\n\t\tconst a = 6378388.000; // OSI semi-major\r\n\t\tconst b = 6356911.946; // OSI semi-minor\r\n\t\tconst e0 = 500000; // OSI easting of false origin\r\n\t\tconst n0 = 0; // OSI northing of false origin\r\n\t\tconst f0 = 0.9996; // OSI scale factor on central meridian\r\n\t\tconst e2 = 0.0067226700223333; // OSI eccentricity squared\r\n\t\tconst lam0 = -0.0523598775598; // OSI false east\r\n\t\tconst phi0 = 0; // OSI false north\r\n\t\tconst af0 = a * f0;\r\n\t\tconst bf0 = b * f0;\r\n\r\n\t\t// easting\r\n\t\tconst slat2 = Math.sin(phi) * Math.sin(phi);\r\n\t\tconst nu = af0 / (Math.sqrt(1 - (e2 * (slat2))));\r\n\t\tconst rho = (nu * (1 - e2)) / (1 - (e2 * slat2));\r\n\t\tconst eta2 = (nu / rho) - 1;\r\n\t\tconst p = lam - lam0;\r\n\t\tconst IV = nu * Math.cos(phi);\r\n\t\tconst clat3 = Math.pow(Math.cos(phi), 3);\r\n\t\tconst tlat2 = Math.tan(phi) * Math.tan(phi);\r\n\t\tconst V = (nu / 6) * clat3 * ((nu / rho) - tlat2);\r\n\t\tconst clat5 = Math.pow(Math.cos(phi), 5);\r\n\t\tconst tlat4 = Math.pow(Math.tan(phi), 4);\r\n\t\tconst VI = (nu / 120) * clat5 * ((5 - (18 * tlat2)) + tlat4 + (14 * eta2) - (58 * tlat2 * eta2));\r\n\t\tconst east = e0 + (p * IV) + (Math.pow(p, 3) * V) + (Math.pow(p, 5) * VI);\r\n\r\n\t\t// northing\r\n\t\tconst n = (af0 - bf0) / (af0 + bf0);\r\n\t\tconst M = LatLng._marc(bf0, n, phi0, phi);\r\n\t\tconst I = M + (n0);\r\n\t\tconst II = (nu / 2) * Math.sin(phi) * Math.cos(phi);\r\n\t\tconst III = ((nu / 24) * Math.sin(phi) * Math.pow(Math.cos(phi), 3)) * (5 - Math.pow(Math.tan(phi), 2) + (9 * eta2));\r\n\t\tconst IIIA = ((nu / 720) * Math.sin(phi) * clat5) * (61 - (58 * tlat2) + tlat4);\r\n\t\tconst north = I + ((p * p) * II) + (Math.pow(p, 4) * III) + (Math.pow(p, 6) * IIIA);\r\n\r\n\t\treturn new GridCoordsCI(Math.round(east), Math.round(north));\r\n\t}\r\n\r\n\t/**\r\n\t *\r\n\t * @param {number} easting\r\n\t * @param {number} northing\r\n\t * @return {string} tetrad letter\r\n\t */\r\n\tstatic calculateTetrad(easting, northing) {\r\n\t\treturn (easting >= 0 && northing >= 0) ?\r\n\t\t\tTETRAD_LETTERS.charAt((Math.floor(easting % 10000 / 2000) * 5) + Math.floor(northing % 10000 / 2000)) :\r\n\t\t\t'';\r\n\t};\r\n\r\n\ttetradLetter() {\r\n\t\treturn (this.x >= 0 && this.y >= 0) ?\r\n\t\t\tTETRAD_LETTERS.charAt((Math.floor(this.x % 10000 / 2000) * 5) + Math.floor(this.y % 10000 / 2000)) :\r\n\t\t\t'';\r\n\t}\r\n\r\n\ttoString() {\r\n\t\treturn this.x + ',' + this.y;\r\n\t};\r\n}\r\n\r\n/**\r\n *\r\n * @param {string} letters\r\n * @param {number} e metres\r\n * @param {number} n metres\r\n * @param {number} precision metres\r\n * @returns {String}\r\n */\r\nexport const _e_n_to_gr = function (letters, e, n, precision) {\r\n\tlet eString = ('00000' + Math.floor(e));\r\n\tlet nString = ('00000' + Math.floor(n));\r\n\r\n\tif (precision === 2000) {\r\n\t\treturn letters +\r\n\t\t\teString.charAt(eString.length - 5) + nString.charAt(nString.length - 5) +\r\n\t\t\tGridCoords.calculateTetrad(e, n);\r\n\t} else if (precision === 100000) {\r\n\t\treturn letters;\r\n\t} else {\r\n\t\tif (precision === 5000) {\r\n\t\t\t// ignore quadrant and treat as hectad\r\n\t\t\tprecision = 10000;\r\n\t\t}\r\n\r\n\t\tlet logPrecision = Math.round(Math.log10(precision));\r\n\t\treturn letters +\r\n\t\t\t(logPrecision ?\r\n\t\t\t\t\t(eString.slice(-5, -logPrecision) + nString.slice(-5, -logPrecision))\r\n\t\t\t\t\t:\r\n\t\t\t\t\t(eString.slice(-5) + nString.slice(-5))\r\n\t\t\t);\r\n\t}\r\n}\r\n\r\n/**\r\n *\r\n */\r\nexport class GridCoordsGB extends GridCoords {\r\n\t/**\r\n\t * @type {GridCoordsGB}\r\n\t */\r\n\tgridCoords = null;\r\n\r\n\t/**\r\n\t *\r\n\t * @param {number} easting\r\n\t * @param {number} northing\r\n\t */\r\n\tconstructor(easting, northing) {\r\n\t\tsuper();\r\n\t\tthis.x = easting | 0;\r\n\t\tthis.y = northing | 0;\r\n\t};\r\n\r\n\t/**\r\n\t *\r\n\t * @type {string}\r\n\t */\r\n\tcountry = 'GB';\r\n\r\n\t/**\r\n\t *\r\n\t * @type {string}\r\n\t */\r\n\tstatic gbHectads = 'SV80SV81SV90SV91SW32SW33SW42SW43SW44SW52SW53SW54SW61SW62SW63SW64SW65SW71SW72SW73SW74SW75SW76SW81SW82SW83SW84SW85SW86SW87SW95SW96SW97SS10SS11SS20SS21SS30SW83SW84SW85SW93SW94SW95SW96SW97SW98SX03SX04SX05SX06SX07SX08SX09SX14SX15SX16SX17SX18SX19SX25SX26SX27SX28SX29SX35SX36SX37SX38SX39SX44SX45SX46SX47SS70SS80SS81SS90SS91ST00ST01ST10ST11ST20ST21ST30SX37SX44SX45SX46SX47SX48SX54SX55SX56SX57SX58SX63SX64SX65SX66SX67SX68SX69SX73SX74SX75SX76SX77SX78SX79SX83SX84SX85SX86SX87SX88SX89SX94SX95SX96SX97SX98SX99SY07SY08SY09SY18SY19SY28SY29SY38SY39SS14SS20SS21SS22SS30SS31SS32SS40SS41SS42SS43SS44SS50SS51SS52SS53SS54SS60SS61SS62SS63SS64SS70SS71SS72SS73SS74SS75SS80SS81SS82SS83SS91SS92ST01ST02SX28SX29SX37SX38SX39SX48SX49SX58SX59SX68SX69SX79SS73SS74SS82SS83SS84SS92SS93SS94ST01ST02ST03ST04ST11ST12ST13ST14ST20ST21ST22ST23ST24ST25ST30ST31ST32ST33ST34ST40ST41ST42ST50ST51ST52ST61ST62ST71ST72ST24ST25ST26ST32ST33ST34ST35ST36ST37ST42ST43ST44ST45ST46ST47ST52ST53ST54ST55ST56ST57ST62ST63ST64ST65ST66ST67ST72ST73ST74ST75ST76ST77ST83ST84ST85ST86SP00SP10ST76ST77ST85ST86ST87ST88ST89ST96ST97ST98ST99SU06SU07SU08SU09SU16SU17SU18SU19SU26SU27SU28SU29SU36SU37ST73ST74ST75ST76ST82ST83ST84ST85ST86ST91ST92ST93ST94ST95ST96SU01SU02SU03SU04SU05SU06SU11SU12SU13SU14SU15SU16SU21SU22SU23SU24SU25SU26SU31SU32SU34SU35SU36ST20ST30ST40ST50ST51ST60ST61ST70ST71ST72ST73ST80ST81ST82ST83ST90ST91ST92SU00SU01SU02SU10SU11SY39SY48SY49SY58SY59SY66SY67SY68SY69SY77SY78SY79SY87SY88SY89SY97SY98SY99SZ07SZ08SZ09SZ28SZ38SZ39SZ47SZ48SZ49SZ57SZ58SZ59SZ68SZ69SU00SU01SU02SU10SU11SU12SU20SU21SU22SU23SU30SU31SU32SU33SU40SU41SU42SU43SU50SU51SU52SU60SU61SU62SU70SU71SU72SZ08SZ09SZ19SZ29SZ38SZ39SZ49SZ59SZ69SZ79SU23SU24SU25SU33SU34SU35SU36SU42SU43SU44SU45SU46SU52SU53SU54SU55SU56SU62SU63SU64SU65SU66SU72SU73SU74SU75SU76SU82SU83SU84SU85SU86SU70SU71SU72SU80SU81SU82SU83SU90SU91SU92SU93SZ79SZ89SZ99TQ00TQ01TQ02TQ03TQ10TQ11TQ12TQ13TQ20TQ21TQ22TQ23TQ30TQ31TQ32TQ20TQ21TQ22TQ23TQ30TQ31TQ32TQ33TQ40TQ41TQ42TQ43TQ44TQ50TQ51TQ52TQ53TQ54TQ60TQ61TQ62TQ63TQ70TQ71TQ72TQ80TQ81TQ82TQ91TQ92TV49TV59TV69TQ65TQ72TQ73TQ74TQ75TQ76TQ77TQ82TQ83TQ84TQ85TQ86TQ87TQ91TQ92TQ93TQ94TQ95TQ96TQ97TR01TR02TR03TR04TR05TR06TR07TR12TR13TR14TR15TR16TR23TR24TR25TR26TR27TR33TR34TR35TR36TR37TR46TR47TQ35TQ36TQ37TQ38TQ43TQ44TQ45TQ46TQ47TQ48TQ53TQ54TQ55TQ56TQ57TQ58TQ63TQ64TQ65TQ66TQ67TQ72TQ73TQ74TQ75TQ76TQ77TQ78TQ87TQ88TQ97SU83SU84SU85SU86SU93SU94SU95SU96SU97TQ03TQ04TQ05TQ06TQ07TQ13TQ14TQ15TQ16TQ17TQ23TQ24TQ25TQ26TQ27TQ33TQ34TQ35TQ36TQ37TQ38TQ43TQ44TQ45TL30TL40TL50TL60TL70TL80TL90TM00TQ38TQ39TQ47TQ48TQ49TQ57TQ58TQ59TQ67TQ68TQ69TQ77TQ78TQ79TQ88TQ89TQ98TQ99TR08TR09TR19TL30TL31TL34TL40TL41TL42TL43TL44TL50TL51TL52TL53TL54TL60TL61TL62TL63TL64TL70TL71TL72TL73TL74TL80TL81TL82TL83TL84TL90TL91TL92TL93TM01TM02TM03TM11TM12TM13TM21TM22TM23TQ49SP81SP90SP91TL00TL01TL02TL10TL11TL12TL13TL20TL21TL22TL23TL24TL30TL31TL32TL33TL34TL41TL42TL43TL44TL51TL52TQ09TQ19TQ29TQ39TL20TL30TQ06TQ07TQ08TQ09TQ16TQ17TQ18TQ19TQ27TQ28TQ29TQ37TQ38TQ39SP20SP30SP40SP41SP50SU19SU26SU27SU28SU29SU36SU37SU38SU39SU46SU47SU48SU49SU56SU57SU58SU59SU66SU67SU68SU69SU76SU77SU78SU86SU87SU88SU96SU97SU98SP10SP20SP21SP22SP23SP30SP31SP32SP33SP34SP40SP41SP42SP43SP44SP45SP50SP51SP52SP53SP54SP60SP61SP62SP63SP70SU29SU39SU49SU57SU58SU59SU67SU68SU69SU77SU78SU79SP51SP53SP60SP61SP62SP63SP64SP70SP71SP72SP73SP74SP80SP81SP82SP83SP84SP85SP90SP91SP92SP93SP94SP95SU78SU79SU88SU89SU97SU98SU99TL00TL01TQ07TQ08TQ09TG40TG50TM03TM04TM05TM06TM07TM13TM14TM15TM16TM17TM23TM24TM25TM26TM27TM28TM33TM34TM35TM36TM37TM38TM39TM44TM45TM46TM47TM48TM49TM57TM58TM59TL64TL65TL66TL67TL68TL74TL75TL76TL77TL78TL83TL84TL85TL86TL87TL88TL93TL94TL95TL96TL97TL98TM03TM04TM05TM06TM07TM08TG00TG01TG02TG03TG04TG10TG11TG12TG13TG14TG20TG21TG22TG23TG24TG30TG31TG32TG33TG40TG41TG42TG50TG51TM07TM08TM09TM17TM18TM19TM27TM28TM29TM38TM39TM49TM59TF40TF41TF42TF50TF51TF52TF53TF60TF61TF62TF63TF64TF70TF71TF72TF73TF74TF80TF81TF82TF83TF84TF90TF91TF92TF93TF94TG00TG01TG02TG03TG04TL49TL59TL68TL69TL78TL79TL87TL88TL89TL98TL99TM07TM08TM09TF20TF30TF31TF40TF41TF50TL15TL19TL23TL24TL25TL26TL28TL29TL33TL34TL35TL36TL37TL38TL39TL44TL45TL46TL47TL48TL49TL54TL55TL56TL57TL58TL59TL63TL64TL65TL66TL67TL68TL69TL75TL76SP91SP92SP93SP94SP95SP96TL01TL02TL03TL04TL05TL06TL07TL11TL12TL13TL14TL15TL16TL23TL24TL25TL06TL07TL08TL09TL15TL16TL17TL18TL19TL25TL26TL27TL28TL29TL36TL37TL38TL39SK90SP43SP44SP45SP46SP53SP54SP55SP56SP57SP58SP63SP64SP65SP66SP67SP68SP73SP74SP75SP76SP77SP78SP79SP84SP85SP86SP87SP88SP89SP95SP96SP97SP98SP99TF00TF10TF20TL06TL07TL08TL09TL18TL19TL29SO70SO71SO80SO81SO82SO83SO90SO91SO92SO93SO94SP00SP01SP02SP03SP04SP10SP11SP12SP13SP14SP15SP20SP21SP22SP23SP24SP25ST99SU09SU19SU29SO50SO51SO60SO61SO62SO63SO70SO71SO72SO73SO80SO81SO82SO83SO90ST57ST58ST59ST66ST67ST68ST69ST76ST77ST78ST79ST87ST88ST89ST98ST99SO10SO11SO20SO21SO22SO23SO30SO31SO32SO40SO41SO42SO50SO51ST18ST19ST27ST28ST29ST37ST38ST39ST47ST48ST49ST58ST59SO22SO23SO24SO25SO26SO32SO33SO34SO35SO36SO37SO41SO42SO43SO44SO45SO46SO47SO51SO52SO53SO54SO55SO56SO57SO61SO62SO63SO64SO65SO66SO73SO74SO75SO76SO56SO64SO65SO66SO67SO72SO73SO74SO75SO76SO77SO78SO82SO83SO84SO85SO86SO87SO88SO93SO94SO95SO96SO97SO98SO99SP03SP04SP05SP06SP07SP08SP13SP14SP16SP17SP18SK10SK20SK30SP04SP05SP06SP07SP08SP09SP14SP15SP16SP17SP18SP19SP22SP23SP24SP25SP26SP27SP28SP29SP33SP34SP35SP36SP37SP38SP39SP44SP45SP46SP47SP48SP49SP55SP56SP57SP58SJ63SJ70SJ71SJ72SJ73SJ74SJ75SJ80SJ81SJ82SJ83SJ84SJ85SJ86SJ90SJ91SJ92SJ93SJ94SJ95SJ96SK00SK01SK02SK03SK04SK05SK06SK10SK11SK12SK13SK14SK15SK16SK20SK21SK22SO77SO78SO79SO88SO89SO98SO99SP08SP09SP19SP29SJ20SJ21SJ22SJ23SJ30SJ31SJ32SJ33SJ34SJ40SJ41SJ42SJ43SJ50SJ51SJ52SJ53SJ54SJ60SJ61SJ62SJ63SJ64SJ70SJ71SJ72SJ73SJ74SJ80SO17SO18SO27SO28SO29SO37SO38SO39SO46SO47SO48SO49SO56SO57SO58SO59SO66SO67SO68SO69SO77SO78SO79SO88SO89SN50SN60SN61SN70SN71SN80SN81SN90SO00SO01SO10SO11SS38SS39SS48SS49SS58SS59SS68SS69SS77SS78SS79SS87SS88SS89SS96SS97SS98SS99ST06ST07ST08ST09ST16ST17ST18ST19ST26ST27ST28SN70SN71SN74SN80SN81SN82SN83SN84SN85SN86SN90SN91SN92SN93SN94SN95SN96SO00SO01SO02SO03SO04SO05SO06SO10SO11SO12SO13SO14SO21SO22SO23SO24SN86SN87SN96SN97SO04SO05SO06SO07SO08SO13SO14SO15SO16SO17SO18SO24SO25SO26SO27SO36SO37SN01SN02SN10SN11SN12SN20SN21SN22SN23SN24SN30SN31SN32SN33SN34SN40SN41SN42SN43SN44SN50SN51SN52SN53SN54SN60SN61SN62SN63SN64SN65SN71SN72SN73SN74SN75SN81SN82SN83SN84SS39SS49SS59SM50SM62SM70SM71SM72SM73SM80SM81SM82SM83SM84SM90SM91SM92SM93SM94SN00SN01SN02SN03SN04SN10SN11SN12SN13SN14SN22SN23SN24SR89SR99SS09SS19SN14SN15SN24SN25SN33SN34SN35SN36SN44SN45SN46SN54SN55SN56SN57SN58SN64SN65SN66SN67SN68SN69SN74SN75SN76SN77SN78SN79SN84SN85SN86SN87SN88SN89SH70SH71SH80SH81SH90SH91SH92SJ00SJ01SJ02SJ03SJ10SJ11SJ12SJ20SJ21SJ22SJ31SN69SN78SN79SN87SN88SN89SN97SN98SN99SO07SO08SO09SO18SO19SO28SO29SO39SH50SH51SH52SH53SH54SH60SH61SH62SH63SH64SH70SH71SH72SH73SH74SH80SH81SH82SH83SH84SH91SH92SH93SH94SH95SJ03SJ04SJ05SJ13SJ14SN59SN69SN79SH12SH13SH22SH23SH24SH32SH33SH34SH43SH44SH45SH46SH53SH54SH55SH56SH57SH64SH65SH66SH67SH74SH75SH76SH77SH78SH84SH85SH86SH87SH88SH74SH75SH76SH77SH84SH85SH86SH87SH88SH94SH95SH96SH97SH98SJ02SJ03SJ04SJ05SJ06SJ07SJ08SJ12SJ13SJ14SJ15SJ16SJ17SJ22SJ23SJ24SJ25SJ26SJ33SJ34SJ35SJ43SJ44SJ45SJ53SJ54SH97SH98SJ06SJ07SJ08SJ15SJ16SJ17SJ18SJ25SJ26SJ27SJ35SJ36SJ37SH27SH28SH29SH36SH37SH38SH39SH46SH47SH48SH49SH56SH57SH58SH59SH67SH68SK81SK82SK83SK84SK85SK86SK87SK90SK91SK92SK93SK94SK95SK96SK97TF00TF01TF02TF03TF04TF05TF06TF07TF10TF11TF12TF13TF14TF15TF16TF17TF20TF21TF22TF23TF24TF25TF30TF31TF32TF33TF34TF41TF42TF43TF44TF52SE60SE70SE71SE80SE81SE82SE90SE91SE92SK78SK79SK87SK88SK89SK97SK98SK99TA00TA01TA02TA10TA11TA12TA20TA21TA30TA31TA40TF07TF08TF09TF15TF16TF17TF18TF19TF24TF25TF26TF27TF28TF29TF33TF34TF35TF36TF37TF38TF39TF43TF44TF45TF46TF47TF48TF49TF54TF55TF56TF57TF58SK20SK21SK30SK31SK32SK40SK41SK42SK43SK50SK51SK52SK60SK61SK62SK70SK71SK72SK73SK74SK80SK81SK82SK83SK84SK90SK91SP39SP48SP49SP57SP58SP59SP68SP69SP78SP79SP89SP99TF00TF01SE60SE70SK42SK43SK44SK45SK46SK52SK53SK54SK55SK56SK57SK58SK59SK62SK63SK64SK65SK66SK67SK68SK69SK72SK73SK74SK75SK76SK77SK78SK79SK84SK85SK86SK87SK88SK89SK97SJ98SJ99SK03SK06SK07SK08SK09SK11SK12SK13SK14SK15SK16SK17SK18SK19SK21SK22SK23SK24SK25SK26SK27SK28SK31SK32SK33SK34SK35SK36SK37SK38SK42SK43SK44SK45SK46SK47SK48SK53SK56SK57SD90SE00SE10SJ18SJ19SJ27SJ28SJ29SJ35SJ36SJ37SJ38SJ39SJ44SJ45SJ46SJ47SJ48SJ54SJ55SJ56SJ57SJ58SJ63SJ64SJ65SJ66SJ67SJ68SJ69SJ74SJ75SJ76SJ77SJ78SJ79SJ85SJ86SJ87SJ88SJ89SJ96SJ97SJ98SJ99SK06SK07SK08SK09SK19SD20SD21SD22SD30SD31SD32SD40SD41SD42SD50SD51SD52SD53SD60SD61SD62SD63SD70SD71SD72SD73SD74SD80SD81SD82SD83SD84SD90SD91SD92SD93SD94SJ29SJ38SJ39SJ48SJ49SJ58SJ59SJ68SJ69SJ79SJ88SJ89SJ99SD22SD23SD32SD33SD34SD35SD36SD42SD43SD44SD45SD46SD47SD52SD53SD54SD55SD56SD57SD63SD64SD65SD66SD67SD68SD73SD78SE53SE54SE62SE63SE64SE65SE72SE73SE74SE75SE76SE82SE83SE84SE85SE86SE87SE92SE93SE94SE95SE96SE97SE98TA02TA03TA04TA05TA06TA07TA08TA12TA13TA14TA15TA16TA17TA18TA21TA22TA23TA24TA26TA27TA31TA32TA33TA41TA42NZ30NZ31NZ40NZ41NZ42NZ50NZ51NZ52NZ60NZ61NZ62NZ70NZ71NZ72NZ80NZ81NZ90NZ91SE37SE38SE39SE46SE47SE48SE49SE55SE56SE57SE58SE59SE64SE65SE66SE67SE68SE69SE75SE76SE77SE78SE79SE86SE87SE88SE89SE97SE98SE99TA08TA09TA18SD84SD90SD91SD92SD93SD94SD95SE00SE01SE02SE03SE04SE10SE11SE12SE13SE14SE20SE21SE22SE23SE30SE31SE32SE33SE40SE41SE42SE50SE51SE52SE60SE61SE62SE70SE71SE72SE81SE82SK18SK19SK28SK29SK38SK39SK47SK48SK49SK57SK58SK59SK69SD54SD55SD64SD65SD66SD67SD68SD73SD74SD75SD76SD77SD78SD84SD85SD86SD87SD88SD94SD95SD96SD97SD98SE04SE05SE06SE07SE13SE14SE15SE16SE17SE23SE24SE25SE26SE27SE32SE33SE34SE35SE36SE37SE42SE43SE44SE45SE46SE52SE53SE54SE55SE56SE62SE63SE64SE65SE72NY72NY80NY81NY82NY90NY91NY92NZ00NZ01NZ02NZ10NZ11NZ20NZ21NZ30NZ31SD68SD69SD78SD79SD88SD89SD97SD98SD99SE07SE08SE09SE17SE18SE19SE27SE28SE29SE36SE37SE38SE39SE46SE47NY73NY74NY82NY83NY84NY92NY93NY94NY95NZ01NZ02NZ03NZ04NZ05NZ11NZ12NZ13NZ14NZ15NZ16NZ20NZ21NZ22NZ23NZ24NZ25NZ26NZ30NZ31NZ32NZ33NZ34NZ35NZ36NZ41NZ42NZ43NZ44NZ45NZ46NZ52NZ53NT60NT70NT80NT90NU00NU10NU20NY58NY59NY64NY65NY66NY67NY68NY69NY74NY75NY76NY77NY78NY79NY84NY85NY86NY87NY88NY89NY94NY95NY96NY97NY98NY99NZ04NZ05NZ06NZ07NZ08NZ09NZ15NZ16NZ17NZ18NZ19NZ26NZ27NZ28NZ29NZ36NZ37NZ38NZ39NT70NT71NT73NT80NT81NT82NT83NT84NT90NT91NT92NT93NT94NT95NU00NU01NU02NU03NU04NU05NU10NU11NU12NU13NU14NU20NU21NU22NU23NZ09NZ19NY20NY21NY30NY31NY40NY41NY42NY50NY51NY52NY53NY60NY61NY62NY63NY70NY71NY72NY73NY80NY81NY82NY83SD16SD17SD18SD19SD26SD27SD28SD29SD36SD37SD38SD39SD46SD47SD48SD49SD57SD58SD59SD67SD68SD69SD78SD79SD89NX90NX91NX92NX93NY00NY01NY02NY03NY04NY05NY10NY11NY12NY13NY14NY15NY16NY20NY21NY22NY23NY24NY25NY26NY31NY32NY33NY34NY35NY36NY37NY41NY42NY43NY44NY45NY46NY47NY48NY52NY53NY54NY55NY56NY57NY58NY62NY63NY64NY65NY66NY67NY68NY73NY74NY75NY84SD08SD09SD17SD18SD19SD28SD29NX30NX40SC16SC17SC26SC27SC28SC36SC37SC38SC39SC47SC48SC49NS60NS61NS70NS71NS72NS80NS81NS90NT00NT01NT10NT11NT20NT21NT30NX69NX78NX79NX88NX89NX96NX97NX98NX99NY05NY06NY07NY08NY09NY16NY17NY18NY19NY26NY27NY28NY29NY36NY37NY38NY39NY47NY48NY49NS50NS60NX36NX37NX38NX45NX46NX47NX48NX49NX54NX55NX56NX57NX58NX59NX64NX65NX66NX67NX68NX69NX74NX75NX76NX77NX78NX79NX84NX85NX86NX87NX88NX95NX96NX97NX98NY05NY06NW95NW96NW97NX03NX04NX05NX06NX07NX13NX14NX15NX16NX17NX24NX25NX26NX27NX33NX34NX35NX36NX37NX43NX44NX45NX46NS00NS10NS14NS15NS16NS20NS21NS23NS24NS25NS26NS30NS31NS32NS33NS34NS35NS36NS40NS41NS42NS43NS44NS45NS50NS51NS52NS53NS54NS55NS60NS61NS62NS63NS64NS71NS72NS73NX07NX08NX09NX17NX18NX19NX27NX28NX29NX37NX38NX39NX48NX49NX59NS16NS17NS26NS27NS35NS36NS37NS44NS45NS46NS47NS54NS55NS56NS64NS65NS66NS53NS54NS55NS56NS57NS63NS64NS65NS66NS67NS71NS72NS73NS74NS75NS76NS77NS80NS81NS82NS83NS84NS85NS86NS87NS90NS91NS92NS93NS94NS95NS96NT00NT01NT02NT03NT04NT05NT14NT01NT02NT03NT04NT05NT11NT12NT13NT14NT15NT21NT22NT23NT24NT25NT32NT33NT34NT10NT11NT20NT21NT22NT23NT30NT31NT32NT33NT34NT41NT42NT43NT44NT53NT20NT30NT31NT40NT41NT42NT43NT44NT50NT51NT52NT53NT54NT60NT61NT62NT63NT64NT70NT71NT72NT73NT74NT81NT82NT83NY39NY47NY48NY49NY58NY59NY69NT44NT45NT46NT53NT54NT55NT56NT63NT64NT65NT66NT73NT74NT75NT76NT77NT83NT84NT85NT86NT87NT94NT95NT96NT36NT37NT45NT46NT47NT48NT55NT56NT57NT58NT65NT66NT67NT68NT76NT77NS95NS96NT05NT06NT15NT16NT17NT24NT25NT26NT27NT34NT35NT36NT37NT43NT44NT45NT46NS86NS87NS95NS96NS97NS98NT06NT07NT08NT16NT17NO00NO01NO10NO11NO20NO21NO22NO30NO31NO32NO40NO41NO42NO50NO51NO52NO60NO61NS99NT08NT09NT18NT19NT28NT29NT39NT49NT59NT69NN30NN31NN40NN41NS38NS39NS47NS48NS49NS57NS58NS59NS67NS68NS69NS77NS78NS79NS86NS87NS88NS89NS97NS98NN21NN22NN30NN31NN32NN40NN41NN42NN50NN51NN52NN60NN61NN70NN71NN80NN81NN90NN91NO00NS49NS59NS69NS79NS88NS89NS98NS99NT08NT09NN22NN23NN32NN33NN34NN35NN42NN43NN44NN45NN46NN47NN51NN52NN53NN54NN55NN56NN57NN61NN62NN63NN64NN65NN66NN67NN71NN72NN73NN74NN75NN76NN77NN81NN82NN83NN84NN85NN86NN90NN91NN92NN93NN94NN95NN96NO00NO01NO02NO03NO04NO11NO12NO13NO21NN56NN57NN66NN67NN68NN76NN77NN78NN86NN87NN88NN94NN95NN96NN97NN98NO02NO03NO04NO05NO06NO07NO08NO11NO12NO13NO14NO15NO16NO17NO21NO22NO23NO24NO25NO32NO33NO34NO15NO16NO17NO23NO24NO25NO26NO27NO28NO32NO33NO34NO35NO36NO37NO38NO42NO43NO44NO45NO46NO47NO48NO53NO54NO55NO56NO57NO58NO63NO64NO65NO66NO67NO74NO75NO76NJ60NJ70NJ80NJ90NO57NO58NO66NO67NO68NO69NO76NO77NO78NO79NO86NO87NO88NO89NO99NH90NJ00NJ10NJ11NJ20NJ21NJ30NJ31NJ32NJ40NJ41NJ42NJ50NJ51NJ52NJ60NJ61NJ62NJ70NJ71NJ72NJ80NJ81NJ82NJ90NJ91NJ92NK02NN98NN99NO07NO08NO09NO17NO18NO19NO27NO28NO29NO37NO38NO39NO48NO49NO58NO59NO68NO69NO79NO89NJ31NJ32NJ33NJ34NJ42NJ43NJ44NJ52NJ53NJ54NJ55NJ62NJ63NJ64NJ65NJ72NJ73NJ74NJ75NJ76NJ82NJ83NJ84NJ85NJ86NJ92NJ93NJ94NJ95NJ96NK02NK03NK04NK05NK06NK13NK14NK15NH90NJ00NJ01NJ10NJ11NJ12NJ13NJ14NJ21NJ22NJ23NJ24NJ25NJ32NJ33NJ34NJ35NJ36NJ42NJ43NJ44NJ45NJ46NJ54NJ55NJ56NJ64NJ65NJ66NJ74NJ75NJ76NJ86NN99NH72NH81NH82NH91NH92NH93NH94NH95NH96NJ00NJ01NJ02NJ03NJ04NJ05NJ06NJ11NJ12NJ13NJ14NJ15NJ16NJ17NJ23NJ24NJ25NJ26NJ27NJ34NJ35NJ36NJ45NH01NH02NH10NH11NH12NH13NH14NH20NH21NH22NH23NH24NH30NH31NH32NH33NH34NH40NH41NH42NH43NH44NH50NH51NH52NH53NH54NH60NH61NH62NH63NH64NH70NH71NH72NH73NH74NH75NH80NH81NH82NH83NH84NH85NH90NH91NH92NH93NH94NH95NH96NJ00NJ01NN39NN46NN47NN48NN49NN56NN57NN58NN59NN67NN68NN69NN77NN78NN79NN88NN89NN98NN99NG60NG70NG71NG72NG80NG81NG82NG90NG91NH00NH01NH10NH20NH30NM46NM47NM54NM55NM56NM57NM64NM65NM66NM67NM68NM69NM74NM75NM76NM77NM78NM79NM84NM85NM86NM87NM88NM89NM95NM96NM97NM98NM99NN05NN06NN07NN08NN09NN16NN17NN18NN19NN26NN27NN28NN29NN35NN36NN37NN38NN39NN46NN47NN48NN49NN57NN58NN59NM70NM71NM72NM73NM80NM81NM82NM83NM84NM90NM91NM92NM93NM94NM95NN00NN01NN02NN03NN04NN05NN10NN11NN12NN13NN14NN15NN16NN20NN21NN22NN23NN24NN25NN26NN30NN33NN34NN35NN36NN44NN45NN46NR79NR88NR89NR96NR97NR98NR99NS06NS07NS08NS09NS16NS17NS18NS19NS28NS29NN20NN21NN30NN31NS28NS29NS37NS38NS39NS46NS47NS48NS56NS57NR82NR83NR84NR92NR93NR94NR95NR96NR97NS01NS02NS03NS04NS05NS06NS07NS15NS16NR50NR51NR60NR61NR62NR63NR64NR65NR67NR68NR70NR71NR72NR73NR74NR75NR76NR77NR78NR79NR83NR84NR85NR86NR87NR88NR89NR95NR96NM40NM60NM61NM70NM71NR15NR16NR24NR25NR26NR27NR34NR35NR36NR37NR38NR39NR44NR45NR46NR47NR48NR49NR56NR57NR58NR59NR67NR68NR69NR79NL93NL94NM04NM05NM15NM16NM21NM22NM23NM24NM25NM26NM31NM32NM33NM34NM35NM41NM42NM43NM44NM45NM51NM52NM53NM54NM55NM61NM62NM63NM64NM72NM73NG13NG14NG15NG20NG23NG24NG25NG26NG30NG31NG32NG33NG34NG35NG36NG37NG38NG40NG41NG42NG43NG44NG45NG46NG47NG50NG51NG52NG53NG54NG55NG56NG60NG61NG62NG63NG64NG65NG66NG71NG72NG82NM19NM29NM37NM38NM39NM47NM48NM49NM59NB90NB91NC00NC01NC10NC11NC20NC21NG63NG64NG65NG72NG73NG74NG75NG76NG77NG78NG79NG82NG83NG84NG85NG86NG87NG88NG89NG91NG92NG93NG94NG95NG96NG97NG98NG99NH00NH01NH02NH03NH04NH05NH06NH07NH08NH09NH10NH11NH15NH16NH17NH18NH19NH27NH28NH29NC10NC20NC21NC30NC31NC40NH02NH03NH04NH05NH06NH07NH12NH13NH14NH15NH16NH17NH19NH23NH24NH25NH26NH27NH28NH29NH34NH35NH36NH37NH38NH39NH44NH45NH46NH47NH48NH49NH54NH55NH56NH57NH58NH59NH64NH65NH66NH67NH68NH69NH75NH76NH77NH78NH86NH87NH88NH97NH98NC22NC30NC31NC32NC33NC40NC41NC42NC43NC50NC51NC52NC60NC61NC62NC63NC70NC71NC72NC73NC74NC80NC81NC82NC83NC84NC90NC91NC92NC93ND01ND02NH49NH59NH68NH69NH78NH79NH88NH89NC01NC02NC03NC10NC11NC12NC13NC14NC15NC16NC20NC21NC22NC23NC24NC25NC26NC27NC31NC32NC33NC34NC35NC36NC37NC42NC43NC44NC45NC46NC52NC53NC54NC55NC56NC62NC63NC64NC65NC66NC73NC74NC75NC76NC83NC84NC85NC86NC93NC94NC95NC96NC92NC93NC94NC95NC96ND01ND02ND03ND04ND05ND06ND07ND12ND13ND14ND15ND16ND17ND23ND24ND25ND26ND27ND33ND34ND35ND36ND37ND47HW63HW83HX62NA00NA10NA64NA74NA81NA90NA91NA92NA93NB00NB01NB02NB03NB10NB11NB12NB13NB14NB20NB21NB22NB23NB24NB30NB31NB32NB33NB34NB35NB40NB41NB42NB43NB44NB45NB46NB52NB53NB54NB55NB56NF09NF19NF56NF58NF60NF61NF66NF67NF68NF70NF71NF72NF73NF74NF75NF76NF77NF80NF81NF82NF83NF84NF85NF86NF87NF88NF89NF95NF96NF97NF98NF99NG07NG08NG09NG18NG19NG29NG49NL57NL58NL68NL69NL79HY10HY20HY21HY22HY23HY30HY31HY32HY33HY34HY35HY40HY41HY42HY43HY44HY45HY50HY51HY52HY53HY54HY55HY60HY61HY62HY63HY64HY73HY74HY75ND19ND28ND29ND38ND39ND47ND48ND49ND59HP40HP50HP51HP60HP61HT93HT94HU14HU15HU16HU24HU25HU26HU27HU28HU30HU31HU32HU33HU34HU35HU36HU37HU38HU39HU40HU41HU42HU43HU44HU45HU46HU47HU48HU49HU53HU54HU55HU56HU57HU58HU59HU66HU67HU68HU69HZ16HZ17HZ26HZ27';\r\n\r\n\t/**\r\n\t *\r\n\t * @param {number} precision metres\r\n\t * @returns {string}\r\n\t */\r\n\ttoGridRefString(precision) {\r\n\t\tconst hundredkmE = this.x / 100000 | 0; // Math.floor(this.x / 100000);\r\n\t\tconst hundredkmN = this.y / 100000 | 0; // Math.floor(this.y / 100000);\r\n\t\tlet firstLetter;\r\n\t\tif (hundredkmN < 5) {\r\n\t\t\tfirstLetter = (hundredkmE < 5) ? 'S' : 'T';\r\n\t\t} else if (hundredkmN < 10) {\r\n\t\t\tfirstLetter = (hundredkmE < 5) ? 'N' : 'O';\r\n\t\t} else {\r\n\t\t\tfirstLetter = (hundredkmE < 5) ? 'H' : 'J';\r\n\t\t}\r\n\r\n\r\n\t\tlet index = 65 + ((4 - (hundredkmN % 5)) * 5) + (hundredkmE % 5);\r\n\r\n\t\tif (index >= 73) {\r\n\t\t\tindex++;\r\n\t\t}\r\n\r\n\t\tconst secondLetter = String.fromCharCode(index);\r\n\r\n\t\treturn _e_n_to_gr(\r\n\t\t\tfirstLetter + secondLetter,\r\n\t\t\t(this.x - (100000 * hundredkmE)),\r\n\t\t\t(this.y - (100000 * hundredkmN)),\r\n\t\t\tprecision ? precision : 1\r\n\t\t);\r\n\t};\r\n\r\n\t/**\r\n\t *\r\n\t * @return {string} hectad\r\n\t */\r\n\ttoHectad() {\r\n\t\tconst hundredkmE = this.x / 100000 | 0; // Math.floor(easting / 100000);\r\n\t\tconst hundredkmN = this.y / 100000 | 0; // Math.floor(northing / 100000);\r\n\t\tlet firstLetter;\r\n\t\tif (hundredkmN < 5) {\r\n\t\t\tfirstLetter = (hundredkmE < 5) ? 'S' : 'T';\r\n\t\t} else if (hundredkmN < 10) {\r\n\t\t\tfirstLetter = (hundredkmE < 5) ? 'N' : 'O';\r\n\t\t} else {\r\n\t\t\tfirstLetter = (hundredkmE < 5) ? 'H' : 'J';\r\n\t\t}\r\n\r\n\t\tlet index = 65 + ((4 - (hundredkmN % 5)) * 5) + (hundredkmE % 5);\r\n\r\n\t\tif (index >= 73) {\r\n\t\t\tindex++;\r\n\t\t}\r\n\r\n\t\treturn firstLetter +\r\n\t\t\tString.fromCharCode(index) + // secondLetter\r\n\t\t\t(((this.x - (100000 * hundredkmE)) / 10000) | 0) +\r\n\t\t\t(((this.y - (100000 * hundredkmN)) / 10000) | 0);\r\n\t};\r\n\r\n\t/**\r\n\t *\r\n\t * @returns {boolean}\r\n\t */\r\n\tis_gb_hectad() {\r\n\t\treturn GridCoordsGB.gbHectads.indexOf(this.toHectad()) !== -1;\r\n\t};\r\n\r\n\t/**\r\n\t * convert easting,northing to a WGS84 lat lng\r\n\t *\r\n\t * @returns {LatLngWGS84}\r\n\t */\r\n\ttoLatLng() {\r\n\t\t//airy1830 = RefEll::airy1830(); //new RefEll(6377563.396, 6356256.909);\r\n\t\t//var OSGB_F0 = 0.9996012717;\r\n\t\t//var N0 = -100000.0;\r\n\t\tconst E0 = 400000.0;\r\n\t\tconst phi0 = 0.85521133347722; //deg2rad(49.0);\r\n\t\tconst lambda0 = -0.034906585039887; //deg2rad(-2.0);\r\n\t\tconst a = 6377563.396; // airy1830->maj;\r\n\t\t//var b = 6356256.909; // airy1830->min;\r\n\t\tconst eSquared = 0.00667054007; // ((maj * maj) - (min * min)) / (maj * maj); // airy1830->ecc;\r\n\t\t//var phi = 0.0;\r\n\t\t//var lambda = 0.0;\r\n\t\tconst E = this.x;\r\n\t\tconst N = this.y;\r\n\t\tconst n = 0.0016732203289875; //(a - b) / (a + b);\r\n\t\tlet M;\r\n\t\tlet phiPrime = ((N + 100000) / (a * 0.9996012717)) + phi0;\r\n\r\n\t\t// 15 / 8 === 1.875\r\n\t\t// 5 / 4 === 1.25\r\n\t\t// 21 / 8 === 2.625\r\n\r\n\t\tdo {\r\n\t\t\tM = N + 100000 - (\r\n\t\t\t\t6353722.489 // (b * OSGB_F0)\r\n\t\t\t\t* ((1.0016767257674 // * (((1 + n + (1.25 * n * n) + (1.25 * n * n * n))\r\n\t\t\t\t\t\t* (phiPrime - phi0))\r\n\t\t\t\t\t- (0.00502807228247412 // - (((3 * n) + (3 * n * n) + (2.625 * n * n * n))\r\n\t\t\t\t\t\t* Math.sin(phiPrime - phi0)\r\n\t\t\t\t\t\t* Math.cos(phiPrime + phi0))\r\n\t\t\t\t\t+ (((1.875 * n * n) + (1.875 * n * n * n))\r\n\t\t\t\t\t\t* Math.sin(2.0 * (phiPrime - phi0))\r\n\t\t\t\t\t\t* Math.cos(2.0 * (phiPrime + phi0)))\r\n\t\t\t\t\t- (((35.0 / 24.0) * n * n * n)\r\n\t\t\t\t\t\t* Math.sin(3.0 * (phiPrime - phi0))\r\n\t\t\t\t\t\t* Math.cos(3.0 * (phiPrime + phi0)))));\r\n\r\n\t\t\tphiPrime += M / 6375020.48098897; // (N - N0 - M) / (a * OSGB_F0);\r\n\t\t} while (M >= 0.001);\r\n\r\n\t\tconst sinphiPrime2 = Math.sin(phiPrime) * Math.sin(phiPrime);\r\n\t\tconst tanphiPrime2 = Math.tan(phiPrime) * Math.tan(phiPrime);\r\n\t\tconst secphiPrime = 1.0 / Math.cos(phiPrime);\r\n\r\n\t\tconst v = a * 0.9996012717 * Math.pow(1.0 - eSquared * sinphiPrime2, -0.5);\r\n\r\n\t\tconst rho =\r\n\t\t\ta\r\n\t\t\t* 0.9996012717\r\n\t\t\t* (1.0 - eSquared)\r\n\t\t\t* Math.pow(1.0 - eSquared * sinphiPrime2, -1.5);\r\n\t\tconst etaSquared = (v / rho) - 1.0;\r\n\t\tconst VII = Math.tan(phiPrime) / (2 * rho * v);\r\n\t\tconst VIII =\r\n\t\t\t(Math.tan(phiPrime) / (24.0 * rho * Math.pow(v, 3.0)))\r\n\t\t\t* (5.0\r\n\t\t\t\t+ (3.0 * tanphiPrime2)\r\n\t\t\t\t+ etaSquared\r\n\t\t\t\t- (9.0 * tanphiPrime2 * etaSquared));\r\n\t\tconst IX =\r\n\t\t\t(Math.tan(phiPrime) / (720.0 * rho * Math.pow(v, 5.0)))\r\n\t\t\t* (61.0\r\n\t\t\t\t+ (90.0 * tanphiPrime2)\r\n\t\t\t\t+ (45.0 * tanphiPrime2 * tanphiPrime2));\r\n\t\tconst X = secphiPrime / v;\r\n\t\tconst XI =\r\n\t\t\t(secphiPrime / (6.0 * v * v * v))\r\n\t\t\t* ((v / rho) + (2 * tanphiPrime2));\r\n\t\tconst XII =\r\n\t\t\t(secphiPrime / (120.0 * Math.pow(v, 5.0)))\r\n\t\t\t* (5.0\r\n\t\t\t\t+ (28.0 * tanphiPrime2)\r\n\t\t\t\t+ (24.0 * tanphiPrime2 * tanphiPrime2));\r\n\t\tconst XIIA =\r\n\t\t\t(secphiPrime / (5040.0 * Math.pow(v, 7.0)))\r\n\t\t\t* (61.0\r\n\t\t\t\t+ (662.0 * tanphiPrime2)\r\n\t\t\t\t+ (1320.0 * tanphiPrime2 * tanphiPrime2)\r\n\t\t\t\t+ (720.0\r\n\t\t\t\t\t* tanphiPrime2\r\n\t\t\t\t\t* tanphiPrime2\r\n\t\t\t\t\t* tanphiPrime2));\r\n\t\tconst phi =\r\n\t\t\tphiPrime\r\n\t\t\t- (VII * Math.pow(E - E0, 2.0))\r\n\t\t\t+ (VIII * Math.pow(E - E0, 4.0))\r\n\t\t\t- (IX * Math.pow(E - E0, 6.0));\r\n\t\tconst lambda =\r\n\t\t\tlambda0\r\n\t\t\t+ (X * (E - E0))\r\n\t\t\t- (XI * Math.pow(E - E0, 3.0))\r\n\t\t\t+ (XII * Math.pow(E - E0, 5.0))\r\n\t\t\t- (XIIA * Math.pow(E - E0, 7.0));\r\n\r\n\t\treturn (new LatLngGB(rad2deg * phi, rad2deg * lambda)).toWGS84();\r\n\t}\r\n}\r\n\r\nexport class GridCoordsIE extends GridCoords {\r\n\t/**\r\n\t *\r\n\t * @type {string}\r\n\t */\r\n\tcountry = 'IE';\r\n\r\n\t/**\r\n\t * @type {GridCoordsIE}\r\n\t */\r\n\tgridCoords = null;\r\n\r\n\t/**\r\n\t *\r\n\t * @param {number} easting metres\r\n\t * @param {number} northing metres\r\n\t * @constructor\r\n\t * @returns {GridCoordsIE}\r\n\t */\r\n\tconstructor(easting, northing) {\r\n\t\tsuper();\r\n\t\tthis.x = easting;\r\n\t\tthis.y = northing;\r\n\t}\r\n\r\n\r\n\tstatic irishGrid = {\r\n\t\t0: ['V', 'Q', 'L', 'F', 'A'],\r\n\t\t1: ['W', 'R', 'M', 'G', 'B'],\r\n\t\t2: ['X', 'S', 'N', 'H', 'C'],\r\n\t\t3: ['Y', 'T', 'O', 'J', 'D']\r\n\t};\r\n\r\n\t/**\r\n\t * convert easting,northing to a WGS84 lat lng\r\n\t *\r\n\t * @returns {LatLngWGS84}\r\n\t */\r\n\ttoLatLng() {\r\n\t\t//converts OSI coords to lat/long.\r\n\r\n\t\t// Modified from OSGBtoLL, equations from USGS Bulletin 1532\r\n\t\t//East Longitudes are positive, West longitudes are negative.\r\n\t\t//North latitudes are positive, South latitudes are negative\r\n\t\t//Lat and Long are in decimal degrees.\r\n\t\t//Written by Chuck Gantz- chuck.gantz@globalstar.com\r\n\r\n\t\t// php transliteration by TH\r\n\r\n\t\t//OSIENorthing = this.y;\r\n\t\t//OSIEEasting = this.x;\r\n\r\n\t\t//constants\r\n\t\t//PI = 3.14159265;\r\n\t\t//FOURTHPI = M_PI / 4.0;\r\n\t\t//DEG2RAD = M_PI / 180.0;\r\n\t\t//RAD2DEG = 180.0 / M_PI;\r\n\t\t// ////////////////\r\n\r\n\t\tconst k0 = 1.000035; // scale factor\r\n\t\t//double a;\r\n\t\t//double eccPrimeSquared;\r\n\t\t//double N1, T1, C1, R1, D, M;\r\n\t\tconst LongOrigin = -8.0;\r\n\t\t//LatOrigin = 53.5;\r\n\t\t//LatOriginRad = LatOrigin * DEG2RAD;\r\n\r\n\t\t//UK\r\n\t\t//majoraxis=6377563.396; //Airy\r\n\t\t//a=6377563.396;\r\n\t\t//minoraxis = 6356256.91; //Airy\r\n\r\n\t\t//IE\r\n\t\t//majoraxis = 6377340.189; //Airy\r\n\t\tconst a = 6377340.189;\r\n\t\t//minoraxis = 6356034.447; //Airy\r\n\r\n\t\t//eccSquared = (majoraxis * majoraxis - minoraxis * minoraxis) / (majoraxis * majoraxis);\r\n\t\tconst eccSquared = 0.0066705402933363;\r\n\r\n\t\t//e1 = (1-Math.sqrt(1-eccSquared))/(1+Math.sqrt(1-eccSquared));\r\n\t\tconst e1 = 0.0016732203841521;\r\n\t\t//error_log(\"eccSquared={eccSquared} e1={e1}\");\r\n\r\n\t\t//only calculate M0 once since it is based on the origin of the OSGB projection, which is fixed\r\n\t\t//M0 = a*((1\t- eccSquared/4\t\t- 3*eccSquared*eccSquared/64\t- 5*eccSquared*eccSquared*eccSquared/256)*LatOriginRad\r\n\t\t//\t- (3*eccSquared/8\t+ 3*eccSquared*eccSquared/32\t+ 45*eccSquared*eccSquared*eccSquared/1024)*Math.sin(2*LatOriginRad)\r\n\t\t//\t+ (15*eccSquared*eccSquared/256 + 45*eccSquared*eccSquared*eccSquared/1024)*Math.sin(4*LatOriginRad)\r\n\t\t//\t- (35*eccSquared*eccSquared*eccSquared/3072)*Math.sin(6*LatOriginRad));\r\n\t\t//error_log(\"M0 = {M0}\");\r\n\t\tconst M0 = 5929615.3530033;\r\n\r\n\t\t//OSGBSquareToRefCoords(OSGBZone, RefEasting, RefNorthing); // Assume supplied MapInfo northing and easting take this into account\r\n\t\tconst x = this.x - 200000.0; //remove 400,000 meter false easting for longitude\r\n\t\tconst y = this.y - 250000.0; //remove 100,000 meter false easting for longitude\r\n\r\n\t\t//eccPrimeSquared = (eccSquared)/(1.0-eccSquared);\r\n\t\tconst eccPrimeSquared = 0.0067153352074207;\r\n\t\t//error_log(\"eccPrimeSquared={eccPrimeSquared}\");\r\n\r\n\t\tconst M = M0 + y / k0;\r\n\t\tconst mu = M / (a * (1 - eccSquared / 4 - 3 * eccSquared * eccSquared / 64 - 5 * eccSquared * eccSquared * eccSquared / 256));\r\n\r\n\t\tconst phi1Rad = mu + (3 * e1 / 2 - 27 * e1 * e1 * e1 / 32) * Math.sin(2 * mu)\r\n\t\t\t+ (21 * e1 * e1 / 16 - 55 * e1 * e1 * e1 * e1 / 32) * Math.sin(4 * mu)\r\n\t\t\t+ (151 * e1 * e1 * e1 / 96) * Math.sin(6 * mu);\r\n\t\t//phi1 = phi1Rad*RAD2DEG;\r\n\r\n\t\tconst N1 = a / Math.sqrt(1 - eccSquared * Math.sin(phi1Rad) * Math.sin(phi1Rad));\r\n\t\tconst T1 = Math.tan(phi1Rad) * Math.tan(phi1Rad);\r\n\t\tconst C1 = eccPrimeSquared * Math.cos(phi1Rad) * Math.cos(phi1Rad);\r\n\t\tconst R1 = a * (1 - eccSquared) / Math.pow(1 - eccSquared * Math.sin(phi1Rad) * Math.sin(phi1Rad), 1.5);\r\n\t\tconst D = x / (N1 * k0);\r\n\r\n\t\tlet Lat = phi1Rad - (N1 * Math.tan(phi1Rad) / R1) * (D * D / 2 - (5 + 3 * T1 + 10 * C1 - 4 * C1 * C1 - 9 * eccPrimeSquared) * D * D * D * D / 24\r\n\t\t\t+ (61 + 90 * T1 + 298 * C1 + 45 * T1 * T1 - 252 * eccPrimeSquared - 3 * C1 * C1) * D * D * D * D * D * D / 720);\r\n\t\tLat = Lat * rad2deg;\r\n\r\n\t\tlet Long = (D - (1 + 2 * T1 + C1) * D * D * D / 6 + (5 - 2 * C1 + 28 * T1 - 3 * C1 * C1 + 8 * eccPrimeSquared + 24 * T1 * T1)\r\n\t\t\t* D * D * D * D * D / 120) / Math.cos(phi1Rad);\r\n\r\n\t\tLong = LongOrigin + Long * rad2deg;\r\n\r\n\t\t//return new LatLng(Lat, Long);\r\n\r\n\t\t//var ll = new LatLngIE(Lat, Long); // Irish projection (modified Airy)\r\n\t\t//ll.IE_to_WGS84(); // google earth uses WGS84\r\n\r\n\t\t//return ll;\r\n\r\n\t\treturn (new LatLngIE(Lat, Long)).toWGS84();\r\n\t}\r\n\r\n\t/**\r\n\t *\r\n\t * @param {number} precision metres\r\n\t * @returns {String}\r\n\t */\r\n\ttoGridRefString(precision) {\r\n\t\tconst hundredkmE = (this.x / 100000) | 0,\r\n\t\t\thundredkmN = (this.y / 100000) | 0;\r\n\t\tif (GridCoordsIE.irishGrid[hundredkmE] && GridCoordsIE.irishGrid[hundredkmE][hundredkmN]) {\r\n\r\n\t\t\treturn _e_n_to_gr(GridCoordsIE.irishGrid[hundredkmE][hundredkmN],\r\n\t\t\t\t(this.x - (100000 * hundredkmE)),\r\n\t\t\t\t(this.y - (100000 * hundredkmN)),\r\n\t\t\t\tprecision ? precision : 1\r\n\t\t\t);\r\n\t\t} else {\r\n\t\t\treturn null;\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t *\r\n\t * @return {?string} hectad\r\n\t */\r\n\ttoHectad() {\r\n\t\tconst hundredkmE = (this.x / 100000) | 0,\r\n\t\t\thundredkmN = (this.y / 100000) | 0;\r\n\r\n\t\tif (GridCoordsIE.irishGrid[hundredkmE] && GridCoordsIE.irishGrid[hundredkmE][hundredkmN]) {\r\n\t\t\treturn (GridCoordsIE.irishGrid[hundredkmE][hundredkmN]) + Math.floor((this.x % 100000) / 10000) + Math.floor((this.y % 100000) / 10000);\r\n\t\t} else {\r\n\t\t\treturn null;\r\n\t\t}\r\n\t}\r\n}\r\n\r\nexport class GridCoordsCI extends GridCoords {\r\n\t/**\r\n\t *\r\n\t * @type {string}\r\n\t */\r\n\tcountry = 'CI';\r\n\r\n\t/**\r\n\t *\r\n\t * @param {number} easting metres\r\n\t * @param {number} northing metres\r\n\t * @constructor\r\n\t * @returns {GridCoordsCI}\r\n\t */\r\n\tconstructor(easting, northing) {\r\n\t\tsuper();\r\n\r\n\t\tthis.x = easting;\r\n\t\tthis.y = northing;\r\n\t}\r\n\r\n\t/**\r\n\t * convert easting,northing to a WGS84 lat lng\r\n\t *\r\n\t * @returns {LatLngWGS84}\r\n\t */\r\n\ttoLatLng() {\r\n\t\t//nX = north;\r\n\t\t//ex = east;\r\n\r\n\t\tconst a = 6378388.000; // INT24 ED50 semi-major\r\n\t\tconst b = 6356911.946; // INT24 ED50 semi-minor\r\n\t\tconst e0 = 500000; // easting of false origin\r\n\t\tconst n0 = 0; // northing of false origin\r\n\t\tconst f0 = 0.9996; // INT24 ED50 scale factor on central meridian\r\n\t\tconst e2 = 0.0067226700223333; // INT24 ED50 eccentricity squared\r\n\t\tconst lam0 = -0.0523598775598; // INT24 ED50 false east\r\n\t\tconst phi0 = 0; //0 * deg2rad; // INT24 ED50 false north\r\n\r\n\t\tconst af0 = a * f0;\r\n\t\tconst bf0 = b * f0;\r\n\t\tconst n = (af0 - bf0) / (af0 + bf0);\r\n\t\tconst Et = this.x - e0;\r\n\t\tconst phid = GridCoordsCI._initial_lat(this.y, n0, af0, phi0, n, bf0);\r\n\t\tconst nu = af0 / (Math.sqrt(1 - (e2 * (Math.sin(phid) * Math.sin(phid)))));\r\n\t\tconst rho = (nu * (1 - e2)) / (1 - (e2 * (Math.sin(phid)) * (Math.sin(phid))));\r\n\t\tconst eta2 = (nu / rho) - 1;\r\n\t\tconst tlat2 = Math.tan(phid) * Math.tan(phid);\r\n\t\tconst tlat4 = Math.pow(Math.tan(phid), 4);\r\n\t\tconst tlat6 = Math.pow(Math.tan(phid), 6);\r\n\t\tconst clatm1 = Math.pow(Math.cos(phid), -1);\r\n\t\tconst VII = Math.tan(phid) / (2 * rho * nu);\r\n\t\tconst VIII = (Math.tan(phid) / (24 * rho * (nu * nu * nu))) * (5 + (3 * tlat2) + eta2 - (9 * eta2 * tlat2));\r\n\t\tconst IX = ((Math.tan(phid)) / (720 * rho * Math.pow(nu, 5))) * (61 + (90 * tlat2) + (45 * tlat4));\r\n\t\tconst phip = (phid - ((Et * Et) * VII) + (Math.pow(Et, 4) * VIII) - (Math.pow(Et, 6) * IX));\r\n\t\tconst X = Math.pow(Math.cos(phid), -1) / nu;\r\n\t\tconst XI = (clatm1 / (6 * (nu * nu * nu))) * ((nu / rho) + (2 * (tlat2)));\r\n\t\tconst XII = (clatm1 / (120 * Math.pow(nu, 5))) * (5 + (28 * tlat2) + (24 * tlat4));\r\n\t\tconst XIIA = clatm1 / (5040 * Math.pow(nu, 7)) * (61 + (662 * tlat2) + (1320 * tlat4) + (720 * tlat6));\r\n\t\tconst lambdap = (lam0 + (Et * X) - ((Et * Et * Et) * XI) + (Math.pow(Et, 5) * XII) - (Math.pow(Et, 7) * XIIA));\r\n\r\n\t\t// var WGS84_AXIS = 6378137;\r\n\t\t// var WGS84_ECCENTRIC = 0.00669438037928458;\r\n\t\t//\r\n\t\t// var INT24_AXIS = 6378388.000;\r\n\t\t// var INT24_ECCENTRIC = 0.0067226700223333;\r\n\t\t// var height = 10; // dummy height\r\n\t\t// //var latLngRadians = LatLng._transform(phip, lambdap, INT24_AXIS, INT24_ECCENTRIC, height, WGS84_AXIS, WGS84_ECCENTRIC, -83.901, -98.127, -118.635, 0, 0, 0, 0);\r\n\r\n\t\tconst latLngRadians = GridCoordsCI._convert_to_wgs(phip, lambdap);\r\n\t\treturn new LatLngWGS84(latLngRadians.lat * rad2deg, latLngRadians.lng * rad2deg);\r\n\r\n\t\t//return (new LatLngCI(rad2deg * phip, rad2deg * lambdap)).to_WGS84()\r\n\t}\r\n\r\n\t/**\r\n\t *\r\n\t * @param {number} precision metres\r\n\t * @returns {?string}\r\n\t */\r\n\ttoGridRefString(precision) {\r\n\t\tif (this.y >= 5500000) {\r\n\t\t\treturn _e_n_to_gr('WA', this.x - 500000, this.y - 5500000, precision ? precision : 1);\r\n\t\t} else if (this.y < 5500000) {\r\n\t\t\treturn _e_n_to_gr('WV', this.x - 500000, this.y - 5400000, precision ? precision : 1);\r\n\t\t}\r\n\t\treturn null;\r\n\t}\r\n\r\n\t/**\r\n\t *\r\n\t * @returns {?string}\r\n\t */\r\n\ttoHectad() {\r\n\t\tif (this.y > 5500000) {\r\n\t\t\treturn 'WA' + this.x.toString().substring(1, 2) + this.y.toString().substring(2, 3);\r\n\t\t} else if (this.y < 5500000) {\r\n\t\t\treturn 'WV' + this.x.toString().substring(1, 2) + this.y.toString().substring(2, 3);\r\n\t\t}\r\n\t\treturn null;\r\n\t}\r\n\r\n\tstatic _convert_to_wgs (phip, lambdap) {\r\n\t\tconst WGS84_AXIS = 6378137;\r\n\t\tconst WGS84_ECCENTRIC = 0.00669438037928458;\r\n\t\t//OSGB_AXIS = 6377563.396;\r\n\t\t//OSGB_ECCENTRIC = 0.0066705397616;\r\n\t\t//IRISH_AXIS = 6377340.189;\r\n\t\t//IRISH_ECCENTRIC = 0.00667054015;\r\n\t\tconst INT24_AXIS = 6378388.000;\r\n\t\tconst INT24_ECCENTRIC = 0.0067226700223333;\r\n\t\tconst height = 10; // dummy height\r\n\t\treturn LatLng._transform(phip, lambdap, INT24_AXIS, INT24_ECCENTRIC, height, WGS84_AXIS, WGS84_ECCENTRIC, -83.901, -98.127, -118.635, 0, 0, 0, 0);\r\n\t}\r\n\r\n\tstatic _initial_lat (north, n0, af0, phi0, n, bf0) {\r\n\t\tlet phi1 = ((north - n0) / af0) + phi0;\r\n\t\tlet M = LatLng._marc(bf0, n, phi0, phi1);\r\n\t\tlet phi2 = ((north - n0 - M) / af0) + phi1;\r\n\t\tlet ind = 0;\r\n\t\twhile ((Math.abs(north - n0 - M) > 0.00001) && (ind < 20)) // max 20 iterations in case of error\r\n\t\t{\r\n\t\t\tind += 1;\r\n\t\t\tphi2 = ((north - n0 - M) / af0) + phi1;\r\n\t\t\tM = LatLng._marc(bf0, n, phi0, phi2);\r\n\t\t\tphi1 = phi2;\r\n\t\t}\r\n\t\treturn phi2;\r\n\t}\r\n}\r\n","import {GridCoords, TETRAD_LETTERS} from \"../GridCoords/GridCoords\";\r\n\r\n /**\r\n * x,y offsets (in metres) for tetrad letter codes\r\n * @type {Object.>}\r\n */\r\n\r\n export const TETRAD_OFFSETS = {\r\n\tE: [0, 8000], J: [2000, 8000], P: [4000, 8000], U: [6000, 8000], Z: [8000, 8000],\r\n\tD: [0, 6000], I: [2000, 6000], N: [4000, 6000], T: [6000, 6000], Y: [8000, 6000],\r\n\tC: [0, 4000], H: [2000, 4000], M: [4000, 4000], S: [6000, 4000], X: [8000, 4000],\r\n\tB: [0, 2000], G: [2000, 2000], L: [4000, 2000], R: [6000, 2000], W: [8000, 2000],\r\n\tA: [0, 0], F: [2000, 0], K: [4000, 0], Q: [6000, 0], V: [8000, 0]\r\n};\r\n\r\n/**\r\n * x,y offsets (in metres) for quadrant codes\r\n * @type {{SE: number[], SW: number[], NE: number[], NW: number[]}}\r\n */\r\nexport const QUADRANT_OFFSETS = {\r\n\tNW: [0, 5000],\r\n\tNE: [5000, 5000],\r\n\tSW: [0, 0],\r\n\tSE: [5000, 0]\r\n};\r\n\r\nexport class GridRef {\r\n\r\n\t// /**\r\n\t// * x,y offsets (in metres) for tetrad letter codes\r\n\t// * @type {Object.>}\r\n\t// */\r\n\t// static tetradOffsets = {\r\n\t// \tE: [0, 8000], J: [2000, 8000], P: [4000, 8000], U: [6000, 8000], Z: [8000, 8000],\r\n\t// \tD: [0, 6000], I: [2000, 6000], N: [4000, 6000], T: [6000, 6000], Y: [8000, 6000],\r\n\t// \tC: [0, 4000], H: [2000, 4000], M: [4000, 4000], S: [6000, 4000], X: [8000, 4000],\r\n\t// \tB: [0, 2000], G: [2000, 2000], L: [4000, 2000], R: [6000, 2000], W: [8000, 2000],\r\n\t// \tA: [0, 0], F: [2000, 0], K: [4000, 0], Q: [6000, 0], V: [8000, 0]\r\n\t// };\r\n\r\n\t// /**\r\n\t// * x,y offsets (in metres) for quadrant codes\r\n\t// * @type {{SE: number[], SW: number[], NE: number[], NW: number[]}}\r\n\t// */\r\n\t// static quadrantOffsets = {\r\n\t// \tNW: [0, 5000],\r\n\t// \tNE: [5000, 5000],\r\n\t// \tSW: [0, 0],\r\n\t// \tSE: [5000, 0]\r\n\t// };\r\n\r\n\t// /**\r\n\t// * numerical mapping of letters to numbers\r\n\t// * 'I' is omitted\r\n\t// *\r\n\t// * @type {{A: number, B: number, C: number, D: number, E: number, F: number, G: number, H: number, J: number, K: number, L: number, M: number, N: number, O: number, P: number, Q: number, R: number, S: number, T: number, U: number, V: number, W: number, X: number, Y: number, Z: number}}\r\n\t// */\r\n\t// static letterMapping = {\r\n\t// \tA: 0, B: 1, C: 2, D: 3, E: 4, F: 5, G: 6, H: 7, J: 8, K: 9,\r\n\t// \tL: 10, M: 11, N: 12, O: 13, P: 14, Q: 15, R: 16, S: 17, T: 18,\r\n\t// \tU: 19, V: 20, W: 21, X: 22, Y: 23, Z: 24\r\n\t// };\r\n\r\n\r\n\t// /**\r\n\t// * tetrad letters ordered by easting then northing (steps of 2000m)\r\n\t// * i.e. (x*4) + y\r\n\t// *\r\n\t// * where x and y are integer of (10km remainder / 2)\r\n\t// *\r\n\t// * @type {string}\r\n\t// */\r\n\t// static tetradLetters = 'ABCDEFGHIJKLMNPQRSTUVWXYZ';\r\n\r\n\t/**\r\n\t *\r\n\t * @type {string}\r\n\t */\r\n\tpreciseGridRef = '';\r\n\r\n\t/**\r\n\t * length in m (0 marks an invalid value)\r\n\t *\r\n\t * @type {number}\r\n\t */\r\n\tlength = 0;\r\n\r\n\t/**\r\n\t * @type {string}\r\n\t */\r\n\thectad = '';\r\n\r\n\t/**\r\n\t * 10km ref with tetrad suffix or ''\r\n\t * e.g. SD59A\r\n\t * @type {string}\r\n\t */\r\n\ttetrad = '';\r\n\r\n\t/**\r\n\t *\r\n\t * @type {string}\r\n\t */\r\n\ttetradLetter = '';\r\n\r\n\t/**\r\n\t * quadrant gridref(e.g. NZ34NW)\r\n\t * only set if gridref is defined at 5km or <=1km precision\r\n\t * undefined by default so need to use getter\r\n\t *\r\n\t * read using GridRef::get_quadrant\r\n\t *\r\n\t * @type {string}\r\n\t */\r\n\tquadrant = '';\r\n\r\n\t/**\r\n\t * quadrant code suffix(e.g. NW, NE, SW, SE)\r\n\t *\r\n\t * @type {string}\r\n\t */\r\n\tquadrantCode = '';\r\n\r\n\t/**\r\n\t *\r\n\t * @type {GridCoords|null}\r\n\t */\r\n\tgridCoords = null;\r\n\r\n\t/**\r\n\t *\r\n\t * @type {boolean}\r\n\t */\r\n\terror = false;\r\n\r\n\t/**\r\n\t *\r\n\t * @type {string}\r\n\t */\r\n\terrorMessage = '';\r\n\r\n\tget centrePoint() {\r\n\t\tconst centre = new GridCoords();\r\n\t\tconst halfLength = Math.floor(this.length / 2);\r\n\r\n\t\tcentre.x = this.gridCoords.x + halfLength;\r\n\t\tcentre.y = this.gridCoords.y + halfLength;\r\n\t\treturn centre;\r\n\t}\r\n\r\n\t/**\r\n\t *\r\n\t * @param {GridCoords} gridCoords centre-point to test\r\n\t * @param {number} radius default 0 for absolute point\r\n\t */\r\n\tsquareIntersectsPoint(gridCoords, radius = 1) {\r\n\t\t// const hX = gridCoords.x + this.length;\r\n\t\t// const hy = gridCoords.y + this.length;\r\n\r\n\t\tif (radius === 1) {\r\n\t\t\treturn (this.gridCoords.x <= gridCoords.x && this.gridCoords.x + this.length > gridCoords.x\r\n\t\t\t\t&& this.gridCoords.y <= gridCoords.y && this.gridCoords.y + this.length > gridCoords.y);\r\n\t\t} else {\r\n\t\t\treturn GridRef._checkOverlap(\r\n\t\t\t\tradius,\r\n\t\t\t\tgridCoords.x, gridCoords.y,\r\n\t\t\t\tthis.gridCoords.x, this.gridCoords.y,\r\n\t\t\t\tthis.gridCoords.x + this.length, this.gridCoords.y + this.length\r\n\t\t\t\t);\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * checks if any point overlaps the given circle and rectangle.\r\n\t * see https://www.geeksforgeeks.org/check-if-any-point-overlaps-the-given-circle-and-rectangle/\r\n\t *\r\n\t * @param {number} R\r\n\t * @param {number} Xc\r\n\t * @param {number} Yc\r\n\t * @param {number} X1\r\n\t * @param {number} Y1\r\n\t * @param {number} X2\r\n\t * @param {number} Y2\r\n\t * @returns {boolean}\r\n\t */\r\n\tstatic _checkOverlap(R, Xc, Yc, X1, Y1, X2, Y2) {\r\n\r\n\t\t// Find the nearest point on the\r\n\t\t// rectangle to the center of\r\n\t\t// the circle\r\n\t\tlet Xn = Math.max(X1, Math.min(Xc, X2));\r\n\t\tlet Yn = Math.max(Y1, Math.min(Yc, Y2));\r\n\r\n\t\t// Find the distance between the\r\n\t\t// nearest point and the center\r\n\t\t// of the circle\r\n\t\t// Distance between 2 points,\r\n\t\t// (x1, y1) & (x2, y2) in\r\n\t\t// 2D Euclidean space is\r\n\t\t// ((x1-x2)**2 + (y1-y2)**2)**0.5\r\n\t\tlet Dx = Xn - Xc;\r\n\t\tlet Dy = Yn - Yc;\r\n\t\treturn (Dx * Dx + Dy * Dy) <= R * R;\r\n\t}\r\n\r\n\t/**\r\n\t * Update tetrad using Easting/Northing values (metres)\r\n\t * Hectad should have been set prior to calling.\r\n\t */\r\n\tsetTetrad() {\r\n\t\tthis.tetradLetter = TETRAD_LETTERS.charAt(\r\n\t\t\t((Math.floor((this.gridCoords.x % 10000) / 1000) >> 1) * 5) + (Math.floor((this.gridCoords.y % 10000) / 1000) >> 1));\r\n\r\n\t\tif (!this.tetradLetter) {\r\n\t\t\tthrow new Error(\"Failed to get tetrad letter when processing '\" + this.preciseGridRef + \"', easting=\" + this.gridCoords.x + \" northing=\" + this.gridCoords.y);\r\n\t\t}\r\n\t\tthis.tetrad = this.hectad + this.tetradLetter;\r\n\t}\r\n\r\n\t/**\r\n\t *\r\n\t * @param {number} rawPrecision\r\n\t * @param {number} [minPrecision]\r\n\t * @returns {number}\r\n\t */\r\n\tstatic getNormalizedPrecision(rawPrecision, minPrecision) {\r\n\t\treturn rawPrecision > 2000 ? 10000 :\r\n\t\t\t(rawPrecision > 1000 ? 2000 :\r\n\t\t\t\t\t(rawPrecision > 100 ? 1000 :\r\n\t\t\t\t\t\t\t(rawPrecision > 10 ? 100 :\r\n\t\t\t\t\t\t\t\t\t(rawPrecision > 1 ? 10 :\r\n\t\t\t\t\t\t\t\t\t\t\tminPrecision ? minPrecision : 1\r\n\t\t\t\t\t\t\t\t\t)\r\n\t\t\t\t\t\t\t)\r\n\t\t\t\t\t)\r\n\t\t\t);\r\n\t}\r\n\r\n\t/**\r\n\t * used for GB grid-refs and invoked as parent for the Channel Islands\r\n\t *\r\n\t * @param {?number} significantPrecision default null (precision in metres of centroid diameter)\r\n\t *\r\n\t * @return {string}\r\n\t */\r\n\ttoHtml(significantPrecision = null) {\r\n\t\tlet formattedGr;\r\n\r\n\t\tif (!significantPrecision || significantPrecision === this.length) {\r\n\t\t\tif (this.length <= 1000) {\r\n\t\t\t\tlet halfNumLen = ((this.preciseGridRef.length - 2) / 2) | 0;\r\n\t\t\t\tformattedGr = this.preciseGridRef.substring(0, 2) +\r\n\t\t\t\t\t\"\" + this.preciseGridRef.substring(2, 2 + halfNumLen) +\r\n\t\t\t\t\t\"\" + this.preciseGridRef.substring(2 + halfNumLen) + \"\";\r\n\t\t\t} else {\r\n\t\t\t\tformattedGr = this.preciseGridRef;\r\n\t\t\t}\r\n\t\t} else {\r\n\t\t\tif (this.length === 2000) {\r\n\t\t\t\t// reduced precision means greying the tetrad code\r\n\r\n\t\t\t\tformattedGr = `${this.hectad}${this.tetradLetter}`;\r\n\t\t\t} else if (this.length === 5000) {\r\n\t\t\t\t// reduced precision means greying the quadrant code\r\n\r\n\t\t\t\tformattedGr = `${this.hectad}${this.quadrantCode}`;\r\n\t\t\t} else {\r\n\t\t\t\tif (significantPrecision > 5000) {\r\n\t\t\t\t\t// large and probably spurious precision value - so grey-out the entire grid-reference\r\n\t\t\t\t\tformattedGr = `${this.preciseGridRef}`;\r\n\t\t\t\t} else {\r\n\t\t\t\t\tlet columns = (5 + Math.log10(1 / significantPrecision)) | 0; // number of sig figures\r\n\t\t\t\t\tlet halfNumLen = ((this.preciseGridRef.length - 2) / 2) | 0;\r\n\r\n\t\t\t\t\tformattedGr = this.preciseGridRef.substring(0, 2) + \"\" + this.preciseGridRef.substring(2, 2 + columns) + \"\" +\r\n\t\t\t\t\t\t\"\" + this.preciseGridRef.substring(columns + 2, 2 + halfNumLen) + \"\" +\r\n\t\t\t\t\t\t\"\" + this.preciseGridRef.substring(2 + halfNumLen, 2 + halfNumLen + columns) + \"\" +\r\n\t\t\t\t\t\t\"\" + this.preciseGridRef.substring(2 + halfNumLen + columns) + \"\"\r\n\t\t\t\t\t;\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\treturn formattedGr;\r\n\t}\r\n\r\n\t/**\r\n\t * Interleaves xy co-ordinate pairs at each resolution\r\n\t * also includes hectad level precision as a separate 5 x 5 tier\r\n\t * DOES NOT SUPPORT QUADRANTS, which are stripped out.\r\n\t *\r\n\t * @param {string} gridRefString\r\n\t * @return {string}\r\n\t * @throws Error\r\n\t */\r\n\tstatic interleave(gridRefString) {\r\n\t\tif (!gridRefString) {\r\n\t\t\treturn '';\r\n\t\t}\r\n\r\n\t\tlet tetrad;\r\n\r\n\t\tif (gridRefString.length > 3) {\r\n\r\n\t\t\tif (gridRefString.includes('NENWSESW', gridRefString.length - 2)) {\r\n\t\t\t//if (str_contains('NENWSESW', substr(gridRefString, -2))) {\r\n\r\n\t\t\t\tgridRefString = gridRefString.substring(0, gridRefString.length - 2);\r\n\t\t\t\ttetrad = '';\r\n\r\n\t\t\t} else if (gridRefString.substring(gridRefString.length - 1).match(/a-z/i)) {\r\n\t\t\t//} else if (ctype_alpha(substr(gridRefString, -1))) {\r\n\r\n\t\t\t\tlet o = TETRAD_LETTERS.indexOf(gridRefString.substring(gridRefString.length - 1))\r\n\t\t\t\t//let o = strpos(TETRAD_LETTERS, substr(gridRefString, -1));\r\n\r\n\t\t\t\tgridRefString = gridRefString.substring(0, gridRefString.length - 1);\r\n\t\t\t\ttetrad = `${(o / 5)|0}${o % 5}`;\r\n\t\t\t} else {\r\n\t\t\t\ttetrad = '';\r\n\t\t\t}\r\n\t\t} else {\r\n\t\t\ttetrad = '';\r\n\t\t}\r\n\r\n\t\tswitch (gridRefString.length) {\r\n\t\t\tcase 0:\r\n\t\t\t\treturn '';\r\n\r\n\t\t\tcase 1:\r\n\t\t\t\treturn `_${gridRefString}`;\r\n\r\n\t\t\tcase 2:\r\n\t\t\t\treturn gridRefString;\r\n\r\n\t\t\tcase 3:\r\n\t\t\t\treturn `_${gridRefString}${tetrad}`;\r\n\r\n\t\t\tcase 4:\r\n\t\t\t\treturn `${gridRefString}${tetrad}`;\r\n\r\n\t\t\tcase 5:\r\n\t\t\t\treturn `_${gridRefString.substring(0, 2)}${gridRefString[3]}${gridRefString[2] >> 1}${gridRefString[4] >> 1}${gridRefString[2]}${gridRefString[4]}`;\r\n\r\n\t\t\tcase 6:\r\n\t\t\t\treturn `${gridRefString.substring(0, 3)}${gridRefString[4]}${gridRefString[3] >> 1}${gridRefString[5] >> 1}${gridRefString[3]}${gridRefString[5]}`;\r\n\r\n\t\t\tcase 7:\r\n\t\t\t\treturn `_${gridRefString.substring(0, 2)}${gridRefString[4]}${gridRefString[2] >> 1}${gridRefString[5] >> 1}${gridRefString[2]}${gridRefString[5]}${gridRefString[3]}${gridRefString[6]}`;\r\n\r\n\t\t\tcase 8:\r\n\t\t\t\treturn `${gridRefString.substring(0, 3)}${gridRefString[5]}${gridRefString[3] >> 1}${gridRefString[6] >> 1}${gridRefString[3]}${gridRefString[6]}${gridRefString[4]}${gridRefString[7]}`;\r\n\r\n\t\t\tcase 9:\r\n\t\t\t\treturn `_${gridRefString.substring(0, 2)}${gridRefString[5]}${gridRefString[2] >> 1}${gridRefString[6] >> 1}${gridRefString[2]}${gridRefString[6]}${gridRefString[3]}${gridRefString[7]}${gridRefString[4]}${gridRefString[8]}`;\r\n\r\n\t\t\tcase 10:\r\n\t\t\t\treturn `${gridRefString.substring(0, 3)}${gridRefString[6]}${gridRefString[3] >> 1}${gridRefString[7] >> 1}${gridRefString[3]}${gridRefString[7]}${gridRefString[4]}${gridRefString[8]}${gridRefString[5]}${gridRefString[9]}`;\r\n\r\n\t\t\tcase 11:\r\n\t\t\t\treturn `_${gridRefString.substring(0, 2)}${gridRefString[6]}${gridRefString[2] >> 1}${gridRefString[7] >> 1}${gridRefString[2]}${gridRefString[7]}${gridRefString[3]}${gridRefString[8]}${gridRefString[4]}${gridRefString[9]}${gridRefString[5]}${gridRefString[10]}`;\r\n\r\n\t\t\tcase 12:\r\n\t\t\t\treturn `${gridRefString.substring(0, 3)}${gridRefString[7]}${gridRefString[3] >> 1}${gridRefString[8] >> 1}${gridRefString[3]}${gridRefString[8]}${gridRefString[4]}${gridRefString[9]}${gridRefString[5]}${gridRefString[10]}${gridRefString[6]}${gridRefString[11]}`;\r\n\r\n\t\t\tdefault:\r\n\t\t\t\tthrow new Error(`Bad grid-ref length '${gridRefString.length}' for interleaving.`);\r\n\t\t}\r\n\r\n\t\t// return match (strlen(gridRefString)) {\r\n\t\t// \t 0 => '',\r\n\t\t// \t\t1 => \"_{gridRefString}\",\r\n\t\t// \t\t2 => gridRefString,\r\n\t\t// \t\t3 => \"_{gridRefString}{tetrad}\",\r\n\t\t// \t\t4 => \"{gridRefString}{tetrad}\",\r\n\t\t// \t\t5 => \"_\" . substr(gridRefString, 0, 2) . gridRefString[3] . (gridRefString[2] >> 1) . (gridRefString[4] >> 1) . gridRefString[2] . gridRefString[4],\r\n\t\t// \t\t6 => substr(gridRefString, 0, 3) . gridRefString[4] . (gridRefString[3] >> 1) . (gridRefString[5] >> 1) . gridRefString[3] . gridRefString[5],\r\n\t\t// \t\t7 => '_' . substr(gridRefString, 0, 2) . gridRefString[4] . (gridRefString[2] >> 1) . (gridRefString[5] >> 1) . gridRefString[2] . gridRefString[5] . gridRefString[3] . gridRefString[6],\r\n\t\t// \t\t8 => substr(gridRefString, 0, 3) . gridRefString[5] . (gridRefString[3] >> 1) . (gridRefString[6] >> 1) . gridRefString[3] . gridRefString[6] . gridRefString[4] . gridRefString[7],\r\n\t\t// \t\t9 => '_' . substr(gridRefString, 0, 2) . gridRefString[5] . (gridRefString[2] >> 1) . (gridRefString[6] >> 1) . gridRefString[2] . gridRefString[6] . gridRefString[3] . gridRefString[7] . gridRefString[4] . gridRefString[8],\r\n\t\t// \t\t10 => substr(gridRefString, 0, 3) . gridRefString[6] . (gridRefString[3] >> 1) . (gridRefString[7] >> 1) . gridRefString[3] . gridRefString[7] . gridRefString[4] . gridRefString[8] . gridRefString[5] . gridRefString[9],\r\n\t\t// \t\t11 => '_' . substr(gridRefString, 0, 2) . gridRefString[6] . (gridRefString[2] >> 1) . (gridRefString[7] >> 1) . gridRefString[2] . gridRefString[7] . gridRefString[3] . gridRefString[8] . gridRefString[4] . gridRefString[9] . gridRefString[5] . gridRefString[10],\r\n\t\t// \t\t12 => substr(gridRefString, 0, 3) . gridRefString[7] . (gridRefString[3] >> 1) . (gridRefString[8] >> 1) . gridRefString[3] . gridRefString[8] . gridRefString[4] . gridRefString[9] . gridRefString[5] . gridRefString[10] . gridRefString[6] . gridRefString[11],\r\n\t\t// \tdefault => throw new Exception(\"Bad gridref length '\" . strlen(gridRefString) . \"' for interleaving.\"),\r\n\t\t// };\r\n\t}\r\n}\r\n","import {GridRef, QUADRANT_OFFSETS, TETRAD_OFFSETS} from './GridRef';\r\nimport {GridCoordsCI} from '../GridCoords/GridCoords';\r\n\r\nexport class GridRefCI extends GridRef {\r\n // noinspection JSUnusedGlobalSymbols\r\n\t/**\r\n\t *\r\n\t * @type {string}\r\n\t */\r\n\tcountry = 'CI';\r\n\r\n\t// noinspection JSUnusedGlobalSymbols\r\n /**\r\n\t *\r\n\t * @type {typeof GridCoordsCI}\r\n\t */\r\n\tGridCoords = GridCoordsCI;\r\n\r\n\t// /**\r\n\t// * @type {GridCoordsCI}\r\n\t// */\r\n\t// gridCoords = null;\r\n\r\n\t/**\r\n\t * @constructor\r\n\t */\r\n\tconstructor() {\r\n\t\tsuper();\r\n\r\n\t\tthis.parseWellFormed = this.fromString;\r\n\t};\r\n\r\n\t/**\r\n\t *\r\n\t * @param {string} rawGridRef\r\n\t * @throws Error\r\n\t */\r\n\tfromString(rawGridRef) {\r\n\t\tlet trimmedLocality = rawGridRef.replace(/[\\[\\]\\s\\t.\\/-]+/gu, '').toUpperCase();\r\n\t\tlet tetradCode = '';\r\n\t\tlet enl;\r\n\r\n\t\tif (/[ABCDEFGHIJKLMNPQRSTUVWXYZ]$/.test(trimmedLocality)) {\r\n\t\t\t// tetrad or quadrant\r\n\r\n\t\t\tif (QUADRANT_OFFSETS.hasOwnProperty(trimmedLocality.substring(trimmedLocality.length - 2))) {\r\n\t\t\t\tthis.quadrantCode = trimmedLocality.substring(trimmedLocality.length - 2);\r\n\t\t\t\ttrimmedLocality = trimmedLocality.substring(0, trimmedLocality.length - 2);\r\n\t\t\t} else {\r\n\t\t\t\ttetradCode = trimmedLocality.charAt(trimmedLocality.length - 1);\r\n\t\t\t\ttrimmedLocality = trimmedLocality.substring(0, trimmedLocality.length - 1);\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\tif (/^(W[AV](?:\\d\\d){1,5})$/.test(trimmedLocality)) {\r\n\t\t\tif ((enl = GridRefCI.gridref_string_to_e_n_l(trimmedLocality))) {\r\n\t\t\t\tthis.length = enl.length;\r\n\r\n\t\t\t\tthis.gridCoords = new GridCoordsCI(enl.e, enl.n);\r\n\t\t\t\tthis.hectad = this.gridCoords.toGridRefString(10000);\r\n\r\n\t\t\t\tif (this.length === 10000 && (tetradCode || this.quadrantCode)) {\r\n\t\t\t\t\tif (tetradCode) {\r\n\t\t\t\t\t\tthis.preciseGridRef = trimmedLocality + tetradCode;\r\n\t\t\t\t\t\tthis.tetrad = this.hectad + tetradCode;\r\n\t\t\t\t\t\tthis.tetradLetter = tetradCode;\r\n\t\t\t\t\t\tthis.length = 2000; // 2km square\r\n\t\t\t\t\t\tthis.gridCoords.x += TETRAD_OFFSETS[tetradCode][0];\r\n\t\t\t\t\t\tthis.gridCoords.y += TETRAD_OFFSETS[tetradCode][1];\r\n\t\t\t\t\t} else {\r\n\t\t\t\t\t\t// quadrant\r\n\t\t\t\t\t\tthis.preciseGridRef = trimmedLocality + this.quadrantCode;\r\n\t\t\t\t\t\tthis.tetradLetter = '';\r\n\t\t\t\t\t\tthis.tetrad = '';\r\n\t\t\t\t\t\tthis.quadrant = this.preciseGridRef;\r\n\t\t\t\t\t\tthis.length = 5000; // 5km square\r\n\t\t\t\t\t\tthis.gridCoords.x += QUADRANT_OFFSETS[this.quadrantCode][0];\r\n\t\t\t\t\t\tthis.gridCoords.y += QUADRANT_OFFSETS[this.quadrantCode][1];\r\n\t\t\t\t\t}\r\n\t\t\t\t} else {\r\n\t\t\t\t\tthis.preciseGridRef = trimmedLocality;\r\n\r\n\t\t\t\t\tif (this.length <= 1000) {\r\n\t\t\t\t\t\t// calculate tetrad for precise gridref\r\n\t\t\t\t\t\tthis.setTetrad();\r\n\t\t\t\t\t}\r\n\t\t\t\t}\r\n\t\t\t} else {\r\n\t\t\t\tthis.error = true;\r\n\t\t\t\tthis.errorMessage = 'Grid reference format not understood (odd length).';\r\n\t\t\t}\r\n\t\t} else {\r\n\t\t\t// no match\r\n\t\t\tthis.error = true;\r\n\t\t\tthis.errorMessage = \"Channel Island grid reference format not understood. ('\" + rawGridRef + \"')\";\r\n\t\t}\r\n\t}\r\n\r\n\r\n\t/**\r\n\t *\r\n\t *\r\n\t * @param {string} gridRef plain string without tetrad or quadrant suffix\r\n\t * @return {(boolean|{e : number, n : number, length : number})}\r\n\t * returns false on error or object {'e' : easting, 'n' : northing, 'length' : length}\r\n\t */\r\n\tstatic gridref_string_to_e_n_l(gridRef) {\r\n\t\tlet northOffset, x, y, length;\r\n\r\n\t\t// assume modern alphabetical sheet ref\r\n\t\tlet chars = gridRef.substring(0, 2);\r\n\r\n\t\tif (chars === 'WA') {\r\n\t\t\tnorthOffset = 5500000;\r\n\t\t} else if (chars === 'WV') {\r\n\t\t\tnorthOffset = 5400000;\r\n\t\t} else {\r\n\t\t\tconsole.log(\"Bad Channel Island grid letters: '\" + chars + \"'\");\r\n\t\t\treturn false;\r\n\t\t}\r\n\r\n\t\tlet ref = gridRef.substring(2);\r\n\t\tswitch (ref.length) {\r\n\t\t\tcase 2:\r\n\t\t\t\tx = ref.charAt(0) * 10000;\r\n\t\t\t\ty = ref.charAt(1) * 10000;\r\n\t\t\t\tlength = 10000; //10 km square\r\n\t\t\t\tbreak;\r\n\r\n\t\t\tcase 4:\r\n\t\t\t\tx = ref.substring(0, 2) * 1000;\r\n\t\t\t\ty = ref.substring(2) * 1000;\r\n\t\t\t\tlength = 1000; //1 km square\r\n\t\t\t\tbreak;\r\n\r\n\t\t\tcase 6:\r\n\t\t\t\tx = ref.substring(0, 3) * 100;\r\n\t\t\t\ty = ref.substring(3) * 100;\r\n\t\t\t\tlength = 100; //100m square\r\n\t\t\t\tbreak;\r\n\r\n\t\t\tcase 8:\r\n\t\t\t\tx = ref.substring(0, 4) * 10;\r\n\t\t\t\ty = ref.substring(4) * 10;\r\n\t\t\t\tlength = 10; //10m square\r\n\t\t\t\tbreak;\r\n\r\n\t\t\tcase 10:\r\n\t\t\t\tx = parseInt(ref.substring(0, 5), 10);\r\n\t\t\t\ty = parseInt(ref.substring(5), 10);\r\n\t\t\t\tlength = 1; //1m square\r\n\t\t\t\tbreak;\r\n\r\n\t\t\tdefault:\r\n\t\t\t\tconsole.log(\"Bad length for Channel Island grid ref '\" + gridRef + \"'\");\r\n\t\t\t\treturn false;\r\n\t\t}\r\n\r\n\t\treturn {\r\n\t\t\te: (x + 500000),\r\n\t\t\tn: (y + northOffset),\r\n\t\t\tlength: length\r\n\t\t};\r\n\t}\r\n}\r\n","import {GridRef, QUADRANT_OFFSETS, TETRAD_OFFSETS} from './GridRef';\r\nimport {GridCoordsGB} from '../GridCoords/GridCoords';\r\n\r\n/**\r\n * numerical mapping of letters to numbers\r\n * 'I' is omitted\r\n *\r\n * @type {{A: number, B: number, C: number, D: number, E: number, F: number, G: number, H: number, J: number, K: number, L: number, M: number, N: number, O: number, P: number, Q: number, R: number, S: number, T: number, U: number, V: number, W: number, X: number, Y: number, Z: number}}\r\n */\r\nconst LETTER_MAPPING = {\r\n\tA: 0, B: 1, C: 2, D: 3, E: 4, F: 5, G: 6, H: 7, J: 8, K: 9,\r\n\tL: 10, M: 11, N: 12, O: 13, P: 14, Q: 15, R: 16, S: 17, T: 18,\r\n\tU: 19, V: 20, W: 21, X: 22, Y: 23, Z: 24\r\n};\r\n\r\nexport class GridRefGB extends GridRef {\r\n // noinspection JSUnusedGlobalSymbols\r\n\t/**\r\n\t *\r\n\t * @type {string}\r\n\t */\r\n\tcountry = 'GB';\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n\t/**\r\n\t *\r\n\t * @type {typeof GridCoordsGB}\r\n\t */\r\n\tGridCoords = GridCoordsGB;\r\n\r\n\t// /**\r\n\t// * @type {GridCoordsGB}\r\n\t// */\r\n\t// gridCoords = null;\r\n\r\n\tconstructor() {\r\n\t\tsuper();\r\n\t}\r\n\r\n\t/**\r\n\t * grid ref known to have correct syntax\r\n\t * may have tetrad or quadrant suffix\r\n\t *\r\n\t * @param {string} rawGridRef\r\n\t * @throws Error\r\n\t */\r\n\tparseWellFormed(rawGridRef) {\r\n\r\n\t\tif (rawGridRef.length >= 5 && /^[A-Z]/.test(rawGridRef.charAt(4))) {\r\n\t\t\t// tetrad or quadrant\r\n\r\n\t\t\tif (QUADRANT_OFFSETS.hasOwnProperty(rawGridRef.substring(rawGridRef.length - 2))) {\r\n\t\t\t\tthis.quadrantCode = rawGridRef.substring(rawGridRef.length - 2);\r\n\t\t\t} else {\r\n\t\t\t\tthis.tetradLetter = rawGridRef.charAt(4);\r\n\t\t\t}\r\n\r\n\t\t\trawGridRef = rawGridRef.substring(0, 4);\r\n\t\t}\r\n\r\n\t\t//this sets easting/northing, length and hectad\r\n\t\tthis.parse_wellformed_gb_gr_string_no_tetrads(rawGridRef);\r\n\r\n\t\tif (this.tetradLetter || this.quadrantCode) {\r\n\t\t\t// tetrad or quadrant suffix\r\n\r\n\t\t\tif (this.tetradLetter) {\r\n\t\t\t\tif (!TETRAD_OFFSETS.hasOwnProperty(this.tetradLetter)) {\r\n\t\t\t\t\tthrow new Error(`Invalid tetrad letter: ${this.tetradLetter}`);\r\n\t\t\t\t}\r\n\r\n\t\t\t\tthis.preciseGridRef = this.tetrad = this.hectad + this.tetradLetter;\r\n\t\t\t\tthis.length = 2000; // 2km square\r\n\t\t\t\tthis.gridCoords.x += TETRAD_OFFSETS[this.tetradLetter][0];\r\n\t\t\t\tthis.gridCoords.y += TETRAD_OFFSETS[this.tetradLetter][1];\r\n\t\t\t} else {\r\n\t\t\t\t// quadrant\r\n\t\t\t\tif (!QUADRANT_OFFSETS.hasOwnProperty(this.quadrantCode)) {\r\n\t\t\t\t\tthrow new Error(`Invalid quadrant code: ${this.quadrantCode}`);\r\n\t\t\t\t}\r\n\r\n\t\t\t\tthis.preciseGridRef = this.quadrant = rawGridRef + this.quadrantCode;\r\n\t\t\t\tthis.length = 5000; // 5km square\r\n\t\t\t\tthis.gridCoords.x += QUADRANT_OFFSETS[this.quadrantCode][0];\r\n\t\t\t\tthis.gridCoords.y += QUADRANT_OFFSETS[this.quadrantCode][1];\r\n\t\t\t}\r\n\t\t} else {\r\n\t\t\tthis.preciseGridRef = rawGridRef;\r\n\r\n\t\t\tif (this.length <= 1000) {\r\n\t\t\t\t// calculate tetrad for precise grid ref\r\n\t\t\t\tthis.setTetrad();\r\n\t\t\t}\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t *\r\n\t * @param {string} rawGridRef\r\n\t * @throws Error\r\n\t */\r\n\tfromString(rawGridRef) {\r\n\t\t// grid ref may not be in canonical format\r\n\t\tlet trimmedLocality = rawGridRef.replace(/[\\[\\]\\s\\t.-]+/gu, '').toUpperCase();\r\n\t\tlet tetradCode = '';\r\n\t\tlet ref;\r\n\r\n\t\tif (/[ABCDEFGHIJKLMNPQRSTUVWXYZ]$/.test(trimmedLocality)) {\r\n\t\t\t// tetrad or quadrant\r\n\r\n\t\t\tif (QUADRANT_OFFSETS.hasOwnProperty(trimmedLocality.substring(trimmedLocality.length - 2))) {\r\n\t\t\t\tthis.quadrantCode = trimmedLocality.substring(trimmedLocality.length - 2);\r\n\t\t\t\ttrimmedLocality = trimmedLocality.substring(0, trimmedLocality.length - 2);\r\n\t\t\t} else {\r\n\t\t\t\ttetradCode = trimmedLocality.charAt(trimmedLocality.length - 1);\r\n\t\t\t\ttrimmedLocality = trimmedLocality.substring(0, trimmedLocality.length - 1);\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\t// if all numeric gridref, e.g. 38517462 then\r\n\t\t// split with '/', i.e. 38/517462\r\n\t\tif (trimmedLocality === parseInt(trimmedLocality, 10).toString()) {\r\n\t\t\ttrimmedLocality = trimmedLocality.substring(0, 2) + '/' + trimmedLocality.substring(2);\r\n\t\t} else if (trimmedLocality.length > 3 && trimmedLocality.charAt(2) === '/' && /^[A-Z]{2}$/.test(trimmedLocality.substring(0, 2))) {\r\n\t\t\t// preprocess refs of form SD/59 to SD59\r\n\t\t\t// but at this stage want to retain old-style nn/nnnn gridrefs\r\n\t\t\ttrimmedLocality = trimmedLocality.replace('/', '');\r\n\t\t}\r\n\r\n\t\tif (trimmedLocality.substring(0, 2) === 'VC') {\r\n\t\t\t// special case error, VC number entered into the wrong field\r\n\t\t\tthis.error = true;\r\n\t\t\tthis.errorMessage = \"Misplaced vice-county code in grid-reference field. ('\" + trimmedLocality + \"')\";\r\n\t\t\tthis.gridCoords = null;\r\n\t\t\tthis.length = 0;\r\n\t\t} else if ((ref = trimmedLocality.match(/^([HJNOST][ABCDEFGHJKLMNOPQRSTUVWXYZ](?:\\d\\d){1,5})$/)) !== null) {\r\n\t\t\ttrimmedLocality = ref[0]; //grid reference\r\n\r\n\t\t\tthis.parse_wellformed_gb_gr_string_no_tetrads(trimmedLocality);\r\n\r\n\t\t\tif (this.length > 0) {\r\n\t\t\t\tif (this.length === 10000 && (tetradCode || this.quadrantCode)) {\r\n\t\t\t\t\t// tetrad or quadrant suffix\r\n\r\n\t\t\t\t\tif (tetradCode) {\r\n\t\t\t\t\t\tthis.preciseGridRef = trimmedLocality + tetradCode;\r\n\t\t\t\t\t\tthis.tetradLetter = tetradCode;\r\n\t\t\t\t\t\tthis.tetrad = this.hectad + tetradCode;\r\n\t\t\t\t\t\tthis.length = 2000; // 2km square\r\n\t\t\t\t\t\tthis.gridCoords.x += TETRAD_OFFSETS[tetradCode][0];\r\n\t\t\t\t\t\tthis.gridCoords.y += TETRAD_OFFSETS[tetradCode][1];\r\n\t\t\t\t\t} else {\r\n\t\t\t\t\t\t// quadrant\r\n\t\t\t\t\t\tthis.preciseGridRef = trimmedLocality + this.quadrantCode;\r\n\t\t\t\t\t\tthis.tetradLetter = '';\r\n\t\t\t\t\t\tthis.tetrad = '';\r\n\t\t\t\t\t\tthis.quadrant = this.preciseGridRef;\r\n\t\t\t\t\t\tthis.length = 5000; // 5km square\r\n\t\t\t\t\t\tthis.gridCoords.x += QUADRANT_OFFSETS[this.quadrantCode][0];\r\n\t\t\t\t\t\tthis.gridCoords.y += QUADRANT_OFFSETS[this.quadrantCode][1];\r\n\t\t\t\t\t}\r\n\t\t\t\t} else {\r\n\t\t\t\t\tthis.preciseGridRef = trimmedLocality;\r\n\r\n\t\t\t\t\tif (this.length <= 1000) {\r\n\t\t\t\t\t\t// calculate tetrad for precise gridref\r\n\t\t\t\t\t\tthis.setTetrad();\r\n\t\t\t\t\t}\r\n\t\t\t\t}\r\n\t\t\t} else {\r\n\t\t\t\tthis.error = true;\r\n\t\t\t\tthis.errorMessage = 'GB grid reference format not understood (strange length).';\r\n\t\t\t}\r\n\t\t} else if (/^([\\d]{2})\\/((?:\\d\\d){1,5})$/.test(trimmedLocality)) {\r\n\t\t\t// matching old-style nn/nnnn gridrefs\r\n\t\t\t// where second-part must have even-number of digits\r\n\r\n\t\t\tthis.parse_gr_string_without_tetrads(trimmedLocality);\r\n\r\n\t\t\tswitch (this.length) {\r\n\t\t\t\tcase 10000:\r\n\t\t\t\t\ttrimmedLocality = this.gridCoords.toGridRefString(10000);\r\n\t\t\t\t\tthis.hectad = trimmedLocality;\r\n\r\n\t\t\t\t\tif (tetradCode) {\r\n\t\t\t\t\t\ttrimmedLocality += tetradCode;\r\n\t\t\t\t\t\tthis.tetradLetter = tetradCode;\r\n\t\t\t\t\t\tthis.tetrad = this.hectad + tetradCode;\r\n\t\t\t\t\t\tthis.length = 2000; // 2km square\r\n\t\t\t\t\t\tthis.gridCoords.x += TETRAD_OFFSETS[tetradCode][0];\r\n\t\t\t\t\t\tthis.gridCoords.y += TETRAD_OFFSETS[tetradCode][1];\r\n\t\t\t\t\t} else if (this.quadrantCode) {\r\n\t\t\t\t\t\ttrimmedLocality += this.quadrantCode;\r\n\t\t\t\t\t\tthis.quadrant = trimmedLocality;\r\n\t\t\t\t\t\tthis.length = 5000; // 5km square\r\n\t\t\t\t\t\tthis.gridCoords.x += QUADRANT_OFFSETS[this.quadrantCode][0];\r\n\t\t\t\t\t\tthis.gridCoords.y += QUADRANT_OFFSETS[this.quadrantCode][1];\r\n\t\t\t\t\t}\r\n\t\t\t\t\tbreak;\r\n\r\n\t\t\t\tcase 1000:\r\n\t\t\t\tcase 100:\r\n\t\t\t\tcase 10:\r\n\t\t\t\tcase 1:\r\n\t\t\t\t\ttrimmedLocality = this.gridCoords.toGridRefString(this.length);\r\n\t\t\t\t\tthis.hectad = this.gridCoords.toGridRefString(10000);\r\n\t\t\t\t\tthis.setTetrad();\r\n\t\t\t\t\tbreak;\r\n\r\n\t\t\t\tdefault:\r\n\t\t\t\t\tthis.error = true;\r\n\t\t\t\t\tthis.errorMessage = 'Bad grid square dimension (' + this.length + ' m).';\r\n\t\t\t\t\tthis.gridCoords = null;\r\n\t\t\t\t\tthis.length = 0;\r\n\t\t\t}\r\n\r\n\t\t\tthis.preciseGridRef = trimmedLocality;\r\n\t\t} else {\r\n\t\t\t// no match\r\n\t\t\tthis.gridCoords = null;\r\n\t\t\tthis.length = 0;\r\n\t\t\tthis.error = true;\r\n\t\t\tthis.errorMessage = \"Grid reference format not understood. ('\" + rawGridRef + \"')\";\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * sets easting, northing and length (in km)\r\n\t * source grid-reference need not be well-formed\r\n\t *\r\n\t * @param {string} gridRef either nn/nn... or aann...\r\n\t */\r\n\tparse_gr_string_without_tetrads(gridRef) {\r\n\t\tlet matches, x, y, ref;\r\n\r\n\t\tif ((matches = gridRef.match(/^(\\d{2})\\/((?:\\d\\d){1,5})$/)) !== null) {\r\n\r\n\t\t\t// old style numerical sheet ref XY/nnnnnn\r\n\t\t\t// nnnn part must have even length\r\n\r\n\t\t\t// northern scottish islands have eccentric numbering\r\n\t\t\tswitch (matches[1]) {\r\n\t\t\t\tcase '57':\r\n\t\t\t\t\tx = 300000;\r\n\t\t\t\t\ty = 1000000;\r\n\t\t\t\t\tbreak;\r\n\r\n\t\t\t\tcase '67':\r\n\t\t\t\t\tx = 400000;\r\n\t\t\t\t\ty = 1000000;\r\n\t\t\t\t\tbreak;\r\n\r\n\t\t\t\tcase '58':\r\n\t\t\t\t\tx = 300000;\r\n\t\t\t\t\ty = 1100000;\r\n\t\t\t\t\tbreak;\r\n\r\n\t\t\t\tcase '68':\r\n\t\t\t\t\tx = 400000;\r\n\t\t\t\t\ty = 1100000;\r\n\t\t\t\t\tbreak;\r\n\r\n\t\t\t\tcase '69':\r\n\t\t\t\t\tx = 400000;\r\n\t\t\t\t\ty = 1200000;\r\n\t\t\t\t\tbreak;\r\n\r\n\t\t\t\tdefault:\r\n\t\t\t\t\tx = gridRef.charAt(0) * 100000;\r\n\t\t\t\t\ty = gridRef.charAt(1) * 100000;\r\n\t\t\t}\r\n\r\n\t\t\tref = matches[2];\r\n\t\t} else {\r\n\t\t\t// modern alphabetical sheet ref\r\n\t\t\tif (!LETTER_MAPPING.hasOwnProperty(gridRef.charAt(0)) || !LETTER_MAPPING.hasOwnProperty(gridRef.charAt(1))) {\r\n\t\t\t\t// invalid\r\n\t\t\t\tthis.length = 0;\r\n\t\t\t\tthis.gridCoords = null;\r\n\t\t\t\treturn;\r\n\t\t\t}\r\n\r\n\t\t\tlet char1 = LETTER_MAPPING[gridRef.charAt(0)];\r\n\t\t\tlet char2 = LETTER_MAPPING[gridRef.charAt(1)];\r\n\t\t\tref = gridRef.substring(2);\r\n\r\n\t\t\tx = ((char1 % 5) * 500000) + ((char2 % 5) * 100000) - 1000000;\r\n\t\t\ty = (-Math.floor(char1 / 5) * 500000) - (Math.floor(char2 / 5) * 100000) + 1900000;\r\n\t\t}\r\n\r\n\t\tswitch (ref.length) {\r\n\t\t\tcase 2:\r\n\t\t\t\tthis.gridCoords = new GridCoordsGB(\r\n\t\t\t\t\tx + ref.charAt(0) * 10000, // use first digit of ref\r\n\t\t\t\t\ty + ref.charAt(1) * 10000 // use second digit of ref\r\n\t\t\t\t);\r\n\t\t\t\tthis.length = 10000; //10 km square\r\n\t\t\t\tbreak;\r\n\r\n\t\t\tcase 4:\r\n\t\t\t\tthis.gridCoords = new GridCoordsGB(\r\n\t\t\t\t\tx + Math.floor(ref / 100) * 1000,\r\n\t\t\t\t\ty + (ref % 100) * 1000\r\n\t\t\t\t);\r\n\t\t\t\tthis.length = 1000; //1 km square\r\n\t\t\t\tbreak;\r\n\r\n\t\t\tcase 6:\r\n\t\t\t\tthis.gridCoords = new GridCoordsGB(\r\n\t\t\t\t\tx + Math.floor(ref / 1000) * 100,\r\n\t\t\t\t\ty + (ref % 1000) * 100\r\n\t\t\t\t);\r\n\t\t\t\tthis.length = 100; //100m square\r\n\t\t\t\tbreak;\r\n\r\n\t\t\tcase 8:\r\n\t\t\t\tthis.gridCoords = new GridCoordsGB(\r\n\t\t\t\t\tx + Math.floor(ref / 10000) * 10,\r\n\t\t\t\t\ty + (ref % 10000) * 10\r\n\t\t\t\t);\r\n\t\t\t\tthis.length = 10; //10m square\r\n\t\t\t\tbreak;\r\n\r\n\t\t\tcase 10:\r\n\t\t\t\tthis.gridCoords = new GridCoordsGB(\r\n\t\t\t\t\tx + Math.floor(ref / 100000),\r\n\t\t\t\t\ty + (ref % 100000)\r\n\t\t\t\t);\r\n\t\t\t\tthis.length = 1; //1m square\r\n\t\t\t\tbreak;\r\n\r\n\t\t\tdefault:\r\n\t\t\t\tconsole.log('Bad grid ref length, ref=' + gridRef);\r\n\t\t\t\tthis.gridCoords = null;\r\n\t\t\t\tthis.length = 0;\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * gridRef must be a correctly formed OS GB grid-reference\r\n\t *\r\n\t * sets self::gridCoords\r\n\t * sets self::length\r\n\t * sets self::hectad\r\n\t *\r\n\t * @param {string} gridRef modern alphanumeric format with no suffixes\r\n\t * @throws Error\r\n\t */\r\n\tparse_wellformed_gb_gr_string_no_tetrads(gridRef) {\r\n\t\tlet char1, char2, ref, x, y;\r\n\r\n\t\t// modern alphabetical sheet refs only\r\n\t\tchar1 = LETTER_MAPPING[gridRef.charAt(0)];\r\n\t\tchar2 = LETTER_MAPPING[gridRef.charAt(1)];\r\n\t\tref = gridRef.substring(2);\r\n\r\n\t\tx = ((char1 % 5) * 500000) + ((char2 % 5) * 100000) - 1000000;\r\n\t\ty = (-Math.floor(char1 / 5) * 500000) - (Math.floor(char2 / 5) * 100000) + 1900000;\r\n\r\n\t\tswitch (ref.length) {\r\n\t\t\tcase 2:\r\n\t\t\t\tthis.gridCoords = new GridCoordsGB(\r\n\t\t\t\t\tx + ref.charAt(0) * 10000, // use first digit of ref\r\n\t\t\t\t\ty + ref.charAt(1) * 10000 // use second digit of ref\r\n\t\t\t\t);\r\n\t\t\t\tthis.length = 10000; //10 km square\r\n\t\t\t\tthis.hectad = gridRef;\r\n\t\t\t\tbreak;\r\n\r\n\t\t\tcase 4:\r\n\t\t\t\tthis.gridCoords = new GridCoordsGB(\r\n\t\t\t\t\tx + (Math.floor(ref / 100) * 1000),\r\n\t\t\t\t\ty + ((ref % 100) * 1000)\r\n\t\t\t\t);\r\n\t\t\t\tthis.length = 1000; //1 km square\r\n\t\t\t\tthis.hectad = gridRef.substring(0, 3) + gridRef.charAt(4);\r\n\t\t\t\tbreak;\r\n\r\n\t\t\tcase 6:\r\n\t\t\t\tthis.gridCoords = new GridCoordsGB(\r\n\t\t\t\t\tx + (Math.floor(ref / 1000)) * 100,\r\n\t\t\t\t\ty + (ref % 1000) * 100\r\n\t\t\t\t);\r\n\t\t\t\tthis.length = 100; //100m square\r\n\t\t\t\tthis.hectad = gridRef.substring(0, 3) + gridRef.charAt(5);\r\n\t\t\t\tbreak;\r\n\r\n\t\t\tcase 8:\r\n\t\t\t\tthis.gridCoords = new GridCoordsGB(\r\n\t\t\t\t\tx + (Math.floor(ref / 10000)) * 10,\r\n\t\t\t\t\ty + (ref % 10000) * 10\r\n\t\t\t\t);\r\n\t\t\t\tthis.length = 10; //10m square\r\n\t\t\t\tthis.hectad = gridRef.substring(0, 3) + gridRef.charAt(6);\r\n\t\t\t\tbreak;\r\n\r\n\t\t\tcase 10:\r\n\t\t\t\tthis.gridCoords = new GridCoordsGB(\r\n\t\t\t\t\tx + Math.floor(ref / 100000),\r\n\t\t\t\t\ty + (ref % 100000)\r\n\t\t\t\t);\r\n\t\t\t\tthis.length = 1; //1m square\r\n\t\t\t\tthis.hectad = gridRef.substring(0, 3) + gridRef.charAt(7);\r\n\t\t\t\tbreak;\r\n\r\n\t\t\tdefault:\r\n\t\t\t\tthis.gridCoords = null;\r\n\t\t\t\tthrow new Error(\"Bad grid ref length when parsing supposedly well-formed ref, ref='\" + gridRef + \"'\");\r\n\t\t}\r\n\t}\r\n}\r\n","import {GridRef, QUADRANT_OFFSETS, TETRAD_OFFSETS} from './GridRef';\r\nimport {GridCoordsIE} from '../GridCoords/GridCoords';\r\n\r\nconst _IE_GRID_LETTERS = 'VQLFAWRMGBXSNHCYTOJD';\r\n\r\nexport class GridRefIE extends GridRef {\r\n\t/**\r\n\t * @constructor\r\n\t */\r\n\tconstructor() {\r\n\t\tsuper();\r\n\t\tthis.parseWellFormed = this.fromString;\r\n\t};\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n\t/**\r\n\t *\r\n\t * @type {string}\r\n\t */\r\n\tcountry = 'IE';\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n\t/**\r\n\t *\r\n\t * @type {typeof GridCoordsIE}\r\n\t */\r\n\tGridCoords = GridCoordsIE;\r\n\r\n\t// /**\r\n\t// * @type {GridCoordsIE}\r\n\t// */\r\n\t// gridCoords = null;\r\n\r\n\t// static gridLetter = {\r\n\t// \tA: [0, 4],\r\n\t// \tB: [1, 4],\r\n\t// \tC: [2, 4],\r\n\t// \tD: [3, 4],\r\n\t// \tF: [0, 3],\r\n\t// \tG: [1, 3],\r\n\t// \tH: [2, 3],\r\n\t// \tJ: [3, 3],\r\n\t// \tL: [0, 2],\r\n\t// \tM: [1, 2],\r\n\t// \tN: [2, 2],\r\n\t// \tO: [3, 2],\r\n\t// \tQ: [0, 1],\r\n\t// \tR: [1, 1],\r\n\t// \tS: [2, 1],\r\n\t// \tT: [3, 1],\r\n\t// \tV: [0, 0],\r\n\t// \tW: [1, 0],\r\n\t// \tX: [2, 0],\r\n\t// \tY: [3, 0]\r\n\t// };\r\n\r\n\t/**\r\n\t *\r\n\t * @param {string} rawGridRef\r\n\t * @throws Error\r\n\t */\r\n\tfromString(rawGridRef) {\r\n\t\tlet trimmedLocality = rawGridRef.replace(/[\\[\\]\\s\\t.-]+/gu, '').toUpperCase();\r\n\r\n\t\tif (/[ABCDEFGHIJKLMNPQRSTUVWXYZ]$/.test(trimmedLocality)) {\r\n\t\t\t// tetrad or quadrant\r\n\r\n\t\t\tif (QUADRANT_OFFSETS.hasOwnProperty(trimmedLocality.substring(trimmedLocality.length - 2))) {\r\n\t\t\t\tthis.quadrantCode = trimmedLocality.substring(trimmedLocality.length - 2);\r\n\t\t\t\ttrimmedLocality = trimmedLocality.substring(0, trimmedLocality.length - 2);\r\n\t\t\t} else {\r\n\t\t\t\tthis.tetradLetter = trimmedLocality.substring(trimmedLocality.length - 1);\r\n\t\t\t\ttrimmedLocality = trimmedLocality.substring(0, trimmedLocality.length - 1);\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\tthis.parse_gr_string_without_tetrads(trimmedLocality);\r\n\r\n\t\tif (this.length > 0) {\r\n\t\t\tif (this.tetradLetter || this.quadrantCode) {\r\n\t\t\t\t// tetrad or quadrant suffix\r\n\r\n\t\t\t\tif (this.tetradLetter) {\r\n\t\t\t\t\tif (!TETRAD_OFFSETS.hasOwnProperty(this.tetradLetter)) {\r\n\t\t\t\t\t\tthrow new Error(`Invalid tetrad letter: ${this.tetradLetter}`);\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\tthis.preciseGridRef = this.hectad + this.tetradLetter;\r\n\t\t\t\t\tthis.tetrad = this.preciseGridRef;\r\n\t\t\t\t\tthis.length = 2000; // 2km square\r\n\t\t\t\t\tthis.gridCoords.x += TETRAD_OFFSETS[this.tetradLetter][0];\r\n\t\t\t\t\tthis.gridCoords.y += TETRAD_OFFSETS[this.tetradLetter][1];\r\n\t\t\t\t} else {\r\n\t\t\t\t\t// quadrant\r\n\t\t\t\t\tif (!QUADRANT_OFFSETS.hasOwnProperty(this.quadrantCode)) {\r\n\t\t\t\t\t\tthrow new Error(`Invalid quadrant code: ${this.quadrantCode}`);\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\tthis.preciseGridRef = this.hectad + this.quadrantCode;\r\n\t\t\t\t\tthis.quadrant = this.preciseGridRef;\r\n\t\t\t\t\tthis.length = 5000; // 5km square\r\n\t\t\t\t\tthis.gridCoords.x += QUADRANT_OFFSETS[this.quadrantCode][0];\r\n\t\t\t\t\tthis.gridCoords.y += QUADRANT_OFFSETS[this.quadrantCode][1];\r\n\t\t\t\t}\r\n\t\t\t} else {\r\n\t\t\t\tthis.preciseGridRef = trimmedLocality;\r\n\r\n\t\t\t\tif (this.length <= 1000) {\r\n\t\t\t\t\t// calculate tetrad for precise gridref\r\n\t\t\t\t\tthis.setTetrad();\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t} else {\r\n\t\t\tthis.error = true;\r\n\t\t\tthis.errorMessage = \"Irish grid reference format not understood. ('\" + rawGridRef + \"')\";\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t *\r\n\t * @param {string} gridRef nn/nnnn or [A-Z]nnnn or [A-Z]/nnnn (no other punctuation by this point), all upper-case\r\n\t * @return boolean\r\n\t */\r\n\tparse_gr_string_without_tetrads(gridRef) {\r\n\t\tlet x, y, ref, char;\r\n\r\n\t\tif (/^\\d{2}\\/(?:\\d\\d){1,5}$/.test(gridRef)) {\r\n\t\t\t// nn/nnnn etc.\r\n\t\t\t// regex used to avoid matching oddly malformed refs, such as \"32/SO763520\"\r\n\r\n\t\t\tx = parseInt(gridRef.charAt(0), 10);\r\n\t\t\ty = parseInt(gridRef.charAt(1), 10);\r\n\r\n\t\t\tif (x > 3 || y > 4) {\r\n\t\t\t\tconsole.log(\"bad grid square, ref='\" + gridRef + \"' (Ireland)\");\r\n\t\t\t\tthis.length = 0;\r\n\t\t\t\treturn false;\r\n\t\t\t}\r\n\r\n\t\t\tref = gridRef.substring(3);\r\n\t\t\tchar = _IE_GRID_LETTERS.charAt((x * 5) + y);\r\n\r\n\t\t\tx *= 100000;\r\n\t\t\ty *= 100000;\r\n\t\t} else {\r\n\t\t\t// [A-Z]nnnn or [A-Z]/nnnn etc.\r\n\t\t\tgridRef = gridRef.replace('/', '');\r\n\r\n\t\t\tif (!/^[ABCDFGHJLMNOQRSTVWXY](?:\\d\\d){1,5}$/.test(gridRef)) {\r\n\t\t\t\tthis.length = 0;// mark error state\r\n\t\t\t\tthis.gridCoords = null;\r\n\t\t\t\treturn false;\r\n\t\t\t}\r\n\r\n\t\t\tif (gridRef) {\r\n\t\t\t\tchar = gridRef.charAt(0);\r\n\t\t\t\tlet p = _IE_GRID_LETTERS.indexOf(char);\r\n\r\n\t\t\t\tif (p !== -1) {\r\n\t\t\t\t\tx = Math.floor(p / 5) * 100000;\r\n\t\t\t\t\ty = (p % 5) * 100000;\r\n\t\t\t\t} else {\r\n\t\t\t\t\tconsole.log(\"Bad grid ref grid-letter, ref='\" + gridRef + \"' (Ireland)\");\r\n\t\t\t\t\tthis.length = 0; // mark error\r\n\t\t\t\t\tthis.gridCoords = null;\r\n\t\t\t\t\treturn false;\r\n\t\t\t\t}\r\n\t\t\t} else {\r\n\t\t\t\tconsole.log('Bad (empty) Irish grid ref');\r\n\t\t\t\tthis.length = 0; // mark error\r\n\t\t\t\tthis.gridCoords = null;\r\n\t\t\t\treturn false;\r\n\t\t\t}\r\n\r\n\t\t\tref = gridRef.substring(1);\r\n\t\t}\r\n\r\n\t\tswitch (ref.length) {\r\n\t\t\tcase 2:\r\n\t\t\t\tthis.gridCoords = new GridCoordsIE(\r\n\t\t\t\t\tx + (ref.charAt(0) * 10000),\r\n\t\t\t\t\ty + (ref.charAt(1) * 10000)\r\n\t\t\t\t);\r\n\t\t\t\tthis.length = 10000; //10 km square\r\n\t\t\t\tthis.hectad = char + ref;\r\n\t\t\t\tbreak;\r\n\r\n\t\t\tcase 4:\r\n\t\t\t\tthis.gridCoords = new GridCoordsIE(\r\n\t\t\t\t\tx + Math.floor(ref / 100) * 1000,\r\n\t\t\t\t\ty + (ref % 100) * 1000\r\n\t\t\t\t);\r\n\t\t\t\tthis.length = 1000; //1 km square\r\n\t\t\t\tthis.hectad = char + ref.charAt(0) + ref.charAt(2);\r\n\t\t\t\tbreak;\r\n\r\n\t\t\tcase 6:\r\n\t\t\t\tthis.gridCoords = new GridCoordsIE(\r\n\t\t\t\t\tx + Math.floor(ref / 1000) * 100,\r\n\t\t\t\t\ty + (ref % 1000) * 100\r\n\t\t\t\t);\r\n\t\t\t\tthis.length = 100; // 100m square\r\n\t\t\t\tthis.hectad = char + ref.charAt(0) + ref.charAt(3);\r\n\t\t\t\tbreak;\r\n\r\n\t\t\tcase 8:\r\n\t\t\t\tthis.gridCoords = new GridCoordsIE(\r\n\t\t\t\t\tx + Math.floor(ref / 10000) * 10,\r\n\t\t\t\t\ty + (ref % 10000) * 10\r\n\t\t\t\t);\r\n\t\t\t\tthis.length = 10; //10m square\r\n\t\t\t\tthis.hectad = char + ref.charAt(0) + ref.charAt(4);\r\n\t\t\t\tbreak;\r\n\r\n\t\t\tcase 10:\r\n\t\t\t\tthis.gridCoords = new GridCoordsIE(\r\n\t\t\t\t\tx + Math.floor(ref / 100000),\r\n\t\t\t\t\ty + (ref % 100000)\r\n\t\t\t\t);\r\n\t\t\t\tthis.length = 1; //1m square\r\n\t\t\t\tthis.hectad = char + ref.charAt(0) + ref.charAt(5);\r\n\t\t\t\tbreak;\r\n\r\n\t\t\tdefault:\r\n\t\t\t\tconsole.log(\"Bad grid ref length, ref='\" + gridRef + \"' (Ireland)\");\r\n\t\t\t\tthis.length = 0;\r\n\t\t\t\tthis.gridCoords = null;\r\n\t\t\t\treturn false;\r\n\t\t}\r\n\t\treturn true;\r\n\t}\r\n\r\n\t/**\r\n\t * used for IE grid-refs\r\n\t *\r\n\t * @param {?number} significantPrecision default null (precision in metres of centroid diameter)\r\n\t * @return {string}\r\n\t */\r\n\ttoHtml(significantPrecision = null) {\r\n\t\tlet formattedGr;\r\n\r\n\t\tif (!significantPrecision || significantPrecision === this.length) {\r\n\t\t\tif (this.length <= 1000) {\r\n\t\t\t\tlet halfNumLen = ((this.preciseGridRef.length - 1) / 2) | 0\r\n\t\t\t\tformattedGr = this.preciseGridRef[0] +\r\n\t\t\t\t\t\"\" + this.preciseGridRef.substring(1, 1 + halfNumLen) +\r\n\t\t\t\t\t\"\" + this.preciseGridRef.substring(1 + halfNumLen) + \"\";\r\n\t\t\t} else {\r\n\t\t\t\tformattedGr = this.preciseGridRef;\r\n\t\t\t}\r\n\t\t} else {\r\n\t\t\tif (this.length === 2000) {\r\n\t\t\t\t// reduced precision means greying the tetrad code\r\n\r\n\t\t\t\tformattedGr = `${this.hectad}${this.tetradLetter}`;\r\n\t\t\t} else if (this.length === 5000) {\r\n\t\t\t\t// reduced precision means greying the quadrant code\r\n\r\n\t\t\t\tformattedGr = `${this.hectad}${this.quadrantCode}`;\r\n\t\t\t} else {\r\n\t\t\t\tif (significantPrecision > 5000) {\r\n\t\t\t\t\t// large and probably spurious precision value - so grey-out the entire grid-reference\r\n\t\t\t\t\tformattedGr = `${this.preciseGridRef}`;\r\n\t\t\t\t} else {\r\n\t\t\t\t\tlet columns = (5 + Math.log10(1 / significantPrecision)) | 0; // number of sig figures\r\n\t\t\t\t\tlet halfNumLen = ((this.preciseGridRef.length - 1) / 2) | 0;\r\n\r\n\t\t\t\t\tformattedGr = this.preciseGridRef[0] + \"\" + this.preciseGridRef.substring(1, 1 + columns) + \"\" +\r\n\t\t\t\t\t\t\"\" + this.preciseGridRef.substring(columns + 1, 1 + halfNumLen) + \"\" +\r\n\t\t\t\t\t\t\"\" + this.preciseGridRef.substring(1 + halfNumLen, 1 + halfNumLen + columns) + \"\" +\r\n\t\t\t\t\t\t\"\" + this.preciseGridRef.substring(1 + halfNumLen + columns) + \"\"\r\n\t\t\t\t\t;\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\treturn formattedGr;\r\n\t}\r\n}\r\n","import {GridRef} from './GridRef';\r\nimport {GridRefCI} from './GridRefCI';\r\nimport {GridRefGB} from './GridRefGB';\r\nimport {GridRefIE} from './GridRefIE';\r\n\r\n/**\r\n * returns a GridRef (GB, IE or CI-specific parser) or false\r\n * crudely tries to determine the country by trying each country in turn\r\n *\r\n * @param {string} rawGridRef\r\n * @returns {(GridRef|false)}\r\n */\r\nGridRef.fromString = (rawGridRef) => {\r\n\tlet parser;\r\n\tlet cleanRef = rawGridRef.replace(/\\s+/gu, '').toUpperCase();\r\n\r\n\tif (!cleanRef) {\r\n\t\treturn false;\r\n\t}\r\n\r\n\t// if we have a canonical ref form, then can be more efficient\r\n\tif (/^(?:[BCDFGHJLMNOQRSTVWXY]|[HJNOST][ABCDEFGHJKLMNOPQRSTUVWXYZ]|W[VA])\\d{2}(?:[A-Z]|[NS][EW]|(?:\\d{2}){0,4})?$/.test(cleanRef)) {\r\n\t\t// have a simple, well-formed grid ref\r\n\r\n\t\tif (/^.\\d/.test(cleanRef)) {\r\n\t\t\tparser = new GridRefIE();\r\n\t\t} else {\r\n\t\t\tif (cleanRef.charAt(0) === 'W') {\r\n\t\t\t\tparser = new GridRefCI();\r\n\t\t\t} else {\r\n\t\t\t\tparser = new GridRefGB();\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\tparser.parseWellFormed(cleanRef);\r\n\r\n\t\treturn (parser.length && !parser.error) ? parser : false;\r\n\t} else {\r\n\t\tparser = new GridRefGB();\r\n\t\tparser.fromString(cleanRef);\r\n\r\n\t\tif (parser.length && !parser.error) {\r\n\t\t\treturn parser;\r\n\t\t}\r\n\r\n\t\tif (cleanRef.charAt(0) === 'W') {\r\n\t\t\tparser = new GridRefCI();\r\n\t\t\tparser.fromString(cleanRef);\r\n\r\n\t\t\tif (parser.length && !parser.error) {\r\n\t\t\t\treturn parser;\r\n\t\t\t}\r\n\t\t} else {\r\n\t\t\tparser = new GridRefIE();\r\n\t\t\tparser.fromString(cleanRef);\r\n\r\n\t\t\tif (parser.length && !parser.error) {\r\n\t\t\t\treturn parser;\r\n\t\t\t}\r\n\t\t}\r\n\t}\r\n\treturn false;\r\n};\r\n\r\nexport {GridRef, GridRefCI, GridRefGB, GridRefIE};\r\n","/**\r\n * Persistent buffer for log entries that could not be delivered at the time they were raised.\r\n *\r\n * Deliberately backed by localStorage rather than IndexedDb. The failures most worth capturing are\r\n * the ones where IndexedDb itself has died, taking the records with it; entries held in a second\r\n * IndexedDb database would be lost in the same event, which is precisely the evidence needed.\r\n * localStorage is a separate backend, is synchronous (so an entry survives an immediate crash,\r\n * unload or reload), and adds no pressure to the database under investigation.\r\n *\r\n * Nothing in this file may call Logger.logError(). A failure here must not generate a log entry,\r\n * or a failing flush would produce more entries needing flushing. console only.\r\n */\r\n\r\n/**\r\n * Prefix for individual buffered entries. Keys sort lexicographically into chronological order.\r\n *\r\n * @type {string}\r\n */\r\nconst ENTRY_KEY_PREFIX = 'bsbiLog.';\r\n\r\n/**\r\n * Separate prefix, so that meta keys are not picked up by the entry scan.\r\n *\r\n * @type {string}\r\n */\r\nconst DROPPED_COUNT_KEY = 'bsbiLogMeta.dropped';\r\n\r\n/**\r\n * Caps on the buffer, against a total origin budget of roughly 5Mb. Entries run about 0.5-1.5Kb\r\n * each, so this is far more history than is ever likely to be useful.\r\n */\r\nconst MAX_ENTRIES = 500;\r\nconst MAX_TOTAL_BYTES = 1024 * 1024;\r\n\r\n/**\r\n * A single oversized entry (a huge stack, or a stringified object) must not be able to consume the\r\n * whole budget.\r\n *\r\n * @type {number}\r\n */\r\nconst MAX_ENTRY_BYTES = 16 * 1024;\r\n\r\n/**\r\n * Batch limits, whichever is reached first.\r\n *\r\n * Sized for a slow or intermittent mobile connection: roughly 25Kb per request, which should\r\n * complete in a few seconds even on a poor link, and costs little when it has to be retried.\r\n */\r\nconst CHUNK_ENTRIES = 25;\r\nconst CHUNK_BYTES = 64 * 1024;\r\n\r\n/**\r\n * Minimum interval between flush attempts after a failure, so that an unreachable endpoint is not\r\n * hammered.\r\n *\r\n * @type {number}\r\n */\r\nconst FLUSH_RETRY_INTERVAL_MS = 60000;\r\n\r\nexport class LogBuffer {\r\n /**\r\n * @type {boolean}\r\n * @private\r\n */\r\n static _flushInProgress = false;\r\n\r\n /**\r\n * @type {number}\r\n * @private\r\n */\r\n static _nextFlushAllowedStamp = 0;\r\n\r\n /**\r\n * @type {boolean}\r\n * @private\r\n */\r\n static _onlineListenerAttached = false;\r\n\r\n /**\r\n * Key of the newest buffered entry, cached so that repeat detection doesn't rescan on every\r\n * call. Null means 'not yet determined', and triggers a single scan.\r\n *\r\n * @type {string|null}\r\n * @private\r\n */\r\n static _newestKey = null;\r\n\r\n /**\r\n * @type {string|null}\r\n * @private\r\n */\r\n static _newestSignature = null;\r\n\r\n /**\r\n * @type {number}\r\n * @private\r\n */\r\n static _serial = 0;\r\n\r\n /**\r\n * @returns {boolean}\r\n */\r\n static isAvailable() {\r\n try {\r\n // absent in a service worker, and can throw in restricted contexts\r\n return typeof localStorage !== 'undefined' && !!localStorage;\r\n } catch (error) {\r\n return false;\r\n }\r\n }\r\n\r\n /**\r\n * Buffers an undelivered entry.\r\n *\r\n * Consecutive identical entries are coalesced, carrying a count and the stamp of the latest\r\n * occurrence. That matters because the entries most worth keeping tend to arrive in bursts -\r\n * a reload loop, or a repeated failing save - and 30 copies of one message is both wasteful\r\n * and harder to read than one with a count.\r\n *\r\n * @param {{}} doc the payload that would have been posted\r\n * @param {boolean} [undeliverable] set when the entry is being held because it could not be\r\n * delivered - offline, or a post that failed - rather than because it is simply waiting for the\r\n * next batch. Only the former is marked as late; see below.\r\n * @returns {boolean} true if the entry was buffered\r\n */\r\n static store(doc, undeliverable = true) {\r\n if (!LogBuffer.isAvailable()) {\r\n return false;\r\n }\r\n\r\n try {\r\n LogBuffer._attachOnlineListener();\r\n\r\n const descriptor = doc.error || doc.descriptor;\r\n\r\n if (descriptor && undeliverable) {\r\n // marks the entry as delivered late, so that a batch arriving hours afterwards is\r\n // not mistaken for a burst of simultaneous failures\r\n //\r\n // Conditional because every entry now passes through the buffer on its way out -\r\n // entries are batched rather than posted one at a time - so marking them all would\r\n // make the flag say nothing. It still means what it always did: this entry could\r\n // not be delivered when it was raised.\r\n descriptor.buffered = true;\r\n }\r\n\r\n const signature = LogBuffer._signatureOf(doc);\r\n\r\n if (LogBuffer._coalesceWithNewest(signature, descriptor)) {\r\n return true;\r\n }\r\n\r\n let serialised = JSON.stringify(doc);\r\n\r\n if (serialised.length > MAX_ENTRY_BYTES) {\r\n serialised = LogBuffer._truncateEntry(doc, descriptor);\r\n }\r\n\r\n const key = `${ENTRY_KEY_PREFIX}${Date.now().toString().padStart(14, '0')}.${(LogBuffer._serial++).toString().padStart(6, '0')}`;\r\n\r\n localStorage.setItem(key, serialised);\r\n\r\n LogBuffer._newestKey = key;\r\n LogBuffer._newestSignature = signature;\r\n\r\n LogBuffer._enforceLimits();\r\n\r\n return true;\r\n } catch (error) {\r\n // quota exceeded, or storage unavailable - drop the entry rather than propagate\r\n console.error({'Failed to buffer log entry': error});\r\n\r\n try {\r\n LogBuffer._evictOldest(Math.ceil(MAX_ENTRIES / 4));\r\n } catch (evictionError) {\r\n console.error({'Failed to evict buffered log entries': evictionError});\r\n }\r\n\r\n return false;\r\n }\r\n }\r\n\r\n /**\r\n * Posts buffered entries in batches, discarding each batch only once the server has accepted it.\r\n *\r\n * @param {function(Array<{}>): Promise} postBatch resolves true if the batch was accepted\r\n * @returns {Promise} always resolves\r\n */\r\n static flush(postBatch) {\r\n if (!LogBuffer.isAvailable() || LogBuffer._flushInProgress) {\r\n return Promise.resolve();\r\n }\r\n\r\n if (Date.now() < LogBuffer._nextFlushAllowedStamp) {\r\n // still backing off from a previous failure\r\n return Promise.resolve();\r\n }\r\n\r\n let keys;\r\n\r\n try {\r\n keys = LogBuffer._entryKeys();\r\n } catch (error) {\r\n console.error({'Failed to read buffered log entries': error});\r\n return Promise.resolve();\r\n }\r\n\r\n if (!keys.length) {\r\n return Promise.resolve();\r\n }\r\n\r\n LogBuffer._flushInProgress = true;\r\n\r\n return LogBuffer._flushChunks(keys, postBatch)\r\n .catch((error) => {\r\n console.error({'Buffered log flush failed': error});\r\n // @intentional allow the chain to continue\r\n })\r\n .then(() => {\r\n LogBuffer._flushInProgress = false;\r\n });\r\n }\r\n\r\n /**\r\n * @param {Array} keys\r\n * @param {function(Array<{}>): Promise} postBatch\r\n * @returns {Promise}\r\n * @private\r\n */\r\n static _flushChunks(keys, postBatch) {\r\n if (!keys.length) {\r\n return Promise.resolve();\r\n }\r\n\r\n const chunkKeys = [];\r\n const chunkEntries = [];\r\n let chunkBytes = 0;\r\n\r\n while (keys.length && chunkKeys.length < CHUNK_ENTRIES) {\r\n const key = keys[0];\r\n const raw = localStorage.getItem(key);\r\n\r\n if (!raw) {\r\n // vanished (another tab, or eviction) - nothing to send\r\n keys.shift();\r\n continue;\r\n }\r\n\r\n if (chunkKeys.length && (chunkBytes + raw.length) > CHUNK_BYTES) {\r\n break;\r\n }\r\n\r\n let entry;\r\n\r\n try {\r\n entry = JSON.parse(raw);\r\n } catch (error) {\r\n // unreadable entry: discard it rather than block the queue behind it\r\n console.error({'Discarding unreadable buffered log entry': {key, error}});\r\n localStorage.removeItem(key);\r\n keys.shift();\r\n continue;\r\n }\r\n\r\n chunkKeys.push(key);\r\n chunkEntries.push(entry);\r\n chunkBytes += raw.length;\r\n keys.shift();\r\n }\r\n\r\n if (!chunkEntries.length) {\r\n return Promise.resolve();\r\n }\r\n\r\n LogBuffer._prependDroppedNotice(chunkEntries);\r\n\r\n return postBatch(chunkEntries).then((accepted) => {\r\n if (!accepted) {\r\n // leave the entries in place and stop; they'll be retried after the backoff\r\n LogBuffer._nextFlushAllowedStamp = Date.now() + FLUSH_RETRY_INTERVAL_MS;\r\n return;\r\n }\r\n\r\n for (const key of chunkKeys) {\r\n localStorage.removeItem(key);\r\n\r\n if (LogBuffer._newestKey === key) {\r\n LogBuffer._newestKey = null;\r\n LogBuffer._newestSignature = null;\r\n }\r\n }\r\n\r\n return LogBuffer._flushChunks(keys, postBatch);\r\n }, (reason) => {\r\n LogBuffer._nextFlushAllowedStamp = Date.now() + FLUSH_RETRY_INTERVAL_MS;\r\n\r\n // postBatch is contracted to resolve with a boolean, so a rejection means the poster\r\n // itself failed rather than the server declining the batch. Rejecting keeps the two\r\n // apart and carries the reason up to flush(), which logs it - swallowing it here left\r\n // that catch unreachable and discarded the only evidence of what went wrong.\r\n return Promise.reject(reason);\r\n });\r\n }\r\n\r\n /**\r\n * Adds a synthetic entry recording how many entries were evicted, so that a gap in the record is\r\n * visible rather than silent.\r\n *\r\n * @param {Array<{}>} chunkEntries\r\n * @private\r\n */\r\n static _prependDroppedNotice(chunkEntries) {\r\n try {\r\n const dropped = parseInt(localStorage.getItem(DROPPED_COUNT_KEY), 10);\r\n\r\n if (dropped > 0) {\r\n chunkEntries.unshift({\r\n descriptor: {\r\n message: `${dropped} buffered log entries were discarded because the offline log buffer was full.`,\r\n buffered: true,\r\n stamp: Date.now(),\r\n }\r\n });\r\n\r\n localStorage.removeItem(DROPPED_COUNT_KEY);\r\n }\r\n } catch (error) {\r\n console.error({'Failed to read dropped log entry count': error});\r\n }\r\n }\r\n\r\n /**\r\n * @returns {Array} entry keys, oldest first\r\n * @private\r\n */\r\n static _entryKeys() {\r\n const keys = [];\r\n\r\n for (let i = 0; i < localStorage.length; i++) {\r\n const key = localStorage.key(i);\r\n\r\n if (key && key.startsWith(ENTRY_KEY_PREFIX)) {\r\n keys.push(key);\r\n }\r\n }\r\n\r\n // keys embed a zero-padded stamp and serial, so lexicographic order is chronological\r\n keys.sort();\r\n\r\n return keys;\r\n }\r\n\r\n /**\r\n * Identity of an entry for repeat detection.\r\n *\r\n * Built with JSON.stringify rather than by joining with a separator, so that no character needs\r\n * to be assumed absent from a message or stack.\r\n *\r\n * @param {{}} doc\r\n * @returns {string}\r\n * @private\r\n */\r\n static _signatureOf(doc) {\r\n const descriptor = doc.error || doc.descriptor || {};\r\n\r\n return JSON.stringify([descriptor.message || '', descriptor.stack || '']);\r\n }\r\n\r\n /**\r\n * @param {string} signature\r\n * @param {{}} descriptor\r\n * @returns {boolean} true if the entry was merged into the newest buffered entry\r\n * @private\r\n */\r\n static _coalesceWithNewest(signature, descriptor) {\r\n if (LogBuffer._newestKey === null) {\r\n LogBuffer._loadNewest();\r\n }\r\n\r\n if (!LogBuffer._newestKey || LogBuffer._newestSignature !== signature) {\r\n return false;\r\n }\r\n\r\n const raw = localStorage.getItem(LogBuffer._newestKey);\r\n\r\n if (!raw) {\r\n LogBuffer._newestKey = null;\r\n LogBuffer._newestSignature = null;\r\n return false;\r\n }\r\n\r\n const existing = JSON.parse(raw);\r\n const existingDescriptor = existing.error || existing.descriptor;\r\n\r\n if (!existingDescriptor) {\r\n return false;\r\n }\r\n\r\n existingDescriptor.count = (existingDescriptor.count || 1) + 1;\r\n existingDescriptor.lastStamp = descriptor?.stamp || Date.now();\r\n\r\n localStorage.setItem(LogBuffer._newestKey, JSON.stringify(existing));\r\n\r\n return true;\r\n }\r\n\r\n /**\r\n * Establishes the newest buffered entry after a page load, so that repeats spanning a reload are\r\n * still coalesced - which is the case that matters, since a reload loop produces one entry per\r\n * load.\r\n *\r\n * @private\r\n */\r\n static _loadNewest() {\r\n try {\r\n const keys = LogBuffer._entryKeys();\r\n\r\n if (!keys.length) {\r\n LogBuffer._newestKey = '';\r\n LogBuffer._newestSignature = null;\r\n return;\r\n }\r\n\r\n const key = keys[keys.length - 1];\r\n const raw = localStorage.getItem(key);\r\n\r\n LogBuffer._newestKey = key;\r\n LogBuffer._newestSignature = raw ? LogBuffer._signatureOf(JSON.parse(raw)) : null;\r\n } catch (error) {\r\n console.error({'Failed to inspect newest buffered log entry': error});\r\n LogBuffer._newestKey = '';\r\n LogBuffer._newestSignature = null;\r\n }\r\n }\r\n\r\n /**\r\n * @param {{}} doc\r\n * @param {{}} descriptor\r\n * @returns {string}\r\n * @private\r\n */\r\n static _truncateEntry(doc, descriptor) {\r\n if (descriptor) {\r\n if (typeof descriptor.stack === 'string') {\r\n descriptor.stack = `${descriptor.stack.slice(0, 2000)}\\n[truncated]`;\r\n }\r\n\r\n if (typeof descriptor.message === 'string') {\r\n descriptor.message = `${descriptor.message.slice(0, 4000)}\\n[truncated]`;\r\n }\r\n\r\n descriptor.truncated = true;\r\n }\r\n\r\n return JSON.stringify(doc).slice(0, MAX_ENTRY_BYTES);\r\n }\r\n\r\n /**\r\n * @private\r\n */\r\n static _enforceLimits() {\r\n const keys = LogBuffer._entryKeys();\r\n\r\n let totalBytes = 0;\r\n\r\n for (const key of keys) {\r\n totalBytes += (localStorage.getItem(key) || '').length;\r\n }\r\n\r\n let excess = keys.length - MAX_ENTRIES;\r\n\r\n while (totalBytes > MAX_TOTAL_BYTES && excess < keys.length) {\r\n excess++;\r\n totalBytes -= (localStorage.getItem(keys[excess - 1]) || '').length;\r\n }\r\n\r\n if (excess > 0) {\r\n LogBuffer._removeKeys(keys.slice(0, excess));\r\n }\r\n }\r\n\r\n /**\r\n * @param {number} count\r\n * @private\r\n */\r\n static _evictOldest(count) {\r\n LogBuffer._removeKeys(LogBuffer._entryKeys().slice(0, count));\r\n }\r\n\r\n /**\r\n * @param {Array} keys\r\n * @private\r\n */\r\n static _removeKeys(keys) {\r\n if (!keys.length) {\r\n return;\r\n }\r\n\r\n for (const key of keys) {\r\n localStorage.removeItem(key);\r\n\r\n if (LogBuffer._newestKey === key) {\r\n LogBuffer._newestKey = null;\r\n LogBuffer._newestSignature = null;\r\n }\r\n }\r\n\r\n try {\r\n const dropped = (parseInt(localStorage.getItem(DROPPED_COUNT_KEY), 10) || 0) + keys.length;\r\n localStorage.setItem(DROPPED_COUNT_KEY, dropped.toString());\r\n } catch (error) {\r\n console.error({'Failed to record dropped log entry count': error});\r\n }\r\n }\r\n\r\n /**\r\n * @private\r\n */\r\n static _attachOnlineListener() {\r\n if (LogBuffer._onlineListenerAttached || typeof addEventListener !== 'function') {\r\n return;\r\n }\r\n\r\n LogBuffer._onlineListenerAttached = true;\r\n\r\n addEventListener('online', () => {\r\n // cleared so that a genuine reconnection isn't blocked by an earlier backoff\r\n LogBuffer._nextFlushAllowedStamp = 0;\r\n\r\n if (LogBuffer.onFlushRequested) {\r\n LogBuffer.onFlushRequested();\r\n }\r\n });\r\n }\r\n\r\n /**\r\n * Set by Logger, which owns the transport.\r\n *\r\n * @type {function|null}\r\n */\r\n static onFlushRequested = null;\r\n}\r\n","import {LogBuffer} from \"./LogBuffer.js\";\r\n\r\nconst JS_LOG_PATH = '/jsLog.php';\r\n\r\n/**\r\n * Deadline for a log post. Without one a stalled connection leaves the request hanging, which for a\r\n * batch flush would block the queue behind it indefinitely.\r\n *\r\n * @type {number}\r\n */\r\nconst LOG_POST_TIMEOUT_MS = 30000;\r\n\r\nexport class Logger {\r\n\r\n /**\r\n * @type {App}\r\n */\r\n static app;\r\n\r\n /**\r\n * @type {string}\r\n */\r\n static bsbiAppVersion;\r\n\r\n static _serialNumber = 0;\r\n\r\n /**\r\n * Used only if the Logger is running in a service worker context, otherwise use Logger.app.session.userId\r\n *\r\n * @type {string}\r\n */\r\n static userId;\r\n\r\n static get serialNumber() {\r\n return Logger._serialNumber++;\r\n }\r\n\r\n /**\r\n * For test builds reports a JavaScript error, otherwise is a no-op\r\n *\r\n * @param {string} message\r\n * @param {string|null} [url]\r\n * @param {string|number|null} [line]\r\n * @param {number|null} [column]\r\n * @param {Error|null} [errorObj]\r\n * @returns {Promise}\r\n */\r\n static logErrorDev(message, url = '', line= '', column = null, errorObj = null) {\r\n return (Logger?.app?.isTestBuild) ?\r\n Logger.logError(message, url, line, column, errorObj)\r\n :\r\n Promise.resolve();\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * For test builds reports a JavaScript error, otherwise is a no-op\r\n *\r\n * @param {string} message\r\n * @param {string|null} [url]\r\n * @returns {Promise}\r\n */\r\n static logMessageDev(message, url = '') {\r\n return (Logger?.app?.isTestBuild) ?\r\n Logger.logMessage(message, url)\r\n :\r\n Promise.resolve();\r\n }\r\n\r\n static stringifyObject(obj) {\r\n if (obj === null || obj === undefined) {\r\n // reached via Promise.reject() with no reason, among others; obj.toString() would throw\r\n return String(obj);\r\n } else if (typeof obj !== 'object') {\r\n return obj.toString();\r\n } else if (obj instanceof Error) {\r\n return `Error (${obj.name}): ${obj.message}, code: ${obj.code}\\nStack: ${obj.stack}`;\r\n } else {\r\n const stringified = JSON.stringify(obj, null, 2);\r\n return stringified === '{}' ? obj.toString() : stringified;\r\n }\r\n }\r\n\r\n /**\r\n * reports a JavaScript error\r\n *\r\n * @param {string|object} message\r\n * @param {string|null} [url]\r\n * @param {string|number|null} [line]\r\n * @param {number|null} [column]\r\n * @param {Error|null} [errorObj]\r\n * @param {{}|null} [context] extra detail recorded alongside the entry rather than inside the\r\n * message. LogBuffer coalesces repeats by message and stack, so anything that varies per\r\n * occurrence - an object id, say - belongs here: putting it in the message would make every\r\n * repeat unique and defeat coalescing entirely.\r\n * @returns {Promise} a fulfilled promise (even if logging fails)\r\n */\r\n static logError(message, url = '', line= '', column = null, errorObj = null, context = null) {\r\n try {\r\n console.error(message, url, line, errorObj);\r\n\r\n if (!errorObj) {\r\n // on V8 construction of PlaceholderError will capture a stack trace automatically\r\n errorObj = new _PlaceholderError(message);\r\n\r\n // otherwise may need to throw and catch the error\r\n if (!Error.captureStackTrace) {\r\n try {\r\n // thrown just to generate a stack trace\r\n // noinspection ExceptionCaughtLocallyJS\r\n throw errorObj;\r\n } catch (error) {\r\n\r\n }\r\n }\r\n }\r\n\r\n if (!url) {\r\n url = globalThis.window?.location?.href;\r\n }\r\n\r\n if (console.trace) {\r\n console.trace('Trace');\r\n }\r\n\r\n const doc = {error: {}};\r\n const errorDescriptor = doc.error;\r\n\r\n errorDescriptor.n = Logger.serialNumber;\r\n\r\n if (line !== null && line !== undefined) {\r\n errorDescriptor.line = line;\r\n }\r\n\r\n if (errorObj && ('stack' in errorObj)) {\r\n errorDescriptor.stack = errorObj.stack;\r\n }\r\n\r\n if (url !== null && url !== undefined && url !== '') {\r\n errorDescriptor.url = url;\r\n }\r\n\r\n if (globalThis.window?.location?.href) {\r\n errorDescriptor.referrer = window.location.href;\r\n }\r\n\r\n if (globalThis.window?.location?.search) {\r\n errorDescriptor.urlquery = window.location.search;\r\n }\r\n\r\n if (globalThis.window?.location?.hash) {\r\n errorDescriptor.urlhash = window.location.hash;\r\n }\r\n\r\n if (Logger.app?.session?.userId || Logger.userId) {\r\n errorDescriptor.userid = Logger.app?.session?.userId || Logger.userId;\r\n }\r\n\r\n errorDescriptor.installed = Logger.isInstalledStatus();\r\n\r\n if (globalThis.navigator) {\r\n // noinspection PlatformDetectionJS,JSDeprecatedSymbols\r\n errorDescriptor.browser = navigator.appName;\r\n // noinspection JSDeprecatedSymbols\r\n errorDescriptor.browserv = navigator.appVersion;\r\n errorDescriptor.userAgent = navigator.userAgent;\r\n }\r\n\r\n errorDescriptor.versions = Logger.bsbiAppVersion;\r\n\r\n if (message instanceof Error) {\r\n message = Logger.stringifyObject(message);\r\n }\r\n\r\n errorDescriptor.message = message;\r\n\r\n if (context) {\r\n errorDescriptor.context = context;\r\n }\r\n\r\n errorDescriptor.stamp = Date.now();\r\n\r\n return Logger._deliver(doc);\r\n } catch (error) {\r\n console.error({'error in error handler' : error});\r\n\r\n // Callers chain .then()/.finally() onto this, so a promise must be returned even when\r\n // the error handler itself fails.\r\n return Promise.resolve();\r\n }\r\n }\r\n\r\n /**\r\n * remote-logs a message\r\n *\r\n * @param {string|object} message\r\n * @param {string|null} [url]\r\n * @returns {Promise} a fulfilled promise (even if logging fails)\r\n */\r\n static logMessage(message, url = '') {\r\n try {\r\n return Logger._buildAndDeliverMessage(message, url);\r\n } catch (error) {\r\n console.error({'error in message logger' : error});\r\n return Promise.resolve();\r\n }\r\n }\r\n\r\n static isInstalledStatus() {\r\n if (globalThis.window?.matchMedia) {\r\n return globalThis.window.matchMedia('(display-mode: standalone)').matches ? 'yes' : 'no';\r\n } else {\r\n return 'untested';\r\n }\r\n }\r\n\r\n /**\r\n * @param {string|object} message\r\n * @param {string|null} url\r\n * @returns {Promise}\r\n * @private\r\n */\r\n static _buildAndDeliverMessage(message, url) {\r\n console.log(message);\r\n\r\n if (!url) {\r\n url = globalThis.window?.location?.href;\r\n }\r\n\r\n if (console.trace) {\r\n console.trace('Trace');\r\n }\r\n\r\n const doc = {descriptor: {}};\r\n const messageDescriptor = doc.descriptor;\r\n\r\n messageDescriptor.n = Logger.serialNumber;\r\n\r\n if (url !== null && url !== undefined && url !== '') {\r\n messageDescriptor.url = url;\r\n }\r\n\r\n if (globalThis.window?.location?.search) {\r\n messageDescriptor.urlquery = window.location.search;\r\n }\r\n\r\n if (globalThis.window?.location?.hash) {\r\n messageDescriptor.urlhash = window.location.hash;\r\n }\r\n\r\n if (Logger.app?.session?.userId || Logger.userId) {\r\n messageDescriptor.userid = Logger.app?.session?.userId || Logger.userId;\r\n }\r\n\r\n messageDescriptor.installed = Logger.isInstalledStatus();\r\n\r\n // noinspection PlatformDetectionJS,JSDeprecatedSymbols\r\n messageDescriptor.browser = navigator?.appName;\r\n // noinspection JSDeprecatedSymbols\r\n messageDescriptor.browserv = navigator?.appVersion;\r\n messageDescriptor.useragent = navigator?.userAgent;\r\n messageDescriptor.version = Logger.bsbiAppVersion;\r\n\r\n messageDescriptor.message = message;\r\n messageDescriptor.stamp = Date.now();\r\n\r\n return Logger._deliver(doc);\r\n }\r\n\r\n /**\r\n * Hands an entry to the buffer and lets the next batch carry it.\r\n *\r\n * Entries used to be posted one at a time, as they were raised, and only buffered when that\r\n * failed. But the conditions that produce log entries in the field also produce them in bursts -\r\n * a marginal connection makes every save fail, and each failure was then costing a second\r\n * request of its own - and each request wakes the radio, which is the expensive part.\r\n *\r\n * Batching is safe here because the buffer is localStorage-backed and synchronous: the entry is\r\n * durable before this returns, so a crash, unload or reload during the wait loses nothing, and\r\n * whatever is still held gets flushed by the next batch, by LogBuffer's own 'online' listener,\r\n * or at the next start-up.\r\n *\r\n * @param {{}} doc\r\n * @returns {Promise} always resolves\r\n * @private\r\n */\r\n static _deliver(doc) {\r\n const undeliverable = !globalThis.navigator?.onLine;\r\n\r\n if (LogBuffer.store(doc, undeliverable)) {\r\n if (undeliverable) {\r\n console.info({'Offline, report buffered': doc});\r\n } else {\r\n Logger._scheduleBufferedFlush();\r\n }\r\n\r\n return Promise.resolve();\r\n }\r\n\r\n // There is nowhere to hold the entry - a service worker has no localStorage, and storage can\r\n // be unavailable or full - so it goes now or not at all.\r\n if (undeliverable) {\r\n console.info({'Offline and unable to buffer, report dropped': doc});\r\n\r\n return Promise.resolve();\r\n }\r\n\r\n return Logger._postPayload(doc).then(() => undefined);\r\n }\r\n\r\n /**\r\n * How long an entry waits for company before the buffer is flushed.\r\n *\r\n * Long enough that a burst - a run of failing saves, a reload loop - leaves as one request\r\n * rather than a dozen, and short enough that an entry raised while the app is in use still\r\n * reaches the server during that session. Nothing is at risk during the wait: the buffer is\r\n * localStorage-backed, so entries are durable as soon as they are stored.\r\n *\r\n * Settable, like Model.SAVE_POST_TIMEOUT_MS and Track.msInterval, so that the batching can be\r\n * tuned without a rebuild - and so that scripts/testLogBatching.mjs does not have to sit through\r\n * the real interval.\r\n *\r\n * @type {number}\r\n */\r\n static bufferedFlushDelayMs = 10000;\r\n\r\n /**\r\n * Timer handle for a pending batch flush.\r\n *\r\n * @type {number|null}\r\n * @private\r\n */\r\n static _bufferedFlushHandle = null;\r\n\r\n /**\r\n * Starts the wait for a batch flush, if one is not already pending.\r\n *\r\n * @private\r\n */\r\n static _scheduleBufferedFlush() {\r\n if (Logger._bufferedFlushHandle) {\r\n return; // a flush is already due, and it will carry this entry with it\r\n }\r\n\r\n Logger._bufferedFlushHandle = setTimeout(() => {\r\n Logger._bufferedFlushHandle = null;\r\n\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.flushBufferedLogs();\r\n // @intentional end of chain - flushBufferedLogs() always resolves, and a failed flush\r\n // leaves the entries in place for LogBuffer's own retry backoff to pick up\r\n }, Logger.bufferedFlushDelayMs);\r\n }\r\n\r\n /**\r\n * Sends buffered entries to the server in batches.\r\n *\r\n * @returns {Promise} always resolves\r\n */\r\n static flushBufferedLogs() {\r\n if (!globalThis.navigator?.onLine) {\r\n return Promise.resolve();\r\n }\r\n\r\n return LogBuffer.flush((entries) => Logger._postPayload(entries));\r\n }\r\n\r\n /**\r\n * Posts either a single entry or an array of them; jsLog.php accepts both.\r\n *\r\n * Must never call Logger.logError(), or a failing log post would generate further entries.\r\n *\r\n * @param {{}|Array<{}>} payload\r\n * @returns {Promise} resolves true if the server accepted the payload\r\n * @private\r\n */\r\n static _postPayload(payload) {\r\n let timeoutId = null;\r\n\r\n const clearPostTimeout = () => {\r\n if (timeoutId) {\r\n clearTimeout(timeoutId);\r\n timeoutId = null;\r\n }\r\n };\r\n\r\n try {\r\n const fetchOptions = {\r\n method: \"POST\", // *GET, POST, PUT, DELETE, etc.\r\n mode: \"cors\", // no-cors, *cors, same-origin\r\n cache: \"no-cache\", // *default, no-cache, reload, force-cache, only-if-cached\r\n credentials: \"include\", // include, *same-origin, omit\r\n headers: {\r\n \"Content-Type\": \"application/json\",\r\n },\r\n redirect: \"follow\", // manual, *follow, error\r\n referrerPolicy: \"no-referrer-when-downgrade\", // no-referrer, *no-referrer-when-downgrade, origin, origin-when-cross-origin, same-origin, strict-origin, strict-origin-when-cross-origin, unsafe-url\r\n body: JSON.stringify(payload),\r\n };\r\n\r\n if (typeof AbortController !== 'undefined') {\r\n const signalController = new AbortController();\r\n fetchOptions.signal = signalController.signal;\r\n\r\n timeoutId = setTimeout(() => {\r\n timeoutId = null;\r\n signalController.abort();\r\n }, LOG_POST_TIMEOUT_MS);\r\n }\r\n\r\n return fetch(JS_LOG_PATH, fetchOptions).then(\r\n (response) => {\r\n if (!response.ok) {\r\n console.info({'Remote logging rejected': response.status});\r\n }\r\n\r\n return response.ok;\r\n },\r\n (reason) => {\r\n console.info({'Remote logging failed': reason});\r\n return false;\r\n }\r\n ).finally(clearPostTimeout);\r\n } catch (error) {\r\n clearPostTimeout();\r\n console.info({'Remote logging threw': error});\r\n\r\n return Promise.resolve(false);\r\n }\r\n }\r\n}\r\n\r\n// LogBuffer owns the storage and scheduling; Logger owns the transport, so it supplies the means of\r\n// draining the buffer when connectivity returns.\r\nLogBuffer.onFlushRequested = () => Logger.flushBufferedLogs();\r\n\r\n/**\r\n * Throw this only from within logError\r\n */\r\nclass _PlaceholderError extends Error {\r\n constructor(...args) {\r\n super(...args);\r\n\r\n Error.captureStackTrace?.(this, Logger.logError); // see https://v8.dev/docs/stack-trace-api\r\n }\r\n}","/**\r\n * @typedef {number} EventHarness~Handle\r\n */\r\nimport {Logger} from \"../utils/Logger\";\r\n\r\nexport const EVENT_HARNESS_STOP_PROPAGATION = 'STOP_PROPAGATION';\r\n\r\nexport class EventHarness {\r\n /**\r\n *\r\n * @type {Object>}\r\n */\r\n _eventListeners = {};\r\n\r\n /**\r\n *\r\n * @type {Map>>}\r\n * @private\r\n */\r\n static _staticEventListeners = new Map;\r\n\r\n /**\r\n *\r\n * @type {Map>}\r\n * @private\r\n */\r\n _wrappedStaticHandles = new Map;\r\n\r\n /**\r\n *\r\n * @type {Array<{element: Node, type: string, handler: EventListenerOrEventListenerObject, options: AddEventListenerOptions}|null>}\r\n * @private\r\n */\r\n _domEventListeners = [];\r\n\r\n // static STOP_PROPAGATION = EVENT_HARNESS_STOP_PROPAGATION;\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {Node} element\r\n * @param {string} type\r\n * @param {EventListenerOrEventListenerObject} handler\r\n * @param {AddEventListenerOptions=} options\r\n * @returns {number}\r\n */\r\n addDomEventListener(element, type, handler, options) {\r\n element.addEventListener(type, handler, options);\r\n return this._domEventListeners.push({element, type, handler, options}) - 1;\r\n }\r\n\r\n /**\r\n *\r\n * @param {number} handle\r\n */\r\n removeDomEventListener(handle) {\r\n if (this._domEventListeners[handle]) {\r\n const listener = this._domEventListeners[handle];\r\n listener.element.removeEventListener(listener.type, listener.handler, listener.options);\r\n listener.handler = null;\r\n listener.element = null;\r\n this._domEventListeners[handle] = null;\r\n }\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {Array} handles\r\n */\r\n removeDomEventListeners(handles) {\r\n handles.forEach(this.removeDomEventListener.bind(this));\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {string} eventName\r\n * @param {{}} handlerObject\r\n * @param {string} handlerMethodName\r\n * @param {*=} constructionParam\r\n * @returns {number}\r\n */\r\n addWeakListener (eventName, handlerObject, handlerMethodName, constructionParam = {}) {\r\n //this._eventListeners = this._eventListeners || [];\r\n\r\n const weakWrapped = new WeakRef(handlerObject);\r\n handlerObject = null;\r\n\r\n const handlerFunction = (context, eventName, invocationParam = {}) => {\r\n let weakObject = weakWrapped.deref();\r\n\r\n if (weakObject) {\r\n weakObject[handlerMethodName]({context, eventName, ...invocationParam, ...constructionParam});\r\n } else {\r\n console.warn(`A ${eventName} handler (${handlerMethodName}) has been garbage collected`);\r\n }\r\n }\r\n\r\n if (this._eventListeners[eventName]) {\r\n return (this._eventListeners[eventName].push(handlerFunction)) - 1;\r\n } else {\r\n this._eventListeners[eventName] = [handlerFunction];\r\n return 0; // first element in the array\r\n }\r\n }\r\n\r\n // /**\r\n // *\r\n // * @param {string} eventName\r\n // * @param {Function} handler\r\n // * @param {*=} constructionParam\r\n // * @return {EventHarness~Handle} handle\r\n // */\r\n // addWeakListener(eventName, handler, constructionParam = {}) {\r\n // //this._eventListeners = this._eventListeners || [];\r\n //\r\n // /**\r\n // *\r\n // * @type {WeakRef}\r\n // */\r\n // const weakWrapped = new WeakRef(handler);\r\n //\r\n // const handlerFunction = (context, eventName, invocationParam = {}) => {\r\n // const handler = weakWrapped.deref();\r\n //\r\n // if (handler) {\r\n // handler({context, eventName, ...invocationParam, ...constructionParam});\r\n // } else {\r\n // console.warn(`A ${eventName} handler has been garbage collected`);\r\n // }\r\n // }\r\n //\r\n // if (this._eventListeners[eventName]) {\r\n // return (this._eventListeners[eventName].push(handlerFunction)) - 1;\r\n // } else {\r\n // this._eventListeners[eventName] = [handlerFunction];\r\n // return 0; // first element in array\r\n // }\r\n // }\r\n\r\n /**\r\n *\r\n * @param {string} eventName\r\n * @param {Function} handler\r\n * @param {*=} constructionParam\r\n * @return {EventHarness~Handle} handle\r\n */\r\n addListener (eventName, handler, constructionParam = {}) {\r\n const handlerFunction = (context, eventName, invocationParam = {}) =>\r\n handler({context, eventName, ...invocationParam, ...constructionParam});\r\n\r\n if (this._eventListeners[eventName]) {\r\n return (this._eventListeners[eventName].push(handlerFunction)) - 1;\r\n } else {\r\n this._eventListeners[eventName] = [handlerFunction];\r\n return 0; // first element in the array\r\n }\r\n }\r\n\r\n /**\r\n *\r\n * @param {{}} staticTarget\r\n * @param {string} eventName\r\n * @param {Function} handler\r\n * @param {*=} constructionParam\r\n * @return {EventHarness~Handle} handle\r\n */\r\n static staticAddListener (staticTarget, eventName, handler, constructionParam = {}) {\r\n const handlerFunction = (context, eventName, invocationParam = {}) =>\r\n handler({context, eventName, ...invocationParam, ...constructionParam});\r\n\r\n if (!EventHarness._staticEventListeners.has(staticTarget)) {\r\n EventHarness._staticEventListeners.set(staticTarget, {});\r\n }\r\n\r\n const eventListeners = EventHarness._staticEventListeners.get(staticTarget);\r\n\r\n if (eventListeners[eventName]) {\r\n return (eventListeners[eventName].push(handlerFunction)) - 1;\r\n } else {\r\n eventListeners[eventName] = [handlerFunction];\r\n return 0; // first element in the array\r\n }\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {{}} staticTarget\r\n * @param {string} eventName\r\n * @param {Function} handler\r\n * @param {*=} constructionParam\r\n */\r\n addStaticListenerWrapper(staticTarget, eventName, handler, constructionParam = {}) {\r\n let wrappedHandles;\r\n\r\n if (this._wrappedStaticHandles.has(staticTarget)) {\r\n wrappedHandles = this._wrappedStaticHandles.get(staticTarget);\r\n } else {\r\n wrappedHandles = [];\r\n this._wrappedStaticHandles.set(staticTarget, wrappedHandles);\r\n }\r\n\r\n wrappedHandles.push({eventName, handle: EventHarness.staticAddListener(staticTarget, eventName, handler, constructionParam)});\r\n }\r\n\r\n /**\r\n *\r\n * @param {string} eventName\r\n * @param {number} handle\r\n * @returns {undefined}\r\n */\r\n removeListener(eventName, handle) {\r\n if (this._eventListeners[eventName]?.[handle]) {\r\n delete this._eventListeners[eventName][handle];\r\n }\r\n // no need for console warning if event listener already gone\r\n // as a model may have been destroyed legitimately without the awareness of everyone who holds listeners\r\n\r\n // else {\r\n // console.info('trying to remove non-existent event handler, event = ' + eventName + ' handle = ' + handle);\r\n // }\r\n return undefined;\r\n }\r\n\r\n /**\r\n *\r\n * @param {{}} staticTarget\r\n * @param {string} eventName\r\n * @param {number} handle\r\n */\r\n static staticRemoveListener(staticTarget, eventName, handle) {\r\n const eventListeners = EventHarness._staticEventListeners.get(staticTarget);\r\n\r\n if (eventListeners[eventName]?.[handle]) {\r\n delete eventListeners[eventName][handle];\r\n }\r\n // no need for console warning if event listener already gone\r\n // as a model may have been destroyed legitimately without the awareness of everyone who holds listeners\r\n }\r\n\r\n /**\r\n *\r\n */\r\n destructor() {\r\n this._eventListeners = {};\r\n\r\n for (let n in this._domEventListeners) {\r\n if (this._domEventListeners.hasOwnProperty(n) && this._domEventListeners[n]) {\r\n const listener = this._domEventListeners[n];\r\n listener.element.removeEventListener(listener.type, listener.handler, listener.options);\r\n this._domEventListeners[n] = null;\r\n }\r\n }\r\n\r\n this._domEventListeners = [];\r\n\r\n for (const [targetClass, eventDescriptors] of this._wrappedStaticHandles) {\r\n for (let descriptor of eventDescriptors) {\r\n EventHarness.staticRemoveListener(targetClass, descriptor.eventName, descriptor.handle);\r\n }\r\n }\r\n this._wrappedStaticHandles.clear();\r\n }\r\n\r\n /**\r\n *\r\n * @param {string} eventName\r\n * @param {Object=} param optional parameter to pass on to listener\r\n * @returns {void}\r\n */\r\n fireEvent (eventName, param) {\r\n if (this._eventListeners) {\r\n for (let f in this._eventListeners[eventName]) {\r\n try {\r\n if (this._eventListeners[eventName][f](this, eventName, arguments[1]) === EVENT_HARNESS_STOP_PROPAGATION) {\r\n break;\r\n }\r\n } catch (exception) {\r\n console.error({'Exception thrown in event handler' : {eventName, exception}});\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logError(\r\n `Exception thrown in event handler '${eventName}': ${exception.message}`,\r\n '',\r\n null,\r\n null,\r\n exception\r\n );\r\n }\r\n }\r\n }\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * @param {{}} staticTarget\r\n * @param {string} eventName\r\n * @param {Object=} param optional parameter to pass on to listener\r\n * @returns {void}\r\n */\r\n static staticFireEvent (staticTarget, eventName, param) {\r\n const eventListeners = EventHarness._staticEventListeners.get(staticTarget);\r\n\r\n if (eventListeners) {\r\n for (let f in eventListeners[eventName]) {\r\n try {\r\n if (eventListeners[eventName][f](this, eventName, arguments[2]) === EVENT_HARNESS_STOP_PROPAGATION) {\r\n break;\r\n }\r\n } catch (exception) {\r\n console.error({'Exception thrown in static event handler': {eventName, exception}});\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logError(\r\n `Exception thrown in static event handler '${eventName}': ${exception.message}`,\r\n '',\r\n null,\r\n null,\r\n exception\r\n );\r\n }\r\n }\r\n }\r\n }\r\n}\r\n","/**\r\n * Event fired when user requests a new blank survey\r\n *\r\n * @type {string}\r\n */\r\nexport const APP_EVENT_ADD_SURVEY_USER_REQUEST = 'useraddsurveyrequest';\r\n\r\n/**\r\n * Event fired when user requests a reset (local clearance) of all surveys\r\n * @type {string}\r\n */\r\nexport const APP_EVENT_RESET_SURVEYS = 'userresetsurveys';\r\n\r\n/**\r\n * Fired after App.currentSurvey has been set to a new blank survey\r\n * the survey will be accessible in App.currentSurvey\r\n *\r\n * @type {string}\r\n */\r\nexport const APP_EVENT_NEW_SURVEY = 'newsurvey';\r\n\r\n/**\r\n * Fired when a brand-new occurrence is added\r\n *\r\n * @type {string}\r\n */\r\nexport const APP_EVENT_OCCURRENCE_ADDED = 'occurrenceadded';\r\n\r\n/**\r\n * Fired when new user preferences are first restored from local storage\r\n *\r\n * @type {string}\r\n */\r\nexport const APP_EVENT_OPTIONS_RESTORED = 'optionsrestored';\r\n\r\n/**\r\n * Fired when a survey is retrieved from local storage\r\n * parameter is {survey : Survey}\r\n *\r\n * @type {string}\r\n */\r\nexport const APP_EVENT_SURVEY_LOADED = 'surveyloaded';\r\n\r\n/**\r\n * Fired when an occurrence is retrieved from local storage or newly initialised\r\n * parameter is {occurrence : Occurrence}\r\n *\r\n * @type {string}\r\n */\r\nexport const APP_EVENT_OCCURRENCE_LOADED = 'occurrenceloaded';\r\n\r\nexport const APP_EVENT_CURRENT_OCCURRENCE_CHANGED = 'currentoccurrencechanged';\r\n\r\n/**\r\n * Fired when the selected current survey id is changed\r\n * parameter is {newSurvey : Survey|null}\r\n *\r\n * (this is not fired for modification of the survey content)\r\n *\r\n * @type {string}\r\n */\r\nexport const APP_EVENT_CURRENT_SURVEY_CHANGED = 'currentsurveychanged';\r\n\r\n/**\r\n * Fired if the surveys list might need updating (as a survey has been added, removed or changed)\r\n *\r\n * @type {string}\r\n */\r\nexport const APP_EVENT_SURVEYS_CHANGED = 'surveyschanged';\r\n\r\n/**\r\n * Fired if the survey definitions list has been updated (as a survey has been added, removed or changed)\r\n *\r\n * @type {string}\r\n */\r\nexport const APP_EVENT_SURVEY_DEFINITIONS_CHANGED = 'surveydefinitionschanged';\r\n\r\n/**\r\n * Fired after fully-successful sync-all\r\n * (or if sync-all resolved with nothing to send)\r\n *\r\n * @todo this is misleading as in fact is fired when all saved to indexeddb or to server\r\n *\r\n * @type {string}\r\n */\r\nexport const APP_EVENT_ALL_SYNCED_TO_SERVER = 'allsyncedtoserver';\r\n\r\n/**\r\n * fired if sync-all called, but one or more objects failed to be stored\r\n *\r\n * @type {string}\r\n */\r\nexport const APP_EVENT_SYNC_ALL_FAILED = 'syncallfailed';\r\n\r\nexport const APP_EVENT_USER_LOGIN = 'login';\r\n\r\nexport const APP_EVENT_USER_LOGOUT = 'logout';\r\n\r\n/**\r\n * Fired when watching of GPS has been granted following user request.\r\n *\r\n * @type {string}\r\n */\r\nexport const APP_EVENT_WATCH_GPS_USER_REQUEST = 'watchgps';\r\n\r\n/**\r\n * Fired when state of survey tracking has changed.\r\n * Applies only when the current survey is geolocated\r\n *\r\n * parameter: {state : boolean}\r\n *\r\n * @type {string}\r\n */\r\nexport const APP_EVENT_GPS_FOLLOWING_CURRENT_SURVEY_CHANGED = 'gpsfollowsurvey'\r\n\r\n/**\r\n * fired when GPS tracking should cease\r\n * parameter 'auto' set if this was triggered by a non-explicit user action\r\n *\r\n * @type {string}\r\n */\r\nexport const APP_EVENT_CANCEL_WATCHED_GPS_USER_REQUEST = 'cancelgpswatch';\r\n\r\n/**\r\n * fired after the new controller activates\r\n *\r\n * @type {string}\r\n */\r\nexport const APP_EVENT_CONTROLLER_CHANGED = 'controllerchanged';\r\n\r\n/**\r\n * fired on Survey when one of its occurrences has been modified, added, deleted or reloaded\r\n *\r\n * no parameters\r\n *\r\n * @type {string}\r\n */\r\nexport const SURVEY_EVENT_OCCURRENCES_CHANGED = 'occurrenceschanged';\r\n\r\n/**\r\n *\r\n * @type {string}\r\n */\r\nexport const SURVEY_EVENT_DELETED = 'surveydeleted';\r\n\r\n/**\r\n * fired from Survey when the object's contents have been modified\r\n *\r\n * The parameter is {surveyId : string}\r\n *\r\n * @type {string}\r\n */\r\nexport const SURVEY_EVENT_MODIFIED = 'modified';\r\n\r\n/**\r\n *\r\n * @type {string}\r\n */\r\nexport const SURVEY_DEFINITION_EVENT_DELETED = 'surveydefinitiondeleted';\r\n\r\n/**\r\n * fired from Survey when the object's contents have been modified\r\n *\r\n * The parameter is {surveyDefinitionId : string}\r\n *\r\n * @type {string}\r\n */\r\nexport const SURVEY_DEFINITION_EVENT_MODIFIED = 'surveydefinitionmodified';\r\n\r\nexport const APP_EVENT_SERVICE_WORKER_CHANGED = 'serviceworkerchanged';","// AppController\r\n// Abstract super-class for page controllers\r\n\r\nimport {EventHarness} from \"../framework/EventHarness\";\r\nimport {APP_EVENT_CONTROLLER_CHANGED} from \"../framework/AppEvents\";\r\n\r\n/**\r\n * @typedef {import('bsbi-app-framework-view').Page} Page\r\n * @typedef {import('bsbi-app-framework-view').PatchedNavigo} PatchedNavigo\r\n */\r\n\r\n/**\r\n * @abstract\r\n */\r\nexport class AppController extends EventHarness {\r\n\r\n /**\r\n *\r\n * @type {(null|string)}\r\n */\r\n route = null;\r\n\r\n /**\r\n *\r\n * @type {Page}\r\n */\r\n view;\r\n\r\n title = 'untitled';\r\n\r\n /**\r\n * integer controller handle\r\n * note that 0 is a valid handle\r\n *\r\n * @type {number}\r\n */\r\n handle;\r\n\r\n /**\r\n *\r\n * @type {App}\r\n */\r\n app;\r\n\r\n static className = 'AppController';\r\n\r\n /**\r\n *\r\n * @type {function|null}\r\n */\r\n beforeRouteHandler = null;\r\n\r\n /**\r\n *\r\n * @type {function|null}\r\n */\r\n afterRouteHandler = null;\r\n\r\n // /**\r\n // *\r\n // * @type {function|null}\r\n // */\r\n // leaveRouteHandler = null;\r\n\r\n /**\r\n *\r\n * @type {function|null}\r\n */\r\n alreadyRouteHandler = null;\r\n\r\n error;\r\n\r\n static _handleIndex = 0;\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * @type {function}\r\n */\r\n viewClass;\r\n\r\n static get nextHandle() {\r\n return AppController._handleIndex++;\r\n }\r\n\r\n isCurrent() {\r\n return this.app.currentControllerHandle === this.handle;\r\n }\r\n\r\n /**\r\n * Called when the app's current controller is about to change.\r\n * The controller may want to clear view listeners.\r\n */\r\n makeNotActive() {\r\n\r\n }\r\n\r\n /**\r\n * Called after the app's current controller has changed, to make this the current controller.\r\n */\r\n makeActive() {\r\n this.app.fireEvent(APP_EVENT_CONTROLLER_CHANGED);\r\n }\r\n\r\n /**\r\n * called from App.initialise() to trigger late-stage initialisation\r\n */\r\n initialise() {\r\n\r\n // remove this once all controllers shift to having on-demand rather than permanent views\r\n this.view?.initialise?.();\r\n }\r\n\r\n /**\r\n * registers the default route from this.route\r\n * or alternatively is overridden in a child class\r\n *\r\n * @param {PatchedNavigo} router\r\n */\r\n registerRoute(router) {\r\n if (null === this.route) {\r\n throw new Error(`No route set for '${this.title}' controller.`);\r\n }\r\n\r\n router.on(\r\n this.route,\r\n this.routeHandler.bind(this),\r\n {\r\n before : this.beforeRouteHandler ? this.beforeRouteHandler.bind(this) : null,\r\n after : this.afterRouteHandler ? this.afterRouteHandler.bind(this) : null,\r\n leave : this.leaveRouteHandler ? this.leaveRouteHandler.bind(this) : null,\r\n already : this.alreadyRouteHandler ? this.alreadyRouteHandler.bind(this) : null\r\n }\r\n );\r\n }\r\n\r\n\r\n routeHandler(context, subcontext, rhs, queryParameters) {\r\n\r\n }\r\n\r\n leaveRouteHandler() {\r\n AppController.clearControlHiding();\r\n }\r\n\r\n /**\r\n * If a CSS body class has been set to hide controls due to open drop-boxes, then clear any hiding\r\n */\r\n static clearControlHiding() {\r\n //this is a low priority, so yield here\r\n\r\n const yieldCallback = () => {\r\n document.body.classList.remove('hide-controls', 'dropdown-open');\r\n\r\n // Suggest-list drop-downs are promoted to the top layer where the popover API is\r\n // available, and nothing else can dismiss them, so they must be closed explicitly.\r\n // (This package can't import the view package's helper, hence the direct DOM sweep.)\r\n for (let element of document.querySelectorAll('div.dropdown-list[popover]')) {\r\n try {\r\n element.hidePopover();\r\n } catch {\r\n // wasn't open\r\n }\r\n }\r\n\r\n for (let element of document.querySelectorAll('.needs-bsbi-controls')) {\r\n if (!element.classList.contains('bsbi-controls')) {\r\n element.classList.add('bsbi-controls');\r\n }\r\n }\r\n\r\n for (let element of document.querySelectorAll('.dropdown-focused')) {\r\n element.classList.remove('dropdown-focused');\r\n }\r\n };\r\n\r\n window.requestIdleCallback?.(yieldCallback, {timeout: 500}) ?? setTimeout(yieldCallback);\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * If the controller currently allows a dynamic survey change to happen (triggered by GPS) then return true\r\n *\r\n * @returns {boolean}\r\n * @protected\r\n */\r\n _allowGPSTriggeredSurveyChanges() {\r\n return false;\r\n }\r\n}\r\n","// StaticContentController\r\n\r\nimport {AppController} from './AppController';\r\n/**\r\n * @typedef {import('bsbi-app-framework-view').Page} Page\r\n */\r\n\r\nexport class StaticContentController extends AppController {\r\n /**\r\n * @type {Array|null}\r\n */\r\n _routes = [];\r\n\r\n /**\r\n *\r\n * @param {?Page} [view]\r\n * @param {Array|null} [route]\r\n */\r\n constructor (view = null, route = null) {\r\n super();\r\n\r\n if (view) {\r\n this.view = view;\r\n this.view.controller = this;\r\n }\r\n\r\n if (route) {\r\n this._routes = route;\r\n }\r\n\r\n this.handle = AppController.nextHandle;\r\n }\r\n\r\n /**\r\n * registers the default route from this.route\r\n * or alternatively is overridden in a child class\r\n *\r\n * @param {PatchedNavigo} router\r\n */\r\n registerRoute(router) {\r\n\r\n for (const route of this._routes) {\r\n router.on(\r\n route,\r\n this.routeHandler.bind(this),\r\n {\r\n before: this.beforeRouteHandler ? this.beforeRouteHandler.bind(this) : null,\r\n after: this.afterRouteHandler ? this.afterRouteHandler.bind(this) : null,\r\n leave: this.leaveRouteHandler ? this.leaveRouteHandler.bind(this) : null,\r\n already: this.alreadyRouteHandler ? this.alreadyRouteHandler.bind(this) : null\r\n }\r\n );\r\n }\r\n }\r\n\r\n routeHandler(context, subcontext, rhs, queryParameters) {\r\n // console.log(\"reached route handler for StaticContentController.js\");\r\n this.app.saveRoute();\r\n\r\n this.app.currentControllerHandle = this.handle;\r\n this.view.display();\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n backHandler() {\r\n // backHandler may still be attached to other inactive controllers\r\n // need to check that only the current one takes effect\r\n if (this.isCurrent()) {\r\n\r\n // check that previous page is within app (i.e. that someone hasn't bizarrely navigated from outside, straight to this page)\r\n if (this.app.routeHistory.length >= 2) {\r\n this.app.routeHistory.length--;\r\n console.log('using standard back navigation');\r\n\r\n window.history.back();\r\n } else {\r\n console.log(`navigating back to home page '${this.app.homeRoute}'`);\r\n\r\n if (this.app.routeHistory.length > 0) {\r\n this.app.routeHistory.length--;\r\n } else {\r\n console.error(`In static content controller back handler route history length was ${this.app.routeHistory.length} before back navigation.`)\r\n }\r\n\r\n // pause so that replace rather than push history state\r\n this.app.router.pause();\r\n this.app.router.navigate(this.app.homeRoute).resume();\r\n this.app.router.resolve();\r\n }\r\n }\r\n }\r\n}\r\n","export class NotFoundError extends Error {\r\n constructor (message) {\r\n super(message);\r\n\r\n Error.captureStackTrace?.(this, NotFoundError); // see https://v8.dev/docs/stack-trace-api\r\n }\r\n}","/*!\n localForage -- Offline Storage, Improved\n Version 1.10.0\n https://localforage.github.io/localForage\n (c) 2013-2017 Mozilla, Apache License 2.0\n*/\n(function(f){if(typeof exports===\"object\"&&typeof module!==\"undefined\"){module.exports=f()}else if(typeof define===\"function\"&&define.amd){define([],f)}else{var g;if(typeof window!==\"undefined\"){g=window}else if(typeof global!==\"undefined\"){g=global}else if(typeof self!==\"undefined\"){g=self}else{g=this}g.localforage = f()}})(function(){var define,module,exports;return (function e(t,n,r){function s(o,u){if(!n[o]){if(!t[o]){var a=typeof require==\"function\"&&require;if(!u&&a)return a(o,!0);if(i)return i(o,!0);var f=new Error(\"Cannot find module '\"+o+\"'\");throw (f.code=\"MODULE_NOT_FOUND\", f)}var l=n[o]={exports:{}};t[o][0].call(l.exports,function(e){var n=t[o][1][e];return s(n?n:e)},l,l.exports,e,t,n,r)}return n[o].exports}var i=typeof require==\"function\"&&require;for(var o=0;o element; its readystatechange event will be fired asynchronously once it is inserted\n // into the document. Do so, thus queuing up the task. Remember to clean up once it's been called.\n var scriptEl = global.document.createElement('script');\n scriptEl.onreadystatechange = function () {\n nextTick();\n\n scriptEl.onreadystatechange = null;\n scriptEl.parentNode.removeChild(scriptEl);\n scriptEl = null;\n };\n global.document.documentElement.appendChild(scriptEl);\n };\n } else {\n scheduleDrain = function () {\n setTimeout(nextTick, 0);\n };\n }\n}\n\nvar draining;\nvar queue = [];\n//named nextTick for less confusing stack traces\nfunction nextTick() {\n draining = true;\n var i, oldQueue;\n var len = queue.length;\n while (len) {\n oldQueue = queue;\n queue = [];\n i = -1;\n while (++i < len) {\n oldQueue[i]();\n }\n len = queue.length;\n }\n draining = false;\n}\n\nmodule.exports = immediate;\nfunction immediate(task) {\n if (queue.push(task) === 1 && !draining) {\n scheduleDrain();\n }\n}\n\n}).call(this,typeof global !== \"undefined\" ? global : typeof self !== \"undefined\" ? self : typeof window !== \"undefined\" ? window : {})\n},{}],2:[function(_dereq_,module,exports){\n'use strict';\nvar immediate = _dereq_(1);\n\n/* istanbul ignore next */\nfunction INTERNAL() {}\n\nvar handlers = {};\n\nvar REJECTED = ['REJECTED'];\nvar FULFILLED = ['FULFILLED'];\nvar PENDING = ['PENDING'];\n\nmodule.exports = Promise;\n\nfunction Promise(resolver) {\n if (typeof resolver !== 'function') {\n throw new TypeError('resolver must be a function');\n }\n this.state = PENDING;\n this.queue = [];\n this.outcome = void 0;\n if (resolver !== INTERNAL) {\n safelyResolveThenable(this, resolver);\n }\n}\n\nPromise.prototype[\"catch\"] = function (onRejected) {\n return this.then(null, onRejected);\n};\nPromise.prototype.then = function (onFulfilled, onRejected) {\n if (typeof onFulfilled !== 'function' && this.state === FULFILLED ||\n typeof onRejected !== 'function' && this.state === REJECTED) {\n return this;\n }\n var promise = new this.constructor(INTERNAL);\n if (this.state !== PENDING) {\n var resolver = this.state === FULFILLED ? onFulfilled : onRejected;\n unwrap(promise, resolver, this.outcome);\n } else {\n this.queue.push(new QueueItem(promise, onFulfilled, onRejected));\n }\n\n return promise;\n};\nfunction QueueItem(promise, onFulfilled, onRejected) {\n this.promise = promise;\n if (typeof onFulfilled === 'function') {\n this.onFulfilled = onFulfilled;\n this.callFulfilled = this.otherCallFulfilled;\n }\n if (typeof onRejected === 'function') {\n this.onRejected = onRejected;\n this.callRejected = this.otherCallRejected;\n }\n}\nQueueItem.prototype.callFulfilled = function (value) {\n handlers.resolve(this.promise, value);\n};\nQueueItem.prototype.otherCallFulfilled = function (value) {\n unwrap(this.promise, this.onFulfilled, value);\n};\nQueueItem.prototype.callRejected = function (value) {\n handlers.reject(this.promise, value);\n};\nQueueItem.prototype.otherCallRejected = function (value) {\n unwrap(this.promise, this.onRejected, value);\n};\n\nfunction unwrap(promise, func, value) {\n immediate(function () {\n var returnValue;\n try {\n returnValue = func(value);\n } catch (e) {\n return handlers.reject(promise, e);\n }\n if (returnValue === promise) {\n handlers.reject(promise, new TypeError('Cannot resolve promise with itself'));\n } else {\n handlers.resolve(promise, returnValue);\n }\n });\n}\n\nhandlers.resolve = function (self, value) {\n var result = tryCatch(getThen, value);\n if (result.status === 'error') {\n return handlers.reject(self, result.value);\n }\n var thenable = result.value;\n\n if (thenable) {\n safelyResolveThenable(self, thenable);\n } else {\n self.state = FULFILLED;\n self.outcome = value;\n var i = -1;\n var len = self.queue.length;\n while (++i < len) {\n self.queue[i].callFulfilled(value);\n }\n }\n return self;\n};\nhandlers.reject = function (self, error) {\n self.state = REJECTED;\n self.outcome = error;\n var i = -1;\n var len = self.queue.length;\n while (++i < len) {\n self.queue[i].callRejected(error);\n }\n return self;\n};\n\nfunction getThen(obj) {\n // Make sure we only access the accessor once as required by the spec\n var then = obj && obj.then;\n if (obj && (typeof obj === 'object' || typeof obj === 'function') && typeof then === 'function') {\n return function appyThen() {\n then.apply(obj, arguments);\n };\n }\n}\n\nfunction safelyResolveThenable(self, thenable) {\n // Either fulfill, reject or reject with error\n var called = false;\n function onError(value) {\n if (called) {\n return;\n }\n called = true;\n handlers.reject(self, value);\n }\n\n function onSuccess(value) {\n if (called) {\n return;\n }\n called = true;\n handlers.resolve(self, value);\n }\n\n function tryToUnwrap() {\n thenable(onSuccess, onError);\n }\n\n var result = tryCatch(tryToUnwrap);\n if (result.status === 'error') {\n onError(result.value);\n }\n}\n\nfunction tryCatch(func, value) {\n var out = {};\n try {\n out.value = func(value);\n out.status = 'success';\n } catch (e) {\n out.status = 'error';\n out.value = e;\n }\n return out;\n}\n\nPromise.resolve = resolve;\nfunction resolve(value) {\n if (value instanceof this) {\n return value;\n }\n return handlers.resolve(new this(INTERNAL), value);\n}\n\nPromise.reject = reject;\nfunction reject(reason) {\n var promise = new this(INTERNAL);\n return handlers.reject(promise, reason);\n}\n\nPromise.all = all;\nfunction all(iterable) {\n var self = this;\n if (Object.prototype.toString.call(iterable) !== '[object Array]') {\n return this.reject(new TypeError('must be an array'));\n }\n\n var len = iterable.length;\n var called = false;\n if (!len) {\n return this.resolve([]);\n }\n\n var values = new Array(len);\n var resolved = 0;\n var i = -1;\n var promise = new this(INTERNAL);\n\n while (++i < len) {\n allResolver(iterable[i], i);\n }\n return promise;\n function allResolver(value, i) {\n self.resolve(value).then(resolveFromAll, function (error) {\n if (!called) {\n called = true;\n handlers.reject(promise, error);\n }\n });\n function resolveFromAll(outValue) {\n values[i] = outValue;\n if (++resolved === len && !called) {\n called = true;\n handlers.resolve(promise, values);\n }\n }\n }\n}\n\nPromise.race = race;\nfunction race(iterable) {\n var self = this;\n if (Object.prototype.toString.call(iterable) !== '[object Array]') {\n return this.reject(new TypeError('must be an array'));\n }\n\n var len = iterable.length;\n var called = false;\n if (!len) {\n return this.resolve([]);\n }\n\n var i = -1;\n var promise = new this(INTERNAL);\n\n while (++i < len) {\n resolver(iterable[i]);\n }\n return promise;\n function resolver(value) {\n self.resolve(value).then(function (response) {\n if (!called) {\n called = true;\n handlers.resolve(promise, response);\n }\n }, function (error) {\n if (!called) {\n called = true;\n handlers.reject(promise, error);\n }\n });\n }\n}\n\n},{\"1\":1}],3:[function(_dereq_,module,exports){\n(function (global){\n'use strict';\nif (typeof global.Promise !== 'function') {\n global.Promise = _dereq_(2);\n}\n\n}).call(this,typeof global !== \"undefined\" ? global : typeof self !== \"undefined\" ? self : typeof window !== \"undefined\" ? window : {})\n},{\"2\":2}],4:[function(_dereq_,module,exports){\n'use strict';\n\nvar _typeof = typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\" ? function (obj) { return typeof obj; } : function (obj) { return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; };\n\nfunction _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError(\"Cannot call a class as a function\"); } }\n\nfunction getIDB() {\n /* global indexedDB,webkitIndexedDB,mozIndexedDB,OIndexedDB,msIndexedDB */\n try {\n if (typeof indexedDB !== 'undefined') {\n return indexedDB;\n }\n if (typeof webkitIndexedDB !== 'undefined') {\n return webkitIndexedDB;\n }\n if (typeof mozIndexedDB !== 'undefined') {\n return mozIndexedDB;\n }\n if (typeof OIndexedDB !== 'undefined') {\n return OIndexedDB;\n }\n if (typeof msIndexedDB !== 'undefined') {\n return msIndexedDB;\n }\n } catch (e) {\n return;\n }\n}\n\nvar idb = getIDB();\n\nfunction isIndexedDBValid() {\n try {\n // Initialize IndexedDB; fall back to vendor-prefixed versions\n // if needed.\n if (!idb || !idb.open) {\n return false;\n }\n // We mimic PouchDB here;\n //\n // We test for openDatabase because IE Mobile identifies itself\n // as Safari. Oh the lulz...\n var isSafari = typeof openDatabase !== 'undefined' && /(Safari|iPhone|iPad|iPod)/.test(navigator.userAgent) && !/Chrome/.test(navigator.userAgent) && !/BlackBerry/.test(navigator.platform);\n\n var hasFetch = typeof fetch === 'function' && fetch.toString().indexOf('[native code') !== -1;\n\n // Safari <10.1 does not meet our requirements for IDB support\n // (see: https://github.com/pouchdb/pouchdb/issues/5572).\n // Safari 10.1 shipped with fetch, we can use that to detect it.\n // Note: this creates issues with `window.fetch` polyfills and\n // overrides; see:\n // https://github.com/localForage/localForage/issues/856\n return (!isSafari || hasFetch) && typeof indexedDB !== 'undefined' &&\n // some outdated implementations of IDB that appear on Samsung\n // and HTC Android devices <4.4 are missing IDBKeyRange\n // See: https://github.com/mozilla/localForage/issues/128\n // See: https://github.com/mozilla/localForage/issues/272\n typeof IDBKeyRange !== 'undefined';\n } catch (e) {\n return false;\n }\n}\n\n// Abstracts constructing a Blob object, so it also works in older\n// browsers that don't support the native Blob constructor. (i.e.\n// old QtWebKit versions, at least).\n// Abstracts constructing a Blob object, so it also works in older\n// browsers that don't support the native Blob constructor. (i.e.\n// old QtWebKit versions, at least).\nfunction createBlob(parts, properties) {\n /* global BlobBuilder,MSBlobBuilder,MozBlobBuilder,WebKitBlobBuilder */\n parts = parts || [];\n properties = properties || {};\n try {\n return new Blob(parts, properties);\n } catch (e) {\n if (e.name !== 'TypeError') {\n throw e;\n }\n var Builder = typeof BlobBuilder !== 'undefined' ? BlobBuilder : typeof MSBlobBuilder !== 'undefined' ? MSBlobBuilder : typeof MozBlobBuilder !== 'undefined' ? MozBlobBuilder : WebKitBlobBuilder;\n var builder = new Builder();\n for (var i = 0; i < parts.length; i += 1) {\n builder.append(parts[i]);\n }\n return builder.getBlob(properties.type);\n }\n}\n\n// This is CommonJS because lie is an external dependency, so Rollup\n// can just ignore it.\nif (typeof Promise === 'undefined') {\n // In the \"nopromises\" build this will just throw if you don't have\n // a global promise object, but it would throw anyway later.\n _dereq_(3);\n}\nvar Promise$1 = Promise;\n\nfunction executeCallback(promise, callback) {\n if (callback) {\n promise.then(function (result) {\n callback(null, result);\n }, function (error) {\n callback(error);\n });\n }\n}\n\nfunction executeTwoCallbacks(promise, callback, errorCallback) {\n if (typeof callback === 'function') {\n promise.then(callback);\n }\n\n if (typeof errorCallback === 'function') {\n promise[\"catch\"](errorCallback);\n }\n}\n\nfunction normalizeKey(key) {\n // Cast the key to a string, as that's all we can set as a key.\n if (typeof key !== 'string') {\n console.warn(key + ' used as a key, but it is not a string.');\n key = String(key);\n }\n\n return key;\n}\n\nfunction getCallback() {\n if (arguments.length && typeof arguments[arguments.length - 1] === 'function') {\n return arguments[arguments.length - 1];\n }\n}\n\n// Some code originally from async_storage.js in\n// [Gaia](https://github.com/mozilla-b2g/gaia).\n\nvar DETECT_BLOB_SUPPORT_STORE = 'local-forage-detect-blob-support';\nvar supportsBlobs = void 0;\nvar dbContexts = {};\nvar toString = Object.prototype.toString;\n\n// Transaction Modes\nvar READ_ONLY = 'readonly';\nvar READ_WRITE = 'readwrite';\n\n// Transform a binary string to an array buffer, because otherwise\n// weird stuff happens when you try to work with the binary string directly.\n// It is known.\n// From http://stackoverflow.com/questions/14967647/ (continues on next line)\n// encode-decode-image-with-base64-breaks-image (2013-04-21)\nfunction _binStringToArrayBuffer(bin) {\n var length = bin.length;\n var buf = new ArrayBuffer(length);\n var arr = new Uint8Array(buf);\n for (var i = 0; i < length; i++) {\n arr[i] = bin.charCodeAt(i);\n }\n return buf;\n}\n\n//\n// Blobs are not supported in all versions of IndexedDB, notably\n// Chrome <37 and Android <5. In those versions, storing a blob will throw.\n//\n// Various other blob bugs exist in Chrome v37-42 (inclusive).\n// Detecting them is expensive and confusing to users, and Chrome 37-42\n// is at very low usage worldwide, so we do a hacky userAgent check instead.\n//\n// content-type bug: https://code.google.com/p/chromium/issues/detail?id=408120\n// 404 bug: https://code.google.com/p/chromium/issues/detail?id=447916\n// FileReader bug: https://code.google.com/p/chromium/issues/detail?id=447836\n//\n// Code borrowed from PouchDB. See:\n// https://github.com/pouchdb/pouchdb/blob/master/packages/node_modules/pouchdb-adapter-idb/src/blobSupport.js\n//\nfunction _checkBlobSupportWithoutCaching(idb) {\n return new Promise$1(function (resolve) {\n var txn = idb.transaction(DETECT_BLOB_SUPPORT_STORE, READ_WRITE);\n var blob = createBlob(['']);\n txn.objectStore(DETECT_BLOB_SUPPORT_STORE).put(blob, 'key');\n\n txn.onabort = function (e) {\n // If the transaction aborts now its due to not being able to\n // write to the database, likely due to the disk being full\n e.preventDefault();\n e.stopPropagation();\n resolve(false);\n };\n\n txn.oncomplete = function () {\n var matchedChrome = navigator.userAgent.match(/Chrome\\/(\\d+)/);\n var matchedEdge = navigator.userAgent.match(/Edge\\//);\n // MS Edge pretends to be Chrome 42:\n // https://msdn.microsoft.com/en-us/library/hh869301%28v=vs.85%29.aspx\n resolve(matchedEdge || !matchedChrome || parseInt(matchedChrome[1], 10) >= 43);\n };\n })[\"catch\"](function () {\n return false; // error, so assume unsupported\n });\n}\n\nfunction _checkBlobSupport(idb) {\n if (typeof supportsBlobs === 'boolean') {\n return Promise$1.resolve(supportsBlobs);\n }\n return _checkBlobSupportWithoutCaching(idb).then(function (value) {\n supportsBlobs = value;\n return supportsBlobs;\n });\n}\n\nfunction _deferReadiness(dbInfo) {\n var dbContext = dbContexts[dbInfo.name];\n\n // Create a deferred object representing the current database operation.\n var deferredOperation = {};\n\n deferredOperation.promise = new Promise$1(function (resolve, reject) {\n deferredOperation.resolve = resolve;\n deferredOperation.reject = reject;\n });\n\n // Enqueue the deferred operation.\n dbContext.deferredOperations.push(deferredOperation);\n\n // Chain its promise to the database readiness.\n if (!dbContext.dbReady) {\n dbContext.dbReady = deferredOperation.promise;\n } else {\n dbContext.dbReady = dbContext.dbReady.then(function () {\n return deferredOperation.promise;\n });\n }\n}\n\nfunction _advanceReadiness(dbInfo) {\n var dbContext = dbContexts[dbInfo.name];\n\n // Dequeue a deferred operation.\n var deferredOperation = dbContext.deferredOperations.pop();\n\n // Resolve its promise (which is part of the database readiness\n // chain of promises).\n if (deferredOperation) {\n deferredOperation.resolve();\n return deferredOperation.promise;\n }\n}\n\nfunction _rejectReadiness(dbInfo, err) {\n var dbContext = dbContexts[dbInfo.name];\n\n // Dequeue a deferred operation.\n var deferredOperation = dbContext.deferredOperations.pop();\n\n // Reject its promise (which is part of the database readiness\n // chain of promises).\n if (deferredOperation) {\n deferredOperation.reject(err);\n return deferredOperation.promise;\n }\n}\n\nfunction _getConnection(dbInfo, upgradeNeeded) {\n return new Promise$1(function (resolve, reject) {\n dbContexts[dbInfo.name] = dbContexts[dbInfo.name] || createDbContext();\n\n if (dbInfo.db) {\n if (upgradeNeeded) {\n _deferReadiness(dbInfo);\n dbInfo.db.close();\n } else {\n return resolve(dbInfo.db);\n }\n }\n\n var dbArgs = [dbInfo.name];\n\n if (upgradeNeeded) {\n dbArgs.push(dbInfo.version);\n }\n\n var openreq = idb.open.apply(idb, dbArgs);\n\n if (upgradeNeeded) {\n openreq.onupgradeneeded = function (e) {\n var db = openreq.result;\n try {\n db.createObjectStore(dbInfo.storeName);\n if (e.oldVersion <= 1) {\n // Added when support for blob shims was added\n db.createObjectStore(DETECT_BLOB_SUPPORT_STORE);\n }\n } catch (ex) {\n if (ex.name === 'ConstraintError') {\n console.warn('The database \"' + dbInfo.name + '\"' + ' has been upgraded from version ' + e.oldVersion + ' to version ' + e.newVersion + ', but the storage \"' + dbInfo.storeName + '\" already exists.');\n } else {\n throw ex;\n }\n }\n };\n }\n\n openreq.onerror = function (e) {\n e.preventDefault();\n reject(openreq.error);\n };\n\n openreq.onsuccess = function () {\n var db = openreq.result;\n db.onversionchange = function (e) {\n // Triggered when the database is modified (e.g. adding an objectStore) or\n // deleted (even when initiated by other sessions in different tabs).\n // Closing the connection here prevents those operations from being blocked.\n // If the database is accessed again later by this instance, the connection\n // will be reopened or the database recreated as needed.\n e.target.close();\n };\n resolve(db);\n _advanceReadiness(dbInfo);\n };\n });\n}\n\nfunction _getOriginalConnection(dbInfo) {\n return _getConnection(dbInfo, false);\n}\n\nfunction _getUpgradedConnection(dbInfo) {\n return _getConnection(dbInfo, true);\n}\n\nfunction _isUpgradeNeeded(dbInfo, defaultVersion) {\n if (!dbInfo.db) {\n return true;\n }\n\n var isNewStore = !dbInfo.db.objectStoreNames.contains(dbInfo.storeName);\n var isDowngrade = dbInfo.version < dbInfo.db.version;\n var isUpgrade = dbInfo.version > dbInfo.db.version;\n\n if (isDowngrade) {\n // If the version is not the default one\n // then warn for impossible downgrade.\n if (dbInfo.version !== defaultVersion) {\n console.warn('The database \"' + dbInfo.name + '\"' + \" can't be downgraded from version \" + dbInfo.db.version + ' to version ' + dbInfo.version + '.');\n }\n // Align the versions to prevent errors.\n dbInfo.version = dbInfo.db.version;\n }\n\n if (isUpgrade || isNewStore) {\n // If the store is new then increment the version (if needed).\n // This will trigger an \"upgradeneeded\" event which is required\n // for creating a store.\n if (isNewStore) {\n var incVersion = dbInfo.db.version + 1;\n if (incVersion > dbInfo.version) {\n dbInfo.version = incVersion;\n }\n }\n\n return true;\n }\n\n return false;\n}\n\n// encode a blob for indexeddb engines that don't support blobs\nfunction _encodeBlob(blob) {\n return new Promise$1(function (resolve, reject) {\n var reader = new FileReader();\n reader.onerror = reject;\n reader.onloadend = function (e) {\n var base64 = btoa(e.target.result || '');\n resolve({\n __local_forage_encoded_blob: true,\n data: base64,\n type: blob.type\n });\n };\n reader.readAsBinaryString(blob);\n });\n}\n\n// decode an encoded blob\nfunction _decodeBlob(encodedBlob) {\n var arrayBuff = _binStringToArrayBuffer(atob(encodedBlob.data));\n return createBlob([arrayBuff], { type: encodedBlob.type });\n}\n\n// is this one of our fancy encoded blobs?\nfunction _isEncodedBlob(value) {\n return value && value.__local_forage_encoded_blob;\n}\n\n// Specialize the default `ready()` function by making it dependent\n// on the current database operations. Thus, the driver will be actually\n// ready when it's been initialized (default) *and* there are no pending\n// operations on the database (initiated by some other instances).\nfunction _fullyReady(callback) {\n var self = this;\n\n var promise = self._initReady().then(function () {\n var dbContext = dbContexts[self._dbInfo.name];\n\n if (dbContext && dbContext.dbReady) {\n return dbContext.dbReady;\n }\n });\n\n executeTwoCallbacks(promise, callback, callback);\n return promise;\n}\n\n// Try to establish a new db connection to replace the\n// current one which is broken (i.e. experiencing\n// InvalidStateError while creating a transaction).\nfunction _tryReconnect(dbInfo) {\n _deferReadiness(dbInfo);\n\n var dbContext = dbContexts[dbInfo.name];\n var forages = dbContext.forages;\n\n for (var i = 0; i < forages.length; i++) {\n var forage = forages[i];\n if (forage._dbInfo.db) {\n forage._dbInfo.db.close();\n forage._dbInfo.db = null;\n }\n }\n dbInfo.db = null;\n\n return _getOriginalConnection(dbInfo).then(function (db) {\n dbInfo.db = db;\n if (_isUpgradeNeeded(dbInfo)) {\n // Reopen the database for upgrading.\n return _getUpgradedConnection(dbInfo);\n }\n return db;\n }).then(function (db) {\n // store the latest db reference\n // in case the db was upgraded\n dbInfo.db = dbContext.db = db;\n for (var i = 0; i < forages.length; i++) {\n forages[i]._dbInfo.db = db;\n }\n })[\"catch\"](function (err) {\n _rejectReadiness(dbInfo, err);\n throw err;\n });\n}\n\n// FF doesn't like Promises (micro-tasks) and IDDB store operations,\n// so we have to do it with callbacks\nfunction createTransaction(dbInfo, mode, callback, retries) {\n if (retries === undefined) {\n retries = 1;\n }\n\n try {\n var tx = dbInfo.db.transaction(dbInfo.storeName, mode);\n callback(null, tx);\n } catch (err) {\n if (retries > 0 && (!dbInfo.db || err.name === 'InvalidStateError' || err.name === 'NotFoundError')) {\n return Promise$1.resolve().then(function () {\n if (!dbInfo.db || err.name === 'NotFoundError' && !dbInfo.db.objectStoreNames.contains(dbInfo.storeName) && dbInfo.version <= dbInfo.db.version) {\n // increase the db version, to create the new ObjectStore\n if (dbInfo.db) {\n dbInfo.version = dbInfo.db.version + 1;\n }\n // Reopen the database for upgrading.\n return _getUpgradedConnection(dbInfo);\n }\n }).then(function () {\n return _tryReconnect(dbInfo).then(function () {\n createTransaction(dbInfo, mode, callback, retries - 1);\n });\n })[\"catch\"](callback);\n }\n\n callback(err);\n }\n}\n\nfunction createDbContext() {\n return {\n // Running localForages sharing a database.\n forages: [],\n // Shared database.\n db: null,\n // Database readiness (promise).\n dbReady: null,\n // Deferred operations on the database.\n deferredOperations: []\n };\n}\n\n// Open the IndexedDB database (automatically creates one if one didn't\n// previously exist), using any options set in the config.\nfunction _initStorage(options) {\n var self = this;\n var dbInfo = {\n db: null\n };\n\n if (options) {\n for (var i in options) {\n dbInfo[i] = options[i];\n }\n }\n\n // Get the current context of the database;\n var dbContext = dbContexts[dbInfo.name];\n\n // ...or create a new context.\n if (!dbContext) {\n dbContext = createDbContext();\n // Register the new context in the global container.\n dbContexts[dbInfo.name] = dbContext;\n }\n\n // Register itself as a running localForage in the current context.\n dbContext.forages.push(self);\n\n // Replace the default `ready()` function with the specialized one.\n if (!self._initReady) {\n self._initReady = self.ready;\n self.ready = _fullyReady;\n }\n\n // Create an array of initialization states of the related localForages.\n var initPromises = [];\n\n function ignoreErrors() {\n // Don't handle errors here,\n // just makes sure related localForages aren't pending.\n return Promise$1.resolve();\n }\n\n for (var j = 0; j < dbContext.forages.length; j++) {\n var forage = dbContext.forages[j];\n if (forage !== self) {\n // Don't wait for itself...\n initPromises.push(forage._initReady()[\"catch\"](ignoreErrors));\n }\n }\n\n // Take a snapshot of the related localForages.\n var forages = dbContext.forages.slice(0);\n\n // Initialize the connection process only when\n // all the related localForages aren't pending.\n return Promise$1.all(initPromises).then(function () {\n dbInfo.db = dbContext.db;\n // Get the connection or open a new one without upgrade.\n return _getOriginalConnection(dbInfo);\n }).then(function (db) {\n dbInfo.db = db;\n if (_isUpgradeNeeded(dbInfo, self._defaultConfig.version)) {\n // Reopen the database for upgrading.\n return _getUpgradedConnection(dbInfo);\n }\n return db;\n }).then(function (db) {\n dbInfo.db = dbContext.db = db;\n self._dbInfo = dbInfo;\n // Share the final connection amongst related localForages.\n for (var k = 0; k < forages.length; k++) {\n var forage = forages[k];\n if (forage !== self) {\n // Self is already up-to-date.\n forage._dbInfo.db = dbInfo.db;\n forage._dbInfo.version = dbInfo.version;\n }\n }\n });\n}\n\nfunction getItem(key, callback) {\n var self = this;\n\n key = normalizeKey(key);\n\n var promise = new Promise$1(function (resolve, reject) {\n self.ready().then(function () {\n createTransaction(self._dbInfo, READ_ONLY, function (err, transaction) {\n if (err) {\n return reject(err);\n }\n\n try {\n var store = transaction.objectStore(self._dbInfo.storeName);\n var req = store.get(key);\n\n req.onsuccess = function () {\n var value = req.result;\n if (value === undefined) {\n value = null;\n }\n if (_isEncodedBlob(value)) {\n value = _decodeBlob(value);\n }\n resolve(value);\n };\n\n req.onerror = function () {\n reject(req.error);\n };\n } catch (e) {\n reject(e);\n }\n });\n })[\"catch\"](reject);\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\n// Iterate over all items stored in database.\nfunction iterate(iterator, callback) {\n var self = this;\n\n var promise = new Promise$1(function (resolve, reject) {\n self.ready().then(function () {\n createTransaction(self._dbInfo, READ_ONLY, function (err, transaction) {\n if (err) {\n return reject(err);\n }\n\n try {\n var store = transaction.objectStore(self._dbInfo.storeName);\n var req = store.openCursor();\n var iterationNumber = 1;\n\n req.onsuccess = function () {\n var cursor = req.result;\n\n if (cursor) {\n var value = cursor.value;\n if (_isEncodedBlob(value)) {\n value = _decodeBlob(value);\n }\n var result = iterator(value, cursor.key, iterationNumber++);\n\n // when the iterator callback returns any\n // (non-`undefined`) value, then we stop\n // the iteration immediately\n if (result !== void 0) {\n resolve(result);\n } else {\n cursor[\"continue\"]();\n }\n } else {\n resolve();\n }\n };\n\n req.onerror = function () {\n reject(req.error);\n };\n } catch (e) {\n reject(e);\n }\n });\n })[\"catch\"](reject);\n });\n\n executeCallback(promise, callback);\n\n return promise;\n}\n\nfunction setItem(key, value, callback) {\n var self = this;\n\n key = normalizeKey(key);\n\n var promise = new Promise$1(function (resolve, reject) {\n var dbInfo;\n self.ready().then(function () {\n dbInfo = self._dbInfo;\n if (toString.call(value) === '[object Blob]') {\n return _checkBlobSupport(dbInfo.db).then(function (blobSupport) {\n if (blobSupport) {\n return value;\n }\n return _encodeBlob(value);\n });\n }\n return value;\n }).then(function (value) {\n createTransaction(self._dbInfo, READ_WRITE, function (err, transaction) {\n if (err) {\n return reject(err);\n }\n\n try {\n var store = transaction.objectStore(self._dbInfo.storeName);\n\n // The reason we don't _save_ null is because IE 10 does\n // not support saving the `null` type in IndexedDB. How\n // ironic, given the bug below!\n // See: https://github.com/mozilla/localForage/issues/161\n if (value === null) {\n value = undefined;\n }\n\n var req = store.put(value, key);\n\n transaction.oncomplete = function () {\n // Cast to undefined so the value passed to\n // callback/promise is the same as what one would get out\n // of `getItem()` later. This leads to some weirdness\n // (setItem('foo', undefined) will return `null`), but\n // it's not my fault localStorage is our baseline and that\n // it's weird.\n if (value === undefined) {\n value = null;\n }\n\n resolve(value);\n };\n transaction.onabort = transaction.onerror = function () {\n var err = req.error ? req.error : req.transaction.error;\n reject(err);\n };\n } catch (e) {\n reject(e);\n }\n });\n })[\"catch\"](reject);\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\nfunction removeItem(key, callback) {\n var self = this;\n\n key = normalizeKey(key);\n\n var promise = new Promise$1(function (resolve, reject) {\n self.ready().then(function () {\n createTransaction(self._dbInfo, READ_WRITE, function (err, transaction) {\n if (err) {\n return reject(err);\n }\n\n try {\n var store = transaction.objectStore(self._dbInfo.storeName);\n // We use a Grunt task to make this safe for IE and some\n // versions of Android (including those used by Cordova).\n // Normally IE won't like `.delete()` and will insist on\n // using `['delete']()`, but we have a build step that\n // fixes this for us now.\n var req = store[\"delete\"](key);\n transaction.oncomplete = function () {\n resolve();\n };\n\n transaction.onerror = function () {\n reject(req.error);\n };\n\n // The request will be also be aborted if we've exceeded our storage\n // space.\n transaction.onabort = function () {\n var err = req.error ? req.error : req.transaction.error;\n reject(err);\n };\n } catch (e) {\n reject(e);\n }\n });\n })[\"catch\"](reject);\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\nfunction clear(callback) {\n var self = this;\n\n var promise = new Promise$1(function (resolve, reject) {\n self.ready().then(function () {\n createTransaction(self._dbInfo, READ_WRITE, function (err, transaction) {\n if (err) {\n return reject(err);\n }\n\n try {\n var store = transaction.objectStore(self._dbInfo.storeName);\n var req = store.clear();\n\n transaction.oncomplete = function () {\n resolve();\n };\n\n transaction.onabort = transaction.onerror = function () {\n var err = req.error ? req.error : req.transaction.error;\n reject(err);\n };\n } catch (e) {\n reject(e);\n }\n });\n })[\"catch\"](reject);\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\nfunction length(callback) {\n var self = this;\n\n var promise = new Promise$1(function (resolve, reject) {\n self.ready().then(function () {\n createTransaction(self._dbInfo, READ_ONLY, function (err, transaction) {\n if (err) {\n return reject(err);\n }\n\n try {\n var store = transaction.objectStore(self._dbInfo.storeName);\n var req = store.count();\n\n req.onsuccess = function () {\n resolve(req.result);\n };\n\n req.onerror = function () {\n reject(req.error);\n };\n } catch (e) {\n reject(e);\n }\n });\n })[\"catch\"](reject);\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\nfunction key(n, callback) {\n var self = this;\n\n var promise = new Promise$1(function (resolve, reject) {\n if (n < 0) {\n resolve(null);\n\n return;\n }\n\n self.ready().then(function () {\n createTransaction(self._dbInfo, READ_ONLY, function (err, transaction) {\n if (err) {\n return reject(err);\n }\n\n try {\n var store = transaction.objectStore(self._dbInfo.storeName);\n var advanced = false;\n var req = store.openKeyCursor();\n\n req.onsuccess = function () {\n var cursor = req.result;\n if (!cursor) {\n // this means there weren't enough keys\n resolve(null);\n\n return;\n }\n\n if (n === 0) {\n // We have the first key, return it if that's what they\n // wanted.\n resolve(cursor.key);\n } else {\n if (!advanced) {\n // Otherwise, ask the cursor to skip ahead n\n // records.\n advanced = true;\n cursor.advance(n);\n } else {\n // When we get here, we've got the nth key.\n resolve(cursor.key);\n }\n }\n };\n\n req.onerror = function () {\n reject(req.error);\n };\n } catch (e) {\n reject(e);\n }\n });\n })[\"catch\"](reject);\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\nfunction keys(callback) {\n var self = this;\n\n var promise = new Promise$1(function (resolve, reject) {\n self.ready().then(function () {\n createTransaction(self._dbInfo, READ_ONLY, function (err, transaction) {\n if (err) {\n return reject(err);\n }\n\n try {\n var store = transaction.objectStore(self._dbInfo.storeName);\n var req = store.openKeyCursor();\n var keys = [];\n\n req.onsuccess = function () {\n var cursor = req.result;\n\n if (!cursor) {\n resolve(keys);\n return;\n }\n\n keys.push(cursor.key);\n cursor[\"continue\"]();\n };\n\n req.onerror = function () {\n reject(req.error);\n };\n } catch (e) {\n reject(e);\n }\n });\n })[\"catch\"](reject);\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\nfunction dropInstance(options, callback) {\n callback = getCallback.apply(this, arguments);\n\n var currentConfig = this.config();\n options = typeof options !== 'function' && options || {};\n if (!options.name) {\n options.name = options.name || currentConfig.name;\n options.storeName = options.storeName || currentConfig.storeName;\n }\n\n var self = this;\n var promise;\n if (!options.name) {\n promise = Promise$1.reject('Invalid arguments');\n } else {\n var isCurrentDb = options.name === currentConfig.name && self._dbInfo.db;\n\n var dbPromise = isCurrentDb ? Promise$1.resolve(self._dbInfo.db) : _getOriginalConnection(options).then(function (db) {\n var dbContext = dbContexts[options.name];\n var forages = dbContext.forages;\n dbContext.db = db;\n for (var i = 0; i < forages.length; i++) {\n forages[i]._dbInfo.db = db;\n }\n return db;\n });\n\n if (!options.storeName) {\n promise = dbPromise.then(function (db) {\n _deferReadiness(options);\n\n var dbContext = dbContexts[options.name];\n var forages = dbContext.forages;\n\n db.close();\n for (var i = 0; i < forages.length; i++) {\n var forage = forages[i];\n forage._dbInfo.db = null;\n }\n\n var dropDBPromise = new Promise$1(function (resolve, reject) {\n var req = idb.deleteDatabase(options.name);\n\n req.onerror = function () {\n var db = req.result;\n if (db) {\n db.close();\n }\n reject(req.error);\n };\n\n req.onblocked = function () {\n // Closing all open connections in onversionchange handler should prevent this situation, but if\n // we do get here, it just means the request remains pending - eventually it will succeed or error\n console.warn('dropInstance blocked for database \"' + options.name + '\" until all open connections are closed');\n };\n\n req.onsuccess = function () {\n var db = req.result;\n if (db) {\n db.close();\n }\n resolve(db);\n };\n });\n\n return dropDBPromise.then(function (db) {\n dbContext.db = db;\n for (var i = 0; i < forages.length; i++) {\n var _forage = forages[i];\n _advanceReadiness(_forage._dbInfo);\n }\n })[\"catch\"](function (err) {\n (_rejectReadiness(options, err) || Promise$1.resolve())[\"catch\"](function () {});\n throw err;\n });\n });\n } else {\n promise = dbPromise.then(function (db) {\n if (!db.objectStoreNames.contains(options.storeName)) {\n return;\n }\n\n var newVersion = db.version + 1;\n\n _deferReadiness(options);\n\n var dbContext = dbContexts[options.name];\n var forages = dbContext.forages;\n\n db.close();\n for (var i = 0; i < forages.length; i++) {\n var forage = forages[i];\n forage._dbInfo.db = null;\n forage._dbInfo.version = newVersion;\n }\n\n var dropObjectPromise = new Promise$1(function (resolve, reject) {\n var req = idb.open(options.name, newVersion);\n\n req.onerror = function (err) {\n var db = req.result;\n db.close();\n reject(err);\n };\n\n req.onupgradeneeded = function () {\n var db = req.result;\n db.deleteObjectStore(options.storeName);\n };\n\n req.onsuccess = function () {\n var db = req.result;\n db.close();\n resolve(db);\n };\n });\n\n return dropObjectPromise.then(function (db) {\n dbContext.db = db;\n for (var j = 0; j < forages.length; j++) {\n var _forage2 = forages[j];\n _forage2._dbInfo.db = db;\n _advanceReadiness(_forage2._dbInfo);\n }\n })[\"catch\"](function (err) {\n (_rejectReadiness(options, err) || Promise$1.resolve())[\"catch\"](function () {});\n throw err;\n });\n });\n }\n }\n\n executeCallback(promise, callback);\n return promise;\n}\n\nvar asyncStorage = {\n _driver: 'asyncStorage',\n _initStorage: _initStorage,\n _support: isIndexedDBValid(),\n iterate: iterate,\n getItem: getItem,\n setItem: setItem,\n removeItem: removeItem,\n clear: clear,\n length: length,\n key: key,\n keys: keys,\n dropInstance: dropInstance\n};\n\nfunction isWebSQLValid() {\n return typeof openDatabase === 'function';\n}\n\n// Sadly, the best way to save binary data in WebSQL/localStorage is serializing\n// it to Base64, so this is how we store it to prevent very strange errors with less\n// verbose ways of binary <-> string data storage.\nvar BASE_CHARS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';\n\nvar BLOB_TYPE_PREFIX = '~~local_forage_type~';\nvar BLOB_TYPE_PREFIX_REGEX = /^~~local_forage_type~([^~]+)~/;\n\nvar SERIALIZED_MARKER = '__lfsc__:';\nvar SERIALIZED_MARKER_LENGTH = SERIALIZED_MARKER.length;\n\n// OMG the serializations!\nvar TYPE_ARRAYBUFFER = 'arbf';\nvar TYPE_BLOB = 'blob';\nvar TYPE_INT8ARRAY = 'si08';\nvar TYPE_UINT8ARRAY = 'ui08';\nvar TYPE_UINT8CLAMPEDARRAY = 'uic8';\nvar TYPE_INT16ARRAY = 'si16';\nvar TYPE_INT32ARRAY = 'si32';\nvar TYPE_UINT16ARRAY = 'ur16';\nvar TYPE_UINT32ARRAY = 'ui32';\nvar TYPE_FLOAT32ARRAY = 'fl32';\nvar TYPE_FLOAT64ARRAY = 'fl64';\nvar TYPE_SERIALIZED_MARKER_LENGTH = SERIALIZED_MARKER_LENGTH + TYPE_ARRAYBUFFER.length;\n\nvar toString$1 = Object.prototype.toString;\n\nfunction stringToBuffer(serializedString) {\n // Fill the string into a ArrayBuffer.\n var bufferLength = serializedString.length * 0.75;\n var len = serializedString.length;\n var i;\n var p = 0;\n var encoded1, encoded2, encoded3, encoded4;\n\n if (serializedString[serializedString.length - 1] === '=') {\n bufferLength--;\n if (serializedString[serializedString.length - 2] === '=') {\n bufferLength--;\n }\n }\n\n var buffer = new ArrayBuffer(bufferLength);\n var bytes = new Uint8Array(buffer);\n\n for (i = 0; i < len; i += 4) {\n encoded1 = BASE_CHARS.indexOf(serializedString[i]);\n encoded2 = BASE_CHARS.indexOf(serializedString[i + 1]);\n encoded3 = BASE_CHARS.indexOf(serializedString[i + 2]);\n encoded4 = BASE_CHARS.indexOf(serializedString[i + 3]);\n\n /*jslint bitwise: true */\n bytes[p++] = encoded1 << 2 | encoded2 >> 4;\n bytes[p++] = (encoded2 & 15) << 4 | encoded3 >> 2;\n bytes[p++] = (encoded3 & 3) << 6 | encoded4 & 63;\n }\n return buffer;\n}\n\n// Converts a buffer to a string to store, serialized, in the backend\n// storage library.\nfunction bufferToString(buffer) {\n // base64-arraybuffer\n var bytes = new Uint8Array(buffer);\n var base64String = '';\n var i;\n\n for (i = 0; i < bytes.length; i += 3) {\n /*jslint bitwise: true */\n base64String += BASE_CHARS[bytes[i] >> 2];\n base64String += BASE_CHARS[(bytes[i] & 3) << 4 | bytes[i + 1] >> 4];\n base64String += BASE_CHARS[(bytes[i + 1] & 15) << 2 | bytes[i + 2] >> 6];\n base64String += BASE_CHARS[bytes[i + 2] & 63];\n }\n\n if (bytes.length % 3 === 2) {\n base64String = base64String.substring(0, base64String.length - 1) + '=';\n } else if (bytes.length % 3 === 1) {\n base64String = base64String.substring(0, base64String.length - 2) + '==';\n }\n\n return base64String;\n}\n\n// Serialize a value, afterwards executing a callback (which usually\n// instructs the `setItem()` callback/promise to be executed). This is how\n// we store binary data with localStorage.\nfunction serialize(value, callback) {\n var valueType = '';\n if (value) {\n valueType = toString$1.call(value);\n }\n\n // Cannot use `value instanceof ArrayBuffer` or such here, as these\n // checks fail when running the tests using casper.js...\n //\n // TODO: See why those tests fail and use a better solution.\n if (value && (valueType === '[object ArrayBuffer]' || value.buffer && toString$1.call(value.buffer) === '[object ArrayBuffer]')) {\n // Convert binary arrays to a string and prefix the string with\n // a special marker.\n var buffer;\n var marker = SERIALIZED_MARKER;\n\n if (value instanceof ArrayBuffer) {\n buffer = value;\n marker += TYPE_ARRAYBUFFER;\n } else {\n buffer = value.buffer;\n\n if (valueType === '[object Int8Array]') {\n marker += TYPE_INT8ARRAY;\n } else if (valueType === '[object Uint8Array]') {\n marker += TYPE_UINT8ARRAY;\n } else if (valueType === '[object Uint8ClampedArray]') {\n marker += TYPE_UINT8CLAMPEDARRAY;\n } else if (valueType === '[object Int16Array]') {\n marker += TYPE_INT16ARRAY;\n } else if (valueType === '[object Uint16Array]') {\n marker += TYPE_UINT16ARRAY;\n } else if (valueType === '[object Int32Array]') {\n marker += TYPE_INT32ARRAY;\n } else if (valueType === '[object Uint32Array]') {\n marker += TYPE_UINT32ARRAY;\n } else if (valueType === '[object Float32Array]') {\n marker += TYPE_FLOAT32ARRAY;\n } else if (valueType === '[object Float64Array]') {\n marker += TYPE_FLOAT64ARRAY;\n } else {\n callback(new Error('Failed to get type for BinaryArray'));\n }\n }\n\n callback(marker + bufferToString(buffer));\n } else if (valueType === '[object Blob]') {\n // Conver the blob to a binaryArray and then to a string.\n var fileReader = new FileReader();\n\n fileReader.onload = function () {\n // Backwards-compatible prefix for the blob type.\n var str = BLOB_TYPE_PREFIX + value.type + '~' + bufferToString(this.result);\n\n callback(SERIALIZED_MARKER + TYPE_BLOB + str);\n };\n\n fileReader.readAsArrayBuffer(value);\n } else {\n try {\n callback(JSON.stringify(value));\n } catch (e) {\n console.error(\"Couldn't convert value into a JSON string: \", value);\n\n callback(null, e);\n }\n }\n}\n\n// Deserialize data we've inserted into a value column/field. We place\n// special markers into our strings to mark them as encoded; this isn't\n// as nice as a meta field, but it's the only sane thing we can do whilst\n// keeping localStorage support intact.\n//\n// Oftentimes this will just deserialize JSON content, but if we have a\n// special marker (SERIALIZED_MARKER, defined above), we will extract\n// some kind of arraybuffer/binary data/typed array out of the string.\nfunction deserialize(value) {\n // If we haven't marked this string as being specially serialized (i.e.\n // something other than serialized JSON), we can just return it and be\n // done with it.\n if (value.substring(0, SERIALIZED_MARKER_LENGTH) !== SERIALIZED_MARKER) {\n return JSON.parse(value);\n }\n\n // The following code deals with deserializing some kind of Blob or\n // TypedArray. First we separate out the type of data we're dealing\n // with from the data itself.\n var serializedString = value.substring(TYPE_SERIALIZED_MARKER_LENGTH);\n var type = value.substring(SERIALIZED_MARKER_LENGTH, TYPE_SERIALIZED_MARKER_LENGTH);\n\n var blobType;\n // Backwards-compatible blob type serialization strategy.\n // DBs created with older versions of localForage will simply not have the blob type.\n if (type === TYPE_BLOB && BLOB_TYPE_PREFIX_REGEX.test(serializedString)) {\n var matcher = serializedString.match(BLOB_TYPE_PREFIX_REGEX);\n blobType = matcher[1];\n serializedString = serializedString.substring(matcher[0].length);\n }\n var buffer = stringToBuffer(serializedString);\n\n // Return the right type based on the code/type set during\n // serialization.\n switch (type) {\n case TYPE_ARRAYBUFFER:\n return buffer;\n case TYPE_BLOB:\n return createBlob([buffer], { type: blobType });\n case TYPE_INT8ARRAY:\n return new Int8Array(buffer);\n case TYPE_UINT8ARRAY:\n return new Uint8Array(buffer);\n case TYPE_UINT8CLAMPEDARRAY:\n return new Uint8ClampedArray(buffer);\n case TYPE_INT16ARRAY:\n return new Int16Array(buffer);\n case TYPE_UINT16ARRAY:\n return new Uint16Array(buffer);\n case TYPE_INT32ARRAY:\n return new Int32Array(buffer);\n case TYPE_UINT32ARRAY:\n return new Uint32Array(buffer);\n case TYPE_FLOAT32ARRAY:\n return new Float32Array(buffer);\n case TYPE_FLOAT64ARRAY:\n return new Float64Array(buffer);\n default:\n throw new Error('Unkown type: ' + type);\n }\n}\n\nvar localforageSerializer = {\n serialize: serialize,\n deserialize: deserialize,\n stringToBuffer: stringToBuffer,\n bufferToString: bufferToString\n};\n\n/*\n * Includes code from:\n *\n * base64-arraybuffer\n * https://github.com/niklasvh/base64-arraybuffer\n *\n * Copyright (c) 2012 Niklas von Hertzen\n * Licensed under the MIT license.\n */\n\nfunction createDbTable(t, dbInfo, callback, errorCallback) {\n t.executeSql('CREATE TABLE IF NOT EXISTS ' + dbInfo.storeName + ' ' + '(id INTEGER PRIMARY KEY, key unique, value)', [], callback, errorCallback);\n}\n\n// Open the WebSQL database (automatically creates one if one didn't\n// previously exist), using any options set in the config.\nfunction _initStorage$1(options) {\n var self = this;\n var dbInfo = {\n db: null\n };\n\n if (options) {\n for (var i in options) {\n dbInfo[i] = typeof options[i] !== 'string' ? options[i].toString() : options[i];\n }\n }\n\n var dbInfoPromise = new Promise$1(function (resolve, reject) {\n // Open the database; the openDatabase API will automatically\n // create it for us if it doesn't exist.\n try {\n dbInfo.db = openDatabase(dbInfo.name, String(dbInfo.version), dbInfo.description, dbInfo.size);\n } catch (e) {\n return reject(e);\n }\n\n // Create our key/value table if it doesn't exist.\n dbInfo.db.transaction(function (t) {\n createDbTable(t, dbInfo, function () {\n self._dbInfo = dbInfo;\n resolve();\n }, function (t, error) {\n reject(error);\n });\n }, reject);\n });\n\n dbInfo.serializer = localforageSerializer;\n return dbInfoPromise;\n}\n\nfunction tryExecuteSql(t, dbInfo, sqlStatement, args, callback, errorCallback) {\n t.executeSql(sqlStatement, args, callback, function (t, error) {\n if (error.code === error.SYNTAX_ERR) {\n t.executeSql('SELECT name FROM sqlite_master ' + \"WHERE type='table' AND name = ?\", [dbInfo.storeName], function (t, results) {\n if (!results.rows.length) {\n // if the table is missing (was deleted)\n // re-create it table and retry\n createDbTable(t, dbInfo, function () {\n t.executeSql(sqlStatement, args, callback, errorCallback);\n }, errorCallback);\n } else {\n errorCallback(t, error);\n }\n }, errorCallback);\n } else {\n errorCallback(t, error);\n }\n }, errorCallback);\n}\n\nfunction getItem$1(key, callback) {\n var self = this;\n\n key = normalizeKey(key);\n\n var promise = new Promise$1(function (resolve, reject) {\n self.ready().then(function () {\n var dbInfo = self._dbInfo;\n dbInfo.db.transaction(function (t) {\n tryExecuteSql(t, dbInfo, 'SELECT * FROM ' + dbInfo.storeName + ' WHERE key = ? LIMIT 1', [key], function (t, results) {\n var result = results.rows.length ? results.rows.item(0).value : null;\n\n // Check to see if this is serialized content we need to\n // unpack.\n if (result) {\n result = dbInfo.serializer.deserialize(result);\n }\n\n resolve(result);\n }, function (t, error) {\n reject(error);\n });\n });\n })[\"catch\"](reject);\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\nfunction iterate$1(iterator, callback) {\n var self = this;\n\n var promise = new Promise$1(function (resolve, reject) {\n self.ready().then(function () {\n var dbInfo = self._dbInfo;\n\n dbInfo.db.transaction(function (t) {\n tryExecuteSql(t, dbInfo, 'SELECT * FROM ' + dbInfo.storeName, [], function (t, results) {\n var rows = results.rows;\n var length = rows.length;\n\n for (var i = 0; i < length; i++) {\n var item = rows.item(i);\n var result = item.value;\n\n // Check to see if this is serialized content\n // we need to unpack.\n if (result) {\n result = dbInfo.serializer.deserialize(result);\n }\n\n result = iterator(result, item.key, i + 1);\n\n // void(0) prevents problems with redefinition\n // of `undefined`.\n if (result !== void 0) {\n resolve(result);\n return;\n }\n }\n\n resolve();\n }, function (t, error) {\n reject(error);\n });\n });\n })[\"catch\"](reject);\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\nfunction _setItem(key, value, callback, retriesLeft) {\n var self = this;\n\n key = normalizeKey(key);\n\n var promise = new Promise$1(function (resolve, reject) {\n self.ready().then(function () {\n // The localStorage API doesn't return undefined values in an\n // \"expected\" way, so undefined is always cast to null in all\n // drivers. See: https://github.com/mozilla/localForage/pull/42\n if (value === undefined) {\n value = null;\n }\n\n // Save the original value to pass to the callback.\n var originalValue = value;\n\n var dbInfo = self._dbInfo;\n dbInfo.serializer.serialize(value, function (value, error) {\n if (error) {\n reject(error);\n } else {\n dbInfo.db.transaction(function (t) {\n tryExecuteSql(t, dbInfo, 'INSERT OR REPLACE INTO ' + dbInfo.storeName + ' ' + '(key, value) VALUES (?, ?)', [key, value], function () {\n resolve(originalValue);\n }, function (t, error) {\n reject(error);\n });\n }, function (sqlError) {\n // The transaction failed; check\n // to see if it's a quota error.\n if (sqlError.code === sqlError.QUOTA_ERR) {\n // We reject the callback outright for now, but\n // it's worth trying to re-run the transaction.\n // Even if the user accepts the prompt to use\n // more storage on Safari, this error will\n // be called.\n //\n // Try to re-run the transaction.\n if (retriesLeft > 0) {\n resolve(_setItem.apply(self, [key, originalValue, callback, retriesLeft - 1]));\n return;\n }\n reject(sqlError);\n }\n });\n }\n });\n })[\"catch\"](reject);\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\nfunction setItem$1(key, value, callback) {\n return _setItem.apply(this, [key, value, callback, 1]);\n}\n\nfunction removeItem$1(key, callback) {\n var self = this;\n\n key = normalizeKey(key);\n\n var promise = new Promise$1(function (resolve, reject) {\n self.ready().then(function () {\n var dbInfo = self._dbInfo;\n dbInfo.db.transaction(function (t) {\n tryExecuteSql(t, dbInfo, 'DELETE FROM ' + dbInfo.storeName + ' WHERE key = ?', [key], function () {\n resolve();\n }, function (t, error) {\n reject(error);\n });\n });\n })[\"catch\"](reject);\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\n// Deletes every item in the table.\n// TODO: Find out if this resets the AUTO_INCREMENT number.\nfunction clear$1(callback) {\n var self = this;\n\n var promise = new Promise$1(function (resolve, reject) {\n self.ready().then(function () {\n var dbInfo = self._dbInfo;\n dbInfo.db.transaction(function (t) {\n tryExecuteSql(t, dbInfo, 'DELETE FROM ' + dbInfo.storeName, [], function () {\n resolve();\n }, function (t, error) {\n reject(error);\n });\n });\n })[\"catch\"](reject);\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\n// Does a simple `COUNT(key)` to get the number of items stored in\n// localForage.\nfunction length$1(callback) {\n var self = this;\n\n var promise = new Promise$1(function (resolve, reject) {\n self.ready().then(function () {\n var dbInfo = self._dbInfo;\n dbInfo.db.transaction(function (t) {\n // Ahhh, SQL makes this one soooooo easy.\n tryExecuteSql(t, dbInfo, 'SELECT COUNT(key) as c FROM ' + dbInfo.storeName, [], function (t, results) {\n var result = results.rows.item(0).c;\n resolve(result);\n }, function (t, error) {\n reject(error);\n });\n });\n })[\"catch\"](reject);\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\n// Return the key located at key index X; essentially gets the key from a\n// `WHERE id = ?`. This is the most efficient way I can think to implement\n// this rarely-used (in my experience) part of the API, but it can seem\n// inconsistent, because we do `INSERT OR REPLACE INTO` on `setItem()`, so\n// the ID of each key will change every time it's updated. Perhaps a stored\n// procedure for the `setItem()` SQL would solve this problem?\n// TODO: Don't change ID on `setItem()`.\nfunction key$1(n, callback) {\n var self = this;\n\n var promise = new Promise$1(function (resolve, reject) {\n self.ready().then(function () {\n var dbInfo = self._dbInfo;\n dbInfo.db.transaction(function (t) {\n tryExecuteSql(t, dbInfo, 'SELECT key FROM ' + dbInfo.storeName + ' WHERE id = ? LIMIT 1', [n + 1], function (t, results) {\n var result = results.rows.length ? results.rows.item(0).key : null;\n resolve(result);\n }, function (t, error) {\n reject(error);\n });\n });\n })[\"catch\"](reject);\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\nfunction keys$1(callback) {\n var self = this;\n\n var promise = new Promise$1(function (resolve, reject) {\n self.ready().then(function () {\n var dbInfo = self._dbInfo;\n dbInfo.db.transaction(function (t) {\n tryExecuteSql(t, dbInfo, 'SELECT key FROM ' + dbInfo.storeName, [], function (t, results) {\n var keys = [];\n\n for (var i = 0; i < results.rows.length; i++) {\n keys.push(results.rows.item(i).key);\n }\n\n resolve(keys);\n }, function (t, error) {\n reject(error);\n });\n });\n })[\"catch\"](reject);\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\n// https://www.w3.org/TR/webdatabase/#databases\n// > There is no way to enumerate or delete the databases available for an origin from this API.\nfunction getAllStoreNames(db) {\n return new Promise$1(function (resolve, reject) {\n db.transaction(function (t) {\n t.executeSql('SELECT name FROM sqlite_master ' + \"WHERE type='table' AND name <> '__WebKitDatabaseInfoTable__'\", [], function (t, results) {\n var storeNames = [];\n\n for (var i = 0; i < results.rows.length; i++) {\n storeNames.push(results.rows.item(i).name);\n }\n\n resolve({\n db: db,\n storeNames: storeNames\n });\n }, function (t, error) {\n reject(error);\n });\n }, function (sqlError) {\n reject(sqlError);\n });\n });\n}\n\nfunction dropInstance$1(options, callback) {\n callback = getCallback.apply(this, arguments);\n\n var currentConfig = this.config();\n options = typeof options !== 'function' && options || {};\n if (!options.name) {\n options.name = options.name || currentConfig.name;\n options.storeName = options.storeName || currentConfig.storeName;\n }\n\n var self = this;\n var promise;\n if (!options.name) {\n promise = Promise$1.reject('Invalid arguments');\n } else {\n promise = new Promise$1(function (resolve) {\n var db;\n if (options.name === currentConfig.name) {\n // use the db reference of the current instance\n db = self._dbInfo.db;\n } else {\n db = openDatabase(options.name, '', '', 0);\n }\n\n if (!options.storeName) {\n // drop all database tables\n resolve(getAllStoreNames(db));\n } else {\n resolve({\n db: db,\n storeNames: [options.storeName]\n });\n }\n }).then(function (operationInfo) {\n return new Promise$1(function (resolve, reject) {\n operationInfo.db.transaction(function (t) {\n function dropTable(storeName) {\n return new Promise$1(function (resolve, reject) {\n t.executeSql('DROP TABLE IF EXISTS ' + storeName, [], function () {\n resolve();\n }, function (t, error) {\n reject(error);\n });\n });\n }\n\n var operations = [];\n for (var i = 0, len = operationInfo.storeNames.length; i < len; i++) {\n operations.push(dropTable(operationInfo.storeNames[i]));\n }\n\n Promise$1.all(operations).then(function () {\n resolve();\n })[\"catch\"](function (e) {\n reject(e);\n });\n }, function (sqlError) {\n reject(sqlError);\n });\n });\n });\n }\n\n executeCallback(promise, callback);\n return promise;\n}\n\nvar webSQLStorage = {\n _driver: 'webSQLStorage',\n _initStorage: _initStorage$1,\n _support: isWebSQLValid(),\n iterate: iterate$1,\n getItem: getItem$1,\n setItem: setItem$1,\n removeItem: removeItem$1,\n clear: clear$1,\n length: length$1,\n key: key$1,\n keys: keys$1,\n dropInstance: dropInstance$1\n};\n\nfunction isLocalStorageValid() {\n try {\n return typeof localStorage !== 'undefined' && 'setItem' in localStorage &&\n // in IE8 typeof localStorage.setItem === 'object'\n !!localStorage.setItem;\n } catch (e) {\n return false;\n }\n}\n\nfunction _getKeyPrefix(options, defaultConfig) {\n var keyPrefix = options.name + '/';\n\n if (options.storeName !== defaultConfig.storeName) {\n keyPrefix += options.storeName + '/';\n }\n return keyPrefix;\n}\n\n// Check if localStorage throws when saving an item\nfunction checkIfLocalStorageThrows() {\n var localStorageTestKey = '_localforage_support_test';\n\n try {\n localStorage.setItem(localStorageTestKey, true);\n localStorage.removeItem(localStorageTestKey);\n\n return false;\n } catch (e) {\n return true;\n }\n}\n\n// Check if localStorage is usable and allows to save an item\n// This method checks if localStorage is usable in Safari Private Browsing\n// mode, or in any other case where the available quota for localStorage\n// is 0 and there wasn't any saved items yet.\nfunction _isLocalStorageUsable() {\n return !checkIfLocalStorageThrows() || localStorage.length > 0;\n}\n\n// Config the localStorage backend, using options set in the config.\nfunction _initStorage$2(options) {\n var self = this;\n var dbInfo = {};\n if (options) {\n for (var i in options) {\n dbInfo[i] = options[i];\n }\n }\n\n dbInfo.keyPrefix = _getKeyPrefix(options, self._defaultConfig);\n\n if (!_isLocalStorageUsable()) {\n return Promise$1.reject();\n }\n\n self._dbInfo = dbInfo;\n dbInfo.serializer = localforageSerializer;\n\n return Promise$1.resolve();\n}\n\n// Remove all keys from the datastore, effectively destroying all data in\n// the app's key/value store!\nfunction clear$2(callback) {\n var self = this;\n var promise = self.ready().then(function () {\n var keyPrefix = self._dbInfo.keyPrefix;\n\n for (var i = localStorage.length - 1; i >= 0; i--) {\n var key = localStorage.key(i);\n\n if (key.indexOf(keyPrefix) === 0) {\n localStorage.removeItem(key);\n }\n }\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\n// Retrieve an item from the store. Unlike the original async_storage\n// library in Gaia, we don't modify return values at all. If a key's value\n// is `undefined`, we pass that value to the callback function.\nfunction getItem$2(key, callback) {\n var self = this;\n\n key = normalizeKey(key);\n\n var promise = self.ready().then(function () {\n var dbInfo = self._dbInfo;\n var result = localStorage.getItem(dbInfo.keyPrefix + key);\n\n // If a result was found, parse it from the serialized\n // string into a JS object. If result isn't truthy, the key\n // is likely undefined and we'll pass it straight to the\n // callback.\n if (result) {\n result = dbInfo.serializer.deserialize(result);\n }\n\n return result;\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\n// Iterate over all items in the store.\nfunction iterate$2(iterator, callback) {\n var self = this;\n\n var promise = self.ready().then(function () {\n var dbInfo = self._dbInfo;\n var keyPrefix = dbInfo.keyPrefix;\n var keyPrefixLength = keyPrefix.length;\n var length = localStorage.length;\n\n // We use a dedicated iterator instead of the `i` variable below\n // so other keys we fetch in localStorage aren't counted in\n // the `iterationNumber` argument passed to the `iterate()`\n // callback.\n //\n // See: github.com/mozilla/localForage/pull/435#discussion_r38061530\n var iterationNumber = 1;\n\n for (var i = 0; i < length; i++) {\n var key = localStorage.key(i);\n if (key.indexOf(keyPrefix) !== 0) {\n continue;\n }\n var value = localStorage.getItem(key);\n\n // If a result was found, parse it from the serialized\n // string into a JS object. If result isn't truthy, the\n // key is likely undefined and we'll pass it straight\n // to the iterator.\n if (value) {\n value = dbInfo.serializer.deserialize(value);\n }\n\n value = iterator(value, key.substring(keyPrefixLength), iterationNumber++);\n\n if (value !== void 0) {\n return value;\n }\n }\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\n// Same as localStorage's key() method, except takes a callback.\nfunction key$2(n, callback) {\n var self = this;\n var promise = self.ready().then(function () {\n var dbInfo = self._dbInfo;\n var result;\n try {\n result = localStorage.key(n);\n } catch (error) {\n result = null;\n }\n\n // Remove the prefix from the key, if a key is found.\n if (result) {\n result = result.substring(dbInfo.keyPrefix.length);\n }\n\n return result;\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\nfunction keys$2(callback) {\n var self = this;\n var promise = self.ready().then(function () {\n var dbInfo = self._dbInfo;\n var length = localStorage.length;\n var keys = [];\n\n for (var i = 0; i < length; i++) {\n var itemKey = localStorage.key(i);\n if (itemKey.indexOf(dbInfo.keyPrefix) === 0) {\n keys.push(itemKey.substring(dbInfo.keyPrefix.length));\n }\n }\n\n return keys;\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\n// Supply the number of keys in the datastore to the callback function.\nfunction length$2(callback) {\n var self = this;\n var promise = self.keys().then(function (keys) {\n return keys.length;\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\n// Remove an item from the store, nice and simple.\nfunction removeItem$2(key, callback) {\n var self = this;\n\n key = normalizeKey(key);\n\n var promise = self.ready().then(function () {\n var dbInfo = self._dbInfo;\n localStorage.removeItem(dbInfo.keyPrefix + key);\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\n// Set a key's value and run an optional callback once the value is set.\n// Unlike Gaia's implementation, the callback function is passed the value,\n// in case you want to operate on that value only after you're sure it\n// saved, or something like that.\nfunction setItem$2(key, value, callback) {\n var self = this;\n\n key = normalizeKey(key);\n\n var promise = self.ready().then(function () {\n // Convert undefined values to null.\n // https://github.com/mozilla/localForage/pull/42\n if (value === undefined) {\n value = null;\n }\n\n // Save the original value to pass to the callback.\n var originalValue = value;\n\n return new Promise$1(function (resolve, reject) {\n var dbInfo = self._dbInfo;\n dbInfo.serializer.serialize(value, function (value, error) {\n if (error) {\n reject(error);\n } else {\n try {\n localStorage.setItem(dbInfo.keyPrefix + key, value);\n resolve(originalValue);\n } catch (e) {\n // localStorage capacity exceeded.\n // TODO: Make this a specific error/event.\n if (e.name === 'QuotaExceededError' || e.name === 'NS_ERROR_DOM_QUOTA_REACHED') {\n reject(e);\n }\n reject(e);\n }\n }\n });\n });\n });\n\n executeCallback(promise, callback);\n return promise;\n}\n\nfunction dropInstance$2(options, callback) {\n callback = getCallback.apply(this, arguments);\n\n options = typeof options !== 'function' && options || {};\n if (!options.name) {\n var currentConfig = this.config();\n options.name = options.name || currentConfig.name;\n options.storeName = options.storeName || currentConfig.storeName;\n }\n\n var self = this;\n var promise;\n if (!options.name) {\n promise = Promise$1.reject('Invalid arguments');\n } else {\n promise = new Promise$1(function (resolve) {\n if (!options.storeName) {\n resolve(options.name + '/');\n } else {\n resolve(_getKeyPrefix(options, self._defaultConfig));\n }\n }).then(function (keyPrefix) {\n for (var i = localStorage.length - 1; i >= 0; i--) {\n var key = localStorage.key(i);\n\n if (key.indexOf(keyPrefix) === 0) {\n localStorage.removeItem(key);\n }\n }\n });\n }\n\n executeCallback(promise, callback);\n return promise;\n}\n\nvar localStorageWrapper = {\n _driver: 'localStorageWrapper',\n _initStorage: _initStorage$2,\n _support: isLocalStorageValid(),\n iterate: iterate$2,\n getItem: getItem$2,\n setItem: setItem$2,\n removeItem: removeItem$2,\n clear: clear$2,\n length: length$2,\n key: key$2,\n keys: keys$2,\n dropInstance: dropInstance$2\n};\n\nvar sameValue = function sameValue(x, y) {\n return x === y || typeof x === 'number' && typeof y === 'number' && isNaN(x) && isNaN(y);\n};\n\nvar includes = function includes(array, searchElement) {\n var len = array.length;\n var i = 0;\n while (i < len) {\n if (sameValue(array[i], searchElement)) {\n return true;\n }\n i++;\n }\n\n return false;\n};\n\nvar isArray = Array.isArray || function (arg) {\n return Object.prototype.toString.call(arg) === '[object Array]';\n};\n\n// Drivers are stored here when `defineDriver()` is called.\n// They are shared across all instances of localForage.\nvar DefinedDrivers = {};\n\nvar DriverSupport = {};\n\nvar DefaultDrivers = {\n INDEXEDDB: asyncStorage,\n WEBSQL: webSQLStorage,\n LOCALSTORAGE: localStorageWrapper\n};\n\nvar DefaultDriverOrder = [DefaultDrivers.INDEXEDDB._driver, DefaultDrivers.WEBSQL._driver, DefaultDrivers.LOCALSTORAGE._driver];\n\nvar OptionalDriverMethods = ['dropInstance'];\n\nvar LibraryMethods = ['clear', 'getItem', 'iterate', 'key', 'keys', 'length', 'removeItem', 'setItem'].concat(OptionalDriverMethods);\n\nvar DefaultConfig = {\n description: '',\n driver: DefaultDriverOrder.slice(),\n name: 'localforage',\n // Default DB size is _JUST UNDER_ 5MB, as it's the highest size\n // we can use without a prompt.\n size: 4980736,\n storeName: 'keyvaluepairs',\n version: 1.0\n};\n\nfunction callWhenReady(localForageInstance, libraryMethod) {\n localForageInstance[libraryMethod] = function () {\n var _args = arguments;\n return localForageInstance.ready().then(function () {\n return localForageInstance[libraryMethod].apply(localForageInstance, _args);\n });\n };\n}\n\nfunction extend() {\n for (var i = 1; i < arguments.length; i++) {\n var arg = arguments[i];\n\n if (arg) {\n for (var _key in arg) {\n if (arg.hasOwnProperty(_key)) {\n if (isArray(arg[_key])) {\n arguments[0][_key] = arg[_key].slice();\n } else {\n arguments[0][_key] = arg[_key];\n }\n }\n }\n }\n }\n\n return arguments[0];\n}\n\nvar LocalForage = function () {\n function LocalForage(options) {\n _classCallCheck(this, LocalForage);\n\n for (var driverTypeKey in DefaultDrivers) {\n if (DefaultDrivers.hasOwnProperty(driverTypeKey)) {\n var driver = DefaultDrivers[driverTypeKey];\n var driverName = driver._driver;\n this[driverTypeKey] = driverName;\n\n if (!DefinedDrivers[driverName]) {\n // we don't need to wait for the promise,\n // since the default drivers can be defined\n // in a blocking manner\n this.defineDriver(driver);\n }\n }\n }\n\n this._defaultConfig = extend({}, DefaultConfig);\n this._config = extend({}, this._defaultConfig, options);\n this._driverSet = null;\n this._initDriver = null;\n this._ready = false;\n this._dbInfo = null;\n\n this._wrapLibraryMethodsWithReady();\n this.setDriver(this._config.driver)[\"catch\"](function () {});\n }\n\n // Set any config values for localForage; can be called anytime before\n // the first API call (e.g. `getItem`, `setItem`).\n // We loop through options so we don't overwrite existing config\n // values.\n\n\n LocalForage.prototype.config = function config(options) {\n // If the options argument is an object, we use it to set values.\n // Otherwise, we return either a specified config value or all\n // config values.\n if ((typeof options === 'undefined' ? 'undefined' : _typeof(options)) === 'object') {\n // If localforage is ready and fully initialized, we can't set\n // any new configuration values. Instead, we return an error.\n if (this._ready) {\n return new Error(\"Can't call config() after localforage \" + 'has been used.');\n }\n\n for (var i in options) {\n if (i === 'storeName') {\n options[i] = options[i].replace(/\\W/g, '_');\n }\n\n if (i === 'version' && typeof options[i] !== 'number') {\n return new Error('Database version must be a number.');\n }\n\n this._config[i] = options[i];\n }\n\n // after all config options are set and\n // the driver option is used, try setting it\n if ('driver' in options && options.driver) {\n return this.setDriver(this._config.driver);\n }\n\n return true;\n } else if (typeof options === 'string') {\n return this._config[options];\n } else {\n return this._config;\n }\n };\n\n // Used to define a custom driver, shared across all instances of\n // localForage.\n\n\n LocalForage.prototype.defineDriver = function defineDriver(driverObject, callback, errorCallback) {\n var promise = new Promise$1(function (resolve, reject) {\n try {\n var driverName = driverObject._driver;\n var complianceError = new Error('Custom driver not compliant; see ' + 'https://mozilla.github.io/localForage/#definedriver');\n\n // A driver name should be defined and not overlap with the\n // library-defined, default drivers.\n if (!driverObject._driver) {\n reject(complianceError);\n return;\n }\n\n var driverMethods = LibraryMethods.concat('_initStorage');\n for (var i = 0, len = driverMethods.length; i < len; i++) {\n var driverMethodName = driverMethods[i];\n\n // when the property is there,\n // it should be a method even when optional\n var isRequired = !includes(OptionalDriverMethods, driverMethodName);\n if ((isRequired || driverObject[driverMethodName]) && typeof driverObject[driverMethodName] !== 'function') {\n reject(complianceError);\n return;\n }\n }\n\n var configureMissingMethods = function configureMissingMethods() {\n var methodNotImplementedFactory = function methodNotImplementedFactory(methodName) {\n return function () {\n var error = new Error('Method ' + methodName + ' is not implemented by the current driver');\n var promise = Promise$1.reject(error);\n executeCallback(promise, arguments[arguments.length - 1]);\n return promise;\n };\n };\n\n for (var _i = 0, _len = OptionalDriverMethods.length; _i < _len; _i++) {\n var optionalDriverMethod = OptionalDriverMethods[_i];\n if (!driverObject[optionalDriverMethod]) {\n driverObject[optionalDriverMethod] = methodNotImplementedFactory(optionalDriverMethod);\n }\n }\n };\n\n configureMissingMethods();\n\n var setDriverSupport = function setDriverSupport(support) {\n if (DefinedDrivers[driverName]) {\n console.info('Redefining LocalForage driver: ' + driverName);\n }\n DefinedDrivers[driverName] = driverObject;\n DriverSupport[driverName] = support;\n // don't use a then, so that we can define\n // drivers that have simple _support methods\n // in a blocking manner\n resolve();\n };\n\n if ('_support' in driverObject) {\n if (driverObject._support && typeof driverObject._support === 'function') {\n driverObject._support().then(setDriverSupport, reject);\n } else {\n setDriverSupport(!!driverObject._support);\n }\n } else {\n setDriverSupport(true);\n }\n } catch (e) {\n reject(e);\n }\n });\n\n executeTwoCallbacks(promise, callback, errorCallback);\n return promise;\n };\n\n LocalForage.prototype.driver = function driver() {\n return this._driver || null;\n };\n\n LocalForage.prototype.getDriver = function getDriver(driverName, callback, errorCallback) {\n var getDriverPromise = DefinedDrivers[driverName] ? Promise$1.resolve(DefinedDrivers[driverName]) : Promise$1.reject(new Error('Driver not found.'));\n\n executeTwoCallbacks(getDriverPromise, callback, errorCallback);\n return getDriverPromise;\n };\n\n LocalForage.prototype.getSerializer = function getSerializer(callback) {\n var serializerPromise = Promise$1.resolve(localforageSerializer);\n executeTwoCallbacks(serializerPromise, callback);\n return serializerPromise;\n };\n\n LocalForage.prototype.ready = function ready(callback) {\n var self = this;\n\n var promise = self._driverSet.then(function () {\n if (self._ready === null) {\n self._ready = self._initDriver();\n }\n\n return self._ready;\n });\n\n executeTwoCallbacks(promise, callback, callback);\n return promise;\n };\n\n LocalForage.prototype.setDriver = function setDriver(drivers, callback, errorCallback) {\n var self = this;\n\n if (!isArray(drivers)) {\n drivers = [drivers];\n }\n\n var supportedDrivers = this._getSupportedDrivers(drivers);\n\n function setDriverToConfig() {\n self._config.driver = self.driver();\n }\n\n function extendSelfWithDriver(driver) {\n self._extend(driver);\n setDriverToConfig();\n\n self._ready = self._initStorage(self._config);\n return self._ready;\n }\n\n function initDriver(supportedDrivers) {\n return function () {\n var currentDriverIndex = 0;\n\n function driverPromiseLoop() {\n while (currentDriverIndex < supportedDrivers.length) {\n var driverName = supportedDrivers[currentDriverIndex];\n currentDriverIndex++;\n\n self._dbInfo = null;\n self._ready = null;\n\n return self.getDriver(driverName).then(extendSelfWithDriver)[\"catch\"](driverPromiseLoop);\n }\n\n setDriverToConfig();\n var error = new Error('No available storage method found.');\n self._driverSet = Promise$1.reject(error);\n return self._driverSet;\n }\n\n return driverPromiseLoop();\n };\n }\n\n // There might be a driver initialization in progress\n // so wait for it to finish in order to avoid a possible\n // race condition to set _dbInfo\n var oldDriverSetDone = this._driverSet !== null ? this._driverSet[\"catch\"](function () {\n return Promise$1.resolve();\n }) : Promise$1.resolve();\n\n this._driverSet = oldDriverSetDone.then(function () {\n var driverName = supportedDrivers[0];\n self._dbInfo = null;\n self._ready = null;\n\n return self.getDriver(driverName).then(function (driver) {\n self._driver = driver._driver;\n setDriverToConfig();\n self._wrapLibraryMethodsWithReady();\n self._initDriver = initDriver(supportedDrivers);\n });\n })[\"catch\"](function () {\n setDriverToConfig();\n var error = new Error('No available storage method found.');\n self._driverSet = Promise$1.reject(error);\n return self._driverSet;\n });\n\n executeTwoCallbacks(this._driverSet, callback, errorCallback);\n return this._driverSet;\n };\n\n LocalForage.prototype.supports = function supports(driverName) {\n return !!DriverSupport[driverName];\n };\n\n LocalForage.prototype._extend = function _extend(libraryMethodsAndProperties) {\n extend(this, libraryMethodsAndProperties);\n };\n\n LocalForage.prototype._getSupportedDrivers = function _getSupportedDrivers(drivers) {\n var supportedDrivers = [];\n for (var i = 0, len = drivers.length; i < len; i++) {\n var driverName = drivers[i];\n if (this.supports(driverName)) {\n supportedDrivers.push(driverName);\n }\n }\n return supportedDrivers;\n };\n\n LocalForage.prototype._wrapLibraryMethodsWithReady = function _wrapLibraryMethodsWithReady() {\n // Add a stub for each driver API method that delays the call to the\n // corresponding driver method until localForage is ready. These stubs\n // will be replaced by the driver methods as soon as the driver is\n // loaded, so there is no performance impact.\n for (var i = 0, len = LibraryMethods.length; i < len; i++) {\n callWhenReady(this, LibraryMethods[i]);\n }\n };\n\n LocalForage.prototype.createInstance = function createInstance(options) {\n return new LocalForage(options);\n };\n\n return LocalForage;\n}();\n\n// The actual localForage object that we expose as a module or via a\n// global. It's extended by pulling in one of our other libraries.\n\n\nvar localforage_js = new LocalForage();\n\nmodule.exports = localforage_js;\n\n},{\"3\":3}]},{},[4])(4)\n});\n","/**\r\n * localforage key under which the service worker leaves a precache failure for the page to report.\r\n *\r\n * Shared through this module rather than exported from BSBIServiceWorker, so that the app can read it\r\n * without bundling the worker.\r\n *\r\n * A worker cannot report its own precache failures: they are usually network failures, so anything needing\r\n * the network is the least likely to get through, and LogBuffer is no help because it uses localStorage,\r\n * which a service worker does not have. So the worker records and the page reports - the same arrangement\r\n * as the start-up stall record in index.html, for the same reason.\r\n *\r\n * @type {string}\r\n */\r\nexport const PRECACHE_FAILURE_KEY = 'bsbiPrecacheFailure';\r\n\r\nexport const PROJECT_ID_PLANT_ALERT = 1;\r\nexport const PROJECT_ID_NYPH = 2;\r\nexport const PROJECT_ID_RECORDING_APP = 4;\r\nexport const PROJECT_ID_SCM = 5;\r\nexport const PROJECT_ID_PHENOLOGY = 6;\r\n\r\n/**\r\n * Mixed records typed in from previously collated lists, entered through a tabular full-width form\r\n * rather than one record at a time.\r\n *\r\n * The back end accepts this id and echoes records back, but does not yet process it distinctly.\r\n *\r\n * @type {number}\r\n */\r\nexport const PROJECT_ID_TRANSCRIPTION = 7;\r\n\r\nexport const GEOREF_SOURCE_UNKNOWN = 'unknown';\r\nexport const GEOREF_SOURCE_GRIDREF = 'gridref';\r\nexport const GEOREF_SOURCE_MAP = 'map';\r\nexport const GEOREF_SOURCE_GPS = 'gps';\r\n\r\n/**\r\n * based on a geocoded postcode\r\n * @type {string}\r\n */\r\nexport const GEOREF_SOURCE_POSTCODE = 'postcode';\r\n\r\n/**\r\n * based on a geocoded placename\r\n * @type {string}\r\n */\r\nexport const GEOREF_SOURCE_PLACE = 'place';\r\n\r\n/**\r\n * centre-point of a polygon area\r\n * @type {string}\r\n */\r\nexport const GEOREF_SOURCE_AREA = 'area';\r\n\r\nexport const GEOREF_TYPE_SQUARE = 's';\r\nexport const GEOREF_TYPE_CENTROID = 'p';\r\nexport const GEOREF_TYPE_UNKNOWN = undefined;\r\n\r\nexport const SAVE_STATE_LOCAL = 'SAVED_LOCALLY';\r\nexport const SAVE_STATE_SERVER = 'SAVED_TO_SERVER';","import {SAVE_STATE_LOCAL} from \"../../utils/constants\";\r\n\r\nexport class ResponseFactory {\r\n static responses = {};\r\n\r\n /**\r\n *\r\n * @param {FormData} formData\r\n * @returns {LocalResponse}\r\n * @throws {Error}\r\n */\r\n static fromPostedData(formData) {\r\n /**\r\n * the object that will be saved to IndexedDb\r\n *\r\n * this needs to be in scope for several stages of the promise chain\r\n * @type {{[saved]: string, [type]: string, [imageId]: string, [surveyId]: string, [occurrenceId]: string, [image]: file, [projectId]: number, saveState: string }}\r\n */\r\n const toSaveLocally = {\r\n saveState: SAVE_STATE_LOCAL // mark as not saved externally\r\n };\r\n\r\n for(let pair of formData.entries()) {\r\n toSaveLocally[pair[0]] = pair[1];\r\n }\r\n\r\n if (!toSaveLocally.type) {\r\n throw new Error('Missing type in form data.');\r\n }\r\n\r\n if (ResponseFactory.responses.hasOwnProperty(toSaveLocally.type)) {\r\n return new ResponseFactory.responses[toSaveLocally.type](toSaveLocally, {});\r\n } else {\r\n throw new Error(`Unrecognised post type '${toSaveLocally.type}'`);\r\n }\r\n }\r\n\r\n /**\r\n *\r\n * @param {{}} modelData the object that will be saved to IndexedDb\r\n * @returns {LocalResponse}\r\n * @throws {Error}\r\n */\r\n static fromModelData(modelData) {\r\n modelData.saveState = SAVE_STATE_LOCAL;\r\n\r\n if (!modelData.type) {\r\n throw new Error('Missing type in model data.');\r\n }\r\n\r\n if (ResponseFactory.responses.hasOwnProperty(modelData.type)) {\r\n return new ResponseFactory.responses[modelData.type](modelData, {});\r\n } else {\r\n throw new Error(`Unrecognised post type '${modelData.type}'`);\r\n }\r\n }\r\n\r\n /**\r\n *\r\n * @returns {LocalResponse} returnedToClient\r\n */\r\n static fromPostResponse(returnedToClient) {\r\n if (!returnedToClient) {\r\n throw new Error('Invalid empty post response.');\r\n }\r\n\r\n if (!returnedToClient.type) {\r\n throw new Error('Missing type in returned response.');\r\n }\r\n\r\n if (ResponseFactory.responses.hasOwnProperty(returnedToClient.type)) {\r\n //console.log(`in fromPostResponse returning a ${returnedToClient.type}`);\r\n return new ResponseFactory.responses[returnedToClient.type]({}, returnedToClient);\r\n } else {\r\n throw new Error(`Unrecognised post type '${returnedToClient.type}'`);\r\n }\r\n }\r\n}\r\n","/**\r\n * How a backlog of unsaved occurrences is divided into batch posts, and how the replies are matched back.\r\n *\r\n * A transcriber working offline may enter several thousand records. Draining them one request at a time\r\n * costs a round trip and a full server bootstrap each, so sync sends them in batches instead. The rules for\r\n * doing that safely are here rather than in `App._syncLocalUnsaved`, and this file is importless by\r\n * construction so that node can test them - the same arrangement as `flexibleDate.js` for dates and\r\n * `georefValidity.js` for grid references.\r\n *\r\n * **Every rule below fails silently.** A record grouped under the wrong survey, a batch that quietly loses\r\n * its tail, or - worst - a reply matched to the wrong record, all leave a sync that appears to have\r\n * succeeded. The last of those would write one record's authoritative timestamps onto another and mark a\r\n * record saved that was never sent, which is data loss that no error would announce. So they are settled\r\n * here, against `scripts/testSyncBatching.mjs`, rather than by watching a sync go past on screen.\r\n *\r\n * What is deliberately *not* here: anything that needs a model, local storage or the network. This module\r\n * is handed plain descriptors and hands back plain instructions.\r\n */\r\n\r\n/**\r\n * The most records that may go in one post.\r\n *\r\n * Not a tuning knob so much as a ceiling. The server bounds the same number independently and rejects\r\n * anything larger rather than truncating it, because a truncated batch answered with a success would read\r\n * to the client as every record saved.\r\n *\r\n * @type {number}\r\n */\r\nexport const MAX_BATCH_SIZE = 100;\r\n\r\n/**\r\n * Why a record has to be posted on its own rather than in a batch.\r\n *\r\n * @type {string}\r\n */\r\nexport const SINGLE_REASON_UNCONFIRMED_SURVEY = 'unconfirmedSurvey';\r\n\r\n/**\r\n * @param {*} value\r\n * @returns {number}\r\n */\r\nfunction batchLimit(value) {\r\n const limit = Math.floor(Number(value));\r\n\r\n return limit > 0 ? Math.min(limit, MAX_BATCH_SIZE) : MAX_BATCH_SIZE;\r\n}\r\n\r\n/**\r\n * The records that still need posting, out of everything local storage holds.\r\n *\r\n * **This has to happen before planBatches(), not after.** The sync walk hands over every stored occurrence,\r\n * saved or not - seekKeys() is a key-only pass with no notion of saved state. Planning that list cuts the\r\n * batch windows across the whole survey and leaves the records that actually need sending scattered between\r\n * them: five edits in one survey went out as four posts of 1, 1, 2, 1, one for each hundred-record window an\r\n * edit happened to fall in. Every record saved and nothing reported an error; batching had simply stopped\r\n * batching. The cap suffers the same way, bounding the records *considered* for a request rather than the\r\n * records in one.\r\n *\r\n * The state string is a parameter because this file has to stay importless and cannot see SAVE_STATE_SERVER\r\n * - the same arrangement as parseGridRef in georefValidity.\r\n *\r\n * Model._parseSavedState() is what makes the cheap descriptor an exact answer rather than a guess: a stored\r\n * record is always _savedLocally, and savedRemotely is precisely saveState === SAVE_STATE_SERVER. So this\r\n * drops exactly the records that Model.unsaved() would have rejected, and no others.\r\n *\r\n * Anything unrecognised is kept. Over-inclusive costs a wasted place in a request; under-inclusive silently\r\n * abandons work the user did.\r\n *\r\n * @param {Array<{saveState?: string}>} descriptors\r\n * @param {string} savedToServerState the saveState meaning \"already on the server\"\r\n * @returns {Array}\r\n */\r\nexport function selectUnsavedDescriptors(descriptors, savedToServerState) {\r\n if (!savedToServerState) {\r\n // Without knowing which state means saved, nothing can be ruled out.\r\n return descriptors ? [...descriptors] : [];\r\n }\r\n\r\n return (descriptors || []).filter((descriptor) => descriptor?.saveState !== savedToServerState);\r\n}\r\n\r\n/**\r\n * Divides records into the posts that should be made for them, in order.\r\n *\r\n * Two things decide the division:\r\n *\r\n * - **A record whose survey is not confirmed on the server goes on its own.** `SaveOccurrenceController`\r\n * invents a placeholder survey when an occurrence names one the server has never seen, and several\r\n * occurrences arriving together for the same unseen survey would each try to invent it. Sync saves\r\n * surveys as a phase before occurrences, so this is normally moot; sending the first ones singly makes\r\n * that ordering a guarantee rather than an accident of scheduling.\r\n * - **Records are never mixed across surveys in one post**, even though the server would accept it. It\r\n * keeps a failed batch attributable to one survey, and it keeps this function's output readable when\r\n * something has gone wrong in the field.\r\n *\r\n * Order is preserved throughout: records come out in the order they went in, and so do the batches. Sync\r\n * walks storage in key order and a reordering here would make a failure impossible to correlate with a\r\n * log.\r\n *\r\n * @param {Array<{id: string, surveyId?: string}>} records\r\n * @param {{confirmedSurveyIds?: (Set|Array), maxBatchSize?: number}} [options]\r\n * `confirmedSurveyIds` are the surveys known to be on the server already. Anything absent from it is\r\n * treated as unconfirmed, so an omitted set means every record goes singly - which is slow but never\r\n * wrong, and is the right way round for a default.\r\n * @returns {Array<{records: Array, single: boolean, [reason]: string, [surveyId]: string}>}\r\n */\r\nexport function planBatches(records, options) {\r\n const {confirmedSurveyIds = null, maxBatchSize = MAX_BATCH_SIZE} = options || {};\r\n\r\n const limit = batchLimit(maxBatchSize);\r\n\r\n const confirmed = confirmedSurveyIds instanceof Set ?\r\n confirmedSurveyIds :\r\n new Set(Array.isArray(confirmedSurveyIds) ? confirmedSurveyIds : []);\r\n\r\n /**\r\n * @type {Array<{records: Array, single: boolean, [reason]: string, [surveyId]: string}>}\r\n */\r\n const posts = [];\r\n\r\n /**\r\n * The batch currently being filled, and the survey it belongs to. Held rather than looked up from the\r\n * tail of `posts`, so that a single post landing between two batches of the same survey starts a fresh\r\n * batch instead of reopening a closed one.\r\n *\r\n * @type {{records: Array, single: boolean, surveyId: string}|null}\r\n */\r\n let open = null;\r\n\r\n for (const record of records || []) {\r\n if (!record || !record.id) {\r\n // Not silently dropped as a convenience: a record with no id cannot be matched to a reply, so\r\n // it could never be marked saved and would be retried for ever. Skipping it here at least keeps\r\n // it out of a batch it would corrupt.\r\n continue;\r\n }\r\n\r\n const surveyId = record.surveyId || '';\r\n\r\n if (!surveyId || !confirmed.has(surveyId)) {\r\n open = null;\r\n posts.push({\r\n records: [record],\r\n single: true,\r\n reason: SINGLE_REASON_UNCONFIRMED_SURVEY,\r\n surveyId,\r\n });\r\n continue;\r\n }\r\n\r\n if (!open || open.surveyId !== surveyId || open.records.length >= limit) {\r\n open = {records: [], single: false, surveyId};\r\n posts.push(open);\r\n }\r\n\r\n open.records.push(record);\r\n }\r\n\r\n return posts;\r\n}\r\n\r\n/**\r\n * The smallest batch worth compressing, in bytes of JSON.\r\n *\r\n * Below this the ratio does not pay for a second code path: one record is about 1.0 kB and gzips to 0.6,\r\n * where a hundred is about 120 kB and gzips to between 4 and 10. Sixteen kilobytes is roughly thirteen\r\n * records, which keeps the ordinary online case - a handful of records, sent promptly - on exactly the\r\n * route that is already working.\r\n *\r\n * @type {number}\r\n */\r\nexport const MIN_COMPRESSED_BATCH_BYTES = 16 * 1024;\r\n\r\n/**\r\n * Whether a batch of this size should be sent compressed.\r\n *\r\n * Compression is worth having only on a poor uplink, which is where the field use case lives. Measured on\r\n * the real record shape: a hundred records is about 120 kB, which is ten seconds at 100 kbit and under one\r\n * compressed - but half a second against three hundredths on ordinary 4G. So this is deliberately\r\n * conservative. It is an optimisation for a minority of syncs, and every request it diverts onto the newer\r\n * path is a request that was working before.\r\n *\r\n * `supported` is passed in rather than tested here, because CompressionStream is a DOM API and this file\r\n * has to stay importless - the same reason parseGridRef is injected into georefValidity. An unsupported\r\n * browser never compresses, whatever the size; iOS only gained CompressionStream in 16.4.\r\n *\r\n * @param {{byteLength?: number, threshold?: number, supported?: boolean}} params\r\n * @returns {boolean}\r\n */\r\nexport function shouldCompressBatch(params) {\r\n const {byteLength = 0, threshold = MIN_COMPRESSED_BATCH_BYTES, supported = false} = params || {};\r\n\r\n if (!supported) {\r\n return false;\r\n }\r\n\r\n return byteLength >= (threshold > 0 ? threshold : MIN_COMPRESSED_BATCH_BYTES);\r\n}\r\n\r\n/**\r\n * Matches a batch reply onto the records that were sent.\r\n *\r\n * **Matched by id, never by position.** The server is free to answer in any order, to omit a record it\r\n * could not process, or to answer about something that was not asked for; position-matching would survive\r\n * every one of those in testing and then write one record's `created`/`modified` stamps onto another\r\n * record on the day the server changed. That is silent, permanent, and indistinguishable from a successful\r\n * save, which is why this function exists at all rather than the caller zipping two arrays together.\r\n *\r\n * A record that got no reply is returned in `missing`, and the caller must leave it unsaved so the next\r\n * sync retries it. A reply naming something that was not sent is returned in `unexpected` and applied to\r\n * nothing.\r\n *\r\n * @param {Array<{id: string}>} records as sent\r\n * @param {Array<{id?: string, occurrenceId?: string}>} replies\r\n * @returns {{\r\n * matched: Array<{record: Object, reply: Object}>,\r\n * missing: Array,\r\n * unexpected: Array,\r\n * duplicated: Array\r\n * }}\r\n */\r\nexport function matchReplies(records, replies) {\r\n const sent = new Map();\r\n\r\n for (const record of records || []) {\r\n if (record && record.id) {\r\n sent.set(record.id, record);\r\n }\r\n }\r\n\r\n /**\r\n * @type {Map}\r\n */\r\n const answered = new Map();\r\n\r\n /**\r\n * Ids the server answered about more than once. The first reply wins, because a later one cannot be\r\n * known to be better and silently preferring it would make the outcome depend on reply order - the\r\n * very thing matching by id is here to avoid.\r\n *\r\n * @type {Array}\r\n */\r\n const duplicated = [];\r\n\r\n /**\r\n * @type {Array}\r\n */\r\n const unexpected = [];\r\n\r\n for (const reply of replies || []) {\r\n const id = reply?.id || reply?.occurrenceId || '';\r\n\r\n if (!id || !sent.has(id)) {\r\n unexpected.push(reply);\r\n continue;\r\n }\r\n\r\n if (answered.has(id)) {\r\n duplicated.push(id);\r\n continue;\r\n }\r\n\r\n answered.set(id, reply);\r\n }\r\n\r\n /**\r\n * @type {Array<{record: Object, reply: Object}>}\r\n */\r\n const matched = [];\r\n\r\n /**\r\n * @type {Array}\r\n */\r\n const missing = [];\r\n\r\n // Walked in send order rather than reply order, so that the caller applies results in the order it\r\n // knows about and a partial application is a prefix rather than a scatter.\r\n for (const record of records || []) {\r\n if (!record || !record.id) {\r\n continue;\r\n }\r\n\r\n const reply = answered.get(record.id);\r\n\r\n if (reply) {\r\n matched.push({record, reply});\r\n } else {\r\n missing.push(record);\r\n }\r\n }\r\n\r\n return {matched, missing, unexpected, duplicated};\r\n}\r\n\r\n/**\r\n * A one-line summary of what a drain did, for the log.\r\n *\r\n * Built here so that the shape is fixed and testable rather than assembled inline at the call site, and\r\n * deliberately free of record ids: `LogBuffer` coalesces entries by message, so an id would make every\r\n * line unique and a large failing sync would evict everything else worth keeping.\r\n *\r\n * @param {{records?: number, posts?: number, failures?: number, elapsedMs?: number}} counts\r\n * @returns {string}\r\n */\r\nexport function describeDrain(counts) {\r\n const {records = 0, posts = 0, failures = 0, elapsedMs = 0} = counts || {};\r\n\r\n const seconds = Math.round(elapsedMs / 100) / 10;\r\n const perRecord = records > 0 ? Math.round(elapsedMs / records) : 0;\r\n\r\n return `Sync drain: ${records} record(s) in ${posts} post(s), ${failures} failure(s),`\r\n + ` ${seconds}s total, ${perRecord}ms/record.`;\r\n}\r\n","import {EventHarness} from \"../framework/EventHarness\";\r\nimport localforage from 'localforage';\r\nimport {Logger} from \"../utils/Logger\";\r\nimport {ResponseFactory} from \"../serviceworker/responses/ResponseFactory.js\";\r\nimport {SAVE_STATE_LOCAL, SAVE_STATE_SERVER} from \"../utils/constants\";\r\nimport {matchReplies, shouldCompressBatch} from \"../utils/syncBatching\";\r\n\r\n/**\r\n * @typedef {import('bsbi-app-framework-view').FormField} FormField\r\n */\r\n\r\n/**\r\n *\r\n * @param {number} [a]\r\n * @returns {string}\r\n */\r\nexport function uuid(a){return a?(a^Math.random()*16>>a/4).toString(16):([1e7]+-1e3+-4e3+-8e3+-1e11).replace(/[018]/g,uuid)}\r\n\r\n/**\r\n * regex used to validate AppObject external ids\r\n * (UUID form is 8 digits followed by three groups of 4 digits followed by a group of 12)\r\n */\r\nexport const UUID_REGEX = /^[a-fA-F0-9]{8}-(?:[a-fA-F0-9]{4}-){3}[a-fA-F0-9]{12}$/;\r\n\r\n//export const SAVE_STATE_LOCAL = 'SAVED_LOCALLY';\r\n//export const SAVE_STATE_SERVER = 'SAVED_TO_SERVER';\r\n\r\nexport const MODEL_EVENT_SAVED_REMOTELY = 'savedremotely';\r\n\r\nexport const MODEL_EVENT_DESTROYED = 'destroyed';\r\n\r\nexport class Model extends EventHarness {\r\n /**\r\n * @type {string}\r\n */\r\n _id = '';\r\n\r\n /**\r\n * set if the object has been posted to the server\r\n *\r\n * @type {boolean}\r\n */\r\n _savedRemotely = false;\r\n\r\n // static EVENT_SAVED_REMOTELY = MODEL_EVENT_SAVED_REMOTELY;\r\n\r\n static bsbiAppVersion = '';\r\n\r\n /**\r\n * Deadline (in milliseconds) applied to a save post, covering the whole request\r\n * including reading the response body.\r\n *\r\n * Without this a stalled connection blocks indefinitely, as fetch() has no default timeout.\r\n * A fully broken connection fails quickly, but a captive portal, or mobile data with a live\r\n * radio but no throughput, can accept the connection and then hang, jamming the serial post\r\n * queue behind it.\r\n *\r\n * Set to 0 to disable.\r\n *\r\n * @type {number}\r\n */\r\n static SAVE_POST_TIMEOUT_MS = 30000;\r\n\r\n /**\r\n * mirrors constructor.name but doesn't get mangled by minification\r\n *\r\n * @type {string}\r\n */\r\n static className = 'Model';\r\n\r\n attributes = {};\r\n\r\n /**\r\n * ms stamp of last queued change\r\n * set when a post is queued\r\n * @type {number}\r\n */\r\n lastQueuedPostAbsoluteStamp = 0;\r\n\r\n /**\r\n * ms stamp of last save snapshot\r\n * set when form data is prepared for saving\r\n * @type {number}\r\n */\r\n saveSnapshotAbsoluteStamp = 0;\r\n\r\n /**\r\n * The state of the modified token at the point of the last save\r\n * (a fine-grained way to catch changes between starting a post and marking the result as saved)\r\n * (ms timestamps may be too course for this)\r\n *\r\n * @type {number}\r\n */\r\n saveSnapshotModifiedToken;\r\n\r\n /**\r\n * Random number set whenever the model is touched\r\n *\r\n * @type {number}\r\n */\r\n modifiedToken;\r\n\r\n saveSnapshotStamp = 0;\r\n\r\n /**\r\n * @type {string|undefined}\r\n */\r\n userId;\r\n\r\n /**\r\n * @return {string}\r\n */\r\n get localKey() {\r\n return `${this.TYPE}.${this.id}`;\r\n }\r\n\r\n /**\r\n *\r\n * @param {boolean} savedFlag\r\n */\r\n set savedRemotely(savedFlag) {\r\n if (this._savedRemotely !== savedFlag) {\r\n this._savedRemotely = !!savedFlag;\r\n\r\n if (this._savedRemotely) {\r\n this.fireEvent(MODEL_EVENT_SAVED_REMOTELY, {id : this.id});\r\n }\r\n }\r\n }\r\n\r\n /**\r\n *\r\n * @returns {boolean}\r\n */\r\n get savedRemotely() {\r\n return this._savedRemotely;\r\n }\r\n\r\n /**\r\n * set if the object has been added to a temporary store (e.g. indexedDb)\r\n *\r\n * @type {boolean}\r\n */\r\n _savedLocally = false;\r\n\r\n /**\r\n *\r\n * @type {boolean}\r\n */\r\n deleted = false;\r\n\r\n /**\r\n * unix timestamp (seconds since epoch)\r\n * Provided that the created stamp is < the modified stamp then the externally assigned creation stamp will be used\r\n *\r\n * @type {number}\r\n */\r\n createdStamp;\r\n\r\n /**\r\n * unix timestamp (seconds since epoch)\r\n * modified stamp is generally server assigned - rather than using a potentially discrepant client clock,\r\n * this may increase synchrony and trust between distributed clients\r\n *\r\n * @type {number}\r\n */\r\n modifiedStamp;\r\n\r\n /**\r\n * DDb AppProject id\r\n *\r\n * @type {number}\r\n */\r\n projectId;\r\n\r\n /**\r\n * paired with isNew this marks objects that have never been edited\r\n *\r\n * @type {boolean}\r\n */\r\n isPristine = false;\r\n\r\n constructor() {\r\n super();\r\n\r\n this.createdStamp = Math.floor(Date.now() / 1000);\r\n this.modifiedStamp = this.createdStamp;\r\n }\r\n\r\n /**\r\n * returns true if either remote or local copy is missing\r\n *\r\n * @returns {boolean}\r\n */\r\n unsaved() {\r\n return !(this._savedLocally && this._savedRemotely);\r\n }\r\n\r\n /**\r\n * string\r\n */\r\n get id() {\r\n if (!this._id) {\r\n this._id = uuid();\r\n } else if (this._id === 'undefined') {\r\n console.error(\"id is literal 'undefined', am forcing new id\");\r\n this._id = uuid();\r\n }\r\n\r\n return this._id;\r\n }\r\n\r\n /**\r\n *\r\n * @param {string} newId\r\n */\r\n set id(newId) {\r\n\r\n if (!newId?.match?.(UUID_REGEX)) {\r\n throw new Error(`Cannot set malformed object id '${newId}'.`);\r\n } else {\r\n // only allow an id to be set if not present already\r\n\r\n if (this._id && newId !== this._id) {\r\n throw new Error(`Object id has already been set, when trying to set new id '${newId}'.`);\r\n }\r\n this._id = newId;\r\n }\r\n }\r\n\r\n /**\r\n *\r\n * @abstract\r\n * @param {boolean} forceSave\r\n * @param {boolean} [isSync]\r\n * @param {{[surveyId] : string, [projectId] : number|null, [occurrenceId] : string}} [params]\r\n *\r\n * @returns {Promise}\r\n */\r\n save(forceSave = false, isSync = false, params) {}\r\n\r\n /**\r\n * Persist to local storage immediately, then queue a remote post that is deliberately *not* awaited.\r\n *\r\n * The returned promise settles once the object is durable on this device. The remote save\r\n * continues in the background and announces itself through MODEL_EVENT_SAVED_REMOTELY.\r\n *\r\n * The local write is kept off Model._tasks on purpose. That queue exists to order *server*\r\n * requests (survey before occurrence before image); local storage has no such dependency, as\r\n * records are independent keyed puts. Leaving the local write in the queue meant that the\r\n * hundredth record could not reach IndexedDb until the first record's post had settled, so a\r\n * single stalled request put a whole session's work at risk.\r\n *\r\n * @protected\r\n * @param {boolean} isSync set if this is part of a sync-all rather than a regular save\r\n * @returns {Promise}\r\n */\r\n _saveLocalThenQueuePost(isSync = false) {\r\n if (isSync) {\r\n // Sync only ever runs over objects that are already in local storage, so there is\r\n // nothing to pre-write. The caller (App._syncLocalUnsaved) also needs to know the\r\n // outcome of the *remote* save, so the queued post stays awaited here.\r\n return this.queuePost(true);\r\n }\r\n\r\n return this._storeLocallyRecordingOutcome()\r\n .then((localFailure) => {\r\n // Known to be offline: don't queue a post that cannot succeed.\r\n //\r\n // navigator.onLine is only trustworthy in this direction - false means there is\r\n // definitely no connection, whereas true means very little - and reading it is free,\r\n // as it is a cached flag rather than any kind of probe.\r\n //\r\n // Skipping is safe because the record is already in local storage and App.syncAll()\r\n // finds it there by enumerating keys, prompted by the 'online' event. Queuing anyway\r\n // would occupy a slot in the serial post queue, start a fetch and its abort timer,\r\n // and log a failure - per record. Someone entering hundreds of records out of signal\r\n // would fill the offline log buffer with those failures alone.\r\n //\r\n // If the local write failed, post regardless: local storage is then the one place\r\n // the record is not, so even a long-odds attempt is worth making.\r\n if (localFailure || globalThis.navigator?.onLine !== false) {\r\n this.queuePost(false)\r\n .catch((reason) => {\r\n // @intentional Remote failure is routine when offline. The object keeps savedRemotely false\r\n // and will be retried by App.syncAll() from local storage.\r\n console.info(`Deferred remote save pending for ${this.constructor.className} id ${this.id}: ${Logger.stringifyObject(reason)}`);\r\n });\r\n } else {\r\n console.info(`Offline, so deferring the remote save of ${this.constructor.className} id ${this.id} to the next sync.`);\r\n }\r\n\r\n if (localFailure) {\r\n return Promise.reject(localFailure);\r\n }\r\n });\r\n }\r\n\r\n /**\r\n * Whether a server response that has been superseded locally should still be written to local\r\n * storage.\r\n *\r\n * True for every record type where the server can hold the more recent version. A record\r\n * created on this device offline may have been edited elsewhere before the device got back into\r\n * signal, and the user does not want that later work discarded; the response is the route by\r\n * which it reaches the device. The snapshot tests are what protect a record the user is\r\n * actively editing, and they act on the in-memory object rather than here.\r\n *\r\n * Track overrides this: for tracking, the device is always the source of truth, and the points\r\n * only ever grow, so a superseded response can only be an older prefix of what is already held.\r\n *\r\n * @protected\r\n * @returns {boolean}\r\n */\r\n _mirrorSupersededResponseLocally() {\r\n return true;\r\n }\r\n\r\n /**\r\n * Writes the record to local storage, recording the outcome on the object.\r\n *\r\n * Split out of _saveLocalThenQueuePost() so that a subclass can make the record durable on the\r\n * device without committing to an immediate post - see Track, which writes locally on every\r\n * position ping but coalesces the posts.\r\n *\r\n * Resolves rather than rejects on failure, because both callers need to carry on and decide\r\n * what to do about the remote save before the failure is reported.\r\n *\r\n * @protected\r\n * @returns {Promise<*|null>} the local failure reason, or null if the write succeeded\r\n */\r\n _storeLocallyRecordingOutcome() {\r\n // Promise.resolve().then() so that a synchronous throw from storeLocally() (the localKey\r\n // getters throw on incomplete objects) surfaces as a rejection rather than escaping save().\r\n return Promise.resolve()\r\n .then(() => this.storeLocally())\r\n .then(\r\n () => {\r\n this._savedLocally = true;\r\n return null;\r\n },\r\n (reason) => {\r\n // Now that local storage is written first, this is the only step that can lose\r\n // the user's work outright, so it must be surfaced rather than swallowed.\r\n // @intentional continue after failure, so that server post is still tried, before the promise rejects later\r\n\r\n this._savedLocally = false;\r\n\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logError(`Failed to save ${this.constructor.className} id ${this.id} locally: ${Logger.stringifyObject(reason)}`);\r\n\r\n return reason;\r\n }\r\n );\r\n }\r\n\r\n /**\r\n *\r\n * @type {Array}\r\n * @private\r\n */\r\n static _tasks = [];\r\n\r\n /**\r\n * @param {number} modifiedStampWhenQueued\r\n * @returns {boolean}\r\n * @protected\r\n */\r\n _cannotSkipAsObsolete(modifiedStampWhenQueued) {\r\n return true;\r\n }\r\n\r\n /**\r\n * Add a post request to the queue\r\n * Requests run in sequence.\r\n * Returns a promise that resolves once the queued request completes\r\n *\r\n * The queue reduces the chance of requests being sent to the server out-of-order (which can lead to race conditions)\r\n *\r\n * @param {boolean} isSync default false, set if request is part of sync all rather than a regular save\r\n * @returns {Promise}\r\n */\r\n queuePost(isSync = false) {\r\n const modifiedStampWhenQueued = this.modifiedStamp;\r\n this.lastQueuedPostAbsoluteStamp = Date.now();\r\n\r\n return new Promise((resolve, reject) => {\r\n /**\r\n * @returns {Promise}\r\n */\r\n const task = () => {\r\n\r\n try {\r\n if (isSync || this._cannotSkipAsObsolete(modifiedStampWhenQueued)) {\r\n this.saveSnapshotAbsoluteStamp = Date.now();\r\n this.saveSnapshotModifiedToken = this.modifiedToken;\r\n this.saveSnapshotStamp = Math.floor(this.saveSnapshotAbsoluteStamp / 1000); // any new changes from this point on will be saved without skipping\r\n\r\n //console.log({'posting form data': formData});\r\n return this._post(this.formData(), isSync)\r\n .catch((reason) => {\r\n // The object id is deliberately kept out of the message and passed as\r\n // context instead. LogBuffer coalesces repeats by message and stack,\r\n // so an id in the message would make every failure unique - and a\r\n // user saving hundreds of records against a dead connection would\r\n // fill the whole offline log buffer with them, evicting the entries\r\n // worth having.\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logError(\r\n `Failed to post ${this.constructor.className}, isSync: ${isSync ? 'true' : 'false'}: '${Logger.stringifyObject(reason)}'`,\r\n '', '', null, null,\r\n {objectId: this.id}\r\n );\r\n\r\n return Promise.reject(reason);\r\n })\r\n .then((result) => resolve(result), (reason) => reject(reason));\r\n } else {\r\n console.log(`Skipped queued save as superseded, for ${this.constructor.className} id ${this.id}`);\r\n resolve(`Skipped queued save as superseded.`);\r\n return Promise.resolve();\r\n }\r\n } catch (error) {\r\n // should never get here\r\n // this is an emergency catch to ensure that resolve or reject is always called so that the queue does not jamb\r\n\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logError(`Catch in queue post outer loop: ${Logger.stringifyObject(error)}`);\r\n reject(`Catch in queuepost outer loop: ${Logger.stringifyObject(error)}`);\r\n return Promise.reject(error);\r\n }\r\n };\r\n\r\n Model._tasks.push(task);\r\n\r\n if (Model._tasks.length > 1) {\r\n console.log(`Added post request to the queue.`);\r\n } else {\r\n console.log(`No pending tasks, starting post request immediately.`);\r\n\r\n try {\r\n task().finally(() => {\r\n Model._next();\r\n // @intentional end of immediate local promise chain\r\n });\r\n } catch (error) {\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logError(`Catch in queuePost. ${Logger.stringifyObject(error)}`);\r\n Model._next();\r\n }\r\n }\r\n });\r\n }\r\n\r\n // /**\r\n // * Post immediately (no queue).\r\n // * Returns a promise that resolves once the POST request completes.\r\n // *\r\n // * @param {boolean} isSync default false, set if request is part of sync all rather than a regular save\r\n // * @returns {Promise}\r\n // */\r\n // postImmediately(isSync = false) {\r\n // const modifiedStampWhenQueued = this.modifiedStamp;\r\n // this.lastQueuedPostAbsoluteStamp = Date.now();\r\n //\r\n // return new Promise((resolve, reject) => {\r\n // if (isSync || this._cannotSkipAsObsolete(modifiedStampWhenQueued)) {\r\n // this.saveSnapshotAbsoluteStamp = Date.now();\r\n // this.saveSnapshotModifiedToken = this.modifiedToken;\r\n // this.saveSnapshotStamp = Math.floor(this.saveSnapshotAbsoluteStamp / 1000); // any new changes from this point on will be saved without skipping\r\n //\r\n // //console.log({'posting form data': formData});\r\n // this._post(this.formData(), isSync)\r\n // .catch((reason) => {\r\n // // noinspection JSIgnoredPromiseFromCall\r\n // Logger.logError(`Failed to post '${Logger.stringifyObject(reason)}' for ${this.constructor.className} id ${this.id} isSync: ${isSync ? 'true' : 'false'}.`);\r\n //\r\n // return Promise.reject(reason);\r\n // })\r\n // .then((result) => resolve(result), (reason) => reject(reason));\r\n // } else {\r\n // console.log(`Skipped immediate save as superseded, for ${this.constructor.className} id ${this.id}`);\r\n // resolve(`Skipped immediate save as superseded.`);\r\n // }\r\n // });\r\n // }\r\n\r\n /**\r\n *\r\n * @returns {Promise|void}\r\n * @private\r\n */\r\n static _next() {\r\n Model._tasks.shift(); // save is done\r\n\r\n if (Model._tasks.length) {\r\n // run the next task\r\n //console.log('Running the next task.');\r\n\r\n try {\r\n return Model._tasks[0]().finally(Model._next);\r\n } catch (error) {\r\n // this should never be reached\r\n\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logError(`Outer catch in _next(). ${Logger.stringifyObject(error)}`);\r\n return Model._next();\r\n }\r\n }\r\n }\r\n\r\n /**\r\n * Makes a post to , storing the server's acknowledgement locally.\r\n *\r\n * The server's reply is parsed and written back to local storage because it does not always\r\n * match what was sent (the server assigns the authoritative created/modified stamps, and may\r\n * amend the record), so the local copy has to be reconciled with it.\r\n *\r\n * No local fallback is attempted on failure: callers reach this via _saveLocalThenQueuePost(),\r\n * which has already written the record locally, or via sync, where it is already in local\r\n * storage. A failure here simply leaves savedRemotely false for App.syncAll() to retry.\r\n *\r\n * @protected\r\n * @param {FormData} formData\r\n * @param {boolean} isSync default false, set if request is part of sync all rather than a regular save\r\n * @returns {Promise}\r\n */\r\n _post(formData, isSync = false) {\r\n /**\r\n * set if the request was aborted by our own deadline rather than failing for another reason\r\n * @type {boolean}\r\n */\r\n let timedOut = false;\r\n\r\n let timeoutId = null;\r\n\r\n /**\r\n * Cleared only once the whole chain has settled, rather than when the response headers\r\n * arrive, so that a stalled *body* is covered too (fetch resolves on headers, and\r\n * response.json() can then hang indefinitely).\r\n */\r\n const clearPostTimeout = () => {\r\n if (timeoutId) {\r\n clearTimeout(timeoutId);\r\n timeoutId = null;\r\n }\r\n };\r\n\r\n try {\r\n const fetchOptions = {\r\n method: 'POST',\r\n body: formData,\r\n // keepalive: true, // can't use keepalive, as it limits the request's size to 64kb\r\n };\r\n\r\n // feature-detected, as aborting is an optimisation rather than a requirement\r\n if (Model.SAVE_POST_TIMEOUT_MS && typeof AbortController !== 'undefined') {\r\n const signalController = new AbortController();\r\n fetchOptions.signal = signalController.signal;\r\n\r\n timeoutId = setTimeout(() => {\r\n timeoutId = null;\r\n timedOut = true;\r\n\r\n console.log(`Save post deadline of ${Model.SAVE_POST_TIMEOUT_MS} ms expired for ${this.constructor.className} id ${this.id}, aborting request.`);\r\n signalController.abort();\r\n }, Model.SAVE_POST_TIMEOUT_MS);\r\n }\r\n\r\n return fetch(`${this.SAVE_ENDPOINT}${isSync ? '?issync' : ''}`, fetchOptions).then(response => {\r\n if (response.ok) {\r\n return response.json()\r\n .then((jsonResponseData) => this._applyPostResponse(jsonResponseData), reason => {\r\n // An OK status but an unreadable body. The server may or may not have\r\n // stored the record, so leave it flagged for re-sync.\r\n console.error({'fetch error (at JSON decoding stage)': reason});\r\n\r\n return Promise.reject(`fetch error (at JSON decoding stage): ${Logger.stringifyObject(reason)}`);\r\n }\r\n );\r\n } else {\r\n console.error(`Remote save failed (reason ${response.status} '${response.statusText}')`);\r\n\r\n // see if a json error message is available in the response\r\n return response.json().then((responseData) => {\r\n return Promise.reject(`${isSync ? 'Sync save' : 'Save'} failed (reason ${response.status} '${response.statusText}') when saving ${this.constructor.className}, '${JSON.stringify(responseData)}'`);\r\n }, (error) => {\r\n return Promise.reject(isSync ?\r\n `Sync save failed, possibly no network connection. (${response.status}) when saving ${this.constructor.className}, error: ${Logger.stringifyObject(error)}`\r\n :\r\n `Save failed. (${response.status}) when saving ${this.constructor.className}, error: ${Logger.stringifyObject(error)}`);\r\n });\r\n }\r\n }, (error) => {\r\n return Promise.reject(timedOut ?\r\n `Save post timed out after ${Model.SAVE_POST_TIMEOUT_MS} ms when saving ${this.constructor.className}, isSync: ${isSync ? 'true' : 'false'}.`\r\n :\r\n `fetch network or permissions error: ${Logger.stringifyObject(error)}`);\r\n }).finally(clearPostTimeout);\r\n } catch (e) {\r\n clearPostTimeout();\r\n return Promise.reject(`fetch exception: ${Logger.stringifyObject(e)}`);\r\n }\r\n }\r\n\r\n /**\r\n * The endpoint that accepts several of these at once, or '' where there is none.\r\n *\r\n * Only occurrences have one. Images are chunked binary uploads and surveys are few, so neither has\r\n * anything to gain from batching.\r\n *\r\n * @type {string}\r\n */\r\n BATCH_SAVE_ENDPOINT = '';\r\n\r\n /**\r\n * Deadline for a batch post.\r\n *\r\n * Longer than SAVE_POST_TIMEOUT_MS because a batch legitimately takes longer: the server does the same\r\n * per-record work, just without repeating the bootstrap. Expressed as a base plus an allowance per\r\n * record so that the deadline tracks the size of what was actually sent, rather than being a single\r\n * number that is too tight for a hundred records and far too loose for three.\r\n *\r\n * @type {number}\r\n */\r\n static BATCH_POST_BASE_TIMEOUT_MS = 30000;\r\n\r\n /**\r\n * @type {number}\r\n */\r\n static BATCH_POST_PER_RECORD_TIMEOUT_MS = 1000;\r\n\r\n /**\r\n * Posts several models in one request and reconciles each reply with the model it belongs to.\r\n *\r\n * The models are all of one class - the caller groups them - so the endpoint and the reconciliation\r\n * come from the class itself.\r\n *\r\n * **A reply is matched to its model by id, never by position.** `syncBatching.matchReplies()` does that\r\n * and explains why at length; the short version is that position-matching would write one record's\r\n * authoritative timestamps onto another the first time the server answered out of order, silently.\r\n *\r\n * A model that gets no reply, or whose reply reports a failure, is simply left alone: `savedRemotely`\r\n * stays false and the next sync retries it, which is exactly what happens to a failed single post.\r\n *\r\n * @param {Array} models\r\n * @param {boolean} isSync\r\n * @returns {Promise<{saved: number, failed: number}>} rejects only if the whole request failed\r\n */\r\n static postBatch(models, isSync = false) {\r\n if (!models?.length) {\r\n return Promise.resolve({saved: 0, failed: 0});\r\n }\r\n\r\n const endpoint = models[0].BATCH_SAVE_ENDPOINT;\r\n\r\n if (!endpoint) {\r\n return Promise.reject(`No batch endpoint for ${models[0].constructor.className}.`);\r\n }\r\n\r\n const records = [];\r\n\r\n for (const model of models) {\r\n // The same snapshot a single post takes, and taken for the same reason: it is what\r\n // _applyPostResponse() later compares against to decide whether the reply has been overtaken\r\n // by an edit made while the request was in flight.\r\n model.lastQueuedPostAbsoluteStamp = Date.now();\r\n model.saveSnapshotAbsoluteStamp = Date.now();\r\n model.saveSnapshotModifiedToken = model.modifiedToken;\r\n model.saveSnapshotStamp = Math.floor(model.saveSnapshotAbsoluteStamp / 1000);\r\n\r\n records.push(model.postRecord());\r\n }\r\n\r\n return Model._batchFormData(records)\r\n .then((formData) => Model._fetchBatch(endpoint, formData, records.length, isSync))\r\n .then((replies) => {\r\n const {matched, missing, unexpected, duplicated} = matchReplies(\r\n models.map((model) => ({id: model.id, model})),\r\n replies\r\n );\r\n\r\n if (unexpected.length || duplicated.length) {\r\n // Not fatal - nothing was applied from them - but it means the server answered about\r\n // something that was not asked for, which is worth knowing about before it becomes a\r\n // mismatch that does matter.\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logError(\r\n `Batch save reply carried ${unexpected.length} unexpected and ${duplicated.length} duplicated record(s).`\r\n );\r\n }\r\n\r\n return Promise.allSettled(\r\n matched.map(({record, reply}) => record.model._applyPostResponse(reply))\r\n ).then((outcomes) => ({\r\n saved: outcomes.filter((outcome) => 'fulfilled' === outcome.status).length,\r\n failed: missing.length + outcomes.filter((outcome) => 'rejected' === outcome.status).length,\r\n }));\r\n });\r\n }\r\n\r\n /**\r\n * Whether this browser can gzip a request body.\r\n *\r\n * CompressionStream reached iOS in 16.4, so a real share of installs will not have it. They send the\r\n * batch uncompressed, which is what every client did until now.\r\n *\r\n * @returns {boolean}\r\n */\r\n static get compressionSupported() {\r\n return 'undefined' !== typeof CompressionStream && 'undefined' !== typeof Blob;\r\n }\r\n\r\n /**\r\n * Builds the multipart body for a batch, gzipping the records where that is worth doing.\r\n *\r\n * Sent as a **file part inside the ordinary multipart form**, not as a gzip-encoded request body.\r\n * That is not a stylistic choice: PHP does not decode Content-Encoding on a request, so \\$_POST would\r\n * arrive empty and the framework's whole parameter binding would break - and a file part looks to any\r\n * intermediary exactly like the image upload this server already accepts.\r\n *\r\n * The record count travels alongside so the server can reject a payload that inflated to a different\r\n * number of records than were sent. A corrupt inflate usually fails JSON parsing loudly, but a\r\n * truncation that still parses would otherwise save a prefix and report success for the rest.\r\n *\r\n * **Compression failing must never cost a batch.** Any error falls back to the uncompressed field:\r\n * this is an optimisation for a minority of syncs and must not become a way to lose records.\r\n *\r\n * @param {Array} records\r\n * @returns {Promise}\r\n * @private\r\n */\r\n static _batchFormData(records) {\r\n const json = JSON.stringify(records);\r\n\r\n /**\r\n * @param {Blob|null} compressed\r\n * @returns {FormData}\r\n */\r\n const build = (compressed) => {\r\n const formData = new FormData;\r\n\r\n if (compressed) {\r\n formData.append('occurrencesGz', compressed, 'occurrences.json.gz');\r\n formData.append('recordCount', String(records.length));\r\n } else {\r\n formData.append('occurrences', json);\r\n }\r\n\r\n formData.append('appVersion', Model.bsbiAppVersion);\r\n\r\n return formData;\r\n };\r\n\r\n // Measured on the encoded bytes rather than the string length, since the threshold is about what\r\n // goes over the wire and a name with an accent in it is more bytes than characters.\r\n const byteLength = 'undefined' === typeof TextEncoder ?\r\n json.length : new TextEncoder().encode(json).length;\r\n\r\n if (!shouldCompressBatch({byteLength, supported: Model.compressionSupported})) {\r\n return Promise.resolve(build(null));\r\n }\r\n\r\n return Model._gzip(json).then(\r\n (compressed) => build(compressed),\r\n (reason) => {\r\n console.info(`Batch compression failed, sending uncompressed: ${Logger.stringifyObject(reason)}`);\r\n\r\n return build(null);\r\n }\r\n );\r\n }\r\n\r\n /**\r\n * @param {string} text\r\n * @returns {Promise}\r\n * @private\r\n */\r\n static _gzip(text) {\r\n try {\r\n const stream = new Blob([text]).stream().pipeThrough(new CompressionStream('gzip'));\r\n\r\n return new Response(stream).blob();\r\n } catch (error) {\r\n // Thrown rather than rejected by some of the above; either way the caller falls back.\r\n return Promise.reject(error);\r\n }\r\n }\r\n\r\n /**\r\n * The request half of postBatch, kept separate so that the reply handling above reads as one thing.\r\n *\r\n * @param {string} endpoint\r\n * @param {FormData} formData\r\n * @param {number} recordCount\r\n * @param {boolean} isSync\r\n * @returns {Promise>} the per-record replies, unwrapped from the envelope\r\n * @private\r\n */\r\n static _fetchBatch(endpoint, formData, recordCount, isSync) {\r\n let timedOut = false;\r\n let timeoutId = null;\r\n\r\n const timeout = Model.BATCH_POST_BASE_TIMEOUT_MS\r\n + (recordCount * Model.BATCH_POST_PER_RECORD_TIMEOUT_MS);\r\n\r\n const clearPostTimeout = () => {\r\n if (timeoutId) {\r\n clearTimeout(timeoutId);\r\n timeoutId = null;\r\n }\r\n };\r\n\r\n try {\r\n const fetchOptions = {method: 'POST', body: formData};\r\n\r\n if (timeout && typeof AbortController !== 'undefined') {\r\n const signalController = new AbortController();\r\n fetchOptions.signal = signalController.signal;\r\n\r\n timeoutId = setTimeout(() => {\r\n timeoutId = null;\r\n timedOut = true;\r\n signalController.abort();\r\n }, timeout);\r\n }\r\n\r\n return fetch(`${endpoint}${isSync ? '?issync' : ''}`, fetchOptions).then((response) => {\r\n if (!response.ok) {\r\n // The status describes the request, not the records - the endpoint answers 200 whenever\r\n // it understood the batch, however the individual records fared. So a non-OK status\r\n // means none of them were attempted.\r\n return Promise.reject(`Batch save failed (${response.status} '${response.statusText}').`);\r\n }\r\n\r\n return response.json().then((body) => {\r\n const replies = body?.results;\r\n\r\n if (!Array.isArray(replies)) {\r\n return Promise.reject(`Batch save reply had no results list.`);\r\n }\r\n\r\n // Unwrapped here so that everything above deals in per-record replies of the same shape\r\n // a single save returns, which is what _applyPostResponse() expects.\r\n return replies\r\n .filter((result) => result?.success && result?.record)\r\n .map((result) => result.record);\r\n }, (reason) => Promise.reject(`Batch save reply could not be read: ${Logger.stringifyObject(reason)}`));\r\n }, (error) => Promise.reject(timedOut ?\r\n `Batch save timed out after ${timeout} ms for ${recordCount} record(s).`\r\n :\r\n `Batch save network error: ${Logger.stringifyObject(error)}`\r\n )).finally(clearPostTimeout);\r\n } catch (e) {\r\n clearPostTimeout();\r\n return Promise.reject(`Batch save exception: ${Logger.stringifyObject(e)}`);\r\n }\r\n }\r\n\r\n /**\r\n * Reconciles one server reply with this object and with local storage.\r\n *\r\n * Extracted from _post() unchanged so that the batch save path applies exactly the same rules to\r\n * each of its replies. Two copies of this would be the expensive mistake: the conflict rules it\r\n * encodes are subtle, and a batch copy that drifted would corrupt records silently rather than\r\n * failing - the reply carries the server's authoritative created/modified stamps, so applying the\r\n * wrong one writes a plausible-looking lie.\r\n *\r\n * The caller is responsible for having established that the reply belongs to *this* object. For a\r\n * single post that is trivially true; for a batch it is what syncBatching.matchReplies() decides.\r\n *\r\n * @param {{created: (number|string), modified: (number|string), saveState: string}} jsonResponseData\r\n * @returns {Promise} resolves with the reply, once local storage has been brought into step\r\n * @protected\r\n */\r\n _applyPostResponse(jsonResponseData) {\r\n // given an OK response from the server, with a JSON body, we can assume a successful server save.\r\n\r\n // Evaluated once, before anything is mutated. The test used to be made\r\n // twice, but the first pass assigned this.modifiedStamp from the\r\n // response, so the second pass was comparing the response against a\r\n // value it had just set. Both passes always agreed, so hoisting the\r\n // single evaluation changes no outcome, only the ordering.\r\n const responseIsStillCurrent =\r\n jsonResponseData.modified >= this.modifiedStamp\r\n && this.saveSnapshotAbsoluteStamp >= this.lastQueuedPostAbsoluteStamp\r\n && this.saveSnapshotModifiedToken === this.modifiedToken;\r\n\r\n if (responseIsStillCurrent) {\r\n this.savedRemotely = (jsonResponseData.saveState === SAVE_STATE_SERVER);\r\n\r\n this.createdStamp = parseInt(jsonResponseData.created, 10);\r\n this.modifiedStamp = parseInt(jsonResponseData.modified, 10);\r\n } else if (!this._mirrorSupersededResponseLocally()) {\r\n console.info(`Object ${this.localKey} has been modified since post request, post stamp ${jsonResponseData.modified} < ${this.modifiedStamp}; discarding the superseded server response.`);\r\n\r\n return Promise.resolve(jsonResponseData);\r\n }\r\n\r\n // Mirrored even when the response is no longer current, because for most\r\n // record types the server's copy can legitimately be the more recent\r\n // one: a record created on this device while offline may have been\r\n // edited elsewhere in the meantime, and the response is how that newer\r\n // work reaches the device. This write updates local storage only - the\r\n // in-memory object, which is what the user is looking at, is left alone\r\n // above, so nothing the user is actively editing is reverted under them.\r\n return ResponseFactory.fromPostResponse(jsonResponseData)\r\n .populateLocalSave()\r\n .storeLocally(true)\r\n .then(() => {\r\n if (responseIsStillCurrent) {\r\n this._savedLocally = true;\r\n } else {\r\n console.info(`Object ${this.localKey} has been modified since post request, post stamp ${jsonResponseData.modified} < ${this.modifiedStamp}.`);\r\n }\r\n\r\n return jsonResponseData;\r\n }, (reason) => {\r\n // failed to save locally, after successful save to server\r\n\r\n this._savedLocally = false;\r\n return Promise.reject(`failed to save locally, after successful save to server: ${Logger.stringifyObject(reason)}`);\r\n }\r\n );\r\n }\r\n\r\n /**\r\n *\r\n * @param {string} key\r\n * @param {string} type\r\n * @returns {Promise<{\r\n * id : string,\r\n * deleted : boolean,\r\n * modified : int, // note 'modified' not modifiedStamp\r\n * saveState : string,\r\n * [surveyId] : string, // occurrences only\r\n * }>}\r\n */\r\n static retrieveRawFromLocal(key, type) {\r\n if (!key || key === 'undefined') {\r\n // bad key or literal string 'undefined'\r\n return Promise.reject(`Cannot retrieve empty or 'undefined' key from local '${key}', type '${typeof key}'.`);\r\n }\r\n\r\n return localforage.getItem(`${type}.${key}`)\r\n .then(\r\n (descriptor) => {\r\n if (descriptor) {\r\n return descriptor;\r\n } else {\r\n return Promise.reject(`Failed to retrieve ${type}.${key} locally`);\r\n }\r\n },\r\n (reason) => {\r\n console.error({'Error retrieving from localforage' : {type : `${type}.${key}`}, reason});\r\n return Promise.reject(`Failed to retrieve ${type}.${key} locally (forage error)`);\r\n }\r\n );\r\n }\r\n\r\n /**\r\n *\r\n * @param {string} key\r\n * @param {(Survey|Occurrence|OccurrenceImage|Track)} modelObject\r\n * @returns {Promise}\r\n */\r\n static retrieveFromLocal(key, modelObject) {\r\n if (!key || key === 'undefined') {\r\n // bad key or literal string 'undefined'\r\n return Promise.reject(`Cannot retrieve empty or 'undefined' key from local '${key}', type '${typeof key}'.`);\r\n }\r\n\r\n return localforage.getItem(`${modelObject.TYPE}.${key}`)\r\n .then(\r\n (descriptor) => {\r\n if (descriptor) {\r\n modelObject._id = key; // _id must be set directly rather than through the setter, as a spurious id already set for the empty may need to be overwritten\r\n modelObject._parseDescriptor(descriptor);\r\n\r\n return modelObject;\r\n } else {\r\n return Promise.reject(`Failed to retrieve ${modelObject.TYPE}.${key} locally`);\r\n }\r\n },\r\n (reason) => {\r\n console.error({'Error retrieving from localforage' : {type : `${modelObject.TYPE}.${key}`}, reason});\r\n return Promise.reject(`Failed to retrieve ${modelObject.TYPE}.${key} locally (forage error)`);\r\n }\r\n );\r\n }\r\n\r\n /**\r\n *\r\n * @param {{\r\n * id : string,\r\n * saveState: string,\r\n * [userId]: string,\r\n * attributes: Object.,\r\n * deleted: boolean|string,\r\n * created: (number|string),\r\n * modified: (number|string),\r\n * projectId: (number|string)\r\n * }} descriptor\r\n */\r\n _parseDescriptor(descriptor) {\r\n this._parseAttributes(descriptor.attributes);\r\n this._parseSavedState(descriptor.saveState);\r\n this.deleted = (descriptor.deleted === true) || (descriptor.deleted === 'true'); // cast stringified boolean to true boolean\r\n this.createdStamp = parseInt(descriptor.created, 10);\r\n this.modifiedStamp = descriptor.modified ? parseInt(descriptor.modified, 10) : 0; // avoids NaN\r\n this.projectId = parseInt(descriptor.projectId, 10);\r\n\r\n if (descriptor.userId) {\r\n this.userId = descriptor.userId;\r\n }\r\n }\r\n\r\n /**\r\n *\r\n * @param {Object.|string|Array} attributes\r\n */\r\n _parseAttributes(attributes) {\r\n if (typeof attributes === 'string') {\r\n attributes = JSON.parse(attributes);\r\n }\r\n\r\n if (Array.isArray(attributes)) {\r\n // problematic bug, where empty attributes come back as an array rather than as an object\r\n\r\n //console.log('Attributes were spuriously represented as an array rather than as an empty object');\r\n this.attributes = {};\r\n } else {\r\n this.attributes = attributes;\r\n }\r\n }\r\n\r\n /**\r\n *\r\n * @param {string} saveState\r\n */\r\n _parseSavedState(saveState) {\r\n switch (saveState) {\r\n case SAVE_STATE_LOCAL:\r\n this.savedRemotely = false;\r\n this._savedLocally = true;\r\n break;\r\n\r\n case SAVE_STATE_SERVER:\r\n this.savedRemotely = true;\r\n this._savedLocally = true;\r\n break;\r\n\r\n default:\r\n throw new Error(`Unrecognised saved state '${saveState}`);\r\n }\r\n }\r\n\r\n /**\r\n * update modified stamp to current time\r\n */\r\n touch() {\r\n this.modifiedStamp = Math.floor(Date.now() / 1000);\r\n\r\n this.modifiedToken = Math.random();\r\n\r\n if (this.isPristine) {\r\n this.isPristine = false;\r\n this.createdStamp = this.modifiedStamp;\r\n }\r\n\r\n this._savedLocally = false;\r\n this.savedRemotely = false;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {Object.} formSectionProperties\r\n * @return {{requiredFieldsPresent: boolean, validity: Object.}}\r\n */\r\n evaluateCompletionStatus(formSectionProperties) {\r\n const validity = {};\r\n let requiredFieldsPresent = true;\r\n\r\n for (let key in formSectionProperties) {\r\n if (formSectionProperties.hasOwnProperty(key)) {\r\n let property = formSectionProperties[key];\r\n\r\n validity[key] = property.validator ?\r\n property.validator(key, property, this.attributes)\r\n :\r\n property.field.isValid(key, property, this.attributes);\r\n\r\n if (null !== validity[key]) {\r\n // validity can be 'null' in which case field was optional and not assessed\r\n requiredFieldsPresent = requiredFieldsPresent && validity[key];\r\n }\r\n }\r\n }\r\n\r\n return {\r\n requiredFieldsPresent,\r\n validity\r\n };\r\n }\r\n\r\n destructor() {\r\n this.fireEvent(MODEL_EVENT_DESTROYED);\r\n super.destructor();\r\n }\r\n\r\n /**\r\n * @abstract\r\n * @returns {FormData}\r\n */\r\n formData() {\r\n\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * @abstract\r\n * @returns {Promise}\r\n */\r\n storeLocally() {\r\n\r\n }\r\n\r\n /**\r\n *\r\n * @param {{}} data\r\n * @returns {Promise}\r\n * @protected\r\n */\r\n _storeLocalData(data) {\r\n\r\n return localforage.setItem(this.localKey, data)\r\n .then(() => {\r\n console.log(`Stored object ${this.localKey} locally`);\r\n },\r\n (reason) => {\r\n console.log({[`Failed to store object ${this.localKey} locally`] : reason});\r\n return Promise.reject({[`Failed to store object ${this.localKey} locally`] : reason});\r\n }\r\n );\r\n }\r\n}\r\n","/**\r\n *\r\n * @param text\r\n * @returns {string}\r\n */\r\nexport function escapeHTML(text) {\r\n try {\r\n // IE (even v 11) sometimes fails here with 'Unknown runtime error', see http://blog.rakeshpai.me/2007/02/ies-unknown-runtime-error-when-using.html\r\n const textArea = document.createElement('textarea');\r\n textArea.innerHTML = text;\r\n return textArea.innerHTML.replace(/\"/g, '"');\r\n } catch (e) {\r\n const pre = document.createElement('pre');\r\n pre.appendChild(document.createTextNode(text));\r\n return pre.innerHTML.replace(/\"/g, '"');\r\n }\r\n}","import {EventHarness} from \"../framework/EventHarness\";\r\n\r\nexport const DEVICE_TYPE_UNKNOWN = 'unknown';\r\nexport const DEVICE_TYPE_UNCHECKED = 'unchecked';\r\nexport const DEVICE_TYPE_MOBILE = 'mobile';\r\nexport const DEVICE_TYPE_IMMOBILE = 'immobile';\r\n\r\nexport class DeviceType extends EventHarness {\r\n\t// static DEVICE_TYPE_UNKNOWN = DEVICE_TYPE_UNKNOWN;\r\n\t// static DEVICE_TYPE_UNCHECKED = DEVICE_TYPE_UNCHECKED;\r\n\t// static DEVICE_TYPE_MOBILE = DEVICE_TYPE_MOBILE;\r\n\t// static DEVICE_TYPE_IMMOBILE = DEVICE_TYPE_IMMOBILE;\r\n\r\n\t/**\r\n\t * global flag affecting the behaviour of some GPS functionality,\r\n\t * e.g. on a non-mobile device don't automatically seek GPS locality for new records\r\n\t * @private\r\n\t *\r\n\t * @type {string}\r\n\t */\r\n\tstatic _deviceType = DEVICE_TYPE_UNCHECKED;\r\n\r\n\t/**\r\n\t * @type {App}\r\n\t */\r\n\tstatic app;\r\n\r\n\t/**\r\n\t * @returns {string}\r\n\t */\r\n\tstatic getDeviceType() {\r\n\t\tif (DeviceType._deviceType === DEVICE_TYPE_UNCHECKED) {\r\n\t\t\tconst override = DeviceType?.app?.getOption?.('mobileOverride');\r\n\r\n\t\t\tif (override === 'mobile') {\r\n\t\t\t\tDeviceType._deviceType = DEVICE_TYPE_MOBILE;\r\n\t\t\t} else if (override === 'immobile') {\r\n\t\t\t\tDeviceType._deviceType = DEVICE_TYPE_IMMOBILE;\r\n\t\t\t} else {\r\n\t\t\t\tDeviceType._deviceType = DeviceType.getDeviceTypeUncached();\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\treturn DeviceType._deviceType;\r\n\t}\r\n\r\n\t/**\r\n\t *\r\n\t * @returns {boolean} true if the device type has changed\r\n\t */\r\n\tstatic reevaluate() {\r\n\t\tconst previous = DeviceType._deviceType;\r\n\t\tDeviceType._deviceType = DEVICE_TYPE_UNCHECKED; // reset\r\n\t\tDeviceType._deviceType = DeviceType.getDeviceType();\r\n\r\n\t\treturn previous !== DeviceType._deviceType;\r\n\t}\r\n\r\n\t/**\r\n\t *\r\n\t * @param {string} deviceType\r\n\t */\r\n\tstatic setDeviceType(deviceType) {\r\n\t\tDeviceType._deviceType = deviceType;\r\n\t}\r\n\r\n\t// /**\r\n\t// * @returns {string}\r\n\t// */\r\n\t// static getDeviceType() {\r\n\t// \tif (DeviceType._deviceType === DeviceType.DEVICE_TYPE_UNCHECKED) {\r\n\t// \t\t// noinspection JSUnresolvedReference\r\n\t// \t\tif (navigator.userAgentData && \"mobile\" in navigator.userAgentData) {\r\n\t// \t\t\tDeviceType._deviceType = navigator.userAgentData.mobile ?\r\n\t// \t\t\t\tDeviceType.DEVICE_TYPE_MOBILE : DeviceType.DEVICE_TYPE_IMMOBILE;\r\n\t// \t\t\tconsole.log(`Evaluated device using mobile flag, result: ${DeviceType._deviceType}`);\r\n\t// \t\t} else if (/Android|webOS|iPhone|iPad|iPod|BlackBerry/i.test(navigator.userAgent)) {\r\n\t// \t\t\t// see https://javascript.plainenglish.io/how-to-detect-a-mobile-device-with-javascript-1c26e0002b31\r\n\t// \t\t\tconsole.log(`Detected mobile via use-agent string: ${navigator.userAgent}`);\r\n\t// \t\t\tDeviceType._deviceType = DeviceType.DEVICE_TYPE_MOBILE;\r\n\t// \t\t} else if (navigator.platform && /iPhone|iPad/.test(navigator.platform)) {\r\n\t// \t\t\t// see https://stackoverflow.com/questions/19877924/what-is-the-list-of-possible-values-for-navigator-platform-as-of-today\r\n\t// \t\t\tconsole.log(`Detected mobile via platform string: ${navigator.platform}`);\r\n\t// \t\t\tDeviceType._deviceType = DeviceType.DEVICE_TYPE_MOBILE;\r\n\t// \t\t} else if (navigator.platform && /Win32|^Mac/.test(navigator.platform)) {\r\n\t// \t\t\t// see https://stackoverflow.com/questions/19877924/what-is-the-list-of-possible-values-for-navigator-platform-as-of-today\r\n\t// \t\t\tconsole.log(`Detected immobility via platform string: ${navigator.platform}`);\r\n\t// \t\t\tDeviceType._deviceType = DeviceType.DEVICE_TYPE_IMMOBILE;\r\n\t// \t\t} else {\r\n\t// \t\t\tconsole.log('Flagging device type as unknown.');\r\n\t// \t\t\tDeviceType._deviceType = DeviceType.DEVICE_TYPE_UNKNOWN;\r\n\t// \t\t}\r\n\t// \t}\r\n\t//\r\n\t// \treturn DeviceType._deviceType;\r\n\t// }\r\n\r\n\t/**\r\n\t * Evaluates the device type based on browser information, does not consider user-set overrides.\r\n\t *\r\n\t * @returns {string}\r\n\t */\r\n\tstatic getDeviceTypeUncached() {\r\n\t\t// noinspection JSUnresolvedReference\r\n\t\tif (navigator.userAgentData && \"mobile\" in navigator.userAgentData) {\r\n\t\t\treturn navigator.userAgentData.mobile ?\r\n\t\t\t\tDEVICE_TYPE_MOBILE : DEVICE_TYPE_IMMOBILE;\r\n\t\t\t// console.log(`Evaluated device using mobile flag, result: ${DeviceType._deviceType}`);\r\n\t\t} else if (/Android|webOS|iPhone|iPad|iPod|BlackBerry/i.test(navigator.userAgent)) {\r\n\t\t\t// see https://javascript.plainenglish.io/how-to-detect-a-mobile-device-with-javascript-1c26e0002b31\r\n\t\t\t//console.log(`Detected mobile via use-agent string: ${navigator.userAgent}`);\r\n\t\t\treturn DEVICE_TYPE_MOBILE;\r\n\t\t} else if (navigator.platform && /iPhone|iPad/.test(navigator.platform)) {\r\n\t\t\t// see https://stackoverflow.com/questions/19877924/what-is-the-list-of-possible-values-for-navigator-platform-as-of-today\r\n\t\t\t//console.log(`Detected mobile via platform string: ${navigator.platform}`);\r\n\t\t\treturn DEVICE_TYPE_MOBILE;\r\n\t\t} else if (navigator.platform && /Win32|^Mac/.test(navigator.platform)) {\r\n\t\t\t// see https://stackoverflow.com/questions/19877924/what-is-the-list-of-possible-values-for-navigator-platform-as-of-today\r\n\t\t\t//console.log(`Detected immobility via platform string: ${navigator.platform}`);\r\n\t\t\treturn DEVICE_TYPE_IMMOBILE;\r\n\t\t} else {\r\n\t\t\t//console.log('Flagging device type as unknown.');\r\n\t\t\treturn DEVICE_TYPE_UNKNOWN;\r\n\t\t}\r\n\t}\r\n}\r\n","import {Model, MODEL_EVENT_DESTROYED} from \"./Model\";\r\nimport {DEVICE_TYPE_IMMOBILE, DeviceType} from \"../utils/DeviceType\";\r\nimport {\r\n APP_EVENT_CANCEL_WATCHED_GPS_USER_REQUEST,\r\n APP_EVENT_CURRENT_SURVEY_CHANGED,\r\n //APP_EVENT_WATCH_GPS_USER_REQUEST,\r\n SURVEY_EVENT_MODIFIED,\r\n SURVEY_EVENT_OCCURRENCES_CHANGED\r\n} from \"../framework/AppEvents\";\r\nimport {SAVE_STATE_LOCAL, SAVE_STATE_SERVER} from \"../utils/constants\";\r\nimport {Logger} from \"../utils/Logger.js\";\r\n//import {Logger} from \"../utils/Logger\";\r\n\r\n//import {App} from \"../framework/App\";\r\n\r\n/**\r\n * Used for saving the current survey track that is still open\r\n * @type {number}\r\n */\r\nconst TRACK_END_REASON_SURVEY_OPEN = 0;\r\n\r\nconst TRACK_END_REASON_WATCHING_ENDED = 1;\r\nconst TRACK_END_REASON_SURVEY_DATE = 2;\r\nconst TRACK_END_REASON_SURVEY_CHANGED = 3;\r\nconst TRACK_END_LOCATION_CHANGED = 4;\r\n\r\n// 0.00001 is approximately 1.1 m\r\nconst LONGITUDE_MAX_DIFF_THRESHOLD = 0.00001 * (200 / 1.1); // 200m\r\nconst LATITUDE_MAX_DIFF_THRESHOLD = 0.00001 * (200 / 1.1); // 200m\r\nconst TIME_MAX_DIFF_THRESHOLD = 10 * 60; // 10 minutes\r\n\r\n/**\r\n * @typedef {import('british-isles-gridrefs').GridCoords} GridCoords\r\n */\r\n\r\nexport class Track extends Model {\r\n\r\n /**\r\n * mirrors constructor.name but doesn't get mangled by minification\r\n *\r\n * @type {string}\r\n */\r\n static className = 'Track';\r\n\r\n /**\r\n * @typedef PointTriplet\r\n * @type {array}\r\n * @property {number} 0 lng\r\n * @property {number} 1 lat\r\n * @property {number} 2 stamp (seconds since epoch)\r\n * @property {number} 3 accuracy (m 95% CI)\r\n */\r\n\r\n /**\r\n * @typedef PointSeries\r\n * @type {Array|number>}\r\n * @property {Array} 0 points\r\n * @property {number} 1 end reason code\r\n */\r\n\r\n /**\r\n *\r\n * @type {Array}\r\n */\r\n points = []\r\n\r\n /**\r\n * next index to write to in points\r\n * Following a successful save to the server, the earlier values will be cleared locally, but pointIndex will continue\r\n *\r\n * @type {number}\r\n */\r\n pointIndex = 0;\r\n\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n userId = '';\r\n\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n surveyId = '';\r\n\r\n /**\r\n * route tracking should be maintained separately on each device\r\n * (e.g. if multiple people linked to a single live survey)\r\n *\r\n * @type {string}\r\n */\r\n deviceId = '';\r\n\r\n SAVE_ENDPOINT = '/savetrack.php';\r\n\r\n TYPE = 'track';\r\n\r\n /**\r\n * @type {App}\r\n */\r\n static _app;\r\n\r\n /**\r\n * If set then user options allow tracking, (even if it is not currently active)\r\n *\r\n * @type {boolean}\r\n */\r\n static trackingIsEnabled = false;\r\n\r\n /**\r\n * Tracking is active if GPS watching is turned on,\r\n * the current survey is from the same day and the device id matches\r\n *\r\n * @type {boolean}\r\n */\r\n static trackingIsActive = false;\r\n\r\n /**\r\n *\r\n * @type {null|string}\r\n * @private\r\n */\r\n static _currentlyTrackedSurveyId = null;\r\n\r\n /**\r\n *\r\n * @type {null|string}\r\n * @private\r\n */\r\n static _currentlyTrackedDeviceId = null;\r\n\r\n /**\r\n * keyed by survey id and then by device id\r\n *\r\n * @type {Map>}\r\n * @private\r\n */\r\n static _tracks = new Map();\r\n\r\n /**\r\n * Unix timestamp of the most recent co-ordinate ping, in ms\r\n * @type {number}\r\n */\r\n static lastPingStamp = 0;\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * Minimum interval between position updates in milliseconds\r\n *\r\n * @type {number}\r\n */\r\n static msInterval = 15 * 1000;\r\n\r\n /**\r\n * Minimum interval between remote posts of a live track, in milliseconds.\r\n *\r\n * Every save posts the whole points array, so on a walked survey the ordinary per-ping save\r\n * uploads an ever-growing payload every msInterval - tens of megabytes over a day, almost all\r\n * of it re-sending points the server already holds. Local storage is still written on every\r\n * ping (that is the data-loss guard, and it is cheap), but the posts are coalesced.\r\n *\r\n * Nothing is at risk in the gap: the record sits in local storage flagged SAVE_STATE_LOCAL, so\r\n * App.syncAll() finds and posts it - whichever comes first, the timer or the next sync.\r\n *\r\n * Terminal saves (forceSave, and sync) bypass this entirely and post at once.\r\n *\r\n * @type {number}\r\n */\r\n static remotePostIntervalMs = 5 * 60 * 1000;\r\n\r\n /**\r\n *\r\n * @type {EventHarness~Handle|undefined}\r\n */\r\n _surveyChangeListenerHandle;\r\n\r\n /**\r\n *\r\n * @type {EventHarness~Handle|undefined}\r\n */\r\n _surveyDestroyedListenerHandle;\r\n\r\n /**\r\n *\r\n * @type {EventHarness~Handle|undefined}\r\n */\r\n _surveyOccurrencesChangeListenerHandle;\r\n\r\n // /**\r\n // * Project ids of survey types that are trackable\r\n // *\r\n // * @type {Array}\r\n // */\r\n // static trackableSurveyProjects = [];\r\n\r\n /**\r\n * @return {string}\r\n */\r\n get localKey() {\r\n if (!this.deviceId) {\r\n throw new Error(`Cannot generate a localKey for track, as the device id is undefined.`);\r\n }\r\n\r\n return `${this.TYPE}.${this.surveyId}.${this.deviceId}`;\r\n }\r\n\r\n static reset() {\r\n // Tracks are about to be dropped, so cancel any post still waiting on its timer. This is a\r\n // soft reset (log-out), and posting after the session has ended would be pointless; the\r\n // points remain in local storage for the next App.syncAll() to find.\r\n for (const deviceTracks of Track._tracks.values()) {\r\n for (const track of deviceTracks.values()) {\r\n track._clearDeferredPost();\r\n }\r\n }\r\n\r\n Track._tracks = new Map();\r\n Track.trackingIsActive = false;\r\n Track._currentlyTrackedSurveyId = null;\r\n Track.lastPingStamp = 0;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * Need to listen for change of the current survey\r\n *\r\n * @param {App} app\r\n */\r\n static registerApp(app) {\r\n Track._app = app;\r\n }\r\n\r\n static _staticListenersRegistered = false;\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n static registerStaticListeners() {\r\n if (!Track._staticListenersRegistered) {\r\n const app = Track._app;\r\n if (DeviceType.getDeviceType() !== DEVICE_TYPE_IMMOBILE) {\r\n app.addListener(APP_EVENT_CURRENT_SURVEY_CHANGED, (/** {newSurvey : Survey|null}|null */ params) => {\r\n //const survey = Track._app.currentSurvey;\r\n const survey = params?.newSurvey;\r\n // noinspection JSValidateTypes\r\n params = null;\r\n\r\n if (!survey || Track._currentlyTrackedSurveyId !== survey.id) {\r\n /**\r\n *\r\n * @type {null|Survey}\r\n */\r\n let previouslyTrackedSurvey = null;\r\n\r\n if (Track._currentlyTrackedSurveyId) {\r\n /**\r\n * @type {Track|null}\r\n */\r\n const oldTrack =\r\n Track._tracks.get(Track._currentlyTrackedSurveyId)\r\n ?.get?.(Track._currentlyTrackedDeviceId);\r\n\r\n previouslyTrackedSurvey = Track._app.surveys.get(Track._currentlyTrackedSurveyId);\r\n\r\n if (oldTrack) {\r\n if (undefined !== oldTrack._surveyChangeListenerHandle) {\r\n oldTrack.removeSurveyChangeListener();\r\n }\r\n\r\n oldTrack.endCurrentSeries(TRACK_END_REASON_SURVEY_CHANGED);\r\n\r\n oldTrack.save(true).then(() => {\r\n console.log(`Tracking for survey ${oldTrack.surveyId} saved following survey change.`)\r\n // @intentional end of chain\r\n }, (e) => {\r\n console.error(`Failed to save track for survey ${oldTrack.surveyId} following survey change: ${Logger.stringifyObject(e)}`);\r\n // @intentional end of chain\r\n });\r\n } else {\r\n console.error(`Failed to retrieve old track for survey ${Track._currentlyTrackedSurveyId} in survey changed event handler.`)\r\n }\r\n\r\n Track._currentlyTrackedSurveyId = null;\r\n Track._currentlyTrackedDeviceId = null;\r\n }\r\n\r\n Track.applyChangedSurveyTrackingResumption(survey, previouslyTrackedSurvey);\r\n }\r\n });\r\n\r\n // Track._app.addListener(APP_EVENT_WATCH_GPS_USER_REQUEST, () => {\r\n // if (Track.trackingIsActive) {\r\n // Track.startTracking();\r\n // }\r\n // });\r\n\r\n Track._app.addListener(APP_EVENT_CANCEL_WATCHED_GPS_USER_REQUEST, () => {\r\n\r\n if (Track.trackingIsActive) {\r\n /**\r\n * @type {Track|null}\r\n */\r\n const track = Track._tracks.get(Track._currentlyTrackedSurveyId)?.get?.(Track._currentlyTrackedDeviceId);\r\n\r\n if (track) {\r\n track.endCurrentSeries(TRACK_END_REASON_WATCHING_ENDED);\r\n\r\n track.save(true).then(() => {\r\n console.log(`Tracking for survey ${track.surveyId} saved following tracking change.`);\r\n // @intentional end of promise chain\r\n }, (reason) => {\r\n console.error(reason);\r\n // @intentional no throw needed at end of chain\r\n });\r\n }\r\n\r\n Track._currentlyTrackedSurveyId = null;\r\n Track._currentlyTrackedDeviceId = null;\r\n Track.trackingIsActive = false;\r\n }\r\n });\r\n Track._staticListenersRegistered = true;\r\n }\r\n }\r\n }\r\n\r\n static startTracking() {\r\n Track.refreshTrackingEnabledState();\r\n\r\n if (Track.trackingIsEnabled) {\r\n const survey = Track._app.currentSurvey;\r\n\r\n if (survey) {\r\n if (!survey.attributes?.casual && survey.isToday() !== false) {\r\n // Resume existing tracking or start a new track.\r\n Track._trackSurvey(survey);\r\n Track.trackingIsActive = true;\r\n }\r\n }\r\n }\r\n }\r\n\r\n /**\r\n *\r\n * @param {Survey} survey\r\n * @param {?Survey} previouslyTrackedSurvey\r\n */\r\n static applyChangedSurveyTrackingResumption(survey, previouslyTrackedSurvey = null) {\r\n Track.refreshTrackingEnabledState();\r\n\r\n if (Track.trackingIsEnabled && survey && !survey.attributes?.casual && survey.isToday() !== false) {\r\n Track.trackingIsActive = true;\r\n Track._trackSurvey(survey);\r\n }\r\n\r\n // // Tracking should only resume automatically if the survey change was an automatic switch\r\n // // to a new square and tracking was previously active.\r\n //\r\n // // otherwise, there is a risk that a survey switch will lead to spurious new points\r\n // if (survey &&\r\n // !survey.attributes?.casual &&\r\n // survey.isToday() !== false &&\r\n // survey.baseSurveyId === previouslyTrackedSurvey?.baseSurveyId\r\n // ) {\r\n // // Resume existing tracking or start a new track.\r\n //\r\n // console.log('continuing tracking for survey with common baseSurvey')\r\n // Track._trackSurvey(survey);\r\n // Track.trackingIsActive = true;\r\n // } else if (survey && !survey.attributes?.casual && survey.isToday() !== false) {\r\n // // Dependent on user preferences may restart tracking\r\n // // const trackingLocation = Track._app.getOption('trackLocation') && DeviceType.getDeviceType() !== DeviceType.DEVICE_TYPE_IMMOBILE;\r\n //\r\n //\r\n //\r\n // if (Track.trackingIsEnabled) {\r\n // // start tracking\r\n //\r\n // console.log('start tracking for survey based on user preference')\r\n // Track._trackSurvey(survey);\r\n // Track.trackingIsActive = true;\r\n // Track._app.fireEvent(APP_EVENT_WATCH_GPS_USER_REQUEST, {auto: true});\r\n // } else {\r\n // Track._app.fireEvent(APP_EVENT_CANCEL_WATCHED_GPS_USER_REQUEST, {auto : true});\r\n // }\r\n // } else {\r\n // Track._app.fireEvent(APP_EVENT_CANCEL_WATCHED_GPS_USER_REQUEST, {auto : true});\r\n // }\r\n }\r\n\r\n static refreshTrackingEnabledState() {\r\n Track.trackingIsEnabled = Track._app.getOption('trackLocation') && DeviceType.getDeviceType() !== DEVICE_TYPE_IMMOBILE;\r\n }\r\n\r\n /**\r\n * Resume existing tracking or start a new track.\r\n * (should already have tested that the survey is valid to track)\r\n *\r\n * @param {Survey} survey\r\n * @private\r\n */\r\n static _trackSurvey(survey) {\r\n let surveyTracks = Track._tracks.get(survey.id);\r\n let track;\r\n\r\n if (!surveyTracks) {\r\n surveyTracks = new Map();\r\n Track._tracks.set(survey.id, surveyTracks);\r\n }\r\n\r\n const deviceId = Track._app.deviceId;\r\n\r\n if (surveyTracks.has(deviceId)) {\r\n track = surveyTracks.get(deviceId);\r\n track.registerSurvey(survey);\r\n } else {\r\n track = survey.initialiseNewTracker(Track._app);\r\n surveyTracks.set(deviceId, track);\r\n }\r\n\r\n Track.clearGeowatchThrottle(); // for the new track, we want a starting point without any delay\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {GeolocationPosition} position\r\n */\r\n static ping(position) {\r\n /**\r\n * @type {Track|null} track\r\n */\r\n const track = Track._tracks.get(Track._currentlyTrackedSurveyId)?.get?.(Track._currentlyTrackedDeviceId);\r\n\r\n if (track) {\r\n const changed = track.addPoint(position);\r\n Track.lastPingStamp = position.timestamp;\r\n\r\n if (changed) {\r\n /**\r\n *\r\n * @type {(Survey|null)}\r\n */\r\n const currentSurvey = Track._app?.currentSurvey;\r\n\r\n // The survey must be saved first\r\n if (currentSurvey?.unsaved?.()) {\r\n if (!currentSurvey.isPristine) {\r\n // adds to a save queue so promises don't need to be chained\r\n\r\n // noinspection JSIgnoredPromiseFromCall\r\n currentSurvey.save()\r\n .catch((reason) => {\r\n console.error(reason);\r\n // @intentional no throw needed at end of chain\r\n });\r\n\r\n // noinspection JSIgnoredPromiseFromCall\r\n track.save()\r\n .catch((reason) => {\r\n console.error(reason);\r\n // @intentional no throw needed at end of chain\r\n });\r\n }\r\n } else {\r\n // noinspection JSIgnoredPromiseFromCall\r\n track.save();\r\n }\r\n }\r\n }\r\n }\r\n\r\n /**\r\n * The device is always the source of truth for tracking: points are appended locally and never\r\n * originate anywhere else, so a response that has been superseded can only be an older prefix\r\n * of what is already held. Writing it back would drop the points added since the post was sent,\r\n * until the next ping happened to rewrite them.\r\n *\r\n * @protected\r\n * @returns {boolean}\r\n */\r\n _mirrorSupersededResponseLocally() {\r\n return false;\r\n }\r\n\r\n /**\r\n * @param {number} modifiedStampWhenQueued\r\n * @returns {boolean}\r\n * @protected\r\n */\r\n _cannotSkipAsObsolete(modifiedStampWhenQueued) {\r\n if (this.modifiedStamp >= this.saveSnapshotStamp) {\r\n //console.log('Track._cannotSkipAsObsolete: allow save as previous save was prior');\r\n return true;\r\n }\r\n\r\n if ((!this.unsaved()) || this.modifiedStamp > modifiedStampWhenQueued) {\r\n // track has been updated since, so can skip saving an earlier iteration\r\n console.info('Track._cannotSkipAsObsolete: skipping save due to update');\r\n return false;\r\n }\r\n return true;\r\n }\r\n\r\n /**\r\n *\r\n * @param {GeolocationPosition} position\r\n * @returns {boolean} changed\r\n */\r\n addPoint(position) {\r\n let series = this.points[this.points.length - 1];\r\n\r\n if (!series || series?.[1] !== TRACK_END_REASON_SURVEY_OPEN) {\r\n series = this.startPointSeries();\r\n }\r\n\r\n let l = series[0].length;\r\n\r\n // test if we have jumped too far and should start a new series\r\n if (l > 0 &&\r\n (Math.abs(series[0][l - 1][0] - position.coords.longitude) > LONGITUDE_MAX_DIFF_THRESHOLD ||\r\n Math.abs(series[0][l - 1][1] - position.coords.latitude) > LATITUDE_MAX_DIFF_THRESHOLD ||\r\n (Math.floor(position.timestamp / 1000) - series[0][l - 1][2]) > TIME_MAX_DIFF_THRESHOLD\r\n )\r\n ) {\r\n console.log({'tracking jump' : { latDiff : Math.abs(series[0][l - 1][1] - position.coords.latitude),\r\n lngDiff : Math.abs(series[0][l - 1][0] - position.coords.longitude),\r\n timeDiff: (Math.floor(position.timestamp / 1000) - series[0][l - 1][2]),\r\n }\r\n });\r\n this.endCurrentSeries(TRACK_END_LOCATION_CHANGED);\r\n series = this.startPointSeries();\r\n l = 0;\r\n }\r\n\r\n // test if we have moved at all since last point\r\n if (l > 0 && series[0][l - 1][0] === position.coords.longitude && series[0][l - 1][1] === position.coords.latitude) {\r\n // no change since last point\r\n return false;\r\n } else {\r\n series[0][l] = [\r\n position.coords.longitude,\r\n position.coords.latitude,\r\n Math.floor(position.timestamp / 1000),\r\n position.coords.accuracy,\r\n ];\r\n\r\n this.touch();\r\n\r\n return true;\r\n }\r\n }\r\n\r\n /**\r\n * Appends a new point series and advances this.pointIndex\r\n * Does not close previous series and does not mark series as unsaved (which happens only\r\n * once co-ordinate data starts to be added)\r\n *\r\n * @returns {PointSeries}\r\n */\r\n startPointSeries() {\r\n /**\r\n *\r\n * @type {PointSeries}\r\n */\r\n const pointSeries = [\r\n /** @type {Array} */ [], // empty array of PointTriplets\r\n TRACK_END_REASON_SURVEY_OPEN\r\n ];\r\n\r\n this.points[this.points.length] = pointSeries;\r\n\r\n this.pointIndex++;\r\n\r\n return pointSeries;\r\n }\r\n\r\n /**\r\n * Called only if tracking is currently enabled\r\n *\r\n * @param {number} reason\r\n */\r\n endCurrentSeries(reason) {\r\n if (this.points.length) {\r\n const lastEntry = this.points[this.points.length - 1];\r\n\r\n if (lastEntry[0].length) {\r\n // co-ordinates have been added\r\n\r\n lastEntry[1] = reason;\r\n } else {\r\n // this is an empty series, so just delete it\r\n\r\n this.points.splice(this.points.length - 1, 1); // use splice, as delete leaves a hole without updating the array length\r\n this.pointIndex--;\r\n }\r\n } else {\r\n //throw new Error(\"Track.endCurrentSeries called when no series in progress.\");\r\n console.error(\"Track.endCurrentSeries called when no series in progress.\");\r\n }\r\n }\r\n\r\n /**\r\n * if not securely saved then makes a post to /savetrack.php\r\n *\r\n * This should be intercepted by a service worker, which could write the object to indexedDb.\r\n * A successful save (local or to server) will result in a JSON response containing the object\r\n * and also the state of persistence. After a save to the server, the points-list may be cleared,\r\n * but pointIndex will be maintained so that tracking can resume.\r\n *\r\n * If saving fails, then the expectation is that there is no service worker, in which case should attempt to write\r\n * the object directly to indexeddb\r\n *\r\n * Must test indexeddb for this eventuality after the save has returned.\r\n *\r\n * @param {boolean} forceSave\r\n * @param {boolean} [isSync]\r\n * @param {{}} [params]\r\n *\r\n * @returns {Promise}\r\n */\r\n save(forceSave = false, isSync = false, params) {\r\n if ((forceSave || this.unsaved()) && (this.points?.length > 0 || this.deleted)) {\r\n if (!this.surveyId) {\r\n return Promise.reject(`Survey id must be set before saving a track.`);\r\n }\r\n\r\n if (!this.deviceId) {\r\n return Promise.reject(`Device id must be set before saving a track.`);\r\n }\r\n\r\n if (isSync || forceSave) {\r\n // Sync, or a terminal save (the series has been closed off because tracking\r\n // stopped, the survey changed or its date changed). Either way there is no later\r\n // ping coming to carry the points, so post now rather than sitting on them.\r\n this._clearDeferredPost();\r\n this._lastRemotePostStamp = Date.now();\r\n\r\n return this._saveLocalThenQueuePost(isSync);\r\n }\r\n\r\n return this._saveLocalDeferringPost();\r\n } else {\r\n return Promise.resolve();\r\n //return Promise.reject(`Track for survey ${this.surveyId} has already been saved.`);\r\n }\r\n }\r\n\r\n /**\r\n * Timer handle for a post that is waiting out remotePostIntervalMs.\r\n *\r\n * @type {number|null}\r\n * @private\r\n */\r\n _deferredPostHandle = null;\r\n\r\n /**\r\n * When the last post was queued (not when it succeeded). A failed post backs off for a further\r\n * interval rather than being retried every ping; App.syncAll() is the retry path.\r\n *\r\n * Starts at 0 so that the first save of a new track posts straight away, which gets the track\r\n * on the server early rather than leaving the first few minutes of a route with no remote copy.\r\n *\r\n * @type {number}\r\n * @private\r\n */\r\n _lastRemotePostStamp = 0;\r\n\r\n /**\r\n * Makes the track durable on the device now, and lets the remote post wait for the interval.\r\n *\r\n * @returns {Promise}\r\n * @private\r\n */\r\n _saveLocalDeferringPost() {\r\n return this._storeLocallyRecordingOutcome()\r\n .then((localFailure) => {\r\n if (localFailure) {\r\n // Local storage is now the one place the points are not, so neither hold the\r\n // post back nor skip it for being offline - as in\r\n // Model._saveLocalThenQueuePost(), a long-odds attempt beats nothing.\r\n this._clearDeferredPost();\r\n this._lastRemotePostStamp = Date.now();\r\n this._queueDeferredPost();\r\n\r\n return Promise.reject(localFailure);\r\n }\r\n\r\n this._scheduleDeferredPost();\r\n });\r\n }\r\n\r\n /**\r\n * @private\r\n */\r\n _scheduleDeferredPost() {\r\n if (this._deferredPostHandle) {\r\n return; // a post is already waiting, and it will carry whatever has accumulated by then\r\n }\r\n\r\n const dueInMs = Math.max(0, (this._lastRemotePostStamp + Track.remotePostIntervalMs) - Date.now());\r\n\r\n this._deferredPostHandle = setTimeout(() => {\r\n this._deferredPostHandle = null;\r\n this._flushDeferredPost();\r\n }, dueInMs);\r\n }\r\n\r\n /**\r\n * @private\r\n */\r\n _clearDeferredPost() {\r\n if (this._deferredPostHandle) {\r\n clearTimeout(this._deferredPostHandle);\r\n this._deferredPostHandle = null;\r\n }\r\n }\r\n\r\n /**\r\n * Posts whatever has accumulated since the last post.\r\n *\r\n * @private\r\n */\r\n _flushDeferredPost() {\r\n // Stamped whether or not a post actually follows, so that a track which cannot currently be\r\n // posted backs off for a further interval instead of retrying on every ping.\r\n this._lastRemotePostStamp = Date.now();\r\n\r\n if (!this.unsaved()) {\r\n // already carried to the server by a sync or a forced save while this was waiting\r\n return;\r\n }\r\n\r\n if (globalThis.navigator?.onLine === false) {\r\n // Same reasoning as Model._saveLocalThenQueuePost(): a post that cannot succeed only\r\n // occupies the queue and fills the log buffer. The points are in local storage and\r\n // App.syncAll() posts them when the connection returns.\r\n console.info(`Offline, so deferring the remote save of the track for survey ${this.surveyId} to the next sync.`);\r\n return;\r\n }\r\n\r\n this._queueDeferredPost();\r\n }\r\n\r\n /**\r\n * @private\r\n */\r\n _queueDeferredPost() {\r\n // noinspection JSIgnoredPromiseFromCall\r\n this.queuePost(false)\r\n .catch((reason) => {\r\n // @intentional Remote failure is routine in the field. The track keeps savedRemotely\r\n // false and will be retried by App.syncAll() from local storage.\r\n console.info(`Deferred remote save pending for track for survey ${this.surveyId}: ${Logger.stringifyObject(reason)}`);\r\n });\r\n }\r\n\r\n storeLocally() {\r\n return this._storeLocalData({\r\n surveyId : this.surveyId,\r\n deviceId : this.deviceId,\r\n type : this.TYPE,\r\n attributes : this.attributes,\r\n created : this.createdStamp,\r\n modified : this.modifiedStamp,\r\n saveState : this._savedRemotely ? SAVE_STATE_SERVER : SAVE_STATE_LOCAL, // derived from the flag; there is no saveState property\r\n deleted : this.deleted,\r\n projectId : this.projectId,\r\n userId : this.userId,\r\n pointIndex : this.pointIndex,\r\n points : this.points,\r\n });\r\n }\r\n\r\n /**\r\n *\r\n * @returns {FormData}\r\n */\r\n formData() {\r\n const formData = new FormData;\r\n\r\n formData.append('type', this.TYPE);\r\n formData.append('surveyId', this.surveyId);\r\n formData.append('deviceId', this.deviceId);\r\n formData.append('id', `${this.surveyId}.${this.deviceId}`);\r\n formData.append('projectId', this.projectId?.toString?.() || '');\r\n formData.append('pointIndex', this.pointIndex.toString());\r\n formData.append('points', JSON.stringify(this.points));\r\n formData.append('attributes', JSON.stringify(this.attributes));\r\n formData.append('created', this.createdStamp?.toString?.() || '');\r\n formData.append('modified', this.modifiedStamp?.toString?.() || '');\r\n\r\n if (this.userId) {\r\n formData.append('userId', this.userId);\r\n }\r\n\r\n formData.append('appVersion', Model.bsbiAppVersion);\r\n\r\n return formData;\r\n }\r\n\r\n /**\r\n *\r\n * @param {{\r\n * id : string,\r\n * saveState: string,\r\n * attributes: Object.,\r\n * deleted: boolean|string,\r\n * created: number,\r\n * modified: number,\r\n * projectId: number,\r\n * surveyId: string,\r\n * deviceId: string,\r\n * pointIndex: string,\r\n * points: string | Array,\r\n * }} descriptor\r\n * @param {string|Array} descriptor.points JSON-serialised Array or native array\r\n */\r\n _parseDescriptor(descriptor) {\r\n super._parseDescriptor(descriptor);\r\n this.surveyId = descriptor.surveyId;\r\n this.deviceId = descriptor.deviceId;\r\n this.pointIndex = parseInt(descriptor.pointIndex, 10);\r\n\r\n if (typeof descriptor.pointIndex === 'string') {\r\n // uncertain if this is ever relevant\r\n this.points = JSON.parse(descriptor.points);\r\n } else {\r\n this.points = descriptor.points;\r\n }\r\n }\r\n\r\n /**\r\n *\r\n *\r\n * Listen for survey changes (e.g. to date) that might abort tracking\r\n *\r\n * surveyId and deviceId will already have been set\r\n * The track must already have been added to Track._tracks\r\n *\r\n * sets Track._currentlyTrackedSurveyId and Track._currentlyTrackedDeviceId\r\n *\r\n * @param {Survey} survey\r\n *\r\n */\r\n registerSurvey(survey) {\r\n if (!survey) {\r\n throw new Error('Attempt to register null survey in Track.registerSurvey()');\r\n }\r\n\r\n Track._currentlyTrackedSurveyId = this.surveyId;\r\n Track._currentlyTrackedDeviceId = Track._app.deviceId;\r\n Track.lastPingStamp = 0;\r\n\r\n if (survey.attributes.casual) {\r\n throw new Error('Attempt to register tracking for casual survey.');\r\n }\r\n\r\n // listener handles start at zero, so test must be for undefined rather than a simple boolean\r\n if (undefined === this._surveyChangeListenerHandle) {\r\n this._surveyChangeListenerHandle = survey.addListener(SURVEY_EVENT_MODIFIED, () => {\r\n // need to check for change to date\r\n\r\n if (Track.trackingIsActive && survey.id === Track._currentlyTrackedSurveyId) {\r\n if (!survey.isToday()) {\r\n this.endCurrentSeries(TRACK_END_REASON_SURVEY_DATE);\r\n\r\n // Forced, as with the other two places that close off a series: tracking is\r\n // about to become inactive, so there is no later ping to carry the points\r\n // and no reason to hold the post back.\r\n this.save(true).then(() => {\r\n console.log(`Tracking for survey ${this.surveyId} saved following survey date change.`)\r\n // @intentional end of chain\r\n }, (e) => {\r\n console.error(`Failed to save track for survey ${this.surveyId} following survey date change: ${Logger.stringifyObject(e)}`);\r\n // @intentional end of chain\r\n });\r\n\r\n Track._currentlyTrackedSurveyId = null;\r\n Track._currentlyTrackedDeviceId = null;\r\n Track.trackingIsActive = false;\r\n }\r\n }\r\n });\r\n }\r\n\r\n if (undefined === this._surveyOccurrencesChangeListenerHandle) {\r\n this._surveyOccurrencesChangeListenerHandle = survey.addListener(SURVEY_EVENT_OCCURRENCES_CHANGED, () => {\r\n // If occurrences have changed, then worth ensuring that tracking is up to date.\r\n\r\n this.isPristine = false; // probably not required, but safety fallback to ensure that the track is saved\r\n\r\n if (Track.trackingIsActive && survey.id === Track._currentlyTrackedSurveyId && !this.isPristine && this.unsaved()) {\r\n this.save().then(() => {\r\n console.log(`Tracking for survey ${this.surveyId} saved following occurrence change.`);\r\n // @intentional end of chain\r\n }, (e) => {\r\n console.error(`Failed to save track for survey ${this.surveyId} following occurrence change: ${Logger.stringifyObject(e)}`);\r\n // @intentional end of chain\r\n });\r\n }\r\n });\r\n }\r\n\r\n if (undefined === this._surveyDestroyedListenerHandle) {\r\n this._surveyDestroyedListenerHandle = survey.addListener(MODEL_EVENT_DESTROYED, () => {\r\n this.removeSurveyChangeListener();\r\n })\r\n }\r\n }\r\n\r\n removeSurveyChangeListener() {\r\n const survey = Track._app.surveys.get(this.surveyId);\r\n\r\n survey?.removeListener?.(SURVEY_EVENT_MODIFIED, this._surveyChangeListenerHandle);\r\n this._surveyChangeListenerHandle = undefined;\r\n\r\n survey?.removeListener?.(SURVEY_EVENT_MODIFIED, this._surveyOccurrencesChangeListenerHandle);\r\n this._surveyOccurrencesChangeListenerHandle = undefined;\r\n\r\n survey?.removeListener?.(MODEL_EVENT_DESTROYED, this._surveyDestroyedListenerHandle);\r\n this._surveyDestroyedListenerHandle = undefined;\r\n }\r\n\r\n static _geoWatchTimerFlag = null;\r\n\r\n /**\r\n * If true, then are probably at a gridsquare transition and want a new position reading immediately,\r\n * overriding the usual time and distance constraints.\r\n * @type {boolean}\r\n */\r\n static wantImmediateNewReading = false;\r\n\r\n static clearGeowatchThrottle() {\r\n if (Track._geoWatchTimerFlag) {\r\n clearTimeout(Track._geoWatchTimerFlag);\r\n Track._geoWatchTimerFlag = null;\r\n Track.wantImmediateNewReading = true;\r\n }\r\n }\r\n}\r\n","// a Survey captures the currentSurvey meta-data\r\n// i.e. it captures site details (name, location); user details (name, email)\r\n//\r\n// If a user were to submit multiple surveys, then they could end up in the contact database multiple times.\r\n// This is probably unavoidable. Not worth the effort and risk of automatic de-duplication. Email preferences would be\r\n// shared, keyed by email.\r\n\r\nimport {Model, uuid} from \"./Model\";\r\nimport {escapeHTML} from \"../utils/escapeHTML\";\r\nimport {GridRef} from 'british-isles-gridrefs'\r\nimport {Track} from \"./Track\";\r\nimport {SURVEY_EVENT_MODIFIED, SURVEY_EVENT_DELETED} from \"../framework/AppEvents\";\r\nimport {Logger} from \"../utils/Logger\";\r\nimport {GEOREF_SOURCE_AREA, GEOREF_SOURCE_UNKNOWN,\r\n PROJECT_ID_PHENOLOGY, PROJECT_ID_SCM, PROJECT_ID_TRANSCRIPTION, PROJECT_ID_PLANT_ALERT,\r\n SAVE_STATE_LOCAL, SAVE_STATE_SERVER} from \"../utils/constants\";\r\n\r\n/**\r\n * fired on Survey when one of its occurrences has been added, deleted or reloaded\r\n *\r\n * no parameters\r\n *\r\n * @type {string}\r\n */\r\nexport const SURVEY_EVENT_LIST_LENGTH_CHANGED = 'listlengthchanged';\r\n\r\n/**\r\n * parameter is {currentHectadSubunit: string}\r\n *\r\n * @type {string}\r\n */\r\nexport const SURVEY_EVENT_TETRAD_SUBUNIT_CHANGED = 'tetradsubunitchanged';\r\n\r\nexport const SAMPLE_UNIT_CENTROID = 'centroid';\r\nexport const SAMPLE_UNIT_OTHER = 'other';\r\nexport const SAMPLE_UNIT_AREA = 'area';\r\n\r\n// /**\r\n// * fired from Survey when the object's contents have been modified\r\n// *\r\n// * parameter is {surveyId : string}\r\n// *\r\n// * @type {string}\r\n// */\r\n// export const SURVEY_EVENT_MODIFIED = 'modified';\r\n\r\n/**\r\n * @typedef {import('bsbi-app-framework-view').SurveyForm} SurveyForm\r\n */\r\n\r\nexport class Survey extends Model {\r\n\r\n /**\r\n * mirrors constructor.name but doesn't get mangled by minification\r\n *\r\n * @type {string}\r\n */\r\n static className = 'Survey';\r\n\r\n // /**\r\n // * fired from Survey when the object's contents have been modified\r\n // *\r\n // * parameter is {surveyId : string}\r\n // *\r\n // * @type {string}\r\n // */\r\n // static EVENT_MODIFIED = SURVEY_EVENT_MODIFIED;\r\n\r\n // /**\r\n // * fired on Survey when one of its occurrences has been modified, added, deleted or reloaded\r\n // *\r\n // * no parameters\r\n // *\r\n // * @type {string}\r\n // */\r\n // static EVENT_OCCURRENCES_CHANGED = SURVEY_EVENT_OCCURRENCES_CHANGED;\r\n\r\n // /**\r\n // * fired on Survey when one of its occurrences has been added, deleted or reloaded\r\n // *\r\n // * no parameters\r\n // *\r\n // * @type {string}\r\n // */\r\n // static EVENT_LIST_LENGTH_CHANGED = 'listlengthchanged';\r\n\r\n // /**\r\n // * parameter is {currentHectadSubunit : string}\r\n // *\r\n // * @type {string}\r\n // */\r\n // static EVENT_TETRAD_SUBUNIT_CHANGED = 'tetradsubunitchanged';\r\n\r\n SAVE_ENDPOINT = '/savesurvey.php';\r\n\r\n TYPE = 'survey';\r\n\r\n /**\r\n *\r\n * @type {{\r\n * [sampleUnit] : {selection : Array, [precision] : number}\r\n * [georef] : {\r\n * rawString: string,\r\n * precision: number|null,\r\n * source: string|null,\r\n * gridRef: string,\r\n * latLng: {lat : number, lng : number}|null,\r\n * [defaultSurveyGridRef]: string|null,\r\n * [defaultSurveyPrecision]: number|null\r\n * },\r\n * [date] : string|null,\r\n * [place] : string|null,\r\n * [recorders] : Array<{}>|null,\r\n * [surveyName] : string|null,\r\n * [casual] : \"1\"|null,\r\n * [defaultCasual] : true|null,\r\n * [vc] : {selection : Array, inferred: (boolean|null)}|null,\r\n * [nulllist] : boolean,\r\n * [listname] : string,\r\n * [area] : {\r\n * areaName: string,\r\n * areaId: string,\r\n * areaType: string,\r\n * [unitId]: string,\r\n * [unitNumber]: number|null\r\n * },\r\n * [surveyTemplate] : string,\r\n * }}\r\n */\r\n attributes = {};\r\n\r\n /**\r\n * How the survey's editor was configured, as against what the survey contains.\r\n *\r\n * The distinction from `attributes` is the whole point of having two properties, and it is easy to\r\n * blur: `attributes` is the survey - its place, its date, what was recorded - and belongs to the\r\n * record. `metadata` is the arrangement of the tool the record was typed into, which is not part of\r\n * the observation but is needed to read the result back years later: a set of transcribed records\r\n * cannot be interpreted without knowing which columns were in use.\r\n *\r\n * It is not a per-user display preference. Column widths and display density stay in the app's own\r\n * options, because those describe somebody's screen rather than anything about the survey.\r\n *\r\n * The shape is the caller's business - the framework neither reads nor validates it. The transcription\r\n * grid's use of it is defined in apps/recording/src/utils/transcriptionMetadata.js.\r\n *\r\n * @type {Object}\r\n */\r\n metadata = {};\r\n\r\n /**\r\n * if set, then provide default values (e.g. GPS look-up of current geo-reference)\r\n *\r\n * @type {boolean}\r\n */\r\n isNew = false;\r\n\r\n /**\r\n * kludge to flag once the App singleton has set up a listener for changes on the survey\r\n *\r\n * @type {boolean}\r\n */\r\n hasAppModifiedListener = false;\r\n\r\n /**\r\n * kludge to flag once the App singleton has set up a listener for deletion on the survey\r\n *\r\n * @type {boolean}\r\n */\r\n hasDeleteListener = false;\r\n\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n userId = '';\r\n\r\n /**\r\n *\r\n * @type {Track|null}\r\n * @private\r\n */\r\n _track = null;\r\n\r\n /**\r\n * Used to tie together linked surveys\r\n * (e.g. deliberately duplicated, or generated automatically by movement to a new grid-square)\r\n *\r\n * Tracking of location can continue seamlessly across linked surveys.\r\n *\r\n * @type {string}\r\n */\r\n _baseSurveyId = '';\r\n\r\n /**\r\n *\r\n * @returns {({rawString: string, precision: number|null, source: string|null, gridRef: string, latLng: ({lat: number, lng: number}|null)}|null)}\r\n */\r\n get geoReference() {\r\n return this.attributes.georef || {\r\n gridRef: '',\r\n rawString: '', // the string provided by the user to generate this grid-ref (might be a postcode or placename)\r\n source: GEOREF_SOURCE_UNKNOWN,\r\n latLng: null,\r\n precision: null\r\n };\r\n };\r\n\r\n\r\n\r\n /**\r\n * @returns {string}\r\n */\r\n get baseSurveyId() {\r\n if (!this._baseSurveyId || this._baseSurveyId === 'undefined') {\r\n this._baseSurveyId = this._id;\r\n }\r\n\r\n return this._baseSurveyId;\r\n }\r\n\r\n /**\r\n *\r\n * @param {string} id\r\n */\r\n set baseSurveyId(id) {\r\n this._baseSurveyId = id;\r\n }\r\n\r\n /**\r\n * string\r\n */\r\n get id() {\r\n if (!this._id) {\r\n this._id = uuid();\r\n\r\n if (!this._baseSurveyId) {\r\n this._baseSurveyId = this._id;\r\n }\r\n } else if (this._id === 'undefined') {\r\n console.error(\"id is literal 'undefined', am forcing new id\");\r\n this._id = uuid();\r\n\r\n if (!this._baseSurveyId) {\r\n this._baseSurveyId = this._id;\r\n }\r\n }\r\n\r\n return this._id;\r\n }\r\n\r\n /**\r\n * Set for tetrad-structured surveys, where the user may be working within a monad subdivision\r\n *\r\n * @type {string}\r\n */\r\n currentTetradSubunit = '';\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * Get a summarised geo-ref from the survey geo-reference, based on the survey unit type and precision.\r\n * If the user has explicitly specified a centroid-based survey, then the result will instead be a centroid.\r\n *\r\n * For structured tetrad surveys squareReference will return the currently selected monad within the tetrad (or tetrad if 2 km scale selected)\r\n * For monad or 100 m square surveys will return grid-ref at that resolution\r\n *\r\n * @returns {({rawString: string, precision: number|null, source: string|null, gridRef: string, latLng: ({lat: number, lng: number}|null)}|null)}\r\n */\r\n get summaryReference() {\r\n if (this.attributes.sampleUnit?.selection?.[0]) {\r\n let n = parseInt(this.attributes.sampleUnit.selection[0], 10);\r\n\r\n if (n > 0) {\r\n // have user-specified square precision value\r\n\r\n if (n === 2000 && this.currentTetradSubunit) {\r\n // special-case treatment of tetrad surveys using a monad subdivision\r\n\r\n return {\r\n gridRef: this.currentTetradSubunit,\r\n rawString: this.currentTetradSubunit,\r\n source: GEOREF_SOURCE_UNKNOWN,\r\n latLng: null,\r\n precision: /[A-Z]$/.test(this.currentTetradSubunit) ? 2000 : 1000\r\n }\r\n }\r\n\r\n const ref = this.geoReference;\r\n const gridRef = GridRef.fromString(ref.gridRef);\r\n\r\n if (gridRef && gridRef.length <= n) {\r\n const newRef = gridRef.gridCoords.toGridRefString(n);\r\n\r\n if (n === 2000) {\r\n this.currentTetradSubunit = newRef;\r\n } else {\r\n this.currentTetradSubunit = '';\r\n }\r\n\r\n return {\r\n gridRef: newRef,\r\n rawString: newRef,\r\n source: GEOREF_SOURCE_UNKNOWN,\r\n latLng: null,\r\n precision: n\r\n }\r\n } else {\r\n return {\r\n gridRef: '',\r\n rawString: '',\r\n source: GEOREF_SOURCE_UNKNOWN,\r\n latLng: null,\r\n precision: null\r\n }\r\n }\r\n } else {\r\n switch (this.attributes.sampleUnit.selection[0]) {\r\n case SAMPLE_UNIT_CENTROID:\r\n const centroidGeoref = this.geoReference; // avoid calling getter repeatedly\r\n\r\n return {\r\n gridRef: centroidGeoref.gridRef,\r\n rawString: '',\r\n source: GEOREF_SOURCE_UNKNOWN,\r\n latLng: centroidGeoref.latLng,\r\n precision: this.attributes.sampleUnit.precision || 1000\r\n };\r\n\r\n case SAMPLE_UNIT_AREA:\r\n const areaGeoref = this.geoReference; // avoid calling getter repeatedly\r\n\r\n return {\r\n gridRef: areaGeoref.gridRef,\r\n rawString: '',\r\n source: GEOREF_SOURCE_AREA,\r\n latLng: areaGeoref.latLng,\r\n precision: areaGeoref.precision\r\n };\r\n\r\n case SAMPLE_UNIT_OTHER:\r\n return this._infer_square_ref_from_survey_ref();\r\n\r\n default:\r\n throw new Error(`Unrecognized sample unit value '${this.attributes.sampleUnit.selection[0]}'`);\r\n }\r\n }\r\n } else {\r\n return this._infer_square_ref_from_survey_ref();\r\n }\r\n }\r\n\r\n /**\r\n *\r\n * @returns {{rawString: string, precision: null, source: string, gridRef: string, latLng: null}|{rawString, precision: null, source: string, gridRef, latLng: null}}\r\n * @private\r\n */\r\n _infer_square_ref_from_survey_ref() {\r\n if (this.attributes.georef?.gridRef && this.attributes.georef.precision <= 2000) {\r\n let newRef;\r\n\r\n if (this.attributes.georef.precision === 2000 || this.attributes.georef.precision === 1000) {\r\n newRef = this.attributes.georef.gridRef;\r\n } else {\r\n // this is really inefficient\r\n const context = this.getGeoContext();\r\n newRef = context.monad || context.tetrad;\r\n }\r\n\r\n return {\r\n gridRef: newRef,\r\n rawString: newRef,\r\n source: GEOREF_SOURCE_UNKNOWN,\r\n latLng: null,\r\n precision: this.attributes.georef.precision\r\n }\r\n } else {\r\n return {\r\n gridRef: '',\r\n rawString: '', // what was provided by the user to generate this grid-ref (might be a postcode or placename)\r\n source: GEOREF_SOURCE_UNKNOWN,\r\n latLng: null,\r\n precision: null\r\n }\r\n }\r\n }\r\n\r\n /**\r\n *\r\n * @returns {string}\r\n */\r\n get date() {\r\n return this.attributes.date || '';\r\n }\r\n\r\n /**\r\n * returns the survey date string, with special formatting for 'today' and 'yesterday'\r\n *\r\n * @returns {string}\r\n */\r\n get prettyDate() {\r\n const date = this.attributes.date || '';\r\n const today = new Date;\r\n\r\n if (date === today.toISOString().slice(0,10)) {\r\n return 'today';\r\n } else if (date === (new Date(today.valueOf() - (3600*24*1000))).toISOString().slice(0,10)) {\r\n return 'yesterday';\r\n } else {\r\n return date;\r\n }\r\n }\r\n\r\n /**\r\n * Returns true or false based on date compatibility or null if the survey is undated (e.g. ongoing casual)\r\n * @param {string} [today] (iso YYYY-MM-DD) defaults to current day\r\n * @returns {boolean|null}\r\n */\r\n isToday(today = (new Date).toISOString().slice(0,10)) {\r\n const date = this.date;\r\n\r\n return date === '' ? null : (date === today);\r\n }\r\n\r\n /**\r\n * Returns true or false based on date compatibility or null if the survey is undated (e.g. ongoing casual)\r\n *\r\n * @returns {boolean}\r\n */\r\n createdInCurrentYear() {\r\n const yearString = new Date(this.createdStamp * 1000).toISOString().slice(0,4);\r\n\r\n return yearString === (new Date).toISOString().slice(0,4);\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * Returns true or false based on date compatibility or null if the survey is undated (e.g. ongoing casual)\r\n *\r\n * @returns {boolean}\r\n */\r\n createdInCurrentOrFutureYear() {\r\n const surveyYear = parseInt(new Date(this.createdStamp * 1000).toISOString().slice(0,4), 10);\r\n\r\n return surveyYear >= parseInt((new Date).toISOString().slice(0,4), 10);\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n get place() {\r\n return this.attributes.place || '';\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * called after the form has changed, before the values have been read back in to the object.\r\n * read new values\r\n * validate\r\n * then fire its own change event (Survey.EVENT_MODIFIED)\r\n * @param {{form: SurveyForm}} params\r\n */\r\n formChangedHandler(params) {\r\n console.log('Survey change handler invoked.');\r\n\r\n const form = params.form;\r\n // noinspection JSValidateTypes\r\n params = null;\r\n\r\n form.updateModelFromContent().then(() => {\r\n\r\n console.log('Survey calling conditional validation.');\r\n\r\n try {\r\n // refresh the form's validation state\r\n form.conditionallyValidateForm();\r\n } catch (error) {\r\n console.error({'error caught in Survey, form.conditionallyValidateForm' : error});\r\n }\r\n\r\n this.touch();\r\n this.fireEvent(SURVEY_EVENT_MODIFIED, {surveyId: this.id});\r\n // @intentional end of chain\r\n })\r\n .catch((error) => {\r\n // if updateModelFromContent() fails, due to user rejection of dialogue box then intentionally don't want the survey to save\r\n console.log({\"In survey form handler promise rejected (probably normal cancellation of dialogue box)\" : error});\r\n // @intentional end of chain\r\n });\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * Used for special-case setting of a custom attribute\r\n * (i.e. not usually one linked to a form)\r\n * e.g. used for updating the NYPH null-list flag\r\n *\r\n * @param attributeName\r\n * @param value\r\n */\r\n setAttribute(attributeName, value) {\r\n if (this.attributes[attributeName] !== value) {\r\n this.attributes[attributeName] = value;\r\n\r\n this.touch();\r\n this.fireEvent(SURVEY_EVENT_MODIFIED, {surveyId : this.id});\r\n }\r\n }\r\n\r\n /**\r\n * Sets a key of the editor-configuration metadata, marking the survey modified if it really changed.\r\n *\r\n * Compared by serialisation rather than by `!==` as `setAttribute` does. The values here are arrays and\r\n * objects - a list of columns, a list of attribute keys - so identity comparison would report a change\r\n * on every write, and a survey would be touched and queued for saving each time its editor was rebuilt\r\n * with the configuration it already had.\r\n *\r\n * @param {string} key\r\n * @param {*} value\r\n * @returns {boolean} whether anything changed\r\n */\r\n setMetadata(key, value) {\r\n const before = JSON.stringify(this.metadata?.[key] ?? null);\r\n const after = JSON.stringify(value ?? null);\r\n\r\n if (before === after) {\r\n return false;\r\n }\r\n\r\n if (!this.metadata || 'object' !== typeof this.metadata) {\r\n this.metadata = {};\r\n }\r\n\r\n this.metadata[key] = value;\r\n\r\n this.touch();\r\n this.fireEvent(SURVEY_EVENT_MODIFIED, {surveyId : this.id});\r\n\r\n return true;\r\n }\r\n\r\n /**\r\n * Whether taxon localisation should follow the individual record rather than the survey.\r\n *\r\n * True where records are gathered under a survey that has no location of its own, so each one\r\n * carries its own grid reference: casual records, and transcribed records typed in from somebody\r\n * else's list. For those, getGeoContext() here has nothing to report, and the equivalent on\r\n * Occurrence is the one to ask.\r\n *\r\n * @returns {boolean}\r\n */\r\n get geoContextFollowsOccurrence() {\r\n return !!this.attributes.casual\r\n || PROJECT_ID_TRANSCRIPTION === this.projectId\r\n || PROJECT_ID_PLANT_ALERT === this.projectId;\r\n }\r\n\r\n /**\r\n * returns interpreted grid-ref / vc summary, used to look up metadata for the taxon list\r\n *\r\n * @return {{\r\n * hectad : string,\r\n * tetrad : string,\r\n * monad : string,\r\n * hectare : string,\r\n * country : 'GB'|'IE'|'CI'|'',\r\n * vc : string[],\r\n * interleavedGridRef : string,\r\n * [surveyGridUnit] : number,\r\n * [hectare] : string,\r\n * [areaId] : string,\r\n * [unitId] : string,\r\n * }}\r\n */\r\n getGeoContext() {\r\n const geoRef = this.geoReference;\r\n\r\n const result = {};\r\n\r\n if (this.attributes.vc?.selection) {\r\n result.vc = [...this.attributes.vc.selection]; // clone rather than reference the VC selection\r\n } else {\r\n result.vc = [];\r\n }\r\n\r\n const sampleUnit = this.attributes.sampleUnit?.selection?.[0];\r\n const surveyGridUnit = parseInt(sampleUnit, 10) || null;\r\n\r\n if (surveyGridUnit) {\r\n result.surveyGridUnit = surveyGridUnit;\r\n }\r\n\r\n if (sampleUnit === SAMPLE_UNIT_AREA) {\r\n const areaId = this.attributes?.area?.areaId;\r\n\r\n // both areaId and unitId are needed separately\r\n if (areaId) {\r\n result.areaId = areaId;\r\n\r\n if (this.attributes?.area?.unitId) {\r\n result.unitId = this.attributes?.area?.unitId;\r\n }\r\n }\r\n }\r\n\r\n if (geoRef?.gridRef) {\r\n const gridRef = GridRef.fromString(geoRef.gridRef);\r\n\r\n if (gridRef) {\r\n result.precision = gridRef.length;\r\n\r\n if (gridRef.length <= 100 && surveyGridUnit && surveyGridUnit <= 100) {\r\n result.hectare = gridRef.gridCoords.toGridRefString(100);\r\n }\r\n\r\n if (gridRef.length <= 1000 && surveyGridUnit && surveyGridUnit <= 1000) {\r\n result.monad = gridRef.gridCoords.toGridRefString(1000);\r\n }\r\n\r\n if (gridRef.length <= 2000) {\r\n result.tetrad = gridRef.gridCoords.toGridRefString(2000);\r\n }\r\n\r\n result.country = gridRef.country;\r\n }\r\n\r\n result.hectad = gridRef.gridCoords.toGridRefString(10000);\r\n\r\n result.interleavedGridRef = GridRef.interleave(geoRef.gridRef);\r\n }\r\n\r\n return {...{hectad : '', tetrad : '', monad : '', hectare : '', country : '', vc : [], interleavedGridRef : '', precision : null}, ...result};\r\n }\r\n\r\n /**\r\n * if not securely saved, then makes a post to /savesurvey.php\r\n *\r\n * this will be intercepted by a service worker,\r\n * a successful save will result in a JSON response containing the uri from which the object may be retrieved\r\n * and also the state of persistence (whether or not the object was intercepted by a service worker while offline)\r\n *\r\n * if saving fails, then the expectation is that there is no service worker, in which case should attempt to write\r\n * the object directly to indexeddb\r\n *\r\n * must test indexeddb for this eventuality after the save has returned\r\n *\r\n * @param {boolean} forceSave\r\n * @param {boolean} [isSync]\r\n * @param {{}} [params]\r\n *\r\n * @returns {Promise}\r\n */\r\n save(forceSave = false, isSync = false, params) {\r\n if (forceSave || this.unsaved()) {\r\n return this._saveLocalThenQueuePost(isSync);\r\n } else {\r\n return Promise.reject(`Survey ${this.id} has already been saved.`);\r\n }\r\n }\r\n\r\n /**\r\n *\r\n * @returns {FormData}\r\n */\r\n formData() {\r\n const formData = new FormData;\r\n\r\n formData.append('type', this.TYPE);\r\n formData.append('surveyId', this.id);\r\n formData.append('id', this.id); // this is incorrect duplication\r\n formData.append('projectId', this.projectId?.toString?.() || '');\r\n formData.append('attributes', JSON.stringify(this.attributes));\r\n formData.append('metadata', JSON.stringify(this.metadata || {}));\r\n formData.append('deleted', this.deleted.toString());\r\n formData.append('created', this.createdStamp?.toString?.() || '');\r\n formData.append('modified', this.modifiedStamp?.toString?.() || '');\r\n formData.append('baseSurveyId', this.baseSurveyId || this.id);\r\n\r\n if (this.userId) {\r\n formData.append('userId', this.userId);\r\n }\r\n\r\n formData.append('appVersion', Model.bsbiAppVersion);\r\n\r\n return formData;\r\n }\r\n\r\n /**\r\n *\r\n * @returns {Promise}\r\n */\r\n storeLocally() {\r\n return this._storeLocalData({\r\n id : this.id,\r\n surveyId : this.id, // unsure which id key should be preferred\r\n baseSurveyId : this.baseSurveyId || this.id,\r\n type : this.TYPE,\r\n attributes : this.attributes,\r\n metadata : this.metadata,\r\n created : this.createdStamp,\r\n modified : this.modifiedStamp,\r\n saveState : this._savedRemotely ? SAVE_STATE_SERVER : SAVE_STATE_LOCAL, // derived from the flag; there is no saveState property\r\n deleted : this.deleted,\r\n projectId : this.projectId,\r\n userId : this.userId,\r\n });\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * Low-level deletion of the survey.\r\n * Does not test whether there are extant occurrences.\r\n *\r\n */\r\n delete() {\r\n if (!this.deleted) {\r\n this.touch();\r\n this.deleted = true;\r\n this.save()\r\n .catch((reason) => {\r\n console.error(reason);\r\n // @intentional no throw needed at end of chain\r\n })\r\n .finally(() => {\r\n this.fireEvent(SURVEY_EVENT_DELETED, {surveyId : this.id});\r\n // @intentional end of promise chain\r\n });\r\n }\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * @param {{\r\n * [summarySquarePrecision] : number,\r\n * [summarizeTetrad] : boolean\r\n * [includeSegment] : boolean\r\n * }} options\r\n * @param {App|null} [app]\r\n * @returns {string} an html-safe string based on the locality and creation date\r\n */\r\n generateSurveyName(options = {\r\n summarySquarePrecision : 1000,\r\n summarizeTetrad : false,\r\n }, app = null) {\r\n\r\n if (this.attributes.casual || PROJECT_ID_TRANSCRIPTION === this.projectId) {\r\n // Surveys that have no locality or date of their own, so there is nothing for the branch below\r\n // to build a name out of: casual records, and transcribed records typed in from someone else's\r\n // list. Both carry a name the user gave them, and fall back to when they were started.\r\n //\r\n // Transcribed surveys used to fall through to the place-and-date branch, which reads\r\n // `listname` and never `surveyName` - so one named \"J. Smith field notebook 1954\" appeared in\r\n // every survey list as \"(unlocalised) 7 August 2026\", with nothing to tell one from another.\r\n //\r\n // `geoContextFollowsOccurrence` above states the same idea for a different purpose and covers\r\n // plant-alert as well. Deliberately not reused here: whether that app's surveys should also be\r\n // named this way is a question for that app, and this fixes only what was reported broken.\r\n\r\n return this.attributes.surveyName ?\r\n escapeHTML(this.attributes.surveyName)\r\n :\r\n `Data-set created on ${this._createdDateString()}`;\r\n } else {\r\n let place;\r\n\r\n if (this.projectId === PROJECT_ID_SCM) {\r\n if (this.attributes.area?.areaName) {\r\n place = `${this.attributes.area?.areaName}${this.attributes.area?.unitNumber === null || this.attributes.area?.unitNumber === undefined ? '' : ` (unit ${this.attributes.area?.unitNumber})`}`; // @todo consider appending area type suffix\r\n } else {\r\n place = '(unlocalised)';\r\n }\r\n } else if (this.projectId === PROJECT_ID_PHENOLOGY) {\r\n if (app) {\r\n const surveyTemplate = app.surveyDefinitions.get(this.attributes.surveyTemplate);\r\n if (surveyTemplate) {\r\n place = surveyTemplate.getTitle();\r\n\r\n if (options.includeSegment) {\r\n const segmentNumber = this.attributes.segmentNumber || 0;\r\n const segmentData = surveyTemplate.getSegmentsMetaData()?.[this.attributes.segmentNumber];\r\n\r\n place += ` segment ${segmentData.segmentName || (segmentNumber + 1)}`;\r\n }\r\n } else {\r\n place = `Phenology survey ${this.id}`;\r\n }\r\n } else {\r\n place = `Phenology segment ${(this.attributes.segmentNumber || 0) + 1}`; // should rely on the survey template for pretty names\r\n }\r\n } else {\r\n if (this.attributes.place) {\r\n let summaryGridRef = this._summarySquareString(options.summarySquarePrecision);\r\n\r\n place = `${this.attributes.place}${summaryGridRef ? ` ${summaryGridRef}` : ''}`;\r\n } else if (this.attributes.georef?.gridRef) {\r\n place = this._summarySquareString(options.summarySquarePrecision);\r\n } else if (this.attributes.area?.areaName) {\r\n place = `${this.attributes.area?.areaName}${this.attributes.area?.unitNumber === null || this.attributes.area?.unitNumber === undefined ? '' : ` (unit ${this.attributes.area?.unitNumber})`}`; // @todo consider appending area type suffix\r\n } else {\r\n place = '(unlocalised)';\r\n }\r\n }\r\n\r\n let surveyName = '';\r\n if (this.attributes.listname) {\r\n surveyName = ` “${escapeHTML(this.attributes.listname)}”`;\r\n }\r\n\r\n return `${escapeHTML(place)}${surveyName} ${this.prettyDate || this._createdDateString()}`;\r\n }\r\n }\r\n\r\n /**\r\n * if the survey has a specified grid-unit, then use that instead of the fallBackPrecision option\r\n *\r\n * @param {number|null} fallBackPrecision\r\n * @returns {string}\r\n * @private\r\n */\r\n _summarySquareString(fallBackPrecision) {\r\n if (this.attributes.georef?.gridRef) {\r\n let sampleUnit;\r\n\r\n // '<' replacement used simplistically to sanitise against script injection\r\n const rawGridRef = this.attributes.georef.gridRef.replace(/[<&\\s]/g, '');\r\n\r\n if (this.attributes.sampleUnit) {\r\n sampleUnit = parseInt(this.attributes.sampleUnit?.selection[0], 10) || null;\r\n }\r\n\r\n const precision = sampleUnit || fallBackPrecision;\r\n\r\n if (precision) {\r\n const gridRef = GridRef.fromString(rawGridRef);\r\n\r\n return gridRef?.gridCoords?.toGridRefString?.(gridRef.length <= precision ? precision : gridRef.length) || this.attributes.georef.gridRef;\r\n } else {\r\n return rawGridRef;\r\n }\r\n } else {\r\n return '';\r\n }\r\n }\r\n\r\n _createdDateString() {\r\n const createdDate = new Date(this.createdStamp * 1000);\r\n let dateString;\r\n\r\n try {\r\n // 'default' locale fails on Edge\r\n dateString = createdDate.toLocaleString('default', {\r\n year: 'numeric',\r\n month: 'long',\r\n day: 'numeric'\r\n });\r\n } catch (e) {\r\n dateString = createdDate.toLocaleString('en-GB', {year: 'numeric', month: 'long', day: 'numeric'});\r\n }\r\n\r\n return dateString;\r\n }\r\n\r\n /**\r\n *\r\n * @type {Set}\r\n *\r\n */\r\n extantOccurrenceKeys = new Set();\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * @todo need to exclude deleted records\r\n * @returns {number}\r\n *\r\n */\r\n countRecords() {\r\n return this.extantOccurrenceKeys.size;\r\n }\r\n\r\n /**\r\n *\r\n * @param {{\r\n * id : string,\r\n * saveState: string,\r\n * [userId]: string,\r\n * attributes: Object.,\r\n * deleted: boolean|string,\r\n * created: (number|string),\r\n * modified: (number|string),\r\n * projectId: (number|string),\r\n * [baseSurveyId]: (string),\r\n * }} descriptor\r\n */\r\n _parseDescriptor(descriptor) {\r\n super._parseDescriptor(descriptor);\r\n this._baseSurveyId = descriptor.baseSurveyId;\r\n this._parseMetadata(descriptor.metadata);\r\n }\r\n\r\n /**\r\n * Mirrors Model._parseAttributes, which is the established handling for a JSON property of this kind:\r\n * it arrives as an object locally and can arrive as a string from the server.\r\n *\r\n * The array branch is the same defence `_parseAttributes` carries. Whether this endpoint shares that\r\n * habit of representing an empty object as an array is not known; costing one comparison to be right\r\n * either way is the better trade, and an editor configuration is empty far more often than a survey's\r\n * attributes ever are.\r\n *\r\n * @param {Object|string|Array|null|undefined} metadata\r\n * @private\r\n */\r\n _parseMetadata(metadata) {\r\n if ('string' === typeof metadata) {\r\n try {\r\n metadata = JSON.parse(metadata);\r\n } catch (error) {\r\n console.error({'Failed to parse survey metadata': {surveyId: this.id, error}});\r\n metadata = null;\r\n }\r\n }\r\n\r\n this.metadata = (metadata && !Array.isArray(metadata) && 'object' === typeof metadata) ? metadata : {};\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {{}} newAttributes\r\n * @param {{}} properties\r\n * @returns {Survey}\r\n */\r\n duplicate(newAttributes = {}, properties = {}) {\r\n const newSurvey = new Survey();\r\n\r\n // @todo need to be certain that are not cloning image attribute\r\n newSurvey.attributes = Object.assign(structuredClone(this.attributes), newAttributes);\r\n\r\n // A duplicate is made to carry on the same work, so it should open laid out the same way.\r\n newSurvey.metadata = structuredClone(this.metadata || {});\r\n\r\n if (newSurvey.attributes.hasOwnProperty('images') && newSurvey.attributes.images?.length > 0) {\r\n // reset to default value\r\n newSurvey.attributes.images = [];\r\n }\r\n\r\n newSurvey.userId = properties.hasOwnProperty('userId') ? properties.userId : this.userId;\r\n newSurvey.isPristine = true;\r\n newSurvey.isNew = false; // don't want GPS override of geo-ref\r\n newSurvey._savedLocally = false;\r\n newSurvey._savedRemotely = false;\r\n newSurvey.deleted = false;\r\n newSurvey.projectId = this.projectId;\r\n newSurvey.baseSurveyId = this.baseSurveyId;\r\n newSurvey.id; // trigger id generation\r\n\r\n return newSurvey;\r\n }\r\n\r\n // /**\r\n // * @param {number} modifiedStampWhenQueued\r\n // * @returns {boolean}\r\n // * @protected\r\n // */\r\n // _cannotSkipAsObsolete(modifiedStampWhenQueued) {\r\n // if (this._savedLocally && this.modifiedStamp > modifiedStampWhenQueued) {\r\n // // track has been updated since, so can skip saving an earlier iteration\r\n // console.info('Survey._cannotSkipAsObsolete: skipping save due to later update');\r\n // return false;\r\n // }\r\n // return true;\r\n // }\r\n\r\n /**\r\n *\r\n * @param {App} app\r\n * @returns {Track}\r\n */\r\n initialiseNewTracker(app) {\r\n const track = new Track();\r\n track.surveyId = this.id;\r\n track.deviceId = app.deviceId;\r\n\r\n // In some cases more than one project id may be in use (e.g. RecordingApp v's NYPH),\r\n // so use the survey rather than app project id as the source-of-truth\r\n track.projectId = this.projectId;\r\n //track.projectId = app.projectId;\r\n track.isPristine = true;\r\n\r\n this.track = track;\r\n track.registerSurvey(this);\r\n\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logMessageDev(`Starting tracking of survey id '${this.id}'`);\r\n\r\n return track;\r\n }\r\n\r\n /**\r\n * returns the currently active track (other tracks may exist if the survey has shifted between devices etc.)\r\n *\r\n * @returns {Track|null}\r\n */\r\n get track() {\r\n return this._track;\r\n }\r\n\r\n /**\r\n *\r\n * @param {Track|null} track\r\n */\r\n set track(track) {\r\n this._track = track;\r\n }\r\n\r\n /**\r\n *\r\n * @param {Survey} newSurvey\r\n * @returns {Survey}\r\n */\r\n mergeUpdate(newSurvey) {\r\n if (newSurvey.id !== this._id) {\r\n throw new Error(`Survey merge id mismatch: ${newSurvey.id} !== ${this._id}`);\r\n }\r\n\r\n if (!(this.isPristine || this._savedLocally)) {\r\n console.error(`Dangerous merge with unsaved local survey, for survey id ${this._id}`);\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logError(`Dangerous merge with unsaved local survey, for survey id ${this._id}`);\r\n }\r\n\r\n Object.assign(this.attributes, newSurvey.attributes);\r\n\r\n this.userId = newSurvey.userId; // generally, this should be the same anyway\r\n this.deleted = newSurvey.deleted; // probably doesn't change here\r\n //this.createdStamp = newSurvey.createdStamp; // should be the same\r\n this.modifiedStamp = newSurvey.modifiedStamp;\r\n this.projectId = newSurvey.projectId; // generally, this should be the same anyway\r\n this.isPristine = newSurvey.isPristine;\r\n\r\n if (newSurvey.baseSurveyId) {\r\n this.baseSurveyId = newSurvey.baseSurveyId;\r\n }\r\n\r\n return this;\r\n }\r\n\r\n destructor() {\r\n super.destructor();\r\n this.hasAppModifiedListener = false;\r\n this.hasDeleteListener = false;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {SurveyDefinition} surveyDefinition\r\n * @param {App} app\r\n */\r\n registerSurveyDefinition(surveyDefinition, app) {\r\n const compatibleSurveyDefinitions = app.compatibleSurveyDefinitions.get(surveyDefinition.projectId);\r\n if (compatibleSurveyDefinitions?.includes?.(surveyDefinition.surveyType)) {\r\n\r\n if (this.attributes.surveyTemplate !== surveyDefinition.id) {\r\n this.attributes.surveyTemplate = surveyDefinition.id;\r\n this.touch();\r\n this.save()\r\n .then(() => {\r\n console.log(`Survey definition updated for survey id: ${this.id}`);\r\n // @intentional end of promise chain\r\n })\r\n .catch((reason) => {\r\n console.error(reason);\r\n // @intentional no throw needed at end of chain\r\n });\r\n }\r\n } else {\r\n console.error(`Survey definition type '${surveyDefinition.surveyType}' not compatible with survey id: ${this.id}`);\r\n }\r\n }\r\n}\r\n","/**\r\n *\r\n */\r\nexport class InternalAppError extends Error {\r\n constructor(...args) {\r\n super(...args);\r\n\r\n Error.captureStackTrace?.(this, InternalAppError); // see https://v8.dev/docs/stack-trace-api\r\n }\r\n}","export class TaxonError extends Error {\r\n constructor(...args) {\r\n super(...args);\r\n\r\n Error.captureStackTrace?.(this, TaxonError); // see https://v8.dev/docs/stack-trace-api\r\n }\r\n}","import {TaxonError} from \"../utils/exceptions/TaxonError\";\r\nimport {escapeHTML} from \"../utils/escapeHTML\";\r\n\r\nexport const SORT_ORDER_GENUS = 28;\r\nexport const SORT_ORDER_SPECIES = 56;\r\nexport const SORT_ORDER_SUBSPECIES = 76;\r\nexport const SORT_ORDER_CULTIVAR = 120;\r\n\r\nconst AGG_QUALIFIER = 'agg.';\r\nconst SL_QUALIFIER = 's.l.';\r\n\r\nconst INFO_ICON_SVG = '';\r\n\r\nexport const RAW_TAXON_NAMESTRING = 0;\r\nexport const RAW_TAXON_CANONICAL = 1;\r\nexport const RAW_TAXON_HYBRID_CANONCIAL = 2;\r\nexport const RAW_TAXON_ACCEPTED_ENTITY_ID = 3;\r\nexport const RAW_TAXON_QUALIFIER = 4;\r\nexport const RAW_TAXON_AUTHORITY = 5;\r\nexport const RAW_TAXON_VERNACULAR = 6;\r\nexport const RAW_TAXON_VERNACULAR_ROOT = 7;\r\nexport const RAW_TAXON_USED = 8;\r\nexport const RAW_TAXON_SORT_ORDER = 9;\r\nexport const RAW_TAXON_PARENT_IDS = 10;\r\nexport const RAW_TAXON_VERNACULAR_NOT_FOR_ENTRY = 11;\r\nexport const RAW_TAXON_GB_NATIONAL_STATUS = 12;\r\nexport const RAW_TAXON_IE_NATIONAL_STATUS = 13;\r\nexport const RAW_TAXON_CI_NATIONAL_STATUS = 14;\r\nexport const RAW_TAXON_GB_RARE_SCARCE = 15;\r\nexport const RAW_TAXON_IE_RARE_SCARCE = 16;\r\nexport const RAW_TAXON_NYPH_RANKING = 17;\r\nexport const RAW_TAXON_BRC_CODE = 18;\r\nexport const RAW_TAXON_NOT_FOR_NEW_RECORDING = 19\r\nexport const RAW_TAXON_ATLAS_DOCS = 20;\r\n\r\nexport const TAXON_GR_PRESENCE_KEY = 21;\r\nexport const TAXON_RPR_KEY = 22;\r\nexport const TAXON_VC_PRESENCE_KEY = 23;\r\n\r\nexport const NATIONAL_STATUS_SCHEME_STATUS_NATIVE = 'n';\r\nexport const NATIONAL_STATUS_SCHEME_STATUS_ENDEMIC = 'v';\r\nexport const NATIONAL_STATUS_SCHEME_STATUS_NEOPHYTE = 'e';\r\nexport const NATIONAL_STATUS_SCHEME_STATUS_SPONTANEOUS_NATIVE_X_NATIVE_HYBRID = 'b';\r\nexport const NATIONAL_STATUS_SCHEME_STATUS_SPONTANEOUS_NATIVE_X_ALIEN_HYBRID = 'd';\r\nexport const NATIONAL_STATUS_SCHEME_STATUS_SPONTANEOUS_ALIEN_X_ALIEN_HYBRID = 'k';\r\n\r\nexport class Taxon {\r\n /**\r\n * @typedef RawTaxon\r\n * @type {array}\r\n * @property {string} 0 - nameString\r\n * @property {(string|number)} 1 - canonical\r\n * @property {string} 2 hybridCanonical, raw entry is 0/undefined if canonical == hybridCanonical\r\n * @property {(string|number)} 3 acceptedEntityId or 0/undefined if name is accepted\r\n * @property {string} 4 qualifier\r\n * @property {string} 5 authority\r\n * @property {string} 6 vernacular\r\n * @property {string} 7 vernacularRoot\r\n * @property {number} 8 used\r\n * @property {number} 9 sortOrder\r\n * @property {Array.} 10 parentIds id(s) of *immediate* parent(s)\r\n * @property {number} [11] vernacularNotForEntry (1 === not for entry)\r\n * @property {string} [12] GB national status\r\n * @property {string} [13] IE national status\r\n * @property {string} [14] CI national status\r\n * @property {string} [15] GB rare/scarce conservation status\r\n * @property {string} [16] IE rare/scarce conservation status\r\n * @property {number|null} [17] (optionally) NYPH percentile ranking or null\r\n * @property {string|null} [18] BRC code\r\n * @property {string|null} [19] Taxon not for new recording\r\n * @property {number} [20] documentation (Atlas captions etc.) [not used yet]\r\n *\r\n * // properties beyond this point are not part of the source file\r\n * @property {{}} [21] Presence in grid-squares (top-level object is keyed by grid-ref)\r\n * @property {{}} [22] Presence on rpr\r\n * @property {{}} [23] Presence in county (top-level object is keyed by vc code string, including prefix)\r\n */\r\n\r\n // static PARENT_IDS_KEY = 10;\r\n\r\n // static GR_PRESENCE_KEY = 21;\r\n // static RPR_KEY = 22;\r\n // static VC_PRESENCE_KEY = 23;\r\n\r\n /**\r\n *\r\n * @type {Object.}\r\n */\r\n static rawTaxa;\r\n\r\n /**\r\n *\r\n * @type {boolean}\r\n */\r\n static includeAtlasDocumentation = false;\r\n\r\n /**\r\n * @type {string}\r\n */\r\n id;\r\n\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n nameString = '';\r\n\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n canonical = '';\r\n\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n hybridCanonical = '';\r\n\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n acceptedEntityId = '';\r\n\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n qualifier = '';\r\n\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n authority = '';\r\n\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n vernacular = '';\r\n\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n vernacularRoot = '';\r\n\r\n /**\r\n * if set then the vernacular name should not be allowed for data entry\r\n *\r\n * @type {boolean}\r\n */\r\n badVernacular = false;\r\n\r\n /**\r\n * @type {boolean}\r\n */\r\n used;\r\n\r\n /**\r\n * @type {number}\r\n */\r\n sortOrder;\r\n\r\n /**\r\n *\r\n * @type {Array.}\r\n */\r\n parentIds = [];\r\n\r\n /**\r\n *\r\n * @type {{CI: null|string, GB: null|string, IE: null|string}}\r\n */\r\n nationalStatus = {\r\n GB : null,\r\n IE : null,\r\n CI : null\r\n }\r\n\r\n /**\r\n * if rated, then the string is 'scarce' or 'rare'\r\n *\r\n * @type {{GB: null|('rare'|'scarce'), IE: null|('rare'|'scarce')}}\r\n */\r\n rareScarceStatus = {\r\n GB : null,\r\n IE : null\r\n }\r\n\r\n /**\r\n *\r\n * @type {{number, (string|true)}}\r\n */\r\n rprStatus = {}\r\n\r\n /**\r\n * keyed by grid-square string\r\n * @type {Object|null}\r\n */\r\n occurrenceCoverage = null;\r\n\r\n /**\r\n * keyed by vc code string\r\n * @type {Object|null}\r\n */\r\n vcPresence = null;\r\n\r\n /**\r\n *\r\n * @type {number|null}\r\n */\r\n nyphRanking = null;\r\n\r\n /**\r\n *\r\n * @type {boolean}\r\n */\r\n notForNewRecording = false;\r\n\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n brcCode = '';\r\n\r\n /**\r\n *\r\n * @type {null|{description: string, trends: string, biogeog: string}}\r\n */\r\n documentation = null;\r\n\r\n /**\r\n *\r\n * @type {boolean}\r\n */\r\n static showVernacular = true;\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {Object.} taxa\r\n */\r\n static setTaxa(taxa) {\r\n Taxon.rawTaxa = taxa;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {Object.} taxa\r\n * @param {string} sourceUrl\r\n */\r\n static initialiseTaxa(taxa, sourceUrl) {\r\n Taxon.rawTaxa = taxa;\r\n\r\n if (navigator.onLine && (taxa.stamp + (3600 * 24 * 7)) < (Date.now() / 1000)) {\r\n console.log(`Taxon list may be stale (stamp is ${taxa.stamp}), prompting re-cache.`);\r\n navigator?.serviceWorker?.ready?.then?.((registration) => {\r\n registration.active.postMessage(\r\n {\r\n action: 'recache',\r\n url: sourceUrl\r\n }\r\n );\r\n });\r\n }\r\n }\r\n\r\n /**\r\n *\r\n * @param {string} id\r\n * @returns {Taxon}\r\n * @throws {TaxonError}\r\n */\r\n static fromId (id) {\r\n if (!Taxon.rawTaxa) {\r\n throw new TaxonError(`Taxon.fromId() called before taxon list has been initialised.`);\r\n }\r\n\r\n if (!Taxon.rawTaxa.hasOwnProperty(id)) {\r\n //console.error(`Taxon id '${id}' not found.`);\r\n throw new TaxonError(`Taxon id '${id}' not found.`);\r\n }\r\n\r\n const raw = Taxon.rawTaxa[id];\r\n const taxon = new Taxon;\r\n\r\n taxon.id = id;\r\n taxon.nameString = raw[0];\r\n taxon.canonical = raw[1] || raw[0]; // raw entry is blank if namesString == canonical\r\n taxon.hybridCanonical = raw[2] || taxon.canonical; // raw entry is blank if canonical == hybridCanonical\r\n taxon.acceptedEntityId = raw[3] || id;\r\n taxon.qualifier = raw[4] || '';\r\n taxon.authority = raw[5] || '';\r\n taxon.vernacular = raw[6] || '';\r\n taxon.vernacularRoot = raw[7] || '';\r\n taxon.used = !!raw[8];\r\n taxon.sortOrder = raw[9];\r\n taxon.parentIds = raw[10];\r\n taxon.badVernacular = !!raw[11];\r\n taxon.nyphRanking = raw[RAW_TAXON_NYPH_RANKING] || null;\r\n taxon.notForNewRecording = !!raw[RAW_TAXON_NOT_FOR_NEW_RECORDING];\r\n taxon.brcCode = raw[RAW_TAXON_BRC_CODE] || '';\r\n\r\n taxon.nationalStatus = {\r\n GB: raw[12] || null,\r\n IE: raw[13] || null,\r\n CI: raw[14] || null\r\n };\r\n\r\n taxon.rareScarceStatus = {\r\n GB: raw[15] || null,\r\n IE: raw[16] || null\r\n };\r\n\r\n taxon.rprStatus = raw[TAXON_RPR_KEY] || null;\r\n\r\n taxon.occurrenceCoverage = raw[TAXON_GR_PRESENCE_KEY] || null;\r\n\r\n taxon.vcPresence = raw[TAXON_VC_PRESENCE_KEY] || null;\r\n\r\n return taxon;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {number} maxSortOrder lowest matching rank to accept\r\n * @param {number} minSortOrder highest rank to allow (return null if fails)\r\n * @param {boolean} excludeAggregates ignore aggregate parents\r\n * @param {boolean} excludeCultivars if set and current taxon is a cultivar then return null\r\n * @return {Taxon|null}\r\n */\r\n seekRankedAncestor(maxSortOrder, minSortOrder = SORT_ORDER_SPECIES, excludeAggregates = true, excludeCultivars = true) {\r\n const parentStack = [this];\r\n do {\r\n let taxon = parentStack.pop();\r\n\r\n if (taxon.sortOrder <= maxSortOrder && taxon.sortOrder >= minSortOrder) {\r\n // potentially have an acceptable taxon already\r\n\r\n if (!excludeAggregates || (taxon.qualifier !== AGG_QUALIFIER && taxon.qualifier !== SL_QUALIFIER)) {\r\n return taxon;\r\n }\r\n }\r\n\r\n if (taxon.sortOrder < minSortOrder || (excludeCultivars && taxon.sortOrder === SORT_ORDER_CULTIVAR)) {\r\n continue;\r\n }\r\n\r\n if (taxon.parentIds?.length) {\r\n for (let parentId of taxon.parentIds) {\r\n try {\r\n parentStack[parentStack.length] = Taxon.fromId(parentId);\r\n } catch (error) {\r\n // occasionally, taxon not found errors might end up here\r\n console.error(error);\r\n }\r\n }\r\n }\r\n } while (parentStack.length);\r\n\r\n return null;\r\n }\r\n\r\n get qualifiedNameString() {\r\n return `${this.nameString}${this.qualifier ? ` ${this.qualifier}` : ''}`;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {boolean} vernacularMatched\r\n * @returns {string}\r\n */\r\n formattedHTML(vernacularMatched = false) {\r\n let acceptedTaxon;\r\n\r\n try {\r\n if (this.id !== this.acceptedEntityId) {\r\n acceptedTaxon = Taxon.fromId(this.acceptedEntityId);\r\n }\r\n } catch (error) {\r\n // occasionally, taxon not found errors might end up here\r\n // in which case acceptedTaxon can stay unset\r\n console.error(error);\r\n }\r\n\r\n let infoLink = '';\r\n if (Taxon.includeAtlasDocumentation) {\r\n const preferredTaxon = acceptedTaxon || this;\r\n\r\n if (preferredTaxon?.documentation?.description) {\r\n infoLink = ` ${INFO_ICON_SVG}`;\r\n }\r\n }\r\n\r\n if (Taxon.showVernacular) {\r\n if (vernacularMatched) {\r\n return (acceptedTaxon) ?\r\n `${escapeHTML(this.vernacular)} ${this.nameString}${this.qualifier ? ` ${this.qualifier}` : ''} ${escapeHTML(this.authority)}` +\r\n ` = ${acceptedTaxon.nameString}${acceptedTaxon.qualifier ? ` ${acceptedTaxon.qualifier}` : ''} ${escapeHTML(acceptedTaxon.authority)}${infoLink}`\r\n :\r\n `${escapeHTML(this.vernacular)} ${this.nameString}${this.qualifier ? ` ${this.qualifier}` : ''} ${escapeHTML(this.authority)}${infoLink}`\r\n ;\r\n } else {\r\n return (acceptedTaxon) ?\r\n `${this.nameString}${this.qualifier ? ` ${this.qualifier}` : ''} ${this.authority}${this.vernacular ? ` ${escapeHTML(this.vernacular)}` : ''\r\n } = ${acceptedTaxon.nameString}${acceptedTaxon.qualifier ? ` ${acceptedTaxon.qualifier}` : ''} ${escapeHTML(acceptedTaxon.authority)}${infoLink}`\r\n :\r\n `${this.nameString}${this.qualifier ? ` ${this.qualifier}` : ''} ${escapeHTML(this.authority)}${this.vernacular ? ` ${escapeHTML(this.vernacular)}${infoLink}` : ''}`\r\n ;\r\n }\r\n } else {\r\n return (acceptedTaxon) ?\r\n `${this.nameString}${this.qualifier ? ` ${this.qualifier}` : ''} ${this.authority}` +\r\n ` = ${acceptedTaxon.nameString}${acceptedTaxon.qualifier ? ` ${acceptedTaxon.qualifier}` : ''} ${escapeHTML(acceptedTaxon.authority)}${infoLink}`\r\n :\r\n `${this.nameString}${this.qualifier ? ` ${this.qualifier}` : ''} ${escapeHTML(this.authority)}${infoLink}`\r\n ;\r\n }\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * @returns {boolean}\r\n */\r\n isAggregate() {\r\n return (this.qualifier === 's.l.' || this.qualifier === 'agg.');\r\n }\r\n}\r\n","import {Model} from \"./Model\";\r\nimport {Taxon} from \"./Taxon\";\r\nimport {GridRef} from 'british-isles-gridrefs'\r\nimport {GEOREF_SOURCE_UNKNOWN, SAVE_STATE_LOCAL, SAVE_STATE_SERVER} from \"../utils/constants\";\r\n//import {SURVEY_EVENT_MODIFIED} from \"../framework/AppEvents\";\r\n\r\n/**\r\n * @typedef {import('bsbi-app-framework-view').Form} Form\r\n */\r\n\r\n/**\r\n * fired from Occurrence when the object's contents have been modified\r\n *\r\n * @type {string}\r\n */\r\nexport const OCCURRENCE_EVENT_MODIFIED = 'modified';\r\n\r\n/**\r\n * fired from Occurrence when the object's contents may need redisplay, e.g. because image remote save state has changed\r\n * The content of the occurrence hasn't changed, so this shouldn't trigger a new save.\r\n * @type {string}\r\n */\r\nexport const OCCURRENCE_EVENT_NEEDS_REFRESH = 'needsrefresh';\r\n\r\n/**\r\n * set as a taxon context attribute if the name was selected based on a PlantNet identification\r\n *\r\n * @type {string}\r\n */\r\nexport const OCCURRENCE_TAXON_CONTEXT_PLANTNET = 'plantnet';\r\n\r\nexport const OCCURRENCE_TAXON_ROLE_DETERMINATION = 'determination';\r\nexport const OCCURRENCE_TAXON_ROLE_CONFIRMATION = 'confirmation';\r\n\r\n/**\r\n * fired on occurrence after a taxon name or determiner have been revised based on a PlantNet id\r\n *\r\n * @type {string}\r\n */\r\nexport const OCCURRENCE_EVENT_OUTOFBAND_TAXON_CHANGE = 'taxonchange';\r\n\r\nexport const MODEL_TYPE_OCCURRENCE = 'occurrence';\r\n\r\nexport class Occurrence extends Model {\r\n\r\n /**\r\n * mirrors constructor.name but doesn't get mangled by minification\r\n *\r\n * @type {string}\r\n */\r\n static className = 'Occurrence';\r\n\r\n // /**\r\n // *\r\n // * @type {Object.}\r\n // */\r\n // attributes = {\r\n // // taxon: {\r\n // // taxonId: '',\r\n // // taxonName: '',\r\n // // vernacularMatch: false\r\n // // }\r\n // };\r\n\r\n // set attributes(value) {\r\n // console.log({'setting attribute' : value});\r\n // super.attributes = value;\r\n // }\r\n\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n userId = '';\r\n\r\n /**\r\n *\r\n * @type {number}\r\n */\r\n draftExpiry = 0;\r\n\r\n /**\r\n *\r\n * @type {string|null}\r\n */\r\n draftNotes = null;\r\n\r\n /**\r\n * set if a longer draft period was applied explicitly\r\n *\r\n * @type {boolean}\r\n */\r\n extendedDraft = false;\r\n\r\n SAVE_ENDPOINT = '/saveoccurrence.php';\r\n\r\n /**\r\n * Occurrences are the only records that arrive in bulk - a transcriber's offline backlog is thousands\r\n * of them - so they are the only ones with a batch endpoint.\r\n *\r\n * @type {string}\r\n */\r\n BATCH_SAVE_ENDPOINT = '/saveoccurrences.php';\r\n\r\n TYPE = MODEL_TYPE_OCCURRENCE;\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * set if this is a new entry (before the user has moved on to the next entry)\r\n * influences whether form validation errors are displayed\r\n *\r\n * @type {boolean}\r\n */\r\n isNew = false;\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @returns {(Taxon|null)} returns null for unmatched taxa specified by name\r\n */\r\n get taxon() {\r\n try {\r\n return this.attributes.taxon?.taxonId ? Taxon.fromId(this.attributes.taxon.taxonId) : null;\r\n } catch (error) {\r\n // occasionally, taxon not found errors might end up here\r\n\r\n console.error(error);\r\n return null;\r\n }\r\n };\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * This should be used only for out-of-band updates to the taxon, e.g. from PlantNet.\r\n *\r\n * @param {string} taxonId\r\n * @param {{[context] : string, [plantnetId] : string, [score] : number}|null} params\r\n * @return {string|null} role string or null if no update was needed\r\n */\r\n updateTaxon(taxonId, params = null) {\r\n const taxon = Taxon.fromId(taxonId);\r\n\r\n if (taxon) {\r\n\r\n if (params?.context) {\r\n let change = false;\r\n\r\n if (params.context === OCCURRENCE_TAXON_CONTEXT_PLANTNET) {\r\n \r\n if (this.attributes?.taxon?.taxonId !== taxonId) {\r\n this.attributes.taxon = {\r\n taxonId,\r\n taxonName : taxon.nameString + (taxon.qualifier ? ` ${taxon.qualifier}` : ''),\r\n context : params.context, // Only apply context if this was a primary determination.\r\n plantnetId : params.plantnetId,\r\n vernacularMatch : false,\r\n role : OCCURRENCE_TAXON_ROLE_DETERMINATION,\r\n };\r\n\r\n if (params.score) {\r\n if (typeof params.score !== 'number') {\r\n // score has come through as a string\r\n this.attributes.taxon.score = parseFloat(params.score) || null;\r\n } else {\r\n this.attributes.taxon.score = params.score;\r\n }\r\n }\r\n \r\n change = true;\r\n } else if (this.attributes.taxon?.context !== OCCURRENCE_TAXON_CONTEXT_PLANTNET) {\r\n this.attributes.taxon.role = OCCURRENCE_TAXON_ROLE_CONFIRMATION;\r\n this.attributes.taxon.plantnetId = params.plantnetId;\r\n if (params.score) {\r\n if (typeof params.score !== 'number') {\r\n // score has come through as a string\r\n this.attributes.taxon.score = parseFloat(params.score) || null;\r\n } else {\r\n this.attributes.taxon.score = params.score;\r\n }\r\n }\r\n change = true;\r\n }\r\n }\r\n\r\n if (change) {\r\n this.touch();\r\n this.fireEvent(OCCURRENCE_EVENT_MODIFIED, {occurrenceId : this.id});\r\n this.fireEvent(OCCURRENCE_EVENT_OUTOFBAND_TAXON_CHANGE, {newTaxonValue: this.attributes.taxon});\r\n\r\n return this.attributes.taxon.role;\r\n }\r\n }\r\n }\r\n return null;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * Returns true or false based on occurrence date compatibility of *this* occurrence,\r\n * or null if individual occurrences are not dated (i.e. part of a dated survey)\r\n *\r\n * @returns {boolean|null}\r\n */\r\n isToday() {\r\n const date = this.attributes.date || '';\r\n\r\n return date === '' ? null : (date === (new Date).toISOString().slice(0,10));\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * called after the form has changed, before the values have been read back in to the occurrence\r\n *\r\n * @param {{form: Form}} params\r\n */\r\n formChangedHandler(params) {\r\n //console.log('Occurrence change handler invoked.');\r\n\r\n const form = params.form;\r\n // noinspection JSValidateTypes\r\n params = null;\r\n\r\n // read new values\r\n // then fire its own change event (Occurrence.EVENT_MODIFIED)\r\n form.updateModelFromContent().then(() => {\r\n\r\n try {\r\n // refresh the form's validation state\r\n form.conditionallyValidateForm();\r\n } catch (error) {\r\n console.error({'error caught in Occurrence, form.conditionallyValidateForm' : error});\r\n }\r\n\r\n this.changeApplied();\r\n // @intentional end of the promise chain\r\n })\r\n .catch((error) => {\r\n // Matches the handling in Survey and SurveyDefinition, where a rejection means the user\r\n // dismissed a confirmation dialogue and the change should deliberately not be applied.\r\n //\r\n // Only the survey forms currently override updateModelFromContent() (the occurrence\r\n // form's override is commented out), so the base implementation always resolves and\r\n // this cannot fire today. It is here because if an occurrence override is reintroduced,\r\n // the absence of a handler would mean changeApplied() silently never runs - so the\r\n // occurrence would never be touched, never fire OCCURRENCE_EVENT_MODIFIED, and never be\r\n // saved, with nothing reported.\r\n // @intentional\r\n console.log({\"In occurrence form handler promise rejected (probably normal cancellation of dialogue box)\": error});\r\n });\r\n }\r\n\r\n changeApplied() {\r\n this.touch();\r\n this.isNew = false;\r\n this.fireEvent(OCCURRENCE_EVENT_MODIFIED, {occurrenceId: this.id});\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n delete() {\r\n if (!this.deleted) {\r\n this.touch();\r\n this.deleted = true;\r\n this.isNew = false;\r\n\r\n this.fireEvent(OCCURRENCE_EVENT_MODIFIED, {occurrenceId : this.id});\r\n }\r\n }\r\n\r\n /**\r\n * If not securely saved, then makes a post to /saveoccurrence.php\r\n *\r\n * This should be intercepted by a service worker, which could write the object to indexeddb\r\n * A successful save (local or to server) will result in a JSON response containing the object\r\n * and also the state of persistence.\r\n *\r\n * If saving fails, then the expectation is that there is no service worker, in which case should attempt to write\r\n * the object directly to indexeddb\r\n *\r\n * Must test indexeddb for this eventuality after the save has returned.\r\n *\r\n *\r\n * @param {boolean} forceSave\r\n * @param {boolean} [isSync]\r\n * @param {{}} [params]\r\n *\r\n * @returns {Promise}\r\n */\r\n save(forceSave = false, isSync = false, params) {\r\n if (this.unsaved() || forceSave) {\r\n if (!this.surveyId) {\r\n return Promise.reject(`Survey id must be set before saving an occurrence. Failed for occ id '${this.id}'`);\r\n }\r\n\r\n return this._saveLocalThenQueuePost(isSync);\r\n } else {\r\n return Promise.reject(`Occurrence ${this.id} has already been saved.`);\r\n }\r\n }\r\n\r\n storeLocally() {\r\n return this._storeLocalData({\r\n id : this.id,\r\n occurrenceId : this.id, // unsure which id key should be preferred\r\n type : this.TYPE,\r\n surveyId : this.surveyId,\r\n attributes : this.attributes,\r\n created : this.createdStamp,\r\n modified : this.modifiedStamp,\r\n saveState : this._savedRemotely ? SAVE_STATE_SERVER : SAVE_STATE_LOCAL, // derived from the flag; there is no saveState property\r\n deleted : this.deleted,\r\n projectId : this.projectId,\r\n userId : this.userId,\r\n draftExpiry : this.draftExpiry,\r\n draftNotes : this.draftNotes,\r\n extendedDraft : this.extendedDraft,\r\n });\r\n }\r\n\r\n /**\r\n * @param {number} modifiedStampWhenQueued\r\n * @returns {boolean}\r\n * @protected\r\n */\r\n _cannotSkipAsObsolete(modifiedStampWhenQueued) {\r\n if (this.modifiedStamp >= this.saveSnapshotStamp) {\r\n //console.log('Occurrence._cannotSkipAsObsolete: allow save as previous save was prior');\r\n return true;\r\n }\r\n\r\n // skip if already saved or, if the object is not on its first save (i.e. created == modified), then skip if it has new modifications since the originally queued request that will be saved later in the queue.\r\n if ((!this.unsaved()) || (modifiedStampWhenQueued > this.createdStamp && this.modifiedStamp > modifiedStampWhenQueued)) {\r\n // occurrence has been updated since, so can skip saving an earlier iteration\r\n\r\n console.info('Occurrence._cannotSkipAsObsolete: skipping save due to later update');\r\n return false;\r\n }\r\n return true;\r\n }\r\n\r\n /**\r\n *\r\n * @returns {FormData}\r\n */\r\n formData() {\r\n const formData = new FormData;\r\n\r\n for (const [key, value] of Object.entries(this.postRecord())) {\r\n // FormData carries strings, so the one structured field is encoded here rather than in\r\n // postRecord() - a batch post sends the same object as JSON and wants it structured.\r\n formData.append(key, 'attributes' === key ? JSON.stringify(value) : value);\r\n }\r\n\r\n return formData;\r\n }\r\n\r\n /**\r\n * This occurrence as the plain object a save posts, whichever route it takes.\r\n *\r\n * One builder for both, because the batch endpoint reads the same field names as the single one and\r\n * two builders would drift: a field added to a form post and forgotten in the batch would be dropped\r\n * silently for exactly the records that went out in a batch, which is the offline backlog - the\r\n * hardest case to notice and the worst to lose.\r\n *\r\n * @returns {Object}\r\n */\r\n postRecord() {\r\n const record = {\r\n type: this.TYPE,\r\n surveyId: this.surveyId,\r\n occurrenceId: this.id,\r\n id: this.id, // this is incorrect duplication\r\n projectId: this.projectId?.toString?.() || '',\r\n attributes: this.attributes,\r\n deleted: this.deleted.toString(),\r\n created: this.createdStamp?.toString?.() || '',\r\n modified: this.modifiedStamp?.toString?.() || '',\r\n };\r\n\r\n if (this.draftExpiry && this.draftExpiry > Date.now() / 1000) {\r\n record.draftExpiry = this.draftExpiry.toString();\r\n if (this.draftNotes) {\r\n record.draftNotes = this.draftNotes;\r\n }\r\n record.extendedDraft = this.extendedDraft.toString();\r\n }\r\n\r\n if (this.userId) {\r\n record.userId = this.userId;\r\n }\r\n\r\n record.appVersion = Model.bsbiAppVersion;\r\n\r\n return record;\r\n }\r\n\r\n /**\r\n *\r\n * @param {{\r\n * id : string,\r\n * saveState: string,\r\n * userId : string?,\r\n * attributes: Object.,\r\n * deleted: boolean|string,\r\n * created: number,\r\n * modified: number,\r\n * projectId: number,\r\n * surveyId: string,\r\n * [draftExpiry]: number,\r\n * [draftNotes]: string|null,\r\n * [extendedDraft]: boolean,\r\n * }} descriptor\r\n */\r\n _parseDescriptor(descriptor) {\r\n super._parseDescriptor(descriptor);\r\n this.surveyId = descriptor.surveyId;\r\n\r\n if (descriptor.draftExpiry && descriptor.draftExpiry > Date.now() / 1000) {\r\n this.draftExpiry = descriptor.draftExpiry;\r\n this.draftNotes = descriptor.draftNotes || null;\r\n\r\n if (descriptor.extendedDraft && descriptor.extendedDraft !== true) {\r\n console.error(`extendedDraft must be a boolean, not '${descriptor.extendedDraft}'`);\r\n }\r\n\r\n this.extendedDraft = descriptor.extendedDraft || false;\r\n } else {\r\n this.draftExpiry = 0;\r\n this.draftNotes = null;\r\n this.extendedDraft = false;\r\n }\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * returns interpreted grid-ref / vc summary, used to look up meta-data for the taxon list\r\n *\r\n * @return {{\r\n * hectad : string,\r\n * tetrad : string,\r\n * monad : string,\r\n * country : string,\r\n * vc : int[],\r\n * interleavedGridRef : string,\r\n * }}\r\n */\r\n getGeoContext() {\r\n const geoRef = this.geoReference;\r\n\r\n const result = {};\r\n\r\n if (this.attributes.vc?.selection) {\r\n result.vc = [...this.attributes.vc.selection]; // clone rather than reference the VC selection\r\n } else {\r\n result.vc = [];\r\n }\r\n\r\n if (geoRef?.gridRef) {\r\n const gridRef = GridRef.fromString(geoRef.gridRef);\r\n\r\n if (gridRef) {\r\n if (gridRef.length <= 1000) {\r\n result.monad = gridRef.gridCoords.toGridRefString(1000);\r\n }\r\n\r\n if (gridRef.length <= 2000) {\r\n result.tetrad = gridRef.gridCoords.toGridRefString(2000);\r\n }\r\n\r\n result.country = gridRef.country;\r\n }\r\n\r\n result.hectad = gridRef.gridCoords.toGridRefString(10000);\r\n\r\n result.interleavedGridRef = GridRef.interleave(geoRef.gridRef);\r\n }\r\n\r\n return {...{hectad : '', tetrad : '', monad : '', country : '', vc : [], interleavedGridRef : ''}, ...result};\r\n }\r\n\r\n /**\r\n * For Occurrences that use a single grid-reference this returns the 'georef' (singular) attribute\r\n * For Occurrences allowing one or more geo-references, this returns the first geo-reference in the set\r\n *\r\n * @returns {{rawString: string, precision: number|null, source: string|null, gridRef: string, latLng: ({lat: number, lng: number}|null), [defaultSurveyGridRef]: string, [defaultSurveyPrecision]: number}}\r\n */\r\n get geoReference() {\r\n if (this.attributes.georefs && this.attributes.georefs.length > 0) {\r\n return this.attributes.georefs[0];\r\n } else {\r\n return this.attributes.georef || {\r\n gridRef: '',\r\n rawString: '', // the string that was provided by the user to generate this grid-ref (might be a postcode or placename)\r\n source: GEOREF_SOURCE_UNKNOWN,\r\n latLng: null,\r\n precision: null\r\n };\r\n }\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n hasDefaultSurveyGeoreference() {\r\n return !!this.attributes?.surveyGeoRef?.gridRef;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {string} surveyGridRef\r\n * @param {number|null} surveyPrecision diameter of centroid or square dimension\r\n */\r\n applySurveyGeoreference(surveyGridRef, surveyPrecision = null) {\r\n this.attributes.surveyGeoRef = {gridRef: surveyGridRef, precision: surveyPrecision};\r\n }\r\n}\r\n","import localforage from 'localforage';\nimport {Logger} from \"./Logger\";\n\n/**\n * localforage's default driver order is [INDEXEDDB, WEBSQL, LOCALSTORAGE], so if IndexedDb fails\n * its support check or fails to initialise it silently degrades — potentially all the way to\n * localStorage, which is roughly 5Mb, synchronous, string-only, and cannot hold a File at all.\n *\n * For this app that would look like working saves right up to the point the quota blows, while\n * everything already in IndexedDb became invisible. Pinning the driver turns a silent degradation\n * into a loud, reportable failure.\n *\n * @type {string}\n */\nexport const PINNED_FORAGE_DRIVER = localforage.INDEXEDDB;\n\n/**\n * Reports which driver a store actually ended up using.\n *\n * config() is peculiar: it *returns* an Error rather than throwing when called too late, and\n * returns the setDriver() promise when a driver was specified, so both need handling.\n *\n * @param {LocalForage} instance\n * @param {Error|boolean|Promise} configResult whatever localforage.config() returned\n * @param {string} label identifies the store in the log message\n * @returns {Promise} resolves with the driver name, or null if none could be set\n */\nexport function reportForageDriver(instance, configResult, label) {\n if (configResult instanceof Error) {\n // e.g. 'Can't call config() after localforage has been used.' — the pinned driver was\n // never applied, so the store may be running on a fallback driver.\n console.error({[`Failed to configure '${label}' store`]: configResult});\n\n // noinspection JSIgnoredPromiseFromCall\n Logger.logError(`Failed to configure '${label}' local store: ${configResult.message}`);\n\n return Promise.resolve(instance.driver());\n }\n\n return Promise.resolve(configResult)\n .then(() => instance.ready())\n .then(() => {\n const driver = instance.driver();\n\n console.info(`Local store '${label}' is using driver '${driver}'.`);\n\n if (driver !== PINNED_FORAGE_DRIVER) {\n // shouldn't be reachable while the driver is pinned, but worth knowing about\n // noinspection JSIgnoredPromiseFromCall\n Logger.logError(`Local store '${label}' is using unexpected driver '${driver}'.`);\n }\n\n return driver;\n })\n .catch((reason) => {\n // IndexedDb is unavailable and no fallback is permitted. Storage will not work, so this\n // needs to be loud — previously the app would have limped along on localStorage and\n // failed later in a much more confusing way.\n console.error({[`No usable storage driver for '${label}' store`]: reason});\n\n // noinspection JSIgnoredPromiseFromCall\n Logger.logError(`No usable storage driver for '${label}' local store (IndexedDb unavailable): ${Logger.stringifyObject(reason)}`);\n\n return null;\n });\n}\n","import localforage from 'localforage';\nimport {PINNED_FORAGE_DRIVER, reportForageDriver} from \"../utils/forageDriver.js\";\n\n/**\n * Store for image binaries, held separately from the structured records.\n *\n * Image files used to live inline in their `image.{id}` record, which meant that *any* read of an\n * image record pulled the whole photo into memory. The sync and purge passes both walk every image\n * key on start-up, so a user with a few hundred unsent photos dragged several hundred megabytes\n * through WebKit's IndexedDb layer on every session. That is the known trigger for the\n * 'Connection to Indexed Database server lost' failures, which take the whole database with them.\n *\n * Binaries therefore get their own IndexedDb *database* rather than merely their own object store.\n * That way a failure of the (large, churny) image database cannot destroy the taxon records, which\n * are the irreplaceable data — photos can at least be retaken, and once uploaded they are dropped\n * from local storage anyway.\n *\n * This class is also the intended seam for moving image binaries to the Origin Private File System:\n * only these four operations would need reimplementing.\n */\nexport class ImageFileStore {\n /**\n * @type {LocalForage|null}\n * @private\n */\n static _store = null;\n\n /**\n * Must be called wherever localforage is configured for the records store, in both the window\n * and the service worker.\n *\n * @param {string} forageName the records store name, which this is derived from\n * @returns {Promise} resolves with the driver actually in use\n */\n static configure(forageName) {\n ImageFileStore._store = localforage.createInstance({\n name: `${forageName}-imagefiles`,\n storeName: 'imagefiles',\n driver: PINNED_FORAGE_DRIVER, // never silently fall back — see forageDriver.js\n });\n\n // createInstance() applies the driver itself, so there is no config() result to inspect\n return reportForageDriver(ImageFileStore._store, true, 'image files');\n }\n\n /**\n * @returns {LocalForage}\n * @private\n */\n static _getStore() {\n if (!ImageFileStore._store) {\n throw new Error('ImageFileStore.configure() must be called before the image file store is used.');\n }\n\n return ImageFileStore._store;\n }\n\n /**\n * @param {string} imageId\n * @param {File|Blob} file\n * @returns {Promise}\n */\n static setFile(imageId, file) {\n return ImageFileStore._getStore().setItem(imageId, file);\n }\n\n /**\n * Resolves with null rather than rejecting when the file is absent, as a missing binary is an\n * expected state (images are dropped locally once acknowledged by the server).\n *\n * @param {string} imageId\n * @returns {Promise}\n */\n static getFile(imageId) {\n return ImageFileStore._getStore().getItem(imageId)\n .then((file) => file || null, () => null);\n }\n\n /**\n * @param {string} imageId\n * @returns {Promise}\n */\n static removeFile(imageId) {\n return ImageFileStore._getStore().removeItem(imageId)\n .catch(() => {\n // @intentional A binary that cannot be removed is litter rather than a failure, and must not be\n // allowed to fail a save or abort a purge.\n });\n }\n\n /**\n * @returns {Promise>}\n */\n static keys() {\n return ImageFileStore._getStore().keys();\n }\n}\n","\r\nimport {Model, uuid} from \"./Model\";\r\nimport {ResponseFactory} from \"../serviceworker/responses/ResponseFactory.js\";\r\nimport {Logger} from \"../utils/Logger.js\";\r\nimport {ImageFileStore} from \"../framework/ImageFileStore.js\";\r\n\r\nexport const IMAGE_CONTEXT_SURVEY = 'survey';\r\nexport const IMAGE_CONTEXT_OCCURRENCE = 'occurrence';\r\n\r\nexport const MODEL_TYPE_IMAGE = 'image';\r\n\r\n/**\r\n * Fired on a placeholder once local storage has given up the record it was standing in for.\r\n * Anything a view derived from the empty stub has to be reconsidered at that point.\r\n */\r\nexport const IMAGE_EVENT_PLACEHOLDER_RESOLVED = 'placeholderresolved';\r\n\r\n/**\r\n * Fired when the server has refused the file outright. The counterpart of\r\n * MODEL_EVENT_SAVED_REMOTELY: between them they are the two ways an upload can stop being pending.\r\n */\r\nexport const IMAGE_EVENT_REFUSED = 'imagerefused';\r\n\r\nexport const MEDIA_TYPE_IMAGE = 'image';\r\nexport const MEDIA_TYPE_PDF = 'pdf';\r\n\r\n/**\r\n * The kinds of media that may be attached, keyed by the value held in attributes.mediaType.\r\n *\r\n * mimeTypes match exactly; mimePrefix matches loosely, so that any image/* subtype is taken,\r\n * including formats that the browser knows about and this list doesn't. The extensions are only\r\n * consulted when the browser states no type at all, which happens for less usual formats on some\r\n * Android file pickers.\r\n *\r\n * These tests decide what the client will accept and how it presents what it holds. The server\r\n * repeats them and inspects the content itself, so nothing here is a security boundary.\r\n *\r\n * thumbnailFormat is the format image.php renders a *non-image* attachment in. It is fixed per\r\n * media type rather than negotiated: unlike a photo, which can be asked for in whichever format\r\n * suits the browser, the server produces exactly one rendering of these.\r\n *\r\n * @type {Object, extensions: Array, accept: string, icon: string, label: string, [thumbnailFormat]: string, [thumbnailMaxDimension]: number}>}\r\n */\r\nexport const MEDIA_TYPE_DEFINITIONS = {\r\n [MEDIA_TYPE_IMAGE] : {\r\n mimePrefix : 'image/',\r\n mimeTypes : [],\r\n extensions : ['jpg', 'jpeg', 'png', 'gif', 'webp', 'avif', 'heic', 'heif', 'tif', 'tiff', 'bmp'],\r\n accept : '.jpeg, .jpg, .avif, .heic, .webp, image/png, image/jpeg, image/webp, image/avif, image/heic',\r\n icon : 'image',\r\n label : 'photo',\r\n },\r\n [MEDIA_TYPE_PDF] : {\r\n mimePrefix : '',\r\n mimeTypes : ['application/pdf', 'application/x-pdf'],\r\n extensions : ['pdf'],\r\n accept : '.pdf, application/pdf',\r\n icon : 'picture_as_pdf',\r\n label : 'PDF',\r\n\r\n // A page render is text and line art, which is what PNG is good at and what JPEG is worst\r\n // at, so this is the right way round and isn't worth changing server-side.\r\n thumbnailFormat : 'png',\r\n\r\n // What the server actually produces, whatever size is asked of it. Recorded so that the\r\n // rendering can be bounded without ever asking the browser to scale a small render up.\r\n thumbnailMaxDimension : 200,\r\n },\r\n};\r\n\r\nexport class OccurrenceImage extends Model {\r\n\r\n /**\r\n * mirrors constructor.name but doesn't get mangled by minification\r\n *\r\n * @type {string}\r\n */\r\n static className = 'OccurrenceImage';\r\n\r\n /**\r\n * raw file object retrieved from a file upload image element\r\n *\r\n * Not populated by retrieveFromLocal(), which reads metadata only. Call loadFile() to fetch the\r\n * binary from ImageFileStore when it is actually needed (i.e. immediately before a post).\r\n *\r\n * @type {File|null}\r\n */\r\n file = null;\r\n\r\n /**\r\n * Set if a binary is held locally for this image, allowing the sync and purge passes to reason\r\n * about images without loading hundreds of megabytes of photos out of IndexedDb.\r\n *\r\n * @type {boolean}\r\n */\r\n hasFile = false;\r\n\r\n /**\r\n * size in bytes of the locally held binary (0 if none)\r\n *\r\n * @type {number}\r\n */\r\n fileSize = 0;\r\n\r\n /**\r\n * mime type of the locally held binary\r\n *\r\n * @type {string}\r\n */\r\n fileType = '';\r\n\r\n /**\r\n * Set when the server has refused this file outright, rather than merely failing to take it\r\n * this time.\r\n *\r\n * Every other failure is transient by assumption: the record stays unsaved, sync offers it\r\n * again, and the purge keeps it out of harm's way until it lands. A file the server has\r\n * inspected and rejected will never land, so without this it would be re-uploaded on every\r\n * sync for as long as the app is installed, and its binary kept for ever alongside.\r\n *\r\n * Local only. The server does not need telling what it just told us.\r\n *\r\n * @type {boolean}\r\n */\r\n refused = false;\r\n\r\n /**\r\n * The server's own wording for why the file was refused, to be shown to the user. It knows why;\r\n * the client would only be guessing from the reason slug.\r\n *\r\n * @type {string}\r\n */\r\n refusalMessage = '';\r\n\r\n /**\r\n * Stable slug for the refusal, for logging and counting rather than for display.\r\n *\r\n * @type {string}\r\n */\r\n refusalReason = '';\r\n\r\n /**\r\n *\r\n * @type {Map.}\r\n */\r\n static imageCache = new Map;\r\n\r\n /**\r\n *\r\n * @type {App|null}\r\n */\r\n static app = null;\r\n\r\n TYPE = MODEL_TYPE_IMAGE;\r\n\r\n /**\r\n * Only relevant for occurrence-linked images\r\n *\r\n * @type {string}\r\n */\r\n occurrenceId = '';\r\n\r\n surveyId = '';\r\n\r\n //projectId = '';\r\n\r\n //static CONTEXT_SURVEY = IMAGE_CONTEXT_SURVEY;\r\n //static CONTEXT_OCCURRENCE = IMAGE_CONTEXT_OCCURRENCE;\r\n\r\n context = IMAGE_CONTEXT_OCCURRENCE;\r\n\r\n /**\r\n * The kind of media held, one of the keys of MEDIA_TYPE_DEFINITIONS.\r\n *\r\n * Kept in attributes rather than as a field of its own so that it travels with the record\r\n * through every save path without each of them having to know about it. Defaulted rather than\r\n * migrated: every record written before this existed is a photo.\r\n *\r\n * @returns {string}\r\n */\r\n get mediaType() {\r\n return this.attributes?.mediaType || MEDIA_TYPE_IMAGE;\r\n }\r\n\r\n /**\r\n *\r\n * @param {string} mediaType\r\n */\r\n set mediaType(mediaType) {\r\n if (!this.attributes) {\r\n // _parseAttributes() leaves attributes undefined for a record saved before images had any\r\n this.attributes = {};\r\n }\r\n\r\n this.attributes.mediaType = mediaType;\r\n }\r\n\r\n /**\r\n * Only an image can be rendered locally, or asked of the server in a choice of formats.\r\n *\r\n * @returns {boolean}\r\n */\r\n get isImage() {\r\n return this.mediaType === MEDIA_TYPE_IMAGE;\r\n }\r\n\r\n /**\r\n * Whether there is a thumbnail to be shown, as opposed to a placeholder icon.\r\n *\r\n * A photo always has one, drawn from the local copy while it is still on its way up. Other\r\n * media has no local rendering - the bytes of a PDF mean nothing to an - but the server\r\n * renders a thumbnail of the file once it holds it, so such an attachment becomes previewable\r\n * on upload rather than being previewable from the start.\r\n *\r\n * @returns {boolean}\r\n */\r\n get hasThumbnail() {\r\n return !this.refused && (this.isImage || this.savedRemotely);\r\n }\r\n\r\n /**\r\n * Human-readable name for a kind of media, for alt text and the like.\r\n *\r\n * @param {string} mediaType\r\n * @returns {string}\r\n */\r\n static mediaLabel(mediaType) {\r\n return MEDIA_TYPE_DEFINITIONS.hasOwnProperty(mediaType) ?\r\n MEDIA_TYPE_DEFINITIONS[mediaType].label\r\n :\r\n 'file';\r\n }\r\n\r\n /**\r\n * The media type of a file, or null if it is of a kind that cannot be attached at all.\r\n *\r\n * @param {File|Blob} file\r\n * @returns {string|null}\r\n */\r\n static mediaTypeFromFile(file) {\r\n // e.g. 'text/plain; charset=utf-8'\r\n const mimeType = (file?.type || '').toLowerCase().split(';')[0].trim();\r\n\r\n if (mimeType) {\r\n for (const mediaType of Object.keys(MEDIA_TYPE_DEFINITIONS)) {\r\n const definition = MEDIA_TYPE_DEFINITIONS[mediaType];\r\n\r\n if (definition.mimeTypes.includes(mimeType)\r\n || (definition.mimePrefix && mimeType.startsWith(definition.mimePrefix))\r\n ) {\r\n return mediaType;\r\n }\r\n }\r\n\r\n // A type was stated and it isn't one that's taken, so the file name is deliberately not\r\n // consulted as a second chance - trusting the name over a stated type would only be a\r\n // way round the check.\r\n return null;\r\n }\r\n\r\n return OccurrenceImage.mediaTypeFromFileName(file?.name || '');\r\n }\r\n\r\n /**\r\n * Fallback for the browsers and file pickers that report an empty type.\r\n *\r\n * @param {string} fileName\r\n * @returns {string|null}\r\n */\r\n static mediaTypeFromFileName(fileName) {\r\n const match = /\\.([a-z0-9]+)$/i.exec(fileName || '');\r\n\r\n if (match) {\r\n const extension = match[1].toLowerCase();\r\n\r\n for (const mediaType of Object.keys(MEDIA_TYPE_DEFINITIONS)) {\r\n if (MEDIA_TYPE_DEFINITIONS[mediaType].extensions.includes(extension)) {\r\n return mediaType;\r\n }\r\n }\r\n }\r\n\r\n return null;\r\n }\r\n\r\n /**\r\n * Value for the 'accept' attribute of a file input that takes the given media types.\r\n *\r\n * @param {Array} mediaTypes\r\n * @returns {string}\r\n */\r\n static acceptAttribute(mediaTypes) {\r\n return mediaTypes\r\n .filter((mediaType) => MEDIA_TYPE_DEFINITIONS.hasOwnProperty(mediaType))\r\n .map((mediaType) => MEDIA_TYPE_DEFINITIONS[mediaType].accept)\r\n .join(', ');\r\n }\r\n\r\n /**\r\n * Markup standing in for media that has no thumbnail to show yet - see hasThumbnail().\r\n *\r\n * The icon says only what kind of thing is attached.\r\n *\r\n * @param {string} mediaType\r\n * @param {{[className]: string, [size]: number, [refused]: boolean}} [attributes] size is the square edge in px\r\n * @returns {string}\r\n */\r\n static mediaPlaceholderHTML(mediaType, attributes = {}) {\r\n // Only values drawn from MEDIA_TYPE_DEFINITIONS reach the markup, so a mediaType read back\r\n // from storage is never interpolated, however odd it might be.\r\n const definition = attributes.refused ?\r\n // What kind of file it was matters less than the fact that it isn't going anywhere.\r\n {icon : 'error_outline', label : 'not accepted'}\r\n :\r\n (MEDIA_TYPE_DEFINITIONS.hasOwnProperty(mediaType) ?\r\n MEDIA_TYPE_DEFINITIONS[mediaType]\r\n :\r\n {icon : 'insert_drive_file', label : 'file'});\r\n\r\n const className = `${attributes.refused ? ' media-placeholder-refused' : ''}${attributes.className ? ` ${attributes.className}` : ''}`;\r\n\r\n const size = parseInt(attributes.size, 10);\r\n const sizeStyle = size ?\r\n ` style=\"width: ${size}px; height: ${size}px; font-size: ${Math.round(size * 0.55)}px;\"`\r\n :\r\n '';\r\n\r\n return `` +\r\n `${definition.icon}` +\r\n `${definition.label}` +\r\n ``;\r\n }\r\n\r\n /**\r\n * Markup for the server-rendered thumbnail of a non-image attachment, e.g. the first page of a\r\n * PDF. Only meaningful once the server holds the file - see hasThumbnail().\r\n *\r\n * A plain , with no wrapper and no size asked for. Both of those exist to\r\n * negotiate with the server over a photo, and there is no negotiation to be had here: the\r\n * server renders one format at one size, and honours neither a format nor a size parameter.\r\n *\r\n * That single size (thumbnailMaxDimension) is why the rendering is bounded with max-width and\r\n * max-height rather than with a height attribute. Fixing a height would upscale a page render\r\n * that came back smaller than the space, which reads as a blurry mistake rather than as a small\r\n * thumbnail. Should image.php gain sizing for these, this is the one place to ask for it.\r\n *\r\n * @param {string} id\r\n * @param {string} mediaType\r\n * @param {{[className]: string, [maxSize]: number, [style]: string}} [attributes] maxSize bounds both edges, in px\r\n * @returns {string}\r\n */\r\n static mediaThumbnailHTML(id, mediaType, attributes = {}) {\r\n const definition = MEDIA_TYPE_DEFINITIONS.hasOwnProperty(mediaType) ?\r\n MEDIA_TYPE_DEFINITIONS[mediaType]\r\n :\r\n {};\r\n\r\n const format = definition.thumbnailFormat || 'png';\r\n\r\n const className = attributes.className ? ` class=\"${attributes.className}\"` : '';\r\n\r\n const styles = [];\r\n\r\n const maxSize = parseInt(attributes.maxSize, 10);\r\n if (maxSize) {\r\n styles.push(`max-width: ${maxSize}px`, `max-height: ${maxSize}px`);\r\n }\r\n\r\n if (attributes.style) {\r\n styles.push(attributes.style);\r\n }\r\n\r\n const style = styles.length ? ` style=\"${styles.join('; ')};\"` : '';\r\n\r\n return `\"${OccurrenceImage.mediaLabel(mediaType)}\"${className}${style}`;\r\n }\r\n\r\n /**\r\n * fetches a URL of the image\r\n * this might be a remote url (or one intercepted by a service worker)\r\n * or a data url of the raw image, (not yet uploaded)\r\n *\r\n * @returns {string}\r\n */\r\n getUrl () {\r\n throw new Error('OccurrenceImage getUrl() not implemented.')\r\n }\r\n\r\n SAVE_ENDPOINT = '/saveimagedirectly.php';\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {File} file\r\n * @param {string|null} [mediaType] defaults to the type implied by the file itself\r\n * @returns {OccurrenceImage}\r\n */\r\n static fromFile(file, mediaType = null) {\r\n const image = new OccurrenceImage;\r\n image.id; // trigger id assigment\r\n image.file = file;\r\n image.mediaType = mediaType || OccurrenceImage.mediaTypeFromFile(file) || MEDIA_TYPE_IMAGE;\r\n\r\n return image;\r\n }\r\n\r\n /**\r\n * If not securely saved, then makes a post to /saveimage.php\r\n *\r\n * This will be intercepted by a service worker that will write the image to IndexedDB.\r\n * A successful save will result in a JSON response containing the uri from which the image may be retrieved\r\n * and also the state of persistence (whether or not the image was intercepted by a service worker while offline).\r\n *\r\n * If saving fails, then the expectation is that there is no service worker, in which case should attempt to write\r\n * the image directly to indexeddb.\r\n *\r\n * Must test indexeddb for this eventuality after the save has returned.\r\n *\r\n * @param {boolean} forceSave\r\n * @param {boolean} [isSync]\r\n * @param {{[surveyId] : string, [projectId] : number|null, [occurrenceId] : string}} [params]\r\n * @param {boolean} [skipQueue] default FALSE, if set then skip the normal save queue (first attempts should skip as the image is needed for display quickly, syncs should be queued)\r\n *\r\n * @returns {Promise<{}>}\r\n */\r\n save(forceSave = false, isSync = false, params, skipQueue = false) {\r\n if (params?.surveyId) {\r\n this.surveyId = params.surveyId;\r\n }\r\n\r\n if (params?.projectId) {\r\n this.projectId = params.projectId;\r\n }\r\n\r\n if (this.context === IMAGE_CONTEXT_OCCURRENCE && params?.occurrenceId) {\r\n this.occurrenceId = params.occurrenceId;\r\n }\r\n\r\n if (this.refused && !this.deleted) {\r\n // The server has inspected this file and will not have it. Offering it again would fail\r\n // identically, so every retry route stops here rather than each having to know.\r\n // A deletion is still allowed through, that being the user's way out.\r\n return Promise.reject(`Image ${this.id} was refused by the server, so is not offered again.`);\r\n }\r\n\r\n if (!this.deleted && !this.file && !this.hasFile) {\r\n return Promise.reject(`Cannot save image id '${this.id}' with no local image data.`);\r\n }\r\n\r\n // kludge to avoid historical instances of corrupted surveyId\r\n if (this.surveyId === true || this.surveyId === false) {\r\n console.log(`Fixing damaged survey id for image '${this.id}'`);\r\n this.surveyId = '';\r\n }\r\n\r\n if (forceSave || this.unsaved()) {\r\n if (!OccurrenceImage.imageCache.has(this.id)) {\r\n OccurrenceImage.imageCache.set(this.id, this);\r\n }\r\n\r\n console.log(`queueing image post, image id ${this.id}`);\r\n\r\n // The binary is fetched here rather than by retrieveFromLocal(), so that the sync and\r\n // purge passes can walk every image without pulling the photos into memory.\r\n // It has to happen before queuePost(), as that builds the form data.\r\n return this.loadFile().then(() => {\r\n if (!this.deleted && !this.file) {\r\n // metadata claimed a binary that has since gone; treat as already uploaded\r\n return Promise.reject(`Cannot save image id '${this.id}', local image data is no longer present.`);\r\n }\r\n\r\n return skipQueue ? this.directSave() : this.queuePost(isSync);\r\n });\r\n } else {\r\n return Promise.reject(`Image ${this.id} has already been saved.`);\r\n }\r\n }\r\n\r\n /**\r\n *\r\n * @returns {FormData}\r\n */\r\n formData() {\r\n const formData = new FormData;\r\n\r\n const id = this.id;\r\n\r\n formData.append('type', this.TYPE);\r\n formData.append('surveyId', this.surveyId ? this.surveyId : ''); // avoid 'undefined'\r\n formData.append('projectId', this.projectId?.toString?.() || '');\r\n formData.append('imageId', id); // this shouldn't be needed\r\n formData.append('id', id);\r\n formData.append('deleted', this.deleted.toString());\r\n formData.append('created', this.createdStamp?.toString?.() || '');\r\n formData.append('modified', this.modifiedStamp?.toString?.() || '');\r\n\r\n formData.append('context', this.context);\r\n\r\n if (this.context === IMAGE_CONTEXT_OCCURRENCE) {\r\n formData.append('occurrenceId', this.occurrenceId);\r\n }\r\n\r\n // Note that the *presentational* image attributes (caption, photographer, geo-ref) are saved\r\n // as part of the associated image field data rather than with the image. What travels here\r\n // is the image's own attributes, which is to say the mediaType.\r\n formData.append('attributes', JSON.stringify(this.attributes || {}));\r\n\r\n if (this.userId) {\r\n formData.append('userId', this.userId);\r\n }\r\n\r\n formData.append('appVersion', Model.bsbiAppVersion);\r\n\r\n if (!this.deleted) {\r\n if (this.file) {\r\n // The size the client believes it is sending, for the server to check what it\r\n // received against. On this path the whole file arrives in one request, so this is\r\n // both the early size check and the truncation check that the chunked path splits\r\n // between its first and last chunks.\r\n formData.append('fileSize', (this.file.size || 0).toString());\r\n formData.append('image', this.file);\r\n } else {\r\n throw new Error(`While retrieving form data, cannot save image id '${this.id}' with no local image data.`);\r\n }\r\n }\r\n\r\n return formData;\r\n }\r\n\r\n dataForSaving() {\r\n const id = this.id;\r\n\r\n const modelData = {\r\n type : this.TYPE,\r\n surveyId : this.surveyId ? this.surveyId : '', // avoid 'undefined'\r\n projectId : this.projectId ? this.projectId : '',\r\n imageId : id, // this shouldn't be needed\r\n id : id,\r\n deleted : this.deleted.toString(),\r\n created : this.createdStamp?.toString?.() || '',\r\n modified : this.modifiedStamp?.toString?.() || '',\r\n context : this.context,\r\n attributes : this.attributes || {},\r\n refused : this.refused,\r\n refusalMessage : this.refusalMessage,\r\n refusalReason : this.refusalReason,\r\n appVersion : Model.bsbiAppVersion,\r\n };\r\n\r\n if (this.context === IMAGE_CONTEXT_OCCURRENCE) {\r\n modelData.occurrenceId = this.occurrenceId;\r\n }\r\n\r\n // Note that the *presentational* image attributes (caption, photographer, geo-ref) are saved\r\n // as part of the associated image field data rather than with the image. What is held above\r\n // is the image's own attributes, which is to say the mediaType.\r\n\r\n if (this.userId) {\r\n modelData.userId = this.userId;\r\n }\r\n\r\n // A refused file is treated like a deleted one here: the binary is dropped rather than\r\n // rewritten, because nothing will ever be done with it again, and holding megabytes for an\r\n // upload that cannot happen is the cost this whole flag exists to avoid.\r\n if (!this.deleted && !this.refused) {\r\n if (this.file) {\r\n // 'image' is a transient carrier: ImageResponse.storeLocally() diverts it to\r\n // ImageFileStore and keeps it out of the record itself, leaving only enough\r\n // metadata for the sync and purge passes to work without loading the photo.\r\n modelData.image = this.file;\r\n modelData.hasFile = true;\r\n modelData.fileSize = this.file.size || 0;\r\n modelData.fileType = this.file.type || '';\r\n } else {\r\n throw new Error(`While retrieving model data, cannot save image id '${this.id}' with no local image data.`);\r\n }\r\n } else {\r\n modelData.hasFile = false;\r\n modelData.fileSize = 0;\r\n modelData.fileType = '';\r\n }\r\n\r\n return modelData;\r\n }\r\n\r\n /**\r\n * Saves to IndexedDB and then to the server.\r\n * The promise returns after the initial IndexedDB save has completed.\r\n *\r\n * This should not be called in the context of sync saves, which should reject if they don't go through\r\n *\r\n * @returns {Promise}\r\n */\r\n directSave() {\r\n //const modifiedStampWhenQueued = this.modifiedStamp;\r\n this.lastQueuedPostAbsoluteStamp = Date.now();\r\n this.saveSnapshotAbsoluteStamp = Date.now();\r\n this.saveSnapshotModifiedToken = this.modifiedToken;\r\n this.saveSnapshotStamp = Math.floor(this.saveSnapshotAbsoluteStamp / 1000); // any new changes from this point on will be saved without skipping\r\n\r\n // save to indexedDb first and then to server after promise has resolved\r\n // mimics the service worker pattern but in the main thread, avoiding Safari issues with reading formData in the service worker\r\n\r\n return ResponseFactory\r\n .fromModelData(this.dataForSaving())\r\n .populateClientResponse()\r\n .storeLocally(false)\r\n .then((response) => {\r\n // Separately, send data to the server, but the initial local save has already completed.\r\n\r\n this._savedLocally = true;\r\n this._postChunked()\r\n .then((response) => {\r\n console.log('posting image after local db save');\r\n\r\n // would get here if the server responds at all, but need to check that the response is OK (not a server error)\r\n if (response.ok) {\r\n console.log('posted image to server after local storage: got OK response');\r\n\r\n return Promise.resolve(response)\r\n .then((response) => response.json())\r\n .then((jsonResponseData) => {\r\n // can assume that OK response with JSON data means a successful server save\r\n\r\n return ResponseFactory.fromPostResponse(this._retainAttributesInResponse(jsonResponseData))\r\n .setPrebuiltResponse(response)\r\n .populateLocalSave()\r\n .storeLocally()\r\n .then(() => {\r\n // call back to indicate that the image has been saved remotely\r\n OccurrenceImage.app?._handleImageSavedRemotely?.(this.id);\r\n });\r\n })\r\n .catch((error) => {\r\n // for some reason, local storage failed, after a successful server save\r\n console.error({'local storage store of image failed': error});\r\n // @intentional have a secure save so allow the catch to fall through here\r\n });\r\n } else {\r\n response.json().then(jsonError => {\r\n const refused = OccurrenceImage.isPermanentRefusal(response, jsonError);\r\n\r\n jsonError.imageId = this.id;\r\n jsonError.fileLength = this.file?.size;\r\n jsonError.fileType = this.file?.type;\r\n return Logger.logError(`JSON error response to image post to server after local storage: ${JSON.stringify(jsonError)}`)\r\n .then(() => {\r\n console.error({'JSON error response to image post to server after local storage': jsonError});\r\n\r\n // Marked after logging, as marking drops the binary that the\r\n // log entry above reports the size and type of.\r\n return refused ? this.markRefused(jsonError) : undefined;\r\n // @intentional have a local save so allow the catch to fall through here\r\n });\r\n }, error => {\r\n return Logger.logError(`Error response to image post to server after local storage: ${Logger.stringifyObject(error)}`)\r\n .then(() => {\r\n console.error({'Error response to image post to server after local storage': error});\r\n // @intentional have a local save so allow the catch to fall through here\r\n });\r\n });\r\n }\r\n }, (reason) => {\r\n return Logger.logError(`Rejected image post fetch from server: ${Logger.stringifyObject(reason)}`)\r\n .then(() => {\r\n console.error({'Rejected image post fetch from server - implies network is down': reason});\r\n // @intentional have a local save so allow the catch to fall through here\r\n });\r\n });\r\n\r\n\r\n return response;\r\n });\r\n }\r\n\r\n /**\r\n * The local record is rewritten from the server's reply, so anything the reply doesn't carry is\r\n * dropped from it. saveimagedirectly.php now returns the mediaType in attributes, so in the\r\n * ordinary case this does nothing and the server's answer stands.\r\n *\r\n * It is kept for the replies that still won't carry one. An image stored before mediaType\r\n * existed posts empty attributes, and a server that echoes what it was given echoes nothing;\r\n * so would a server that predates the change, which is what a client sees mid-rollout. In\r\n * either case the alternative to filling the gap here is a record whose type silently reverts\r\n * to 'image', which is a poor trade for a test that costs nothing.\r\n *\r\n * @param {{[attributes]: Object}} jsonResponseData\r\n * @returns {{}} jsonResponseData\r\n * @private\r\n */\r\n _retainAttributesInResponse(jsonResponseData) {\r\n if (jsonResponseData && !jsonResponseData.attributes?.mediaType) {\r\n jsonResponseData.attributes = Object.assign(\r\n {},\r\n jsonResponseData.attributes,\r\n {mediaType : this.mediaType}\r\n );\r\n }\r\n\r\n return jsonResponseData;\r\n }\r\n\r\n /**\r\n * The server's statement that it will never accept this file, as against the many ways a post\r\n * can fail today and succeed tomorrow.\r\n *\r\n * Read from the body rather than from the status alone. A 422 can also come from a proxy, a\r\n * crash, or anything else between here and the file check, and only the check itself sets the\r\n * flag; a status is not evidence that the code which understands the file ever ran. So anything\r\n * unrecognised stays retryable, which is the safe direction when the alternative is to stop\r\n * trying to save someone's work.\r\n *\r\n * @param {Response} response\r\n * @param {{[permanentFailure]: boolean}} jsonError\r\n * @returns {boolean}\r\n */\r\n static isPermanentRefusal(response, jsonError) {\r\n return 422 === response?.status && true === jsonError?.permanentFailure;\r\n }\r\n\r\n /**\r\n * Records that the server has refused this file, and rewrites the local record so that the\r\n * refusal survives a restart.\r\n *\r\n * Nothing is posted: the server is the one that said so. The record itself is kept, rather than\r\n * quietly removed, so that the user can see which attachment was not accepted and why, and\r\n * remove it themselves. Its binary goes, as dataForSaving() no longer offers one for a refused\r\n * image.\r\n *\r\n * @param {{[reason]: string, [message]: string}} jsonError\r\n * @returns {Promise}\r\n */\r\n markRefused(jsonError) {\r\n this.refused = true;\r\n this.refusalReason = jsonError?.reason || '';\r\n this.refusalMessage = jsonError?.message || 'This file could not be accepted.';\r\n\r\n return ResponseFactory\r\n .fromModelData(this.dataForSaving())\r\n .populateClientResponse()\r\n .storeLocally(false)\r\n .then(() => {\r\n this.file = null;\r\n this.hasFile = false;\r\n this.fileSize = 0;\r\n\r\n this.fireEvent(IMAGE_EVENT_REFUSED, {id : this.id});\r\n OccurrenceImage.app?._handleImageRefused?.(this.id);\r\n }, (reason) => {\r\n // The refusal holds in memory, so this session behaves correctly; only writing it\r\n // down has failed. The next sync then offers the file again, is refused again, and\r\n // tries to record it again - so this recovers by itself, and the binary is\r\n // deliberately left in place above for that retry to have something to write.\r\n // Rejecting here would only add noise to an error path that is already reporting.\r\n // @intentional the caller is handling a failed post and has nothing to do with this\r\n\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logError(`Failed to record the refusal of image ${this.id}: ${Logger.stringifyObject(reason)}`);\r\n });\r\n }\r\n\r\n isIOS() {\r\n const ua = globalThis?.navigator?.userAgent;\r\n\r\n // 1. Direct check for iPhone, iPod, or legacy iPad strings\r\n const standardMatch = /iPhone|iPad|iPod/i.test(ua);\r\n\r\n // 2. Detect Modern iPads and iPhones running in \"Desktop Mode\"\r\n // These masquerade as a \"Macintosh\" but natively support multi-touch points.\r\n const isDesktopModeApple = /Macintosh/i.test(ua) &&\r\n globalThis?.navigator?.maxTouchPoints > 1;\r\n\r\n return standardMatch || isDesktopModeApple;\r\n };\r\n\r\n /**\r\n *\r\n * @param {boolean} isSync\r\n * @returns {Promise}\r\n * @private\r\n */\r\n async _postChunked(isSync = false) {\r\n const chunkSize = this.isIOS() ? (400 * 1024) : (2 * 1024 * 900); // 400k for IOS or ~ 1800k slices for sane devices\r\n\r\n // Strictly, only retrieving the form data now, may result in a discrepancy between what was\r\n // previously saved locally. That's not going to happen for images, but the same approach can't be replicated\r\n // for other object types that undergo rapid changes.\r\n\r\n // The upload is taken against a snapshot of the file rather than re-reading this.file on\r\n // each pass. A chunked upload awaits a fetch per chunk, and this.file can be reassigned in\r\n // the meantime - deleting an image sets it to null - which previously surfaced as\r\n // \"Cannot read properties of null (reading 'size')\" partway through a large photo.\r\n const file = this.file;\r\n\r\n if (!file || file.size <= chunkSize) {\r\n return await fetch(this.SAVE_ENDPOINT, {\r\n method: 'POST',\r\n body: this.formData(),\r\n });\r\n }\r\n\r\n const totalChunks = Math.ceil(file.size / chunkSize);\r\n\r\n let response;\r\n\r\n const transactionId = uuid(); // required to avoid conflict between simultaneous uploads of the same image\r\n\r\n for (let i = 0; i < totalChunks; i++) {\r\n if (this.deleted) {\r\n // The user discarded the image while it was uploading, so there is no point pushing\r\n // the remaining chunks. The deletion is saved separately, and the server discards a\r\n // part-uploaded transaction.\r\n return Promise.reject(`Abandoned chunked upload of image ${this.id}, deleted while uploading.`);\r\n }\r\n\r\n const start = i * chunkSize;\r\n const end = Math.min(start + chunkSize, file.size);\r\n const chunk = file.slice(start, end);\r\n\r\n const formData = new FormData();\r\n formData.append('fileChunk', chunk);\r\n formData.append('chunkIndex', i.toString());\r\n formData.append('totalChunks', totalChunks.toString());\r\n formData.append('transactionId', transactionId);\r\n formData.append('imageId', this.id);\r\n\r\n if (0 === i || i === totalChunks - 1) {\r\n // Declared twice, for two different checks.\r\n //\r\n // On the first chunk it is the only thing the server can judge the whole upload by\r\n // before any of it has been sent, so an oversized file can be turned away while it\r\n // still costs the user one chunk rather than all of them.\r\n //\r\n // On the last it is what the assembled transaction is measured against. totalChunks\r\n // and chunksize bound the size only to chunk granularity - the final chunk's length\r\n // is not known until it lands - so without this the server cannot tell a complete\r\n // upload from one that stopped early.\r\n formData.append('fileSize', (file.size || 0).toString());\r\n }\r\n\r\n if (i === totalChunks - 1) {\r\n // for the final chunk, include the full metadata\r\n\r\n formData.append('type', this.TYPE);\r\n formData.append('surveyId', this.surveyId ? this.surveyId : ''); // avoid 'undefined'\r\n formData.append('projectId', this.projectId ? this.projectId : '');\r\n formData.append('deleted', this.deleted.toString());\r\n formData.append('created', this.createdStamp?.toString?.() || '');\r\n formData.append('modified', this.modifiedStamp?.toString?.() || '');\r\n\r\n formData.append('context', this.context);\r\n\r\n if (this.context === IMAGE_CONTEXT_OCCURRENCE) {\r\n formData.append('occurrenceId', this.occurrenceId);\r\n }\r\n\r\n // Note that the *presentational* image attributes (caption, photographer, geo-ref)\r\n // are saved as part of the associated image field data rather than with the image.\r\n // What travels here is the image's own attributes, which is to say the mediaType.\r\n formData.append('attributes', JSON.stringify(this.attributes || {}));\r\n\r\n if (this.userId) {\r\n formData.append('userId', this.userId);\r\n }\r\n\r\n formData.append('appVersion', Model.bsbiAppVersion);\r\n }\r\n\r\n response = await fetch(`${this.SAVE_ENDPOINT}?chunk=${i}&chunksize=${chunkSize}${isSync ? '&issync' : ''}`, {\r\n method: 'POST',\r\n body: formData\r\n });\r\n\r\n if (!response.ok) {\r\n break;\r\n }\r\n }\r\n\r\n return response;\r\n }\r\n\r\n /**\r\n * Makes a post to saveimagedirectly.php largely bypassing the service worker\r\n * *Does not save the original image to IndexedDB as this is intended to be used in a sync context*\r\n * *Does save server acknowledgement, if received*\r\n *\r\n * @protected\r\n * @param {FormData} formData\r\n * @param {boolean} isSync default false, set if request is part of sync all rather than a regular save\r\n * @returns {Promise}\r\n */\r\n _post(formData, isSync = false) {\r\n\r\n // save to server and update IndexedDB and the local copy.\r\n // mimics the service worker sync pattern but in the main thread, avoiding Safari issues with reading formData in the service worker\r\n\r\n // return fetch(`/saveimagedirectly.php${isSync ? '?issync' : ''}`, {\r\n // method: 'POST',\r\n // body: this.formData(),\r\n // })\r\n try {\r\n return this._postChunked(isSync)\r\n .then((response) => {\r\n console.log('posting image after local db save');\r\n\r\n // would get here if the server responds at all, but need to check that the response is OK (not a server error)\r\n if (response.ok) {\r\n console.log('posted image to server: got OK response');\r\n\r\n return Promise.resolve(response)\r\n .then((response) => response.json())\r\n .then((jsonResponseData) => {\r\n\r\n // can assume that OK response with JSON data means a successful server save\r\n\r\n return ResponseFactory.fromPostResponse(this._retainAttributesInResponse(jsonResponseData))\r\n .setPrebuiltResponse(response)\r\n .populateLocalSave()\r\n .storeLocally()\r\n .then(() => {\r\n // call back to indicate that the image has been saved remotely\r\n OccurrenceImage.app?._handleImageSavedRemotely?.(this.id);\r\n\r\n // note that, as images don't undergo repeated updates, we can be sloppy here\r\n // and not test whether a subsequent update has occurred.\r\n this._savedLocally = true;\r\n this.savedRemotely = true;\r\n\r\n return jsonResponseData;\r\n });\r\n })\r\n .catch((error) => {\r\n // for some reason, local storage failed, after a successful server save\r\n console.error({'local post storage store of image failed': error});\r\n // @intentional have a remote save so allow the catch to fall through here\r\n });\r\n } else {\r\n return response.json().then(jsonError => {\r\n const errorString = `JSON error response to direct image post to server after local storage: ${JSON.stringify(jsonError)}`;\r\n const refused = OccurrenceImage.isPermanentRefusal(response, jsonError);\r\n\r\n return Logger.logError(errorString)\r\n .then(() => {\r\n console.error({'JSON error response to direct image post to server': jsonError});\r\n })\r\n .then(() => refused ? this.markRefused(jsonError) : undefined)\r\n .then(() => Promise.reject(errorString));\r\n }, error => {\r\n const errorString = `Error response to direct image post to server after local storage: ${Logger.stringifyObject(error)}`;\r\n\r\n return Logger.logError(errorString)\r\n .then(() => {\r\n console.error({'Error response to direct image post to server': error});\r\n })\r\n .then(() => Promise.reject(errorString));\r\n });\r\n }\r\n }, (reason) => {\r\n const errorString = `Rejected image post fetch from server: ${Logger.stringifyObject(reason)}`;\r\n return Logger.logError(errorString)\r\n .then(() => {\r\n console.error({'Rejected image post fetch from server - implies network is down': reason});\r\n })\r\n .then(() => Promise.reject(errorString));\r\n });\r\n } catch (e) {\r\n // this outer catch is intended to prevent catastrophic queue jamming if a wrapped bug\r\n // prevents a promise from being returned\r\n\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logError(`Unexpected outer catch in image post. e=${Logger.stringifyObject(e)}`);\r\n return Promise.reject(`Unexpected outer catch in image post. e=${Logger.stringifyObject(e)}`);\r\n }\r\n }\r\n\r\n // /**\r\n // * fired from Occurrence when the object's contents have been modified\r\n // *\r\n // * @type {string}\r\n // */\r\n // static EVENT_MODIFIED = 'modified';\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {string} id\r\n * @returns {OccurrenceImage}\r\n */\r\n static placeholder(id) {\r\n let placeholderObject = new OccurrenceImage;\r\n placeholderObject.id = id; // should use the setter, to enforce validation\r\n placeholderObject.isPlaceholder = true;\r\n\r\n OccurrenceImage.imageCache.set(id, placeholderObject);\r\n\r\n return placeholderObject;\r\n }\r\n\r\n /**\r\n * Set while this object is standing in for a record that local storage has not yet given up.\r\n * Such a stub answers every question about itself with a default - an unsaved photo - so it is\r\n * only ever a temporary answer, resolved by retrieveIntoCache().\r\n *\r\n * @type {boolean}\r\n */\r\n isPlaceholder = false;\r\n\r\n /**\r\n * Reads an image out of local storage and into the cache, resolving with the object the cache\r\n * then holds for that id.\r\n *\r\n * A placeholder is filled in rather than swapped out. Placeholders exist because a view asked\r\n * for an image before local storage had given it up, and that view keeps hold of the object it\r\n * was handed - ImageField keeps one per attachment for the life of the form. Replacing the cache\r\n * entry therefore left those views pointing at a discarded stub for the rest of the session.\r\n *\r\n * That used to cost little, as the stub's answers were close enough to the truth for something\r\n * that was only going to be rendered as a photo. It is no longer close enough: the stub reports\r\n * an unsaved photo, and getting that wrong is now the difference between showing a PDF's\r\n * thumbnail and showing a broken image, and between asking for its grid-reference and not.\r\n *\r\n * @param {string} id\r\n * @param {function(OccurrenceImage): boolean} [accept] decides whether an image that no view is\r\n * already waiting on is worth holding in memory\r\n * @returns {Promise}\r\n */\r\n static retrieveIntoCache(id, accept = null) {\r\n const cached = OccurrenceImage.imageCache.get(id);\r\n const placeholder = cached?.isPlaceholder ? cached : null;\r\n\r\n return OccurrenceImage.retrieveFromLocal(id, placeholder || new OccurrenceImage)\r\n .then((image) => {\r\n if (placeholder) {\r\n // Already in the cache, and already referenced by whoever asked for it. The\r\n // filter is there to keep unrelated images out of memory, and this one is by\r\n // definition not unrelated, so it is kept either way.\r\n placeholder.isPlaceholder = false;\r\n image.fireEvent(IMAGE_EVENT_PLACEHOLDER_RESOLVED, {id});\r\n } else if (!accept || accept(image)) {\r\n OccurrenceImage.imageCache.set(id, image);\r\n }\r\n\r\n return image;\r\n });\r\n }\r\n\r\n /**\r\n *\r\n *\r\n * @param {{\r\n * id : string,\r\n * saveState: string,\r\n * [userId]: string,\r\n * attributes: Object.,\r\n * deleted: boolean|string,\r\n * created: (number|string),\r\n * modified: (number|string),\r\n * projectId: (number|string),\r\n * surveyId: string,\r\n * occurrenceId: string,\r\n * [image]: File\r\n * [context]: string\r\n * }} descriptor\r\n * @private\r\n */\r\n _parseDescriptor(descriptor) {\r\n super._parseDescriptor(descriptor);\r\n\r\n if (!this.attributes) {\r\n // A record saved before images carried any attributes. The mediaType getter defaults\r\n // such a record to an image, but the object still needs somewhere to hold one.\r\n this.attributes = {};\r\n }\r\n\r\n this.surveyId = descriptor.surveyId;\r\n\r\n // kludge to deal with corrupted survey ids\r\n if (this.surveyId === true || this.surveyId === false) {\r\n this.surveyId = '';\r\n descriptor.surveyId = '';\r\n }\r\n\r\n if (descriptor.occurrenceId) {\r\n this.occurrenceId = descriptor.occurrenceId;\r\n }\r\n\r\n if (descriptor.image) {\r\n // Legacy record written before binaries were split out into ImageFileStore.\r\n // Still honoured so that existing unsent photos are not orphaned, but note that reading\r\n // such a record does load the whole photo — see migrateInlineFile().\r\n this.file = descriptor.image;\r\n this.hasFile = true;\r\n this.fileSize = descriptor.image.size || 0;\r\n this.fileType = descriptor.image.type || '';\r\n this._legacyInlineFile = true;\r\n } else {\r\n this.hasFile = !!descriptor.hasFile;\r\n this.fileSize = descriptor.fileSize || 0;\r\n this.fileType = descriptor.fileType || '';\r\n }\r\n\r\n if (descriptor.context) {\r\n this.context = descriptor.context;\r\n }\r\n\r\n this.refused = !!descriptor.refused;\r\n this.refusalMessage = descriptor.refusalMessage || '';\r\n this.refusalReason = descriptor.refusalReason || '';\r\n }\r\n\r\n /**\r\n * Fetch the binary from ImageFileStore into this.file, if it isn't already loaded.\r\n *\r\n * Resolves with null when no binary is held locally, which is the normal state for an image\r\n * that has already been acknowledged by the server.\r\n *\r\n * @returns {Promise}\r\n */\r\n loadFile() {\r\n if (this.file) {\r\n return Promise.resolve(this.file);\r\n }\r\n\r\n if (!this.hasFile || this.deleted) {\r\n // a deleted image must never resurrect its binary\r\n return Promise.resolve(null);\r\n }\r\n\r\n return ImageFileStore.getFile(this.id)\r\n .then((file) => {\r\n if (file) {\r\n this.file = file;\r\n } else {\r\n // metadata claims a binary that is no longer present\r\n this.hasFile = false;\r\n this.fileSize = 0;\r\n }\r\n\r\n return this.file;\r\n });\r\n }\r\n\r\n /**\r\n * True if this image was read from a legacy record that still holds its binary inline.\r\n * Such records are rewritten in the split form the next time the image is saved.\r\n *\r\n * @returns {boolean}\r\n */\r\n hasLegacyInlineFile() {\r\n return this._legacyInlineFile;\r\n }\r\n\r\n /**\r\n * @type {boolean}\r\n * @private\r\n */\r\n _legacyInlineFile = false;\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {string} id\r\n * @param {(number|null)} width\r\n * @param {(number|null)} height\r\n * @param {{[className] : string}} [attributes]\r\n * @return {string}\r\n */\r\n static imageLink(id, width, height, attributes) {\r\n width = width || 0;\r\n height = height || 0;\r\n\r\n let attributesString = '';\r\n\r\n if (attributes.className) {\r\n attributesString += ` class=\"${attributes.className}\"`;\r\n }\r\n\r\n const renderingConstraint = (width > height) ?\r\n `width=\"${width}\"`\r\n :\r\n `height=\"${height}\"`;\r\n\r\n // should try the other options only if the image has been saved to the server\r\n const image = OccurrenceImage.imageCache.get(id);\r\n\r\n if (image && image.refused) {\r\n // never uploaded, so there is nothing at image.php to ask for\r\n return OccurrenceImage.mediaPlaceholderHTML(image.mediaType, {\r\n className : attributes.className,\r\n size : Math.max(width, height),\r\n refused : true,\r\n });\r\n }\r\n\r\n if (image && !image.isImage) {\r\n if (!image.hasThumbnail) {\r\n // still on its way up, and nothing local can be rendered, so stand an icon in its place\r\n return OccurrenceImage.mediaPlaceholderHTML(image.mediaType, {\r\n className : attributes.className,\r\n size : Math.max(width, height),\r\n });\r\n }\r\n\r\n return OccurrenceImage.mediaThumbnailHTML(id, image.mediaType, {\r\n className : attributes.className,\r\n maxSize : Math.max(width, height),\r\n });\r\n }\r\n\r\n if (image && image.savedRemotely) {\r\n // Try sized images first, before falling back to an unsized JPEG that may match an offline cache.\r\n return `` +\r\n //\r\n `\r\n \r\n \r\n `;\r\n } else {\r\n // use empty alt text to hide broken images\r\n return ``;\r\n }\r\n }\r\n\r\n storeLocally() {\r\n throw new Error(\"OccurrenceImages don't implement storeLocally(). Instead save requests should be posted.\")\r\n }\r\n}\r\n","/**\r\n * Yield execution\r\n * (implemented as scheduler.yield if available otherwise setTimeout(0) )\r\n * @returns {Promise}\r\n */\r\nexport function schedulerYield () {\r\n // Use scheduler.yield if it exists:\r\n // noinspection JSUnresolvedReference\r\n if ('scheduler' in globalThis && 'yield' in scheduler) {\r\n // noinspection JSUnresolvedReference\r\n return scheduler.yield();\r\n }\r\n\r\n // Fall back to setTimeout:\r\n return new Promise(resolve => {\r\n setTimeout(resolve, 0);\r\n });\r\n}\r\n\r\n// can't use this, as out-of-context calls result in 'Illegal invocation' errors\r\n\r\n// export const schedulerYield = ('scheduler' in globalThis && 'yield' in scheduler) ?\r\n// scheduler.yield\r\n// :\r\n// () => new Promise(resolve => {\r\n// setTimeout(resolve, 0);\r\n// });\r\n\r\n","// A Survey Definition defines the common characteristics of a repeatable structured survey.\r\n\r\nimport {Model, uuid} from \"./Model\";\r\nimport {SURVEY_DEFINITION_EVENT_MODIFIED, SURVEY_DEFINITION_EVENT_DELETED} from \"../framework/AppEvents\";\r\nimport {Logger} from \"../utils/Logger\";\r\nimport {SAVE_STATE_LOCAL, SAVE_STATE_SERVER} from \"../utils/constants\";\r\n\r\n/**\r\n * @typedef {import('bsbi-app-framework-view').Form} Form\r\n */\r\n\r\nexport class SurveyDefinition extends Model {\r\n\r\n /**\r\n * mirrors constructor.name but doesn't get mangled by minification\r\n *\r\n * @type {string}\r\n */\r\n static className = 'SurveyDefinition';\r\n\r\n SAVE_ENDPOINT = '/savesurveydefinition.php';\r\n\r\n TYPE = 'surveydefinition';\r\n\r\n /**\r\n *\r\n * @type {{\r\n * [surveyName] : string,\r\n * [place] : string,\r\n * [route] : object,\r\n * [recorders] : Array<{}>|null,\r\n * [segments] : Array<{\r\n * uniqueId : string,\r\n * segmentName : string,\r\n * [notes] : string,\r\n * }>|null,\r\n * }}\r\n */\r\n attributes = {};\r\n\r\n /**\r\n * @type {string}\r\n */\r\n surveyType;\r\n\r\n /**\r\n * Part of the saved survey definition record.\r\n * Flags whether this survey definition is linked to any surveys. Once used for records, the route cannot be revised and\r\n * the definition cannot be deleted.\r\n *\r\n * @type {boolean}\r\n */\r\n inUse = false;\r\n\r\n /**\r\n * if set, then provide default values (e.g. GPS look-up of current geo-reference)\r\n *\r\n * @type {boolean}\r\n */\r\n isNew = false;\r\n\r\n /**\r\n * kludge to flag once the App singleton has set up a listener for changes on the survey\r\n *\r\n * @type {boolean}\r\n */\r\n hasAppModifiedListener = false;\r\n\r\n /**\r\n * kludge to flag once the App singleton has set up a listener for deletion on the survey\r\n *\r\n * @type {boolean}\r\n */\r\n hasDeleteListener = false;\r\n\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n userId = '';\r\n\r\n /**\r\n * string\r\n */\r\n get id() {\r\n if (!this._id) {\r\n this._id = uuid();\r\n } else if (this._id === 'undefined') {\r\n console.error(\"id is literal 'undefined', am forcing new id\");\r\n this._id = uuid();\r\n }\r\n\r\n return this._id;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * called after the form has changed, before the values have been read back in to the object.\r\n * read new values\r\n * validate\r\n * then fire its own change event (Survey.EVENT_MODIFIED)\r\n * @param {{form: Form}} params\r\n */\r\n formChangedHandler(params) {\r\n //console.log('Survey definition change handler invoked.');\r\n\r\n const form = params.form;\r\n // noinspection JSValidateTypes\r\n params = null;\r\n\r\n form.updateModelFromContent().then(() => {\r\n\r\n //console.log('Survey Definition calling conditional validation.');\r\n\r\n try {\r\n // refresh the form's validation state\r\n form.conditionallyValidateForm();\r\n } catch (error) {\r\n console.error({'error caught in SurveyDefinition, form.conditionallyValidateForm' : error});\r\n }\r\n\r\n this.isNew = false;\r\n this.touch();\r\n this.fireEvent(SURVEY_DEFINITION_EVENT_MODIFIED, {surveyId: this.id});\r\n // @intentional end of chain\r\n })\r\n .catch((error) => {\r\n // if updateModelFromContent() fails, due to user rejection of dialogue box then intentionally don't want the survey to save\r\n console.log({\"In survey definition form handler, promise rejected (probably normal cancellation of dialogue box)\" : error});\r\n // @intentional end of chain\r\n });\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * Used for special-case setting of a custom attribute\r\n * (i.e. not usually one linked to a form)\r\n * e.g. used for updating the NYPH null-list flag\r\n *\r\n * @param attributeName\r\n * @param value\r\n */\r\n setAttribute(attributeName, value) {\r\n if (this.attributes[attributeName] !== value) {\r\n this.attributes[attributeName] = value;\r\n\r\n this.touch();\r\n this.fireEvent(SURVEY_DEFINITION_EVENT_MODIFIED, {surveyDefinitionId : this.id});\r\n }\r\n }\r\n\r\n /**\r\n * if not securely saved, then makes a post to /savesurveydefinition.php\r\n *\r\n * This will be intercepted by a service worker.\r\n * A successful save will result in a JSON response containing the uri from which the object may be retrieved\r\n * and also the state of persistence (whether or not the object was intercepted by a service worker while offline)\r\n *\r\n * If saving fails, then the expectation is that there is no service worker, in which case should attempt to write\r\n * the object directly to IndexedDB\r\n *\r\n * must test IndexedDB for this eventuality after the save has returned\r\n *\r\n * @param {boolean} forceSave\r\n * @param {boolean} [isSync]\r\n * @param {{}} [params]\r\n *\r\n * @returns {Promise}\r\n */\r\n save(forceSave = false, isSync = false, params) {\r\n if (forceSave || this.unsaved()) {\r\n return this._saveLocalThenQueuePost(isSync);\r\n } else {\r\n return Promise.reject(`Survey definition ${this.id} has already been saved.`);\r\n }\r\n }\r\n\r\n /**\r\n *\r\n * @returns {FormData}\r\n */\r\n formData() {\r\n const formData = new FormData;\r\n\r\n formData.append('type', this.TYPE);\r\n formData.append('surveyDefinitionId', this.id);\r\n formData.append('id', this.id); // this is incorrect duplication\r\n formData.append('projectId', this.projectId?.toString?.() || '');\r\n formData.append('attributes', JSON.stringify(this.attributes));\r\n formData.append('deleted', this.deleted.toString());\r\n formData.append('created', this.createdStamp?.toString?.() || '');\r\n formData.append('userId', this.userId);\r\n formData.append('surveyType', this.surveyType);\r\n formData.append('inUse', this.inUse.toString());\r\n\r\n formData.append('appVersion', Model.bsbiAppVersion);\r\n\r\n return formData;\r\n }\r\n\r\n /**\r\n *\r\n * @returns {Promise}\r\n */\r\n storeLocally() {\r\n return this._storeLocalData({\r\n id : this.id,\r\n surveyDefinitionId : this.id, // unsure which id key should be preferred\r\n type : this.TYPE,\r\n attributes : this.attributes,\r\n created : this.createdStamp,\r\n modified : this.modifiedStamp,\r\n saveState : this._savedRemotely ? SAVE_STATE_SERVER : SAVE_STATE_LOCAL, // derived from the flag; there is no saveState property\r\n deleted : this.deleted,\r\n projectId : this.projectId,\r\n userId : this.userId,\r\n inUse : this.inUse,\r\n });\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * Low-level deletion of the survey definition.\r\n * Does not test whether there are dependencies.\r\n *\r\n */\r\n delete() {\r\n if (!this.deleted) {\r\n this.touch();\r\n this.deleted = true;\r\n this.save()\r\n .catch((reason) => {\r\n console.error(reason);\r\n // @intentional no throw needed at end of chain\r\n })\r\n .finally(() => {\r\n this.fireEvent(SURVEY_DEFINITION_EVENT_DELETED, {surveyDefinitionId : this.id});\r\n // @intentional end of promise chain\r\n });\r\n }\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {number} segmentNumber\r\n * @returns {{\r\n * uniqueId : string,\r\n * segmentName : string,\r\n * [notes] : string,\r\n * route : {\r\n * n: number,\r\n * id: string,\r\n * waypoints: Array<{lng: number, lat: number}>,\r\n * centre : {lng: number, lat: number},\r\n * radius : number\r\n * },\r\n * }|null}\r\n */\r\n getSegmentData(segmentNumber) {\r\n if (!this.attributes?.segments?.[segmentNumber]) {\r\n return null;\r\n }\r\n\r\n // shallow clone so that 'route' doesn't get added as a property of the original object\r\n const meta = Object.assign({}, this.attributes.segments[segmentNumber]);\r\n\r\n meta.route = this.attributes.route[segmentNumber];\r\n return meta;\r\n }\r\n\r\n /**\r\n *\r\n * @returns {string[]}\r\n */\r\n getSegmentUniqueIds() {\r\n if (this.attributes?.segments) {\r\n return this.attributes?.segments.map(segment => segment.uniqueId)\r\n }\r\n\r\n return [];\r\n }\r\n\r\n /**\r\n *\r\n * @returns {number|null}\r\n */\r\n getTotalNumberOfSegments() {\r\n return this.attributes?.segments?.length;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @returns {Array<{\r\n * uniqueId : string,\r\n * segmentName : string,\r\n * [notes] : string,\r\n * }>|null}\r\n */\r\n getSegmentsMetaData() {\r\n return this.attributes.segments;\r\n }\r\n\r\n /**\r\n *\r\n * @param {{\r\n * id : string,\r\n * saveState: string,\r\n * userId: string,\r\n * attributes: Object.,\r\n * deleted: boolean|string,\r\n * created: (number|string),\r\n * modified: (number|string),\r\n * projectId: (number|string),\r\n * surveyType: string,\r\n * inUse: boolean|string,\r\n * }} descriptor\r\n */\r\n _parseDescriptor(descriptor) {\r\n this.surveyType = descriptor.surveyType;\r\n this.inUse = (descriptor.inUse === true) || (descriptor.inUse === 'true'); // cast stringified boolean to true boolean\r\n super._parseDescriptor(descriptor);\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {SurveyDefinition} newSurveyDefinition\r\n * @returns {SurveyDefinition}\r\n */\r\n mergeUpdate(newSurveyDefinition) {\r\n if (newSurveyDefinition.id !== this._id) {\r\n throw new Error(`Survey Definition merge id mismatch: ${newSurveyDefinition.id} !== ${this._id}`);\r\n }\r\n\r\n if (!(this.isPristine || this._savedLocally)) {\r\n console.error(`Dangerous merge with unsaved local survey definition, for id ${this._id}`);\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logError(`Dangerous merge with unsaved local survey definition, for id ${this._id}`);\r\n }\r\n\r\n Object.assign(this.attributes, newSurveyDefinition.attributes);\r\n\r\n this.userId = newSurveyDefinition.userId; // generally, this should be the same anyway\r\n this.deleted = newSurveyDefinition.deleted; // probably doesn't change here\r\n //this.createdStamp = newSurvey.createdStamp; // should be the same\r\n this.modifiedStamp = newSurveyDefinition.modifiedStamp;\r\n this.projectId = newSurveyDefinition.projectId; // generally, this should be the same anyway\r\n this.isPristine = newSurveyDefinition.isPristine;\r\n this.surveyType = newSurveyDefinition.surveyType;\r\n this.inUse = this.inUse || newSurveyDefinition.inUse;\r\n\r\n return this;\r\n }\r\n\r\n destructor() {\r\n super.destructor();\r\n this.hasAppModifiedListener = false;\r\n this.hasDeleteListener = false;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * @return {string}\r\n */\r\n getTitle() {\r\n return this.attributes.surveyName || this.attributes.place || `(untitled ${this.id})`;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * Returns a promise that resolves when the survey definition has saved.\r\n * (proceed with caution as the save will be queued so may be slow to resolve)\r\n * Promise resolves immediately if the survey definition is already flagged as in use.\r\n *\r\n * @returns {Promise}\r\n */\r\n flagUse() {\r\n if (!this.inUse) {\r\n this.inUse = true;\r\n this.touch();\r\n return this.save();\r\n } else {\r\n return Promise.resolve();\r\n }\r\n }\r\n}\r\n","import localforage from \"localforage\";\r\nimport {Logger} from \"../../utils/Logger.js\";\r\n\r\nexport class LocalResponse {\r\n /**\r\n * @type {Object}\r\n */\r\n toSaveLocally;\r\n\r\n /**\r\n * @type {Object}\r\n */\r\n returnedToClient;\r\n\r\n /**\r\n * @type {Response}\r\n */\r\n prebuiltResponse;\r\n\r\n failureErrorMessage = 'Failed to save a local copy on your device.';\r\n failureErrorHelp = 'Your internet connection may have failed (or there could be a problem with the server). ' +\r\n 'It wasn\\'t possible to save a temporary copy on your device. Perhaps there is insufficient space? ' +\r\n 'Please try to re-establish a network connection and try again.';\r\n\r\n /**\r\n *\r\n * @param {{}} toSaveLocally\r\n * @param {{}} returnedToClient\r\n */\r\n constructor(toSaveLocally, returnedToClient) {\r\n this.toSaveLocally = toSaveLocally;\r\n this.returnedToClient = returnedToClient;\r\n }\r\n\r\n /**\r\n *\r\n * @param {Response} prebuiltResponse\r\n * @returns {this}\r\n */\r\n setPrebuiltResponse(prebuiltResponse) {\r\n this.prebuiltResponse = prebuiltResponse;\r\n return this;\r\n }\r\n\r\n /**\r\n *\r\n * @param {boolean} remoteSuccess set if the object has been saved remotely\r\n * @returns {Promise<>}\r\n */\r\n storeLocally(remoteSuccess = true) {\r\n return localforage.setItem(this.localKey(), this.toSaveLocally)\r\n .then(() => {\r\n console.log(`Stored object ${this.localKey()} locally`);\r\n //return this.prebuiltResponse ? this.prebuiltResponse : packageClientResponse(this.returnedToClient);\r\n },\r\n (reason) => {\r\n console.log(`Failed to store object ${this.localKey()} locally`);\r\n console.log({reason});\r\n\r\n return Promise.reject(`Failed to store object ${this.localKey()} locally: ${Logger.stringifyObject(reason)}`);\r\n }\r\n );\r\n }\r\n\r\n /**\r\n * @return {string}\r\n */\r\n localKey () {\r\n throw new Error(`LocalKey must be implemented in a subclass for ${this.toSaveLocally.type}`);\r\n }\r\n\r\n /**\r\n * called to build the response to the post that is returned to the client\r\n * in the absence of the remote server\r\n *\r\n * @returns {this}\r\n * @abstract\r\n */\r\n populateClientResponse() {\r\n }\r\n\r\n /**\r\n * called to mirror a response from the server locally\r\n *\r\n * @returns {this}\r\n * @abstract\r\n */\r\n populateLocalSave(){}\r\n}\r\n","import {ResponseFactory} from \"./ResponseFactory\";\r\nimport {LocalResponse} from \"./LocalResponse\";\r\nimport {SAVE_STATE_LOCAL, SAVE_STATE_SERVER} from \"../../utils/constants\";\r\nimport {IMAGE_CONTEXT_OCCURRENCE, IMAGE_CONTEXT_SURVEY} from \"../../models/OccurrenceImage\";\r\nimport {ImageFileStore} from \"../../framework/ImageFileStore.js\";\r\n\r\nexport class ImageResponse extends LocalResponse {\r\n failureErrorMessage = 'Failed to store image.';\r\n failureErrorHelp = 'Your internet connection may have failed (or there could be a problem with the server). ' +\r\n 'It wasn\\'t possible to save a temporary copy on your device. Perhaps there is insufficient space? ' +\r\n 'Please try to re-establish a network connection and try again.';\r\n\r\n /**\r\n * called to build the response to the post that is returned to the client\r\n * in the absence of the remote server\r\n *\r\n * @returns {this}\r\n */\r\n populateClientResponse() {\r\n // kludge to deal with corrupted survey ids\r\n if (this.toSaveLocally.surveyId === true\r\n || this.toSaveLocally.surveyId === false\r\n || this.toSaveLocally.surveyId === 'true'\r\n || this.toSaveLocally.surveyId === 'false'\r\n ) {\r\n this.toSaveLocally.surveyId = '';\r\n }\r\n\r\n this.returnedToClient.id = this.toSaveLocally.imageId ? this.toSaveLocally.imageId : this.toSaveLocally.id;\r\n this.returnedToClient.imageId = this.toSaveLocally.imageId ? this.toSaveLocally.imageId : this.toSaveLocally.id;\r\n this.returnedToClient.type = 'image';\r\n this.returnedToClient.surveyId = this.toSaveLocally.surveyId;\r\n this.returnedToClient.created = parseInt(this.toSaveLocally.created, 10); // stamps from server always take precedence\r\n this.returnedToClient.modified = parseInt(this.toSaveLocally.modified, 10);\r\n this.returnedToClient.saveState = SAVE_STATE_LOCAL;\r\n this.returnedToClient.deleted = this.toSaveLocally.deleted;\r\n this.returnedToClient.projectId = parseInt(this.toSaveLocally.projectId, 10);\r\n this.returnedToClient.context = this.toSaveLocally.context || IMAGE_CONTEXT_OCCURRENCE;\r\n // Carries the mediaType. May arrive as a JSON string (posted form data) or as an object\r\n // (a direct model save); Model._parseAttributes() reads back either.\r\n this.returnedToClient.attributes = this.toSaveLocally.attributes || {};\r\n this.returnedToClient.hasFile = !!this.toSaveLocally.hasFile;\r\n this.returnedToClient.fileSize = this.toSaveLocally.fileSize || 0;\r\n this.returnedToClient.fileType = this.toSaveLocally.fileType || '';\r\n\r\n if (this.toSaveLocally.context !== IMAGE_CONTEXT_SURVEY) {\r\n this.returnedToClient.occurrenceId = this.toSaveLocally.occurrenceId;\r\n }\r\n\r\n return this;\r\n }\r\n\r\n /**\r\n * called to mirror a response from the server locally\r\n *\r\n * @returns {this}\r\n */\r\n populateLocalSave() {\r\n this.toSaveLocally.surveyId = this.returnedToClient.surveyId;\r\n this.toSaveLocally.type = 'image';\r\n this.toSaveLocally.imageId = this.returnedToClient.id ? this.returnedToClient.id : this.returnedToClient.imageId; // hedging\r\n this.toSaveLocally.id = this.returnedToClient.id ? this.returnedToClient.id : this.returnedToClient.imageId; // hedging\r\n this.toSaveLocally.created = parseInt(this.returnedToClient.created, 10);\r\n this.toSaveLocally.modified = parseInt(this.returnedToClient.modified, 10);\r\n this.toSaveLocally.saveState = this.returnedToClient.saveState || SAVE_STATE_SERVER; //SAVE_STATE_SERVER;\r\n this.toSaveLocally.deleted = (this.returnedToClient.deleted === true || this.returnedToClient.deleted === 'true');\r\n this.toSaveLocally.projectId = parseInt(this.returnedToClient.projectId, 10);\r\n this.toSaveLocally.context = this.returnedToClient.context || IMAGE_CONTEXT_OCCURRENCE;\r\n // Carries the mediaType, which the server now states. Where it doesn't - an image stored\r\n // before mediaType existed posts none for it to echo - OccurrenceImage\r\n // ._retainAttributesInResponse() has already filled the gap, so this never blanks the type\r\n // of an attachment that has one.\r\n this.toSaveLocally.attributes = this.returnedToClient.attributes || {};\r\n\r\n if (this.returnedToClient.context !== IMAGE_CONTEXT_SURVEY) {\r\n this.toSaveLocally.occurrenceId = this.returnedToClient.occurrenceId;\r\n }\r\n\r\n // A server acknowledgement means the binary is safely uploaded, so the local copy is dropped\r\n // (this was previously implicit, as the record was overwritten without its inline image).\r\n // Now that binaries live in their own store, hasFile: false drives their explicit removal\r\n // in storeLocally(), otherwise they would accumulate indefinitely.\r\n this.toSaveLocally.hasFile = false;\r\n this.toSaveLocally.fileSize = 0;\r\n this.toSaveLocally.fileType = '';\r\n\r\n return this;\r\n }\r\n\r\n /**\r\n * Diverts the binary to ImageFileStore so that it never enters the image record itself.\r\n *\r\n * @param {boolean} remoteSuccess\r\n * @returns {Promise}\r\n */\r\n storeLocally(remoteSuccess = true) {\r\n const imageId = this.toSaveLocally.imageId || this.toSaveLocally.id;\r\n\r\n // 'image' is only ever a transient carrier — strip it before the record is written.\r\n const file = this.toSaveLocally.image;\r\n delete this.toSaveLocally.image;\r\n\r\n // hasFile is the single source of truth: false means any stored binary is now redundant,\r\n // whether because the server has acknowledged it or because the image was deleted.\r\n const filePromise = file ?\r\n ImageFileStore.setFile(imageId, file)\r\n :\r\n (this.toSaveLocally.hasFile ? Promise.resolve() : ImageFileStore.removeFile(imageId));\r\n\r\n // The binary is written first: a record claiming hasFile with no binary behind it is worse\r\n // than a binary with no record, which the purge will collect as an orphan.\r\n return filePromise.then(() => super.storeLocally(remoteSuccess));\r\n }\r\n\r\n /**\r\n *\r\n * @returns {string}\r\n */\r\n localKey() {\r\n return `image.${this.toSaveLocally.imageId || this.toSaveLocally.id}`; // shouldn't need to hedge this\r\n }\r\n\r\n static register() {\r\n ResponseFactory.responses.image = ImageResponse;\r\n }\r\n}\r\n","import {ResponseFactory} from \"./ResponseFactory\";\r\nimport {LocalResponse} from \"./LocalResponse\";\r\nimport {SAVE_STATE_LOCAL, SAVE_STATE_SERVER} from \"../../utils/constants\";\r\n\r\nexport class SurveyResponse extends LocalResponse {\r\n failureErrorMessage = 'Failed to store survey.';\r\n failureErrorHelp = 'Your internet connection may have failed (or there could be a problem with the server). ' +\r\n 'It wasn\\'t possible to save a temporary copy on your device. Perhaps there is insufficient space? ' +\r\n 'Please try to re-establish a network connection and try again.';\r\n\r\n /**\r\n * called to build the response to the post that is returned to the client\r\n * in the absence of the remote server\r\n *\r\n * @returns {this}\r\n */\r\n populateClientResponse() {\r\n this.returnedToClient.surveyId = this.toSaveLocally.id || this.toSaveLocally.surveyId; // hedging\r\n this.returnedToClient.id = this.toSaveLocally.id ? this.toSaveLocally.id : this.toSaveLocally.surveyId; // hedging\r\n this.returnedToClient.baseSurveyId = this.toSaveLocally.baseSurveyId || this.returnedToClient.id;\r\n this.returnedToClient.type = 'survey';\r\n this.returnedToClient.attributes = this.toSaveLocally.attributes;\r\n\r\n // Carried for the same reason as the attributes: this response is what a save made with no server\r\n // is answered with, so anything omitted here is lost from a survey configured offline.\r\n this.returnedToClient.metadata = this.toSaveLocally.metadata;\r\n this.returnedToClient.created = parseInt(this.toSaveLocally.created, 10); // stamps from server always take precedence\r\n this.returnedToClient.modified = parseInt(this.toSaveLocally.modified, 10);\r\n this.returnedToClient.saveState = SAVE_STATE_LOCAL;\r\n this.returnedToClient.deleted = this.toSaveLocally.deleted;\r\n this.returnedToClient.projectId = this.toSaveLocally.projectId;\r\n this.returnedToClient.userId = this.toSaveLocally.userId || '';\r\n return this;\r\n }\r\n\r\n /**\r\n * called to mirror a response from the server locally\r\n *\r\n * @returns {this}\r\n */\r\n populateLocalSave() {\r\n this.toSaveLocally.surveyId = this.returnedToClient.id ? this.returnedToClient.id : this.returnedToClient.surveyId;\r\n this.toSaveLocally.id = this.returnedToClient.id ? this.returnedToClient.id : this.returnedToClient.surveyId;\r\n this.toSaveLocally.baseSurveyId = this.returnedToClient.baseSurveyId || this.toSaveLocally.id;\r\n this.toSaveLocally.type = 'survey';\r\n this.toSaveLocally.attributes = this.returnedToClient.attributes;\r\n this.toSaveLocally.metadata = this.returnedToClient.metadata;\r\n this.toSaveLocally.created = parseInt(this.returnedToClient.created, 10); // stamps from server always take precedence\r\n this.toSaveLocally.modified = parseInt(this.returnedToClient.modified, 10);\r\n this.toSaveLocally.saveState = this.returnedToClient.saveState || SAVE_STATE_SERVER; //SAVE_STATE_SERVER;\r\n this.toSaveLocally.deleted = this.returnedToClient.deleted;\r\n this.toSaveLocally.projectId = parseInt(this.returnedToClient.projectId, 10);\r\n this.toSaveLocally.userId = this.returnedToClient.userId || '';\r\n return this;\r\n }\r\n\r\n /**\r\n *\r\n * @returns {string}\r\n */\r\n localKey() {\r\n return `survey.${this.toSaveLocally.surveyId}`;\r\n }\r\n\r\n static register() {\r\n ResponseFactory.responses.survey = SurveyResponse;\r\n }\r\n}\r\n","import {ResponseFactory} from \"./ResponseFactory\";\r\nimport {LocalResponse} from \"./LocalResponse\";\r\nimport {SAVE_STATE_LOCAL, SAVE_STATE_SERVER} from \"../../utils/constants\";\r\n\r\nexport class OccurrenceResponse extends LocalResponse {\r\n failureErrorMessage = 'Failed to store occurrence.';\r\n failureErrorHelp = 'Your internet connection may have failed (or there could be a problem with the server). ' +\r\n 'It wasn\\'t possible to save a temporary copy on your device. Perhaps there is insufficient space? ' +\r\n 'Please try to re-establish a network connection and try again.';\r\n\r\n /**\r\n * called to build the response to the post that is returned to the client\r\n * in the absence of the remote server\r\n *\r\n * @returns {this}\r\n */\r\n populateClientResponse() {\r\n this.returnedToClient.id = this.toSaveLocally.occurrenceId ? this.toSaveLocally.occurrenceId : this.toSaveLocally.id;\r\n this.returnedToClient.occurrenceId = this.toSaveLocally.occurrenceId ? this.toSaveLocally.occurrenceId : this.toSaveLocally.id;\r\n this.returnedToClient.type = 'occurrence';\r\n this.returnedToClient.surveyId = this.toSaveLocally.surveyId;\r\n this.returnedToClient.attributes = this.toSaveLocally.attributes;\r\n this.returnedToClient.created = parseInt(this.toSaveLocally.created, 10); // stamps from server always take precedence\r\n this.returnedToClient.modified = parseInt(this.toSaveLocally.modified, 10);\r\n this.returnedToClient.saveState = SAVE_STATE_LOCAL;\r\n this.returnedToClient.deleted = this.toSaveLocally.deleted;\r\n this.returnedToClient.projectId = parseInt(this.toSaveLocally.projectId, 10);\r\n this.returnedToClient.userId = this.toSaveLocally.userId || '';\r\n this.returnedToClient.draftExpiry = this.toSaveLocally.draftExpiry ? parseInt(this.toSaveLocally.draftExpiry, 10) : 0;\r\n this.returnedToClient.draftNotes = this.toSaveLocally.draftNotes || null;\r\n this.returnedToClient.extendedDraft = (this.toSaveLocally.extendedDraft === true || this.toSaveLocally.extendedDraft === 'true');\r\n return this;\r\n }\r\n\r\n /**\r\n * called to mirror a response from the server locally\r\n *\r\n * @returns {this}\r\n */\r\n populateLocalSave() {\r\n this.toSaveLocally.occurrenceId = this.returnedToClient.id ? this.returnedToClient.id : this.returnedToClient.occurrenceId; // hedging\r\n this.toSaveLocally.id = this.returnedToClient.id ? this.returnedToClient.id : this.returnedToClient.occurrenceId; // hedging\r\n this.toSaveLocally.type = 'occurrence';\r\n this.toSaveLocally.surveyId = this.returnedToClient.surveyId;\r\n this.toSaveLocally.attributes = this.returnedToClient.attributes;\r\n this.toSaveLocally.created = parseInt(this.returnedToClient.created, 10); // stamps from server always take precedence\r\n this.toSaveLocally.modified = parseInt(this.returnedToClient.modified, 10);\r\n this.toSaveLocally.saveState = this.returnedToClient.saveState || SAVE_STATE_SERVER; //SAVE_STATE_SERVER;\r\n this.toSaveLocally.deleted = (this.returnedToClient.deleted === true || this.returnedToClient.deleted === 'true');\r\n this.toSaveLocally.projectId = parseInt(this.returnedToClient.projectId, 10);\r\n this.toSaveLocally.userId = this.returnedToClient.userId || '';\r\n this.toSaveLocally.draftExpiry = this.returnedToClient.draftExpiry ? parseInt(this.returnedToClient.draftExpiry, 10) : 0;\r\n this.toSaveLocally.draftNotes = this.returnedToClient.draftNotes || null;\r\n this.toSaveLocally.extendedDraft = (this.returnedToClient.extendedDraft === true || this.returnedToClient.extendedDraft === 'true');\r\n return this;\r\n }\r\n\r\n /**\r\n *\r\n * @returns {string}\r\n */\r\n localKey() {\r\n return `occurrence.${this.toSaveLocally.occurrenceId}`;\r\n }\r\n\r\n static register() {\r\n ResponseFactory.responses.occurrence = OccurrenceResponse;\r\n }\r\n}\r\n","// App.js\r\n// base class for single page application\r\n// allows binding of controllers and routes\r\nimport {EventHarness} from \"./EventHarness\";\r\nimport {\r\n Survey,\r\n SURVEY_EVENT_LIST_LENGTH_CHANGED,\r\n} from \"../models/Survey\";\r\nimport {InternalAppError} from \"../utils/exceptions/InternalAppError\";\r\nimport {MODEL_TYPE_OCCURRENCE, Occurrence, OCCURRENCE_EVENT_MODIFIED, OCCURRENCE_EVENT_NEEDS_REFRESH} from \"../models/Occurrence\";\r\nimport {describeDrain, planBatches, selectUnsavedDescriptors} from \"../utils/syncBatching\";\r\nimport localforage from \"localforage\";\r\nimport {MODEL_TYPE_IMAGE, OccurrenceImage} from \"../models/OccurrenceImage\";\r\nimport {Logger} from \"../utils/Logger\";\r\nimport {Model, MODEL_EVENT_SAVED_REMOTELY, uuid} from \"../models/Model\";\r\nimport {Track} from \"../models/Track\";\r\nimport {\r\n //APP_EVENT_ADD_SURVEY_USER_REQUEST,\r\n APP_EVENT_ALL_SYNCED_TO_SERVER,\r\n //APP_EVENT_CURRENT_OCCURRENCE_CHANGED,\r\n APP_EVENT_CURRENT_SURVEY_CHANGED,\r\n APP_EVENT_NEW_SURVEY,\r\n APP_EVENT_OCCURRENCE_ADDED,\r\n APP_EVENT_OCCURRENCE_LOADED,\r\n //APP_EVENT_RESET_SURVEYS,\r\n APP_EVENT_SURVEY_LOADED,\r\n APP_EVENT_SURVEYS_CHANGED,\r\n APP_EVENT_SYNC_ALL_FAILED,\r\n //APP_EVENT_USER_LOGIN,\r\n //APP_EVENT_USER_LOGOUT,\r\n APP_EVENT_OPTIONS_RESTORED,\r\n SURVEY_EVENT_MODIFIED,\r\n SURVEY_EVENT_OCCURRENCES_CHANGED, SURVEY_EVENT_DELETED,\r\n APP_EVENT_SERVICE_WORKER_CHANGED\r\n} from './AppEvents';\r\nimport {DEVICE_TYPE_IMMOBILE, DeviceType} from \"../utils/DeviceType\";\r\nimport {schedulerYield} from \"../utils/schedulerYield\";\r\nimport {SurveyDefinition} from \"../models/SurveyDefinition.js\";\r\nimport {PRECACHE_FAILURE_KEY, SAVE_STATE_SERVER} from \"../utils/constants.js\";\r\nimport {ImageResponse} from \"../serviceworker/responses/ImageResponse.js\";\r\nimport {ImageFileStore} from \"./ImageFileStore.js\";\r\nimport {PINNED_FORAGE_DRIVER, reportForageDriver} from \"../utils/forageDriver.js\";\r\nimport {SurveyResponse} from \"../serviceworker/responses/SurveyResponse.js\";\r\nimport {OccurrenceResponse} from \"../serviceworker/responses/OccurrenceResponse.js\";\r\n\r\n/**\r\n * never retain longer than 14 days\r\n *\r\n * @type {number}\r\n */\r\nexport const OCCURRENCE_MAXIMUM_RETENTION_LIMIT_DAYS = 14;\r\n\r\nexport const OCCURRENCE_DEFAULT_RETENTION_LIMIT_DAYS = 14;\r\n\r\n/**\r\n * @typedef {import('bsbi-app-framework-view').PatchedNavigo} PatchedNavigo\r\n * @typedef {import('bsbi-app-framework-view').Layout} Layout\r\n */\r\n\r\nexport class App extends EventHarness {\r\n /**\r\n * @type {PatchedNavigo}\r\n */\r\n _router;\r\n\r\n /**\r\n * @type {HTMLElement}\r\n */\r\n _containerEl;\r\n\r\n /**\r\n * flag marking test build, set in constructor of child class.\r\n *\r\n * @type {boolean}\r\n */\r\n isTestBuild = false;\r\n\r\n /**\r\n *\r\n * @type {Array.}\r\n */\r\n controllers = [];\r\n\r\n /**\r\n * tracks the handle of the current page controller\r\n * updating this is the responsibility of the controller\r\n *\r\n * *never* set this directly, always use setter\r\n *\r\n * @protected\r\n * @type {number|null}\r\n */\r\n _currentControllerHandle = null;\r\n\r\n /**\r\n * keys set if a particular survey key is enabled\r\n * This may be contolled by build-time flags or dynamic conditions such as device type\r\n *\r\n * @type {Object}\r\n */\r\n static gatedSurveys = {};\r\n\r\n /**\r\n * Set while a purge is in progress, to prevent overlapping conflicting purge operations.\r\n *\r\n * @type {boolean}\r\n * @private\r\n */\r\n static _doingPurge = false;\r\n\r\n /**\r\n * Set if the app should potentially allow tracking (if enabled by the user and supported by the device etc.)\r\n *\r\n * true for RecordingApp, false for PlantAlert\r\n *\r\n * @type {boolean}\r\n */\r\n supportsTracking = false;\r\n\r\n static supportEmail = 'feedback@bsbi.app';\r\n\r\n static majorVersion = 0;\r\n static minorVersion = 0;\r\n\r\n static changeLogMajorVersion = 0;\r\n static changeLogMinorVersion = 0;\r\n\r\n /**\r\n *\r\n * @param {number|null} handle\r\n */\r\n set currentControllerHandle(handle) {\r\n if (handle !== this._currentControllerHandle) {\r\n if (this._currentControllerHandle !== null) {\r\n this.controllers[this._currentControllerHandle].makeNotActive();\r\n }\r\n\r\n this._currentControllerHandle = handle;\r\n\r\n if (this._currentControllerHandle !== null) {\r\n this.controllers[this._currentControllerHandle].makeActive();\r\n }\r\n }\r\n }\r\n\r\n /**\r\n *\r\n * @returns {number|null}\r\n */\r\n get currentControllerHandle() {\r\n return this._currentControllerHandle;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @returns {string|null}\r\n */\r\n get currentControllerName() {\r\n return this.controllers[this._currentControllerHandle].constructor.className;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @returns {number|null}\r\n */\r\n get currentProjectId() {\r\n return this.controllers[this._currentControllerHandle].constructor.projectId || null;\r\n }\r\n\r\n /**\r\n *\r\n * @type {Array.<{url : string}>}\r\n */\r\n routeHistory = [];\r\n\r\n /**\r\n * Used when re-opening with no specified survey\r\n *\r\n * @type {string}\r\n */\r\n homeRoute = '/list/survey/welcome';\r\n\r\n defaultListRoute = '/list';\r\n\r\n /**\r\n * keyed by occurrence id (a UUID string)\r\n *\r\n * @type {Map.}\r\n */\r\n occurrences= new Map();\r\n\r\n /**\r\n * keyed by survey id (a UUID string)\r\n *\r\n * @type {Map.}\r\n */\r\n surveys= new Map();\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * keyed by survey definition id (a UUID string)\r\n * @type {Map}\r\n */\r\n surveyDefinitions = new Map();\r\n\r\n\r\n /**\r\n * @type {?Survey}\r\n */\r\n _currentSurvey = null;\r\n\r\n /**\r\n * @abstract\r\n * @type {number}\r\n */\r\n projectId;\r\n\r\n /**\r\n *\r\n * @type {{[superAdmin] : boolean, [userId] : string} | null}\r\n */\r\n session = null;\r\n\r\n /**\r\n *\r\n * @type {Object}\r\n */\r\n _options = {};\r\n\r\n static DEFAULT_OPTIONS = {};\r\n\r\n /**\r\n *\r\n * @type {string}\r\n * @private\r\n */\r\n _deviceId = '';\r\n\r\n /**\r\n * time in seconds to retain stale surveys\r\n *\r\n * @type {number}\r\n */\r\n staleThreshold = 3600 * 24 * OCCURRENCE_DEFAULT_RETENTION_LIMIT_DAYS; // keep surveys for 14 days\r\n\r\n /**\r\n * called to resolve display promise after the very first navigation happens\r\n *\r\n * @type {function|null}\r\n */\r\n afterFirstNavigationHandler = null;\r\n\r\n /**\r\n *\r\n * @type {Map>}\r\n */\r\n compatibleSurveyDefinitions = new Map();\r\n\r\n /**\r\n * Flags the occurrence of a pervasive Safari bug\r\n * see https://bugs.webkit.org/show_bug.cgi?id=197050\r\n * @type {boolean}\r\n */\r\n static indexedDbConnectionLost = false;\r\n\r\n // /**\r\n // * Event fired when user requests a new blank survey\r\n // *\r\n // * @type {string}\r\n // */\r\n // static EVENT_ADD_SURVEY_USER_REQUEST = APP_EVENT_ADD_SURVEY_USER_REQUEST;\r\n\r\n // /**\r\n // * Event fired when user requests a reset (local clearance) of all surveys\r\n // * @type {string}\r\n // */\r\n // static EVENT_RESET_SURVEYS = APP_EVENT_RESET_SURVEYS;\r\n\r\n // /**\r\n // * Fired after App.currentSurvey has been set to a new blank survey\r\n // * the survey will be accessible in App.currentSurvey\r\n // *\r\n // * @type {string}\r\n // */\r\n // static EVENT_NEW_SURVEY = APP_EVENT_NEW_SURVEY;\r\n\r\n static LOAD_SURVEYS_ENDPOINT = '/loadsurveys.php';\r\n\r\n /**\r\n * IndexedDb key used for storing id of the current (last accessed) survey (or null)\r\n *\r\n * @type {string}\r\n */\r\n static CURRENT_SURVEY_KEY_NAME = 'currentsurvey';\r\n static SESSION_KEY_NAME = 'session';\r\n static DEVICE_ID_KEY_NAME = 'deviceid';\r\n static LOCAL_OPTIONS_KEY_NAME = 'localoptions';\r\n static LAST_APP_VERSION_KEY_NAME = 'appversion';\r\n\r\n /**\r\n * The shared internal-error dialog, built on first use.\r\n *\r\n * @type {HTMLDialogElement|null}\r\n * @private\r\n */\r\n static _internalErrorDialog = null;\r\n\r\n /**\r\n * Tells the user that something unexpected has gone wrong.\r\n *\r\n * For the rare case where a failure is bad enough that the user needs to know about it - not a\r\n * validation message, and not something that can be left to a log entry they will never see.\r\n *\r\n * A native `` rather than a Bootstrap modal, because `bsbi-app-framework` depends on\r\n * localforage and nothing else: Bootstrap is a peer dependency of `bsbi-app-framework-view`, which\r\n * depends on *this* package, so reaching for it here would point that arrow the wrong way. The apps\r\n * already report this sort of thing the same way - see `appUpdateDialog` and `serviceWorkerErrorDialog`\r\n * in the recording app's index.html - so following that idiom costs nothing and matches what a user\r\n * has already seen.\r\n *\r\n * Styled inline rather than from a stylesheet. This dialog exists to report that something has broken,\r\n * and a message that needs the app's own CSS to become legible is no use when a stalled stylesheet is\r\n * one of the things that can break - the same reasoning the start-up watchdog in index.html carries.\r\n *\r\n * **`descriptionHtml` is inserted as markup and must be authored here, never built from user or server\r\n * data.** The title is treated as plain text.\r\n *\r\n * While one error is on screen a second is not shown, so a cascade cannot bury the first message - which\r\n * is usually the one that explains the rest. The suppressed title goes to the console, and the return\r\n * value says which happened.\r\n *\r\n * @param {string} title\r\n * @param {string} descriptionHtml developer-authored markup\r\n * @returns {boolean} true if the dialog was shown, false if one was already open or it could not open\r\n */\r\n static showInternalError(title, descriptionHtml) {\r\n try {\r\n const dialog = App._buildInternalErrorDialog();\r\n\r\n if (!dialog) {\r\n return false;\r\n }\r\n\r\n // The open dialog itself is the test, never a flag of our own. A dialog closes on Escape as\r\n // well as through its button, and neither route runs any code here - so a 'showing' boolean\r\n // would be left set by an Escape and would suppress every later error for the rest of the\r\n // session, silently disabling the one mechanism this exists to provide.\r\n if (dialog.open) {\r\n console.info(`Suppressed a second internal error while one was showing: ${title}`);\r\n\r\n return false;\r\n }\r\n\r\n dialog.querySelector('.bsbi-internal-error-title').textContent = title || 'Something went wrong';\r\n dialog.querySelector('.bsbi-internal-error-body').innerHTML = descriptionHtml || '';\r\n\r\n dialog.showModal();\r\n\r\n return true;\r\n } catch (error) {\r\n // Callers reach this while already handling a failure; throwing from the thing that reports the\r\n // error would be a poor way to repay them.\r\n console.error({'Failed to show the internal error dialog': {title, error}});\r\n\r\n return false;\r\n }\r\n }\r\n\r\n /**\r\n * @returns {HTMLDialogElement|null}\r\n * @private\r\n */\r\n static _buildInternalErrorDialog() {\r\n if (App._internalErrorDialog) {\r\n return App._internalErrorDialog;\r\n }\r\n\r\n if ('undefined' === typeof document || !document.body) {\r\n return null;\r\n }\r\n\r\n const dialog = document.createElement('dialog');\r\n dialog.className = 'bsbi-internal-error';\r\n\r\n // Enough to keep a long description readable, and nothing more - the browser's default dialog box\r\n // is what the app's other dialogs use, so matching it is what makes this look familiar.\r\n dialog.style.maxWidth = 'min(34em, 90vw)';\r\n dialog.style.maxHeight = '80vh';\r\n dialog.style.overflowY = 'auto';\r\n\r\n const heading = dialog.appendChild(document.createElement('p'));\r\n const strong = heading.appendChild(document.createElement('strong'));\r\n strong.className = 'bsbi-internal-error-title';\r\n\r\n const body = dialog.appendChild(document.createElement('div'));\r\n body.className = 'bsbi-internal-error-body';\r\n\r\n // method=\"dialog\" closes it natively on submit, so there is no click handler to bind and none to\r\n // leak - the same arrangement as the dialogs already in index.html.\r\n const form = dialog.appendChild(document.createElement('form'));\r\n form.method = 'dialog';\r\n\r\n const button = form.appendChild(document.createElement('button'));\r\n button.type = 'submit';\r\n button.textContent = 'close';\r\n\r\n document.body.appendChild(dialog);\r\n\r\n App._internalErrorDialog = dialog;\r\n\r\n return dialog;\r\n }\r\n\r\n static RESERVED_KEY_NAMES = [\r\n App.CURRENT_SURVEY_KEY_NAME,\r\n App.SESSION_KEY_NAME,\r\n App.DEVICE_ID_KEY_NAME,\r\n App.LOCAL_OPTIONS_KEY_NAME,\r\n App.LAST_APP_VERSION_KEY_NAME,\r\n ];\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @type {boolean}\r\n */\r\n static devMode = false;\r\n\r\n /**\r\n *\r\n * @private\r\n */\r\n static _DATA_CACHE_VERSION;\r\n\r\n /**\r\n *\r\n * @private\r\n */\r\n static _IMAGE_DATA_CACHE_VERSION;\r\n\r\n static set DATA_CACHE_VERSION(version) {\r\n App._DATA_CACHE_VERSION = `bsbi-data-${version}`;\r\n }\r\n\r\n static get DATA_CACHE_VERSION() {\r\n if (!App._DATA_CACHE_VERSION) {\r\n throw new Error('DATA_CACHE_VERSION has not been initialized');\r\n }\r\n return App._DATA_CACHE_VERSION;\r\n }\r\n\r\n static set IMAGE_DATA_CACHE_VERSION(version) {\r\n App._IMAGE_DATA_CACHE_VERSION = `bsbi-images-${version}`;\r\n }\r\n\r\n static get IMAGE_DATA_CACHE_VERSION() {\r\n if (!App._IMAGE_DATA_CACHE_VERSION) {\r\n throw new Error('IMAGE_DATA_CACHE_VERSION has not been initialized');\r\n }\r\n return App._IMAGE_DATA_CACHE_VERSION;\r\n }\r\n\r\n constructor() {\r\n super();\r\n\r\n // register ResponseHandlers for core objects\r\n ImageResponse.register();\r\n SurveyResponse.register();\r\n OccurrenceResponse.register();\r\n }\r\n\r\n /**\r\n *\r\n * @param {Survey} survey\r\n * @returns {Promise}\r\n */\r\n setCurrentSurvey(survey) {\r\n if (this._currentSurvey?.id !== survey?.id) {\r\n this._currentSurvey = survey || null;\r\n\r\n if (survey) {\r\n // listeners should have been set by App.addSurvey()\r\n // but there might be edge-cases where the listeners have been cleared\r\n // and not re-established.\r\n this._applySurveyListeners(survey);\r\n }\r\n\r\n let surveyId = survey?.id;\r\n return localforage.setItem(App.CURRENT_SURVEY_KEY_NAME, surveyId)\r\n .finally(() => {\r\n this.fireEvent(APP_EVENT_CURRENT_SURVEY_CHANGED, {newSurvey: survey});\r\n });\r\n } else {\r\n return Promise.resolve();\r\n }\r\n }\r\n\r\n /**\r\n * @todo use of this is dangerous, as set is not permanent until the promise completes, instead use setCurrentSurvey()\r\n * @deprecated Use setCurrentSurvey() instead.\r\n * @param {?Survey} survey\r\n */\r\n set currentSurvey(survey) {\r\n\r\n throw new InternalAppError('Use setCurrentSurvey() instead.');\r\n\r\n // if (this._currentSurvey !== survey) {\r\n // this._currentSurvey = survey || null;\r\n //\r\n // if (survey) {\r\n // // listeners should have been set by App.addSurvey()\r\n // // but there might be edge-cases where the listeners have been cleared\r\n // // and not re-established.\r\n // this._applySurveyListeners(survey);\r\n // }\r\n //\r\n // let surveyId = survey?.id;\r\n // localforage.setItem(App.CURRENT_SURVEY_KEY_NAME, surveyId)\r\n // .finally(() => {\r\n // this.fireEvent(APP_EVENT_CURRENT_SURVEY_CHANGED, {newSurvey: survey});\r\n // });\r\n // }\r\n }\r\n\r\n /**\r\n *\r\n * @returns {?Survey}\r\n */\r\n get currentSurvey() {\r\n return this._currentSurvey;\r\n }\r\n\r\n get userId() {\r\n return this.session?.userId;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @returns {Promise<{}>}\r\n */\r\n restoreOptions() {\r\n const userId = this.userId;\r\n\r\n if (userId) {\r\n return localforage.getItem(`${App.LOCAL_OPTIONS_KEY_NAME}.${userId}`)\r\n .then((options) => {\r\n if (options) {\r\n // apply user's options over the top of a copy of the defaults\r\n this._options = Object.assign(JSON.parse(JSON.stringify(this.constructor.DEFAULT_OPTIONS)), options);\r\n } else {\r\n this._options = JSON.parse(JSON.stringify(this.constructor.DEFAULT_OPTIONS));\r\n }\r\n\r\n // return a clone of the options (to prevent improper direct modification\r\n const clonedOptions = JSON.parse(JSON.stringify(this._options));\r\n\r\n this.fireEvent(APP_EVENT_OPTIONS_RESTORED, clonedOptions);\r\n\r\n return clonedOptions;\r\n });\r\n } else {\r\n return Promise.reject('User ID unset when restoring options.');\r\n }\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n */\r\n clearOptions() {\r\n this._options = null;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {{}} rawOptions\r\n * @returns {Promise>}\r\n */\r\n setOptions(rawOptions) {\r\n const userId = this.userId;\r\n\r\n if (userId) {\r\n if (!this.options) {\r\n this.options = {};\r\n }\r\n\r\n Object.assign(this._options, rawOptions);\r\n\r\n return localforage.setItem(`${App.LOCAL_OPTIONS_KEY_NAME}.${userId}`, this._options);\r\n } else {\r\n return Promise.reject(`User ID unset when setting options.`);\r\n }\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {string} key\r\n * @param value\r\n * @returns {Promise>}\r\n */\r\n setOption(key, value) {\r\n const userId = this.userId;\r\n\r\n if (userId) {\r\n this._options[key] = JSON.parse(JSON.stringify(value));\r\n\r\n return localforage.setItem(`${App.LOCAL_OPTIONS_KEY_NAME}.${userId}`, this._options);\r\n } else {\r\n return Promise.reject(`User ID unset when setting option '${key}'.`);\r\n }\r\n }\r\n\r\n /**\r\n *\r\n * @param {string} key\r\n * @returns {any|undefined}\r\n */\r\n getOption(key) {\r\n return this._options?.hasOwnProperty?.(key) ? JSON.parse(JSON.stringify(this._options[key])) : undefined;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {string} key\r\n * @returns {boolean}\r\n */\r\n hasOption(key) {\r\n return this._options?.hasOwnProperty?.(key) || false;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * @returns {Promise}\r\n */\r\n /**\r\n * Reads and clears whatever the service worker recorded about a failed precache.\r\n *\r\n * The worker cannot report this itself - see PRECACHE_FAILURE_KEY - so it writes and the page reads.\r\n * Cleared here rather than by the caller, because the record has served its purpose once it has been\r\n * handed over, and leaving it would produce the same entry on every subsequent start.\r\n *\r\n * @returns {Promise<{stamp: number, version: string, essential: boolean, failures: Array<{url: string, reason: string}>, total: number}|null>}\r\n */\r\n takePrecacheFailureRecord() {\r\n return localforage.getItem(PRECACHE_FAILURE_KEY).then((record) => {\r\n if (!record) {\r\n return null;\r\n }\r\n\r\n return localforage.removeItem(PRECACHE_FAILURE_KEY).then(() => record, () => record);\r\n }, (error) => {\r\n console.error({'Failed to read the precache failure record': error});\r\n return null;\r\n });\r\n }\r\n\r\n initialiseDeviceId() {\r\n if (!this._deviceId) {\r\n return localforage.getItem(App.DEVICE_ID_KEY_NAME)\r\n .then((deviceId) => {\r\n if (deviceId && deviceId !== 'undefined') {\r\n this._deviceId = deviceId;\r\n return deviceId;\r\n } else {\r\n const deviceId = uuid();\r\n\r\n return localforage.setItem(App.DEVICE_ID_KEY_NAME, deviceId)\r\n .then(() => {\r\n this._deviceId = deviceId;\r\n return deviceId;\r\n })\r\n }\r\n });\r\n } else {\r\n return Promise.resolve(this._deviceId);\r\n }\r\n }\r\n\r\n /**\r\n *\r\n * @returns {string}\r\n */\r\n get deviceId() {\r\n if (!this._deviceId) {\r\n throw new Error(\"Device ID has not been initialised.\");\r\n }\r\n\r\n return this._deviceId;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @returns {Promise<{major: number, minor : number} | null>}\r\n */\r\n getStoredAppVersion() {\r\n return localforage.getItem(App.LAST_APP_VERSION_KEY_NAME).then((version) => (version ? { major: parseInt(version.major, 10), minor: parseInt(version.minor, 10) } : null));\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {{major: number, minor : number}} version\r\n * @returns {Promise}\r\n */\r\n setStoredAppVersion(version) {\r\n return localforage.setItem(App.LAST_APP_VERSION_KEY_NAME, version);\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {string} key\r\n * @param value\r\n * @returns {Promise<*>}\r\n */\r\n forageSetItem(key, value) {\r\n return localforage.setItem(key, value);\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {string} key\r\n * @returns {Promise}\r\n */\r\n forageGetItem(key) {\r\n return localforage.getItem(key);\r\n }\r\n\r\n /**\r\n *\r\n * @param {string} key\r\n * @returns {Promise}\r\n */\r\n forageRemoveItem(key) {\r\n return localforage.removeItem(key);\r\n }\r\n\r\n /**\r\n * @abstract\r\n * @protected\r\n */\r\n _updateUnsavedMarkerCss() {\r\n\r\n }\r\n\r\n /**\r\n * note that the last survey might not belong to the current user\r\n *\r\n * @returns {Promise}\r\n */\r\n getLastSurveyId() {\r\n return localforage.getItem(App.CURRENT_SURVEY_KEY_NAME)\r\n .catch((error) => {\r\n console.log({'Error retrieving last survey id' : error});\r\n return Promise.resolve(null);\r\n });\r\n }\r\n\r\n clearLastSurveyId() {\r\n return localforage.removeItem(App.CURRENT_SURVEY_KEY_NAME)\r\n .catch((error) => {\r\n console.log({'Error removing last survey id' : error});\r\n return Promise.resolve(null);\r\n });\r\n }\r\n\r\n /**\r\n * @type {Layout}\r\n */\r\n layout;\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {string} name\r\n */\r\n setLocalForageName(name) {\r\n const configResult = localforage.config({\r\n name: name,\r\n driver: PINNED_FORAGE_DRIVER, // never silently fall back — see forageDriver.js\r\n });\r\n\r\n // image binaries are held in a separate database, derived from the same name\r\n ImageFileStore.configure(name);\r\n\r\n return reportForageDriver(localforage, configResult, 'records');\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * Try to enable persistent storage if installed and running on mobile.\r\n *\r\n * @param always\r\n * @returns {Promise|Promise}\r\n */\r\n tryPersistStorage(always = false) {\r\n if ((always || window.matchMedia('(display-mode: standalone)').matches) &&\r\n navigator?.storage?.persist && navigator?.storage?.persisted &&\r\n DeviceType.getDeviceType() !== DEVICE_TYPE_IMMOBILE\r\n ) {\r\n return navigator.storage.persisted().then((persistent) => {\r\n if (persistent) {\r\n console.log('Storage already persisted');\r\n } else {\r\n console.log('Attempting to enable persistent storage');\r\n return navigator.storage.persist().then((persistent) => {\r\n if (persistent) {\r\n console.log('Storage now persists.');\r\n //return Logger.logError('Storage now persists.');\r\n return Promise.resolve();\r\n } else {\r\n console.log('Failed to enable persistent storage.');\r\n return Logger.logError('Failed to enable persistent storage.');\r\n }\r\n });\r\n }\r\n }, (error) => {\r\n console.error({'Failure reading state of persistent storage' : error});\r\n return Promise.reject({'Failure reading state of persistent storage' : error});\r\n });\r\n } else {\r\n return Promise.resolve();\r\n }\r\n }\r\n\r\n /**\r\n * This is a soft-reset (e.g. after log-out) rather than a hard clear of storage\r\n *\r\n * @returns {Promise}\r\n */\r\n reset() {\r\n this.surveys = new Map();\r\n Track.reset();\r\n return this.clearCurrentSurvey().then(() => this.clearLastSurveyId());\r\n }\r\n\r\n /**\r\n * unset the current survey and its associated list of occurrences\r\n * called when switching surveys and during startup\r\n *\r\n * updates local storage last saved survey id\r\n *\r\n * @param {string|null} surveyId only used as a sanity check\r\n *\r\n * @returns {Promise}\r\n */\r\n clearCurrentSurvey(surveyId = null) {\r\n if (surveyId && this._currentSurvey && surveyId !== this._currentSurvey.id) {\r\n // theoretical weird error state where the current survey has changed prior to call to clearCurrentSurvey()\r\n console.error('Conflicting survey id in clearCurrentSurvey()');\r\n return Promise.reject('Conflicting survey id in clearCurrentSurvey()');\r\n }\r\n\r\n try {\r\n for (let occurrenceTuple of this.occurrences) {\r\n occurrenceTuple[1].destructor();\r\n }\r\n } catch (e) {\r\n console.error({\"in clearCurrentSurvey, failed occurrence destruction\" : e});\r\n }\r\n\r\n this.occurrences = new Map();\r\n\r\n try {\r\n if (this._currentSurvey) {\r\n this._currentSurvey.destructor();\r\n this._currentSurvey = null; // must not use setter here otherwise local storage saved previous id will be lost\r\n }\r\n } catch (e) {\r\n console.error({\"in clearCurrentSurvey, failed survey destruction\" : e});\r\n }\r\n return this.clearLastSurveyId();\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * see https://github.com/krasimir/navigo\r\n * @param {PatchedNavigo} router\r\n */\r\n set router(router) {\r\n this._router = router;\r\n }\r\n\r\n /**\r\n *\r\n * @returns {PatchedNavigo}\r\n */\r\n get router() {\r\n return this._router;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {string} containerId\r\n */\r\n set containerId(containerId) {\r\n const el = document.getElementById(containerId);\r\n if (!el) {\r\n throw new Error(`App container '${containerId}' not found.`);\r\n } else {\r\n this._containerEl = el;\r\n }\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n get container() {\r\n return this._containerEl;\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {AppController} controller\r\n */\r\n registerController(controller) {\r\n controller.handle = this.controllers.length;\r\n this.controllers[this.controllers.length] = controller;\r\n\r\n controller.app = this;\r\n controller.registerRoute(this._router);\r\n }\r\n\r\n initialise() {\r\n this.layout.initialise();\r\n\r\n // this.addListener(APP_EVENT_WATCH_GPS_USER_REQUEST, () => {\r\n // EventHarness.staticFireEvent(App, APP_EVENT_WATCH_GPS_USER_REQUEST);\r\n // });\r\n\r\n // this.addListener(APP_EVENT_CANCEL_WATCHED_GPS_USER_REQUEST, () => {\r\n // EventHarness.staticFireEvent(App, APP_EVENT_CANCEL_WATCHED_GPS_USER_REQUEST);\r\n // });\r\n\r\n for (let controller of this.controllers) {\r\n controller.initialise();\r\n }\r\n\r\n this._router.notFound((query) => {\r\n // called when there is a path specified but\r\n // there is no route matching\r\n\r\n console.log(`no route found for '${query}'`);\r\n //this._router.navigate('/list');\r\n\r\n // const view = new NotFoundView();\r\n // view.display();\r\n this.notFoundView();\r\n });\r\n\r\n this._router.hooks({\r\n //before: (done, params) => { ... },\r\n after: () => {\r\n // generic 'after' handler for all routes\r\n if (this.afterFirstNavigationHandler) {\r\n try {\r\n this.afterFirstNavigationHandler();\r\n } finally {\r\n this.afterFirstNavigationHandler = null;\r\n }\r\n }\r\n }\r\n });\r\n\r\n //default homepage\r\n this._router.on(() => {\r\n // special-case redirect (replacing in history) from '/' to '/list' without updating browser history\r\n\r\n console.log(\"redirecting from '/'\");\r\n\r\n this._router.pause();\r\n\r\n if (!this.currentSurvey) {\r\n console.log(`redirecting without survey from '/' to '${this.homeRoute}'`);\r\n this._router.navigate(this.homeRoute).resume();\r\n } else if (this.currentSurvey && this.currentSurvey.isPristine) {\r\n console.log(`redirecting from '/' to '${this.homeRoute}'`);\r\n this._router.navigate(this.homeRoute).resume();\r\n } else {\r\n console.log(`redirecting from '/' to '${this.defaultListRoute}'`);\r\n this._router.navigate(this.defaultListRoute).resume();\r\n }\r\n this._router.resolve();\r\n });\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * Returns a promise that resolves after the initial navigation completes\r\n *\r\n * @returns {Promise}\r\n */\r\n display() {\r\n return new Promise((resolve) => {\r\n this.afterFirstNavigationHandler = resolve;\r\n this._router.resolve();\r\n });\r\n }\r\n\r\n /**\r\n *\r\n */\r\n saveRoute() {\r\n const lastRoute = this._router.lastRouteResolved();\r\n if (this.routeHistory.length) {\r\n if (this.routeHistory[this.routeHistory.length - 1] !== lastRoute) {\r\n this.routeHistory[this.routeHistory.length] = lastRoute;\r\n }\r\n } else {\r\n this.routeHistory[0] = lastRoute;\r\n }\r\n }\r\n\r\n /**\r\n * returns true if window history state is not null and not an empty object\r\n *\r\n * @returns {boolean}\r\n */\r\n windowHasHistoryState() {\r\n return this.routeHistory.length > 0;\r\n\r\n // const state = window.history.state;\r\n //\r\n // return (state !== null && typeof state === 'object' && Object.keys(state).length > 0);\r\n }\r\n\r\n /**\r\n * Go back to the last page logged in the app's history thread\r\n * Usually used after temporary navigation to service handling urls\r\n */\r\n revertUrl() {\r\n this.router.pause();\r\n if (this.windowHasHistoryState()) {\r\n window.history.back(); // this could fail if the previous url was not under the single-page-app umbrella (should test)\r\n }\r\n this.router.resume();\r\n }\r\n\r\n /**\r\n * mark the current survey and its constituent records as subject to validation checks (not pristine)\r\n */\r\n markAllNotPristine() {\r\n for (let occurrenceTuple of this.occurrences) {\r\n occurrenceTuple[1].isPristine = false;\r\n }\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {Layout} layout\r\n */\r\n setLayout(layout) {\r\n this.layout = layout;\r\n layout.setApp(this);\r\n }\r\n\r\n /**\r\n * App implementations may replace this to allow more complex project id matching\r\n *\r\n * @param {number} projectId\r\n * @returns {boolean}\r\n */\r\n projectIdIsCompatible(projectId) {\r\n return projectId === this.projectId;\r\n }\r\n\r\n /**\r\n * Adds or updates the survey\r\n * Caller should always use the returned value, *which may have become a reference to the original now amended survey*\r\n *\r\n * @param {Survey} survey\r\n * @returns {Survey}\r\n */\r\n addSurvey(survey) {\r\n if (!this.projectIdIsCompatible(survey.projectId)) {\r\n throw new Error(`Survey project id '${survey.projectId} does not match with current project ('${this.projectId}')`);\r\n }\r\n\r\n let changes = false;\r\n\r\n if (this.surveys.has(survey.id)) {\r\n const previousSurvey = this.surveys.get(survey.id);\r\n\r\n if (previousSurvey.modifiedStamp !== survey.modifiedStamp) {\r\n changes = true;\r\n survey = previousSurvey.mergeUpdate(survey);\r\n } else {\r\n survey = previousSurvey;\r\n }\r\n } else {\r\n this.surveys.set(survey.id, survey);\r\n changes = true;\r\n }\r\n\r\n if (changes) {\r\n this.fireEvent(APP_EVENT_SURVEYS_CHANGED);\r\n }\r\n\r\n this._applySurveyListeners(survey);\r\n\r\n return survey;\r\n }\r\n\r\n /**\r\n *\r\n * @param {Survey} survey\r\n * @private\r\n */\r\n _applySurveyListeners(survey) {\r\n if (!survey.hasAppModifiedListener) {\r\n survey.hasAppModifiedListener = true;\r\n\r\n //console.log(\"setting survey's modified/save handler\");\r\n survey.addListener(\r\n SURVEY_EVENT_MODIFIED,\r\n () => {\r\n // survey.save().finally(() => {\r\n // this.fireEvent(APP_EVENT_SURVEYS_CHANGED);\r\n // });\r\n\r\n // no need for promise chaining here as the save is queued\r\n // noinspection JSIgnoredPromiseFromCall\r\n survey.save();\r\n this.fireEvent(APP_EVENT_SURVEYS_CHANGED);\r\n }\r\n );\r\n }\r\n\r\n if (!survey.hasDeleteListener) {\r\n survey.hasDeleteListener = true;\r\n\r\n survey.addListener(\r\n SURVEY_EVENT_DELETED,\r\n () => {\r\n let promise = Promise.resolve();\r\n\r\n // do this slightly more safely via ids, in case surveys somehow refer to different objects\r\n if (this.currentSurvey?.id === survey.id) {\r\n promise = promise.then(() => this.setCurrentSurvey(null));\r\n }\r\n\r\n promise.then(() => {\r\n this.surveys.delete(survey.id);\r\n\r\n // only clear from local storage if the deletion has gone through\r\n if (survey.savedRemotely) {\r\n return this.forageRemoveItem(`survey.${survey.id}`);\r\n }\r\n }).then(() => {\r\n survey.destructor();\r\n this.fireEvent(APP_EVENT_SURVEYS_CHANGED);\r\n // @intentional end of promise chain\r\n });\r\n }\r\n );\r\n }\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * tests whether occurrences have been defined, excluding any that have been deleted\r\n *\r\n * @returns {boolean}\r\n */\r\n haveExtantOccurrences() {\r\n for (let occurrence of this.occurrences) {\r\n\r\n // occurrence should at least exist (null entries shouldn't be possible, but want to allow for something\r\n // having gone awry)\r\n if (!occurrence?.deleted) {\r\n return true;\r\n }\r\n }\r\n return false;\r\n }\r\n\r\n /**\r\n *\r\n * @param {Occurrence} occurrence\r\n */\r\n addOccurrence(occurrence) {\r\n if (!occurrence.surveyId) {\r\n throw new InternalAppError('Survey id must set prior to registering occurrence.');\r\n }\r\n\r\n // set the survey creation stamp to match the earliest extant occurrence\r\n // this avoids anomalies where a 'stale' survey created when the form was first opened but not used sits around\r\n // for a protracted period\r\n\r\n const survey = this.surveys.get(occurrence.surveyId);\r\n if (!survey) {\r\n App.showInternalError('Failed to find survey','

When adding an occurrence record, the survey could not be found. This is a bug in the application. The new occurrence has not been added.

If the problem persists, then please close and reopen the app.

');\r\n throw new Error(`Failed to look up survey id ${occurrence.surveyId}`);\r\n }\r\n\r\n if (occurrence.createdStamp &&\r\n (this.occurrences.size === 0 || survey.createdStamp > occurrence.createdStamp)) {\r\n\r\n survey.createdStamp = occurrence.createdStamp;\r\n }\r\n //console.log(`in addOccurrence setting id '${occurrence.id}'`);\r\n this.occurrences.set(occurrence.id, occurrence);\r\n\r\n // listener will be cleared when the occurrence is destroyed (which happens during survey change)\r\n occurrence.addListener(OCCURRENCE_EVENT_MODIFIED,\r\n () => {\r\n const survey = this.surveys.get(occurrence.surveyId);\r\n if (!survey) {\r\n // this should be impossible but seems to happen\r\n\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logError(`Failed to look up survey id ${occurrence.surveyId} in app listener for OCCURRENCE_EVENT_MODIFIED; available surveys: ${Array.from(this.surveys.keys()).join(',')}`);\r\n\r\n // in desperation, try to save the occurrence anyway\r\n occurrence.save().then(() => {\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logError(`Saved modified occurrence ${occurrence.id} for missing survey ${occurrence.surveyId}.`);\r\n // @intentional end of promise chain\r\n });\r\n\r\n throw new Error(`Failed to look up survey id ${occurrence.surveyId} in app listener for OCCURRENCE_EVENT_MODIFIED`);\r\n } else {\r\n survey.isPristine = false;\r\n\r\n // Need to ensure that the currentSurvey is saved before occurrence.\r\n // Rather than using a promise chain here, instead rely on the enforced queuing of post requests by the Model,\r\n // otherwise there are problems with queue-jumping (e.g. when an image needs to be saved after both previous requests).\r\n if (survey.unsaved()) {\r\n // noinspection JSIgnoredPromiseFromCall\r\n survey.save(true).catch((reason) => {\r\n console.error(reason);\r\n // @intentional no throw needed at end of chain\r\n });\r\n }\r\n\r\n schedulerYield()\r\n .then(() => {\r\n return occurrence.save();\r\n })\r\n .catch((reason) => {\r\n console.error(reason);\r\n // @intentional no throw needed at end of chain\r\n })\r\n .finally(() => {\r\n // Resolves once the occurrence is durable locally; the remote save\r\n // continues in the background and refreshes the marker separately\r\n // (see the MODEL_EVENT_SAVED_REMOTELY listener below).\r\n survey.fireEvent(SURVEY_EVENT_OCCURRENCES_CHANGED, {occurrenceId: occurrence.id});\r\n // @intentional end of promise chain\r\n });\r\n }\r\n });\r\n\r\n // The 'unsaved' marker means 'not yet on the server', but occurrence.save() now resolves as\r\n // soon as the record is durable locally, so the marker has to be refreshed again when the\r\n // background post completes.\r\n // The marker sheet is updated directly rather than by re-firing SURVEY_EVENT_OCCURRENCES_CHANGED,\r\n // as that event also drives track, taxon-search and view refreshes that aren't wanted here.\r\n occurrence.addListener(MODEL_EVENT_SAVED_REMOTELY, () => this._scheduleUnsavedMarkerUpdate());\r\n\r\n this.fireEvent(APP_EVENT_OCCURRENCE_LOADED, {occurrence: occurrence});\r\n }\r\n\r\n /**\r\n * set while a marker refresh is already pending\r\n *\r\n * @type {boolean}\r\n * @private\r\n */\r\n _unsavedMarkerUpdateScheduled = false;\r\n\r\n /**\r\n * Coalesces marker refreshes, as _updateUnsavedMarkerCss() rebuilds a stylesheet from the whole\r\n * occurrence set and remote saves can complete in rapid bursts (particularly during a sync-all).\r\n *\r\n * @protected\r\n */\r\n _scheduleUnsavedMarkerUpdate() {\r\n if (this._unsavedMarkerUpdateScheduled) {\r\n return;\r\n }\r\n\r\n this._unsavedMarkerUpdateScheduled = true;\r\n\r\n schedulerYield().then(() => {\r\n this._unsavedMarkerUpdateScheduled = false;\r\n this._updateUnsavedMarkerCss();\r\n // @intentional end of promise chain\r\n });\r\n }\r\n\r\n /**\r\n * attempts to refresh the state of local storage for the specified survey ids\r\n * If the fetch fails, then return a failed promise.\r\n *\r\n * updates local copy of surveys and occurrences\r\n *\r\n * no service worker interception of this call - passed through and not cached\r\n *\r\n * @param {Array.} surveyIds\r\n * @param {boolean} specifiedSurveysOnly if set then don't return a full extended refresh, only the specified surveys\r\n * @param {number|null} maxAge maximum age (in seconds) of surveys to retrieve (excluding specified ids, which are unconstrained), applicable only if a user id is provided, default null. If null then use users preference setting if available.\r\n * @return {Promise}\r\n */\r\n refreshFromServer(surveyIds, specifiedSurveysOnly = false, maxAge = null) {\r\n //console.log({'Refresh from server, ids' : surveyIds});\r\n const formData = new FormData;\r\n\r\n let n = 0;\r\n for (let key of surveyIds) {\r\n if (key && key !== 'undefined') {\r\n formData.append(`surveyId[${n++}]`, key);\r\n }\r\n }\r\n\r\n if (this.session?.userId) {\r\n formData.append('userId', this.session.userId);\r\n\r\n if (!maxAge) {\r\n const retentionDays = this.getOption('retentionTime');\r\n\r\n if (retentionDays && retentionDays <= OCCURRENCE_MAXIMUM_RETENTION_LIMIT_DAYS) {\r\n maxAge = retentionDays * 3600 * 24; // convert from days to seconds\r\n }\r\n }\r\n\r\n // relevant only if a user is logged in\r\n if (maxAge) {\r\n formData.append('userMaxAge', maxAge.toString());\r\n }\r\n }\r\n\r\n if (specifiedSurveysOnly) {\r\n formData.append('specifiedOnly', '1');\r\n }\r\n\r\n formData.append('isMobile', DeviceType.getDeviceType() !== DEVICE_TYPE_IMMOBILE);\r\n\r\n return fetch(App.LOAD_SURVEYS_ENDPOINT, {\r\n method: 'POST',\r\n body: formData\r\n }).then(response => {\r\n if (response.ok) {\r\n return response.json();\r\n } else {\r\n return Promise.reject(`Invalid response from server when refreshing survey ids`);\r\n }\r\n }).then((jsonResponse) => {\r\n /** @param {{survey : Array., occurrence: Array., image: Array.}} jsonResponse */\r\n\r\n //console.log({'refresh from server json response' : jsonResponse});\r\n\r\n // if the external object is newer than the local version then place in local storage\r\n let promise = Promise.resolve();\r\n\r\n for (let type in jsonResponse) {\r\n if (jsonResponse.hasOwnProperty(type)) {\r\n for (let object of jsonResponse[type]) {\r\n promise = promise.then(() => this._conditionallyReplaceObject(object))\r\n .catch((reason) => {\r\n console.error({'Failed to replace' : {type, id : object.id, reason}});\r\n return Promise.resolve();\r\n })\r\n ;\r\n }\r\n }\r\n }\r\n\r\n return promise;\r\n });\r\n }\r\n\r\n /**\r\n * Compare modified stamp of the local and external objects and write the external version\r\n * locally if more recent.\r\n * This is even allowed to overwrite changes that have not yet been saved locally.\r\n *\r\n * @param {{id : string, type : string, modified : number, created : number, saveState : string, deleted : boolean}} externalVersion\r\n * @returns {Promise<{}>} resolves with the current version, local or external\r\n * @protected\r\n */\r\n _conditionallyReplaceObject(externalVersion) {\r\n const objectType = externalVersion.type;\r\n const id = externalVersion.id;\r\n const key = `${objectType}.${id}`;\r\n\r\n return localforage.getItem(key)\r\n .then((localVersion) => {\r\n if (localVersion) {\r\n // compare stamps\r\n\r\n if (!externalVersion.deleted && localVersion.modified >= externalVersion.modified) {\r\n this.isTestBuild && console.info(`Local copy of ${key} is the same or newer than the server copy. (${localVersion.modified} >= ${externalVersion.modified}) `);\r\n return localVersion;\r\n }\r\n } else {\r\n this.isTestBuild && console.info(`Adding new ${key} from server. (locally absent)`);\r\n }\r\n\r\n // No local copy or a stale copy,\r\n // so store response locally.\r\n return localforage.setItem(key, externalVersion).then(() => externalVersion);\r\n });\r\n }\r\n\r\n /**\r\n * retrieve the full set of keys from local storage (IndexedDb)\r\n *\r\n * @param {{survey: Array, occurrence : Array, image: Array, [track]: Array}} storedObjectKeys\r\n * @returns {Promise<{\r\n * survey: Array,\r\n * occurrence: Array,\r\n * image: Array,\r\n * [track]: Array\r\n * }>}\r\n */\r\n seekKeys(storedObjectKeys = {survey: [], occurrence: [], image: [], track: []}) {\r\n\r\n return localforage.keys().then((keys) => {\r\n\r\n const reservedNamesRegex = new RegExp(`^(?:${App.RESERVED_KEY_NAMES.join('|')})\\\\b`);\r\n\r\n for (let key of keys) {\r\n\r\n if (!key.match(reservedNamesRegex)) {\r\n let type, id, deviceId;\r\n\r\n [type, id, deviceId] = key.split('.', 3);\r\n\r\n if (storedObjectKeys.hasOwnProperty(type)) {\r\n if (type === 'track') {\r\n // tracks keys consist of id.deviceId rather than just id\r\n\r\n if (!storedObjectKeys[type].includes(`${id}.${deviceId}`)) {\r\n storedObjectKeys[type].push(`${id}.${deviceId}`);\r\n }\r\n } else if (!storedObjectKeys[type].includes(id)) {\r\n if (id && id !== 'undefined') {\r\n storedObjectKeys[type].push(id);\r\n }\r\n }\r\n }\r\n // else {\r\n // // 'track', 'log' and 'surveydefinition' records are not always wanted here, but not an error\r\n // if (type !== 'track' && type !== 'log' && type !== 'surveydefinition') {\r\n // console.error(`Unrecognised stored key type '${type}'.`);\r\n // }\r\n // }\r\n }\r\n }\r\n\r\n return storedObjectKeys;\r\n });\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * Purge local entries that are older than the threshold or orphaned and which have been saved externally\r\n *\r\n * @returns {Promise}\r\n */\r\n purgeStale(fastReturn = true) {\r\n if (App._doingPurge) {\r\n console.error('Already doing a purge');\r\n\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logError('Already doing a purge');\r\n return Promise.resolve();\r\n }\r\n\r\n App._doingPurge = true;\r\n\r\n const thresholdDays = this.getOption('retentionTime');\r\n if (thresholdDays >= 1 && thresholdDays <= OCCURRENCE_MAXIMUM_RETENTION_LIMIT_DAYS) {\r\n this.staleThreshold = thresholdDays * 3600 * 24;\r\n }\r\n\r\n // No seekKeys() call here any more: _purgeLocal() gathers keys and values together in a\r\n // single cursor pass, rather than a key walk followed by one getItem per record.\r\n const promise = this._purgeLocal()\r\n .catch((failedResult) => {\r\n console.error({'Failed to purge': failedResult});\r\n Logger.logError(`Failed to purge: ${Logger.stringifyObject(failedResult)}`)\r\n .finally(() => {\r\n // cope with the pervasive Safari crash\r\n // see https://bugs.webkit.org/show_bug.cgi?id=197050\r\n if (failedResult.toString().includes('Connection to Indexed Database server lost')) {\r\n // @todo before forcing a reload, should prompt the user to take remedial access, e.g. screenshotting data or transcribing results\r\n\r\n App.showInternalError(\"Internal storage error\", \"

The app's local database connection has been lost. Please close and reopen the app.

Unsaved records may be at risk of loss. Please immediately make a separate copy of records from the current survey. Taking screenshots may help with this.

Once that is done, please close and reopen the app.

We're sorry for the disruption, which is due to a bug in the underlying web browser storage system.

Please report this error to feedback@bsbi.app

\");\r\n\r\n App.indexedDbConnectionLost = true;\r\n //location.reload();\r\n }\r\n\r\n // @intentional end of promise chain\r\n });\r\n\r\n //this.fireEvent(APP_EVENT_PURGE_FAILED);\r\n return Promise.reject(failedResult);\r\n }).finally(() => {\r\n App._doingPurge = false;\r\n // @intentional end of promise chain\r\n });\r\n\r\n return fastReturn ?\r\n Promise.resolve()\r\n :\r\n promise;\r\n }\r\n\r\n /**\r\n * Flag to prevent multiple syncAll sequences happening at once\r\n *\r\n * @type {boolean}\r\n * @private\r\n */\r\n static _syncAllInProgress = false;\r\n\r\n /**\r\n * Timestamp (ms unixtime) of last successful sync all attempt\r\n *\r\n * @type {number}\r\n */\r\n static lastSyncAllTimestamp = 0;\r\n\r\n /**\r\n * Minimum interval after last sync all to attempt another automatically\r\n *\r\n * 15 min in milliseconds\r\n */\r\n static syncAllInterval = 15 * 60 * 1000;\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n */\r\n registerSyncAllOnVisibleListener () {\r\n document.addEventListener('visibilitychange', () => {\r\n if (document.visibilityState === \"visible\"\r\n && navigator.onLine\r\n && !App._syncAllInProgress\r\n && (App.lastSyncAllTimestamp + App.syncAllInterval) < Date.now()) {\r\n\r\n console.info('Sync all attempt triggered by visibility change.');\r\n\r\n schedulerYield().then(() => this.syncAll()\r\n .catch(e => {\r\n console.error({'sync all failure on visability change' : e});\r\n // @intentional allow promise to continue after catch\r\n })\r\n .finally(() => {\r\n console.info('Sync all attempt triggered by visibility change - finished.');\r\n // @intentional end of promise chain\r\n })\r\n );\r\n }\r\n });\r\n }\r\n\r\n /**\r\n * Timestamp (ms unixtime) of the last sync triggered by a connectivity change.\r\n *\r\n * @type {number}\r\n */\r\n static lastOnlineSyncAllTimestamp = 0;\r\n\r\n /**\r\n * Minimum interval between syncs triggered by regaining a connection.\r\n *\r\n * Deliberately far shorter than syncAllInterval. Coming back into signal is the moment a\r\n * backlog most wants clearing, and a sync attempted while offline returns immediately without\r\n * recording a timestamp, so the ordinary throttle would needlessly hold the first real\r\n * opportunity back. This guard exists only to absorb a flapping connection - a train journey\r\n * will raise online/offline repeatedly - rather than to ration syncing.\r\n *\r\n * 1 min in milliseconds\r\n */\r\n static onlineSyncAllInterval = 60 * 1000;\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * Syncs as soon as a connection returns, rather than waiting for the user to look at the screen.\r\n *\r\n * Without this the only automatic trigger is a visibility change, so a phone carried in a pocket\r\n * can walk back into signal and sync nothing until it is next unlocked.\r\n */\r\n registerSyncAllOnOnlineListener () {\r\n globalThis.addEventListener?.('online', () => {\r\n if (App._syncAllInProgress) {\r\n return;\r\n }\r\n\r\n if ((App.lastOnlineSyncAllTimestamp + App.onlineSyncAllInterval) > Date.now()) {\r\n // connection is flapping; the attempt already under way or just made will do\r\n return;\r\n }\r\n\r\n App.lastOnlineSyncAllTimestamp = Date.now();\r\n\r\n console.info('Sync all attempt triggered by connectivity returning.');\r\n\r\n schedulerYield().then(() => this.syncAll()\r\n .catch(e => {\r\n console.error({'sync all failure after connectivity gained' : e});\r\n // @intentional allow promise to continue after catch\r\n })\r\n .finally(() => {\r\n console.info('Sync all attempt triggered by connectivity returning - finished.');\r\n // @intentional end of promise chain\r\n })\r\n );\r\n });\r\n }\r\n\r\n /**\r\n * @param {boolean} fastReturn If set then the promise returns more quickly once the saves have been queued but not all effected\r\n * This should allow surveys to be switched etc. without disrupting the ongoing save process.\r\n * @returns {Promise<{savedCount : {}}|void>}\r\n */\r\n syncAll(fastReturn = true) {\r\n\r\n //if ((App._syncAllInProgress || !navigator.onLine) && fastReturn) {\r\n if (App._syncAllInProgress || !navigator.onLine) {\r\n console.info(\"Skipped sync-all as another sync is already in progress or the device is offline.\");\r\n return Promise.resolve();\r\n }\r\n\r\n App._syncAllInProgress = true;\r\n App.lastSyncAllTimestamp = Date.now();\r\n\r\n const storedObjectKeys = {\r\n survey : [],\r\n occurrence : [],\r\n image : [],\r\n track : [],\r\n };\r\n\r\n let promise;\r\n\r\n try {\r\n promise = this.seekKeys(storedObjectKeys)\r\n .then((storedObjectKeys) => {\r\n return this._syncLocalUnsaved(storedObjectKeys, fastReturn)\r\n .then((result) => {\r\n if (!fastReturn) {\r\n // Can only trigger the event once the whole process is complete, rather than after\r\n // a short-cut fast return.\r\n this.fireEvent(APP_EVENT_ALL_SYNCED_TO_SERVER, result);\r\n }\r\n\r\n return result;\r\n }, (failedResult) => {\r\n this.fireEvent(APP_EVENT_SYNC_ALL_FAILED, failedResult);\r\n return Promise.reject({'_syncLocalUnsaved failedResult': failedResult});\r\n });\r\n }, (failedResult) => {\r\n console.error(`Failed to seek keys: ${failedResult}`);\r\n Logger.logError(`Failed to seek keys for sync all: ${failedResult}`)\r\n .finally(() => {\r\n // @todo need to check that failedResult can be parsed in this way\r\n // (possibly should happen earlier rather than here)\r\n\r\n // cope with a pervasive Safari crash issue\r\n // see https://bugs.webkit.org/show_bug.cgi?id=197050\r\n if (failedResult.toString().includes('Connection to Indexed Database server lost')) {\r\n // before forcing a reload, should prompt the user to take remedial access, e.g. screenshotting data or transcribing results\r\n\r\n App.showInternalError(\"Internal storage error\", \"

The app's local database connection has been lost. Please close and reopen the app.

Unsaved records may be at risk of loss. Please immediately make a separate copy of records from the current survey. Taking screenshots may help with this.

Once that is done please close and reopen the app.

We're sorry for the disruption, which is due to a bug in the underlying web browser storage system.

Please report this error to feedback@bsbi.app

\");\r\n\r\n App.indexedDbConnectionLost = true;\r\n //location.reload();\r\n // @intentional end of promise chain\r\n }\r\n })\r\n ;\r\n\r\n this.fireEvent(APP_EVENT_SYNC_ALL_FAILED);\r\n return Promise.reject(failedResult);\r\n }).finally(() => {\r\n App._syncAllInProgress = false;\r\n // @intentional end of promise chain\r\n });\r\n\r\n\r\n } catch (error) {\r\n console.error({'syncAll reached outer catch' : error});\r\n App._syncAllInProgress = false;\r\n }\r\n\r\n return fastReturn ? Promise.resolve() : (promise || Promise.resolve());\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * @param queryFilters\r\n * @param {boolean} [queryFilters.structuredSurvey]\r\n * @param {boolean} [queryFilters.createdInCurrentYear]\r\n * @param {boolean} [queryFilters.isToday]\r\n * @param {string} [queryFilters.monad]\r\n * @param {string} [queryFilters.tetrad]\r\n * @param {string} [queryFilters.sampleUnit]\r\n * @param {string} [queryFilters.userId]\r\n * @param {string} [queryFilters.date]\r\n * @param {string} [queryFilters.excludeSurveyId]\r\n * @param {boolean} [queryFilters.defaultCasual]\r\n * @param {number} [queryFilters.segmentUniqueId]\r\n * @param {string} [queryFilters.requireBaseSurveyId]\r\n * @param {string|null} preferredBaseSurveyId\r\n * @returns {Array}\r\n */\r\n queryLocalSurveys(queryFilters, preferredBaseSurveyId = null) {\r\n const matches = [];\r\n\r\n for (const surveyTuple of this.surveys) {\r\n /**\r\n * @type {Survey}\r\n */\r\n const survey = surveyTuple[1];\r\n\r\n if (queryFilters.structuredSurvey && survey.attributes.casual) {\r\n continue;\r\n }\r\n\r\n if (queryFilters.defaultCasual && !survey.attributes.defaultCasual) {\r\n continue;\r\n }\r\n\r\n if (queryFilters.requireBaseSurveyId && survey.baseSurveyId !== queryFilters.requireBaseSurveyId) {\r\n continue;\r\n }\r\n\r\n if (queryFilters.segmentUniqueId && survey.attributes.segmentUniqueId !== queryFilters.segmentUniqueId) {\r\n continue;\r\n }\r\n\r\n if (queryFilters.createdInCurrentYear && !survey.createdInCurrentYear()) {\r\n continue;\r\n }\r\n\r\n if (queryFilters.isToday && !survey.isToday()) {\r\n continue;\r\n }\r\n\r\n if (queryFilters.monad && survey.getGeoContext()?.monad !== queryFilters.monad) {\r\n continue;\r\n }\r\n\r\n if (queryFilters.tetrad && survey.getGeoContext()?.tetrad !== queryFilters.tetrad) {\r\n continue;\r\n }\r\n\r\n if (queryFilters.sampleUnit && survey.attributes?.sampleUnit?.selection[0] !== queryFilters.sampleUnit) {\r\n continue;\r\n }\r\n\r\n if (queryFilters.hasOwnProperty('userId')) {\r\n if (queryFilters.userId !== survey.userId) {\r\n continue;\r\n }\r\n } else {\r\n // test if the survey belongs to the session user by default (only relevant if an explicit userId selector wasn't applied)\r\n if (this.session?.userId && survey.userId !== this.session.userId) {\r\n continue;\r\n }\r\n }\r\n\r\n if (queryFilters.excludeSurveyId === survey.id) {\r\n continue;\r\n }\r\n\r\n if (queryFilters.date && queryFilters.date !== survey.date) {\r\n continue;\r\n }\r\n\r\n matches[matches.length] = survey;\r\n }\r\n\r\n if (preferredBaseSurveyId && matches.length) {\r\n // sort matches with a compatible base survey first\r\n matches.sort((a, b) => {\r\n if (a.baseSurveyId === preferredBaseSurveyId) {\r\n if (b.baseSurveyId === preferredBaseSurveyId) {\r\n return b.createdStamp - a.createdStamp; // return earliest first\r\n } else {\r\n return -1;\r\n }\r\n }\r\n\r\n if (b.baseSurveyId === preferredBaseSurveyId) {\r\n return 1;\r\n }\r\n\r\n return b.createdStamp - a.createdStamp; // return earliest first\r\n });\r\n }\r\n\r\n return matches;\r\n }\r\n\r\n /**\r\n *\r\n * @param {{survey : Array, occurrence : Array, image : Array, [track] : Array}} storedObjectKeys\r\n * @param {boolean} fastReturn default false\r\n * @returns {Promise<{savedCount : {survey: number, occurrence: number, occurrenceimage: number, track: number}, errors : null|Object>, savedFlag : boolean}|void>}\r\n * @private\r\n */\r\n _syncLocalUnsaved(storedObjectKeys, fastReturn = false) {\r\n // synchronises surveys first, then occurrences, then images from indexedDb\r\n\r\n //const tasks = [];\r\n\r\n /**\r\n *\r\n * @type {Object>}\r\n */\r\n const errors = {\r\n survey : [],\r\n occurrence : [],\r\n occurrenceimage : [],\r\n track : [],\r\n };\r\n\r\n /**\r\n *\r\n * @type {{survey: number, occurrence: number, occurrenceimage: number, track: number}}\r\n */\r\n const savedCount = {\r\n survey : 0,\r\n occurrence : 0,\r\n occurrenceimage : 0,\r\n track : 0,\r\n };\r\n let errorFlag = false;\r\n\r\n // set if at least one save happened\r\n let savedFlag = false;\r\n\r\n /**\r\n * @param {string} objectKey\r\n * @param {typeof Model} objectClass\r\n * @returns {function(): Promise}\r\n * @private\r\n *\r\n */\r\n const queueSync = (objectKey, objectClass) => {\r\n const classLowerName = objectClass.className.toLowerCase();\r\n\r\n /**\r\n * @returns {Promise}\r\n */\r\n return () => {\r\n //console.log({'queueing sync': {key: objectKey, type: classLowerName}});\r\n return objectClass.retrieveFromLocal(objectKey, new objectClass)\r\n .then((/** Model|OccurrenceImage */ model) => {\r\n if (model.TYPE === MODEL_TYPE_IMAGE && model.refused && !model.deleted) {\r\n // The server has inspected this file and rejected it outright, so it\r\n // would be rejected again identically. Skipped here as well as in\r\n // OccurrenceImage.save(), so that a permanent refusal does not log a\r\n // fresh sync failure on every sync for the life of the install.\r\n return;\r\n }\r\n\r\n if (model.TYPE === MODEL_TYPE_IMAGE && !model.deleted && (!model.hasFile || model.fileSize === 0)) {\r\n // special case where image data is no longer in local storage (but not flagged as deleted)\r\n // (assume that image has already been saved)\r\n\r\n // Tested against the metadata rather than model.file, so that syncing\r\n // does not load every photo out of IndexedDb just to check this.\r\n return;\r\n }\r\n\r\n if (model.unsaved()) {\r\n return model.save(true, true)\r\n .then(() => {\r\n // for sync, only a remote save should count as successful\r\n if (!model.savedRemotely) {\r\n return Promise.reject(`Failed to save ${classLowerName} to server.`);\r\n }\r\n\r\n // make sure that the local copy of the object matches the saved\r\n // in terms of save flags\r\n // (as retrieveFromLocal has substituted a new object with the same values)\r\n if (classLowerName === 'occurrence' &&\r\n this.occurrences.has(model.id) &&\r\n this.occurrences.get(model.id).modifiedStamp === model.modifiedStamp\r\n ) {\r\n this.occurrences.get(model.id).savedRemotely = true;\r\n }\r\n })\r\n .then(() => {\r\n savedCount[classLowerName]++;\r\n savedFlag = true;\r\n });\r\n }\r\n })\r\n .catch((/** string */ failedResult) => {\r\n errors[classLowerName].push({\r\n key: objectKey,\r\n reason: failedResult,\r\n });\r\n errorFlag = true;\r\n return Promise.resolve('Continuing after sync failure.');\r\n })\r\n .finally(() => {\r\n //console.log({'processed sync': {key: objectKey, type: classLowerName}});\r\n })\r\n };\r\n };\r\n\r\n // /**\r\n // *\r\n // * @returns {Promise}\r\n // * @private\r\n // */\r\n // const next = () => {\r\n // tasks.shift(); // save is done\r\n //\r\n // if (tasks.length) {\r\n // // run the next task\r\n // console.log('Running the next sync task.');\r\n // return tasks[0]().finally(next);\r\n // }\r\n // };\r\n\r\n const drainStartStamp = Date.now();\r\n this._syncPostCount = 0;\r\n\r\n let syncPromise = Promise.resolve();\r\n //const syncPromise = new Promise();\r\n\r\n // this complex queuing system enforces the order of save requests:\r\n // survey > occurrences > images > tracks\r\n // and minimises flooding of indexedDb look-ups that sometimes appear to crash Safari\r\n // and should minimise memory usage\r\n\r\n //console.log('got to 1079');\r\n\r\n for(let surveyKey of storedObjectKeys.survey) {\r\n syncPromise = syncPromise.then(() => queueSync(surveyKey, Survey)());\r\n\r\n // queueSync(surveyKey, Survey);\r\n }\r\n syncPromise = syncPromise.then(schedulerYield);\r\n\r\n // Occurrences are the phase that can be thousands long, and the only one with a batch endpoint.\r\n // The surveys above have already been through this chain, so by the time this runs each one that\r\n // saved has savedRemotely set - which is what confirmedSurveyIds() reads to decide whether an\r\n // occurrence may travel in a batch at all.\r\n syncPromise = syncPromise.then(() => this._syncOccurrencesInBatches(\r\n storedObjectKeys.occurrence,\r\n queueSync,\r\n (saved) => {\r\n savedCount.occurrence += saved;\r\n if (saved) {\r\n savedFlag = true;\r\n }\r\n },\r\n (key, reason) => {\r\n errors.occurrence.push({key, reason});\r\n errorFlag = true;\r\n }\r\n ));\r\n syncPromise = syncPromise.then(schedulerYield);\r\n\r\n for(let imageKey of storedObjectKeys.image) {\r\n syncPromise = syncPromise.then(() => queueSync(imageKey, OccurrenceImage)());\r\n\r\n\r\n // queueSync(imageKey, OccurrenceImage);\r\n }\r\n syncPromise = syncPromise.then(schedulerYield);\r\n\r\n for(let trackKey of storedObjectKeys.track) {\r\n syncPromise = syncPromise.then(() => queueSync(trackKey, Track)());\r\n // queueSync(trackKey, Track);\r\n }\r\n syncPromise = syncPromise.then(schedulerYield);\r\n\r\n //console.log('got to 1105');\r\n\r\n syncPromise = syncPromise.finally(() => {\r\n // Logged for every drain, not only slow ones. Nothing previously reported how long a\r\n // backlog took to clear, so the cost of a sync was only ever guessed at - and the\r\n // interesting case, a transcriber's several thousand offline records, is precisely the\r\n // one nobody is watching a console for.\r\n const drainedRecords = savedCount.survey + savedCount.occurrence\r\n + savedCount.occurrenceimage + savedCount.track;\r\n\r\n if (drainedRecords || errorFlag) {\r\n const summary = describeDrain({\r\n records: drainedRecords,\r\n posts: this._syncPostCount,\r\n failures: errors.survey.length + errors.occurrence.length\r\n + errors.occurrenceimage.length + errors.track.length,\r\n elapsedMs: Date.now() - drainStartStamp,\r\n });\r\n\r\n console.info(summary);\r\n\r\n // Reported to the server only when it is worth somebody's attention, following the\r\n // start-up timing in main.js: Logger.logError is the error channel, and filing every\r\n // routine sync there would bury the reports that matter. A drain this slow, or one\r\n // with failures in it, is the case nobody is watching a console for.\r\n if (App.SLOW_DRAIN_THRESHOLD_MS < (Date.now() - drainStartStamp) || errorFlag) {\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logError(summary);\r\n }\r\n }\r\n\r\n this._updateUnsavedMarkerCss();\r\n if (errorFlag) {\r\n console.log({'local sync failed with errors': errors});\r\n return Promise.reject({\r\n savedCount,\r\n errors,\r\n savedFlag\r\n });\r\n }\r\n });\r\n\r\n if (fastReturn) {\r\n return Promise.resolve();\r\n } else {\r\n return syncPromise.then(() => {\r\n\r\n return {\r\n savedCount,\r\n errors: null,\r\n savedFlag\r\n }\r\n });\r\n }\r\n }\r\n\r\n /**\r\n * How long a drain has to take before it is reported to the server rather than only to the console.\r\n *\r\n * @type {number}\r\n */\r\n static SLOW_DRAIN_THRESHOLD_MS = 60000;\r\n\r\n /**\r\n * Posts made by the drain currently running, so the summary can say how many requests the records\r\n * actually cost - which is the number batching exists to reduce.\r\n *\r\n * @type {number}\r\n * @private\r\n */\r\n _syncPostCount = 0;\r\n\r\n /**\r\n * Drains the unsaved occurrences, in batches where that is safe and singly where it is not.\r\n *\r\n * The division is `syncBatching.planBatches()`, which is node-tested; this method is only the part that\r\n * needs storage and the network. A batch that fails as a whole falls back to posting its records one at\r\n * a time, because a single bad record can fail a whole request and the point of the retry is to find\r\n * out which one - after which the rest save and only the offender is left for the next sync.\r\n *\r\n * @param {Array} occurrenceKeys\r\n * @param {function(string, typeof Model): function(): Promise} queueSync the single-record path\r\n * @param {function(number)} countSaved\r\n * @param {function(string, string)} recordError\r\n * @returns {Promise}\r\n * @private\r\n */\r\n _syncOccurrencesInBatches(occurrenceKeys, queueSync, countSaved, recordError) {\r\n if (!occurrenceKeys?.length) {\r\n return Promise.resolve();\r\n }\r\n\r\n // Loaded before anything is posted, because the plan needs each record's survey and its saved\r\n // state. Only the cheap descriptors are kept rather than the models - see the note in\r\n // _gatherPurgeMetaData about track point arrays.\r\n return this._describeStoredOccurrences(occurrenceKeys)\r\n .then((descriptors) => {\r\n // Filtered *before* planning, not inside each batch afterwards. seekKeys() hands over\r\n // every stored occurrence, so planning the raw list cuts the batch windows across the\r\n // whole survey and leaves the records that need sending scattered between them - five\r\n // edits went out as four posts of 1, 1, 2, 1, with no error to show for it.\r\n const posts = planBatches(selectUnsavedDescriptors(descriptors, SAVE_STATE_SERVER), {\r\n confirmedSurveyIds: this._confirmedSurveyIds(),\r\n });\r\n\r\n let chain = Promise.resolve();\r\n\r\n for (const post of posts) {\r\n chain = chain\r\n .then(() => post.single ?\r\n this._syncOccurrenceSingly(post.records[0].id, queueSync)\r\n :\r\n this._syncOccurrenceBatch(post.records, queueSync, countSaved, recordError)\r\n )\r\n .then(schedulerYield);\r\n }\r\n\r\n return chain;\r\n }, (reason) => {\r\n // Could not read local storage well enough to plan. Falls back to the path that was there\r\n // before any of this, rather than abandoning the drain: slow is better than not at all.\r\n console.error({'Failed to plan occurrence batches, falling back to single posts': reason});\r\n\r\n let chain = Promise.resolve();\r\n\r\n for (const key of occurrenceKeys) {\r\n chain = chain.then(() => this._syncOccurrenceSingly(key, queueSync));\r\n }\r\n\r\n return chain;\r\n });\r\n }\r\n\r\n /**\r\n * The surveys the server is known to hold, so that an occurrence naming one of them can travel in a\r\n * batch without racing its neighbours to invent a placeholder for it.\r\n *\r\n * Read after the survey phase of the drain has run, so a survey saved a moment ago counts.\r\n *\r\n * @returns {Set}\r\n * @private\r\n */\r\n _confirmedSurveyIds() {\r\n const confirmed = new Set();\r\n\r\n for (const [surveyId, survey] of this.surveys) {\r\n if (survey.savedRemotely) {\r\n confirmed.add(surveyId);\r\n }\r\n }\r\n\r\n return confirmed;\r\n }\r\n\r\n /**\r\n * The id, survey and saved state of every stored occurrence, in a single cursor pass.\r\n *\r\n * Every stored one, not only the unsaved: seekKeys() has no notion of saved state, and the cheap\r\n * descriptor is where that is decided. The name matters here - it was _describeUnsavedOccurrences\r\n * while returning all of them, which is how the caller came to plan batches over records that were\r\n * never going to be sent.\r\n *\r\n * **One transaction, not one per record**, for the reason _gatherPurgeMetaData() gives at length:\r\n * transaction churn is a plausible contributor to the Safari 'Connection to Indexed Database server\r\n * lost' failures, and those lose users' records. The first version of this method called\r\n * Model.retrieveRawFromLocal() per key - reintroducing, in the sync, exactly the N-getItem pattern\r\n * the purge had been rewritten to remove. The same bytes are read either way.\r\n *\r\n * Three things about the callback are copied from that method rather than improvised, and each is\r\n * load-bearing:\r\n *\r\n * - it stays synchronous and returns undefined, because localforage stops iterating as soon as the\r\n * callback returns anything else;\r\n * - it catches everything, because a throw escapes the cursor's onsuccess handler without settling\r\n * the promise at all - which would hang the drain rather than fail it;\r\n * - it retains only the small descriptor, so attributes go out of scope each iteration instead of\r\n * the whole database being held for the length of the walk.\r\n *\r\n * The keys are still taken as an argument, and used to bound what is returned, so that this reports\r\n * on exactly the set the caller was given even if storage has changed under it since seekKeys().\r\n *\r\n * @param {Array} occurrenceKeys\r\n * @returns {Promise>}\r\n * @private\r\n */\r\n _describeStoredOccurrences(occurrenceKeys) {\r\n const wanted = new Set(occurrenceKeys);\r\n\r\n /**\r\n * @type {Array<{id: string, surveyId: string, saveState: string}>}\r\n */\r\n const descriptors = [];\r\n\r\n let skippedCount = 0;\r\n\r\n return localforage.iterate((value, key) => {\r\n // Synchronous, returns undefined, catches everything - see the note above.\r\n try {\r\n if (!value) {\r\n return;\r\n }\r\n\r\n const [type, id] = key.split('.', 3);\r\n\r\n if (MODEL_TYPE_OCCURRENCE !== type || !id || 'undefined' === id || !wanted.has(id)) {\r\n return;\r\n }\r\n\r\n // No model built: the raw descriptor carries everything planning needs, which is the\r\n // same conclusion the purge scan reached for occurrences.\r\n descriptors.push({\r\n id: value.id || id,\r\n surveyId: value.surveyId || '',\r\n saveState: value.saveState,\r\n });\r\n } catch (error) {\r\n skippedCount++;\r\n console.error({'Skipped unreadable record while planning batches': {key, error}});\r\n }\r\n }).then(() => {\r\n if (skippedCount) {\r\n // Not fatal - an unreadable record is simply not planned, and the next sync tries again -\r\n // but unreadable records are the symptom the crash work was chasing, so they are reported.\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logError(`Batch planning skipped ${skippedCount} unreadable occurrence record(s).`);\r\n }\r\n\r\n return descriptors;\r\n });\r\n }\r\n\r\n /**\r\n * The unchanged single-record path, wrapped only so that the two routes read alike at the call site and\r\n * both are counted. queueSync already tallies successes and records failures through the closures it\r\n * was built with.\r\n *\r\n * @param {string} key\r\n * @param {function(string, typeof Model): function(): Promise} queueSync\r\n * @returns {Promise}\r\n * @private\r\n */\r\n _syncOccurrenceSingly(key, queueSync) {\r\n this._syncPostCount++;\r\n\r\n return queueSync(key, Occurrence)();\r\n }\r\n\r\n /**\r\n * @param {Array<{id: string}>} descriptors\r\n * @param {function(string, typeof Model): function(): Promise} queueSync\r\n * @param {function(number)} countSaved\r\n * @param {function(string, string)} recordError\r\n * @returns {Promise}\r\n * @private\r\n */\r\n _syncOccurrenceBatch(descriptors, queueSync, countSaved, recordError) {\r\n return Promise.all(descriptors.map((descriptor) =>\r\n Occurrence.retrieveFromLocal(descriptor.id, new Occurrence).then((model) => model, () => null)\r\n )).then((models) => {\r\n const unsaved = models.filter((model) => model && model.unsaved());\r\n\r\n if (!unsaved.length) {\r\n return;\r\n }\r\n\r\n this._syncPostCount++;\r\n\r\n return Model.postBatch(unsaved, true)\r\n .then(({saved, failed}) => {\r\n countSaved(saved);\r\n\r\n // Whatever did not come back saved keeps savedRemotely false and is left for the next\r\n // sync, exactly as a failed single post would be. Recorded against the batch rather\r\n // than per record: the server said nothing about them individually.\r\n if (failed) {\r\n recordError(descriptors[0].id, `${failed} of ${unsaved.length} record(s) in a batch were not saved.`);\r\n }\r\n\r\n // The in-memory copies the user may be looking at are brought into step, the same way\r\n // the single path does it for occurrences.\r\n for (const model of unsaved) {\r\n if (model.savedRemotely\r\n && this.occurrences.has(model.id)\r\n && this.occurrences.get(model.id).modifiedStamp === model.modifiedStamp\r\n ) {\r\n this.occurrences.get(model.id).savedRemotely = true;\r\n }\r\n }\r\n }, (reason) => {\r\n // The whole request failed, so nothing in it was attempted. Retried one at a time\r\n // rather than given up on: a single malformed record fails the request for all of them,\r\n // and posting them singly is how the rest get through and the offender is isolated.\r\n console.info(`Batch save failed, retrying ${unsaved.length} record(s) singly: ${Logger.stringifyObject(reason)}`);\r\n\r\n let chain = Promise.resolve();\r\n\r\n for (const model of unsaved) {\r\n chain = chain.then(() => this._syncOccurrenceSingly(model.id, queueSync));\r\n }\r\n\r\n return chain;\r\n });\r\n });\r\n }\r\n\r\n /**\r\n * Gathers everything a purge needs to decide what to delete, in a single cursor pass.\r\n *\r\n * This replaces one seekKeys() transaction plus one getItem transaction per record. The same\r\n * bytes are read either way, but in one transaction rather than N+1, which matters because\r\n * transaction churn is a plausible contributor to the Safari 'Connection to Indexed Database\r\n * server lost' failures.\r\n *\r\n * Only small derived descriptors are retained. The model objects constructed here go out of\r\n * scope immediately, so survey attributes and (importantly) track point arrays are not held in\r\n * memory for the length of the walk.\r\n *\r\n * @returns {Promise<{survey : Array<{}>, occurrence : Array<{}>, image : Array<{}>, track : Array<{}>}>}\r\n * @private\r\n */\r\n _gatherPurgeMetaData() {\r\n const metaData = {\r\n survey : [],\r\n occurrence : [],\r\n image : [],\r\n track : [],\r\n };\r\n\r\n const reservedNamesRegex = new RegExp(`^(?:${App.RESERVED_KEY_NAMES.join('|')})\\\\b`);\r\n\r\n const startStamp = Date.now();\r\n let recordCount = 0;\r\n let skippedCount = 0;\r\n\r\n return localforage.iterate((value, key) => {\r\n // This callback must stay synchronous and must return undefined.\r\n //\r\n // localforage stops iterating as soon as the callback returns anything other than\r\n // undefined, and a throw from here escapes the cursor's onsuccess handler without\r\n // settling the promise at all - that would hang the purge and leave App._doingPurge\r\n // set for the rest of the session. Hence the blanket try/catch: an unreadable record\r\n // is skipped rather than fatal.\r\n try {\r\n if (!value || reservedNamesRegex.test(key)) {\r\n return;\r\n }\r\n\r\n const [type, id, deviceId] = key.split('.', 3);\r\n\r\n if (!metaData.hasOwnProperty(type) || !id || id === 'undefined') {\r\n // 'surveydefinition' and 'log' records are not wanted here, and are not an error\r\n return;\r\n }\r\n\r\n recordCount++;\r\n\r\n switch (type) {\r\n case 'survey': {\r\n const survey = new Survey();\r\n survey._id = id; // set directly, as retrieveFromLocal does\r\n survey._parseDescriptor(value);\r\n\r\n metaData.survey.push({\r\n id : survey.id,\r\n savedRemotely : survey.savedRemotely,\r\n modifiedStamp : survey.modifiedStamp,\r\n userId : survey.userId,\r\n defaultCasual : !!survey.attributes?.defaultCasual,\r\n nulllist : !!survey.attributes?.nulllist, // NYPH-specific\r\n createdInCurrentYear : survey.createdInCurrentYear(),\r\n });\r\n }\r\n break;\r\n\r\n case 'occurrence':\r\n // no model needed, the raw descriptor carries everything\r\n metaData.occurrence.push({\r\n id : value.id || id,\r\n surveyId : value.surveyId,\r\n deleted : value.deleted,\r\n modifiedStamp : value.modified, // note the descriptor uses 'modified' not 'modifiedStamp'\r\n saveState : value.saveState,\r\n });\r\n break;\r\n\r\n case 'image': {\r\n const image = new OccurrenceImage();\r\n image._id = id;\r\n image._parseDescriptor(value);\r\n\r\n metaData.image.push({\r\n id : image.id,\r\n surveyId : image.surveyId,\r\n occurrenceId : image.occurrenceId,\r\n deleted : image.deleted,\r\n hasFile : image.hasFile, // never image.file - binaries live in ImageFileStore\r\n unsaved : image.unsaved(),\r\n refused : image.refused,\r\n });\r\n }\r\n break;\r\n\r\n case 'track': {\r\n // track keys are expressed as id.deviceId rather than just id\r\n const trackKey = `${id}.${deviceId}`;\r\n\r\n const track = new Track();\r\n track._id = trackKey;\r\n track._parseDescriptor(value);\r\n\r\n metaData.track.push({\r\n trackKey,\r\n id : track.id,\r\n deviceId : track.deviceId,\r\n surveyId : track.surveyId,\r\n deleted : track.deleted,\r\n unsaved : track.unsaved(),\r\n });\r\n }\r\n break;\r\n }\r\n } catch (error) {\r\n skippedCount++;\r\n console.error({'Skipped unreadable record during purge scan' : {key, error}});\r\n }\r\n }).then(() => {\r\n console.info(`Purge scan read ${recordCount} records in ${Date.now() - startStamp} ms (${skippedCount} unreadable).`);\r\n\r\n if (skippedCount) {\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logError(`Purge scan skipped ${skippedCount} unreadable records of ${recordCount}.`);\r\n }\r\n\r\n return metaData;\r\n });\r\n }\r\n\r\n /**\r\n * Purges local entries that are stale or orphaned and which have been saved externally.\r\n *\r\n * All of the decision-making below is synchronous, running over the descriptors collected by\r\n * _gatherPurgeMetaData(). The order matters: surveys are classified first, as the occurrence,\r\n * image and track decisions all consult the survey deletion list.\r\n *\r\n * @returns {Promise}\r\n *\r\n * @private\r\n */\r\n _purgeLocal() {\r\n const deletionCandidateKeys = {\r\n survey : [],\r\n occurrence : [],\r\n image : [],\r\n track : [],\r\n };\r\n\r\n const preservedKeys = {\r\n survey : [],\r\n occurrence : [],\r\n image : [],\r\n track : [],\r\n };\r\n\r\n /**\r\n * Recent surveys, that if found to be empty should be purged\r\n * @type {Set}\r\n */\r\n const recentSurveyKeys = new Set();\r\n\r\n const thresholdStamp = Math.floor(Date.now() / 1000) - this.staleThreshold;\r\n\r\n const recentThresholdStamp = Math.floor(Date.now() / 1000) - (3600 * 24);\r\n\r\n const defaultCasualThreshold = Math.floor(Date.now() / 1000) - (3600 * 24 * 30);\r\n\r\n const currentSurveyId = this.currentSurvey?.id;\r\n\r\n console.info(`in _purgeLocal currentSurveyId = ${currentSurveyId}`);\r\n\r\n let currentDefaultCasualSurveyId = null;\r\n\r\n return this._gatherPurgeMetaData()\r\n .then((metaData) => {\r\n for (const survey of metaData.survey) {\r\n if (survey.defaultCasual &&\r\n survey.createdInCurrentYear &&\r\n survey.userId === this.userId\r\n ) {\r\n currentDefaultCasualSurveyId = survey.id;\r\n }\r\n\r\n if (survey.id !== currentSurveyId && survey.savedRemotely && (\r\n (survey.modifiedStamp <= thresholdStamp) || (this.session?.userId && survey.userId && this.session.userId !== survey.userId)\r\n )) {\r\n // The survey hasn't been modified recently or belongs to a different user\r\n\r\n if (survey.id !== currentDefaultCasualSurveyId) {\r\n // The survey isn't the set of casual records for the current year for the current user\r\n\r\n deletionCandidateKeys.survey.push(survey.id);\r\n } else {\r\n if (survey.modifiedStamp <= recentThresholdStamp &&\r\n !survey.defaultCasual &&\r\n !survey.nulllist\r\n ) {\r\n recentSurveyKeys.add(survey.id);\r\n }\r\n\r\n preservedKeys.survey.push(survey.id);\r\n }\r\n } else {\r\n preservedKeys.survey.push(survey.id);\r\n }\r\n }\r\n\r\n // first pass removes any surveys as deletion candidates if they include occurrences from within the current timeframe\r\n // (regardless of whether saved or not)\r\n for (let occurrenceDescriptor of metaData.occurrence) {\r\n // occurrence has been modified within the retained window (or is unsaved)\r\n // then keep the associated survey even if the survey itself is unmodified\r\n if (\r\n ((occurrenceDescriptor.modifiedStamp > thresholdStamp && !occurrenceDescriptor.deleted)\r\n || occurrenceDescriptor.saveState !== SAVE_STATE_SERVER)\r\n && deletionCandidateKeys.survey.includes(occurrenceDescriptor.surveyId)\r\n ) {\r\n deletionCandidateKeys.survey.splice(deletionCandidateKeys.survey.indexOf(occurrenceDescriptor.surveyId), 1); // use splice rather than delete to avoid a hole in the array\r\n\r\n if (!preservedKeys.survey.includes(occurrenceDescriptor.surveyId)) {\r\n preservedKeys.survey.push(occurrenceDescriptor.surveyId);\r\n }\r\n }\r\n\r\n if (recentSurveyKeys.has(occurrenceDescriptor.surveyId) && !(occurrenceDescriptor.deleted && occurrenceDescriptor.saveState === SAVE_STATE_SERVER)) {\r\n // If the occurrence belongs to one of the threshold recent surveys\r\n // and hasn't been persistently deleted already, then the survey is not empty so should be retained.\r\n //\r\n recentSurveyKeys.delete(occurrenceDescriptor.surveyId);\r\n }\r\n }\r\n\r\n // having pruned the survey deletion candidates list, mark occurrences from surveys that are still on the deletion list.\r\n for (let occurrenceDescriptor of metaData.occurrence) {\r\n if (deletionCandidateKeys.survey.includes(occurrenceDescriptor.surveyId) || (occurrenceDescriptor.deleted && occurrenceDescriptor.saveState === SAVE_STATE_SERVER)) {\r\n\r\n // I think this final guard is probably not needed, but added for safety\r\n if (occurrenceDescriptor.saveState === SAVE_STATE_SERVER) {\r\n deletionCandidateKeys.occurrence.push(occurrenceDescriptor.id);\r\n }\r\n } else {\r\n // at this stage, mostly preserving occurrence keys, except for any saved occurrences\r\n // belonging to the current default casual survey that are more than 30 days old\r\n\r\n if (occurrenceDescriptor.saveState === SAVE_STATE_SERVER && occurrenceDescriptor.surveyId === currentDefaultCasualSurveyId && occurrenceDescriptor.modifiedStamp < defaultCasualThreshold) {\r\n console.log(`will purge older default casual occurrence ${occurrenceDescriptor.id}`);\r\n } else {\r\n preservedKeys.occurrence.push(occurrenceDescriptor.id);\r\n }\r\n }\r\n }\r\n\r\n // add remaining recentish surveys that have no records to the purge list\r\n deletionCandidateKeys.survey.push(...recentSurveyKeys);\r\n\r\n // allow garbage collection\r\n metaData.occurrence.length = 0;\r\n\r\n for (const image of metaData.image) {\r\n // hasFile rather than image.file, so that the purge does not load every photo\r\n if (image.unsaved && !image.refused && (image.hasFile || image.deleted)) {\r\n // An unsaved image is always preserved, including when its survey or\r\n // occurrence is being purged.\r\n //\r\n // Unless the server has refused it. The exemption below rests on the image\r\n // still having somewhere to go; a refused one does not, so it follows the\r\n // ordinary rules and is collected with its survey rather than outliving it.\r\n //\r\n // That is safe because a parent only becomes a deletion candidate once it is\r\n // confirmed saved on the server (surveys require savedRemotely, occurrences\r\n // require saveState === SAVE_STATE_SERVER), so the image can still be posted\r\n // against it by the next syncAll(), which enumerates local storage rather\r\n // than the in-memory model.\r\n //\r\n // This previously threw PurgeInconsistencyError, which rejected the *entire*\r\n // purge, so one unsendable photo blocked all cleanup indefinitely.\r\n preservedKeys.image.push(image.id);\r\n } else {\r\n if (deletionCandidateKeys.survey.includes(image.surveyId) ||\r\n deletionCandidateKeys.occurrence.includes(image.occurrenceId) ||\r\n image.deleted\r\n ) {\r\n deletionCandidateKeys.image.push(image.id);\r\n } else if (!(\r\n preservedKeys.survey.includes(image.surveyId) ||\r\n preservedKeys.occurrence.includes(image.occurrenceId)\r\n )) {\r\n // have an orphaned image\r\n console.log(`Queueing purge of orphaned image id ${image.id}`);\r\n deletionCandidateKeys.image.push(image.id);\r\n } else {\r\n preservedKeys.image.push(image.id);\r\n }\r\n }\r\n }\r\n\r\n for (const track of metaData.track) {\r\n // use trackKey rather than track.id as keys for tracks are expressed as id.deviceId\r\n\r\n if (!track.deviceId || track.deviceId === 'undefined') {\r\n console.log(`Queueing purge of corrupt track id ${track.id} with no device.`);\r\n deletionCandidateKeys.track.push(track.trackKey);\r\n } else if (track.unsaved) {\r\n // preserved even when the survey is being purged, for the reason given\r\n // against unsaved images above\r\n preservedKeys.track.push(track.trackKey);\r\n } else {\r\n if (deletionCandidateKeys.survey.includes(track.surveyId) || track.deleted) {\r\n deletionCandidateKeys.track.push(track.trackKey);\r\n } else if (!preservedKeys.survey.includes(track.surveyId)) {\r\n // have an orphaned track\r\n console.log(`Queueing purge of orphaned track id ${track.id} for survey ${track.surveyId}.`);\r\n deletionCandidateKeys.track.push(track.trackKey);\r\n } else {\r\n preservedKeys.track.push(track.trackKey);\r\n }\r\n }\r\n }\r\n })\r\n .then(\r\n () => {\r\n // console.log({'Purging' : deletionCandidateKeys});\r\n\r\n return this._applyPurge(deletionCandidateKeys);\r\n },\r\n (reason) => {\r\n console.error({'purge failed reason' : reason});\r\n console.log({'would have purged' : deletionCandidateKeys});\r\n\r\n return Logger.logError(`Purge failed: ${Logger.stringifyObject(reason)}`)\r\n .then(() => Promise.reject(`Purge failed: ${Logger.stringifyObject(reason)}, would have purged: ${JSON.stringify(deletionCandidateKeys)}`));\r\n });\r\n }\r\n\r\n /**\r\n *\r\n * @param {{survey : Array, occurrence : Array, image : Array, track : Array}} deletionIds\r\n * @return {Promise}\r\n * @private\r\n */\r\n _applyPurge(deletionIds) {\r\n let purgePromise = Promise.resolve();\r\n\r\n // local survey list should be cleared first, to avoid the risk of the user selecting a survey mid-purge\r\n if (deletionIds.survey.length > 0) {\r\n purgePromise = purgePromise.then(() => {\r\n // re-check for the current survey amongst the deletion ids, in case the survey has changed since the purge process started.\r\n if (this._currentSurvey?.id && deletionIds.survey.includes(this._currentSurvey.id)) {\r\n return Promise.reject(`Cannot purge current survey, '${this._currentSurvey.id}'`);\r\n }\r\n\r\n for (let key of deletionIds.survey) {\r\n console.info(`Purging survey id ${key}.`);\r\n this.surveys.delete(key);\r\n }\r\n\r\n this.fireEvent(APP_EVENT_SURVEYS_CHANGED);\r\n })\r\n .catch((error) => {\r\n console.error({'survey deletion error' : {surveyskeys: deletionIds.survey, error}})\r\n return Promise.reject({'survey deletion error' : {surveyskeys: deletionIds.survey, error}});\r\n });\r\n }\r\n\r\n for (let type in deletionIds) {\r\n for (let key of deletionIds[type]) {\r\n purgePromise = purgePromise.then(() => this.forageRemoveItem(`${type}.${key}`))\r\n .catch((error) => {\r\n console.error({'purge error' : {key: `${type}.${key}`, error}});\r\n return Promise.reject({'purge error' : {key: `${type}.${key}`, error}});\r\n });\r\n }\r\n }\r\n\r\n if (deletionIds.image.length > 0) {\r\n // Binaries live in their own store, so removing the image record is no longer enough.\r\n for (let imageId of deletionIds.image) {\r\n if (imageId) {\r\n purgePromise = purgePromise.then(() => ImageFileStore.removeFile(imageId));\r\n }\r\n }\r\n\r\n purgePromise = purgePromise.then(() => this._purgeCachedImages(deletionIds.image))\r\n .catch((error) => {\r\n console.error({'purge images error' : {imagekeys: deletionIds.image, error}});\r\n return Promise.reject({'purge images error' : {imagekeys: deletionIds.image, error}});\r\n });\r\n }\r\n\r\n return purgePromise;\r\n }\r\n\r\n /**\r\n *\r\n * @param {Array} imageIds\r\n * @returns {Promise}\r\n * @private\r\n */\r\n _purgeCachedImages(imageIds) {\r\n const cacheName = App.IMAGE_DATA_CACHE_VERSION;\r\n\r\n return caches.open(cacheName)\r\n .then((cache) => {\r\n return cache.keys()\r\n .then((/** Array */ requests) => {\r\n for (let request of requests) {\r\n const url = request.url;\r\n\r\n const match = url.match(/image\\.php.*imageid=([a-fA-F0-9]{8}-(?:[a-fA-F0-9]{4}-){3}[a-fA-F0-9]{12})/);\r\n\r\n //if (url.match(new RegExp(`image\\.php.*imageid=${imageId}`))) {\r\n if (match && imageIds.includes(match[1])) {\r\n console.log(`Deleting cached image ${url}`);\r\n // noinspection JSIgnoredPromiseFromCall\r\n cache.delete(request);\r\n }\r\n }\r\n })\r\n });\r\n\r\n }\r\n\r\n /**\r\n * restore previous state, pulling back from local and external store\r\n *\r\n * @param {string} [targetSurveyId] if specified then select this id as the current survey\r\n * @param {boolean} [neverAddBlank] if set then don't add a new blank survey if none available, default false\r\n * @param {boolean} [setCurrentSurvey] if set then, if possible, set a survey as current, default true\r\n * @param {boolean} [localOnly] if set then only retrieve data from local storage (applies only if a targetSurveyId is specified, default false\r\n * @param {boolean} [specifiedSurveyOnly] if set (default FALSE) then pull-back only the target survey and no others\r\n * @return {Promise}\r\n */\r\n restoreOccurrences(targetSurveyId = '', neverAddBlank = false, setCurrentSurvey = true, localOnly = false, specifiedSurveyOnly = false) {\r\n console.log(`Invoked restoreOccurrences, target survey id: ${targetSurveyId}, localOnly: '${localOnly.toString()}'`);\r\n\r\n if (targetSurveyId === 'undefined') {\r\n console.error(`Attempt to restore occurrences for literal 'undefined' survey id.`);\r\n targetSurveyId = '';\r\n }\r\n\r\n return (targetSurveyId) ?\r\n this._restoreOccurrenceImp(targetSurveyId, neverAddBlank, setCurrentSurvey, localOnly, specifiedSurveyOnly)\r\n :\r\n this.getLastSurveyId().then(\r\n (lastSurveyId) => {\r\n console.log(`Retrieved last used survey id '${lastSurveyId}'`);\r\n\r\n if (lastSurveyId) {\r\n return this._restoreOccurrenceImp(lastSurveyId, neverAddBlank, setCurrentSurvey, localOnly, false /* specifiedSurveyOnly can't apply */).catch(() => {\r\n console.log(`Failed to retrieve lastSurveyId ${lastSurveyId}. Resetting current survey and retrying.`);\r\n // // noinspection JSIgnoredPromiseFromCall\r\n // Logger.logError(`Failed to retrieve lastSurveyId ${lastSurveyId}. Resetting current survey and retrying.`);\r\n\r\n return this.setCurrentSurvey(null)\r\n .then(() => this._restoreOccurrenceImp('', neverAddBlank, setCurrentSurvey, false, false));\r\n });\r\n } else {\r\n // // noinspection JSIgnoredPromiseFromCall\r\n // Logger.logError('Failed to retrieve lastSurveyId.');\r\n return this._restoreOccurrenceImp('', neverAddBlank, setCurrentSurvey, false, false);\r\n }\r\n },\r\n // probably can't reach this catch phase\r\n () => this._restoreOccurrenceImp('', neverAddBlank, setCurrentSurvey, false, false)\r\n );\r\n }\r\n\r\n /**\r\n *\r\n * @param {string} contextMessage\r\n * @returns {Promise}\r\n */\r\n static logMemoryUsage(contextMessage) {\r\n // noinspection JSUnresolvedReference\r\n if (navigator.storage?.estimate || performance?.measureUserAgentSpecificMemory) {\r\n let memory, storage, promise;\r\n\r\n promise = Promise.resolve();\r\n\r\n // noinspection JSUnresolvedReference\r\n if (performance?.measureUserAgentSpecificMemory) {\r\n promise = promise.then(() => {\r\n // noinspection JSUnresolvedReference\r\n return performance.measureUserAgentSpecificMemory().then(memorySpec => {\r\n memory = memorySpec;\r\n });\r\n });\r\n }\r\n\r\n if (navigator.storage?.estimate) {\r\n promise = promise.then(() => {\r\n return navigator.storage.estimate().then(storageSpec => {\r\n storage = storageSpec;\r\n });\r\n });\r\n }\r\n\r\n return promise.then(() => Logger.logErrorDev(`Memory and storage logs: ${contextMessage} : ${JSON.stringify({\r\n memory,\r\n storage\r\n })}`));\r\n } else {\r\n return Promise.resolve();\r\n }\r\n }\r\n\r\n /**\r\n *\r\n * @param {string} [targetSurveyId] default ''\r\n * @param {boolean} [neverAddBlank] if set then don't add a new blank survey if none available, default false\r\n * @param {boolean} [setCurrentSurvey] default true\r\n * @param {boolean} [localOnly] default false, if set then do a fast local switch rather than refreshing from server\r\n * @param {boolean} [specifiedSurveyOnly] default FALSE, if set then only seek the targetSurveyId from the server\r\n *\r\n * @returns {Promise}\r\n * @protected\r\n */\r\n _restoreOccurrenceImp(targetSurveyId = '', neverAddBlank = false, setCurrentSurvey = true, localOnly = false, specifiedSurveyOnly = false) {\r\n // Need to check for a special case where restoring a survey that has never been saved even locally\r\n // i.e. new and unmodified and only present in current App.surveys\r\n // This occurs if the user creates a new survey, makes no changes, switches away from it, then switches back\r\n // and also in some other automated navigation sequences.\r\n if (targetSurveyId && this.surveys.has(targetSurveyId)) {\r\n const localSurvey = this.surveys.get(targetSurveyId);\r\n\r\n if (localSurvey.isPristine) {\r\n // If the local survey is not current, then\r\n // clear occurrences from the previous survey.\r\n\r\n if (setCurrentSurvey && localSurvey.id !== this._currentSurvey?.id) {\r\n // // noinspection JSIgnoredPromiseFromCall\r\n // Logger.logError(`Switching to pristine survey ${targetSurveyId}.`);\r\n\r\n return this.clearCurrentSurvey()\r\n .then(() => this.setCurrentSurvey(localSurvey))\r\n .then(() => {\r\n this.fireEvent(APP_EVENT_SURVEYS_CHANGED); // the current survey should be set now, so the menu needs refreshing\r\n });\r\n } else {\r\n return Promise.resolve();\r\n }\r\n }\r\n } else {\r\n localOnly = false;\r\n }\r\n\r\n /**\r\n *\r\n * @type {{image: Array, survey: Array, occurrence: Array}}\r\n */\r\n const storedObjectKeys = {\r\n survey: [],\r\n occurrence: [],\r\n image: [],\r\n track: [],\r\n };\r\n\r\n if (targetSurveyId) {\r\n storedObjectKeys.survey[0] = targetSurveyId;\r\n } else {\r\n specifiedSurveyOnly = false;\r\n }\r\n\r\n let promise;\r\n // only clear the current survey if the new one is different\r\n if (this.currentSurvey && this.currentSurvey.id !== targetSurveyId) {\r\n promise = this.clearCurrentSurvey();\r\n } else {\r\n promise = Promise.resolve();\r\n }\r\n\r\n return promise.then(() => this.seekKeys(storedObjectKeys))\r\n .then((storedObjectKeys) => {\r\n // if (!navigator.onLine) { // insufficiently reliable\r\n // localOnly = true;\r\n // }\r\n\r\n if (!localOnly && (storedObjectKeys.survey.length || this.session?.userId)) {\r\n let timer;\r\n const timeoutMs = 15 * 1000;\r\n\r\n const promisesToRace = [\r\n new Promise((resolve, reject) => {\r\n // Set up the timeout\r\n timer = setTimeout(() => {\r\n timer = null;\r\n console.error(`Refresh from server timeout.`);\r\n reject(new Error(`Survey load timed out after ${timeoutMs} ms`));\r\n }, timeoutMs);\r\n }),\r\n this.refreshFromServer(specifiedSurveyOnly ? [targetSurveyId] : storedObjectKeys.survey, specifiedSurveyOnly)\r\n // re-seek keys from indexed db, to take account of any new occurrences received from the server\r\n // do this for both promise states (can't use finally as it doesn't chain returned promises)\r\n .then(\r\n () => this.seekKeys(storedObjectKeys),\r\n () => this.seekKeys(storedObjectKeys),\r\n ).then(() => {\r\n if (!timer) {\r\n console.log('Adding surveys for late response to load surveys');\r\n\r\n return this.addAllSurveysFromLocal();\r\n }\r\n })\r\n .finally(() => {\r\n if (timer) {\r\n clearTimeout(timer);\r\n }\r\n })\r\n ];\r\n\r\n // The split approach below isn't yet safe\r\n /*\r\n if (targetSurveyId) {\r\n // as a single batch, try to get just the survey of interest\r\n\r\n promisesToRace.push(\r\n this.refreshFromServer([targetSurveyId], true)\r\n // re-seek keys from indexed db, to take account of any new occurrences received from the server\r\n // do this for both promise states (can't use finally as it doesn't chain returned promises)\r\n .then(\r\n () => this.seekKeys(storedObjectKeys),\r\n () => this.seekKeys(storedObjectKeys),\r\n )\r\n .finally(() => {\r\n console.info(`Returned from narrow survey load.`);\r\n if (timer) {\r\n clearTimeout(timer);\r\n }\r\n })\r\n );\r\n }\r\n\r\n // request other relevant recent surveys more generally\r\n // will usually complete more slowly\r\n promisesToRace.push(\r\n this.refreshFromServer(storedObjectKeys.survey)\r\n .then(() => this.seekKeys(storedObjectKeys))\r\n .finally(() => {\r\n console.info(`Returned from broad survey load.`);\r\n if (timer) {\r\n clearTimeout(timer);\r\n }\r\n })\r\n );\r\n */\r\n\r\n return Promise.race(promisesToRace);\r\n } else {\r\n return null;\r\n }\r\n })\r\n .catch(() => {\r\n // need this catch to get back to a resolving promise chain\r\n console.error('Failed at clear survey or at seek keys.');\r\n return Promise.resolve();\r\n })\r\n .then(() => {\r\n // called regardless of whether a server refresh was successful\r\n // (because of previous catch)\r\n // storedObjectKeys and indexed db should be as up to date as possible\r\n\r\n if (storedObjectKeys?.survey?.length) {\r\n let n = 0;\r\n\r\n let restorePromise = Promise.resolve();\r\n\r\n for (let surveyKey of storedObjectKeys.survey) {\r\n // arbitrarily set the first survey key as current if a target id hasn't been specified\r\n\r\n if (localOnly\r\n && targetSurveyId\r\n && surveyKey !== targetSurveyId\r\n && this.surveys.has(surveyKey)\r\n ) {\r\n // don't bother with non-target surveys that are already in the survey list, as for local-only we know nothing has changed\r\n continue;\r\n }\r\n\r\n restorePromise = restorePromise\r\n .then(() => {\r\n return this._restoreSurveyFromLocal(surveyKey, storedObjectKeys, setCurrentSurvey && ((targetSurveyId === surveyKey) || (!targetSurveyId && n++ === 0)));\r\n })\r\n .catch((reason) => {\r\n console.log({'failed to restore from local': {surveyKey, reason}});\r\n return Promise.resolve();\r\n });\r\n }\r\n\r\n return restorePromise\r\n .finally(() => {\r\n\r\n if (!this.currentSurvey && neverAddBlank && setCurrentSurvey) {\r\n // survey doesn't exist\r\n // this could have happened in an invalid survey id was provided as a targetSurveyId\r\n console.log(`Failed to retrieve survey id '${targetSurveyId}'`);\r\n return Promise.reject(new Error(`Failed to retrieve survey id '${targetSurveyId}'`));\r\n }\r\n\r\n if (!this.currentSurvey && !neverAddBlank && setCurrentSurvey) {\r\n // survey doesn't exist\r\n // this could have happened in an invalid survey id was provided as a targetSurveyId\r\n console.log(`Setting a new survey as current`);\r\n return this.setNewSurvey();\r\n }\r\n\r\n if (this.currentSurvey?.deleted) {\r\n // unusual case where the survey was deleted or was not found\r\n // substitute a new one\r\n\r\n // this should probably never happen, as items deleted on the server ought to have been\r\n // removed locally\r\n return this.setCurrentSurvey(null)\r\n .then(() => {\r\n if (neverAddBlank) {\r\n return Promise.reject(new Error(`Survey id '${targetSurveyId}' ${this.currentSurvey?.deleted ? 'is deleted' : 'not found'}.`));\r\n } else {\r\n return this.setNewSurvey();\r\n }\r\n });\r\n }\r\n })\r\n .finally(() => {\r\n this.fireEvent(APP_EVENT_SURVEYS_CHANGED); // the current survey should be set now, so the menu needs refreshing\r\n this.currentSurvey?.fireEvent?.(SURVEY_EVENT_OCCURRENCES_CHANGED);\r\n this.currentSurvey?.fireEvent?.(SURVEY_EVENT_LIST_LENGTH_CHANGED);\r\n });\r\n } else {\r\n // no pre-existing surveys\r\n\r\n if (neverAddBlank) {\r\n console.log('no pre-existing survey');\r\n this.fireEvent(APP_EVENT_SURVEYS_CHANGED); // survey menu needs refresh\r\n return Promise.reject(new Error(`Failed to match survey.`));\r\n } else {\r\n console.log('no pre-existing surveys, so creating a new one');\r\n return this.setNewSurvey(); // this also fires EVENT_SURVEYS_CHANGED\r\n }\r\n }\r\n });\r\n }\r\n\r\n /**\r\n * Adds surveys from local storage to the app's current list (if the survey is compatible)\r\n * Does not affect the current survey or refresh any dependent occurrences etc.\r\n *\r\n * Called as part of refresh following sync-all (not used during app start-up, when current the survey also needs to be set)\r\n *\r\n * @returns {Promise}\r\n *\r\n */\r\n addAllSurveysFromLocal() {\r\n return this.seekKeys()\r\n .then((storedObjectKeys) => {\r\n let wrappedPromise = Promise.resolve();\r\n if (storedObjectKeys?.survey?.length) {\r\n for (let surveyKey of storedObjectKeys.survey) {\r\n wrappedPromise = wrappedPromise.then(() => {\r\n return this._restoreSurveyFromLocal(surveyKey, storedObjectKeys, false);\r\n })\r\n .catch((reason) => {\r\n console.log({'failed to restore from local': {surveyKey, reason}});\r\n return Promise.resolve();\r\n })\r\n }\r\n }\r\n return wrappedPromise;\r\n });\r\n }\r\n\r\n /**\r\n *\r\n * @param {{}|null} [attributes]\r\n * @param {number} [projectId]\r\n * @returns {Promise}\r\n */\r\n setNewSurvey(attributes, projectId) {\r\n const newSurvey = new Survey();\r\n\r\n newSurvey.id; // trigger id initialisation\r\n\r\n if (attributes) {\r\n newSurvey.attributes = {...newSurvey.attributes, ...attributes};\r\n }\r\n\r\n newSurvey.projectId = projectId || this.projectId;\r\n newSurvey.isPristine = true;\r\n newSurvey.isNew = true;\r\n\r\n if (this.session?.userId) {\r\n newSurvey.userId = this.session.userId;\r\n }\r\n\r\n // Important: don't set this.currentSurvey until default attributes have been set,\r\n // as the currentSurvey setter fires an event that may depend on these attributes\r\n return this.setCurrentSurvey(this.addSurvey(newSurvey))\r\n .then(() => {\r\n this.fireEvent(APP_EVENT_NEW_SURVEY);\r\n\r\n if (this.supportsTracking) {\r\n Track.applyChangedSurveyTrackingResumption(newSurvey);\r\n }\r\n });\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * Add and set a *new* survey\r\n *\r\n * @param {Survey} survey\r\n * @returns {Promise}\r\n */\r\n addAndSetSurvey(survey) {\r\n return this.setCurrentSurvey(survey)\r\n .then(() => {\r\n this.fireEvent(APP_EVENT_NEW_SURVEY);\r\n });\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * specialised surveys might return an HTML tag string\r\n *\r\n * @abstract\r\n * @param {Survey} survey\r\n * @returns {string}\r\n */\r\n getSurveyTypeMarkerIcon(survey) {\r\n return '';\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n * Note that if attributes are set here, then the occurrence is regarded as changed and unsaved, rather than pristine\r\n * i.e. attributes setting here is *not* intended as a way to set defaults\r\n *\r\n * @param {{}|null} [attributes]\r\n * @param {{}|null} [pristineAttributes] additional attributes, that if set, don't count as edits\r\n * @return {Occurrence}\r\n */\r\n addNewOccurrence(attributes, pristineAttributes) {\r\n const occurrence = new Occurrence();\r\n const currentSurvey = this.currentSurvey; // avoid too many getter lookups\r\n\r\n if (!currentSurvey) {\r\n throw new Error(`Current survey unset when adding new occurrence.`);\r\n }\r\n\r\n occurrence.id; // force initialisation of occurrence id\r\n occurrence.surveyId = currentSurvey.id;\r\n\r\n // In some cases, more than one project id may be in use (e.g. RecordingApp v's NYPH),\r\n // so when adding occurrences, use the survey rather than app project id as the source-of-truth.\r\n occurrence.projectId = currentSurvey.projectId;\r\n\r\n if (currentSurvey.userId) {\r\n occurrence.userId = currentSurvey.userId;\r\n }\r\n\r\n occurrence.isNew = true;\r\n occurrence.isPristine = true;\r\n\r\n if (attributes && Object.keys(attributes).length) {\r\n occurrence.attributes = {...occurrence.attributes, ...attributes};\r\n occurrence.touch(); // now no longer pristine\r\n }\r\n\r\n if (pristineAttributes && Object.keys(pristineAttributes).length) {\r\n // unlike above, setting these attributes doesn't affect the modified state of the object\r\n occurrence.attributes = {...occurrence.attributes, ...pristineAttributes};\r\n }\r\n\r\n this.addOccurrence(occurrence);\r\n\r\n currentSurvey.extantOccurrenceKeys.add(occurrence.id);\r\n\r\n this.fireEvent(APP_EVENT_OCCURRENCE_ADDED, {occurrenceId: occurrence.id, surveyId: occurrence.surveyId});\r\n\r\n currentSurvey.fireEvent(SURVEY_EVENT_OCCURRENCES_CHANGED, {occurrenceId : occurrence.id});\r\n currentSurvey.fireEvent(SURVEY_EVENT_LIST_LENGTH_CHANGED);\r\n\r\n // occurrence modified event fired to ensure that the occurrence is saved\r\n occurrence.fireEvent(OCCURRENCE_EVENT_MODIFIED);\r\n\r\n return occurrence;\r\n }\r\n\r\n /**\r\n * Test if the user has the necessary admin rights for the given survey.\r\n * May be overridden in child classes to cope with administration of specialised survey types\r\n *\r\n * @param {Survey} survey\r\n * @returns {boolean}\r\n * @protected\r\n */\r\n _userHasSurveyAdminRights(survey) {\r\n if (this.session?.userId) {\r\n return survey.userId === this.session.userId || this.session?.superAdmin\r\n } else {\r\n return false;\r\n }\r\n }\r\n\r\n /**\r\n *\r\n * @param {string} surveyId\r\n * @param {{survey: Array, occurrence: Array, image: Array}} storedObjectKeys\r\n * @param {boolean} setAsCurrent\r\n * @returns {Promise}\r\n * @private\r\n */\r\n _restoreSurveyFromLocal(surveyId, storedObjectKeys = {survey: [], occurrence: [], image: []}, setAsCurrent = false) {\r\n // retrieve surveys first, then occurrences, then images from indexedDb\r\n\r\n let userIdFilter = this.session?.userId;\r\n\r\n let promise = Survey.retrieveFromLocal(surveyId, new Survey)\r\n .then((survey) => {\r\n //console.log(`retrieving local survey ${surveyId}`);\r\n\r\n this.fireEvent(APP_EVENT_SURVEY_LOADED, {survey}); // provides a hook point in case any attributes need to be re-initialised\r\n\r\n if (survey.deleted) {\r\n console.log(`Skipping deleted survey id ${survey.id}.`);\r\n return Promise.reject(`Skipping deleted survey id ${survey.id}.`);\r\n }\r\n\r\n if ((!userIdFilter && !survey.userId) || this._userHasSurveyAdminRights(survey)) {\r\n if (setAsCurrent) {\r\n // the app's occurrences should only relate to the current survey\r\n // (the reset records are remote or in IndexedDb)\r\n return this.clearCurrentSurvey().then(() => {\r\n survey = this.addSurvey(survey);\r\n //const occurrenceFetchingPromises = [];\r\n let occurrenceFetchingPromise = Promise.resolve();\r\n\r\n for (let occurrenceKey of storedObjectKeys.occurrence) {\r\n occurrenceFetchingPromise = occurrenceFetchingPromise\r\n .then(() => Occurrence.retrieveFromLocal(occurrenceKey, new Occurrence)\r\n .then((occurrence) => {\r\n if (occurrence.surveyId === surveyId) {\r\n //console.log(`adding occurrence ${occurrenceKey}`);\r\n this.addOccurrence(occurrence);\r\n\r\n survey.extantOccurrenceKeys.add(occurrence.id);\r\n } else {\r\n // not part of the current survey but should still add it to the key list for counting purposes\r\n\r\n this.surveys.get(occurrence.surveyId)?.extantOccurrenceKeys?.add?.(occurrence.id);\r\n }\r\n\r\n })\r\n )\r\n .catch((reason) => {\r\n console.error({'Failed to fetch occurrence for current survey' : {occurrenceKey, reason}});\r\n return Promise.resolve();\r\n });\r\n }\r\n\r\n //return Promise.all(occurrenceFetchingPromises);\r\n return occurrenceFetchingPromise;\r\n });\r\n } else {\r\n // not the current survey, so just add it but don't load occurrences\r\n survey = this.addSurvey(survey);\r\n return Promise.resolve();\r\n }\r\n } else {\r\n console.log(`Skipping survey id ${survey.id} that belongs to user ${survey.userId}`);\r\n return Promise.reject(`Skipping survey id ${survey.id} that belongs to user ${survey.userId}`);\r\n }\r\n });\r\n\r\n if (setAsCurrent) {\r\n promise = promise.then( () => this.setCurrentSurvey(this.surveys.get(surveyId) || null))\r\n .then(() => {\r\n if (this.currentSurvey) {\r\n //console.log('Reached the image fetching part');\r\n let imageFetchingPromise = Promise.resolve();\r\n\r\n for (let occurrenceImageKey of storedObjectKeys.image) {\r\n imageFetchingPromise = imageFetchingPromise\r\n .then(\r\n // Reads into the placeholder that a form has already been handed\r\n // for this id, if there is one, rather than into a fresh object\r\n // that the form would never see.\r\n () => OccurrenceImage.retrieveIntoCache(occurrenceImageKey, (image) => image.surveyId === surveyId)\r\n .then((occurrenceImage) => {\r\n console.log(`restoring image id '${occurrenceImageKey}'`);\r\n\r\n if (occurrenceImage.surveyId === surveyId) {\r\n // image loading may be slow, so the occurrence list may already have been built\r\n // need to refresh entries on the occurrence list, e.g. so that PlantNet buttons become available and possible image url changes take effect.\r\n // Run this in parallel\r\n schedulerYield().then(() => {\r\n if (occurrenceImage.occurrenceId) {\r\n const occurrence = this.occurrences.get(occurrenceImage.occurrenceId);\r\n\r\n if (occurrence) {\r\n occurrence.fireEvent(OCCURRENCE_EVENT_NEEDS_REFRESH);\r\n }\r\n }\r\n // @intentional runs in parallel outside the main promise chain\r\n });\r\n }\r\n }, (reason) => {\r\n console.error({'Failed to retrieve an image': reason});\r\n return Promise.resolve();\r\n })\r\n ,\r\n () => Promise.resolve() // always finish with a resolved promise, even on failure\r\n );\r\n\r\n // imageFetchingPromises.push(\r\n // OccurrenceImage.retrieveFromLocal(occurrenceImageKey, new OccurrenceImage)\r\n // .then((occurrenceImage) => {\r\n // console.log(`restoring image id '${occurrenceImageKey}'`);\r\n //\r\n // if (occurrenceImage.surveyId === surveyId) {\r\n // OccurrenceImage.imageCache.set(occurrenceImageKey, occurrenceImage);\r\n // }\r\n // }, (reason) => {\r\n // console.log(`Failed to retrieve an image: ${reason}`);\r\n // })\r\n // );\r\n }\r\n\r\n return imageFetchingPromise;\r\n } else {\r\n return Logger.logError(`Failed to retrieve survey id '${surveyId}' from local set in _restoreSurveyFromLocal().`)\r\n .then(() => Promise.reject(`Failed to restore survey id '${surveyId}' from local set.`));\r\n }\r\n\r\n // if the target survey belonged to a different user then could be undefined here\r\n // failed state should reject rather than resolve the promise\r\n // return this.currentSurvey ? Promise.all(imageFetchingPromises) : Promise.reject();\r\n });\r\n }\r\n\r\n return promise;\r\n }\r\n\r\n /**\r\n *\r\n * @returns {Promise}\r\n */\r\n clearLocalForage() {\r\n return localforage.clear();\r\n }\r\n\r\n /**\r\n * @abstract\r\n */\r\n notFoundView() {\r\n // const view = new NotFoundView();\r\n // view.display();\r\n }\r\n\r\n static deleteCacheByPrefix(prefix) {\r\n return caches.keys()\r\n .then((cacheNames) => Promise.all(\r\n cacheNames.map((cacheName) => {\r\n if (cacheName.startsWith(prefix)) {\r\n console.log(`Deleting cache: ${cacheName}`);\r\n return caches.delete(cacheName);\r\n }\r\n })\r\n )\r\n );\r\n }\r\n\r\n /**\r\n * The other way an upload can stop being pending. The occurrence list has to be told, as it\r\n * shows a thumbnail of the first attachment and a refused one has none.\r\n *\r\n * @param {string} imageId\r\n */\r\n _handleImageRefused(imageId) {\r\n const image = OccurrenceImage.imageCache.get(imageId);\r\n\r\n if (image?.occurrenceId) {\r\n const occurrence = this.occurrences.get(image.occurrenceId);\r\n\r\n if (occurrence) {\r\n occurrence.fireEvent(OCCURRENCE_EVENT_NEEDS_REFRESH);\r\n }\r\n }\r\n }\r\n\r\n _handleImageSavedRemotely(imageId) {\r\n if (OccurrenceImage.imageCache.has(imageId)) {\r\n const image = OccurrenceImage.imageCache.get(imageId);\r\n image.savedRemotely = true; // this will trigger a MODEL_EVENT_SAVED_REMOTELY event\r\n\r\n // need to refresh entries on the occurrence list, e.g. so that PlantNet buttons become available and possible image url changes take effect.\r\n if (image.occurrenceId) {\r\n const occurrence = this.occurrences.get(image.occurrenceId);\r\n\r\n if (occurrence) {\r\n occurrence.fireEvent(OCCURRENCE_EVENT_NEEDS_REFRESH);\r\n }\r\n }\r\n }\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {MessageEvent} event\r\n */\r\n handleServiceWorkerMessage(event) {\r\n switch (event.data.reason) {\r\n case 'imageSavedRemotely':\r\n this._handleImageSavedRemotely(event.data.imageId);\r\n // if (OccurrenceImage.imageCache.has(event.data.imageId)) {\r\n // const image = OccurrenceImage.imageCache.get(event.data.imageId);\r\n // image.savedRemotely = true; // this will trigger a MODEL_EVENT_SAVED_REMOTELY event\r\n //\r\n // // need to refresh entries on the occurrence list, e.g. so that PlantNet buttons become available and possible image url changes take effect.\r\n // if (image.occurrenceId) {\r\n // const occurrence = this.occurrences.get(image.occurrenceId);\r\n //\r\n // if (occurrence) {\r\n // occurrence.fireEvent(OCCURRENCE_EVENT_NEEDS_REFRESH);\r\n // }\r\n // }\r\n // }\r\n break;\r\n case 'versionChanged':\r\n if (event.data.upgrading) {\r\n this.fireEvent(APP_EVENT_SERVICE_WORKER_CHANGED, event.data.upgrading);\r\n }\r\n break;\r\n default:\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logError(`Unknown service worker message reason: ${event.data.reason}`);\r\n }\r\n }\r\n}\r\n\r\n","// SurveyPickerController\r\n//\r\n\r\nimport {AppController} from './AppController';\r\nimport {NotFoundError} from \"../utils/exceptions/NotFoundError\";\r\nimport {UUID_REGEX} from \"../models/Model\";\r\n//import {App} from \"../framework/App\";\r\nimport {Logger} from \"../utils/Logger\";\r\nimport {\r\n APP_EVENT_ADD_SURVEY_USER_REQUEST,\r\n APP_EVENT_RESET_SURVEYS,\r\n // APP_EVENT_SURVEYS_CHANGED\r\n} from \"../framework/AppEvents\";\r\nimport {App} from \"../framework/App\";\r\n\r\n/**\r\n * @typedef {import('bsbi-app-framework-view').SurveyPickerView} SurveyPickerView\r\n * @typedef {import('bsbi-app-framework-view').PatchedNavigo} PatchedNavigo\r\n */\r\n\r\nexport class SurveyPickerController extends AppController {\r\n route = '/survey/:action/:id';\r\n\r\n // static EVENT_BACK = 'back';\r\n\r\n title = 'Survey picker';\r\n\r\n /**\r\n *\r\n * @type {SurveyPickerView}\r\n */\r\n view;\r\n\r\n /**\r\n *\r\n * @returns {Survey}\r\n */\r\n get survey() {\r\n return this.app.currentSurvey;\r\n }\r\n\r\n /**\r\n *\r\n * @param {SurveyPickerView} view\r\n */\r\n constructor (view) {\r\n super();\r\n\r\n this.view = view;\r\n view.controller = this;\r\n\r\n this.handle = AppController.nextHandle;\r\n }\r\n\r\n /**\r\n * registers the default route from this.route\r\n * or alternatively is overridden in a child class\r\n *\r\n * @param {PatchedNavigo} router\r\n */\r\n registerRoute(router) {\r\n // router.on(\r\n // '/survey',\r\n // this.mainRouteHandler.bind(this, 'survey', '', ''),\r\n // {\r\n // // before : this.beforeRouteHandler ? this.beforeRouteHandler.bind(this) : null,\r\n // // after : this.afterRouteHandler ? this.afterRouteHandler.bind(this) : null,\r\n // // leave : this.leaveRouteHandler ? this.leaveRouteHandler.bind(this) : null,\r\n // // already : this.alreadyRouteHandler ? this.alreadyRouteHandler.bind(this) : null\r\n // }\r\n // );\r\n\r\n router.on(\r\n '/survey/new',\r\n this.newSurveyHandler.bind(this, 'survey', 'new', ''),\r\n {\r\n before : this.beforeNewHandler.bind(this)\r\n }\r\n );\r\n\r\n router.on(\r\n '/survey/reset',\r\n this.mainRouteHandler.bind(this, 'survey', 'reset', ''),\r\n {\r\n before : this.beforeResetHandler.bind(this)\r\n }\r\n );\r\n\r\n router.on(\r\n '/survey/save',\r\n this.mainRouteHandler.bind(this, 'survey', 'save', ''),\r\n {\r\n before : this.beforeSaveAllHandler.bind(this)\r\n }\r\n );\r\n\r\n router.on(\r\n '/survey/add/:surveyId/:occurrenceId',\r\n this.addSurveyHandler.bind(this, 'survey', 'add', ''),\r\n {\r\n before: this.beforeRouteLoginHandler.bind(this),\r\n }\r\n );\r\n\r\n router.on(\r\n '/survey/add/:surveyId',\r\n this.addSurveyHandler.bind(this, 'survey', 'add', ''),\r\n {\r\n before: this.beforeRouteLoginHandler.bind(this),\r\n }\r\n );\r\n\r\n this.app.addListener(APP_EVENT_ADD_SURVEY_USER_REQUEST, this.addNewSurveyHandler.bind(this));\r\n this.app.addListener(APP_EVENT_RESET_SURVEYS, this.resetSurveysHandler.bind(this));\r\n }\r\n\r\n beforeNewHandler(done) {\r\n this.view.newSurveyDialog();\r\n this.app.revertUrl();\r\n done(false); // block navigation\r\n }\r\n\r\n beforeResetHandler(done) {\r\n this.view.showResetDialog();\r\n this.app.revertUrl();\r\n\r\n done(false); // block navigation\r\n }\r\n\r\n beforeSaveAllHandler(done) {\r\n\r\n if (navigator.onLine && !App._doingPurge) {\r\n // invoke sync of any/all unsaved data\r\n // show pop-ups on success and failure\r\n this.app.syncAll(false)\r\n .then((result) => {\r\n //console.log({'In save all handler, success result': result});\r\n\r\n this.view.showSaveAllSuccess(result);\r\n\r\n return this.app.refreshFromServer(Array.from(this.app.surveys.keys()), false)\r\n .then(() => this.app.addAllSurveysFromLocal())\r\n .then(() => {\r\n console.log('Surveys refreshed from the server');\r\n // this.fireEvent(APP_EVENT_SURVEYS_CHANGED); this will have been fired already from app.addSurvey()\r\n\r\n // @todo should now update the current survey from indexDb without clearing existing entries\r\n });\r\n }, (result) => {\r\n console.log({'In save all handler, failure result': result});\r\n // noinspection JSIgnoredPromiseFromCall\r\n Logger.logError(`Failed to sync all (line 143): ${Logger.stringifyObject(result)}`);\r\n this.view.showSaveAllFailure(result);\r\n return Promise.reject(result);\r\n }).finally(() => {\r\n // stop the spinner\r\n\r\n // @intentional end of promise chain\r\n });\r\n }\r\n\r\n this.app.revertUrl();\r\n done(false); // block navigation\r\n }\r\n\r\n /**\r\n *\r\n * @param {string} context typically 'survey'\r\n * @param {('new'|'')} subcontext\r\n * @param {(''|'help')} rhs currently not used\r\n * @param {Object.} queryParameters surveyId\r\n */\r\n newSurveyHandler(context, subcontext, rhs, queryParameters) {\r\n // should not get here, as beforeNewHandler ought to have been invoked first\r\n }\r\n\r\n /**\r\n * called after the user has confirmed the add new survey dialogue box\r\n * @returns {Promise}\r\n */\r\n addNewSurveyHandler() {\r\n console.log(\"reached addNewSurveyHandler\");\r\n this.app.currentControllerHandle = this.handle; // when navigate back need to list need to ensure full view refresh\r\n\r\n // it's opportune at this point to try to ping the server again to save anything left outstanding\r\n return this.app.syncAll(true).finally(() => {\r\n\r\n // the app's occurrences should only relate to the current survey\r\n // (the reset surveys are remote or in IndexedDb)\r\n return this.app.clearCurrentSurvey()\r\n .then(() => this.app.setNewSurvey())\r\n .then(() => {\r\n this.app.router.pause();\r\n this.app.router.navigate('/list/survey/about').resume(); // jump straight into the survey rather than to welcome stage\r\n this.app.router.resolve();\r\n });\r\n });\r\n }\r\n\r\n /**\r\n * called after the user has confirmed reset surveys dialogue box\r\n *\r\n * @returns {Promise}\r\n */\r\n resetSurveysHandler() {\r\n return App.deleteCacheByPrefix('bsbi-images')\r\n .then(() => this.app.clearLocalForage())\r\n .then(() => this.app.reset())\r\n .finally(() => this.addNewSurveyHandler());\r\n }\r\n\r\n /**\r\n * url fragment to redirect to, following addition of an existing survey, e.g. a pick from the selection list\r\n *\r\n * should be '/list' or '/list/record'\r\n *\r\n * @type {string}\r\n */\r\n restoredSurveyNavigationTarget = '/list';\r\n\r\n /**\r\n *\r\n * @param {string} context typically 'survey'\r\n * @param {('add'|'')} subcontext\r\n * @param {(''|'help')} rhs currently not used\r\n * @param {Object.} queryParameters surveyId\r\n */\r\n addSurveyHandler(context, subcontext, rhs, queryParameters) {\r\n console.log(\"reached addSurveyHandler\");\r\n //console.log({context: context, params: subcontext, query: queryParameters});\r\n\r\n this.app.currentControllerHandle = this.handle; // when navigate back need to list need to ensure full view refresh\r\n\r\n let surveyId = queryParameters.surveyId;\r\n\r\n if (!surveyId || !surveyId.match(UUID_REGEX)) {\r\n throw new NotFoundError(`Failed to match survey id '${surveyId}', the id format appears to be incorrect`);\r\n }\r\n\r\n surveyId = surveyId.toLowerCase();\r\n\r\n // hide the left panel before loading, otherwise there can be a confusing delay\r\n this.view.hideLeftPanel();\r\n\r\n return this.app.restoreOccurrences(surveyId, false, true, false, true)\r\n .then(() => {\r\n this.app.markAllNotPristine();\r\n\r\n this.app.router.pause();\r\n this.app.router.navigate(this.restoredSurveyNavigationTarget).resume();\r\n this.app.router.resolve();\r\n }, (error) => {\r\n console.log({'failed survey restoration' : error});\r\n\r\n // should display a modal error message\r\n // either the survey was not found or there was no network connection\r\n\r\n // should switch to displaying a list of available surveys and an option to start a new survey\r\n return Promise.reject(error);\r\n })\r\n .finally(() => {\r\n this.view.restoreLeftPanel();\r\n })\r\n ;\r\n }\r\n\r\n /**\r\n *\r\n * @param {string} context typically 'survey'\r\n * @param {('add'|'')} subcontext\r\n * @param {(''|'help')} rhs currently not used\r\n * @param {Object.} queryParameters surveyId\r\n */\r\n mainRouteHandler(context, subcontext, rhs, queryParameters) {\r\n console.log(\"reached special route handler for SurveyPickerController.js\");\r\n //console.log({context: context, params: subcontext, query: queryParameters});\r\n }\r\n\r\n /**\r\n * Placeholder hook for login, overridden in descendants as required\r\n *\r\n * @param done\r\n * @param params\r\n */\r\n beforeRouteLoginHandler(done, params) {\r\n done(true);\r\n }\r\n}\r\n","import {ResponseFactory} from \"./ResponseFactory\";\r\nimport {LocalResponse} from \"./LocalResponse\";\r\nimport {SAVE_STATE_LOCAL, SAVE_STATE_SERVER} from \"../../utils/constants\";\r\n\r\nexport class TrackResponse extends LocalResponse {\r\n failureErrorMessage = 'Failed to store tracking data.';\r\n failureErrorHelp = 'Your internet connection may have failed (or there could be a problem with the server). ' +\r\n 'It wasn\\'t possible to save a temporary copy on your device. Perhaps there is insufficient space? ' +\r\n 'Please try to re-establish a network connection and try again.';\r\n\r\n /**\r\n * called to build the response to the post that is returned to the client\r\n * in the absence of the remote server\r\n *\r\n * @returns {this}\r\n */\r\n populateClientResponse() {\r\n this.returnedToClient.surveyId = this.toSaveLocally.surveyId;\r\n this.returnedToClient.deviceId = this.toSaveLocally.deviceId;\r\n this.returnedToClient.type = 'track';\r\n this.returnedToClient.attributes = this.toSaveLocally.attributes;\r\n this.returnedToClient.created = parseInt(this.toSaveLocally.created, 10); // stamps from server always take precedence\r\n this.returnedToClient.modified = parseInt(this.toSaveLocally.modified, 10);\r\n this.returnedToClient.saveState = SAVE_STATE_LOCAL;\r\n this.returnedToClient.deleted = this.toSaveLocally.deleted || '';\r\n this.returnedToClient.projectId = this.toSaveLocally.projectId;\r\n this.returnedToClient.userId = this.toSaveLocally.userId || '';\r\n this.returnedToClient.pointIndex = this.toSaveLocally.pointIndex;\r\n this.returnedToClient.points = this.toSaveLocally.points;\r\n return this;\r\n }\r\n\r\n /**\r\n * called to mirror a response from the server locally\r\n *\r\n * @returns {this}\r\n */\r\n populateLocalSave() {\r\n this.toSaveLocally.surveyId = this.returnedToClient.surveyId;\r\n this.toSaveLocally.deviceId = this.returnedToClient.deviceId;\r\n this.toSaveLocally.type = 'track';\r\n this.toSaveLocally.attributes = this.returnedToClient.attributes;\r\n this.toSaveLocally.created = parseInt(this.returnedToClient.created, 10); // stamps from server always take precedence\r\n this.toSaveLocally.modified = parseInt(this.returnedToClient.modified, 10);\r\n this.toSaveLocally.saveState = this.returnedToClient.saveState || SAVE_STATE_SERVER; //SAVE_STATE_SERVER;\r\n this.toSaveLocally.deleted = this.returnedToClient.deleted;\r\n this.toSaveLocally.projectId = parseInt(this.returnedToClient.projectId, 10);\r\n this.toSaveLocally.userId = this.returnedToClient.userId || '';\r\n this.toSaveLocally.pointIndex = parseInt(this.returnedToClient.pointIndex, 10);\r\n this.toSaveLocally.points = this.returnedToClient.points; // may eventually want to truncate this to save local space\r\n return this;\r\n }\r\n\r\n /**\r\n *\r\n * @returns {string}\r\n */\r\n localKey() {\r\n if (!this.toSaveLocally.deviceId || this.toSaveLocally.deviceId === 'undefined') {\r\n throw new Error(`Cannot generate a localKey for track, as the device id is undefined.`);\r\n }\r\n\r\n return `track.${this.toSaveLocally.surveyId}.${this.toSaveLocally.deviceId}`;\r\n }\r\n\r\n static register() {\r\n ResponseFactory.responses.track = TrackResponse;\r\n }\r\n}\r\n","import {ResponseFactory} from \"./ResponseFactory\";\r\nimport {LocalResponse} from \"./LocalResponse\";\r\nimport {SAVE_STATE_LOCAL, SAVE_STATE_SERVER} from \"../../utils/constants\";\r\n\r\nexport class SurveyDefinitionResponse extends LocalResponse {\r\n failureErrorMessage = 'Failed to store survey definition.';\r\n failureErrorHelp = 'Your internet connection may have failed (or there could be a problem with the server). ' +\r\n 'It wasn\\'t possible to save a temporary copy on your device. Perhaps there is insufficient space? ' +\r\n 'Please try to re-establish a network connection and try again.';\r\n\r\n /**\r\n * called to build the response to the post that is returned to the client\r\n * in the absence of the remote server\r\n *\r\n * @returns {this}\r\n */\r\n populateClientResponse() {\r\n this.returnedToClient.surveyDefinitionId = this.toSaveLocally.id || this.toSaveLocally.surveyDefinitionId; // hedging\r\n this.returnedToClient.id = this.toSaveLocally.id ? this.toSaveLocally.id : this.toSaveLocally.surveyDefinitionId; // hedging\r\n this.returnedToClient.type = 'surveydefinition';\r\n this.returnedToClient.attributes = this.toSaveLocally.attributes;\r\n this.returnedToClient.created = this.toSaveLocally.created; // stamps from server always take precedence\r\n this.returnedToClient.modified = this.toSaveLocally.modified;\r\n this.returnedToClient.saveState = SAVE_STATE_LOCAL;\r\n this.returnedToClient.deleted = this.toSaveLocally.deleted;\r\n this.returnedToClient.projectId = this.toSaveLocally.projectId;\r\n this.returnedToClient.userId = this.toSaveLocally.userId || '';\r\n this.returnedToClient.surveyType = this.toSaveLocally.surveyType;\r\n this.returnedToClient.inUse = this.toSaveLocally.inUse;\r\n return this;\r\n }\r\n\r\n /**\r\n * called to mirror a response from the server locally\r\n *\r\n * @returns {this}\r\n */\r\n populateLocalSave() {\r\n this.toSaveLocally.surveyDefinitionId = this.returnedToClient.id ? this.returnedToClient.id : this.returnedToClient.surveyDefinitionId;\r\n this.toSaveLocally.id = this.returnedToClient.id ? this.returnedToClient.id : this.returnedToClient.surveyDefinitionId;\r\n this.toSaveLocally.type = 'surveydefinition';\r\n this.toSaveLocally.attributes = this.returnedToClient.attributes;\r\n this.toSaveLocally.created = parseInt(this.returnedToClient.created, 10); // stamps from server always take precedence\r\n this.toSaveLocally.modified = parseInt(this.returnedToClient.modified, 10);\r\n this.toSaveLocally.saveState = this.returnedToClient.saveState || SAVE_STATE_SERVER; //SAVE_STATE_SERVER;\r\n this.toSaveLocally.deleted = this.returnedToClient.deleted;\r\n this.toSaveLocally.projectId = parseInt(this.returnedToClient.projectId, 10);\r\n this.toSaveLocally.userId = this.returnedToClient.userId || '';\r\n this.toSaveLocally.surveyType = this.returnedToClient.surveyType;\r\n this.toSaveLocally.inUse = this.returnedToClient.inUse;\r\n return this;\r\n }\r\n\r\n /**\r\n *\r\n * @returns {string}\r\n */\r\n localKey() {\r\n return `surveydefinition.${this.toSaveLocally.surveyDefinitionId}`;\r\n }\r\n\r\n static register() {\r\n ResponseFactory.responses.surveydefinition = SurveyDefinitionResponse;\r\n }\r\n}\r\n","//import {PartyError} from \"../utils/exceptions/PartyError\";\r\nimport {escapeHTML} from \"../utils/escapeHTML\";\r\n\r\nexport const PARTY_TYPE_PERSON = 'p';\r\nexport const PARTY_TYPE_ORGANISATION = 'u';\r\nexport const PARTY_TYPE_UNKNOWN = '?';\r\n\r\nexport const PARTY_NAME_INDEX = 0;\r\nexport const PARTY_SURNAME_INDEX = 2;\r\nexport const PARTY_FORENAMES_INDEX = 3;\r\nexport const PARTY_ORGNAME_INDEX = 4;\r\nexport const PARTY_INITIALS_INDEX = 5;\r\nexport const PARTY_ID_INDEX = 6;\r\nexport const PARTY_USERID_INDEX = 7;\r\nexport const PARTY_ROLES_INDEX = 8;\r\n\r\nexport class Party {\r\n /**\r\n * @typedef RawParty\r\n * @type {object}\r\n *\r\n * @property {string} 0 - name string\r\n * @property {array} 1 - dates (normally blank)\r\n * @property {string} 2 - surname\r\n * @property {string} 3 - forenames\r\n * @property {string} 4 - orgName\r\n * @property {string} 5 - initials\r\n * @property {string} 6 - id\r\n * @property {string} 7 - linked user id\r\n * @property {array} 8 - roles\r\n *\r\n * // these are not implemented\r\n * @property {string} [9] - type code\r\n * @property {string} [10] - prefix\r\n * @property {string} [11] - suffix\r\n * @property {string} [12] - disambiguation\r\n */\r\n\r\n // static NAME_INDEX = PARTY_NAME_INDEX;\r\n // static SURNAME_INDEX = PARTY_SURNAME_INDEX;\r\n // static FORENAMES_INDEX = PARTY_FORENAMES_INDEX;\r\n // static ORGNAME_INDEX = PARTY_ORGNAME_INDEX;\r\n // static INITIALS_INDEX = PARTY_INITIALS_INDEX;\r\n // static ID_INDEX = PARTY_ID_INDEX;\r\n // static USERID_INDEX = PARTY_USERID_INDEX;\r\n // static ROLES_INDEX = PARTY_ROLES_INDEX;\r\n\r\n /**\r\n * Generic party list, not tied to a particular user id\r\n *\r\n * @type {Array.}\r\n */\r\n static _baseParties = [];\r\n\r\n /**\r\n * Current party working set, combining the base set with per-user extras\r\n *\r\n * @type {Array.}\r\n */\r\n static rawParties = [];\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @type {string|null}\r\n */\r\n static loadedUserId = null;\r\n\r\n // static TYPE_PERSON = PARTY_TYPE_PERSON;\r\n // static TYPE_ORGANISATION = PARTY_TYPE_ORGANISATION;\r\n // static TYPE_UNKNOWN = PARTY_TYPE_UNKNOWN;\r\n\r\n // static USER_PARTIES_URL = '/';\r\n\r\n /**\r\n * @type {string}\r\n */\r\n id;\r\n\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n name = '';\r\n\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n firstName = '';\r\n\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n surnameName = '';\r\n\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n orgName = '';\r\n\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n type = '';\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n prefix = '';\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n suffix = '';\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @type {string}\r\n */\r\n disambiguation = '';\r\n\r\n // static setParties(parties) {\r\n // Party.rawParties = parties;\r\n // }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {Array.} parties\r\n * @param {number} parties.stamp\r\n * @param {string|null} sourceUrl\r\n */\r\n static initialiseParties(parties, sourceUrl = null) {\r\n Party._baseParties = parties;\r\n //Party.rawParties = [...Party._baseParties, ...parties];\r\n Party.rawParties = Party._baseParties;\r\n\r\n if (sourceUrl) {\r\n Party.testPartyRecache(parties.stamp, sourceUrl);\r\n }\r\n }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n static clearUserParties() {\r\n Party.rawParties = Party._baseParties;\r\n }\r\n\r\n /**\r\n *\r\n * @param {number|null} stamp\r\n * @param {string} sourceUrl\r\n * @param {number} interval\r\n * @todo default interval for re-cache should be shorter on desktops than on mobile\r\n */\r\n static testPartyRecache(stamp, sourceUrl, interval = (3600 * 24)) {\r\n if (navigator.onLine && stamp && (stamp + interval) < (Date.now() / 1000)) {\r\n console.log(`Party list may be stale (stamp is ${stamp}), prompting re-cache from ${sourceUrl}.`);\r\n navigator?.serviceWorker?.ready?.then?.((registration) => {\r\n registration.active.postMessage(\r\n {\r\n action: 'recache',\r\n url: sourceUrl\r\n }\r\n );\r\n });\r\n }\r\n }\r\n\r\n static additionalPartiesUrl = 'https://database.bsbi.org/js/appuserpartylist.mjs.php?user=';\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @param {string} userId\r\n * @returns {Promise}\r\n */\r\n static addUserParties(userId) {\r\n // where parties are the newly loaded extra set\r\n\r\n const url = `${Party.additionalPartiesUrl}${userId}`;\r\n\r\n return import(url).then((imported) => {\r\n const newParties = imported?.default;\r\n\r\n if (newParties?.length) {\r\n /**\r\n *\r\n * @type {Map}\r\n */\r\n const unique = new Map;\r\n\r\n // base parties must come first as these will be tied to registered DDb users\r\n // dynamically added in-app names must come last\r\n for (let party of [...Party._baseParties, ...newParties]) {\r\n /**\r\n * either the packed entity id, or a string-serialised forename-surname-orgname\r\n * @type {string}\r\n */\r\n let key = (party?.[PARTY_ID_INDEX]) || JSON.stringify([party?.[PARTY_FORENAMES_INDEX], party?.[PARTY_SURNAME_INDEX], party?.[PARTY_ORGNAME_INDEX]]);\r\n\r\n if (!unique.has(key)) {\r\n unique.set(key, party);\r\n }\r\n }\r\n\r\n Party.rawParties = Array.from(unique.values());\r\n }\r\n Party.testPartyRecache(newParties?.stamp, url);\r\n\r\n return newParties;\r\n }, (reason) => {\r\n console.error({\"Failed to import user parties\" : reason});\r\n return Promise.reject({\"Failed to import user parties\" : reason});\r\n });\r\n }\r\n\r\n // /**\r\n // * @todo this does not work as rawParties are not keyed by ID (as newly added parities in app won't have an entity id)\r\n // *\r\n // * @param {string} id\r\n // * @returns {Party}\r\n // * @throws {PartyError}\r\n // */\r\n // static fromId (id) {\r\n // if (!Party.rawParties) {\r\n // throw new PartyError(`Party.fromId() called before list has been initialised.`);\r\n // }\r\n //\r\n // if (!Party.rawParties.hasOwnProperty(id)) {\r\n // throw new PartyError(`Party id '${id}' not found.`);\r\n // }\r\n //\r\n // const raw = Party.rawParties[id];\r\n //\r\n // const party = new Party;\r\n //\r\n // party.id = id;\r\n // party.surname = raw[0] || '';\r\n // party.firstName = raw[1] || '';\r\n // party.orgName = raw[2] || '';\r\n // party.type = raw[3];\r\n // party.prefix = raw[4] || '';\r\n // party.suffix = raw[5] || '';\r\n // party.disambiguation = raw[6] || '';\r\n // // @todo need to set party.name\r\n //\r\n // return party;\r\n // }\r\n\r\n // noinspection JSUnusedGlobalSymbols\r\n /**\r\n *\r\n * @returns {string}\r\n */\r\n formattedHTML() {\r\n\r\n return this.type === PARTY_TYPE_PERSON ?\r\n escapeHTML(`${this.firstName} ${this.surnameName}`)\r\n :\r\n escapeHTML(this.orgName);\r\n }\r\n}\r\n","/**\r\n *\r\n * @param {string} separator\r\n * @param {string} finalSeparator\r\n * @param {Array.} list\r\n * @returns {string}\r\n */\r\nexport function formattedImplode(separator, finalSeparator, list) {\r\n if (list.length > 2) {\r\n const last = list.pop();\r\n return `${list.join(separator + ' ')} ${finalSeparator} ${last}`;\r\n } else {\r\n return list.join(` ${finalSeparator} `);\r\n }\r\n}","function isPushStateAvailable() {\n return !!(\n typeof window !== 'undefined' &&\n window.history &&\n window.history.pushState\n );\n}\n\nfunction Navigo(r, useHash, hash) {\n this.root = null;\n this._routes = [];\n this._useHash = useHash;\n this._hash = typeof hash === 'undefined' ? '#' : hash;\n this._paused = false;\n this._destroyed = false;\n this._lastRouteResolved = null;\n this._notFoundHandler = null;\n this._defaultHandler = null;\n this._usePushState = !useHash && isPushStateAvailable();\n this._onLocationChange = this._onLocationChange.bind(this);\n this._genericHooks = null;\n this._historyAPIUpdateMethod = 'pushState';\n\n if (r) {\n this.root = useHash ? r.replace(/\\/$/, '/' + this._hash) : r.replace(/\\/$/, '');\n } else if (useHash) {\n this.root = this._cLoc().split(this._hash)[0].replace(/\\/$/, '/' + this._hash);\n }\n\n this._listen();\n this.updatePageLinks();\n}\n\nfunction clean(s) {\n if (s instanceof RegExp) return s;\n return s.replace(/\\/+$/, '').replace(/^\\/+/, '^/');\n}\n\nfunction regExpResultToParams(match, names) {\n if (names.length === 0) return null;\n if (!match) return null;\n return match\n .slice(1, match.length)\n .reduce((params, value, index) => {\n if (params === null) params = {};\n params[names[index]] = decodeURIComponent(value);\n return params;\n }, null);\n}\n\nfunction replaceDynamicURLParts(route) {\n var paramNames = [], regexp;\n\n if (route instanceof RegExp) {\n regexp = route;\n } else {\n regexp = new RegExp(\n route.replace(Navigo.PARAMETER_REGEXP, function (full, dots, name) {\n paramNames.push(name);\n return Navigo.REPLACE_VARIABLE_REGEXP;\n })\n .replace(Navigo.WILDCARD_REGEXP, Navigo.REPLACE_WILDCARD) + Navigo.FOLLOWED_BY_SLASH_REGEXP\n , Navigo.MATCH_REGEXP_FLAGS);\n }\n return { regexp, paramNames };\n}\n\nfunction getUrlDepth(url) {\n return url.replace(/\\/$/, '').split('/').length;\n}\n\nfunction compareUrlDepth(urlA, urlB) {\n return getUrlDepth(urlB) - getUrlDepth(urlA);\n}\n\nfunction findMatchedRoutes(url, routes = []) {\n return routes\n .map(route => {\n var { regexp, paramNames } = replaceDynamicURLParts(clean(route.route));\n var match = url.replace(/^\\/+/, '/').match(regexp);\n var params = regExpResultToParams(match, paramNames);\n\n return match ? { match, route, params } : false;\n })\n .filter(m => m);\n}\n\nfunction match(url, routes) {\n return findMatchedRoutes(url, routes)[0] || false;\n}\n\nfunction root(url, routes) {\n var matched = routes.map(\n route => route.route === '' || route.route === '*' ? url : url.split(new RegExp(route.route + '($|\\/)'))[0]\n );\n var fallbackURL = clean(url);\n\n if (matched.length > 1) {\n return matched.reduce((result, url) => {\n if (result.length > url.length) result = url;\n return result;\n }, matched[0]);\n } else if (matched.length === 1) {\n return matched[0];\n }\n return fallbackURL;\n}\n\nfunction isHashChangeAPIAvailable() {\n return typeof window !== 'undefined' && 'onhashchange' in window;\n}\n\nfunction extractGETParameters(url) {\n return url.split(/\\?(.*)?$/).slice(1).join('');\n}\n\nfunction getOnlyURL(url, useHash, hash) {\n var onlyURL = url, split;\n var cleanGETParam = str => str.split(/\\?(.*)?$/)[0];\n\n if (typeof hash === 'undefined') {\n // To preserve BC\n hash = '#';\n }\n\n if (isPushStateAvailable() && !useHash) {\n onlyURL = cleanGETParam(url).split(hash)[0];\n } else {\n split = url.split(hash);\n onlyURL = split.length > 1 ? cleanGETParam(split[1]) : cleanGETParam(split[0]);\n }\n\n return onlyURL;\n}\n\nfunction manageHooks(handler, hooks, params) {\n if (hooks && typeof hooks === 'object') {\n if (hooks.before) {\n hooks.before((shouldRoute = true) => {\n if (!shouldRoute) return;\n handler();\n hooks.after && hooks.after(params);\n }, params);\n return;\n } else if (hooks.after) {\n handler();\n hooks.after && hooks.after(params);\n return;\n }\n }\n handler();\n}\n\nfunction isHashedRoot(url, useHash, hash) {\n if (isPushStateAvailable() && !useHash) {\n return false;\n }\n\n if (!url.match(hash)) {\n return false;\n }\n\n let split = url.split(hash);\n\n return split.length < 2 || split[1] === '';\n}\n\nNavigo.prototype = {\n helpers: {\n match,\n root,\n clean,\n getOnlyURL\n },\n navigate: function (path, absolute) {\n var to;\n\n path = path || '';\n if (this._usePushState) {\n to = (!absolute ? this._getRoot() + '/' : '') + path.replace(/^\\/+/, '/');\n to = to.replace(/([^:])(\\/{2,})/g, '$1/');\n history[this._historyAPIUpdateMethod]({}, '', to);\n this.resolve();\n } else if (typeof window !== 'undefined') {\n path = path.replace(new RegExp('^' + this._hash), '');\n window.location.href =\n window.location.href\n .replace(/#$/, '')\n .replace(new RegExp(this._hash + '.*$'), '') + this._hash + path;\n }\n return this;\n },\n on: function (...args) {\n if (typeof args[0] === 'function') {\n this._defaultHandler = { handler: args[0], hooks: args[1] };\n } else if (args.length >= 2) {\n if (args[0] === '/') {\n let func = args[1];\n\n if (typeof args[1] === 'object') {\n func = args[1].uses;\n }\n\n this._defaultHandler = { handler: func, hooks: args[2] };\n } else {\n this._add(args[0], args[1], args[2]);\n }\n } else if (typeof args[0] === 'object') {\n let orderedRoutes = Object.keys(args[0]).sort(compareUrlDepth);\n\n orderedRoutes.forEach(route => {\n this.on(route, args[0][route]);\n });\n }\n return this;\n },\n off: function (handler) {\n if (this._defaultHandler !== null && handler === this._defaultHandler.handler) {\n this._defaultHandler = null;\n } else if (this._notFoundHandler !== null && handler === this._notFoundHandler.handler) {\n this._notFoundHandler = null;\n }\n this._routes = this._routes.reduce((result, r) => {\n if (r.handler !== handler) result.push(r);\n return result;\n }, []);\n return this;\n },\n notFound: function (handler, hooks) {\n this._notFoundHandler = { handler, hooks: hooks };\n return this;\n },\n resolve: function (current) {\n var handler, m;\n var url = (current || this._cLoc()).replace(this._getRoot(), '');\n\n if (this._useHash) {\n url = url.replace(new RegExp('^\\/' + this._hash), '/');\n }\n\n let GETParameters = extractGETParameters(current || this._cLoc());\n let onlyURL = getOnlyURL(url, this._useHash, this._hash);\n\n if (this._paused) return false;\n\n if (\n this._lastRouteResolved &&\n onlyURL === this._lastRouteResolved.url &&\n GETParameters === this._lastRouteResolved.query\n ) {\n if (this._lastRouteResolved.hooks && this._lastRouteResolved.hooks.already) {\n this._lastRouteResolved.hooks.already(this._lastRouteResolved.params);\n }\n return false;\n }\n\n m = match(onlyURL, this._routes);\n\n if (m) {\n this._callLeave();\n this._lastRouteResolved = {\n url: onlyURL,\n query: GETParameters,\n hooks: m.route.hooks,\n params: m.params,\n name: m.route.name\n };\n handler = m.route.handler;\n manageHooks(() => {\n manageHooks(() => {\n m.route.route instanceof RegExp ?\n handler(...(m.match.slice(1, m.match.length))) :\n handler(m.params, GETParameters);\n }, m.route.hooks, m.params, this._genericHooks);\n }, this._genericHooks, m.params);\n return m;\n } else if (this._defaultHandler && (\n onlyURL === '' ||\n onlyURL === '/' ||\n onlyURL === this._hash ||\n isHashedRoot(onlyURL, this._useHash, this._hash)\n )) {\n manageHooks(() => {\n manageHooks(() => {\n this._callLeave();\n this._lastRouteResolved = { url: onlyURL, query: GETParameters, hooks: this._defaultHandler.hooks };\n this._defaultHandler.handler(GETParameters);\n }, this._defaultHandler.hooks);\n }, this._genericHooks);\n return true;\n } else if (this._notFoundHandler) {\n manageHooks(() => {\n manageHooks(() => {\n this._callLeave();\n this._lastRouteResolved = { url: onlyURL, query: GETParameters, hooks: this._notFoundHandler.hooks };\n this._notFoundHandler.handler(GETParameters);\n }, this._notFoundHandler.hooks);\n }, this._genericHooks);\n }\n return false;\n },\n destroy: function () {\n this._routes = [];\n this._destroyed = true;\n this._lastRouteResolved = null;\n this._genericHooks = null;\n clearTimeout(this._listeningInterval);\n if (typeof window !== 'undefined') {\n window.removeEventListener('popstate', this._onLocationChange);\n window.removeEventListener('hashchange', this._onLocationChange);\n }\n },\n updatePageLinks: function () {\n var self = this;\n\n if (typeof document === 'undefined') return;\n\n this._findLinks().forEach(link => {\n if (!link.hasListenerAttached) {\n link.addEventListener('click', function (e) {\n if((e.ctrlKey || e.metaKey) && e.target.tagName.toLowerCase() == 'a'){ return false; }\n var location = self.getLinkPath(link);\n\n if (!self._destroyed) {\n e.preventDefault();\n self.navigate(location.replace(/\\/+$/, '').replace(/^\\/+/, '/'));\n }\n });\n link.hasListenerAttached = true;\n }\n });\n },\n generate: function (name, data = {}) {\n var result = this._routes.reduce((result, route) => {\n var key;\n\n if (route.name === name) {\n result = route.route;\n for (key in data) {\n result = result.toString().replace(':' + key, data[key]);\n }\n }\n return result;\n }, '');\n\n return this._useHash ? this._hash + result : result;\n },\n link: function (path) {\n return this._getRoot() + path;\n },\n pause: function (status = true) {\n this._paused = status;\n if (status) {\n this._historyAPIUpdateMethod = 'replaceState';\n } else {\n this._historyAPIUpdateMethod = 'pushState';\n }\n },\n resume: function () {\n this.pause(false);\n },\n historyAPIUpdateMethod: function (value) {\n if (typeof value === 'undefined') return this._historyAPIUpdateMethod;\n this._historyAPIUpdateMethod = value;\n return value;\n },\n disableIfAPINotAvailable: function () {\n if (!isPushStateAvailable()) {\n this.destroy();\n }\n },\n lastRouteResolved() {\n return this._lastRouteResolved;\n },\n getLinkPath(link) {\n return link.getAttribute('href');\n },\n hooks(hooks) {\n this._genericHooks = hooks;\n },\n _add: function (route, handler = null, hooks = null) {\n if (typeof route === 'string') {\n route = encodeURI(route);\n }\n this._routes.push(\n typeof handler === 'object' ? {\n route,\n handler: handler.uses,\n name: handler.as,\n hooks: hooks || handler.hooks\n } : { route, handler, hooks: hooks }\n );\n\n return this._add;\n },\n _getRoot: function () {\n if (this.root !== null) return this.root;\n this.root = root(this._cLoc().split('?')[0], this._routes);\n return this.root;\n },\n _listen: function () {\n if (this._usePushState) {\n window.addEventListener('popstate', this._onLocationChange);\n } else if (isHashChangeAPIAvailable()) {\n window.addEventListener('hashchange', this._onLocationChange);\n } else {\n let cached = this._cLoc(), current, check;\n\n check = () => {\n current = this._cLoc();\n if (cached !== current) {\n cached = current;\n this.resolve();\n }\n this._listeningInterval = setTimeout(check, 200);\n };\n check();\n }\n },\n _cLoc: function () {\n if (typeof window !== 'undefined') {\n if (typeof window.__NAVIGO_WINDOW_LOCATION_MOCK__ !== 'undefined') {\n return window.__NAVIGO_WINDOW_LOCATION_MOCK__;\n }\n return clean(window.location.href);\n }\n return '';\n },\n _findLinks: function () {\n return [].slice.call(document.querySelectorAll('[data-navigo]'));\n },\n _onLocationChange: function () {\n this.resolve();\n },\n _callLeave() {\n const lastRouteResolved = this._lastRouteResolved;\n\n if (lastRouteResolved && lastRouteResolved.hooks && lastRouteResolved.hooks.leave) {\n lastRouteResolved.hooks.leave(lastRouteResolved.params);\n }\n }\n};\n\nNavigo.PARAMETER_REGEXP = /([:*])(\\w+)/g;\nNavigo.WILDCARD_REGEXP = /\\*/g;\nNavigo.REPLACE_VARIABLE_REGEXP = '([^\\/]+)';\nNavigo.REPLACE_WILDCARD = '(?:.*)';\nNavigo.FOLLOWED_BY_SLASH_REGEXP = '(?:\\/$|$)';\nNavigo.MATCH_REGEXP_FLAGS = '';\n\nexport default Navigo;\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap dom/data.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\n/**\n * Constants\n */\n\nconst elementMap = new Map()\n\nexport default {\n set(element, key, instance) {\n if (!elementMap.has(element)) {\n elementMap.set(element, new Map())\n }\n\n const instanceMap = elementMap.get(element)\n\n // make it clear we only want one instance per element\n // can be removed later when multiple key/instances are fine to be used\n if (!instanceMap.has(key) && instanceMap.size !== 0) {\n // eslint-disable-next-line no-console\n console.error(`Bootstrap doesn't allow more than one instance per element. Bound instance: ${Array.from(instanceMap.keys())[0]}.`)\n return\n }\n\n instanceMap.set(key, instance)\n },\n\n get(element, key) {\n if (elementMap.has(element)) {\n return elementMap.get(element).get(key) || null\n }\n\n return null\n },\n\n remove(element, key) {\n if (!elementMap.has(element)) {\n return\n }\n\n const instanceMap = elementMap.get(element)\n\n instanceMap.delete(key)\n\n // free up element references if there are no instances left for an element\n if (instanceMap.size === 0) {\n elementMap.delete(element)\n }\n }\n}\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap util/index.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nconst MAX_UID = 1_000_000\nconst MILLISECONDS_MULTIPLIER = 1000\nconst TRANSITION_END = 'transitionend'\n\n/**\n * Properly escape IDs selectors to handle weird IDs\n * @param {string} selector\n * @returns {string}\n */\nconst parseSelector = selector => {\n if (selector && window.CSS && window.CSS.escape) {\n // document.querySelector needs escaping to handle IDs (html5+) containing for instance /\n selector = selector.replace(/#([^\\s\"#']+)/g, (match, id) => `#${CSS.escape(id)}`)\n }\n\n return selector\n}\n\n// Shout-out Angus Croll (https://goo.gl/pxwQGp)\nconst toType = object => {\n if (object === null || object === undefined) {\n return `${object}`\n }\n\n return Object.prototype.toString.call(object).match(/\\s([a-z]+)/i)[1].toLowerCase()\n}\n\n/**\n * Public Util API\n */\n\nconst getUID = prefix => {\n do {\n prefix += Math.floor(Math.random() * MAX_UID)\n } while (document.getElementById(prefix))\n\n return prefix\n}\n\nconst getTransitionDurationFromElement = element => {\n if (!element) {\n return 0\n }\n\n // Get transition-duration of the element\n let { transitionDuration, transitionDelay } = window.getComputedStyle(element)\n\n const floatTransitionDuration = Number.parseFloat(transitionDuration)\n const floatTransitionDelay = Number.parseFloat(transitionDelay)\n\n // Return 0 if element or transition duration is not found\n if (!floatTransitionDuration && !floatTransitionDelay) {\n return 0\n }\n\n // If multiple durations are defined, take the first\n transitionDuration = transitionDuration.split(',')[0]\n transitionDelay = transitionDelay.split(',')[0]\n\n return (Number.parseFloat(transitionDuration) + Number.parseFloat(transitionDelay)) * MILLISECONDS_MULTIPLIER\n}\n\nconst triggerTransitionEnd = element => {\n element.dispatchEvent(new Event(TRANSITION_END))\n}\n\nconst isElement = object => {\n if (!object || typeof object !== 'object') {\n return false\n }\n\n if (typeof object.jquery !== 'undefined') {\n object = object[0]\n }\n\n return typeof object.nodeType !== 'undefined'\n}\n\nconst getElement = object => {\n // it's a jQuery object or a node element\n if (isElement(object)) {\n return object.jquery ? object[0] : object\n }\n\n if (typeof object === 'string' && object.length > 0) {\n return document.querySelector(parseSelector(object))\n }\n\n return null\n}\n\nconst isVisible = element => {\n if (!isElement(element) || element.getClientRects().length === 0) {\n return false\n }\n\n const elementIsVisible = getComputedStyle(element).getPropertyValue('visibility') === 'visible'\n // Handle `details` element as its content may falsie appear visible when it is closed\n const closedDetails = element.closest('details:not([open])')\n\n if (!closedDetails) {\n return elementIsVisible\n }\n\n if (closedDetails !== element) {\n const summary = element.closest('summary')\n if (summary && summary.parentNode !== closedDetails) {\n return false\n }\n\n if (summary === null) {\n return false\n }\n }\n\n return elementIsVisible\n}\n\nconst isDisabled = element => {\n if (!element || element.nodeType !== Node.ELEMENT_NODE) {\n return true\n }\n\n if (element.classList.contains('disabled')) {\n return true\n }\n\n if (typeof element.disabled !== 'undefined') {\n return element.disabled\n }\n\n return element.hasAttribute('disabled') && element.getAttribute('disabled') !== 'false'\n}\n\nconst findShadowRoot = element => {\n if (!document.documentElement.attachShadow) {\n return null\n }\n\n // Can find the shadow root otherwise it'll return the document\n if (typeof element.getRootNode === 'function') {\n const root = element.getRootNode()\n return root instanceof ShadowRoot ? root : null\n }\n\n if (element instanceof ShadowRoot) {\n return element\n }\n\n // when we don't find a shadow root\n if (!element.parentNode) {\n return null\n }\n\n return findShadowRoot(element.parentNode)\n}\n\nconst noop = () => {}\n\n/**\n * Trick to restart an element's animation\n *\n * @param {HTMLElement} element\n * @return void\n *\n * @see https://www.harrytheo.com/blog/2021/02/restart-a-css-animation-with-javascript/#restarting-a-css-animation\n */\nconst reflow = element => {\n element.offsetHeight // eslint-disable-line no-unused-expressions\n}\n\nconst getjQuery = () => {\n if (window.jQuery && !document.body.hasAttribute('data-bs-no-jquery')) {\n return window.jQuery\n }\n\n return null\n}\n\nconst DOMContentLoadedCallbacks = []\n\nconst onDOMContentLoaded = callback => {\n if (document.readyState === 'loading') {\n // add listener on the first call when the document is in loading state\n if (!DOMContentLoadedCallbacks.length) {\n document.addEventListener('DOMContentLoaded', () => {\n for (const callback of DOMContentLoadedCallbacks) {\n callback()\n }\n })\n }\n\n DOMContentLoadedCallbacks.push(callback)\n } else {\n callback()\n }\n}\n\nconst isRTL = () => document.documentElement.dir === 'rtl'\n\nconst defineJQueryPlugin = plugin => {\n onDOMContentLoaded(() => {\n const $ = getjQuery()\n /* istanbul ignore if */\n if ($) {\n const name = plugin.NAME\n const JQUERY_NO_CONFLICT = $.fn[name]\n $.fn[name] = plugin.jQueryInterface\n $.fn[name].Constructor = plugin\n $.fn[name].noConflict = () => {\n $.fn[name] = JQUERY_NO_CONFLICT\n return plugin.jQueryInterface\n }\n }\n })\n}\n\nconst execute = (possibleCallback, args = [], defaultValue = possibleCallback) => {\n return typeof possibleCallback === 'function' ? possibleCallback.call(...args) : defaultValue\n}\n\nconst executeAfterTransition = (callback, transitionElement, waitForTransition = true) => {\n if (!waitForTransition) {\n execute(callback)\n return\n }\n\n const durationPadding = 5\n const emulatedDuration = getTransitionDurationFromElement(transitionElement) + durationPadding\n\n let called = false\n\n const handler = ({ target }) => {\n if (target !== transitionElement) {\n return\n }\n\n called = true\n transitionElement.removeEventListener(TRANSITION_END, handler)\n execute(callback)\n }\n\n transitionElement.addEventListener(TRANSITION_END, handler)\n setTimeout(() => {\n if (!called) {\n triggerTransitionEnd(transitionElement)\n }\n }, emulatedDuration)\n}\n\n/**\n * Return the previous/next element of a list.\n *\n * @param {array} list The list of elements\n * @param activeElement The active element\n * @param shouldGetNext Choose to get next or previous element\n * @param isCycleAllowed\n * @return {Element|elem} The proper element\n */\nconst getNextActiveElement = (list, activeElement, shouldGetNext, isCycleAllowed) => {\n const listLength = list.length\n let index = list.indexOf(activeElement)\n\n // if the element does not exist in the list return an element\n // depending on the direction and if cycle is allowed\n if (index === -1) {\n return !shouldGetNext && isCycleAllowed ? list[listLength - 1] : list[0]\n }\n\n index += shouldGetNext ? 1 : -1\n\n if (isCycleAllowed) {\n index = (index + listLength) % listLength\n }\n\n return list[Math.max(0, Math.min(index, listLength - 1))]\n}\n\nexport {\n defineJQueryPlugin,\n execute,\n executeAfterTransition,\n findShadowRoot,\n getElement,\n getjQuery,\n getNextActiveElement,\n getTransitionDurationFromElement,\n getUID,\n isDisabled,\n isElement,\n isRTL,\n isVisible,\n noop,\n onDOMContentLoaded,\n parseSelector,\n reflow,\n triggerTransitionEnd,\n toType\n}\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap dom/event-handler.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport { getjQuery } from '../util/index.js'\n\n/**\n * Constants\n */\n\nconst namespaceRegex = /[^.]*(?=\\..*)\\.|.*/\nconst stripNameRegex = /\\..*/\nconst stripUidRegex = /::\\d+$/\nconst eventRegistry = {} // Events storage\nlet uidEvent = 1\nconst customEvents = {\n mouseenter: 'mouseover',\n mouseleave: 'mouseout'\n}\n\nconst nativeEvents = new Set([\n 'click',\n 'dblclick',\n 'mouseup',\n 'mousedown',\n 'contextmenu',\n 'mousewheel',\n 'DOMMouseScroll',\n 'mouseover',\n 'mouseout',\n 'mousemove',\n 'selectstart',\n 'selectend',\n 'keydown',\n 'keypress',\n 'keyup',\n 'orientationchange',\n 'touchstart',\n 'touchmove',\n 'touchend',\n 'touchcancel',\n 'pointerdown',\n 'pointermove',\n 'pointerup',\n 'pointerleave',\n 'pointercancel',\n 'gesturestart',\n 'gesturechange',\n 'gestureend',\n 'focus',\n 'blur',\n 'change',\n 'reset',\n 'select',\n 'submit',\n 'focusin',\n 'focusout',\n 'load',\n 'unload',\n 'beforeunload',\n 'resize',\n 'move',\n 'DOMContentLoaded',\n 'readystatechange',\n 'error',\n 'abort',\n 'scroll'\n])\n\n/**\n * Private methods\n */\n\nfunction makeEventUid(element, uid) {\n return (uid && `${uid}::${uidEvent++}`) || element.uidEvent || uidEvent++\n}\n\nfunction getElementEvents(element) {\n const uid = makeEventUid(element)\n\n element.uidEvent = uid\n eventRegistry[uid] = eventRegistry[uid] || {}\n\n return eventRegistry[uid]\n}\n\nfunction bootstrapHandler(element, fn) {\n return function handler(event) {\n hydrateObj(event, { delegateTarget: element })\n\n if (handler.oneOff) {\n EventHandler.off(element, event.type, fn)\n }\n\n return fn.apply(element, [event])\n }\n}\n\nfunction bootstrapDelegationHandler(element, selector, fn) {\n return function handler(event) {\n const domElements = element.querySelectorAll(selector)\n\n for (let { target } = event; target && target !== this; target = target.parentNode) {\n for (const domElement of domElements) {\n if (domElement !== target) {\n continue\n }\n\n hydrateObj(event, { delegateTarget: target })\n\n if (handler.oneOff) {\n EventHandler.off(element, event.type, selector, fn)\n }\n\n return fn.apply(target, [event])\n }\n }\n }\n}\n\nfunction findHandler(events, callable, delegationSelector = null) {\n return Object.values(events)\n .find(event => event.callable === callable && event.delegationSelector === delegationSelector)\n}\n\nfunction normalizeParameters(originalTypeEvent, handler, delegationFunction) {\n const isDelegated = typeof handler === 'string'\n // TODO: tooltip passes `false` instead of selector, so we need to check\n const callable = isDelegated ? delegationFunction : (handler || delegationFunction)\n let typeEvent = getTypeEvent(originalTypeEvent)\n\n if (!nativeEvents.has(typeEvent)) {\n typeEvent = originalTypeEvent\n }\n\n return [isDelegated, callable, typeEvent]\n}\n\nfunction addHandler(element, originalTypeEvent, handler, delegationFunction, oneOff) {\n if (typeof originalTypeEvent !== 'string' || !element) {\n return\n }\n\n let [isDelegated, callable, typeEvent] = normalizeParameters(originalTypeEvent, handler, delegationFunction)\n\n // in case of mouseenter or mouseleave wrap the handler within a function that checks for its DOM position\n // this prevents the handler from being dispatched the same way as mouseover or mouseout does\n if (originalTypeEvent in customEvents) {\n const wrapFunction = fn => {\n return function (event) {\n if (!event.relatedTarget || (event.relatedTarget !== event.delegateTarget && !event.delegateTarget.contains(event.relatedTarget))) {\n return fn.call(this, event)\n }\n }\n }\n\n callable = wrapFunction(callable)\n }\n\n const events = getElementEvents(element)\n const handlers = events[typeEvent] || (events[typeEvent] = {})\n const previousFunction = findHandler(handlers, callable, isDelegated ? handler : null)\n\n if (previousFunction) {\n previousFunction.oneOff = previousFunction.oneOff && oneOff\n\n return\n }\n\n const uid = makeEventUid(callable, originalTypeEvent.replace(namespaceRegex, ''))\n const fn = isDelegated ?\n bootstrapDelegationHandler(element, handler, callable) :\n bootstrapHandler(element, callable)\n\n fn.delegationSelector = isDelegated ? handler : null\n fn.callable = callable\n fn.oneOff = oneOff\n fn.uidEvent = uid\n handlers[uid] = fn\n\n element.addEventListener(typeEvent, fn, isDelegated)\n}\n\nfunction removeHandler(element, events, typeEvent, handler, delegationSelector) {\n const fn = findHandler(events[typeEvent], handler, delegationSelector)\n\n if (!fn) {\n return\n }\n\n element.removeEventListener(typeEvent, fn, Boolean(delegationSelector))\n delete events[typeEvent][fn.uidEvent]\n}\n\nfunction removeNamespacedHandlers(element, events, typeEvent, namespace) {\n const storeElementEvent = events[typeEvent] || {}\n\n for (const [handlerKey, event] of Object.entries(storeElementEvent)) {\n if (handlerKey.includes(namespace)) {\n removeHandler(element, events, typeEvent, event.callable, event.delegationSelector)\n }\n }\n}\n\nfunction getTypeEvent(event) {\n // allow to get the native events from namespaced events ('click.bs.button' --> 'click')\n event = event.replace(stripNameRegex, '')\n return customEvents[event] || event\n}\n\nconst EventHandler = {\n on(element, event, handler, delegationFunction) {\n addHandler(element, event, handler, delegationFunction, false)\n },\n\n one(element, event, handler, delegationFunction) {\n addHandler(element, event, handler, delegationFunction, true)\n },\n\n off(element, originalTypeEvent, handler, delegationFunction) {\n if (typeof originalTypeEvent !== 'string' || !element) {\n return\n }\n\n const [isDelegated, callable, typeEvent] = normalizeParameters(originalTypeEvent, handler, delegationFunction)\n const inNamespace = typeEvent !== originalTypeEvent\n const events = getElementEvents(element)\n const storeElementEvent = events[typeEvent] || {}\n const isNamespace = originalTypeEvent.startsWith('.')\n\n if (typeof callable !== 'undefined') {\n // Simplest case: handler is passed, remove that listener ONLY.\n if (!Object.keys(storeElementEvent).length) {\n return\n }\n\n removeHandler(element, events, typeEvent, callable, isDelegated ? handler : null)\n return\n }\n\n if (isNamespace) {\n for (const elementEvent of Object.keys(events)) {\n removeNamespacedHandlers(element, events, elementEvent, originalTypeEvent.slice(1))\n }\n }\n\n for (const [keyHandlers, event] of Object.entries(storeElementEvent)) {\n const handlerKey = keyHandlers.replace(stripUidRegex, '')\n\n if (!inNamespace || originalTypeEvent.includes(handlerKey)) {\n removeHandler(element, events, typeEvent, event.callable, event.delegationSelector)\n }\n }\n },\n\n trigger(element, event, args) {\n if (typeof event !== 'string' || !element) {\n return null\n }\n\n const $ = getjQuery()\n const typeEvent = getTypeEvent(event)\n const inNamespace = event !== typeEvent\n\n let jQueryEvent = null\n let bubbles = true\n let nativeDispatch = true\n let defaultPrevented = false\n\n if (inNamespace && $) {\n jQueryEvent = $.Event(event, args)\n\n $(element).trigger(jQueryEvent)\n bubbles = !jQueryEvent.isPropagationStopped()\n nativeDispatch = !jQueryEvent.isImmediatePropagationStopped()\n defaultPrevented = jQueryEvent.isDefaultPrevented()\n }\n\n const evt = hydrateObj(new Event(event, { bubbles, cancelable: true }), args)\n\n if (defaultPrevented) {\n evt.preventDefault()\n }\n\n if (nativeDispatch) {\n element.dispatchEvent(evt)\n }\n\n if (evt.defaultPrevented && jQueryEvent) {\n jQueryEvent.preventDefault()\n }\n\n return evt\n }\n}\n\nfunction hydrateObj(obj, meta = {}) {\n for (const [key, value] of Object.entries(meta)) {\n try {\n obj[key] = value\n } catch {\n Object.defineProperty(obj, key, {\n configurable: true,\n get() {\n return value\n }\n })\n }\n }\n\n return obj\n}\n\nexport default EventHandler\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap dom/manipulator.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nfunction normalizeData(value) {\n if (value === 'true') {\n return true\n }\n\n if (value === 'false') {\n return false\n }\n\n if (value === Number(value).toString()) {\n return Number(value)\n }\n\n if (value === '' || value === 'null') {\n return null\n }\n\n if (typeof value !== 'string') {\n return value\n }\n\n try {\n return JSON.parse(decodeURIComponent(value))\n } catch {\n return value\n }\n}\n\nfunction normalizeDataKey(key) {\n return key.replace(/[A-Z]/g, chr => `-${chr.toLowerCase()}`)\n}\n\nconst Manipulator = {\n setDataAttribute(element, key, value) {\n element.setAttribute(`data-bs-${normalizeDataKey(key)}`, value)\n },\n\n removeDataAttribute(element, key) {\n element.removeAttribute(`data-bs-${normalizeDataKey(key)}`)\n },\n\n getDataAttributes(element) {\n if (!element) {\n return {}\n }\n\n const attributes = {}\n const bsKeys = Object.keys(element.dataset).filter(key => key.startsWith('bs') && !key.startsWith('bsConfig'))\n\n for (const key of bsKeys) {\n let pureKey = key.replace(/^bs/, '')\n pureKey = pureKey.charAt(0).toLowerCase() + pureKey.slice(1)\n attributes[pureKey] = normalizeData(element.dataset[key])\n }\n\n return attributes\n },\n\n getDataAttribute(element, key) {\n return normalizeData(element.getAttribute(`data-bs-${normalizeDataKey(key)}`))\n }\n}\n\nexport default Manipulator\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap util/config.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport Manipulator from '../dom/manipulator.js'\nimport { isElement, toType } from './index.js'\n\n/**\n * Class definition\n */\n\nclass Config {\n // Getters\n static get Default() {\n return {}\n }\n\n static get DefaultType() {\n return {}\n }\n\n static get NAME() {\n throw new Error('You have to implement the static method \"NAME\", for each component!')\n }\n\n _getConfig(config) {\n config = this._mergeConfigObj(config)\n config = this._configAfterMerge(config)\n this._typeCheckConfig(config)\n return config\n }\n\n _configAfterMerge(config) {\n return config\n }\n\n _mergeConfigObj(config, element) {\n const jsonConfig = isElement(element) ? Manipulator.getDataAttribute(element, 'config') : {} // try to parse\n\n return {\n ...this.constructor.Default,\n ...(typeof jsonConfig === 'object' ? jsonConfig : {}),\n ...(isElement(element) ? Manipulator.getDataAttributes(element) : {}),\n ...(typeof config === 'object' ? config : {})\n }\n }\n\n _typeCheckConfig(config, configTypes = this.constructor.DefaultType) {\n for (const [property, expectedTypes] of Object.entries(configTypes)) {\n const value = config[property]\n const valueType = isElement(value) ? 'element' : toType(value)\n\n if (!new RegExp(expectedTypes).test(valueType)) {\n throw new TypeError(\n `${this.constructor.NAME.toUpperCase()}: Option \"${property}\" provided type \"${valueType}\" but expected type \"${expectedTypes}\".`\n )\n }\n }\n }\n}\n\nexport default Config\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap base-component.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport Data from './dom/data.js'\nimport EventHandler from './dom/event-handler.js'\nimport Config from './util/config.js'\nimport { executeAfterTransition, getElement } from './util/index.js'\n\n/**\n * Constants\n */\n\nconst VERSION = '5.3.8'\n\n/**\n * Class definition\n */\n\nclass BaseComponent extends Config {\n constructor(element, config) {\n super()\n\n element = getElement(element)\n if (!element) {\n return\n }\n\n this._element = element\n this._config = this._getConfig(config)\n\n Data.set(this._element, this.constructor.DATA_KEY, this)\n }\n\n // Public\n dispose() {\n Data.remove(this._element, this.constructor.DATA_KEY)\n EventHandler.off(this._element, this.constructor.EVENT_KEY)\n\n for (const propertyName of Object.getOwnPropertyNames(this)) {\n this[propertyName] = null\n }\n }\n\n // Private\n _queueCallback(callback, element, isAnimated = true) {\n executeAfterTransition(callback, element, isAnimated)\n }\n\n _getConfig(config) {\n config = this._mergeConfigObj(config, this._element)\n config = this._configAfterMerge(config)\n this._typeCheckConfig(config)\n return config\n }\n\n // Static\n static getInstance(element) {\n return Data.get(getElement(element), this.DATA_KEY)\n }\n\n static getOrCreateInstance(element, config = {}) {\n return this.getInstance(element) || new this(element, typeof config === 'object' ? config : null)\n }\n\n static get VERSION() {\n return VERSION\n }\n\n static get DATA_KEY() {\n return `bs.${this.NAME}`\n }\n\n static get EVENT_KEY() {\n return `.${this.DATA_KEY}`\n }\n\n static eventName(name) {\n return `${name}${this.EVENT_KEY}`\n }\n}\n\nexport default BaseComponent\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap dom/selector-engine.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport { isDisabled, isVisible, parseSelector } from '../util/index.js'\n\nconst getSelector = element => {\n let selector = element.getAttribute('data-bs-target')\n\n if (!selector || selector === '#') {\n let hrefAttribute = element.getAttribute('href')\n\n // The only valid content that could double as a selector are IDs or classes,\n // so everything starting with `#` or `.`. If a \"real\" URL is used as the selector,\n // `document.querySelector` will rightfully complain it is invalid.\n // See https://github.com/twbs/bootstrap/issues/32273\n if (!hrefAttribute || (!hrefAttribute.includes('#') && !hrefAttribute.startsWith('.'))) {\n return null\n }\n\n // Just in case some CMS puts out a full URL with the anchor appended\n if (hrefAttribute.includes('#') && !hrefAttribute.startsWith('#')) {\n hrefAttribute = `#${hrefAttribute.split('#')[1]}`\n }\n\n selector = hrefAttribute && hrefAttribute !== '#' ? hrefAttribute.trim() : null\n }\n\n return selector ? selector.split(',').map(sel => parseSelector(sel)).join(',') : null\n}\n\nconst SelectorEngine = {\n find(selector, element = document.documentElement) {\n return [].concat(...Element.prototype.querySelectorAll.call(element, selector))\n },\n\n findOne(selector, element = document.documentElement) {\n return Element.prototype.querySelector.call(element, selector)\n },\n\n children(element, selector) {\n return [].concat(...element.children).filter(child => child.matches(selector))\n },\n\n parents(element, selector) {\n const parents = []\n let ancestor = element.parentNode.closest(selector)\n\n while (ancestor) {\n parents.push(ancestor)\n ancestor = ancestor.parentNode.closest(selector)\n }\n\n return parents\n },\n\n prev(element, selector) {\n let previous = element.previousElementSibling\n\n while (previous) {\n if (previous.matches(selector)) {\n return [previous]\n }\n\n previous = previous.previousElementSibling\n }\n\n return []\n },\n // TODO: this is now unused; remove later along with prev()\n next(element, selector) {\n let next = element.nextElementSibling\n\n while (next) {\n if (next.matches(selector)) {\n return [next]\n }\n\n next = next.nextElementSibling\n }\n\n return []\n },\n\n focusableChildren(element) {\n const focusables = [\n 'a',\n 'button',\n 'input',\n 'textarea',\n 'select',\n 'details',\n '[tabindex]',\n '[contenteditable=\"true\"]'\n ].map(selector => `${selector}:not([tabindex^=\"-\"])`).join(',')\n\n return this.find(focusables, element).filter(el => !isDisabled(el) && isVisible(el))\n },\n\n getSelectorFromElement(element) {\n const selector = getSelector(element)\n\n if (selector) {\n return SelectorEngine.findOne(selector) ? selector : null\n }\n\n return null\n },\n\n getElementFromSelector(element) {\n const selector = getSelector(element)\n\n return selector ? SelectorEngine.findOne(selector) : null\n },\n\n getMultipleElementsFromSelector(element) {\n const selector = getSelector(element)\n\n return selector ? SelectorEngine.find(selector) : []\n }\n}\n\nexport default SelectorEngine\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap tab.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport BaseComponent from './base-component.js'\nimport EventHandler from './dom/event-handler.js'\nimport SelectorEngine from './dom/selector-engine.js'\nimport { defineJQueryPlugin, getNextActiveElement, isDisabled } from './util/index.js'\n\n/**\n * Constants\n */\n\nconst NAME = 'tab'\nconst DATA_KEY = 'bs.tab'\nconst EVENT_KEY = `.${DATA_KEY}`\n\nconst EVENT_HIDE = `hide${EVENT_KEY}`\nconst EVENT_HIDDEN = `hidden${EVENT_KEY}`\nconst EVENT_SHOW = `show${EVENT_KEY}`\nconst EVENT_SHOWN = `shown${EVENT_KEY}`\nconst EVENT_CLICK_DATA_API = `click${EVENT_KEY}`\nconst EVENT_KEYDOWN = `keydown${EVENT_KEY}`\nconst EVENT_LOAD_DATA_API = `load${EVENT_KEY}`\n\nconst ARROW_LEFT_KEY = 'ArrowLeft'\nconst ARROW_RIGHT_KEY = 'ArrowRight'\nconst ARROW_UP_KEY = 'ArrowUp'\nconst ARROW_DOWN_KEY = 'ArrowDown'\nconst HOME_KEY = 'Home'\nconst END_KEY = 'End'\n\nconst CLASS_NAME_ACTIVE = 'active'\nconst CLASS_NAME_FADE = 'fade'\nconst CLASS_NAME_SHOW = 'show'\nconst CLASS_DROPDOWN = 'dropdown'\n\nconst SELECTOR_DROPDOWN_TOGGLE = '.dropdown-toggle'\nconst SELECTOR_DROPDOWN_MENU = '.dropdown-menu'\nconst NOT_SELECTOR_DROPDOWN_TOGGLE = `:not(${SELECTOR_DROPDOWN_TOGGLE})`\n\nconst SELECTOR_TAB_PANEL = '.list-group, .nav, [role=\"tablist\"]'\nconst SELECTOR_OUTER = '.nav-item, .list-group-item'\nconst SELECTOR_INNER = `.nav-link${NOT_SELECTOR_DROPDOWN_TOGGLE}, .list-group-item${NOT_SELECTOR_DROPDOWN_TOGGLE}, [role=\"tab\"]${NOT_SELECTOR_DROPDOWN_TOGGLE}`\nconst SELECTOR_DATA_TOGGLE = '[data-bs-toggle=\"tab\"], [data-bs-toggle=\"pill\"], [data-bs-toggle=\"list\"]' // TODO: could only be `tab` in v6\nconst SELECTOR_INNER_ELEM = `${SELECTOR_INNER}, ${SELECTOR_DATA_TOGGLE}`\n\nconst SELECTOR_DATA_TOGGLE_ACTIVE = `.${CLASS_NAME_ACTIVE}[data-bs-toggle=\"tab\"], .${CLASS_NAME_ACTIVE}[data-bs-toggle=\"pill\"], .${CLASS_NAME_ACTIVE}[data-bs-toggle=\"list\"]`\n\n/**\n * Class definition\n */\n\nclass Tab extends BaseComponent {\n constructor(element) {\n super(element)\n this._parent = this._element.closest(SELECTOR_TAB_PANEL)\n\n if (!this._parent) {\n return\n // TODO: should throw exception in v6\n // throw new TypeError(`${element.outerHTML} has not a valid parent ${SELECTOR_INNER_ELEM}`)\n }\n\n // Set up initial aria attributes\n this._setInitialAttributes(this._parent, this._getChildren())\n\n EventHandler.on(this._element, EVENT_KEYDOWN, event => this._keydown(event))\n }\n\n // Getters\n static get NAME() {\n return NAME\n }\n\n // Public\n show() { // Shows this elem and deactivate the active sibling if exists\n const innerElem = this._element\n if (this._elemIsActive(innerElem)) {\n return\n }\n\n // Search for active tab on same parent to deactivate it\n const active = this._getActiveElem()\n\n const hideEvent = active ?\n EventHandler.trigger(active, EVENT_HIDE, { relatedTarget: innerElem }) :\n null\n\n const showEvent = EventHandler.trigger(innerElem, EVENT_SHOW, { relatedTarget: active })\n\n if (showEvent.defaultPrevented || (hideEvent && hideEvent.defaultPrevented)) {\n return\n }\n\n this._deactivate(active, innerElem)\n this._activate(innerElem, active)\n }\n\n // Private\n _activate(element, relatedElem) {\n if (!element) {\n return\n }\n\n element.classList.add(CLASS_NAME_ACTIVE)\n\n this._activate(SelectorEngine.getElementFromSelector(element)) // Search and activate/show the proper section\n\n const complete = () => {\n if (element.getAttribute('role') !== 'tab') {\n element.classList.add(CLASS_NAME_SHOW)\n return\n }\n\n element.removeAttribute('tabindex')\n element.setAttribute('aria-selected', true)\n this._toggleDropDown(element, true)\n EventHandler.trigger(element, EVENT_SHOWN, {\n relatedTarget: relatedElem\n })\n }\n\n this._queueCallback(complete, element, element.classList.contains(CLASS_NAME_FADE))\n }\n\n _deactivate(element, relatedElem) {\n if (!element) {\n return\n }\n\n element.classList.remove(CLASS_NAME_ACTIVE)\n element.blur()\n\n this._deactivate(SelectorEngine.getElementFromSelector(element)) // Search and deactivate the shown section too\n\n const complete = () => {\n if (element.getAttribute('role') !== 'tab') {\n element.classList.remove(CLASS_NAME_SHOW)\n return\n }\n\n element.setAttribute('aria-selected', false)\n element.setAttribute('tabindex', '-1')\n this._toggleDropDown(element, false)\n EventHandler.trigger(element, EVENT_HIDDEN, { relatedTarget: relatedElem })\n }\n\n this._queueCallback(complete, element, element.classList.contains(CLASS_NAME_FADE))\n }\n\n _keydown(event) {\n if (!([ARROW_LEFT_KEY, ARROW_RIGHT_KEY, ARROW_UP_KEY, ARROW_DOWN_KEY, HOME_KEY, END_KEY].includes(event.key))) {\n return\n }\n\n event.stopPropagation()// stopPropagation/preventDefault both added to support up/down keys without scrolling the page\n event.preventDefault()\n\n const children = this._getChildren().filter(element => !isDisabled(element))\n let nextActiveElement\n\n if ([HOME_KEY, END_KEY].includes(event.key)) {\n nextActiveElement = children[event.key === HOME_KEY ? 0 : children.length - 1]\n } else {\n const isNext = [ARROW_RIGHT_KEY, ARROW_DOWN_KEY].includes(event.key)\n nextActiveElement = getNextActiveElement(children, event.target, isNext, true)\n }\n\n if (nextActiveElement) {\n nextActiveElement.focus({ preventScroll: true })\n Tab.getOrCreateInstance(nextActiveElement).show()\n }\n }\n\n _getChildren() { // collection of inner elements\n return SelectorEngine.find(SELECTOR_INNER_ELEM, this._parent)\n }\n\n _getActiveElem() {\n return this._getChildren().find(child => this._elemIsActive(child)) || null\n }\n\n _setInitialAttributes(parent, children) {\n this._setAttributeIfNotExists(parent, 'role', 'tablist')\n\n for (const child of children) {\n this._setInitialAttributesOnChild(child)\n }\n }\n\n _setInitialAttributesOnChild(child) {\n child = this._getInnerElement(child)\n const isActive = this._elemIsActive(child)\n const outerElem = this._getOuterElement(child)\n child.setAttribute('aria-selected', isActive)\n\n if (outerElem !== child) {\n this._setAttributeIfNotExists(outerElem, 'role', 'presentation')\n }\n\n if (!isActive) {\n child.setAttribute('tabindex', '-1')\n }\n\n this._setAttributeIfNotExists(child, 'role', 'tab')\n\n // set attributes to the related panel too\n this._setInitialAttributesOnTargetPanel(child)\n }\n\n _setInitialAttributesOnTargetPanel(child) {\n const target = SelectorEngine.getElementFromSelector(child)\n\n if (!target) {\n return\n }\n\n this._setAttributeIfNotExists(target, 'role', 'tabpanel')\n\n if (child.id) {\n this._setAttributeIfNotExists(target, 'aria-labelledby', `${child.id}`)\n }\n }\n\n _toggleDropDown(element, open) {\n const outerElem = this._getOuterElement(element)\n if (!outerElem.classList.contains(CLASS_DROPDOWN)) {\n return\n }\n\n const toggle = (selector, className) => {\n const element = SelectorEngine.findOne(selector, outerElem)\n if (element) {\n element.classList.toggle(className, open)\n }\n }\n\n toggle(SELECTOR_DROPDOWN_TOGGLE, CLASS_NAME_ACTIVE)\n toggle(SELECTOR_DROPDOWN_MENU, CLASS_NAME_SHOW)\n outerElem.setAttribute('aria-expanded', open)\n }\n\n _setAttributeIfNotExists(element, attribute, value) {\n if (!element.hasAttribute(attribute)) {\n element.setAttribute(attribute, value)\n }\n }\n\n _elemIsActive(elem) {\n return elem.classList.contains(CLASS_NAME_ACTIVE)\n }\n\n // Try to get the inner element (usually the .nav-link)\n _getInnerElement(elem) {\n return elem.matches(SELECTOR_INNER_ELEM) ? elem : SelectorEngine.findOne(SELECTOR_INNER_ELEM, elem)\n }\n\n // Try to get the outer element (usually the .nav-item)\n _getOuterElement(elem) {\n return elem.closest(SELECTOR_OUTER) || elem\n }\n\n // Static\n static jQueryInterface(config) {\n return this.each(function () {\n const data = Tab.getOrCreateInstance(this)\n\n if (typeof config !== 'string') {\n return\n }\n\n if (data[config] === undefined || config.startsWith('_') || config === 'constructor') {\n throw new TypeError(`No method named \"${config}\"`)\n }\n\n data[config]()\n })\n }\n}\n\n/**\n * Data API implementation\n */\n\nEventHandler.on(document, EVENT_CLICK_DATA_API, SELECTOR_DATA_TOGGLE, function (event) {\n if (['A', 'AREA'].includes(this.tagName)) {\n event.preventDefault()\n }\n\n if (isDisabled(this)) {\n return\n }\n\n Tab.getOrCreateInstance(this).show()\n})\n\n/**\n * Initialize on focus\n */\nEventHandler.on(window, EVENT_LOAD_DATA_API, () => {\n for (const element of SelectorEngine.find(SELECTOR_DATA_TOGGLE_ACTIVE)) {\n Tab.getOrCreateInstance(element)\n }\n})\n/**\n * jQuery\n */\n\ndefineJQueryPlugin(Tab)\n\nexport default Tab\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap util/backdrop.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport EventHandler from '../dom/event-handler.js'\nimport Config from './config.js'\nimport {\n execute, executeAfterTransition, getElement, reflow\n} from './index.js'\n\n/**\n * Constants\n */\n\nconst NAME = 'backdrop'\nconst CLASS_NAME_FADE = 'fade'\nconst CLASS_NAME_SHOW = 'show'\nconst EVENT_MOUSEDOWN = `mousedown.bs.${NAME}`\n\nconst Default = {\n className: 'modal-backdrop',\n clickCallback: null,\n isAnimated: false,\n isVisible: true, // if false, we use the backdrop helper without adding any element to the dom\n rootElement: 'body' // give the choice to place backdrop under different elements\n}\n\nconst DefaultType = {\n className: 'string',\n clickCallback: '(function|null)',\n isAnimated: 'boolean',\n isVisible: 'boolean',\n rootElement: '(element|string)'\n}\n\n/**\n * Class definition\n */\n\nclass Backdrop extends Config {\n constructor(config) {\n super()\n this._config = this._getConfig(config)\n this._isAppended = false\n this._element = null\n }\n\n // Getters\n static get Default() {\n return Default\n }\n\n static get DefaultType() {\n return DefaultType\n }\n\n static get NAME() {\n return NAME\n }\n\n // Public\n show(callback) {\n if (!this._config.isVisible) {\n execute(callback)\n return\n }\n\n this._append()\n\n const element = this._getElement()\n if (this._config.isAnimated) {\n reflow(element)\n }\n\n element.classList.add(CLASS_NAME_SHOW)\n\n this._emulateAnimation(() => {\n execute(callback)\n })\n }\n\n hide(callback) {\n if (!this._config.isVisible) {\n execute(callback)\n return\n }\n\n this._getElement().classList.remove(CLASS_NAME_SHOW)\n\n this._emulateAnimation(() => {\n this.dispose()\n execute(callback)\n })\n }\n\n dispose() {\n if (!this._isAppended) {\n return\n }\n\n EventHandler.off(this._element, EVENT_MOUSEDOWN)\n\n this._element.remove()\n this._isAppended = false\n }\n\n // Private\n _getElement() {\n if (!this._element) {\n const backdrop = document.createElement('div')\n backdrop.className = this._config.className\n if (this._config.isAnimated) {\n backdrop.classList.add(CLASS_NAME_FADE)\n }\n\n this._element = backdrop\n }\n\n return this._element\n }\n\n _configAfterMerge(config) {\n // use getElement() with the default \"body\" to get a fresh Element on each instantiation\n config.rootElement = getElement(config.rootElement)\n return config\n }\n\n _append() {\n if (this._isAppended) {\n return\n }\n\n const element = this._getElement()\n this._config.rootElement.append(element)\n\n EventHandler.on(element, EVENT_MOUSEDOWN, () => {\n execute(this._config.clickCallback)\n })\n\n this._isAppended = true\n }\n\n _emulateAnimation(callback) {\n executeAfterTransition(callback, this._getElement(), this._config.isAnimated)\n }\n}\n\nexport default Backdrop\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap util/component-functions.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport EventHandler from '../dom/event-handler.js'\nimport SelectorEngine from '../dom/selector-engine.js'\nimport { isDisabled } from './index.js'\n\nconst enableDismissTrigger = (component, method = 'hide') => {\n const clickEvent = `click.dismiss${component.EVENT_KEY}`\n const name = component.NAME\n\n EventHandler.on(document, clickEvent, `[data-bs-dismiss=\"${name}\"]`, function (event) {\n if (['A', 'AREA'].includes(this.tagName)) {\n event.preventDefault()\n }\n\n if (isDisabled(this)) {\n return\n }\n\n const target = SelectorEngine.getElementFromSelector(this) || this.closest(`.${name}`)\n const instance = component.getOrCreateInstance(target)\n\n // Method argument is left, for Alert and only, as it doesn't implement the 'hide' method\n instance[method]()\n })\n}\n\nexport {\n enableDismissTrigger\n}\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap util/focustrap.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport EventHandler from '../dom/event-handler.js'\nimport SelectorEngine from '../dom/selector-engine.js'\nimport Config from './config.js'\n\n/**\n * Constants\n */\n\nconst NAME = 'focustrap'\nconst DATA_KEY = 'bs.focustrap'\nconst EVENT_KEY = `.${DATA_KEY}`\nconst EVENT_FOCUSIN = `focusin${EVENT_KEY}`\nconst EVENT_KEYDOWN_TAB = `keydown.tab${EVENT_KEY}`\n\nconst TAB_KEY = 'Tab'\nconst TAB_NAV_FORWARD = 'forward'\nconst TAB_NAV_BACKWARD = 'backward'\n\nconst Default = {\n autofocus: true,\n trapElement: null // The element to trap focus inside of\n}\n\nconst DefaultType = {\n autofocus: 'boolean',\n trapElement: 'element'\n}\n\n/**\n * Class definition\n */\n\nclass FocusTrap extends Config {\n constructor(config) {\n super()\n this._config = this._getConfig(config)\n this._isActive = false\n this._lastTabNavDirection = null\n }\n\n // Getters\n static get Default() {\n return Default\n }\n\n static get DefaultType() {\n return DefaultType\n }\n\n static get NAME() {\n return NAME\n }\n\n // Public\n activate() {\n if (this._isActive) {\n return\n }\n\n if (this._config.autofocus) {\n this._config.trapElement.focus()\n }\n\n EventHandler.off(document, EVENT_KEY) // guard against infinite focus loop\n EventHandler.on(document, EVENT_FOCUSIN, event => this._handleFocusin(event))\n EventHandler.on(document, EVENT_KEYDOWN_TAB, event => this._handleKeydown(event))\n\n this._isActive = true\n }\n\n deactivate() {\n if (!this._isActive) {\n return\n }\n\n this._isActive = false\n EventHandler.off(document, EVENT_KEY)\n }\n\n // Private\n _handleFocusin(event) {\n const { trapElement } = this._config\n\n if (event.target === document || event.target === trapElement || trapElement.contains(event.target)) {\n return\n }\n\n const elements = SelectorEngine.focusableChildren(trapElement)\n\n if (elements.length === 0) {\n trapElement.focus()\n } else if (this._lastTabNavDirection === TAB_NAV_BACKWARD) {\n elements[elements.length - 1].focus()\n } else {\n elements[0].focus()\n }\n }\n\n _handleKeydown(event) {\n if (event.key !== TAB_KEY) {\n return\n }\n\n this._lastTabNavDirection = event.shiftKey ? TAB_NAV_BACKWARD : TAB_NAV_FORWARD\n }\n}\n\nexport default FocusTrap\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap util/scrollBar.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport Manipulator from '../dom/manipulator.js'\nimport SelectorEngine from '../dom/selector-engine.js'\nimport { isElement } from './index.js'\n\n/**\n * Constants\n */\n\nconst SELECTOR_FIXED_CONTENT = '.fixed-top, .fixed-bottom, .is-fixed, .sticky-top'\nconst SELECTOR_STICKY_CONTENT = '.sticky-top'\nconst PROPERTY_PADDING = 'padding-right'\nconst PROPERTY_MARGIN = 'margin-right'\n\n/**\n * Class definition\n */\n\nclass ScrollBarHelper {\n constructor() {\n this._element = document.body\n }\n\n // Public\n getWidth() {\n // https://developer.mozilla.org/en-US/docs/Web/API/Window/innerWidth#usage_notes\n const documentWidth = document.documentElement.clientWidth\n return Math.abs(window.innerWidth - documentWidth)\n }\n\n hide() {\n const width = this.getWidth()\n this._disableOverFlow()\n // give padding to element to balance the hidden scrollbar width\n this._setElementAttributes(this._element, PROPERTY_PADDING, calculatedValue => calculatedValue + width)\n // trick: We adjust positive paddingRight and negative marginRight to sticky-top elements to keep showing fullwidth\n this._setElementAttributes(SELECTOR_FIXED_CONTENT, PROPERTY_PADDING, calculatedValue => calculatedValue + width)\n this._setElementAttributes(SELECTOR_STICKY_CONTENT, PROPERTY_MARGIN, calculatedValue => calculatedValue - width)\n }\n\n reset() {\n this._resetElementAttributes(this._element, 'overflow')\n this._resetElementAttributes(this._element, PROPERTY_PADDING)\n this._resetElementAttributes(SELECTOR_FIXED_CONTENT, PROPERTY_PADDING)\n this._resetElementAttributes(SELECTOR_STICKY_CONTENT, PROPERTY_MARGIN)\n }\n\n isOverflowing() {\n return this.getWidth() > 0\n }\n\n // Private\n _disableOverFlow() {\n this._saveInitialAttribute(this._element, 'overflow')\n this._element.style.overflow = 'hidden'\n }\n\n _setElementAttributes(selector, styleProperty, callback) {\n const scrollbarWidth = this.getWidth()\n const manipulationCallBack = element => {\n if (element !== this._element && window.innerWidth > element.clientWidth + scrollbarWidth) {\n return\n }\n\n this._saveInitialAttribute(element, styleProperty)\n const calculatedValue = window.getComputedStyle(element).getPropertyValue(styleProperty)\n element.style.setProperty(styleProperty, `${callback(Number.parseFloat(calculatedValue))}px`)\n }\n\n this._applyManipulationCallback(selector, manipulationCallBack)\n }\n\n _saveInitialAttribute(element, styleProperty) {\n const actualValue = element.style.getPropertyValue(styleProperty)\n if (actualValue) {\n Manipulator.setDataAttribute(element, styleProperty, actualValue)\n }\n }\n\n _resetElementAttributes(selector, styleProperty) {\n const manipulationCallBack = element => {\n const value = Manipulator.getDataAttribute(element, styleProperty)\n // We only want to remove the property if the value is `null`; the value can also be zero\n if (value === null) {\n element.style.removeProperty(styleProperty)\n return\n }\n\n Manipulator.removeDataAttribute(element, styleProperty)\n element.style.setProperty(styleProperty, value)\n }\n\n this._applyManipulationCallback(selector, manipulationCallBack)\n }\n\n _applyManipulationCallback(selector, callBack) {\n if (isElement(selector)) {\n callBack(selector)\n return\n }\n\n for (const sel of SelectorEngine.find(selector, this._element)) {\n callBack(sel)\n }\n }\n}\n\nexport default ScrollBarHelper\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap modal.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport BaseComponent from './base-component.js'\nimport EventHandler from './dom/event-handler.js'\nimport SelectorEngine from './dom/selector-engine.js'\nimport Backdrop from './util/backdrop.js'\nimport { enableDismissTrigger } from './util/component-functions.js'\nimport FocusTrap from './util/focustrap.js'\nimport {\n defineJQueryPlugin, isRTL, isVisible, reflow\n} from './util/index.js'\nimport ScrollBarHelper from './util/scrollbar.js'\n\n/**\n * Constants\n */\n\nconst NAME = 'modal'\nconst DATA_KEY = 'bs.modal'\nconst EVENT_KEY = `.${DATA_KEY}`\nconst DATA_API_KEY = '.data-api'\nconst ESCAPE_KEY = 'Escape'\n\nconst EVENT_HIDE = `hide${EVENT_KEY}`\nconst EVENT_HIDE_PREVENTED = `hidePrevented${EVENT_KEY}`\nconst EVENT_HIDDEN = `hidden${EVENT_KEY}`\nconst EVENT_SHOW = `show${EVENT_KEY}`\nconst EVENT_SHOWN = `shown${EVENT_KEY}`\nconst EVENT_RESIZE = `resize${EVENT_KEY}`\nconst EVENT_CLICK_DISMISS = `click.dismiss${EVENT_KEY}`\nconst EVENT_MOUSEDOWN_DISMISS = `mousedown.dismiss${EVENT_KEY}`\nconst EVENT_KEYDOWN_DISMISS = `keydown.dismiss${EVENT_KEY}`\nconst EVENT_CLICK_DATA_API = `click${EVENT_KEY}${DATA_API_KEY}`\n\nconst CLASS_NAME_OPEN = 'modal-open'\nconst CLASS_NAME_FADE = 'fade'\nconst CLASS_NAME_SHOW = 'show'\nconst CLASS_NAME_STATIC = 'modal-static'\n\nconst OPEN_SELECTOR = '.modal.show'\nconst SELECTOR_DIALOG = '.modal-dialog'\nconst SELECTOR_MODAL_BODY = '.modal-body'\nconst SELECTOR_DATA_TOGGLE = '[data-bs-toggle=\"modal\"]'\n\nconst Default = {\n backdrop: true,\n focus: true,\n keyboard: true\n}\n\nconst DefaultType = {\n backdrop: '(boolean|string)',\n focus: 'boolean',\n keyboard: 'boolean'\n}\n\n/**\n * Class definition\n */\n\nclass Modal extends BaseComponent {\n constructor(element, config) {\n super(element, config)\n\n this._dialog = SelectorEngine.findOne(SELECTOR_DIALOG, this._element)\n this._backdrop = this._initializeBackDrop()\n this._focustrap = this._initializeFocusTrap()\n this._isShown = false\n this._isTransitioning = false\n this._scrollBar = new ScrollBarHelper()\n\n this._addEventListeners()\n }\n\n // Getters\n static get Default() {\n return Default\n }\n\n static get DefaultType() {\n return DefaultType\n }\n\n static get NAME() {\n return NAME\n }\n\n // Public\n toggle(relatedTarget) {\n return this._isShown ? this.hide() : this.show(relatedTarget)\n }\n\n show(relatedTarget) {\n if (this._isShown || this._isTransitioning) {\n return\n }\n\n const showEvent = EventHandler.trigger(this._element, EVENT_SHOW, {\n relatedTarget\n })\n\n if (showEvent.defaultPrevented) {\n return\n }\n\n this._isShown = true\n this._isTransitioning = true\n\n this._scrollBar.hide()\n\n document.body.classList.add(CLASS_NAME_OPEN)\n\n this._adjustDialog()\n\n this._backdrop.show(() => this._showElement(relatedTarget))\n }\n\n hide() {\n if (!this._isShown || this._isTransitioning) {\n return\n }\n\n const hideEvent = EventHandler.trigger(this._element, EVENT_HIDE)\n\n if (hideEvent.defaultPrevented) {\n return\n }\n\n this._isShown = false\n this._isTransitioning = true\n this._focustrap.deactivate()\n\n this._element.classList.remove(CLASS_NAME_SHOW)\n\n this._queueCallback(() => this._hideModal(), this._element, this._isAnimated())\n }\n\n dispose() {\n EventHandler.off(window, EVENT_KEY)\n EventHandler.off(this._dialog, EVENT_KEY)\n\n this._backdrop.dispose()\n this._focustrap.deactivate()\n\n super.dispose()\n }\n\n handleUpdate() {\n this._adjustDialog()\n }\n\n // Private\n _initializeBackDrop() {\n return new Backdrop({\n isVisible: Boolean(this._config.backdrop), // 'static' option will be translated to true, and booleans will keep their value,\n isAnimated: this._isAnimated()\n })\n }\n\n _initializeFocusTrap() {\n return new FocusTrap({\n trapElement: this._element\n })\n }\n\n _showElement(relatedTarget) {\n // try to append dynamic modal\n if (!document.body.contains(this._element)) {\n document.body.append(this._element)\n }\n\n this._element.style.display = 'block'\n this._element.removeAttribute('aria-hidden')\n this._element.setAttribute('aria-modal', true)\n this._element.setAttribute('role', 'dialog')\n this._element.scrollTop = 0\n\n const modalBody = SelectorEngine.findOne(SELECTOR_MODAL_BODY, this._dialog)\n if (modalBody) {\n modalBody.scrollTop = 0\n }\n\n reflow(this._element)\n\n this._element.classList.add(CLASS_NAME_SHOW)\n\n const transitionComplete = () => {\n if (this._config.focus) {\n this._focustrap.activate()\n }\n\n this._isTransitioning = false\n EventHandler.trigger(this._element, EVENT_SHOWN, {\n relatedTarget\n })\n }\n\n this._queueCallback(transitionComplete, this._dialog, this._isAnimated())\n }\n\n _addEventListeners() {\n EventHandler.on(this._element, EVENT_KEYDOWN_DISMISS, event => {\n if (event.key !== ESCAPE_KEY) {\n return\n }\n\n if (this._config.keyboard) {\n this.hide()\n return\n }\n\n this._triggerBackdropTransition()\n })\n\n EventHandler.on(window, EVENT_RESIZE, () => {\n if (this._isShown && !this._isTransitioning) {\n this._adjustDialog()\n }\n })\n\n EventHandler.on(this._element, EVENT_MOUSEDOWN_DISMISS, event => {\n // a bad trick to segregate clicks that may start inside dialog but end outside, and avoid listen to scrollbar clicks\n EventHandler.one(this._element, EVENT_CLICK_DISMISS, event2 => {\n if (this._element !== event.target || this._element !== event2.target) {\n return\n }\n\n if (this._config.backdrop === 'static') {\n this._triggerBackdropTransition()\n return\n }\n\n if (this._config.backdrop) {\n this.hide()\n }\n })\n })\n }\n\n _hideModal() {\n this._element.style.display = 'none'\n this._element.setAttribute('aria-hidden', true)\n this._element.removeAttribute('aria-modal')\n this._element.removeAttribute('role')\n this._isTransitioning = false\n\n this._backdrop.hide(() => {\n document.body.classList.remove(CLASS_NAME_OPEN)\n this._resetAdjustments()\n this._scrollBar.reset()\n EventHandler.trigger(this._element, EVENT_HIDDEN)\n })\n }\n\n _isAnimated() {\n return this._element.classList.contains(CLASS_NAME_FADE)\n }\n\n _triggerBackdropTransition() {\n const hideEvent = EventHandler.trigger(this._element, EVENT_HIDE_PREVENTED)\n if (hideEvent.defaultPrevented) {\n return\n }\n\n const isModalOverflowing = this._element.scrollHeight > document.documentElement.clientHeight\n const initialOverflowY = this._element.style.overflowY\n // return if the following background transition hasn't yet completed\n if (initialOverflowY === 'hidden' || this._element.classList.contains(CLASS_NAME_STATIC)) {\n return\n }\n\n if (!isModalOverflowing) {\n this._element.style.overflowY = 'hidden'\n }\n\n this._element.classList.add(CLASS_NAME_STATIC)\n this._queueCallback(() => {\n this._element.classList.remove(CLASS_NAME_STATIC)\n this._queueCallback(() => {\n this._element.style.overflowY = initialOverflowY\n }, this._dialog)\n }, this._dialog)\n\n this._element.focus()\n }\n\n /**\n * The following methods are used to handle overflowing modals\n */\n\n _adjustDialog() {\n const isModalOverflowing = this._element.scrollHeight > document.documentElement.clientHeight\n const scrollbarWidth = this._scrollBar.getWidth()\n const isBodyOverflowing = scrollbarWidth > 0\n\n if (isBodyOverflowing && !isModalOverflowing) {\n const property = isRTL() ? 'paddingLeft' : 'paddingRight'\n this._element.style[property] = `${scrollbarWidth}px`\n }\n\n if (!isBodyOverflowing && isModalOverflowing) {\n const property = isRTL() ? 'paddingRight' : 'paddingLeft'\n this._element.style[property] = `${scrollbarWidth}px`\n }\n }\n\n _resetAdjustments() {\n this._element.style.paddingLeft = ''\n this._element.style.paddingRight = ''\n }\n\n // Static\n static jQueryInterface(config, relatedTarget) {\n return this.each(function () {\n const data = Modal.getOrCreateInstance(this, config)\n\n if (typeof config !== 'string') {\n return\n }\n\n if (typeof data[config] === 'undefined') {\n throw new TypeError(`No method named \"${config}\"`)\n }\n\n data[config](relatedTarget)\n })\n }\n}\n\n/**\n * Data API implementation\n */\n\nEventHandler.on(document, EVENT_CLICK_DATA_API, SELECTOR_DATA_TOGGLE, function (event) {\n const target = SelectorEngine.getElementFromSelector(this)\n\n if (['A', 'AREA'].includes(this.tagName)) {\n event.preventDefault()\n }\n\n EventHandler.one(target, EVENT_SHOW, showEvent => {\n if (showEvent.defaultPrevented) {\n // only register focus restorer if modal will actually get shown\n return\n }\n\n EventHandler.one(target, EVENT_HIDDEN, () => {\n if (isVisible(this)) {\n this.focus()\n }\n })\n })\n\n // avoid conflict when clicking modal toggler while another one is open\n const alreadyOpen = SelectorEngine.findOne(OPEN_SELECTOR)\n if (alreadyOpen) {\n Modal.getInstance(alreadyOpen).hide()\n }\n\n const data = Modal.getOrCreateInstance(target)\n\n data.toggle(this)\n})\n\nenableDismissTrigger(Modal)\n\n/**\n * jQuery\n */\n\ndefineJQueryPlugin(Modal)\n\nexport default Modal\n","/**\n * Common utilities\n * @module glMatrix\n */\n\n// Configuration Constants\nexport var EPSILON = 0.000001;\nexport var ARRAY_TYPE = typeof Float32Array !== \"undefined\" ? Float32Array : Array;\nexport var RANDOM = Math.random;\nexport var ANGLE_ORDER = \"zyx\";\n\n/**\n * Symmetric round\n * see https://www.npmjs.com/package/round-half-up-symmetric#user-content-detailed-background\n *\n * @param {Number} a value to round\n */\nexport function round(a) {\n if (a >= 0) return Math.round(a);\n return a % 0.5 === 0 ? Math.floor(a) : Math.round(a);\n}\n\n/**\n * Sets the type of array used when creating new vectors and matrices\n *\n * @param {Float32ArrayConstructor | ArrayConstructor} type Array type, such as Float32Array or Array\n */\nexport function setMatrixArrayType(type) {\n ARRAY_TYPE = type;\n}\nvar degree = Math.PI / 180;\nvar radian = 180 / Math.PI;\n\n/**\n * Convert Degree To Radian\n *\n * @param {Number} a Angle in Degrees\n */\nexport function toRadian(a) {\n return a * degree;\n}\n\n/**\n * Convert Radian To Degree\n *\n * @param {Number} a Angle in Radians\n */\nexport function toDegree(a) {\n return a * radian;\n}\n\n/**\n * Tests whether or not the arguments have approximately the same value, within an absolute\n * or relative tolerance of glMatrix.EPSILON (an absolute tolerance is used for values less\n * than or equal to 1.0, and a relative tolerance is used for larger values)\n *\n * @param {Number} a The first number to test.\n * @param {Number} b The second number to test.\n * @param {Number} tolerance Absolute or relative tolerance (default glMatrix.EPSILON)\n * @returns {Boolean} True if the numbers are approximately equal, false otherwise.\n */\nexport function equals(a, b) {\n var tolerance = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : EPSILON;\n return Math.abs(a - b) <= tolerance * Math.max(1, Math.abs(a), Math.abs(b));\n}","import * as glMatrix from \"./common.js\";\n\n/**\n * 2x2 Matrix\n * @module mat2\n */\n\n/**\n * Creates a new identity mat2\n *\n * @returns {mat2} a new 2x2 matrix\n */\nexport function create() {\n var out = new glMatrix.ARRAY_TYPE(4);\n if (glMatrix.ARRAY_TYPE != Float32Array) {\n out[1] = 0;\n out[2] = 0;\n }\n out[0] = 1;\n out[3] = 1;\n return out;\n}\n\n/**\n * Creates a new mat2 initialized with values from an existing matrix\n *\n * @param {ReadonlyMat2} a matrix to clone\n * @returns {mat2} a new 2x2 matrix\n */\nexport function clone(a) {\n var out = new glMatrix.ARRAY_TYPE(4);\n out[0] = a[0];\n out[1] = a[1];\n out[2] = a[2];\n out[3] = a[3];\n return out;\n}\n\n/**\n * Copy the values from one mat2 to another\n *\n * @param {mat2} out the receiving matrix\n * @param {ReadonlyMat2} a the source matrix\n * @returns {mat2} out\n */\nexport function copy(out, a) {\n out[0] = a[0];\n out[1] = a[1];\n out[2] = a[2];\n out[3] = a[3];\n return out;\n}\n\n/**\n * Set a mat2 to the identity matrix\n *\n * @param {mat2} out the receiving matrix\n * @returns {mat2} out\n */\nexport function identity(out) {\n out[0] = 1;\n out[1] = 0;\n out[2] = 0;\n out[3] = 1;\n return out;\n}\n\n/**\n * Create a new mat2 with the given values\n *\n * @param {Number} m00 Component in column 0, row 0 position (index 0)\n * @param {Number} m01 Component in column 0, row 1 position (index 1)\n * @param {Number} m10 Component in column 1, row 0 position (index 2)\n * @param {Number} m11 Component in column 1, row 1 position (index 3)\n * @returns {mat2} out A new 2x2 matrix\n */\nexport function fromValues(m00, m01, m10, m11) {\n var out = new glMatrix.ARRAY_TYPE(4);\n out[0] = m00;\n out[1] = m01;\n out[2] = m10;\n out[3] = m11;\n return out;\n}\n\n/**\n * Set the components of a mat2 to the given values\n *\n * @param {mat2} out the receiving matrix\n * @param {Number} m00 Component in column 0, row 0 position (index 0)\n * @param {Number} m01 Component in column 0, row 1 position (index 1)\n * @param {Number} m10 Component in column 1, row 0 position (index 2)\n * @param {Number} m11 Component in column 1, row 1 position (index 3)\n * @returns {mat2} out\n */\nexport function set(out, m00, m01, m10, m11) {\n out[0] = m00;\n out[1] = m01;\n out[2] = m10;\n out[3] = m11;\n return out;\n}\n\n/**\n * Transpose the values of a mat2\n *\n * @param {mat2} out the receiving matrix\n * @param {ReadonlyMat2} a the source matrix\n * @returns {mat2} out\n */\nexport function transpose(out, a) {\n // If we are transposing ourselves we can skip a few steps but have to cache\n // some values\n if (out === a) {\n var a1 = a[1];\n out[1] = a[2];\n out[2] = a1;\n } else {\n out[0] = a[0];\n out[1] = a[2];\n out[2] = a[1];\n out[3] = a[3];\n }\n return out;\n}\n\n/**\n * Inverts a mat2\n *\n * @param {mat2} out the receiving matrix\n * @param {ReadonlyMat2} a the source matrix\n * @returns {mat2 | null} out, or null if source matrix is not invertible\n */\nexport function invert(out, a) {\n var a0 = a[0],\n a1 = a[1],\n a2 = a[2],\n a3 = a[3];\n\n // Calculate the determinant\n var det = a0 * a3 - a2 * a1;\n if (!det) {\n return null;\n }\n det = 1.0 / det;\n out[0] = a3 * det;\n out[1] = -a1 * det;\n out[2] = -a2 * det;\n out[3] = a0 * det;\n return out;\n}\n\n/**\n * Calculates the adjugate of a mat2\n *\n * @param {mat2} out the receiving matrix\n * @param {ReadonlyMat2} a the source matrix\n * @returns {mat2} out\n */\nexport function adjoint(out, a) {\n // Caching this value is necessary if out == a\n var a0 = a[0];\n out[0] = a[3];\n out[1] = -a[1];\n out[2] = -a[2];\n out[3] = a0;\n return out;\n}\n\n/**\n * Calculates the determinant of a mat2\n *\n * @param {ReadonlyMat2} a the source matrix\n * @returns {Number} determinant of a\n */\nexport function determinant(a) {\n return a[0] * a[3] - a[2] * a[1];\n}\n\n/**\n * Multiplies two mat2's\n *\n * @param {mat2} out the receiving matrix\n * @param {ReadonlyMat2} a the first operand\n * @param {ReadonlyMat2} b the second operand\n * @returns {mat2} out\n */\nexport function multiply(out, a, b) {\n var a0 = a[0],\n a1 = a[1],\n a2 = a[2],\n a3 = a[3];\n var b0 = b[0],\n b1 = b[1],\n b2 = b[2],\n b3 = b[3];\n out[0] = a0 * b0 + a2 * b1;\n out[1] = a1 * b0 + a3 * b1;\n out[2] = a0 * b2 + a2 * b3;\n out[3] = a1 * b2 + a3 * b3;\n return out;\n}\n\n/**\n * Rotates a mat2 by the given angle\n *\n * @param {mat2} out the receiving matrix\n * @param {ReadonlyMat2} a the matrix to rotate\n * @param {Number} rad the angle to rotate the matrix by\n * @returns {mat2} out\n */\nexport function rotate(out, a, rad) {\n var a0 = a[0],\n a1 = a[1],\n a2 = a[2],\n a3 = a[3];\n var s = Math.sin(rad);\n var c = Math.cos(rad);\n out[0] = a0 * c + a2 * s;\n out[1] = a1 * c + a3 * s;\n out[2] = a0 * -s + a2 * c;\n out[3] = a1 * -s + a3 * c;\n return out;\n}\n\n/**\n * Scales the mat2 by the dimensions in the given vec2\n *\n * @param {mat2} out the receiving matrix\n * @param {ReadonlyMat2} a the matrix to rotate\n * @param {ReadonlyVec2} v the vec2 to scale the matrix by\n * @returns {mat2} out\n **/\nexport function scale(out, a, v) {\n var a0 = a[0],\n a1 = a[1],\n a2 = a[2],\n a3 = a[3];\n var v0 = v[0],\n v1 = v[1];\n out[0] = a0 * v0;\n out[1] = a1 * v0;\n out[2] = a2 * v1;\n out[3] = a3 * v1;\n return out;\n}\n\n/**\n * Creates a matrix from a given angle\n * This is equivalent to (but much faster than):\n *\n * mat2.identity(dest);\n * mat2.rotate(dest, dest, rad);\n *\n * @param {mat2} out mat2 receiving operation result\n * @param {Number} rad the angle to rotate the matrix by\n * @returns {mat2} out\n */\nexport function fromRotation(out, rad) {\n var s = Math.sin(rad);\n var c = Math.cos(rad);\n out[0] = c;\n out[1] = s;\n out[2] = -s;\n out[3] = c;\n return out;\n}\n\n/**\n * Creates a matrix from a vector scaling\n * This is equivalent to (but much faster than):\n *\n * mat2.identity(dest);\n * mat2.scale(dest, dest, vec);\n *\n * @param {mat2} out mat2 receiving operation result\n * @param {ReadonlyVec2} v Scaling vector\n * @returns {mat2} out\n */\nexport function fromScaling(out, v) {\n out[0] = v[0];\n out[1] = 0;\n out[2] = 0;\n out[3] = v[1];\n return out;\n}\n\n/**\n * Returns a string representation of a mat2\n *\n * @param {ReadonlyMat2} a matrix to represent as a string\n * @returns {String} string representation of the matrix\n */\nexport function str(a) {\n return \"mat2(\" + a[0] + \", \" + a[1] + \", \" + a[2] + \", \" + a[3] + \")\";\n}\n\n/**\n * Returns Frobenius norm of a mat2\n *\n * @param {ReadonlyMat2} a the matrix to calculate Frobenius norm of\n * @returns {Number} Frobenius norm\n */\nexport function frob(a) {\n return Math.sqrt(a[0] * a[0] + a[1] * a[1] + a[2] * a[2] + a[3] * a[3]);\n}\n\n/**\n * Returns L, D and U matrices (Lower triangular, Diagonal and Upper triangular) by factorizing the input matrix\n * @param {ReadonlyMat2} L the lower triangular matrix\n * @param {ReadonlyMat2} D the diagonal matrix\n * @param {ReadonlyMat2} U the upper triangular matrix\n * @param {ReadonlyMat2} a the input matrix to factorize\n */\n\nexport function LDU(L, D, U, a) {\n L[2] = a[2] / a[0];\n U[0] = a[0];\n U[1] = a[1];\n U[3] = a[3] - L[2] * U[1];\n return [L, D, U];\n}\n\n/**\n * Adds two mat2's\n *\n * @param {mat2} out the receiving matrix\n * @param {ReadonlyMat2} a the first operand\n * @param {ReadonlyMat2} b the second operand\n * @returns {mat2} out\n */\nexport function add(out, a, b) {\n out[0] = a[0] + b[0];\n out[1] = a[1] + b[1];\n out[2] = a[2] + b[2];\n out[3] = a[3] + b[3];\n return out;\n}\n\n/**\n * Subtracts matrix b from matrix a\n *\n * @param {mat2} out the receiving matrix\n * @param {ReadonlyMat2} a the first operand\n * @param {ReadonlyMat2} b the second operand\n * @returns {mat2} out\n */\nexport function subtract(out, a, b) {\n out[0] = a[0] - b[0];\n out[1] = a[1] - b[1];\n out[2] = a[2] - b[2];\n out[3] = a[3] - b[3];\n return out;\n}\n\n/**\n * Returns whether or not the matrices have exactly the same elements in the same position (when compared with ===)\n *\n * @param {ReadonlyMat2} a The first matrix.\n * @param {ReadonlyMat2} b The second matrix.\n * @returns {Boolean} True if the matrices are equal, false otherwise.\n */\nexport function exactEquals(a, b) {\n return a[0] === b[0] && a[1] === b[1] && a[2] === b[2] && a[3] === b[3];\n}\n\n/**\n * Returns whether or not the matrices have approximately the same elements in the same position.\n *\n * @param {ReadonlyMat2} a The first matrix.\n * @param {ReadonlyMat2} b The second matrix.\n * @returns {Boolean} True if the matrices are equal, false otherwise.\n */\nexport function equals(a, b) {\n var a0 = a[0],\n a1 = a[1],\n a2 = a[2],\n a3 = a[3];\n var b0 = b[0],\n b1 = b[1],\n b2 = b[2],\n b3 = b[3];\n return Math.abs(a0 - b0) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1)) && Math.abs(a2 - b2) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a2), Math.abs(b2)) && Math.abs(a3 - b3) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a3), Math.abs(b3));\n}\n\n/**\n * Multiply each element of the matrix by a scalar.\n *\n * @param {mat2} out the receiving matrix\n * @param {ReadonlyMat2} a the matrix to scale\n * @param {Number} b amount to scale the matrix's elements by\n * @returns {mat2} out\n */\nexport function multiplyScalar(out, a, b) {\n out[0] = a[0] * b;\n out[1] = a[1] * b;\n out[2] = a[2] * b;\n out[3] = a[3] * b;\n return out;\n}\n\n/**\n * Adds two mat2's after multiplying each element of the second operand by a scalar value.\n *\n * @param {mat2} out the receiving vector\n * @param {ReadonlyMat2} a the first operand\n * @param {ReadonlyMat2} b the second operand\n * @param {Number} scale the amount to scale b's elements by before adding\n * @returns {mat2} out\n */\nexport function multiplyScalarAndAdd(out, a, b, scale) {\n out[0] = a[0] + b[0] * scale;\n out[1] = a[1] + b[1] * scale;\n out[2] = a[2] + b[2] * scale;\n out[3] = a[3] + b[3] * scale;\n return out;\n}\n\n/**\n * Alias for {@link mat2.multiply}\n * @function\n */\nexport var mul = multiply;\n\n/**\n * Alias for {@link mat2.subtract}\n * @function\n */\nexport var sub = subtract;","import * as glMatrix from \"./common.js\";\n\n/**\n * 3x3 Matrix\n * @module mat3\n */\n\n/**\n * Creates a new identity mat3\n *\n * @returns {mat3} a new 3x3 matrix\n */\nexport function create() {\n var out = new glMatrix.ARRAY_TYPE(9);\n if (glMatrix.ARRAY_TYPE != Float32Array) {\n out[1] = 0;\n out[2] = 0;\n out[3] = 0;\n out[5] = 0;\n out[6] = 0;\n out[7] = 0;\n }\n out[0] = 1;\n out[4] = 1;\n out[8] = 1;\n return out;\n}\n\n/**\n * Copies the upper-left 3x3 values into the given mat3.\n *\n * @param {mat3} out the receiving 3x3 matrix\n * @param {ReadonlyMat4} a the source 4x4 matrix\n * @returns {mat3} out\n */\nexport function fromMat4(out, a) {\n out[0] = a[0];\n out[1] = a[1];\n out[2] = a[2];\n out[3] = a[4];\n out[4] = a[5];\n out[5] = a[6];\n out[6] = a[8];\n out[7] = a[9];\n out[8] = a[10];\n return out;\n}\n\n/**\n * Creates a new mat3 initialized with values from an existing matrix\n *\n * @param {ReadonlyMat3} a matrix to clone\n * @returns {mat3} a new 3x3 matrix\n */\nexport function clone(a) {\n var out = new glMatrix.ARRAY_TYPE(9);\n out[0] = a[0];\n out[1] = a[1];\n out[2] = a[2];\n out[3] = a[3];\n out[4] = a[4];\n out[5] = a[5];\n out[6] = a[6];\n out[7] = a[7];\n out[8] = a[8];\n return out;\n}\n\n/**\n * Copy the values from one mat3 to another\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the source matrix\n * @returns {mat3} out\n */\nexport function copy(out, a) {\n out[0] = a[0];\n out[1] = a[1];\n out[2] = a[2];\n out[3] = a[3];\n out[4] = a[4];\n out[5] = a[5];\n out[6] = a[6];\n out[7] = a[7];\n out[8] = a[8];\n return out;\n}\n\n/**\n * Create a new mat3 with the given values\n *\n * @param {Number} m00 Component in column 0, row 0 position (index 0)\n * @param {Number} m01 Component in column 0, row 1 position (index 1)\n * @param {Number} m02 Component in column 0, row 2 position (index 2)\n * @param {Number} m10 Component in column 1, row 0 position (index 3)\n * @param {Number} m11 Component in column 1, row 1 position (index 4)\n * @param {Number} m12 Component in column 1, row 2 position (index 5)\n * @param {Number} m20 Component in column 2, row 0 position (index 6)\n * @param {Number} m21 Component in column 2, row 1 position (index 7)\n * @param {Number} m22 Component in column 2, row 2 position (index 8)\n * @returns {mat3} A new mat3\n */\nexport function fromValues(m00, m01, m02, m10, m11, m12, m20, m21, m22) {\n var out = new glMatrix.ARRAY_TYPE(9);\n out[0] = m00;\n out[1] = m01;\n out[2] = m02;\n out[3] = m10;\n out[4] = m11;\n out[5] = m12;\n out[6] = m20;\n out[7] = m21;\n out[8] = m22;\n return out;\n}\n\n/**\n * Set the components of a mat3 to the given values\n *\n * @param {mat3} out the receiving matrix\n * @param {Number} m00 Component in column 0, row 0 position (index 0)\n * @param {Number} m01 Component in column 0, row 1 position (index 1)\n * @param {Number} m02 Component in column 0, row 2 position (index 2)\n * @param {Number} m10 Component in column 1, row 0 position (index 3)\n * @param {Number} m11 Component in column 1, row 1 position (index 4)\n * @param {Number} m12 Component in column 1, row 2 position (index 5)\n * @param {Number} m20 Component in column 2, row 0 position (index 6)\n * @param {Number} m21 Component in column 2, row 1 position (index 7)\n * @param {Number} m22 Component in column 2, row 2 position (index 8)\n * @returns {mat3} out\n */\nexport function set(out, m00, m01, m02, m10, m11, m12, m20, m21, m22) {\n out[0] = m00;\n out[1] = m01;\n out[2] = m02;\n out[3] = m10;\n out[4] = m11;\n out[5] = m12;\n out[6] = m20;\n out[7] = m21;\n out[8] = m22;\n return out;\n}\n\n/**\n * Set a mat3 to the identity matrix\n *\n * @param {mat3} out the receiving matrix\n * @returns {mat3} out\n */\nexport function identity(out) {\n out[0] = 1;\n out[1] = 0;\n out[2] = 0;\n out[3] = 0;\n out[4] = 1;\n out[5] = 0;\n out[6] = 0;\n out[7] = 0;\n out[8] = 1;\n return out;\n}\n\n/**\n * Transpose the values of a mat3\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the source matrix\n * @returns {mat3} out\n */\nexport function transpose(out, a) {\n // If we are transposing ourselves we can skip a few steps but have to cache some values\n if (out === a) {\n var a01 = a[1],\n a02 = a[2],\n a12 = a[5];\n out[1] = a[3];\n out[2] = a[6];\n out[3] = a01;\n out[5] = a[7];\n out[6] = a02;\n out[7] = a12;\n } else {\n out[0] = a[0];\n out[1] = a[3];\n out[2] = a[6];\n out[3] = a[1];\n out[4] = a[4];\n out[5] = a[7];\n out[6] = a[2];\n out[7] = a[5];\n out[8] = a[8];\n }\n return out;\n}\n\n/**\n * Inverts a mat3\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the source matrix\n * @returns {mat3 | null} out, or null if source matrix is not invertible\n */\nexport function invert(out, a) {\n var a00 = a[0],\n a01 = a[1],\n a02 = a[2];\n var a10 = a[3],\n a11 = a[4],\n a12 = a[5];\n var a20 = a[6],\n a21 = a[7],\n a22 = a[8];\n var b01 = a22 * a11 - a12 * a21;\n var b11 = -a22 * a10 + a12 * a20;\n var b21 = a21 * a10 - a11 * a20;\n\n // Calculate the determinant\n var det = a00 * b01 + a01 * b11 + a02 * b21;\n if (!det) {\n return null;\n }\n det = 1.0 / det;\n out[0] = b01 * det;\n out[1] = (-a22 * a01 + a02 * a21) * det;\n out[2] = (a12 * a01 - a02 * a11) * det;\n out[3] = b11 * det;\n out[4] = (a22 * a00 - a02 * a20) * det;\n out[5] = (-a12 * a00 + a02 * a10) * det;\n out[6] = b21 * det;\n out[7] = (-a21 * a00 + a01 * a20) * det;\n out[8] = (a11 * a00 - a01 * a10) * det;\n return out;\n}\n\n/**\n * Calculates the adjugate of a mat3\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the source matrix\n * @returns {mat3} out\n */\nexport function adjoint(out, a) {\n var a00 = a[0],\n a01 = a[1],\n a02 = a[2];\n var a10 = a[3],\n a11 = a[4],\n a12 = a[5];\n var a20 = a[6],\n a21 = a[7],\n a22 = a[8];\n out[0] = a11 * a22 - a12 * a21;\n out[1] = a02 * a21 - a01 * a22;\n out[2] = a01 * a12 - a02 * a11;\n out[3] = a12 * a20 - a10 * a22;\n out[4] = a00 * a22 - a02 * a20;\n out[5] = a02 * a10 - a00 * a12;\n out[6] = a10 * a21 - a11 * a20;\n out[7] = a01 * a20 - a00 * a21;\n out[8] = a00 * a11 - a01 * a10;\n return out;\n}\n\n/**\n * Calculates the determinant of a mat3\n *\n * @param {ReadonlyMat3} a the source matrix\n * @returns {Number} determinant of a\n */\nexport function determinant(a) {\n var a00 = a[0],\n a01 = a[1],\n a02 = a[2];\n var a10 = a[3],\n a11 = a[4],\n a12 = a[5];\n var a20 = a[6],\n a21 = a[7],\n a22 = a[8];\n return a00 * (a22 * a11 - a12 * a21) + a01 * (-a22 * a10 + a12 * a20) + a02 * (a21 * a10 - a11 * a20);\n}\n\n/**\n * Multiplies two mat3's\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the first operand\n * @param {ReadonlyMat3} b the second operand\n * @returns {mat3} out\n */\nexport function multiply(out, a, b) {\n var a00 = a[0],\n a01 = a[1],\n a02 = a[2];\n var a10 = a[3],\n a11 = a[4],\n a12 = a[5];\n var a20 = a[6],\n a21 = a[7],\n a22 = a[8];\n var b00 = b[0],\n b01 = b[1],\n b02 = b[2];\n var b10 = b[3],\n b11 = b[4],\n b12 = b[5];\n var b20 = b[6],\n b21 = b[7],\n b22 = b[8];\n out[0] = b00 * a00 + b01 * a10 + b02 * a20;\n out[1] = b00 * a01 + b01 * a11 + b02 * a21;\n out[2] = b00 * a02 + b01 * a12 + b02 * a22;\n out[3] = b10 * a00 + b11 * a10 + b12 * a20;\n out[4] = b10 * a01 + b11 * a11 + b12 * a21;\n out[5] = b10 * a02 + b11 * a12 + b12 * a22;\n out[6] = b20 * a00 + b21 * a10 + b22 * a20;\n out[7] = b20 * a01 + b21 * a11 + b22 * a21;\n out[8] = b20 * a02 + b21 * a12 + b22 * a22;\n return out;\n}\n\n/**\n * Translate a mat3 by the given vector\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the matrix to translate\n * @param {ReadonlyVec2} v vector to translate by\n * @returns {mat3} out\n */\nexport function translate(out, a, v) {\n var a00 = a[0],\n a01 = a[1],\n a02 = a[2],\n a10 = a[3],\n a11 = a[4],\n a12 = a[5],\n a20 = a[6],\n a21 = a[7],\n a22 = a[8],\n x = v[0],\n y = v[1];\n out[0] = a00;\n out[1] = a01;\n out[2] = a02;\n out[3] = a10;\n out[4] = a11;\n out[5] = a12;\n out[6] = x * a00 + y * a10 + a20;\n out[7] = x * a01 + y * a11 + a21;\n out[8] = x * a02 + y * a12 + a22;\n return out;\n}\n\n/**\n * Rotates a mat3 by the given angle\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the matrix to rotate\n * @param {Number} rad the angle to rotate the matrix by\n * @returns {mat3} out\n */\nexport function rotate(out, a, rad) {\n var a00 = a[0],\n a01 = a[1],\n a02 = a[2],\n a10 = a[3],\n a11 = a[4],\n a12 = a[5],\n a20 = a[6],\n a21 = a[7],\n a22 = a[8],\n s = Math.sin(rad),\n c = Math.cos(rad);\n out[0] = c * a00 + s * a10;\n out[1] = c * a01 + s * a11;\n out[2] = c * a02 + s * a12;\n out[3] = c * a10 - s * a00;\n out[4] = c * a11 - s * a01;\n out[5] = c * a12 - s * a02;\n out[6] = a20;\n out[7] = a21;\n out[8] = a22;\n return out;\n}\n\n/**\n * Scales the mat3 by the dimensions in the given vec2\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the matrix to scale\n * @param {ReadonlyVec2} v the vec2 to scale the matrix by\n * @returns {mat3} out\n **/\nexport function scale(out, a, v) {\n var x = v[0],\n y = v[1];\n out[0] = x * a[0];\n out[1] = x * a[1];\n out[2] = x * a[2];\n out[3] = y * a[3];\n out[4] = y * a[4];\n out[5] = y * a[5];\n out[6] = a[6];\n out[7] = a[7];\n out[8] = a[8];\n return out;\n}\n\n/**\n * Creates a matrix from a vector translation\n * This is equivalent to (but much faster than):\n *\n * mat3.identity(dest);\n * mat3.translate(dest, dest, vec);\n *\n * @param {mat3} out mat3 receiving operation result\n * @param {ReadonlyVec2} v Translation vector\n * @returns {mat3} out\n */\nexport function fromTranslation(out, v) {\n out[0] = 1;\n out[1] = 0;\n out[2] = 0;\n out[3] = 0;\n out[4] = 1;\n out[5] = 0;\n out[6] = v[0];\n out[7] = v[1];\n out[8] = 1;\n return out;\n}\n\n/**\n * Creates a matrix from a given angle\n * This is equivalent to (but much faster than):\n *\n * mat3.identity(dest);\n * mat3.rotate(dest, dest, rad);\n *\n * @param {mat3} out mat3 receiving operation result\n * @param {Number} rad the angle to rotate the matrix by\n * @returns {mat3} out\n */\nexport function fromRotation(out, rad) {\n var s = Math.sin(rad),\n c = Math.cos(rad);\n out[0] = c;\n out[1] = s;\n out[2] = 0;\n out[3] = -s;\n out[4] = c;\n out[5] = 0;\n out[6] = 0;\n out[7] = 0;\n out[8] = 1;\n return out;\n}\n\n/**\n * Creates a matrix from a vector scaling\n * This is equivalent to (but much faster than):\n *\n * mat3.identity(dest);\n * mat3.scale(dest, dest, vec);\n *\n * @param {mat3} out mat3 receiving operation result\n * @param {ReadonlyVec2} v Scaling vector\n * @returns {mat3} out\n */\nexport function fromScaling(out, v) {\n out[0] = v[0];\n out[1] = 0;\n out[2] = 0;\n out[3] = 0;\n out[4] = v[1];\n out[5] = 0;\n out[6] = 0;\n out[7] = 0;\n out[8] = 1;\n return out;\n}\n\n/**\n * Copies the values from a mat2d into a mat3\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat2d} a the matrix to copy\n * @returns {mat3} out\n **/\nexport function fromMat2d(out, a) {\n out[0] = a[0];\n out[1] = a[1];\n out[2] = 0;\n out[3] = a[2];\n out[4] = a[3];\n out[5] = 0;\n out[6] = a[4];\n out[7] = a[5];\n out[8] = 1;\n return out;\n}\n\n/**\n * Calculates a 3x3 matrix from the given quaternion\n *\n * @param {mat3} out mat3 receiving operation result\n * @param {ReadonlyQuat} q Quaternion to create matrix from\n *\n * @returns {mat3} out\n */\nexport function fromQuat(out, q) {\n var x = q[0],\n y = q[1],\n z = q[2],\n w = q[3];\n var x2 = x + x;\n var y2 = y + y;\n var z2 = z + z;\n var xx = x * x2;\n var yx = y * x2;\n var yy = y * y2;\n var zx = z * x2;\n var zy = z * y2;\n var zz = z * z2;\n var wx = w * x2;\n var wy = w * y2;\n var wz = w * z2;\n out[0] = 1 - yy - zz;\n out[3] = yx - wz;\n out[6] = zx + wy;\n out[1] = yx + wz;\n out[4] = 1 - xx - zz;\n out[7] = zy - wx;\n out[2] = zx - wy;\n out[5] = zy + wx;\n out[8] = 1 - xx - yy;\n return out;\n}\n\n/**\n * Calculates a 3x3 normal matrix (transpose inverse) from the 4x4 matrix\n *\n * @param {mat3} out mat3 receiving operation result\n * @param {ReadonlyMat4} a Mat4 to derive the normal matrix from\n *\n * @returns {mat3} out\n */\nexport function normalFromMat4(out, a) {\n var a00 = a[0],\n a01 = a[1],\n a02 = a[2],\n a03 = a[3];\n var a10 = a[4],\n a11 = a[5],\n a12 = a[6],\n a13 = a[7];\n var a20 = a[8],\n a21 = a[9],\n a22 = a[10],\n a23 = a[11];\n var a30 = a[12],\n a31 = a[13],\n a32 = a[14],\n a33 = a[15];\n var b00 = a00 * a11 - a01 * a10;\n var b01 = a00 * a12 - a02 * a10;\n var b02 = a00 * a13 - a03 * a10;\n var b03 = a01 * a12 - a02 * a11;\n var b04 = a01 * a13 - a03 * a11;\n var b05 = a02 * a13 - a03 * a12;\n var b06 = a20 * a31 - a21 * a30;\n var b07 = a20 * a32 - a22 * a30;\n var b08 = a20 * a33 - a23 * a30;\n var b09 = a21 * a32 - a22 * a31;\n var b10 = a21 * a33 - a23 * a31;\n var b11 = a22 * a33 - a23 * a32;\n\n // Calculate the determinant\n var det = b00 * b11 - b01 * b10 + b02 * b09 + b03 * b08 - b04 * b07 + b05 * b06;\n if (!det) {\n return null;\n }\n det = 1.0 / det;\n out[0] = (a11 * b11 - a12 * b10 + a13 * b09) * det;\n out[1] = (a12 * b08 - a10 * b11 - a13 * b07) * det;\n out[2] = (a10 * b10 - a11 * b08 + a13 * b06) * det;\n out[3] = (a02 * b10 - a01 * b11 - a03 * b09) * det;\n out[4] = (a00 * b11 - a02 * b08 + a03 * b07) * det;\n out[5] = (a01 * b08 - a00 * b10 - a03 * b06) * det;\n out[6] = (a31 * b05 - a32 * b04 + a33 * b03) * det;\n out[7] = (a32 * b02 - a30 * b05 - a33 * b01) * det;\n out[8] = (a30 * b04 - a31 * b02 + a33 * b00) * det;\n return out;\n}\n\n/**\n * Generates a 2D projection matrix with the given bounds\n *\n * @param {mat3} out mat3 frustum matrix will be written into\n * @param {number} width Width of your gl context\n * @param {number} height Height of gl context\n * @returns {mat3} out\n */\nexport function projection(out, width, height) {\n out[0] = 2 / width;\n out[1] = 0;\n out[2] = 0;\n out[3] = 0;\n out[4] = -2 / height;\n out[5] = 0;\n out[6] = -1;\n out[7] = 1;\n out[8] = 1;\n return out;\n}\n\n/**\n * Returns a string representation of a mat3\n *\n * @param {ReadonlyMat3} a matrix to represent as a string\n * @returns {String} string representation of the matrix\n */\nexport function str(a) {\n return \"mat3(\" + a[0] + \", \" + a[1] + \", \" + a[2] + \", \" + a[3] + \", \" + a[4] + \", \" + a[5] + \", \" + a[6] + \", \" + a[7] + \", \" + a[8] + \")\";\n}\n\n/**\n * Returns Frobenius norm of a mat3\n *\n * @param {ReadonlyMat3} a the matrix to calculate Frobenius norm of\n * @returns {Number} Frobenius norm\n */\nexport function frob(a) {\n return Math.sqrt(a[0] * a[0] + a[1] * a[1] + a[2] * a[2] + a[3] * a[3] + a[4] * a[4] + a[5] * a[5] + a[6] * a[6] + a[7] * a[7] + a[8] * a[8]);\n}\n\n/**\n * Adds two mat3's\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the first operand\n * @param {ReadonlyMat3} b the second operand\n * @returns {mat3} out\n */\nexport function add(out, a, b) {\n out[0] = a[0] + b[0];\n out[1] = a[1] + b[1];\n out[2] = a[2] + b[2];\n out[3] = a[3] + b[3];\n out[4] = a[4] + b[4];\n out[5] = a[5] + b[5];\n out[6] = a[6] + b[6];\n out[7] = a[7] + b[7];\n out[8] = a[8] + b[8];\n return out;\n}\n\n/**\n * Subtracts matrix b from matrix a\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the first operand\n * @param {ReadonlyMat3} b the second operand\n * @returns {mat3} out\n */\nexport function subtract(out, a, b) {\n out[0] = a[0] - b[0];\n out[1] = a[1] - b[1];\n out[2] = a[2] - b[2];\n out[3] = a[3] - b[3];\n out[4] = a[4] - b[4];\n out[5] = a[5] - b[5];\n out[6] = a[6] - b[6];\n out[7] = a[7] - b[7];\n out[8] = a[8] - b[8];\n return out;\n}\n\n/**\n * Multiply each element of the matrix by a scalar.\n *\n * @param {mat3} out the receiving matrix\n * @param {ReadonlyMat3} a the matrix to scale\n * @param {Number} b amount to scale the matrix's elements by\n * @returns {mat3} out\n */\nexport function multiplyScalar(out, a, b) {\n out[0] = a[0] * b;\n out[1] = a[1] * b;\n out[2] = a[2] * b;\n out[3] = a[3] * b;\n out[4] = a[4] * b;\n out[5] = a[5] * b;\n out[6] = a[6] * b;\n out[7] = a[7] * b;\n out[8] = a[8] * b;\n return out;\n}\n\n/**\n * Adds two mat3's after multiplying each element of the second operand by a scalar value.\n *\n * @param {mat3} out the receiving vector\n * @param {ReadonlyMat3} a the first operand\n * @param {ReadonlyMat3} b the second operand\n * @param {Number} scale the amount to scale b's elements by before adding\n * @returns {mat3} out\n */\nexport function multiplyScalarAndAdd(out, a, b, scale) {\n out[0] = a[0] + b[0] * scale;\n out[1] = a[1] + b[1] * scale;\n out[2] = a[2] + b[2] * scale;\n out[3] = a[3] + b[3] * scale;\n out[4] = a[4] + b[4] * scale;\n out[5] = a[5] + b[5] * scale;\n out[6] = a[6] + b[6] * scale;\n out[7] = a[7] + b[7] * scale;\n out[8] = a[8] + b[8] * scale;\n return out;\n}\n\n/**\n * Returns whether or not the matrices have exactly the same elements in the same position (when compared with ===)\n *\n * @param {ReadonlyMat3} a The first matrix.\n * @param {ReadonlyMat3} b The second matrix.\n * @returns {Boolean} True if the matrices are equal, false otherwise.\n */\nexport function exactEquals(a, b) {\n return a[0] === b[0] && a[1] === b[1] && a[2] === b[2] && a[3] === b[3] && a[4] === b[4] && a[5] === b[5] && a[6] === b[6] && a[7] === b[7] && a[8] === b[8];\n}\n\n/**\n * Returns whether or not the matrices have approximately the same elements in the same position.\n *\n * @param {ReadonlyMat3} a The first matrix.\n * @param {ReadonlyMat3} b The second matrix.\n * @returns {Boolean} True if the matrices are equal, false otherwise.\n */\nexport function equals(a, b) {\n var a0 = a[0],\n a1 = a[1],\n a2 = a[2],\n a3 = a[3],\n a4 = a[4],\n a5 = a[5],\n a6 = a[6],\n a7 = a[7],\n a8 = a[8];\n var b0 = b[0],\n b1 = b[1],\n b2 = b[2],\n b3 = b[3],\n b4 = b[4],\n b5 = b[5],\n b6 = b[6],\n b7 = b[7],\n b8 = b[8];\n return Math.abs(a0 - b0) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1)) && Math.abs(a2 - b2) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a2), Math.abs(b2)) && Math.abs(a3 - b3) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a3), Math.abs(b3)) && Math.abs(a4 - b4) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a4), Math.abs(b4)) && Math.abs(a5 - b5) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a5), Math.abs(b5)) && Math.abs(a6 - b6) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a6), Math.abs(b6)) && Math.abs(a7 - b7) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a7), Math.abs(b7)) && Math.abs(a8 - b8) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a8), Math.abs(b8));\n}\n\n/**\n * Alias for {@link mat3.multiply}\n * @function\n */\nexport var mul = multiply;\n\n/**\n * Alias for {@link mat3.subtract}\n * @function\n */\nexport var sub = subtract;","import * as glMatrix from \"./common.js\";\n\n/**\n * 4x4 Matrix
Format: column-major, when typed out it looks like row-major
The matrices are being post multiplied.\n * @module mat4\n */\n\n/**\n * Creates a new identity mat4\n *\n * @returns {mat4} a new 4x4 matrix\n */\nexport function create() {\n var out = new glMatrix.ARRAY_TYPE(16);\n if (glMatrix.ARRAY_TYPE != Float32Array) {\n out[1] = 0;\n out[2] = 0;\n out[3] = 0;\n out[4] = 0;\n out[6] = 0;\n out[7] = 0;\n out[8] = 0;\n out[9] = 0;\n out[11] = 0;\n out[12] = 0;\n out[13] = 0;\n out[14] = 0;\n }\n out[0] = 1;\n out[5] = 1;\n out[10] = 1;\n out[15] = 1;\n return out;\n}\n\n/**\n * Creates a new mat4 initialized with values from an existing matrix\n *\n * @param {ReadonlyMat4} a matrix to clone\n * @returns {mat4} a new 4x4 matrix\n */\nexport function clone(a) {\n var out = new glMatrix.ARRAY_TYPE(16);\n out[0] = a[0];\n out[1] = a[1];\n out[2] = a[2];\n out[3] = a[3];\n out[4] = a[4];\n out[5] = a[5];\n out[6] = a[6];\n out[7] = a[7];\n out[8] = a[8];\n out[9] = a[9];\n out[10] = a[10];\n out[11] = a[11];\n out[12] = a[12];\n out[13] = a[13];\n out[14] = a[14];\n out[15] = a[15];\n return out;\n}\n\n/**\n * Copy the values from one mat4 to another\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the source matrix\n * @returns {mat4} out\n */\nexport function copy(out, a) {\n out[0] = a[0];\n out[1] = a[1];\n out[2] = a[2];\n out[3] = a[3];\n out[4] = a[4];\n out[5] = a[5];\n out[6] = a[6];\n out[7] = a[7];\n out[8] = a[8];\n out[9] = a[9];\n out[10] = a[10];\n out[11] = a[11];\n out[12] = a[12];\n out[13] = a[13];\n out[14] = a[14];\n out[15] = a[15];\n return out;\n}\n\n/**\n * Create a new mat4 with the given values\n *\n * @param {Number} m00 Component in column 0, row 0 position (index 0)\n * @param {Number} m01 Component in column 0, row 1 position (index 1)\n * @param {Number} m02 Component in column 0, row 2 position (index 2)\n * @param {Number} m03 Component in column 0, row 3 position (index 3)\n * @param {Number} m10 Component in column 1, row 0 position (index 4)\n * @param {Number} m11 Component in column 1, row 1 position (index 5)\n * @param {Number} m12 Component in column 1, row 2 position (index 6)\n * @param {Number} m13 Component in column 1, row 3 position (index 7)\n * @param {Number} m20 Component in column 2, row 0 position (index 8)\n * @param {Number} m21 Component in column 2, row 1 position (index 9)\n * @param {Number} m22 Component in column 2, row 2 position (index 10)\n * @param {Number} m23 Component in column 2, row 3 position (index 11)\n * @param {Number} m30 Component in column 3, row 0 position (index 12)\n * @param {Number} m31 Component in column 3, row 1 position (index 13)\n * @param {Number} m32 Component in column 3, row 2 position (index 14)\n * @param {Number} m33 Component in column 3, row 3 position (index 15)\n * @returns {mat4} A new mat4\n */\nexport function fromValues(m00, m01, m02, m03, m10, m11, m12, m13, m20, m21, m22, m23, m30, m31, m32, m33) {\n var out = new glMatrix.ARRAY_TYPE(16);\n out[0] = m00;\n out[1] = m01;\n out[2] = m02;\n out[3] = m03;\n out[4] = m10;\n out[5] = m11;\n out[6] = m12;\n out[7] = m13;\n out[8] = m20;\n out[9] = m21;\n out[10] = m22;\n out[11] = m23;\n out[12] = m30;\n out[13] = m31;\n out[14] = m32;\n out[15] = m33;\n return out;\n}\n\n/**\n * Set the components of a mat4 to the given values\n *\n * @param {mat4} out the receiving matrix\n * @param {Number} m00 Component in column 0, row 0 position (index 0)\n * @param {Number} m01 Component in column 0, row 1 position (index 1)\n * @param {Number} m02 Component in column 0, row 2 position (index 2)\n * @param {Number} m03 Component in column 0, row 3 position (index 3)\n * @param {Number} m10 Component in column 1, row 0 position (index 4)\n * @param {Number} m11 Component in column 1, row 1 position (index 5)\n * @param {Number} m12 Component in column 1, row 2 position (index 6)\n * @param {Number} m13 Component in column 1, row 3 position (index 7)\n * @param {Number} m20 Component in column 2, row 0 position (index 8)\n * @param {Number} m21 Component in column 2, row 1 position (index 9)\n * @param {Number} m22 Component in column 2, row 2 position (index 10)\n * @param {Number} m23 Component in column 2, row 3 position (index 11)\n * @param {Number} m30 Component in column 3, row 0 position (index 12)\n * @param {Number} m31 Component in column 3, row 1 position (index 13)\n * @param {Number} m32 Component in column 3, row 2 position (index 14)\n * @param {Number} m33 Component in column 3, row 3 position (index 15)\n * @returns {mat4} out\n */\nexport function set(out, m00, m01, m02, m03, m10, m11, m12, m13, m20, m21, m22, m23, m30, m31, m32, m33) {\n out[0] = m00;\n out[1] = m01;\n out[2] = m02;\n out[3] = m03;\n out[4] = m10;\n out[5] = m11;\n out[6] = m12;\n out[7] = m13;\n out[8] = m20;\n out[9] = m21;\n out[10] = m22;\n out[11] = m23;\n out[12] = m30;\n out[13] = m31;\n out[14] = m32;\n out[15] = m33;\n return out;\n}\n\n/**\n * Set a mat4 to the identity matrix\n *\n * @param {mat4} out the receiving matrix\n * @returns {mat4} out\n */\nexport function identity(out) {\n out[0] = 1;\n out[1] = 0;\n out[2] = 0;\n out[3] = 0;\n out[4] = 0;\n out[5] = 1;\n out[6] = 0;\n out[7] = 0;\n out[8] = 0;\n out[9] = 0;\n out[10] = 1;\n out[11] = 0;\n out[12] = 0;\n out[13] = 0;\n out[14] = 0;\n out[15] = 1;\n return out;\n}\n\n/**\n * Transpose the values of a mat4\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the source matrix\n * @returns {mat4} out\n */\nexport function transpose(out, a) {\n // If we are transposing ourselves we can skip a few steps but have to cache some values\n if (out === a) {\n var a01 = a[1],\n a02 = a[2],\n a03 = a[3];\n var a12 = a[6],\n a13 = a[7];\n var a23 = a[11];\n out[1] = a[4];\n out[2] = a[8];\n out[3] = a[12];\n out[4] = a01;\n out[6] = a[9];\n out[7] = a[13];\n out[8] = a02;\n out[9] = a12;\n out[11] = a[14];\n out[12] = a03;\n out[13] = a13;\n out[14] = a23;\n } else {\n out[0] = a[0];\n out[1] = a[4];\n out[2] = a[8];\n out[3] = a[12];\n out[4] = a[1];\n out[5] = a[5];\n out[6] = a[9];\n out[7] = a[13];\n out[8] = a[2];\n out[9] = a[6];\n out[10] = a[10];\n out[11] = a[14];\n out[12] = a[3];\n out[13] = a[7];\n out[14] = a[11];\n out[15] = a[15];\n }\n return out;\n}\n\n/**\n * Inverts a mat4\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the source matrix\n * @returns {mat4 | null} out, or null if source matrix is not invertible\n */\nexport function invert(out, a) {\n var a00 = a[0],\n a01 = a[1],\n a02 = a[2],\n a03 = a[3];\n var a10 = a[4],\n a11 = a[5],\n a12 = a[6],\n a13 = a[7];\n var a20 = a[8],\n a21 = a[9],\n a22 = a[10],\n a23 = a[11];\n var a30 = a[12],\n a31 = a[13],\n a32 = a[14],\n a33 = a[15];\n var b00 = a00 * a11 - a01 * a10;\n var b01 = a00 * a12 - a02 * a10;\n var b02 = a00 * a13 - a03 * a10;\n var b03 = a01 * a12 - a02 * a11;\n var b04 = a01 * a13 - a03 * a11;\n var b05 = a02 * a13 - a03 * a12;\n var b06 = a20 * a31 - a21 * a30;\n var b07 = a20 * a32 - a22 * a30;\n var b08 = a20 * a33 - a23 * a30;\n var b09 = a21 * a32 - a22 * a31;\n var b10 = a21 * a33 - a23 * a31;\n var b11 = a22 * a33 - a23 * a32;\n\n // Calculate the determinant\n var det = b00 * b11 - b01 * b10 + b02 * b09 + b03 * b08 - b04 * b07 + b05 * b06;\n if (!det) {\n return null;\n }\n det = 1.0 / det;\n out[0] = (a11 * b11 - a12 * b10 + a13 * b09) * det;\n out[1] = (a02 * b10 - a01 * b11 - a03 * b09) * det;\n out[2] = (a31 * b05 - a32 * b04 + a33 * b03) * det;\n out[3] = (a22 * b04 - a21 * b05 - a23 * b03) * det;\n out[4] = (a12 * b08 - a10 * b11 - a13 * b07) * det;\n out[5] = (a00 * b11 - a02 * b08 + a03 * b07) * det;\n out[6] = (a32 * b02 - a30 * b05 - a33 * b01) * det;\n out[7] = (a20 * b05 - a22 * b02 + a23 * b01) * det;\n out[8] = (a10 * b10 - a11 * b08 + a13 * b06) * det;\n out[9] = (a01 * b08 - a00 * b10 - a03 * b06) * det;\n out[10] = (a30 * b04 - a31 * b02 + a33 * b00) * det;\n out[11] = (a21 * b02 - a20 * b04 - a23 * b00) * det;\n out[12] = (a11 * b07 - a10 * b09 - a12 * b06) * det;\n out[13] = (a00 * b09 - a01 * b07 + a02 * b06) * det;\n out[14] = (a31 * b01 - a30 * b03 - a32 * b00) * det;\n out[15] = (a20 * b03 - a21 * b01 + a22 * b00) * det;\n return out;\n}\n\n/**\n * Calculates the adjugate of a mat4\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the source matrix\n * @returns {mat4} out\n */\nexport function adjoint(out, a) {\n var a00 = a[0],\n a01 = a[1],\n a02 = a[2],\n a03 = a[3];\n var a10 = a[4],\n a11 = a[5],\n a12 = a[6],\n a13 = a[7];\n var a20 = a[8],\n a21 = a[9],\n a22 = a[10],\n a23 = a[11];\n var a30 = a[12],\n a31 = a[13],\n a32 = a[14],\n a33 = a[15];\n var b00 = a00 * a11 - a01 * a10;\n var b01 = a00 * a12 - a02 * a10;\n var b02 = a00 * a13 - a03 * a10;\n var b03 = a01 * a12 - a02 * a11;\n var b04 = a01 * a13 - a03 * a11;\n var b05 = a02 * a13 - a03 * a12;\n var b06 = a20 * a31 - a21 * a30;\n var b07 = a20 * a32 - a22 * a30;\n var b08 = a20 * a33 - a23 * a30;\n var b09 = a21 * a32 - a22 * a31;\n var b10 = a21 * a33 - a23 * a31;\n var b11 = a22 * a33 - a23 * a32;\n out[0] = a11 * b11 - a12 * b10 + a13 * b09;\n out[1] = a02 * b10 - a01 * b11 - a03 * b09;\n out[2] = a31 * b05 - a32 * b04 + a33 * b03;\n out[3] = a22 * b04 - a21 * b05 - a23 * b03;\n out[4] = a12 * b08 - a10 * b11 - a13 * b07;\n out[5] = a00 * b11 - a02 * b08 + a03 * b07;\n out[6] = a32 * b02 - a30 * b05 - a33 * b01;\n out[7] = a20 * b05 - a22 * b02 + a23 * b01;\n out[8] = a10 * b10 - a11 * b08 + a13 * b06;\n out[9] = a01 * b08 - a00 * b10 - a03 * b06;\n out[10] = a30 * b04 - a31 * b02 + a33 * b00;\n out[11] = a21 * b02 - a20 * b04 - a23 * b00;\n out[12] = a11 * b07 - a10 * b09 - a12 * b06;\n out[13] = a00 * b09 - a01 * b07 + a02 * b06;\n out[14] = a31 * b01 - a30 * b03 - a32 * b00;\n out[15] = a20 * b03 - a21 * b01 + a22 * b00;\n return out;\n}\n\n/**\n * Calculates the determinant of a mat4\n *\n * @param {ReadonlyMat4} a the source matrix\n * @returns {Number} determinant of a\n */\nexport function determinant(a) {\n var a00 = a[0],\n a01 = a[1],\n a02 = a[2],\n a03 = a[3];\n var a10 = a[4],\n a11 = a[5],\n a12 = a[6],\n a13 = a[7];\n var a20 = a[8],\n a21 = a[9],\n a22 = a[10],\n a23 = a[11];\n var a30 = a[12],\n a31 = a[13],\n a32 = a[14],\n a33 = a[15];\n var b0 = a00 * a11 - a01 * a10;\n var b1 = a00 * a12 - a02 * a10;\n var b2 = a01 * a12 - a02 * a11;\n var b3 = a20 * a31 - a21 * a30;\n var b4 = a20 * a32 - a22 * a30;\n var b5 = a21 * a32 - a22 * a31;\n var b6 = a00 * b5 - a01 * b4 + a02 * b3;\n var b7 = a10 * b5 - a11 * b4 + a12 * b3;\n var b8 = a20 * b2 - a21 * b1 + a22 * b0;\n var b9 = a30 * b2 - a31 * b1 + a32 * b0;\n\n // Calculate the determinant\n return a13 * b6 - a03 * b7 + a33 * b8 - a23 * b9;\n}\n\n/**\n * Multiplies two mat4s\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the first operand\n * @param {ReadonlyMat4} b the second operand\n * @returns {mat4} out\n */\nexport function multiply(out, a, b) {\n var a00 = a[0],\n a01 = a[1],\n a02 = a[2],\n a03 = a[3];\n var a10 = a[4],\n a11 = a[5],\n a12 = a[6],\n a13 = a[7];\n var a20 = a[8],\n a21 = a[9],\n a22 = a[10],\n a23 = a[11];\n var a30 = a[12],\n a31 = a[13],\n a32 = a[14],\n a33 = a[15];\n\n // Cache only the current line of the second matrix\n var b0 = b[0],\n b1 = b[1],\n b2 = b[2],\n b3 = b[3];\n out[0] = b0 * a00 + b1 * a10 + b2 * a20 + b3 * a30;\n out[1] = b0 * a01 + b1 * a11 + b2 * a21 + b3 * a31;\n out[2] = b0 * a02 + b1 * a12 + b2 * a22 + b3 * a32;\n out[3] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33;\n b0 = b[4];\n b1 = b[5];\n b2 = b[6];\n b3 = b[7];\n out[4] = b0 * a00 + b1 * a10 + b2 * a20 + b3 * a30;\n out[5] = b0 * a01 + b1 * a11 + b2 * a21 + b3 * a31;\n out[6] = b0 * a02 + b1 * a12 + b2 * a22 + b3 * a32;\n out[7] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33;\n b0 = b[8];\n b1 = b[9];\n b2 = b[10];\n b3 = b[11];\n out[8] = b0 * a00 + b1 * a10 + b2 * a20 + b3 * a30;\n out[9] = b0 * a01 + b1 * a11 + b2 * a21 + b3 * a31;\n out[10] = b0 * a02 + b1 * a12 + b2 * a22 + b3 * a32;\n out[11] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33;\n b0 = b[12];\n b1 = b[13];\n b2 = b[14];\n b3 = b[15];\n out[12] = b0 * a00 + b1 * a10 + b2 * a20 + b3 * a30;\n out[13] = b0 * a01 + b1 * a11 + b2 * a21 + b3 * a31;\n out[14] = b0 * a02 + b1 * a12 + b2 * a22 + b3 * a32;\n out[15] = b0 * a03 + b1 * a13 + b2 * a23 + b3 * a33;\n return out;\n}\n\n/**\n * Translate a mat4 by the given vector\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the matrix to translate\n * @param {ReadonlyVec3} v vector to translate by\n * @returns {mat4} out\n */\nexport function translate(out, a, v) {\n var x = v[0],\n y = v[1],\n z = v[2];\n var a00, a01, a02, a03;\n var a10, a11, a12, a13;\n var a20, a21, a22, a23;\n if (a === out) {\n out[12] = a[0] * x + a[4] * y + a[8] * z + a[12];\n out[13] = a[1] * x + a[5] * y + a[9] * z + a[13];\n out[14] = a[2] * x + a[6] * y + a[10] * z + a[14];\n out[15] = a[3] * x + a[7] * y + a[11] * z + a[15];\n } else {\n a00 = a[0];\n a01 = a[1];\n a02 = a[2];\n a03 = a[3];\n a10 = a[4];\n a11 = a[5];\n a12 = a[6];\n a13 = a[7];\n a20 = a[8];\n a21 = a[9];\n a22 = a[10];\n a23 = a[11];\n out[0] = a00;\n out[1] = a01;\n out[2] = a02;\n out[3] = a03;\n out[4] = a10;\n out[5] = a11;\n out[6] = a12;\n out[7] = a13;\n out[8] = a20;\n out[9] = a21;\n out[10] = a22;\n out[11] = a23;\n out[12] = a00 * x + a10 * y + a20 * z + a[12];\n out[13] = a01 * x + a11 * y + a21 * z + a[13];\n out[14] = a02 * x + a12 * y + a22 * z + a[14];\n out[15] = a03 * x + a13 * y + a23 * z + a[15];\n }\n return out;\n}\n\n/**\n * Scales the mat4 by the dimensions in the given vec3 not using vectorization\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the matrix to scale\n * @param {ReadonlyVec3} v the vec3 to scale the matrix by\n * @returns {mat4} out\n **/\nexport function scale(out, a, v) {\n var x = v[0],\n y = v[1],\n z = v[2];\n out[0] = a[0] * x;\n out[1] = a[1] * x;\n out[2] = a[2] * x;\n out[3] = a[3] * x;\n out[4] = a[4] * y;\n out[5] = a[5] * y;\n out[6] = a[6] * y;\n out[7] = a[7] * y;\n out[8] = a[8] * z;\n out[9] = a[9] * z;\n out[10] = a[10] * z;\n out[11] = a[11] * z;\n out[12] = a[12];\n out[13] = a[13];\n out[14] = a[14];\n out[15] = a[15];\n return out;\n}\n\n/**\n * Rotates a mat4 by the given angle around the given axis\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the matrix to rotate\n * @param {Number} rad the angle to rotate the matrix by\n * @param {ReadonlyVec3} axis the axis to rotate around\n * @returns {mat4} out\n */\nexport function rotate(out, a, rad, axis) {\n var x = axis[0],\n y = axis[1],\n z = axis[2];\n var len = Math.sqrt(x * x + y * y + z * z);\n var s, c, t;\n var a00, a01, a02, a03;\n var a10, a11, a12, a13;\n var a20, a21, a22, a23;\n var b00, b01, b02;\n var b10, b11, b12;\n var b20, b21, b22;\n if (len < glMatrix.EPSILON) {\n return null;\n }\n len = 1 / len;\n x *= len;\n y *= len;\n z *= len;\n s = Math.sin(rad);\n c = Math.cos(rad);\n t = 1 - c;\n a00 = a[0];\n a01 = a[1];\n a02 = a[2];\n a03 = a[3];\n a10 = a[4];\n a11 = a[5];\n a12 = a[6];\n a13 = a[7];\n a20 = a[8];\n a21 = a[9];\n a22 = a[10];\n a23 = a[11];\n\n // Construct the elements of the rotation matrix\n b00 = x * x * t + c;\n b01 = y * x * t + z * s;\n b02 = z * x * t - y * s;\n b10 = x * y * t - z * s;\n b11 = y * y * t + c;\n b12 = z * y * t + x * s;\n b20 = x * z * t + y * s;\n b21 = y * z * t - x * s;\n b22 = z * z * t + c;\n\n // Perform rotation-specific matrix multiplication\n out[0] = a00 * b00 + a10 * b01 + a20 * b02;\n out[1] = a01 * b00 + a11 * b01 + a21 * b02;\n out[2] = a02 * b00 + a12 * b01 + a22 * b02;\n out[3] = a03 * b00 + a13 * b01 + a23 * b02;\n out[4] = a00 * b10 + a10 * b11 + a20 * b12;\n out[5] = a01 * b10 + a11 * b11 + a21 * b12;\n out[6] = a02 * b10 + a12 * b11 + a22 * b12;\n out[7] = a03 * b10 + a13 * b11 + a23 * b12;\n out[8] = a00 * b20 + a10 * b21 + a20 * b22;\n out[9] = a01 * b20 + a11 * b21 + a21 * b22;\n out[10] = a02 * b20 + a12 * b21 + a22 * b22;\n out[11] = a03 * b20 + a13 * b21 + a23 * b22;\n if (a !== out) {\n // If the source and destination differ, copy the unchanged last row\n out[12] = a[12];\n out[13] = a[13];\n out[14] = a[14];\n out[15] = a[15];\n }\n return out;\n}\n\n/**\n * Rotates a matrix by the given angle around the X axis\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the matrix to rotate\n * @param {Number} rad the angle to rotate the matrix by\n * @returns {mat4} out\n */\nexport function rotateX(out, a, rad) {\n var s = Math.sin(rad);\n var c = Math.cos(rad);\n var a10 = a[4];\n var a11 = a[5];\n var a12 = a[6];\n var a13 = a[7];\n var a20 = a[8];\n var a21 = a[9];\n var a22 = a[10];\n var a23 = a[11];\n if (a !== out) {\n // If the source and destination differ, copy the unchanged rows\n out[0] = a[0];\n out[1] = a[1];\n out[2] = a[2];\n out[3] = a[3];\n out[12] = a[12];\n out[13] = a[13];\n out[14] = a[14];\n out[15] = a[15];\n }\n\n // Perform axis-specific matrix multiplication\n out[4] = a10 * c + a20 * s;\n out[5] = a11 * c + a21 * s;\n out[6] = a12 * c + a22 * s;\n out[7] = a13 * c + a23 * s;\n out[8] = a20 * c - a10 * s;\n out[9] = a21 * c - a11 * s;\n out[10] = a22 * c - a12 * s;\n out[11] = a23 * c - a13 * s;\n return out;\n}\n\n/**\n * Rotates a matrix by the given angle around the Y axis\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the matrix to rotate\n * @param {Number} rad the angle to rotate the matrix by\n * @returns {mat4} out\n */\nexport function rotateY(out, a, rad) {\n var s = Math.sin(rad);\n var c = Math.cos(rad);\n var a00 = a[0];\n var a01 = a[1];\n var a02 = a[2];\n var a03 = a[3];\n var a20 = a[8];\n var a21 = a[9];\n var a22 = a[10];\n var a23 = a[11];\n if (a !== out) {\n // If the source and destination differ, copy the unchanged rows\n out[4] = a[4];\n out[5] = a[5];\n out[6] = a[6];\n out[7] = a[7];\n out[12] = a[12];\n out[13] = a[13];\n out[14] = a[14];\n out[15] = a[15];\n }\n\n // Perform axis-specific matrix multiplication\n out[0] = a00 * c - a20 * s;\n out[1] = a01 * c - a21 * s;\n out[2] = a02 * c - a22 * s;\n out[3] = a03 * c - a23 * s;\n out[8] = a00 * s + a20 * c;\n out[9] = a01 * s + a21 * c;\n out[10] = a02 * s + a22 * c;\n out[11] = a03 * s + a23 * c;\n return out;\n}\n\n/**\n * Rotates a matrix by the given angle around the Z axis\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the matrix to rotate\n * @param {Number} rad the angle to rotate the matrix by\n * @returns {mat4} out\n */\nexport function rotateZ(out, a, rad) {\n var s = Math.sin(rad);\n var c = Math.cos(rad);\n var a00 = a[0];\n var a01 = a[1];\n var a02 = a[2];\n var a03 = a[3];\n var a10 = a[4];\n var a11 = a[5];\n var a12 = a[6];\n var a13 = a[7];\n if (a !== out) {\n // If the source and destination differ, copy the unchanged last row\n out[8] = a[8];\n out[9] = a[9];\n out[10] = a[10];\n out[11] = a[11];\n out[12] = a[12];\n out[13] = a[13];\n out[14] = a[14];\n out[15] = a[15];\n }\n\n // Perform axis-specific matrix multiplication\n out[0] = a00 * c + a10 * s;\n out[1] = a01 * c + a11 * s;\n out[2] = a02 * c + a12 * s;\n out[3] = a03 * c + a13 * s;\n out[4] = a10 * c - a00 * s;\n out[5] = a11 * c - a01 * s;\n out[6] = a12 * c - a02 * s;\n out[7] = a13 * c - a03 * s;\n return out;\n}\n\n/**\n * Creates a matrix from a vector translation\n * This is equivalent to (but much faster than):\n *\n * mat4.identity(dest);\n * mat4.translate(dest, dest, vec);\n *\n * @param {mat4} out mat4 receiving operation result\n * @param {ReadonlyVec3} v Translation vector\n * @returns {mat4} out\n */\nexport function fromTranslation(out, v) {\n out[0] = 1;\n out[1] = 0;\n out[2] = 0;\n out[3] = 0;\n out[4] = 0;\n out[5] = 1;\n out[6] = 0;\n out[7] = 0;\n out[8] = 0;\n out[9] = 0;\n out[10] = 1;\n out[11] = 0;\n out[12] = v[0];\n out[13] = v[1];\n out[14] = v[2];\n out[15] = 1;\n return out;\n}\n\n/**\n * Creates a matrix from a vector scaling\n * This is equivalent to (but much faster than):\n *\n * mat4.identity(dest);\n * mat4.scale(dest, dest, vec);\n *\n * @param {mat4} out mat4 receiving operation result\n * @param {ReadonlyVec3} v Scaling vector\n * @returns {mat4} out\n */\nexport function fromScaling(out, v) {\n out[0] = v[0];\n out[1] = 0;\n out[2] = 0;\n out[3] = 0;\n out[4] = 0;\n out[5] = v[1];\n out[6] = 0;\n out[7] = 0;\n out[8] = 0;\n out[9] = 0;\n out[10] = v[2];\n out[11] = 0;\n out[12] = 0;\n out[13] = 0;\n out[14] = 0;\n out[15] = 1;\n return out;\n}\n\n/**\n * Creates a matrix from a given angle around a given axis\n * This is equivalent to (but much faster than):\n *\n * mat4.identity(dest);\n * mat4.rotate(dest, dest, rad, axis);\n *\n * @param {mat4} out mat4 receiving operation result\n * @param {Number} rad the angle to rotate the matrix by\n * @param {ReadonlyVec3} axis the axis to rotate around\n * @returns {mat4} out\n */\nexport function fromRotation(out, rad, axis) {\n var x = axis[0],\n y = axis[1],\n z = axis[2];\n var len = Math.sqrt(x * x + y * y + z * z);\n var s, c, t;\n if (len < glMatrix.EPSILON) {\n return null;\n }\n len = 1 / len;\n x *= len;\n y *= len;\n z *= len;\n s = Math.sin(rad);\n c = Math.cos(rad);\n t = 1 - c;\n\n // Perform rotation-specific matrix multiplication\n out[0] = x * x * t + c;\n out[1] = y * x * t + z * s;\n out[2] = z * x * t - y * s;\n out[3] = 0;\n out[4] = x * y * t - z * s;\n out[5] = y * y * t + c;\n out[6] = z * y * t + x * s;\n out[7] = 0;\n out[8] = x * z * t + y * s;\n out[9] = y * z * t - x * s;\n out[10] = z * z * t + c;\n out[11] = 0;\n out[12] = 0;\n out[13] = 0;\n out[14] = 0;\n out[15] = 1;\n return out;\n}\n\n/**\n * Creates a matrix from the given angle around the X axis\n * This is equivalent to (but much faster than):\n *\n * mat4.identity(dest);\n * mat4.rotateX(dest, dest, rad);\n *\n * @param {mat4} out mat4 receiving operation result\n * @param {Number} rad the angle to rotate the matrix by\n * @returns {mat4} out\n */\nexport function fromXRotation(out, rad) {\n var s = Math.sin(rad);\n var c = Math.cos(rad);\n\n // Perform axis-specific matrix multiplication\n out[0] = 1;\n out[1] = 0;\n out[2] = 0;\n out[3] = 0;\n out[4] = 0;\n out[5] = c;\n out[6] = s;\n out[7] = 0;\n out[8] = 0;\n out[9] = -s;\n out[10] = c;\n out[11] = 0;\n out[12] = 0;\n out[13] = 0;\n out[14] = 0;\n out[15] = 1;\n return out;\n}\n\n/**\n * Creates a matrix from the given angle around the Y axis\n * This is equivalent to (but much faster than):\n *\n * mat4.identity(dest);\n * mat4.rotateY(dest, dest, rad);\n *\n * @param {mat4} out mat4 receiving operation result\n * @param {Number} rad the angle to rotate the matrix by\n * @returns {mat4} out\n */\nexport function fromYRotation(out, rad) {\n var s = Math.sin(rad);\n var c = Math.cos(rad);\n\n // Perform axis-specific matrix multiplication\n out[0] = c;\n out[1] = 0;\n out[2] = -s;\n out[3] = 0;\n out[4] = 0;\n out[5] = 1;\n out[6] = 0;\n out[7] = 0;\n out[8] = s;\n out[9] = 0;\n out[10] = c;\n out[11] = 0;\n out[12] = 0;\n out[13] = 0;\n out[14] = 0;\n out[15] = 1;\n return out;\n}\n\n/**\n * Creates a matrix from the given angle around the Z axis\n * This is equivalent to (but much faster than):\n *\n * mat4.identity(dest);\n * mat4.rotateZ(dest, dest, rad);\n *\n * @param {mat4} out mat4 receiving operation result\n * @param {Number} rad the angle to rotate the matrix by\n * @returns {mat4} out\n */\nexport function fromZRotation(out, rad) {\n var s = Math.sin(rad);\n var c = Math.cos(rad);\n\n // Perform axis-specific matrix multiplication\n out[0] = c;\n out[1] = s;\n out[2] = 0;\n out[3] = 0;\n out[4] = -s;\n out[5] = c;\n out[6] = 0;\n out[7] = 0;\n out[8] = 0;\n out[9] = 0;\n out[10] = 1;\n out[11] = 0;\n out[12] = 0;\n out[13] = 0;\n out[14] = 0;\n out[15] = 1;\n return out;\n}\n\n/**\n * Creates a matrix from a quaternion rotation and vector translation\n * This is equivalent to (but much faster than):\n *\n * mat4.identity(dest);\n * mat4.translate(dest, dest, vec);\n * let quatMat = mat4.create();\n * mat4.fromQuat(quatMat, quat);\n * mat4.multiply(dest, dest, quatMat);\n *\n * @param {mat4} out mat4 receiving operation result\n * @param {quat} q Rotation quaternion\n * @param {ReadonlyVec3} v Translation vector\n * @returns {mat4} out\n */\nexport function fromRotationTranslation(out, q, v) {\n // Quaternion math\n var x = q[0],\n y = q[1],\n z = q[2],\n w = q[3];\n var x2 = x + x;\n var y2 = y + y;\n var z2 = z + z;\n var xx = x * x2;\n var xy = x * y2;\n var xz = x * z2;\n var yy = y * y2;\n var yz = y * z2;\n var zz = z * z2;\n var wx = w * x2;\n var wy = w * y2;\n var wz = w * z2;\n out[0] = 1 - (yy + zz);\n out[1] = xy + wz;\n out[2] = xz - wy;\n out[3] = 0;\n out[4] = xy - wz;\n out[5] = 1 - (xx + zz);\n out[6] = yz + wx;\n out[7] = 0;\n out[8] = xz + wy;\n out[9] = yz - wx;\n out[10] = 1 - (xx + yy);\n out[11] = 0;\n out[12] = v[0];\n out[13] = v[1];\n out[14] = v[2];\n out[15] = 1;\n return out;\n}\n\n/**\n * Creates a new mat4 from a dual quat.\n *\n * @param {mat4} out Matrix\n * @param {ReadonlyQuat2} a Dual Quaternion\n * @returns {mat4} mat4 receiving operation result\n */\nexport function fromQuat2(out, a) {\n var translation = new glMatrix.ARRAY_TYPE(3);\n var bx = -a[0],\n by = -a[1],\n bz = -a[2],\n bw = a[3],\n ax = a[4],\n ay = a[5],\n az = a[6],\n aw = a[7];\n var magnitude = bx * bx + by * by + bz * bz + bw * bw;\n //Only scale if it makes sense\n if (magnitude > 0) {\n translation[0] = (ax * bw + aw * bx + ay * bz - az * by) * 2 / magnitude;\n translation[1] = (ay * bw + aw * by + az * bx - ax * bz) * 2 / magnitude;\n translation[2] = (az * bw + aw * bz + ax * by - ay * bx) * 2 / magnitude;\n } else {\n translation[0] = (ax * bw + aw * bx + ay * bz - az * by) * 2;\n translation[1] = (ay * bw + aw * by + az * bx - ax * bz) * 2;\n translation[2] = (az * bw + aw * bz + ax * by - ay * bx) * 2;\n }\n fromRotationTranslation(out, a, translation);\n return out;\n}\n\n/**\n * Returns the translation vector component of a transformation\n * matrix. If a matrix is built with fromRotationTranslation,\n * the returned vector will be the same as the translation vector\n * originally supplied.\n * @param {vec3} out Vector to receive translation component\n * @param {ReadonlyMat4} mat Matrix to be decomposed (input)\n * @return {vec3} out\n */\nexport function getTranslation(out, mat) {\n out[0] = mat[12];\n out[1] = mat[13];\n out[2] = mat[14];\n return out;\n}\n\n/**\n * Returns the scaling factor component of a transformation\n * matrix. If a matrix is built with fromRotationTranslationScale\n * with a normalized Quaternion parameter, the returned vector will be\n * the same as the scaling vector\n * originally supplied.\n * @param {vec3} out Vector to receive scaling factor component\n * @param {ReadonlyMat4} mat Matrix to be decomposed (input)\n * @return {vec3} out\n */\nexport function getScaling(out, mat) {\n var m11 = mat[0];\n var m12 = mat[1];\n var m13 = mat[2];\n var m21 = mat[4];\n var m22 = mat[5];\n var m23 = mat[6];\n var m31 = mat[8];\n var m32 = mat[9];\n var m33 = mat[10];\n out[0] = Math.sqrt(m11 * m11 + m12 * m12 + m13 * m13);\n out[1] = Math.sqrt(m21 * m21 + m22 * m22 + m23 * m23);\n out[2] = Math.sqrt(m31 * m31 + m32 * m32 + m33 * m33);\n return out;\n}\n\n/**\n * Returns a quaternion representing the rotational component\n * of a transformation matrix. If a matrix is built with\n * fromRotationTranslation, the returned quaternion will be the\n * same as the quaternion originally supplied.\n * @param {quat} out Quaternion to receive the rotation component\n * @param {ReadonlyMat4} mat Matrix to be decomposed (input)\n * @return {quat} out\n */\nexport function getRotation(out, mat) {\n var scaling = new glMatrix.ARRAY_TYPE(3);\n getScaling(scaling, mat);\n var is1 = 1 / scaling[0];\n var is2 = 1 / scaling[1];\n var is3 = 1 / scaling[2];\n var sm11 = mat[0] * is1;\n var sm12 = mat[1] * is2;\n var sm13 = mat[2] * is3;\n var sm21 = mat[4] * is1;\n var sm22 = mat[5] * is2;\n var sm23 = mat[6] * is3;\n var sm31 = mat[8] * is1;\n var sm32 = mat[9] * is2;\n var sm33 = mat[10] * is3;\n var trace = sm11 + sm22 + sm33;\n var S = 0;\n if (trace > 0) {\n S = Math.sqrt(trace + 1.0) * 2;\n out[3] = 0.25 * S;\n out[0] = (sm23 - sm32) / S;\n out[1] = (sm31 - sm13) / S;\n out[2] = (sm12 - sm21) / S;\n } else if (sm11 > sm22 && sm11 > sm33) {\n S = Math.sqrt(1.0 + sm11 - sm22 - sm33) * 2;\n out[3] = (sm23 - sm32) / S;\n out[0] = 0.25 * S;\n out[1] = (sm12 + sm21) / S;\n out[2] = (sm31 + sm13) / S;\n } else if (sm22 > sm33) {\n S = Math.sqrt(1.0 + sm22 - sm11 - sm33) * 2;\n out[3] = (sm31 - sm13) / S;\n out[0] = (sm12 + sm21) / S;\n out[1] = 0.25 * S;\n out[2] = (sm23 + sm32) / S;\n } else {\n S = Math.sqrt(1.0 + sm33 - sm11 - sm22) * 2;\n out[3] = (sm12 - sm21) / S;\n out[0] = (sm31 + sm13) / S;\n out[1] = (sm23 + sm32) / S;\n out[2] = 0.25 * S;\n }\n return out;\n}\n\n/**\n * Decomposes a transformation matrix into its rotation, translation\n * and scale components. Returns only the rotation component\n * @param {quat} out_r Quaternion to receive the rotation component\n * @param {vec3} out_t Vector to receive the translation vector\n * @param {vec3} out_s Vector to receive the scaling factor\n * @param {ReadonlyMat4} mat Matrix to be decomposed (input)\n * @returns {quat} out_r\n */\nexport function decompose(out_r, out_t, out_s, mat) {\n out_t[0] = mat[12];\n out_t[1] = mat[13];\n out_t[2] = mat[14];\n var m11 = mat[0];\n var m12 = mat[1];\n var m13 = mat[2];\n var m21 = mat[4];\n var m22 = mat[5];\n var m23 = mat[6];\n var m31 = mat[8];\n var m32 = mat[9];\n var m33 = mat[10];\n out_s[0] = Math.sqrt(m11 * m11 + m12 * m12 + m13 * m13);\n out_s[1] = Math.sqrt(m21 * m21 + m22 * m22 + m23 * m23);\n out_s[2] = Math.sqrt(m31 * m31 + m32 * m32 + m33 * m33);\n var is1 = 1 / out_s[0];\n var is2 = 1 / out_s[1];\n var is3 = 1 / out_s[2];\n var sm11 = m11 * is1;\n var sm12 = m12 * is2;\n var sm13 = m13 * is3;\n var sm21 = m21 * is1;\n var sm22 = m22 * is2;\n var sm23 = m23 * is3;\n var sm31 = m31 * is1;\n var sm32 = m32 * is2;\n var sm33 = m33 * is3;\n var trace = sm11 + sm22 + sm33;\n var S = 0;\n if (trace > 0) {\n S = Math.sqrt(trace + 1.0) * 2;\n out_r[3] = 0.25 * S;\n out_r[0] = (sm23 - sm32) / S;\n out_r[1] = (sm31 - sm13) / S;\n out_r[2] = (sm12 - sm21) / S;\n } else if (sm11 > sm22 && sm11 > sm33) {\n S = Math.sqrt(1.0 + sm11 - sm22 - sm33) * 2;\n out_r[3] = (sm23 - sm32) / S;\n out_r[0] = 0.25 * S;\n out_r[1] = (sm12 + sm21) / S;\n out_r[2] = (sm31 + sm13) / S;\n } else if (sm22 > sm33) {\n S = Math.sqrt(1.0 + sm22 - sm11 - sm33) * 2;\n out_r[3] = (sm31 - sm13) / S;\n out_r[0] = (sm12 + sm21) / S;\n out_r[1] = 0.25 * S;\n out_r[2] = (sm23 + sm32) / S;\n } else {\n S = Math.sqrt(1.0 + sm33 - sm11 - sm22) * 2;\n out_r[3] = (sm12 - sm21) / S;\n out_r[0] = (sm31 + sm13) / S;\n out_r[1] = (sm23 + sm32) / S;\n out_r[2] = 0.25 * S;\n }\n return out_r;\n}\n\n/**\n * Creates a matrix from a quaternion rotation, vector translation and vector scale\n * This is equivalent to (but much faster than):\n *\n * mat4.identity(dest);\n * mat4.translate(dest, dest, vec);\n * let quatMat = mat4.create();\n * mat4.fromQuat(quatMat, quat);\n * mat4.multiply(dest, dest, quatMat);\n * mat4.scale(dest, dest, scale)\n *\n * @param {mat4} out mat4 receiving operation result\n * @param {quat} q Rotation quaternion\n * @param {ReadonlyVec3} v Translation vector\n * @param {ReadonlyVec3} s Scaling vector\n * @returns {mat4} out\n */\nexport function fromRotationTranslationScale(out, q, v, s) {\n // Quaternion math\n var x = q[0],\n y = q[1],\n z = q[2],\n w = q[3];\n var x2 = x + x;\n var y2 = y + y;\n var z2 = z + z;\n var xx = x * x2;\n var xy = x * y2;\n var xz = x * z2;\n var yy = y * y2;\n var yz = y * z2;\n var zz = z * z2;\n var wx = w * x2;\n var wy = w * y2;\n var wz = w * z2;\n var sx = s[0];\n var sy = s[1];\n var sz = s[2];\n out[0] = (1 - (yy + zz)) * sx;\n out[1] = (xy + wz) * sx;\n out[2] = (xz - wy) * sx;\n out[3] = 0;\n out[4] = (xy - wz) * sy;\n out[5] = (1 - (xx + zz)) * sy;\n out[6] = (yz + wx) * sy;\n out[7] = 0;\n out[8] = (xz + wy) * sz;\n out[9] = (yz - wx) * sz;\n out[10] = (1 - (xx + yy)) * sz;\n out[11] = 0;\n out[12] = v[0];\n out[13] = v[1];\n out[14] = v[2];\n out[15] = 1;\n return out;\n}\n\n/**\n * Creates a matrix from a quaternion rotation, vector translation and vector scale, rotating and scaling around the given origin\n * This is equivalent to (but much faster than):\n *\n * mat4.identity(dest);\n * mat4.translate(dest, dest, vec);\n * mat4.translate(dest, dest, origin);\n * let quatMat = mat4.create();\n * mat4.fromQuat(quatMat, quat);\n * mat4.multiply(dest, dest, quatMat);\n * mat4.scale(dest, dest, scale)\n * mat4.translate(dest, dest, negativeOrigin);\n *\n * @param {mat4} out mat4 receiving operation result\n * @param {quat} q Rotation quaternion\n * @param {ReadonlyVec3} v Translation vector\n * @param {ReadonlyVec3} s Scaling vector\n * @param {ReadonlyVec3} o The origin vector around which to scale and rotate\n * @returns {mat4} out\n */\nexport function fromRotationTranslationScaleOrigin(out, q, v, s, o) {\n // Quaternion math\n var x = q[0],\n y = q[1],\n z = q[2],\n w = q[3];\n var x2 = x + x;\n var y2 = y + y;\n var z2 = z + z;\n var xx = x * x2;\n var xy = x * y2;\n var xz = x * z2;\n var yy = y * y2;\n var yz = y * z2;\n var zz = z * z2;\n var wx = w * x2;\n var wy = w * y2;\n var wz = w * z2;\n var sx = s[0];\n var sy = s[1];\n var sz = s[2];\n var ox = o[0];\n var oy = o[1];\n var oz = o[2];\n var out0 = (1 - (yy + zz)) * sx;\n var out1 = (xy + wz) * sx;\n var out2 = (xz - wy) * sx;\n var out4 = (xy - wz) * sy;\n var out5 = (1 - (xx + zz)) * sy;\n var out6 = (yz + wx) * sy;\n var out8 = (xz + wy) * sz;\n var out9 = (yz - wx) * sz;\n var out10 = (1 - (xx + yy)) * sz;\n out[0] = out0;\n out[1] = out1;\n out[2] = out2;\n out[3] = 0;\n out[4] = out4;\n out[5] = out5;\n out[6] = out6;\n out[7] = 0;\n out[8] = out8;\n out[9] = out9;\n out[10] = out10;\n out[11] = 0;\n out[12] = v[0] + ox - (out0 * ox + out4 * oy + out8 * oz);\n out[13] = v[1] + oy - (out1 * ox + out5 * oy + out9 * oz);\n out[14] = v[2] + oz - (out2 * ox + out6 * oy + out10 * oz);\n out[15] = 1;\n return out;\n}\n\n/**\n * Calculates a 4x4 matrix from the given quaternion\n *\n * @param {mat4} out mat4 receiving operation result\n * @param {ReadonlyQuat} q Quaternion to create matrix from\n *\n * @returns {mat4} out\n */\nexport function fromQuat(out, q) {\n var x = q[0],\n y = q[1],\n z = q[2],\n w = q[3];\n var x2 = x + x;\n var y2 = y + y;\n var z2 = z + z;\n var xx = x * x2;\n var yx = y * x2;\n var yy = y * y2;\n var zx = z * x2;\n var zy = z * y2;\n var zz = z * z2;\n var wx = w * x2;\n var wy = w * y2;\n var wz = w * z2;\n out[0] = 1 - yy - zz;\n out[1] = yx + wz;\n out[2] = zx - wy;\n out[3] = 0;\n out[4] = yx - wz;\n out[5] = 1 - xx - zz;\n out[6] = zy + wx;\n out[7] = 0;\n out[8] = zx + wy;\n out[9] = zy - wx;\n out[10] = 1 - xx - yy;\n out[11] = 0;\n out[12] = 0;\n out[13] = 0;\n out[14] = 0;\n out[15] = 1;\n return out;\n}\n\n/**\n * Generates a frustum matrix with the given bounds\n *\n * @param {mat4} out mat4 frustum matrix will be written into\n * @param {Number} left Left bound of the frustum\n * @param {Number} right Right bound of the frustum\n * @param {Number} bottom Bottom bound of the frustum\n * @param {Number} top Top bound of the frustum\n * @param {Number} near Near bound of the frustum\n * @param {Number} far Far bound of the frustum\n * @returns {mat4} out\n */\nexport function frustum(out, left, right, bottom, top, near, far) {\n var rl = 1 / (right - left);\n var tb = 1 / (top - bottom);\n var nf = 1 / (near - far);\n out[0] = near * 2 * rl;\n out[1] = 0;\n out[2] = 0;\n out[3] = 0;\n out[4] = 0;\n out[5] = near * 2 * tb;\n out[6] = 0;\n out[7] = 0;\n out[8] = (right + left) * rl;\n out[9] = (top + bottom) * tb;\n out[10] = (far + near) * nf;\n out[11] = -1;\n out[12] = 0;\n out[13] = 0;\n out[14] = far * near * 2 * nf;\n out[15] = 0;\n return out;\n}\n\n/**\n * Generates a perspective projection matrix with the given bounds.\n * The near/far clip planes correspond to a normalized device coordinate Z range of [-1, 1],\n * which matches WebGL/OpenGL's clip volume.\n * Passing null/undefined/no value for far will generate infinite projection matrix.\n *\n * @param {mat4} out mat4 frustum matrix will be written into\n * @param {number} fovy Vertical field of view in radians\n * @param {number} aspect Aspect ratio. typically viewport width/height\n * @param {number} near Near bound of the frustum\n * @param {number} far Far bound of the frustum, can be null or Infinity\n * @returns {mat4} out\n */\nexport function perspectiveNO(out, fovy, aspect, near, far) {\n var f = 1.0 / Math.tan(fovy / 2);\n out[0] = f / aspect;\n out[1] = 0;\n out[2] = 0;\n out[3] = 0;\n out[4] = 0;\n out[5] = f;\n out[6] = 0;\n out[7] = 0;\n out[8] = 0;\n out[9] = 0;\n out[11] = -1;\n out[12] = 0;\n out[13] = 0;\n out[15] = 0;\n if (far != null && far !== Infinity) {\n var nf = 1 / (near - far);\n out[10] = (far + near) * nf;\n out[14] = 2 * far * near * nf;\n } else {\n out[10] = -1;\n out[14] = -2 * near;\n }\n return out;\n}\n\n/**\n * Alias for {@link mat4.perspectiveNO}\n * @function\n */\nexport var perspective = perspectiveNO;\n\n/**\n * Generates a perspective projection matrix suitable for WebGPU with the given bounds.\n * The near/far clip planes correspond to a normalized device coordinate Z range of [0, 1],\n * which matches WebGPU/Vulkan/DirectX/Metal's clip volume.\n * Passing null/undefined/no value for far will generate infinite projection matrix.\n *\n * @param {mat4} out mat4 frustum matrix will be written into\n * @param {number} fovy Vertical field of view in radians\n * @param {number} aspect Aspect ratio. typically viewport width/height\n * @param {number} near Near bound of the frustum\n * @param {number} far Far bound of the frustum, can be null or Infinity\n * @returns {mat4} out\n */\nexport function perspectiveZO(out, fovy, aspect, near, far) {\n var f = 1.0 / Math.tan(fovy / 2);\n out[0] = f / aspect;\n out[1] = 0;\n out[2] = 0;\n out[3] = 0;\n out[4] = 0;\n out[5] = f;\n out[6] = 0;\n out[7] = 0;\n out[8] = 0;\n out[9] = 0;\n out[11] = -1;\n out[12] = 0;\n out[13] = 0;\n out[15] = 0;\n if (far != null && far !== Infinity) {\n var nf = 1 / (near - far);\n out[10] = far * nf;\n out[14] = far * near * nf;\n } else {\n out[10] = -1;\n out[14] = -near;\n }\n return out;\n}\n\n/**\n * Generates a perspective projection matrix with the given field of view.\n * This is primarily useful for generating projection matrices to be used\n * with the still experiemental WebVR API.\n *\n * @param {mat4} out mat4 frustum matrix will be written into\n * @param {Object} fov Object containing the following values: upDegrees, downDegrees, leftDegrees, rightDegrees\n * @param {number} near Near bound of the frustum\n * @param {number} far Far bound of the frustum\n * @returns {mat4} out\n */\nexport function perspectiveFromFieldOfView(out, fov, near, far) {\n var upTan = Math.tan(fov.upDegrees * Math.PI / 180.0);\n var downTan = Math.tan(fov.downDegrees * Math.PI / 180.0);\n var leftTan = Math.tan(fov.leftDegrees * Math.PI / 180.0);\n var rightTan = Math.tan(fov.rightDegrees * Math.PI / 180.0);\n var xScale = 2.0 / (leftTan + rightTan);\n var yScale = 2.0 / (upTan + downTan);\n out[0] = xScale;\n out[1] = 0.0;\n out[2] = 0.0;\n out[3] = 0.0;\n out[4] = 0.0;\n out[5] = yScale;\n out[6] = 0.0;\n out[7] = 0.0;\n out[8] = -((leftTan - rightTan) * xScale * 0.5);\n out[9] = (upTan - downTan) * yScale * 0.5;\n out[10] = far / (near - far);\n out[11] = -1.0;\n out[12] = 0.0;\n out[13] = 0.0;\n out[14] = far * near / (near - far);\n out[15] = 0.0;\n return out;\n}\n\n/**\n * Generates a orthogonal projection matrix with the given bounds.\n * The near/far clip planes correspond to a normalized device coordinate Z range of [-1, 1],\n * which matches WebGL/OpenGL's clip volume.\n *\n * @param {mat4} out mat4 frustum matrix will be written into\n * @param {number} left Left bound of the frustum\n * @param {number} right Right bound of the frustum\n * @param {number} bottom Bottom bound of the frustum\n * @param {number} top Top bound of the frustum\n * @param {number} near Near bound of the frustum\n * @param {number} far Far bound of the frustum\n * @returns {mat4} out\n */\nexport function orthoNO(out, left, right, bottom, top, near, far) {\n var lr = 1 / (left - right);\n var bt = 1 / (bottom - top);\n var nf = 1 / (near - far);\n out[0] = -2 * lr;\n out[1] = 0;\n out[2] = 0;\n out[3] = 0;\n out[4] = 0;\n out[5] = -2 * bt;\n out[6] = 0;\n out[7] = 0;\n out[8] = 0;\n out[9] = 0;\n out[10] = 2 * nf;\n out[11] = 0;\n out[12] = (left + right) * lr;\n out[13] = (top + bottom) * bt;\n out[14] = (far + near) * nf;\n out[15] = 1;\n return out;\n}\n\n/**\n * Alias for {@link mat4.orthoNO}\n * @function\n */\nexport var ortho = orthoNO;\n\n/**\n * Generates a orthogonal projection matrix with the given bounds.\n * The near/far clip planes correspond to a normalized device coordinate Z range of [0, 1],\n * which matches WebGPU/Vulkan/DirectX/Metal's clip volume.\n *\n * @param {mat4} out mat4 frustum matrix will be written into\n * @param {number} left Left bound of the frustum\n * @param {number} right Right bound of the frustum\n * @param {number} bottom Bottom bound of the frustum\n * @param {number} top Top bound of the frustum\n * @param {number} near Near bound of the frustum\n * @param {number} far Far bound of the frustum\n * @returns {mat4} out\n */\nexport function orthoZO(out, left, right, bottom, top, near, far) {\n var lr = 1 / (left - right);\n var bt = 1 / (bottom - top);\n var nf = 1 / (near - far);\n out[0] = -2 * lr;\n out[1] = 0;\n out[2] = 0;\n out[3] = 0;\n out[4] = 0;\n out[5] = -2 * bt;\n out[6] = 0;\n out[7] = 0;\n out[8] = 0;\n out[9] = 0;\n out[10] = nf;\n out[11] = 0;\n out[12] = (left + right) * lr;\n out[13] = (top + bottom) * bt;\n out[14] = near * nf;\n out[15] = 1;\n return out;\n}\n\n/**\n * Generates a look-at matrix with the given eye position, focal point, and up axis.\n * If you want a matrix that actually makes an object look at another object, you should use targetTo instead.\n *\n * @param {mat4} out mat4 frustum matrix will be written into\n * @param {ReadonlyVec3} eye Position of the viewer\n * @param {ReadonlyVec3} center Point the viewer is looking at\n * @param {ReadonlyVec3} up vec3 pointing up\n * @returns {mat4} out\n */\nexport function lookAt(out, eye, center, up) {\n var x0, x1, x2, y0, y1, y2, z0, z1, z2, len;\n var eyex = eye[0];\n var eyey = eye[1];\n var eyez = eye[2];\n var upx = up[0];\n var upy = up[1];\n var upz = up[2];\n var centerx = center[0];\n var centery = center[1];\n var centerz = center[2];\n if (Math.abs(eyex - centerx) < glMatrix.EPSILON && Math.abs(eyey - centery) < glMatrix.EPSILON && Math.abs(eyez - centerz) < glMatrix.EPSILON) {\n return identity(out);\n }\n z0 = eyex - centerx;\n z1 = eyey - centery;\n z2 = eyez - centerz;\n len = 1 / Math.sqrt(z0 * z0 + z1 * z1 + z2 * z2);\n z0 *= len;\n z1 *= len;\n z2 *= len;\n x0 = upy * z2 - upz * z1;\n x1 = upz * z0 - upx * z2;\n x2 = upx * z1 - upy * z0;\n len = Math.sqrt(x0 * x0 + x1 * x1 + x2 * x2);\n if (!len) {\n x0 = 0;\n x1 = 0;\n x2 = 0;\n } else {\n len = 1 / len;\n x0 *= len;\n x1 *= len;\n x2 *= len;\n }\n y0 = z1 * x2 - z2 * x1;\n y1 = z2 * x0 - z0 * x2;\n y2 = z0 * x1 - z1 * x0;\n len = Math.sqrt(y0 * y0 + y1 * y1 + y2 * y2);\n if (!len) {\n y0 = 0;\n y1 = 0;\n y2 = 0;\n } else {\n len = 1 / len;\n y0 *= len;\n y1 *= len;\n y2 *= len;\n }\n out[0] = x0;\n out[1] = y0;\n out[2] = z0;\n out[3] = 0;\n out[4] = x1;\n out[5] = y1;\n out[6] = z1;\n out[7] = 0;\n out[8] = x2;\n out[9] = y2;\n out[10] = z2;\n out[11] = 0;\n out[12] = -(x0 * eyex + x1 * eyey + x2 * eyez);\n out[13] = -(y0 * eyex + y1 * eyey + y2 * eyez);\n out[14] = -(z0 * eyex + z1 * eyey + z2 * eyez);\n out[15] = 1;\n return out;\n}\n\n/**\n * Generates a matrix that makes something look at something else.\n *\n * @param {mat4} out mat4 frustum matrix will be written into\n * @param {ReadonlyVec3} eye Position of the viewer\n * @param {ReadonlyVec3} target Point the viewer is looking at\n * @param {ReadonlyVec3} up vec3 pointing up\n * @returns {mat4} out\n */\nexport function targetTo(out, eye, target, up) {\n var eyex = eye[0],\n eyey = eye[1],\n eyez = eye[2],\n upx = up[0],\n upy = up[1],\n upz = up[2];\n var z0 = eyex - target[0],\n z1 = eyey - target[1],\n z2 = eyez - target[2];\n var len = z0 * z0 + z1 * z1 + z2 * z2;\n if (len > 0) {\n len = 1 / Math.sqrt(len);\n z0 *= len;\n z1 *= len;\n z2 *= len;\n }\n var x0 = upy * z2 - upz * z1,\n x1 = upz * z0 - upx * z2,\n x2 = upx * z1 - upy * z0;\n len = x0 * x0 + x1 * x1 + x2 * x2;\n if (len > 0) {\n len = 1 / Math.sqrt(len);\n x0 *= len;\n x1 *= len;\n x2 *= len;\n }\n out[0] = x0;\n out[1] = x1;\n out[2] = x2;\n out[3] = 0;\n out[4] = z1 * x2 - z2 * x1;\n out[5] = z2 * x0 - z0 * x2;\n out[6] = z0 * x1 - z1 * x0;\n out[7] = 0;\n out[8] = z0;\n out[9] = z1;\n out[10] = z2;\n out[11] = 0;\n out[12] = eyex;\n out[13] = eyey;\n out[14] = eyez;\n out[15] = 1;\n return out;\n}\n\n/**\n * Returns a string representation of a mat4\n *\n * @param {ReadonlyMat4} a matrix to represent as a string\n * @returns {String} string representation of the matrix\n */\nexport function str(a) {\n return \"mat4(\" + a[0] + \", \" + a[1] + \", \" + a[2] + \", \" + a[3] + \", \" + a[4] + \", \" + a[5] + \", \" + a[6] + \", \" + a[7] + \", \" + a[8] + \", \" + a[9] + \", \" + a[10] + \", \" + a[11] + \", \" + a[12] + \", \" + a[13] + \", \" + a[14] + \", \" + a[15] + \")\";\n}\n\n/**\n * Returns Frobenius norm of a mat4\n *\n * @param {ReadonlyMat4} a the matrix to calculate Frobenius norm of\n * @returns {Number} Frobenius norm\n */\nexport function frob(a) {\n return Math.sqrt(a[0] * a[0] + a[1] * a[1] + a[2] * a[2] + a[3] * a[3] + a[4] * a[4] + a[5] * a[5] + a[6] * a[6] + a[7] * a[7] + a[8] * a[8] + a[9] * a[9] + a[10] * a[10] + a[11] * a[11] + a[12] * a[12] + a[13] * a[13] + a[14] * a[14] + a[15] * a[15]);\n}\n\n/**\n * Adds two mat4's\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the first operand\n * @param {ReadonlyMat4} b the second operand\n * @returns {mat4} out\n */\nexport function add(out, a, b) {\n out[0] = a[0] + b[0];\n out[1] = a[1] + b[1];\n out[2] = a[2] + b[2];\n out[3] = a[3] + b[3];\n out[4] = a[4] + b[4];\n out[5] = a[5] + b[5];\n out[6] = a[6] + b[6];\n out[7] = a[7] + b[7];\n out[8] = a[8] + b[8];\n out[9] = a[9] + b[9];\n out[10] = a[10] + b[10];\n out[11] = a[11] + b[11];\n out[12] = a[12] + b[12];\n out[13] = a[13] + b[13];\n out[14] = a[14] + b[14];\n out[15] = a[15] + b[15];\n return out;\n}\n\n/**\n * Subtracts matrix b from matrix a\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the first operand\n * @param {ReadonlyMat4} b the second operand\n * @returns {mat4} out\n */\nexport function subtract(out, a, b) {\n out[0] = a[0] - b[0];\n out[1] = a[1] - b[1];\n out[2] = a[2] - b[2];\n out[3] = a[3] - b[3];\n out[4] = a[4] - b[4];\n out[5] = a[5] - b[5];\n out[6] = a[6] - b[6];\n out[7] = a[7] - b[7];\n out[8] = a[8] - b[8];\n out[9] = a[9] - b[9];\n out[10] = a[10] - b[10];\n out[11] = a[11] - b[11];\n out[12] = a[12] - b[12];\n out[13] = a[13] - b[13];\n out[14] = a[14] - b[14];\n out[15] = a[15] - b[15];\n return out;\n}\n\n/**\n * Multiply each element of the matrix by a scalar.\n *\n * @param {mat4} out the receiving matrix\n * @param {ReadonlyMat4} a the matrix to scale\n * @param {Number} b amount to scale the matrix's elements by\n * @returns {mat4} out\n */\nexport function multiplyScalar(out, a, b) {\n out[0] = a[0] * b;\n out[1] = a[1] * b;\n out[2] = a[2] * b;\n out[3] = a[3] * b;\n out[4] = a[4] * b;\n out[5] = a[5] * b;\n out[6] = a[6] * b;\n out[7] = a[7] * b;\n out[8] = a[8] * b;\n out[9] = a[9] * b;\n out[10] = a[10] * b;\n out[11] = a[11] * b;\n out[12] = a[12] * b;\n out[13] = a[13] * b;\n out[14] = a[14] * b;\n out[15] = a[15] * b;\n return out;\n}\n\n/**\n * Adds two mat4's after multiplying each element of the second operand by a scalar value.\n *\n * @param {mat4} out the receiving vector\n * @param {ReadonlyMat4} a the first operand\n * @param {ReadonlyMat4} b the second operand\n * @param {Number} scale the amount to scale b's elements by before adding\n * @returns {mat4} out\n */\nexport function multiplyScalarAndAdd(out, a, b, scale) {\n out[0] = a[0] + b[0] * scale;\n out[1] = a[1] + b[1] * scale;\n out[2] = a[2] + b[2] * scale;\n out[3] = a[3] + b[3] * scale;\n out[4] = a[4] + b[4] * scale;\n out[5] = a[5] + b[5] * scale;\n out[6] = a[6] + b[6] * scale;\n out[7] = a[7] + b[7] * scale;\n out[8] = a[8] + b[8] * scale;\n out[9] = a[9] + b[9] * scale;\n out[10] = a[10] + b[10] * scale;\n out[11] = a[11] + b[11] * scale;\n out[12] = a[12] + b[12] * scale;\n out[13] = a[13] + b[13] * scale;\n out[14] = a[14] + b[14] * scale;\n out[15] = a[15] + b[15] * scale;\n return out;\n}\n\n/**\n * Returns whether or not the matrices have exactly the same elements in the same position (when compared with ===)\n *\n * @param {ReadonlyMat4} a The first matrix.\n * @param {ReadonlyMat4} b The second matrix.\n * @returns {Boolean} True if the matrices are equal, false otherwise.\n */\nexport function exactEquals(a, b) {\n return a[0] === b[0] && a[1] === b[1] && a[2] === b[2] && a[3] === b[3] && a[4] === b[4] && a[5] === b[5] && a[6] === b[6] && a[7] === b[7] && a[8] === b[8] && a[9] === b[9] && a[10] === b[10] && a[11] === b[11] && a[12] === b[12] && a[13] === b[13] && a[14] === b[14] && a[15] === b[15];\n}\n\n/**\n * Returns whether or not the matrices have approximately the same elements in the same position.\n *\n * @param {ReadonlyMat4} a The first matrix.\n * @param {ReadonlyMat4} b The second matrix.\n * @returns {Boolean} True if the matrices are equal, false otherwise.\n */\nexport function equals(a, b) {\n var a0 = a[0],\n a1 = a[1],\n a2 = a[2],\n a3 = a[3];\n var a4 = a[4],\n a5 = a[5],\n a6 = a[6],\n a7 = a[7];\n var a8 = a[8],\n a9 = a[9],\n a10 = a[10],\n a11 = a[11];\n var a12 = a[12],\n a13 = a[13],\n a14 = a[14],\n a15 = a[15];\n var b0 = b[0],\n b1 = b[1],\n b2 = b[2],\n b3 = b[3];\n var b4 = b[4],\n b5 = b[5],\n b6 = b[6],\n b7 = b[7];\n var b8 = b[8],\n b9 = b[9],\n b10 = b[10],\n b11 = b[11];\n var b12 = b[12],\n b13 = b[13],\n b14 = b[14],\n b15 = b[15];\n return Math.abs(a0 - b0) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1)) && Math.abs(a2 - b2) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a2), Math.abs(b2)) && Math.abs(a3 - b3) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a3), Math.abs(b3)) && Math.abs(a4 - b4) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a4), Math.abs(b4)) && Math.abs(a5 - b5) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a5), Math.abs(b5)) && Math.abs(a6 - b6) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a6), Math.abs(b6)) && Math.abs(a7 - b7) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a7), Math.abs(b7)) && Math.abs(a8 - b8) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a8), Math.abs(b8)) && Math.abs(a9 - b9) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a9), Math.abs(b9)) && Math.abs(a10 - b10) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a10), Math.abs(b10)) && Math.abs(a11 - b11) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a11), Math.abs(b11)) && Math.abs(a12 - b12) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a12), Math.abs(b12)) && Math.abs(a13 - b13) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a13), Math.abs(b13)) && Math.abs(a14 - b14) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a14), Math.abs(b14)) && Math.abs(a15 - b15) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a15), Math.abs(b15));\n}\n\n/**\n * Alias for {@link mat4.multiply}\n * @function\n */\nexport var mul = multiply;\n\n/**\n * Alias for {@link mat4.subtract}\n * @function\n */\nexport var sub = subtract;","import * as glMatrix from \"./common.js\";\n\n/**\n * 3 Dimensional Vector\n * @module vec3\n */\n\n/**\n * Creates a new, empty vec3\n *\n * @returns {vec3} a new 3D vector\n */\nexport function create() {\n var out = new glMatrix.ARRAY_TYPE(3);\n if (glMatrix.ARRAY_TYPE != Float32Array) {\n out[0] = 0;\n out[1] = 0;\n out[2] = 0;\n }\n return out;\n}\n\n/**\n * Creates a new vec3 initialized with values from an existing vector\n *\n * @param {ReadonlyVec3} a vector to clone\n * @returns {vec3} a new 3D vector\n */\nexport function clone(a) {\n var out = new glMatrix.ARRAY_TYPE(3);\n out[0] = a[0];\n out[1] = a[1];\n out[2] = a[2];\n return out;\n}\n\n/**\n * Calculates the length of a vec3\n *\n * @param {ReadonlyVec3} a vector to calculate length of\n * @returns {Number} length of a\n */\nexport function length(a) {\n var x = a[0];\n var y = a[1];\n var z = a[2];\n return Math.sqrt(x * x + y * y + z * z);\n}\n\n/**\n * Creates a new vec3 initialized with the given values\n *\n * @param {Number} x X component\n * @param {Number} y Y component\n * @param {Number} z Z component\n * @returns {vec3} a new 3D vector\n */\nexport function fromValues(x, y, z) {\n var out = new glMatrix.ARRAY_TYPE(3);\n out[0] = x;\n out[1] = y;\n out[2] = z;\n return out;\n}\n\n/**\n * Copy the values from one vec3 to another\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the source vector\n * @returns {vec3} out\n */\nexport function copy(out, a) {\n out[0] = a[0];\n out[1] = a[1];\n out[2] = a[2];\n return out;\n}\n\n/**\n * Set the components of a vec3 to the given values\n *\n * @param {vec3} out the receiving vector\n * @param {Number} x X component\n * @param {Number} y Y component\n * @param {Number} z Z component\n * @returns {vec3} out\n */\nexport function set(out, x, y, z) {\n out[0] = x;\n out[1] = y;\n out[2] = z;\n return out;\n}\n\n/**\n * Adds two vec3's\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @returns {vec3} out\n */\nexport function add(out, a, b) {\n out[0] = a[0] + b[0];\n out[1] = a[1] + b[1];\n out[2] = a[2] + b[2];\n return out;\n}\n\n/**\n * Subtracts vector b from vector a\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @returns {vec3} out\n */\nexport function subtract(out, a, b) {\n out[0] = a[0] - b[0];\n out[1] = a[1] - b[1];\n out[2] = a[2] - b[2];\n return out;\n}\n\n/**\n * Multiplies two vec3's\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @returns {vec3} out\n */\nexport function multiply(out, a, b) {\n out[0] = a[0] * b[0];\n out[1] = a[1] * b[1];\n out[2] = a[2] * b[2];\n return out;\n}\n\n/**\n * Divides two vec3's\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @returns {vec3} out\n */\nexport function divide(out, a, b) {\n out[0] = a[0] / b[0];\n out[1] = a[1] / b[1];\n out[2] = a[2] / b[2];\n return out;\n}\n\n/**\n * Math.ceil the components of a vec3\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a vector to ceil\n * @returns {vec3} out\n */\nexport function ceil(out, a) {\n out[0] = Math.ceil(a[0]);\n out[1] = Math.ceil(a[1]);\n out[2] = Math.ceil(a[2]);\n return out;\n}\n\n/**\n * Math.floor the components of a vec3\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a vector to floor\n * @returns {vec3} out\n */\nexport function floor(out, a) {\n out[0] = Math.floor(a[0]);\n out[1] = Math.floor(a[1]);\n out[2] = Math.floor(a[2]);\n return out;\n}\n\n/**\n * Returns the minimum of two vec3's\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @returns {vec3} out\n */\nexport function min(out, a, b) {\n out[0] = Math.min(a[0], b[0]);\n out[1] = Math.min(a[1], b[1]);\n out[2] = Math.min(a[2], b[2]);\n return out;\n}\n\n/**\n * Returns the maximum of two vec3's\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @returns {vec3} out\n */\nexport function max(out, a, b) {\n out[0] = Math.max(a[0], b[0]);\n out[1] = Math.max(a[1], b[1]);\n out[2] = Math.max(a[2], b[2]);\n return out;\n}\n\n/**\n * symmetric round the components of a vec3\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a vector to round\n * @returns {vec3} out\n */\nexport function round(out, a) {\n out[0] = glMatrix.round(a[0]);\n out[1] = glMatrix.round(a[1]);\n out[2] = glMatrix.round(a[2]);\n return out;\n}\n\n/**\n * Scales a vec3 by a scalar number\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the vector to scale\n * @param {Number} b amount to scale the vector by\n * @returns {vec3} out\n */\nexport function scale(out, a, b) {\n out[0] = a[0] * b;\n out[1] = a[1] * b;\n out[2] = a[2] * b;\n return out;\n}\n\n/**\n * Adds two vec3's after scaling the second operand by a scalar value\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @param {Number} scale the amount to scale b by before adding\n * @returns {vec3} out\n */\nexport function scaleAndAdd(out, a, b, scale) {\n out[0] = a[0] + b[0] * scale;\n out[1] = a[1] + b[1] * scale;\n out[2] = a[2] + b[2] * scale;\n return out;\n}\n\n/**\n * Calculates the euclidian distance between two vec3's\n *\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @returns {Number} distance between a and b\n */\nexport function distance(a, b) {\n var x = b[0] - a[0];\n var y = b[1] - a[1];\n var z = b[2] - a[2];\n return Math.sqrt(x * x + y * y + z * z);\n}\n\n/**\n * Calculates the squared euclidian distance between two vec3's\n *\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @returns {Number} squared distance between a and b\n */\nexport function squaredDistance(a, b) {\n var x = b[0] - a[0];\n var y = b[1] - a[1];\n var z = b[2] - a[2];\n return x * x + y * y + z * z;\n}\n\n/**\n * Calculates the squared length of a vec3\n *\n * @param {ReadonlyVec3} a vector to calculate squared length of\n * @returns {Number} squared length of a\n */\nexport function squaredLength(a) {\n var x = a[0];\n var y = a[1];\n var z = a[2];\n return x * x + y * y + z * z;\n}\n\n/**\n * Negates the components of a vec3\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a vector to negate\n * @returns {vec3} out\n */\nexport function negate(out, a) {\n out[0] = -a[0];\n out[1] = -a[1];\n out[2] = -a[2];\n return out;\n}\n\n/**\n * Returns the inverse of the components of a vec3\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a vector to invert\n * @returns {vec3} out\n */\nexport function inverse(out, a) {\n out[0] = 1.0 / a[0];\n out[1] = 1.0 / a[1];\n out[2] = 1.0 / a[2];\n return out;\n}\n\n/**\n * Normalize a vec3\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a vector to normalize\n * @returns {vec3} out\n */\nexport function normalize(out, a) {\n var x = a[0];\n var y = a[1];\n var z = a[2];\n var len = x * x + y * y + z * z;\n if (len > 0) {\n //TODO: evaluate use of glm_invsqrt here?\n len = 1 / Math.sqrt(len);\n }\n out[0] = a[0] * len;\n out[1] = a[1] * len;\n out[2] = a[2] * len;\n return out;\n}\n\n/**\n * Calculates the dot product of two vec3's\n *\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @returns {Number} dot product of a and b\n */\nexport function dot(a, b) {\n return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];\n}\n\n/**\n * Computes the cross product of two vec3's\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @returns {vec3} out\n */\nexport function cross(out, a, b) {\n var ax = a[0],\n ay = a[1],\n az = a[2];\n var bx = b[0],\n by = b[1],\n bz = b[2];\n out[0] = ay * bz - az * by;\n out[1] = az * bx - ax * bz;\n out[2] = ax * by - ay * bx;\n return out;\n}\n\n/**\n * Performs a linear interpolation between two vec3's\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\n * @returns {vec3} out\n */\nexport function lerp(out, a, b, t) {\n var ax = a[0];\n var ay = a[1];\n var az = a[2];\n out[0] = ax + t * (b[0] - ax);\n out[1] = ay + t * (b[1] - ay);\n out[2] = az + t * (b[2] - az);\n return out;\n}\n\n/**\n * Performs a spherical linear interpolation between two vec3's\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\n * @returns {vec3} out\n */\nexport function slerp(out, a, b, t) {\n var angle = Math.acos(Math.min(Math.max(dot(a, b), -1), 1));\n var sinTotal = Math.sin(angle);\n var ratioA = Math.sin((1 - t) * angle) / sinTotal;\n var ratioB = Math.sin(t * angle) / sinTotal;\n out[0] = ratioA * a[0] + ratioB * b[0];\n out[1] = ratioA * a[1] + ratioB * b[1];\n out[2] = ratioA * a[2] + ratioB * b[2];\n return out;\n}\n\n/**\n * Performs a hermite interpolation with two control points\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @param {ReadonlyVec3} c the third operand\n * @param {ReadonlyVec3} d the fourth operand\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\n * @returns {vec3} out\n */\nexport function hermite(out, a, b, c, d, t) {\n var factorTimes2 = t * t;\n var factor1 = factorTimes2 * (2 * t - 3) + 1;\n var factor2 = factorTimes2 * (t - 2) + t;\n var factor3 = factorTimes2 * (t - 1);\n var factor4 = factorTimes2 * (3 - 2 * t);\n out[0] = a[0] * factor1 + b[0] * factor2 + c[0] * factor3 + d[0] * factor4;\n out[1] = a[1] * factor1 + b[1] * factor2 + c[1] * factor3 + d[1] * factor4;\n out[2] = a[2] * factor1 + b[2] * factor2 + c[2] * factor3 + d[2] * factor4;\n return out;\n}\n\n/**\n * Performs a bezier interpolation with two control points\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the first operand\n * @param {ReadonlyVec3} b the second operand\n * @param {ReadonlyVec3} c the third operand\n * @param {ReadonlyVec3} d the fourth operand\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\n * @returns {vec3} out\n */\nexport function bezier(out, a, b, c, d, t) {\n var inverseFactor = 1 - t;\n var inverseFactorTimesTwo = inverseFactor * inverseFactor;\n var factorTimes2 = t * t;\n var factor1 = inverseFactorTimesTwo * inverseFactor;\n var factor2 = 3 * t * inverseFactorTimesTwo;\n var factor3 = 3 * factorTimes2 * inverseFactor;\n var factor4 = factorTimes2 * t;\n out[0] = a[0] * factor1 + b[0] * factor2 + c[0] * factor3 + d[0] * factor4;\n out[1] = a[1] * factor1 + b[1] * factor2 + c[1] * factor3 + d[1] * factor4;\n out[2] = a[2] * factor1 + b[2] * factor2 + c[2] * factor3 + d[2] * factor4;\n return out;\n}\n\n/**\n * Generates a random vector with the given scale\n *\n * @param {vec3} out the receiving vector\n * @param {Number} [scale] Length of the resulting vector. If omitted, a unit vector will be returned\n * @returns {vec3} out\n */\nexport function random(out, scale) {\n scale = scale === undefined ? 1.0 : scale;\n var r = glMatrix.RANDOM() * 2.0 * Math.PI;\n var z = glMatrix.RANDOM() * 2.0 - 1.0;\n var zScale = Math.sqrt(1.0 - z * z) * scale;\n out[0] = Math.cos(r) * zScale;\n out[1] = Math.sin(r) * zScale;\n out[2] = z * scale;\n return out;\n}\n\n/**\n * Transforms the vec3 with a mat4.\n * 4th vector component is implicitly '1'\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the vector to transform\n * @param {ReadonlyMat4} m matrix to transform with\n * @returns {vec3} out\n */\nexport function transformMat4(out, a, m) {\n var x = a[0],\n y = a[1],\n z = a[2];\n var w = m[3] * x + m[7] * y + m[11] * z + m[15];\n w = w || 1.0;\n out[0] = (m[0] * x + m[4] * y + m[8] * z + m[12]) / w;\n out[1] = (m[1] * x + m[5] * y + m[9] * z + m[13]) / w;\n out[2] = (m[2] * x + m[6] * y + m[10] * z + m[14]) / w;\n return out;\n}\n\n/**\n * Transforms the vec3 with a mat3.\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the vector to transform\n * @param {ReadonlyMat3} m the 3x3 matrix to transform with\n * @returns {vec3} out\n */\nexport function transformMat3(out, a, m) {\n var x = a[0],\n y = a[1],\n z = a[2];\n out[0] = x * m[0] + y * m[3] + z * m[6];\n out[1] = x * m[1] + y * m[4] + z * m[7];\n out[2] = x * m[2] + y * m[5] + z * m[8];\n return out;\n}\n\n/**\n * Transforms the vec3 with a quat\n * Can also be used for dual quaternions. (Multiply it with the real part)\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec3} a the vector to transform\n * @param {ReadonlyQuat} q normalized quaternion to transform with\n * @returns {vec3} out\n */\nexport function transformQuat(out, a, q) {\n // Fast Vector Rotation using Quaternions by Robert Eisele\n // https://raw.org/proof/vector-rotation-using-quaternions/\n\n var qx = q[0],\n qy = q[1],\n qz = q[2],\n qw = q[3];\n var vx = a[0],\n vy = a[1],\n vz = a[2];\n\n // t = q x v\n var tx = qy * vz - qz * vy;\n var ty = qz * vx - qx * vz;\n var tz = qx * vy - qy * vx;\n\n // t = 2t\n tx = tx + tx;\n ty = ty + ty;\n tz = tz + tz;\n\n // v + w t + q x t\n out[0] = vx + qw * tx + qy * tz - qz * ty;\n out[1] = vy + qw * ty + qz * tx - qx * tz;\n out[2] = vz + qw * tz + qx * ty - qy * tx;\n return out;\n}\n\n/**\n * Rotate a 3D vector around the x-axis\n * @param {vec3} out The receiving vec3\n * @param {ReadonlyVec3} a The vec3 point to rotate\n * @param {ReadonlyVec3} b The origin of the rotation\n * @param {Number} rad The angle of rotation in radians\n * @returns {vec3} out\n */\nexport function rotateX(out, a, b, rad) {\n var p = [],\n r = [];\n //Translate point to the origin\n p[0] = a[0] - b[0];\n p[1] = a[1] - b[1];\n p[2] = a[2] - b[2];\n\n //perform rotation\n r[0] = p[0];\n r[1] = p[1] * Math.cos(rad) - p[2] * Math.sin(rad);\n r[2] = p[1] * Math.sin(rad) + p[2] * Math.cos(rad);\n\n //translate to correct position\n out[0] = r[0] + b[0];\n out[1] = r[1] + b[1];\n out[2] = r[2] + b[2];\n return out;\n}\n\n/**\n * Rotate a 3D vector around the y-axis\n * @param {vec3} out The receiving vec3\n * @param {ReadonlyVec3} a The vec3 point to rotate\n * @param {ReadonlyVec3} b The origin of the rotation\n * @param {Number} rad The angle of rotation in radians\n * @returns {vec3} out\n */\nexport function rotateY(out, a, b, rad) {\n var p = [],\n r = [];\n //Translate point to the origin\n p[0] = a[0] - b[0];\n p[1] = a[1] - b[1];\n p[2] = a[2] - b[2];\n\n //perform rotation\n r[0] = p[2] * Math.sin(rad) + p[0] * Math.cos(rad);\n r[1] = p[1];\n r[2] = p[2] * Math.cos(rad) - p[0] * Math.sin(rad);\n\n //translate to correct position\n out[0] = r[0] + b[0];\n out[1] = r[1] + b[1];\n out[2] = r[2] + b[2];\n return out;\n}\n\n/**\n * Rotate a 3D vector around the z-axis\n * @param {vec3} out The receiving vec3\n * @param {ReadonlyVec3} a The vec3 point to rotate\n * @param {ReadonlyVec3} b The origin of the rotation\n * @param {Number} rad The angle of rotation in radians\n * @returns {vec3} out\n */\nexport function rotateZ(out, a, b, rad) {\n var p = [],\n r = [];\n //Translate point to the origin\n p[0] = a[0] - b[0];\n p[1] = a[1] - b[1];\n p[2] = a[2] - b[2];\n\n //perform rotation\n r[0] = p[0] * Math.cos(rad) - p[1] * Math.sin(rad);\n r[1] = p[0] * Math.sin(rad) + p[1] * Math.cos(rad);\n r[2] = p[2];\n\n //translate to correct position\n out[0] = r[0] + b[0];\n out[1] = r[1] + b[1];\n out[2] = r[2] + b[2];\n return out;\n}\n\n/**\n * Get the angle between two 3D vectors\n * @param {ReadonlyVec3} a The first operand\n * @param {ReadonlyVec3} b The second operand\n * @returns {Number} The angle in radians\n */\nexport function angle(a, b) {\n var ax = a[0],\n ay = a[1],\n az = a[2],\n bx = b[0],\n by = b[1],\n bz = b[2],\n mag = Math.sqrt((ax * ax + ay * ay + az * az) * (bx * bx + by * by + bz * bz)),\n cosine = mag && dot(a, b) / mag;\n return Math.acos(Math.min(Math.max(cosine, -1), 1));\n}\n\n/**\n * Set the components of a vec3 to zero\n *\n * @param {vec3} out the receiving vector\n * @returns {vec3} out\n */\nexport function zero(out) {\n out[0] = 0.0;\n out[1] = 0.0;\n out[2] = 0.0;\n return out;\n}\n\n/**\n * Returns a string representation of a vector\n *\n * @param {ReadonlyVec3} a vector to represent as a string\n * @returns {String} string representation of the vector\n */\nexport function str(a) {\n return \"vec3(\" + a[0] + \", \" + a[1] + \", \" + a[2] + \")\";\n}\n\n/**\n * Returns whether or not the vectors have exactly the same elements in the same position (when compared with ===)\n *\n * @param {ReadonlyVec3} a The first vector.\n * @param {ReadonlyVec3} b The second vector.\n * @returns {Boolean} True if the vectors are equal, false otherwise.\n */\nexport function exactEquals(a, b) {\n return a[0] === b[0] && a[1] === b[1] && a[2] === b[2];\n}\n\n/**\n * Returns whether or not the vectors have approximately the same elements in the same position.\n *\n * @param {ReadonlyVec3} a The first vector.\n * @param {ReadonlyVec3} b The second vector.\n * @returns {Boolean} True if the vectors are equal, false otherwise.\n */\nexport function equals(a, b) {\n var a0 = a[0],\n a1 = a[1],\n a2 = a[2];\n var b0 = b[0],\n b1 = b[1],\n b2 = b[2];\n return Math.abs(a0 - b0) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1)) && Math.abs(a2 - b2) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a2), Math.abs(b2));\n}\n\n/**\n * Alias for {@link vec3.subtract}\n * @function\n */\nexport var sub = subtract;\n\n/**\n * Alias for {@link vec3.multiply}\n * @function\n */\nexport var mul = multiply;\n\n/**\n * Alias for {@link vec3.divide}\n * @function\n */\nexport var div = divide;\n\n/**\n * Alias for {@link vec3.distance}\n * @function\n */\nexport var dist = distance;\n\n/**\n * Alias for {@link vec3.squaredDistance}\n * @function\n */\nexport var sqrDist = squaredDistance;\n\n/**\n * Alias for {@link vec3.length}\n * @function\n */\nexport var len = length;\n\n/**\n * Alias for {@link vec3.squaredLength}\n * @function\n */\nexport var sqrLen = squaredLength;\n\n/**\n * Perform some operation over an array of vec3s.\n *\n * @param {Array} a the array of vectors to iterate over\n * @param {Number} stride Number of elements between the start of each vec3. If 0 assumes tightly packed\n * @param {Number} offset Number of elements to skip at the beginning of the array\n * @param {Number} count Number of vec3s to iterate over. If 0 iterates over entire array\n * @param {Function} fn Function to call for each vector in the array\n * @param {Object} [arg] additional argument to pass to fn\n * @returns {Array} a\n * @function\n */\nexport var forEach = function () {\n var vec = create();\n return function (a, stride, offset, count, fn, arg) {\n var i, l;\n if (!stride) {\n stride = 3;\n }\n if (!offset) {\n offset = 0;\n }\n if (count) {\n l = Math.min(count * stride + offset, a.length);\n } else {\n l = a.length;\n }\n for (i = offset; i < l; i += stride) {\n vec[0] = a[i];\n vec[1] = a[i + 1];\n vec[2] = a[i + 2];\n fn(vec, vec, arg);\n a[i] = vec[0];\n a[i + 1] = vec[1];\n a[i + 2] = vec[2];\n }\n return a;\n };\n}();","import * as glMatrix from \"./common.js\";\n\n/**\n * 4 Dimensional Vector\n * @module vec4\n */\n\n/**\n * Creates a new, empty vec4\n *\n * @returns {vec4} a new 4D vector\n */\nexport function create() {\n var out = new glMatrix.ARRAY_TYPE(4);\n if (glMatrix.ARRAY_TYPE != Float32Array) {\n out[0] = 0;\n out[1] = 0;\n out[2] = 0;\n out[3] = 0;\n }\n return out;\n}\n\n/**\n * Creates a new vec4 initialized with values from an existing vector\n *\n * @param {ReadonlyVec4} a vector to clone\n * @returns {vec4} a new 4D vector\n */\nexport function clone(a) {\n var out = new glMatrix.ARRAY_TYPE(4);\n out[0] = a[0];\n out[1] = a[1];\n out[2] = a[2];\n out[3] = a[3];\n return out;\n}\n\n/**\n * Creates a new vec4 initialized with the given values\n *\n * @param {Number} x X component\n * @param {Number} y Y component\n * @param {Number} z Z component\n * @param {Number} w W component\n * @returns {vec4} a new 4D vector\n */\nexport function fromValues(x, y, z, w) {\n var out = new glMatrix.ARRAY_TYPE(4);\n out[0] = x;\n out[1] = y;\n out[2] = z;\n out[3] = w;\n return out;\n}\n\n/**\n * Copy the values from one vec4 to another\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the source vector\n * @returns {vec4} out\n */\nexport function copy(out, a) {\n out[0] = a[0];\n out[1] = a[1];\n out[2] = a[2];\n out[3] = a[3];\n return out;\n}\n\n/**\n * Set the components of a vec4 to the given values\n *\n * @param {vec4} out the receiving vector\n * @param {Number} x X component\n * @param {Number} y Y component\n * @param {Number} z Z component\n * @param {Number} w W component\n * @returns {vec4} out\n */\nexport function set(out, x, y, z, w) {\n out[0] = x;\n out[1] = y;\n out[2] = z;\n out[3] = w;\n return out;\n}\n\n/**\n * Adds two vec4's\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @returns {vec4} out\n */\nexport function add(out, a, b) {\n out[0] = a[0] + b[0];\n out[1] = a[1] + b[1];\n out[2] = a[2] + b[2];\n out[3] = a[3] + b[3];\n return out;\n}\n\n/**\n * Subtracts vector b from vector a\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @returns {vec4} out\n */\nexport function subtract(out, a, b) {\n out[0] = a[0] - b[0];\n out[1] = a[1] - b[1];\n out[2] = a[2] - b[2];\n out[3] = a[3] - b[3];\n return out;\n}\n\n/**\n * Multiplies two vec4's\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @returns {vec4} out\n */\nexport function multiply(out, a, b) {\n out[0] = a[0] * b[0];\n out[1] = a[1] * b[1];\n out[2] = a[2] * b[2];\n out[3] = a[3] * b[3];\n return out;\n}\n\n/**\n * Divides two vec4's\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @returns {vec4} out\n */\nexport function divide(out, a, b) {\n out[0] = a[0] / b[0];\n out[1] = a[1] / b[1];\n out[2] = a[2] / b[2];\n out[3] = a[3] / b[3];\n return out;\n}\n\n/**\n * Math.ceil the components of a vec4\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a vector to ceil\n * @returns {vec4} out\n */\nexport function ceil(out, a) {\n out[0] = Math.ceil(a[0]);\n out[1] = Math.ceil(a[1]);\n out[2] = Math.ceil(a[2]);\n out[3] = Math.ceil(a[3]);\n return out;\n}\n\n/**\n * Math.floor the components of a vec4\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a vector to floor\n * @returns {vec4} out\n */\nexport function floor(out, a) {\n out[0] = Math.floor(a[0]);\n out[1] = Math.floor(a[1]);\n out[2] = Math.floor(a[2]);\n out[3] = Math.floor(a[3]);\n return out;\n}\n\n/**\n * Returns the minimum of two vec4's\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @returns {vec4} out\n */\nexport function min(out, a, b) {\n out[0] = Math.min(a[0], b[0]);\n out[1] = Math.min(a[1], b[1]);\n out[2] = Math.min(a[2], b[2]);\n out[3] = Math.min(a[3], b[3]);\n return out;\n}\n\n/**\n * Returns the maximum of two vec4's\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @returns {vec4} out\n */\nexport function max(out, a, b) {\n out[0] = Math.max(a[0], b[0]);\n out[1] = Math.max(a[1], b[1]);\n out[2] = Math.max(a[2], b[2]);\n out[3] = Math.max(a[3], b[3]);\n return out;\n}\n\n/**\n * symmetric round the components of a vec4\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a vector to round\n * @returns {vec4} out\n */\nexport function round(out, a) {\n out[0] = glMatrix.round(a[0]);\n out[1] = glMatrix.round(a[1]);\n out[2] = glMatrix.round(a[2]);\n out[3] = glMatrix.round(a[3]);\n return out;\n}\n\n/**\n * Scales a vec4 by a scalar number\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the vector to scale\n * @param {Number} b amount to scale the vector by\n * @returns {vec4} out\n */\nexport function scale(out, a, b) {\n out[0] = a[0] * b;\n out[1] = a[1] * b;\n out[2] = a[2] * b;\n out[3] = a[3] * b;\n return out;\n}\n\n/**\n * Adds two vec4's after scaling the second operand by a scalar value\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @param {Number} scale the amount to scale b by before adding\n * @returns {vec4} out\n */\nexport function scaleAndAdd(out, a, b, scale) {\n out[0] = a[0] + b[0] * scale;\n out[1] = a[1] + b[1] * scale;\n out[2] = a[2] + b[2] * scale;\n out[3] = a[3] + b[3] * scale;\n return out;\n}\n\n/**\n * Calculates the euclidian distance between two vec4's\n *\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @returns {Number} distance between a and b\n */\nexport function distance(a, b) {\n var x = b[0] - a[0];\n var y = b[1] - a[1];\n var z = b[2] - a[2];\n var w = b[3] - a[3];\n return Math.sqrt(x * x + y * y + z * z + w * w);\n}\n\n/**\n * Calculates the squared euclidian distance between two vec4's\n *\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @returns {Number} squared distance between a and b\n */\nexport function squaredDistance(a, b) {\n var x = b[0] - a[0];\n var y = b[1] - a[1];\n var z = b[2] - a[2];\n var w = b[3] - a[3];\n return x * x + y * y + z * z + w * w;\n}\n\n/**\n * Calculates the length of a vec4\n *\n * @param {ReadonlyVec4} a vector to calculate length of\n * @returns {Number} length of a\n */\nexport function length(a) {\n var x = a[0];\n var y = a[1];\n var z = a[2];\n var w = a[3];\n return Math.sqrt(x * x + y * y + z * z + w * w);\n}\n\n/**\n * Calculates the squared length of a vec4\n *\n * @param {ReadonlyVec4} a vector to calculate squared length of\n * @returns {Number} squared length of a\n */\nexport function squaredLength(a) {\n var x = a[0];\n var y = a[1];\n var z = a[2];\n var w = a[3];\n return x * x + y * y + z * z + w * w;\n}\n\n/**\n * Negates the components of a vec4\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a vector to negate\n * @returns {vec4} out\n */\nexport function negate(out, a) {\n out[0] = -a[0];\n out[1] = -a[1];\n out[2] = -a[2];\n out[3] = -a[3];\n return out;\n}\n\n/**\n * Returns the inverse of the components of a vec4\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a vector to invert\n * @returns {vec4} out\n */\nexport function inverse(out, a) {\n out[0] = 1.0 / a[0];\n out[1] = 1.0 / a[1];\n out[2] = 1.0 / a[2];\n out[3] = 1.0 / a[3];\n return out;\n}\n\n/**\n * Normalize a vec4\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a vector to normalize\n * @returns {vec4} out\n */\nexport function normalize(out, a) {\n var x = a[0];\n var y = a[1];\n var z = a[2];\n var w = a[3];\n var len = x * x + y * y + z * z + w * w;\n if (len > 0) {\n len = 1 / Math.sqrt(len);\n }\n out[0] = x * len;\n out[1] = y * len;\n out[2] = z * len;\n out[3] = w * len;\n return out;\n}\n\n/**\n * Calculates the dot product of two vec4's\n *\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @returns {Number} dot product of a and b\n */\nexport function dot(a, b) {\n return a[0] * b[0] + a[1] * b[1] + a[2] * b[2] + a[3] * b[3];\n}\n\n/**\n * Returns the cross-product of three vectors in a 4-dimensional space\n *\n * @param {ReadonlyVec4} out the receiving vector\n * @param {ReadonlyVec4} u the first vector\n * @param {ReadonlyVec4} v the second vector\n * @param {ReadonlyVec4} w the third vector\n * @returns {vec4} result\n */\nexport function cross(out, u, v, w) {\n var A = v[0] * w[1] - v[1] * w[0],\n B = v[0] * w[2] - v[2] * w[0],\n C = v[0] * w[3] - v[3] * w[0],\n D = v[1] * w[2] - v[2] * w[1],\n E = v[1] * w[3] - v[3] * w[1],\n F = v[2] * w[3] - v[3] * w[2];\n var G = u[0];\n var H = u[1];\n var I = u[2];\n var J = u[3];\n out[0] = H * F - I * E + J * D;\n out[1] = -(G * F) + I * C - J * B;\n out[2] = G * E - H * C + J * A;\n out[3] = -(G * D) + H * B - I * A;\n return out;\n}\n\n/**\n * Performs a linear interpolation between two vec4's\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the first operand\n * @param {ReadonlyVec4} b the second operand\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\n * @returns {vec4} out\n */\nexport function lerp(out, a, b, t) {\n var ax = a[0];\n var ay = a[1];\n var az = a[2];\n var aw = a[3];\n out[0] = ax + t * (b[0] - ax);\n out[1] = ay + t * (b[1] - ay);\n out[2] = az + t * (b[2] - az);\n out[3] = aw + t * (b[3] - aw);\n return out;\n}\n\n/**\n * Generates a random vector with the given scale\n *\n * @param {vec4} out the receiving vector\n * @param {Number} [scale] Length of the resulting vector. If omitted, a unit vector will be returned\n * @returns {vec4} out\n */\nexport function random(out, scale) {\n scale = scale === undefined ? 1.0 : scale;\n\n // Marsaglia, George. Choosing a Point from the Surface of a\n // Sphere. Ann. Math. Statist. 43 (1972), no. 2, 645--646.\n // http://projecteuclid.org/euclid.aoms/1177692644;\n var v1, v2, v3, v4;\n var s1, s2;\n var rand;\n rand = glMatrix.RANDOM();\n v1 = rand * 2 - 1;\n v2 = (4 * glMatrix.RANDOM() - 2) * Math.sqrt(rand * -rand + rand);\n s1 = v1 * v1 + v2 * v2;\n rand = glMatrix.RANDOM();\n v3 = rand * 2 - 1;\n v4 = (4 * glMatrix.RANDOM() - 2) * Math.sqrt(rand * -rand + rand);\n s2 = v3 * v3 + v4 * v4;\n var d = Math.sqrt((1 - s1) / s2);\n out[0] = scale * v1;\n out[1] = scale * v2;\n out[2] = scale * v3 * d;\n out[3] = scale * v4 * d;\n return out;\n}\n\n/**\n * Transforms the vec4 with a mat4.\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the vector to transform\n * @param {ReadonlyMat4} m matrix to transform with\n * @returns {vec4} out\n */\nexport function transformMat4(out, a, m) {\n var x = a[0],\n y = a[1],\n z = a[2],\n w = a[3];\n out[0] = m[0] * x + m[4] * y + m[8] * z + m[12] * w;\n out[1] = m[1] * x + m[5] * y + m[9] * z + m[13] * w;\n out[2] = m[2] * x + m[6] * y + m[10] * z + m[14] * w;\n out[3] = m[3] * x + m[7] * y + m[11] * z + m[15] * w;\n return out;\n}\n\n/**\n * Transforms the vec4 with a quat\n *\n * @param {vec4} out the receiving vector\n * @param {ReadonlyVec4} a the vector to transform\n * @param {ReadonlyQuat} q normalized quaternion to transform with\n * @returns {vec4} out\n */\nexport function transformQuat(out, a, q) {\n // Fast Vector Rotation using Quaternions by Robert Eisele\n // https://raw.org/proof/vector-rotation-using-quaternions/\n\n var qx = q[0],\n qy = q[1],\n qz = q[2],\n qw = q[3];\n var vx = a[0],\n vy = a[1],\n vz = a[2];\n\n // t = q x v\n var tx = qy * vz - qz * vy;\n var ty = qz * vx - qx * vz;\n var tz = qx * vy - qy * vx;\n\n // t = 2t\n tx = tx + tx;\n ty = ty + ty;\n tz = tz + tz;\n\n // v + w t + q x t\n out[0] = vx + qw * tx + qy * tz - qz * ty;\n out[1] = vy + qw * ty + qz * tx - qx * tz;\n out[2] = vz + qw * tz + qx * ty - qy * tx;\n out[3] = a[3];\n return out;\n}\n\n/**\n * Set the components of a vec4 to zero\n *\n * @param {vec4} out the receiving vector\n * @returns {vec4} out\n */\nexport function zero(out) {\n out[0] = 0.0;\n out[1] = 0.0;\n out[2] = 0.0;\n out[3] = 0.0;\n return out;\n}\n\n/**\n * Returns a string representation of a vector\n *\n * @param {ReadonlyVec4} a vector to represent as a string\n * @returns {String} string representation of the vector\n */\nexport function str(a) {\n return \"vec4(\" + a[0] + \", \" + a[1] + \", \" + a[2] + \", \" + a[3] + \")\";\n}\n\n/**\n * Returns whether or not the vectors have exactly the same elements in the same position (when compared with ===)\n *\n * @param {ReadonlyVec4} a The first vector.\n * @param {ReadonlyVec4} b The second vector.\n * @returns {Boolean} True if the vectors are equal, false otherwise.\n */\nexport function exactEquals(a, b) {\n return a[0] === b[0] && a[1] === b[1] && a[2] === b[2] && a[3] === b[3];\n}\n\n/**\n * Returns whether or not the vectors have approximately the same elements in the same position.\n *\n * @param {ReadonlyVec4} a The first vector.\n * @param {ReadonlyVec4} b The second vector.\n * @returns {Boolean} True if the vectors are equal, false otherwise.\n */\nexport function equals(a, b) {\n var a0 = a[0],\n a1 = a[1],\n a2 = a[2],\n a3 = a[3];\n var b0 = b[0],\n b1 = b[1],\n b2 = b[2],\n b3 = b[3];\n return Math.abs(a0 - b0) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1)) && Math.abs(a2 - b2) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a2), Math.abs(b2)) && Math.abs(a3 - b3) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a3), Math.abs(b3));\n}\n\n/**\n * Alias for {@link vec4.subtract}\n * @function\n */\nexport var sub = subtract;\n\n/**\n * Alias for {@link vec4.multiply}\n * @function\n */\nexport var mul = multiply;\n\n/**\n * Alias for {@link vec4.divide}\n * @function\n */\nexport var div = divide;\n\n/**\n * Alias for {@link vec4.distance}\n * @function\n */\nexport var dist = distance;\n\n/**\n * Alias for {@link vec4.squaredDistance}\n * @function\n */\nexport var sqrDist = squaredDistance;\n\n/**\n * Alias for {@link vec4.length}\n * @function\n */\nexport var len = length;\n\n/**\n * Alias for {@link vec4.squaredLength}\n * @function\n */\nexport var sqrLen = squaredLength;\n\n/**\n * Perform some operation over an array of vec4s.\n *\n * @param {Array} a the array of vectors to iterate over\n * @param {Number} stride Number of elements between the start of each vec4. If 0 assumes tightly packed\n * @param {Number} offset Number of elements to skip at the beginning of the array\n * @param {Number} count Number of vec4s to iterate over. If 0 iterates over entire array\n * @param {Function} fn Function to call for each vector in the array\n * @param {Object} [arg] additional argument to pass to fn\n * @returns {Array} a\n * @function\n */\nexport var forEach = function () {\n var vec = create();\n return function (a, stride, offset, count, fn, arg) {\n var i, l;\n if (!stride) {\n stride = 4;\n }\n if (!offset) {\n offset = 0;\n }\n if (count) {\n l = Math.min(count * stride + offset, a.length);\n } else {\n l = a.length;\n }\n for (i = offset; i < l; i += stride) {\n vec[0] = a[i];\n vec[1] = a[i + 1];\n vec[2] = a[i + 2];\n vec[3] = a[i + 3];\n fn(vec, vec, arg);\n a[i] = vec[0];\n a[i + 1] = vec[1];\n a[i + 2] = vec[2];\n a[i + 3] = vec[3];\n }\n return a;\n };\n}();","import * as glMatrix from \"./common.js\";\nimport * as mat3 from \"./mat3.js\";\nimport * as vec3 from \"./vec3.js\";\nimport * as vec4 from \"./vec4.js\";\n\n/**\n * Quaternion in the format XYZW\n * @module quat\n */\n\n/**\n * Creates a new identity quat\n *\n * @returns {quat} a new quaternion\n */\nexport function create() {\n var out = new glMatrix.ARRAY_TYPE(4);\n if (glMatrix.ARRAY_TYPE != Float32Array) {\n out[0] = 0;\n out[1] = 0;\n out[2] = 0;\n }\n out[3] = 1;\n return out;\n}\n\n/**\n * Set a quat to the identity quaternion\n *\n * @param {quat} out the receiving quaternion\n * @returns {quat} out\n */\nexport function identity(out) {\n out[0] = 0;\n out[1] = 0;\n out[2] = 0;\n out[3] = 1;\n return out;\n}\n\n/**\n * Sets a quat from the given angle and rotation axis,\n * then returns it.\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyVec3} axis the axis around which to rotate\n * @param {Number} rad the angle in radians\n * @returns {quat} out\n **/\nexport function setAxisAngle(out, axis, rad) {\n rad = rad * 0.5;\n var s = Math.sin(rad);\n out[0] = s * axis[0];\n out[1] = s * axis[1];\n out[2] = s * axis[2];\n out[3] = Math.cos(rad);\n return out;\n}\n\n/**\n * Gets the rotation axis and angle for a given\n * quaternion. If a quaternion is created with\n * setAxisAngle, this method will return the same\n * values as providied in the original parameter list\n * OR functionally equivalent values.\n * Example: The quaternion formed by axis [0, 0, 1] and\n * angle -90 is the same as the quaternion formed by\n * [0, 0, 1] and 270. This method favors the latter.\n * @param {vec3} out_axis Vector receiving the axis of rotation\n * @param {ReadonlyQuat} q Quaternion to be decomposed\n * @return {Number} Angle, in radians, of the rotation\n */\nexport function getAxisAngle(out_axis, q) {\n var rad = Math.acos(q[3]) * 2.0;\n var s = Math.sin(rad / 2.0);\n if (s > glMatrix.EPSILON) {\n out_axis[0] = q[0] / s;\n out_axis[1] = q[1] / s;\n out_axis[2] = q[2] / s;\n } else {\n // If s is zero, return any axis (no rotation - axis does not matter)\n out_axis[0] = 1;\n out_axis[1] = 0;\n out_axis[2] = 0;\n }\n return rad;\n}\n\n/**\n * Gets the angular distance between two unit quaternions\n *\n * @param {ReadonlyQuat} a Origin unit quaternion\n * @param {ReadonlyQuat} b Destination unit quaternion\n * @return {Number} Angle, in radians, between the two quaternions\n */\nexport function getAngle(a, b) {\n var dotproduct = dot(a, b);\n return Math.acos(2 * dotproduct * dotproduct - 1);\n}\n\n/**\n * Multiplies two quat's\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a the first operand\n * @param {ReadonlyQuat} b the second operand\n * @returns {quat} out\n */\nexport function multiply(out, a, b) {\n var ax = a[0],\n ay = a[1],\n az = a[2],\n aw = a[3];\n var bx = b[0],\n by = b[1],\n bz = b[2],\n bw = b[3];\n out[0] = ax * bw + aw * bx + ay * bz - az * by;\n out[1] = ay * bw + aw * by + az * bx - ax * bz;\n out[2] = az * bw + aw * bz + ax * by - ay * bx;\n out[3] = aw * bw - ax * bx - ay * by - az * bz;\n return out;\n}\n\n/**\n * Rotates a quaternion by the given angle about the X axis\n *\n * @param {quat} out quat receiving operation result\n * @param {ReadonlyQuat} a quat to rotate\n * @param {number} rad angle (in radians) to rotate\n * @returns {quat} out\n */\nexport function rotateX(out, a, rad) {\n rad *= 0.5;\n var ax = a[0],\n ay = a[1],\n az = a[2],\n aw = a[3];\n var bx = Math.sin(rad),\n bw = Math.cos(rad);\n out[0] = ax * bw + aw * bx;\n out[1] = ay * bw + az * bx;\n out[2] = az * bw - ay * bx;\n out[3] = aw * bw - ax * bx;\n return out;\n}\n\n/**\n * Rotates a quaternion by the given angle about the Y axis\n *\n * @param {quat} out quat receiving operation result\n * @param {ReadonlyQuat} a quat to rotate\n * @param {number} rad angle (in radians) to rotate\n * @returns {quat} out\n */\nexport function rotateY(out, a, rad) {\n rad *= 0.5;\n var ax = a[0],\n ay = a[1],\n az = a[2],\n aw = a[3];\n var by = Math.sin(rad),\n bw = Math.cos(rad);\n out[0] = ax * bw - az * by;\n out[1] = ay * bw + aw * by;\n out[2] = az * bw + ax * by;\n out[3] = aw * bw - ay * by;\n return out;\n}\n\n/**\n * Rotates a quaternion by the given angle about the Z axis\n *\n * @param {quat} out quat receiving operation result\n * @param {ReadonlyQuat} a quat to rotate\n * @param {number} rad angle (in radians) to rotate\n * @returns {quat} out\n */\nexport function rotateZ(out, a, rad) {\n rad *= 0.5;\n var ax = a[0],\n ay = a[1],\n az = a[2],\n aw = a[3];\n var bz = Math.sin(rad),\n bw = Math.cos(rad);\n out[0] = ax * bw + ay * bz;\n out[1] = ay * bw - ax * bz;\n out[2] = az * bw + aw * bz;\n out[3] = aw * bw - az * bz;\n return out;\n}\n\n/**\n * Calculates the W component of a quat from the X, Y, and Z components.\n * Assumes that quaternion is 1 unit in length.\n * Any existing W component will be ignored.\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a quat to calculate W component of\n * @returns {quat} out\n */\nexport function calculateW(out, a) {\n var x = a[0],\n y = a[1],\n z = a[2];\n out[0] = x;\n out[1] = y;\n out[2] = z;\n out[3] = Math.sqrt(Math.abs(1.0 - x * x - y * y - z * z));\n return out;\n}\n\n/**\n * Calculate the exponential of a unit quaternion.\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a quat to calculate the exponential of\n * @returns {quat} out\n */\nexport function exp(out, a) {\n var x = a[0],\n y = a[1],\n z = a[2],\n w = a[3];\n var r = Math.sqrt(x * x + y * y + z * z);\n var et = Math.exp(w);\n var s = r > 0 ? et * Math.sin(r) / r : 0;\n out[0] = x * s;\n out[1] = y * s;\n out[2] = z * s;\n out[3] = et * Math.cos(r);\n return out;\n}\n\n/**\n * Calculate the natural logarithm of a unit quaternion.\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a quat to calculate the exponential of\n * @returns {quat} out\n */\nexport function ln(out, a) {\n var x = a[0],\n y = a[1],\n z = a[2],\n w = a[3];\n var r = Math.sqrt(x * x + y * y + z * z);\n var t = r > 0 ? Math.atan2(r, w) / r : 0;\n out[0] = x * t;\n out[1] = y * t;\n out[2] = z * t;\n out[3] = 0.5 * Math.log(x * x + y * y + z * z + w * w);\n return out;\n}\n\n/**\n * Calculate the scalar power of a unit quaternion.\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a quat to calculate the exponential of\n * @param {Number} b amount to scale the quaternion by\n * @returns {quat} out\n */\nexport function pow(out, a, b) {\n ln(out, a);\n scale(out, out, b);\n exp(out, out);\n return out;\n}\n\n/**\n * Performs a spherical linear interpolation between two quat\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a the first operand\n * @param {ReadonlyQuat} b the second operand\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\n * @returns {quat} out\n */\nexport function slerp(out, a, b, t) {\n // benchmarks:\n // http://jsperf.com/quaternion-slerp-implementations\n var ax = a[0],\n ay = a[1],\n az = a[2],\n aw = a[3];\n var bx = b[0],\n by = b[1],\n bz = b[2],\n bw = b[3];\n var omega, cosom, sinom, scale0, scale1;\n\n // calc cosine\n cosom = ax * bx + ay * by + az * bz + aw * bw;\n // adjust signs (if necessary)\n if (cosom < 0.0) {\n cosom = -cosom;\n bx = -bx;\n by = -by;\n bz = -bz;\n bw = -bw;\n }\n // calculate coefficients\n if (1.0 - cosom > glMatrix.EPSILON) {\n // standard case (slerp)\n omega = Math.acos(cosom);\n sinom = Math.sin(omega);\n scale0 = Math.sin((1.0 - t) * omega) / sinom;\n scale1 = Math.sin(t * omega) / sinom;\n } else {\n // \"from\" and \"to\" quaternions are very close\n // ... so we can do a linear interpolation\n scale0 = 1.0 - t;\n scale1 = t;\n }\n // calculate final values\n out[0] = scale0 * ax + scale1 * bx;\n out[1] = scale0 * ay + scale1 * by;\n out[2] = scale0 * az + scale1 * bz;\n out[3] = scale0 * aw + scale1 * bw;\n return out;\n}\n\n/**\n * Generates a random unit quaternion\n *\n * @param {quat} out the receiving quaternion\n * @returns {quat} out\n */\nexport function random(out) {\n // Implementation of http://planning.cs.uiuc.edu/node198.html\n // TODO: Calling random 3 times is probably not the fastest solution\n var u1 = glMatrix.RANDOM();\n var u2 = glMatrix.RANDOM();\n var u3 = glMatrix.RANDOM();\n var sqrt1MinusU1 = Math.sqrt(1 - u1);\n var sqrtU1 = Math.sqrt(u1);\n out[0] = sqrt1MinusU1 * Math.sin(2.0 * Math.PI * u2);\n out[1] = sqrt1MinusU1 * Math.cos(2.0 * Math.PI * u2);\n out[2] = sqrtU1 * Math.sin(2.0 * Math.PI * u3);\n out[3] = sqrtU1 * Math.cos(2.0 * Math.PI * u3);\n return out;\n}\n\n/**\n * Calculates the inverse of a quat\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a quat to calculate inverse of\n * @returns {quat} out\n */\nexport function invert(out, a) {\n var a0 = a[0],\n a1 = a[1],\n a2 = a[2],\n a3 = a[3];\n var dot = a0 * a0 + a1 * a1 + a2 * a2 + a3 * a3;\n var invDot = dot ? 1.0 / dot : 0;\n\n // TODO: Would be faster to return [0,0,0,0] immediately if dot == 0\n\n out[0] = -a0 * invDot;\n out[1] = -a1 * invDot;\n out[2] = -a2 * invDot;\n out[3] = a3 * invDot;\n return out;\n}\n\n/**\n * Calculates the conjugate of a quat\n * If the quaternion is normalized, this function is faster than quat.inverse and produces the same result.\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a quat to calculate conjugate of\n * @returns {quat} out\n */\nexport function conjugate(out, a) {\n out[0] = -a[0];\n out[1] = -a[1];\n out[2] = -a[2];\n out[3] = a[3];\n return out;\n}\n\n/**\n * Creates a quaternion from the given 3x3 rotation matrix.\n *\n * NOTE: The resultant quaternion is not normalized, so you should be sure\n * to renormalize the quaternion yourself where necessary.\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyMat3} m rotation matrix\n * @returns {quat} out\n * @function\n */\nexport function fromMat3(out, m) {\n // Algorithm in Ken Shoemake's article in 1987 SIGGRAPH course notes\n // article \"Quaternion Calculus and Fast Animation\".\n var fTrace = m[0] + m[4] + m[8];\n var fRoot;\n if (fTrace > 0.0) {\n // |w| > 1/2, may as well choose w > 1/2\n fRoot = Math.sqrt(fTrace + 1.0); // 2w\n out[3] = 0.5 * fRoot;\n fRoot = 0.5 / fRoot; // 1/(4w)\n out[0] = (m[5] - m[7]) * fRoot;\n out[1] = (m[6] - m[2]) * fRoot;\n out[2] = (m[1] - m[3]) * fRoot;\n } else {\n // |w| <= 1/2\n var i = 0;\n if (m[4] > m[0]) i = 1;\n if (m[8] > m[i * 3 + i]) i = 2;\n var j = (i + 1) % 3;\n var k = (i + 2) % 3;\n fRoot = Math.sqrt(m[i * 3 + i] - m[j * 3 + j] - m[k * 3 + k] + 1.0);\n out[i] = 0.5 * fRoot;\n fRoot = 0.5 / fRoot;\n out[3] = (m[j * 3 + k] - m[k * 3 + j]) * fRoot;\n out[j] = (m[j * 3 + i] + m[i * 3 + j]) * fRoot;\n out[k] = (m[k * 3 + i] + m[i * 3 + k]) * fRoot;\n }\n return out;\n}\n\n/**\n * Creates a quaternion from the given euler angle x, y, z using the provided intrinsic order for the conversion.\n *\n * @param {quat} out the receiving quaternion\n * @param {Number} x Angle to rotate around X axis in degrees.\n * @param {Number} y Angle to rotate around Y axis in degrees.\n * @param {Number} z Angle to rotate around Z axis in degrees.\n * @param {'xyz'|'xzy'|'yxz'|'yzx'|'zxy'|'zyx'} order Intrinsic order for conversion, default is zyx.\n * @returns {quat} out\n * @function\n */\nexport function fromEuler(out, x, y, z) {\n var order = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : glMatrix.ANGLE_ORDER;\n var halfToRad = Math.PI / 360;\n x *= halfToRad;\n z *= halfToRad;\n y *= halfToRad;\n var sx = Math.sin(x);\n var cx = Math.cos(x);\n var sy = Math.sin(y);\n var cy = Math.cos(y);\n var sz = Math.sin(z);\n var cz = Math.cos(z);\n switch (order) {\n case \"xyz\":\n out[0] = sx * cy * cz + cx * sy * sz;\n out[1] = cx * sy * cz - sx * cy * sz;\n out[2] = cx * cy * sz + sx * sy * cz;\n out[3] = cx * cy * cz - sx * sy * sz;\n break;\n case \"xzy\":\n out[0] = sx * cy * cz - cx * sy * sz;\n out[1] = cx * sy * cz - sx * cy * sz;\n out[2] = cx * cy * sz + sx * sy * cz;\n out[3] = cx * cy * cz + sx * sy * sz;\n break;\n case \"yxz\":\n out[0] = sx * cy * cz + cx * sy * sz;\n out[1] = cx * sy * cz - sx * cy * sz;\n out[2] = cx * cy * sz - sx * sy * cz;\n out[3] = cx * cy * cz + sx * sy * sz;\n break;\n case \"yzx\":\n out[0] = sx * cy * cz + cx * sy * sz;\n out[1] = cx * sy * cz + sx * cy * sz;\n out[2] = cx * cy * sz - sx * sy * cz;\n out[3] = cx * cy * cz - sx * sy * sz;\n break;\n case \"zxy\":\n out[0] = sx * cy * cz - cx * sy * sz;\n out[1] = cx * sy * cz + sx * cy * sz;\n out[2] = cx * cy * sz + sx * sy * cz;\n out[3] = cx * cy * cz - sx * sy * sz;\n break;\n case \"zyx\":\n out[0] = sx * cy * cz - cx * sy * sz;\n out[1] = cx * sy * cz + sx * cy * sz;\n out[2] = cx * cy * sz - sx * sy * cz;\n out[3] = cx * cy * cz + sx * sy * sz;\n break;\n default:\n throw new Error('Unknown angle order ' + order);\n }\n return out;\n}\n\n/**\n * Returns a string representation of a quaternion\n *\n * @param {ReadonlyQuat} a vector to represent as a string\n * @returns {String} string representation of the vector\n */\nexport function str(a) {\n return \"quat(\" + a[0] + \", \" + a[1] + \", \" + a[2] + \", \" + a[3] + \")\";\n}\n\n/**\n * Creates a new quat initialized with values from an existing quaternion\n *\n * @param {ReadonlyQuat} a quaternion to clone\n * @returns {quat} a new quaternion\n * @function\n */\nexport var clone = vec4.clone;\n\n/**\n * Creates a new quat initialized with the given values\n *\n * @param {Number} x X component\n * @param {Number} y Y component\n * @param {Number} z Z component\n * @param {Number} w W component\n * @returns {quat} a new quaternion\n * @function\n */\nexport var fromValues = vec4.fromValues;\n\n/**\n * Copy the values from one quat to another\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a the source quaternion\n * @returns {quat} out\n * @function\n */\nexport var copy = vec4.copy;\n\n/**\n * Set the components of a quat to the given values\n *\n * @param {quat} out the receiving quaternion\n * @param {Number} x X component\n * @param {Number} y Y component\n * @param {Number} z Z component\n * @param {Number} w W component\n * @returns {quat} out\n * @function\n */\nexport var set = vec4.set;\n\n/**\n * Adds two quat's\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a the first operand\n * @param {ReadonlyQuat} b the second operand\n * @returns {quat} out\n * @function\n */\nexport var add = vec4.add;\n\n/**\n * Alias for {@link quat.multiply}\n * @function\n */\nexport var mul = multiply;\n\n/**\n * Scales a quat by a scalar number\n *\n * @param {quat} out the receiving vector\n * @param {ReadonlyQuat} a the vector to scale\n * @param {Number} b amount to scale the vector by\n * @returns {quat} out\n * @function\n */\nexport var scale = vec4.scale;\n\n/**\n * Calculates the dot product of two quat's\n *\n * @param {ReadonlyQuat} a the first operand\n * @param {ReadonlyQuat} b the second operand\n * @returns {Number} dot product of a and b\n * @function\n */\nexport var dot = vec4.dot;\n\n/**\n * Performs a linear interpolation between two quat's\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a the first operand\n * @param {ReadonlyQuat} b the second operand\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\n * @returns {quat} out\n * @function\n */\nexport var lerp = vec4.lerp;\n\n/**\n * Calculates the length of a quat\n *\n * @param {ReadonlyQuat} a vector to calculate length of\n * @returns {Number} length of a\n */\nexport var length = vec4.length;\n\n/**\n * Alias for {@link quat.length}\n * @function\n */\nexport var len = length;\n\n/**\n * Calculates the squared length of a quat\n *\n * @param {ReadonlyQuat} a vector to calculate squared length of\n * @returns {Number} squared length of a\n * @function\n */\nexport var squaredLength = vec4.squaredLength;\n\n/**\n * Alias for {@link quat.squaredLength}\n * @function\n */\nexport var sqrLen = squaredLength;\n\n/**\n * Normalize a quat\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a quaternion to normalize\n * @returns {quat} out\n * @function\n */\nexport var normalize = vec4.normalize;\n\n/**\n * Returns whether or not the quaternions have exactly the same elements in the same position (when compared with ===)\n *\n * @param {ReadonlyQuat} a The first quaternion.\n * @param {ReadonlyQuat} b The second quaternion.\n * @returns {Boolean} True if the vectors are equal, false otherwise.\n */\nexport var exactEquals = vec4.exactEquals;\n\n/**\n * Returns whether or not the quaternions point approximately to the same direction.\n *\n * Both quaternions are assumed to be unit length.\n *\n * @param {ReadonlyQuat} a The first unit quaternion.\n * @param {ReadonlyQuat} b The second unit quaternion.\n * @returns {Boolean} True if the quaternions are equal, false otherwise.\n */\nexport function equals(a, b) {\n return Math.abs(vec4.dot(a, b)) >= 1 - glMatrix.EPSILON;\n}\n\n/**\n * Sets a quaternion to represent the shortest rotation from one\n * vector to another.\n *\n * Both vectors are assumed to be unit length.\n *\n * @param {quat} out the receiving quaternion.\n * @param {ReadonlyVec3} a the initial vector\n * @param {ReadonlyVec3} b the destination vector\n * @returns {quat} out\n */\nexport var rotationTo = function () {\n var tmpvec3 = vec3.create();\n var xUnitVec3 = vec3.fromValues(1, 0, 0);\n var yUnitVec3 = vec3.fromValues(0, 1, 0);\n return function (out, a, b) {\n var dot = vec3.dot(a, b);\n if (dot < -0.999999) {\n vec3.cross(tmpvec3, xUnitVec3, a);\n if (vec3.len(tmpvec3) < 0.000001) vec3.cross(tmpvec3, yUnitVec3, a);\n vec3.normalize(tmpvec3, tmpvec3);\n setAxisAngle(out, tmpvec3, Math.PI);\n return out;\n } else if (dot > 0.999999) {\n out[0] = 0;\n out[1] = 0;\n out[2] = 0;\n out[3] = 1;\n return out;\n } else {\n vec3.cross(tmpvec3, a, b);\n out[0] = tmpvec3[0];\n out[1] = tmpvec3[1];\n out[2] = tmpvec3[2];\n out[3] = 1 + dot;\n return normalize(out, out);\n }\n };\n}();\n\n/**\n * Performs a spherical linear interpolation with two control points\n *\n * @param {quat} out the receiving quaternion\n * @param {ReadonlyQuat} a the first operand\n * @param {ReadonlyQuat} b the second operand\n * @param {ReadonlyQuat} c the third operand\n * @param {ReadonlyQuat} d the fourth operand\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\n * @returns {quat} out\n */\nexport var sqlerp = function () {\n var temp1 = create();\n var temp2 = create();\n return function (out, a, b, c, d, t) {\n slerp(temp1, a, d, t);\n slerp(temp2, b, c, t);\n slerp(out, temp1, temp2, 2 * t * (1 - t));\n return out;\n };\n}();\n\n/**\n * Sets the specified quaternion with values corresponding to the given\n * axes. Each axis is a vec3 and is expected to be unit length and\n * perpendicular to all other specified axes.\n *\n * @param {ReadonlyVec3} view the vector representing the viewing direction\n * @param {ReadonlyVec3} right the vector representing the local \"right\" direction\n * @param {ReadonlyVec3} up the vector representing the local \"up\" direction\n * @returns {quat} out\n */\nexport var setAxes = function () {\n var matr = mat3.create();\n return function (out, view, right, up) {\n matr[0] = right[0];\n matr[3] = right[1];\n matr[6] = right[2];\n matr[1] = up[0];\n matr[4] = up[1];\n matr[7] = up[2];\n matr[2] = -view[0];\n matr[5] = -view[1];\n matr[8] = -view[2];\n return normalize(out, fromMat3(out, matr));\n };\n}();","import * as glMatrix from \"./common.js\";\n\n/**\n * 2 Dimensional Vector\n * @module vec2\n */\n\n/**\n * Creates a new, empty vec2\n *\n * @returns {vec2} a new 2D vector\n */\nexport function create() {\n var out = new glMatrix.ARRAY_TYPE(2);\n if (glMatrix.ARRAY_TYPE != Float32Array) {\n out[0] = 0;\n out[1] = 0;\n }\n return out;\n}\n\n/**\n * Creates a new vec2 initialized with values from an existing vector\n *\n * @param {ReadonlyVec2} a vector to clone\n * @returns {vec2} a new 2D vector\n */\nexport function clone(a) {\n var out = new glMatrix.ARRAY_TYPE(2);\n out[0] = a[0];\n out[1] = a[1];\n return out;\n}\n\n/**\n * Creates a new vec2 initialized with the given values\n *\n * @param {Number} x X component\n * @param {Number} y Y component\n * @returns {vec2} a new 2D vector\n */\nexport function fromValues(x, y) {\n var out = new glMatrix.ARRAY_TYPE(2);\n out[0] = x;\n out[1] = y;\n return out;\n}\n\n/**\n * Copy the values from one vec2 to another\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the source vector\n * @returns {vec2} out\n */\nexport function copy(out, a) {\n out[0] = a[0];\n out[1] = a[1];\n return out;\n}\n\n/**\n * Set the components of a vec2 to the given values\n *\n * @param {vec2} out the receiving vector\n * @param {Number} x X component\n * @param {Number} y Y component\n * @returns {vec2} out\n */\nexport function set(out, x, y) {\n out[0] = x;\n out[1] = y;\n return out;\n}\n\n/**\n * Adds two vec2's\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @returns {vec2} out\n */\nexport function add(out, a, b) {\n out[0] = a[0] + b[0];\n out[1] = a[1] + b[1];\n return out;\n}\n\n/**\n * Subtracts vector b from vector a\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @returns {vec2} out\n */\nexport function subtract(out, a, b) {\n out[0] = a[0] - b[0];\n out[1] = a[1] - b[1];\n return out;\n}\n\n/**\n * Multiplies two vec2's\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @returns {vec2} out\n */\nexport function multiply(out, a, b) {\n out[0] = a[0] * b[0];\n out[1] = a[1] * b[1];\n return out;\n}\n\n/**\n * Divides two vec2's\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @returns {vec2} out\n */\nexport function divide(out, a, b) {\n out[0] = a[0] / b[0];\n out[1] = a[1] / b[1];\n return out;\n}\n\n/**\n * Math.ceil the components of a vec2\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a vector to ceil\n * @returns {vec2} out\n */\nexport function ceil(out, a) {\n out[0] = Math.ceil(a[0]);\n out[1] = Math.ceil(a[1]);\n return out;\n}\n\n/**\n * Math.floor the components of a vec2\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a vector to floor\n * @returns {vec2} out\n */\nexport function floor(out, a) {\n out[0] = Math.floor(a[0]);\n out[1] = Math.floor(a[1]);\n return out;\n}\n\n/**\n * Returns the minimum of two vec2's\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @returns {vec2} out\n */\nexport function min(out, a, b) {\n out[0] = Math.min(a[0], b[0]);\n out[1] = Math.min(a[1], b[1]);\n return out;\n}\n\n/**\n * Returns the maximum of two vec2's\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @returns {vec2} out\n */\nexport function max(out, a, b) {\n out[0] = Math.max(a[0], b[0]);\n out[1] = Math.max(a[1], b[1]);\n return out;\n}\n\n/**\n * symmetric round the components of a vec2\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a vector to round\n * @returns {vec2} out\n */\nexport function round(out, a) {\n out[0] = glMatrix.round(a[0]);\n out[1] = glMatrix.round(a[1]);\n return out;\n}\n\n/**\n * Scales a vec2 by a scalar number\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the vector to scale\n * @param {Number} b amount to scale the vector by\n * @returns {vec2} out\n */\nexport function scale(out, a, b) {\n out[0] = a[0] * b;\n out[1] = a[1] * b;\n return out;\n}\n\n/**\n * Adds two vec2's after scaling the second operand by a scalar value\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @param {Number} scale the amount to scale b by before adding\n * @returns {vec2} out\n */\nexport function scaleAndAdd(out, a, b, scale) {\n out[0] = a[0] + b[0] * scale;\n out[1] = a[1] + b[1] * scale;\n return out;\n}\n\n/**\n * Calculates the euclidian distance between two vec2's\n *\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @returns {Number} distance between a and b\n */\nexport function distance(a, b) {\n var x = b[0] - a[0],\n y = b[1] - a[1];\n return Math.sqrt(x * x + y * y);\n}\n\n/**\n * Calculates the squared euclidian distance between two vec2's\n *\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @returns {Number} squared distance between a and b\n */\nexport function squaredDistance(a, b) {\n var x = b[0] - a[0],\n y = b[1] - a[1];\n return x * x + y * y;\n}\n\n/**\n * Calculates the length of a vec2\n *\n * @param {ReadonlyVec2} a vector to calculate length of\n * @returns {Number} length of a\n */\nexport function length(a) {\n var x = a[0],\n y = a[1];\n return Math.sqrt(x * x + y * y);\n}\n\n/**\n * Calculates the squared length of a vec2\n *\n * @param {ReadonlyVec2} a vector to calculate squared length of\n * @returns {Number} squared length of a\n */\nexport function squaredLength(a) {\n var x = a[0],\n y = a[1];\n return x * x + y * y;\n}\n\n/**\n * Negates the components of a vec2\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a vector to negate\n * @returns {vec2} out\n */\nexport function negate(out, a) {\n out[0] = -a[0];\n out[1] = -a[1];\n return out;\n}\n\n/**\n * Returns the inverse of the components of a vec2\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a vector to invert\n * @returns {vec2} out\n */\nexport function inverse(out, a) {\n out[0] = 1.0 / a[0];\n out[1] = 1.0 / a[1];\n return out;\n}\n\n/**\n * Normalize a vec2\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a vector to normalize\n * @returns {vec2} out\n */\nexport function normalize(out, a) {\n var x = a[0],\n y = a[1];\n var len = x * x + y * y;\n if (len > 0) {\n //TODO: evaluate use of glm_invsqrt here?\n len = 1 / Math.sqrt(len);\n }\n out[0] = a[0] * len;\n out[1] = a[1] * len;\n return out;\n}\n\n/**\n * Calculates the dot product of two vec2's\n *\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @returns {Number} dot product of a and b\n */\nexport function dot(a, b) {\n return a[0] * b[0] + a[1] * b[1];\n}\n\n/**\n * Computes the cross product of two vec2's\n * Note that the cross product must by definition produce a 3D vector\n *\n * @param {vec3} out the receiving vector\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @returns {vec3} out\n */\nexport function cross(out, a, b) {\n var z = a[0] * b[1] - a[1] * b[0];\n out[0] = out[1] = 0;\n out[2] = z;\n return out;\n}\n\n/**\n * Performs a linear interpolation between two vec2's\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the first operand\n * @param {ReadonlyVec2} b the second operand\n * @param {Number} t interpolation amount, in the range [0-1], between the two inputs\n * @returns {vec2} out\n */\nexport function lerp(out, a, b, t) {\n var ax = a[0],\n ay = a[1];\n out[0] = ax + t * (b[0] - ax);\n out[1] = ay + t * (b[1] - ay);\n return out;\n}\n\n/**\n * Generates a random vector with the given scale\n *\n * @param {vec2} out the receiving vector\n * @param {Number} [scale] Length of the resulting vector. If omitted, a unit vector will be returned\n * @returns {vec2} out\n */\nexport function random(out, scale) {\n scale = scale === undefined ? 1.0 : scale;\n var r = glMatrix.RANDOM() * 2.0 * Math.PI;\n out[0] = Math.cos(r) * scale;\n out[1] = Math.sin(r) * scale;\n return out;\n}\n\n/**\n * Transforms the vec2 with a mat2\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the vector to transform\n * @param {ReadonlyMat2} m matrix to transform with\n * @returns {vec2} out\n */\nexport function transformMat2(out, a, m) {\n var x = a[0],\n y = a[1];\n out[0] = m[0] * x + m[2] * y;\n out[1] = m[1] * x + m[3] * y;\n return out;\n}\n\n/**\n * Transforms the vec2 with a mat2d\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the vector to transform\n * @param {ReadonlyMat2d} m matrix to transform with\n * @returns {vec2} out\n */\nexport function transformMat2d(out, a, m) {\n var x = a[0],\n y = a[1];\n out[0] = m[0] * x + m[2] * y + m[4];\n out[1] = m[1] * x + m[3] * y + m[5];\n return out;\n}\n\n/**\n * Transforms the vec2 with a mat3\n * 3rd vector component is implicitly '1'\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the vector to transform\n * @param {ReadonlyMat3} m matrix to transform with\n * @returns {vec2} out\n */\nexport function transformMat3(out, a, m) {\n var x = a[0],\n y = a[1];\n out[0] = m[0] * x + m[3] * y + m[6];\n out[1] = m[1] * x + m[4] * y + m[7];\n return out;\n}\n\n/**\n * Transforms the vec2 with a mat4\n * 3rd vector component is implicitly '0'\n * 4th vector component is implicitly '1'\n *\n * @param {vec2} out the receiving vector\n * @param {ReadonlyVec2} a the vector to transform\n * @param {ReadonlyMat4} m matrix to transform with\n * @returns {vec2} out\n */\nexport function transformMat4(out, a, m) {\n var x = a[0];\n var y = a[1];\n out[0] = m[0] * x + m[4] * y + m[12];\n out[1] = m[1] * x + m[5] * y + m[13];\n return out;\n}\n\n/**\n * Rotate a 2D vector\n * @param {vec2} out The receiving vec2\n * @param {ReadonlyVec2} a The vec2 point to rotate\n * @param {ReadonlyVec2} b The origin of the rotation\n * @param {Number} rad The angle of rotation in radians\n * @returns {vec2} out\n */\nexport function rotate(out, a, b, rad) {\n //Translate point to the origin\n var p0 = a[0] - b[0],\n p1 = a[1] - b[1],\n sinC = Math.sin(rad),\n cosC = Math.cos(rad);\n\n //perform rotation and translate to correct position\n out[0] = p0 * cosC - p1 * sinC + b[0];\n out[1] = p0 * sinC + p1 * cosC + b[1];\n return out;\n}\n\n/**\n * Get the smallest angle between two 2D vectors\n * @param {ReadonlyVec2} a The first operand\n * @param {ReadonlyVec2} b The second operand\n * @returns {Number} The angle in radians\n */\nexport function angle(a, b) {\n var ax = a[0],\n ay = a[1],\n bx = b[0],\n by = b[1];\n return Math.abs(Math.atan2(ay * bx - ax * by, ax * bx + ay * by));\n}\n\n/**\n * Get the signed angle in the interval [-pi,pi] between two 2D vectors (positive if `a` is to the right of `b`)\n * \n * @param {ReadonlyVec2} a The first vector\n * @param {ReadonlyVec2} b The second vector\n * @returns {number} The signed angle in radians\n */\nexport function signedAngle(a, b) {\n var ax = a[0],\n ay = a[1],\n bx = b[0],\n by = b[1];\n return Math.atan2(ax * by - ay * bx, ax * bx + ay * by);\n}\n\n/**\n * Set the components of a vec2 to zero\n *\n * @param {vec2} out the receiving vector\n * @returns {vec2} out\n */\nexport function zero(out) {\n out[0] = 0.0;\n out[1] = 0.0;\n return out;\n}\n\n/**\n * Returns a string representation of a vector\n *\n * @param {ReadonlyVec2} a vector to represent as a string\n * @returns {String} string representation of the vector\n */\nexport function str(a) {\n return \"vec2(\" + a[0] + \", \" + a[1] + \")\";\n}\n\n/**\n * Returns whether or not the vectors exactly have the same elements in the same position (when compared with ===)\n *\n * @param {ReadonlyVec2} a The first vector.\n * @param {ReadonlyVec2} b The second vector.\n * @returns {Boolean} True if the vectors are equal, false otherwise.\n */\nexport function exactEquals(a, b) {\n return a[0] === b[0] && a[1] === b[1];\n}\n\n/**\n * Returns whether or not the vectors have approximately the same elements in the same position.\n *\n * @param {ReadonlyVec2} a The first vector.\n * @param {ReadonlyVec2} b The second vector.\n * @returns {Boolean} True if the vectors are equal, false otherwise.\n */\nexport function equals(a, b) {\n var a0 = a[0],\n a1 = a[1];\n var b0 = b[0],\n b1 = b[1];\n return Math.abs(a0 - b0) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a0), Math.abs(b0)) && Math.abs(a1 - b1) <= glMatrix.EPSILON * Math.max(1.0, Math.abs(a1), Math.abs(b1));\n}\n\n/**\n * Alias for {@link vec2.length}\n * @function\n */\nexport var len = length;\n\n/**\n * Alias for {@link vec2.subtract}\n * @function\n */\nexport var sub = subtract;\n\n/**\n * Alias for {@link vec2.multiply}\n * @function\n */\nexport var mul = multiply;\n\n/**\n * Alias for {@link vec2.divide}\n * @function\n */\nexport var div = divide;\n\n/**\n * Alias for {@link vec2.distance}\n * @function\n */\nexport var dist = distance;\n\n/**\n * Alias for {@link vec2.squaredDistance}\n * @function\n */\nexport var sqrDist = squaredDistance;\n\n/**\n * Alias for {@link vec2.squaredLength}\n * @function\n */\nexport var sqrLen = squaredLength;\n\n/**\n * Perform some operation over an array of vec2s.\n *\n * @param {Array} a the array of vectors to iterate over\n * @param {Number} stride Number of elements between the start of each vec2. If 0 assumes tightly packed\n * @param {Number} offset Number of elements to skip at the beginning of the array\n * @param {Number} count Number of vec2s to iterate over. If 0 iterates over entire array\n * @param {Function} fn Function to call for each vector in the array\n * @param {Object} [arg] additional argument to pass to fn\n * @returns {Array} a\n * @function\n */\nexport var forEach = function () {\n var vec = create();\n return function (a, stride, offset, count, fn, arg) {\n var i, l;\n if (!stride) {\n stride = 2;\n }\n if (!offset) {\n offset = 0;\n }\n if (count) {\n l = Math.min(count * stride + offset, a.length);\n } else {\n l = a.length;\n }\n for (i = offset; i < l; i += stride) {\n vec[0] = a[i];\n vec[1] = a[i + 1];\n fn(vec, vec, arg);\n a[i] = vec[0];\n a[i + 1] = vec[1];\n }\n return a;\n };\n}();","\nexport default function unitBezier(p1x, p1y, p2x, p2y) {\n // Calculate the polynomial coefficients, implicit first and last control points are (0,0) and (1,1).\n const cx = 3 * p1x;\n const bx = 3 * (p2x - p1x) - cx;\n const ax = 1 - cx - bx;\n\n const cy = 3 * p1y;\n const by = 3 * (p2y - p1y) - cy;\n const ay = 1 - cy - by;\n\n return function solve(x, epsilon = 1e-6) {\n if (x <= 0) return 0;\n if (x >= 1) return 1;\n\n let t = x;\n\n // First try a few iterations of Newton's method - normally very fast.\n // `ax t^3 + bx t^2 + cx t` expanded using Horner's rule.\n for (let i = 0; i < 8; i++) {\n const x2 = ((ax * t + bx) * t + cx) * t - x;\n if (Math.abs(x2) < epsilon) return ((ay * t + by) * t + cy) * t;\n\n const d2 = (3 * ax * t + 2 * bx) * t + cx;\n if (Math.abs(d2) < 1e-6) break;\n\n t -= x2 / d2;\n }\n\n // Fall back to the bisection method for reliability.\n let t0 = 0;\n let t1 = 1;\n t = x;\n\n for (let i = 0; i < 20; i++) {\n const x2 = ((ax * t + bx) * t + cx) * t;\n if (Math.abs(x2 - x) < epsilon) break;\n\n if (x > x2) t0 = t;\n else t1 = t;\n\n t = (t0 + t1) * 0.5;\n }\n\n return ((ay * t + by) * t + cy) * t;\n };\n}\n","/**\n * A standalone point geometry with useful accessor, comparison, and\n * modification methods.\n *\n * @class\n * @param {number} x the x-coordinate. This could be longitude or screen pixels, or any other sort of unit.\n * @param {number} y the y-coordinate. This could be latitude or screen pixels, or any other sort of unit.\n *\n * @example\n * const point = new Point(-77, 38);\n */\nexport default function Point(x, y) {\n this.x = x;\n this.y = y;\n}\n\nPoint.prototype = {\n /**\n * Clone this point, returning a new point that can be modified\n * without affecting the old one.\n * @return {Point} the clone\n */\n clone() { return new Point(this.x, this.y); },\n\n /**\n * Add this point's x & y coordinates to another point,\n * yielding a new point.\n * @param {Point} p the other point\n * @return {Point} output point\n */\n add(p) { return this.clone()._add(p); },\n\n /**\n * Subtract this point's x & y coordinates to from point,\n * yielding a new point.\n * @param {Point} p the other point\n * @return {Point} output point\n */\n sub(p) { return this.clone()._sub(p); },\n\n /**\n * Multiply this point's x & y coordinates by point,\n * yielding a new point.\n * @param {Point} p the other point\n * @return {Point} output point\n */\n multByPoint(p) { return this.clone()._multByPoint(p); },\n\n /**\n * Divide this point's x & y coordinates by point,\n * yielding a new point.\n * @param {Point} p the other point\n * @return {Point} output point\n */\n divByPoint(p) { return this.clone()._divByPoint(p); },\n\n /**\n * Multiply this point's x & y coordinates by a factor,\n * yielding a new point.\n * @param {number} k factor\n * @return {Point} output point\n */\n mult(k) { return this.clone()._mult(k); },\n\n /**\n * Divide this point's x & y coordinates by a factor,\n * yielding a new point.\n * @param {number} k factor\n * @return {Point} output point\n */\n div(k) { return this.clone()._div(k); },\n\n /**\n * Rotate this point around the 0, 0 origin by an angle a,\n * given in radians\n * @param {number} a angle to rotate around, in radians\n * @return {Point} output point\n */\n rotate(a) { return this.clone()._rotate(a); },\n\n /**\n * Rotate this point around p point by an angle a,\n * given in radians\n * @param {number} a angle to rotate around, in radians\n * @param {Point} p Point to rotate around\n * @return {Point} output point\n */\n rotateAround(a, p) { return this.clone()._rotateAround(a, p); },\n\n /**\n * Multiply this point by a 4x1 transformation matrix\n * @param {[number, number, number, number]} m transformation matrix\n * @return {Point} output point\n */\n matMult(m) { return this.clone()._matMult(m); },\n\n /**\n * Calculate this point but as a unit vector from 0, 0, meaning\n * that the distance from the resulting point to the 0, 0\n * coordinate will be equal to 1 and the angle from the resulting\n * point to the 0, 0 coordinate will be the same as before.\n * @return {Point} unit vector point\n */\n unit() { return this.clone()._unit(); },\n\n /**\n * Compute a perpendicular point, where the new y coordinate\n * is the old x coordinate and the new x coordinate is the old y\n * coordinate multiplied by -1\n * @return {Point} perpendicular point\n */\n perp() { return this.clone()._perp(); },\n\n /**\n * Return a version of this point with the x & y coordinates\n * rounded to integers.\n * @return {Point} rounded point\n */\n round() { return this.clone()._round(); },\n\n /**\n * Return the magnitude of this point: this is the Euclidean\n * distance from the 0, 0 coordinate to this point's x and y\n * coordinates.\n * @return {number} magnitude\n */\n mag() {\n return Math.sqrt(this.x * this.x + this.y * this.y);\n },\n\n /**\n * Judge whether this point is equal to another point, returning\n * true or false.\n * @param {Point} other the other point\n * @return {boolean} whether the points are equal\n */\n equals(other) {\n return this.x === other.x &&\n this.y === other.y;\n },\n\n /**\n * Calculate the distance from this point to another point\n * @param {Point} p the other point\n * @return {number} distance\n */\n dist(p) {\n return Math.sqrt(this.distSqr(p));\n },\n\n /**\n * Calculate the distance from this point to another point,\n * without the square root step. Useful if you're comparing\n * relative distances.\n * @param {Point} p the other point\n * @return {number} distance\n */\n distSqr(p) {\n const dx = p.x - this.x,\n dy = p.y - this.y;\n return dx * dx + dy * dy;\n },\n\n /**\n * Get the angle from the 0, 0 coordinate to this point, in radians\n * coordinates.\n * @return {number} angle\n */\n angle() {\n return Math.atan2(this.y, this.x);\n },\n\n /**\n * Get the angle from this point to another point, in radians\n * @param {Point} b the other point\n * @return {number} angle\n */\n angleTo(b) {\n return Math.atan2(this.y - b.y, this.x - b.x);\n },\n\n /**\n * Get the angle between this point and another point, in radians\n * @param {Point} b the other point\n * @return {number} angle\n */\n angleWith(b) {\n return this.angleWithSep(b.x, b.y);\n },\n\n /**\n * Find the angle of the two vectors, solving the formula for\n * the cross product a x b = |a||b|sin(θ) for θ.\n * @param {number} x the x-coordinate\n * @param {number} y the y-coordinate\n * @return {number} the angle in radians\n */\n angleWithSep(x, y) {\n return Math.atan2(\n this.x * y - this.y * x,\n this.x * x + this.y * y);\n },\n\n /** @param {[number, number, number, number]} m */\n _matMult(m) {\n const x = m[0] * this.x + m[1] * this.y,\n y = m[2] * this.x + m[3] * this.y;\n this.x = x;\n this.y = y;\n return this;\n },\n\n /** @param {Point} p */\n _add(p) {\n this.x += p.x;\n this.y += p.y;\n return this;\n },\n\n /** @param {Point} p */\n _sub(p) {\n this.x -= p.x;\n this.y -= p.y;\n return this;\n },\n\n /** @param {number} k */\n _mult(k) {\n this.x *= k;\n this.y *= k;\n return this;\n },\n\n /** @param {number} k */\n _div(k) {\n this.x /= k;\n this.y /= k;\n return this;\n },\n\n /** @param {Point} p */\n _multByPoint(p) {\n this.x *= p.x;\n this.y *= p.y;\n return this;\n },\n\n /** @param {Point} p */\n _divByPoint(p) {\n this.x /= p.x;\n this.y /= p.y;\n return this;\n },\n\n _unit() {\n this._div(this.mag());\n return this;\n },\n\n _perp() {\n const y = this.y;\n this.y = this.x;\n this.x = -y;\n return this;\n },\n\n /** @param {number} angle */\n _rotate(angle) {\n const cos = Math.cos(angle),\n sin = Math.sin(angle),\n x = cos * this.x - sin * this.y,\n y = sin * this.x + cos * this.y;\n this.x = x;\n this.y = y;\n return this;\n },\n\n /**\n * @param {number} angle\n * @param {Point} p\n */\n _rotateAround(angle, p) {\n const cos = Math.cos(angle),\n sin = Math.sin(angle),\n x = p.x + cos * (this.x - p.x) - sin * (this.y - p.y),\n y = p.y + sin * (this.x - p.x) + cos * (this.y - p.y);\n this.x = x;\n this.y = y;\n return this;\n },\n\n _round() {\n this.x = Math.round(this.x);\n this.y = Math.round(this.y);\n return this;\n },\n\n constructor: Point\n};\n\n/**\n * Construct a point from an array if necessary, otherwise if the input\n * is already a Point, return it unchanged.\n * @param {Point | [number, number] | {x: number, y: number}} p input value\n * @return {Point} constructed point.\n * @example\n * // this\n * var point = Point.convert([0, 1]);\n * // is equivalent to\n * var point = new Point(0, 1);\n */\nPoint.convert = function (p) {\n if (p instanceof Point) {\n return /** @type {Point} */ (p);\n }\n if (Array.isArray(p)) {\n return new Point(+p[0], +p[1]);\n }\n if (p.x !== undefined && p.y !== undefined) {\n return new Point(+p.x, +p.y);\n }\n throw new Error('Expected [x, y] or {x, y} point format');\n};\n","/**\n * Deeply compares two object literals.\n *\n * @private\n */\nfunction deepEqual(a?: unknown, b?: unknown): boolean {\n if (Array.isArray(a)) {\n if (!Array.isArray(b) || a.length !== b.length) return false;\n for (let i = 0; i < a.length; i++) {\n if (!deepEqual(a[i], b[i])) return false;\n }\n return true;\n }\n if (typeof a === 'object' && a !== null && b !== null) {\n if (!(typeof b === 'object')) return false;\n const aRec = a as Record;\n const bRec = b as Record;\n const keys = Object.keys(aRec);\n if (keys.length !== Object.keys(bRec).length) return false;\n for (const key in aRec) {\n if (!deepEqual(aRec[key], bRec[key])) return false;\n }\n return true;\n }\n return a === b;\n}\n\nexport default deepEqual;\n","\n/**\n * Rearranges items so that all items in the [left, k] are the smallest.\n * The k-th element will have the (k - left + 1)-th smallest value in [left, right].\n *\n * @template T\n * @param {T[]} arr the array to partially sort (in place)\n * @param {number} k middle index for partial sorting (as defined above)\n * @param {number} [left=0] left index of the range to sort\n * @param {number} [right=arr.length-1] right index\n * @param {(a: T, b: T) => number} [compare = (a, b) => a - b] compare function\n */\nexport default function quickselect(arr, k, left = 0, right = arr.length - 1, compare = defaultCompare) {\n\n while (right > left) {\n if (right - left > 600) {\n const n = right - left + 1;\n const m = k - left + 1;\n const z = Math.log(n);\n const s = 0.5 * Math.exp(2 * z / 3);\n const sd = 0.5 * Math.sqrt(z * s * (n - s) / n) * (m - n / 2 < 0 ? -1 : 1);\n const newLeft = Math.max(left, Math.floor(k - m * s / n + sd));\n const newRight = Math.min(right, Math.floor(k + (n - m) * s / n + sd));\n quickselect(arr, k, newLeft, newRight, compare);\n }\n\n const t = arr[k];\n let i = left;\n /** @type {number} */\n let j = right;\n\n swap(arr, left, k);\n if (compare(arr[right], t) > 0) swap(arr, left, right);\n\n while (i < j) {\n swap(arr, i, j);\n i++;\n j--;\n while (compare(arr[i], t) < 0) i++;\n while (compare(arr[j], t) > 0) j--;\n }\n\n if (compare(arr[left], t) === 0) swap(arr, left, j);\n else {\n j++;\n swap(arr, j, right);\n }\n\n if (j <= k) left = j + 1;\n if (k <= j) right = j - 1;\n }\n}\n\n/**\n * @template T\n * @param {T[]} arr\n * @param {number} i\n * @param {number} j\n */\nfunction swap(arr, i, j) {\n const tmp = arr[i];\n arr[i] = arr[j];\n arr[j] = tmp;\n}\n\n/**\n * @template T\n * @param {T} a\n * @param {T} b\n * @returns {number}\n */\nfunction defaultCompare(a, b) {\n return a < b ? -1 : a > b ? 1 : 0;\n}\n","import quickselect from 'quickselect';\nimport Point from '@mapbox/point-geometry';\n\ntype Ring = Point[] & {area?: number};\n\n// minX, minY, maxX, maxY\nexport type BBox = [number, number, number, number];\n\n/**\n * Returns the signed area for the polygon ring. Postive areas are exterior rings and\n * have a clockwise winding. Negative areas are interior rings and have a counter clockwise\n * ordering.\n */\nexport function calculateSignedArea(ring: Ring): number {\n let sum = 0;\n for (let i = 0, len = ring.length, j = len - 1, p1: Point, p2: Point; i < len; j = i++) {\n p1 = ring[i] as Point;\n p2 = ring[j] as Point;\n sum += (p2.x - p1.x) * (p1.y + p2.y);\n }\n return sum;\n}\n\nfunction compareAreas(a: Ring, b: Ring): number {\n return (b.area as number) - (a.area as number);\n}\n\n// classifies an array of rings into polygons with outer rings and holes\nexport function classifyRings(rings: Array, maxRings: number): Array> {\n const len = rings.length;\n\n if (len <= 1) return [rings];\n\n const polygons: Array> = [];\n let polygon: Array | undefined,\n ccw: boolean | undefined;\n\n for (let i = 0; i < len; i++) {\n const area = calculateSignedArea(rings[i] as Ring);\n if (area === 0) continue;\n\n (rings[i] as Ring).area = Math.abs(area);\n\n if (ccw === undefined) ccw = area < 0;\n\n if (ccw === area < 0) {\n if (polygon) polygons.push(polygon);\n polygon = [rings[i] as Ring];\n } else {\n (polygon as Array).push(rings[i] as Ring);\n }\n }\n if (polygon) polygons.push(polygon);\n\n // Earcut performance degrades with the # of rings in a polygon. For this\n // reason, we limit strip out all but the `maxRings` largest rings.\n if (maxRings > 1) {\n for (let j = 0; j < polygons.length; j++) {\n const currentPolygon = polygons[j] as Array;\n if (currentPolygon.length <= maxRings) continue;\n quickselect(currentPolygon, maxRings, 1, currentPolygon.length - 1, compareAreas);\n polygons[j] = currentPolygon.slice(0, maxRings);\n }\n }\n\n return polygons;\n}\n\nexport function updateBBox(bbox: BBox, coord: GeoJSON.Position) {\n bbox[0] = Math.min(bbox[0], coord[0] as number);\n bbox[1] = Math.min(bbox[1], coord[1] as number);\n bbox[2] = Math.max(bbox[2], coord[0] as number);\n bbox[3] = Math.max(bbox[3], coord[1] as number);\n}\n\nexport function boxWithinBox(bbox1: BBox, bbox2: BBox): boolean {\n if (bbox1[0] <= bbox2[0]) return false;\n if (bbox1[2] >= bbox2[2]) return false;\n if (bbox1[1] <= bbox2[1]) return false;\n if (bbox1[3] >= bbox2[3]) return false;\n return true;\n}\n\nfunction onBoundary(p: GeoJSON.Position, p1: GeoJSON.Position, p2: GeoJSON.Position) {\n const x1 = (p[0] as number) - (p1[0] as number);\n const y1 = (p[1] as number) - (p1[1] as number);\n const x2 = (p[0] as number) - (p2[0] as number);\n const y2 = (p[1] as number) - (p2[1] as number);\n return (x1 * y2 - x2 * y1 === 0) && (x1 * x2 <= 0) && (y1 * y2 <= 0);\n}\n\nfunction rayIntersect(p: GeoJSON.Position, p1: GeoJSON.Position, p2: GeoJSON.Position) {\n return (((p1[1] as number) > (p[1] as number)) !== ((p2[1] as number) > (p[1] as number))) && ((p[0] as number) < ((p2[0] as number) - (p1[0] as number)) * ((p[1] as number) - (p1[1] as number)) / ((p2[1] as number) - (p1[1] as number)) + (p1[0] as number));\n}\n\n// ray casting algorithm for detecting if point is in polygon\nexport function pointWithinPolygon(\n point: GeoJSON.Position,\n rings: Array>,\n trueOnBoundary: boolean = false,\n): boolean {\n let inside = false;\n for (let i = 0, len = rings.length; i < len; i++) {\n const ring = rings[i] as Array;\n for (let j = 0, len2 = ring.length, k = len2 - 1; j < len2; k = j++) {\n const q1 = ring[k] as GeoJSON.Position;\n const q2 = ring[j] as GeoJSON.Position;\n if (onBoundary(point, q1, q2)) return trueOnBoundary;\n if (rayIntersect(point, q1, q2)) inside = !inside;\n }\n }\n return inside;\n}\n\nfunction perp(v1: GeoJSON.Position, v2: GeoJSON.Position) {\n return (v1[0] as number) * (v2[1] as number) - (v1[1] as number) * (v2[0] as number);\n}\n\n// check if p1 and p2 are in different sides of line segment q1->q2\nfunction twoSided(p1: GeoJSON.Position, p2: GeoJSON.Position, q1: GeoJSON.Position, q2: GeoJSON.Position) {\n // q1->p1 (x1, y1), q1->p2 (x2, y2), q1->q2 (x3, y3)\n const x1 = (p1[0] as number) - (q1[0] as number);\n const y1 = (p1[1] as number) - (q1[1] as number);\n const x2 = (p2[0] as number) - (q1[0] as number);\n const y2 = (p2[1] as number) - (q1[1] as number);\n const x3 = (q2[0] as number) - (q1[0] as number);\n const y3 = (q2[1] as number) - (q1[1] as number);\n const det1 = x1 * y3 - x3 * y1;\n const det2 = x2 * y3 - x3 * y2;\n if ((det1 > 0 && det2 < 0) || (det1 < 0 && det2 > 0)) return true;\n return false;\n}\n// a, b are end points for line segment1, c and d are end points for line segment2\nexport function segmentIntersectSegment(\n a: GeoJSON.Position,\n b: GeoJSON.Position,\n c: GeoJSON.Position,\n d: GeoJSON.Position,\n): boolean {\n // check if two segments are parallel or not\n // precondition is end point a, b is inside polygon, if line a->b is\n // parallel to polygon edge c->d, then a->b won't intersect with c->d\n const vectorP = [(b[0] as number) - (a[0] as number), (b[1] as number) - (a[1] as number)];\n const vectorQ = [(d[0] as number) - (c[0] as number), (d[1] as number) - (c[1] as number)];\n if (perp(vectorQ, vectorP) === 0) return false;\n\n // If lines are intersecting with each other, the relative location should be:\n // a and b lie in different sides of segment c->d\n // c and d lie in different sides of segment a->b\n if (twoSided(a, b, c, d) && twoSided(c, d, a, b)) return true;\n return false;\n}\n\nexport interface Bounds {\n min: Point;\n max: Point;\n}\n\nexport function computeBounds(points: Point[][]): Bounds {\n const min = new Point(Number.POSITIVE_INFINITY, Number.POSITIVE_INFINITY);\n const max = new Point(Number.NEGATIVE_INFINITY, Number.NEGATIVE_INFINITY);\n\n for (const point of points[0] as Point[]) {\n if (min.x > point.x) min.x = point.x;\n if (min.y > point.y) min.y = point.y;\n if (max.x < point.x) max.x = point.x;\n if (max.y < point.y) max.y = point.y;\n }\n\n return {min, max};\n}\n","import {mat4} from 'gl-matrix';\nimport bezier from '@mapbox/unitbezier';\nimport Point from '@mapbox/point-geometry';\nimport assert from '../style-spec/util/assert';\nimport deepEqual from '../style-spec/util/deep_equal';\n\nimport type {vec4} from 'gl-matrix';\nimport type {Range} from '../../3d-style/elevation/elevation_feature';\nimport type {Callback} from '../types/callback';\nimport type {ExpiryData} from '../source/tile';\n\nconst DEG_TO_RAD = Math.PI / 180;\nconst RAD_TO_DEG = 180 / Math.PI;\n\nconst UUID_V4_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[4][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\n\n/**\n * Converts an angle in degrees to radians\n * copy all properties from the source objects into the destination.\n * The last source object given overrides properties from previous\n * source objects.\n *\n * @param a angle to convert\n * @returns the angle in radians\n * @private\n */\nexport function degToRad(a: number): number {\n return a * DEG_TO_RAD;\n}\n\n/**\n * Converts an angle in radians to degrees\n * copy all properties from the source objects into the destination.\n * The last source object given overrides properties from previous\n * source objects.\n *\n * @param a angle to convert\n * @returns the angle in degrees\n * @private\n */\nexport function radToDeg(a: number): number {\n return a * RAD_TO_DEG;\n}\n\nconst TILE_CORNERS = [[0, 0], [1, 0], [1, 1], [0, 1]] as const;\n\n/**\n * Given a particular bearing, returns the corner of the tile thats farthest\n * along the bearing.\n *\n * @param {number} bearing angle in degrees (-180, 180]\n * @returns {QuadCorner}\n * @private\n */\nexport function furthestTileCorner(bearing: number): Readonly<[number, number]> {\n const alignedBearing = ((bearing + 45) + 360) % 360;\n const cornerIdx = Math.round(alignedBearing / 90) % 4;\n return TILE_CORNERS[cornerIdx];\n}\n\n/**\n * @module util\n * @private\n */\n\n/**\n * Given a value `t` that varies between 0 and 1, return\n * an interpolation function that eases between 0 and 1 in a pleasing\n * cubic in-out fashion.\n *\n * @private\n */\nexport function easeCubicInOut(t: number): number {\n if (t <= 0) return 0;\n if (t >= 1) return 1;\n const t2 = t * t,\n t3 = t2 * t;\n return 4 * (t < 0.5 ? t3 : 3 * (t - t2) + t3 - 0.75);\n}\n\n/**\n * Computes an AABB for a set of points.\n *\n * @param {Point[]} points\n * @returns {{ min: Point, max: Point}}\n * @private\n */\nexport function getBounds(points: Point[]): {\n min: Point;\n max: Point;\n} {\n let minX = Infinity;\n let minY = Infinity;\n let maxX = -Infinity;\n let maxY = -Infinity;\n for (const p of points) {\n minX = Math.min(minX, p.x);\n minY = Math.min(minY, p.y);\n maxX = Math.max(maxX, p.x);\n maxY = Math.max(maxY, p.y);\n }\n\n return {\n min: new Point(minX, minY),\n max: new Point(maxX, maxY),\n };\n}\n\n/**\n * Returns the square of the 2D distance between an AABB defined by min and max and a point.\n * If point is null or undefined, the AABB distance from the origin (0,0) is returned.\n *\n * @param {Array} min The minimum extent of the AABB.\n * @param {Array} max The maximum extent of the AABB.\n * @param {Array} [point] The point to compute the distance from, may be undefined.\n * @returns {number} The square distance from the AABB, 0.0 if the AABB contains the point.\n */\nexport function getAABBPointSquareDist(min: Array, max: Array, point?: Array | null): number {\n let sqDist = 0.0;\n\n for (let i = 0; i < 2; ++i) {\n const v = point ? point[i] : 0.0;\n assert(min[i] < max[i], 'Invalid aabb min and max inputs, min[i] must be < max[i].');\n if (min[i] > v) sqDist += (min[i] - v) * (min[i] - v);\n if (max[i] < v) sqDist += (v - max[i]) * (v - max[i]);\n }\n\n return sqDist;\n}\n\n/**\n * Converts a AABB into a polygon with clockwise winding order.\n *\n * @param {Point} min The top left point.\n * @param {Point} max The bottom right point.\n * @param {number} [buffer=0] The buffer width.\n * @param {boolean} [close=true] Whether to close the polygon or not.\n * @returns {Point[]} The polygon.\n */\nexport function polygonizeBounds(min: Point, max: Point, buffer: number = 0, close: boolean = true): Point[] {\n const offset = new Point(buffer, buffer);\n const minBuf = min.sub(offset);\n const maxBuf = max.add(offset);\n const polygon = [minBuf, new Point(maxBuf.x, minBuf.y), maxBuf, new Point(minBuf.x, maxBuf.y)];\n\n if (close) {\n polygon.push(minBuf.clone());\n }\n return polygon;\n}\n\n/**\n * Takes a convex ring and expands it outward by applying a buffer around it.\n * This function assumes that the ring is in clockwise winding order.\n *\n * @param {Point[]} ring The input ring.\n * @param {number} buffer The buffer width.\n * @returns {Point[]} The expanded ring.\n */\nexport function bufferConvexPolygon(ring: Point[], buffer: number): Point[] {\n assert(ring.length > 2, 'bufferConvexPolygon requires the ring to have atleast 3 points');\n const output: Point[] = [];\n for (let currIdx = 0; currIdx < ring.length; currIdx++) {\n const prevIdx = wrap(currIdx - 1, -1, ring.length - 1);\n const nextIdx = wrap(currIdx + 1, -1, ring.length - 1);\n const prev = ring[prevIdx];\n const curr = ring[currIdx];\n const next = ring[nextIdx];\n const p1 = prev.sub(curr).unit();\n const p2 = next.sub(curr).unit();\n const interiorAngle = p2.angleWithSep(p1.x, p1.y);\n // Calcuate a vector that points in the direction of the angle bisector between two sides.\n // Scale it based on a right angled triangle constructed at that corner.\n const offset = p1.add(p2).unit().mult(-1 * buffer / Math.sin(interiorAngle / 2));\n output.push(curr.add(offset));\n }\n return output;\n}\n\nexport {bezier};\n\n/**\n * A default bezier-curve powered easing function with\n * control points (0.25, 0.1) and (0.25, 1)\n *\n * @private\n */\nexport const ease = bezier(0.25, 0.1, 0.25, 1);\n\n/**\n * constrain n to the given range via min + max\n *\n * @param n value\n * @param min the minimum value to be returned\n * @param max the maximum value to be returned\n * @returns the clamped value\n * @private\n */\nexport function clamp(n: number, min: number, max: number): number {\n return Math.min(max, Math.max(min, n));\n}\n\n/**\n * Equivalent to GLSL smoothstep.\n *\n * @param {number} e0 The lower edge of the sigmoid\n * @param {number} e1 The upper edge of the sigmoid\n * @param {number} x the value to be interpolated\n * @returns {number} in the range [0, 1]\n * @private\n */\nexport function smoothstep(e0: number, e1: number, x: number): number {\n x = clamp((x - e0) / (e1 - e0), 0, 1);\n return x * x * (3 - 2 * x);\n}\n\n/**\n * constrain n to the given range, excluding the minimum, via modular arithmetic\n *\n * @param n value\n * @param min the minimum value to be returned, exclusive\n * @param max the maximum value to be returned, inclusive\n * @returns constrained number\n * @private\n */\nexport function wrap(n: number, min: number, max: number): number {\n const d = max - min;\n const w = ((n - min) % d + d) % d + min;\n return (w === min) ? max : w;\n}\n\n/**\n * Computes shortest angle in range [-180, 180) between two angles.\n *\n * @param {*} a First angle in degrees\n * @param {*} b Second angle in degrees\n * @returns Shortest angle\n * @private\n */\nexport function shortestAngle(a: number, b: number): number {\n const diff = (b - a + 180) % 360 - 180;\n return diff < -180 ? diff + 360 : diff;\n}\n\n/*\n * Call an asynchronous function on an array of arguments,\n * calling `callback` with the completed results of all calls.\n *\n * @param array input to each call of the async function.\n * @param fn an async function with signature (data, callback)\n * @param callback a callback run after all async work is done.\n * called with an array, containing the results of each async call.\n * @private\n */\nexport function asyncAll(\n array: Array,\n fn: (item: Item, fnCallback: Callback) => void,\n callback: Callback>,\n): void {\n if (!array.length) { return callback(null, []); }\n let remaining = array.length;\n const results = new Array(array.length);\n let error = null;\n array.forEach((item, i) => {\n fn(item, (err, result) => {\n if (err) error = err;\n results[i] = result;\n // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n if (--remaining === 0) callback(error, results);\n });\n });\n}\n\n/*\n * Compute the difference between the keys in one object and the keys\n * in another object.\n *\n * @returns keys difference\n * @private\n */\nexport function keysDifference(\n obj: Record,\n other: Record,\n): Array {\n const difference: string[] = [];\n for (const i in obj) {\n if (!(i in other)) {\n difference.push(i);\n }\n }\n return difference;\n}\n\n/**\n * Given an object and a number of properties as strings, return version\n * of that object with only those properties.\n *\n * @param src the object\n * @param properties an array of property names chosen\n * to appear on the resulting object.\n * @returns object with limited properties.\n * @example\n * var foo = { name: 'Charlie', age: 10 };\n * var justName = pick(foo, ['name']);\n * // justName = { name: 'Charlie' }\n * @private\n */\nexport function pick(src: T, properties: Array): Pick {\n const result = {} as Pick;\n for (let i = 0; i < properties.length; i++) {\n const k = properties[i];\n if (k in src) {\n result[k] = src[k];\n }\n }\n return result;\n}\n\nlet id = 1;\n\n/**\n * Return a unique numeric id, starting at 1 and incrementing with\n * each call.\n *\n * @returns unique numeric id.\n * @private\n */\nexport function uniqueId(): number {\n return id++;\n}\n\n/**\n * Return a random UUID (v4). Taken from: https://gist.github.com/jed/982883\n * @private\n */\nexport function uuid(): string {\n function b(a?: undefined): string {\n return a ?\n (a ^ Math.random() * (16 >> a / 4)).toString(16) :\n // eslint-disable-next-line @typescript-eslint/no-unsafe-unary-minus\n (([1e7] as unknown as string) + -[1e3] + -4e3 + -8e3 + -1e11).replace(/[018]/g, b);\n }\n return b();\n}\n\n/**\n * Return whether a given value is a power of two\n * @private\n */\nexport function isPowerOfTwo(value: number): boolean {\n return (Math.log2(value)) % 1 === 0;\n}\n\n/**\n * Return the next power of two, or the input value if already a power of two\n * @private\n */\nexport function nextPowerOfTwo(value: number): number {\n if (value <= 1) return 1;\n return Math.pow(2, Math.ceil(Math.log2(value)));\n}\n\n/**\n * Return the previous power of two, or the input value if already a power of two\n * @private\n */\nexport function prevPowerOfTwo(value: number): number {\n if (value <= 1) return 1;\n return Math.pow(2, Math.floor(Math.log2(value)));\n}\n\n/**\n * Validate a string to match UUID(v4) of the\n * form: xxxxxxxx-xxxx-4xxx-[89ab]xxx-xxxxxxxxxxxx\n * @param str string to validate.\n * @private\n */\nexport function validateUuid(str?: string | null): boolean {\n return str ? UUID_V4_RE.test(str) : false;\n}\n\n/**\n * Given an array of member function names as strings, replace all of them\n * with bound versions that will always refer to `context` as `this`. This\n * is useful for classes where otherwise event bindings would reassign\n * `this` to the evented object or some other value: this lets you ensure\n * the `this` value always.\n *\n * @param fns list of member function names\n * @param context the context value\n * @example\n * function MyClass() {\n * bindAll(['ontimer'], this);\n * this.name = 'Tom';\n * }\n * MyClass.prototype.ontimer = function() {\n * alert(this.name);\n * };\n * var myClass = new MyClass();\n * setTimeout(myClass.ontimer, 100);\n * @private\n */\nexport function bindAll(fns: Array, context: unknown): void {\n fns.forEach((fn) => {\n if (!context[fn]) { return; }\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access\n context[fn] = context[fn].bind(context);\n });\n}\n\n/**\n * Create an object by mapping all the values of an existing object while\n * preserving their keys.\n *\n * @private\n */\nexport function mapObject(\n this: unknown,\n input: Record,\n iterator: (value: T, key: PropertyKey, obj: Record) => U,\n context?: unknown\n): Record {\n const output: Record = {};\n for (const key in input) {\n output[key] = iterator.call(context || this, input[key], key, input);\n }\n return output;\n}\n\n/**\n * Create an object by filtering out values of an existing object.\n *\n * @private\n */\nexport function filterObject>(\n this: unknown,\n input: T,\n iterator: (value: T[keyof T], key: keyof T, obj: T) => boolean,\n context?: unknown\n): T {\n const output = {} as T;\n for (const key in input) {\n if (iterator.call(context || this, input[key], key, input)) {\n output[key] = input[key];\n }\n }\n return output;\n}\n\n/**\n * Deeply clones two objects.\n *\n * @private\n */\nexport function clone(input: T): T {\n if (Array.isArray(input)) {\n return input.map(clone) as T;\n } else if (typeof input === 'object' && input) {\n return mapObject(input as Record, clone) as T;\n } else {\n return input;\n }\n}\n\n/**\n * Maps a value from a range between [min, max] to the range [outMin, outMax]\n *\n * @private\n */\nexport function mapValue(value: number, min: number, max: number, outMin: number, outMax: number): number {\n return clamp((value - min) / (max - min) * (outMax - outMin) + outMin, outMin, outMax);\n}\n\n/**\n * Check if two arrays have at least one common element.\n *\n * @private\n */\nexport function arraysIntersect(a: Array, b: Array): boolean {\n for (let l = 0; l < a.length; l++) {\n if (b.includes(a[l])) return true;\n }\n return false;\n}\n\n/**\n * Print a warning message to the console and ensure duplicate warning messages\n * are not printed.\n *\n * @private\n */\nconst warnOnceHistory: {\n [key: string]: boolean;\n} = {};\n\nexport function warnOnce(message: string): void {\n if (!warnOnceHistory[message]) {\n // console isn't defined in some WebWorkers, see #2558\n if (typeof console !== \"undefined\") console.warn(message);\n warnOnceHistory[message] = true;\n }\n}\n\n/**\n * Indicates if the provided Points are in a counter clockwise (true) or clockwise (false) order\n *\n * @private\n * @returns true for a counter clockwise set of points\n */\n// http://bryceboe.com/2006/10/23/line-segment-intersection-algorithm/\nexport function isCounterClockwise(a: Point, b: Point, c: Point): boolean {\n return (c.y - a.y) * (b.x - a.x) > (b.y - a.y) * (c.x - a.x);\n}\n\nexport {calculateSignedArea} from '../style-spec/util/geometry_util';\n\nexport type Position = {\n x: number;\n y: number;\n z: number;\n azimuthal: number;\n polar: number;\n};\n\nexport type Direction = {\n x: number;\n y: number;\n z: number;\n};\n\n/**\n * Converts spherical coordinates to cartesian position coordinates.\n *\n * @private\n * @param spherical Spherical coordinates, in [radial, azimuthal, polar]\n * @return Position cartesian coordinates\n */\nexport function sphericalPositionToCartesian([r, azimuthal, polar]: [number, number, number]): Position {\n // We abstract \"north\"/\"up\" (compass-wise) to be 0° when really this is 90° (π/2):\n // correct for that here\n const a = degToRad(azimuthal + 90), p = degToRad(polar);\n\n return {\n x: r * Math.cos(a) * Math.sin(p),\n y: r * Math.sin(a) * Math.sin(p),\n z: r * Math.cos(p),\n azimuthal, polar\n };\n}\n\n/**\n * Converts spherical direction to cartesian coordinates.\n *\n * @private\n * @param spherical Spherical direction, in [azimuthal, polar]\n * @return Direction cartesian direction\n */\nexport function sphericalDirectionToCartesian([azimuthal, polar]: [number, number]): Direction {\n const position = sphericalPositionToCartesian([1.0, azimuthal, polar]);\n\n return {\n x: position.x,\n y: position.y,\n z: position.z\n };\n}\n\nexport function cartesianPositionToSpherical(x: number, y: number, z: number): [number, number, number] {\n const radial = Math.sqrt(x * x + y * y + z * z);\n const polar = radial > 0.0 ? Math.acos(z / radial) * RAD_TO_DEG : 0.0;\n // Domain error may occur if x && y are both 0.0\n let azimuthal = (x !== 0.0 || y !== 0.0) ? Math.atan2(-y, -x) * RAD_TO_DEG + 90.0 : 0.0;\n\n if (azimuthal < 0.0) {\n azimuthal += 360.0;\n }\n\n return [radial, azimuthal, polar];\n}\n\n/**\n * Returns true if run in the web-worker context.\n *\n * @private\n * @returns {boolean}\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ndeclare const WorkerGlobalScope: (new (...args: any[]) => any) | undefined;\n\nexport function isWorker(scope?: unknown): scope is Worker {\n if (typeof self === 'undefined' && scope === undefined) {\n return false;\n }\n\n // Check if WorkerGlobalScope isn't available\n // This is a global that's only present in browser worker environments\n if (typeof WorkerGlobalScope === 'undefined') {\n return false;\n }\n\n // Use provided scope or global self\n const contextToCheck = scope !== undefined ? scope : self;\n\n // Final check if context is a WorkerGlobalScope\n return contextToCheck instanceof WorkerGlobalScope;\n}\n\n/**\n * Parses data from 'Cache-Control' headers.\n *\n * @private\n * @param cacheControl Value of 'Cache-Control' header\n * @return object containing parsed header info.\n */\n\nexport function parseCacheControl(cacheControl: string): Record {\n // Taken from [Wreck](https://github.com/hapijs/wreck)\n const re = /(?:^|(?:\\s*\\,\\s*))([^\\x00-\\x20\\(\\)<>@\\,;\\:\\\\\"\\/\\[\\]\\?\\=\\{\\}\\x7F]+)(?:\\=(?:([^\\x00-\\x20\\(\\)<>@\\,;\\:\\\\\"\\/\\[\\]\\?\\=\\{\\}\\x7F]+)|(?:\\\"((?:[^\"\\\\]|\\\\.)*)\\\")))?/g;\n\n const header: Record = {};\n cacheControl.replace(re, ($0, $1, $2, $3) => {\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n const value = $2 || $3;\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-call\n header[$1] = value ? value.toLowerCase() : true;\n return '';\n });\n\n if (header['max-age']) {\n const maxAge = parseInt(header['max-age'] as string, 10);\n if (isNaN(maxAge)) delete header['max-age'];\n else header['max-age'] = maxAge;\n }\n\n return header as Record;\n}\n\nexport function parseExpiryData(responseHeaders: Headers | undefined): ExpiryData {\n if (!responseHeaders) return {cacheControl: undefined, expires: undefined};\n const cacheControl = responseHeaders.get('cache-control');\n const expires = responseHeaders.get('expires');\n return {cacheControl, expires};\n}\n\nexport function isFullscreen(): boolean {\n return !!document.fullscreenElement || !!(document as {webkitFullscreenElement?: boolean}).webkitFullscreenElement;\n}\n\nexport function storageAvailable(type: string): boolean {\n try {\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n const storage = self[type];\n // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access\n storage.setItem('_mapbox_test_', 1);\n // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access\n storage.removeItem('_mapbox_test_');\n return true;\n } catch (e) {\n return false;\n }\n}\n\n// The following methods are from https://developer.mozilla.org/en-US/docs/Web/API/WindowBase64/Base64_encoding_and_decoding#The_Unicode_Problem\n//Unicode compliant base64 encoder for strings\nexport function b64EncodeUnicode(str: string): string {\n return btoa(\n encodeURIComponent(str).replace(/%([0-9A-F]{2})/g,\n (match, p1) => {\n return String.fromCharCode(Number('0x' + p1)); //eslint-disable-line\n }\n )\n );\n}\n\n// Unicode compliant decoder for base64-encoded strings\nexport function b64DecodeUnicode(str: string): string {\n return decodeURIComponent(atob(str).split('').map((c) => {\n return '%' + ('00' + c.charCodeAt(0).toString(16)).slice(-2); //eslint-disable-line\n }).join(''));\n}\n\nexport function base64DecToArr(sBase64: string): Uint8Array {\n const str = atob(sBase64);\n const arr = new Uint8Array(str.length);\n for (let i = 0; i < str.length; i++) arr[i] = str.codePointAt(i);\n return arr;\n}\n\nexport function getColumn(matrix: mat4, col: number): vec4 {\n return [matrix[col * 4], matrix[col * 4 + 1], matrix[col * 4 + 2], matrix[col * 4 + 3]];\n}\n\nexport function setColumn(matrix: mat4, col: number, values: vec4) {\n matrix[col * 4 + 0] = values[0];\n matrix[col * 4 + 1] = values[1];\n matrix[col * 4 + 2] = values[2];\n matrix[col * 4 + 3] = values[3];\n}\n\nexport function sRGBToLinearAndScale(v: [number, number, number, number], s: number): [number, number, number] {\n return [\n Math.pow(v[0], 2.2) * s,\n Math.pow(v[1], 2.2) * s,\n Math.pow(v[2], 2.2) * s\n ];\n}\n\nexport function linearVec3TosRGB(v: [number, number, number]): [number, number, number] {\n return [\n Math.pow(v[0], 1.0 / 2.2),\n Math.pow(v[1], 1.0 / 2.2),\n Math.pow(v[2], 1.0 / 2.2)\n ];\n}\n\nexport function lowerBound(array: number[], startIndex: number, finishIndex: number, target: number): number {\n while (startIndex < finishIndex) {\n const middleIndex = (startIndex + finishIndex) >> 1;\n\n if (array[middleIndex] < target) {\n startIndex = middleIndex + 1;\n } else {\n finishIndex = middleIndex;\n }\n }\n\n return startIndex;\n}\n\nexport function upperBound(array: number[], startIndex: number, finishIndex: number, target: number): number {\n while (startIndex < finishIndex) {\n const middleIndex = (startIndex + finishIndex) >> 1;\n\n if (array[middleIndex] <= target) {\n startIndex = middleIndex + 1;\n } else {\n finishIndex = middleIndex;\n }\n }\n\n return startIndex;\n}\n\nexport function contrastFactor(contrast: number): number {\n return contrast > 0 ?\n 1 / (1.001 - contrast) :\n 1 + contrast;\n}\n\nexport function saturationFactor(saturation: number): number {\n return saturation > 0 ?\n 1 - 1 / (1.001 - saturation) :\n -saturation;\n}\n\n/**\n * Given the inputs creates a matrix that when applied to a color can\n * change its saturation, contrast and brightness levels.\n * This results in the same behaviour that happens in raster.fragment.glsl\n *\n * @param saturation Saturation level ranging from -1 to 1.\n * @param contrast Contrast level ranging from -1 to 1.\n * @param brightnessMin Minimum brightness ranging from 0 to 1.\n * @param brightnessMax Maximum brightness ranging from 0 to 1.\n * @returns Matrix that adjusts saturation, contrast and brightness of a color.\n * @private\n */\nexport function computeColorAdjustmentMatrix(\n saturation: number,\n contrast: number,\n brightnessMin: number,\n brightnessMax: number,\n): mat4 {\n saturation = saturationFactor(saturation);\n contrast = contrastFactor(contrast);\n\n const m = mat4.create();\n\n /*hueAngle *= Math.PI / 180;\n const s = Math.sin(hueAngle);\n const c = Math.cos(hueAngle);\n const x = (2 * c + 1) / 3;\n const y = (-c - Math.sqrt(3) * s + 1) / 3;\n const z = (-c + Math.sqrt(3) * s + 1) / 3;\n const hueMatrix = [\n x, z, y, 0,\n y, x, z, 0,\n z, y, x, 0,\n 0, 0, 0, 1\n ];*/\n\n const sa = saturation / 3.0;\n const sb = 1.0 - 2.0 * sa;\n const saturationMatrix: mat4 = [\n sb, sa, sa, 0.0,\n sa, sb, sa, 0.0,\n sa, sa, sb, 0.0,\n 0.0, 0.0, 0.0, 1.0\n ];\n\n const cs = 0.5 - 0.5 * contrast;\n const contrastMatrix: mat4 = [\n contrast, 0.0, 0.0, 0.0,\n 0.0, contrast, 0.0, 0.0,\n 0.0, 0.0, contrast, 0.0,\n cs, cs, cs, 1.0\n ];\n\n const hl = brightnessMax - brightnessMin;\n const brightnessMatrix: mat4 = [\n hl, 0.0, 0.0, 0.0,\n 0.0, hl, 0.0, 0.0,\n 0.0, 0.0, hl, 0.0,\n brightnessMin, brightnessMin, brightnessMin, 1.0\n ];\n\n mat4.multiply(m, brightnessMatrix, contrastMatrix);\n mat4.multiply(m, m, saturationMatrix);\n return m;\n}\n\nfunction mapRangeValue(value: number, from: Range, to: Range): number {\n return ((value - from.min) * (to.max - to.min)) / (from.max - from.min) + to.min;\n}\n\nexport function mapRange(range: Range, from: Range, to: Range): Range {\n return {min: mapRangeValue(range.min, from, to), max: mapRangeValue(range.max, from, to)};\n}\n\nexport function easeIn(x: number) {\n return x * x * x * x * x;\n}\n\n/**\n * Hash function from https://www.shadertoy.com/view/XlGcRh\n * Matches gl-native's esgtsaHash in mbgl/util/random.hpp\n */\nexport function esgtsaHash(s: number): number {\n s = s >>> 0; // Ensure unsigned 32-bit integer\n s = Math.imul(s ^ 2747636419, 2654435769) >>> 0;\n s = Math.imul(s ^ (s >>> 16), 2654435769) >>> 0;\n s = Math.imul(s ^ (s >>> 16), 2654435769) >>> 0;\n return s / 4294967296;\n}\n\nexport {deepEqual};\n","let supportsOffscreenCanvas: boolean | null | undefined;\n\nexport default function offscreenCanvasSupported(): boolean {\n if (supportsOffscreenCanvas == null) {\n supportsOffscreenCanvas = self.OffscreenCanvas &&\n !!new OffscreenCanvas(1, 1).getContext('2d') &&\n typeof self.createImageBitmap === 'function';\n }\n\n return supportsOffscreenCanvas;\n}\n","import assert from '../style-spec/util/assert';\nimport offscreenCanvasSupported from './offscreen_canvas_supported';\n\nimport type {Cancelable} from '../types/cancelable';\n\nlet linkEl: HTMLAnchorElement | undefined;\n\nlet reducedMotionQuery: MediaQueryList;\n\nlet stubTime: number | undefined;\n\nlet canvas: HTMLCanvasElement | undefined;\n\nlet hasCanvasFingerprintNoise: boolean | undefined;\n\n/**\n * @private\n */\nconst exported = {\n requestIdleCallback: (callback: (deadline: IdleDeadline) => void): number | undefined => {\n if (typeof requestIdleCallback !== 'undefined') {\n return requestIdleCallback(callback);\n } else {\n // Fallback for environments without requestIdleCallback: emulate a fresh idle\n // window (50ms is the spec maximum) via setTimeout so callers that rely on\n // deadline.timeRemaining() still make progress.\n setTimeout(() => callback({didTimeout: false, timeRemaining: () => 50}), 0);\n }\n },\n\n /**\n * Returns either performance.now() or a value set by setNow.\n * @returns {number} Time value in milliseconds.\n */\n now(): number {\n if (stubTime !== undefined) {\n return stubTime;\n }\n return performance.now();\n },\n setNow(time: number) {\n stubTime = time;\n },\n\n restoreNow() {\n stubTime = undefined;\n },\n\n frame(fn: (paintStartTimestamp: number) => void): Cancelable {\n const frame = requestAnimationFrame(fn);\n return {cancel: () => cancelAnimationFrame(frame)};\n },\n\n getImageData(img: ImageBitmap | HTMLImageElement, padding: number = 0): ImageData {\n const {width, height} = img;\n\n if (!canvas) {\n canvas = document.createElement('canvas');\n }\n\n const context = canvas.getContext('2d', {willReadFrequently: true});\n if (!context) {\n throw new Error('failed to create canvas 2d context');\n }\n\n if (width > canvas.width || height > canvas.height) {\n canvas.width = width;\n canvas.height = height;\n }\n\n context.clearRect(-padding, -padding, width + 2 * padding, height + 2 * padding);\n context.drawImage(img, 0, 0, width, height);\n return context.getImageData(-padding, -padding, width + 2 * padding, height + 2 * padding);\n },\n\n resolveURL(path: string): string {\n if (!linkEl) linkEl = document.createElement('a');\n linkEl.href = path;\n return linkEl.href;\n },\n\n get devicePixelRatio(): number { return window.devicePixelRatio; },\n get prefersReducedMotion(): boolean {\n if (!window.matchMedia) return false;\n // Lazily initialize media query.\n if (reducedMotionQuery == null) {\n reducedMotionQuery = window.matchMedia('(prefers-reduced-motion: reduce)');\n }\n return reducedMotionQuery.matches;\n },\n\n /**\n * Returns true if the browser has OffscreenCanvas support and\n * adds noise to Canvas2D operations used for image decoding to prevent fingerprinting.\n */\n hasCanvasFingerprintNoise(): boolean {\n if (hasCanvasFingerprintNoise !== undefined) {\n return hasCanvasFingerprintNoise;\n }\n\n if (!offscreenCanvasSupported()) {\n hasCanvasFingerprintNoise = false;\n return false;\n }\n\n assert(self.OffscreenCanvas, 'OffscreenCanvas is not supported');\n\n const offscreenCanvas = new OffscreenCanvas(255 / 3, 1);\n const offscreenCanvasContext = offscreenCanvas.getContext('2d', {willReadFrequently: true});\n assert(offscreenCanvasContext, 'OffscreenCanvas 2D context unavailable');\n let inc = 0;\n // getImageData is lossy with premultiplied alpha.\n for (let i = 0; i < offscreenCanvas.width; ++i) {\n offscreenCanvasContext.fillStyle = `rgba(${inc++},${inc++},${inc++}, 255)`;\n offscreenCanvasContext.fillRect(i, 0, 1, 1);\n }\n const readData = offscreenCanvasContext.getImageData(0, 0, offscreenCanvas.width, offscreenCanvas.height);\n inc = 0;\n for (let i = 0; i < readData.data.length; ++i) {\n if (i % 4 !== 3 && inc++ !== readData.data[i]) {\n hasCanvasFingerprintNoise = true;\n return true;\n }\n }\n hasCanvasFingerprintNoise = false;\n return false;\n }\n};\n\nexport default exported;\n\nexport const {setNow, restoreNow} = exported;\n","let simdSupported: boolean | undefined;\n\n/**\n * Returns whether the browser supports WebAssembly SIMD instructions.\n * The result is cached after the first call.\n *\n * @private\n */\nexport function isWasmSimdSupported(): boolean {\n if (simdSupported === undefined) {\n if (typeof WebAssembly !== 'object') {\n return false;\n }\n\n // Minimal WASM module that uses SIMD\n const detector = new Uint8Array([0, 97, 115, 109, 1, 0, 0, 0, 1, 4, 1, 96, 0, 0, 3, 3, 2, 0, 0, 5, 3, 1, 0, 1, 12, 1, 0, 10, 22, 2, 12, 0, 65, 0, 65, 0, 65, 0, 252, 10, 0, 0, 11, 7, 0, 65, 0, 253, 15, 26, 11]);\n simdSupported = WebAssembly.validate(detector);\n }\n\n return simdSupported;\n}\n","import {isWasmSimdSupported} from './is_wasm_simd_supported';\nimport browser from './browser';\n\nconst API_URL_REGEX = /^((https?:)?\\/\\/)?([^\\/]+\\.)?mapbox\\.c(n|om)(\\/|\\?|$)/i;\nconst API_TILEJSON_REGEX = /^((https?:)?\\/\\/)?([^\\/]+\\.)?mapbox\\.c(n|om)(\\/v[0-9]*\\/.*\\.json.*$)/i;\nconst API_SPRITE_REGEX = /^((https?:)?\\/\\/)?([^\\/]+\\.)?mapbox\\.c(n|om)(\\/styles\\/v[0-9]*\\/)(.*\\/sprite.*\\..*$)/i;\nconst API_FONTS_REGEX = /^((https?:)?\\/\\/)?([^\\/]+\\.)?mapbox\\.c(n|om)(\\/fonts\\/v[0-9]*\\/)(.*\\.pbf.*$)/i;\nconst API_STYLE_REGEX = /^((https?:)?\\/\\/)?([^\\/]+\\.)?mapbox\\.c(n|om)(\\/styles\\/v[0-9]*\\/)(.*$)/i;\nconst API_CDN_URL_REGEX = /^((https?:)?\\/\\/)?api\\.mapbox\\.c(n|om)(\\/mapbox-gl-js\\/)(.*$)/i;\n\nexport type Config = {\n API_URL: string;\n API_URL_REGEX: RegExp;\n API_TILEJSON_REGEX: RegExp;\n API_FONTS_REGEX: RegExp;\n API_SPRITE_REGEX: RegExp;\n API_STYLE_REGEX: RegExp;\n API_CDN_URL_REGEX: RegExp;\n EVENTS_URL: string | null | undefined;\n SESSION_PATH: string;\n FEEDBACK_URL: string;\n REQUIRE_ACCESS_TOKEN: boolean;\n TILE_URL_VERSION: string;\n RASTER_URL_PREFIX: string;\n RASTERARRAYS_URL_PREFIX: string;\n ACCESS_TOKEN: string | null | undefined;\n MAX_PARALLEL_IMAGE_REQUESTS: number;\n DRACO_URL: string;\n MESHOPT_URL: string;\n MESHOPT_SIMD_URL: string;\n BUILDING_GEN_URL: string;\n DEFAULT_STYLE: string;\n GLYPHS_URL: string;\n TILES3D_URL_PREFIX: string;\n TILE_PROVIDER_URLS: Record;\n};\n\nconst config: Config = {\n API_URL: 'https://api.mapbox.com',\n API_URL_REGEX,\n API_TILEJSON_REGEX,\n API_SPRITE_REGEX,\n API_FONTS_REGEX,\n API_STYLE_REGEX,\n API_CDN_URL_REGEX,\n get EVENTS_URL() {\n if (!config.API_URL) { return null; }\n try {\n const url = new URL(config.API_URL);\n if (url.hostname === 'api.mapbox.cn') {\n return 'https://events.mapbox.cn/events/v2';\n } else if (url.hostname === 'api.mapbox.com') {\n return 'https://events.mapbox.com/events/v2';\n } else {\n return null;\n }\n } catch (e) {\n return null;\n }\n },\n SESSION_PATH: '/map-sessions/v1',\n FEEDBACK_URL: 'https://apps.mapbox.com/feedback',\n TILE_URL_VERSION: 'v4',\n RASTER_URL_PREFIX: 'raster/v1',\n RASTERARRAYS_URL_PREFIX: 'rasterarrays/v1',\n REQUIRE_ACCESS_TOKEN: true,\n ACCESS_TOKEN: null,\n DEFAULT_STYLE: 'mapbox://styles/mapbox/standard',\n MAX_PARALLEL_IMAGE_REQUESTS: 16,\n DRACO_URL: '/mapbox-gl-js/draco_decoder_gltf_v1.5.6.wasm',\n MESHOPT_URL: '/mapbox-gl-js/meshopt_base_v0.20.wasm',\n MESHOPT_SIMD_URL: '/mapbox-gl-js/meshopt_simd_v0.20.wasm',\n BUILDING_GEN_URL: '/mapbox-gl-js/building-gen/building_gen_v1.2.4.wasm',\n GLYPHS_URL: 'mapbox://fonts/mapbox/{fontstack}/{range}.pbf',\n TILES3D_URL_PREFIX: '3dtiles/v1',\n TILE_PROVIDER_URLS: Object.assign(Object.create(null) as Record, {\n pmtiles: `/mapbox-gl-js/plugins/mapbox-gl-pmtiles-provider/v0.0.2/mapbox-gl-pmtiles-provider.js`,\n }),\n};\n\nexport function setAccessToken(token: string) {\n config.ACCESS_TOKEN = token;\n}\n\nexport function setBaseApiUrl(url: string) {\n config.API_URL = url;\n}\n\nexport function setMaxParallelImageRequests(numRequests: number) {\n config.MAX_PARALLEL_IMAGE_REQUESTS = numRequests;\n}\n\n// Returns the config subset that can be changed via public setters and needs syncing to workers.\nexport function getBroadcastableConfig() {\n return {\n API_URL: config.API_URL,\n DRACO_URL: config.DRACO_URL,\n MESHOPT_URL: config.MESHOPT_URL,\n MESHOPT_SIMD_URL: config.MESHOPT_SIMD_URL,\n BUILDING_GEN_URL: config.BUILDING_GEN_URL,\n };\n}\n\nexport function getDracoUrl(): string {\n return new URL(config.DRACO_URL, config.API_URL).href;\n}\n\nexport function setDracoUrl(url: string) {\n config.DRACO_URL = browser.resolveURL(url);\n}\n\nexport function getMeshoptUrl(): string {\n if (typeof WebAssembly !== 'object') {\n throw new Error(\"WebAssembly not supported, cannot instantiate meshoptimizer\");\n }\n\n return new URL(isWasmSimdSupported() ? config.MESHOPT_SIMD_URL : config.MESHOPT_URL, config.API_URL).href;\n}\n\nexport function setMeshoptUrl(url: string) {\n const resolved = browser.resolveURL(url);\n config.MESHOPT_URL = resolved;\n config.MESHOPT_SIMD_URL = resolved;\n}\n\nexport function getBuildingGenUrl(): string {\n return new URL(config.BUILDING_GEN_URL, config.API_URL).href;\n}\n\nexport function setBuildingGenUrl(url: string) {\n config.BUILDING_GEN_URL = browser.resolveURL(url);\n}\n\nexport default config;\n","const exported = {\n supported: false,\n testSupport\n};\n\nexport default exported;\n\nlet glForTesting: WebGL2RenderingContext | null;\nlet webpCheckComplete = false;\nlet webpImgTest: HTMLImageElement | undefined;\nlet webpImgTestOnloadComplete = false;\n\n/**\n * @note Expressions test suite run in Node.js and use this file\n */\nconst window = typeof self !== 'undefined' ? self : {} as Window;\n\nif (window.document) {\n webpImgTest = window.document.createElement('img');\n webpImgTest.onload = function () {\n if (glForTesting) testWebpTextureUpload(glForTesting);\n glForTesting = null;\n webpImgTestOnloadComplete = true;\n };\n webpImgTest.onerror = function () {\n webpCheckComplete = true;\n glForTesting = null;\n };\n webpImgTest.src = 'data:image/webp;base64,UklGRh4AAABXRUJQVlA4TBEAAAAvAQAAAAfQ//73v/+BiOh/AAA=';\n}\n\nfunction testSupport(gl: WebGL2RenderingContext) {\n if (webpCheckComplete || !webpImgTest) return;\n\n // HTMLImageElement.complete is set when an image is done loading it's source\n // regardless of whether the load was successful or not.\n // It's possible for an error to set HTMLImageElement.complete to true which would trigger\n // testWebpTextureUpload and mistakenly set exported.supported to true in browsers which don't support webp\n // To avoid this, we set a flag in the image's onload handler and only call testWebpTextureUpload\n // after a successful image load event.\n if (webpImgTestOnloadComplete) {\n testWebpTextureUpload(gl);\n } else {\n glForTesting = gl;\n\n }\n}\n\nfunction testWebpTextureUpload(gl: WebGL2RenderingContext) {\n // Edge 18 supports WebP but not uploading a WebP image to a gl texture\n // Test support for this before allowing WebP images.\n // https://github.com/mapbox/mapbox-gl-js/issues/7671\n const texture = gl.createTexture();\n gl.bindTexture(gl.TEXTURE_2D, texture);\n\n try {\n gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, webpImgTest);\n\n // The error does not get triggered in Edge if the context is lost\n if (gl.isContextLost()) return;\n\n exported.supported = true;\n } catch (e) {\n // Catch \"Unspecified Error.\" in Edge 18.\n }\n\n gl.deleteTexture(texture);\n\n webpCheckComplete = true;\n}\n","export function getURLExtension(url: string): string {\n try {\n const lastSegment = new URL(url).pathname.split('/').pop() || '';\n const dotIndex = lastSegment.lastIndexOf('.');\n return dotIndex >= 0 ? lastSegment.slice(dotIndex + 1) : '';\n } catch {\n return '';\n }\n}\n\nexport function setQueryParameters(\n url: string,\n params: {\n [key: string]: string;\n },\n): string {\n const paramStart = url.indexOf('?');\n if (paramStart < 0) return `${url}?${new URLSearchParams(params).toString()}`;\n\n const searchParams = new URLSearchParams(url.slice(paramStart));\n for (const key in params) {\n searchParams.set(key, params[key]);\n }\n\n return `${url.slice(0, paramStart)}?${searchParams.toString()}`;\n}\n\ntype StripQueryParameters = {\n persistentParams: string[];\n};\n\nexport function stripQueryParameters(url: string, params: StripQueryParameters = {persistentParams: []}): string {\n const paramStart = url.indexOf('?');\n if (paramStart < 0) return url;\n\n const nextParams = new URLSearchParams();\n const searchParams = new URLSearchParams(url.slice(paramStart));\n for (const param of params.persistentParams) {\n const value = searchParams.get(param);\n if (value) nextParams.set(param, value);\n }\n\n const nextParamsString = nextParams.toString();\n\n return `${url.slice(0, paramStart)}${nextParamsString.length > 0 ? `?${nextParamsString}` : ''}`;\n}\n","import {warnOnce, parseCacheControl} from './util';\nimport {stripQueryParameters, setQueryParameters} from './url';\n\nimport type Dispatcher from './dispatcher';\n\nconst CACHE_NAME = 'mapbox-tiles';\nlet cacheLimit = 500; // 50MB / (100KB/tile) ~= 500 tiles\nlet cacheCheckThreshold = 50;\n\nconst MIN_TIME_UNTIL_EXPIRY = 1000 * 60 * 7; // 7 minutes. Skip caching tiles with a short enough max age.\n\n// So that caching functions correctly, these params are persisted\n// on URLs with query params otherwise stripped.\nconst PERSISTENT_PARAMS = ['language', 'worldview', 'jobid'];\n\nexport type ResponseOptions = {\n status: number;\n statusText: string;\n headers: Headers;\n};\n\n// We're using a global shared cache object. Normally, requesting ad-hoc Cache objects is fine, but\n// Safari has a memory leak in which it fails to release memory when requesting keys() from a Cache\n// object. See https://bugs.webkit.org/show_bug.cgi?id=203991 for more information.\nlet sharedCache: Promise | null | undefined;\n\nfunction getCaches() {\n try {\n return caches;\n } catch (e) {\n //