@drawtonomy/sdk 0.5.0 → 0.6.0

package/README.md

@@ -120,6 +120,12 @@ http://localhost:3000/?ext=http://localhost:3001/manifest.json
 | `getBoundingBox(points)` | Get bounding box |
 | `distanceToSegment(point, a, b)` | Point-to-segment distance |
 
+### Snapshot
+
+| Function | Description |
+|----------|-------------|
+| `parseDrawtonomySvg(svg)` | Read a `.drawtonomy.svg` source string and return the embedded `DrawtonomySnapshot`, or `null` if absent / malformed |
+
 ### Exporter Module
 
 Convert a `DrawtonomySnapshot` into target-format strings (OpenDRIVE,

package/dist/index.d.ts

@@ -2,5 +2,6 @@ export * from './types';
 export * from './helpers';
 export * from './geometry';
 export { ExtensionClient } from './ExtensionClient';
+export { parseDrawtonomySvg } from './snapshot';
 export * as exporter from './exporter';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEnD,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAE/C,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -3,6 +3,7 @@ export * from './types';
 export * from './helpers';
 export * from './geometry';
 export { ExtensionClient } from './ExtensionClient';
+export { parseDrawtonomySvg } from './snapshot';
 // Exporter sub-module is also available via "@drawtonomy/sdk/exporter".
 export * as exporter from './exporter';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,wEAAwE;AACxE,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC/C,wEAAwE;AACxE,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAA"}

package/dist/snapshot.d.ts

@@ -0,0 +1,9 @@
+import type { DrawtonomySnapshot } from './types';
+/**
+ * Parse a `.drawtonomy.svg` source string and return the embedded
+ * DrawtonomySnapshot. Returns `null` if the file is not a drawtonomy SVG
+ * (e.g. plain SVG without an embedded snapshot) or the embedded payload is
+ * malformed.
+ */
+export declare function parseDrawtonomySvg(svgContent: string): DrawtonomySnapshot | null;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAkCjD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAgBhF"}

package/dist/snapshot.js

@@ -0,0 +1,60 @@
+// Parse a `.drawtonomy.svg` file (a regular SVG with a base64-encoded
+// snapshot embedded in `data-drawtonomy-snapshot`) back into a
+// DrawtonomySnapshot. The legacy attribute name `data-drawauto-snapshot`
+// is also accepted for backwards compatibility.
+/**
+ * Decode a base64-encoded UTF-8 string. Mirrors the encoder used when the
+ * editor produces .drawtonomy.svg files: `btoa(unescape(encodeURIComponent(json)))`.
+ */
+function base64DecodeUtf8(encoded) {
+    if (typeof atob === 'function') {
+        return decodeURIComponent(escape(atob(encoded)));
+    }
+    // Node fallback (Buffer is global in Node 18+).
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const buf = globalThis.Buffer;
+    if (buf) {
+        return buf.from(encoded, 'base64').toString('utf-8');
+    }
+    throw new Error('No base64 decoder available in this environment');
+}
+/**
+ * Extract the value of an attribute from the root `<svg>` element of an SVG
+ * source string. Used instead of DOMParser so the parser works in plain
+ * Node without jsdom.
+ */
+function extractRootSvgAttribute(svg, attrName) {
+    // Match the opening <svg ...> tag (allow line breaks inside).
+    const openTagMatch = svg.match(/<svg\b[^>]*>/);
+    if (!openTagMatch)
+        return null;
+    const openTag = openTagMatch[0];
+    const attrRegex = new RegExp(`\\b${attrName}="([^"]*)"`);
+    const m = openTag.match(attrRegex);
+    return m ? m[1] : null;
+}
+/**
+ * Parse a `.drawtonomy.svg` source string and return the embedded
+ * DrawtonomySnapshot. Returns `null` if the file is not a drawtonomy SVG
+ * (e.g. plain SVG without an embedded snapshot) or the embedded payload is
+ * malformed.
+ */
+export function parseDrawtonomySvg(svgContent) {
+    if (!svgContent || typeof svgContent !== 'string')
+        return null;
+    const encoded = extractRootSvgAttribute(svgContent, 'data-drawtonomy-snapshot') ??
+        extractRootSvgAttribute(svgContent, 'data-drawauto-snapshot');
+    if (!encoded)
+        return null;
+    try {
+        const jsonString = base64DecodeUtf8(encoded);
+        const parsed = JSON.parse(jsonString);
+        if (!parsed || !Array.isArray(parsed.shapes))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,+DAA+D;AAC/D,yEAAyE;AACzE,gDAAgD;AAIhD;;;GAGG;AACH,SAAS,gBAAgB,CAAC,OAAe;IACvC,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IAClD,CAAC;IACD,gDAAgD;IAChD,8DAA8D;IAC9D,MAAM,GAAG,GAAI,UAAkB,CAAC,MAAM,CAAA;IACtC,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IACtD,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;AACpE,CAAC;AAED;;;;GAIG;AACH,SAAS,uBAAuB,CAAC,GAAW,EAAE,QAAgB;IAC5D,8DAA8D;IAC9D,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;IAC9C,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAA;IAC9B,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAA;IAC/B,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,MAAM,QAAQ,YAAY,CAAC,CAAA;IACxD,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAClC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACxB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAE9D,MAAM,OAAO,GACX,uBAAuB,CAAC,UAAU,EAAE,0BAA0B,CAAC;QAC/D,uBAAuB,CAAC,UAAU,EAAE,wBAAwB,CAAC,CAAA;IAC/D,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAA;IAEzB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAA;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAuB,CAAA;QAC3D,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAA;QACzD,OAAO,MAAM,CAAA;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drawtonomy/sdk",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "SDK for building drawtonomy extensions",
   "type": "module",
   "main": "./dist/index.js",