@drawtonomy/sdk 0.5.0 → 0.7.0

package/dist/exporter/osmParser.js

@@ -0,0 +1,247 @@
+// Lanelet2 OSM (.osm XML) parser.
+//
+// The Lanelet2 format reuses OpenStreetMap's `<node>` / `<way>` / `<relation>`
+// tag structure but with traffic-domain semantics:
+//   - <node>      : a 2D point in lat/lon (optionally with `ele` tag for height)
+//   - <way>       : an ordered list of node refs forming a polyline
+//                   (used for lane boundaries, stop lines, etc.)
+//   - <relation>  : a typed grouping of ways/nodes
+//                   (`type=lanelet` joins a left + right way as a lane;
+//                    `type=regulatory_element` etc. are kept untouched)
+//
+// drawtonomy-emitted files additionally embed `drawtonomy_origin_lat` and
+// `drawtonomy_origin_lon` attributes on the root `<osm>` element so that the
+// canvas page coordinates can be reconstructed exactly on round-trip. Standard
+// OSM consumers ignore unknown attributes, keeping the file compatible.
+//
+// The parser is intentionally hand-written so it works in a plain Node runtime
+// without a DOM. When a global `DOMParser` is available (e.g. in a browser or
+// when jsdom is installed), it is used for robustness; otherwise a regex-based
+// fallback parses the same subset of OSM XML used by Lanelet2.
+function getDomParser() {
+    const g = globalThis;
+    return typeof g.DOMParser === 'function' ? g.DOMParser : null;
+}
+function parseOsmXmlWithDom(xmlString, DOMParserImpl) {
+    const parser = new DOMParserImpl();
+    const doc = parser.parseFromString(xmlString, 'text/xml');
+    const nodes = new Map();
+    const ways = new Map();
+    const relations = [];
+    let drawtonomyOrigin;
+    const osmEl = doc.querySelector('osm');
+    if (osmEl) {
+        const oLat = parseFloat(osmEl.getAttribute('drawtonomy_origin_lat') || '');
+        const oLon = parseFloat(osmEl.getAttribute('drawtonomy_origin_lon') || '');
+        if (Number.isFinite(oLat) && Number.isFinite(oLon)) {
+            drawtonomyOrigin = { lat: oLat, lon: oLon };
+        }
+    }
+    const collectTags = (el) => {
+        const tags = {};
+        el.querySelectorAll(':scope > tag').forEach(tagEl => {
+            const k = tagEl.getAttribute('k') || '';
+            const v = tagEl.getAttribute('v') || '';
+            if (k)
+                tags[k] = v;
+        });
+        return tags;
+    };
+    doc.querySelectorAll('node').forEach(nodeEl => {
+        const id = nodeEl.getAttribute('id') || '';
+        const lat = parseFloat(nodeEl.getAttribute('lat') || '0');
+        const lon = parseFloat(nodeEl.getAttribute('lon') || '0');
+        const tags = collectTags(nodeEl);
+        nodes.set(id, {
+            id,
+            lat,
+            lon,
+            ele: tags.ele !== undefined ? parseFloat(tags.ele) : undefined,
+            tags,
+        });
+    });
+    doc.querySelectorAll('way').forEach(wayEl => {
+        const id = wayEl.getAttribute('id') || '';
+        const nodeRefs = [];
+        wayEl.querySelectorAll(':scope > nd').forEach(ndEl => {
+            const ref = ndEl.getAttribute('ref') || '';
+            if (ref)
+                nodeRefs.push(ref);
+        });
+        ways.set(id, { id, nodeRefs, tags: collectTags(wayEl) });
+    });
+    doc.querySelectorAll('relation').forEach(relEl => {
+        const id = relEl.getAttribute('id') || '';
+        const members = [];
+        relEl.querySelectorAll(':scope > member').forEach(memEl => {
+            members.push({
+                type: memEl.getAttribute('type') || '',
+                ref: memEl.getAttribute('ref') || '',
+                role: memEl.getAttribute('role') || '',
+            });
+        });
+        // Keep all relations (regulatory_element etc.) so they survive a
+        // round-trip; consumers can filter by tag type.
+        relations.push({ id, members, tags: collectTags(relEl) });
+    });
+    return { nodes, ways, relations, drawtonomyOrigin };
+}
+// ---------- Hand-rolled fallback parser (no DOM dependency) ----------
+const ATTR_RE = /([a-zA-Z_][\w:.-]*)\s*=\s*(?:"([^"]*)"|'([^']*)')/g;
+function parseAttributes(attrString) {
+    const attrs = {};
+    ATTR_RE.lastIndex = 0;
+    let m;
+    while ((m = ATTR_RE.exec(attrString)) !== null) {
+        const value = m[2] !== undefined ? m[2] : m[3];
+        attrs[m[1]] = decodeXmlEntities(value);
+    }
+    return attrs;
+}
+function decodeXmlEntities(s) {
+    return s
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'")
+        .replace(/&#(\d+);/g, (_, code) => String.fromCharCode(parseInt(code, 10)))
+        .replace(/&#x([0-9a-fA-F]+);/g, (_, code) => String.fromCharCode(parseInt(code, 16)))
+        .replace(/&amp;/g, '&');
+}
+/**
+ * Minimal XML parser supporting the subset used by Lanelet2 OSM files:
+ * elements, attributes, self-closing tags, and nested elements. XML comments
+ * and CDATA blocks are stripped first. Sufficient for `<node>`/`<way>`/
+ * `<relation>`/`<tag>`/`<nd>`/`<member>`.
+ */
+function parseXmlSubset(xml) {
+    // Strip XML declaration, comments, processing instructions, and CDATA.
+    let src = xml
+        .replace(/<\?[\s\S]*?\?>/g, '')
+        .replace(/<!--[\s\S]*?-->/g, '')
+        .replace(/<!\[CDATA\[[\s\S]*?\]\]>/g, '')
+        .replace(/<!DOCTYPE[\s\S]*?>/g, '');
+    const tagRe = /<\/?\s*([a-zA-Z_][\w:.-]*)((?:[^<>"']|"[^"]*"|'[^']*')*)\/?\s*>/g;
+    const stack = [];
+    let root = null;
+    let m;
+    while ((m = tagRe.exec(src)) !== null) {
+        const fullTag = m[0];
+        const name = m[1];
+        const rest = m[2];
+        const isClosing = fullTag.startsWith('</');
+        const isSelfClosing = fullTag.endsWith('/>');
+        if (isClosing) {
+            // Pop matching element.
+            const top = stack.pop();
+            if (!top || top.name !== name) {
+                // Tolerate slight mismatches by ignoring stray closers.
+                continue;
+            }
+        }
+        else {
+            const el = { name, attrs: parseAttributes(rest), children: [] };
+            const parent = stack[stack.length - 1];
+            if (parent)
+                parent.children.push(el);
+            else
+                root = el;
+            if (!isSelfClosing)
+                stack.push(el);
+        }
+    }
+    return root;
+}
+function findChildren(el, name) {
+    return el.children.filter(c => c.name === name);
+}
+function collectTagsFromChildren(el) {
+    const tags = {};
+    for (const c of findChildren(el, 'tag')) {
+        const k = c.attrs.k;
+        const v = c.attrs.v ?? '';
+        if (k)
+            tags[k] = v;
+    }
+    return tags;
+}
+function parseOsmXmlFallback(xmlString) {
+    const root = parseXmlSubset(xmlString);
+    const nodes = new Map();
+    const ways = new Map();
+    const relations = [];
+    let drawtonomyOrigin;
+    if (!root)
+        return { nodes, ways, relations };
+    const osmRoot = root.name === 'osm' ? root : findChildren(root, 'osm')[0];
+    if (!osmRoot)
+        return { nodes, ways, relations };
+    const oLat = parseFloat(osmRoot.attrs.drawtonomy_origin_lat ?? '');
+    const oLon = parseFloat(osmRoot.attrs.drawtonomy_origin_lon ?? '');
+    if (Number.isFinite(oLat) && Number.isFinite(oLon)) {
+        drawtonomyOrigin = { lat: oLat, lon: oLon };
+    }
+    for (const child of osmRoot.children) {
+        if (child.name === 'node') {
+            const id = child.attrs.id ?? '';
+            const lat = parseFloat(child.attrs.lat ?? '0');
+            const lon = parseFloat(child.attrs.lon ?? '0');
+            const tags = collectTagsFromChildren(child);
+            nodes.set(id, {
+                id,
+                lat,
+                lon,
+                ele: tags.ele !== undefined ? parseFloat(tags.ele) : undefined,
+                tags,
+            });
+        }
+        else if (child.name === 'way') {
+            const id = child.attrs.id ?? '';
+            const nodeRefs = findChildren(child, 'nd').map(c => c.attrs.ref ?? '').filter(r => r.length > 0);
+            ways.set(id, { id, nodeRefs, tags: collectTagsFromChildren(child) });
+        }
+        else if (child.name === 'relation') {
+            const id = child.attrs.id ?? '';
+            const members = findChildren(child, 'member').map(c => ({
+                type: c.attrs.type ?? '',
+                ref: c.attrs.ref ?? '',
+                role: c.attrs.role ?? '',
+            }));
+            relations.push({ id, members, tags: collectTagsFromChildren(child) });
+        }
+    }
+    return { nodes, ways, relations, drawtonomyOrigin };
+}
+/** Parse a Lanelet2 OSM XML string into structured data. */
+export function parseOsmXml(xmlString) {
+    const DOMParserImpl = getDomParser();
+    if (DOMParserImpl) {
+        try {
+            return parseOsmXmlWithDom(xmlString, DOMParserImpl);
+        }
+        catch {
+            // Fall through to the hand-rolled parser.
+        }
+    }
+    return parseOsmXmlFallback(xmlString);
+}
+/**
+ * Project lat/lon onto canvas (page) coordinates using a simple
+ * equirectangular projection centered at (centerLat, centerLon).
+ *
+ * The default scale matches drawtonomy's visual sizing convention: a 3 m wide
+ * lane renders as 50 px (16.67 px/m), so `scale = 16.67 * 111320 ≈ 1,855,000`.
+ */
+export function latLonToCanvas(lat, lon, centerLat, centerLon, scale = 1855000) {
+    const x = (lon - centerLon) * scale * Math.cos((centerLat * Math.PI) / 180);
+    // Page Y axis points down, latitude grows northward (= up), so flip.
+    const y = -(lat - centerLat) * scale;
+    return { x, y };
+}
+/** Inverse of `latLonToCanvas`: page coordinates back to lat/lon. */
+export function canvasToLatLon(x, y, centerLat, centerLon, scale = 1855000) {
+    const lat = centerLat - y / scale;
+    const lon = centerLon + x / (scale * Math.cos((centerLat * Math.PI) / 180));
+    return { lat, lon };
+}
+//# sourceMappingURL=osmParser.js.map

package/dist/exporter/osmParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"osmParser.js","sourceRoot":"","sources":["../../src/exporter/osmParser.ts"],"names":[],"mappings":"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"}

package/dist/exporter/osmToShapes.d.ts

@@ -0,0 +1,107 @@
+import type { ShapeId } from '../types';
+import { type OsmData } from './osmParser';
+/**
+ * ID allocator interface. The default implementation produces predictable
+ * `shape:<kind>_<n>` ids starting from 0; callers (e.g. the editor) can pass
+ * a custom allocator to coordinate IDs with their own counters.
+ */
+export interface ShapeIdAllocator {
+    next(kind: 'point' | 'linestring' | 'lane'): ShapeId;
+}
+/** Default allocator: monotonic counter per shape kind. */
+export declare function createShapeIdAllocator(): ShapeIdAllocator;
+export interface ImportedPoint {
+    id: ShapeId;
+    x: number;
+    y: number;
+    osmId: string;
+}
+export interface ImportedLinestring {
+    id: ShapeId;
+    x: number;
+    y: number;
+    pointIds: string[];
+    osmId: string;
+    attributes: Record<string, string>;
+}
+export interface ImportedLane {
+    id: ShapeId;
+    x: number;
+    y: number;
+    leftBoundaryId: string;
+    rightBoundaryId: string;
+    /**
+     * Whether the boundary's node order should be reversed when interpreted by
+     * the editor. Lanelet2 encodes lane direction via the left boundary's node
+     * order, but a sibling lane in the opposite direction may share the same
+     * boundary read backwards.
+     */
+    invertLeft: boolean;
+    invertRight: boolean;
+    osmId: string;
+    attributes: Record<string, string>;
+    next: string[];
+    prev: string[];
+}
+export interface ImportBounds {
+    minX: number;
+    maxX: number;
+    minY: number;
+    maxY: number;
+    centerX: number;
+    centerY: number;
+    width: number;
+    height: number;
+}
+export interface ImportedShapes {
+    points: ImportedPoint[];
+    linestrings: ImportedLinestring[];
+    lanes: ImportedLane[];
+    bounds: ImportBounds;
+    /**
+     * Geographic center used as the canvas origin during projection. The host
+     * app should call `setMapOrigin(originLatLon)` so that the map background
+     * lines up with the imported lanes at page (0, 0).
+     */
+    originLatLon?: {
+        lat: number;
+        lon: number;
+    };
+}
+export interface OsmToShapesOptions {
+    /** Custom id allocator. A fresh `createShapeIdAllocator()` is used when omitted. */
+    idAllocator?: ShapeIdAllocator;
+    /**
+     * Restrict conversion to the given lanelet relation IDs. When omitted, all
+     * `type=lanelet` relations are converted (regulatory_element etc. are
+     * always skipped here; they are preserved separately via the OSM sidecar).
+     */
+    selectedLaneIds?: readonly string[];
+}
+interface Point2d {
+    x: number;
+    y: number;
+}
+/**
+ * Decide whether to reverse the left and/or right boundary so the lane is
+ * interpreted consistently by the editor.
+ *
+ * In Lanelet2, the way's node order defines the lane direction (the left
+ * boundary's direction is the lane's direction). This routine preserves that
+ * direction whenever possible, only flipping a boundary when needed to keep
+ * the right-of-left invariant.
+ */
+export declare function alignBoundaries(leftPoints: Point2d[], rightPoints: Point2d[]): {
+    invertLeft: boolean;
+    invertRight: boolean;
+};
+/**
+ * Convert parsed OSM data into editor-ready point/linestring/lane records.
+ *
+ * Pass `selectedLaneIds` to restrict to a subset of lanelet relations
+ * (selective import); leave it `undefined` to import every `type=lanelet`
+ * relation.
+ */
+export declare function osmToShapes(osmData: OsmData, options?: OsmToShapesOptions): ImportedShapes;
+export {};
+//# sourceMappingURL=osmToShapes.d.ts.map

package/dist/exporter/osmToShapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"osmToShapes.d.ts","sourceRoot":"","sources":["../../src/exporter/osmToShapes.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,CAAA;CACrD;AAED,2DAA2D;AAC3D,wBAAgB,sBAAsB,IAAI,gBAAgB,CASzD;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAA;IACX,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAA;IACX,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAA;IACX,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB;;;;;OAKG;IACH,UAAU,EAAE,OAAO,CAAA;IACnB,WAAW,EAAE,OAAO,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,IAAI,EAAE,MAAM,EAAE,CAAA;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,WAAW,EAAE,kBAAkB,EAAE,CAAA;IACjC,KAAK,EAAE,YAAY,EAAE,CAAA;IACrB,MAAM,EAAE,YAAY,CAAA;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CAC5C;AAED,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,WAAW,CAAC,EAAE,gBAAgB,CAAA;IAC9B;;;;OAIG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC;AAED,UAAU,OAAO;IACf,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAcD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,OAAO,EAAE,EACrB,WAAW,EAAE,OAAO,EAAE,GACrB;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CA4E/C;AAmFD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,kBAAuB,GAAG,cAAc,CAmM9F"}