@faubulous/mentor-rdf-serializers 1.1.4 → 1.2.0

package/README.md

@@ -1,82 +1,39 @@
-# @faubulous/mentor-rdf-serializers
+# Mentor RDF Serializers
 
-A comprehensive RDF serialization library for TypeScript, designed as the counterpart to [@faubulous/mentor-rdf-parsers](https://github.com/faubulous/mentor-rdf-parsers). Optimized for IDE use cases such as code formatting and partial serialization.
+[![npm version](https://img.shields.io/npm/v/@faubulous/mentor-rdf-serializers.svg)](https://www.npmjs.com/package/@faubulous/mentor-rdf-serializers)
+[![npm downloads](https://img.shields.io/npm/dm/@faubulous/mentor-rdf-parsers.svg)](https://www.npmjs.com/package/@faubulous/mentor-rdf-parsers)
+[![License: LGPL-2.1](https://img.shields.io/badge/License-LGPL--2.1-blue.svg)](https://opensource.org/licenses/LGPL-2.1)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5-blue.svg)](https://www.typescriptlang.org/)
+[![RDF 1.2](https://img.shields.io/badge/RDF-1.2-green.svg)](https://www.w3.org/TR/rdf12-concepts/)
 
-## Features
-
-- **Multiple Formats**: N-Triples, N-Quads, Turtle, TriG, N3, JSON-LD
-- **SPARQL Formatting**: Format SPARQL queries and updates with comment preservation
-- **RDF 1.2 Support**: Full support for RDF 1.2 features including:
-  - Triple Terms (`<<( s p o )>>`)
-  - Reified Triples (`<< s p o >>`)
-  - Annotations (`{| p o |}`)
-  - Language direction (`@en--ltr`, `@ar--rtl`)
-- **Advanced Formatting Options**: Control line width, alignment, blank node style, and more
-- **Comment Preservation**: Preserve comments when reformatting source files
-- **Token-based Serialization**: Serialize directly from parser tokens, preserving blank node IDs
-- **Sorting Strategies**: Pluggable sorting with built-in alphabetical and priority-based strategies
-- **IDE Integration**: Designed for code formatting and partial document serialization
-- **Prefix Handling**: Automatic prefix compaction and expansion
-- **Configurable Output**: Pretty printing, sorting, grouping options
-
-## Architecture
-
-The `mentor-rdf-serializers` package is designed to work seamlessly with `mentor-rdf-parsers`, forming a complete round-trip pipeline for RDF processing in IDEs and editors.
-
-```mermaid
-flowchart LR
-    subgraph Source
-        A[RDF text (Turtle, TriG, ...)]
-        B[SPARQL text]
-        C[RDF/JS quads]
-    end
-
-    subgraph mentor-rdf-parsers
-        P1[Parser]
-        T1[Tokens]
-        Q1[Quads]
+**A TypeScript library for serializing and formatting RDF and SPARQL, built for IDE integration.**
 
-        A --> P1
-        P1 --> T1
-        P1 --> Q1
+Designed as the counterpart to [@faubulous/mentor-rdf-parsers](https://github.com/faubulous/mentor-rdf-parsers), this library provides RDF serialization and SPARQL formatting with first-class support for editor workflows such as document formatting, range formatting, comment preservation, and configurable output styles.
 
-        B --> L2[SparqlLexer] --> T2[SPARQL tokens]
-    end
-
-    subgraph mentor-rdf-serializers
-        S1[Quad serializers\n(Turtle, N-Triples, ...)]
-        TS[TokenSerializer]
-        SF[SparqlFormatter]
-    end
-
-    subgraph Output
-        O1[Serialized / formatted RDF]
-        O2[Formatted SPARQL]
-    end
-
-    C --> S1 --> O1
-    Q1 --> S1
-    T1 --> TS --> O1
-    T2 --> SF --> O2
+## Features
 
-    style mentor-rdf-parsers fill:#e1f5fe
-    style mentor-rdf-serializers fill:#fff3e0
-```
+| | |
+|---|---|
+| **Multi-Format Output** | Serialize to N-Triples, N-Quads, Turtle, TriG, N3, and JSON-LD |
+| **SPARQL Formatting** | Format queries and updates with keyword casing, alignment, and comment preservation |
+| **RDF 1.2** | Triple terms (`<<( s p o )>>`), reified triples, annotations, and language direction |
+| **Sorting Strategies** | Alphabetical, by-type, semantic, and priority-based quad ordering |
+| **Comment Preservation** | Token-based serialization keeps comments attached to their statements |
+| **Token Serialization** | Serialize directly from parser tokens to preserve blank node IDs and source layout |
+| **Configurable Layout** | Line width, predicate alignment, blank node style, object list wrapping, and more |
+| **IDE-Ready** | Partial document serialization, range formatting, and VS Code integration examples |
 
-## Installation
+## Quick Start
 
 ```bash
 npm install @faubulous/mentor-rdf-serializers
 ```
 
-## Quick Start
-
 ```typescript
 import { TurtleSerializer } from '@faubulous/mentor-rdf-serializers';
 import DataFactory from '@rdfjs/data-model';
 
 const serializer = new TurtleSerializer();
-
 const quads = [
     DataFactory.quad(
         DataFactory.namedNode('http://example.org/subject'),
@@ -90,493 +47,50 @@ const quads = [
     )
 ];
 
-const turtle = serializer.serialize(quads, {
+console.log(serializer.serialize(quads, {
     prefixes: {
         'ex': 'http://example.org/',
         'rdf': 'http://www.w3.org/1999/02/22-rdf-syntax-ns#'
     }
-});
-
-console.log(turtle);
-// @prefix ex: <http://example.org/> .
-// @prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
-//
-// ex:subject a ex:Class ;
-//     ex:name "Example"@en .
-```
-
-## Serializers
-
-### N-Triples
-
-```typescript
-import { NTriplesSerializer } from '@faubulous/mentor-rdf-serializers';
-
-const serializer = new NTriplesSerializer();
-const output = serializer.serialize(quads, { sort: true });
-```
-
-### N-Quads
-
-```typescript
-import { NQuadsSerializer } from '@faubulous/mentor-rdf-serializers';
-
-const serializer = new NQuadsSerializer();
-const output = serializer.serialize(quads);
-```
-
-### Turtle
-
-```typescript
-import { TurtleSerializer } from '@faubulous/mentor-rdf-serializers';
-
-const serializer = new TurtleSerializer();
-const output = serializer.serialize(quads, {
-    prefixes: { 'ex': 'http://example.org/' },
-    baseIri: 'http://example.org/',
-    groupBySubject: true,
-    sort: true
-});
-```
-
-### TriG
-
-```typescript
-import { TriGSerializer } from '@faubulous/mentor-rdf-serializers';
-
-const serializer = new TriGSerializer();
-const output = serializer.serialize(quadsWithGraphs, {
-    prefixes: { 'ex': 'http://example.org/' }
-});
-```
-
-### N3
-
-```typescript
-import { N3Serializer } from '@faubulous/mentor-rdf-serializers';
-
-const serializer = new N3Serializer();
-const output = serializer.serialize(quads); // Supports formulas and implications
-```
-
-### JSON-LD
-
-```typescript
-import { JsonLdSerializer } from '@faubulous/mentor-rdf-serializers';
-
-const serializer = new JsonLdSerializer();
-const output = serializer.serialize(quads, {
-    prefixes: { 'ex': 'http://example.org/' },
-    useTypeShorthand: true,
-    useIdShorthand: true,
-    compactArrays: true,
-    prettyPrint: true
-});
-```
-
-## SPARQL Formatting
-
-```typescript
-import { SparqlFormatter } from '@faubulous/mentor-rdf-serializers';
-
-const formatter = new SparqlFormatter();
-
-// Format a SELECT query
-const selectResult = formatter.formatFromText(`
-    SELECT ?s ?p ?o WHERE { ?s ?p ?o . FILTER(?o > 10) }
-`, {
-    uppercaseKeywords: true,
-    alignPatterns: true,
-    sameBraceLine: true,
-    separateClauses: true,
-    maxLineWidth: 80
-});
-
-console.log(selectResult.output);
-
-// Format a SPARQL UPDATE (same API)
-const updateResult = formatter.formatFromText(`
-    INSERT DATA { <http://example.org/s> <http://example.org/p> "value" }
-`, { 
-    indent: '    ',
-    uppercaseKeywords: true 
-});
-
-console.log(updateResult.output);
-
-// Comments are preserved
-const withComments = formatter.formatFromText(`
-    # Find all people
-    SELECT ?person WHERE {
-        ?person a <http://example.org/Person> .  # Match persons
-    }
-`);
-
-console.log(withComments.output); // Comments remain in the formatted output
+}));
 ```
 
-## Token-based Serialization
-
-For IDE integration, you can serialize directly from parser tokens, which preserves blank node IDs and comments from the source document.
-
-```typescript
-import { TokenSerializer } from '@faubulous/mentor-rdf-serializers';
-import { TurtleParser } from '@faubulous/mentor-rdf-parsers';
-
-const parser = new TurtleParser();
-const parseResult = parser.parse(sourceDocument);
-
-const tokenSerializer = new TokenSerializer();
-
-// Serialize all tokens
-const output = tokenSerializer.serialize(parseResult.tokens, {
-    preserveBlankNodeIds: true,
-    preserveComments: true  // Keeps comments in output
-});
-
-// Serialize only a specific range (for range formatting)
-const rangeOutput = tokenSerializer.serializeRange(
-    parseResult.tokens,
-    startOffset,
-    endOffset,
-    { preserveComments: true }
-);
-```
-
-## Serialization Options
-
-### Common Options
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `prefixes` | `Record<string, string>` | Prefix mappings for compacting IRIs |
-| `baseIri` | `string` | Base IRI for relative references |
-| `sort` | `boolean` | Sort output alphabetically |
-| `prettyPrint` | `boolean` | Enable pretty formatting |
-
-### Turtle/TriG Options
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `groupBySubject` | `boolean` | `true` | Group triples by subject |
-| `usePrefixedNames` | `boolean` | `true` | Use prefixed names where possible |
-| `useShorthandTypes` | `boolean` | `true` | Use `a` for `rdf:type` |
-| `useLongStrings` | `boolean` | `true` | Use `"""` for multiline strings |
-| `useNumericShorthands` | `boolean` | `true` | Use numeric literals without quotes |
-
-### Formatting Options
-
-These options control the visual layout of Turtle, TriG, and SPARQL output:
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `maxLineWidth` | `number` | `0` | Maximum line width before wrapping (0 = no wrapping) |
-| `alignPredicates` | `boolean` | `false` | Align predicates in columns |
-| `alignObjects` | `boolean` | `false` | Align objects in columns (requires `alignPredicates`) |
-| `blankNodeStyle` | `'labeled' \| 'inline' \| 'auto'` | `'auto'` | How to format blank nodes |
-| `objectListStyle` | `'single-line' \| 'multi-line' \| 'auto'` | `'auto'` | How to format multiple objects |
-| `predicateListStyle` | `'single-line' \| 'multi-line' \| 'first-same-line'` | `'first-same-line'` | How to format predicate lists |
-| `blankLinesBetweenSubjects` | `boolean` | `true` | Insert blank lines between subject blocks |
-
-#### Blank Node Style
-
-```typescript
-// 'labeled' - Always use labeled blank nodes
-_:b0 ex:name "Alice" .
-_:b0 ex:knows _:b1 .
-
-// 'inline' - Use inline property lists where possible
-[ ex:name "Alice" ; ex:knows [ ex:name "Bob" ] ] .
-
-// 'auto' - Inline for single-reference blank nodes, labeled for multi-reference
-```
-
-#### Object List Style
-
-```typescript
-// 'single-line' - Objects on same line
-ex:s ex:p "a", "b", "c" .
-
-// 'multi-line' - Each object on its own line
-ex:s ex:p "a",
-    "b",
-    "c" .
-
-// 'auto' - Based on maxLineWidth
-```
-
-#### Predicate List Style
-
-```typescript
-// 'first-same-line' - First predicate with subject
-ex:s a ex:Class ;
-    ex:name "Example" ;
-    ex:value 42 .
-
-// 'multi-line' - All predicates on separate lines
-ex:s
-    a ex:Class ;
-    ex:name "Example" ;
-    ex:value 42 .
-
-// 'single-line' - All on one line (compact)
-ex:s a ex:Class ; ex:name "Example" ; ex:value 42 .
-```
-
-### JSON-LD Options
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `useTypeShorthand` | `boolean` | `true` | Use `@type` instead of `rdf:type` |
-| `useIdShorthand` | `boolean` | `true` | Use `@id` for IRI references |
-| `compactArrays` | `boolean` | `true` | Unwrap single-element arrays |
-| `embedContext` | `boolean` | `true` | Include `@context` in output |
-| `jsonIndent` | `number` | `2` | Indentation for pretty printing |
-
-### SPARQL Options
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `uppercaseKeywords` | `boolean` | `true` | Uppercase SPARQL keywords |
-| `lowercaseKeywords` | `boolean` | `false` | Lowercase SPARQL keywords |
-| `alignPatterns` | `boolean` | `true` | Align WHERE clause patterns |
-| `sameBraceLine` | `boolean` | `true` | Opening braces on same line |
-| `separateClauses` | `boolean` | `true` | Blank lines between major clauses |
-| `maxLineWidth` | `number` | `0` | Maximum line width before wrapping |
-| `objectListStyle` | `string` | `'auto'` | How to format object lists in patterns |
-| `predicateListStyle` | `string` | `'first-same-line'` | How to format predicate lists |
-| `blankLinesBetweenSubjects` | `boolean` | `true` | Blank lines between subject blocks |
-
-### Token Serialization Options
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `preserveBlankNodeIds` | `boolean` | `true` | Preserve original blank node IDs |
-| `preserveComments` | `boolean` | `true` | Preserve comments from source |
-
-## RDF 1.2 Features
-
-### Triple Terms
-
-```typescript
-import { TurtleSerializer } from '@faubulous/mentor-rdf-serializers';
-import type { TripleTerm, Rdf12Quad } from '@faubulous/mentor-rdf-serializers';
-
-const tripleTerm: TripleTerm = {
-    termType: 'TripleTerm',
-    subject: { termType: 'NamedNode', value: 'http://example.org/s' },
-    predicate: { termType: 'NamedNode', value: 'http://example.org/p' },
-    object: { termType: 'Literal', value: 'value', language: '', datatype: { termType: 'NamedNode', value: 'http://www.w3.org/2001/XMLSchema#string' } }
-};
-
-// Output: <<( <http://example.org/s> <http://example.org/p> "value" )>>
-```
-
-### Reified Triples with Annotations
-
 ```turtle
-# Input
-ex:subject ex:predicate ex:object {| ex:source ex:source1 |} .
-
-# Serialized correctly with annotations
-```
+PREFIX ex: <http://example.org/>
+PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
 
-### Language Direction (RDF 1.2)
-
-```typescript
-const literal = DataFactory.literal('مرحبا', 'ar--rtl');
-// Output in Turtle: "مرحبا"@ar--rtl
-// Output in JSON-LD: { "@value": "مرحبا", "@language": "ar", "@direction": "rtl" }
-```
-
-## API Reference
-
-### Interfaces
-
-#### `ISerializer`
-
-```typescript
-interface ISerializer {
-    serializeQuad(quad: Quad | Rdf12Quad, options?: SerializerOptions): string;
-    serialize(quads: Iterable<Quad | Rdf12Quad>, options?: SerializerOptions): string;
-    format(quads: Iterable<Quad | Rdf12Quad>, options?: SerializerOptions): SerializationResult;
-}
+ex:subject a ex:Class ;
+    ex:name "Example"@en .
 ```
 
-#### `SerializationResult`
+## Documentation
 
-```typescript
-interface SerializationResult {
-    output: string;
-    warnings?: string[];
-    sourceMap?: SourceMapEntry[];
-}
-```
+Detailed guides and API documentation are available in the [docs](docs/README.md) folder:
 
-#### `ISparqlFormatter`
+| Guide | Description |
+|-------|-------------|
+| [Getting Started](docs/getting-started.md) | Installation and first serialization |
+| [Architecture](docs/architecture.md) | Parser/serializer pipeline overview |
+| [Serializers](docs/serializers.md) | Format-specific serializer usage |
+| [Token Serialization](docs/token-serialization.md) | Serialize from parser tokens |
+| [SPARQL Formatting](docs/sparql-formatting.md) | Query and update formatting |
+| [Sorting](docs/sorting.md) | Quad ordering strategies |
+| [Options](docs/options.md) | Full configuration reference |
+| [RDF 1.2](docs/rdf-1.2.md) | Triple terms, annotations, language direction |
+| [API Reference](docs/api-reference.md) | Interfaces and types |
+| [VS Code Formatter](docs/vs-code-formatter.md) | Editor integration example |
 
-```typescript
-interface ISparqlFormatter {
-    formatFromText(query: string, options?: SerializerOptions): SerializationResult;
-    formatFromTokens(tokens: unknown[], options?: SerializerOptions): SerializationResult;
-}
-```
-
-## VS Code Formatter
-
-Here's how to create a document formatter for Turtle files in VS Code:
-
-```typescript
-import * as vscode from 'vscode';
-import { TurtleParser } from '@faubulous/mentor-rdf-parsers';
-import { TurtleSerializer } from '@faubulous/mentor-rdf-serializers';
-
-export class TurtleDocumentFormatter implements vscode.DocumentFormattingEditProvider {
-    private parser = new TurtleParser();
-    private serializer = new TurtleSerializer();
-
-    provideDocumentFormattingEdits(
-        document: vscode.TextDocument,
-        options: vscode.FormattingOptions,
-        token: vscode.CancellationToken
-    ): vscode.TextEdit[] {
-        const text = document.getText();
-        
-        // Parse the document
-        const parseResult = this.parser.parse(text);
-        
-        if (parseResult.errors.length > 0) {
-            // Don't format if there are parse errors
-            return [];
-        }
-
-        // Get user preferences from VS Code settings
-        const config = vscode.workspace.getConfiguration('turtle');
-        
-        // Serialize with formatting options
-        const result = this.serializer.serialize(parseResult.quads, {
-            prefixes: parseResult.prefixes,
-            baseIri: parseResult.baseIri,
-            indent: options.insertSpaces ? ' '.repeat(options.tabSize) : '\t',
-            prettyPrint: true,
-            groupBySubject: true,
-            sort: config.get('sortStatements', true),
-            maxLineWidth: config.get('maxLineWidth', 80),
-            alignPredicates: config.get('alignPredicates', false),
-            blankNodeStyle: config.get('blankNodeStyle', 'auto'),
-            predicateListStyle: config.get('predicateListStyle', 'first-same-line'),
-            blankLinesBetweenSubjects: config.get('blankLinesBetweenSubjects', true)
-        });
-
-        // Return a single edit replacing the entire document
-        const fullRange = new vscode.Range(
-            document.positionAt(0),
-            document.positionAt(text.length)
-        );
-
-        return [vscode.TextEdit.replace(fullRange, result.output)];
-    }
-}
-
-// Register the formatter in your extension's activate function
-export function activate(context: vscode.ExtensionContext) {
-    context.subscriptions.push(
-        vscode.languages.registerDocumentFormattingEditProvider(
-            { language: 'turtle', scheme: 'file' },
-            new TurtleDocumentFormatter()
-        )
-    );
-}
-```
-
-### SPARQL Formatter for VS Code
-
-```typescript
-import * as vscode from 'vscode';
-import { SparqlFormatter } from '@faubulous/mentor-rdf-serializers';
-
-export class SparqlDocumentFormatter implements vscode.DocumentFormattingEditProvider {
-    private formatter = new SparqlFormatter();
-
-    provideDocumentFormattingEdits(
-        document: vscode.TextDocument,
-        options: vscode.FormattingOptions,
-        token: vscode.CancellationToken
-    ): vscode.TextEdit[] {
-        const text = document.getText();
-        const config = vscode.workspace.getConfiguration('sparql');
-        
-        const result = this.formatter.formatFromText(text, {
-            indent: options.insertSpaces ? ' '.repeat(options.tabSize) : '\t',
-            prettyPrint: true,
-            uppercaseKeywords: config.get('uppercaseKeywords', true),
-            alignPatterns: config.get('alignPatterns', true),
-            sameBraceLine: config.get('sameBraceLine', true),
-            separateClauses: config.get('separateClauses', true),
-            maxLineWidth: config.get('maxLineWidth', 80)
-        });
-
-        const fullRange = new vscode.Range(
-            document.positionAt(0),
-            document.positionAt(text.length)
-        );
-
-        return [vscode.TextEdit.replace(fullRange, result.output)];
-    }
-}
-```
-
-### Range Formatting (Format Selection)
-
-For formatting only a selected range, use the `TokenSerializer` to preserve surrounding content:
-
-```typescript
-import { TurtleParser } from '@faubulous/mentor-rdf-parsers';
-import { TokenSerializer } from '@faubulous/mentor-rdf-serializers';
-
-export class TurtleRangeFormatter implements vscode.DocumentRangeFormattingEditProvider {
-    private parser = new TurtleParser();
-    private tokenSerializer = new TokenSerializer();
-
-    provideDocumentRangeFormattingEdits(
-        document: vscode.TextDocument,
-        range: vscode.Range,
-        options: vscode.FormattingOptions,
-        token: vscode.CancellationToken
-    ): vscode.TextEdit[] {
-        const text = document.getText();
-        const parseResult = this.parser.parse(text);
-        
-        if (parseResult.errors.length > 0) {
-            return [];
-        }
-
-        // Get byte offsets for the selected range
-        const startOffset = document.offsetAt(range.start);
-        const endOffset = document.offsetAt(range.end);
-
-        // Serialize only tokens within the range
-        const result = this.tokenSerializer.serializeRange(
-            parseResult.tokens,
-            startOffset,
-            endOffset,
-            { preserveComments: true, preserveBlankNodeIds: true }
-        );
-
-        return [vscode.TextEdit.replace(range, result.output)];
-    }
-}
-```
-
-## License
+## Related Projects
 
-[LGPL-2.1-or-later](https://github.com/faubulous/mentor-rdf-parsers/blob/main/LICENSE)
+| Package | Description |
+|---------|-------------|
+| [@faubulous/mentor-rdf-parsers](https://github.com/faubulous/mentor-rdf-parsers) | RDF parsing library — the parser counterpart |
+| [@faubulous/mentor-vscode](https://github.com/faubulous/mentor-vscode) | RDF IDE and workbench for VS Code |
 
 ## Contributing
 
-Contributions are welcome! Please feel free to submit a Pull Request.
+Contributions are welcome. Please feel free to open an issue or submit a pull request on [GitHub](https://github.com/faubulous/mentor-rdf-serializers).
 
-## Related Projects
+## License
 
-- [@faubulous/mentor-rdf-parsers](https://github.com/faubulous/mentor-rdf-parsers) - RDF parsing library
-- [@faubulous/mentor-vscode](https://github.com/faubulous/mentor-vscode) - RDF IDE and workbench
+[LGPL-2.1-or-later](https://github.com/faubulous/mentor-rdf-serializers/blob/main/LICENSE)

package/dist/index.d.ts

@@ -1,5 +1,4 @@
-export type { ISerializer, ITokenSerializer, IRdfFormatter, ISparqlFormatter, Rdf12Quad, Rdf12Term, Reifier, TripleTerm, SerializerOptions, TokenSerializerOptions, SerializationResult, SourceMapEntry, QuadComparator, SortingStrategy, PriorityStrategyConfig, SortOption, BlankNodeStyle, ObjectListStyle, PredicateListStyle } from './types.js';
-export { RdfSyntax } from './types.js';
+export type { BlankNodeStyle, IRdfFormatter, ISerializer, ISparqlFormatter, ITokenSerializer, ObjectListStyle, PredicateListStyle, PriorityStrategyConfig, QuadComparator, Rdf12Quad, Rdf12Term, RdfSyntax, Reifier, SerializationResult, SerializerOptions, SortingStrategy, SortOption, SourceMapEntry, TokenSerializerOptions, TripleTerm, } from './types.js';
 export { escapeIri, escapeString, escapeLocalName, findPrefix, isValidLocalName, isTripleTerm, isReifier, hasAnnotations, hasReifier, needsLongString, isInteger, isDecimal, isDouble, groupQuadsBySubject, groupQuadsBySubjectPredicate, groupQuadsByGraph, termToString, sortQuads, parseLanguageTag, formatLanguageTag, resetBlankNodeCounter, generateBlankNodeId, mergeOptions, RDF_NAMESPACE, XSD_NAMESPACE, RDF_TYPE, XSD_STRING, XSD_INTEGER, XSD_DECIMAL, XSD_DOUBLE, XSD_BOOLEAN, DEFAULT_OPTIONS } from './utils.js';
 export { BaseSerializer } from './base-serializer.js';
 export { BaseTokenFormatter, annotateTokens, type TokenAnnotation, type AnnotatedToken, type Scope, type BaseFormatterContext, type BaseFormatterOptions, } from './base-token-formatter.js';
@@ -17,4 +16,6 @@ export { TrigFormatter, type TrigFormatterOptions } from './trig/formatter.js';
 export { N3Formatter, type N3FormatterOptions } from './n3/formatter.js';
 export { TokenSerializer, type Token, getBlankNodeIdFromToken, isBlankNodeToken, getTokenPosition } from './token-serializer.js';
 export { alphabeticalStrategy, createByTypeStrategy, createSemanticStrategy, createPriorityStrategy, applySortingStrategy } from './sorting/index.js';
+export { StatementSerializer } from './statement-serializer.js';
+export type { StatementSerializerOptions, QuadTokens, QuadContext } from './statement-serializer.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACR,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,OAAO,EACP,UAAU,EACV,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,UAAU,EACV,cAAc,EACd,eAAe,EACf,kBAAkB,EACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,OAAO,EACH,SAAS,EACT,YAAY,EACZ,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,cAAc,EACd,UAAU,EACV,eAAe,EACf,SAAS,EACT,SAAS,EACT,QAAQ,EACR,mBAAmB,EACnB,4BAA4B,EAC5B,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,QAAQ,EACR,UAAU,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,eAAe,EAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EACH,kBAAkB,EAClB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,KAAK,EACV,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC5B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EACH,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,WAAW,EACX,iBAAiB,EACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACH,gBAAgB,EAChB,KAAK,uBAAuB,EAC/B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACH,eAAe,EACf,KAAK,sBAAsB,EAC9B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACH,eAAe,EACf,KAAK,sBAAsB,EAC9B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EACH,aAAa,EACb,KAAK,oBAAoB,EAC5B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACH,WAAW,EACX,KAAK,kBAAkB,EAC1B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACH,eAAe,EACf,KAAK,KAAK,EACV,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EACnB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACH,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACvB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,cAAc,EACd,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,SAAS,EACT,SAAS,EACT,SAAS,EACT,OAAO,EACP,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,cAAc,EACd,sBAAsB,EACtB,UAAU,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EACH,SAAS,EACT,YAAY,EACZ,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,cAAc,EACd,UAAU,EACV,eAAe,EACf,SAAS,EACT,SAAS,EACT,QAAQ,EACR,mBAAmB,EACnB,4BAA4B,EAC5B,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,QAAQ,EACR,UAAU,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,eAAe,EAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACH,kBAAkB,EAClB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,KAAK,EACV,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC5B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EACH,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,WAAW,EACX,iBAAiB,EACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEzE,OAAO,EACH,eAAe,EACf,KAAK,KAAK,EACV,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACH,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,YAAY,EACR,0BAA0B,EAC1B,UAAU,EACV,WAAW,EACd,MAAM,2BAA2B,CAAC"}