first commit

Author: mscolnick

.github/workflows/demo.yml

@@ -0,0 +1,48 @@
+name: Demo
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    name: 🏗️ Build
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: ⎔ Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: ⎔ Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+
+      - name: 📥 Install dependencies
+        run: pnpm install --ignore-scripts --frozen-lockfile
+
+      - name: 🛠️ Build project
+        run: pnpm demo
+
+      - name: 📄 Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: 📤 Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: './demo/dist'
+
+      - name: 🚀 Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/release.yml

@@ -0,0 +1,75 @@
+name: Release
+
+permissions:
+  contents: write
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: ⎔ Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: ⎔ Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          registry-url: 'https://registry.npmjs.org'
+          cache: pnpm
+
+      - name: 📥 Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: 🔍 Type Check
+        run: pnpm run typecheck
+
+      - name: 🧪 Test
+        run: pnpm run test
+
+      - name: 🏗️ Build
+        run: pnpm run build
+
+      - name: 📦 Validate build artifacts
+        run: |
+          # Check if dist directory exists
+          if [ ! -d "dist" ]; then
+            echo "❌ dist directory is missing but declared in package.json"
+            exit 1
+          fi
+
+          # Check if dist contains files
+          if [ -z "$(ls -A dist)" ]; then
+            echo "❌ dist directory is empty"
+            exit 1
+          fi
+
+          # Check for index.js and index.d.ts
+          if [ ! -f "dist/index.js" ] || [ ! -f "dist/index.d.ts" ]; then
+            echo "❌ Missing required files in dist/"
+            echo "Required: index.js and index.d.ts"
+            echo "Found: $(ls dist)"
+            exit 1
+          fi
+
+          echo "✅ Build artifacts validation passed"
+
+      - name: 📦 Publish to NPM
+        run: pnpm publish --no-git-checks
+        env:
+          NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}
+
+      - name: 📝 Update Changelog
+        run: npx changelogithub
+        env:
+          GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}

.github/workflows/test.yml

@@ -0,0 +1,66 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+
+  pull_request:
+    branches:
+      - main
+
+env:
+  CLICOLOR: 1
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: ⎔ Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: ⎔ Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+
+      - name: 📥 Install dependencies
+        run: pnpm install --ignore-scripts --frozen-lockfile
+
+      - name: 🔍 Type Check
+        run: pnpm run typecheck
+
+      - name: 🧪 Test
+        run: pnpm run test
+
+  security:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: 🔍 Run CodeQL
+        uses: github/codeql-action/init@v3
+        with:
+          languages: javascript
+
+      - name: 🔍 Perform Analysis
+        uses: github/codeql-action/analyze@v3
+
+
+  spelling:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: 🔍 Spell Check Repo
+        uses: crate-ci/typos@v1.34.0

.gitignore

@@ -0,0 +1,7 @@
+node_modules
+coverage
+src/**.js
+scripts/**.js
+dist
+.DS_Store
+!.vscode

.vscode/launch.json

@@ -0,0 +1,23 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Debug Tests",
+      "autoAttachChildProcesses": true,
+      "skipFiles": ["<node_internals>/**", "**/node_modules/**"],
+      "program": "${workspaceRoot}/node_modules/vitest/vitest.mjs",
+      "args": ["run", "${file}"],
+      "smartStep": true,
+      "console": "integratedTerminal"
+    },
+    {
+      "type": "chrome",
+      "request": "launch",
+      "name": "Debug Demo",
+      "url": "http://localhost:5173",
+      "webRoot": "${workspaceFolder}/demo"
+    }
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,13 @@
+{
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "biomejs.biome",
+  "editor.codeActionsOnSave": {
+    "source.organizeImports.biome": "always",
+    "quickfix.biome": "always"
+  },
+  "files.autoSave": "afterDelay",
+  "files.autoSaveDelay": 1000,
+  "[markdown]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  }
+}

CONTRIBUTING.md

@@ -0,0 +1,63 @@
+# Contributing to codemirror-sql
+
+Thanks for your interest in contributing! Here's how you can help:
+
+## Development Setup
+
+1. Fork and clone the repo
+2. Install dependencies: `pnpm install`
+3. Run tests: `pnpm test`
+4. Start dev environment: `pnpm dev`
+
+## Development Process
+
+1. Create a feature branch: `git checkout -b feature-name`
+2. Make your changes
+3. Run tests: `pnpm test`
+4. Run type checks: `pnpm typecheck`
+5. Run linting: `pnpm lint`
+6. Commit your changes using conventional commits
+7. Push to your fork and submit a pull request
+
+## Pull Request Guidelines
+
+- Include tests for any new functionality
+- Update documentation for API changes
+- Follow the existing code style
+- Keep PRs focused - one feature/fix per PR
+
+## Commit Messages
+
+We use conventional commits. Format:
+
+```markdown
+type(scope): description
+
+[optional body]
+[optional footer]
+```
+
+Types:
+
+- feat: New feature
+- fix: Bug fix
+- docs: Documentation only
+- style: Code style changes
+- refactor: Code changes that neither fixes a bug nor adds a feature
+- perf: Performance improvements
+- test: Adding or updating tests
+- chore: Changes to build process or auxiliary tools
+
+## Release Process
+
+For maintainers only:
+
+```bash
+git checkout main
+git pull
+npx bumpp --no-git-check=false
+```
+
+## Questions?
+
+Open an issue or discussion if you have questions!