mapshaper 0.7.2 → 0.7.4

package/www/docs/_assets/docs.js

@@ -1,75 +0,0 @@
-// Tiny client-side helpers for the docs site.
-//
-// 1. Rewrites "Open in the web app" links so they target the current
-//    origin. At build time, build-docs.mjs renders the link with `href`
-//    pointing at https://mapshaper.org/?files=https%3A%2F%2Fmapshaper.org%2F...
-//    and a `data-open-snapshot="/docs/.../foo.msx"` attribute holding the
-//    snapshot's site-root-relative path. On page load we recompute href
-//    against `location.origin` so the link works when the docs are
-//    previewed locally (typically via `mapshaper-gui`, which serves www/
-//    on localhost:NNNN), and continues to do the right thing on the
-//    production site.
-//
-// 2. Adds a "Copy" button to every code block on individual example-map
-//    pages (body.is-example-map). Skipped on the Basics index, whose code
-//    blocks are short snippets where the buttons would be visual noise.
-//    Falls back gracefully if the Clipboard API is unavailable.
-(function () {
-  rewriteOpenInWebAppLinks();
-  if (document.body.classList.contains('is-example-map')) {
-    addCopyButtons();
-  }
-
-  function rewriteOpenInWebAppLinks() {
-    var links = document.querySelectorAll('a[data-open-snapshot]');
-    if (!links.length) return;
-    var origin = location.origin;
-    for (var i = 0; i < links.length; i++) {
-      var a = links[i];
-      var path = a.getAttribute('data-open-snapshot') || '';
-      if (!path) continue;
-      var absUrl = origin + path;
-      a.href = origin + '/?files=' + encodeURIComponent(absUrl) + '&q';
-    }
-  }
-
-  function addCopyButtons() {
-    if (!navigator.clipboard || !navigator.clipboard.writeText) return;
-    var blocks = document.querySelectorAll('.docs-article pre');
-    for (var i = 0; i < blocks.length; i++) {
-      attachCopyButton(blocks[i]);
-    }
-  }
-
-  function attachCopyButton(pre) {
-    if (pre.querySelector(':scope > .copy-btn')) return; // already wired
-    pre.classList.add('has-copy-btn');
-    var btn = document.createElement('button');
-    btn.type = 'button';
-    btn.className = 'copy-btn';
-    btn.setAttribute('aria-label', 'Copy code to clipboard');
-    btn.textContent = 'Copy';
-    btn.addEventListener('click', function () {
-      var code = pre.querySelector('code') || pre;
-      var text = code.innerText.replace(/\n$/, '');
-      navigator.clipboard.writeText(text).then(function () {
-        flash(btn, 'Copied');
-      }, function () {
-        flash(btn, 'Copy failed');
-      });
-    });
-    pre.appendChild(btn);
-  }
-
-  var flashTimer = null;
-  function flash(btn, label) {
-    var original = 'Copy';
-    btn.textContent = label;
-    btn.classList.add('is-flashing');
-    if (flashTimer) clearTimeout(flashTimer);
-    flashTimer = setTimeout(function () {
-      btn.textContent = original;
-      btn.classList.remove('is-flashing');
-    }, 1400);
-  }
-})();

package/www/docs/_assets/highlight.css

