kymostudio 0.1.0 → 0.2.0

package/dist/xml.js

@@ -0,0 +1,116 @@
+/**
+ * Minimal, dependency-free XML reader — just enough to walk a BPMN 2.0
+ * document. Produces a tree of {@link XmlEl} nodes with namespace prefixes
+ * stripped (so `bpmn:task` and `bpmn2:task` both read as `task`). Handles
+ * comments, CDATA, processing instructions / the XML declaration, doctype,
+ * self-closing tags, single/double-quoted attributes, and the standard +
+ * numeric entity references. It is a reader, not a validator.
+ */
+const local = (name) => {
+    const c = name.indexOf(":");
+    return c >= 0 ? name.slice(c + 1) : name;
+};
+function decode(s) {
+    if (s.indexOf("&") < 0)
+        return s;
+    return s.replace(/&(#x?[0-9a-fA-F]+|\w+);/g, (m, body) => {
+        if (body[0] === "#") {
+            const code = body[1] === "x" || body[1] === "X"
+                ? parseInt(body.slice(2), 16)
+                : parseInt(body.slice(1), 10);
+            return Number.isFinite(code) ? String.fromCodePoint(code) : m;
+        }
+        return { amp: "&", lt: "<", gt: ">", quot: '"', apos: "'" }[body] ?? m;
+    });
+}
+const ATTR_RE = /([\w:.-]+)\s*=\s*("([^"]*)"|'([^']*)')/g;
+function parseTag(body) {
+    const nameMatch = /^\s*([\w:.-]+)/.exec(body);
+    const name = nameMatch ? nameMatch[1] : "";
+    const attrs = {};
+    let m;
+    ATTR_RE.lastIndex = nameMatch ? nameMatch[0].length : 0;
+    while ((m = ATTR_RE.exec(body)) !== null) {
+        attrs[local(m[1])] = decode(m[3] !== undefined ? m[3] : m[4]);
+    }
+    return { name, attrs };
+}
+/** Index of the closing `>` of a tag starting at `start`, respecting quotes. */
+function tagEnd(src, start) {
+    let q = "";
+    for (let i = start; i < src.length; i++) {
+        const ch = src[i];
+        if (q) {
+            if (ch === q)
+                q = "";
+        }
+        else if (ch === '"' || ch === "'")
+            q = ch;
+        else if (ch === ">")
+            return i;
+    }
+    return src.length;
+}
+/** Parse `src` and return its root element. */
+export function parseXml(src) {
+    const root = { tag: "#root", attrs: {}, children: [], text: "" };
+    const stack = [root];
+    const top = () => stack[stack.length - 1];
+    const n = src.length;
+    let i = 0;
+    while (i < n) {
+        const lt = src.indexOf("<", i);
+        if (lt < 0)
+            break;
+        if (lt > i) {
+            const t = decode(src.slice(i, lt));
+            if (t.trim())
+                top().text += t;
+        }
+        if (src.startsWith("<!--", lt)) {
+            const e = src.indexOf("-->", lt + 4);
+            i = e < 0 ? n : e + 3;
+            continue;
+        }
+        if (src.startsWith("<![CDATA[", lt)) {
+            const e = src.indexOf("]]>", lt + 9);
+            top().text += src.slice(lt + 9, e < 0 ? n : e);
+            i = e < 0 ? n : e + 3;
+            continue;
+        }
+        if (src.startsWith("<?", lt)) {
+            const e = src.indexOf("?>", lt + 2);
+            i = e < 0 ? n : e + 2;
+            continue;
+        }
+        if (src.startsWith("<!", lt)) {
+            const e = tagEnd(src, lt + 2);
+            i = e + 1;
+            continue;
+        }
+        if (src.startsWith("</", lt)) {
+            const e = src.indexOf(">", lt + 2);
+            if (stack.length > 1)
+                stack.pop();
+            i = e < 0 ? n : e + 1;
+            continue;
+        }
+        const e = tagEnd(src, lt + 1);
+        const inner = src.slice(lt + 1, e);
+        const selfClose = inner.endsWith("/");
+        const { name, attrs } = parseTag(selfClose ? inner.slice(0, -1) : inner);
+        const el = { tag: local(name), attrs, children: [], text: "" };
+        top().children.push(el);
+        if (!selfClose)
+            stack.push(el);
+        i = e + 1;
+    }
+    return root.children[0] ?? root;
+}
+/** Depth-first (document order) iterator over `el` and all descendants. */
+export function* iterAll(el) {
+    yield el;
+    for (const c of el.children)
+        yield* iterAll(c);
+}
+//# sourceMappingURL=xml.js.map

