Merge pull request #35 from hypermedia-app/sparqlc-tsc

feat(cli): add `sparqlc-cli`

Author: tpluscode

.changeset/add-sparqlc-tsc.md

@@ -0,0 +1,8 @@
+---
+"sparqlc": patch
+"ts-plugin-sparqlc": patch
+"sparqlc-cli": minor
+---
+
+Add `sparqlc-cli` package containing `sparqlc-tsc` (a drop-in `tsc` replacement for SPARQL query/update imports) and `sparqlc` (a CLI SPARQL compiler).
+Extract shared declaration generator `toDeclaration` into `sparqlc/declarations.js` and update `ts-plugin-sparqlc` to use it.

.changeset/lovely-poets-report.md

@@ -0,0 +1,5 @@
+---
+"sparqlc": minor
+---
+
+`sparqlc` reimplemented in `sparqlc-cli` package

.github/workflows/tests.yaml

@@ -24,7 +24,6 @@ jobs:
             path: packages/vite-plugin-sparql
     steps:
       - uses: actions/checkout@v7
-      - uses: fabasoad/setup-prolog-action@v1
       - uses: actions/setup-node@v7
         with:
           node-version: ${{ matrix.node }}
@@ -40,11 +39,40 @@ jobs:
           token: ${{ secrets.CODECOV_TOKEN }}
           flags: ${{ matrix.package.name }}
 
+  sparql-cli:
+    name: sparql-cli (TS ${{ matrix.typescript }}, node ${{ matrix.node }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        node: [ "lts/*" ]
+        typescript: [ "5", "6" ]
+        include:
+          - node: "lts/-1"
+            typescript: "5"
+          - node: "lts/-2"
+            typescript: "5"
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v7
+        with:
+          node-version: ${{ matrix.node }}
+      - run: npm ci
+      - run: npm run -w sparqlc build
+      - name: Install target TypeScript version in sparqlc-cli
+        run: npm install --no-save typescript@${{ matrix.typescript }} -w packages/sparqlc-cli
+      - name: Run CLI tests against target TypeScript version
+        run: npx c8 --all --src packages/sparqlc-cli --include packages/sparqlc-cli --reporter lcovonly --reporter text npm run -w sparqlc-cli test
+      - name: Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          flags: sparqlc-cli
+
   lint:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7
-      - uses: fabasoad/setup-prolog-action@v1
       - uses: actions/setup-node@v7
         with:
           node-version: lts/*
@@ -55,7 +83,6 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7
-      - uses: fabasoad/setup-prolog-action@v1
       - uses: actions/setup-node@v7
         with:
           node-version: lts/*

.gitignore

@@ -4,3 +4,4 @@ node_modules/
 !packages/ts-plugin-sparqlc/*.js
 coverage/
 .vitest-attachments/
+!packages/*/bin/*.js

README.md

@@ -3,11 +3,12 @@
 A set of tools for compiling and using SPARQL queries as first‑class modules across Node.js, Vite, esbuild, and TypeScript.
 
 Packages (in usage order):
-- `sparqlc` – core compiler and runtime (JS API + CLI)
+- `sparqlc` – core compiler and runtime (JS API)
+- `sparqlc-cli` – CLI tools (`sparqlc-tsc` drop-in replacement for `tsc`, and `sparqlc` CLI compiler)
 - `node-loader-sparql` – Node.js loader to import `.rq` files directly
 - `vite-plugin-sparql` – Vite plugin to import `.rq` in web apps
 - `esbuild-plugin-sparql` – esbuild plugin to import `.rq`
-- `ts-plugin-sparqlc` – TypeScript language service plugin to get strong types for `.rq` imports
+- `ts-plugin-sparqlc` – TypeScript language service plugin to get strong types for `.rq` imports in IDEs
 
 ## Installation