@faubulous/mentor-rdf-serializers 1.0.0

package/dist/jsonld/serializer.d.ts

@@ -0,0 +1,99 @@
+import type { Quad } from '@rdfjs/types';
+import type { ISerializer, Rdf12Quad, SerializationResult, SerializerOptions, RdfSyntax as RdfSyntaxType } from '../types.js';
+/**
+ * JSON-LD specific options.
+ */
+export interface JsonLdSerializerOptions extends SerializerOptions {
+    /**
+     * Whether to use @type shorthand instead of rdf:type.
+     * Default: true
+     */
+    useTypeShorthand?: boolean;
+    /**
+     * Whether to use @id shorthand instead of full IRI objects.
+     * Default: true
+     */
+    useIdShorthand?: boolean;
+    /**
+     * Whether to compact arrays with single items.
+     * Default: true
+     */
+    compactArrays?: boolean;
+    /**
+     * Whether to embed @context in the output.
+     * Default: true
+     */
+    embedContext?: boolean;
+    /**
+     * JSON indentation spaces (default: 2).
+     */
+    jsonIndent?: number;
+}
+/**
+ * Serializer for JSON-LD format.
+ *
+ * JSON-LD is a JSON-based format for Linked Data that can be used
+ * both as RDF and as plain JSON.
+ *
+ * Supports RDF 1.2 features including:
+ * - Triple terms via @id references
+ * - Base direction in language tags
+ *
+ * @see https://www.w3.org/TR/json-ld11/
+ */
+export declare class JsonLdSerializer implements ISerializer {
+    readonly syntax: RdfSyntaxType;
+    /**
+     * Serializes a single quad to JSON-LD format.
+     */
+    serializeQuad(quad: Quad | Rdf12Quad, options?: JsonLdSerializerOptions): string;
+    /**
+     * Serializes multiple quads to JSON-LD format.
+     */
+    serialize(quads: Iterable<Quad | Rdf12Quad>, options?: JsonLdSerializerOptions): string;
+    /**
+     * Formats quads to JSON-LD with detailed result.
+     */
+    format(quads: Iterable<Quad | Rdf12Quad>, options?: JsonLdSerializerOptions): SerializationResult;
+    /**
+     * Builds the @context object from prefixes.
+     */
+    private buildContext;
+    /**
+     * Builds a graph node containing all quads.
+     */
+    private buildGraph;
+    /**
+     * Builds the content of a graph (array of nodes).
+     */
+    private buildGraphContent;
+    /**
+     * Builds a JSON-LD node from a subject and its quads.
+     */
+    private buildNode;
+    /**
+     * Builds a JSON-LD value from an RDF term.
+     */
+    private buildValue;
+    /**
+     * Builds a JSON-LD literal value.
+     */
+    private buildLiteralValue;
+    /**
+     * Builds a JSON-LD representation of a triple term (RDF 1.2).
+     */
+    private buildTripleTermValue;
+    /**
+     * Compacts an IRI using prefixes.
+     */
+    private compactIri;
+    /**
+     * Extracts the IRI value from a graph term.
+     */
+    private extractIri;
+    /**
+     * Gets merged options with defaults.
+     */
+    private getOptions;
+}
+//# sourceMappingURL=serializer.d.ts.map

package/dist/jsonld/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../../src/jsonld/serializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiC,IAAI,EAAQ,MAAM,cAAc,CAAC;AAC9E,OAAO,KAAK,EACR,WAAW,EACX,SAAS,EAET,mBAAmB,EACnB,iBAAiB,EAEjB,SAAS,IAAI,aAAa,EAC7B,MAAM,aAAa,CAAC;AAmBrB;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAC9D;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAiBD;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAChD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAoB;IAElD;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,MAAM;IAIhF;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,GAAG,SAAS,CAAC,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,MAAM;IAsDvF;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,GAAG,SAAS,CAAC,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,mBAAmB;IAMjG;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;IACH,OAAO,CAAC,SAAS;IA4DjB;;OAEG;IACH,OAAO,CAAC,UAAU;IAsBlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgDzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiB5B;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,UAAU;CAWrB"}