package/dist/xml.js.map

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

package/package.json

@@ -1,30 +1,48 @@
 {
   "name": "kymostudio",
-  "version": "0.1.0",
-  "description": "Diagram-as-code DSL — browser/Node port (data model + icon library) mirroring the Python source-of-truth at src/python/kymo/",
+  "version": "0.2.0",
+  "description": "Diagram-as-code for browser/Node — data model, icon library, SVG renderer, and BPMN 2.0 importer. Independent, dependency-free TypeScript implementation.",
   "type": "module",
   "license": "Apache-2.0",
   "author": "rain1024",
-  "keywords": ["diagram", "diagram-as-code", "svg", "architecture", "icons"],
-  "homepage": "https://github.com/rain1024/kymo#readme",
+  "keywords": [
+    "diagram",
+    "diagram-as-code",
+    "svg",
+    "architecture",
+    "icons"
+  ],
+  "homepage": "https://github.com/kymostudio/kymostudio#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/rain1024/kymo.git"
+    "url": "git+https://github.com/kymostudio/kymostudio.git",
+    "directory": "packages/js"
   },
   "bugs": {
-    "url": "https://github.com/rain1024/kymo/issues"
+    "url": "https://github.com/kymostudio/kymostudio/issues"
   },
-  "main": "src/js/index.js",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "exports": {
-    ".": "./src/js/index.js",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
     "./icons-manifest.json": "./icons-manifest.json"
   },
   "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
     "build-manifest": "node scripts/build-manifest.mjs",
-    "test": "node --test tests/js/"
+    "prepack": "npm run build",
+    "test": "npm run build && node --test"
   },
   "files": [
-    "src/js/",
+    "dist/",
     "icons-manifest.json"
-  ]
+  ],
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "typescript": "^6.0.3"
+  }
 }

package/src/js/icons-loader.js

