# shaclc-write

> A writer for SHACLC documents

Latest version **1.6.3** (published 2026-01-16) · MIT license · 0 weekly downloads

## Install

```sh
npm install shaclc-write
pnpm add shaclc-write
yarn add shaclc-write
bun add shaclc-write
```

## Health

**Score 60/100 (C)** — status: stable.

Positive: has types; no vulnerabilities; has provenance; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 1.6.3 |
| Published | 2026-01-16 |
| First published | 2022-11-24 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 3 |
| Unpacked size | 117.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 0 |
| Author | Jesse Wright |
| Maintainers | jeswr |
| Keywords | SHACLC, SHACL-compact-syntax, writer, rdf |

## Links

- npm: https://www.npmjs.com/package/shaclc-write
- Repository: https://github.com/jeswr/shaclc-writer
- Homepage: https://github.com/jeswr/shaclc-writer#readme
- Issues: https://github.com/jeswr/shaclc-writer/issues
- npm.io page: https://npm.io/package/shaclc-write

## Dependencies (3)

- [n3](https://npm.io/package/n3.md) ^2.0.0
- [rdf-string-ttl](https://npm.io/package/rdf-string-ttl.md) ^2.0.1
- [@jeswr/prefixcc](https://npm.io/package/@jeswr/prefixcc.md) ^1.2.1

## Alternatives

- [@oh-my-pi/pi-natives](https://npm.io/package/@oh-my-pi/pi-natives.md) — 51.8K weekly downloads
- [@capgo/capacitor-light-sensor](https://npm.io/package/@capgo/capacitor-light-sensor.md) — 3.0K weekly downloads
- [@heyhuynhgiabuu/pi-diff](https://npm.io/package/@heyhuynhgiabuu/pi-diff.md) — 492 weekly downloads
- [@lotsa/verdant-lang-asm](https://npm.io/package/@lotsa/verdant-lang-asm.md) — 38 weekly downloads
- [new-era-syntax](https://npm.io/package/new-era-syntax.md) — 20 weekly downloads

## Recent versions

- 1.6.3 (latest) — 2026-01-16
- 1.6.2 — 2026-01-16
- 1.6.1 — 2026-01-16
- 1.6.0 — 2026-01-09
- 1.5.0 — 2025-07-10
- 1.4.3 — 2024-06-05
- 1.4.2 — 2023-01-03
- 1.4.1 — 2023-01-02
- 1.4.0 — 2023-01-01
- 1.3.2 — 2023-01-01
- 1.3.1 — 2023-01-01
- 1.3.0 — 2023-01-01
- 1.2.0 — 2022-12-14
- 1.1.0 — 2022-12-12
- 1.0.0 — 2022-11-24

## README

# shaclc-writer

Write RDF/JS quads to SHACLC documents

## Usage

```ts
import { Parser } from 'n3';
import { write } from 'shaclc-write';

const ttl = `
@base <http://example.org/array-in> .
@prefix ex: <http://example.org/test#> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix sh: <http://www.w3.org/ns/shacl#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

<>
	a owl:Ontology ;
.

ex:TestShape
	a sh:NodeShape ;
	sh:property [
		sh:path ex:property ;
		sh:in ( ex:Instance1 true "string" 42 ) ;
	] ;
.
`

async function main() {
  const quads = (new Parser()).parse(ttl);

  const { text } = await write(quads, {
    prefixes: {
      ex: "http://example.org/test#",
      sh: "http://www.w3.org/ns/shacl#",
      owl: "http://www.w3.org/2002/07/owl#"
    }
  });


  // BASE <http://example.org/array-in>
  // PREFIX ex: <http://example.org/test#>
  //
  // shape ex:TestShape {
  // 	ex:property in=[ex:Instance1 true "string" 42] .
  // }
  console.log(text)
}

main();
```

### Identifying quads that could not be serialized

By default an error is thrown if there are quads that cannot be serialised in SHACLC. Alternatively we can skip throwing errors and just return the quads that cannot be serialised.


```ts
import { Parser } from 'n3';
import { write } from 'shaclc-write';

const ttl = `
@base <http://example.org/array-in> .
@prefix ex: <http://example.org/test#> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix sh: <http://www.w3.org/ns/shacl#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

<>
	a owl:Ontology ;
.

ex:TestShape
	a sh:NodeShape ;
	sh:property [
		sh:path ex:property ;
		sh:in ( ex:Instance1 true "string" 42 ) ;
	] ;
.

ex:Jesse ex:knows ex:Bob .

`

async function main() {
  const quads = (new Parser()).parse(ttl);

  const { text, extraQuads } = await write(quads, {
    prefixes: {
      ex: "http://example.org/test#",
      sh: "http://www.w3.org/ns/shacl#",
      owl: "http://www.w3.org/2002/07/owl#"
    },
    errorOnUnused: false
  });


  // BASE <http://example.org/array-in>
  // PREFIX ex: <http://example.org/test#>
  //
  // shape ex:TestShape {
  // 	ex:property in=[ex:Instance1 true "string" 42] .
  // }
  console.log(text)

  // Array containing a single RDF/JS representing the triple "ex:Jesse ex:knows ex:Bob"
  console.log(extraQuads)
}

main();
```

## Minting prefixes

Prefixes for namespaces that have not been specified can also be created on demand (first it attempts to look up a
prefix on [prefix.cc](http://prefix.cc/) and will generate one if this fails).

```ts
async function main() {
  const quads = (new Parser()).parse(ttl);

  const { text } = await write(quads, {
    mintPrefixes: true,
  });


  // BASE <http://example.org/array-in>
  // PREFIX test: <http://example.org/test#>
  //
  // shape test:TestShape {
  // 	test:property in=[test:Instance1 true "string" 42] .
  // }
  console.log(text)

  // Array containing a single RDF/JS representing the triple "ex:Jesse ex:knows ex:Bob"
  console.log(extraQuads)
}

main();
```

## Extended SHACL Compact Syntax

The [SHACL Compact Syntax specification](https://w3c.github.io/shacl/shacl-compact-syntax/) is not expressive enough to
make any RDF 1.0 statement. This package includes an opt-in extended syntax that allows users to make any RDF 1.0 statement. Writing of this extended syntax can be enabled via an option in the `write` function

```ts
const quads = write(/*quads*/, { extendedSyntax: true })
```

### Making additional statements about the `NodeShape`

Additional statements can be made about NodeShapes by using a turtle-like syntax before the body of the shape. For instance we can add the following statements to the above `ex:TestShape`.

```ttl
ex:TestShape ex:myCustomAnnotation ex:myCustomValue ;
	ex:myCustomBlankNodeAnnotation [
		ex:myCustomList ( 1 ex:myCustomValue )
	] .
```

by doing the following:

```shaclc
shape ex:TestShape -> ex:TestClass1 ex:TestClass2 ;
	ex:myCustomAnnotation ex:myCustomValue ;
	ex:myCustomBlankNodeAnnotation [
		ex:myCustomList ( 1 ex:myCustomValue )
	] {
		targetNode=ex:TestNode targetSubjectsOf=ex:subjectProperty targetObjectsOf=ex:objectProperty .
	}
```

### Making additional statements about the `sh:property`

additional statements can be made about each blank node property as follows:

```shaclc
shape ex:TestShape -> ex:TestClass1 ex:TestClass2 {
	ex:myPath [0..1] %
		ex:myCustomPropertyAnnotation ex:myCustomPropertyValue ;
		ex:myCustomPropertyAnnotation2 ex:myCustomPropertyValue2 ;
	% .
}
```

### Making arbitrary statements

Finally we permit the use of turtle syntax at the end of the file to make any additional statements


```shaclc
shape ex:TestShape -> ex:TestClass1 ex:TestClass2 {
	targetNode=ex:TestNode targetSubjectsOf=ex:subjectProperty targetObjectsOf=ex:objectProperty .
}

ex:bob a ex:Person .
```

---
_Source: https://npm.io/package/shaclc-write · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._