package/dist/jsonld/serializer.js

@@ -0,0 +1,282 @@
+import { RdfSyntax } from '../types.js';
+import { findPrefix, groupQuadsByGraph, groupQuadsBySubject, mergeOptions, parseLanguageTag, RDF_NAMESPACE, RDF_TYPE, sortQuads, XSD_BOOLEAN, XSD_DECIMAL, XSD_DOUBLE, XSD_INTEGER, XSD_STRING } from '../utils.js';
+/**
+ * Serializer for JSON-LD format.
+ *
+ * JSON-LD is a JSON-based format for Linked Data that can be used
+ * both as RDF and as plain JSON.
+ *
+ * Supports RDF 1.2 features including:
+ * - Triple terms via @id references
+ * - Base direction in language tags
+ *
+ * @see https://www.w3.org/TR/json-ld11/
+ */
+export class JsonLdSerializer {
+    syntax = RdfSyntax.JsonLd;
+    /**
+     * Serializes a single quad to JSON-LD format.
+     */
+    serializeQuad(quad, options) {
+        return this.serialize([quad], options);
+    }
+    /**
+     * Serializes multiple quads to JSON-LD format.
+     */
+    serialize(quads, options) {
+        const opts = this.getOptions(options);
+        const quadArray = Array.from(quads);
+        if (quadArray.length === 0) {
+            return '{}';
+        }
+        // Sort if requested  
+        const sortedQuads = opts.sort ? sortQuads(quadArray) : quadArray;
+        // Group by graph first
+        const graphGroups = groupQuadsByGraph(sortedQuads);
+        // Build JSON-LD structure
+        const result = {};
+        // Add @context if prefixes are provided
+        if (opts.embedContext && Object.keys(opts.prefixes).length > 0) {
+            result['@context'] = this.buildContext(opts);
+        }
+        // Check if we have multiple graphs
+        const hasNamedGraphs = Array.from(graphGroups.keys()).some(k => k !== '');
+        if (hasNamedGraphs) {
+            // Dataset with named graphs
+            const graphs = [];
+            for (const [graphKey, graphQuads] of graphGroups) {
+                const graphNode = this.buildGraph(graphQuads, opts);
+                if (graphKey !== '') {
+                    graphNode['@id'] = this.extractIri(graphQuads[0].graph);
+                }
+                graphs.push(graphNode);
+            }
+            result['@graph'] = graphs.length === 1 && !opts.compactArrays ? graphs : graphs;
+        }
+        else {
+            // Single default graph
+            const defaultGraphQuads = graphGroups.get('') || [];
+            const graphContent = this.buildGraphContent(defaultGraphQuads, opts);
+            if (graphContent.length === 1 && opts.compactArrays) {
+                Object.assign(result, graphContent[0]);
+            }
+            else {
+                result['@graph'] = graphContent;
+            }
+        }
+        const indent = opts.jsonIndent ?? 2;
+        return JSON.stringify(result, null, opts.prettyPrint ? indent : undefined);
+    }
+    /**
+     * Formats quads to JSON-LD with detailed result.
+     */
+    format(quads, options) {
+        return {
+            output: this.serialize(quads, options)
+        };
+    }
+    /**
+     * Builds the @context object from prefixes.
+     */
+    buildContext(opts) {
+        const context = {};
+        for (const [prefix, namespace] of Object.entries(opts.prefixes)) {
+            context[prefix] = namespace;
+        }
+        return context;
+    }
+    /**
+     * Builds a graph node containing all quads.
+     */
+    buildGraph(quads, opts) {
+        const content = this.buildGraphContent(quads, opts);
+        return {
+            '@graph': content
+        };
+    }
+    /**
+     * Builds the content of a graph (array of nodes).
+     */
+    buildGraphContent(quads, opts) {
+        const subjectGroups = groupQuadsBySubject(quads);
+        const nodes = [];
+        for (const [_subjectKey, subjectQuads] of subjectGroups) {
+            const node = this.buildNode(subjectQuads[0].subject, subjectQuads, opts);
+            nodes.push(node);
+        }
+        return nodes;
+    }
+    /**
+     * Builds a JSON-LD node from a subject and its quads.
+     */
+    buildNode(subject, quads, opts) {
+        const node = {};
+        // Add @id for named nodes and blank nodes
+        if (subject.termType === 'NamedNode') {
+            node['@id'] = this.compactIri(subject.value, opts);
+        }
+        else if (subject.termType === 'BlankNode') {
+            node['@id'] = `_:${subject.value}`;
+        }
+        else if (subject.termType === 'TripleTerm') {
+            // Handle RDF 1.2 triple term subjects
+            // JSON-LD doesn't directly support this, so we represent as reified statement
+            const tt = subject;
+            node['@type'] = this.compactIri(`${RDF_NAMESPACE}Statement`, opts);
+            node[this.compactIri(`${RDF_NAMESPACE}subject`, opts)] =
+                this.buildValue(tt.subject, opts);
+            node[this.compactIri(`${RDF_NAMESPACE}predicate`, opts)] =
+                this.buildValue(tt.predicate, opts);
+            node[this.compactIri(`${RDF_NAMESPACE}object`, opts)] =
+                this.buildValue(tt.object, opts);
+        }
+        // Group properties
+        const properties = new Map();
+        for (const quad of quads) {
+            const predKey = quad.predicate.value;
+            if (!properties.has(predKey)) {
+                properties.set(predKey, []);
+            }
+            properties.get(predKey).push(quad);
+        }
+        // Build properties
+        for (const [predicateIri, propQuads] of properties) {
+            const values = propQuads.map(q => this.buildValue(q.object, opts));
+            // Use @type shorthand for rdf:type
+            if (opts.useTypeShorthand && predicateIri === RDF_TYPE) {
+                const types = values.map(v => {
+                    if (typeof v === 'object' && v !== null && '@id' in v) {
+                        return v['@id'];
+                    }
+                    return v;
+                }).filter((v) => typeof v === 'string');
+                node['@type'] = opts.compactArrays && types.length === 1 ? types[0] : types;
+            }
+            else {
+                const propName = this.compactIri(predicateIri, opts);
+                node[propName] = opts.compactArrays && values.length === 1
+                    ? values[0]
+                    : values;
+            }
+        }
+        return node;
+    }
+    /**
+     * Builds a JSON-LD value from an RDF term.
+     */
+    buildValue(term, opts) {
+        switch (term.termType) {
+            case 'NamedNode':
+                if (opts.useIdShorthand) {
+                    return { '@id': this.compactIri(term.value, opts) };
+                }
+                return { '@id': term.value };
+            case 'BlankNode':
+                return { '@id': `_:${term.value}` };
+            case 'Literal':
+                return this.buildLiteralValue(term, opts);
+            case 'TripleTerm':
+                return this.buildTripleTermValue(term, opts);
+            default:
+                return null;
+        }
+    }
+    /**
+     * Builds a JSON-LD literal value.
+     */
+    buildLiteralValue(literal, opts) {
+        const datatype = literal.datatype?.value;
+        const language = literal.language;
+        // Language-tagged literal
+        if (language) {
+            const parsed = parseLanguageTag(language);
+            const result = {
+                '@value': literal.value,
+                '@language': parsed.language
+            };
+            if (parsed.direction) {
+                result['@direction'] = parsed.direction;
+            }
+            return result;
+        }
+        // Native JSON types
+        if (datatype === XSD_BOOLEAN) {
+            return literal.value === 'true' || literal.value === '1';
+        }
+        if (datatype === XSD_INTEGER) {
+            const num = parseInt(literal.value, 10);
+            if (!isNaN(num)) {
+                return num;
+            }
+        }
+        if (datatype === XSD_DOUBLE || datatype === XSD_DECIMAL) {
+            const num = parseFloat(literal.value);
+            if (!isNaN(num)) {
+                return num;
+            }
+        }
+        // Plain string (xsd:string is default)
+        if (!datatype || datatype === XSD_STRING) {
+            return literal.value;
+        }
+        // Typed literal
+        return {
+            '@value': literal.value,
+            '@type': this.compactIri(datatype, opts)
+        };
+    }
+    /**
+     * Builds a JSON-LD representation of a triple term (RDF 1.2).
+     */
+    buildTripleTermValue(tripleTerm, opts) {
+        // JSON-LD 1.1 doesn't have native triple term support,
+        // but we can represent it as a reified statement
+        const result = {
+            '@type': this.compactIri(`${RDF_NAMESPACE}Statement`, opts)
+        };
+        result[this.compactIri(`${RDF_NAMESPACE}subject`, opts)] =
+            this.buildValue(tripleTerm.subject, opts);
+        result[this.compactIri(`${RDF_NAMESPACE}predicate`, opts)] =
+            this.buildValue(tripleTerm.predicate, opts);
+        result[this.compactIri(`${RDF_NAMESPACE}object`, opts)] =
+            this.buildValue(tripleTerm.object, opts);
+        return result;
+    }
+    /**
+     * Compacts an IRI using prefixes.
+     */
+    compactIri(iri, opts) {
+        const prefixMatch = findPrefix(iri, opts.prefixes);
+        if (prefixMatch) {
+            return `${prefixMatch.prefix}:${prefixMatch.localName}`;
+        }
+        return iri;
+    }
+    /**
+     * Extracts the IRI value from a graph term.
+     */
+    extractIri(term) {
+        if (term.termType === 'NamedNode') {
+            return term.value;
+        }
+        if (term.termType === 'BlankNode') {
+            return `_:${term.value}`;
+        }
+        return '';
+    }
+    /**
+     * Gets merged options with defaults.
+     */
+    getOptions(options) {
+        const base = mergeOptions(options);
+        return {
+            ...base,
+            useTypeShorthand: options?.useTypeShorthand ?? true,
+            useIdShorthand: options?.useIdShorthand ?? true,
+            compactArrays: options?.compactArrays ?? true,
+            embedContext: options?.embedContext ?? true,
+            jsonIndent: options?.jsonIndent ?? 2
+        };
+    }
+}
+//# sourceMappingURL=serializer.js.map