@@ -1,91 +0,0 @@
-/**
- * Icon loader — JS mirror of `src/icons.py:get_icon`.
- *
- * Built-in glyphs (from `icons-builtin.js`) are returned synchronously
- * wrapped in `Promise.resolve()`. File-backed PNG icons are resolved
- * lazily: on first request the manifest is fetched, then the PNG bytes
- * are fetched and embedded as a base64 `<image>` tag inside an SVG
- * fragment. Subsequent lookups are cache hits.
- *
- * Configure the base URL with `setIconBaseURL(url)` before the first
- * call — defaults to `""` (paths are relative to the page).
- */
-import { ICONS } from "./icons-builtin.js";
-
-const IMAGE_SIZE = 64;
-const _cache = new Map(Object.entries(ICONS));   // builtin keys start cached
-let _manifest = null;
-let _manifestPromise = null;
-let _baseURL = "";
-
-/** Set the URL prefix used to fetch the manifest + icon files. */
-export function setIconBaseURL(url) {
-  _baseURL = url.endsWith("/") ? url.slice(0, -1) : url;
-}
-
-/** Optional override for tests: inject a manifest map directly. */
-export function setManifest(map) {
-  _manifest = { ...map };
-}
-
-/** Optional override for tests: register a single key → SVG fragment. */
-export function registerIcon(key, svg) {
-  _cache.set(key, svg);
-}
-
-async function loadManifest() {
-  if (_manifest) return _manifest;
-  if (_manifestPromise) return _manifestPromise;
-  const url = `${_baseURL}/icons-manifest.json`.replace(/^\//, "");
-  _manifestPromise = fetch(url).then(r => {
-    if (!r.ok) throw new Error(`manifest fetch failed: ${r.status}`);
-    return r.json();
-  }).then(m => (_manifest = m));
-  return _manifestPromise;
-}
-
-function pngBytesToImageTag(bytes, size = IMAGE_SIZE) {
-  // Base64-encode the PNG bytes for embedding in an SVG `<image>` tag.
-  let bin = "";
-  for (let i = 0; i < bytes.length; i++) bin += String.fromCharCode(bytes[i]);
-  const b64 = (typeof btoa !== "undefined") ? btoa(bin) : Buffer.from(bytes).toString("base64");
-  const half = (size / 2) | 0;
-  return `<image href="data:image/png;base64,${b64}" ` +
-         `x="-${half}" y="-${half}" width="${size}" height="${size}"/>`;
-}
-
-function svgTextToInline(text, size = IMAGE_SIZE) {
-  const half = (size / 2) | 0;
-  return `<svg x="-${half}" y="-${half}" width="${size}" height="${size}" ` +
-         `overflow="visible">${text}</svg>`;
-}
-
-/**
- * Resolve `key` to an SVG fragment. Returns a Promise; built-in icons
- * resolve immediately, file-backed PNGs/SVGs after a network fetch.
- * Throws when the key is not in the built-in registry and not in the
- * manifest.
- */
-export async function getIcon(key) {
-  if (_cache.has(key)) return _cache.get(key);
-
-  const manifest = await loadManifest();
-  const path = manifest[key];
-  if (!path) throw new Error(`unknown icon: ${JSON.stringify(key)}`);
-
-  const url = _baseURL ? `${_baseURL}/${path}` : path;
-  const res = await fetch(url);
-  if (!res.ok) throw new Error(`icon fetch failed: ${path} (${res.status})`);
-
-  let svg;
-  if (path.endsWith(".svg")) {
-    svg = svgTextToInline(await res.text());
-  } else {
-    const buf = new Uint8Array(await res.arrayBuffer());
-    svg = pngBytesToImageTag(buf);
-  }
-  _cache.set(key, svg);
-  return svg;
-}
-
-export { ICONS };

package/src/js/index.js

@@ -1,13 +0,0 @@
-/**
- * kymo — browser/Node port of the diagram-as-code model + icon library.
- *
- * Mirrors the Python source-of-truth at `src/python/kymo/`. This entry
- * point re-exports the data model (`makeComponent`, `makeEdge`, `anchor`,
- * `resolveAnchors`, …) and the icon registry/loader (`ICONS`, `getIcon`,
- * `setIconBaseURL`, …).
- *
- * Note: the DSL parser, layout engine and SVG renderer are currently
- * Python-only; this package ships the shared model + icons.
- */
-export * from "./model.js";
-export * from "./icons-loader.js"; // re-exports ICONS, getIcon, setIconBaseURL, setManifest, registerIcon

package/src/js/model.js

@@ -1,176 +0,0 @@
-/**
- * Data model for the container diagram — JS mirror of `src/model.py`.
- *
- * Components, regions and edges are plain object literals (no classes).
- * `anchor(node, side)` and `resolveAnchors(edge, src, dst)` mimic the
- * Python implementations 1:1.
- */
-
-/** @type {Record<string, [number, number]>} */
-export const SHAPE_HALF = {
-  "circle":        [38, 38],
-  "cube":          [40, 40],
-  "cube-big":      [50, 50],
-  "box":           [35, 35],
-  "cylinder":      [35, 35],
-  "hex":           [35, 32],   // flat-top hexagon — wider than tall
-  "annotation":    [0, 0],
-  "aws-tile":      [32, 32],
-  "aws-tile-hero": [40, 40],
-  "badge":         [14, 14],
-  "image":         [32, 32],
-};
-
-/** @type {Record<string, number>} */
-export const LABEL_HEIGHT = {
-  "circle":        38,
-  "cube":          42,
-  "cube-big":      48,
-  "box":           38,
-  "cylinder":      38,
-  "hex":           40,
-  "annotation":    0,
-  "aws-tile":      48,
-  "aws-tile-hero": 48,
-  "badge":         0,
-  "image":         26,
-};
-
-// ── Factories (mirror Python @dataclass with defaults) ────────────────
-
-export function makeComponent({
-  id, name = "", subtitle = "", icon = "", shape = "box", accent = "green",
-  pos = [0, 0],
-  parent = null, align = null, alignGap = 24, alignOffset = [0, 0],
-}) {
-  return {
-    id, name, subtitle, icon, shape, accent, pos,
-    parent, align, alignGap, alignOffset,
-  };
-}
-
-export function makeRegion({
-  id, label = "", bounds = [0, 0, 0, 0], contains = [],
-  padding = [24, 24], paddingBottom = null, style = "outer",
-  icon = null, layout = null, pos = null, gap = 24, align = "center",
-  visible = true, borderDash = null, borderStroke = null,
-  labelAnchor = "middle", labelPosition = null,
-}) {
-  return {
-    id, label, bounds, contains, padding, paddingBottom, style, icon,
-    layout, pos, gap, align, visible, borderDash, borderStroke,
-    labelAnchor, labelPosition,
-  };
-}
-
-export function makeEdge({
-  src, dst, label = "", style = "gray",
-  srcAnchor = null, dstAnchor = null,
-  route = "auto", via = [],
-  srcOffset = [0, 0], dstOffset = [0, 0],
-  labelOffset = [0, 0], labelAnchor = "mid",
-  labelSmall = false, labelPos = null,
-  dashed = false, noArrow = false,
-  trunkOffset = 0, sharedPort = false,
-}) {
-  return {
-    src, dst, label, style, srcAnchor, dstAnchor, route, via,
-    srcOffset, dstOffset, labelOffset, labelAnchor, labelSmall, labelPos,
-    dashed, noArrow, trunkOffset, sharedPort,
-  };
-}
-
-export function makeDiagram({
-  width = 0, height = 0, title = "", subtitle = "",
-  components = [], regions = [], edges = [], layoutTrees = [],
-} = {}) {
-  return { width, height, title, subtitle, components, regions, edges, layoutTrees };
-}
-
-// ── Lookups & geometry helpers ────────────────────────────────────────
-
-export function componentHalf(c) {
-  return SHAPE_HALF[c.shape];
-}
-
-export function regionHalf(r) {
-  const [, , w, h] = r.bounds;
-  return [(w / 2) | 0, (h / 2) | 0];
-}
-
-/**
- * Edge attach point on `node` for a given side.
- * For a Component, `bottom` pushes past `LABEL_HEIGHT` when the
- * component actually has a name or subtitle.
- */
-export function anchor(node, side) {
-  // Region path — has `bounds`, no `pos`.
-  if (node.bounds !== undefined && node.pos === undefined) {
-    return regionAnchor(node, side);
-  }
-  // Component path — has `pos`.
-  return componentAnchor(node, side);
-}
-
-function componentAnchor(c, side) {
-  const [cx, cy] = c.pos;
-  const [hw, hh] = SHAPE_HALF[c.shape];
-  const labelled = (c.name && c.name.length > 0) || (c.subtitle && c.subtitle.length > 0);
-  const lh = labelled ? (LABEL_HEIGHT[c.shape] || 0) : 0;
-  switch (side) {
-    case "top":    return [cx, cy - hh];
-    case "right":  return [cx + hw, cy];
-    case "bottom": return [cx, cy + hh + lh];
-    case "left":   return [cx - hw, cy];
-    case "center": return [cx, cy];
-  }
-  throw new Error(`anchor: bad side ${side}`);
-}
-
-function regionAnchor(r, side) {
-  const [x, y, w, h] = r.bounds;
-  switch (side) {
-    case "top":    return [x + ((w / 2) | 0), y];
-    case "right":  return [x + w, y + ((h / 2) | 0)];
-    case "bottom": return [x + ((w / 2) | 0), y + h];
-    case "left":   return [x, y + ((h / 2) | 0)];
-    case "center": return [x + ((w / 2) | 0), y + ((h / 2) | 0)];
-  }
-  throw new Error(`anchor: bad side ${side}`);
-}
-
-/**
- * Pick effective (srcAnchor, dstAnchor) for an edge. `null` slots are
- * filled from geometry: horizontal-biased — vertical wins only when
- * `|dy| > 2·|dx|`.
- */
-export function resolveAnchors(e, src, dst) {
-  let { srcAnchor: sa, dstAnchor: da } = e;
-  if (sa !== null && da !== null) return [sa, da];
-  const [scx, scy] = anchor(src, "center");
-  const [dcx, dcy] = anchor(dst, "center");
-  const dx = dcx - scx, dy = dcy - scy;
-  let autoSa, autoDa;
-  if (Math.abs(dy) > 2 * Math.abs(dx)) {
-    [autoSa, autoDa] = dy >= 0 ? ["bottom", "top"] : ["top", "bottom"];
-  } else {
-    [autoSa, autoDa] = dx >= 0 ? ["right", "left"] : ["left", "right"];
-  }
-  return [sa || autoSa, da || autoDa];
-}
-
-// ── Diagram node lookups ──────────────────────────────────────────────
-
-export function getComponent(d, id) {
-  const c = d.components.find(c => c.id === id);
-  if (!c) throw new Error(`component ${JSON.stringify(id)} not in diagram`);
-  return c;
-}
-
-export function getNode(d, id) {
-  const c = d.components.find(c => c.id === id);
-  if (c) return c;
-  const r = d.regions.find(r => r.id === id);
-  if (r) return r;
-  throw new Error(`node ${JSON.stringify(id)} not in diagram (checked components + regions)`);
-}