feat(full): version @libpg-query/parser per PG major — full/17 (pg17) + full/18 (pg18)

Author: pyramation

.github/workflows/build-wasm-no-docker.yaml

@@ -42,15 +42,15 @@ jobs:
           ./emsdk install 3.1.59
           ./emsdk activate 3.1.59
           source ./emsdk_env.sh
-        working-directory: full
+        working-directory: full/18
       - name: Build with Emscripten 🏗
         run: |
           source ./emsdk/emsdk_env.sh
           emmake make
           emmake make build
-        working-directory: full
+        working-directory: full/18
       - name: Archive production artifacts 🏛
         uses: actions/upload-artifact@v4
         with:
           name: wasm-artifacts
-          path: full/wasm
+          path: full/18/wasm

.github/workflows/build-wasm.yml

@@ -36,13 +36,24 @@ jobs:
       - name: Install Dependencies 🧶
         run: pnpm install
 
-      - name: Build WASM 🏗
+      - name: Build WASM (PG17) 🏗
         run: pnpm run build
-        working-directory: full
+        working-directory: full/17
 
-      - name: Archive production artifacts 🏛
+      - name: Build WASM (PG18) 🏗
+        run: pnpm run build
+        working-directory: full/18
+
+      - name: Archive PG17 artifacts 🏛
+        uses: actions/upload-artifact@v4
+        with:
+          name: wasm-artifacts-pg17
+          path: full/17/wasm/
+          retention-days: 7
+
+      - name: Archive PG18 artifacts 🏛
         uses: actions/upload-artifact@v4
         with:
-          name: wasm-artifacts
-          path: full/wasm/
+          name: wasm-artifacts-pg18
+          path: full/18/wasm/
           retention-days: 7

.github/workflows/ci.yml

@@ -13,7 +13,8 @@ jobs:
     strategy:
       matrix:
         package: 
-          - { name: 'full', path: 'full', version: '18' }
+          - { name: 'full17', path: 'full/17', version: '17' }
+          - { name: 'full18', path: 'full/18', version: '18' }
           - { name: 'v13', path: 'versions/13', version: '13' }
           - { name: 'v14', path: 'versions/14', version: '14' }
           - { name: 'v15', path: 'versions/15', version: '15' }
@@ -78,7 +79,8 @@ jobs:
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
         package: 
-          - { name: 'full', path: 'full', version: '18' }
+          - { name: 'full17', path: 'full/17', version: '17' }
+          - { name: 'full18', path: 'full/18', version: '18' }
           - { name: 'v13', path: 'versions/13', version: '13' }
           - { name: 'v14', path: 'versions/14', version: '14' }
           - { name: 'v15', path: 'versions/15', version: '15' }

PUBLISH.md

@@ -10,7 +10,7 @@ pnpm run publish:versions
 This interactive script will:
 - Check for uncommitted changes (will error if any exist)
 - Let you select which versions to publish (or all)
-- Also includes the full package (@libpg-query/parser)
+- Also includes the full package versions (@libpg-query/parser, full/17 and full/18)
 - Ask for version bump type (patch or minor only)
 - Ask if you want to skip the build step (useful if already built)
 - Always run tests (even if build is skipped)
@@ -165,28 +165,35 @@ npm install libpg-query        # Latest/default version
 
 ## Full Package (@libpg-query/parser)
 
-### Quick Publish
+The full package is versioned per PostgreSQL major version, mirroring `versions/`:
+- `full/17` — built from `17-constructive`, published as `@libpg-query/parser` with tag `pg17`
+- `full/18` — built from `18-constructive`, published as `@libpg-query/parser` with tag `pg18`
+
+### Quick Publish (per version)
 ```bash
-cd full
+cd full/17   # or full/18
 pnpm version patch
 git add . && git commit -m "release: bump @libpg-query/parser version"
 pnpm build
 pnpm test
-pnpm publish --tag pg17
+pnpm run publish:pkg
 ```
 
+`publish:pkg` uses `x-publish.publishName` (`@libpg-query/parser`) and `x-publish.distTag`
+(`pg17` / `pg18`) from each package.json, temporarily renaming the package during publish.
+
 ### Promote to latest (optional)
 ```bash
 npm dist-tag add @libpg-query/parser@pg17 latest
 ```
 
 ### What it does