package/dist/jsonld/serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../../src/jsonld/serializer.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACH,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EAEnB,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,QAAQ,EACR,SAAS,EACT,WAAW,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,EACb,MAAM,aAAa,CAAC;AAmDrB;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,gBAAgB;IAChB,MAAM,GAAkB,SAAS,CAAC,MAAM,CAAC;IAElD;;OAEG;IACH,aAAa,CAAC,IAAsB,EAAE,OAAiC;QACnE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAAiC,EAAE,OAAiC;QAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEpC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,sBAAsB;QACtB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEjE,uBAAuB;QACvB,MAAM,WAAW,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAEnD,0BAA0B;QAC1B,MAAM,MAAM,GAA4B,EAAE,CAAC;QAE3C,wCAAwC;QACxC,IAAI,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7D,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;QAED,mCAAmC;QACnC,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAE1E,IAAI,cAAc,EAAE,CAAC;YACjB,4BAA4B;YAC5B,MAAM,MAAM,GAAiB,EAAE,CAAC;YAEhC,KAAK,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,WAAW,EAAE,CAAC;gBAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;gBACpD,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;oBAClB,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC5D,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC3B,CAAC;YAED,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QACpF,CAAC;aAAM,CAAC;YACJ,uBAAuB;YACvB,MAAM,iBAAiB,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;YACpD,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;YAErE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBAClD,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC;YACpC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC/E,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAiC,EAAE,OAAiC;QACvE,OAAO;YACH,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC;SACzC,CAAC;IACN,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,IAAuC;QACxD,MAAM,OAAO,GAA2B,EAAE,CAAC;QAE3C,KAAK,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9D,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;QAChC,CAAC;QAED,OAAO,OAAO,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,KAA8B,EAAE,IAAuC;QACtF,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACpD,OAAO;YACH,QAAQ,EAAE,OAAO;SACN,CAAC;IACpB,CAAC;IAED;;OAEG;IACK,iBAAiB,CACrB,KAA8B,EAC9B,IAAuC;QAEvC,MAAM,aAAa,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,KAAK,GAAiB,EAAE,CAAC;QAE/B,KAAK,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,IAAI,aAAa,EAAE,CAAC;YACtD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,OAA8B,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;YAChG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,SAAS,CACb,OAA0B,EAC1B,KAA8B,EAC9B,IAAuC;QAEvC,MAAM,IAAI,GAAe,EAAE,CAAC;QAE5B,0CAA0C;QAC1C,IAAI,OAAO,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;YACnC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,UAAU,CAAE,OAAqB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACtE,CAAC;aAAM,IAAI,OAAO,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC1C,IAAI,CAAC,KAAK,CAAC,GAAG,KAAM,OAAqB,CAAC,KAAK,EAAE,CAAC;QACtD,CAAC;aAAM,IAAI,OAAO,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC3C,sCAAsC;YACtC,8EAA8E;YAC9E,MAAM,EAAE,GAAG,OAAqB,CAAC;YACjC,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,aAAa,WAAW,EAAE,IAAI,CAAC,CAAC;YACnE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,aAAa,SAAS,EAAE,IAAI,CAAC,CAAC;gBAClD,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAgB,CAAC;YACrD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,aAAa,WAAW,EAAE,IAAI,CAAC,CAAC;gBACpD,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAgB,CAAC;YACvD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,aAAa,QAAQ,EAAE,IAAI,CAAC,CAAC;gBACjD,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAgB,CAAC;QACxD,CAAC;QAED,mBAAmB;QACnB,MAAM,UAAU,GAAG,IAAI,GAAG,EAAmC,CAAC;QAC9D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YACrC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAChC,CAAC;YACD,UAAU,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC;QAED,mBAAmB;QACnB,KAAK,MAAM,CAAC,YAAY,EAAE,SAAS,CAAC,IAAI,UAAU,EAAE,CAAC;YACjD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;YAEnE,mCAAmC;YACnC,IAAI,IAAI,CAAC,gBAAgB,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;gBACrD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;oBACzB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;wBACpD,OAAQ,CAAgB,CAAC,KAAK,CAAC,CAAC;oBACpC,CAAC;oBACD,OAAO,CAAC,CAAC;gBACb,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;gBAErD,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,aAAa,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YAChF,CAAC;iBAAM,CAAC;gBACJ,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;gBACrD,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,aAAa,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;oBACtD,CAAC,CAAC,MAAM,CAAC,CAAC,CAAgB;oBAC1B,CAAC,CAAC,MAAuB,CAAC;YAClC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,IAAsB,EAAE,IAAuC;QAC9E,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpB,KAAK,WAAW;gBACZ,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;oBACtB,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;gBACxD,CAAC;gBACD,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YAEjC,KAAK,WAAW;gBACZ,OAAO,EAAE,KAAK,EAAE,KAAK,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YAExC,KAAK,SAAS;gBACV,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAe,EAAE,IAAI,CAAC,CAAC;YAEzD,KAAK,YAAY;gBACb,OAAO,IAAI,CAAC,oBAAoB,CAAC,IAAkB,EAAE,IAAI,CAAC,CAAC;YAE/D;gBACI,OAAO,IAAI,CAAC;QACpB,CAAC;IACL,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,OAAgB,EAAE,IAAuC;QAC/E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC;QACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAElC,0BAA0B;QAC1B,IAAI,QAAQ,EAAE,CAAC;YACX,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAe;gBACvB,QAAQ,EAAE,OAAO,CAAC,KAAK;gBACvB,WAAW,EAAE,MAAM,CAAC,QAAQ;aAC/B,CAAC;YACF,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACnB,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC;YAC5C,CAAC;YACD,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,oBAAoB;QACpB,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC3B,OAAO,OAAO,CAAC,KAAK,KAAK,MAAM,IAAI,OAAO,CAAC,KAAK,KAAK,GAAG,CAAC;QAC7D,CAAC;QAED,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACxC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACd,OAAO,GAAG,CAAC;YACf,CAAC;QACL,CAAC;QAED,IAAI,QAAQ,KAAK,UAAU,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YACtD,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACtC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACd,OAAO,GAAG,CAAC;YACf,CAAC;QACL,CAAC;QAED,uCAAuC;QACvC,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;YACvC,OAAO,OAAO,CAAC,KAAK,CAAC;QACzB,CAAC;QAED,gBAAgB;QAChB,OAAO;YACH,QAAQ,EAAE,OAAO,CAAC,KAAK;YACvB,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC;SAC3C,CAAC;IACN,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,UAAsB,EAAE,IAAuC;QACxF,uDAAuD;QACvD,iDAAiD;QACjD,MAAM,MAAM,GAAe;YACvB,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,aAAa,WAAW,EAAE,IAAI,CAAC;SAC9D,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,aAAa,SAAS,EAAE,IAAI,CAAC,CAAC;YACpD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAgB,CAAC;QAC7D,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,aAAa,WAAW,EAAE,IAAI,CAAC,CAAC;YACtD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,CAAgB,CAAC;QAC/D,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,aAAa,QAAQ,EAAE,IAAI,CAAC,CAAC;YACnD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAgB,CAAC;QAE5D,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,GAAW,EAAE,IAAuC;QACnE,MAAM,WAAW,GAAG,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,IAAI,WAAW,EAAE,CAAC;YACd,OAAO,GAAG,WAAW,CAAC,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC;QAC5D,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,IAAU;QACzB,IAAI,IAAI,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,KAAK,CAAC;QACtB,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;YAChC,OAAO,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QAC7B,CAAC;QACD,OAAO,EAAE,CAAC;IACd,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,OAAiC;QAChD,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO;YACH,GAAG,IAAI;YACP,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,IAAI,IAAI;YACnD,cAAc,EAAE,OAAO,EAAE,cAAc,IAAI,IAAI;YAC/C,aAAa,EAAE,OAAO,EAAE,aAAa,IAAI,IAAI;YAC7C,YAAY,EAAE,OAAO,EAAE,YAAY,IAAI,IAAI;YAC3C,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,CAAC;SACvC,CAAC;IACN,CAAC;CACJ"}

