@motionscript/geo 0.0.0-stage → 0.1.0-alpha.3

package/dist/border/geo-border.js

@@ -0,0 +1,234 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Clip, Graphics2D, ShapeNode, node, property, } from "@motionscript/sdk";
+import { snapValue } from "@motionscript/sdk/component";
+import { geoGeometry } from "./geometry.js";
+import { geoDataVersion, geoLoader } from "./loader.js";
+import { geoRegistry } from "./registry.js";
+import { geoFilesFor, normalizeIso, selectGeoFeatures } from "./selection.js";
+// Skia's cost for one path grows faster than its contour count, and a shape
+// drawn as several paths under one paint is unioned every frame — so a region
+// is cut into paths of bounded size, each painted on its own.
+const CONTOURS_PER_PATH = 256;
+const POINTS_PER_PATH = 40_000;
+const coordinate = (value) => String(Math.round(value * 100) / 100);
+function chunk(contours, total, scale) {
+    const chunks = [];
+    let parts = [];
+    let count = 0;
+    let points = 0;
+    let from = 0;
+    let length = 0;
+    const flush = () => {
+        if (count === 0)
+            return;
+        const to = total > 0 ? Math.min(1, length / total) : 1;
+        chunks.push({ data: parts.join(""), from, to });
+        from = to;
+        parts = [];
+        count = 0;
+        points = 0;
+    };
+    for (const contour of contours) {
+        const p = contour.points;
+        // Path data is y-down; the unit geometry is y-up.
+        for (let i = 0; i < p.length; i += 2) {
+            parts.push(i === 0 ? "M" : "L", coordinate(p[i] * scale), " ", coordinate(-p[i + 1] * scale));
+        }
+        if (contour.closed)
+            parts.push("Z");
+        count++;
+        points += p.length / 2;
+        length += contour.length;
+        if (count >= CONTOURS_PER_PATH || points >= POINTS_PER_PATH)
+            flush();
+    }
+    flush();
+    return chunks;
+}
+/**
+ * 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.
+ */
+let GeoBorder = class GeoBorder extends ShapeNode {
+    constructor(props) {
+        super(props);
+    }
+    declareAssets(assets) {
+        super.declareAssets(assets);
+        for (const file of geoFilesFor(this.iso, this.level)) {
+            assets.loader(`geo:${file}`, geoLoader(file), { gate: "render" });
+        }
+    }
+    renderSelf(ctx) {
+        const drawn = this._drawn();
+        const fill = this.fill;
+        if (!drawn || drawn.fills.length === 0)
+            return;
+        const shadow = this.shadow;
+        const g = new Graphics2D();
+        for (const chunk of drawn.fills) {
+            if (!this._pathOp(g, chunk))
+                continue;
+            if (shadow.length > 0)
+                g.shadow(shadow);
+            g.fill(fill);
+        }
+        ctx.draw(g);
+    }
+    renderOverlay(ctx) {
+        const overlay = this.overlay;
+        if (overlay.length === 0)
+            return;
+        const drawn = this._drawn();
+        if (!drawn)
+            return;
+        const g = new Graphics2D();
+        for (const chunk of drawn.fills)
+            if (this._pathOp(g, chunk))
+                g.fill(overlay);
+        ctx.draw(g);
+    }
+    renderStroke(ctx) {
+        const stroke = this.stroke;
+        if (stroke.length === 0)
+            return;
+        const drawn = this._drawn();
+        if (!drawn || drawn.lines.length === 0)
+            return;
+        const centred = stroke.map((layer) => (layer.align === 0 ? layer : { ...layer, align: 0 }));
+        const shadow = this.shadow;
+        const castsShadow = shadow.length > 0 && !this.fill.some((layer) => (layer.opacity ?? 1) > 0);
+        const g = new Graphics2D();
+        for (const chunk of drawn.lines) {
+            if (!this._pathOp(g, chunk))
+                continue;
+            if (castsShadow)
+                g.shadow(shadow);
+            g.stroke(centred);
+        }
+        ctx.draw(g);
+    }
+    // The box, not the outline: a path clip has no winding test, and a country's
+    // bounding box is what the selection shows.
+    clipSelf() {
+        return new Clip().rect({
+            x: 0,
+            y: 0,
+            width: this.layoutBounds.width,
+            height: this.layoutBounds.height,
+        });
+    }
+    _drawnCache = null;
+    _warned = new Set();
+    _pathOp(g, chunk) {
+        const start = this.start;
+        const end = this.end;
+        const width = this.layoutBounds.width;
+        const height = this.layoutBounds.height;
+        const centerBounds = [-width / 2, -height / 2, width / 2, height / 2];
+        if (start <= 0 && end >= 1) {
+            g.path({ data: chunk.data, centerBounds });
+            return true;
+        }
+        const span = chunk.to - chunk.from;
+        if (span <= 0)
+            return false;
+        const localStart = Math.max(0, (start - chunk.from) / span);
+        const localEnd = Math.min(1, (end - chunk.from) / span);
+        if (localEnd <= localStart)
+            return false;
+        g.path({ data: chunk.data, centerBounds, start: localStart, end: localEnd });
+        return true;
+    }
+    _drawn() {
+        const codes = this.iso;
+        const level = this.level;
+        const frame = this.frame;
+        const selection = selectGeoFeatures(codes, level, frame);
+        for (const code of selection.unknown) {
+            if (this._warned.has(code))
+                continue;
+            this._warned.add(code);
+            console.warn(`[GeoBorder] no region with code ${code}`);
+        }
+        if (selection.features.length === 0)
+            return null;
+        const geometry = geoGeometry({
+            selectionKey: `${geoRegistry.generation}:${geoDataVersion()}:${level}:${frame}:${codes.join(",")}`,
+            features: selection.features,
+            frame,
+            projection: this.projection,
+            borders: this.borders,
+            detail: this.detail,
+        });
+        if (!geometry)
+            return null;
+        const width = this.layoutBounds.width;
+        const height = this.layoutBounds.height;
+        const cached = this._drawnCache;
+        if (cached && cached.geometry === geometry && cached.width === width && cached.height === height) {
+            return cached;
+        }
+        const scale = Math.min(width / geometry.width, height / geometry.height);
+        const drawn = {
+            geometry,
+            width,
+            height,
+            fills: chunk(geometry.fills, geometry.fillLength, scale),
+            lines: chunk(geometry.lines, geometry.lineLength, scale),
+        };
+        this._drawnCache = drawn;
+        return drawn;
+    }
+};
+__decorate([
+    property({ default: ["FR"], mapper: normalizeIso, tween: snapValue })
+], GeoBorder.prototype, "iso", void 0);
+__decorate([
+    property({ default: "country", tween: snapValue, options: ["country", "state"] })
+], GeoBorder.prototype, "level", void 0);
+__decorate([
+    property({ default: 0.5, min: 0, max: 1, step: 0.01 })
+], GeoBorder.prototype, "detail", void 0);
+__decorate([
+    property({
+        default: "conic",
+        tween: snapValue,
+        options: ["conic", "mercator", "equirectangular", "orthographic"],
+    })
+], GeoBorder.prototype, "projection", void 0);
+__decorate([
+    property({ default: "mainland", tween: snapValue, options: ["mainland", "all"] })
+], GeoBorder.prototype, "frame", void 0);
+__decorate([
+    property({ default: "all", tween: snapValue, options: ["all", "outline"] })
+], GeoBorder.prototype, "borders", void 0);
+GeoBorder = __decorate([
+    node({
+        key: "geoBorder",
+        parentKey: "shape",
+        forkable: true,
+        layout: {
+            children: "freeform",
+            acceptsChildren: true,
+            defaultWidthMode: "fixed",
+            defaultHeightMode: "fixed",
+        },
+        seed: { width: 480, height: 480 },
+    })
+], GeoBorder);
+export { GeoBorder };
+//# sourceMappingURL=geo-border.js.map

