@graphty/graph-io 0.3.25 → 0.3.27

package/dist/src/common/direction.d.ts

@@ -24,14 +24,14 @@ import { DIRECTION_FORCED_CODE, DIRECTION_REFUSED_CODE, MIXED_DIRECTION_CODE } f
 import { type ImportReportBuilder } from "./report.js";
 /**
  * The direction of one source edge.
- * Consumed by the per-format importers and exporters under src/formats.
  * @public
+ * @category Plugin helpers
  */
 export type EdgeKind = "directed" | "undirected" | "mutual";
 /**
  * Where an edge or header was read, for issues.
- * Consumed by the per-format importers and exporters under src/formats.
  * @public
+ * @category Plugin helpers
  */
 export interface EdgeLocation {
     /** The 1-based line, when known. */
@@ -39,16 +39,30 @@ export interface EdgeLocation {
     /** The edge id or another element name, when known. */
     readonly element?: string | null | undefined;
 }
-/** The name of the bool edge column marking source-directed edges (design section 3.6). */
+/**
+ * The name of the bool edge column that, in a graph with both directed and undirected edges, says
+ * which edges were directed in the file (true) and which were undirected (false).
+ * @category Plugin helpers
+ */
 export declare const DIRECTED_COLUMN = "graphty.directed";
-/** The name of the u32 edge column pairing the halves of an expanded edge (design section 3.6). */
+/**
+ * The name of the edge column that links the two edges an undirected edge is stored as, in a graph
+ * with both directed and undirected edges: each holds the index of the other.
+ * @category Plugin helpers
+ */
 export declare const PAIR_COLUMN = "graphty.pair";
-/** The name of the bool edge column marking GEXF mutual edges (design section 3.6). */
+/**
+ * The name of the bool edge column that marks a GEXF `mutual` edge.
+ * @category Plugin helpers
+ */
 export declare const MUTUAL_COLUMN = "graphty.mutual";
 export { DIRECTION_FORCED_CODE, DIRECTION_REFUSED_CODE, MIXED_DIRECTION_CODE };
 /**
- * Pushes edges into a sink while resolving direction per design section 8.4. One instance per
- * import call; `setHeader()` before the first `addEdge()`.
+ * Adds edges to the sink and handles files whose edges have different directions, the way
+ * `onMixedDirection` asks. Make one per import call, call `setHeader()` once with the direction the
+ * file declares, then `addEdge()` for each edge. In a directed graph an undirected edge is stored as
+ * two edges, one each way, linked so an exporter writes them back as one.
+ * @category Writing a format
  */
 export declare class DirectionResolver {
     private readonly sink;
@@ -77,17 +91,16 @@ export declare class DirectionResolver {
      */
     get directed(): boolean;
     /**
-     * Whether the reserved direction columns exist (the sink holds expanded edges).
-     * @returns true once graphty.pair was declared or adopted
+     * Whether the graph holds undirected edges stored as two edges.
+     * @returns true once the first such edge was added
      */
     get expanded(): boolean;
     /**
-     * Rule 1 of design section 8.4: set the sink's direction from the file's header (or the
-     * `defaultDirected` option for a file that declares none) before the first edge. Under the
-     * "directed" / "undirected" policies the policy's direction is used instead and the difference
-     * is reported. A refusal (E_DIRECTED: locked, or a non-empty directed sink for an undirected
-     * header) is recorded as a coercion issue and the sink's direction stands; a non-empty unlocked
-     * undirected sink with a directed header is expanded in place.
+     * Set the graph's direction before the first edge: the direction the file declares, or the
+     * `defaultDirected` option for a file that declares none. Under `onMixedDirection` "directed" or
+     * "undirected" that direction is used instead, with a warning when it differs. When the sink
+     * cannot change direction (a caller's builder that already holds edges or was locked), the
+     * sink's direction stands and a warning is recorded.
      * @param headerDirected - the direction the file declares (or the default)
      * @param where - the line of the header, when known
      */
@@ -98,25 +111,29 @@ export declare class DirectionResolver {
      */
     private adoptExisting;
     /**
-     * The mirror half of the edge most recently pushed by addEdge(), when it was expanded into a
-     * pair; INVALID_INDEX otherwise. An importer that learns an edge's weight after pushing it
-     * (a GEXF attvalue) sets it on both halves.
-     * @returns the mirror's logical index, or INVALID_INDEX
+     * The second edge of the edge the last addEdge() call added, when that edge was stored as two;
+     * otherwise INVALID_INDEX (4294967295). An edge attribute or weight you set after addEdge()
+     * belongs on both: set it on the index addEdge() returned and, when this is not INVALID_INDEX,
+     * on this index too.
+     * @returns the second edge's index, or INVALID_INDEX
      */
     get lastMirror(): number;
     /**
-     * Rule 2 of design section 8.4: push one source edge. An edge whose direction equals the
-     * sink's is one addEdge; one that differs is expanded, forced or refused per the policy.
+     * Add one edge. An edge with the graph's direction is added as it is; one with the other
+     * direction is stored as two edges, given the graph's direction, or refused, as
+     * `onMixedDirection` says. When it is stored as two, the return value is the first and
+     * `lastMirror` the second.
      * @param source - the source id
      * @param target - the target id
      * @param kind - the edge's direction in the file
      * @param weight - the weight, or undefined when the file gives none
      * @param where - the line and element, for issues
-     * @returns the logical index of the (primary) edge
+     * @returns the index of the edge added (the first one, when it was stored as two)
      */
     addEdge(source: NodeId, target: NodeId, kind: EdgeKind, weight?: number, where?: EdgeLocation): number;
     /**
-     * How many edges were pushed with a direction other than their own under the forcing policies.
+     * How many edges were given a direction other than their own, under `onMixedDirection`
+     * "directed" or "undirected".
      * @returns the count
      */
     get forced(): number;
@@ -148,59 +165,66 @@ export declare class DirectionResolver {
     private ensureMutualColumn;
 }
 /**
- * The expanded-pair view of a snapshot's logical edges for exporters (design sections 3.6 and
- * 8.5): which edges are the mirror half of an expanded pair (and are folded back into their
- * primary), which were undirected in the source, and which carry the GEXF mutual mark. One
- * implementation for every exporter; the only per-format choice is whether a mutual pair folds
- * back into one edge (`foldMutual`, for formats with a mutual or undirected slot) or is written as
- * two directed edges (the default).
- * Consumed by the per-format exporters under src/formats.
+ * What an exporter needs to know about edge direction, from `pairFolding(snapshot)`. In a graph
+ * with both directed and undirected edges, each undirected edge is stored as two edges, one each
+ * way. `folded(e)` tells you which of the two to skip, so the edge is written once, and
+ * `sourceDirected(e)` whether an edge was directed. A GEXF `mutual` edge is also stored as two
+ * edges; it is written as two directed edges unless you pass `foldMutual: true`.
  * @public
+ * @category Plugin helpers
  */
 export interface PairFolding {
-    /** Whether the snapshot carries expanded pairs at all (the pair role column exists). */
+    /** Whether the graph holds any edge stored as two edges. When false, every method answers as for a plain edge. */
     readonly expanded: boolean;
-    /** The number of mutual primaries (edges with the mutual mark whose mirror exists). */
+    /** How many GEXF mutual edges the graph holds, each counted once. */
     readonly mutualCount: number;
     /**
-     * Whether an edge is the mirror half of a pair the exporter folds (its primary is written).
-     * @param e - the logical edge index
+     * Whether to skip an edge: true for the second of the two edges an undirected edge (or, with
+     * `foldMutual`, a mutual edge) is stored as. Write the first and skip this one.
+     * @param e - the edge index
      * @returns true when the edge must be skipped
      */
     folded(e: number): boolean;
     /**
-     * The other half of an expanded pair.
-     * @param e - the logical edge index
-     * @returns the mate's index, or INVALID_INDEX when the edge is not paired
+     * The other of the two edges an undirected or mutual edge is stored as.
+     * @param e - the edge index
+     * @returns the other edge's index, or INVALID_INDEX (4294967295) for an edge stored once
      */
     mateOf(e: number): number;
     /**
-     * Whether an edge was directed in the source (true for every edge of a snapshot without the
-     * directed role column, and for an undirected snapshot's edges as far as the column says).
-     * @param e - the logical edge index
-     * @returns the source direction
+     * Whether an edge was directed in the file it was read from: false for an undirected edge of a
+     * graph with both kinds. It is true for every edge of a graph without mixed direction, an
+     * undirected graph included, so the direction to write for edge `e` is
+     * `snapshot.directed && sourceDirected(e)`.
+     * @param e - the edge index
+     * @returns whether the edge is directed
      */
     sourceDirected(e: number): boolean;
     /**
-     * Whether an edge is a mutual primary or mirror (the GEXF `mutual` type).
-     * @param e - the logical edge index
+     * Whether an edge is either of the two edges a GEXF `mutual` edge is stored as.
+     * @param e - the edge index
      * @returns true for a mutual edge
      */
     isMutual(e: number): boolean;
 }
-/** The per-format choice of pairFolding(). */
+/**
+ * The per-format choice of pairFolding().
+ * @category Plugin helpers
+ */
 export interface PairFoldingOptions {
     /**
-     * Fold a mutual pair back into its primary (a format with a mutual or undirected slot);
-     * false (the default) writes both halves as directed edges, and the caller reports the mark.
+     * Write a GEXF mutual edge once, for a format that can say an edge goes both ways. When false
+     * (the default), `folded()` keeps both of its edges, so it is written as two directed edges.
      */
     readonly foldMutual?: boolean | undefined;
 }
 /**
- * Build the pair-folding view of a snapshot (one pass over the role columns).
- * @param snapshot - the snapshot
- * @param options - the per-format choice
- * @returns the view
+ * Read how a snapshot stores edge direction, for an exporter: which edges to skip so each
+ * undirected edge is written once, and which edges were directed.
+ * @param snapshot - the graph to write
+ * @param options - whether a GEXF mutual edge is written once
+ * @returns the answers, per edge
+ * @category Writing a format
  */
 export declare function pairFolding(snapshot: GraphSnapshot, options?: PairFoldingOptions): PairFolding;
 //# sourceMappingURL=direction.d.ts.map

package/dist/src/common/direction.d.ts.map

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

package/dist/src/common/direction.js

@@ -21,19 +21,33 @@
  */
 import { GraphFormatError, INVALID_INDEX, } from "@graphty/graph-format";
 import { DIRECTION_FORCED_CODE, DIRECTION_REFUSED_CODE, MIXED_DIRECTION_CODE } from "./codes.js";
-/** The name of the bool edge column marking source-directed edges (design section 3.6). */
+/**
+ * The name of the bool edge column that, in a graph with both directed and undirected edges, says
+ * which edges were directed in the file (true) and which were undirected (false).
+ * @category Plugin helpers
+ */
 export const DIRECTED_COLUMN = "graphty.directed";
-/** The name of the u32 edge column pairing the halves of an expanded edge (design section 3.6). */
+/**
+ * The name of the edge column that links the two edges an undirected edge is stored as, in a graph
+ * with both directed and undirected edges: each holds the index of the other.
+ * @category Plugin helpers
+ */
 export const PAIR_COLUMN = "graphty.pair";
-/** The name of the bool edge column marking GEXF mutual edges (design section 3.6). */
+/**
+ * The name of the bool edge column that marks a GEXF `mutual` edge.
+ * @category Plugin helpers
+ */
 export const MUTUAL_COLUMN = "graphty.mutual";
 export { DIRECTION_FORCED_CODE, DIRECTION_REFUSED_CODE, MIXED_DIRECTION_CODE };
 const DIRECTED_DECL = { name: DIRECTED_COLUMN, dtype: "bool", role: "directed" };
 const PAIR_DECL = { name: PAIR_COLUMN, dtype: "u32", role: "pair", refersTo: "edge" };
 const MUTUAL_DECL = { name: MUTUAL_COLUMN, dtype: "bool", role: "mutual" };
 /**
- * Pushes edges into a sink while resolving direction per design section 8.4. One instance per
- * import call; `setHeader()` before the first `addEdge()`.
+ * Adds edges to the sink and handles files whose edges have different directions, the way
+ * `onMixedDirection` asks. Make one per import call, call `setHeader()` once with the direction the
+ * file declares, then `addEdge()` for each edge. In a directed graph an undirected edge is stored as
+ * two edges, one each way, linked so an exporter writes them back as one.
+ * @category Writing a format
  */
 export class DirectionResolver {
     /**
@@ -65,19 +79,18 @@ export class DirectionResolver {
         return this.sink.directed;
     }
     /**
-     * Whether the reserved direction columns exist (the sink holds expanded edges).
-     * @returns true once graphty.pair was declared or adopted
+     * Whether the graph holds undirected edges stored as two edges.
+     * @returns true once the first such edge was added
      */
     get expanded() {
         return this.pairHandle !== INVALID_INDEX;
     }
     /**
-     * Rule 1 of design section 8.4: set the sink's direction from the file's header (or the
-     * `defaultDirected` option for a file that declares none) before the first edge. Under the
-     * "directed" / "undirected" policies the policy's direction is used instead and the difference
-     * is reported. A refusal (E_DIRECTED: locked, or a non-empty directed sink for an undirected
-     * header) is recorded as a coercion issue and the sink's direction stands; a non-empty unlocked
-     * undirected sink with a directed header is expanded in place.
+     * Set the graph's direction before the first edge: the direction the file declares, or the
+     * `defaultDirected` option for a file that declares none. Under `onMixedDirection` "directed" or
+     * "undirected" that direction is used instead, with a warning when it differs. When the sink
+     * cannot change direction (a caller's builder that already holds edges or was locked), the
+     * sink's direction stands and a warning is recorded.
      * @param headerDirected - the direction the file declares (or the default)
      * @param where - the line of the header, when known
      */
@@ -87,7 +100,8 @@ export class DirectionResolver {
         if (this.policy === "directed" || this.policy === "undirected") {
             wanted = this.policy === "directed";
             if (wanted !== headerDirected) {
-                this.report.warning("coercion", DIRECTION_FORCED_CODE, `the file declares ${direction(headerDirected)} edges; read as ${direction(wanted)} per onMixedDirection`, { line: where?.line ?? null });
+                // once: this says it for every edge, so no edge repeats it
+                this.report.warnOnce("coercion", DIRECTION_FORCED_CODE, `the file declares ${direction(headerDirected)} edges; read as ${direction(wanted)} per onMixedDirection`, { line: where?.line ?? null }, `${DIRECTION_FORCED_CODE}:${direction(headerDirected)}`);
             }
         }
         const { sink } = this;
@@ -124,23 +138,26 @@ export class DirectionResolver {
         }
     }
     /**
-     * The mirror half of the edge most recently pushed by addEdge(), when it was expanded into a
-     * pair; INVALID_INDEX otherwise. An importer that learns an edge's weight after pushing it
-     * (a GEXF attvalue) sets it on both halves.
-     * @returns the mirror's logical index, or INVALID_INDEX
+     * The second edge of the edge the last addEdge() call added, when that edge was stored as two;
+     * otherwise INVALID_INDEX (4294967295). An edge attribute or weight you set after addEdge()
+     * belongs on both: set it on the index addEdge() returned and, when this is not INVALID_INDEX,
+     * on this index too.
+     * @returns the second edge's index, or INVALID_INDEX
      */
     get lastMirror() {
         return this.mirrorOfLast;
     }
     /**
-     * Rule 2 of design section 8.4: push one source edge. An edge whose direction equals the
-     * sink's is one addEdge; one that differs is expanded, forced or refused per the policy.
+     * Add one edge. An edge with the graph's direction is added as it is; one with the other
+     * direction is stored as two edges, given the graph's direction, or refused, as
+     * `onMixedDirection` says. When it is stored as two, the return value is the first and
+     * `lastMirror` the second.
      * @param source - the source id
      * @param target - the target id
      * @param kind - the edge's direction in the file
      * @param weight - the weight, or undefined when the file gives none
      * @param where - the line and element, for issues
-     * @returns the logical index of the (primary) edge
+     * @returns the index of the edge added (the first one, when it was stored as two)
      */
     addEdge(source, target, kind, weight, where) {
         if (!this.headerSet) {
@@ -164,7 +181,7 @@ export class DirectionResolver {
             case "undirected": {
                 // the sink's direction is the policy's (or a locked sink's); the edge is pushed as the sink's kind
                 this.forcedCount++;
-                this.report.warnOnce("coercion", DIRECTION_FORCED_CODE, `${kind} edges read as ${direction(sink.directed)} per onMixedDirection`, where);
+                this.report.warnOnce("coercion", DIRECTION_FORCED_CODE, `${kind} edges read as ${direction(sink.directed)} per onMixedDirection`, where, `${DIRECTION_FORCED_CODE}:${kind}`);
                 const e = sink.addEdge(source, target, weight);
                 this.track(e);
                 if (this.directedHandle !== INVALID_INDEX) {
@@ -187,7 +204,8 @@ export class DirectionResolver {
         }
     }
     /**
-     * How many edges were pushed with a direction other than their own under the forcing policies.
+     * How many edges were given a direction other than their own, under `onMixedDirection`
+     * "directed" or "undirected".
      * @returns the count
      */
     get forced() {
@@ -311,10 +329,12 @@ function direction(directed) {
     return directed ? "directed" : "undirected";
 }
 /**
- * Build the pair-folding view of a snapshot (one pass over the role columns).
- * @param snapshot - the snapshot
- * @param options - the per-format choice
- * @returns the view
+ * Read how a snapshot stores edge direction, for an exporter: which edges to skip so each
+ * undirected edge is written once, and which edges were directed.
+ * @param snapshot - the graph to write
+ * @param options - whether a GEXF mutual edge is written once
+ * @returns the answers, per edge
+ * @category Writing a format
  */
 export function pairFolding(snapshot, options = {}) {
     const foldMutual = options.foldMutual ?? false;

package/dist/src/common/direction.js.map

@@ -1 +1 @@
-{"version":3,"file":"direction.js","sourceRoot":"","sources":["../../../src/common/direction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAIH,gBAAgB,EAGhB,aAAa,GAEhB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAsBjG,2FAA2F;AAC3F,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAElD,mGAAmG;AACnG,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAC;AAE1C,uFAAuF;AACvF,MAAM,CAAC,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAE9C,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,CAAC;AAE/E,MAAM,aAAa,GAAe,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC7F,MAAM,SAAS,GAAe,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAClG,MAAM,WAAW,GAAe,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAEvF;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IAyB1B;;;;;OAKG;IACH,YAAY,IAAe,EAAE,MAA2B,EAAE,MAAsD;QAxBxG,mBAAc,GAAiB,aAA6B,CAAC;QAE7D,eAAU,GAAiB,aAA6B,CAAC;QAEzD,iBAAY,GAAiB,aAA6B,CAAC;QAEnE,4GAA4G;QACpG,cAAS,GAAG,CAAC,CAAC,CAAC;QAEvB,kGAAkG;QAC1F,aAAQ,GAAG,CAAC,CAAC,CAAC;QAEd,gBAAW,GAAG,CAAC,CAAC;QAEhB,cAAS,GAAG,KAAK,CAAC;QAElB,iBAAY,GAAW,aAAa,CAAC;QASzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,UAAU,KAAK,aAAa,CAAC;IAC7C,CAAC;IAED;;;;;;;;;OASG;IACH,SAAS,CAAC,cAAuB,EAAE,KAAoB;QACnD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,MAAM,GAAG,cAAc,CAAC;QAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YAC7D,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC;YACpC,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;gBAC5B,IAAI,CAAC,MAAM,CAAC,OAAO,CACf,UAAU,EACV,qBAAqB,EACrB,qBAAqB,SAAS,CAAC,cAAc,CAAC,mBAAmB,SAAS,CAAC,MAAM,CAAC,uBAAuB,EACzG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,IAAI,EAAE,CAChC,CAAC;YACN,CAAC;QACL,CAAC;QACD,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACtB,IAAI,IAAI,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,OAAO;QACX,CAAC;QACD,IAAI,CAAC;YACD,IAAI,MAAM,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACvD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC9B,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzC,IAAI,CAAC,qBAAqB,EAAE,CAAC;gBAC7B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,IAAI,CAAC,CAAC,GAAG,YAAY,gBAAgB,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAClE,MAAM,GAAG,CAAC;YACd,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,OAAO,CACf,UAAU,EACV,sBAAsB,EACtB,eAAe,SAAS,CAAC,MAAM,CAAC,oBAAoB,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,GAAG,CAAC,cAAc,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EACtI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,IAAI,EAAE,CAChC,CAAC;QACN,CAAC;QACD,IAAI,CAAC,aAAa,EAAE,CAAC;IACzB,CAAC;IAED;;;OAGG;IACK,aAAa;QACjB,IAAI,IAAI,CAAC,UAAU,KAAK,aAAa,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,aAAa,EAAE,CAAC;YAC3F,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACjC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,IAAI,UAAU;QACV,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAc,EAAE,MAAc,EAAE,IAAc,EAAE,MAAe,EAAE,KAAoB;QACzF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAClB,MAAM,IAAI,gBAAgB,CAAC,YAAY,EAAE,8DAA8D,EAAE;gBACrG,MAAM,EAAE,gBAAgB;aAC3B,CAAC,CAAC;QACP,CAAC;QACD,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,YAAY,GAAG,aAAa,CAAC;QAClC,MAAM,YAAY,GAAG,IAAI,KAAK,YAAY,CAAC;QAC3C,IAAI,YAAY,KAAK,IAAI,CAAC,QAAQ,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtD,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YAC/C,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACd,IAAI,IAAI,CAAC,cAAc,KAAK,aAAa,EAAE,CAAC;gBACxC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC;YAC5D,CAAC;YACD,OAAO,CAAC,CAAC;QACb,CAAC;QACD,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;YAClB,KAAK,UAAU,CAAC;YAChB,KAAK,YAAY,CAAC,CAAC,CAAC;gBAChB,mGAAmG;gBACnG,IAAI,CAAC,WAAW,EAAE,CAAC;gBACnB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAChB,UAAU,EACV,qBAAqB,EACrB,GAAG,IAAI,kBAAkB,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,uBAAuB,EACxE,KAAK,CACR,CAAC;gBACF,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;gBAC/C,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACd,IAAI,IAAI,CAAC,cAAc,KAAK,aAAa,EAAE,CAAC;oBACxC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC7D,CAAC;gBACD,OAAO,CAAC,CAAC;YACb,CAAC;YACD,KAAK,OAAO;gBACR,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,kBAAkB,EAClB,oBAAoB,EACpB,GAAG,IAAI,cAAc,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,oCAAoC,EACjF,KAAK,CACR,CAAC;gBACF,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAC;YACvF,KAAK,QAAQ;gBACT,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YAC5D,OAAO,CAAC,CAAC,CAAC;gBACN,MAAM,IAAI,GAAW,IAAI,CAAC,MAAM,CAAC;gBACjC,MAAM,IAAI,gBAAgB,CAAC,eAAe,EAAE,4BAA4B,IAAI,EAAE,EAAE;oBAC5E,MAAM,EAAE,kBAAkB;oBAC1B,KAAK,EAAE,IAAI;iBACd,CAAC,CAAC;YACP,CAAC;QACL,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED;;;;;;;;OAQG;IACK,MAAM,CACV,MAAc,EACd,MAAc,EACd,IAAc,EACd,MAA0B,EAC1B,KAA+B;QAE/B,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjB,4EAA4E;YAC5E,IAAI,CAAC;gBACD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC9B,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzC,IAAI,CAAC,qBAAqB,EAAE,CAAC;gBAC7B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC;YAC/C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,IAAI,CAAC,CAAC,GAAG,YAAY,gBAAgB,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBAClE,MAAM,GAAG,CAAC;gBACd,CAAC;gBACD,IAAI,CAAC,MAAM,CAAC,KAAK,CACb,UAAU,EACV,sBAAsB,EACtB,GAAG,SAAS,CAAC,IAAI,CAAC,qBAAqB,SAAS,CAAC,KAAK,CAAC,0BAA0B,EACjF,KAAK,CACR,CAAC;gBACF,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4CAA4C,EAAE;oBAClE,IAAI,EAAE,sBAAsB;oBAC5B,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM;iBAC7B,CAAC,CAAC;YACP,CAAC;YACD,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;gBACtB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;gBAC/C,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACd,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;gBAChD,OAAO,CAAC,CAAC;YACb,CAAC;QACL,CAAC;QACD,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClB,MAAM,MAAM,GAAG,IAAI,KAAK,QAAQ,CAAC;QACjC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QACnC,IAAI,MAAM,EAAE,CAAC;YACT,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC1B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACV,iFAAiF;YACjF,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACnB,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;QAC3B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACvD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAClD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAClD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,CAAS;QACnB,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,qBAAqB;QACzB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;QACjE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;IAED;;;OAGG;IACK,sBAAsB;QAC1B,IAAI,IAAI,CAAC,UAAU,KAAK,aAAa,EAAE,CAAC;YACpC,OAAO;QACX,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;QACjE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACzD,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC;YACtB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;gBAClD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;YACzD,CAAC;QACL,CAAC;IACL,CAAC;IAED,2CAA2C;IACnC,kBAAkB;QACtB,IAAI,IAAI,CAAC,YAAY,KAAK,aAAa,EAAE,CAAC;YACtC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;QACjE,CAAC;IACL,CAAC;CACJ;AAED;;;;GAIG;AACH,SAAS,QAAQ,CAAC,GAAqB;IACnC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC;IAC/B,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC;AAED;;;;GAIG;AACH,SAAS,SAAS,CAAC,QAAiB;IAChC,OAAO,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC;AAChD,CAAC;AAuDD;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,QAAuB,EAAE,UAA8B,EAAE;IACjF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC;IAC/C,MAAM,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;IAC7E,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;IACpE,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;IACzE,MAAM,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC;IAC/B,MAAM,MAAM,GAAG,CAAC,CAAS,EAAU,EAAE;QACjC,IAAI,UAAU,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,OAAO,aAAa,CAAC;QACzB,CAAC;QACD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACjC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC;IACrF,CAAC,CAAC;IACF,MAAM,cAAc,GAAG,CAAC,CAAS,EAAW,EAAE,CAC1C,cAAc,KAAK,IAAI,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC5F,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAW,EAAE;QACpC,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC1D,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACvB,OAAO,IAAI,KAAK,aAAa,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IACnG,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,CAAS,EAAW,EAAE;QAClC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,IAAI,KAAK,aAAa,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;YACtC,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,4FAA4F;QAC5F,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC,CAAC;IACF,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YACjC,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3E,WAAW,EAAE,CAAC;YAClB,CAAC;QACL,CAAC;IACL,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,UAAU,KAAK,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;AACpG,CAAC;AAED;;;;;GAKG;AACH,SAAS,UAAU,CAAC,MAAqB,EAAE,KAAqB;IAC5D,OAAO,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACrE,CAAC"}
+{"version":3,"file":"direction.js","sourceRoot":"","sources":["../../../src/common/direction.ts"],"names":[],"mappings":"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"}

package/dist/src/common/escape.d.ts

@@ -12,13 +12,15 @@
  * surrogate) has no XML spelling at all and is E_COLUMN_TYPE; the exporters' check() counts them.
  * @param text - the text
  * @returns the escaped text
+ * @category Plugin helpers
  */
 export declare function escapeXmlText(text: string): string;
 /**
  * Escape text for a double-quoted XML attribute value: `&`, `<`, `>`, `"` and the whitespace
- * characters attribute normalisation would fold; a character XML 1.0 forbids is E_COLUMN_TYPE.
+ * characters attribute normalization would fold; a character XML 1.0 forbids is E_COLUMN_TYPE.
  * @param text - the text
  * @returns the escaped text
+ * @category Plugin helpers
  */
 export declare function escapeXmlAttribute(text: string): string;
 /**
@@ -28,15 +30,18 @@ export declare function escapeXmlAttribute(text: string): string;
  * A lone surrogate cannot be written and is E_COLUMN_TYPE.
  * @param text - the text
  * @returns the quoted GML string
+ * @category Plugin helpers
  */
 export declare function quoteGmlString(text: string): string;
 /**
  * Decode the character entities of a GML string body (the inverse of quoteGmlString on the text
  * between the quotes): numeric references, the XML entities and the ISO-8859-1 HTML entities. An
- * unknown named entity is left as written and handed to `onUnknown`.
+ * unknown named entity, or a numeric reference beyond U+10FFFF, is left as written and handed to
+ * `onUnknown`.
  * @param body - the text between the quotes
- * @param onUnknown - called with each unknown named entity (`&name;`), when given
+ * @param onUnknown - called with each entity left as written (`&name;`, `&#99999999;`), when given
  * @returns the decoded text
+ * @category Plugin helpers
  */
 export declare function decodeGmlString(body: string, onUnknown?: (entity: string) => void): string;
 /**
@@ -44,6 +49,7 @@ export declare function decodeGmlString(body: string, onUnknown?: (entity: strin
  * a digit, or a numeral, and not a keyword (case-insensitive).
  * @param text - the text
  * @returns true when the text can be written bare
+ * @category Plugin helpers
  */
 export declare function isBareDotId(text: string): boolean;
 /**
@@ -55,6 +61,7 @@ export declare function isBareDotId(text: string): boolean;
  * the closing quote. Every other text is writable; quoteDotId() writes it.
  * @param text - the id, name or value text
  * @returns true when quoteDotId(text) reads back as `text`
+ * @category Plugin helpers
  */
 export declare function isWritableDotText(text: string): boolean;
 /**
@@ -64,24 +71,28 @@ export declare function isWritableDotText(text: string): boolean;
  * backslash has no DOT spelling (isWritableDotText); the caller refuses it before writing.
  * @param text - the id or label text
  * @returns the DOT ID
+ * @category Plugin helpers
  */
 export declare function quoteDotId(text: string): string;
 /**
- * Write a set CSV cell per RFC 4180: quoted with `"` doubled when the text contains the
- * delimiter, a quote, a CR or LF, or leading / trailing whitespace; bare otherwise. The empty
- * string is written as the quoted empty cell `""`, so the importers can tell a set empty string
- * (and an empty-string node id, legal under design section 4.1) from an unset cell, which every
- * exporter writes as nothing between the delimiters.
+ * Write a set CSV cell per RFC 4180: quoted, with the quote character doubled, when the text
+ * contains the delimiter, the quote character, a CR or LF, or leading / trailing whitespace; bare
+ * otherwise. The empty string is written as an empty quoted cell (`""`), so the importers can tell a
+ * set empty string (and an empty-string node id) from an unset cell, which every exporter writes as
+ * nothing between the delimiters.
  * @param text - the cell text of a set cell
  * @param delimiter - the field delimiter (default ",")
+ * @param quote - the quote character (default `"`)
  * @returns the cell as written
+ * @category Plugin helpers
  */
-export declare function quoteCsvCell(text: string, delimiter?: string): string;
+export declare function quoteCsvCell(text: string, delimiter?: string, quote?: string): string;
 /**
  * Whether a text can be a Pajek label: Pajek has no escape mechanism inside its double-quoted
  * labels, so a text containing a double quote, a CR or an LF cannot be written.
  * @param text - the label text
  * @returns true when quotePajekLabel() can write it
+ * @category Plugin helpers
  */
 export declare function isPajekLabel(text: string): boolean;
 /**
@@ -91,6 +102,7 @@ export declare function isPajekLabel(text: string): boolean;
  * the exporter's check() counts those.
  * @param text - the label text
  * @returns the label as written
+ * @category Plugin helpers
  */
 export declare function quotePajekLabel(text: string): string;
 //# sourceMappingURL=escape.d.ts.map

package/dist/src/common/escape.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"escape.d.ts","sourceRoot":"","sources":["../../../src/common/escape.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkBH;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKlD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKvD;AAgBD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAcnD;AA2BD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,CAe1F;AAKD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKjD;AAuBD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAclE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWpD"}
+{"version":3,"file":"escape.d.ts","sourceRoot":"","sources":["../../../src/common/escape.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkBH;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKlD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKvD;AAgBD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAcnD;AA2BD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,CAkB1F;AAKD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKjD;AAuBD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAM,EAAE,KAAK,SAAM,GAAG,MAAM,CAc/E;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYpD"}