vite-plugin-sparql 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # vite-plugin-sparql
 
+## 0.1.1
+
+### Patch Changes
+
+- ccfe1e2: Added support for `base` import attribute
+- Updated dependencies [ccfe1e2]
+  - sparqlc@0.1.5
+
 ## 0.1.0
 
 ### Minor Changes

package/README.md

@@ -0,0 +1,48 @@
+### vite-plugin-sparql
+
+Vite plugin that compiles SPARQL `.rq` (query) and `.ru` (update) files with `sparqlc`, so you can import them like regular modules.
+
+- Transforms `.rq`/`.ru` to ESM at build/dev time
+- Optional `?base=` query to resolve relative IRIs
+- Works in dev server and build
+
+#### Install
+
+```
+npm i -D vite-plugin-sparql sparqlc
+```
+
+#### Usage
+
+vite.config.ts:
+
+```ts
+import { defineConfig } from 'vite'
+import sparql from 'vite-plugin-sparql'
+
+export default defineConfig({
+  plugins: [sparql()],
+})
+```
+
+Import a query and execute it with `sparql-http-client`:
+
+```ts
+import env from '@zazuko/env'
+import type { ParsingClient } from 'sparql-http-client'
+
+const { default: selectAll } = await import('./queries/select-all.rq')
+
+declare const client: ParsingClient
+const rows = await selectAll({ env, client })
+```
+
+Pass a base IRI via query parameter to resolve relative IRIs in the file:
+
+```ts
+const { default: q } = await import('./queries/select-relative.rq?base=http%3A%2F%2Fexample.org%2F')
+```
+
+Notes:
+- The plugin recognizes both `.rq` and `.ru` extensions.
+- For runtime import attributes in Node.js (`with: { base }`), use the companion loader `node-loader-sparql` instead.

package/index.js

@@ -1,11 +1,16 @@
 import { compile } from 'sparqlc';
 export default {
     name: 'vite-plugin-sparql',
+    enforce: 'pre',
     transform(code, id) {
-        if (id.endsWith('.rq')) {
-            const compiled = compile(code);
-            return compiled.code;
+        // Vite passes the full id including query (e.g., /abs/path.q.rq?import&base=...)
+        const url = new URL(id, 'file://');
+        const pathname = url.pathname;
+        if (/\.r[qu]$/.test(pathname)) {
+            const base = url.searchParams.get('base') ?? undefined;
+            const compiled = compile(code, { base: base ?? undefined });
+            return { code: compiled.code, map: null };
         }
-        return code;
+        return null;
     },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-sparql",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "main": "index.js",
   "files": [
@@ -21,19 +21,19 @@
     "directory": "packages/vite-plugin-sparql"
   },
   "dependencies": {
-    "sparqlc": "^0.1.0"
+    "sparqlc": "^0.1.5"
   },
   "peerDependencies": {
     "vite": ">=6"
   },
   "devDependencies": {
     "@testing-library/dom": "^10.4.1",
-    "@vitest/browser": "^4.0.18",
-    "@vitest/browser-playwright": "^4.0.18",
+    "@vitest/browser": "^4.1.10",
+    "@vitest/browser-playwright": "^4.1.10",
     "@zazuko/env": "^3.0.1",
     "playwright": "^1.58.2",
     "sparql-http-client": "^3.1.0",
-    "vite": "^7.0.0",
-    "vitest": "^4.0.18"
+    "vite": "^8.1.5",
+    "vitest": "^4.1.10"
   }
 }