Migrate gh_pages to reports_site and update workflows

Renames the gh_pages directory to reports_site, updates all related paths and references in configuration, documentation, and scripts. Modernizes GitHub Actions workflows to use latest actions and options, improves caching and setup steps, and updates package and dev dependencies. Also updates ignore files, SonarCloud config, and README to reflect new structure.

Author: mehmet-kozan

.github/workflows/deploy_github_page.yml

@@ -47,14 +47,21 @@ jobs:
       - name: Site Build
         run: npm run site:build
 
+      - name: Upload Coverage to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          directory: ./reports_site/coverage
+          fail_ci_if_error: false
+
       - name: Setup Pages
         uses: actions/configure-pages@v5
 
       - name: Upload static files
         uses: actions/upload-pages-artifact@v4
         with:
-          path: gh_pages/
-          name: report-site
+          path: reports_site/
+          name: reports-and-live-demo
 
   deploy:
     runs-on: ubuntu-latest
@@ -67,4 +74,4 @@ jobs:
         id: deployment
         uses: actions/deploy-pages@v4
         with:
-          artifact_name: report-site
+          artifact_name: reports-and-live-demo

.github/workflows/publish_npm_package.yml

@@ -19,16 +19,19 @@ jobs:
         node-version: [20, 22, 23, 24]
 
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout
+        uses: actions/checkout@v5
         with:
-          fetch-depth: 0
+          fetch-depth: 1
+          show-progress: false
 
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node-version }}
+          package-manager-cache: false
 
-      - name: Clean npm cache
+      - name: Clean NPM Cache
         run: npm cache clean --force
 
       - name: Install
@@ -52,14 +55,16 @@ jobs:
             fi
           done
 
-  deploy-and-publish:
+  publish:
     runs-on: ubuntu-latest
     needs: integration_test
     environment: publish
     steps:
-      - uses: actions/checkout@v3
+      - name: Checkout
+        uses: actions/checkout@v5
         with:
-          fetch-depth: 0
+          fetch-depth: 1
+          show-progress: false
 
       - name: Extract tag version
         id: tag_version
@@ -83,32 +88,20 @@ jobs:
           fi
           echo "Version match confirmed: ${{ steps.tag_version.outputs.version }}"
 
-      - uses: actions/setup-node@v3
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
         with:
           node-version: "22.20.0"
-          registry-url: "https://registry.npmjs.org/"
+          package-manager-cache: false
 
-      - name: Clean npm cache
+      - name: Clean NPM Cache
         run: npm cache clean --force
 
       - name: Install
         run: npm i
 
-      - name: Unit tests & coverage
-        run: npm run coverage
-
-      - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v5
-        with:
-          token: ${{ secrets.CODECOV_TOKEN }}
-          directory: ./gh_pages/coverage
-          fail_ci_if_error: false
-
-      - name: Deploy to GitHub Pages
-        uses: peaceiris/actions-gh-pages@v3
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./gh_pages
+      - name: Unit Tests
+        run: npm test
 
       - run: npm publish --provenance
         env:

.github/workflows/test.yml

@@ -9,22 +9,25 @@ permissions:
 jobs:
   test:
     runs-on: ubuntu-latest
-    
+
     steps:
-    - uses: actions/checkout@v3
-      with:
-        fetch-depth: 0
-    
-    - name: Setup Node.js
-      uses: actions/setup-node@v3
-      with:
-        node-version: '22.20.0'
-    
-    - name: Clean npm cache
-      run: npm cache clean --force
-    
-    - name: Install
-      run: npm i
-      
-    - name: Unit tests
-      run: npm test
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 1
+          show-progress: false
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: "22.20.0"
+          package-manager-cache: false
+
+      - name: Clean NPM Cache
+        run: npm cache clean --force
+
+      - name: Install
+        run: npm i
+
+      - name: Unit tests
+        run: npm test

.github/workflows/test_integration.yml

@@ -7,42 +7,45 @@ permissions:
   pull-requests: read
 
 jobs:
-  test:
+  integration_test:
     runs-on: ubuntu-latest
     strategy:
       matrix:
         node-version: [20, 22, 23, 24]
 
     steps:
