chrome-jig 0.1.0 → 0.2.0

package/dist/session/session.js

@@ -0,0 +1,195 @@
+/**
+ * Session core — shared method dispatch between all protocol adapters.
+ *
+ * Owns the readline loop, method routing, and connection reference.
+ * Protocol adapters own parsing and formatting.
+ */
+import * as readline from 'node:readline';
+import { evaluate } from '../commands/eval.js';
+import { evaluateCljs } from '../commands/cljs-eval.js';
+import { listTabs, selectTab } from '../commands/tabs.js';
+import { inject } from '../commands/inject.js';
+import { isProtocolError } from './protocol.js';
+/** Built-in method handlers */
+export const builtinMethods = {
+    async eval(params, connection) {
+        const code = String(params.code ?? '');
+        if (!code)
+            throw new Error('Missing param: code');
+        const lang = String(params.lang ?? 'js');
+        if (lang === 'cljs') {
+            const result = await evaluateCljs(connection, code);
+            if (!result.success)
+                throw new Error(result.error);
+            return result.value;
+        }
+        if (lang !== 'js') {
+            throw new Error(`Unknown lang: ${lang}. Supported: js, cljs`);
+        }
+        const result = await evaluate(connection, code);
+        if (!result.success)
+            throw new Error(result.error);
+        return result.value;
+    },
+    async 'cljs-eval'(params, connection, config) {
+        return builtinMethods.eval({ ...params, lang: 'cljs' }, connection, config);
+    },
+    async tabs(_params, connection) {
+        const tabs = await listTabs(connection);
+        return { tabs, formatted: formatTabs(tabs) };
+    },
+    async selectTab(params, connection) {
+        const pattern = String(params.pattern ?? '');
+        if (!pattern)
+            throw new Error('Missing param: pattern');
+        const tab = await selectTab(connection, pattern);
+        if (!tab)
+            throw new Error(`No tab matching: ${pattern}`);
+        return { tab, formatted: `Switched to: ${tab.title}\n  ${tab.url}` };
+    },
+    async inject(params, connection, config) {
+        const ref = String(params.ref ?? '');
+        if (!ref)
+            throw new Error('Missing param: ref');
+        const result = await inject(connection, config, ref);
+        if (!result.success)
+            throw new Error(result.error);
+        const lines = [`Injected: ${result.url}`];
+        if (result.windowApi)
+            lines.push(`API available as: window.${result.windowApi}`);
+        if (result.quickStart)
+            lines.push(`Try: ${result.quickStart}`);
+        return { ...result, formatted: lines.join('\n') };
+    },
+    async reload(_params, connection) {
+        await connection.reload();
+        return { formatted: 'Reloaded' };
+    },
+};
+function formatTabs(tabs) {
+    if (tabs.length === 0)
+        return 'No tabs open';
+    const lines = ['\nOpen tabs:\n'];
+    for (const tab of tabs) {
+        const marker = tab.isCurrent ? '→ ' : '  ';
+        lines.push(`${marker}[${tab.index}] ${tab.title}`);
+        lines.push(`       ${tab.url}\n`);
+    }
+    return lines.join('\n');
+}
+export class Session {
+    options;
+    rl = null;
+    running = false;
+    methods;
+    pending = 0;
+    drainResolve = null;
+    constructor(options) {
+        this.options = options;
+        this.methods = { ...builtinMethods };
+    }
+    /** Register a custom method handler */
+    register(method, handler) {
+        this.methods[method] = handler;
+    }
+    async start() {
+        this.running = true;
+        const input = this.options.input ?? process.stdin;
+        const output = this.options.output ?? process.stdout;
+        const rlOptions = {
+            input: input,
+            output: output,
+            terminal: !!this.options.prompt,
+        };
+        if (this.options.prompt)
+            rlOptions.prompt = this.options.prompt;
+        if (this.options.completer)
+            rlOptions.completer = this.options.completer;
+        this.rl = readline.createInterface(rlOptions);
+        if (this.options.prompt)
+            this.rl.prompt();
+        this.rl.on('line', async (line) => {
+            this.pending++;
+            try {
+                await this.handleLine(line, output);
+            }
+            finally {
+                this.pending--;
+                if (this.pending === 0 && this.drainResolve) {
+                    this.drainResolve();
+                }
+            }
+            if (this.running && this.options.prompt) {
+                this.rl?.prompt();
+            }
+        });
+        if (this.options.prompt) {
+            this.rl.on('SIGINT', () => {
+                this.write(output, '\n(Use .exit or Ctrl+D to quit)');
+                this.rl?.prompt();
+            });
+        }
+        return new Promise((resolve) => {
+            this.rl?.on('close', async () => {
+                if (this.pending > 0) {
+                    await new Promise(r => { this.drainResolve = r; });
+                }
+                this.running = false;
+                this.options.onExit?.();
+                resolve();
+            });
+        });
+    }
+    stop() {
+        this.running = false;
+        this.rl?.close();
+    }
+    /** Access the readline interface (for REPL prompt control) */
+    getReadline() {
+        return this.rl;
+    }
+    async handleLine(line, output) {
+        const { protocol, connection, config } = this.options;
+        // Try protocol-local handling first (REPL: .help, .watch, etc.)
+        if (protocol.handleLocal && this.options.localContext) {
+            const localCtx = {
+                ...this.options.localContext,
+                print: (msg) => this.write(output, msg),
+            };
+            const localResult = await protocol.handleLocal(line, localCtx);
+            if (localResult !== null) {
+                if (localResult)
+                    this.write(output, localResult);
+                return;
+            }
+        }
+        // Parse the input
+        const parsed = protocol.parse(line);
+        if (parsed === null)
+            return; // blank line or skip
+        if (isProtocolError(parsed)) {
+            this.write(output, protocol.formatError(null, parsed.code, parsed.message));
+            return;
+        }
+        // Dispatch to method handler
+        const handler = this.methods[parsed.method];
+        if (!handler) {
+            this.write(output, protocol.formatError(parsed, -32601, `Unknown method: ${parsed.method}`));
+            return;
+        }
+        try {
+            const result = await handler(parsed.params, connection, config);
+            const formatted = protocol.formatResult(parsed, result);
+            if (formatted)
+                this.write(output, formatted);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            this.write(output, protocol.formatError(parsed, -32603, message));
+        }
+    }
+    write(output, data) {
+        output.write(data + '\n');
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/session/session.ts"],"names":[],"mappings":"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"}

package/editor/nvim/README.md

@@ -0,0 +1,134 @@
+# cjig.nvim
+
+Neovim plugin for evaluating JavaScript/ClojureScript in Chrome via `cjig serve --stdio`.
+
+Select code, eval in browser, see result in a floating window.
+
+## Requirements
+
+- Neovim >= 0.9
+- `cjig` installed and on `$PATH`
+- Chrome running with debugging enabled (`cjig launch`)
+
+## Installation
+
+Run once (and again after upgrading cjig or switching Node versions):
+
+```bash
+cjig install-nvim
+```
+
+This creates a stable symlink at `$XDG_DATA_HOME/cjig/editors/nvim` (default: `~/.local/share/cjig/editors/nvim`) pointing to the plugin inside the installed package. The command prints setup snippets — add the appropriate one to your Neovim config.
+
+### lazy.nvim
+
+Create `lua/plugins/cjig.lua`:
+
+```lua
+return { dir = "~/.local/share/cjig/editors/nvim" }
+```
+
+### packer
+
+```lua
+use { "~/.local/share/cjig/editors/nvim" }
+```
+
+### Manual (init.lua)
+
+```lua
+vim.opt.runtimepath:prepend(vim.fn.expand("~/.local/share/cjig/editors/nvim"))
+require("cjig").setup()
+```
+
+### Uninstall
+
+```bash
+cjig uninstall-nvim
+```
+
+Then remove the corresponding line from your Neovim config.
+
+## Commands
+
+| Command | Mode | Description |
+|---|---|---|
+| `:CjigConnect` | n | Spawn `cjig serve --stdio` subprocess |
+| `:CjigDisconnect` | n | Kill the subprocess |
+| `:CjigEval` | v | Eval visual selection in browser |
+| `:CjigEvalForm` | n | Eval treesitter form at cursor |
+| `:CjigTabs` | n | List open browser tabs |
+| `:CjigInject <name>` | n | Inject a harness script by name |
+| `:CjigReload` | n | Reload current browser tab |
+
+## Default Keymaps
+
+All under `<leader>c` (configurable via `opts.leader`):
+
+| Key | Mode | Action |
+|---|---|---|
+| `<leader>ce` | v | Eval selection |
+| `<leader>cf` | n | Eval form at cursor |
+| `<leader>ct` | n | List tabs |
+| `<leader>cr` | n | Reload tab |
+| `<leader>cc` | n | Connect |
+| `<leader>cd` | n | Disconnect |
+
+Disable with `require("cjig").setup({ keymaps = false })`.
+
+## Options
+
+```lua
+require("cjig").setup({
+  keymaps = true,       -- set false to skip default keymaps
+  leader = "<leader>c", -- keymap prefix
+})
+```
+
+## Auto-connect
+
+`:CjigEval` and `:CjigEvalForm` auto-connect on first use.
+Explicit `:CjigConnect` is optional.
+
+## Language Detection
+
+- `clojure` filetype -> sends `lang: "cljs"` (compiled via squint-cljs)
+- Everything else -> `lang: "js"`
+
+## Treesitter Form Selection
+
+`:CjigEvalForm` walks up the treesitter tree from the cursor to find the nearest evaluable node:
+
+- `expression_statement` (trailing `;` stripped)
+- `variable_declaration` / `lexical_declaration`
+- `function_declaration`
+- `call_expression`
+- `assignment_expression`
+
+## Walkthrough
+
+```bash
+# Terminal: launch Chrome and serve examples
+cjig launch
+pnpm serve:examples
+```
+
+In Neovim:
+
+```
+:CjigConnect                  " connects to Chrome on localhost:9222
+:CjigTabs                     " floating window lists tabs
+
+" Open a scratch .js file, type:
+"   document.title
+" Visual select the line, then:
+:'<,'>CjigEval                " floating window shows page title
+
+" Type: FX.burst(50)
+" Place cursor on it:
+:CjigEvalForm                 " particles appear in browser
+
+:CjigInject fancy-demo        " injects harness
+:CjigReload                   " reloads tab
+:CjigDisconnect               " kills subprocess
+```

package/editor/nvim/lua/cjig/init.lua

@@ -0,0 +1,226 @@
+--- cjig.nvim — eval-from-editor via JSON-RPC over stdio.
+---
+--- Commands: CjigConnect, CjigDisconnect, CjigEval, CjigEvalForm,
+---           CjigTabs, CjigInject, CjigReload
+
+local rpc = require("cjig.rpc")
+local ui = require("cjig.ui")
+
+local M = {}
+
+-- Evaluable treesitter node types
+local EVAL_NODES = {
+  expression_statement = true,
+  variable_declaration = true,
+  lexical_declaration = true,
+  function_declaration = true,
+  call_expression = true,
+  assignment_expression = true,
+}
+
+--- Detect language from filetype.
+--- @return string "js" or "cljs"
+local function detect_lang()
+  if vim.bo.filetype == "clojure" then
+    return "cljs"
+  end
+  return "js"
+end
+
+--- Get visual selection text.
+--- @return string
+local function get_visual_selection()
+  local _, srow, scol, _ = unpack(vim.fn.getpos("'<"))
+  local _, erow, ecol, _ = unpack(vim.fn.getpos("'>"))
+
+  if srow > erow or (srow == erow and scol > ecol) then
+    srow, erow = erow, srow
+    scol, ecol = ecol, scol
+  end
+
+  local lines = vim.api.nvim_buf_get_lines(0, srow - 1, erow, false)
+  if #lines == 0 then return "" end
+
+  if #lines == 1 then
+    lines[1] = lines[1]:sub(scol, ecol)
+  else
+    lines[1] = lines[1]:sub(scol)
+    lines[#lines] = lines[#lines]:sub(1, ecol)
+  end
+
+  return table.concat(lines, "\n")
+end
+
+--- Walk up treesitter tree to find nearest evaluable node.
+--- @return string|nil
+local function get_treesitter_form()
+  local ok, ts_utils = pcall(require, "nvim-treesitter.ts_utils")
+  local node
+
+  if ok then
+    node = ts_utils.get_node_at_cursor()
+  else
+    -- Fallback: use built-in treesitter
+    node = vim.treesitter.get_node()
+  end
+
+  if not node then return nil end
+
+  -- Walk up to nearest evaluable node
+  while node do
+    if EVAL_NODES[node:type()] then
+      local sr, sc, er, ec = node:range()
+      local lines = vim.api.nvim_buf_get_text(0, sr, sc, er, ec, {})
+      local text = table.concat(lines, "\n")
+
+      -- Strip trailing semicolon from expression statements
+      if node:type() == "expression_statement" then
+        text = text:gsub(";%s*$", "")
+      end
+
+      return text
+    end
+    node = node:parent()
+  end
+
+  return nil
+end
+
+--- Eval code string in browser, show result in float.
+--- @param code string
+local function eval_and_show(code)
+  if code == "" then
+    ui.show_error("No code to evaluate")
+    return
+  end
+
+  local lang = detect_lang()
+
+  rpc.ensure_connected(function()
+    vim.schedule(function()
+      rpc.request("eval", { code = code, lang = lang }, function(result)
+        vim.schedule(function()
+          ui.show_result(result)
+        end)
+      end, function(err)
+        vim.schedule(function()
+          ui.show_error(err)
+        end)
+      end)
+    end)
+  end)
+end
+
+--- Register all user commands.
+local function register_commands()
+  vim.api.nvim_create_user_command("CjigConnect", function()
+    rpc.connect()
+  end, { desc = "Connect to Chrome via cjig serve" })
+
+  vim.api.nvim_create_user_command("CjigDisconnect", function()
+    rpc.disconnect()
+  end, { desc = "Disconnect from cjig" })
+
+  vim.api.nvim_create_user_command("CjigEval", function()
+    local code = get_visual_selection()
+    eval_and_show(code)
+  end, { range = true, desc = "Eval visual selection in browser" })
+
+  vim.api.nvim_create_user_command("CjigEvalForm", function()
+    local code = get_treesitter_form()
+    if not code then
+      ui.show_error("No evaluable form at cursor")
+      return
+    end
+    eval_and_show(code)
+  end, { desc = "Eval treesitter form at cursor" })
+
+  vim.api.nvim_create_user_command("CjigTabs", function()
+    rpc.ensure_connected(function()
+      vim.schedule(function()
+        rpc.request("tabs", {}, function(result)
+          vim.schedule(function()
+            if result and result.formatted then
+              ui.show_result(result.formatted)
+            else
+              ui.show_result(result)
+            end
+          end)
+        end, function(err)
+          vim.schedule(function()
+            ui.show_error(err)
+          end)
+        end)
+      end)
+    end)
+  end, { desc = "List browser tabs" })
+
+  vim.api.nvim_create_user_command("CjigInject", function(opts)
+    local ref = opts.args
+    if ref == "" then
+      ui.show_error("Usage: :CjigInject <name>")
+      return
+    end
+    rpc.ensure_connected(function()
+      vim.schedule(function()
+        rpc.request("inject", { ref = ref }, function(result)
+          vim.schedule(function()
+            if result and result.formatted then
+              vim.notify("cjig: " .. result.formatted, vim.log.levels.INFO)
+            else
+              ui.show_result(result)
+            end
+          end)
+        end, function(err)
+          vim.schedule(function()
+            ui.show_error(err)
+          end)
+        end)
+      end)
+    end)
+  end, { nargs = 1, desc = "Inject a harness script" })
+
+  vim.api.nvim_create_user_command("CjigReload", function()
+    rpc.ensure_connected(function()
+      vim.schedule(function()
+        rpc.request("reload", {}, function(_)
+          vim.schedule(function()
+            vim.notify("cjig: Reloaded", vim.log.levels.INFO)
+          end)
+        end, function(err)
+          vim.schedule(function()
+            ui.show_error(err)
+          end)
+        end)
+      end)
+    end)
+  end, { desc = "Reload current browser tab" })
+end
+
+--- Setup the plugin with optional config.
+--- @param opts? table
+function M.setup(opts)
+  opts = opts or {}
+
+  register_commands()
+
+  -- Default keymaps (disable with opts.keymaps = false)
+  if opts.keymaps ~= false then
+    local leader = opts.leader or "<leader>c"
+
+    vim.keymap.set("v", leader .. "e", ":<C-u>CjigEval<CR>",
+      { silent = true, desc = "cjig: eval selection" })
+    vim.keymap.set("n", leader .. "f", "<cmd>CjigEvalForm<CR>",
+      { silent = true, desc = "cjig: eval form" })
+    vim.keymap.set("n", leader .. "t", "<cmd>CjigTabs<CR>",
+      { silent = true, desc = "cjig: list tabs" })
+    vim.keymap.set("n", leader .. "r", "<cmd>CjigReload<CR>",
+      { silent = true, desc = "cjig: reload tab" })
+    vim.keymap.set("n", leader .. "c", "<cmd>CjigConnect<CR>",
+      { silent = true, desc = "cjig: connect" })
+    vim.keymap.set("n", leader .. "d", "<cmd>CjigDisconnect<CR>",
+      { silent = true, desc = "cjig: disconnect" })
+  end
+end
+
+return M