@faubulous/mentor-rdf-serializers 1.9.3 → 1.10.0

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export * from './quad-sorting-strategy';
 export * from './quad-sorter';
 export * from './serialization-result';
 export * from './serialization-options';
+export * from './term-serializer';
 export * from './quad-context-serializer';
 export * from './token-formatter-base';
 export * from './token-formatter.interface';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC"}

package/dist/index.js

@@ -8,6 +8,7 @@ export * from './quad-sorting-strategy';
 export * from './quad-sorter';
 export * from './serialization-result';
 export * from './serialization-options';
+export * from './term-serializer';
 export * from './quad-context-serializer';
 export * from './token-formatter-base';
 export * from './token-formatter.interface';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC"}

package/dist/quad-serializer-base.d.ts

@@ -4,6 +4,7 @@ import { Rdf12Quad, Rdf12Term, TripleTerm } from './utilities/types';
 import { IQuadSerializer } from './quad-serializer.interface';
 import { SerializationResult } from './serialization-result';
 import { SerializationOptions } from './serialization-options';
+import { TermSerializerSettings } from './term-serializer';
 /**
  * Abstract base class for RDF serializers. Provides common functionality
  * for serializing terms and literals.
@@ -25,6 +26,15 @@ export declare abstract class QuadSerializerBase implements IQuadSerializer {
      * Whether this serializer supports RDF 1.2 features (triple terms, reifiers, annotations).
      */
     protected supportsRdf12: boolean;
+    /**
+     * The settings the terms of the current serialization run are written with, resolved from
+     * the capabilities of this serializer and the options the hooks are called with.
+     */
+    private _termSettings?;
+    /**
+     * The options the term settings were resolved from.
+     */
+    private _termOptions?;
     /**
      * Serializes a single quad to a string.
      */
