umap-project 2.3.1__py3-none-any.whl → 2.4.0b0__py3-none-any.whl

umap/static/umap/js/modules/autocomplete.js

@@ -0,0 +1,347 @@
+import {
+  DomUtil,
+  DomEvent,
+  setOptions,
+  Util,
+} from '../../vendors/leaflet/leaflet-src.esm.js'
+import { translate } from './i18n.js'
+import { Request, ServerRequest } from './request.js'
+
+export class BaseAutocomplete {
+  constructor(el, options) {
+    this.el = el
+    this.options = {
+      placeholder: translate('Start typing...'),
+      emptyMessage: translate('No result'),
+      allowFree: true,
+      minChar: 2,
+      maxResults: 5,
+    }
+    this.cache = ''
+    this.results = []
+    this._current = null
+    setOptions(this, options)
+    this.createInput()
+    this.createContainer()
+    this.selectedContainer = this.initSelectedContainer()
+  }
+
+  get current() {
+    return this._current
+  }
+
+  set current(index) {
+    if (typeof index === 'object') {
+      index = this.resultToIndex(index)
+    }
+    this._current = index
+  }
+
+  createInput() {
+    this.input = DomUtil.element({
+      tagName: 'input',
+      type: 'text',
+      parent: this.el,
+      placeholder: this.options.placeholder,
+      autocomplete: 'off',
+      className: this.options.className,
+    })
+    DomEvent.on(this.input, 'keydown', this.onKeyDown, this)
+    DomEvent.on(this.input, 'keyup', this.onKeyUp, this)
+    DomEvent.on(this.input, 'blur', this.onBlur, this)
+  }
+
+  createContainer() {
+    this.container = DomUtil.element({
+      tagName: 'ul',
+      parent: document.body,
+      className: 'umap-autocomplete',
+    })
+  }
+
+  resizeContainer() {
+    const l = this.getLeft(this.input)
+    const t = this.getTop(this.input) + this.input.offsetHeight
+    this.container.style.left = `${l}px`
+    this.container.style.top = `${t}px`
+    const width = this.options.width ? this.options.width : this.input.offsetWidth - 2
+    this.container.style.width = `${width}px`
+  }
+
+  onKeyDown(e) {
+    switch (e.key) {
+      case 'Tab':
+        if (this.current !== null) this.setChoice()
+        DomEvent.stop(e)
+        break
+      case 'Enter':
+        DomEvent.stop(e)
+        this.setChoice()
+        break
+      case 'Escape':
+        DomEvent.stop(e)
+        this.hide()
+        break
+      case 'ArrowDown':
+        if (this.results.length > 0) {
+          if (this.current !== null && this.current < this.results.length - 1) {
+            // what if one result?
+            this.current++
+            this.highlight()
+          } else if (this.current === null) {
+            this.current = 0
+            this.highlight()
+          }
+        }
+        break
+      case 'ArrowUp':
+        if (this.current !== null) {
+          DomEvent.stop(e)
+        }
+        if (this.results.length > 0) {
+          if (this.current > 0) {
+            this.current--
+            this.highlight()
+          } else if (this.current === 0) {
+            this.current = null
+            this.highlight()
+          }
+        }
+        break
+    }
+  }
+
+  onKeyUp(e) {
+    const special = [
+      'Tab',
+      'Enter',
+      'ArrowLeft',
+      'ArrowRight',
+      'ArrowDown',
+      'ArrowUp',
+      'Meta',
+      'Shift',
+      'Alt',
+      'Control',
+    ]
+    if (!special.includes(e.key)) {
+      this.search()
+    }
+  }
+
+  onBlur() {
+    setTimeout(() => this.hide(), 100)
+  }
+
+  clear() {
+    this.results = []
+    this.current = null
+    this.cache = ''
+    this.container.innerHTML = ''
+  }
+
+  hide() {
+    this.clear()
+    this.container.style.display = 'none'
+    this.input.value = ''
+  }
+
+  setChoice(choice) {
+    choice = choice || this.results[this.current]
+    if (choice) {
+      this.input.value = choice.item.label
+      this.options.on_select(choice)
+      this.displaySelected(choice)
+      this.hide()
+      if (this.options.callback) {
+        this.options.callback.bind(this)(choice)
+      }
+    }
+  }
+
+  createResult(item) {
+    const el = DomUtil.element({
+      tagName: 'li',
+      parent: this.container,
+      textContent: item.label,
+    })
+    const result = {
+      item: item,
+      el: el,
+    }
+    DomEvent.on(el, 'mouseover', () => {
+      this.current = result
+      this.highlight()
+    })
+    DomEvent.on(el, 'mousedown', () => this.setChoice())
+    return result
+  }
+
+  resultToIndex(result) {
+    return this.results.findIndex((item) => item.item.value === result.item.value)
+  }
+
+  handleResults(data) {
+    this.clear()
+    this.container.style.display = 'block'
+    this.resizeContainer()
+    data.forEach((item) => {
+      this.results.push(this.createResult(item))
+    })
+    this.current = 0
+    this.highlight()
+    //TODO manage no results
+  }
+
+  highlight() {
+    this.results.forEach((result, index) => {
+      if (index === this.current) DomUtil.addClass(result.el, 'on')
+      else DomUtil.removeClass(result.el, 'on')
+    })
+  }
+
+  getLeft(el) {
+    let tmp = el.offsetLeft
+    el = el.offsetParent
+    while (el) {
+      tmp += el.offsetLeft
+      el = el.offsetParent
+    }
+    return tmp
+  }
+
+  getTop(el) {
+    let tmp = el.offsetTop
+    el = el.offsetParent
+    while (el) {
+      tmp += el.offsetTop
+      el = el.offsetParent
+    }
+    return tmp
+  }
+}
+
+export class BaseAjax extends BaseAutocomplete {
+  constructor(el, options) {
+    super(el, options)
+    this.setUrl()
+    this.initRequest()
+  }
+
+  setUrl() {
+    this.url = this.options?.url
+  }
+
+  initRequest() {
+    this.request = new Request()
+  }
+
+  optionToResult(option) {
+    return {
+      value: option.value,
+      label: option.innerHTML,
+    }
+  }
+
+  async search() {
+    let val = this.input.value
+    if (val.length < this.options.minChar) {
+      this.clear()
+      return
+    }
+    if (val === this.cache) return
+    else this.cache = val
+    val = val.toLowerCase()
+    const url = Util.template(this.url, { q: encodeURIComponent(val) })
+    this.handleResults(await this._search(url))
+  }
+
+  async _search(url) {
+    const response = await this.request.get(url)
+    if (response && response.ok) {
+      return await response.json()
+    }
+  }
+}
+
+class BaseServerAjax extends BaseAjax {
+  setUrl() {
+    this.url = '/agnocomplete/AutocompleteUser/?q={q}'
+  }
+
+  initRequest() {
+    this.server = new ServerRequest()
+  }
+  async _search(url) {
+    const [{ data }, response] = await this.server.get(url)
+    return data
+  }
+}
+
+export const SingleMixin = (Base) =>
+  class extends Base {
+    initSelectedContainer() {
+      return DomUtil.after(
+        this.input,
+        DomUtil.element({ tagName: 'div', className: 'umap-singleresult' })
+      )
+    }
+
+    displaySelected(result) {
+      const result_el = DomUtil.element({
+        tagName: 'div',
+        parent: this.selectedContainer,
+      })
+      result_el.textContent = result.item.label
+      const close = DomUtil.element({
+        tagName: 'span',
+        parent: result_el,
+        className: 'close',
+        textContent: '×',
+      })
+      this.input.style.display = 'none'
+      DomEvent.on(
+        close,
+        'click',
+        function () {
+          this.selectedContainer.innerHTML = ''
+          this.input.style.display = 'block'
+        },
+        this
+      )
+      this.hide()
+    }
+  }
+
+export const MultipleMixin = (Base) =>
+  class extends Base {
+    initSelectedContainer() {
+      return DomUtil.after(
+        this.input,
+        DomUtil.element({ tagName: 'ul', className: 'umap-multiresult' })
+      )
+    }
+
+    displaySelected(result) {
+      const result_el = DomUtil.element({
+        tagName: 'li',
+        parent: this.selectedContainer,
+      })
+      result_el.textContent = result.item.label
+      const close = DomUtil.element({
+        tagName: 'span',
+        parent: result_el,
+        className: 'close',
+        textContent: '×',
+      })
+      DomEvent.on(close, 'click', () => {
+        this.selectedContainer.removeChild(result_el)
+        this.options.on_unselect(result)
+      })
+      this.hide()
+    }
+  }
+
+export class AjaxAutocompleteMultiple extends MultipleMixin(BaseServerAjax) {}
+
+export class AjaxAutocomplete extends SingleMixin(BaseServerAjax) {}