-    - uses: actions/checkout@v4
-      with:
-        fetch-depth: 0
-
-    - name: Use Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v4
-      with:
-        node-version: ${{ matrix.node-version }}
-
-    - name: Clean npm cache
-      run: npm cache clean --force
-    
-    - name: Install
-      run: npm i
-    
-    - name: Unit tests
-      run: npm test
-
-    - name: Integration tests
-      run: |
-        set -euo pipefail
-        echo "Looking for subfolders in test_integration/..."
-        for d in test_integration/*; do
-          if [ -d "$d" ]; then
-            echo "--- Entering $d ---"
-            if [ -f "$d/package.json" ]; then
-              (cd "$d" && npm i && npm test)
-            else
-              echo "skipping $d (no package.json)"
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 1
+          show-progress: false
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ matrix.node-version }}
+          package-manager-cache: false
+
+      - name: Clean NPM Cache
+        run: npm cache clean --force
+
+      - name: Install
+        run: npm i
+
+      - name: Unit tests
+        run: npm test
+
+      - name: Integration tests
+        run: |
+          set -euo pipefail
+          echo "Looking for subfolders in test_integration/..."
+          for d in test_integration/*; do
+            if [ -d "$d" ]; then
+              echo "--- Entering $d ---"
+              if [ -f "$d/package.json" ]; then
+                (cd "$d" && npm i && npm test)
+              else
+                echo "skipping $d (no package.json)"
+              fi
             fi
-          fi
-        done
+          done

.gitignore

@@ -22,16 +22,11 @@ lib-cov
 coverage
 *.lcov
 
-# Test and coverage reports
-reports/test-report
-reports/coverage
-reports/benchmark
-
 # Github Pages
-gh_pages/test-report
-gh_pages/coverage
-gh_pages/benchmark
-gh_pages/demo/dist-browser
+reports_site/test-report
+reports_site/coverage
+reports_site/benchmark
+reports_site/demo/dist-browser
 
 # Temp Example Files
 example/browser/dist-browser

.sonarcloud.properties

@@ -5,7 +5,7 @@ sonar.organization=pdf-parse
 # Path to sources (root of TypeScript sources)
 sonar.sources=src
 sonar.inclusions=src/**
-sonar.exclusions=**/dist/**,**/node_modules/**,**/test/**,**/*.spec.ts,**/*.test.ts,**/example/**,**test_integration**,**/gh_pages/**
+sonar.exclusions=**/dist/**,**/node_modules/**,**/test/**,**/*.spec.ts,**/*.test.ts,**/example/**,**test_integration**,**/reports_site/**
 
 # Path to tests
 sonar.tests=test
@@ -25,7 +25,7 @@ sonar.cpd.exclusions=**/dist/**,**/node_modules/**
 # Coverage report - Vitest with V8 reporter writes lcov to coverage/lcov.info when run via `npm run coverage`
 # Ensure your CI generates the coverage report before running sonar-scanner
 sonar.coverage.exclusions=**/test/**,**/*.d.ts
-sonar.javascript.lcov.reportPaths=./gh_pages/coverage/lcov.info
+sonar.javascript.lcov.reportPaths=./reports_site/coverage/lcov.info
 
 # Optional: a link to the repo and CI branch (helpful in PR decoration)
 sonar.scm.provider=git

.vscode/extensions.json

@@ -1,3 +1,8 @@
 {
-	"recommendations": ["vitest.explorer", "biomejs.biome", "redhat.vscode-yaml"]
+	"recommendations": [
+		"vitest.explorer",
+		"biomejs.biome",
+		"redhat.vscode-yaml",
+		"ritwickdey.liveserver"
+	]
 }

README.md

@@ -54,7 +54,7 @@ parser.getText().then((result)=>{
 - Well-covered with [`unit tests`](./test)
 - [`Integration tests`](./test_integration) to validate end-to-end behavior across environments.
 - See [DocumentInitParameters](./README.options.md#documentinitparameters) and [ParseParameters](./README.options.md#parseparameters) for all available options.
-- For usage examples, see  [`example`](./example), [`test`](./test) and [`test/example`](./test/test-example) folders.
+- For usage examples, see  [`live_demo`](./reports_site/live_demo/), [`example`](./example/), [`test`](./test/) and [`test/example`](./test/test-example/) folders.
 
 
 ## Installation
@@ -260,7 +260,7 @@ try {
 ## Web / Browser <a href="https://www.jsdelivr.com/package/npm/pdf-parse" target="_blank"><img align="right" src="https://img.shields.io/jsdelivr/npm/hm/pdf-parse"></a>  
 - Can be integrated into `React`, `Vue`, `Angular`, or any other web framework.
 - **Live Demo:** [`https://mehmet-kozan.github.io/pdf-parse/`](https://mehmet-kozan.github.io/pdf-parse/)
-- **Demo Source Code:** [`gh-pages branch`](https://github.com/mehmet-kozan/pdf-parse/tree/gh-pages)
+- **Demo Source:** [`reports_site/live_demo`](reports_site/live_demo)
 
 ### CDN Usage  
 

biome.json

@@ -1,13 +1,13 @@
 {
-	"$schema": "https://biomejs.dev/schemas/2.2.5/schema.json",
+	"$schema": "https://biomejs.dev/schemas/2.2.6/schema.json",
 	"vcs": {
 		"enabled": true,
 		"clientKind": "git",
 		"useIgnoreFile": true
 	},
 	"files": {
 		"ignoreUnknown": true,
-		"includes": ["**", "!dist", "!gh_pages/demo/dist-browser", "!gh_pages/test-report", "!gh_pages/coverage", "!gh_pages/benchmark"]
+		"includes": ["**", "!dist", "!reports_site/live_demo/dist-browser", "!reports_site/test-report", "!reports_site/coverage", "!reports_site/benchmark"]
 	},
 	"formatter": {
 		"enabled": true,