stikfix 1.3.2 → 1.6.0

package/dist/host/stikfix-native.cjs

@@ -23,6 +23,7 @@ __export(native_host_exports, {
   handlePickFolder: () => handlePickFolder,
   handleStartHost: () => handleStartHost,
   main: () => main,
+  runNativeHost: () => runNativeHost,
   validateChosenFolder: () => validateChosenFolder
 });
 module.exports = __toCommonJS(native_host_exports);
@@ -212,8 +213,11 @@ function handleStartHost(cfg, root, spawnFn = import_node_child_process2.spawn,
   }
   const nodePath = typeof cfg.nodePath === "string" && cfg.nodePath.length > 0 ? cfg.nodePath : process.execPath;
   const hostEntry = resolveHostEntry(cfg);
+  const hostExe = typeof cfg.hostExe === "string" && cfg.hostExe.length > 0 ? cfg.hostExe : void 0;
+  const spawnCmd = hostExe ?? nodePath;
+  const spawnArgs = hostExe ? ["serve", "--root", resolvedRoot] : [hostEntry, "--root", resolvedRoot];
   try {
-    const child = spawnFn(nodePath, [hostEntry, "--root", resolvedRoot], {
+    const child = spawnFn(spawnCmd, spawnArgs, {
       detached: true,
       stdio: "ignore",
       windowsHide: true
@@ -315,7 +319,17 @@ function main() {
     process.exit(0);
   });
 }
-if (typeof require !== "undefined" && typeof module !== "undefined" && require.main === module) {
+async function runNativeHost() {
+  main();
+}
+function bundledInExe() {
+  try {
+    return typeof __STIKFIX_BUNDLED__ !== "undefined" && __STIKFIX_BUNDLED__ === true;
+  } catch {
+    return false;
+  }
+}
+if (!bundledInExe() && typeof require !== "undefined" && typeof module !== "undefined" && require.main === module) {
   main();
 }
 // Annotate the CommonJS export names for ESM import in node:
@@ -323,5 +337,6 @@ if (typeof require !== "undefined" && typeof module !== "undefined" && require.m
   handlePickFolder,
   handleStartHost,
   main,
+  runNativeHost,
   validateChosenFolder
 });

package/dist/lib/pin-position.js

@@ -0,0 +1,69 @@
+/**
+ * URL-path matching and pin position computation for stikfix persistent pins.
+ *
+ * matchesUrlPath + computePinPosition — pure, node:test-safe (no DOM/chrome at module level).
+ * Scroll offsets and anchor rects are PASSED AS PARAMETERS by the caller (pin.ts in Plan 04),
+ * which supplies window.scrollX/scrollY and el.getBoundingClientRect() at render time.
+ *
+ * INVARIANT: No top-level browser API access — no window/document/chrome references.
+ * This module imports cleanly under node:test.
+ */
+/**
+ * Compare two URLs by pathname only, ignoring query string and fragment (D-02).
+ * Returns false (not throws) on any malformed URL input.
+ *
+ * @param noteUrl  The URL stored in the note's YAML frontmatter
+ * @param pageUrl  The current page URL from chrome.tabs.get
+ */
+export function matchesUrlPath(noteUrl, pageUrl) {
+    try {
+        const notePath = new URL(noteUrl).pathname;
+        const pagePath = new URL(pageUrl).pathname;
+        return notePath === pagePath;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Compute the CSS viewport position for an on-page pin — pure, DOM-free.
+ *
+ * Branch logic:
+ *   - orphaned || anchorRect === null: orphaned-fallback at last-known page-absolute
+ *     rect minus scroll offsets → { left: storedRect.x - scrollX, top: storedRect.y - scrollY, orphaned: true }
+ *   - !orphaned && anchorRect !== null: use anchorRect x/y directly (already in
+ *     fixed/viewport coords from getBoundingClientRect or stored viewport coords
+ *     for free notes) → { left: anchorRect.x, top: anchorRect.y, orphaned: false }
+ *
+ * The caller (pin.ts) passes:
+ *   - anchorRect: el.getBoundingClientRect() for element pins, stored viewport
+ *     coords {x,y,width:0,height:0} for free pins, or null when selector misses.
+ *   - storedRect: page-absolute rect from frontmatter (for orphaned-fallback).
+ *   - scrollX/scrollY: window.scrollX / window.scrollY at call time.
+ *   - orphaned: true when the selector re-query returned null.
+ *
+ * NEVER reads window.scrollX or window.scrollY internally — caller supplies them.
+ *
+ * @param anchorRect  Live fixed-coord rect from getBoundingClientRect, or null
+ * @param storedRect  Page-absolute rect from frontmatter (orphaned fallback), or null
+ * @param scrollX     window.scrollX at call time (passed by caller)
+ * @param scrollY     window.scrollY at call time (passed by caller)
+ * @param orphaned    true when selector matched nothing on the current page
+ */
+export function computePinPosition(anchorRect, storedRect, scrollX, scrollY, orphaned) {
+    if (orphaned || anchorRect === null) {
+        // Orphaned fallback: last-known page-absolute rect → convert to viewport via scroll
+        return {
+            left: (storedRect?.x ?? 0) - scrollX,
+            top: (storedRect?.y ?? 0) - scrollY,
+            orphaned: true,
+        };
+    }
+    // Element-anchored (live getBoundingClientRect in fixed/viewport coords)
+    // OR free-floating (stored viewport coords already in anchorRect x/y)
+    return {
+        left: anchorRect.x,
+        top: anchorRect.y,
+        orphaned: false,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stikfix",
-  "version": "1.3.2",
+  "version": "1.6.0",
   "description": "Pin sticky notes on any page — your AI reads them.",
   "license": "MIT",
   "author": "Omer Nesher <omernesher@gmail.com>",
@@ -32,6 +32,7 @@
   },
   "files": [
     "dist/host/src",
+    "dist/lib/pin-position.js",
     "dist/host/stikfix-init.cjs",
     "dist/host/stikfix-native.cjs",
     "public/icon",
@@ -50,13 +51,19 @@
     "test:lib": "tsc -p tsconfig.lib.json && node --test \"dist/lib/lib/test/**/*.test.js\"",
     "test": "tsc -p tsconfig.host.json && node --test \"dist/host/test/**/*.test.js\"",
     "check": "tsc --noEmit && tsc --noEmit -p tsconfig.host.json && node scripts/clean-room-check.mjs && node scripts/host-smoke-test.mjs && npm run test:lib && npm test",
+    "pack:crx": "node scripts/pack-crx.mjs",
+    "gen:update-xml": "node scripts/gen-update-xml.mjs",
+    "build:sea": "node scripts/build-sea.mjs",
+    "build:installer": "node scripts/build-installer.mjs",
     "postinstall": "node -e \"try{require.resolve('wxt');require('node:child_process').execSync('wxt prepare',{stdio:'inherit'})}catch(e){}\""
   },
   "devDependencies": {
     "@medv/finder": "4.0.2",
     "@types/chrome": "0.1.42",
     "@types/node": "25.9.1",
+    "crx3": "2.0.0",
     "interactjs": "1.10.27",
+    "postject": "1.0.0-alpha.6",
     "typescript": "6.0.3",
     "wxt": "0.20.26"
   },