ixmaps-gl 0.2.19 → 0.2.21

package/README.md

@@ -46,7 +46,11 @@ page. It currently implements:
   cell, class breaks and legend from the aggregated cells), dynamic sizing, glow (between
   `glowlower` and `glowupper`),
   multi-point grouping, on-bubble value labels, `NORMALIZE`, chart boxes (`BOX`, `CIRCULARBOX`)
-  with the item title above or below (`TITLE`, `BOTTOMTITLE`), between `boxlower` and `boxupper`
+  with the item title above or below (`TITLE`, `BOTTOMTITLE`), between `boxlower` and `boxupper`.
+  A `CATEGORICAL` `BUBBLE` (also `EXACT`/`AGGREGATE`) is filled and outlined as in flat, each
+  bubble and each part of a grouped one: `fillopacity` (1), outlined in the category color × 0.7
+  or `linecolor` (none with `NOLINES`), `linewidth` (0.1) growing with √radius (`OUTLINE`: up to the
+  normal radius), the outline opaque with `linecolor`/`OUTLINE` or below fillopacity 0.5, else 0.3
 - **CHART\|LABEL** — flat's value label: a rounded box sized by the bubble radius of the size value
   in the item color, with `VALUES` the value in bold; with `TEXTONLY` only the text, over a halo of
   the theme color
@@ -61,6 +65,37 @@ page. It currently implements:
   flat's part sizes, glow and value labels
 - **CHART\|USER** — a page's own chart function (`style.userdraw`: `ixmaps.<name>(SVGDocument, opt)`
   and its `_init`, as flat calls them), drawn in flat's chart units and shown as an icon at flat's size
