# @shexjs/util > Shape Expressions validation and utilities. Latest version **1.0.0-alpha.33** (published 2026-09-14) · MIT license · 0 weekly downloads ## Install ```sh npm install @shexjs/util pnpm add @shexjs/util yarn add @shexjs/util bun add @shexjs/util ``` ## Health **Score 70/100 (B)** — status: active. Positive: has types; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score. Warnings: low downloads; no esm support. ## Facts | | | |---|---| | Version | 1.0.0-alpha.33 | | Published | 2026-09-14 | | First published | 2021-06-03 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | CommonJS | | Node | >=18 | | Dependencies | 6 | | Unpacked size | 353 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Provenance | attested (GitHub Actions) | | GitHub stars | 62 | | Author | Eric Prud'hommeaux | | Maintainers | ericprud, justinwb | | Keywords | shex, shape expressions, rdf, query, parser | ## Links - npm: https://www.npmjs.com/package/@shexjs/util - Repository: https://github.com/shexjs/shex.js - Homepage: https://github.com/shexjs/shex.js#readme - Issues: https://github.com/shexSpec/grammar/issues - npm.io page: https://npm.io/package/@shexjs/util ## Dependencies (6) - [@shexjs/term](https://npm.io/package/@shexjs/term.md) ^1.0.0-alpha.28 - [@types/shexj](https://npm.io/package/@types/shexj.md) ^2.1.7 - [sync-request](https://npm.io/package/sync-request.md) ^6.1.0 - [@shexjs/writer](https://npm.io/package/@shexjs/writer.md) ^1.0.0-alpha.33 - [@shexjs/visitor](https://npm.io/package/@shexjs/visitor.md) ^1.0.0-alpha.33 - [hierarchy-closure](https://npm.io/package/hierarchy-closure.md) ^1.2.2 ## Alternatives - [babylon](https://npm.io/package/babylon.md) — 5.1M weekly downloads - [csscolorparser](https://npm.io/package/csscolorparser.md) — 3.7M weekly downloads - [expr-eval-fork](https://npm.io/package/expr-eval-fork.md) — 1.5M weekly downloads - [@leeoniya/ufuzzy](https://npm.io/package/@leeoniya/ufuzzy.md) — 247.7K weekly downloads - [xml-parser](https://npm.io/package/xml-parser.md) — 78.4K weekly downloads ## Recent versions - 1.0.0-alpha.33 (latest) — 2026-09-14 - 1.0.0-alpha.31 — 2026-09-06 - 1.0.0-alpha.30 — 2026-08-31 - 1.0.0-alpha.28 — 2023-11-05 - 1.0.0-alpha.27 — 2023-10-23 - 1.0.0-alpha.25 — 2023-03-21 - 1.0.0-alpha.24 — 2022-09-16 - 1.0.0-alpha.23 — 2022-08-23 - 1.0.0-alpha.22 — 2022-08-18 - 1.0.0-alpha.21 — 2022-03-08 - 1.0.0-alpha.20 — 2022-01-12 - 1.0.0-alpha.19 — 2021-12-22 - 1.0.0-alpha.15 — 2021-07-18 - 1.0.0-alpha.14 — 2021-06-22 - 1.0.0-alpha.13 — 2021-06-22 - … 1 more at https://npm.io/package/@shexjs/util/versions ## README # @shexjs/util [![npm version](https://img.shields.io/npm/v/@shexjs/util)](https://www.npmjs.com/package/@shexjs/util) [![CI](https://github.com/shexjs/shex.js/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/shexjs/shex.js/actions/workflows/ci.yml) Utility functions to work with [ShExJ](https://shex.io/shex-semantics/#shexj) schemas ## Install ``` shell npm install @shexjs/util ``` ## Invocation Using `partition(, [s])` as an example, an illustrative way to invoke it from the command line uses `@shexjs/parser` and `@shexjs/writer`: ``` sh node -e 'const base = "http://a.example/" const schema = require("@shexjs/parser") .construct(base, {v: "http://a.example/vocab#"}) .parse(" { .; @? } { @ } { @ } { . }") const partition = require("@shexjs/util").partition(schema, [base + "S2"]) new (require("@shexjs/writer"))({ base, simplifyParentheses: true }) .writeSchema(partition, (error, text, prefixes) => { if (error) throw error; console.log(text); })' ``` The result is the partition serialized as ShExC: ``` shex BASE { @ } { @ } { . ; @? } ``` Note that `` in the input schema has no references to ``: ``` shex { .; @? } { @ } { @ } { . } ``` ## ShExJtoAS(schema) Parse a ShExJ schema and add `._prefixes` and `._index` for efficient processing within shexj.js ## AStoShExJ(schema) Remove `._prefixes` and `._index` from internal schema structure and add `schema["@context"] || "http://www.w3.org/ns/shex.jsonld"` ## ShExRtoShExJ(schema-like-object) Internal function for parsing ShExR (the `ShExRVisitor` it uses is not exported) ## canonicalize(schema, trimIRI) Normalize ShExJ by moving all tripleExpression references to their first expression. ## BiDiClosure construct an object with this api: * **needs**: {} - mapping from needer to needie * **neededBy**: {} - reverse mapping of `needs` * add(needer, needie, negated) - record that needer referenced needied, possibly in a negation ## nestShapes(schema, options = {}) See which shape declarations have no coreferences and can be nested inside their sole referrer. ### options * **no**: don't do anything; just report nestable shapes * **transform**: function to change shape labels ## getPredicateUsage(schema, untyped = {}) Return which predicates appear in which shapes, what their common type is, and whether they are polymorphic. ## getDependencies(schema, ret) Find which shapes depend on other shapes by inheritance or inclusion. ## partition(, [s]) Create subset of a schema with only desired shapes and their dependencies. ## absolutizeResults(res, base) In validation results with some relative URLs in it, re-evaluate all [`shape`, `reference`, `node`, `subject`, `predicate`, `object`] property values against `base`. ## getProofGraph(res, db, dataFactory) Parse a validation result and call `db.addQuad()` with each triple involved in validation. **Note**, this may call `db.addQuad()` multiple times with the same triple if that triple appears more than once in the validation results. ## isWellDefined(schema) Verify that schema has all necessary referents and conforms to ShEx's stratified negation rules. ## valuesToSchema(values) Convert the results of validating an instance of ShExR against ShExR.shex into a ShExJ schema. ## errsToSimple(val, prefixes?, opts?) Render a validation failure as indented, human-readable lines. `opts.explain` picks what to include: the failure's `"errors"`, its `"repairs"` (the cheapest edits that would have made the node conform), or `"both"`; `opts.lex` and `opts.base` control how terms are written. ## executeQuery(query, endpoint, dataFactory) Synchronously execute a SPARQL query against an endpoint. ## executeQueryPromise(query, endpoint, dataFactory) Asynchronously execute a SPARQL query against an endpoint. ## parseSparqlJsonResults (jsonObject) Parse JSON results to internal RDF term representations. --- `@shexjs/util` is one of the [shex.js](https://github.com/shexjs/shex.js#readme) packages; installing [`shex`](https://www.npmjs.com/package/shex) pulls in the whole suite, and [its README](https://github.com/shexjs/shex.js/tree/main/packages/shex#the-shexjs-packages) maps them. --- _Source: https://npm.io/package/@shexjs/util · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._