forked from MapComplete/MapComplete
		
	
		
			
				
	
	
		
			647 lines
		
	
	
	
		
			26 KiB
		
	
	
	
		
			TypeScript
		
	
	
	
	
	
			
		
		
	
	
			647 lines
		
	
	
	
		
			26 KiB
		
	
	
	
		
			TypeScript
		
	
	
	
	
	
| import { Translation } from "../../UI/i18n/Translation"
 | |
| import SourceConfig from "./SourceConfig"
 | |
| import TagRenderingConfig from "./TagRenderingConfig"
 | |
| import PresetConfig, { PreciseInput } from "./PresetConfig"
 | |
| import { LayerConfigJson } from "./Json/LayerConfigJson"
 | |
| import Translations from "../../UI/i18n/Translations"
 | |
| import { TagUtils } from "../../Logic/Tags/TagUtils"
 | |
| import FilterConfig from "./FilterConfig"
 | |
| import { Unit } from "../Unit"
 | |
| import DeleteConfig from "./DeleteConfig"
 | |
| import MoveConfig from "./MoveConfig"
 | |
| import PointRenderingConfig from "./PointRenderingConfig"
 | |
| import WithContextLoader from "./WithContextLoader"
 | |
| import LineRenderingConfig from "./LineRenderingConfig"
 | |
| import PointRenderingConfigJson from "./Json/PointRenderingConfigJson"
 | |
| import LineRenderingConfigJson from "./Json/LineRenderingConfigJson"
 | |
| import { TagRenderingConfigJson } from "./Json/TagRenderingConfigJson"
 | |
| import BaseUIElement from "../../UI/BaseUIElement"
 | |
| import Combine from "../../UI/Base/Combine"
 | |
| import Title from "../../UI/Base/Title"
 | |
| import List from "../../UI/Base/List"
 | |
| import Link from "../../UI/Base/Link"
 | |
| import { Utils } from "../../Utils"
 | |
| import { TagsFilter } from "../../Logic/Tags/TagsFilter"
 | |
| import Table from "../../UI/Base/Table"
 | |
| import FilterConfigJson from "./Json/FilterConfigJson"
 | |
| import { And } from "../../Logic/Tags/And"
 | |
| import { Overpass } from "../../Logic/Osm/Overpass"
 | |
| import Constants from "../Constants"
 | |
| import { FixedUiElement } from "../../UI/Base/FixedUiElement"
 | |
| import Svg from "../../Svg"
 | |
| import { UIEventSource } from "../../Logic/UIEventSource"
 | |
| import { OsmTags } from "../OsmFeature"
 | |
| 
 | |