package/dist/n3/formatter.d.ts

@@ -0,0 +1,105 @@
+import type { IToken } from 'chevrotain';
+import type { IRdfFormatter, SerializationResult, TokenSerializerOptions, RdfSyntax as RdfSyntaxType } from '../types.js';
+import { BaseTokenFormatter, type BaseFormatterContext, type BaseFormatterOptions } from '../base-token-formatter.js';
+/**
+ * N3-specific formatting options.
+ */
+export interface N3FormatterOptions extends BaseFormatterOptions {
+    /**
+     * Use lowercase for @prefix and @base.
+     * Default: true
+     */
+    lowercaseDirectives?: boolean;
+    /**
+     * Put opening braces on the same line.
+     * Default: true
+     */
+    sameBraceLine?: boolean;
+}
+/**
+ * Internal formatting context for N3.
+ */
+interface N3FormatterContext extends BaseFormatterContext {
+    opts: Required<N3FormatterOptions>;
+}
+/**
+ * Formatter for Notation3 (N3).
+ *
+ * N3 extends Turtle with formulas (graph literals), implications (`=>`),
+ * reverse implications (`<=`), quick variables, and other features.
+ * Uses the scope stack for both formula braces (curly) and blank node
+ * brackets, replacing the manual `formulaDepth` / `blankNodeDepth` counters.
+ *
+ * @see https://www.w3.org/TeamSubmission/n3/
+ */
+export declare class N3Formatter extends BaseTokenFormatter<N3FormatterContext, N3FormatterOptions> implements IRdfFormatter {
+    readonly syntax: RdfSyntaxType;
+    private lexer;
+    /**
+     * Formats an N3 document.
+     */
+    formatFromText(input: string, options?: N3FormatterOptions): SerializationResult;
+    /**
+     * Formats from already-parsed tokens.
+     */
+    formatFromTokens(tokens: IToken[], options?: N3FormatterOptions & TokenSerializerOptions): SerializationResult;
+    format(input: string, options?: N3FormatterOptions): SerializationResult;
+    protected getOptions(options?: N3FormatterOptions): Required<N3FormatterOptions>;
+    protected createContext(opts: Required<N3FormatterOptions>): N3FormatterContext;
+    protected formatTokenValue(token: IToken, opts: Required<N3FormatterOptions>): string;
+    /**
+     * Handles comment tokens.
+     */
+    private handleN3Comment;
+    /**
+     * Handles opening curly brace (formula start).
+     * Uses the scope stack to track formula nesting.
+     */
+    private handleN3OpenCurly;
+    /**
+     * Handles closing curly brace (formula end).
+     * Pops the curly scope.
+     */
+    private handleN3CloseCurly;
+    /**
+     * Handles opening bracket tokens ([ for blank nodes, ( for collections).
+     */
+    private handleN3OpenBracket;
+    /**
+     * Handles closing bracket tokens (] for blank nodes, ) for collections).
+     */
+    private handleN3CloseBracket;
+    /**
+     * Handles period (statement terminator).
+     */
+    private handleN3Period;
+    /**
+     * Handles semicolon (predicate separator).
+     * Always adds extra indent for continuation.
+     */
+    private handleN3Semicolon;
+    /**
+     * Handles comma (object separator).
+     */
+    private handleN3Comma;
+    /**
+     * Handles N3 implication operator =>.
+     */
+    private handleN3Implication;
+    /**
+     * Handles N3 reverse implication operator <=.
+     */
+    private handleN3ReverseImplication;
+    /**
+     * Handles PREFIX/BASE IRI completion.
+     */
+    private handleN3PrefixIri;
+    /**
+     * Handles token spacing.
+     * N3 additionally suppresses space after opening curly braces.
+     */
+    private handleN3TokenSpacing;
+    private formatTokens;
+}
+export {};
+//# sourceMappingURL=formatter.d.ts.map

package/dist/n3/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/n3/formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,KAAK,EACR,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,SAAS,IAAI,aAAa,EAC7B,MAAM,aAAa,CAAC;AAErB,OAAO,EACH,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC5B,MAAM,4BAA4B,CAAC;AAMpC;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC5D;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,UAAU,kBAAmB,SAAQ,oBAAoB;IACrD,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;CACtC;AAMD;;;;;;;;;GASG;AACH,qBAAa,WACT,SAAQ,kBAAkB,CAAC,kBAAkB,EAAE,kBAAkB,CACjE,YAAW,aAAa;IAExB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAgB;IAC9C,OAAO,CAAC,KAAK,CAAiB;IAM9B;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,mBAAmB;IAYhF;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,sBAAsB,GAAG,mBAAmB;IAM9G,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,mBAAmB;IAQxE,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,QAAQ,CAAC,kBAAkB,CAAC;IAUhF,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,kBAAkB;IAO/E,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,MAAM;IAwBrF;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA2B5B;;OAEG;IACH,OAAO,CAAC,cAAc;IActB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IASlC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA0B5B,OAAO,CAAC,YAAY;CAyJvB"}