@unbrained/pm-web 2026.8.10 → 2026.8.17

package/public/src/i18n.ts

@@ -24,6 +24,8 @@ export const LOCALE_STORAGE_KEY = 'pmLocale';
 
 /** Locales shipped by this package. The first entry is the default/fallback. */
 export const SUPPORTED_LOCALES = ['en', 'de', 'es', 'zh'] as const;
+/** String literal union of every locale code this package ships a catalog
+ * for, derived from `SUPPORTED_LOCALES`. */
 export type SupportedLocale = (typeof SUPPORTED_LOCALES)[number];
 
 const DEFAULT_LOCALE: SupportedLocale = 'en';
@@ -166,7 +168,8 @@ export async function initI18n(): Promise<void> {
   applyTranslations();
 }
 
-/** Current active locale. */
+/** Return the locale currently selected for the session, set by `initI18n` or
+ * `setLocale`. Defaults to the English fallback before initialization. */
 export function getLocale(): SupportedLocale {
   return currentLocale;
 }
@@ -232,6 +235,10 @@ export function applyTranslations(root?: ParentNode): void {
   bindAttr(scope, '[data-i18n-aria]', 'data-i18n-aria', (el, v) => { el.setAttribute('aria-label', v); });
 }
 
+/** For every element in `scope` matching `selector`, read its `attr` data
+ * key, resolve the translation (with optional `data-i18n-params`
+ * substitutions), and pass the result to `setter`. Used to bind each
+ * `data-i18n*` flavor. */
 function bindAttr(
   scope: ParentNode,
   selector: string,
@@ -247,6 +254,8 @@ function bindAttr(
   });
 }
 
