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@v6
+
+      - uses: actions/setup-node@v6
+        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@v7
+        with:
+          name: dist
+          path: dist
+          retention-days: 7

.github/workflows/deploy.yml

@@ -18,19 +18,19 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
 
-      - uses: actions/setup-node@v5
+      - uses: actions/setup-node@v6
         with:
           node-version-file: .nvmrc
           cache: npm
 
       - id: pages
-        uses: actions/configure-pages@v5
+        uses: actions/configure-pages@v6
 
       - run: npm ci
 
-      - uses: actions/cache@v4
+      - uses: actions/cache@v5
         with:
           path: public/v86
           key: v86-assets-${{ hashFiles('scripts/fetch-v86-assets.mjs') }}
@@ -39,7 +39,7 @@ jobs:
         env:
           BASE_PATH: ${{ steps.pages.outputs.base_path }}
 
-      - uses: actions/upload-pages-artifact@v4
+      - uses: actions/upload-pages-artifact@v5
         with:
           path: dist
 

.github/workflows/release.yml

@@ -0,0 +1,44 @@
+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:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ github.event.inputs.ref || github.ref }}
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version-file: .nvmrc
+          cache: npm
+
+      - run: npm ci --ignore-scripts
+
+      - run: npm run build:lib
+
+      - name: Pack npm tarball
+        id: pack
+        run: |
+          file=$(npm pack --silent)
+          echo "file=$file" >> "$GITHUB_OUTPUT"
+
+      - name: Create GitHub Release with tarball
+        if: startsWith(github.ref, 'refs/tags/')
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: gh release create "$GITHUB_REF_NAME" "${{ steps.pack.outputs.file }}" --notes ""

README.md

@@ -4,6 +4,29 @@ 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. Each tagged release publishes an `npm pack` tarball as a GitHub Release asset. Install it directly:
+
+```sh
+npm install https://github.com/SoureCode/virtual-keyboard/releases/download/v0.1.0/sourecode-virtual-keyboard-0.1.0.tgz
+```
+
+Or install from the git tag — the `prepare` script will build on install:
+
+```sh
+npm install github:SoureCode/virtual-keyboard#v0.1.0
+```
+
+Consumers of the git-install path 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 +56,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)));