@nielspeter/eess-mermaid 0.7.0 → 0.8.0

package/README.md

@@ -24,6 +24,34 @@ classes(d).that().haveStereotype('repository').should().haveNameEndingWith('Repo
 
 The diagram is validated for internal consistency (valid class references, stereotypes, relationships) via the Langium grammar. Cross-validation against TypeScript code — binding a diagram to its implementation so either side drifting fails the build — ships as `diagramMatchesCode()` in [`@nielspeter/eess-crossvalidate`](https://www.npmjs.com/package/@nielspeter/eess-crossvalidate) (design history: [plan 0059](https://github.com/nielspeter/eess/blob/main/work/plans/completed/0059-cross-validation-eess-crossvalidate.md)).
 
+## Does every Mermaid block parse?
+
+`mermaidParser()` is Mermaid's own parser (the `mermaid` package GitHub renders with) for
+[`@nielspeter/eess-md`](https://www.npmjs.com/package/@nielspeter/eess-md)'s `parseCodeBlocks`. It
+says whether a block parses; `parseClassDiagram` above is eess's own grammar, used to bind a
+diagram to code.
+
+```bash
+npm i -D @nielspeter/eess-md mermaid@11 jsdom
+```
+
+```typescript
+import { corpus, parseCodeBlocks, codeBlocks } from '@nielspeter/eess-md'
+import { mermaidParser } from '@nielspeter/eess-mermaid'
+
+const parsed = await parseCodeBlocks(corpus({ roots: ['docs/**'] }), {
+  language: 'mermaid',
+  parser: mermaidParser(),
+})
+codeBlocks(parsed).should().parse().check()
+```
+
+`mermaid` and `jsdom` are optional peers, about 179 MB installed (`mermaid` 83 MB, `jsdom`
+8.3 MB), and load only inside a worker thread, so your process never gets a DOM. What it reports,
+and its limits (a block with a trailing `%%` comment claims no line; `parse` is not `render`; the
+canaries cover one kind per error shape), are in the
+[guide](https://github.com/nielspeter/eess/blob/main/docs/mermaid.md#does-every-mermaid-block-parse).
+
 ## License
 
 MIT

package/dist/index.d.ts

@@ -27,6 +27,8 @@ export { defineConfig } from './cli/config.js';
 export type { CliConfig } from './cli/config.js';
 export { fromDiagram } from './bridge/from-diagram.js';
 export type { BridgeOptions, BridgeRule, BridgeRuleAllowedEdge, BridgeRuleForbiddenEdge, BridgeRuleInheritance, BridgeOutput, } from './bridge/from-diagram.js';
+export { mermaidParser } from './mermaid-js/mermaid-parser.js';
+export type { MermaidParser, MermaidVerdict, MermaidCanary, } from './mermaid-js/create-mermaid-parser.js';
 export { parseErDiagram } from './parser/parse-er-diagram.js';
 export { diagramKind } from './parser/diagram-kind.js';
 export { collectEntities, collectErRelationships } from './models/er-entity.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAA;AAC/B,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAClG,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAC9E,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACvF,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAKlD,OAAO,EACL,eAAe,EACf,aAAa,EAMb,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACtE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAA;AAG/C,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAG3C,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAA;AAG1F,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAC5E,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAI7E,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC7E,YAAY,EACV,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,8BAA8B,CAAA;AAGrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAGvE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAGhD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,YAAY,EACV,aAAa,EACb,UAAU,EACV,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,YAAY,GACb,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC/E,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAA;AAC/B,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAClG,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAC9E,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACvF,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAKlD,OAAO,EACL,eAAe,EACf,aAAa,EAMb,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACtE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAA;AAG/C,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAG3C,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAA;AAG1F,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAC5E,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAI7E,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC7E,YAAY,EACV,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,8BAA8B,CAAA;AAGrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAGvE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAGhD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,YAAY,EACV,aAAa,EACb,UAAU,EACV,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,YAAY,GACb,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAC9D,YAAY,EACV,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,uCAAuC,CAAA;AAG9C,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC/E,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/index.js

@@ -32,6 +32,8 @@ export { validateReferences } from './parser/validate-diagram.js';
 export { defineConfig } from './cli/config.js';
 // Bridge to eess-ts
 export { fromDiagram } from './bridge/from-diagram.js';
+// Mermaid's own parser, for eess-md's parseCodeBlocks (plan 0413)
+export { mermaidParser } from './mermaid-js/mermaid-parser.js';
 // ER diagrams (plan 0069 Phase 3)
 export { parseErDiagram } from './parser/parse-er-diagram.js';
 // Plan 0214: the one lexer for a diagram's declared kind.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,cAAc,iBAAiB,CAAA;AAE/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAE9E,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAEzC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAElD,iFAAiF;AACjF,8EAA8E;AAC9E,iEAAiE;AACjE,OAAO,EACL,eAAe,EACf,aAAa;AACb,4EAA4E;AAC5E,6EAA6E;AAC7E,4EAA4E;AAC5E,uEAAuE;AACvE,WAAW;AACX,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,kBAAkB,CAAA;AAIzB,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAA;AAI/C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAE3C,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAA;AAE1F,oBAAoB;AACpB,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAE5E,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAE7E,aAAa;AACb,oBAAoB;AACpB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAW7E,uBAAuB;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AAGjE,oDAAoD;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG9C,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAUtD,kCAAkC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,0DAA0D;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,cAAc,iBAAiB,CAAA;AAE/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAE9E,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAEzC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAElD,iFAAiF;AACjF,8EAA8E;AAC9E,iEAAiE;AACjE,OAAO,EACL,eAAe,EACf,aAAa;AACb,4EAA4E;AAC5E,6EAA6E;AAC7E,4EAA4E;AAC5E,uEAAuE;AACvE,WAAW;AACX,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,kBAAkB,CAAA;AAIzB,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAA;AAI/C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAE3C,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAA;AAE1F,oBAAoB;AACpB,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAE5E,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAE7E,aAAa;AACb,oBAAoB;AACpB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAW7E,uBAAuB;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AAGjE,oDAAoD;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG9C,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAUtD,kEAAkE;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAO9D,kCAAkC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,0DAA0D;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/mermaid-js/create-mermaid-parser.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Plan 0413: Mermaid's own parser, in a worker, in the shape of eess-md's code-block parser port
+ * (plan 0412). eess-mermaid matches that port by shape and imports nothing from eess-md.
+ *
+ * Internal: `mermaidParser()` is this with the worker beside it. Tests pass a copy of the worker in a
+ * scratch directory whose `node_modules` holds a stub `mermaid`, nothing, or the real packages. The
+ * package's `exports` has no deep path, so no rule file can name a module for it to run.
+ *
+ * The three types below mirror eess-md's `CodeBlockVerdict`, `CodeBlockCanary` and `CodeBlockParser`
+ * (`packages/md/src/model/code-block-parse.ts`): a change to the port changes both packages' API.
+ * eess-crossvalidate's port test assigns one to the other, so a drift fails its typecheck.
+ */
+/** What Mermaid says about one block, in eess-md's `CodeBlockVerdict` shape. */
+export type MermaidVerdict = {
+    readonly outcome: 'valid';
+} | {
+    readonly outcome: 'invalid';
+    readonly message: string;
+    /** 1-based, from the block's first body line; `null` when Mermaid's line cannot be trusted. */
+    readonly line: number | null;
+    readonly remedy: string;
+} | {
+    readonly outcome: 'unrecognised';
+    readonly message: string;
+    readonly remedy: string;
+};
+/** A block Mermaid must reject, in eess-md's `CodeBlockCanary` shape. */
+export interface MermaidCanary {
+    readonly text: string;
+    readonly expect: 'invalid' | 'unrecognised';
+}
+/** eess-md's `CodeBlockParser` shape, filled by Mermaid. */
+export interface MermaidParser {
+    readonly name: string;
+    /** The installed `mermaid`'s version, `'not installed'`, or `'unreadable'`. */
+    readonly version: string;
+    readonly canaries: readonly MermaidCanary[];
+    parse(texts: readonly string[], options: {
+        readonly signal: AbortSignal;
+        readonly budgetMs: number;
+    }): Promise<readonly MermaidVerdict[]>;
+}
+/** The parser, run from `workerUrl`. Never throws: a missing peer is reported by `parse`. */
+export declare function createMermaidParser(options: {
+    /** The worker module to run: `mermaid-worker.mjs`, or a copy of it. */
+    readonly workerUrl: URL;
+}): MermaidParser;
+//# sourceMappingURL=create-mermaid-parser.d.ts.map

package/dist/mermaid-js/create-mermaid-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-mermaid-parser.d.ts","sourceRoot":"","sources":["../../src/mermaid-js/create-mermaid-parser.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;GAWG;AAEH,gFAAgF;AAChF,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAC7B;IACE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,+FAA+F;IAC/F,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB,GACD;IAAE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAE3F,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc,CAAA;CAC5C;AAED,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAA;IAC3C,KAAK,CACH,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GACnE,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAA;CACtC;AAkaD,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAA;CACxB,GAAG,aAAa,CAYhB"}

package/dist/mermaid-js/create-mermaid-parser.js

@@ -0,0 +1,438 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import { Worker } from 'node:worker_threads';
+import { diagramPreamble } from '../parser/diagram-kind.js';
+import { frontmatterYaml, hasTrailingComment, mermaidLineMap } from '../parser/mermaid-line-map.js';
+/**
+ * Why the parser could not answer for the batch. eess-md reads `remedy` and `blockIndex` by shape
+ * (an index into `texts`, or `null`) and reports the instrument, naming the block when there is one.
+ */
+class MermaidParserFailure extends Error {
+    remedy;
+    blockIndex;
+    constructor(message, remedy, blockIndex) {
+        super(message);
+        this.remedy = remedy;
+        this.blockIndex = blockIndex;
+        this.name = 'MermaidParserFailure';
+    }
+}
+/** The version the line map's regexes were read from; the line canary checks they still hold. */
+const LINE_MAP_MERMAID = '11.17.2';
+const INSTALL = 'Install both peers: `npm i -D mermaid@11 jsdom`.';
+/**
+ * One known-broken block per error shape. eess-md runs them before the corpus's blocks, so a
+ * `mermaid` that stopped throwing (a new major, a changed error shape, `suppressErrors`) is caught.
+ */
+const CANARIES = Object.freeze([
+    Object.freeze({ text: 'sequenceDiagram\n  A->>B: hi\n  A->>', expect: 'invalid' }),
+    Object.freeze({ text: 'packet-beta\n0-10: "a"\n1x-2: "b"', expect: 'invalid' }),
+    Object.freeze({ text: 'flowchrt TD\n  A --> B', expect: 'unrecognised' }),
+]);
+/**
+ * The line canary: blocks whose true error line is known. Between them they hold frontmatter
+ * followed by a blank line, a one-line and a three-line directive, a bare `%%` line (which Mermaid
+ * keeps), a blank line before a mid-body comment, two mid-body comments, a blank line left at the
+ * front once a leading comment goes, `\r\n` line ends, and one error of each line shape: a jison
+ * parse error, a jison lexical error, a Langium error. Not held: a Langium block with errors on
+ * several lines (which one is reported is the line map's "smallest line" rule, pinned only by the
+ * unit tests). Parsed privately, before eess-md's texts.
+ */
+const LINE_CANARIES = Object.freeze([
+    {
+        text: [
+            '---',
+            'title: x',
+            '---',
+            '',
+            'flowchart TD',
+            '  A --> B',
+            '%%{init: {"theme":"dark"}}%%',
+            '  B --> C',
+            '%%',
+            '',
+            '  %% c',
+            '  %% d',
+            '%%{init: {',
+            '"theme":"dark"',
+            '}}%%',
+            '  C --> --> D',
+            '  E --> F',
+        ].join('\n'),
+        line: 16,
+    },
+    // A comment and a blank line before the kind: only Mermaid's final `trimStart` drops the blank.
+    {
+        text: '%% a\r\n\r\nflowchart TD\r\n  A --> B\r\n  %% c\r\n  C --> D ]]] x\r\n  E --> F',
+        line: 6,
+    },
+    { text: 'packet-beta\n0-10: "a"\n%% c\n%% c\n11-x: "b"', line: 5 },
+]);
+const SHAPES = [
+    'ok',
+    'jison',
+    'langium',
+    'unknown-diagram',
+    'yaml',
+    'other',
+    'non-result',
+];
+function isShape(value) {
+    return typeof value === 'string' && SHAPES.includes(value);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function lineOrNull(value) {
+    if (value === null)
+        return null;
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+/** The worker is code eess-mermaid runs but cannot type: every message is narrowed (ADR-005). */
+function readFact(value) {
+    if (!isRecord(value))
+        return null;
+    const { shape, message } = value;
+    const locFirstLine = lineOrNull(value.locFirstLine);
+    const hashLine = lineOrNull(value.hashLine);
+    const yamlLine = lineOrNull(value.yamlLine);
+    const yamlText = value.yamlText;
+    const lines = value.langiumLines;
+    if (!isShape(shape) || typeof message !== 'string')
+        return null;
+    if (locFirstLine === undefined || hashLine === undefined || yamlLine === undefined)
+        return null;
+    if (!Array.isArray(lines))
+        return null;
+    if (yamlText !== null && typeof yamlText !== 'string')
+        return null;
+    const langiumLines = [];
+    for (const line of lines) {
+        if (typeof line !== 'number')
+            return null;
+        langiumLines.push(line);
+    }
+    return { shape, locFirstLine, hashLine, langiumLines, yamlLine, yamlText, message };
+}
+function readFacts(value, count) {
+    if (!Array.isArray(value) || value.length !== count)
+        return null;
+    const facts = [];
+    for (const item of value) {
+        const fact = readFact(item);
+        if (fact === null)
+            return null;
+        facts.push(fact);
+    }
+    return facts;
+}
+/** Mermaid's own line for an error, by shape; never read from the message. */
+function mermaidLine(fact) {
+    if (fact.shape === 'jison') {
+        if (fact.locFirstLine !== null)
+            return fact.locFirstLine;
+        // A lexical error carries no `hash.loc`, and its `hash.line` counts from 0 (spike 0425).
+        return fact.hashLine === null ? null : fact.hashLine + 1;
+    }
+    if (fact.shape === 'langium' && fact.langiumLines.length > 0) {
+        return Math.min(...fact.langiumLines);
+    }
+    return null;
+}
+/** The block line of a syntax error, and Mermaid's own, before the trailing-comment rule. */
+function blockLine(text, fact) {
+    const reported = mermaidLine(fact);
+    return { line: reported === null ? null : mermaidLineMap(text)(reported), reported };
+}
+const SUPPRESSED = (index) => new MermaidParserFailure('`mermaid.parse` resolved without a result; is `suppressErrors` set?', "Check that nothing sets Mermaid's `suppressErrors`: eess-mermaid needs `mermaid.parse` to throw on a broken block.", index);
+/**
+ * The outcome table (plan 0413): Mermaid's acceptance always wins, and so does a syntax error it can
+ * place, since Mermaid found a diagram to parse. Any other failure is read with the block's preamble.
+ * A throw eess-mermaid cannot place is the instrument, never the author's error.
+ */
+function verdictFor(text, fact, index) {
+    const message = fact.message;
+    switch (fact.shape) {
+        case 'ok':
+            return { outcome: 'valid' };
+        case 'non-result':
+            throw SUPPRESSED(index);
+        case 'jison':
+        case 'langium':
+            return syntaxError(text, fact);
+        case 'yaml':
+            return yamlError(text, fact);
+        case 'unknown-diagram':
+        case 'other':
+            break;
+    }
+    switch (diagramPreamble(text).reason) {
+        case 'unclosed-frontmatter':
+            return {
+                outcome: 'invalid',
+                message,
+                line: 1,
+                remedy: 'Close the frontmatter with an un-indented `---` line, followed by a newline and the diagram.',
+            };
+        case 'unclosed-directive':
+            return {
+                outcome: 'unrecognised',
+                message,
+                remedy: 'A `%%{` directive is never closed with `}%%`: close it.',
+            };
+        case 'empty':
+            return {
+                outcome: 'unrecognised',
+                message,
+                remedy: 'The block is empty: write the diagram, or remove the block.',
+            };
+        case 'no-kind-after-preamble':
+            return {
+                outcome: 'unrecognised',
+                message,
+                remedy: 'The block declares no diagram after its directives, comments or frontmatter: add the diagram.',
+            };
+        case 'declared':
+            break;
+    }
+    if (fact.shape === 'unknown-diagram') {
+        return {
+            outcome: 'unrecognised',
+            message,
+            remedy: 'Check the spelling of the diagram kind, or this kind needs a newer `mermaid` or a plugin.',
+        };
+    }
+    throw new MermaidParserFailure(`Mermaid threw something eess-mermaid does not recognise as a syntax error: ${message}`, 'If this block is wrong, fix it; otherwise report it to eess.', index);
+}
+/**
+ * A YAML error claims a line only when the YAML js-yaml was given is the block's frontmatter as the
+ * line map reads it, which starts on the block's second line. Mermaid also reads a node's `@{ … }`
+ * data as YAML, counted on a snippet of its own; that error claims no line (PR review, architect N1).
+ */
+function yamlError(text, fact) {
+    const frontmatter = frontmatterYaml(text);
+    const given = fact.yamlText?.replace(/\n$/, '');
+    if (frontmatter !== null && given === frontmatter && fact.yamlLine !== null) {
+        return {
+            outcome: 'invalid',
+            message: fact.message,
+            line: fact.yamlLine + 2,
+            remedy: "Fix the frontmatter's YAML at this line; Mermaid's message is above.",
+        };
+    }
+    return {
+        outcome: 'invalid',
+        message: fact.message,
+        line: null,
+        remedy: "Mermaid could not read a YAML part of this block, its frontmatter or a node's `@{ … }` data; " +
+            'its message is above.',
+    };
+}
+function syntaxError(text, fact) {
+    const { line, reported } = blockLine(text, fact);
+    const remedy = "Fix the syntax at this line; Mermaid's message is above.";
+    const said = reported === null ? 'no line' : `line ${String(reported)}`;
+    // Mermaid reads frontmatter after a blank line or a comment, which the line map does not mirror
+    // (bug 0435): the walk then calls it unclosed, and the mapped line would be wrong.
+    if (diagramPreamble(text).reason === 'unclosed-frontmatter') {
+        return {
+            outcome: 'invalid',
+            message: `${fact.message}\nMermaid read frontmatter here that eess-mermaid's line map does not ` +
+                `(after a blank line or a comment); it reported ${said}.`,
+            line: null,
+            remedy,
+        };
+    }
+    if (hasTrailingComment(text)) {
+        return {
+            outcome: 'invalid',
+            message: `${fact.message}\nMermaid's line count is unreliable in a block with a trailing \`%%\` comment; ` +
+                `it reported ${said}.`,
+            line: null,
+            remedy,
+        };
+    }
+    return { outcome: 'invalid', message: fact.message, line, remedy };
+}
+/**
+ * The line canary: each block's syntax error must be on its known line. A block Mermaid accepts, or
+ * rejects with anything but a syntax error, checks nothing, so it is the instrument too. The one
+ * exception: when Mermaid also accepted one of this parser's own canaries, it has stopped throwing
+ * altogether, and eess-md's canaries report that under their own cause.
+ */
+function checkLineCanaries(facts, loaded, stoppedThrowing) {
+    for (const [i, canary] of LINE_CANARIES.entries()) {
+        const fact = facts[i];
+        if (fact === undefined)
+            continue;
+        const which = `line-canary block ${String(i + 1)}`;
+        if (fact.shape === 'non-result')
+            throw SUPPRESSED(null);
+        if (fact.shape === 'ok') {
+            if (stoppedThrowing)
+                continue;
+            throw new MermaidParserFailure(`mermaid ${loaded} accepted ${which}, which must fail on line ${String(canary.line)}, so ` +
+                "eess-mermaid's line map cannot be checked against it", `Install \`mermaid@${LINE_MAP_MERMAID}\`, and report the version to eess.`, null);
+        }
+        if (fact.shape !== 'jison' && fact.shape !== 'langium') {
+            throw new MermaidParserFailure(`mermaid ${loaded} rejected ${which} with something that is not a syntax error: ${fact.message}`, "Check that `mermaid` and `jsdom` load cleanly; if they do, report it to eess with Mermaid's message.", null);
+        }
+        if (blockLine(canary.text, fact).line === canary.line)
+            continue;
+        throw new MermaidParserFailure(`eess-mermaid's line map, written for mermaid ${LINE_MAP_MERMAID}, disagrees with mermaid ` +
+            `${loaded}: ${which} should fail on line ${String(canary.line)}`, `Install \`mermaid@${LINE_MAP_MERMAID}\`, and report the version to eess.`, null);
+    }
+}
+const CANARY_TEXTS = new Set(CANARIES.map((c) => c.text));
+/** "Major 11", prereleases included: `11.0.0-alpha.1` is in, `12.0.0-rc.1` is out. */
+function inMermaidRange(version) {
+    return /^11\.\d+\.\d+(?:[-+].*)?$/.test(version);
+}
+/**
+ * The installed `mermaid`'s version, read without loading it and without its `exports`: the first
+ * `<dir>/mermaid/package.json` among the directories Node would search from the worker.
+ */
+function declaredMermaid(workerUrl) {
+    for (const dir of createRequire(workerUrl).resolve.paths('mermaid') ?? []) {
+        const file = join(dir, 'mermaid', 'package.json');
+        if (!existsSync(file))
+            continue;
+        let pkg;
+        try {
+            pkg = JSON.parse(readFileSync(file, 'utf8'));
+        }
+        catch (error) {
+            // Not JSON: an installed mermaid is never reported as missing (ADR-009 rule 2).
+            return {
+                version: 'unreadable',
+                file,
+                reason: error instanceof Error ? error.message : String(error),
+            };
+        }
+        const version = isRecord(pkg) ? pkg.version : undefined;
+        return typeof version === 'string' && version !== ''
+            ? { version, file }
+            : { version: 'unreadable', file };
+    }
+    return { version: 'not installed', file: null };
+}
+function before(declared) {
+    if (declared.version === 'not installed') {
+        return new MermaidParserFailure('mermaid is not installed where eess-mermaid can resolve it.', INSTALL, null);
+    }
+    if (declared.version === 'unreadable') {
+        return new MermaidParserFailure(`mermaid's package.json at ${declared.file ?? 'an unknown path'} has no readable version` +
+            `${declared.reason === undefined ? '' : ` (${declared.reason})`}.`, 'Reinstall `mermaid`.', null);
+    }
+    if (!inMermaidRange(declared.version)) {
+        return new MermaidParserFailure(`mermaid ${declared.version} is installed.`, 'eess-mermaid reads mermaid 11; install `mermaid@11`.', null);
+    }
+    return null;
+}
+function loadFailure(message) {
+    const said = typeof message.message === 'string' ? message.message : 'no message';
+    const missing = typeof message.missing === 'string' ? message.missing : '';
+    if (missing === 'mermaid' || missing === 'jsdom') {
+        return new MermaidParserFailure(`the Mermaid worker could not load ${missing}: ${said}`, INSTALL, null);
+    }
+    if (missing !== '') {
+        return new MermaidParserFailure(`the Mermaid worker could not load: ${said}`, `\`${missing}\`, a dependency of mermaid or jsdom, is missing; reinstall them.`, null);
+    }
+    return new MermaidParserFailure(`the Mermaid worker could not load: ${said}`, `${INSTALL} Node said: ${said}`, null);
+}
+/** The parser, run from `workerUrl`. Never throws: a missing peer is reported by `parse`. */
+export function createMermaidParser(options) {
+    const { workerUrl } = options;
+    const declared = declaredMermaid(workerUrl);
+    return Object.freeze({
+        name: 'mermaid',
+        version: declared.version,
+        canaries: CANARIES,
+        parse: (texts, run) => parseInWorker(workerUrl, declared, texts, run),
+    });
+}
+function parseInWorker(workerUrl, declared, texts, run) {
+    const refused = before(declared);
+    if (refused !== null)
+        return Promise.reject(refused);
+    const { signal, budgetMs } = run;
+    return new Promise((resolve, reject) => {
+        const worker = new Worker(workerUrl, {
+            workerData: { texts: [...texts], privateTexts: LINE_CANARIES.map((c) => c.text) },
+        });
+        let inFlight = null;
+        let loaded = false;
+        let settled = false;
+        // The worker is terminated on every path: success, failure, exit and abort.
+        const finish = (settle) => {
+            if (settled)
+                return;
+            settled = true;
+            signal.removeEventListener('abort', onAbort);
+            void worker.terminate();
+            settle();
+        };
+        const fail = (failure) => finish(() => reject(failure));
+        const onAbort = () => {
+            fail(inFlight === null
+                ? new MermaidParserFailure(`the Mermaid worker did not start parsing within the budget of ${String(budgetMs)} ms`, 'Raise `budget.startUpMs`.', null)
+                : new MermaidParserFailure(`Mermaid was still parsing text ${String(inFlight + 1)} when the budget of ` +
+                    `${String(budgetMs)} ms ran out`, 'Raise `budget.perBlockMs`, or leave that document out of the corpus by its `ignore` glob.', inFlight));
+        };
+        if (signal.aborted)
+            onAbort();
+        else
+            signal.addEventListener('abort', onAbort, { once: true });
+        worker.on('message', (message) => {
+            if (!isRecord(message))
+                return;
+            if (message.type === 'progress') {
+                if (typeof message.index === 'number')
+                    inFlight = message.index;
+            }
+            else if (message.type === 'load-error') {
+                fail(loadFailure(message));
+            }
+            else if (message.type === 'loaded') {
+                loaded = true;
+                const version = typeof message.version === 'string' ? message.version : 'unreadable';
+                if (version !== declared.version) {
+                    fail(new MermaidParserFailure(`the Mermaid worker loaded mermaid ${version}, but mermaid ${declared.version} is ` +
+                        `installed at ${declared.file ?? 'an unknown path'}`, 'Reinstall `mermaid`, and check for a loader hook that redirects it.', null));
+                }
+            }
+            else if (message.type === 'verdicts') {
+                const facts = readFacts(message.results, texts.length);
+                const lineFacts = readFacts(message.privateResults, LINE_CANARIES.length);
+                if (!loaded || facts === null || lineFacts === null) {
+                    fail(new MermaidParserFailure('the Mermaid worker posted verdicts eess-mermaid cannot read', 'Report it to eess, with the versions of mermaid and jsdom.', null));
+                    return;
+                }
+                // Every error settles the parse: a throw from a message listener would be uncaught in the
+                // caller's process, with no finding to report.
+                try {
+                    const verdicts = facts.map((fact, i) => verdictFor(texts[i] ?? '', fact, i));
+                    const stoppedThrowing = facts.some((fact, i) => fact.shape === 'ok' && CANARY_TEXTS.has(texts[i] ?? ''));
+                    checkLineCanaries(lineFacts, declared.version, stoppedThrowing);
+                    finish(() => resolve(Object.freeze(verdicts)));
+                }
+                catch (error) {
+                    fail(error instanceof MermaidParserFailure
+                        ? error
+                        : new MermaidParserFailure(`eess-mermaid could not classify Mermaid's answer: ${error instanceof Error ? error.message : String(error)}`, 'Report it to eess, with the block.', null));
+                }
+            }
+        });
+        worker.on('error', (error) => {
+            fail(exitFailure(`the Mermaid worker threw: ${error.message}`, inFlight));
+        });
+        worker.on('exit', (code) => {
+            fail(exitFailure(`the Mermaid worker exited (code ${String(code)}) without a result`, inFlight));
+        });
+    });
+}
+function exitFailure(what, inFlight) {
+    return new MermaidParserFailure(inFlight === null ? what : `${what}, while parsing text ${String(inFlight + 1)}`, 'Leave that document out of the corpus by its `ignore` glob, and report the block to eess.', inFlight);
+}
+//# sourceMappingURL=create-mermaid-parser.js.map

package/dist/mermaid-js/create-mermaid-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-mermaid-parser.js","sourceRoot":"","sources":["../../src/mermaid-js/create-mermaid-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AA6CnG;;;GAGG;AACH,MAAM,oBAAqB,SAAQ,KAAK;IAG3B;IACA;IAHX,YACE,OAAe,EACN,MAAc,EACd,UAAyB;QAElC,KAAK,CAAC,OAAO,CAAC,CAAA;QAHL,WAAM,GAAN,MAAM,CAAQ;QACd,eAAU,GAAV,UAAU,CAAe;QAGlC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACpC,CAAC;CACF;AAED,iGAAiG;AACjG,MAAM,gBAAgB,GAAG,SAAS,CAAA;AAElC,MAAM,OAAO,GAAG,kDAAkD,CAAA;AAElE;;;GAGG;AACH,MAAM,QAAQ,GAA6B,MAAM,CAAC,MAAM,CAAC;IACvD,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,sCAAsC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAClF,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,mCAAmC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/E,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,wBAAwB,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1E,CAAC,CAAA;AAEF;;;;;;;;GAQG;AACH,MAAM,aAAa,GAAgE,MAAM,CAAC,MAAM,CAAC;IAC/F;QACE,IAAI,EAAE;YACJ,KAAK;YACL,UAAU;YACV,KAAK;YACL,EAAE;YACF,cAAc;YACd,WAAW;YACX,8BAA8B;YAC9B,WAAW;YACX,IAAI;YACJ,EAAE;YACF,QAAQ;YACR,QAAQ;YACR,YAAY;YACZ,gBAAgB;YAChB,MAAM;YACN,eAAe;YACf,WAAW;SACZ,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,IAAI,EAAE,EAAE;KACT;IACD,gGAAgG;IAChG;QACE,IAAI,EAAE,iFAAiF;QACvF,IAAI,EAAE,CAAC;KACR;IACD,EAAE,IAAI,EAAE,+CAA+C,EAAE,IAAI,EAAE,CAAC,EAAE;CACnE,CAAC,CAAA;AAeF,MAAM,MAAM,GAAsB;IAChC,IAAI;IACJ,OAAO;IACP,SAAS;IACT,iBAAiB;IACjB,MAAM;IACN,OAAO;IACP,YAAY;CACb,CAAA;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC5D,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAA;AACpD,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AAChF,CAAC;AAED,iGAAiG;AACjG,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACjC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,KAAK,CAAA;IAChC,MAAM,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;IACnD,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IAC3C,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IAC3C,MAAM,QAAQ,GAAY,KAAK,CAAC,QAAQ,CAAA;IACxC,MAAM,KAAK,GAAY,KAAK,CAAC,YAAY,CAAA;IACzC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAC/D,IAAI,YAAY,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IAC/F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACtC,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAClE,MAAM,YAAY,GAAa,EAAE,CAAA;IACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAA;QACzC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;AACrF,CAAC;AAED,SAAS,SAAS,CAAC,KAAc,EAAE,KAAa;IAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK;QAAE,OAAO,IAAI,CAAA;IAChE,MAAM,KAAK,GAAW,EAAE,CAAA;IACxB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC3B,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAC9B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAClB,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,8EAA8E;AAC9E,SAAS,WAAW,CAAC,IAAU;IAC7B,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,YAAY,CAAA;QACxD,yFAAyF;QACzF,OAAO,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAA;IAC1D,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAA;IACvC,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,6FAA6F;AAC7F,SAAS,SAAS,CAAC,IAAY,EAAE,IAAU;IACzC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;IAClC,OAAO,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAA;AACtF,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,KAAoB,EAAwB,EAAE,CAChE,IAAI,oBAAoB,CACtB,qEAAqE,EACrE,oHAAoH,EACpH,KAAK,CACN,CAAA;AAEH;;;;GAIG;AACH,SAAS,UAAU,CAAC,IAAY,EAAE,IAAU,EAAE,KAAa;IACzD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;IAC5B,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,KAAK,IAAI;YACP,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;QAC7B,KAAK,YAAY;YACf,MAAM,UAAU,CAAC,KAAK,CAAC,CAAA;QACzB,KAAK,OAAO,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAChC,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAC9B,KAAK,iBAAiB,CAAC;QACvB,KAAK,OAAO;YACV,MAAK;IACT,CAAC;IACD,QAAQ,eAAe,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;QACrC,KAAK,sBAAsB;YACzB,OAAO;gBACL,OAAO,EAAE,SAAS;gBAClB,OAAO;gBACP,IAAI,EAAE,CAAC;gBACP,MAAM,EACJ,8FAA8F;aACjG,CAAA;QACH,KAAK,oBAAoB;YACvB,OAAO;gBACL,OAAO,EAAE,cAAc;gBACvB,OAAO;gBACP,MAAM,EAAE,yDAAyD;aAClE,CAAA;QACH,KAAK,OAAO;YACV,OAAO;gBACL,OAAO,EAAE,cAAc;gBACvB,OAAO;gBACP,MAAM,EAAE,6DAA6D;aACtE,CAAA;QACH,KAAK,wBAAwB;YAC3B,OAAO;gBACL,OAAO,EAAE,cAAc;gBACvB,OAAO;gBACP,MAAM,EACJ,+FAA+F;aAClG,CAAA;QACH,KAAK,UAAU;YACb,MAAK;IACT,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,iBAAiB,EAAE,CAAC;QACrC,OAAO;YACL,OAAO,EAAE,cAAc;YACvB,OAAO;YACP,MAAM,EACJ,2FAA2F;SAC9F,CAAA;IACH,CAAC;IACD,MAAM,IAAI,oBAAoB,CAC5B,8EAA8E,OAAO,EAAE,EACvF,8DAA8D,EAC9D,KAAK,CACN,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,SAAS,CAAC,IAAY,EAAE,IAAU;IACzC,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IAC/C,IAAI,WAAW,KAAK,IAAI,IAAI,KAAK,KAAK,WAAW,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC5E,OAAO;YACL,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,QAAQ,GAAG,CAAC;YACvB,MAAM,EAAE,sEAAsE;SAC/E,CAAA;IACH,CAAC;IACD,OAAO;QACL,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI;QACV,MAAM,EACJ,+FAA+F;YAC/F,uBAAuB;KAC1B,CAAA;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,IAAU;IAC3C,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IAChD,MAAM,MAAM,GAAG,0DAA0D,CAAA;IACzE,MAAM,IAAI,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAA;IACvE,gGAAgG;IAChG,mFAAmF;IACnF,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,sBAAsB,EAAE,CAAC;QAC5D,OAAO;YACL,OAAO,EAAE,SAAS;YAClB,OAAO,EACL,GAAG,IAAI,CAAC,OAAO,wEAAwE;gBACvF,kDAAkD,IAAI,GAAG;YAC3D,IAAI,EAAE,IAAI;YACV,MAAM;SACP,CAAA;IACH,CAAC;IACD,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,OAAO,EAAE,SAAS;YAClB,OAAO,EACL,GAAG,IAAI,CAAC,OAAO,kFAAkF;gBACjG,eAAe,IAAI,GAAG;YACxB,IAAI,EAAE,IAAI;YACV,MAAM;SACP,CAAA;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;AACpE,CAAC;AAED;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,KAAsB,EAAE,MAAc,EAAE,eAAwB;IACzF,KAAK,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QACrB,IAAI,IAAI,KAAK,SAAS;YAAE,SAAQ;QAChC,MAAM,KAAK,GAAG,qBAAqB,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAA;QAClD,IAAI,IAAI,CAAC,KAAK,KAAK,YAAY;YAAE,MAAM,UAAU,CAAC,IAAI,CAAC,CAAA;QACvD,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,IAAI,eAAe;gBAAE,SAAQ;YAC7B,MAAM,IAAI,oBAAoB,CAC5B,WAAW,MAAM,aAAa,KAAK,6BAA6B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO;gBACxF,sDAAsD,EACxD,qBAAqB,gBAAgB,qCAAqC,EAC1E,IAAI,CACL,CAAA;QACH,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACvD,MAAM,IAAI,oBAAoB,CAC5B,WAAW,MAAM,aAAa,KAAK,+CAA+C,IAAI,CAAC,OAAO,EAAE,EAChG,sGAAsG,EACtG,IAAI,CACL,CAAA;QACH,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI;YAAE,SAAQ;QAC/D,MAAM,IAAI,oBAAoB,CAC5B,gDAAgD,gBAAgB,2BAA2B;YACzF,GAAG,MAAM,KAAK,KAAK,wBAAwB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAClE,qBAAqB,gBAAgB,qCAAqC,EAC1E,IAAI,CACL,CAAA;IACH,CAAC;AACH,CAAC;AAED,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;AAE9E,sFAAsF;AACtF,SAAS,cAAc,CAAC,OAAe;IACrC,OAAO,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AAClD,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,SAAc;IAKrC,KAAK,MAAM,GAAG,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,cAAc,CAAC,CAAA;QACjD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAQ;QAC/B,IAAI,GAAY,CAAA;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,gFAAgF;YAChF,OAAO;gBACL,OAAO,EAAE,YAAY;gBACrB,IAAI;gBACJ,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC/D,CAAA;QACH,CAAC;QACD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;QACvD,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,EAAE;YAClD,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE;YACnB,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,CAAA;IACrC,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACjD,CAAC;AAED,SAAS,MAAM,CAAC,QAIf;IACC,IAAI,QAAQ,CAAC,OAAO,KAAK,eAAe,EAAE,CAAC;QACzC,OAAO,IAAI,oBAAoB,CAC7B,6DAA6D,EAC7D,OAAO,EACP,IAAI,CACL,CAAA;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC;QACtC,OAAO,IAAI,oBAAoB,CAC7B,6BAA6B,QAAQ,CAAC,IAAI,IAAI,iBAAiB,0BAA0B;YACvF,GAAG,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,MAAM,GAAG,GAAG,EACpE,sBAAsB,EACtB,IAAI,CACL,CAAA;IACH,CAAC;IACD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,OAAO,IAAI,oBAAoB,CAC7B,WAAW,QAAQ,CAAC,OAAO,gBAAgB,EAC3C,sDAAsD,EACtD,IAAI,CACL,CAAA;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,WAAW,CAAC,OAAgC;IACnD,MAAM,IAAI,GAAG,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAA;IACjF,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1E,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACjD,OAAO,IAAI,oBAAoB,CAC7B,qCAAqC,OAAO,KAAK,IAAI,EAAE,EACvD,OAAO,EACP,IAAI,CACL,CAAA;IACH,CAAC;IACD,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACnB,OAAO,IAAI,oBAAoB,CAC7B,sCAAsC,IAAI,EAAE,EAC5C,KAAK,OAAO,mEAAmE,EAC/E,IAAI,CACL,CAAA;IACH,CAAC;IACD,OAAO,IAAI,oBAAoB,CAC7B,sCAAsC,IAAI,EAAE,EAC5C,GAAG,OAAO,eAAe,IAAI,EAAE,EAC/B,IAAI,CACL,CAAA;AACH,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,mBAAmB,CAAC,OAGnC;IACC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAA;IAC7B,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,CAAC,CAAA;IAC3C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,CACL,KAAwB,EACxB,GAAgE,EAChE,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC;KACpD,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,SAAc,EACd,QAAmE,EACnE,KAAwB,EACxB,GAAgE;IAEhE,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IAChC,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACpD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAA;IAChC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,EAAE;YACnC,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,EAAE,YAAY,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE;SAClF,CAAC,CAAA;QACF,IAAI,QAAQ,GAAkB,IAAI,CAAA;QAClC,IAAI,MAAM,GAAG,KAAK,CAAA;QAClB,IAAI,OAAO,GAAG,KAAK,CAAA;QACnB,4EAA4E;QAC5E,MAAM,MAAM,GAAG,CAAC,MAAkB,EAAQ,EAAE;YAC1C,IAAI,OAAO;gBAAE,OAAM;YACnB,OAAO,GAAG,IAAI,CAAA;YACd,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC5C,KAAK,MAAM,CAAC,SAAS,EAAE,CAAA;YACvB,MAAM,EAAE,CAAA;QACV,CAAC,CAAA;QACD,MAAM,IAAI,GAAG,CAAC,OAA6B,EAAQ,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;QACnF,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,IAAI,CACF,QAAQ,KAAK,IAAI;gBACf,CAAC,CAAC,IAAI,oBAAoB,CACtB,iEAAiE,MAAM,CAAC,QAAQ,CAAC,KAAK,EACtF,2BAA2B,EAC3B,IAAI,CACL;gBACH,CAAC,CAAC,IAAI,oBAAoB,CACtB,kCAAkC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,sBAAsB;oBAC1E,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,EAClC,2FAA2F,EAC3F,QAAQ,CACT,CACN,CAAA;QACH,CAAC,CAAA;QACD,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,EAAE,CAAA;;YACxB,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QAE9D,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAgB,EAAE,EAAE;YACxC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,OAAM;YAC9B,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAChC,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;oBAAE,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAA;YACjE,CAAC;iBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACzC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAA;YAC5B,CAAC;iBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrC,MAAM,GAAG,IAAI,CAAA;gBACb,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAA;gBACpF,IAAI,OAAO,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;oBACjC,IAAI,CACF,IAAI,oBAAoB,CACtB,qCAAqC,OAAO,iBAAiB,QAAQ,CAAC,OAAO,MAAM;wBACjF,gBAAgB,QAAQ,CAAC,IAAI,IAAI,iBAAiB,EAAE,EACtD,qEAAqE,EACrE,IAAI,CACL,CACF,CAAA;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBACvC,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;gBACtD,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;gBACzE,IAAI,CAAC,MAAM,IAAI,KAAK,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;oBACpD,IAAI,CACF,IAAI,oBAAoB,CACtB,6DAA6D,EAC7D,4DAA4D,EAC5D,IAAI,CACL,CACF,CAAA;oBACD,OAAM;gBACR,CAAC;gBACD,0FAA0F;gBAC1F,+CAA+C;gBAC/C,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;oBAC5E,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAChC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CACrE,CAAA;oBACD,iBAAiB,CAAC,SAAS,EAAE,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,CAAA;oBAC/D,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;gBAChD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CACF,KAAK,YAAY,oBAAoB;wBACnC,CAAC,CAAC,KAAK;wBACP,CAAC,CAAC,IAAI,oBAAoB,CACtB,qDAAqD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC7G,oCAAoC,EACpC,IAAI,CACL,CACN,CAAA;gBACH,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAA;QACF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;YAClC,IAAI,CAAC,WAAW,CAAC,6BAA6B,KAAK,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAA;QAC3E,CAAC,CAAC,CAAA;QACF,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YACjC,IAAI,CACF,WAAW,CAAC,mCAAmC,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAC3F,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,QAAuB;IACxD,OAAO,IAAI,oBAAoB,CAC7B,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,wBAAwB,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,EAChF,2FAA2F,EAC3F,QAAQ,CACT,CAAA;AACH,CAAC"}

package/dist/mermaid-js/mermaid-parser.d.ts

@@ -0,0 +1,17 @@
+import { type MermaidParser } from './create-mermaid-parser.js';
+/**
+ * Mermaid's own parser, for eess-md's `parseCodeBlocks` (plan 0413): it says whether a block
+ * parses with the `mermaid` package GitHub renders with. It is not `parseClassDiagram`, which is
+ * eess's own grammar, used to bind a diagram to code.
+ *
+ * `mermaid` (11) and `jsdom` are optional peers, loaded only inside a worker thread, so the DOM
+ * globals Mermaid needs never reach the caller's process. Never throws: a missing peer is reported
+ * by `parse`, as the instrument.
+ *
+ * ```ts
+ * const parsed = await parseCodeBlocks(corpus, { language: 'mermaid', parser: mermaidParser() })
+ * codeBlocks(parsed).should().parse().check()
+ * ```
+ */
+export declare function mermaidParser(): MermaidParser;
+//# sourceMappingURL=mermaid-parser.d.ts.map

package/dist/mermaid-js/mermaid-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid-parser.d.ts","sourceRoot":"","sources":["../../src/mermaid-js/mermaid-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAEpF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,IAAI,aAAa,CAE7C"}

package/dist/mermaid-js/mermaid-parser.js

@@ -0,0 +1,19 @@
+import { createMermaidParser } from './create-mermaid-parser.js';
+/**
+ * Mermaid's own parser, for eess-md's `parseCodeBlocks` (plan 0413): it says whether a block
+ * parses with the `mermaid` package GitHub renders with. It is not `parseClassDiagram`, which is
+ * eess's own grammar, used to bind a diagram to code.
+ *
+ * `mermaid` (11) and `jsdom` are optional peers, loaded only inside a worker thread, so the DOM
+ * globals Mermaid needs never reach the caller's process. Never throws: a missing peer is reported
+ * by `parse`, as the instrument.
+ *
+ * ```ts
+ * const parsed = await parseCodeBlocks(corpus, { language: 'mermaid', parser: mermaidParser() })
+ * codeBlocks(parsed).should().parse().check()
+ * ```
+ */
+export function mermaidParser() {
+    return createMermaidParser({ workerUrl: new URL('./mermaid-worker.mjs', import.meta.url) });
+}
+//# sourceMappingURL=mermaid-parser.js.map

package/dist/mermaid-js/mermaid-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid-parser.js","sourceRoot":"","sources":["../../src/mermaid-js/mermaid-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAsB,MAAM,4BAA4B,CAAA;AAEpF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,mBAAmB,CAAC,EAAE,SAAS,EAAE,IAAI,GAAG,CAAC,sBAAsB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;AAC7F,CAAC"}

package/dist/mermaid-js/mermaid-worker.mjs

@@ -0,0 +1,144 @@
+// eess-mermaid's Mermaid worker (plan 0413). It runs `mermaid.parse` under a `jsdom` window on its
+// own thread, so the DOM globals Mermaid needs never reach the host's.
+//
+// Self-contained on purpose: it imports only Node built-ins, `mermaid` and `jsdom`, with no relative
+// import, so a copy of this one file runs wherever those two resolve. It is plain JavaScript because
+// no loader transforms a worker's own imports: the resolve hook ADR-015 allows is in-thread and
+// does not reach a worker.
+//
+// It posts facts and decides nothing. An error loses its `hash` and `result` crossing `postMessage`,
+// so each one is read here, where it was thrown, and only plain data is posted. Which outcome a fact
+// is, and on which line, is the host's (`create-mermaid-parser.ts`). The messages:
+//   { type: 'loaded', version }                     once, after `mermaid` and `jsdom` load
+//   { type: 'load-error', code, missing, message }  when they do not
+//   { type: 'progress', index }                     before each of `workerData.texts`
+//   { type: 'verdicts', results, privateResults }   one fact per text, at the end
+// A fact is { shape, locFirstLine, hashLine, langiumLines, yamlLine, yamlText, message }.
+// `workerData.privateTexts` are parsed first and post no `progress`, so the indexes stay the caller's.
+import { existsSync, readFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { parentPort, workerData } from 'node:worker_threads'
+
+/** The version of the `mermaid` this worker imports: up from its resolved entry to its package.json. */
+function loadedVersion() {
+  let dir = dirname(fileURLToPath(import.meta.resolve('mermaid')))
+  for (;;) {
+    const file = join(dir, 'package.json')
+    if (existsSync(file)) {
+      const pkg = JSON.parse(readFileSync(file, 'utf8'))
+      if (pkg?.name === 'mermaid')
+        return typeof pkg.version === 'string' ? pkg.version : 'unreadable'
+    }
+    const up = dirname(dir)
+    if (up === dir) return 'unreadable'
+    dir = up
+  }
+}
+
+const finite = (value) => (typeof value === 'number' && Number.isFinite(value) ? value : null)
+
+/** One error, read by property, never by class name or message. */
+function errorFact(error) {
+  const message = String(error?.message ?? error)
+  const fact = {
+    shape: 'other',
+    locFirstLine: null,
+    hashLine: null,
+    langiumLines: [],
+    yamlLine: null,
+    yamlText: null,
+    message,
+  }
+  if (typeof error?.hash === 'object' && error.hash !== null) {
+    return {
+      ...fact,
+      shape: 'jison',
+      locFirstLine: finite(error.hash.loc?.first_line),
+      hashLine: finite(error.hash.line),
+    }
+  }
+  const result = error?.result
+  if (Array.isArray(result?.lexerErrors) && Array.isArray(result?.parserErrors)) {
+    const lines = [
+      ...result.lexerErrors.map((e) => finite(e?.line)),
+      ...result.parserErrors.map((e) => finite(e?.token?.startLine)),
+    ].filter((line) => line !== null)
+    return { ...fact, shape: 'langium', langiumLines: lines }
+  }
+  if (error?.name === 'UnknownDiagramError') return { ...fact, shape: 'unknown-diagram' }
+  // YAML Mermaid could not read: js-yaml's error, with its 0-based line and the YAML it was given,
+  // which may be the frontmatter or a node's `@{ … }` data.
+  if (error?.name === 'YAMLException') {
+    const buffer = error.mark?.buffer
+    return {
+      ...fact,
+      shape: 'yaml',
+      yamlLine: finite(error.mark?.line),
+      yamlText: typeof buffer === 'string' ? buffer : null,
+    }
+  }
+  return fact
+}
+
+async function parseOne(mermaid, text) {
+  try {
+    const result = await mermaid.parse(text)
+    if (typeof result !== 'object' || result === null) {
+      return {
+        shape: 'non-result',
+        locFirstLine: null,
+        hashLine: null,
+        langiumLines: [],
+        yamlLine: null,
+        yamlText: null,
+        message: String(result),
+      }
+    }
+    return {
+      shape: 'ok',
+      locFirstLine: null,
+      hashLine: null,
+      langiumLines: [],
+      yamlLine: null,
+      yamlText: null,
+      message: '',
+    }
+  } catch (error) {
+    return errorFact(error)
+  }
+}
+
+async function main() {
+  let mermaid
+  let version
+  try {
+    const { JSDOM } = await import('jsdom')
+    const dom = new JSDOM('<!doctype html><html><body></body></html>')
+    for (const key of ['window', 'document', 'DOMParser', 'Element', 'HTMLElement', 'Node']) {
+      if (!(key in globalThis)) globalThis[key] = key === 'window' ? dom.window : dom.window[key]
+    }
+    mermaid = (await import('mermaid')).default
+    version = loadedVersion()
+  } catch (error) {
+    const message = String(error?.message ?? error)
+    parentPort.postMessage({
+      type: 'load-error',
+      code: typeof error?.code === 'string' ? error.code : '',
+      missing: /Cannot find package '([^']+)'/.exec(message)?.[1] ?? '',
+      message,
+    })
+    return
+  }
+  parentPort.postMessage({ type: 'loaded', version })
+  const privateResults = []
+  for (const text of workerData.privateTexts) privateResults.push(await parseOne(mermaid, text))
+  const results = []
+  for (const [index, text] of workerData.texts.entries()) {
+    parentPort.postMessage({ type: 'progress', index })
+    results.push(await parseOne(mermaid, text))
+  }
+  parentPort.postMessage({ type: 'verdicts', results, privateResults })
+}
+
+await main()

package/dist/parser/diagram-kind.d.ts

@@ -8,4 +8,20 @@
  * binding tested the raw text and missed a themed diagram entirely (bug 0210).
  */
 export declare function diagramKind(text: string): string;
+/**
+ * Why a block declares the kind it does (plan 0413). `declared` when the walk finds a kind; otherwise
+ * the first that holds of: Mermaid sees frontmatter it cannot close (`unclosed-frontmatter`), a `%%{`
+ * directive never closes (`unclosed-directive`), the block is blank (`empty`), or something precedes
+ * no kind (`no-kind-after-preamble`). Internal to eess-mermaid: no adopter needs the reason.
+ */
+type PreambleReason = 'declared' | 'empty' | 'no-kind-after-preamble' | 'unclosed-directive' | 'unclosed-frontmatter';
+interface DiagramPreamble {
+    /** As `diagramKind` returns it: the kind token, or `''`. */
+    readonly kind: string;
+    /** The 1-based block line the kind is declared on, or `null` when none is. */
+    readonly kindLine: number | null;
+    readonly reason: PreambleReason;
+}
+export declare function diagramPreamble(text: string): DiagramPreamble;
+export {};
 //# sourceMappingURL=diagram-kind.d.ts.map

package/dist/parser/diagram-kind.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagram-kind.d.ts","sourceRoot":"","sources":["../../src/parser/diagram-kind.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD"}
+{"version":3,"file":"diagram-kind.d.ts","sourceRoot":"","sources":["../../src/parser/diagram-kind.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIhD;AAMD;;;;;GAKG;AACH,KAAK,cAAc,GACf,UAAU,GACV,OAAO,GACP,wBAAwB,GACxB,oBAAoB,GACpB,sBAAsB,CAAA;AAE1B,UAAU,eAAe;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;CAChC;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAa7D"}

package/dist/parser/diagram-kind.js

@@ -1,3 +1,4 @@
+import { mermaidPreprocessed } from './mermaid-line-map.js';
 /**
  * The declared kind of a Mermaid diagram (plan 0214): the first token of the line that declares it,
  * such as `erDiagram`, `graph` or `stateDiagram-v2`, or `''` when the text declares none.
@@ -8,7 +9,29 @@
  * binding tested the raw text and missed a themed diagram entirely (bug 0210).
  */
 export function diagramKind(text) {
-    return (declaredLine(text).split(/[\s{]/)[0] ?? '').trim();
+    // The walk alone: the reason below needs Mermaid's preprocessing, and the bindings that select
+    // blocks by kind need neither its cost nor its dependence on one Mermaid version.
+    return kindOf(declaredLine(text).line);
+}
+function kindOf(line) {
+    return (line.split(/[\s{]/)[0] ?? '').trim();
+}
+export function diagramPreamble(text) {
+    const walked = declaredLine(text);
+    const kind = kindOf(walked.line);
+    // Mermaid's own test for frontmatter it could not read: what is left after its preprocessing
+    // still begins with `---` (its `---` diagram detector). The same steps as the line map, so the
+    // two cannot disagree about it.
+    if (/^---/.test(mermaidPreprocessed(text).text.toLowerCase())) {
+        return { kind, kindLine: walked.at, reason: 'unclosed-frontmatter' };
+    }
+    if (kind !== '')
+        return { kind, kindLine: walked.at, reason: 'declared' };
+    if (walked.inDirective)
+        return { kind, kindLine: null, reason: 'unclosed-directive' };
+    if (text.trim() === '')
+        return { kind, kindLine: null, reason: 'empty' };
+    return { kind, kindLine: null, reason: 'no-kind-after-preamble' };
 }
 function declaredLine(text) {
     const lines = text.split(/\r?\n/);
@@ -21,24 +44,30 @@ function declaredLine(text) {
     }
     let inDirective = false;
     for (; i < lines.length; i += 1) {
-        const line = lines[i]?.trim() ?? '';
-        if (line === '')
-            continue;
+        let line = lines[i]?.trim() ?? '';
         // `%%{ … }%%` may span lines. Track it, or the continuation line gets read as the declared kind:
-        // measured, a multi-line init block ahead of a sequenceDiagram made it selected.
+        // measured, a multi-line init block ahead of a sequenceDiagram made it selected. A directive
+        // closes at its FIRST `}%%`, wherever it is on the line, as Mermaid's own pattern does; what
+        // follows is read as the rest of the line (bug 0429: `%%{init}%% %% note` stayed open).
         if (inDirective) {
-            if (line.endsWith('}%%'))
-                inDirective = false;
-            continue;
+            const close = line.indexOf('}%%');
+            if (close === -1)
+                continue;
+            inDirective = false;
+            line = line.slice(close + 3).trim();
         }
-        if (line.startsWith('%%{') && !line.endsWith('}%%')) {
-            inDirective = true;
-            continue;
+        while (line.startsWith('%%{')) {
+            const close = line.indexOf('}%%');
+            if (close === -1) {
+                inDirective = true;
+                break;
+            }
+            line = line.slice(close + 3).trim();
         }
-        if (line.startsWith('%%'))
+        if (inDirective || line === '' || line.startsWith('%%'))
             continue;
-        return line;
+        return { line, at: i + 1, inDirective: false };
     }
-    return '';
+    return { line: '', at: null, inDirective };
 }
 //# sourceMappingURL=diagram-kind.js.map

package/dist/parser/diagram-kind.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagram-kind.js","sourceRoot":"","sources":["../../src/parser/diagram-kind.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;AAC5D,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACjC,IAAI,CAAC,GAAG,CAAC,CAAA;IACT,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;QAC/B,CAAC,GAAG,CAAC,CAAA;QACL,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,KAAK;YAAE,CAAC,IAAI,CAAC,CAAA;QAC7D,CAAC,IAAI,CAAC,CAAA;IACR,CAAC;IACD,IAAI,WAAW,GAAG,KAAK,CAAA;IACvB,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;QACnC,IAAI,IAAI,KAAK,EAAE;YAAE,SAAQ;QACzB,iGAAiG;QACjG,iFAAiF;QACjF,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,WAAW,GAAG,KAAK,CAAA;YAC7C,SAAQ;QACV,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,WAAW,GAAG,IAAI,CAAA;YAClB,SAAQ;QACV,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAQ;QACnC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC"}
+{"version":3,"file":"diagram-kind.js","sourceRoot":"","sources":["../../src/parser/diagram-kind.ts"],"names":[],"mappings":"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"}

package/dist/parser/mermaid-line-map.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Where Mermaid's line is in the block (plan 0413, spike 0428). Mermaid counts an error's line on the
+ * text it has preprocessed, not on the block: it drops frontmatter with the blank lines after it,
+ * collapses a multi-line directive, and removes every whole-line `%%` comment with the blank lines
+ * before it. This mirrors those steps on the block while carrying each UTF-16 unit's origin line.
+ *
+ * The regexes are mermaid 11.17.2's, from `preprocessDiagram` in `dist/mermaid.core.mjs`: the CRLF
+ * rewrite and the comment removal are its own, the frontmatter regex is `frontMatterRegex` and the
+ * directive regex is `directiveRegex`. The line canary (`create-mermaid-parser.ts`) reds when an
+ * installed `mermaid` stops agreeing with them.
+ */
+interface Traced {
+    readonly text: string;
+    /** The block line (1-based) each UTF-16 unit of `text` came from. */
+    readonly origin: readonly number[];
+}
+/**
+ * The YAML of the block's frontmatter as Mermaid hands it to js-yaml (its indent removed from each
+ * line, as `extractFrontMatter` does), or `null` when the line map reads no frontmatter.
+ */
+export declare function frontmatterYaml(text: string): string | null;
+/** The text Mermaid parses, as its four line-moving steps leave it, with each unit's origin line. */
+export declare function mermaidPreprocessed(text: string): Traced;
+/**
+ * A function from Mermaid's 1-based line to the block's, or `null` when Mermaid's text has no such
+ * line.
+ */
+export declare function mermaidLineMap(text: string): (mermaidLine: number) => number | null;
+/**
+ * Does any line of the block carry a `%%` comment after other text? Two of Mermaid's lexers lose
+ * lines after one (spike 0428 Q2), so a verdict for such a block claims no line. Read after the
+ * frontmatter and directive steps, so a directive's own closing `}%%` is not a comment.
+ */
+export declare function hasTrailingComment(text: string): boolean;
+export {};
+//# sourceMappingURL=mermaid-line-map.d.ts.map

package/dist/parser/mermaid-line-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid-line-map.d.ts","sourceRoot":"","sources":["../../src/parser/mermaid-line-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,UAAU,MAAM;IACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CACnC;AAkCD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU3D;AAOD,qGAAqG;AACrG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CASnF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/parser/mermaid-line-map.js

@@ -0,0 +1,101 @@
+/**
+ * Where Mermaid's line is in the block (plan 0413, spike 0428). Mermaid counts an error's line on the
+ * text it has preprocessed, not on the block: it drops frontmatter with the blank lines after it,
+ * collapses a multi-line directive, and removes every whole-line `%%` comment with the blank lines
+ * before it. This mirrors those steps on the block while carrying each UTF-16 unit's origin line.
+ *
+ * The regexes are mermaid 11.17.2's, from `preprocessDiagram` in `dist/mermaid.core.mjs`: the CRLF
+ * rewrite and the comment removal are its own, the frontmatter regex is `frontMatterRegex` and the
+ * directive regex is `directiveRegex`. The line canary (`create-mermaid-parser.ts`) reds when an
+ * installed `mermaid` stops agreeing with them.
+ */
+const FRONTMATTER = /^([^\S\n\r]*)-{3}\s*[\n\r](.*?)[\n\r]\1-{3}\s*[\n\r]+/s;
+const DIRECTIVE = /%{2}{\s*(?:(\w+)\s*:|(\w+))\s*(?:(\w+)|((?:(?!}%{2}).|\r?\n)*))?\s*(?:}%{2})?/gi;
+const COMMENT = /^\s*%%(?!{)[^\n]+\n?/gm;
+/** A line whose first non-blank text is not `%%` and that holds `%%` later: a trailing comment. */
+const TRAILING_COMMENT = /^[^\S\n]*(?!%%)\S[^\n]*%%/m;
+function cut(traced, pattern) {
+    const global = pattern.global ? pattern : new RegExp(pattern.source, `${pattern.flags}g`);
+    let text = '';
+    const origin = [];
+    let last = 0;
+    for (const match of traced.text.matchAll(global)) {
+        text += traced.text.slice(last, match.index);
+        // A loop, not a spread: a spread of a block-sized array overflows the stack (PR review, 300 KB).
+        for (let i = last; i < match.index; i += 1) {
+            const line = traced.origin[i];
+            if (line !== undefined)
+                origin.push(line);
+        }
+        last = match.index + match[0].length;
+        if (!pattern.global)
+            break;
+    }
+    return {
+        text: text + traced.text.slice(last),
+        origin: origin.concat(traced.origin.slice(last)),
+    };
+}
+function trace(text) {
+    const normalised = text.replace(/\r\n?/g, '\n');
+    const origin = [];
+    let line = 1;
+    for (let i = 0; i < normalised.length; i += 1) {
+        origin.push(line);
+        if (normalised[i] === '\n')
+            line += 1;
+    }
+    return { text: normalised, origin };
+}
+/**
+ * The YAML of the block's frontmatter as Mermaid hands it to js-yaml (its indent removed from each
+ * line, as `extractFrontMatter` does), or `null` when the line map reads no frontmatter.
+ */
+export function frontmatterYaml(text) {
+    const match = FRONTMATTER.exec(trace(text).text);
+    if (match === null)
+        return null;
+    const indent = match[1] ?? '';
+    const body = match[2] ?? '';
+    if (indent === '')
+        return body;
+    return body
+        .split('\n')
+        .map((line) => (line.startsWith(indent) ? line.slice(indent.length) : line))
+        .join('\n');
+}
+/** The text after Mermaid's frontmatter and directive steps, before its comment removal. */
+function withoutPreamble(text) {
+    return cut(cut(trace(text), FRONTMATTER), DIRECTIVE);
+}
+/** The text Mermaid parses, as its four line-moving steps leave it, with each unit's origin line. */
+export function mermaidPreprocessed(text) {
+    const uncommented = cut(withoutPreamble(text), COMMENT);
+    const lead = uncommented.text.length - uncommented.text.trimStart().length;
+    return { text: uncommented.text.slice(lead), origin: uncommented.origin.slice(lead) };
+}
+/**
+ * A function from Mermaid's 1-based line to the block's, or `null` when Mermaid's text has no such
+ * line.
+ */
+export function mermaidLineMap(text) {
+    const { text: parsed, origin } = mermaidPreprocessed(text);
+    const starts = [];
+    if (origin[0] !== undefined)
+        starts.push(origin[0]);
+    for (let i = 0; i < parsed.length - 1; i += 1) {
+        const next = origin[i + 1];
+        if (parsed[i] === '\n' && next !== undefined)
+            starts.push(next);
+    }
+    return (mermaidLine) => starts[mermaidLine - 1] ?? null;
+}
+/**
+ * Does any line of the block carry a `%%` comment after other text? Two of Mermaid's lexers lose
+ * lines after one (spike 0428 Q2), so a verdict for such a block claims no line. Read after the
+ * frontmatter and directive steps, so a directive's own closing `}%%` is not a comment.
+ */
+export function hasTrailingComment(text) {
+    return TRAILING_COMMENT.test(withoutPreamble(text).text);
+}
+//# sourceMappingURL=mermaid-line-map.js.map

package/dist/parser/mermaid-line-map.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nielspeter/eess-mermaid",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Architecture testing for Mermaid class diagrams — the Mermaid dialect of the eess family (formerly mermaidunit)",
   "type": "module",
   "exports": {
@@ -27,11 +27,23 @@
   },
   "author": "Niels Peter",
   "license": "MIT",
+  "peerDependencies": {
+    "jsdom": ">=29.1.1",
+    "mermaid": "^11.0.0"
+  },
+  "peerDependenciesMeta": {
+    "jsdom": {
+      "optional": true
+    },
+    "mermaid": {
+      "optional": true
+    }
+  },
   "scripts": {
     "prepublishOnly": "npm run build",
     "langium:gen": "langium generate --file langium-config.json",
     "prebuild": "rm -rf dist",
-    "build": "npm run langium:gen && tsc -p tsconfig.build.json && chmod +x dist/cli/bin.js",
+    "build": "npm run langium:gen && tsc -p tsconfig.build.json && node -e \"require('node:fs').cpSync('src/mermaid-js/mermaid-worker.mjs', 'dist/mermaid-js/mermaid-worker.mjs')\" && chmod +x dist/cli/bin.js",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit"
@@ -44,8 +56,12 @@
     "eess"
   ],
   "dependencies": {
-    "@nielspeter/eess": "^0.7.0",
+    "@nielspeter/eess": "^0.7.1",
     "jiti": "^2.7.0",
     "langium": "^4.2.3"
+  },
+  "devDependencies": {
+    "jsdom": "29.1.1",
+    "mermaid": "11.17.2"
   }
 }