@kud/gh-ink 0.19.0 → 0.20.0

package/dist/index.d.ts

@@ -311,4 +311,59 @@ declare const writeCache: (key: string, data: {
     login: string;
 }) => void;
 
-export { type Action, ActionMenu, type AnyItem, App, COLS, type CiStatus, CiStatusLine, type CiStatusState, CommentsPanel, type CommentsPanelProps, type DetailContext, type ExplainSection, type ExtensionTarget, type GHDetail, type GHItem, HealthPanel, type HealthPanelProps, type InboxExtension, type JiraTransition, type RepoHeader, type Section, type ShowLess, type ShowMore, type Standing, type SubgroupHeader, type TaskRow, buildActions, buildCheckoutCmd, clipboard, drillCmd, explainItem, filterByOrigin, filterByRepos, filterBySearch, fitCount, healthColor, healthDisplay, healthGlyph, healthLegend, insertRepoHeaders, itermRun, jumpToRepo, jumpToRepoPane, layoutGHItems, maxViewStart, moveCursor, openInTab, readCache, relativeTime, renderMarkdown, repoPriority, reposInSections, resolveRepoPath, runHere, runInPane, runInPaneHorizontal, sameCiStatusState, sortByRecency, sortItems, toCiStatusState, topLevelCount, truncate, useActionMenu, whoseMove, windowCount, withHeaders, withoutItem, writeCache };
+/**
+ * A named slice of the reader's repos. Two or more turn on the in-app toggle;
+ * one or none means an undivided set and no toggle at all.
+ *
+ * Named rather than boolean because the distinction was never a property of a
+ * repo — it is whatever separation the reader actually keeps, and a boolean
+ * leaves a third slice nowhere to go.
+ */
+type RepoProfile = {
+    /** Stable id — what `--profile=<name>` selects. */
+    name: string;
+    /** Shown on the toggle. Defaults to `name`. */
+    label?: string;
+    /** Which repos belong to this profile. */
+    match: (repo: string) => boolean;
+    /** Where this profile's checkouts live, if it keeps its own directory. */
+    checkoutDir?: string;
+};
+type InboxConfig = {
+    /**
+     * Repo ranking, best first. An entry ending in `/` matches by owner prefix,
+     * anything else must equal `owner/name` exactly — so a single repo can outrank
+     * the owner that contains it. Repos matching nothing sort last, together.
+     */
+    repoPriority: readonly string[];
+    profiles: readonly RepoProfile[];
+    /**
+     * Fallback directory holding checkouts, for repos in no profile that names one
+     * of its own. Unset means local checkouts are not resolved at all, which is
+     * correct for a host that only ever opens things in a browser.
+     */
+    checkoutDir?: string;
+    /**
+     * Directory name the on-disk cache lives under, inside the platform cache
+     * root. Defaults to this package's name — a library has no business claiming a
+     * directory named after whichever tool happens to embed it, and two hosts on
+     * one machine would otherwise share a cache keyed only by section name.
+     */
+    cacheNamespace: string;
+};
+/** Supply the host's opinions. Call once, before rendering. */
+declare const configureInbox: (config: Partial<InboxConfig>) => void;
+declare const inboxConfig: () => InboxConfig;
+/** Test seam — restores the empty defaults. */
+declare const resetInboxConfig: () => void;
+/** The profile a repo belongs to, or null when none claims it. */
+declare const profileOf: (repo: string) => RepoProfile | null;
+/**
+ * Where checkouts are searched, in order: every profile that names its own
+ * directory, then the fallback. Deduped, since the ordinary single-directory
+ * case points them all at the same place. Empty when nothing is configured —
+ * callers treat that as "not checked out locally", which it truthfully is.
+ */
+declare const checkoutDirs: () => string[];
+
+export { type Action, ActionMenu, type AnyItem, App, COLS, type CiStatus, CiStatusLine, type CiStatusState, CommentsPanel, type CommentsPanelProps, type DetailContext, type ExplainSection, type ExtensionTarget, type GHDetail, type GHItem, HealthPanel, type HealthPanelProps, type InboxConfig, type InboxExtension, type JiraTransition, type RepoHeader, type RepoProfile, type Section, type ShowLess, type ShowMore, type Standing, type SubgroupHeader, type TaskRow, buildActions, buildCheckoutCmd, checkoutDirs, clipboard, configureInbox, drillCmd, explainItem, filterByOrigin, filterByRepos, filterBySearch, fitCount, healthColor, healthDisplay, healthGlyph, healthLegend, inboxConfig, insertRepoHeaders, itermRun, jumpToRepo, jumpToRepoPane, layoutGHItems, maxViewStart, moveCursor, openInTab, profileOf, readCache, relativeTime, renderMarkdown, repoPriority, reposInSections, resetInboxConfig, resolveRepoPath, runHere, runInPane, runInPaneHorizontal, sameCiStatusState, sortByRecency, sortItems, toCiStatusState, topLevelCount, truncate, useActionMenu, whoseMove, windowCount, withHeaders, withoutItem, writeCache };

