Add library build and GitHub install support

- Rename package to @sourecode/virtual-keyboard, add exports/files/repo metadata
- Add vite.lib.config.ts + tsconfig.lib.json for library build with rolled-up .d.ts
- Add src/keyboard/index.ts barrel re-exporting VirtualKeyboard and adapters
- Add CI workflow (build + smoke test) and release workflow (publish prebuilt dist to release branch on tag)
- Document github-install flow in README

Author: chapterjason

.github/workflows/ci.yml

@@ -0,0 +1,54 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build-lib:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: actions/setup-node@v5
+        with:
+          node-version-file: .nvmrc
+          cache: npm
+
+      - run: npm ci --ignore-scripts
+
+      - run: npm run typecheck
+
+      - run: npm run build:lib
+
+      - name: Verify dist artifacts
+        run: |
+          test -f dist/virtual-keyboard.js
+          test -f dist/virtual-keyboard.d.ts
+
+      - name: Smoke test ESM entry
+        run: |
+          node -e '
+          globalThis.HTMLElement = class {};
+          globalThis.customElements = { define() {} };
+          import("./dist/virtual-keyboard.js").then(m => {
+            const keys = Object.keys(m);
+            console.log("exports:", keys);
+            const missing = ["VirtualKeyboard","terminalAdapter","nativeAdapter"].filter(k => !keys.includes(k));
+            if (missing.length) { console.error("missing:", missing); process.exit(1); }
+          })'
+
+      - name: Smoke test npm pack
+        run: npm pack --dry-run
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist
+          retention-days: 7

.github/workflows/release.yml

@@ -0,0 +1,74 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      ref:
+        description: "Git ref (tag or commit SHA) to build from"
+        required: true
+        default: "master"
+
+permissions:
+  contents: write
+
+jobs:
+  publish-release-branch:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          ref: ${{ github.event.inputs.ref || github.ref }}
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v5
+        with:
+          node-version-file: .nvmrc
+          cache: npm
+
+      - run: npm ci --ignore-scripts
+
+      - run: npm run build:lib
+
+      - name: Verify dist artifacts
+        run: |
+          test -f dist/virtual-keyboard.js
+          test -f dist/virtual-keyboard.d.ts
+
+      - name: Publish prebuilt dist to release branch
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          set -eu
+          SRC_SHA="$(git rev-parse HEAD)"
+          TAG_NAME=""
+          if [[ "${GITHUB_REF:-}" == refs/tags/* ]]; then
+            TAG_NAME="${GITHUB_REF#refs/tags/}"
+          fi
+
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+          WORK="$(mktemp -d)"
+          cp -r dist "$WORK/dist"
+          cp package.json README.md "$WORK/" 2>/dev/null || true
+          [ -f LICENSE ] && cp LICENSE "$WORK/"
+
+          cd "$WORK"
+          git init -q -b release
+          git remote add origin "https://x-access-token:${GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}.git"
+          git add -A
+          git commit -q -m "release: prebuilt dist from ${SRC_SHA}${TAG_NAME:+ (${TAG_NAME})}"
+          git push -f origin release
+
+          if [ -n "$TAG_NAME" ]; then
+            git tag -f "${TAG_NAME}-release"
+            git push -f origin "${TAG_NAME}-release"
+          fi
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist-${{ github.ref_name }}
+          path: dist

README.md

@@ -4,6 +4,27 @@ A framework-agnostic on-screen keyboard as a web component. Drops into any page
 
 **Live demo**: https://sourecode.github.io/virtual-keyboard/
 
+## Install (without npmjs)
+
+This package is not published to the npm registry. Install it straight from GitHub:
+
+```sh
+# prebuilt dist from the release branch (no build toolchain needed)
+npm install github:SoureCode/virtual-keyboard#release
+
+# or pin to a tag — runs the `prepare` script to build on install
+npm install github:SoureCode/virtual-keyboard#v0.1.0
+```
+
+Consumers need `git` plus either public-repo access or a PAT/SSH key with read access to the repo.
+
+Then:
+
+```ts
+import { VirtualKeyboard, terminalAdapter, nativeAdapter } from "@sourecode/virtual-keyboard";
+import "@sourecode/virtual-keyboard/style.css";
+```
+
 ## Features
 
 - Custom element `<virtual-keyboard>`, all styles scoped in Shadow DOM — zero global footprint
@@ -33,7 +54,7 @@ A framework-agnostic on-screen keyboard as a web component. Drops into any page
 ### Switching the output target
 
 ```ts
-import { VirtualKeyboard, terminalAdapter } from "virtual-keyboard";
+import { VirtualKeyboard, terminalAdapter } from "@sourecode/virtual-keyboard";
 
 const kb = document.querySelector("virtual-keyboard")!;
 kb.setAdapter(terminalAdapter((data) => term.paste(data)));