package/dist/border/geo-border.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo-border.js","sourceRoot":"","sources":["../../src/border/geo-border.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    Clip,\n    Graphics2D,\n    ShapeNode,\n    node,\n    property,\n    type AssetScope,\n    type FillResolved,\n    type NodeConfig,\n    type PathBounds,\n    type RenderContext2D,\n    type ShadowResolved,\n    type ShapeProps,\n    type StrokeResolved,\n} from \"@motionscript/sdk\"\nimport { snapValue } from \"@motionscript/sdk/component\"\n\nimport { geoGeometry, type GeoBorders, type GeoContour, type GeoGeometry, type GeoProjectionKind } from \"./geometry\"\nimport { geoDataVersion, geoLoader } from \"./loader\"\nimport { geoRegistry } from \"./registry\"\nimport { geoFilesFor, normalizeIso, selectGeoFeatures, type GeoFrame, type GeoLevel } from \"./selection\"\n\nexport interface GeoBorderProps extends ShapeProps {\n    /** ISO 3166-1 alpha-2 (`\"FR\"`) or ISO 3166-2 (`\"US-CA\"`) codes. */\n    iso: string | readonly string[]\n    level: GeoLevel\n    /** 0–1: 1 is full resolution, lower is a more stylised outline. */\n    detail: number\n    projection: GeoProjectionKind\n    frame: GeoFrame\n    borders: GeoBorders\n}\n\ninterface Chunk {\n    data: string\n    /** Where this chunk's contours sit along the whole drawing, as fractions of its length. */\n    from: number\n    to: number\n}\n\ninterface Drawn {\n    geometry: GeoGeometry\n    width: number\n    height: number\n    fills: Chunk[]\n    lines: Chunk[]\n}\n\n// Skia's cost for one path grows faster than its contour count, and a shape\n// drawn as several paths under one paint is unioned every frame — so a region\n// is cut into paths of bounded size, each painted on its own.\nconst CONTOURS_PER_PATH = 256\nconst POINTS_PER_PATH = 40_000\n\nconst coordinate = (value: number) => String(Math.round(value * 100) / 100)\n\nfunction chunk(contours: readonly GeoContour[], total: number, scale: number): Chunk[] {\n    const chunks: Chunk[] = []\n    let parts: string[] = []\n    let count = 0\n    let points = 0\n    let from = 0\n    let length = 0\n    const flush = () => {\n        if (count === 0) return\n        const to = total > 0 ? Math.min(1, length / total) : 1\n        chunks.push({ data: parts.join(\"\"), from, to })\n        from = to\n        parts = []\n        count = 0\n        points = 0\n    }\n    for (const contour of contours) {\n        const p = contour.points\n        // Path data is y-down; the unit geometry is y-up.\n        for (let i = 0; i < p.length; i += 2) {\n            parts.push(i === 0 ? \"M\" : \"L\", coordinate(p[i] * scale), \" \", coordinate(-p[i + 1] * scale))\n        }\n        if (contour.closed) parts.push(\"Z\")\n        count++\n        points += p.length / 2\n        length += contour.length\n        if (count >= CONTOURS_PER_PATH || points >= POINTS_PER_PATH) flush()\n    }\n    flush()\n    return chunks\n}\n\n/**\n * Country and subdivision outlines by ISO 3166 code, fitted into the node's box.\n *\n *   <GeoBorder iso={[\"FR\", \"DE\"]} detail={0.4} stroke={{ weight: 2, fill: \"white\" }} />\n *\n * Geometry comes from whatever `geoRegistry` has been given — a URL, a loader,\n * or shapes defined by hand — and loads as a declared asset, so a frame never\n * draws half a country. Fill and stroke are separate geometry: the fill is each\n * region's polygons, the stroke is every border once, which is why a border two\n * selected regions share is not drawn twice and why `stroke.align` does not\n * apply.\n */\n@node({\n    key: \"geoBorder\",\n    parentKey: \"shape\",\n    forkable: true,\n    layout: {\n        children: \"freeform\",\n        acceptsChildren: true,\n        defaultWidthMode: \"fixed\",\n        defaultHeightMode: \"fixed\",\n    },\n    seed: { width: 480, height: 480 },\n})\nexport class GeoBorder extends ShapeNode<GeoBorderProps> {\n    @property({ default: [\"FR\"], mapper: normalizeIso, tween: snapValue })\n    declare iso: string | readonly string[]\n\n    @property({ default: \"country\", tween: snapValue, options: [\"country\", \"state\"] })\n    declare level: GeoLevel\n\n    @property({ default: 0.5, min: 0, max: 1, step: 0.01 })\n    declare detail: number\n\n    @property({\n        default: \"conic\",\n        tween: snapValue,\n        options: [\"conic\", \"mercator\", \"equirectangular\", \"orthographic\"],\n    })\n    declare projection: GeoProjectionKind\n\n    @property({ default: \"mainland\", tween: snapValue, options: [\"mainland\", \"all\"] })\n    declare frame: GeoFrame\n\n    @property({ default: \"all\", tween: snapValue, options: [\"all\", \"outline\"] })\n    declare borders: GeoBorders\n\n    constructor(props?: NodeConfig<GeoBorder, GeoBorderProps>) {\n        super(props as NodeConfig<ShapeNode<GeoBorderProps>, GeoBorderProps>)\n    }\n\n    override declareAssets(assets: AssetScope): void {\n        super.declareAssets(assets)\n        for (const file of geoFilesFor(this.iso as string[], this.level)) {\n            assets.loader(`geo:${file}`, geoLoader(file), { gate: \"render\" })\n        }\n    }\n\n    protected override renderSelf(ctx: RenderContext2D): void {\n        const drawn = this._drawn()\n        const fill = this.fill as FillResolved[]\n        if (!drawn || drawn.fills.length === 0) return\n        const shadow = this.shadow as ShadowResolved[]\n        const g = new Graphics2D()\n        for (const chunk of drawn.fills) {\n            if (!this._pathOp(g, chunk)) continue\n            if (shadow.length > 0) g.shadow(shadow)\n            g.fill(fill)\n        }\n        ctx.draw(g)\n    }\n\n    protected override renderOverlay(ctx: RenderContext2D): void {\n        const overlay = this.overlay as FillResolved[]\n        if (overlay.length === 0) return\n        const drawn = this._drawn()\n        if (!drawn) return\n        const g = new Graphics2D()\n        for (const chunk of drawn.fills) if (this._pathOp(g, chunk)) g.fill(overlay)\n        ctx.draw(g)\n    }\n\n    protected override renderStroke(ctx: RenderContext2D): void {\n        const stroke = this.stroke as StrokeResolved[]\n        if (stroke.length === 0) return\n        const drawn = this._drawn()\n        if (!drawn || drawn.lines.length === 0) return\n        const centred = stroke.map((layer) => (layer.align === 0 ? layer : { ...layer, align: 0 }))\n        const shadow = this.shadow as ShadowResolved[]\n        const castsShadow = shadow.length > 0 && !(this.fill as FillResolved[]).some((layer) => (layer.opacity ?? 1) > 0)\n        const g = new Graphics2D()\n        for (const chunk of drawn.lines) {\n            if (!this._pathOp(g, chunk)) continue\n            if (castsShadow) g.shadow(shadow)\n            g.stroke(centred)\n        }\n        ctx.draw(g)\n    }\n\n    // The box, not the outline: a path clip has no winding test, and a country's\n    // bounding box is what the selection shows.\n    protected override clipSelf(): Clip {\n        return new Clip().rect({\n            x: 0,\n            y: 0,\n            width: this.layoutBounds.width,\n            height: this.layoutBounds.height,\n        })\n    }\n\n    private _drawnCache: Drawn | null = null\n    private readonly _warned = new Set<string>()\n\n    private _pathOp(g: Graphics2D, chunk: Chunk): boolean {\n        const start = this.start\n        const end = this.end\n        const width = this.layoutBounds.width\n        const height = this.layoutBounds.height\n        const centerBounds: PathBounds = [-width / 2, -height / 2, width / 2, height / 2]\n        if (start <= 0 && end >= 1) {\n            g.path({ data: chunk.data, centerBounds })\n            return true\n        }\n        const span = chunk.to - chunk.from\n        if (span <= 0) return false\n        const localStart = Math.max(0, (start - chunk.from) / span)\n        const localEnd = Math.min(1, (end - chunk.from) / span)\n        if (localEnd <= localStart) return false\n        g.path({ data: chunk.data, centerBounds, start: localStart, end: localEnd })\n        return true\n    }\n\n    private _drawn(): Drawn | null {\n        const codes = this.iso as string[]\n        const level = this.level\n        const frame = this.frame\n        const selection = selectGeoFeatures(codes, level, frame)\n        for (const code of selection.unknown) {\n            if (this._warned.has(code)) continue\n            this._warned.add(code)\n            console.warn(`[GeoBorder] no region with code ${code}`)\n        }\n        if (selection.features.length === 0) return null\n\n        const geometry = geoGeometry({\n            selectionKey: `${geoRegistry.generation}:${geoDataVersion()}:${level}:${frame}:${codes.join(\",\")}`,\n            features: selection.features,\n            frame,\n            projection: this.projection,\n            borders: this.borders,\n            detail: this.detail,\n        })\n        if (!geometry) return null\n\n        const width = this.layoutBounds.width\n        const height = this.layoutBounds.height\n        const cached = this._drawnCache\n        if (cached && cached.geometry === geometry && cached.width === width && cached.height === height) {\n            return cached\n        }\n        const scale = Math.min(width / geometry.width, height / geometry.height)\n        const drawn: Drawn = {\n            geometry,\n            width,\n            height,\n            fills: chunk(geometry.fills, geometry.fillLength, scale),\n            lines: chunk(geometry.lines, geometry.lineLength, scale),\n        }\n        this._drawnCache = drawn\n        return drawn\n    }\n}\n"]}

