tpluscode
@tpluscode/rdf-ns-builders
Common RDF vocabularies extracted from @zazuko/vocabularies and wrapped
as @rdfjs/namespace builder objects.
Also includes TypeScript declarations of the terms included in the known vocabularies as extracted from the actual RDF source file.
Why?
- If you're tired of typing
const schema = namespace(prefixes.schema)every so often - If you want to have your IDE "Find usages" of a
@rdfjs/namespace-generated term
Installation
npm i -S @tpluscode/rdf-ns-buildersUsage
Simply import a namespace builder by its prefix defined in @zazuko/vocabularies
import { schema } from '@tpluscode/rdf-ns-builders'
import { NamedNode } from '@rdfjs/types'
const schemaPerson: NamedNode = schema.PersonUsage with RDF/JS Environment
You can also add all vocabularies to an environment. Note that this will load everything immediately, even if unused
import { NamedNode } from '@rdfjs/types'
import Environment from '@rdfjs/environment/Environment.js'
import NsBuildersFactory from '@tpluscode/rdf-ns-builders'
const rdf = new Environment([NsBuildersFactory])
const schemaPerson: NamedNode = rdf.ns.schema.PersonLoose builder
The namespace builders exported from the main module allow arbitrary term but in TypeScript, an error will be shown if they do not exist in the vocabulary. Alternatively, loose builders can be imported which will ignore terms from outside the vocabulary.
import { schema } from '@tpluscode/rdf-ns-builders/loose'
import { NamedNode } from '@rdfjs/types'
// will not show error
const schemaPerson: NamedNode = schema.PersonaRoll your own
Given a package with same exports as @zazuko/vocabularies, it is possible to generate a set of namespace builders generated from your own vocabularies.
Install required peer dependencies:
npm i -D ts-node ts-morph clownface @zazuko/vocabularies safe-identifierRun the following command to generate builders package by providing the source package name and output directory.
npm run rdf-ns-builders generate -p @my/vocabularies -o buildersThis will create a directory source, containing typescript modules for all vocabularies, similar to those from src.
Adding your own vocabularies
To extend the interface of env.ns you need to add you own factory which will add additional
namespace builders to the environment. TypeScript users will also need to extend the CustomPrefixes
interface.
// ./ns.ts
import { NamespaceBuilder } from '@rdfjs/namespace'
type ExampleTerms = 'foo' | 'bar
declare module '@tpluscode/rdf-ns-builders' {
interface CustomNamespaces {
ex: NamespaceBuilder<ExampleTerms>
}
}
export class ExampleNsFactory {
init(this: Environment<NsBuildersFactory | NamespaceFactory>) {
this.ns = {
...this.ns,
ex: this.namespace<ExampleTerms>('https://example.com/'),
}
}
}Then, use it to create an extended environment.
// ./env.ts
import { create } from '@zazuko/env'
import { ExampleNsFactory } from './ns.js'
export default create(TalosNsFactory)