+- **CHART\|PIE** (and `PIE|DONUT`) — a pie per record (placed on its FEATURE shape by
+  `binding.lookup`), a slice per value field, as flat lays them out: `SIZE` by the size field (or
+  the parts' sum), `SORT`, `SYMMETRIC`/`BIGTOTOP`, `HALF*`, `AUTOCOMPLETE`, `CENTER` (the center
+  part as a disc, `GLOW`), `CENTERVALUE`, `VALUES` (flat's leader-line labels; one part: inside),
+  `THIN`/`XTHIN`/`THICK` donuts. `3D`, `VOLUME`, `STARBURST`, `RAYS`/`FLOWER`, `BOW`, `ZOOM` are
+  noted in the console and drawn as a flat pie. `AGGREGATE` and `CATEGORICAL` (`EXACT`) pies: a pie
+  per position (or aggregation grid cell, `RELOCATE`), a slice per category of the value field
+  (`style.values`; other values count in the pie's size only) or per value field, slices summed
+  (`SUM`, `MAX`/`MIN`, `MEAN`, `FIRST`/`LAST`, `AUTO100`), sized by the summed size field, legend
+  rows summed per category; `GRIDSIZE`, `AUTOSIZE`, `DOPACITY`, the chart box/title and field100
+  arithmetic on them are noted in the console, not ported
+- **CHART\|VECTOR / CHART\|BEZIER** — flow lines from an item's position to its second one
+  (`binding.position2` / `style.lookupfield2`: a key joined to the FEATURE shapes like `position`,
+  or `"lat|lon"` fields), per record or `AGGREGATE`d per origin–destination pair (`SUM`, `MAX`,
+  `MIN`), as flat draws them: BEZIER's curve (`rangescale` bow, `SHORT`, `GAP`, `REVERSE`,
+  `RANDOM`), width by the size (`sizepow`, `normalsizevalue`) or `linewidth`, `POINTER`/`ARROW`
+  heads (`markersize`), `GRADIENT`/`FADEIN`, `DOPACITY`/`DOPACITYMIN`, static `DASH` dashes; colored
+  by `linecolor`, `colorfield` or the `CATEGORICAL`/`EXACT` category; densified, so they follow the
+  globe. `VALUES` text along the curve, `DYNAMICWIDTH`, `LONG` and the dash animation are noted in
+  the console, not drawn
+- **CHART\|BAR** (and `BARS`) — a bar chart per record or, with `AGGREGATE`/`CATEGORICAL`, per
+  item (aggregated as the pies), a bar per value field or category, as flat draws it: width and
+  length by `SIZE` (size field or the values' sum, `sizepow`), `normalsizevalue`, `rangescale`,
+  `COMPRESS`/`EXPAND`; `HORZ` (to the right, the first bar on top), `STACKED` (one column, values on
+  leader lines with their share), `SORT`, `UP`, `CENTER`, `SPACED`, `THIN`/`THICK`, `NOZERO`,
+  `NONEGATIVE`/`ONLYNEGATIVE`, `LEFT`; negative bars; `POINTER`/`ARROW` pointers (sized by the
+  value with `SIZE`, negative ones pointing down in `fadenegative`), `OFFSETMEAN`/`OFFSETMEDIAN`/
+  `DEVIATION`; `VALUES` (beyond the bar or inside it, `valuedecimals`, `units`, `DTEXT`,
+  `VALUEBACKGROUND`/`CTEXT`), `FADEIN`/`FADENEGATIVE`, `fillopacity`/`linecolor`/`linewidth`;
+  `BOX` and `TITLE`. `3D`, `VOLUME`, `COLUMN`, `DOTTED`, `TRENDLINE`, the `XAXIS` labels, `ZOOM` and
+  field100 arithmetic are noted in the console and drawn as plain bars (`SMALLARROW` as `ARROW`)
 - **DOT** — the simplest base symbol (fixed-radius, unclustered points)
 - **PLOT** — a small line/area chart per item over its value fields (flat's per-item PLOT
   geometry: first point at the item, `scale`/`rangescale`, FIXSIZE markers), or one per grid
@@ -76,8 +111,8 @@ page. It currently implements:
   `window.__setFacetFilter`) for building filterable sidebars
 - Globe (orthographic) projection alongside flat Mercator
 
-Not yet implemented: plain (non-AGGREGATE) `CATEGORICAL` choropleths, and the `QUAD`/`BEZIER`/`VECTOR`/
-`PIE`/`DONUT`/`WAFFLE`/`BAR` base types and SYMBOL shape variants beyond
+Not yet implemented: plain (non-AGGREGATE) `CATEGORICAL` choropleths, and the `QUAD`/
+`WAFFLE` base types, and SYMBOL shape variants beyond
 circle/square/diamond/triangle. See the top-of-file comment in
 [`ixmaps-gl.js`](./ixmaps-gl.js) for the exact, currently-accurate scope note.
 
@@ -144,9 +179,17 @@ Zoom numbers in the ixmaps API are ixmaps-flat's, i.e. Leaflet's (256px tiles):
 works on 512px tiles, so ixmaps-gl shows ixmaps zoom *z* at MapLibre zoom *z* − 1 — the
 same area a flat page shows. Map scales (`aggregation`, `valueupper`, `featureupper`/`featurelower`
 and `boxupper`/`boxlower` thresholds, `normalSizeScale`) are computed from the zoom that is
-actually displayed. Code that talks
+actually displayed; the `normalSizeScale` option key is matched in any spelling
+(`normalsizescale`), as flat does. Code that talks
 to the MapLibre map directly (`api.map.getZoom()`, `jumpTo`) sees MapLibre zooms.
 
+Flat's Equal Earth and Winkel world maps (`map: ".../generic/equalearth.svg"`, `winkel.svg`) are
+drawn in Mercator, but framed and scaled as flat shows them: flat fits its Leaflet view's bounds
+into the projected map, so the same zoom shows a different area there (Equal Earth at zoom 2:
+1.55× the Mercator scale). ixmaps-gl converts every API zoom to the MapLibre zoom with the same
+pixels per degree of longitude at the view's center, and back, and sizes dynamically scaled
+symbols (`objectscaling: "dynamic"`) from flat's own map scale for that map file.
+
 ### Theme normalization
 
 Every layer definition passes through one pure function, `normalizeTheme()`, before any
@@ -243,7 +286,7 @@ of your own project files gl can render.
 Load the engine from jsDelivr, pinned to a release tag (or `@main` for the latest commit):
 
 ```html
-<script src="https://cdn.jsdelivr.net/gh/gjrichter/ixmaps-gl@v0.2.19/ixmaps-gl.js"></script>
+<script src="https://cdn.jsdelivr.net/gh/gjrichter/ixmaps-gl@v0.2.21/ixmaps-gl.js"></script>
 ```
 
 or from unpkg, the npm package [`ixmaps-gl`](https://www.npmjs.com/package/ixmaps-gl)
@@ -251,13 +294,13 @@ or from unpkg, the npm package [`ixmaps-gl`](https://www.npmjs.com/package/ixmap
 browser script, which defines the global `ixmaps`):
 
 ```html
-<script src="https://unpkg.com/ixmaps-gl@0.2.19/ixmaps-gl.js"></script>
+<script src="https://unpkg.com/ixmaps-gl@0.2.21/ixmaps-gl.js"></script>
 ```
 
 or use a local copy (`<script src="ixmaps-gl.js"></script>`). A minimal page:
 
 ```html
-<script src="https://cdn.jsdelivr.net/gh/gjrichter/ixmaps-gl@v0.2.19/ixmaps-gl.js"></script>
+<script src="https://cdn.jsdelivr.net/gh/gjrichter/ixmaps-gl@v0.2.21/ixmaps-gl.js"></script>
 <div id="map_div" style="position:absolute;inset:0;"></div>
 
 <script>
@@ -288,7 +331,7 @@ features this engine doesn't implement:
 
 ```text
 [ixmaps-gl validate] error unknown-style-key — layer "points": unknown style key "fillOpacity" — did you mean "fillopacity"?
-[ixmaps-gl validate] warning gl-unsupported — layer "pie": type flag "PIE" is not implemented by ixmaps-gl
+[ixmaps-gl validate] warning gl-unsupported — layer "waffle": type flag "WAFFLE" is not implemented by ixmaps-gl
 ```
 
 It is **off by default** — nothing is fetched and nothing changes. Turn it on with any of: