@kud/foxhop-cli 1.0.3 → 1.1.0

package/dist/cli.js

@@ -3,6 +3,7 @@
 // src/cli.ts
 import { defineCommand, runMain } from "citty";
 import { spawn } from "child_process";
+import { existsSync as existsSync3 } from "fs";
 
 // src/config.ts
 import { mkdirSync, readFileSync, writeFileSync, existsSync } from "fs";
@@ -52,6 +53,10 @@ var SCHEMA = {
             enum: ["recent", "first", "pinned"],
             default: "recent",
             description: "Which tab to focus when several match"
+          },
+          favorite: {
+            type: "boolean",
+            description: "Pin this target to the top of the list"
           }
         }
       }
@@ -112,6 +117,34 @@ var removeTarget = (name) => {
   if (removed) writeConfig({ targets: filtered });
   return { targets: filtered, removed };
 };
+var toggleFavorite = (name) => {
+  const { targets } = readConfig();
+  let favorite = false;
+  let found = false;
+  const next = targets.map((target) => {
+    if (target.name !== name) return target;
+    found = true;
+    favorite = !target.favorite;
+    const { favorite: _was, ...rest } = target;
+    return favorite ? { ...rest, favorite: true } : rest;
+  });
+  if (found) writeConfig({ targets: next });
+  return { favorite, found };
+};
+var deriveTarget = (url) => {
+  let host = url.trim();
+  try {
+    host = new URL(url).hostname;
+  } catch {
+    host = url.replace(/^[a-z]+:\/\//i, "").split("/")[0] || url;
+  }
+  const labels = host.split(".").filter(Boolean);
+  const generic = /* @__PURE__ */ new Set(["www", "app", "web", "m", "my", "go"]);
+  const candidates = labels.length > 1 ? labels.slice(0, -1) : labels;
+  const name = (candidates.find((label) => !generic.has(label)) ?? candidates[0] ?? host).toLowerCase();
+  const title = name.charAt(0).toUpperCase() + name.slice(1);
+  return { name, match: host, title };
+};
 
 // src/client.ts
 import net from "net";
@@ -245,6 +278,14 @@ var sync = (node, cli, dir = defaultScriptsDir()) => {
   }
   return { dir, written: targets.length, removed: removed.length };
 };
+var clearScripts = (dir = defaultScriptsDir()) => {
+  if (!existsSync2(dir)) return { dir, written: 0, removed: 0 };
+  const removed = readdirSync(dir).filter((file) => file.startsWith("focus-") && file.endsWith(".sh")).filter((file) => isGenerated(join4(dir, file)));
+  for (const file of removed) rmSync(join4(dir, file));
+  const icon = join4(dir, ICON_FILE);
+  if (existsSync2(icon)) rmSync(icon);
+  return { dir, written: 0, removed: removed.length };
+};
 
 // src/cli.ts
 import { fileURLToPath as fileURLToPath2 } from "url";
@@ -260,6 +301,11 @@ var runOpen = (args) => {
 };
 var foreground = () => runOpen(["-a", browserApp()]);
 var openUrl = (url) => runOpen([url]);
+var autoSync = () => {
+  if (existsSync3(defaultScriptsDir())) {
+    sync(process.execPath, fileURLToPath2(import.meta.url));
+  }
+};
 var focus = defineCommand({
   meta: {
     name: "focus",
@@ -344,8 +390,13 @@ var list = defineCommand({
       );
       return;
     }
-    for (const target of targets) {
-      console.log(`${target.name.padEnd(16)} ${target.match}`);
+    const ordered = [
+      ...targets.filter((target) => target.favorite),
+      ...targets.filter((target) => !target.favorite)
+    ];
+    for (const target of ordered) {
+      const star = target.favorite ? "\u2605 " : "  ";
+      console.log(`${star}${target.name.padEnd(16)} ${target.match}`);
     }
   }
 });
@@ -398,9 +449,24 @@ var syncCommand = defineCommand({
       type: "string",
       description: `Output directory (default: ${defaultScriptsDir()})`
     },
+    clean: {
+      type: "boolean",
+      description: "Remove all generated scripts instead of writing them"
+    },
     json: { type: "boolean", description: "Output the result as JSON" }
   },
   run: ({ args }) => {
+    if (args.clean) {
+      const cleared = clearScripts(args.dir);
+      if (args.json) {
+        process.stdout.write(JSON.stringify(cleared) + "\n");
+        return;
+      }
+      console.log(
+        `foxhop: removed ${cleared.removed} script(s) from ${cleared.dir}`
+      );
+      return;
+    }
     const result = sync(
       process.execPath,
       fileURLToPath2(import.meta.url),
@@ -419,20 +485,25 @@ var syncCommand = defineCommand({
   }
 });
 var add = defineCommand({
-  meta: { name: "add", description: "Add or update a target in tabs.json" },
+  meta: {
+    name: "add",
+    description: "Add or update a target \u2014 name/match/title derive from the URL"
+  },
   args: {
-    name: {
+    url: {
       type: "positional",
       required: true,
-      description: "Target id (used by `foxhop focus <name>`)"
+      description: "URL of the tab (e.g. https://gemini.google.com)"
+    },
+    name: {
+      type: "string",
+      description: "Override the derived id (used by `foxhop focus <name>`)"
     },
+    title: { type: "string", description: "Override the derived label" },
     match: {
       type: "string",
-      required: true,
-      description: "Substring matched against tab URLs"
+      description: "Override the derived match (default: the URL hostname)"
     },
-    url: { type: "string", description: "URL opened when no tab matches" },
-    title: { type: "string", description: "Human-friendly label" },
     strategy: {
       type: "string",
       description: "hostname | prefix | exact | search"
@@ -440,18 +511,25 @@ var add = defineCommand({
     pick: {
       type: "string",
       description: "recent | first | pinned (which tab when several match)"
-    }
+    },
+    favorite: { type: "boolean", description: "Pin to the top of the list" }
   },
   run: ({ args }) => {
+    const url = String(args.url);
+    const derived = deriveTarget(url);
+    const name = args.name ?? derived.name;
+    const existing = findTarget(readConfig(), name);
     upsertTarget({
-      name: String(args.name),
-      match: String(args.match),
-      url: args.url,
-      title: args.title,
+      name,
+      match: args.match ?? derived.match,
+      url,
+      title: args.title ?? derived.title,
       strategy: args.strategy,
-      pick: args.pick
+      pick: args.pick,
+      favorite: args.favorite || existing?.favorite ? true : void 0
     });
-    console.log(`foxhop: saved "${args.name}"`);
+    console.log(`foxhop: saved "${name}"`);
+    autoSync();
   }
 });
 var remove = defineCommand({
@@ -470,6 +548,30 @@ var remove = defineCommand({
       process.exit(1);
     }
     console.log(`foxhop: removed "${args.name}"`);
+    autoSync();
+  }
+});
+var fav = defineCommand({
+  meta: {
+    name: "fav",
+    description: "Toggle a target's favourite (pins it to the top of the list)"
+  },
+  args: {
+    name: {
+      type: "positional",
+      required: true,
+      description: "Target id to toggle"
+    }
+  },
+  run: ({ args }) => {
+    const { favorite, found } = toggleFavorite(String(args.name));
+    if (!found) {
+      console.error(`foxhop: no target named "${args.name}"`);
+      process.exit(1);
+    }
+    console.log(
+      `foxhop: "${args.name}" ${favorite ? "favourited \u2605" : "unfavourited"}`
+    );
   }
 });
 var NAME = "foxhop";
@@ -479,6 +581,7 @@ var subCommands = {
   tabs,
   add,
   remove,
+  fav,
   init,
   sync: syncCommand,
   install: installCommand

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kud/foxhop-cli",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "foxhop CLI and native messaging host — focus specific Firefox tabs from macOS",
   "type": "module",
   "license": "MIT",