@miragon/wardley-dsl 0.6.0 → 0.7.0

package/dist/index.d.cts

@@ -49,6 +49,15 @@ interface PatchOptions {
     readonly previous?: WardleyMap;
 }
 
+/**
+ * The id each element of `map` carries once `serializeDSL(map)` is read back, keyed by its id in
+ * `map`. The OWM DSL writes no ids: the parser derives them from names, texts and the order of the
+ * lines, so an element created or renamed in an editor has another id in memory than in the
+ * document until the text is read again. Elements the text does not write (none today) are
+ * missing from the result.
+ */
+declare function readBackIds(map: WardleyMap): Map<string, string>;
+
 /**
  * `rawPassthrough` without the uninterpreted statements of one keyword (e.g. an unreadable `size`
  * line once the map writes a valid one). Lines are judged by their code outside comments, so text
@@ -105,4 +114,5 @@ declare function parseLabelOffset(line: string): {
 declare function keywordOf(line: string): string;
 declare function slug(label: string): string;
 
-export { type InlineDecorators, type LabelOffsetToken, type ParseDiagnostic, type ParseResult, type ParsedCoords, type PatchOptions, keywordOf, parseCoords, parseDSL, parseDSLWithDiagnostics, parseDecorators, parseLabelOffset, patchDSL, serializeDSL, slug, withoutRawStatements };
+export { keywordOf, parseCoords, parseDSL, parseDSLWithDiagnostics, parseDecorators, parseLabelOffset, patchDSL, readBackIds, serializeDSL, slug, withoutRawStatements };
+export type { InlineDecorators, LabelOffsetToken, ParseDiagnostic, ParseResult, ParsedCoords, PatchOptions };

package/dist/index.d.ts

@@ -49,6 +49,15 @@ interface PatchOptions {
     readonly previous?: WardleyMap;
 }
 
+/**
+ * The id each element of `map` carries once `serializeDSL(map)` is read back, keyed by its id in
+ * `map`. The OWM DSL writes no ids: the parser derives them from names, texts and the order of the
+ * lines, so an element created or renamed in an editor has another id in memory than in the
+ * document until the text is read again. Elements the text does not write (none today) are
+ * missing from the result.
+ */
+declare function readBackIds(map: WardleyMap): Map<string, string>;
+
 /**
  * `rawPassthrough` without the uninterpreted statements of one keyword (e.g. an unreadable `size`
  * line once the map writes a valid one). Lines are judged by their code outside comments, so text
@@ -105,4 +114,5 @@ declare function parseLabelOffset(line: string): {
 declare function keywordOf(line: string): string;
 declare function slug(label: string): string;
 
-export { type InlineDecorators, type LabelOffsetToken, type ParseDiagnostic, type ParseResult, type ParsedCoords, type PatchOptions, keywordOf, parseCoords, parseDSL, parseDSLWithDiagnostics, parseDecorators, parseLabelOffset, patchDSL, serializeDSL, slug, withoutRawStatements };
+export { keywordOf, parseCoords, parseDSL, parseDSLWithDiagnostics, parseDecorators, parseLabelOffset, patchDSL, readBackIds, serializeDSL, slug, withoutRawStatements };
+export type { InlineDecorators, LabelOffsetToken, ParseDiagnostic, ParseResult, ParsedCoords, PatchOptions };

package/dist/index.js

@@ -594,7 +594,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
@@ -2484,6 +2484,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;
@@ -2504,6 +2526,6 @@ function withoutRawStatements(rawPassthrough, keyword) {
   return kept.length ? kept : void 0;
 }
 
-export { keywordOf, parseCoords, parseDSL, parseDSLWithDiagnostics, parseDecorators, parseLabelOffset, patchDSL, serializeDSL, slug, withoutRawStatements };
+export { keywordOf, parseCoords, parseDSL, parseDSLWithDiagnostics, parseDecorators, parseLabelOffset, patchDSL, readBackIds, serializeDSL, slug, withoutRawStatements };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map