package/dist/index.js

@@ -606,9 +606,36 @@ var healthLegend = [
   ["merged", "Merged"],
   ["closed", "Closed"]
 ];
+
+// src/inbox/config.ts
+var EMPTY = {
+  repoPriority: [],
+  profiles: [],
+  cacheNamespace: "gh-ink"
+};
+var current = EMPTY;
+var configureInbox = (config) => {
+  current = { ...EMPTY, ...config };
+};
+var inboxConfig = () => current;
+var resetInboxConfig = () => {
+  current = EMPTY;
+};
+var profileOf = (repo) => current.profiles.find((p) => p.match(repo)) ?? null;
+var checkoutDirs = () => [
+  .../* @__PURE__ */ new Set([
+    ...current.profiles.flatMap((p) => p.checkoutDir ?? []),
+    ...current.checkoutDir ? [current.checkoutDir] : []
+  ])
+];
+
+// src/inbox/cache.ts
 var CACHE_TTL_MS = 12e4;
 var CACHE_VERSION = 2;
-var cacheDir = () => join(process.env.XDG_CACHE_HOME || join(homedir(), ".cache"), "ambre");
+var cacheDir = () => join(
+  process.env.XDG_CACHE_HOME || join(homedir(), ".cache"),
+  inboxConfig().cacheNamespace
+);
 var cacheFile = (key) => join(cacheDir(), `${key.replace(/[^a-z0-9._-]/gi, "-")}.json`);
 var readCache = (key) => {
   try {
@@ -840,14 +867,11 @@ var explainItem = (item, login) => {
   ];
 };
 var repoPriority = (repo) => {
-  const profile = process.env.OS_PROFILE ?? "";
-  if (profile === "work") {
-    if (repo === "theorchard/orchardgo") return 0;
-    if (repo.startsWith("theorchard/")) return 1;
-    if (repo.startsWith("kud/")) return 2;
-    return 3;
-  }
-  return repo.startsWith("kud/") ? 0 : 1;
+  const order = inboxConfig().repoPriority;
+  const i = order.findIndex(
+    (p) => p.endsWith("/") ? repo.startsWith(p) : repo === p
+  );
+  return i === -1 ? order.length : i;
 };
 var sortItems = (items) => [...items].sort((a, b) => {
   const pd = repoPriority(a.repo) - repoPriority(b.repo);
@@ -996,11 +1020,11 @@ var reposInSections = (sections) => [
     sections.flatMap((s) => s.items).filter((i) => i.kind === "pr" || i.kind === "issue").map((i) => i.repo)
   )
 ].sort();
-var moveCursor = (items, current, dir) => {
-  let next = current + dir;
+var moveCursor = (items, current2, dir) => {
+  let next = current2 + dir;
   while (next >= 0 && next < items.length && (items[next].kind === "repo-header" || items[next].kind === "subgroup-header"))
     next += dir;
-  if (next < 0 || next >= items.length) return current;
+  if (next < 0 || next >= items.length) return current2;
   return next;
 };
 var itemLines = (item, isFirst) => (item.kind === "repo-header" || item.kind === "subgroup-header") && !isFirst ? 2 : 1;
@@ -1049,11 +1073,8 @@ var clipboard = (text) => {
 };
 var buildCheckoutCmd = async (repoFull, branch, login) => {
   const [repoOwner, repoName] = repoFull.split("/");
-  const projects = process.env.PROJECTS_DIR ?? `${process.env.HOME}/Projects`;
-  const profile = process.env.OS_PROFILE ?? "";
-  const isWorkRepo = profile === "work" && (repoFull.startsWith("theorchard/") || repoFull.startsWith("kud/") && (repoName ?? "").startsWith("theorchard-"));
-  const cloneBase = profile === "work" ? `${projects}/${isWorkRepo ? "work" : "home"}` : projects;
-  const searchDirs = profile === "work" ? [`${projects}/work`, `${projects}/home`] : [projects];
+  const searchDirs = checkoutDirs();
+  const cloneBase = profileOf(repoFull)?.checkoutDir ?? inboxConfig().checkoutDir ?? "";
   let repoPath = "";
   outer: for (const searchDir of searchDirs) {
     if (!existsSync(searchDir)) continue;
@@ -1108,9 +1129,7 @@ var buildCheckoutCmd = async (repoFull, branch, login) => {
   return cmd;
 };
 var resolveRepoPath = async (repoFull) => {
-  const projects = process.env.PROJECTS_DIR ?? `${process.env.HOME}/Projects`;
-  const profile = process.env.OS_PROFILE ?? "";
-  const searchDirs = profile === "work" ? [`${projects}/work`, `${projects}/home`] : [projects];
+  const searchDirs = checkoutDirs();
   for (const searchDir of searchDirs) {
     if (!existsSync(searchDir)) continue;
     let entries;
@@ -2936,4 +2955,4 @@ var App = ({
   ] });
 };
 
-export { ActionMenu, App, COLS, CiStatusLine, CommentsPanel, HealthPanel, buildActions, buildCheckoutCmd, clipboard, drillCmd, explainItem, filterByOrigin, filterByRepos, filterBySearch, fitCount, healthColor, healthDisplay, healthGlyph, healthLegend, insertRepoHeaders, itermRun, jumpToRepo, jumpToRepoPane, layoutGHItems, maxViewStart, moveCursor, openInTab, readCache, relativeTime, renderMarkdown, repoPriority, reposInSections, resolveRepoPath, runHere, runInPane, runInPaneHorizontal, sameCiStatusState, sortByRecency, sortItems, toCiStatusState, topLevelCount, truncate, useActionMenu, whoseMove, windowCount, withHeaders, withoutItem, writeCache };
+export { ActionMenu, App, COLS, CiStatusLine, CommentsPanel, HealthPanel, buildActions, buildCheckoutCmd, checkoutDirs, clipboard, configureInbox, drillCmd, explainItem, filterByOrigin, filterByRepos, filterBySearch, fitCount, healthColor, healthDisplay, healthGlyph, healthLegend, inboxConfig, insertRepoHeaders, itermRun, jumpToRepo, jumpToRepoPane, layoutGHItems, maxViewStart, moveCursor, openInTab, profileOf, readCache, relativeTime, renderMarkdown, repoPriority, reposInSections, resetInboxConfig, resolveRepoPath, runHere, runInPane, runInPaneHorizontal, sameCiStatusState, sortByRecency, sortItems, toCiStatusState, topLevelCount, truncate, useActionMenu, whoseMove, windowCount, withHeaders, withoutItem, writeCache };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kud/gh-ink",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Ink components for rendering GitHub PR review comments and health — controlled, presentation-only, built on @kud/ink-ui and fed by @kud/gh.",
   "type": "module",
   "main": "dist/index.js",