package/dist/border/geometry.d.ts

@@ -0,0 +1,40 @@
+import { type GeoFeature } from "./format.js";
+import type { GeoFrame } from "./selection.js";
+export type GeoProjectionKind = "conic" | "mercator" | "equirectangular" | "orthographic";
+export type GeoBorders = "all" | "outline";
+export interface GeoContour {
+    /** Interleaved x/y in unit space: the longer side spans 1, centred on the origin, y up. */
+    points: Float32Array;
+    closed: boolean;
+    length: number;
+}
+export interface GeoGeometry {
+    /** The drawing's extent in unit space; the longer of the two is 1. */
+    width: number;
+    height: number;
+    fills: GeoContour[];
+    lines: GeoContour[];
+    fillLength: number;
+    lineLength: number;
+    bytes: number;
+}
+/** The highest weight bucket a point may carry and still be drawn. */
+export declare function pointBucketLimit(detail: number, area: number): number;
+/** Rings smaller than this (steradians) are dropped, bar each region's largest. */
+export declare function polygonAreaLimit(detail: number, area: number): number;
+export interface GeoGeometryRequest {
+    /** Identifies `features` and `frame`: equal keys must mean equal selections. */
+    selectionKey: string;
+    features: readonly GeoFeature[];
+    frame: GeoFrame;
+    projection: GeoProjectionKind;
+    borders: GeoBorders;
+    detail: number;
+}
+/**
+ * The drawing for a selection, cached. The projection is fitted to the
+ * selection at full detail, so a `detail` tween never moves or rescales it.
+ */
+export declare function geoGeometry(request: GeoGeometryRequest): GeoGeometry | null;
+export declare function clearGeoGeometry(): void;
+//# sourceMappingURL=geometry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/border/geometry.ts"],"names":[],"mappings":"AAaA,OAAO,EAAgC,KAAK,UAAU,EAAoC,MAAM,UAAU,CAAA;AAC1G,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,UAAU,GAAG,iBAAiB,GAAG,cAAc,CAAA;AACzF,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,SAAS,CAAA;AAE1C,MAAM,WAAW,UAAU;IACvB,2FAA2F;IAC3F,MAAM,EAAE,YAAY,CAAA;IACpB,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,WAAW;IACxB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CAChB;AA6BD,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrE;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGrE;AA+VD,MAAM,WAAW,kBAAkB;IAC/B,gFAAgF;IAChF,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAA;IAC/B,KAAK,EAAE,QAAQ,CAAA;IACf,UAAU,EAAE,iBAAiB,CAAA;IAC7B,OAAO,EAAE,UAAU,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,GAAG,IAAI,CAiB3E;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}