umap/static/umap/js/modules/browser.js

@@ -150,7 +150,7 @@ export default class Browser {
     // https://github.com/Leaflet/Leaflet/pull/9052
     DomEvent.disableClickPropagation(container)
 
-    DomUtil.createTitle(container, translate('Browse data'), 'icon-layers')
+    DomUtil.createTitle(container, translate('Data browser'), 'icon-layers')
     const formContainer = DomUtil.createFieldset(container, L._('Filters'), {
       on: this.mode === 'filters',
       className: 'filters',

umap/static/umap/js/modules/caption.js

@@ -18,8 +18,9 @@ export default class Caption {
 
   open() {
     const container = DomUtil.create('div', 'umap-caption')
-    DomUtil.createTitle(container, this.map.options.name, 'icon-caption')
-    this.map.permissions.addOwnerLink('h5', container)
+    const hgroup = DomUtil.element({tagName: 'hgroup', parent: container})
+    DomUtil.createTitle(hgroup, this.map.options.name, 'icon-caption icon-block')
+    this.map.permissions.addOwnerLink('h4', hgroup)
     if (this.map.options.description) {
       const description = DomUtil.element({
         tagName: 'div',
@@ -29,7 +30,7 @@ export default class Caption {
       })
     }
     const datalayerContainer = DomUtil.create('div', 'datalayer-container', container)
-    this.map.eachDataLayer((datalayer) =>
+    this.map.eachDataLayerReverse((datalayer) =>
       this.addDataLayer(datalayer, datalayerContainer)
     )
     const creditsContainer = DomUtil.create('div', 'credits-container', container)

umap/static/umap/js/modules/global.js

@@ -2,29 +2,53 @@ import URLs from './urls.js'
 import Browser from './browser.js'
 import Facets from './facets.js'
 import Caption from './caption.js'
-import { Panel, EditPanel, FullPanel } from './panel.js'
+import { Panel, EditPanel, FullPanel } from './ui/panel.js'
+import Dialog from './ui/dialog.js'
+import Tooltip from './ui/tooltip.js'
+import Rules from './rules.js'
 import * as Utils from './utils.js'
 import { SCHEMA } from './schema.js'
 import { Request, ServerRequest, RequestError, HTTPError, NOKError } from './request.js'
+import { AjaxAutocomplete, AjaxAutocompleteMultiple } from './autocomplete.js'
 import Orderable from './orderable.js'
+import Importer from './importer.js'
+import Help from './help.js'
+import { SyncEngine } from './sync/engine.js'
+import {
+  uMapAlert as Alert,
+  uMapAlertCreation as AlertCreation,
+  uMapAlertConflict as AlertConflict,
+} from '../components/alerts/alert.js'
 
 // Import modules and export them to the global scope.
 // For the not yet module-compatible JS out there.
 
+// By alphabetic order
 window.U = {
-  URLs,
-  Request,
-  ServerRequest,
-  RequestError,
-  HTTPError,
-  NOKError,
+  Alert,
+  AlertCreation,
+  AlertConflict,
+  AjaxAutocomplete,
+  AjaxAutocompleteMultiple,
   Browser,
-  Facets,
-  Panel,
+  Caption,
+  Dialog,
   EditPanel,
+  Facets,
   FullPanel,
-  Utils,
-  SCHEMA,
+  Help,
+  HTTPError,
+  Importer,
+  NOKError,
   Orderable,
-  Caption,
+  Panel,
+  Request,
+  RequestError,
+  Rules,
+  SCHEMA,
+  ServerRequest,
+  SyncEngine,
+  Tooltip,
+  URLs,
+  Utils,
 }

umap/static/umap/js/modules/help.js

@@ -0,0 +1,255 @@
+import { DomUtil, DomEvent } from '../../vendors/leaflet/leaflet-src.esm.js'
+import { translate } from './i18n.js'
+
+const SHORTCUTS = {
+  DRAW_MARKER: {
+    shortcut: 'Modifier+M',
+    label: translate('Draw a marker'),
+  },
+  DRAW_LINE: {
+    shortcut: 'Modifier+L',
+    label: translate('Draw a polyline'),
+  },
+  DRAW_POLYGON: {
+    shortcut: 'Modifier+P',
+    label: translate('Draw a polygon'),
+  },
+  TOGGLE_EDIT: {
+    shortcut: 'Modifier+E',
+    label: translate('Toggle edit mode'),
+  },
+  STOP_EDIT: {
+    shortcut: 'Modifier+E',
+    label: translate('Stop editing'),
+  },
+  SAVE_MAP: {
+    shortcut: 'Modifier+S',
+    label: translate('Save map'),
+  },
+  IMPORT_PANEL: {
+    shortcut: 'Modifier+I',
+    label: translate('Import data'),
+  },
+  SEARCH: {
+    shortcut: 'Modifier+F',
+    label: translate('Search location'),
+  },
+  CANCEL: {
+    shortcut: 'Modifier+Z',
+    label: translate('Cancel edits'),
+  },
+  PREVIEW: {
+    shortcut: 'Modifier+E',
+    label: translate('Back to preview'),
+  },
+  SAVE: {
+    shortcut: 'Modifier+S',
+    label: translate('Save current edits'),
+  },
+  EDIT_FEATURE_LAYER: {
+    shortcut: 'Modifier+⇧+Click',
+    label: translate("Edit feature's layer"),
+  },
+  CONTINUE_LINE: {
+    shortcut: 'Modifier+Click',
+    label: translate('Continue line'),
+  },
+}
+
+const ENTRIES = {
+  formatURL: `${translate(
+    'Supported variables that will be dynamically replaced'
+  )}: {bbox}, {lat}, {lng}, {zoom}, {east}, {north}..., {left}, {top}..., locale, lang`,
+  colorValue: translate('Must be a valid CSS value (eg.: DarkBlue or #123456)'),
+  smoothFactor: translate(
+    'How much to simplify the polyline on each zoom level (more = better performance and smoother look, less = more accurate)'
+  ),
+  dashArray: translate(
+    'A comma separated list of numbers that defines the stroke dash pattern. Ex.: "5, 10, 15".'
+  ),
+  zoomTo: translate('Zoom level for automatic zooms'),
+  labelKey: translate(
+    'The name of the property to use as feature label (eg.: "nom"). You can also use properties inside brackets to use more than one or mix with static content (eg.: "{name} in {place}")'
+  ),
+  stroke: translate('Whether to display or not polygons paths.'),
+  fill: translate('Whether to fill polygons with color.'),
+  fillColor: translate('Optional. Same as color if not set.'),
+  shortCredit: translate('Will be displayed in the bottom right corner of the map'),
+  longCredit: translate('Will be visible in the caption of the map'),
+  permanentCredit: translate(
+    'Will be permanently visible in the bottom left corner of the map'
+  ),
+  sortKey: translate(
+    'Comma separated list of properties to use for sorting features. To reverse the sort, put a minus sign (-) before. Eg. mykey,-otherkey.'
+  ),
+  slugKey: translate('The name of the property to use as feature unique identifier.'),
+  filterKey: translate(
+    'Comma separated list of properties to use when filtering features by text input'
+  ),
+  facetKey: translate(
+    'Comma separated list of properties to use for filters (eg.: mykey,otherkey). To control label, add it after a | (eg.: mykey|My Key,otherkey|Other Key). To control input field type, add it after another | (eg.: mykey|My Key|checkbox,otherkey|Other Key|datetime). Allowed values for the input field type are checkbox (default), radio, number, date and datetime.'
+  ),
+  interactive: translate(
+    'If false, the polygon or line will act as a part of the underlying map.'
+  ),
+  outlink: translate('Define link to open in a new window on polygon click.'),
+  dynamicRemoteData: translate('Fetch data each time map view changes.'),
+  proxyRemoteData: translate(
+    "To use if remote server doesn't allow cross domain (slower)"
+  ),
+  browsable: translate(
+    'Set it to false to hide this layer from the slideshow, the data browser, the popup navigation…'
+  ),
+  importMode: translate(
+    'When providing an URL, uMap can copy the remote data in a layer, or add this URL as remote source of the layer. In that case, data will always be fetched from that URL, and thus be up to date, but it will not be possible to edit it inside uMap.'
+  ),
+  importFormats: `
+  <div>
+    <dt>GeoJSON</dt>
+    <dd>${translate('All properties are imported.')}</dd>
+    <dt>GPX</dt>
+    <dd>${translate('Properties imported:')}name, desc</dd>
+    <dt>KML</dt>
+    <dd>${translate('Properties imported:')}name, description</dd>
+    <dt>CSV</dt>
+    <dd>${translate('Comma, tab or semi-colon separated values. SRS WGS84 is implied. Only Point geometries are imported. The import will look at the column headers for any mention of «lat» and «lon» at the begining of the header, case insensitive. All other column are imported as properties.')}</dd>
+    <dt>uMap</dt>
+    <dd>${translate('Imports all umap data, including layers and settings.')}</dd>
+  </div>
+  `,
+  dynamicProperties: `
+  <div>
+    <h4>${translate('Dynamic properties')}</h4>
+    <p>${translate('Use placeholders with feature properties between brackets, eg. &#123;name&#125;, they will be dynamically replaced by the corresponding values.')}</p>
+  </div>
+  `,
+
+  textFormatting: `
+  <div>
+    <h4>${translate('Text formatting')}</h4>
+    <ul>
+      <li>${translate('*single star for italic*')}</li>
+      <li>${translate('**double star for bold**')}</li>
+      <li>${translate('# one hash for main heading')}</li>
+      <li>${translate('## two hashes for second heading')}</li>
+      <li>${translate('### three hashes for third heading')}</li>
+      <li>${translate('Simple link: [[http://example.com]]')}</li>
+      <li>${translate('Link with text: [[http://example.com|text of the link]]')}</li>
+      <li>${translate('Image: {{http://image.url.com}}')}</li>
+      <li>${translate('Image with custom width (in px): {{http://image.url.com|width}}')}</li>
+      <li>${translate('Iframe: {{{http://iframe.url.com}}}')}</li>
+      <li>${translate('Iframe with custom height (in px): {{{http://iframe.url.com|height}}}')}</li>
+      <li>${translate('Iframe with custom height and width (in px): {{{http://iframe.url.com|height*width}}}')}</li>
+      <li>${translate('--- for a horizontal rule')}</li>
+    </ul>
+  </div>
+  `,
+
+  overpassImporter: `
+  <div>
+    <h4>${translate('Overpass supported expressions')}</h4>
+    <ul>
+      <li>${translate('key (eg. building)')}</li>
+      <li>${translate('!key (eg. !name)')}</li>
+      <li>${translate('key=value (eg. building=yes)')}</li>
+      <li>${translate('key!=value (eg. building!=yes)')}</li>
+      <li>${translate('key~value (eg. name~Grisy)')}</li>
+      <li>${translate('key="value|value2" (eg. name="Paris|Berlin")')}</li>
+    </ul>
+    <div>${translate('More info about Overpass syntax')}: <a href="https://wiki.openstreetmap.org/wiki/Overpass_API/Language_Guide">https://wiki.openstreetmap.org/wiki/Overpass_API/Language_Guide</a></div>
+    <div>${translate('For more complex needs, see')} <a href="https://overpass-turbo.eu/">https://overpass-turbo.eu/</a></div>
+  </div>
+  `,
+}
+
+export default class Help {
+  constructor(map) {
+    this.map = map
+    this.isMacOS = /mac/i.test(
+      // eslint-disable-next-line compat/compat -- Fallback available.
+      navigator.userAgentData ? navigator.userAgentData.platform : navigator.platform
+    )
+  }
+
+  displayLabel(action, withKbdTag = true) {
+    let { shortcut, label } = SHORTCUTS[action]
+    const modifier = this.isMacOS ? 'Cmd' : 'Ctrl'
+    shortcut = shortcut.replace('Modifier', modifier)
+    if (withKbdTag) {
+      shortcut = shortcut
+        .split('+')
+        .map((el) => `<kbd>${el}</kbd>`)
+        .join('+')
+      label += ` ${shortcut}`
+    } else {
+      label += ` (${shortcut})`
+    }
+    return label
+  }
+
+  show(entries) {
+    const container = DomUtil.add('div')
+    DomUtil.createTitle(container, translate('Help'))
+    // Special dynamic case. Do we still think this dialog is usefull ?
+    if (entries == 'edit') {
+      DomUtil.element({
+        tagName: 'div',
+        className: 'umap-help-entry',
+        parent: container,
+      }).appendChild(this._buildEditEntry())
+    } else {
+      for (const name of entries) {
+        DomUtil.element({
+          tagName: 'div',
+          className: 'umap-help-entry',
+          parent: container,
+          innerHTML: ENTRIES[name],
+        })
+      }
+    }
+    this.map.dialog.open({ content: container, className: 'dark' })
+  }
+
+  button(container, entries, classname) {
+    const button = DomUtil.createButton(
+      classname || 'umap-help-button',
+      container,
+      translate('Help')
+    )
+    entries = typeof entries === 'string' ? [entries] : entries
+    DomEvent.on(button, 'click', DomEvent.stop).on(button, 'click', () =>
+      this.show(entries)
+    )
+    return button
+  }
+
+  link(container, entries) {
+    const button = this.button(container, entries, 'umap-help-link')
+    button.textContent = translate('Help')
+    return button
+  }
+
+  parse(container) {
+    for (const element of container.querySelectorAll('[data-help]')) {
+      this.button(element, element.dataset.help.split(','))
+    }
+  }
+
+  _buildEditEntry() {
+    const container = DomUtil.create('div', '')
+    const title = DomUtil.create('h4', '', container)
+    const actionsContainer = DomUtil.create('ul', 'umap-edit-actions', container)
+    const addAction = (action) => {
+      const actionContainer = DomUtil.add('li', '', actionsContainer)
+      DomUtil.add('i', action.options.className, actionContainer),
+        DomUtil.add('span', '', actionContainer, action.options.tooltip)
+      DomEvent.on(actionContainer, 'click', action.addHooks, action)
+      DomEvent.on(actionContainer, 'click', this.map.dialog.close, this.map.dialog)
+    }
+    title.textContent = translate('Where do we go from here?')
+    for (const id in this.map.helpMenuActions) {
+      addAction(this.map.helpMenuActions[id])
+    }
+    return container
+  }
+}