@miragon/wardley-dsl 0.5.1 → 0.5.3

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { WardleyMap, Method } from '@miragon/wardley-schema-model';
 export { loadMap, parseMapJSON as mapFromJSON, serializeMap as mapToJSON } from '@miragon/wardley-schema-model';
 
-/** Finding produced while parsing — line is 1-based; `text` is the (comment-stripped) line. */
+/** Finding produced while parsing — line is 1-based; `text` is that source line, trimmed. */
 interface ParseDiagnostic {
     readonly line: number;
     readonly message: string;
@@ -52,6 +52,10 @@ interface InlineDecorators {
  * - parenthesized: `(market)`, `(ecosystem)`, `(build|buy|outsource)`, combined `(market, outsource)`
  * - trailing keyword: `inertia`
  * Returns the decorators found and the line stripped of them.
+ *
+ * @deprecated Kept for API compatibility; the parser no longer uses it. It reads every `( … )` group
+ * and `inertia` anywhere on the line and lets the last method win, while `parseDSL` reads decorators
+ * only after the coordinates and keeps the first method.
  */
 declare function parseDecorators(line: string): {
     decorators: InlineDecorators;
@@ -61,10 +65,14 @@ interface LabelOffsetToken {
     readonly dx: number;
     readonly dy: number;
 }
-/** Reads an optional `label [dx, dy]` (pixel offset) and returns it plus the stripped line. */
+/**
+ * Reads an optional `label [dx, dy]` (pixel offset) and returns it plus the stripped line.
+ * `unreadable` holds the matched text when a number in it cannot be read.
+ */
 declare function parseLabelOffset(line: string): {
     labelOffset: LabelOffsetToken | null;
     rest: string;
+    unreadable?: string;
 };
 /** First word (keyword) of a line, lowercased. */
 declare function keywordOf(line: string): string;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { WardleyMap, Method } from '@miragon/wardley-schema-model';
 export { loadMap, parseMapJSON as mapFromJSON, serializeMap as mapToJSON } from '@miragon/wardley-schema-model';
 
-/** Finding produced while parsing — line is 1-based; `text` is the (comment-stripped) line. */
+/** Finding produced while parsing — line is 1-based; `text` is that source line, trimmed. */
 interface ParseDiagnostic {
     readonly line: number;
     readonly message: string;
@@ -52,6 +52,10 @@ interface InlineDecorators {
  * - parenthesized: `(market)`, `(ecosystem)`, `(build|buy|outsource)`, combined `(market, outsource)`
  * - trailing keyword: `inertia`
  * Returns the decorators found and the line stripped of them.
+ *
+ * @deprecated Kept for API compatibility; the parser no longer uses it. It reads every `( … )` group
+ * and `inertia` anywhere on the line and lets the last method win, while `parseDSL` reads decorators
+ * only after the coordinates and keeps the first method.
  */
 declare function parseDecorators(line: string): {
     decorators: InlineDecorators;
@@ -61,10 +65,14 @@ interface LabelOffsetToken {
     readonly dx: number;
     readonly dy: number;
 }
-/** Reads an optional `label [dx, dy]` (pixel offset) and returns it plus the stripped line. */
+/**
+ * Reads an optional `label [dx, dy]` (pixel offset) and returns it plus the stripped line.
+ * `unreadable` holds the matched text when a number in it cannot be read.
+ */
 declare function parseLabelOffset(line: string): {
     labelOffset: LabelOffsetToken | null;
     rest: string;
+    unreadable?: string;
 };
 /** First word (keyword) of a line, lowercased. */
 declare function keywordOf(line: string): string;