| export default class LayerConfig extends WithContextLoader {
 | |
|     public static readonly syncSelectionAllowed = ["no", "local", "theme-only", "global"] as const
 | |
|     public readonly id: string
 | |
|     public readonly name: Translation
 | |
|     public readonly description: Translation
 | |
|     public readonly source: SourceConfig
 | |
|     public readonly calculatedTags: [string, string, boolean][]
 | |
|     public readonly doNotDownload: boolean
 | |
|     public readonly passAllFeatures: boolean
 | |
|     public readonly isShown: TagsFilter
 | |
|     public minzoom: number
 | |
|     public minzoomVisible: number
 | |
|     public readonly maxzoom: number
 | |
|     public readonly title?: TagRenderingConfig
 | |
|     public readonly titleIcons: TagRenderingConfig[]
 | |
|     public readonly mapRendering: PointRenderingConfig[]
 | |
|     public readonly lineRendering: LineRenderingConfig[]
 | |
|     public readonly units: Unit[]
 | |
|     public readonly deletion: DeleteConfig | null
 | |
|     public readonly allowMove: MoveConfig | null
 | |
|     public readonly allowSplit: boolean
 | |
|     public readonly shownByDefault: boolean
 | |
|     /**
 | |
|      * In seconds
 | |
|      */
 | |
|     public readonly maxAgeOfCache: number
 | |
|     public readonly presets: PresetConfig[]
 | |
|     public readonly tagRenderings: TagRenderingConfig[]
 | |
|     public readonly filters: FilterConfig[]
 | |
|     public readonly filterIsSameAs: string
 | |
|     public readonly forceLoad: boolean
 | |
|     public readonly syncSelection: typeof LayerConfig.syncSelectionAllowed[number] // this is a trick to conver a constant array of strings into a type union of these values
 | |
| 
 | |
|     constructor(json: LayerConfigJson, context?: string, official: boolean = true) {
 | |
|         context = context + "." + json.id
 | |
|         const translationContext = "layers:" + json.id
 | |
|         super(json, context)
 | |
|         this.id = json.id
 | |
| 
 | |
|         if (typeof json === "string") {
 | |
|             throw `Not a valid layer: the layerConfig is a string. 'npm run generate:layeroverview' might be needed (at ${context})`
 | |
|         }
 | |
| 
 | |
|         if (json.id === undefined) {
 | |
|             throw `Not a valid layer: id is undefined: ${JSON.stringify(json)} (At ${context})`
 | |
|         }
 | |
| 
 | |
|         if (json.source === undefined) {
 | |
|             throw "Layer " + this.id + " does not define a source section (" + context + ")"
 | |
|         }
 | |
| 
 | |
|         if (json.source.osmTags === undefined) {
 | |
|             throw (
 | |
|                 "Layer " +
 | |
|                 this.id +
 | |
|                 " does not define a osmTags in the source section - these should always be present, even for geojson layers (" +
 | |
|                 context +
 | |
|                 ")"
 | |
|             )
 | |
|         }
 | |
| 
 | |
|         if (json.id.toLowerCase() !== json.id) {
 | |
|             throw `${context}: The id of a layer should be lowercase: ${json.id}`
 | |
|         }
 | |
|         if (json.id.match(/[a-z0-9-_]/) == null) {
 | |
|             throw `${context}: The id of a layer should match [a-z0-9-_]*: ${json.id}`
 | |
|         }
 | |
| 
 | |
|         this.maxAgeOfCache = json.source.maxCacheAge ?? 24 * 60 * 60 * 30
 | |
|         if (
 | |
|             json.syncSelection !== undefined &&
 | |
|             LayerConfig.syncSelectionAllowed.indexOf(json.syncSelection) < 0
 | |
|         ) {
 | |
|             throw (
 | |
|                 context +
 | |
|                 " Invalid sync-selection: must be one of " +
 | |
|                 LayerConfig.syncSelectionAllowed.map((v) => `'${v}'`).join(", ") +
 | |
|                 " but got '" +
 | |
|                 json.syncSelection +
 | |
|                 "'"
 | |
|             )
 | |
|         }
 | |
|         this.syncSelection = json.syncSelection ?? "no"
 | |
|         const osmTags = TagUtils.Tag(json.source.osmTags, context + "source.osmTags")
 | |
| 
 | |
|         if (Constants.priviliged_layers.indexOf(this.id) < 0 && osmTags.isNegative()) {
 | |
|             throw (
 | |
|                 context +
 | |
|                 "The source states tags which give a very wide selection: it only uses negative expressions, which will result in too much and unexpected data. Add at least one required tag. The tags are:\n\t" +
 | |
|                 osmTags.asHumanString(false, false, {})
 | |
|             )
 | |
|         }
 | |
| 
 | |
|         if (json.source["geoJsonSource"] !== undefined) {
 | |
|             throw context + "Use 'geoJson' instead of 'geoJsonSource'"
 | |
|         }
 | |
| 
 | |
|         if (json.source["geojson"] !== undefined) {
 | |
|             throw context + "Use 'geoJson' instead of 'geojson' (the J is a capital letter)"
 | |
|         }
 | |
| 
 | |
|         this.source = new SourceConfig(
 | |
|             {
 | |
|                 osmTags: osmTags,
 | |
|                 geojsonSource: json.source["geoJson"],
 | |
|                 geojsonSourceLevel: json.source["geoJsonZoomLevel"],
 | |
|                 overpassScript: json.source["overpassScript"],
 | |
|                 isOsmCache: json.source["isOsmCache"],
 | |
|                 mercatorCrs: json.source["mercatorCrs"],
 | |
|                 idKey: json.source["idKey"],
 | |
|             },
 | |
|             Constants.priviliged_layers.indexOf(this.id) > 0,
 | |
|             json.id
 | |
|         )
 | |
| 
 | |
|         this.allowSplit = json.allowSplit ?? false
 | |
|         this.name = Translations.T(json.name, translationContext + ".name")
 | |
|         if (json.units !== undefined && !Array.isArray(json.units)) {
 | |
|             throw (
 | |
|                 "At " +
 | |
|                 context +
 | |
|                 ".units: the 'units'-section should be a list; you probably have an object there"
 | |
|             )
 | |
|         }
 | |
|         this.units = (json.units ?? []).map((unitJson, i) =>
 | |
|             Unit.fromJson(unitJson, `${context}.unit[${i}]`)
 | |
|         )
 | |
| 
 | |
|         if (json.description !== undefined) {
 | |
|             if (Object.keys(json.description).length === 0) {
 | |
|                 json.description = undefined
 | |
|             }
 | |
|         }
 | |
| 
 | |
|         this.description = Translations.T(json.description, translationContext + ".description")
 | |
| 
 | |
|         this.calculatedTags = undefined
 | |
|         if (json.calculatedTags !== undefined) {
 | |
|             if (!official) {
 | |
|                 console.warn(
 | |
|                     `Unofficial theme ${this.id} with custom javascript! This is a security risk`
 | |
|                 )
 | |
|             }
 | |
|             this.calculatedTags = []
 | |
|             for (const kv of json.calculatedTags) {
 | |
|                 const index = kv.indexOf("=")
 | |
|                 let key = kv.substring(0, index).trim()
 | |
|                 const r = "[a-z_][a-z0-9:]*"
 | |
|                 if (key.match(r) === null) {
 | |
|                     throw (
 | |
|                         "At " +
 | |
|                         context +
 | |
|                         " invalid key for calculated tag: " +
 | |
|                         key +
 | |
|                         "; it should match " +
 | |
|                         r
 | |
|                     )
 | |
|                 }
 | |
|                 const isStrict = key.endsWith(":")
 | |
|                 if (isStrict) {
 | |
|                     key = key.substr(0, key.length - 1)
 | |
|                 }
 | |
|                 const code = kv.substring(index + 1)
 | |
| 
 | |
|                 try {
 | |
|                     new Function("feat", "return " + code + ";")
 | |
|                 } catch (e) {
 | |
|                     throw `Invalid function definition: the custom javascript is invalid:${e} (at ${context}). The offending javascript code is:\n    ${code}`
 | |
|                 }
 | |
| 
 | |
|                 this.calculatedTags.push([key, code, isStrict])
 | |
|             }
 | |
|         }
 | |
| 
 | |
|         this.doNotDownload = json.doNotDownload ?? false
 | |
|         this.passAllFeatures = json.passAllFeatures ?? false
 | |
|         this.minzoom = json.minzoom ?? 0
 | |
|         if (json["minZoom"] !== undefined) {
 | |
|             throw "At " + context + ": minzoom is written all lowercase"
 | |
|         }
 | |
|         this.minzoomVisible = json.minzoomVisible ?? this.minzoom
 | |
|         this.shownByDefault = json.shownByDefault ?? true
 | |
|         this.forceLoad = json.forceLoad ?? false
 | |
|         if (json.presets === null) json.presets = undefined
 | |
|         if (json.presets !== undefined && json.presets?.map === undefined) {
 | |
|             throw "Presets should be a list of items (at " + context + ")"
 | |
|         }
 | |
|         this.presets = (json.presets ?? []).map((pr, i) => {
 | |
|             let preciseInput: PreciseInput = {
 | |
|                 preferredBackground: ["photo"],
 | |
|                 snapToLayers: undefined,
 | |
|                 maxSnapDistance: undefined,
 | |
|             }
 | |
|             if (pr.preciseInput !== undefined) {
 | |
|                 if (pr.preciseInput === true) {
 | |
|                     pr.preciseInput = {
 | |
|                         preferredBackground: undefined,
 | |
|                     }
 | |
|                 }
 | |
| 
 | |
|                 let snapToLayers: string[]
 | |
|                 if (typeof pr.preciseInput.snapToLayer === "string") {
 | |
|                     snapToLayers = [pr.preciseInput.snapToLayer]
 | |
|                 } else {
 | |
|                     snapToLayers = pr.preciseInput.snapToLayer
 | |
|                 }
 | |
| 
 | |
|                 let preferredBackground: (
 | |
|                     | "map"
 | |
|                     | "photo"
 | |
|                     | "osmbasedmap"
 | |
|                     | "historicphoto"
 | |
|                     | string
 | |
|                 )[]
 | |
|                 if (typeof pr.preciseInput.preferredBackground === "string") {
 | |
|                     preferredBackground = [pr.preciseInput.preferredBackground]
 | |
|                 } else {
 | |
|                     preferredBackground = pr.preciseInput.preferredBackground
 | |
|                 }
 | |
|                 preciseInput = {
 | |
|                     preferredBackground,
 | |
|                     snapToLayers,
 | |
|                     maxSnapDistance: pr.preciseInput.maxSnapDistance ?? 10,
 | |
|                 }
 | |
|             }
 | |
| 
 | |
|             const config: PresetConfig = {
 | |
|                 title: Translations.T(pr.title, `${translationContext}.presets.${i}.title`),
 | |
|                 tags: pr.tags.map((t) => TagUtils.SimpleTag(t)),
 | |
|                 description: Translations.T(
 | |
|                     pr.description,
 | |
|                     `${translationContext}.presets.${i}.description`
 | |
|                 ),
 | |
|                 preciseInput: preciseInput,
 | |
|                 exampleImages: pr.exampleImages,
 | |
|             }
 | |
|             return config
 | |
|         })
 | |
| 
 | |
|         if (json.mapRendering === undefined) {
 | |
|             throw "MapRendering is undefined in " + context
 | |
|         }
 | |
| 
 | |
|         if (json.mapRendering === null) {
 | |
|             this.mapRendering = []
 | |
|             this.lineRendering = []
 | |
|         } else {
 | |
|             this.mapRendering = Utils.NoNull(json.mapRendering)
 | |
|                 .filter((r) => r["location"] !== undefined)
 | |
|                 .map(
 | |
|                     (r, i) =>
 | |
|                         new PointRenderingConfig(
 | |
|                             <PointRenderingConfigJson>r,
 | |
|                             context + ".mapRendering[" + i + "]"
 | |
|                         )
 | |
|                 )
 | |
| 
 | |
|             this.lineRendering = Utils.NoNull(json.mapRendering)
 | |
|                 .filter((r) => r["location"] === undefined)
 | |
|                 .map(
 | |
|                     (r, i) =>
 | |
|                         new LineRenderingConfig(
 | |
|                             <LineRenderingConfigJson>r,
 | |
|                             context + ".mapRendering[" + i + "]"
 | |
|                         )
 | |
|                 )
 | |
| 
 | |
|             const hasCenterRendering = this.mapRendering.some(
 | |
|                 (r) =>
 | |
|                     r.location.has("centroid") ||
 | |
|                     r.location.has("projected_centerpoint") ||
 | |
|                     r.location.has("start") ||
 | |
|                     r.location.has("end")
 | |
|             )
 | |
| 
 | |
|             if (this.lineRendering.length === 0 && this.mapRendering.length === 0) {
 | |
|                 throw (
 | |
|                     "The layer " +
 | |
|                     this.id +
 | |
|                     " does not have any maprenderings defined and will thus not show up on the map at all. If this is intentional, set maprenderings to 'null' instead of '[]'"
 | |
|                 )
 | |
|             } else if (
 | |
|                 !hasCenterRendering &&
 | |
|                 this.lineRendering.length === 0 &&
 | |
|                 !this.source.geojsonSource?.startsWith(
 | |
|                     "https://api.openstreetmap.org/api/0.6/notes.json"
 | |
|                 )
 | |
|             ) {
 | |
|                 throw (
 | |
|                     "The layer " +
 | |
|                     this.id +
 | |
|                     " might not render ways. This might result in dropped information (at " +
 | |
|                     context +
 | |
|                     ")"
 | |
|                 )
 | |
|             }
 | |
|         }
 | |
| 
 | |
|         const missingIds =
 | |
|             Utils.NoNull(json.tagRenderings)?.filter(
 | |
|                 (tr) =>
 | |
|                     typeof tr !== "string" &&
 | |
|                     tr["builtin"] === undefined &&
 | |
|                     tr["id"] === undefined &&
 | |
|                     tr["rewrite"] === undefined
 | |
|             ) ?? []
 | |
|         if (missingIds?.length > 0 && official) {
 | |
|             console.error("Some tagRenderings of", this.id, "are missing an id:", missingIds)
 | |
|             throw "Missing ids in tagrenderings"
 | |
|         }
 | |
| 
 | |
|         this.tagRenderings = (Utils.NoNull(json.tagRenderings) ?? []).map(
 | |
|             (tr, i) =>
 | |
|                 new TagRenderingConfig(
 | |
|                     <TagRenderingConfigJson>tr,
 | |
|                     this.id + ".tagRenderings[" + i + "]"
 | |
|                 )
 | |
|         )
 | |
| 
 | |
|         if (
 | |
|             json.filter !== undefined &&
 | |
|             json.filter !== null &&
 | |
|             json.filter["sameAs"] !== undefined
 | |
|         ) {
 | |
|             this.filterIsSameAs = json.filter["sameAs"]
 | |
|             this.filters = []
 | |
|         } else {
 | |
|             this.filters = (<FilterConfigJson[]>json.filter ?? []).map((option, i) => {
 | |
|                 return new FilterConfig(option, `layers:${this.id}.filter.${i}`)
 | |
|             })
 | |
|         }
 | |
| 
 | |
|         {
 | |
|             const duplicateIds = Utils.Dupiclates(this.filters.map((f) => f.id))
 | |
|             if (duplicateIds.length > 0) {
 | |
|                 throw `Some filters have a duplicate id: ${duplicateIds} (at ${context}.filters)`
 | |
|             }
 | |
|         }
 | |
| 
 | |
|         if (json["filters"] !== undefined) {
 | |
|             throw "Error in " + context + ": use 'filter' instead of 'filters'"
 | |
|         }
 | |
| 
 | |
|         this.titleIcons = this.ParseTagRenderings(<TagRenderingConfigJson[]>json.titleIcons ?? [], {
 | |
|             readOnlyMode: true,
 | |
|         })
 | |
| 
 | |
|         this.title = this.tr("title", undefined)
 | |
|         this.isShown = TagUtils.TagD(json.isShown, context + ".isShown")
 | |
| 
 | |
|         this.deletion = null
 | |
|         if (json.deletion === true) {
 | |
|             json.deletion = {}
 | |
|         }
 | |
|         if (json.deletion !== undefined && json.deletion !== false) {
 | |
|             this.deletion = new DeleteConfig(json.deletion, `${context}.deletion`)
 | |
|         }
 | |
| 
 | |
|         this.allowMove = null
 | |
|         if (json.allowMove === false) {
 | |
|             this.allowMove = null
 | |
|         } else if (json.allowMove === true) {
 | |
|             this.allowMove = new MoveConfig({}, context + ".allowMove")
 | |
|         } else if (json.allowMove !== undefined && json.allowMove !== false) {
 | |
|             this.allowMove = new MoveConfig(json.allowMove, context + ".allowMove")
 | |
|         }
 | |
| 
 | |
|         if (json["showIf"] !== undefined) {
 | |
|             throw (
 | |
|                 "Invalid key on layerconfig " +
 | |
|                 this.id +
 | |
|                 ": showIf. Did you mean 'isShown' instead?"
 | |
|             )
 | |
|         }
 | |
|     }
 | |
| 
 | |
|     public defaultIcon(): BaseUIElement | undefined {
 | |
|         if (this.mapRendering === undefined || this.mapRendering === null) {
 | |
|             return undefined
 | |
|         }
 | |
|         const mapRendering = this.mapRendering.filter((r) => r.location.has("point"))[0]
 | |
|         if (mapRendering === undefined) {
 | |
|             return undefined
 | |
|         }
 | |
|         return mapRendering.GetBaseIcon(this.GetBaseTags())
 | |
|     }
 | |
| 
 | |
|     public GetBaseTags(): any {
 | |
|         return TagUtils.changeAsProperties(this.source.osmTags.asChange({ id: "node/-1" }))
 | |
|     }
 | |
| 
 | |
|     public GenerateDocumentation(
 | |
|         usedInThemes: string[],
 | |
|         layerIsNeededBy?: Map<string, string[]>,
 | |
|         dependencies: {
 | |
|             context?: string
 | |
|             reason: string
 | |
|             neededLayer: string
 | |
|         }[] = [],
 | |
|         addedByDefault = false,
 | |
|         canBeIncluded = true
 | |
|     ): BaseUIElement {
 | |
|         const extraProps: (string | BaseUIElement)[] = []
 | |
| 
 | |
|         extraProps.push("This layer is shown at zoomlevel **" + this.minzoom + "** and higher")
 | |
| 
 | |
|         if (canBeIncluded) {
 | |
|             if (addedByDefault) {
 | |
|                 extraProps.push(
 | |
|                     "**This layer is included automatically in every theme. This layer might contain no points**"
 | |
|                 )
 | |
|             }
 | |
|             if (this.shownByDefault === false) {
 | |
|                 extraProps.push(
 | |
|                     "This layer is not visible by default and must be enabled in the filter by the user. "
 | |
|                 )
 | |
|             }
 | |
|             if (this.title === undefined) {
 | |
|                 extraProps.push(
 | |
|                     "Elements don't have a title set and cannot be toggled nor will they show up in the dashboard. If you import this layer in your theme, override `title` to make this toggleable."
 | |
|                 )
 | |
|             }
 | |
|             if (this.name === undefined && this.shownByDefault === false) {
 | |
|                 extraProps.push(
 | |
|                     "This layer is not visible by default and the visibility cannot be toggled, effectively resulting in a fully hidden layer. This can be useful, e.g. to calculate some metatags. If you want to render this layer (e.g. for debugging), enable it by setting the URL-parameter layer-<id>=true"
 | |
|                 )
 | |
|             }
 | |
|             if (this.name === undefined) {
 | |
|                 extraProps.push(
 | |
|                     "Not visible in the layer selection by default. If you want to make this layer toggable, override `name`"
 | |
|                 )
 | |
|             }
 | |
|             if (this.mapRendering.length === 0) {
 | |
|                 extraProps.push(
 | |
|                     "Not rendered on the map by default. If you want to rendering this on the map, override `mapRenderings`"
 | |
|                 )
 | |
|             }
 | |
| 
 | |
|             if (this.source.geojsonSource !== undefined) {
 | |
|                 extraProps.push(
 | |
|                     new Combine([
 | |
|                         Utils.runningFromConsole
 | |
|                             ? "<img src='../warning.svg' height='1rem'/>"
 | |
|                             : undefined,
 | |
|                         "This layer is loaded from an external source, namely ",
 | |
|                         new FixedUiElement(this.source.geojsonSource).SetClass("code"),
 | |
|                     ])
 | |
|                 )
 | |
|             }
 | |
|         } else {
 | |
|             extraProps.push(
 | |
|                 "This layer can **not** be included in a theme. It is solely used by [special renderings](SpecialRenderings.md) showing a minimap with custom data."
 | |
|             )
 | |
|         }
 | |
| 
 | |
|         let usingLayer: BaseUIElement[] = []
 | |
|         if (usedInThemes?.length > 0 && !addedByDefault) {
 | |
|             usingLayer = [
 | |
|                 new Title("Themes using this layer", 4),
 | |
|                 new List(
 | |
|                     (usedInThemes ?? []).map(
 | |
|                         (id) => new Link(id, "https://mapcomplete.osm.be/" + id)
 | |
|                     )
 | |
|                 ),
 | |
|             ]
 | |
|         }
 | |
| 
 | |
|         for (const dep of dependencies) {
 | |
|             extraProps.push(
 | |
|                 new Combine([
 | |
|                     "This layer will automatically load ",
 | |
|                     new Link(dep.neededLayer, "./" + dep.neededLayer + ".md"),
 | |
|                     " into the layout as it depends on it: ",
 | |
|                     dep.reason,
 | |
|                     "(" + dep.context + ")",
 | |
|                 ])
 | |
|             )
 | |
|         }
 | |
| 
 | |
|         for (const revDep of Utils.Dedup(layerIsNeededBy?.get(this.id) ?? [])) {
 | |
|             extraProps.push(
 | |
|                 new Combine([
 | |
|                     "This layer is needed as dependency for layer",
 | |
|                     new Link(revDep, "#" + revDep),
 | |
|                 ])
 | |
|             )
 | |
|         }
 | |
| 
 | |
|         let neededTags: TagsFilter[] = [this.source.osmTags]
 | |
|         if (this.source.osmTags["and"] !== undefined) {
 | |
|             neededTags = this.source.osmTags["and"]
 | |
|         }
 | |
| 
 | |
|         let tableRows = Utils.NoNull(
 | |
|             this.tagRenderings
 | |
|                 .map((tr) => tr.FreeformValues())
 | |
|                 .map((values) => {
 | |
|                     if (values == undefined) {
 | |
|                         return undefined
 | |
|                     }
 | |
|                     const embedded: (Link | string)[] = values.values?.map((v) =>
 | |
|                         Link.OsmWiki(values.key, v, true).SetClass("mr-2")
 | |
|                     ) ?? ["_no preset options defined, or no values in them_"]
 | |
|                     return [
 | |
|                         new Combine([
 | |
|                             new Link(
 | |
|                                 Utils.runningFromConsole
 | |
|                                     ? "<img src='https://mapcomplete.osm.be/assets/svg/statistics.svg' height='18px'>"
 | |
|                                     : Svg.statistics_svg().SetClass("w-4 h-4 mr-2"),
 | |
|                                 "https://taginfo.openstreetmap.org/keys/" + values.key + "#values",
 | |
|                                 true
 | |
|                             ),
 | |
|                             Link.OsmWiki(values.key),
 | |
|                         ]).SetClass("flex"),
 | |
|                         values.type === undefined
 | |
|                             ? "Multiple choice"
 | |
|                             : new Link(values.type, "../SpecialInputElements.md#" + values.type),
 | |
|                         new Combine(embedded).SetClass("flex"),
 | |
|                     ]
 | |
|                 })
 | |
|         )
 | |
| 
 | |
|         let quickOverview: BaseUIElement = undefined
 | |
|         if (tableRows.length > 0) {
 | |
|             quickOverview = new Combine([
 | |
|                 new FixedUiElement("Warning: ").SetClass("bold"),
 | |
|                 "this quick overview is incomplete",
 | |
|                 new Table(
 | |
|                     ["attribute", "type", "values which are supported by this layer"],
 | |
|                     tableRows
 | |
|                 ).SetClass("zebra-table"),
 | |
|             ]).SetClass("flex-col flex")
 | |
|         }
 | |
| 
 | |
|         let iconImg: BaseUIElement = new FixedUiElement("")
 | |
| 
 | |
|         if (Utils.runningFromConsole) {
 | |
|             const icon = this.mapRendering
 | |
|                 .filter((mr) => mr.location.has("point"))
 | |
|                 .map((mr) => mr.icon?.render?.txt)
 | |
|                 .find((i) => i !== undefined)
 | |
|             // This is for the documentation in a markdown-file, so we have to use raw HTML
 | |
|             if (icon !== undefined) {
 | |
|                 iconImg = new FixedUiElement(
 | |
|                     `<img src='https://mapcomplete.osm.be/${icon}' height="100px"> `
 | |
|                 )
 | |
|             }
 | |
|         } else {
 | |
|             iconImg = this.mapRendering
 | |
|                 .filter((mr) => mr.location.has("point"))
 | |
|                 .map(
 | |
|                     (mr) =>
 | |
|                         mr.GenerateLeafletStyle(
 | |
|                             new UIEventSource<OsmTags>({ id: "node/-1" }),
 | |
|                             false,
 | |
|                             { includeBadges: false }
 | |
|                         ).html
 | |
|                 )
 | |
|                 .find((i) => i !== undefined)
 | |
|         }
 | |
| 
 | |
|         let overpassLink: BaseUIElement = undefined
 | |
|         if (Constants.priviliged_layers.indexOf(this.id) < 0) {
 | |
|             try {
 | |
|                 overpassLink = new Link(
 | |
|                     "Execute on overpass",
 | |
|                     Overpass.AsOverpassTurboLink(<TagsFilter>new And(neededTags).optimize())
 | |
|                 )
 | |
|             } catch (e) {
 | |
|                 console.error("Could not generate overpasslink for " + this.id)
 | |
|             }
 | |
|         }
 | |
| 
 | |
|         const filterDocs: (string | BaseUIElement)[] = []
 | |
|         if (this.filters.length > 0) {
 | |
|             filterDocs.push(new Title("Filters", 4))
 | |
|             filterDocs.push(...this.filters.map((filter) => filter.GenerateDocs()))
 | |
|         }
 | |
|         return new Combine([
 | |
|             new Combine([new Title(this.id, 1), iconImg, this.description, "\n"]).SetClass(
 | |
|                 "flex flex-col"
 | |
|             ),
 | |
|             new List(extraProps),
 | |
|             ...usingLayer,
 | |
| 
 | |
|             new Title("Basic tags for this layer", 2),
 | |
|             "Elements must have the all of following tags to be shown on this layer:",
 | |
|             new List(neededTags.map((t) => t.asHumanString(true, false, {}))),
 | |
|             overpassLink,
 | |
|             new Title("Supported attributes", 2),
 | |
|             quickOverview,
 | |
|             ...this.tagRenderings.map((tr) => tr.GenerateDocumentation()),
 | |
|             ...filterDocs,
 | |
|         ])
 | |
|             .SetClass("flex-col")
 | |
|             .SetClass("link-underline")
 | |
|     }
 | |
| 
 | |
|     public CustomCodeSnippets(): string[] {
 | |
|         if (this.calculatedTags === undefined) {
 | |
|             return []
 | |
|         }
 | |
|         return this.calculatedTags.map((code) => code[1])
 | |
|     }
 | |
| 
 | |
|     AllTagRenderings(): TagRenderingConfig[] {
 | |
|         return Utils.NoNull([...this.tagRenderings, ...this.titleIcons, this.title])
 | |
|     }
 | |
| 
 | |
|     public isLeftRightSensitive(): boolean {
 | |
|         return this.lineRendering.some((lr) => lr.leftRightSensitive)
 | |
|     }
 | |
| }
 |