chore: comprehensive repository cleanup and modernization

Major cleanup and consolidation of repository structure:

**Removed obsolete/redundant files:**
- Removed .travis.yml (replaced by GitHub Actions)
- Removed .prettierrc and .prettierignore (using Biome)
- Removed redundant GitHub workflow files (test.yml, lint.yml, types.yml)
- Removed .config/ directory (moved configs to root)
- Removed package-lock.json (switched to pnpm)

**Consolidated GitHub workflows:**
- Created comprehensive ci.yaml workflow with test, lint, and type-check jobs
- Tests across Node 20, 22, 24 on Ubuntu and Windows
- Updated to modern GitHub Actions (v5)

**Package manager migration:**
- Switched from npm to pnpm for consistency with CI/CD
- Generated pnpm-lock.yaml
- Added typescript devDependency for type checking
- Added missing npm scripts: test-ci, check-ci, check:tsc

**Configuration improvements:**
- Moved biome.json and eslint.config.mjs to root
- Configured Biome linting rules (errors vs warnings)
- Fixed ESLint config for .mjs and .js files separately
- Updated .gitignore to exclude package-lock.json

**Documentation overhaul:**
- Completely rewrote README.md for visual learners
- Added badges (CI, npm, license)
- "What is a purl?" section with ASCII diagram up front
- Clear API reference with extensive code examples
- Visual table of package types with expandable full list
- Better structured development section

**Code formatting:**
- Formatted all source files with Biome
- Fixed minor linting issues
- Improved code consistency

All 191 tests passing. Zero linting errors (86 warnings, all safe).

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: jdalton

.github/actions/setup/action.yml

@@ -0,0 +1,27 @@
+name: 'Setup'
+description: 'Setup Node.js and pnpm with caching'
+
+inputs:
+  node-version:
+    description: 'Node.js version'
+    required: false
+    default: '22'
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Setup pnpm
+      uses: pnpm/action-setup@v4
+      with:
+        version: '^10.16.0'
+
+    - name: Setup Node.js with pnpm cache
+      uses: actions/setup-node@v5
+      with:
+        node-version: ${{ inputs.node-version }}
+        cache: 'pnpm'
+
+    - name: Install dependencies
+      shell: bash
+      run: |
+        pnpm install --frozen-lockfile

.github/workflows/ci.yaml

@@ -1,13 +1,75 @@
-name: Run Unit Tests
-on:   
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+      - master
+    tags:
+      - '*'
   pull_request:
     branches:
       - '**'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
+  cancel-in-progress: true
+
 jobs:
-  unit_test:
+  test:
+    name: Test (Node ${{ matrix.node }} on ${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      fail-fast: false
+      matrix:
+        node: [20, 22, 24]
+        os: [ubuntu-latest, windows-latest]
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - uses: actions/setup-node@v5
+        with:
+          node-version: ${{ matrix.node }}
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run tests
+        run: pnpm run test-ci
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v5
+      - uses: ./.github/actions/setup
+        with:
+          node-version: '22'
+
+      - name: Run linting
+        run: pnpm run check-ci
+
+  type-check:
+    name: Type Check
     runs-on: ubuntu-latest
+
     steps:
-      - uses: actions/checkout@v2
-      - run: |
-              npm ci
-              npm run test
+      - uses: actions/checkout@v5
+      - uses: ./.github/actions/setup
+        with:
+          node-version: '22'
+
+      - name: Run type check
+        run: pnpm run check:tsc

.github/workflows/provenance.yml

@@ -0,0 +1,38 @@
+name: Publish Package to npm
+
+on:
+  workflow_dispatch:
+    inputs:
+      debug:
+        description: 'Enable debug output'
+        required: false
+        default: '0'
+        type: string
+        options:
+          - '0'
+          - '1'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v5
+      - uses: ./.github/actions/setup
+        with:
+          node-version: '22'
+
+      - name: Run tests before publishing
+        run: pnpm run test-ci
+
+      - name: Configure npm authentication
+        run: npm config set //registry.npmjs.org/:_authToken ${{ secrets.NPM_TOKEN }}
+
+      - name: Publish to npm
+        run: npm publish --provenance
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -5,5 +5,6 @@ Thumbs.db
 /.nvm
 /.vscode
 /npm-debug.log
+/package-lock.json
 /yarn.lock
 **/node_modules