@miragon/wardley-dsl 0.6.0 → 0.7.0

package/README.md

@@ -49,6 +49,19 @@ The result always reads back as the same map as `serializeDSL(map)`. When an edi
 safely into the source layout, `patchDSL` falls back to the canonical `serializeDSL(map)` text (in
 the source's line break style). It never throws.
 
+### Ids in the document
+
+The OWM DSL writes no ids: the parser derives them from names (`cmp_cup_of_tea`), note texts and
+annotation numbers, with a `_2` suffix for a repeat in line order. An editor that creates or renames
+an element holds an id the text does not give it until the text is read again. `readBackIds(map)`
+tells, by the ids of `map`, which id each element carries once `serializeDSL(map)` is read back:
+
+```ts
+import { readBackIds } from '@miragon/wardley-dsl';
+
+readBackIds(editedMap).get('shape_42'); // 'cmp_hot_water'
+```
+
 Part of the [Wardley Maps](https://github.com/Miragon/wardley-maps-modeler) monorepo.
 
 ## License

package/dist/index.cjs

@@ -595,7 +595,7 @@ var MapReader = class {
   }
   /** For a line that looks like a known construct but cannot be parsed. */
   failed(line) {
-    this.keep(line, "Line could not be interpreted (kept losslessly in rawPassthrough)");
+    this.keep(line, "Line not understood \u2014 kept as written");
   }
   // A reference binds to the name as written first, so `X 2` stays bound to an explicit "X 2" even
   // when a duplicate "X" was renamed to "X 2"; the serializer then writes that reference by the
@@ -2485,6 +2485,28 @@ function fingerprint(map) {
   return entries.sort().join("\n");
 }
 
+// src/read-back-ids.ts
+var ELEMENT_KEY = /^(?:element|child):(.*)$/s;
+function elementIdOf(key) {
+  return ELEMENT_KEY.exec(key)?.[1];
+}
+function readBackIds(map) {
+  const lines = serializeKeyedLines(map);
+  const { sourceMap } = parseDSLWithSourceMap([...lines.map((line) => line.text), ""].join("\n"));
+  const readIdByLine = /* @__PURE__ */ new Map();
+  for (const [key, line] of sourceMap.primaryLineOf) {
+    const id = elementIdOf(key);
+    if (id !== void 0) readIdByLine.set(line, id);
+  }
+  const ids = /* @__PURE__ */ new Map();
+  lines.forEach((line, index) => {
+    const id = elementIdOf(line.key);
+    const readId = readIdByLine.get(index + 1);
+    if (id !== void 0 && readId !== void 0) ids.set(id, readId);
+  });
+  return ids;
+}
+
 // src/raw-passthrough.ts
 function withoutRawStatements(rawPassthrough, keyword) {
   if (!rawPassthrough) return rawPassthrough;
@@ -2524,6 +2546,7 @@ exports.parseDSLWithDiagnostics = parseDSLWithDiagnostics;
 exports.parseDecorators = parseDecorators;
 exports.parseLabelOffset = parseLabelOffset;
 exports.patchDSL = patchDSL;
+exports.readBackIds = readBackIds;
 exports.serializeDSL = serializeDSL;
 exports.slug = slug;
 exports.withoutRawStatements = withoutRawStatements;