@sakuzu/maplibre-gl-draw 1.0.0 → 2.1.0

package/README.ja.md

@@ -10,7 +10,7 @@
 
 このページの正は英語版 ([README.md](README.md)) です。
 
-![東京駅周辺の playground。半透明で重なる円、細い線から太い線、破線と点線、枠と頂点ハンドルが付いた選択中の穴あき多角形、マルチポリゴン、円と四角と三角と星のマーカー、画像を囲むフリーハンドの線、不透明度を下げたレイヤー、カテゴリーのスタイル規則で塗り分けた区画、段階区分の規則で塗り分けた細かい六角形と凡例、レイヤーとグループの階層を示すレイヤーパネル](docs/images/overview.jpg)
+![東京駅周辺の playground。半透明で重なる円、細い線から太い線、破線と点線、輪郭が実線と破線と点線の面、枠と頂点ハンドルが付いた選択中の穴あき多角形、マルチポリゴン、円と四角と三角と星のマーカー、画像を囲むフリーハンドの線、不透明度を下げたレイヤー、カテゴリーのスタイル規則で塗り分けた区画、段階区分の規則で塗り分けた細かい六角形、レイヤーとグループと六角形のデータセットを並べたレイヤーのタブ (隣の凡例のタブに 2 つの規則が出ます)、選んだ多角形のインスペクター](docs/images/overview.jpg)
 
 ## 機能
 
@@ -93,12 +93,15 @@ GeoParquet や Arrow の表は、点、線、多角形が行ごとに混ざっ
 決められ、クリックすると属性を読めます
 ([大量のデータ](docs/guides/large-data.ja.md))。
 
-### 書き出しと読み込み
+### 保存と読み込み
 
-独自形式で書き出すと、レイヤー、グループ、スタイル、画像まで含めて
-保存でき、読み込めば同じ状態に戻ります。GeoJSON で書き出せば、ほかの
-ツールと地物をやり取りできます。地物を保存するストアは差し替えられ、
-変更はすべてイベントで通知されます
+文書を独自形式で書き出すと、レイヤー、グループ、スタイル、画像まで
+含めて保存でき、読み込めば同じ状態に戻ります。GeoJSON で書き出せば、
+ほかのツールと地物をやり取りできます。地物は GeoJSON の図形と
+GeoJSON の properties を持つので、ファイルはコードで読む地物と同じ形に
+なります。
+変更は取引ごとに 1 つのイベントで、出どころを添えて届きます。文書を
+保存するストアは差し替えられます
 ([保存と読み込み](docs/guides/save-load.ja.md))。
 
 ### 閲覧専用
@@ -108,7 +111,9 @@ GeoParquet や Arrow の表は、点、線、多角形が行ごとに混ざっ
 
 ### 拡張
 
-プラグイン、独自のモード、独自の地物型を足して拡張できます
+プラグイン、独自のモード、独自の描き方を持つ地物の型、重ね描き、
+吸着の候補やハンドルの提供者を足せます。どの種類も同じ方法で足し、
+足したときに返る関数で外します
 ([プラグイン](docs/guides/plugins.ja.md)、
 [独自の型](docs/guides/custom-types.ja.md))。
 
@@ -117,28 +122,36 @@ GeoParquet や Arrow の表は、点、線、多角形が行ごとに混ざっ
 ブラウザーですぐに試せます。インストールは要りません。
 
 - [プレイグラウンド][demo]
-  - すべての機能を 1 つの画面で。レイヤーとプロパティのパネル付き
-- [基本][ex-basic]
-  - 面の描画、変更のイベント、保存と復元
-- [書き出しと読み込み][ex-save-load]
-  - GeoJSON と独自形式の書き出し、地図に落としたファイルの読み込み
-- [スタイル規則][ex-style-rules]
+  - すべての機能を 1 つの画面で。標準の UI 付き
+- [例][examples]
+  - 20 の例。どれも、例を動かすページにそのコードを添えています
+
+例の一部を挙げます。
+
+- [Get started][ex-get-started]
+  - 地物を描き、選び、パネルで直す
+- [Save and load][ex-save-and-load]
+  - GeoJSON と独自形式、地図に落としたファイル、読み込みで外された地物
+- [Style rules and legend][ex-style-rules-and-legend]
   - 属性の値で色を分ける 4 種類の規則と凡例
