@motionscript/geography 0.1.0-alpha.6 → 0.1.0-alpha.8

package/CHANGELOG.md

@@ -1,7 +1,31 @@
 # @motionscript/geography
 
+## 0.1.0-alpha.8
+
+## 0.1.0-alpha.7
+
 ## 0.1.0-alpha.6
 
+### Minor Changes
+
+- 163b708: Node types are components: one spec object handed to `component2d`, `component3d` or `componentAudio`, with no classes, decorators or JSX.
+
+  - **Writing a node type.** A component is one object literal: `key`, `state` (literals and `Types`), `defaults`, `commands`, `children`, `allowedChildren`/`allowedParents`, `provide`, `load`, and its tree's own fields (`measure`, `layout`, `render` for 2D). Behaviour comes from modules you spread in and call: `Paint`, `Flow`, `Shapes`, `Typeface`, `TextLayout`, `Aim`, `Material`, `View3D`. ADR 0007 and the custom-node docs cover it.
+  - **Building nodes in code** uses calls: `Rect({ fill: 'tomato', children: [Text({ text: 'Hi' })] })`, or `new Rect({...})` for the node itself.
+  - **Every built-in and every kit node is a component**, under the same document key. Code that tested `instanceof` a class now uses the component's `.is`, or `instanceof X.node`. Changed members:
+    - `SurfacePlot3d.valueAt` and `FunctionPlot.valueAt` are now the functions `surfaceValueAt` and `curveValue`.
+    - A system's `coordinates` is replaced by `planeMap`/`axesMap`/`systemMap`.
+    - `PieChart.isSelected` is replaced by `isSliceSelected`.
+    - `ItemGrid` is a kit module (`ItemGrid.isGrid`, `ItemGrid.define`), not a base class.
+  - **The sdk no longer exports the class surface:**
+    - the decorators: `node`, `property` and every `*Property`, `command`, `withdraw`, `driveCommand`;
+    - the authoring bases: `PaintNode`, `ShapeNode`, `TextBase`, `Mesh3DBase`, `Canvas3DBase` and the `*Base` geometry classes;
+    - `asCommand`, `compose`, `drive` and `declarePaints` from `@motionscript/sdk/component`;
+    - the `jsx-runtime` and `jsx-dev-runtime` subpaths.
+    - `Node`, `Node2D`, `Node3D` and `NodeAudio` remain as types.
+  - **Editor metadata leaves the engine.** The kits no longer declare `parentKey`, `forkable`, `layout`, `seed`, `within`, `beside` or `closed`; a host keeps those in its own configs. `describe()` now reports `holds`, the trees a type takes children from, and the placement checks use it, so a 2D viewport of your own that takes 3D children places them.
+  - A command called from code with no argument runs, and a refused child is told what its parent takes (`allowedChildren`) or where it goes (`allowedParents`).
+
 ## 0.1.0-alpha.5
 
 ### Patch Changes
@@ -29,16 +53,95 @@
   - `@motionscript/ui` is removed: its `Switch`, `Button`, `Window` and `Cursor` nodes, and the `ControlNode` base class, no longer ship. They are plain nodes over `@motionscript/sdk`, so a project that needs one writes its own and shapes it to taste.
   - `@motionscript/patterns` is new. It holds the pattern nodes (`LineGridPattern`, `DotGridPattern`, `GridPattern`, `ViewportPattern`) that `@motionscript/core` and `@motionscript/sdk` no longer ship.
 
