Improved RDF documentation

library/rdf.ts

@@ -1,4 +1,4 @@
-import type * as RDF from "npm:[email protected]";
+import type * as RDF from "npm:@rdfjs/types";
 
 export type { RDF };
 

rdf.ts

@@ -1 +1,21 @@
-export * from "./library/rdf.ts";
+/**
+ * RDF utilities
+ *
+ * This module contains a re-export of external RDF libraries that are used
+ * in LDkit and may be used in tandem with LDkit in Linked Data applications as well.
+ *
+ * Included packages:
+ * - [@rdfjs/types](https://github.com/rdfjs/types) [RDF/JS](https://rdf.js.org/) authoritative TypeScript typings
+ * - [n3](https://rdf.js.org/N3.js/) RDF parser and serializer
+ * - [rdf-data-factory](https://github.com/rubensworks/rdf-data-factory.js) A TypeScript/JavaScript implementation of the RDF/JS data factory
+ * - [rdf-literal](https://github.com/rubensworks/rdf-literal.js) Translates between RDF literals and JavaScript primitives
+ * @module
+ */
+export {
+  DataFactory,
+  DefaultGraph,
+  fromRdf,
+  N3,
+  type RDF,
+  toRdf,
+} from "./library/rdf.ts";

tests/rdf.test.ts

@@ -1,12 +1,8 @@
 import { assert, assertEquals } from "./test_deps.ts";
 
-import {
-  BindingsFactory,
-  DataFactory,
-  QuadFactory,
-  type RDF,
-  type RDFJSON,
-} from "ldkit/rdf";
+import { DataFactory, type RDF } from "ldkit/rdf";
+
+import { BindingsFactory, QuadFactory, RDFJSON } from "../library/rdf.ts";
 
 Deno.test("RDF / Quad Factory", () => {
   const df = new DataFactory();

tests/test_utils.ts

@@ -7,6 +7,8 @@ import { DataFactory, N3, type RDF } from "ldkit/rdf";
 import { ldkit, schema, xsd } from "ldkit/namespaces";
 import { Options, type QueryContext } from "ldkit";
 
+import { quadsToGraph } from "../library/rdf.ts";
+
 export type Equals<A, B> = A extends B ? (B extends A ? true : false) : false;
 
 const X_NAMESPACE = "http://x/";
@@ -79,6 +81,11 @@ export const ttl = (turtle: string) => {
   return quads;
 };
 
+export const createGraph = (turtle: string) => {
+  const quads = ttl(turtle);
+  return quadsToGraph(quads);
+};
+
 export const createStore = () =>
   new N3.Store(undefined, {
     factory: DF(),

www/doc.config.ts

@@ -7,7 +7,7 @@ const toApiPath = (url: URL) => {
 };
 
 const toRemoteSourceUrl = (target: string, line?: number) => {
-  const prefix = "https://deno.land/x/ldkit/";
+  const prefix = "https://deno.land/x/ldkit/library/";
   const lineSuffix = line ? `#L${line}` : "";
   const suffix = `?source=${lineSuffix}`;
   const chunks = target.split("/library/");

www/routes/api/[...slug].tsx

@@ -24,7 +24,7 @@ export const handler: Handlers<Data> = {
     const slug = ctx.params.slug;
 
     const match = slug.match(
-      /^([a-zA-Z_\/.]+)?(~[a-zA-Z_]+)?(\.[a-zA-Z_.]+)?$/,
+      /^([a-zA-Z_\/.]+)?(~[a-zA-Z0-9_]+)?(\.[a-zA-Z_.]+)?$/,
     );
 
     if (match === null) {

www/utils/doc.ts

@@ -4,10 +4,11 @@ import { load as defaultLoad } from "https://deno.land/x/[email protected]/loade
 
 export function load(specifier: string) {
   if (specifier.startsWith("npm:")) {
-    return Promise.resolve({
+    specifier = `https://esm.sh/${specifier.slice(4)}`;
+    /*return Promise.resolve({
       "kind": "external" as const,
       "specifier": specifier,
-    });
+    });*/
   }
   return defaultLoad(specifier);
 }