@@ -44,11 +54,19 @@ export declare abstract class QuadSerializerBase implements IQuadSerializer {
     /**
      * Serializes a blank node.
      */
-    protected serializeBlankNode(node: BlankNode, _options: Required<SerializationOptions>): string;
+    protected serializeBlankNode(node: BlankNode, options: Required<SerializationOptions>): string;
     /**
      * Serializes a literal value.
      */
     protected serializeLiteral(literal: Literal, options: Required<SerializationOptions>): string;
+    /**
+     * Gets the settings the terms are written with for a set of options. Some serializers merge
+     * the options anew for every quad, so a run is told apart by the options object the hooks
+     * are called with; resolving the settings again is cheap.
+     * @param options The merged options of the run.
+     * @returns The term settings.
+     */
+    protected termSettingsFor(options: Required<SerializationOptions>): TermSerializerSettings;
     /**
      * Serializes a SPARQL variable.
      */

package/dist/quad-serializer-base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quad-serializer-base.d.ts","sourceRoot":"","sources":["../src/quad-serializer-base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAmB,MAAM,yBAAyB,CAAC;AAMhF;;;GAGG;AACH,8BAAsB,kBAAmB,YAAW,eAAe;IAC/D;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAEpC;;OAEG;IACH,SAAS,CAAC,gBAAgB,EAAE,OAAO,CAAS;IAE5C;;OAEG;IACH,SAAS,CAAC,wBAAwB,EAAE,OAAO,CAAS;IAEpD;;OAEG;IACH,SAAS,CAAC,aAAa,EAAE,OAAO,CAAS;IAEzC;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM;IAEtF;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,GAAG,SAAS,CAAC,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM;IAE7F;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,GAAG,SAAS,CAAC,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,mBAAmB;IAM9F;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,MAAM;IAmB9F;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,MAAM;IAI/F;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,MAAM;IAuD7F;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,MAAM;IAIjG;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,MAAM;IAYtG;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,MAAM;IAmBhG;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,QAAQ,CAAC,oBAAoB,CAAC;CAGvF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,QAAQ,CAAC,oBAAoB,CAAC,CAS3F"}
+{"version":3,"file":"quad-serializer-base.d.ts","sourceRoot":"","sources":["../src/quad-serializer-base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAmB,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAkB,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3E;;;GAGG;AACH,8BAAsB,kBAAmB,YAAW,eAAe;IAC/D;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAEpC;;OAEG;IACH,SAAS,CAAC,gBAAgB,EAAE,OAAO,CAAS;IAE5C;;OAEG;IACH,SAAS,CAAC,wBAAwB,EAAE,OAAO,CAAS;IAEpD;;OAEG;IACH,SAAS,CAAC,aAAa,EAAE,OAAO,CAAS;IAEzC;;;OAGG;IACH,OAAO,CAAC,aAAa,CAAC,CAAyB;IAE/C;;OAEG;IACH,OAAO,CAAC,YAAY,CAAC,CAAiC;IAEtD;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM;IAEtF;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,GAAG,SAAS,CAAC,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM;IAE7F;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,GAAG,SAAS,CAAC,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,mBAAmB;IAM9F;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,MAAM;IAI9F;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,MAAM;IAI9F;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,MAAM;IAI7F;;;;;;OAMG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,sBAAsB;IAY1F;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,MAAM;IAIjG;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,MAAM;IAYtG;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,MAAM;IAmBhG;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,QAAQ,CAAC,oBAAoB,CAAC;CAGvF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,QAAQ,CAAC,oBAAoB,CAAC,CAS3F"}

package/dist/quad-serializer-base.js

@@ -1,9 +1,5 @@
-import { RDF, XSD } from './ontologies';
 import { DEFAULT_OPTIONS } from './serialization-options';
-import { escapeLocalName, escapeIri, escapeString } from "./utilities/escaping";
-import { isInteger, isDecimal, isDouble, needsLongString } from "./utilities/literals";
-import { normalizeBlankNodeId } from './utilities/blank-nodes';
-import { findPrefix } from "./utilities/prefixes";
+import { TermSerializer } from './term-serializer';
 /**
  * Abstract base class for RDF serializers. Provides common functionality
  * for serializing terms and literals.
@@ -21,6 +17,15 @@ export class QuadSerializerBase {
      * Whether this serializer supports RDF 1.2 features (triple terms, reifiers, annotations).
      */
     supportsRdf12 = false;
+    /**
+     * The settings the terms of the current serialization run are written with, resolved from
+     * the capabilities of this serializer and the options the hooks are called with.
+     */
+    _termSettings;
+    /**
+     * The options the term settings were resolved from.
+     */
+    _termOptions;
     /**
      * Serializes quads with formatting, returning detailed result.
      */
@@ -33,70 +38,33 @@ export class QuadSerializerBase {
      * Serializes a named node (IRI).
      */
     serializeNamedNode(node, options) {
-        // Check for rdf:type shorthand
-        if (this.supportsRdfTypeShorthand && options.useRdfTypeShorthand && node.value === RDF.type) {
-            return 'a';
-        }
-        if (this.supportsPrefixes && Object.keys(options.prefixes).length > 0) {
-            const prefixMatch = findPrefix(node.value, options.prefixes);
-            if (prefixMatch) {
-                const escapedLocalName = escapeLocalName(prefixMatch.localName);
-                return `${prefixMatch.prefix}:${escapedLocalName}`;
-            }
-        }
-        return `<${escapeIri(node.value)}>`;
+        return TermSerializer.serializeNamedNode(node, this.termSettingsFor(options), true);
     }
     /**
      * Serializes a blank node.
      */
-    serializeBlankNode(node, _options) {
-        return `_:${normalizeBlankNodeId(node.value)}`;
+    serializeBlankNode(node, options) {
+        return TermSerializer.serializeBlankNode(node, this.termSettingsFor(options));
     }
     /**
      * Serializes a literal value.
      */
     serializeLiteral(literal, options) {
-        const value = literal.value;
-        const datatype = literal.datatype?.value;
-        const language = literal.language;
-        if (language) {
-            const escapedValue = escapeString(value);
-            return `"${escapedValue}"@${language}`;
-        }
-        if (this.supportsPrefixes && datatype === XSD.boolean) {
-            if (value === 'true' || value === '1') {
-                return 'true';
-            }
-            if (value === 'false' || value === '0') {
-                return 'false';
-            }
-        }
-        if (this.supportsPrefixes) {
-            if (datatype === XSD.integer && isInteger(value)) {
-                return value;
-            }
-            if (datatype === XSD.decimal && isDecimal(value)) {
-                return value;
-            }
-            if (datatype === XSD.double && isDouble(value)) {
-                return value;
-            }
-        }
-        // Check if we need long string quoting
-        const useLongString = this.supportsPrefixes && needsLongString(value);
-        const quote = useLongString ? '"""' : '"';
-        const escapedValue = escapeString(value, useLongString);
-        // xsd:string is the default, no need to serialize it
-        if (!datatype || datatype === XSD.string) {
-            return `${quote}${escapedValue}${quote}`;
+        return TermSerializer.serializeLiteral(literal, this.termSettingsFor(options));
+    }
+    /**
+     * Gets the settings the terms are written with for a set of options. Some serializers merge
+     * the options anew for every quad, so a run is told apart by the options object the hooks
+     * are called with; resolving the settings again is cheap.
+     * @param options The merged options of the run.
+     * @returns The term settings.
+     */
+    termSettingsFor(options) {
+        if (options !== this._termOptions || !this._termSettings) {
+            this._termSettings = TermSerializer.settingsOf({ supportsPrefixes: this.supportsPrefixes, supportsRdfTypeShorthand: this.supportsRdfTypeShorthand }, { prefixes: options.prefixes, useRdfTypeShorthand: options.useRdfTypeShorthand });
+            this._termOptions = options;
         }
-        // Serialize with datatype
-        const datatypeStr = this.serializeNamedNode({
-            termType: 'NamedNode',
-            value: datatype,
-            equals: () => false
-        }, options);
-        return `${quote}${escapedValue}${quote}^^${datatypeStr}`;
+        return this._termSettings;
     }
     /**
      * Serializes a SPARQL variable.

package/dist/quad-serializer-base.js.map

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

package/dist/term-serializer.d.ts

@@ -0,0 +1,172 @@
+import { RdfSyntax } from '@faubulous/mentor-rdf-parsers';
+import { BlankNode, Literal, NamedNode, Term } from '@rdfjs/types';
+/**
+ * What a syntax allows a term serializer to abbreviate.
+ */
+export interface TermSerializerCapabilities {
+    /**
+     * Whether IRIs may be written as prefixed names and numbers, booleans and multi-line
+     * strings in their bare or long forms.
+     */
+    supportsPrefixes: boolean;
+    /**
+     * Whether `rdf:type` may be written as `a` in predicate position.
+     */
+    supportsRdfTypeShorthand: boolean;
+}
+/**
+ * Options of a term serializer.
+ */
+export interface TermSerializerOptions {
+    /**
+     * Prefix mappings for compact IRI serialization, prefix name to namespace IRI.
+     */
+    prefixes?: Record<string, string>;
+    /**
+     * Whether to write `rdf:type` as `a` in predicate position. Default: true.
+     */
+    useRdfTypeShorthand?: boolean;
+    /**
+     * The labels to write for blank nodes, by identifier, such as the labels a document already
+     * uses. A blank node without one is written as `_:` with its normalized identifier.
+     */
+    blankNodeLabels?: Record<string, string>;
+}
+/**
+ * Everything the serialization of a term depends on: the capabilities of the syntax and the
+ * options of the run, resolved to plain values.
+ */
+export interface TermSerializerSettings {
+    /**
+     * Whether IRIs may be written as prefixed names and literals in their bare forms.
+     */
+    supportsPrefixes: boolean;
+    /**
+     * Whether `rdf:type` may be written as `a` in predicate position.
+     */
+    supportsRdfTypeShorthand: boolean;
+    /**
+     * Prefix name to namespace IRI.
+     */
+    prefixes: Record<string, string>;
+    /**
+     * Whether to write `rdf:type` as `a` in predicate position.
+     */
+    useRdfTypeShorthand: boolean;
+    /**
+     * The labels to write for blank nodes, by identifier, if any.
+     */
+    blankNodeLabels?: Record<string, string>;
+}
+/**
+ * Serializes single RDF terms the way a document of a syntax writes them: prefixed names where
+ * a prefix is declared, `a` for `rdf:type` in predicate position, bare numbers and booleans, and
+ * long strings for multi-line text where the syntax allows it. The quad serializers build on the
+ * static methods, which take the settings of a run; the instance methods serve code that writes
+ * terms into a document, such as an editor.
+ */
+export declare class TermSerializer {
+    private readonly _capabilities;
+    private _settings;
+    /**
+     * Create a term serializer.
+     * @param capabilities What the target syntax allows.
+     * @param options The serialization options.
+     */
+    constructor(capabilities: TermSerializerCapabilities, options?: TermSerializerOptions);
+    /**
+     * Create a term serializer for a syntax.
+     * @param syntax The syntax the terms are written in.
+     * @param options The serialization options.
+     * @returns A term serializer with the capabilities of the syntax.
+     */
+    static forSyntax(syntax: RdfSyntax, options?: TermSerializerOptions): TermSerializer;
+    /**
+     * Resolve capabilities and options to the settings of a run.
+     * @param capabilities What the target syntax allows.
+     * @param options The serialization options.
+     * @returns The settings.
+     */
+    static settingsOf(capabilities: TermSerializerCapabilities, options?: TermSerializerOptions): TermSerializerSettings;
+    /**
+     * Serialize a named node as a prefixed name when a prefix matches, or as an IRI reference.
+     * @param node The named node.
+     * @param settings The settings of the run.
+     * @param allowTypeShorthand Whether `rdf:type` may be written as `a`, as in predicate position.
+     * @returns The serialized node.
+     */
+    static serializeNamedNode(node: NamedNode, settings: TermSerializerSettings, allowTypeShorthand?: boolean): string;
+    /**
+     * Serialize a blank node with its configured label, or as `_:` with its normalized identifier.
+     * @param node The blank node.
+     * @param settings The settings of the run.
+     * @returns The serialized node.
+     */
+    static serializeBlankNode(node: BlankNode, settings: TermSerializerSettings): string;
+    /**
+     * Serialize a literal: bare where the syntax allows it and the lexical form is valid for the
+     * datatype, quoted with its language tag or datatype otherwise.
+     * @param literal The literal.
+     * @param settings The settings of the run.
+     * @returns The serialized literal.
+     */
+    static serializeLiteral(literal: Literal, settings: TermSerializerSettings): string;
+    /**
+     * Write a number or boolean without quotes when the lexical form is valid for the datatype.
+     * @param value The lexical value.
+     * @param datatype The datatype IRI, if any.
+     * @returns The bare form, or `undefined` if the literal has to be quoted.
+     */
+    private static _serializeBareLiteral;
+    /**
+     * Change the options the terms are written with, keeping the capabilities of the syntax.
+     * @param options The serialization options.
+     * @returns This serializer.
+     */
+    configure(options: TermSerializerOptions): this;
+    /**
+     * Whether the syntax allows prefixed names and bare literals.
+     */
+    get abbreviates(): boolean;
+    /**
+     * Serialize a term in subject position.
+     * @param term The subject term.
+     * @returns The serialized term.
+     * @throws An error if the term cannot be a subject.
+     */
+    serializeSubject(term: Term): string;
+    /**
+     * Serialize a term in predicate position, where `rdf:type` may be written as `a`.
+     * @param term The predicate term.
+     * @returns The serialized term.
+     */
+    serializePredicate(term: NamedNode): string;
+    /**
+     * Serialize a term in object position.
+     * @param term The object term.
+     * @returns The serialized term.
+     * @throws An error if the term type cannot be written.
+     */
+    serializeObject(term: Term): string;
+    /**
+     * Serialize a named node as a prefixed name when a prefix matches, or as an IRI reference.
+     * @param node The named node.
+     * @param allowTypeShorthand Whether `rdf:type` may be written as `a`, as in predicate position.
+     * @returns The serialized node.
+     */
+    serializeNamedNode(node: NamedNode, allowTypeShorthand?: boolean): string;
+    /**
+     * Serialize a blank node with its configured label, or as `_:` with its normalized identifier.
+     * @param node The blank node.
+     * @returns The serialized node.
+     */
+    serializeBlankNode(node: BlankNode): string;
+    /**
+     * Serialize a literal: bare where the syntax allows it and the lexical form is valid for the
+     * datatype, quoted with its language tag or datatype otherwise.
+     * @param literal The literal.
+     * @returns The serialized literal.
+     */
+    serializeLiteral(literal: Literal): string;
+}
+//# sourceMappingURL=term-serializer.d.ts.map

package/dist/term-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"term-serializer.d.ts","sourceRoot":"","sources":["../src/term-serializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAOnE;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC;;;OAGG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,wBAAwB,EAAE,OAAO,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACnC;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,wBAAwB,EAAE,OAAO,CAAC;IAElC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;OAEG;IACH,mBAAmB,EAAE,OAAO,CAAC;IAE7B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAED;;;;;;GAMG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAE3D,OAAO,CAAC,SAAS,CAAyB;IAE1C;;;;OAIG;gBACS,YAAY,EAAE,0BAA0B,EAAE,OAAO,GAAE,qBAA0B;IAKzF;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,cAAc;IAMpF;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,YAAY,EAAE,0BAA0B,EAAE,OAAO,GAAE,qBAA0B,GAAG,sBAAsB;IAUxH;;;;;;OAMG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,sBAAsB,EAAE,kBAAkB,GAAE,OAAe,GAAG,MAAM;IAgBzH;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,sBAAsB,GAAG,MAAM;IAIpF;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,sBAAsB,GAAG,MAAM;IA4BnF;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAoBpC;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAM/C;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IAQpC;;;;OAIG;IACH,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM;IAI3C;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IAanC;;;;;OAKG;IACH,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,kBAAkB,GAAE,OAAe,GAAG,MAAM;IAIhF;;;;OAIG;IACH,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM;IAI3C;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;CAG7C"}

package/dist/term-serializer.js

@@ -0,0 +1,208 @@
+import { RdfSyntax } from '@faubulous/mentor-rdf-parsers';
+import { RDF, XSD } from './ontologies';
+import { normalizeBlankNodeId } from './utilities/blank-nodes';
+import { escapeIri, escapeLocalName, escapeString } from './utilities/escaping';
+import { isDecimal, isDouble, isInteger, needsLongString } from './utilities/literals';
+import { findPrefix } from './utilities/prefixes';
+/**
+ * Serializes single RDF terms the way a document of a syntax writes them: prefixed names where
+ * a prefix is declared, `a` for `rdf:type` in predicate position, bare numbers and booleans, and
+ * long strings for multi-line text where the syntax allows it. The quad serializers build on the
+ * static methods, which take the settings of a run; the instance methods serve code that writes
+ * terms into a document, such as an editor.
+ */
+export class TermSerializer {
+    _capabilities;
+    _settings;
+    /**
+     * Create a term serializer.
+     * @param capabilities What the target syntax allows.
+     * @param options The serialization options.
+     */
+    constructor(capabilities, options = {}) {
+        this._capabilities = capabilities;
+        this._settings = TermSerializer.settingsOf(capabilities, options);
+    }
+    /**
+     * Create a term serializer for a syntax.
+     * @param syntax The syntax the terms are written in.
+     * @param options The serialization options.
+     * @returns A term serializer with the capabilities of the syntax.
+     */
+    static forSyntax(syntax, options) {
+        const abbreviates = syntax === RdfSyntax.Turtle || syntax === RdfSyntax.TriG || syntax === RdfSyntax.N3;
+        return new TermSerializer({ supportsPrefixes: abbreviates, supportsRdfTypeShorthand: abbreviates }, options);
+    }
+    /**
+     * Resolve capabilities and options to the settings of a run.
+     * @param capabilities What the target syntax allows.
+     * @param options The serialization options.
+     * @returns The settings.
+     */
+    static settingsOf(capabilities, options = {}) {
+        return {
+            supportsPrefixes: capabilities.supportsPrefixes,
+            supportsRdfTypeShorthand: capabilities.supportsRdfTypeShorthand,
+            prefixes: options.prefixes ?? {},
+            useRdfTypeShorthand: options.useRdfTypeShorthand ?? true,
+            blankNodeLabels: options.blankNodeLabels
+        };
+    }
+    /**
+     * Serialize a named node as a prefixed name when a prefix matches, or as an IRI reference.
+     * @param node The named node.
+     * @param settings The settings of the run.
+     * @param allowTypeShorthand Whether `rdf:type` may be written as `a`, as in predicate position.
+     * @returns The serialized node.
+     */
+    static serializeNamedNode(node, settings, allowTypeShorthand = false) {
+        if (allowTypeShorthand && settings.supportsRdfTypeShorthand && settings.useRdfTypeShorthand && node.value === RDF.type) {
+            return 'a';
+        }
+        if (settings.supportsPrefixes) {
+            const match = findPrefix(node.value, settings.prefixes);
+            if (match) {
+                return `${match.prefix}:${escapeLocalName(match.localName)}`;
+            }
+        }
+        return `<${escapeIri(node.value)}>`;
+    }
+    /**
+     * Serialize a blank node with its configured label, or as `_:` with its normalized identifier.
+     * @param node The blank node.
+     * @param settings The settings of the run.
+     * @returns The serialized node.
+     */
+    static serializeBlankNode(node, settings) {
+        return settings.blankNodeLabels?.[node.value] ?? `_:${normalizeBlankNodeId(node.value)}`;
+    }
+    /**
+     * Serialize a literal: bare where the syntax allows it and the lexical form is valid for the
+     * datatype, quoted with its language tag or datatype otherwise.
+     * @param literal The literal.
+     * @param settings The settings of the run.
+     * @returns The serialized literal.
+     */
+    static serializeLiteral(literal, settings) {
+        const value = literal.value;
+        const datatype = literal.datatype?.value;
+        const language = literal.language;
+        if (language) {
+            return `"${escapeString(value)}"@${language}`;
+        }
+        if (settings.supportsPrefixes) {
+            const bare = TermSerializer._serializeBareLiteral(value, datatype);
+            if (bare !== undefined) {
+                return bare;
+            }
+        }
+        const useLongString = settings.supportsPrefixes && needsLongString(value);
+        const quote = useLongString ? '"""' : '"';
+        const quoted = `${quote}${escapeString(value, useLongString)}${quote}`;
+        if (!datatype || datatype === XSD.string) {
+            return quoted;
+        }
+        return `${quoted}^^${TermSerializer.serializeNamedNode(literal.datatype, settings)}`;
+    }
+    /**
+     * Write a number or boolean without quotes when the lexical form is valid for the datatype.
+     * @param value The lexical value.
+     * @param datatype The datatype IRI, if any.
+     * @returns The bare form, or `undefined` if the literal has to be quoted.
+     */
+    static _serializeBareLiteral(value, datatype) {
+        if (datatype === XSD.boolean && (value === 'true' || value === 'false' || value === '1' || value === '0')) {
+            return value === 'true' || value === '1' ? 'true' : 'false';
+        }
+        if (datatype === XSD.integer && isInteger(value)) {
+            return value;
+        }
+        if (datatype === XSD.decimal && isDecimal(value)) {
+            return value;
+        }
+        if (datatype === XSD.double && isDouble(value)) {
+            return value;
+        }
+        return undefined;
+    }
+    /**
+     * Change the options the terms are written with, keeping the capabilities of the syntax.
+     * @param options The serialization options.
+     * @returns This serializer.
+     */
+    configure(options) {
+        this._settings = TermSerializer.settingsOf(this._capabilities, options);
+        return this;
+    }
+    /**
+     * Whether the syntax allows prefixed names and bare literals.
+     */
+    get abbreviates() {
+        return this._settings.supportsPrefixes;
+    }
+    /**
+     * Serialize a term in subject position.
+     * @param term The subject term.
+     * @returns The serialized term.
+     * @throws An error if the term cannot be a subject.
+     */
+    serializeSubject(term) {
+        if (term.termType === 'Literal') {
+            throw new Error('A literal cannot be the subject of a statement.');
+        }
+        return this.serializeObject(term);
+    }
+    /**
+     * Serialize a term in predicate position, where `rdf:type` may be written as `a`.
+     * @param term The predicate term.
+     * @returns The serialized term.
+     */
+    serializePredicate(term) {
+        return TermSerializer.serializeNamedNode(term, this._settings, true);
+    }
+    /**
+     * Serialize a term in object position.
+     * @param term The object term.
+     * @returns The serialized term.
+     * @throws An error if the term type cannot be written.
+     */
+    serializeObject(term) {
+        switch (term.termType) {
+            case 'NamedNode':
+                return this.serializeNamedNode(term);
+            case 'BlankNode':
+                return this.serializeBlankNode(term);
+            case 'Literal':
+                return this.serializeLiteral(term);
+            default:
+                throw new Error(`A term of type ${term.termType} cannot be written as a single term.`);
+        }
+    }
+    /**
+     * Serialize a named node as a prefixed name when a prefix matches, or as an IRI reference.
+     * @param node The named node.
+     * @param allowTypeShorthand Whether `rdf:type` may be written as `a`, as in predicate position.
+     * @returns The serialized node.
+     */
+    serializeNamedNode(node, allowTypeShorthand = false) {
+        return TermSerializer.serializeNamedNode(node, this._settings, allowTypeShorthand);
+    }
+    /**
+     * Serialize a blank node with its configured label, or as `_:` with its normalized identifier.
+     * @param node The blank node.
+     * @returns The serialized node.
+     */
+    serializeBlankNode(node) {
+        return TermSerializer.serializeBlankNode(node, this._settings);
+    }
+    /**
+     * Serialize a literal: bare where the syntax allows it and the lexical form is valid for the
+     * datatype, quoted with its language tag or datatype otherwise.
+     * @param literal The literal.
+     * @returns The serialized literal.
+     */
+    serializeLiteral(literal) {
+        return TermSerializer.serializeLiteral(literal, this._settings);
+    }
+}
+//# sourceMappingURL=term-serializer.js.map

package/dist/term-serializer.js.map

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

package/package.json

@@ -15,7 +15,7 @@
     "sparql",
     "typescript"
   ],
-  "version": "1.9.3",
+  "version": "1.10.0",
   "private": false,
   "author": {
     "name": "Sebastian Faubel"