@@ -1,10 +0,0 @@
-pre code.hljs{display:block;overflow-x:auto;padding:1em}code.hljs{padding:3px 5px}/*!
-  Theme: GitHub Dark
-  Description: Dark theme as seen on github.com
-  Author: github.com
-  Maintainer: @Hirse
-  Updated: 2021-05-15
-
-  Outdated base version: https://github.com/primer/github-syntax-dark
-  Current colors taken from GitHub's CSS
-*/.hljs{color:#c9d1d9;background:#0d1117}.hljs-doctag,.hljs-keyword,.hljs-meta .hljs-keyword,.hljs-template-tag,.hljs-template-variable,.hljs-type,.hljs-variable.language_{color:#ff7b72}.hljs-title,.hljs-title.class_,.hljs-title.class_.inherited__,.hljs-title.function_{color:#d2a8ff}.hljs-attr,.hljs-attribute,.hljs-literal,.hljs-meta,.hljs-number,.hljs-operator,.hljs-selector-attr,.hljs-selector-class,.hljs-selector-id,.hljs-variable{color:#79c0ff}.hljs-meta .hljs-string,.hljs-regexp,.hljs-string{color:#a5d6ff}.hljs-built_in,.hljs-symbol{color:#ffa657}.hljs-code,.hljs-comment,.hljs-formula{color:#8b949e}.hljs-name,.hljs-quote,.hljs-selector-pseudo,.hljs-selector-tag{color:#7ee787}.hljs-subst{color:#c9d1d9}.hljs-section{color:#1f6feb;font-weight:700}.hljs-bullet{color:#f2cc60}.hljs-emphasis{color:#c9d1d9;font-style:italic}.hljs-strong{color:#c9d1d9;font-weight:700}.hljs-addition{color:#aff5b4;background-color:#033a16}.hljs-deletion{color:#ffdcd7;background-color:#67060c}

package/www/docs/essentials/command-line.html

@@ -1,127 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1">
-<title>The command-line tool &middot; mapshaper docs</title>
-<meta name="description" content="Install the mapshaper CLI, run your first commands and learn how Mapshaper organizes data into layers.">
-<link rel="icon" type="image/png" href="/images/icon.png">
-<link rel="stylesheet" href="/docs/_assets/highlight.css">
-<link rel="stylesheet" href="/docs/_assets/docs.css">
-</head>
-<body class="">
-
-<header class="page-header">
-  <a href="/" class="mapshaper-logo">map<span class="logo-highlight">shaper</span></a>
-  <span class="header-section-label">Docs</span>
-  <nav class="header-nav">
-    <a href="/">Web app</a>
-    <a href="https://github.com/mbloch/mapshaper">GitHub</a>
-    <a href="/sponsor.html" class="sponsor-link"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M12 21.35l-1.45-1.32C5.4 15.36 2 12.28 2 8.5 2 5.42 4.42 3 7.5 3c1.74 0 3.41.81 4.5 2.09C13.09 3.81 14.76 3 16.5 3 19.58 3 22 5.42 22 8.5c0 3.78-3.4 6.86-8.55 11.54L12 21.35z"/></svg> Become a sponsor</a>
-  </nav>
-</header>
-
-<div class="docs-layout">
-
-  <aside class="docs-sidebar">
-    <div class="sidebar-inner">
-      <nav class="docs-nav"><ul class="top-links"><li><a href="/docs/">Home</a></li><li><a href="/docs/whats-new.html">What&#39;s new</a></li><li><a href="/docs/reference.html">Command reference</a></li><li><a href="/docs/gallery/">Gallery</a></li></ul><h2>Getting started</h2><ul><li><a href="/docs/essentials/command-line.html" class="is-active">The command-line tool</a></li><li><a href="/docs/essentials/web-app.html">The web app</a></li></ul><h2>Guides</h2><ul><li><a href="/docs/guides/simplification.html">Simplification</a></li><li><a href="/docs/guides/expressions.html">JavaScript expressions</a></li><li><a href="/docs/guides/projections.html">Projections</a></li><li><a href="/docs/guides/topology.html">Topology and cleaning</a></li><li><a href="/docs/guides/combining-layers.html">Combining two layers</a></li><li><a href="/docs/guides/programmatic.html">Using Mapshaper from Node.js</a></li></ul><h2>Formats</h2><ul><li><a href="/docs/formats/overview.html">Overview</a></li><li><a href="/docs/formats/shapefile.html">Shapefile</a></li><li><a href="/docs/formats/geojson.html">GeoJSON</a></li><li><a href="/docs/formats/topojson.html">TopoJSON</a></li><li><a href="/docs/formats/geopackage.html">GeoPackage</a></li><li><a href="/docs/formats/flatgeobuf.html">FlatGeobuf</a></li><li><a href="/docs/formats/kml.html">KML / KMZ</a></li><li><a href="/docs/formats/csv.html">CSV / TSV</a></li><li><a href="/docs/formats/dbf.html">DBF</a></li><li><a href="/docs/formats/json.html">JSON records</a></li><li><a href="/docs/formats/svg.html">SVG</a></li><li><a href="/docs/formats/snapshot.html">Mapshaper snapshot</a></li></ul><h2>Examples</h2><ul><li><a href="/docs/examples/basics.html">Basics</a></li><li><a href="/docs/examples/globe.html">Globe</a></li><li><a href="/docs/examples/us-states.html">U.S. state map</a></li></ul></nav>
-    </div>
-  </aside>
-
-  <main class="docs-main">
-    <article class="docs-article">
-      <div class="docs-breadcrumbs"><a href="/docs/">Docs</a> &rsaquo; Getting started &rsaquo; The command-line tool</div>
-      <h1 id="the-command-line-tool">The command-line tool</h1>
-<p>Mapshaper ships as a command-line tool and a <a href="/docs/essentials/web-app.html">web app</a>. This page is a tour of the CLI and the most common things you&#39;ll use it for.</p>
-<h2 id="install">Install</h2>
-<p>Mapshaper requires <a href="https://nodejs.org">Node.js</a>. With Node installed:</p>
-<pre><code class="hljs language-bash">npm install -g mapshaper
-</code></pre>
-<p>That gives you three executables:</p>
-<ul>
-<li><code>mapshaper</code> &mdash; the main CLI.</li>
-<li><code>mapshaper-xl</code> &mdash; same as <code>mapshaper</code>, but launched with a larger Node heap (8 GB by default) for processing very large files. Override the limit with <code>mapshaper-xl 16gb [commands]</code>.</li>
-<li><code>mapshaper-gui</code> &mdash; runs the <a href="/docs/essentials/web-app.html">web UI</a> locally on <code>http://localhost:5555</code>.</li>
-</ul>
-<p>You can also run mapshaper without installing it via <a href="https://bun.sh/">Bun</a> (<code>bunx mapshaper [commands]</code>) or with <code>npx mapshaper [commands]</code>.</p>
-<p>Check the install with:</p>
-<pre><code class="hljs language-bash">mapshaper -v
-</code></pre>
-<h2 id="anatomy-of-a-mapshaper-command">Anatomy of a Mapshaper command</h2>
-<p>A Mapshaper invocation is a sequence of commands run left-to-right. Each command starts with a hyphen-prefixed name and is followed by zero or more options. The initial <code>-i</code> (input) command is implied if the first argument is a file path.</p>
-<pre><code class="hljs language-bash">mapshaper provinces.shp -simplify dp 20% -o precision=0.00001 output.geojson
-</code></pre>
-<p>This reads a Shapefile, simplifies it using the Douglas-Peucker algorithm to 20% of its vertices, and writes a GeoJSON file with rounded coordinates.</p>
-<p>Options come in three forms:</p>
-<ul>
-<li><strong>Values</strong> like <code>provinces.shp</code> and <code>output.geojson</code>.</li>
-<li><strong>Flags</strong> like <code>dp</code>.</li>
-<li><strong>Name/value pairs</strong> like <code>precision=0.00001</code>.</li>
-</ul>
-<p>For the full reference, see the <a href="/docs/reference.html">command reference</a>.</p>
-<h2 id="some-examples">Some examples</h2>
-<h3 id="get-help">Get help</h3>
-<pre><code class="hljs language-bash">mapshaper -h                 <span class="hljs-comment"># list all commands</span>
-mapshaper -h simplify        <span class="hljs-comment"># detailed options for one command</span>
-</code></pre>
-<h3 id="chain-commands">Chain commands</h3>
-<pre><code class="hljs language-bash"><span class="hljs-comment"># From census blocks: dissolve populated Census blocks to tract level.</span>
-mapshaper tabblock2010_36_pophu.shp \
-  -filter <span class="hljs-string">&#x27;POP10 &gt; 0&#x27;</span> \
-  -each <span class="hljs-string">&#x27;TRACT=BLOCKID10.substr(0,11)&#x27;</span> \
-  -dissolve TRACT sum-fields=POP10 \
-  -o tracts.shp
-</code></pre>
-<pre><code class="hljs language-bash"><span class="hljs-comment"># Generate state and national boundaries from one county-level Shapefile.</span>
-<span class="hljs-comment"># Output: states.shp, usa.shp and other Shapefile component files</span>
-mapshaper counties.shp \
-  -dissolve STATE_FIPS name=states \
-  -dissolve + name=usa \
-  -o target=<span class="hljs-string">&#x27;*&#x27;</span>
-</code></pre>
-<p>For a broader set of recipes — filtering, joining, dissolving, reprojection, styling and more — see <a href="/docs/examples/basics.html">Basics</a>.</p>
-<h2 id="working-with-layers">Working with layers</h2>
-<p>Most commands operate on <strong>layers</strong> of data features. A layer is a collection of features with the same geometry type and a consistent attribute schema. Mapshaper supports polygon, polyline and point layers; a single feature may contain one shape, multiple shapes, or no shapes at all.</p>
-<p>The simplest case is a single layer in, a single layer out:</p>
-<pre><code class="hljs language-bash">mapshaper counties.shp -filter <span class="hljs-string">&#x27;this.isNull === false&#x27;</span> -o counties_notnull.shp
-</code></pre>
-<p>When a command runs on a multi-layer dataset, it acts on the <strong>target</strong> layer(s). Most commands accept a <code>target=</code> option, and the <a href="/docs/reference.html#-target"><code>-target</code></a> command sets the target for everything that follows.</p>
-<p>The <code>+</code> option keeps the original layer and creates a new one from the command&#39;s output. Combined with <code>name=</code>, it&#39;s the idiomatic way to derive a new layer:</p>
-<pre><code class="hljs language-bash"><span class="hljs-comment"># Output: out/provinces.json and out/lines.json</span>
-mapshaper provinces.shp \
-  -simplify 20% \
-  -innerlines + name=lines \
-  -target provinces,lines \
-  -o format=geojson out/
-</code></pre>
-<p>This produces <code>out/provinces.json</code> and <code>out/lines.json</code>.</p>
-<p>When importing a TopoJSON file, each named object becomes a layer:</p>
-<pre><code class="hljs language-bash">mapshaper usa.topojson \
-  -filter <span class="hljs-string">&#x27;STATE == &quot;HI&quot;&#x27;</span> target=states \
-  -o out/hawaii.geojson
-</code></pre>
-
-      <div class="edit-link">
-        <a href="https://github.com/mbloch/mapshaper/edit/master/docs/essentials/command-line.md">Edit this page on GitHub</a>
-      </div>
-    </article>
-  </main>
-
-  <aside class="docs-toc">
-    <div class="docs-toc-title">On this page</div><ul><li class="lvl-2"><a href="#install">Install</a></li><li class="lvl-2"><a href="#anatomy-of-a-mapshaper-command">Anatomy of a Mapshaper command</a></li><li class="lvl-2"><a href="#some-examples">Some examples</a></li><li class="lvl-3"><a href="#get-help">Get help</a></li><li class="lvl-3"><a href="#chain-commands">Chain commands</a></li><li class="lvl-2"><a href="#working-with-layers">Working with layers</a></li></ul>
-  </aside>
-
-</div>
-
-<script src="/docs/_assets/docs.js" defer></script>
-
-<footer class="docs-footer">
-  <div class="docs-footer-inner">
-    <span>mapshaper is free software, licensed under <a href="https://www.mozilla.org/MPL/2.0/">MPL 2.0</a>.</span>
-    <span><a href="/privacy.html">Privacy</a> &middot; <a href="/terms.html">Terms</a> &middot; <a href="/sponsor.html">Support mapshaper</a></span>
-  </div>
-</footer>
-
-</body>
-</html>

package/www/docs/essentials/command-line.html.md

@@ -1,112 +0,0 @@
----
-title: The command-line tool
-description: Install the mapshaper CLI, run your first commands and learn how Mapshaper organizes data into layers.
----
-
-# The command-line tool
-
-Mapshaper ships as a command-line tool and a [web app](/docs/essentials/web-app.html.md). This page is a tour of the CLI and the most common things you'll use it for.
-
-## Install
-
-Mapshaper requires [Node.js](https://nodejs.org). With Node installed:
-
-```bash
-npm install -g mapshaper
-```
-
-That gives you three executables:
-
-- `mapshaper` — the main CLI.
-- `mapshaper-xl` — same as `mapshaper`, but launched with a larger Node heap (8 GB by default) for processing very large files. Override the limit with `mapshaper-xl 16gb [commands]`.
-- `mapshaper-gui` — runs the [web UI](/docs/essentials/web-app.html.md) locally on `http://localhost:5555`.
-
-You can also run mapshaper without installing it via [Bun](https://bun.sh/) (`bunx mapshaper [commands]`) or with `npx mapshaper [commands]`.
-
-Check the install with:
-
-```bash
-mapshaper -v
-```
-
-## Anatomy of a Mapshaper command
-
-A Mapshaper invocation is a sequence of commands run left-to-right. Each command starts with a hyphen-prefixed name and is followed by zero or more options. The initial `-i` (input) command is implied if the first argument is a file path.
-
-```bash
-mapshaper provinces.shp -simplify dp 20% -o precision=0.00001 output.geojson
-```
-
-This reads a Shapefile, simplifies it using the Douglas-Peucker algorithm to 20% of its vertices, and writes a GeoJSON file with rounded coordinates.
-
-Options come in three forms:
-
-- **Values** like `provinces.shp` and `output.geojson`.
-- **Flags** like `dp`.
-- **Name/value pairs** like `precision=0.00001`.
-
-For the full reference, see the [command reference](/docs/reference.html.md).
-
-## Some examples
-
-### Get help
-
-```bash
-mapshaper -h                 # list all commands
-mapshaper -h simplify        # detailed options for one command
-```
-
-### Chain commands
-
-```bash
-# From census blocks: dissolve populated Census blocks to tract level.
-mapshaper tabblock2010_36_pophu.shp \
-  -filter 'POP10 > 0' \
-  -each 'TRACT=BLOCKID10.substr(0,11)' \
-  -dissolve TRACT sum-fields=POP10 \
-  -o tracts.shp
-```
-
-```bash
-# Generate state and national boundaries from one county-level Shapefile.
-# Output: states.shp, usa.shp and other Shapefile component files
-mapshaper counties.shp \
-  -dissolve STATE_FIPS name=states \
-  -dissolve + name=usa \
-  -o target='*'
-```
-
-For a broader set of recipes — filtering, joining, dissolving, reprojection, styling and more — see [Basics](/docs/examples/basics.html.md).
-
-## Working with layers
-
-Most commands operate on **layers** of data features. A layer is a collection of features with the same geometry type and a consistent attribute schema. Mapshaper supports polygon, polyline and point layers; a single feature may contain one shape, multiple shapes, or no shapes at all.
-
-The simplest case is a single layer in, a single layer out:
-
-```bash
-mapshaper counties.shp -filter 'this.isNull === false' -o counties_notnull.shp
-```
-
-When a command runs on a multi-layer dataset, it acts on the **target** layer(s). Most commands accept a `target=` option, and the [`-target`](/docs/reference.html.md#-target) command sets the target for everything that follows.
-
-The `+` option keeps the original layer and creates a new one from the command's output. Combined with `name=`, it's the idiomatic way to derive a new layer:
-
-```bash
-# Output: out/provinces.json and out/lines.json
-mapshaper provinces.shp \
-  -simplify 20% \
-  -innerlines + name=lines \
-  -target provinces,lines \
-  -o format=geojson out/
-```
-
-This produces `out/provinces.json` and `out/lines.json`.
-
-When importing a TopoJSON file, each named object becomes a layer:
-
-```bash
-mapshaper usa.topojson \
-  -filter 'STATE == "HI"' target=states \
-  -o out/hawaii.geojson
-```

package/www/docs/essentials/web-app.html

@@ -1,138 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1">
-<title>The web app &middot; mapshaper docs</title>
-<meta name="description" content="A tour of Mapshaper&#39;s web interface, including loading data, the console, the right-click menu, snapshots, browser support and running it locally.">
-<link rel="icon" type="image/png" href="/images/icon.png">
-<link rel="stylesheet" href="/docs/_assets/highlight.css">
-<link rel="stylesheet" href="/docs/_assets/docs.css">
-</head>
-<body class="">
-
-<header class="page-header">
-  <a href="/" class="mapshaper-logo">map<span class="logo-highlight">shaper</span></a>
-  <span class="header-section-label">Docs</span>
-  <nav class="header-nav">
-    <a href="/">Web app</a>
-    <a href="https://github.com/mbloch/mapshaper">GitHub</a>
-    <a href="/sponsor.html" class="sponsor-link"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M12 21.35l-1.45-1.32C5.4 15.36 2 12.28 2 8.5 2 5.42 4.42 3 7.5 3c1.74 0 3.41.81 4.5 2.09C13.09 3.81 14.76 3 16.5 3 19.58 3 22 5.42 22 8.5c0 3.78-3.4 6.86-8.55 11.54L12 21.35z"/></svg> Become a sponsor</a>
-  </nav>
-</header>
-
-<div class="docs-layout">
-
-  <aside class="docs-sidebar">
-    <div class="sidebar-inner">
-      <nav class="docs-nav"><ul class="top-links"><li><a href="/docs/">Home</a></li><li><a href="/docs/whats-new.html">What&#39;s new</a></li><li><a href="/docs/reference.html">Command reference</a></li><li><a href="/docs/gallery/">Gallery</a></li></ul><h2>Getting started</h2><ul><li><a href="/docs/essentials/command-line.html">The command-line tool</a></li><li><a href="/docs/essentials/web-app.html" class="is-active">The web app</a></li></ul><h2>Guides</h2><ul><li><a href="/docs/guides/simplification.html">Simplification</a></li><li><a href="/docs/guides/expressions.html">JavaScript expressions</a></li><li><a href="/docs/guides/projections.html">Projections</a></li><li><a href="/docs/guides/topology.html">Topology and cleaning</a></li><li><a href="/docs/guides/combining-layers.html">Combining two layers</a></li><li><a href="/docs/guides/programmatic.html">Using Mapshaper from Node.js</a></li></ul><h2>Formats</h2><ul><li><a href="/docs/formats/overview.html">Overview</a></li><li><a href="/docs/formats/shapefile.html">Shapefile</a></li><li><a href="/docs/formats/geojson.html">GeoJSON</a></li><li><a href="/docs/formats/topojson.html">TopoJSON</a></li><li><a href="/docs/formats/geopackage.html">GeoPackage</a></li><li><a href="/docs/formats/flatgeobuf.html">FlatGeobuf</a></li><li><a href="/docs/formats/kml.html">KML / KMZ</a></li><li><a href="/docs/formats/csv.html">CSV / TSV</a></li><li><a href="/docs/formats/dbf.html">DBF</a></li><li><a href="/docs/formats/json.html">JSON records</a></li><li><a href="/docs/formats/svg.html">SVG</a></li><li><a href="/docs/formats/snapshot.html">Mapshaper snapshot</a></li></ul><h2>Examples</h2><ul><li><a href="/docs/examples/basics.html">Basics</a></li><li><a href="/docs/examples/globe.html">Globe</a></li><li><a href="/docs/examples/us-states.html">U.S. state map</a></li></ul></nav>
-    </div>
-  </aside>
-
-  <main class="docs-main">
-    <article class="docs-article">
-      <div class="docs-breadcrumbs"><a href="/docs/">Docs</a> &rsaquo; Getting started &rsaquo; The web app</div>
-      <h1 id="the-web-app">The web app</h1>
-<p>The Mapshaper web app at <a href="/">mapshaper.org</a> is designed for interactive editing and visual exploration. Its built-in console exposes the complete command set, so almost anything the CLI can do is available directly in the browser.</p>
-<p>All processing happens in your browser. Your data stays on your machine, even when you use the public website.</p>
-<h2 id="loading-data">Loading data</h2>
-<p>Drag-drop, paste, or use the <strong>Add files</strong> button to import data.</p>
-<p>A few less-obvious behaviors:</p>
-<ul>
-<li><strong>Drop a <code>.zip</code> containing a Shapefile bundle</strong> &mdash; Mapshaper unzips it on the fly and pulls out the sidecars. (Same goes for <code>.gz</code> for single-file formats and <code>.kmz</code> for KML.)</li>
-<li><strong>Paste a URL</strong> anywhere on the page to import the file at that address.</li>
-<li><strong>Query-string preload</strong> &mdash; <code>https://mapshaper.org/?files=URL1,URL2</code> imports a comma-separated list of URLs. All files need to be served from a host that allows cross-origin requests. Append <code>&amp;q</code> to skip the import dialog and open the files immediately.</li>
-<li><strong>With advanced options</strong> is a freeform text field. Anything you&#39;d pass after <code>-i</code> on the CLI works here, including <code>encoding=</code>, <code>string-fields=</code>, <code>csv-fields=</code>, <code>csv-filter=</code>, <code>combine-files</code>, <code>name=</code> and so on.</li>
-<li><strong>Multiple files do not auto-combine.</strong> Selecting several files at once imports them as independent layers. To get a shared topology (so common boundaries simplify identically), tick <strong>with advanced options</strong> and add <code>combine-files</code>.</li>
-</ul>
-<h3 id="tips-for-importing-shapefiles">Tips for importing Shapefiles</h3>
-<ul>
-<li>Drag-drop or select the <code>.shp</code>, <code>.dbf</code> and <code>.prj</code> files together. Without <code>.dbf</code> you&#39;ll have geometry but no attributes; without <code>.prj</code>, projection-dependent commands won&#39;t know what to do.</li>
-<li>If you see a warning about an unknown text encoding, re-import using the <strong>with advanced options</strong> checkbox and set <code>encoding=</code> (for example, <code>encoding=big5</code> for Big-5).</li>
-</ul>
-<h2 id="the-console">The console</h2>
-<p>The Console (top-right of the header, or <strong>space bar</strong> to toggle) is the most powerful part of the UI. Anything the <a href="/docs/reference.html">CLI</a> can do, you can do here.</p>
-<h3 id="keyboard">Keyboard</h3>
-<ul>
-<li><strong>Space</strong> &mdash; open or close the console (only when you&#39;re not typing in another text field).</li>
-<li><strong>Esc</strong> &mdash; close the console, or close any open panel.</li>
-<li><strong>Up / Down</strong> &mdash; cycle through previous commands. The history persists across page reloads.</li>
-<li><strong>Backslash <code>\</code> at end of line</strong> &mdash; continue a long command on the next line. The Enter key adds the wrap; another <strong>Enter</strong> runs the full command.</li>
-</ul>
-<h3 id="syntax">Syntax</h3>
-<ul>
-<li>The leading <code>-</code> is optional in the console: <code>clip places</code> works the same as <code>-clip places</code>.</li>
-<li>Commands run on the <strong>currently-selected layer</strong> by default. Switch layers in the layer panel before issuing a command, or pass <code>target=</code> to be explicit (<code>target=*</code> runs against every layer).</li>
-</ul>
-<h3 id="magic-words-at-the-prompt">Magic words at the prompt</h3>
-<p>These are recognized directly by the console, not by Mapshaper:</p>
-<ul>
-<li><code>history</code> &mdash; print the current session as a single command-line string. Handy for reproducing an interactive workflow as a script.</li>
-<li><code>layers</code> &mdash; print the list of loaded layers.</li>
-<li><code>clear</code> &mdash; clear the console buffer.</li>
-<li><code>close</code> / <code>exit</code> / <code>quit</code> &mdash; close the console.</li>
-</ul>
-<h3 id="discovering-commands">Discovering commands</h3>
-<ul>
-<li><code>help</code> lists every available command.</li>
-<li><code>help &lt;command&gt;</code> shows the full options for one command, e.g. <code>help dissolve</code>.</li>
-<li>The <a href="/docs/reference.html">command reference</a> is the same content with a search box.</li>
-</ul>
-<h2 id="the-map">The map</h2>
-<h3 id="right-click-menu">Right-click menu</h3>
-<p>The right-click menu adapts to what&#39;s under the cursor:</p>
-<ul>
-<li><strong>Copy lon, lat</strong> &mdash; copy the WGS84 coordinates of the click point to the clipboard.</li>
-<li><strong>Copy x, y</strong> &mdash; copy the projected coordinates of the click point.</li>
-<li><strong>Copy as GeoJSON</strong> &mdash; copy the selected feature(s) to the clipboard as GeoJSON. Useful for snipping out one polygon for use elsewhere.</li>
-<li><strong>Delete vertex</strong> / <strong>delete point</strong> / <strong>delete feature</strong> &mdash; available in the corresponding edit modes.</li>
-</ul>
-<h3 id="layer-navigation">Layer navigation</h3>
-<ul>
-<li><strong>Left / Right arrows</strong> (when not typing) &mdash; cycle through the loaded layers.</li>
-</ul>
-<h2 id="display-options">Display options</h2>
-<p>The <strong>Display</strong> button at the top right opens the display options panel.</p>
-<ul>
-<li><strong>Detect line intersections</strong> &mdash; highlights self-intersections in red as you simplify or edit. The quickest way to spot simplification damage. The setting is remembered between sessions.</li>
-</ul>
-<h2 id="snapshots-and-session-history">Snapshots and session history</h2>
-<p>The ribbon icon in the layer panel opens the snapshot menu. Snapshots save the current state of a session so you can return to it. They also record the <strong>session history</strong> that produced the snapshot, so when you re-open one the full history is available too.</p>
-<ul>
-<li><strong>Create a snapshot</strong> &mdash; saves to in-browser storage. These are session-scoped and <strong>deleted when the tab closes or the page is reloaded.</strong> For anything you want to keep, <strong>Save snapshot to file</strong> writes a <code>.msx</code> file you can re-open later.</li>
-<li><strong>View session history</strong> &mdash; a shortcut for typing <code>history</code> in the console: prints the full sequence of commands that produced the current state.</li>
-</ul>
-<p>See the <a href="/docs/formats/snapshot.html">Mapshaper snapshot format page</a> for more on what a <code>.msx</code> file contains and how to use it from the CLI.</p>
-<h2 id="running-the-web-ui-locally">Running the web UI locally</h2>
-<p><code>mapshaper-gui</code> (installed alongside <code>mapshaper</code> when you <code>npm install -g mapshaper</code>) starts a local Node web server and opens the web UI at <code>http://localhost:5555</code>. Use <code>--port</code> to pick a different port.</p>
-<p>You can pre-load files by listing them on the command line, which skips the import dialog:</p>
-<pre><code class="hljs language-bash">mapshaper-gui states.shp rivers.shp
-</code></pre>
-<h2 id="browser-support">Browser support</h2>
-<p>When importing very large files (hundreds of megabytes), the web app may run out of memory and crash. Firefox used to be better than Chrome at handling large files, but Chrome seems to have improved recently. If the web app crashes, try the <a href="/docs/essentials/command-line.html"><code>mapshaper-xl</code> command-line tool</a>, which can allocate a large amount of memory.</p>
-<h2 id="privacy">Privacy</h2>
-<p>The Mapshaper web app runs entirely in your browser. No file content is uploaded to any server. The only network traffic is for static assets (the app itself), basemap tiles when you&#39;ve enabled a basemap, and analytics for <code>mapshaper.org</code> page loads. See the <a href="/privacy.html">privacy policy</a> for details.</p>
-
-      <div class="edit-link">
-        <a href="https://github.com/mbloch/mapshaper/edit/master/docs/essentials/web-app.md">Edit this page on GitHub</a>
-      </div>
-    </article>
-  </main>
-
-  <aside class="docs-toc">
-    <div class="docs-toc-title">On this page</div><ul><li class="lvl-2"><a href="#loading-data">Loading data</a></li><li class="lvl-3"><a href="#tips-for-importing-shapefiles">Tips for importing Shapefiles</a></li><li class="lvl-2"><a href="#the-console">The console</a></li><li class="lvl-3"><a href="#keyboard">Keyboard</a></li><li class="lvl-3"><a href="#syntax">Syntax</a></li><li class="lvl-3"><a href="#magic-words-at-the-prompt">Magic words at the prompt</a></li><li class="lvl-3"><a href="#discovering-commands">Discovering commands</a></li><li class="lvl-2"><a href="#the-map">The map</a></li><li class="lvl-3"><a href="#right-click-menu">Right-click menu</a></li><li class="lvl-3"><a href="#layer-navigation">Layer navigation</a></li><li class="lvl-2"><a href="#display-options">Display options</a></li><li class="lvl-2"><a href="#snapshots-and-session-history">Snapshots and session history</a></li><li class="lvl-2"><a href="#running-the-web-ui-locally">Running the web UI locally</a></li><li class="lvl-2"><a href="#browser-support">Browser support</a></li><li class="lvl-2"><a href="#privacy">Privacy</a></li></ul>
-  </aside>
-
-</div>
-
-<script src="/docs/_assets/docs.js" defer></script>
-
-<footer class="docs-footer">
-  <div class="docs-footer-inner">
-    <span>mapshaper is free software, licensed under <a href="https://www.mozilla.org/MPL/2.0/">MPL 2.0</a>.</span>
-    <span><a href="/privacy.html">Privacy</a> &middot; <a href="/terms.html">Terms</a> &middot; <a href="/sponsor.html">Support mapshaper</a></span>
-  </div>
-</footer>
-
-</body>
-</html>

package/www/docs/essentials/web-app.html.md

@@ -1,106 +0,0 @@
----
-title: The web app
-description: A tour of Mapshaper's web interface, including loading data, the console, the right-click menu, snapshots, browser support and running it locally.
----
-
-# The web app
-
-The Mapshaper web app at [mapshaper.org](/) is designed for interactive editing and visual exploration. Its built-in console exposes the complete command set, so almost anything the CLI can do is available directly in the browser.
-
-All processing happens in your browser. Your data stays on your machine, even when you use the public website.
-
-## Loading data
-
-Drag-drop, paste, or use the **Add files** button to import data.
-
-A few less-obvious behaviors:
-
-- **Drop a `.zip` containing a Shapefile bundle** — Mapshaper unzips it on the fly and pulls out the sidecars. (Same goes for `.gz` for single-file formats and `.kmz` for KML.)
-- **Paste a URL** anywhere on the page to import the file at that address.
-- **Query-string preload** — `https://mapshaper.org/?files=URL1,URL2` imports a comma-separated list of URLs. All files need to be served from a host that allows cross-origin requests. Append `&q` to skip the import dialog and open the files immediately.
-- **With advanced options** is a freeform text field. Anything you'd pass after `-i` on the CLI works here, including `encoding=`, `string-fields=`, `csv-fields=`, `csv-filter=`, `combine-files`, `name=` and so on.
-- **Multiple files do not auto-combine.** Selecting several files at once imports them as independent layers. To get a shared topology (so common boundaries simplify identically), tick **with advanced options** and add `combine-files`.
-
-### Tips for importing Shapefiles
-
-- Drag-drop or select the `.shp`, `.dbf` and `.prj` files together. Without `.dbf` you'll have geometry but no attributes; without `.prj`, projection-dependent commands won't know what to do.
-- If you see a warning about an unknown text encoding, re-import using the **with advanced options** checkbox and set `encoding=` (for example, `encoding=big5` for Big-5).
-
-## The console
-
-The Console (top-right of the header, or **space bar** to toggle) is the most powerful part of the UI. Anything the [CLI](/docs/reference.html.md) can do, you can do here.
-
-### Keyboard
-
-- **Space** — open or close the console (only when you're not typing in another text field).
-- **Esc** — close the console, or close any open panel.
-- **Up / Down** — cycle through previous commands. The history persists across page reloads.
-- **Backslash `\` at end of line** — continue a long command on the next line. The Enter key adds the wrap; another **Enter** runs the full command.
-
-### Syntax
-
-- The leading `-` is optional in the console: `clip places` works the same as `-clip places`.
-- Commands run on the **currently-selected layer** by default. Switch layers in the layer panel before issuing a command, or pass `target=` to be explicit (`target=*` runs against every layer).
-
-### Magic words at the prompt
-
-These are recognized directly by the console, not by Mapshaper:
-
-- `history` — print the current session as a single command-line string. Handy for reproducing an interactive workflow as a script.
-- `layers` — print the list of loaded layers.
-- `clear` — clear the console buffer.
-- `close` / `exit` / `quit` — close the console.
-
-### Discovering commands
-
-- `help` lists every available command.
-- `help <command>` shows the full options for one command, e.g. `help dissolve`.
-- The [command reference](/docs/reference.html.md) is the same content with a search box.
-
-## The map
-
-### Right-click menu
-
-The right-click menu adapts to what's under the cursor:
-
-- **Copy lon, lat** &mdash; copy the WGS84 coordinates of the click point to the clipboard.
-- **Copy x, y** &mdash; copy the projected coordinates of the click point.
-- **Copy as GeoJSON** &mdash; copy the selected feature(s) to the clipboard as GeoJSON. Useful for snipping out one polygon for use elsewhere.
-- **Delete vertex** / **delete point** / **delete feature** &mdash; available in the corresponding edit modes.
-
-### Layer navigation
-
-- **Left / Right arrows** (when not typing) &mdash; cycle through the loaded layers.
-
-## Display options
-
-The **Display** button at the top right opens the display options panel.
-
-- **Detect line intersections** &mdash; highlights self-intersections in red as you simplify or edit. The quickest way to spot simplification damage. The setting is remembered between sessions.
-
-## Snapshots and session history
-
-The ribbon icon in the layer panel opens the snapshot menu. Snapshots save the current state of a session so you can return to it. They also record the **session history** that produced the snapshot, so when you re-open one the full history is available too.
-
-- **Create a snapshot** &mdash; saves to in-browser storage. These are session-scoped and **deleted when the tab closes or the page is reloaded.** For anything you want to keep, **Save snapshot to file** writes a `.msx` file you can re-open later.
-- **View session history** &mdash; a shortcut for typing `history` in the console: prints the full sequence of commands that produced the current state.
-
-See the [Mapshaper snapshot format page](/docs/formats/snapshot.html.md) for more on what a `.msx` file contains and how to use it from the CLI.
-
-## Running the web UI locally
-
-`mapshaper-gui` (installed alongside `mapshaper` when you `npm install -g mapshaper`) starts a local Node web server and opens the web UI at `http://localhost:5555`. Use `--port` to pick a different port.
-
-You can pre-load files by listing them on the command line, which skips the import dialog:
-
-```bash
-mapshaper-gui states.shp rivers.shp
-```
-
-## Browser support
-
-When importing very large files (hundreds of megabytes), the web app may run out of memory and crash. Firefox used to be better than Chrome at handling large files, but Chrome seems to have improved recently. If the web app crashes, try the [`mapshaper-xl` command-line tool](/docs/essentials/command-line.html.md), which can allocate a large amount of memory.
-
-## Privacy
-
-The Mapshaper web app runs entirely in your browser. No file content is uploaded to any server. The only network traffic is for static assets (the app itself), basemap tiles when you've enabled a basemap, and analytics for `mapshaper.org` page loads. See the [privacy policy](/privacy.html) for details.