-- [吸着と幾何演算][ex-snapping-and-geometry]
-  - 吸着、境界のなぞり、共有する頂点の同時移動、結合、切り抜き、
-    バッファ、分割
-- [3D 地形][ex-terrain]
-  - 3D 地形の上での描画と選択
-- [閲覧専用][ex-read-only]
-  - 閲覧専用モード、操作のロック、ロックしたレイヤー
-- [プラグイン][ex-plugin]
-  - フックと独自のモードを持つプラグイン
-- [独自の地物型][ex-custom-feature-type]
-  - 独自のレンダラーと当たり判定を持つ地物型
-- [データセット][ex-large-data]
-  - 5 万のマス目の色分けと、見えている範囲の点の取り寄せ
-- [100 万の点][ex-columnar-worker]
-  - Worker で読み込む 100 万の点
+- [Snapping and tracing][ex-snapping-and-tracing] と
+  [Geometry operations][ex-geometry-operations]
+  - 吸着、境界のなぞり、結合、交差、差、分割、バッファー
+- [Terrain][ex-terrain]
+  - 3D 地形の上での描画と編集
+- [Read-only viewer][ex-read-only-viewer]
+  - 見るための描画。閲覧専用、操作のロック、クリックした地物の属性
+- [Plugins][ex-plugins]
+  - 独自のモードを持つプラグインと、標準の UI に足すその道具
+- [Custom feature types][ex-custom-feature-types]
+  - 独自の描き方、当たり判定、範囲選択を持つ地物の型
+- [Datasets][ex-datasets]
+  - Overture Maps の東京都心の建物と場所を描画の下と上に。場所は
+    見えている範囲の分を取り寄せる
+- [Columnar data in a Worker][ex-columnar-data-in-a-worker]
+  - 同じ建物を Worker で GeoParquet から読み込み、列のまま描く
+- [Build your own UI][ex-custom-ui]
+  - 標準の UI を使わない、自分の道具のバーとパネル
 
 ## インストール
 
@@ -156,7 +169,7 @@ maplibre-gl (`~6.11.1`) を使います。まだ入っていなければ、npm 7
 import * as maplibregl from 'maplibre-gl';
 import 'maplibre-gl/dist/maplibre-gl.css';
 import workerUrl from 'maplibre-gl/dist/maplibre-gl-worker.mjs?worker&url';
-import { createMapLibreGLDraw } from '@sakuzu/maplibre-gl-draw';
+import { createDraw } from '@sakuzu/maplibre-gl-draw';
 
 // maplibre-gl v6 はページごとに 1 回 worker の URL を要する (これは Vite の例)
 maplibregl.setWorkerUrl(workerUrl);
@@ -168,7 +181,7 @@ const map = new maplibregl.Map({
   zoom: 12,
 });
 
-const draw = createMapLibreGLDraw(map);
+const draw = createDraw(map);
 
 // 自分のボタンで描き始める。クリックで頂点を足し、最初の頂点のクリックか
 // Enter で確定する
@@ -176,19 +189,35 @@ document.querySelector('#polygon')?.addEventListener('click', () => {
   draw.setMode('draw_polygon');
 });
 