-- Publishes `@libpg-query/parser` with tag `pg17`
-- Currently based on PostgreSQL 17
-- Includes full parser with all features
+- Publishes `@libpg-query/parser` with tag `pg17` (from `full/17`) or `pg18` (from `full/18`)
+- Includes full parser with all features (parse, parsePlPgSQL, scan, fingerprint, normalize + sync variants)
 
 ### Install published package
 ```bash
+npm install @libpg-query/parser@pg18   # PostgreSQL 18 specific
 npm install @libpg-query/parser@pg17   # PostgreSQL 17 specific
 npm install @libpg-query/parser        # Latest version
 ```

README.md

@@ -77,7 +77,7 @@ This repository contains multiple packages to support different PostgreSQL versi
 | **[@pgsql/parser](https://github.com/constructive-io/libpg-query-node/tree/main/parser)** | Multi-version parser (runtime selection) | 15, 16, 17, 18 | [`@pgsql/parser`](https://www.npmjs.com/package/@pgsql/parser) |
 | **[@pgsql/types](https://github.com/constructive-io/libpg-query-node/tree/main/types)** | TypeScript type definitions | 13, 14, 15, 16, 17, 18 | [`@pgsql/types`](https://www.npmjs.com/package/@pgsql/types) |
 | **[@pgsql/enums](https://github.com/constructive-io/libpg-query-node/tree/main/enums)** | TypeScript enum definitions | 13, 14, 15, 16, 17, 18 | [`@pgsql/enums`](https://www.npmjs.com/package/@pgsql/enums) |
-| **[@libpg-query/parser](https://github.com/constructive-io/libpg-query-node/tree/main/full)** | Full parser with all features | 17 only | [`@libpg-query/parser`](https://www.npmjs.com/package/@libpg-query/parser) |
+| **[@libpg-query/parser](https://github.com/constructive-io/libpg-query-node/tree/main/full)** | Full parser with all features | 17, 18 | [`@libpg-query/parser`](https://www.npmjs.com/package/@libpg-query/parser) |
 
 ### Version Tags
 
@@ -102,7 +102,7 @@ npm install @pgsql/enums
 - **Just need to parse SQL?** → Use `libpg-query` (lightweight, all PG versions)
 - **Need multiple versions at runtime?** → Use `@pgsql/parser` (dynamic version selection)
 - **Need TypeScript types?** → Add `@pgsql/types` and/or `@pgsql/enums`
-- **Need fingerprint, normalize, scan, or PL/pgSQL parsing?** → Use `@libpg-query/parser` (PG 18)
+- **Need fingerprint, normalize, scan, or PL/pgSQL parsing?** → Use `@libpg-query/parser` (PG 17 & 18 via `pg17`/`pg18` dist-tags)
 
 
 ## API Documentation

full/CHANGELOG.md full/17/CHANGELOG.mdfull/CHANGELOG.md renamed to full/17/CHANGELOG.md

@@ -8,7 +8,7 @@
    <a href="https://www.npmjs.com/package/libpg-query"><img height="20" src="https://img.shields.io/npm/dt/libpg-query"></a>
    <a href="https://www.npmjs.com/package/libpg-query"><img height="20" src="https://img.shields.io/npm/dw/libpg-query"/></a>
    <a href="https://github.com/constructive-io/libpg-query/blob/main/LICENSE-MIT"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
-   <a href="https://www.npmjs.com/package/libpg-query"><img height="20" src="https://img.shields.io/github/package-json/v/constructive-io/libpg-query-node?filename=full%2Fpackage.json"/></a><br />
+   <a href="https://www.npmjs.com/package/libpg-query"><img height="20" src="https://img.shields.io/github/package-json/v/constructive-io/libpg-query-node?filename=full%2F17%2Fpackage.json"/></a><br />
    <a href="https://github.com/constructive-io/libpg-query-node/actions/workflows/ci.yml"><img height="20" src="https://github.com/constructive-io/libpg-query-node/actions/workflows/ci.yml/badge.svg" /></a>
    <a href="https://github.com/constructive-io/libpg-query-node/actions/workflows/ci.yml"><img height="20" src="https://img.shields.io/badge/macOS-available-333333?logo=apple&logoColor=white" /></a>
    <a href="https://github.com/constructive-io/libpg-query-node/actions/workflows/ci.yml"><img height="20" src="https://img.shields.io/badge/Windows-available-333333?logo=windows&logoColor=white" /></a>