@graphty/graph-io 0.3.25 → 0.3.27

package/dist/src/common/ontology.js

@@ -8,6 +8,7 @@
  * The node columns of the OBO vocabulary, keyed by column name (design section 4.2). The names are
  * the OBO tag names, so a Gene Ontology user finds `namespace`, `def` and `is_obsolete` under the
  * names the GO documentation uses.
+ * @category Plugin helpers
  */
 export const OBO_NODE_COLUMNS = Object.freeze({
     type: { dtype: "dict" },
@@ -65,13 +66,17 @@ const OBO_EDGE_COLUMNS = Object.freeze({
     qualifiers: { dtype: "json" },
     meta: { dtype: "json" },
 });
-/** The node column that marks a node made for an undeclared reference (design section 4.2). */
+/**
+ * The node column that marks a node made for an undeclared reference (design section 4.2).
+ * @category Plugin helpers
+ */
 export const PLACEHOLDER_COLUMN = "graphty.placeholder";
 /**
  * The declaration of an OBO vocabulary column.
  * @param domain - node or edge
  * @param name - the column name (a key of OBO_NODE_COLUMNS / OBO_EDGE_COLUMNS, or the placeholder column)
  * @returns the declaration, nullable, with origin `{ format: "obo", id: name }`
+ * @category Plugin helpers
  */
 export function oboColumnDecl(domain, name) {
     if (name === PLACEHOLDER_COLUMN) {
@@ -87,24 +92,35 @@ export function oboColumnDecl(domain, name) {
     }
     return decl;
 }
-/** The OBO PURL base every OBO Foundry IRI starts with. */
-const OBO_PURL = "http://purl.obolibrary.org/obo/";
-/** The oboInOwl namespace of the OBO-to-OWL mapping's annotation properties. */
-const OBO_IN_OWL = "http://www.geneontology.org/formats/oboInOwl#";
+/**
+ * The OBO PURL base every OBO Foundry IRI starts with.
+ * @category Plugin helpers
+ */
+export const OBO_PURL = "http://purl.obolibrary.org/obo/"; // NOSONAR(S5332): an identifier the OBO standard fixes, never fetched
+/** The same base under https, which newer OBO Graphs writers use. */
+const OBO_PURL_HTTPS = "https://purl.obolibrary.org/obo/";
+/**
+ * The oboInOwl namespace of the OBO-to-OWL mapping's annotation properties.
+ * @category Plugin helpers
+ */
+export const OBO_IN_OWL = "http://www.geneontology.org/formats/oboInOwl#"; // NOSONAR(S5332): an identifier the OBO standard fixes, never fetched
 /**
  * An IRI as the identifier the `.obo` file writes (the OBO 1.4 mapping, section 5.9, read
  * backwards): `http://purl.obolibrary.org/obo/GO_0008150` is `GO:0008150` (the prefix is the text
  * before the first underscore), and `http://purl.obolibrary.org/obo/go#regulates` (how the OWL
- * translation writes an unprefixed OBO id: subsets, relations, synonym types) is `regulates`.
+ * translation writes an unprefixed OBO id: subsets, relations, synonym types) is `regulates`; the
+ * same under `https://purl.obolibrary.org/obo/`.
  * Every other IRI, and an OBO PURL that fits neither form (`.../obo/T/Female`), is kept.
  * @param iri - the IRI
  * @returns the CURIE or local id, or the IRI unchanged
+ * @category Plugin helpers
  */
 export function compactOboIri(iri) {
-    if (!iri.startsWith(OBO_PURL)) {
+    const base = [OBO_PURL, OBO_PURL_HTTPS].find((b) => iri.startsWith(b));
+    if (base === undefined) {
         return iri;
     }
-    const rest = iri.slice(OBO_PURL.length);
+    const rest = iri.slice(base.length);
     const hash = rest.indexOf("#");
     if (hash > 0) {
         const local = rest.slice(hash + 1);
@@ -116,13 +132,17 @@ export function compactOboIri(iri) {
     }
     return `${rest.slice(0, underscore)}:${rest.slice(underscore + 1)}`;
 }
-/** The OBO synonym scopes. */
+/**
+ * The OBO synonym scopes.
+ * @category Plugin helpers
+ */
 export const SYNONYM_SCOPES = new Set(["EXACT", "BROAD", "NARROW", "RELATED"]);
 /**
  * The OBO synonym scope of an OBO Graphs synonym predicate (`hasExactSynonym`, with or without the
  * oboInOwl namespace).
  * @param pred - the predicate
  * @returns the scope, or null for a predicate that is not one of the four
+ * @category Plugin helpers
  */
 export function synonymScopeOf(pred) {
     const local = pred.startsWith(OBO_IN_OWL) ? pred.slice(OBO_IN_OWL.length) : pred;
@@ -134,6 +154,7 @@ export function synonymScopeOf(pred) {
  * the tags that are annotations), so the `.json` of an ontology fills the same columns as its
  * `.obo`. `shorthand` is the relation's short name; every predicate not listed is a
  * `property_value`.
+ * @category Plugin helpers
  */
 export const OBOGRAPHS_PREDICATE_TAGS = new Map([
     [`${OBO_IN_OWL}hasOBONamespace`, "namespace"],

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

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

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

@@ -1,5 +1,5 @@
 /**
- * Option normalisation for importers and exporters (design sections 8.4 and 8.5): every common
+ * Option normalization for importers and exporters (design sections 8.4 and 8.5): every common
  * option resolved to its documented default, enum values checked (E_UNSUPPORTED, the core's
  * convention for an option outside its set), and the per-format defaults (`ids`, `defaultDirected`,
  * `weightFrom`, `addMissingNodes`) supplied by the importer that calls resolveImportOptions().
@@ -8,7 +8,10 @@ import { type DuplicatePolicy, type GraphSink, type IdCoercion } from "@graphty/
 import { type CommonExportOptions, type CommonImportOptions, type GraphChoiceOptions } from "../types.js";
 import { SINK_OPTION_CODE } from "./codes.js";
 import { type ImportReportBuilder } from "./report.js";
-/** The defaults an importer supplies for the options whose default is per format (design section 8.4). */
+/**
+ * The defaults an importer supplies for the options whose default is per format.
+ * @category Plugin helpers
+ */
 export interface ImportFormatDefaults {
     /** "canonical" for text-cell formats, "keep" for JSON. */
     readonly ids: IdCoercion;
@@ -20,9 +23,9 @@ export interface ImportFormatDefaults {
     readonly addMissingNodes?: boolean | undefined;
 }
 /**
- * CommonImportOptions with every field present (design section 8.4 defaults applied).
- * Consumed by the per-format importers and exporters under src/formats.
+ * CommonImportOptions with every field present.
  * @public
+ * @category Plugin helpers
  */
 export interface ResolvedImportOptions {
     /** The id coercion rule. */
@@ -58,41 +61,57 @@ export interface ResolvedImportOptions {
     /** The caller's byte encoding (canonical name), or null to detect it. */
     readonly encoding: string | null;
 }
-/** CommonExportOptions with every field present (design section 8.5 defaults applied). */
+/**
+ * CommonExportOptions with every field present.
+ * @category Plugin helpers
+ */
 export interface ResolvedExportOptions {
     /** "error" never renames a node; "mangle" rewrites and keeps the original. */
     readonly sanitizeIds: "error" | "mangle";
     /** What a format without mixed-direction support does with a mixed snapshot. */
     readonly onMixedDirection: "error" | "directed" | "undirected";
 }
-/** The default error limit of design section 8.4. */
+/**
+ * The default error limit: errors tolerated before an import aborts.
+ * @category Reports and errors
+ */
 export declare const DEFAULT_ERROR_LIMIT = 100;
 export { SINK_OPTION_CODE };
 /**
- * Report every builder-policy option the caller explicitly requested that the sink does not use
- * (design section 8.4 precedence), one `W_SINK_OPTION` warning per option with the option name as
+ * Report every builder-policy option the caller explicitly requested that the sink does not use,
+ * one `W_SINK_OPTION` warning per option with the option name as
  * the element. Options left undefined are never reported: they are defaults, not requests. On the
  * registry's builder, which is seeded from the same options, nothing is ever reported.
  * @param sink - the sink the importer pushes into
  * @param options - the caller's raw options, possibly undefined
  * @param report - the report to record into
  * @param enforcesMissingNodes - true when the importer applies `addMissingNodes: false` itself (it
- * refuses unknown endpoints before the sink sees them), so that request is honoured on any sink and
+ * refuses unknown endpoints before the sink sees them), so that request is honored on any sink and
  * only `addMissingNodes: true` against a refusing sink is reported
  * @returns the number of warnings recorded
+ * @category Writing a format
  */
 export declare function reportSinkOptions(sink: GraphSink, options: CommonImportOptions | undefined, report: ImportReportBuilder, enforcesMissingNodes?: boolean): number;
 /**
  * Report every common option the caller set to a non-default value that the format has no use
- * for (design section 8.4: "the importer reports every option it could not honour"): one
+ * for: one
  * `W_OPTION_IGNORED` warning (category `unsupported`) per option, the option name as the element.
  * The builder-policy options are reportSinkOptions()'s and are skipped here.
  * @param options - the caller's raw options, possibly undefined
  * @param report - the report to record into
  * @param used - the common option names the importer reads
  * @returns the number of warnings recorded
+ * @category Writing a format
  */
 export declare function reportUnusedOptions(options: CommonImportOptions | undefined, report: ImportReportBuilder, used: ReadonlySet<keyof CommonImportOptions>): number;
+/**
+ * Whether the caller chose a graph with `graphIndex` or `graphName`. An importer warns
+ * W_MULTIPLE_GRAPHS about the graphs it skipped only when it read the first by default.
+ * @param options - the caller's graphIndex / graphName
+ * @returns true when either option is set
+ * @category Writing a format
+ */
+export declare function graphChosen(options: GraphChoiceOptions | undefined): boolean;
 /**
  * The graph an importer reads from an input that holds several: the one `graphIndex` or
  * `graphName` names, else the first. A choice that names no graph is E_GRAPH_NOT_FOUND, a name two
@@ -102,26 +121,57 @@ export declare function reportUnusedOptions(options: CommonImportOptions | undef
  * @param options - the caller's graphIndex / graphName
  * @param report - the report a failure is recorded in
  * @returns the index of the graph to read; E_UNSUPPORTED for an option of the wrong type, or both
+ * @category Writing a format
  */
 export declare function chooseGraph(names: readonly (string | null)[], options: GraphChoiceOptions | undefined, report: ImportReportBuilder): number;
 /**
- * Apply the design section 8.4 defaults to an importer's common options and check every enum
+ * Apply the documented defaults to an importer's common options and check every enum
  * value. Format-specific options in the same object are ignored here.
  * @param options - the caller's options, possibly undefined
  * @param defaults - the importer's per-format defaults
  * @returns the resolved options; E_UNSUPPORTED for a value outside its set
+ * @category Writing a format
  */
 export declare function resolveImportOptions(options: CommonImportOptions | undefined, defaults: ImportFormatDefaults): ResolvedImportOptions;
 /**
- * Apply the design section 8.5 defaults to an exporter's common options and check the enum values.
+ * Apply the documented defaults to an exporter's common options and check the enum values.
  * @param options - the caller's options, possibly undefined
  * @returns the resolved options; E_UNSUPPORTED for a value outside its set
+ * @category Writing a format
  */
 export declare function resolveExportOptions(options: CommonExportOptions | undefined): ResolvedExportOptions;
+/**
+ * The options to pass to another importer that you hand text you already decoded with readText():
+ * the caller's options without `encoding` and `onProgress`, which that text no longer needs. Without
+ * this, the other importer would warn that `encoding` has no effect on text, and report progress a
+ * second time.
+ * @example
+ * ```ts
+ * const text = await readText(input, report, opts);
+ * report.include(await csvImporter.import(text, sink, forDecodedText(options)));
+ * ```
+ * @param options - the caller's import options
+ * @returns a copy without `encoding` and `onProgress`
+ * @category Writing a format
+ */
+export declare function forDecodedText<O extends CommonImportOptions>(options: O | undefined): O;
+/**
+ * The dialect names of the built-in formats with a `dialect` save option. One options object shared between formats
+ * can hold one format's dialect, and the other formats ignore it, as they ignore any option they do not have.
+ */
+export declare const FORMAT_DIALECTS: Readonly<Record<string, readonly string[]>>;
+/**
+ * Whether a `dialect` value names another format's dialect, which this format ignores rather than refuses.
+ * @param format - this format
+ * @param value - the caller's `dialect` option
+ * @returns true for another built-in format's dialect name
+ */
+export declare function otherFormatDialect(format: string, value: unknown): boolean;
 /**
  * A short description of an option value for an error message.
  * @param value - the value
  * @returns the JSON text of a primitive, or the type name otherwise
+ * @category Plugin helpers
  */
 export declare function describe(value: unknown): string;
 //# sourceMappingURL=options.d.ts.map

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

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

package/dist/src/common/options.js

@@ -1,5 +1,5 @@
 /**
- * Option normalisation for importers and exporters (design sections 8.4 and 8.5): every common
+ * Option normalization for importers and exporters (design sections 8.4 and 8.5): every common
  * option resolved to its documented default, enum values checked (E_UNSUPPORTED, the core's
  * convention for an option outside its set), and the per-format defaults (`ids`, `defaultDirected`,
  * `weightFrom`, `addMissingNodes`) supplied by the importer that calls resolveImportOptions().
@@ -7,6 +7,7 @@
 import { GraphFormatError } from "@graphty/graph-format";
 import { AMBIGUOUS_GRAPH_NAME_CODE, GRAPH_NOT_FOUND_CODE, NO_GRAPH_CODE, OPTION_IGNORED_CODE, SINK_OPTION_CODE, } from "./codes.js";
 import { canonicalEncoding } from "./input.js";
+import { plural } from "./plural.js";
 const ID_COERCIONS = new Set(["keep", "canonical", "string", "number"]);
 const NODE_ID_SOURCES = new Set(["id", "label", "index"]);
 const DUPLICATE_POLICIES = new Set(["keep", "error", "first", "last", "sum", "min", "max"]);
@@ -17,23 +18,27 @@ const WEIGHT_DTYPES = new Set(["f32", "f64"]);
 const LONG_MODES = new Set(["f64", "string"]);
 const HYPEREDGE_POLICIES = new Set(["error", "skip", "star", "clique"]);
 const SANITIZE_MODES = new Set(["error", "mangle"]);
-/** The default error limit of design section 8.4. */
+/**
+ * The default error limit: errors tolerated before an import aborts.
+ * @category Reports and errors
+ */
 export const DEFAULT_ERROR_LIMIT = 100;
 export { SINK_OPTION_CODE };
 /** The builder-policy options a sink exposes read-only as `sink.options` (design section 8.4). */
 const SINK_OPTION_NAMES = ["addMissingNodes", "duplicateEdges", "selfLoops", "weightDtype"];
 /**
- * Report every builder-policy option the caller explicitly requested that the sink does not use
- * (design section 8.4 precedence), one `W_SINK_OPTION` warning per option with the option name as
+ * Report every builder-policy option the caller explicitly requested that the sink does not use,
+ * one `W_SINK_OPTION` warning per option with the option name as
  * the element. Options left undefined are never reported: they are defaults, not requests. On the
  * registry's builder, which is seeded from the same options, nothing is ever reported.
  * @param sink - the sink the importer pushes into
  * @param options - the caller's raw options, possibly undefined
  * @param report - the report to record into
  * @param enforcesMissingNodes - true when the importer applies `addMissingNodes: false` itself (it
- * refuses unknown endpoints before the sink sees them), so that request is honoured on any sink and
+ * refuses unknown endpoints before the sink sees them), so that request is honored on any sink and
  * only `addMissingNodes: true` against a refusing sink is reported
  * @returns the number of warnings recorded
+ * @category Writing a format
  */
 export function reportSinkOptions(sink, options, report, enforcesMissingNodes = false) {
     if (options === undefined) {
@@ -69,15 +74,27 @@ const IGNORABLE_OPTION_NAMES = [
     "restoreMangledIds",
     "hyperedges",
 ];
+/** The defaults that are the same in every format (the others, such as `defaultDirected`, differ by format). */
+const FIXED_DEFAULTS = {
+    nodeIdFrom: "id",
+    duplicateEdges: "keep",
+    selfLoops: "keep",
+    onMixedDirection: "expand",
+    weightDtype: "f64",
+    long: "f64",
+    restoreMangledIds: true,
+    hyperedges: "skip",
+};
 /**
  * Report every common option the caller set to a non-default value that the format has no use
- * for (design section 8.4: "the importer reports every option it could not honour"): one
+ * for: one
  * `W_OPTION_IGNORED` warning (category `unsupported`) per option, the option name as the element.
  * The builder-policy options are reportSinkOptions()'s and are skipped here.
  * @param options - the caller's raw options, possibly undefined
  * @param report - the report to record into
  * @param used - the common option names the importer reads
  * @returns the number of warnings recorded
+ * @category Writing a format
  */
 export function reportUnusedOptions(options, report, used) {
     if (options === undefined) {
@@ -89,7 +106,8 @@ export function reportUnusedOptions(options, report, used) {
             continue;
         }
         const value = options[name];
-        if (value === undefined) {
+        if (value === undefined || value === FIXED_DEFAULTS[name]) {
+            // an option spelled out at its default changes nothing, whether or not the format reads it
             continue;
         }
         report.warning("unsupported", OPTION_IGNORED_CODE, `option ${name}: ${JSON.stringify(value)} has no effect on the ${report.format} importer`, { element: name });
@@ -97,6 +115,27 @@ export function reportUnusedOptions(options, report, used) {
     }
     return recorded;
 }
+/**
+ * Whether the caller chose a graph with `graphIndex` or `graphName`. An importer warns
+ * W_MULTIPLE_GRAPHS about the graphs it skipped only when it read the first by default.
+ * @param options - the caller's graphIndex / graphName
+ * @returns true when either option is set
+ * @category Writing a format
+ */
+export function graphChosen(options) {
+    return options?.graphIndex !== undefined || options?.graphName !== undefined;
+}
+/**
+ * The graphs of an input as an E_GRAPH_NOT_FOUND message lists them: their indexes and names, so the
+ * caller can choose without a second call.
+ * @param names - each graph's name, null for an unnamed graph
+ * @returns the text to append, starting with "; "
+ */
+function graphNamesText(names) {
+    const shown = names.slice(0, 10).map((n, i) => `${i} ${n === null ? "(unnamed)" : JSON.stringify(n)}`);
+    const more = names.length > shown.length ? `, and ${names.length - shown.length} more` : "";
+    return `; the file holds ${shown.join(", ")}${more}`;
+}
 /**
  * The graph an importer reads from an input that holds several: the one `graphIndex` or
  * `graphName` names, else the first. A choice that names no graph is E_GRAPH_NOT_FOUND, a name two
@@ -106,6 +145,7 @@ export function reportUnusedOptions(options, report, used) {
  * @param options - the caller's graphIndex / graphName
  * @param report - the report a failure is recorded in
  * @returns the index of the graph to read; E_UNSUPPORTED for an option of the wrong type, or both
+ * @category Writing a format
  */
 export function chooseGraph(names, options, report) {
     const { graphIndex, graphName } = options ?? {};
@@ -137,22 +177,23 @@ export function chooseGraph(names, options, report) {
             return report.fail(AMBIGUOUS_GRAPH_NAME_CODE, `graphName ${JSON.stringify(graphName)} names the graphs at indexes ${matches.join(", ")}; pass graphIndex`, { element: graphName });
         }
         if (matches.length === 0) {
-            return report.fail(GRAPH_NOT_FOUND_CODE, `graphName ${JSON.stringify(graphName)} names none of the ${names.length} graph(s)`, { element: graphName }, { names: [...names] });
+            return report.fail(GRAPH_NOT_FOUND_CODE, `graphName ${JSON.stringify(graphName)} names none of the ${names.length} graph${plural(names.length)}${graphNamesText(names)}`, { element: graphName }, { names: [...names] });
         }
         return matches[0];
     }
     const index = graphIndex ?? 0;
     if (index >= names.length) {
-        return report.fail(GRAPH_NOT_FOUND_CODE, `graphIndex ${index} is beyond the ${names.length} graph(s)`);
+        return report.fail(GRAPH_NOT_FOUND_CODE, `graphIndex ${index} is beyond the ${names.length} graph${plural(names.length)}${graphNamesText(names)}`);
     }
     return index;
 }
 /**
- * Apply the design section 8.4 defaults to an importer's common options and check every enum
+ * Apply the documented defaults to an importer's common options and check every enum
  * value. Format-specific options in the same object are ignored here.
  * @param options - the caller's options, possibly undefined
  * @param defaults - the importer's per-format defaults
  * @returns the resolved options; E_UNSUPPORTED for a value outside its set
+ * @category Writing a format
  */
 export function resolveImportOptions(options, defaults) {
     const o = options ?? {};
@@ -176,9 +217,10 @@ export function resolveImportOptions(options, defaults) {
     });
 }
 /**
- * Apply the design section 8.5 defaults to an exporter's common options and check the enum values.
+ * Apply the documented defaults to an exporter's common options and check the enum values.
  * @param options - the caller's options, possibly undefined
  * @returns the resolved options; E_UNSUPPORTED for a value outside its set
+ * @category Writing a format
  */
 export function resolveExportOptions(options) {
     const o = options ?? {};
@@ -305,10 +347,46 @@ function encodingOption(value) {
     }
     return canonical;
 }
+/**
+ * The options to pass to another importer that you hand text you already decoded with readText():
+ * the caller's options without `encoding` and `onProgress`, which that text no longer needs. Without
+ * this, the other importer would warn that `encoding` has no effect on text, and report progress a
+ * second time.
+ * @example
+ * ```ts
+ * const text = await readText(input, report, opts);
+ * report.include(await csvImporter.import(text, sink, forDecodedText(options)));
+ * ```
+ * @param options - the caller's import options
+ * @returns a copy without `encoding` and `onProgress`
+ * @category Writing a format
+ */
+export function forDecodedText(options) {
+    return { ...options, encoding: undefined, onProgress: undefined };
+}
+/**
+ * The dialect names of the built-in formats with a `dialect` save option. One options object shared between formats
+ * can hold one format's dialect, and the other formats ignore it, as they ignore any option they do not have.
+ */
+export const FORMAT_DIALECTS = Object.freeze({
+    csv: Object.freeze(["gephi", "generic"]),
+    json: Object.freeze(["node-link", "d3", "jgf", "cytoscape", "graphology", "vis", "obographs"]),
+});
+/**
+ * Whether a `dialect` value names another format's dialect, which this format ignores rather than refuses.
+ * @param format - this format
+ * @param value - the caller's `dialect` option
+ * @returns true for another built-in format's dialect name
+ */
+export function otherFormatDialect(format, value) {
+    return (typeof value === "string" &&
+        Object.entries(FORMAT_DIALECTS).some(([f, names]) => f !== format && names.includes(value)));
+}
 /**
  * A short description of an option value for an error message.
  * @param value - the value
  * @returns the JSON text of a primitive, or the type name otherwise
+ * @category Plugin helpers
  */
 export function describe(value) {
     switch (typeof value) {

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * Count agreement for messages, so a report says "1 node is" and "3 nodes are", never "1 node(s) are".
+ */
+/**
+ * The plural ending of a regular noun after a count.
+ * @param n - the count
+ * @returns "" for 1, "s" otherwise
+ */
+export declare function plural(n: number): string;
+/**
+ * The form of a verb that agrees with a count.
+ * @param n - the count
+ * @param one - the form for 1 ("is", "was", "holds")
+ * @param many - the form for any other count ("are", "were", "hold")
+ * @returns `one` or `many`
+ */
+export declare function agree(n: number, one: string, many: string): string;
+/**
+ * A count of nodes and edges, leaving out a zero: "2 nodes and 1 edge", "1 edge".
+ * @param nodes - the node count
+ * @param edges - the edge count
+ * @returns the text
+ */
+export declare function elementCount(nodes: number, edges: number): string;
+/**
+ * A word with its indefinite article, chosen by its first letter: "an integer", "a double".
+ * @param word - the word
+ * @returns "a word" or "an word"
+ */
+export declare function withArticle(word: string): string;
+//# sourceMappingURL=plural.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plural.d.ts","sourceRoot":"","sources":["../../../src/common/plural.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAExC;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CASjE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/src/common/plural.js

@@ -0,0 +1,46 @@
+/**
+ * Count agreement for messages, so a report says "1 node is" and "3 nodes are", never "1 node(s) are".
+ */
+/**
+ * The plural ending of a regular noun after a count.
+ * @param n - the count
+ * @returns "" for 1, "s" otherwise
+ */
+export function plural(n) {
+    return n === 1 ? "" : "s";
+}
+/**
+ * The form of a verb that agrees with a count.
+ * @param n - the count
+ * @param one - the form for 1 ("is", "was", "holds")
+ * @param many - the form for any other count ("are", "were", "hold")
+ * @returns `one` or `many`
+ */
+export function agree(n, one, many) {
+    return n === 1 ? one : many;
+}
+/**
+ * A count of nodes and edges, leaving out a zero: "2 nodes and 1 edge", "1 edge".
+ * @param nodes - the node count
+ * @param edges - the edge count
+ * @returns the text
+ */
+export function elementCount(nodes, edges) {
+    const parts = [];
+    if (nodes > 0 || edges === 0) {
+        parts.push(`${nodes} node${plural(nodes)}`);
+    }
+    if (edges > 0) {
+        parts.push(`${edges} edge${plural(edges)}`);
+    }
+    return parts.join(" and ");
+}
+/**
+ * A word with its indefinite article, chosen by its first letter: "an integer", "a double".
+ * @param word - the word
+ * @returns "a word" or "an word"
+ */
+export function withArticle(word) {
+    return `${/^[aeiou]/i.test(word) ? "an" : "a"} ${word}`;
+}
+//# sourceMappingURL=plural.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plural.js","sourceRoot":"","sources":["../../../src/common/plural.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,KAAK,CAAC,CAAS,EAAE,GAAW,EAAE,IAAY;IACtD,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,KAAa;IACrD,MAAM,KAAK,GAAG,EAAE,CAAC;IACjB,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,QAAQ,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,QAAQ,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACpC,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;AAC5D,CAAC"}