-draw.on('draw.feature.create', ({ feature }) => {
-  console.log(feature.id, feature.type, feature.coordinates);
+draw.on('feature.created', ({ feature }) => {
+  console.log(feature.id, feature.type, feature.geometry);
 });
 
-// すべての地物を GeoJSON の FeatureCollection (文字列) で得る
+// すべての地物を GeoJSON の FeatureCollection で得る
 document.querySelector('#save')?.addEventListener('click', () => {
-  const { data } = draw.export('geojson');
-  console.log(data);
+  console.log(JSON.stringify(draw.document.toGeoJSON()));
 });
 ```
 
-ページ全体は [examples/basic/](examples/basic/) にあります。
-[はじめかた](docs/getting-started.ja.md) で順を追って説明しています。
+[はじめかた](docs/getting-started.ja.md) では、このページを順を追って
+作ります。[Get started][ex-get-started] の例は、自分のボタンの代わりに
+標準の UI を地図に重ねます。
+
+## 入口
+
+ほかの入口が要るとき以外は、main の入口から import します。
+
+- `@sakuzu/maplibre-gl-draw` は、描画のインスタンス (`createDraw`)、
+  その地物、レイヤー、グループ、データセット、イベント、設定、拡張の
+  窓口です
+- `@sakuzu/maplibre-gl-draw/geometry` は、地図の要らない図形の計算
+  です。長さや面積を測る、円やバッファーを作る、面を合成して分ける
+  ことができます。Node や Worker でも動きます
+- `@sakuzu/maplibre-gl-draw/table` は、大きな表を Worker で読んで
+  データセットに渡す部品です
+- `@sakuzu/maplibre-gl-draw/webgl` は、独自のシェーダーを書くための
+  部品です。小さい版で変わることがあります。ほかの 3 つはセマンティック
+  バージョニングに従います
 
 ## 動作環境
 
@@ -209,9 +238,10 @@ document.querySelector('#save')?.addEventListener('click', () => {
 ## ドキュメント
 
 [docs/README.ja.md](docs/README.ja.md) に、はじめかた、手引き、
-リファレンス、内部の文書を読む順に並べています。mapbox-gl-draw や
+リファレンス、内部の文書を読む順に並べています。1.0、mapbox-gl-draw、
 terra-draw から移る場合は [移行](docs/guides/migrating.ja.md) を参照して
-ください。
+ください。[API リファレンス][api] のメインのエントリーのページは、
+インスタンスの資源とそれぞれのメソッドの一覧から始まります。
 
 ## 開発に参加する
 
@@ -234,15 +264,18 @@ AGPL が製品に合わない場合は、Kasika, Inc. (可視化技研株式会
 
 [maplibre]: https://maplibre.org/maplibre-gl-js/docs/
 [custom-layer]: https://maplibre.org/maplibre-gl-js/docs/API/interfaces/CustomLayerInterface/
-[demo]: https://sakuzu.github.io/maplibre-gl-draw/
+[demo]: https://sakuzu.github.io/maplibre-gl-draw/playground/
 [api]: https://sakuzu.github.io/maplibre-gl-draw/api/
-[ex-basic]: https://sakuzu.github.io/maplibre-gl-draw/examples/basic/
-[ex-save-load]: https://sakuzu.github.io/maplibre-gl-draw/examples/save-load/
-[ex-style-rules]: https://sakuzu.github.io/maplibre-gl-draw/examples/style-rules/
-[ex-snapping-and-geometry]: https://sakuzu.github.io/maplibre-gl-draw/examples/snapping-and-geometry/
-[ex-terrain]: https://sakuzu.github.io/maplibre-gl-draw/examples/terrain/
-[ex-read-only]: https://sakuzu.github.io/maplibre-gl-draw/examples/read-only/
-[ex-plugin]: https://sakuzu.github.io/maplibre-gl-draw/examples/plugin/
-[ex-custom-feature-type]: https://sakuzu.github.io/maplibre-gl-draw/examples/custom-feature-type/
-[ex-large-data]: https://sakuzu.github.io/maplibre-gl-draw/examples/large-data/
-[ex-columnar-worker]: https://sakuzu.github.io/maplibre-gl-draw/examples/columnar-worker/
+[examples]: https://sakuzu.github.io/maplibre-gl-draw/ja/examples/
+[ex-get-started]: https://sakuzu.github.io/maplibre-gl-draw/ja/examples/get-started.html
+[ex-save-and-load]: https://sakuzu.github.io/maplibre-gl-draw/ja/examples/save-and-load.html
+[ex-style-rules-and-legend]: https://sakuzu.github.io/maplibre-gl-draw/ja/examples/style-rules-and-legend.html
+[ex-snapping-and-tracing]: https://sakuzu.github.io/maplibre-gl-draw/ja/examples/snapping-and-tracing.html
+[ex-geometry-operations]: https://sakuzu.github.io/maplibre-gl-draw/ja/examples/geometry-operations.html
+[ex-terrain]: https://sakuzu.github.io/maplibre-gl-draw/ja/examples/terrain.html
+[ex-read-only-viewer]: https://sakuzu.github.io/maplibre-gl-draw/ja/examples/read-only-viewer.html
+[ex-plugins]: https://sakuzu.github.io/maplibre-gl-draw/ja/examples/plugins.html
+[ex-custom-feature-types]: https://sakuzu.github.io/maplibre-gl-draw/ja/examples/custom-feature-types.html
+[ex-datasets]: https://sakuzu.github.io/maplibre-gl-draw/ja/examples/datasets.html
+[ex-columnar-data-in-a-worker]: https://sakuzu.github.io/maplibre-gl-draw/ja/examples/columnar-data-in-a-worker.html
+[ex-custom-ui]: https://sakuzu.github.io/maplibre-gl-draw/ja/examples/custom-ui.html

package/README.md

@@ -8,7 +8,7 @@ it does on a flat map.
 [Demos][demo] | [Documentation](docs/README.md) | [API reference][api] |
 [日本語](README.ja.md)
 
-![The playground over central Tokyo: overlapping translucent circles, lines from thin to thick, dashed and dotted lines, a polygon with a hole selected with its frame and vertex handles, a multipolygon, circle, square, triangle and star markers, a freehand loop around an image, a faded layer, parcels colored by a categorical rule, a fine hexagon grid colored by a graduated rule, a legend, and the Layers panel showing layers and groups](docs/images/overview.jpg)
+![The playground over central Tokyo: overlapping translucent circles, lines from thin to thick, dashed and dotted lines, areas with a solid, a dashed and a dotted outline, a polygon with a hole selected with its frame and vertex handles, a multipolygon, circle, square, triangle and star markers, a freehand loop around an image, a faded layer, parcels colored by a categorical rule, a fine hexagon grid colored by a graduated rule, the Layers tab listing the layers, the groups and the hexagon dataset (the Legend tab beside it lists both rules), and the inspector of the selected polygon](docs/images/overview.jpg)
 
 ## Features
 
@@ -97,12 +97,15 @@ large file opens. It is styled by the same style rules as drawn
 features, and a click reads its properties
 ([large data](docs/guides/large-data.md)).
 
-### Export and load
+### Save and load
 
-Export in the native format to keep layers, groups, styles and images,
-and load it to get the same state back. Export as GeoJSON to exchange
-features with other tools. The store that holds the features can be
-replaced, and every change is reported as an event
+Write the document in the native format to keep layers, groups, styles
+and images, and load it to get the same state back. Write it as GeoJSON
+to exchange features with other tools: a feature holds a GeoJSON
+geometry and GeoJSON properties, so the file has the shape of the
+features you read in code.
+Every change arrives as one event per transaction, with where it came
+from, and the store that holds the document can be replaced
 ([save and load](docs/guides/save-load.md)).
 
 ### Read-only
@@ -112,8 +115,10 @@ drawing ([read-only](docs/guides/read-only.md)).
 
 ### Extending
 
-Extend it with plugins, custom modes and custom feature types
-([plugins](docs/guides/plugins.md),
+Add plugins, modes of your own, feature types with their own drawing,
+overlays, and providers of snapping candidates and handles. Every kind
+is added the same way and removed with the function that adding
+returns ([plugins](docs/guides/plugins.md),
 [custom types](docs/guides/custom-types.md)).
 
 ## Demos
@@ -121,31 +126,41 @@ Extend it with plugins, custom modes and custom feature types
 Try them in the browser, with nothing to install.
 
 - [Playground][demo]
-  - Every feature in one editor, with layer and property panels
-- [Basic][ex-basic]
-  - Drawing polygons, the change events, saving and restoring
-- [Export and load][ex-save-load]
-  - Export as GeoJSON and in the native format, loading files dropped on
-    the map
-- [Style rules][ex-style-rules]
+  - Every feature in one editor, with the standard UI
+- [Examples][examples]
+  - Twenty examples, each on a page that runs it beside its code
+
+Among the examples:
+
+- [Get started][ex-get-started]
+  - Drawing, selecting and changing features in the panel
+- [Save and load][ex-save-and-load]
+  - GeoJSON and the native format, files dropped on the map, the
+    features a load leaves out
+- [Style rules and legend][ex-style-rules-and-legend]
   - The four kinds of style rule that color features by a property, with
     a legend
-- [Snapping and geometry][ex-snapping-and-geometry]
-  - Snapping, tracing a boundary, moving shared vertices, union,
-    subtract, buffer and split
-- [3D terrain][ex-terrain]
-  - Drawing and selecting on 3D terrain
-- [Read-only][ex-read-only]
-  - The read-only mode, the interaction lock and locked layers
-- [Plugin][ex-plugin]
-  - A plugin with a hook and a mode of its own
-- [Custom feature type][ex-custom-feature-type]
-  - A kind of feature with its own renderer and hit test
-- [Datasets][ex-large-data]
-  - 50,000 cells colored by a property, and points fetched for the part
-    of the map in view
-- [A million points][ex-columnar-worker]
-  - A million points read in a Worker
+- [Snapping and tracing][ex-snapping-and-tracing] and
+  [geometry operations][ex-geometry-operations]
+  - Snapping, tracing a boundary, union, intersection, difference, split
+    and buffer
+- [Terrain][ex-terrain]
+  - Drawing and editing on 3D terrain
+- [Read-only viewer][ex-read-only-viewer]
+  - A drawing to look at: read-only, the interaction lock, the attributes
+    of the feature clicked
+- [Plugins][ex-plugins]
+  - A plugin with a mode of its own, and its tool in the standard UI
+- [Custom feature types][ex-custom-feature-types]
+  - A kind of feature with its own drawing, hit test and box selection
+- [Datasets][ex-datasets]
+  - The buildings and places of central Tokyo from Overture Maps, under
+    and over the drawing, with places fetched for the part in view
+- [Columnar data in a Worker][ex-columnar-data-in-a-worker]
+  - The same buildings read from GeoParquet in a Worker and drawn from
+    their columns
+- [Build your own UI][ex-custom-ui]
+  - A toolbar and a panel of your own, without the standard UI
 
 ## Installation
 
@@ -163,7 +178,7 @@ npm 7 and later install it along.
 import * as maplibregl from 'maplibre-gl';
 import 'maplibre-gl/dist/maplibre-gl.css';
 import workerUrl from 'maplibre-gl/dist/maplibre-gl-worker.mjs?worker&url';
-import { createMapLibreGLDraw } from '@sakuzu/maplibre-gl-draw';
+import { createDraw } from '@sakuzu/maplibre-gl-draw';
 
 // maplibre-gl v6 needs its worker URL once per page (Vite shown here)
 maplibregl.setWorkerUrl(workerUrl);
@@ -175,7 +190,7 @@ const map = new maplibregl.Map({
   zoom: 12,
 });
 
-const draw = createMapLibreGLDraw(map);
+const draw = createDraw(map);
 
 // Your own button starts drawing. Click to add vertices; click the first
 // vertex or press Enter to finish
@@ -183,19 +198,35 @@ document.querySelector('#polygon')?.addEventListener('click', () => {
   draw.setMode('draw_polygon');
 });
 
-draw.on('draw.feature.create', ({ feature }) => {
-  console.log(feature.id, feature.type, feature.coordinates);
+draw.on('feature.created', ({ feature }) => {
+  console.log(feature.id, feature.type, feature.geometry);
 });
 
-// Every feature as a GeoJSON FeatureCollection (a string)
+// Every feature as a GeoJSON FeatureCollection
 document.querySelector('#save')?.addEventListener('click', () => {
-  const { data } = draw.export('geojson');
-  console.log(data);
+  console.log(JSON.stringify(draw.document.toGeoJSON()));
 });
 ```
 
-The complete page is [examples/basic/](examples/basic/), and
-[getting started](docs/getting-started.md) walks through it step by step.
+[Getting started](docs/getting-started.md) builds this page step by
+step, and the [Get started][ex-get-started] example lays the standard UI
+over the map in place of your own buttons.
+
+## Entry points
+
+Import from the main entry unless you need one of the others.
+
+- `@sakuzu/maplibre-gl-draw`: the draw instance (`createDraw`), its
+  features, layers, groups and datasets, the events, the options and the
+  extension contract
+- `@sakuzu/maplibre-gl-draw/geometry`: geometry that needs no map:
+  measure lengths and areas, build circles and buffers, combine and split
+  polygons. It also runs in Node and in Workers
+- `@sakuzu/maplibre-gl-draw/table`: read a large table in a Worker and
+  pass it to a dataset
+- `@sakuzu/maplibre-gl-draw/webgl`: the building blocks for writing your
+  own shaders. It may change in a minor release; the other three follow
+  semantic versioning
 
 ## Compatibility
 
@@ -217,8 +248,10 @@ The complete page is [examples/basic/](examples/basic/), and
 ## Documentation
 
 [docs/README.md](docs/README.md) lists every document in reading order:
-getting started, the guides, the reference and the internals. Coming from
-mapbox-gl-draw or terra-draw? See [migrating](docs/guides/migrating.md).
+getting started, the guides, the reference and the internals. Moving from
+1.0, mapbox-gl-draw or terra-draw? See [migrating](docs/guides/migrating.md).
+The page of the main entry in the [API reference][api] opens with a list
+of the resources of the instance and the methods each one has.
 
 ## Contributing
 
@@ -241,15 +274,18 @@ The notices of the third-party code this package contains are in
 
 [maplibre]: https://maplibre.org/maplibre-gl-js/docs/
 [custom-layer]: https://maplibre.org/maplibre-gl-js/docs/API/interfaces/CustomLayerInterface/
-[demo]: https://sakuzu.github.io/maplibre-gl-draw/
+[demo]: https://sakuzu.github.io/maplibre-gl-draw/playground/
 [api]: https://sakuzu.github.io/maplibre-gl-draw/api/
-[ex-basic]: https://sakuzu.github.io/maplibre-gl-draw/examples/basic/
-[ex-save-load]: https://sakuzu.github.io/maplibre-gl-draw/examples/save-load/
-[ex-style-rules]: https://sakuzu.github.io/maplibre-gl-draw/examples/style-rules/
-[ex-snapping-and-geometry]: https://sakuzu.github.io/maplibre-gl-draw/examples/snapping-and-geometry/
-[ex-terrain]: https://sakuzu.github.io/maplibre-gl-draw/examples/terrain/
-[ex-read-only]: https://sakuzu.github.io/maplibre-gl-draw/examples/read-only/
-[ex-plugin]: https://sakuzu.github.io/maplibre-gl-draw/examples/plugin/
-[ex-custom-feature-type]: https://sakuzu.github.io/maplibre-gl-draw/examples/custom-feature-type/
-[ex-large-data]: https://sakuzu.github.io/maplibre-gl-draw/examples/large-data/
-[ex-columnar-worker]: https://sakuzu.github.io/maplibre-gl-draw/examples/columnar-worker/
+[examples]: https://sakuzu.github.io/maplibre-gl-draw/examples/
+[ex-get-started]: https://sakuzu.github.io/maplibre-gl-draw/examples/get-started.html
+[ex-save-and-load]: https://sakuzu.github.io/maplibre-gl-draw/examples/save-and-load.html
+[ex-style-rules-and-legend]: https://sakuzu.github.io/maplibre-gl-draw/examples/style-rules-and-legend.html
+[ex-snapping-and-tracing]: https://sakuzu.github.io/maplibre-gl-draw/examples/snapping-and-tracing.html
+[ex-geometry-operations]: https://sakuzu.github.io/maplibre-gl-draw/examples/geometry-operations.html
+[ex-terrain]: https://sakuzu.github.io/maplibre-gl-draw/examples/terrain.html
+[ex-read-only-viewer]: https://sakuzu.github.io/maplibre-gl-draw/examples/read-only-viewer.html
+[ex-plugins]: https://sakuzu.github.io/maplibre-gl-draw/examples/plugins.html
+[ex-custom-feature-types]: https://sakuzu.github.io/maplibre-gl-draw/examples/custom-feature-types.html
+[ex-datasets]: https://sakuzu.github.io/maplibre-gl-draw/examples/datasets.html
+[ex-columnar-data-in-a-worker]: https://sakuzu.github.io/maplibre-gl-draw/examples/columnar-data-in-a-worker.html
+[ex-custom-ui]: https://sakuzu.github.io/maplibre-gl-draw/examples/custom-ui.html

package/THIRD_PARTY_NOTICES.md

@@ -273,3 +273,32 @@ OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
 THIS SOFTWARE.
 ```
+
+---
+
+## Sample data of the examples (Overture Maps)
+
+The examples of the repository (`examples/`, not part of the package)
+show buildings and places of central Tokyo from Overture Maps, in
+`examples/public/data/`. `scripts/fetch-overture-sample.mjs` extracts
+them, and `examples/public/data/README.md` records the release, the
+extent, the counts and the sources of the rows.
+
+Attribution: © OpenStreetMap contributors, Overture Maps Foundation.
+
+- The buildings (`tokyo-buildings.geojson` and `tokyo-buildings.parquet`)
+  are a database derived from Overture's buildings theme, under the Open
+  Database License 1.0 (ODbL): <https://opendatacommons.org/licenses/odbl/1-0/>.
+  Its rows come from OpenStreetMap and Microsoft's Global ML Building
+  Footprints (ODbL), and from Qian Shi, et al., A First High-quality
+  Vector Data of Buildings in East Asian Countries Based on a
+  Comprehensive Large-scale Mapping Framework, Zenodo,
+  doi:10.5281/zenodo.8174931 (CC BY 4.0)
+- The places (`tokyo-places.geojson`) come from Overture's places theme,
+  under the Community Data License Agreement Permissive 2.0:
+  <https://cdla.dev/permissive-2-0/>. Rows from Foursquare are under the
+  Apache License 2.0 (Copyright 2024 Foursquare Labs, Inc.), and rows from
+  AllThePlaces under CC0 1.0
+
+The terms of every source are on
+<https://docs.overturemaps.org/attribution/>.