@young1lin/dsh-ui-gitworkbench 0.1.3 → 0.1.5

package/lib/log-filter.js

@@ -0,0 +1,71 @@
+/**
+ * The history filter, compiled into `git log` arguments.
+ *
+ * This is the pushdown half of the IDEA-style filter: matching runs inside
+ * `git log` over ALL history, not client-side over the loaded pages — the
+ * loaded-pages blind spot is the reason this module exists. Everything here is
+ * pure so the argument matrix is testable without spawning git.
+ *
+ * DIALECT RULE: whenever any pattern is emitted, the flags are `-i -E` and
+ * every literal input is escaped for POSIX ERE. Mixing `--fixed-strings` with
+ * `-E` is not possible (one overrides the other for EVERY pattern on the
+ * command line), so a single dialect keeps users literal no matter what the
+ * text criterion's regex toggle says; regex text alone is passed raw.
+ *
+ * Dates pass through verbatim: approxidate ("2 weeks ago") is git's language,
+ * and reimplementing even a slice of it client-side is how the dual-semantics
+ * bug farm starts. An invalid date is git's error to raise, surfaced by the
+ * host's usual exit-code + stderr format.
+ *
+ * @module @young1lin/dsh-ui-gitworkbench/log-filter
+ */
+/** The filter that filters nothing — also the default when a client sends none. */
+export function emptyLogFilter() {
+    return { users: [], text: '', textRegex: false, paths: [], after: '', before: '' };
+}
+/** POSIX ERE metacharacters, escaped so each matches itself. */
+function escapeEre(literal) {
+    return literal.replace(/[\\.[\]*+?(){}|^$-]/g, '\\$&');
+}
+const DAY_RE = /^\d{4}-\d{2}-\d{2}$/;
+/**
+ * Expand a bare calendar day into an explicit moment. Git's approxidate
+ * parses `--since=2026-08-18` against an implementation-defined timezone,
+ * which on Windows silently excludes that very day's commits; `T00:00:00`
+ * pins it to local midnight (a picker day means the whole day, so `before`
+ * gets the day's last second instead).
+ */
+function expandDay(bound, endOfDay) {
+    if (!DAY_RE.test(bound))
+        return bound;
+    return endOfDay ? `${bound}T23:59:59` : `${bound}T00:00:00`;
+}
+/**
+ * Compile a filter into the argument segment inserted after the log command's
+ * own flags. Pathspecs come last behind a bare `--`, so the CALLER must place
+ * this segment at the end of the argument list.
+ * @param filter - the query; blank entries are dropped, not turned into empty
+ *   patterns (an empty `--author=` would match nothing).
+ */
+export function logFilterArgs(filter) {
+    const users = filter.users.map(user => user.trim()).filter(user => user.length > 0);
+    const paths = filter.paths.map(path => path.trim()).filter(path => path.length > 0);
+    const text = filter.text.trim();
+    const after = filter.after.trim();
+    const before = filter.before.trim();
+    const args = [];
+    if (users.length > 0 || text.length > 0) {
+        args.push('-i', '-E');
+        for (const user of users)
+            args.push(`--author=${escapeEre(user)}`);
+        if (text.length > 0)
+            args.push(`--grep=${filter.textRegex ? text : escapeEre(text)}`);
+    }
+    if (after.length > 0)
+        args.push(`--since=${expandDay(after, false)}`);
+    if (before.length > 0)
+        args.push(`--until=${expandDay(before, true)}`);
+    if (paths.length > 0)
+        args.push('--', ...paths);
+    return args;
+}

package/lib/shortlog.js

@@ -0,0 +1,40 @@
+/**
+ * Author roster from `git shortlog -sne`, for the filter popup's user picker.
+ *
+ * The REF the roster walks is the caller's choice (the host passes the same
+ * ref the history list walks, or `--all` in All-branches mode); shortlog
+ * already did the aggregation, and this module only parses its fixed shape
+ * (`<count>  <name> <<email>>`), sorts by activity and applies the cap — with
+ * the cap VISIBLE, because a filter popup that silently lost the long tail of
+ * occasional committers would be quietly wrong about who exists.
+ *
+ * @module @young1lin/dsh-ui-gitworkbench/shortlog
+ */
+/**
+ * Parse shortlog output into busiest-first authors, capped.
+ * @param stdout - `git shortlog -sne <ref>` output (the ref is the caller's choice).
+ * @param limit - how many authors to keep; the busier half survives.
+ * @returns the roster and whether it was cut short.
+ */
+export function parseShortlog(stdout, limit) {
+    const authors = [];
+    for (const line of stdout.split('\n')) {
+        const match = /^\s*(\d+)\s+(.+)$/.exec(line);
+        if (match === null)
+            continue;
+        const count = Number(match[1]);
+        const who = match[2];
+        // The email is the LAST <...> on the line; a name may legally contain
+        // anything else.
+        const emailMatch = /<([^>]*)>\s*$/.exec(who);
+        if (emailMatch === null)
+            continue;
+        const name = who.slice(0, emailMatch.index).trim();
+        if (name.length === 0)
+            continue;
+        authors.push({ name, email: emailMatch[1], count });
+    }
+    authors.sort((a, b) => b.count - a.count);
+    const truncated = authors.length > limit;
+    return { authors: truncated ? authors.slice(0, limit) : authors, truncated };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@young1lin/dsh-ui-gitworkbench",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Out-of-tree dsh web UI plugin: a session-header git workbench chip opening a drawer with the file tree, per-file diff, history, compare, staging, commit, and sync (fetch/pull/push).",
   "type": "module",
   "main": "lib/index.js",