+/** Parse a `data-i18n-params` JSON string into a parameter object, returning
+ * `undefined` when the JSON is missing, malformed, or not a plain object. */
 function safeParseParams(json: string): Record<string, string | number> | undefined {
   try {
     const parsed = JSON.parse(json) as unknown;
@@ -274,6 +283,9 @@ export function translateError(message: string): string {
 // Lazy reverse map: English error text → catalog key. Built from enCatalog
 // so it tracks the catalog without a hand-maintained second table.
 let cachedErrorReverse: Map<string, string> | null = null;
+/** Build and cache a reverse lookup from English error text to its catalog
+ * key (covering only `error.*` entries), so server error strings can be
+ * mapped back to translatable keys at the display layer. */
 function errorReverseMap(): Map<string, string> {
   if (cachedErrorReverse) return cachedErrorReverse;
   const map = new Map<string, string>();

package/public/src/state.js

@@ -1,3 +1,6 @@
+/** Mutable singleton holding the SPA's global application state: the signed-in
+ * user, loaded projects, the active project and view, item list and filters,
+ * and search state. Views read and mutate this directly. */
 export const state = {
     user: null,
     projects: [],

package/public/src/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["state.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,KAAK,GAAa;IAC7B,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,EAAE;IACZ,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,UAAU;IACvB,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,EAAE;IACT,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;IACnG,WAAW,EAAE,EAAE;IACf,aAAa,EAAE,EAAE;IACjB,UAAU,EAAE,QAAQ;IACpB,SAAS,EAAE,CAAC;IACZ,MAAM,EAAE,IAAI;CACb,CAAC"}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["state.ts"],"names":[],"mappings":"AAKA;;4DAE4D;AAC5D,MAAM,CAAC,MAAM,KAAK,GAAa;IAC7B,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,EAAE;IACZ,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,UAAU;IACvB,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,EAAE;IACT,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;IACnG,WAAW,EAAE,EAAE;IACf,aAAa,EAAE,EAAE;IACjB,UAAU,EAAE,QAAQ;IACpB,SAAS,EAAE,CAAC;IACZ,MAAM,EAAE,IAAI;CACb,CAAC"}

package/public/src/state.ts

@@ -3,6 +3,9 @@
 // ═══════════════════════════════════════════════════════════════
 import type { AppState } from './types.js';
 
+/** Mutable singleton holding the SPA's global application state: the signed-in
+ * user, loaded projects, the active project and view, item list and filters,
+ * and search state. Views read and mutate this directly. */
 export const state: AppState = {
   user: null,
   projects: [],

package/public/src/sw.ts

@@ -127,6 +127,9 @@ interface SyncEvent extends ExtendableEvent {
   readonly tag: string;
 }
 
+/** Open (creating on first run) the IndexedDB database backing the offline
+ * mutation queue, ensuring the `mutations` object store and its timestamp
+ * index exist. Resolves with the ready database handle. */
 function openMutationDB(): Promise<IDBDatabase> {
   return new Promise((resolve, reject) => {
     const request = indexedDB.open(MUTATION_DB, 1);
@@ -185,18 +188,32 @@ async function queueMutation(method: string, path: string, body: unknown): Promi
   }
 }
 
-async function getQueuedMutations(): Promise<QueuedMutation[]> {
+/** The outcome of reading the mutation queue: either the mutations were read
+ * successfully, or the read failed and the queue state is unknown. The
+ * discriminator lets callers distinguish an empty queue from an unreadable
+ * one instead of collapsing both into `[]`. */
+type QueueReadResult =
+  | { ok: true; mutations: QueuedMutation[] }
+  | { ok: false; error: unknown };
+
+/** Read every queued mutation out of IndexedDB in insertion order. Returns
+ * `{ ok: true, mutations }` on success (including an empty array when the
+ * queue is genuinely empty) or `{ ok: false, error }` on storage failure so
+ * callers can distinguish an empty queue from an unreadable one instead of
+ * treating both as drained. */
+async function getQueuedMutations(): Promise<QueueReadResult> {
   try {
     const db = await openMutationDB();
     const tx = db.transaction(MUTATION_STORE, 'readonly');
     const store = tx.objectStore(MUTATION_STORE);
-    return await new Promise<QueuedMutation[]>((resolve, reject) => {
+    const mutations = await new Promise<QueuedMutation[]>((resolve, reject) => {
       const request = store.getAll();
       request.onsuccess = () => resolve(request.result as QueuedMutation[]);
       request.onerror = () => reject(request.error);
     });
-  } catch {
-    return [];
+    return { ok: true, mutations };
+  } catch (error) {
+    return { ok: false, error };
   }
 }
 
@@ -218,10 +235,22 @@ async function clearMutation(id: number): Promise<boolean> {
   }
 }
 
+/** Replay queued mutations to the API in order, removing each on success and
+ * stopping at the first failure so it can retry later, then post-message the
+ * connected clients with how many were replayed or remain. A storage read
+ * failure is never treated as a drained queue: the initial read failure
+ * aborts the flush, and a final read failure reports a partial result rather
+ * than claiming all mutations were replayed. */
 async function flushMutationQueue(): Promise<void> {
-  const mutations = await getQueuedMutations();
+  const read = await getQueuedMutations();
+  if (!read.ok) {
+    console.warn('Failed to read mutation queue:', read.error);
+    return;
+  }
+  const mutations = read.mutations;
   if (mutations.length === 0) return;
 
+  let replayed = 0;
   for (const mut of mutations) {
     try {
       const opts: RequestInit = {
@@ -238,6 +267,7 @@ async function flushMutationQueue(): Promise<void> {
           // avoid duplicate replays on the next flush; it will retry later.
           break;
         }
+        replayed++;
       } else {
         console.warn('Offline mutation failed:', mut.method, mut.path, res.status);
         // Stop processing on first failure — try again later
@@ -250,8 +280,25 @@ async function flushMutationQueue(): Promise<void> {
   }
 
   // Notify clients about replayed mutations
-  const remaining = await getQueuedMutations();
+  const remainingRead = await getQueuedMutations();
   const clients = await sw.clients.matchAll();
+  if (!remainingRead.ok) {
+    // Could not re-read the queue — do NOT claim all mutations were replayed.
+    // Report a partial result with the known replayed count so unreplayed
+    // mutations are not treated as drained.
+    console.warn('Failed to re-read mutation queue after replay:', remainingRead.error);
+    if (mutations.length > 0) {
+      clients.forEach((client) => {
+        client.postMessage({
+          type: 'MUTATIONS_PARTIAL',
+          replayed,
+          remaining: mutations.length - replayed,
+        });
+      });
+    }
+    return;
+  }
+  const remaining = remainingRead.mutations;
   if (remaining.length === 0 && mutations.length > 0) {
     clients.forEach((client) => {
       client.postMessage({ type: 'MUTATIONS_REPLAYED', count: mutations.length });
@@ -445,4 +492,21 @@ sw.addEventListener('sync', (event: Event) => {
 // ── Online event: flush queue when connectivity returns ──
 sw.addEventListener('online', () => {
   void flushMutationQueue();
-});
+});
+
+// ── Test-only: expose queue internals ──
+// app.ts registers this file as a CLASSIC worker (`register('/sw.js', ...)`
+// with no `type: 'module'`), so it cannot use `export` — a module-mode script
+// fails to load under a classic registration, which would take offline support
+// down. That leaves a global as the only seam a test can reach.
+//
+// It is inert in the browser because a classic service worker is the only
+// script that ever runs in its own global scope: no page script, extension or
+// import shares it, so nothing exists that could set the flag before this line
+// executes. That invariant is the registration mode, not the flag name — if
+// app.ts ever registers with `type: 'module'`, replace this with real exports
+// rather than keeping both.
+const __testGlobals = globalThis as unknown as Record<string, unknown>;
+if (__testGlobals.__swTestHarness) {
+  __testGlobals.__swInternals = { getQueuedMutations, flushMutationQueue, queueMutation, clearMutation };
+}

package/public/src/theme.js

@@ -20,6 +20,9 @@ const LABEL = {
     light: 'Theme: light',
     dark: 'Theme: dark',
 };
+/** Read the persisted theme choice from localStorage, defaulting to `auto`
+ * when no preference is stored or when localStorage is unavailable (e.g.
+ * private browsing). */
 export function getStoredTheme() {
     try {
         const v = localStorage.getItem(STORAGE_KEY);
@@ -29,6 +32,9 @@ export function getStoredTheme() {
     catch { /* localStorage may be unavailable (private mode) */ }
     return 'auto';
 }
+/** Apply a theme to the page: set `data-theme` on `<html>`, update the toggle
+ * button's glyph/title, and sync the `<meta name="theme-color">` tag so the
+ * mobile browser chrome matches the chosen palette. */
 export function applyTheme(theme) {
     document.documentElement.setAttribute('data-theme', theme);
     const btn = document.getElementById('theme-toggle');
@@ -50,6 +56,8 @@ export function applyTheme(theme) {
         meta.setAttribute('content', color);
     }
 }
+/** Persist a theme choice to localStorage and immediately apply it to the
+ * document. */
 export function setTheme(theme) {
     try {
         localStorage.setItem(STORAGE_KEY, theme);
@@ -57,12 +65,16 @@ export function setTheme(theme) {
     catch { /* ignore */ }
     applyTheme(theme);
 }
+/** Advance to the next theme in the auto → light → dark order (wrapping
+ * around) and persist plus apply the new selection. */
 export function cycleTheme() {
     const current = getStoredTheme();
     const next = ORDER[(ORDER.indexOf(current) + 1) % ORDER.length];
     setTheme(next);
 }
-// Apply the persisted (or default) theme as early as possible.
+/** Apply the persisted (or default) theme early to avoid a flash of the wrong
+ * palette, then register a listener so `auto` mode tracks live OS theme
+ * changes. */
 export function initTheme() {
     applyTheme(getStoredTheme());
     // When in auto mode, react to live OS theme changes.

package/public/src/theme.js.map

@@ -1 +1 @@
-{"version":3,"file":"theme.js","sourceRoot":"","sources":["theme.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["theme.ts"],"names":[],"mappings":"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"}

package/public/src/theme.ts

@@ -8,6 +8,8 @@
 // preference) is "auto", matching the data-theme="auto" attribute in the HTML
 // shell so there is no flash of the wrong theme on load.
 
+/** The user-selectable theme modes: an explicit `dark` or `light`, or `auto`
+ * which follows the OS `prefers-color-scheme` setting. */
 export type Theme = 'dark' | 'light' | 'auto';
 
 const STORAGE_KEY = 'pm-web-theme';
@@ -26,6 +28,9 @@ const LABEL: Record<Theme, string> = {
   dark: 'Theme: dark',
 };
 
+/** Read the persisted theme choice from localStorage, defaulting to `auto`
+ * when no preference is stored or when localStorage is unavailable (e.g.
+ * private browsing). */
 export function getStoredTheme(): Theme {
   try {
     const v = localStorage.getItem(STORAGE_KEY);
@@ -34,6 +39,9 @@ export function getStoredTheme(): Theme {
   return 'auto';
 }
 
+/** Apply a theme to the page: set `data-theme` on `<html>`, update the toggle
+ * button's glyph/title, and sync the `<meta name="theme-color">` tag so the
+ * mobile browser chrome matches the chosen palette. */
 export function applyTheme(theme: Theme): void {
   document.documentElement.setAttribute('data-theme', theme);
   const btn = document.getElementById('theme-toggle');
@@ -54,18 +62,24 @@ export function applyTheme(theme: Theme): void {
   }
 }
 
+/** Persist a theme choice to localStorage and immediately apply it to the
+ * document. */
 export function setTheme(theme: Theme): void {
   try { localStorage.setItem(STORAGE_KEY, theme); } catch { /* ignore */ }
   applyTheme(theme);
 }
 
+/** Advance to the next theme in the auto → light → dark order (wrapping
+ * around) and persist plus apply the new selection. */
 export function cycleTheme(): void {
   const current = getStoredTheme();
   const next = ORDER[(ORDER.indexOf(current) + 1) % ORDER.length];
   setTheme(next);
 }
 
-// Apply the persisted (or default) theme as early as possible.
+/** Apply the persisted (or default) theme early to avoid a flash of the wrong
+ * palette, then register a listener so `auto` mode tracks live OS theme
+ * changes. */
 export function initTheme(): void {
   applyTheme(getStoredTheme());
   // When in auto mode, react to live OS theme changes.

package/public/src/types.ts

@@ -2,6 +2,7 @@
 // TYPES
 // ═══════════════════════════════════════════════════════════════
 
+/** The signed-in application user, as returned by the auth/session endpoints. */
 export interface User {
   id: string;
   email: string;
@@ -255,6 +256,7 @@ export interface AdminGroup {
 
 export type ToastType = 'info' | 'success' | 'error';
 
+/** Union of every navigation view key the SPA router can display. */
 export type ViewName =
   | 'projects' | 'items' | 'create' | 'activity' | 'search'
   | 'stats' | 'calendar' | 'context' | 'graph' | 'sharing' | 'groups'

package/public/src/utils.js

@@ -2,23 +2,41 @@
 // UTILITIES
 // ═══════════════════════════════════════════════════════════════
 import { PRIORITY_LABELS, TYPE_ICONS } from './constants.js';
+/** Escape `&`, `<`, `>` and `"` so a value can be inserted into HTML text or a
+ * double-quoted attribute. Falsy input yields an empty string.
+ *
+ * NOT sufficient for a JavaScript context. It does not escape `'`, and even if
+ * it did, the browser HTML-decodes an attribute value before the JS parser sees
+ * it, so an entity cannot keep a quote from terminating a string literal. A
+ * value interpolated into an inline handler — `onclick="fn('${escHtml(x)}')"` —
+ * is therefore still injectable. Pass such values through a `data-*` attribute
+ * and bind with `addEventListener` instead. */
 export function escHtml(s) {
     if (!s)
         return '';
     return String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
 }
+/** Build a colored status-badge span for an item status, mapping the
+ * `in_progress` code to "In Progress" and CSS-classifying the rest by slug. */
 export function statusBadge(s) {
     const labels = { in_progress: 'In Progress' };
     const status = String(s || 'unknown');
     const classSuffix = status.toLowerCase().replace(/[^a-z0-9_-]+/g, '-').replace(/^-+|-+$/g, '') || 'unknown';
     return `<span class="status-badge status-${classSuffix}">${escHtml(labels[status] || status)}</span>`;
 }
+/** Render a priority indicator span (P0–P4) whose color class and tooltip
+ * label come from the PRIORITY_LABELS lookup table. */
 export function priorityDot(p) {
     return `<span class="priority-dot priority-${p}" title="P${p}: ${PRIORITY_LABELS[p] || ''}"></span>`;
 }
+/** Render an item-type glyph span using the TYPE_ICONS map, falling back to
+ * the middle-dot character when the type has no assigned icon. */
 export function typeIcon(t) {
-    return `<span class="item-type-icon" title="${t}">${TYPE_ICONS[t] || '·'}</span>`;
+    return `<span class="item-type-icon" title="${escHtml(t)}">${TYPE_ICONS[t] || '·'}</span>`;
 }
+/** Format a timestamp as a short relative phrase ("just now", "5m ago",
+ * "3h ago", "2d ago") or, past a week, a localized calendar date. Falsy or
+ * unparseable input returns an empty string. */
 export function relTime(ts) {
     if (!ts)
         return '';
@@ -35,11 +53,16 @@ export function relTime(ts) {
         return `${Math.floor(s / 86400)}d ago`;
     return d.toLocaleDateString();
 }
+/** Format a timestamp as a US-style short date (e.g. "Jan 5, 2026"). Falsy
+ * input returns an empty string. */
 export function fmtDate(ts) {
     if (!ts)
         return '';
     return new Date(ts).toLocaleDateString('en-US', { year: 'numeric', month: 'short', day: 'numeric' });
 }
+/** Toggle a button's disabled state and, when `text` is supplied, update the
+ * button label — replacing the first inner span when present, otherwise the
+ * whole text content. */
 export function setLoading(btn, yes, text) {
     btn.disabled = yes;
     if (text) {
@@ -50,9 +73,11 @@ export function setLoading(btn, yes, text) {
             btn.textContent = text;
     }
 }
+/** Build an HTML string of `n` placeholder skeleton rows for loading states. */
 export function skeletonRows(n = 5) {
     return Array.from({ length: n }, () => '<div class="skeleton skeleton-row"></div>').join('');
 }
+/** Build an HTML string of `n` placeholder skeleton cards for loading states. */
 export function skeletonCards(n = 3) {
     return Array.from({ length: n }, () => '<div class="skeleton skeleton-card"></div>').join('');
 }

package/public/src/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["utils.ts"],"names":[],"mappings":"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"}

package/public/src/utils.ts

@@ -3,11 +3,22 @@
 // ═══════════════════════════════════════════════════════════════
 import { PRIORITY_LABELS, TYPE_ICONS } from './constants.js';
 
+/** Escape `&`, `<`, `>` and `"` so a value can be inserted into HTML text or a
+ * double-quoted attribute. Falsy input yields an empty string.
+ *
+ * NOT sufficient for a JavaScript context. It does not escape `'`, and even if
+ * it did, the browser HTML-decodes an attribute value before the JS parser sees
+ * it, so an entity cannot keep a quote from terminating a string literal. A
+ * value interpolated into an inline handler — `onclick="fn('${escHtml(x)}')"` —
+ * is therefore still injectable. Pass such values through a `data-*` attribute
+ * and bind with `addEventListener` instead. */
 export function escHtml(s: string | undefined | null): string {
   if (!s) return '';
   return String(s).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;');
 }
 
+/** Build a colored status-badge span for an item status, mapping the
+ * `in_progress` code to "In Progress" and CSS-classifying the rest by slug. */
 export function statusBadge(s: string): string {
   const labels: Record<string, string> = { in_progress: 'In Progress' };
   const status = String(s || 'unknown');
@@ -15,14 +26,21 @@ export function statusBadge(s: string): string {
   return `<span class="status-badge status-${classSuffix}">${escHtml(labels[status] || status)}</span>`;
 }
 
+/** Render a priority indicator span (P0–P4) whose color class and tooltip
+ * label come from the PRIORITY_LABELS lookup table. */
 export function priorityDot(p: number): string {
   return `<span class="priority-dot priority-${p}" title="P${p}: ${PRIORITY_LABELS[p]||''}"></span>`;
 }
 
+/** Render an item-type glyph span using the TYPE_ICONS map, falling back to
+ * the middle-dot character when the type has no assigned icon. */
 export function typeIcon(t: string): string {
-  return `<span class="item-type-icon" title="${t}">${TYPE_ICONS[t]||'·'}</span>`;
+  return `<span class="item-type-icon" title="${escHtml(t)}">${TYPE_ICONS[t]||'·'}</span>`;
 }
 
+/** Format a timestamp as a short relative phrase ("just now", "5m ago",
+ * "3h ago", "2d ago") or, past a week, a localized calendar date. Falsy or
+ * unparseable input returns an empty string. */
 export function relTime(ts: string | undefined | null): string {
   if (!ts) return '';
   const d = new Date(ts);
@@ -35,11 +53,16 @@ export function relTime(ts: string | undefined | null): string {
   return d.toLocaleDateString();
 }
 
+/** Format a timestamp as a US-style short date (e.g. "Jan 5, 2026"). Falsy
+ * input returns an empty string. */
 export function fmtDate(ts: string | undefined | null): string {
   if (!ts) return '';
   return new Date(ts).toLocaleDateString('en-US', { year:'numeric', month:'short', day:'numeric' });
 }
 
+/** Toggle a button's disabled state and, when `text` is supplied, update the
+ * button label — replacing the first inner span when present, otherwise the
+ * whole text content. */
 export function setLoading(btn: HTMLButtonElement, yes: boolean, text?: string): void {
   btn.disabled = yes;
   if (text) {
@@ -49,10 +72,12 @@ export function setLoading(btn: HTMLButtonElement, yes: boolean, text?: string):
   }
 }
 
+/** Build an HTML string of `n` placeholder skeleton rows for loading states. */
 export function skeletonRows(n = 5): string {
   return Array.from({length: n}, () => '<div class="skeleton skeleton-row"></div>').join('');
 }
 
+/** Build an HTML string of `n` placeholder skeleton cards for loading states. */
 export function skeletonCards(n = 3): string {
   return Array.from({length: n}, () => '<div class="skeleton skeleton-card"></div>').join('');
 }

package/public/src/views/activity.js

@@ -5,6 +5,7 @@ import { state } from '../state.js';
 import { api } from '../api.js';
 import { escHtml, relTime } from '../utils.js';
 import { TYPE_ICONS } from '../constants.js';
+/** Renders the activity feed for the current project, listing recent changes with their type icon, a description or fallback, and a relative timestamp. */
 export async function renderActivityView() {
     const el = document.getElementById('content-activity');
     if (!el)

package/public/src/views/activity.js.map

@@ -1 +1 @@
-{"version":3,"file":"activity.js","sourceRoot":"","sources":["activity.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,gBAAgB;AAChB,kEAAkE;AAClE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,EAAE,GAAG,QAAQ,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;IACvD,IAAI,CAAC,EAAE;QAAE,OAAO;IAChB,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QAAC,EAAE,CAAC,SAAS,GAAG,wFAAwF,CAAC;QAAC,OAAO;IAAC,CAAC;IAC/I,EAAE,CAAC,SAAS,GAAG;;gGAE+E,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC;;;iJAGe,CAAC;IAEhJ,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAmB,KAAK,EAAC,aAAa,KAAK,CAAC,cAAc,CAAC,EAAE,uBAAuB,CAAC,CAAC;QAC5G,MAAM,KAAK,GAAoB,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QACjE,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,SAAS,GAAG,yHAAyH,CAAC;YAC7I,OAAO;QACT,CAAC;QACD,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAC,EAAE,CAAA;;qCAED,UAAU,CAAC,CAAC,CAAC,IAAI,IAAE,EAAE,CAAC,IAAE,GAAG;;uCAEzB,OAAO,CAAC,CAAC,CAAC,OAAO,IAAE,CAAC,CAAC,KAAK,IAAE,CAAC,CAAC,MAAM,IAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;uCACxD,OAAO,CAAC,CAAC,CAAC,SAAS,IAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAA,CAAC,CAAA,+CAA+C,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAA,CAAC,CAAA,EAAE;;aAE7I,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC;IAAC,OAAM,GAAY,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QACxD,IAAI,MAAM;YAAE,MAAM,CAAC,SAAS,GAAG,iEAAiE,OAAO,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC;IAC1K,CAAC;AACH,CAAC"}
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["activity.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,gBAAgB;AAChB,kEAAkE;AAClE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,2JAA2J;AAC3J,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,EAAE,GAAG,QAAQ,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;IACvD,IAAI,CAAC,EAAE;QAAE,OAAO;IAChB,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QAAC,EAAE,CAAC,SAAS,GAAG,wFAAwF,CAAC;QAAC,OAAO;IAAC,CAAC;IAC/I,EAAE,CAAC,SAAS,GAAG;;gGAE+E,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC;;;iJAGe,CAAC;IAEhJ,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAmB,KAAK,EAAC,aAAa,KAAK,CAAC,cAAc,CAAC,EAAE,uBAAuB,CAAC,CAAC;QAC5G,MAAM,KAAK,GAAoB,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QACjE,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,SAAS,GAAG,yHAAyH,CAAC;YAC7I,OAAO;QACT,CAAC;QACD,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAC,EAAE,CAAA;;qCAED,UAAU,CAAC,CAAC,CAAC,IAAI,IAAE,EAAE,CAAC,IAAE,GAAG;;uCAEzB,OAAO,CAAC,CAAC,CAAC,OAAO,IAAE,CAAC,CAAC,KAAK,IAAE,CAAC,CAAC,MAAM,IAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;uCACxD,OAAO,CAAC,CAAC,CAAC,SAAS,IAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAA,CAAC,CAAA,+CAA+C,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAA,CAAC,CAAA,EAAE;;aAE7I,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC;IAAC,OAAM,GAAY,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QACxD,IAAI,MAAM;YAAE,MAAM,CAAC,SAAS,GAAG,iEAAiE,OAAO,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC;IAC1K,CAAC;AACH,CAAC"}

package/public/src/views/activity.ts

@@ -7,6 +7,7 @@ import { escHtml, relTime } from '../utils.js';
 import { TYPE_ICONS } from '../constants.js';
 import type { ActivityEntry, ActivityResponse } from '../api-types.js';
 
+/** Renders the activity feed for the current project, listing recent changes with their type icon, a description or fallback, and a relative timestamp. */
 export async function renderActivityView(): Promise<void> {
   const el = document.getElementById('content-activity');
   if (!el) return;