+### Patch Changes
+
+- ad28707: Component kit fixes.
+
+  - Charts: a bar chart maps its columns across the plot panel as laid out (and takes the line chart's top headroom), so a column ends on its marker's grid line. A pie chart's wedges, labels and legend follow `data` and the palette once they are set. A restated value-axis or y/x-axis `range` or `ticks` in `to()` rescales continuously from the axis as drawn, instead of cutting at the midpoint. Without a legend (or without series) the entrance keeps that beat's share, so the call-out and legend land where the slot lays them out. A constant line series gets a scale with width, a `NaN` or infinite cell reads as 0, and tick captions gain decimals when the step is finer than 0.1.
+  - Code: the compiled highlighter is cached per style object, so two styles sharing a name no longer colour alike. A `CodeRanges` chain serialises as its ranges, so a stored `highlight` target selects what it did before it was saved.
+  - LaTeX: seeking from inside a morph to a time before it restores the source formula instead of leaving the last morph frame.
+  - Geo: custom border rings are wound for d3, so a GeoJSON counter-clockwise ring draws as the small region it encloses; a great-circle path between antipodal points runs over the north pole instead of wherever rounding lands.
+  - Audio: bottom-aligned waveform bars stand on the floor of the box instead of hanging from the top.
+  - `Code` and `Latex` take an optional props bag, so `new Registry({ nodes: NODES })` and `createBrowserEngine({ nodes: NODES })` type-check without a cast.
+
+- e818c6e: A `Globe` fades its markers, holds its camera and map to the ranges it advertises, and refuses 3D children. `GeoBorder` documents that `start` and `end` trim the fill too.
+
+  - A marker's `opacity` was parsed and clamped and then only tested against 0; a marker at 0.5 drew fully opaque. It now reaches the material: instance colours carry no alpha, so markers are drawn together per distinct opacity, and a list of opaque markers is still one draw.
+  - `zoom` below 1.02 drew as 1.02, so an `orbitTo` to the advertised minimum of 0.2 appeared to stall. `zoom` is now stored at 1.02 or more and `orbitTo` advertises 1.02. `elevation` is stored within ±89, and `resolution` is advertised as 256 to 2048 and a larger value bakes a 2048-wide map instead of allocating a 16384-wide one.
+  - A 3D node parented to a `Globe`, which was validated and never drawn, is now refused. The inherited viewport settings (`showGrid`, `shadows`, `tone`, `exposure`, `post`) stay listed and stay inert, and the kit README says so.
+  - The kit README states that the `markers` and `arcs` lists are JSON text and snap rather than tween, and that `GeoBorder`'s `start` and `end` trim the fill and overlay as well as the outline.
+
+- 7c07443: `to()` maps a prop's destination once, so a mapper that is not idempotent no longer moves the prop twice as far.
+
+  - A numeric prop behind a mapper was interpolated between stored values and then written through the setter, which ran the mapper on every step again: with `mapper: (v) => v * 2`, `to({ dbl: 10 })` ended at 40 and was at 20 halfway, and a second tween started from the wrong place. A string that snaps at the end was mapped twice the same way. The destination is now mapped once and every step is stored as it is, which is what a prop with a `tween` already did. A clamp behaves as before for any ease that stays between the two ends.
+  - An ease that overshoots (`back`, `elastic`) is no longer held by a mapper alone. A prop that must stay in range says so in its `tween`, as `Globe`'s `elevation` and `zoom` now do, so they still stop at 89° and 1.02 under an overshooting ease.
+
 ## 0.1.0-alpha.3
 
 ### Patch Changes
 
-- 98ea74b: `@motionscript/geo-data` packs from a fresh checkout. `data/` is generated rather than committed, and `prepack` only verified it, so a publish from a clean tree, as the release workflow's is, failed. `prepack` now generates `data/` when it is missing, from the Natural Earth sources `sources.lock.json` pins by tag and sha256, and verifies it either way. A downloaded source is cached only once its checksum matches.
+- 59c9944: A subclass that redeclares a `@property` or a `@command()` its base already declares now overrides it. `getPropertyMeta` and `getCommandMeta` kept the base's declaration and dropped the subclass's, so a redeclared default, mapper, tween or editor option, or a command's `args` and `name`, never took effect. The most-derived declaration of each key now wins, whole, in the position the base gave it, and an inherited key the subclass does not redeclare is kept as declared. `Registry.describe`, a node type's command table and a new instance's values all read that one declaration.
+
+  A bare `Globe` now starts at its own camera and key light (orbit −10, elevation 25, zoom 2.8, ambient 0.55, key 1.9) rather than `Canvas3D`'s (35, 20, 12, 0.45, 2.4), which framed it as a small disc twelve radii away. A bare `Protein` likewise starts at elevation 18, zoom 2.6, ambient 0.55 and key 1.6. `describe("graph3d")` no longer reports `Canvas3D`'s defaults for `orbit`, `elevation` and `zoom`, which a graph derives from `camera.initialPosition`.
 
 ## 0.1.0-alpha.2
 
 ## 0.1.0-alpha.1
 
+### Minor Changes
+
+- 59cecba: Build on `@motionscript/sdk` instead of `@motionscript/core`. The peer dependency is now `@motionscript/sdk`, every import goes through it (and `@motionscript/sdk/component` for the component machinery), and the browser build leaves `@motionscript/sdk` an import, so an import map names it once. A component copied with `ms add` imports the SDK too, and its registry item depends on `@motionscript/sdk` rather than `@motionscript/core`. `@motionscript/charts/kit` re-exports `@motionscript/sdk/component` where it re-exported `@motionscript/core/component`.
+
 ## 0.1.0-alpha.0
 
 Initial release.
+
+## Before the merge
+
+The entries below belong to the data-only `@motionscript/geography` that this package
+absorbed. The kit's own history is above, under its former name `@motionscript/geo`.
+
+### 0.1.0-alpha.7
+
+### 0.1.0-alpha.6
+
+### 0.1.0-alpha.5
+
+#### Patch Changes
+
+- da6f97a: Every package ships a `NOTICE`, and a browser build lists what it bundles.
+
+  - Each tarball carries the repository `NOTICE`: the copyright line and the MIT attributions for the noise functions in `skia-render`'s fractal-noise fill (David Hoskins' "Hash without Sine", Inigo Quilez's 2D simplex noise).
+  - `@motionscript/canvaskit` ships `THIRD_PARTY_NOTICES.txt` with the licences of the libraries compiled into the binary: FreeType, HarfBuzz, ICU 74, zlib, libpng, Brotli, WOFF2, Emscripten and musl.
+  - `dist/browser/manifest.json` gains `thirdParty`, the packages the browser build bundled (`name`, `version`, `license`), and their licence and NOTICE files are written to `dist/browser/THIRD_PARTY_LICENSES.txt`. `@motionscript/browser` bundles mediabunny (MPL-2.0, unmodified; source at https://github.com/Vanilagy/mediabunny), esbuild-wasm and three; `@motionscript/math` bundles MathJax.
+
+- 1778355: The published packages carry what a user needs and say what they are.
+
+  - `@motionscript/code` no longer ships `dist/tests/diff.bench.*`, and `@motionscript/math` no longer ships `dist/tests/harness.*` or `mathjax.setup.*`: test helpers under a `tests` folder are left out of every package's build.
+  - `@motionscript/sdk`'s description no longer repeats core's, and `@motionscript/math`'s names the coordinate systems, plots, 3D graphs and network graphs it has as well as formulas.
+  - The READMEs of `@motionscript/canvaskit`, `@motionscript/charts`, `@motionscript/geo`, `@motionscript/grids`, `@motionscript/skia-render` and `@motionscript/geography` say what to install, and `@motionscript/sdk`'s example now opens the document in an engine and plays it. Links between packages point at the repository, so they work on npm.
+
+### 0.1.0-alpha.4
+
+#### Minor Changes
+
+- 3eefc7e: Package reshuffle.
+
+  - `@motionscript/layout-grid` is now `@motionscript/grids` (`@motionscript/grids/kit`, and `packages/components/grids`), and its `LayoutGrid` base class is `ItemGrid` (`ItemGridProps`, `ITEM_GRID_TYPES`). `RectangularGrid`, `RadialGrid`, `PathGrid` and `SphereGrid` keep their names and document keys. Update the dependency, the imports, and any `@motionscript/layout-grid/kit` specifier a copied component carries.
+  - `@motionscript/geo-data` is now `@motionscript/geography`. The data format on disk (`data/v1/…`) is unchanged, so `@motionscript/geo` reads it as before and a host that serves `@motionscript/geo-data/data` serves `@motionscript/geography/data` the same way.
+  - `@motionscript/ui` is removed: its `Switch`, `Button`, `Window` and `Cursor` nodes, and the `ControlNode` base class, no longer ship. They are plain nodes over `@motionscript/sdk`, so a project that needs one writes its own and shapes it to taste.
+  - `@motionscript/patterns` is new. It holds the pattern nodes (`LineGridPattern`, `DotGridPattern`, `GridPattern`, `ViewportPattern`) that `@motionscript/core` and `@motionscript/sdk` no longer ship.
+
+### 0.1.0-alpha.3
+
+#### Patch Changes
+
+- 98ea74b: `@motionscript/geo-data` packs from a fresh checkout. `data/` is generated rather than committed, and `prepack` only verified it, so a publish from a clean tree, as the release workflow's is, failed. `prepack` now generates `data/` when it is missing, from the Natural Earth sources `sources.lock.json` pins by tag and sha256, and verifies it either way. A downloaded source is cached only once its checksum matches.
+
+### 0.1.0-alpha.2
+
+### 0.1.0-alpha.1
+
+### 0.1.0-alpha.0
+
+Initial release.

package/NOTICE

@@ -4,24 +4,25 @@ Copyright 2026 Motionscript LLC
 This product includes the third-party code below, each part under the MIT
 License reproduced at the end of this file.
 
-- packages/skia-render/src/fills/fractal-noise.ts: `hash2` is "Hash without
-  Sine" by David Hoskins (https://www.shadertoy.com/view/4djSRW).
+- packages/renderer/crates/renderer/src/shaders/prim.wgsl (`fn_hash2`):
+  "Hash without Sine" by David Hoskins (https://www.shadertoy.com/view/4djSRW).
   Copyright (c) 2014 David Hoskins.
 
-- packages/skia-render/src/fills/fractal-noise.ts: `simplexNoise` follows
-  "Noise - simplex - 2D" by Inigo Quilez (https://www.shadertoy.com/view/Msf3WH).
-  Copyright (c) 2013 Inigo Quilez.
+- packages/renderer/crates/renderer/src/shaders/prim.wgsl (`simplex_noise`): "Noise - simplex - 2D" by Inigo Quilez
+  (https://www.shadertoy.com/view/Msf3WH). Copyright (c) 2013 Inigo Quilez.
 
-The project website, which is in the source repository only and in no npm
-package, also includes MIT code: its landing-page background
-(packages/site/components/landing/GradientBackground.tsx) uses 3D simplex
-noise from webgl-noise by Ian McEwan, Ashima Arts
-(https://github.com/ashima/webgl-noise). Copyright (C) 2011 by Ashima Arts.
+- packages/renderer/crates/render3d (in @motionscript/renderer's WebAssembly):
+  its shaders (src/shaders/mesh.wgsl) port three.js r185's mesh programs and
+  src/geometry.rs its primitive generators (https://threejs.org).
+  Copyright (c) 2010-2026 three.js authors.
 
-@motionscript/canvaskit is a build of Skia's CanvasKit (BSD-3-Clause,
-Copyright (c) 2011 Google Inc.) and carries FreeType, HarfBuzz, ICU, zlib,
-libpng, Brotli, WOFF2, Emscripten and musl; their notices are in
-packages/canvaskit/THIRD_PARTY_NOTICES.txt.
+@motionscript/renderer's WebAssembly (dist/ms_renderer_bg.wasm) compiles in
+Rust crates under MIT, Apache-2.0, Zlib and Unicode-3.0 terms (wgpu, naga,
+harfrust, read-fonts, kurbo, wasm-bindgen and others); their notices are in
+packages/renderer/THIRD_PARTY_NOTICES.txt.
+
+MP3 export loads @mediabunny/mp3-encoder (MPL-2.0), a WebAssembly build of
+the LAME MP3 encoder (LGPL, https://lame.sourceforge.io), on first use.
 
 The browser builds under dist/browser/ bundle each package's npm dependencies;
 dist/browser/THIRD_PARTY_LICENSES.txt in each package lists them with their

package/README.md

@@ -1,24 +1,88 @@
 # @motionscript/geography
 
-Country and first-level subdivision outlines for Motion Script's `GeoBorder`
-([`@motionscript/geo`](https://github.com/motionscript-dev/motionscript/tree/main/packages/components/geo)), as small JSON files keyed by ISO 3166
-code. Derived from [Natural Earth](https://www.naturalearthdata.com/) v5.1.2
-(public domain); see `CREDITS.md`.
+Geography for [Motion Script](https://motionscript.dev): `GeoBorder`, country and
+state outlines by ISO 3166 code. Hand `NODES` to the engine through your
+project entry, and a document can name `geoBorder`:
 
-The package has no JavaScript entry point. Its `exports` are `./package.json` and
-`./data/*`, read by path from `node_modules` or served from a static host. The geo
-kit does not depend on it: the two meet only at the file format.
+```ts
+// src/project.ts
+import { NODES } from '@motionscript/geography';
+
+export const nodes = NODES;
+```
+
+`GeoBorder` draws nothing until a data source is registered; see
+[its docs page](https://motionscript.dev/docs/components/geography/geo-border).
+
+This package is written against [`@motionscript/sdk`](https://github.com/motionscript-dev/motionscript/tree/main/packages/sdk), which it
+takes as a peer dependency.
 
 ## Install
 
 ```bash
-npm install @motionscript/geography
+npm install @motionscript/geography @motionscript/sdk
 ```
 
-Or serve `data/` from a static host. Registering it as `GeoBorder`'s data source:
-[motionscript.dev/docs](https://motionscript.dev/docs).
+## GeoBorder
+
+- **`start` and `end` trim the fill and the overlay as well as the outline.**
+  Each path is cut to the part of `[start, end]` that falls inside it, so a
+  filled border drawn on with `end` from 0 to 1 grows as partial polygons, each
+  closed by a straight chord, and a stroke-only one grows as a line. There is no
+  way to trim the stroke alone.
+- **Fill and stroke are separate geometry.** The fill is each kept polygon; the
+  stroke draws each arc once, so a border two selected regions share is stroked
+  once, and `stroke.align` is forced to the centre. `clipSelf` is the layout box,
+  not the outline.
+- **`detail` never refits.** The files store a simplification bucket per point,
+  `detail` is a draw-time threshold over it, and the projection is fitted at full
+  detail and cached apart from it, so tweening `detail` does not move the drawing.
+- **`iso` is a list of codes**, as an array or text split on spaces, commas and
+  semicolons, upper-cased. A code is `AB` or `AB-XYZ`; one that is not, or that no
+  loaded file has, draws nothing and warns once. A bare country code draws the
+  country, or at `level: "state"` its first-level subdivisions (minus `remote`
+  ones when `frame` is `"mainland"`); a subdivision code is always itself.
+- **Drawing never throws.** A node declares each file it needs as the asset
+  `geo:<key>` (gate `render`: layout does not wait for it, but an export loads the
+  files before the frame that needs them); a missing or failed file draws nothing.
+
+### Data sources
+
+The files are this package's own `data/` (see [The data](#the-data)); the kit
+reads them only through their format
+(`v1/index`, `v1/countries/<ISO2>`, `v1/states/<ISO2>`, where `v1/states/US`
+holds every `US-…` unit). The registry is process-wide, shared by every engine,
+session and node:
+
+```ts
+import { geoRegistry, geoUrlSource } from '@motionscript/geography';
+
+geoRegistry.use(geoUrlSource('/geo')); // serves the *contents of* @motionscript/geography/data
+geoRegistry.define({ 'XX-ATLANTIS': { shape: geojsonPolygon, name: 'Atlantis' } });
+```
+
+- **Sources are asked in registration order; the first non-null answer wins.**
+  `null` means "not here" and a throw means "could not tell"; neither is cached
+  for good, and `loadGeoFile` never rejects. `geoUrlSource` treats HTTP 404 and 400
+  as absent. `geoLoaderSource(load)` wraps text, bytes or parsed JSON (for example
+  `fs.readFile`). With no source registered nothing loads and `GeoBorder` draws
+  nothing.
+- **A defined shape wins over every source** and needs none. It is GeoJSON in
+  lon/lat, wound either way round, and is simplified by `detail` like any other.
+- **Decoded files are never freed** while the process lives (`clearGeoFiles`
+  exists for tests), and `geoLoader(key)` returns one function per key, so any
+  number of nodes declare the same loader.
+
+## The data
+
+The package also ships the outlines `GeoBorder` draws: country and first-level
+subdivision outlines keyed by ISO 3166 code, as small JSON files derived from
+[Natural Earth](https://www.naturalearthdata.com/) v5.1.2 (public domain; see
+`CREDITS.md`). They are in `data/` and exported as `./data/*`, read by path from
+`node_modules` or served from a static host. The kit's code does not import
+them.
 
-## The data is generated, never edited
+### The data is generated, never edited
 
 `data/` and `.cache/` are gitignored. `scripts/generate.mjs` removes `data/v1/`
 and writes it whole, from three Natural Earth GeoJSON files pinned in
@@ -37,9 +101,9 @@ node --max-old-space-size=8192 scripts/generate.mjs --update-lock   # re-pin sou
 
 `prepack` (before `npm pack` and `publish`) generates `data/` when it is missing,
 then runs `verify`; the package has no `build`, `lint` or `typecheck`. The geo kit's
-committed fixture is `components/geo/src/border/tests/fixtures/v1/`.
+committed fixture is `components/geography/src/border/tests/fixtures/v1/`.
 
-## Layout and keys
+### Layout and keys
 
 ```
 data/v1/index.json                  every listed region: [code, name, nameNl, parent|null, first 0|1]
@@ -61,7 +125,7 @@ data/v1/states/<prefix>.json        every subdivision whose code starts with <pr
   `remote`, `area` (steradians), `mainland` (polygon indices, or `null` when all),
   `areas` and `polygons` (rings of arc references; `~i` is arc `i` reversed).
 
-## Invariants
+### Invariants
 
 - **One topology.** Every country and subdivision is stitched and quantised
   together (1e6 steps, one `transform` for every file), so a border two regions

package/dist/border/format.d.ts

@@ -0,0 +1,73 @@
+/** The on-disk shape `@motionscript/geography` writes; see its `generate.mjs`. */
+export declare const GEO_DATA_FORMAT = 1;
+export interface GeoFileData {
+    format: number;
+    source?: string;
+    transform: {
+        scale: [number, number];
+        translate: [number, number];
+    };
+    /** Global arc id per local arc — identical across files for a shared border. */
+    arcIds: number[];
+    /** Per arc, flat `[x0, y0, w0, dx, dy, w, …]`: delta-encoded quantized lon/lat and a weight bucket. */
+    arcs: number[][];
+    features: GeoFeatureData[];
+}
+export interface GeoFeatureData {
+    code: string;
+    name: string;
+    nameNl?: string;
+    parent: string | null;
+    first: boolean;
+    listed: boolean;
+    remote?: boolean;
+    area: number;
+    mainland: number[] | null;
+    areas: number[];
+    /** Polygons → rings → arc refs (`~i` is arc `i` reversed). */
+    polygons: number[][][];
+}
+/** `[code, name, nameNl, parent, first]` per listed region. */
+export type GeoIndexEntry = [string, string, string, string | null, 0 | 1];
+export interface GeoIndex {
+    format: number;
+    source?: string;
+    regions: GeoIndexEntry[];
+}
+export interface GeoArc {
+    /** Identity for de-duplicating a border drawn by two regions, across files. */
+    key: number | string;
+    /** Interleaved lon/lat, in degrees. */
+    points: Float64Array;
+    /** Per point: 0 always survives, higher buckets are less significant; see `thresholdBucket`. */
+    buckets: Uint8Array;
+}
+export interface GeoRingRef {
+    arc: GeoArc;
+    reversed: boolean;
+}
+export interface GeoPolygon {
+    rings: GeoRingRef[][];
+    /** Per ring, in steradians — exterior first, then holes. */
+    ringAreas: number[];
+    area: number;
+    mainland: boolean;
+}
+export interface GeoFeature {
+    code: string;
+    name: string;
+    nameNl: string;
+    parent: string | null;
+    first: boolean;
+    listed: boolean;
+    remote: boolean;
+    polygons: GeoPolygon[];
+}
+export interface DecodedGeoFile {
+    features: Map<string, GeoFeature>;
+}
+export declare function ringCoordinates(ring: readonly GeoRingRef[]): [number, number][];
+/** A ring's area in steradians, whichever way it winds. */
+export declare function ringArea(ring: readonly GeoRingRef[]): number;
+export declare function decodeGeoFile(data: GeoFileData): DecodedGeoFile;
+//# sourceMappingURL=format.d.ts.map

package/dist/border/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/border/format.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,eAAO,MAAM,eAAe,IAAI,CAAA;AAEhC,MAAM,WAAW,WAAW;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE;QAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAA;IACnE,gFAAgF;IAChF,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,uGAAuG;IACvG,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;IAChB,QAAQ,EAAE,cAAc,EAAE,CAAA;CAC7B;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IACzB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;CACzB;AAED,+DAA+D;AAC/D,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;AAE1E,MAAM,WAAW,QAAQ;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,aAAa,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,MAAM;IACnB,+EAA+E;IAC/E,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;IACpB,uCAAuC;IACvC,MAAM,EAAE,YAAY,CAAA;IACpB,gGAAgG;IAChG,OAAO,EAAE,UAAU,CAAA;CACtB;AAED,MAAM,WAAW,UAAU;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,UAAU,EAAE,EAAE,CAAA;IACrB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,UAAU,EAAE,CAAA;CACzB;AAED,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CACpC;AAkBD,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAU/E;AAED,2DAA2D;AAC3D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAK5D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,CAiC/D"}

package/dist/border/format.js

@@ -0,0 +1,68 @@
+import { geoArea } from "d3-geo";
+/** The on-disk shape `@motionscript/geography` writes; see its `generate.mjs`. */
+export const GEO_DATA_FORMAT = 1;
+function decodeArc(encoded, key, [kx, ky], [tx, ty]) {
+    const count = encoded.length / 3;
+    const points = new Float64Array(count * 2);
+    const buckets = new Uint8Array(count);
+    let x = 0;
+    let y = 0;
+    for (let i = 0; i < count; i++) {
+        x += encoded[i * 3];
+        y += encoded[i * 3 + 1];
+        points[i * 2] = x * kx + tx;
+        points[i * 2 + 1] = y * ky + ty;
+        buckets[i] = encoded[i * 3 + 2];
+    }
+    return { key, points, buckets };
+}
+export function ringCoordinates(ring) {
+    const out = [];
+    for (const { arc, reversed } of ring) {
+        const n = arc.buckets.length;
+        for (let j = out.length === 0 ? 0 : 1; j < n; j++) {
+            const i = reversed ? n - 1 - j : j;
+            out.push([arc.points[i * 2], arc.points[i * 2 + 1]]);
+        }
+    }
+    return out;
+}
+/** A ring's area in steradians, whichever way it winds. */
+export function ringArea(ring) {
+    const coordinates = ringCoordinates(ring);
+    if (coordinates.length < 4)
+        return 0;
+    const area = geoArea({ type: "Polygon", coordinates: [coordinates] });
+    return area > 2 * Math.PI ? 4 * Math.PI - area : area;
+}
+export function decodeGeoFile(data) {
+    if (data.format !== GEO_DATA_FORMAT) {
+        throw new Error(`geo data format ${data.format} is not supported (expected ${GEO_DATA_FORMAT})`);
+    }
+    const arcs = data.arcs.map((encoded, i) => decodeArc(encoded, data.arcIds[i], data.transform.scale, data.transform.translate));
+    const ref = (index) => index < 0 ? { arc: arcs[~index], reversed: true } : { arc: arcs[index], reversed: false };
+    const features = new Map();
+    for (const f of data.features) {
+        const mainland = f.mainland ? new Set(f.mainland) : null;
+        features.set(f.code, {
+            code: f.code,
+            name: f.name,
+            nameNl: f.nameNl ?? f.name,
+            parent: f.parent,
+            first: f.first,
+            listed: f.listed,
+            remote: f.remote === true,
+            polygons: f.polygons.map((rings, i) => {
+                const resolved = rings.map((ring) => ring.map(ref));
+                return {
+                    rings: resolved,
+                    ringAreas: resolved.map((ring, r) => (r === 0 ? f.areas[i] : ringArea(ring))),
+                    area: f.areas[i],
+                    mainland: mainland === null || mainland.has(i),
+                };
+            }),
+        });
+    }
+    return { features };
+}
+//# sourceMappingURL=format.js.map

package/dist/border/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/border/format.ts"],"names":[],"mappings":"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","sourcesContent":["import { geoArea } from \"d3-geo\"\r\n\r\n/** The on-disk shape `@motionscript/geography` writes; see its `generate.mjs`. */\r\nexport const GEO_DATA_FORMAT = 1\r\n\r\nexport interface GeoFileData {\r\n    format: number\r\n    source?: string\r\n    transform: { scale: [number, number]; translate: [number, number] }\r\n    /** Global arc id per local arc — identical across files for a shared border. */\r\n    arcIds: number[]\r\n    /** Per arc, flat `[x0, y0, w0, dx, dy, w, …]`: delta-encoded quantized lon/lat and a weight bucket. */\r\n    arcs: number[][]\r\n    features: GeoFeatureData[]\r\n}\r\n\r\nexport interface GeoFeatureData {\r\n    code: string\r\n    name: string\r\n    nameNl?: string\r\n    parent: string | null\r\n    first: boolean\r\n    listed: boolean\r\n    remote?: boolean\r\n    area: number\r\n    mainland: number[] | null\r\n    areas: number[]\r\n    /** Polygons → rings → arc refs (`~i` is arc `i` reversed). */\r\n    polygons: number[][][]\r\n}\r\n\r\n/** `[code, name, nameNl, parent, first]` per listed region. */\r\nexport type GeoIndexEntry = [string, string, string, string | null, 0 | 1]\r\n\r\nexport interface GeoIndex {\r\n    format: number\r\n    source?: string\r\n    regions: GeoIndexEntry[]\r\n}\r\n\r\nexport interface GeoArc {\r\n    /** Identity for de-duplicating a border drawn by two regions, across files. */\r\n    key: number | string\r\n    /** Interleaved lon/lat, in degrees. */\r\n    points: Float64Array\r\n    /** Per point: 0 always survives, higher buckets are less significant; see `thresholdBucket`. */\r\n    buckets: Uint8Array\r\n}\r\n\r\nexport interface GeoRingRef {\r\n    arc: GeoArc\r\n    reversed: boolean\r\n}\r\n\r\nexport interface GeoPolygon {\r\n    rings: GeoRingRef[][]\r\n    /** Per ring, in steradians — exterior first, then holes. */\r\n    ringAreas: number[]\r\n    area: number\r\n    mainland: boolean\r\n}\r\n\r\nexport interface GeoFeature {\r\n    code: string\r\n    name: string\r\n    nameNl: string\r\n    parent: string | null\r\n    first: boolean\r\n    listed: boolean\r\n    remote: boolean\r\n    polygons: GeoPolygon[]\r\n}\r\n\r\nexport interface DecodedGeoFile {\r\n    features: Map<string, GeoFeature>\r\n}\r\n\r\nfunction decodeArc(encoded: number[], key: number, [kx, ky]: [number, number], [tx, ty]: [number, number]): GeoArc {\r\n    const count = encoded.length / 3\r\n    const points = new Float64Array(count * 2)\r\n    const buckets = new Uint8Array(count)\r\n    let x = 0\r\n    let y = 0\r\n    for (let i = 0; i < count; i++) {\r\n        x += encoded[i * 3]\r\n        y += encoded[i * 3 + 1]\r\n        points[i * 2] = x * kx + tx\r\n        points[i * 2 + 1] = y * ky + ty\r\n        buckets[i] = encoded[i * 3 + 2]\r\n    }\r\n    return { key, points, buckets }\r\n}\r\n\r\nexport function ringCoordinates(ring: readonly GeoRingRef[]): [number, number][] {\r\n    const out: [number, number][] = []\r\n    for (const { arc, reversed } of ring) {\r\n        const n = arc.buckets.length\r\n        for (let j = out.length === 0 ? 0 : 1; j < n; j++) {\r\n            const i = reversed ? n - 1 - j : j\r\n            out.push([arc.points[i * 2], arc.points[i * 2 + 1]])\r\n        }\r\n    }\r\n    return out\r\n}\r\n\r\n/** A ring's area in steradians, whichever way it winds. */\r\nexport function ringArea(ring: readonly GeoRingRef[]): number {\r\n    const coordinates = ringCoordinates(ring)\r\n    if (coordinates.length < 4) return 0\r\n    const area = geoArea({ type: \"Polygon\", coordinates: [coordinates] })\r\n    return area > 2 * Math.PI ? 4 * Math.PI - area : area\r\n}\r\n\r\nexport function decodeGeoFile(data: GeoFileData): DecodedGeoFile {\r\n    if (data.format !== GEO_DATA_FORMAT) {\r\n        throw new Error(`geo data format ${data.format} is not supported (expected ${GEO_DATA_FORMAT})`)\r\n    }\r\n    const arcs = data.arcs.map((encoded, i) =>\r\n        decodeArc(encoded, data.arcIds[i], data.transform.scale, data.transform.translate)\r\n    )\r\n    const ref = (index: number): GeoRingRef =>\r\n        index < 0 ? { arc: arcs[~index], reversed: true } : { arc: arcs[index], reversed: false }\r\n\r\n    const features = new Map<string, GeoFeature>()\r\n    for (const f of data.features) {\r\n        const mainland = f.mainland ? new Set(f.mainland) : null\r\n        features.set(f.code, {\r\n            code: f.code,\r\n            name: f.name,\r\n            nameNl: f.nameNl ?? f.name,\r\n            parent: f.parent,\r\n            first: f.first,\r\n            listed: f.listed,\r\n            remote: f.remote === true,\r\n            polygons: f.polygons.map((rings, i) => {\r\n                const resolved = rings.map((ring) => ring.map(ref))\r\n                return {\r\n                    rings: resolved,\r\n                    ringAreas: resolved.map((ring, r) => (r === 0 ? f.areas[i] : ringArea(ring))),\r\n                    area: f.areas[i],\r\n                    mainland: mainland === null || mainland.has(i),\r\n                }\r\n            }),\r\n        })\r\n    }\r\n    return { features }\r\n}\r\n"]}

package/dist/border/geo-border.d.ts

@@ -0,0 +1,103 @@
+import { type FillResolved, type NodeOf, type Alignment as _Alignment, type Fill as _Fill, type FlowMode as _FlowMode, type FlowResolved as _FlowResolved, type GapSize as _GapSize, type Node2D as _Node2D, type Node2DProps as _Node2DProps, type Shadow as _Shadow, type Stroke as _Stroke, type Vector2 as _Vector2, type ShadowResolved, type ShapeProps, type StrokeResolved, type Type } from "@motionscript/sdk";
+import { type GeoBorders, type GeoProjectionKind } from "./geometry.js";
+import { type GeoFrame, type GeoLevel } from "./selection.js";
+export interface GeoBorderProps extends ShapeProps {
+    /** ISO 3166-1 alpha-2 (`"FR"`) or ISO 3166-2 (`"US-CA"`) codes. */
+    iso: string | readonly string[];
+    level: GeoLevel;
+    /** 0–1: 1 is full resolution, lower is a more stylised outline. */
+    detail: number;
+    projection: GeoProjectionKind;
+    frame: GeoFrame;
+    borders: GeoBorders;
+}
+/**
+ * Country and subdivision outlines by ISO 3166 code, fitted into the node's box.
+ *
+ *   <GeoBorder iso={["FR", "DE"]} detail={0.4} stroke={{ weight: 2, fill: "white" }} />
+ *
+ * Geometry comes from whatever `geoRegistry` has been given — a URL, a loader,
+ * or shapes defined by hand — and loads as a declared asset, so a frame never
+ * draws half a country. Fill and stroke are separate geometry: the fill is each
+ * region's polygons, the stroke is every border once, which is why a border two
+ * selected regions share is not drawn twice and why `stroke.align` does not
+ * apply.
+ */
+export declare const GeoBorder: import("@motionscript/sdk").Component<"geoBorder", import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    readonly iso: Type<string | readonly string[], string[], false>;
+    readonly level: Type<"country" | "state", "country" | "state", false>;
+    readonly detail: Type<number, number, false>;
+    readonly projection: Type<"conic" | "mercator" | "equirectangular" | "orthographic", "conic" | "mercator" | "equirectangular" | "orthographic", false>;
+    readonly frame: Type<"mainland" | "all", "mainland" | "all", false>;
+    readonly borders: Type<"all" | "outline", "all" | "outline", false>;
+    readonly flow: Type<_FlowMode, _FlowResolved, false>;
+    readonly gap: Type<_GapSize, _GapSize, false>;
+    readonly wrap: boolean;
+    readonly crossGap: Type<number | undefined, number | undefined, false>;
+    readonly columns: Type<number, number, false>;
+    readonly align: import("@motionscript/sdk").Attribute<_Alignment, _Vector2>;
+    readonly fill: import("@motionscript/sdk").Attribute<_Fill, FillResolved[]>;
+    readonly stroke: import("@motionscript/sdk").Attribute<_Stroke, StrokeResolved[]>;
+    readonly shadow: import("@motionscript/sdk").Attribute<_Shadow, ShadowResolved[]>;
+    readonly overlay: import("@motionscript/sdk").Attribute<_Fill, FillResolved[]>;
+    readonly start: Type<number, number, false>;
+    readonly end: Type<number, number, false>;
+}>, {
+    readonly fillTo: readonly ["fill"];
+    readonly strokeTo: readonly ["stroke"];
+    readonly shadowTo: readonly ["shadow"];
+    readonly overlayTo: readonly ["overlay"];
+    readonly progressTo: readonly ["start", "end"];
+    readonly flash: {
+        readonly portion: Type<number, number, false>;
+    };
+}, null, _Node2D<_Node2DProps>, import("@motionscript/sdk").CallProps<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    readonly iso: Type<string | readonly string[], string[], false>;
+    readonly level: Type<"country" | "state", "country" | "state", false>;
+    readonly detail: Type<number, number, false>;
+    readonly projection: Type<"conic" | "mercator" | "equirectangular" | "orthographic", "conic" | "mercator" | "equirectangular" | "orthographic", false>;
+    readonly frame: Type<"mainland" | "all", "mainland" | "all", false>;
+    readonly borders: Type<"all" | "outline", "all" | "outline", false>;
+    readonly flow: Type<_FlowMode, _FlowResolved, false>;
+    readonly gap: Type<_GapSize, _GapSize, false>;
+    readonly wrap: boolean;
+    readonly crossGap: Type<number | undefined, number | undefined, false>;
+    readonly columns: Type<number, number, false>;
+    readonly align: import("@motionscript/sdk").Attribute<_Alignment, _Vector2>;
+    readonly fill: import("@motionscript/sdk").Attribute<_Fill, FillResolved[]>;
+    readonly stroke: import("@motionscript/sdk").Attribute<_Stroke, StrokeResolved[]>;
+    readonly shadow: import("@motionscript/sdk").Attribute<_Shadow, ShadowResolved[]>;
+    readonly overlay: import("@motionscript/sdk").Attribute<_Fill, FillResolved[]>;
+    readonly start: Type<number, number, false>;
+    readonly end: Type<number, number, false>;
+}>, null, import("@motionscript/sdk").BuiltNode<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    readonly iso: Type<string | readonly string[], string[], false>;
+    readonly level: Type<"country" | "state", "country" | "state", false>;
+    readonly detail: Type<number, number, false>;
+    readonly projection: Type<"conic" | "mercator" | "equirectangular" | "orthographic", "conic" | "mercator" | "equirectangular" | "orthographic", false>;
+    readonly frame: Type<"mainland" | "all", "mainland" | "all", false>;
+    readonly borders: Type<"all" | "outline", "all" | "outline", false>;
+    readonly flow: Type<_FlowMode, _FlowResolved, false>;
+    readonly gap: Type<_GapSize, _GapSize, false>;
+    readonly wrap: boolean;
+    readonly crossGap: Type<number | undefined, number | undefined, false>;
+    readonly columns: Type<number, number, false>;
+    readonly align: import("@motionscript/sdk").Attribute<_Alignment, _Vector2>;
+    readonly fill: import("@motionscript/sdk").Attribute<_Fill, FillResolved[]>;
+    readonly stroke: import("@motionscript/sdk").Attribute<_Stroke, StrokeResolved[]>;
+    readonly shadow: import("@motionscript/sdk").Attribute<_Shadow, ShadowResolved[]>;
+    readonly overlay: import("@motionscript/sdk").Attribute<_Fill, FillResolved[]>;
+    readonly start: Type<number, number, false>;
+    readonly end: Type<number, number, false>;
+}>, {
+    readonly fillTo: readonly ["fill"];
+    readonly strokeTo: readonly ["stroke"];
+    readonly shadowTo: readonly ["shadow"];
+    readonly overlayTo: readonly ["overlay"];
+    readonly progressTo: readonly ["start", "end"];
+    readonly flash: {
+        readonly portion: Type<number, number, false>;
+    };
+}, _Node2D<_Node2DProps>>>>;
+export type GeoBorder = NodeOf<typeof GeoBorder>;
+//# sourceMappingURL=geo-border.d.ts.map

package/dist/border/geo-border.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo-border.d.ts","sourceRoot":"","sources":["../../src/border/geo-border.ts"],"names":[],"mappings":"AAAA,OAAO,EAQH,KAAK,YAAY,EACjB,KAAK,MAAM,EAEX,KAAK,SAAS,IAAI,UAAU,EAC5B,KAAK,IAAI,IAAI,KAAK,EAClB,KAAK,QAAQ,IAAI,SAAS,EAC1B,KAAK,YAAY,IAAI,aAAa,EAClC,KAAK,OAAO,IAAI,QAAQ,EACxB,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,WAAW,IAAI,YAAY,EAChC,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,OAAO,IAAI,QAAQ,EAExB,KAAK,cAAc,EACnB,KAAK,UAAU,EAEf,KAAK,cAAc,EACnB,KAAK,IAAI,EACZ,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAAe,KAAK,UAAU,EAAqC,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAGpH,OAAO,EAAgD,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAA;AAExG,MAAM,WAAW,cAAe,SAAQ,UAAU;IAC9C,mEAAmE;IACnE,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;IAC/B,KAAK,EAAE,QAAQ,CAAA;IACf,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,iBAAiB,CAAA;IAC7B,KAAK,EAAE,QAAQ,CAAA;IACf,OAAO,EAAE,UAAU,CAAA;CACtB;AA4ID;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAqEpB,CAAA;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,SAAS,CAAC,CAAA"}