pointer-feedback 0.1.2

package/dist/vite.js

@@ -0,0 +1,306 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/vite/hash.ts
+import { createHash } from "node:crypto";
+function componentHash(repoRelativePath, exportName) {
+  const normalised = repoRelativePath.split("\\").join("/").replace(/^\.\//, "");
+  return createHash("sha1").update(`${normalised}#${exportName}`).digest("hex").slice(0, 8);
+}
+function addToManifest(manifest, hash, entry) {
+  const existing = manifest[hash];
+  if (existing && (existing.path !== entry.path || existing.export !== entry.export)) {
+    throw new Error(
+      `pointer: hash collision on ${hash} between ${existing.path}#${existing.export} and ${entry.path}#${entry.export}. Rename one of the two components.`
+    );
+  }
+  manifest[hash] = entry;
+}
+var init_hash = __esm({
+  "src/vite/hash.ts"() {
+    "use strict";
+  }
+});
+
+// src/vite/transform.ts
+var transform_exports = {};
+__export(transform_exports, {
+  stampSource: () => stampSource
+});
+async function loadBabel() {
+  try {
+    const [parser, traverseMod, generatorMod] = await Promise.all([
+      import("@babel/parser"),
+      // @ts-ignore optional peer — types are not installed for a dependency-free CLI bundle
+      import("@babel/traverse"),
+      // @ts-ignore optional peer — same
+      import("@babel/generator")
+    ]);
+    const unwrap = (mod, name) => {
+      const fn = mod?.default?.default ?? mod?.default ?? mod;
+      if (typeof fn !== "function") {
+        throw new Error(
+          `${name} did not resolve to a function (got ${typeof fn}) \u2014 CJS/ESM interop problem`
+        );
+      }
+      return fn;
+    };
+    return {
+      parse: parser.parse,
+      traverse: unwrap(traverseMod, "@babel/traverse"),
+      generate: unwrap(generatorMod, "@babel/generator")
+    };
+  } catch {
+    throw new Error(
+      "the Vite plugin needs @babel/parser, @babel/traverse and @babel/generator. They ship with @vitejs/plugin-react; install them if you use a different React setup."
+    );
+  }
+}
+function isHostElement(node) {
+  const name = node?.openingElement?.name;
+  return name?.type === "JSXIdentifier" && /^[a-z]/.test(name.name);
+}
+function alreadyStamped(node, attribute) {
+  return (node.openingElement.attributes ?? []).some(
+    (a) => a.type === "JSXAttribute" && a.name?.name === attribute
+  );
+}
+function collectRoots(node, out) {
+  if (!node)
+    return;
+  switch (node.type) {
+    case "JSXElement":
+      if (isHostElement(node))
+        out.push(node);
+      return;
+    case "JSXFragment":
+      for (const child of node.children ?? [])
+        collectRoots(child, out);
+      return;
+    case "ConditionalExpression":
+      collectRoots(node.consequent, out);
+      collectRoots(node.alternate, out);
+      return;
+    case "LogicalExpression":
+      collectRoots(node.right, out);
+      return;
+    case "ParenthesizedExpression":
+      collectRoots(node.expression, out);
+      return;
+    default:
+      return;
+  }
+}
+function componentNameFor(path) {
+  const node = path.node;
+  if (node.id?.name)
+    return node.id.name;
+  const parent = path.parent;
+  if (parent?.type === "VariableDeclarator" && parent.id?.type === "Identifier")
+    return parent.id.name;
+  if (parent?.type === "CallExpression") {
+    const grand = path.parentPath?.parent;
+    if (grand?.type === "VariableDeclarator" && grand.id?.type === "Identifier")
+      return grand.id.name;
+  }
+  if (parent?.type === "ExportDefaultDeclaration")
+    return "default";
+  return null;
+}
+async function stampSource(code, repoRelativePath, attribute) {
+  if (repoRelativePath.endsWith(".vue")) {
+    return stampVue(code, repoRelativePath, attribute);
+  }
+  const { parse, traverse, generate } = await loadBabel();
+  const ast = parse(code, {
+    sourceType: "module",
+    plugins: ["jsx", "typescript", "decorators-legacy", "classProperties"]
+  });
+  const components = {};
+  let changed = false;
+  const visitComponent = (path) => {
+    const name = componentNameFor(path);
+    if (!name || !/^[A-Z]|^default$/.test(name))
+      return;
+    const roots = [];
+    const body = path.node.body;
+    if (body?.type === "BlockStatement") {
+      for (const stmt of body.body) {
+        if (stmt.type === "ReturnStatement")
+          collectRoots(stmt.argument, roots);
+      }
+    } else {
+      collectRoots(body, roots);
+    }
+    if (roots.length === 0)
+      return;
+    const hash = componentHash(repoRelativePath, name);
+    components[hash] = { path: repoRelativePath, export: name };
+    for (const el of roots) {
+      if (alreadyStamped(el, attribute))
+        continue;
+      el.openingElement.attributes.push({
+        type: "JSXAttribute",
+        name: { type: "JSXIdentifier", name: attribute },
+        value: { type: "StringLiteral", value: hash }
+      });
+      changed = true;
+    }
+  };
+  traverse(ast, {
+    FunctionDeclaration: visitComponent,
+    FunctionExpression: visitComponent,
+    ArrowFunctionExpression: visitComponent
+  });
+  if (!changed)
+    return { code, changed: false, components };
+  return { code: generate(ast, { retainLines: true }, code).code, changed: true, components };
+}
+function stampVue(code, repoRelativePath, attribute) {
+  const name = repoRelativePath.split("/").pop().replace(/\.vue$/, "");
+  const hash = componentHash(repoRelativePath, name);
+  const components = { [hash]: { path: repoRelativePath, export: name } };
+  const match = code.match(/<template>([\s\S]*?)<\/template>/);
+  if (!match)
+    return { code, changed: false, components };
+  let changed = false;
+  const stamped = match[1].replace(/<([a-z][\w-]*)((?:\s[^>]*?)?)(\/?)>/g, (whole, tag, attrs, selfClose) => {
+    if (attrs.includes(attribute))
+      return whole;
+    changed = true;
+    return `<${tag}${attrs} ${attribute}="${hash}"${selfClose}>`;
+  });
+  if (!changed)
+    return { code, changed: false, components };
+  return { code: code.replace(match[1], stamped), changed: true, components };
+}
+var init_transform = __esm({
+  "src/vite/transform.ts"() {
+    "use strict";
+    init_hash();
+  }
+});
+
+// src/vite/index.ts
+init_hash();
+init_hash();
+import { promises as fs } from "node:fs";
+import { dirname, relative, resolve, sep } from "node:path";
+import { execFileSync } from "node:child_process";
+var DEFAULT_ATTR = "data-component-source";
+var DEFAULT_MANIFEST = ".pointer/manifest.json";
+function gitRoot(fallback) {
+  try {
+    return execFileSync("git", ["rev-parse", "--show-toplevel"], { cwd: fallback, encoding: "utf8" }).trim();
+  } catch {
+    return fallback;
+  }
+}
+function headSha() {
+  try {
+    return execFileSync("git", ["rev-parse", "HEAD"], { encoding: "utf8" }).trim();
+  } catch {
+    return null;
+  }
+}
+function toPosix(p) {
+  return p.split(sep).join("/");
+}
+function pointerSource(options = {}) {
+  const attribute = options.attribute ?? DEFAULT_ATTR;
+  const enabled = options.enabled ?? true;
+  const wantsBuildSha = options.buildSha ?? true;
+  let root = process.cwd();
+  let repoRoot = root;
+  let manifestPath = DEFAULT_MANIFEST;
+  const manifest = {};
+  const include = options.include ?? ["**/*.jsx", "**/*.tsx", "**/*.vue"];
+  const exclude = options.exclude ?? [];
+  function matches(id) {
+    if (!enabled)
+      return false;
+    if (id.includes("node_modules"))
+      return false;
+    const clean = id.split("?")[0];
+    const ext = clean.slice(clean.lastIndexOf("."));
+    if (![".jsx", ".tsx", ".vue"].includes(ext))
+      return false;
+    if (exclude.some((pattern) => clean.includes(pattern.replace(/\*/g, ""))))
+      return false;
+    return true;
+  }
+  async function writeManifest() {
+    if (!enabled)
+      return;
+    const target = resolve(repoRoot, manifestPath);
+    await fs.mkdir(dirname(target), { recursive: true });
+    const entries = Object.fromEntries(
+      Object.entries(manifest).sort(([a], [b]) => a.localeCompare(b)).map(([hash, entry]) => [hash, { path: entry.path, component: entry.export }])
+    );
+    const payload = { version: 1, entries };
+    const prev = target.replace(/\.json$/, ".prev.json");
+    try {
+      const existing = await fs.readFile(target, "utf8");
+      await fs.writeFile(prev, existing, "utf8");
+    } catch {
+    }
+    const tmp = `${target}.tmp`;
+    await fs.writeFile(tmp, JSON.stringify(payload, null, 2) + "\n", "utf8");
+    await fs.rename(tmp, target);
+  }
+  let debounce = null;
+  return {
+    name: "pointer-source",
+    enforce: "pre",
+    configResolved(config) {
+      root = config.root ?? process.cwd();
+      repoRoot = gitRoot(root);
+      manifestPath = options.manifest ?? DEFAULT_MANIFEST;
+    },
+    async transform(code, id) {
+      if (!matches(id))
+        return null;
+      const relPath = toPosix(relative(repoRoot, id.split("?")[0]));
+      const { stampSource: stampSource2 } = await Promise.resolve().then(() => (init_transform(), transform_exports));
+      try {
+        const result = await stampSource2(code, relPath, attribute);
+        for (const [hash, entry] of Object.entries(result.components)) {
+          addToManifest(manifest, hash, entry);
+        }
+        if (debounce)
+          clearTimeout(debounce);
+        debounce = setTimeout(() => void writeManifest(), 250);
+        return result.changed ? { code: result.code, map: null } : null;
+      } catch (err) {
+        this.warn?.(`pointer: could not stamp ${relPath}: ${err?.message ?? err}`);
+        return null;
+      }
+    },
+    transformIndexHtml(html) {
+      if (!enabled || wantsBuildSha === false)
+        return html;
+      const sha = typeof wantsBuildSha === "string" ? wantsBuildSha : headSha();
+      if (!sha)
+        return html;
+      if (html.includes("data-build-sha"))
+        return html;
+      return html.replace(/<html(\s|>)/, `<html data-build-sha="${sha}"$1`);
+    },
+    async buildEnd() {
+      if (debounce)
+        clearTimeout(debounce);
+      await writeManifest();
+    }
+  };
+}
+export {
+  componentHash,
+  pointerSource as default
+};

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "pointer-feedback",
+  "version": "0.1.2",
+  "description": "Click-to-comment feedback for your web app: install the widget, then turn pending comments into AI apply prompts.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Moamen",
+  "homepage": "https://pointer.moamen.work",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moamen-ui/poitner-api.git",
+    "directory": "cli"
+  },
+  "bugs": {
+    "url": "https://github.com/moamen-ui/poitner-api/issues"
+  },
+  "keywords": [
+    "feedback",
+    "widget",
+    "comments",
+    "bug-report",
+    "ai",
+    "claude",
+    "mcp",
+    "cli"
+  ],
+  "bin": {
+    "pointer": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "node --import tsx --test test/*.test.ts test/**/*.test.ts",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^18.19.130",
+    "esbuild": "^0.20.2",
+    "tsx": "^4.23.13",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.6.0"
+  },
+  "exports": {
+    ".": "./dist/cli.js",
+    "./vite": "./dist/vite.js"
+  },
+  "peerDependencies": {
+    "@babel/parser": ">=7",
+    "@babel/traverse": ">=7",
+    "@babel/generator": ">=7"
+  },
+  "peerDependenciesMeta": {
+    "@babel/parser": {
+      "optional": true
+    },
+    "@babel/traverse": {
+      "optional": true
+    },
+    "@babel/generator": {
+      "optional": true
+    }
+  }
+}