anentrypoint-design 0.0.324 → 0.0.326

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anentrypoint-design",
-  "version": "0.0.324",
+  "version": "0.0.326",
   "description": "247420 design system SDK — webjsx + modified ripple-ui, single-file ESM bundle for reproducible use of the AnEntrypoint design.",
   "type": "module",
   "main": "./dist/247420.js",
@@ -57,11 +57,17 @@
     "./components/files-modals.js": "./src/components/files-modals.js",
     "./web-components/ds-chat.js": "./src/web-components/ds-chat.js",
     "./web-components/freddie-chat.js": "./src/web-components/freddie-chat.js",
+    "./lint": {
+      "import": "./src/lint.js",
+      "default": "./src/lint.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
     "dist",
     "src",
+    "scripts/lint-glyphs.mjs",
+    "scripts/lint-null-children.mjs",
     "vendor/webjsx",
     "colors_and_type.css",
     "app-shell.css",

package/scripts/lint-glyphs.mjs

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+// Decorative-glyph guard: fail the build if any source file hard-codes a
+// decorative unicode glyph (arrows, bullets, checks, stars, status dots, etc.).
+// The design system bans these — chrome must read as one coherent line-icon set
+// (the Icon() SVG component) or industry-standard ASCII, never machine-shaped
+// ornament. This is the durable companion to lint-tokens.mjs: without it, the
+// next hand-edit silently re-introduces a glyph the sweep removed.
+//
+// Run standalone (`node scripts/lint-glyphs.mjs`) or as part of build.mjs.
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const root = path.resolve(__dirname, '..');
+
+// Directories scanned recursively for source files. dist/ is generated,
+// node_modules/ is vendored, vendor/ is third-party (webjsx), .gm/ is the
+// plugkit spool — none are hand-authored design surfaces.
+const SCAN_DIRS = ['src', 'ui_kits', 'slides', 'site'];
+const SCAN_EXT = new Set(['.js', '.mjs', '.css', '.html']);
+// The bundled root CSS files (app-shell.css, chat.css, etc.) are the design
+// system's shipped styling but live at the repo root, outside SCAN_DIRS — they
+// previously escaped the glyph lint entirely (box-drawing comment dividers
+// slipped through). Scan them explicitly so a decorative glyph in shipped CSS
+// fails the build.
+const SCAN_ROOT_FILES = [
+    'app-shell.css', 'chat.css', 'colors_and_type.css', 'community.css',
+    'community-app.css', 'editor-primitives.css', 'app-surfaces.css',
+    'marketing.css',
+];
+
+// Files that are DELIBERATE glyph showcases or documentation of the unicode
+// surface itself — exempt wholesale.
+const EXEMPT_FILES = new Set([
+    'preview/icons-unicode.html', // a deliberate catalog of unicode icons
+]);
+
+// The banned decorative-glyph class. NOT included (intentionally allowed):
+//   ⌘ ⇧ ⌥ ⌃ ⇪ ⏎ ⌫ (Mac/keyboard key symbols — industry-standard, not decorative)
+//   · (middle-dot separator), — (em-dash), … (ellipsis), › ‹ » « (text seps left to authors)
+//   functional JS operators (=>, ??, ?., >=, <=) — those are ASCII, never matched here
+const GLYPH_RE = /[●○◆◉◈▸▾▴◀▶★☆✓✗✕✖✔⟶⇒•◦‣◔↓↑→←⏸⏭ℹ⚠⚒◈▷▭▰◎◐▢↗◌▤▦♪§◫⊞❖✷✢⟳↻↺⥁⟲⌛⏳♻]/;
+
+// Per-file allowlist: a line is exempt if it contains the substring AND the
+// file matches. Keep tiny and audited.
+const ALLOW = {
+    // (currently none — the sweep left zero intentional decorative glyphs)
+};
+
+function isAllowed(rel, line) {
+    const list = ALLOW[rel] || [];
+    return list.some((s) => line.includes(s));
+}
+
+function walk(dir, acc) {
+    let entries;
+    try { entries = fs.readdirSync(dir, { withFileTypes: true }); }
+    catch { return acc; }
+    for (const e of entries) {
+        const full = path.join(dir, e.name);
+        if (e.isDirectory()) walk(full, acc);
+        else if (SCAN_EXT.has(path.extname(e.name))) acc.push(full);
+    }
+    return acc;
+}
+
+// Returns the array of violation strings (empty == clean). Pure; no exit/log.
+export function findGlyphViolations() {
+    const violations = [];
+    const files = [];
+    for (const d of SCAN_DIRS) walk(path.join(root, d), files);
+    for (const f of SCAN_ROOT_FILES) { const p = path.join(root, f); if (fs.existsSync(p)) files.push(p); }
+    for (const file of files) {
+        const rel = path.relative(root, file).split(path.sep).join('/');
+        if (EXEMPT_FILES.has(rel)) continue;
+        const src = fs.readFileSync(file, 'utf8');
+        src.split(/\r?\n/).forEach((line, i) => {
+            if (GLYPH_RE.test(line) && !isAllowed(rel, line)) {
+                violations.push(`${rel}:${i + 1}: ${line.trim().slice(0, 100)}`);
+            }
+        });
+    }
+    return violations;
+}
+
+// Throws on violation; build.mjs calls this so a regression fails the build
+// even under runners (flatspace) that skip npm lifecycle hooks.
+export function lintGlyphsOrThrow() {
+    const violations = findGlyphViolations();
+    if (violations.length) {
+        const msg = '[lint-glyphs] FAIL — decorative unicode glyphs in source '
+            + '(use the Icon() SVG component or industry-standard ASCII like -> [x] *):\n  '
+            + violations.join('\n  ')
+            + `\n[lint-glyphs] ${violations.length} violation(s). If a glyph is a genuine product-design icon, route it through Icon() or add the file to EXEMPT_FILES / the audited ALLOW list in scripts/lint-glyphs.mjs.`;
+        throw new Error(msg);
+    }
+    console.log('[lint-glyphs] OK — no decorative glyphs in ' + SCAN_DIRS.join('/') + ' (all icons via Icon()/ASCII).');
+}
+
+// CLI entry: `node scripts/lint-glyphs.mjs`.
+if (process.argv[1] && process.argv[1].endsWith('lint-glyphs.mjs')) {
+    try { lintGlyphsOrThrow(); }
+    catch (e) { console.error(e.message); process.exit(1); }
+}

package/scripts/lint-null-children.mjs

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+// Null-children guard: webjsx applyDiff crashes ("Cannot read properties of
+// undefined (reading 'key')") when a bare null sits among VElement siblings in
+// a children array. The kit discipline is to .filter(Boolean) every children
+// array that contains a conditional vnode — this lint makes the discipline
+// durable instead of comment-maintained (two live crashes are on record: the
+// agentgui 4th and 10th runs).
+//
+// Detection (kept narrow to avoid prop-object false positives): every
+// top-level array literal is bracket-matched; it is flagged iff
+//   (a) an ELEMENT-level member starts a vnode call (`h(` or `Component(`), AND
+//   (b) an ELEMENT-level member token is `? null` / `: null` (conditional child), AND
+//   (c) the closing `]` is not followed (whitespace-tolerant) by `.filter(`.
+// Element-level means at the bracket depth of the array itself, so
+// `{ tabindex: disabled ? '-1' : null }` props never match.
+//
+// Run standalone (`node scripts/lint-null-children.mjs`) or via build.mjs.
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const root = path.resolve(__dirname, '..');
+const SCAN_DIRS = ['src'];
+const SCAN_EXT = new Set(['.js', '.mjs']);
+
+// Per-file allowlist of line numbers or substrings audited as safe.
+const ALLOW = {};
+
+function* walk(dir) {
+  for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+    const p = path.join(dir, e.name);
+    if (e.isDirectory()) {
+      if (e.name === 'node_modules' || e.name === 'vendor') continue;
+      yield* walk(p);
+    } else if (SCAN_EXT.has(path.extname(e.name))) yield p;
+  }
+}
+
+// Blanks out `//` line-comment content (replacing with spaces, keeping
+// newlines and length so reported line numbers stay accurate) before the
+// bracket-matching pass below. Without this, an apostrophe inside ANY
+// comment anywhere in the file (e.g. "the kit's own") is read as opening a
+// string literal by the naive scanner, silently corrupting bracket-depth
+// tracking for the rest of the file - a false positive here, or worse, a
+// false NEGATIVE that hides a real missing .filter(Boolean) elsewhere.
+// Comments living inside actual string/template literals (rare, but a `//`
+// can appear in a URL string) are left alone via the same inStr tracking.
+function stripLineComments(src) {
+  const out = src.split('');
+  let inStr = null;
+  for (let i = 0; i < out.length; i++) {
+    const c = out[i];
+    if (inStr) {
+      if (c === '\\') { i++; continue; }
+      if (c === inStr) inStr = null;
+      continue;
+    }
+    if (c === "'" || c === '"' || c === '`') { inStr = c; continue; }
+    if (c === '/' && out[i + 1] === '/') {
+      let j = i;
+      while (j < out.length && out[j] !== '\n') out[j++] = ' ';
+      i = j - 1;
+    }
+  }
+  return out.join('');
+}
+
+function findViolations(src) {
+  const scan = stripLineComments(src);
+  const out = [];
+  for (let i = 0; i < scan.length; i++) {
+    if (scan[i] !== '[') continue;
+    // bracket-match this array literal, tracking element-level segments
+    let depth = 0, j = i, inStr = null, elemStart = i + 1;
+    const elems = [];
+    for (; j < scan.length; j++) {
+      const c = scan[j];
+      if (inStr) {
+        if (c === '\\') j++;
+        else if (c === inStr) inStr = null;
+        continue;
+      }
+      if (c === "'" || c === '"' || c === '`') { inStr = c; continue; }
+      if (c === '[' || c === '(' || c === '{') depth++;
+      else if (c === ']' || c === ')' || c === '}') {
+        depth--;
+        if (depth === 0 && c === ']') { elems.push(scan.slice(elemStart, j)); break; }
+      } else if (c === ',' && depth === 1) { elems.push(scan.slice(elemStart, j)); elemStart = j + 1; }
+    }
+    if (j >= scan.length) continue;
+    const after = scan.slice(j + 1, j + 24);
+    if (/^\s*\.filter\(/.test(after)) continue;
+    const hasVnode = elems.some((e) => /(^|\s|\(|,)(h\(|[A-Z][A-Za-z0-9]*\()/.test(e.trim()));
+    // conditional-child tail: the ELEMENT itself ends in `: null` or `? ... : null`
+    const hasCondNull = elems.some((e) => /[?:]\s*null\s*$/.test(e.trim()));
+    if (hasVnode && hasCondNull) {
+      const line = src.slice(0, i).split('\n').length;
+      out.push(line);
+      i = j; // skip past this array
+    }
+  }
+  return out;
+}
+
+export function lintNullChildrenOrThrow() {
+  const failures = [];
+  for (const dir of SCAN_DIRS) {
+    const abs = path.join(root, dir);
+    if (!fs.existsSync(abs)) continue;
+    for (const file of walk(abs)) {
+      const rel = path.relative(root, file);
+      const src = fs.readFileSync(file, 'utf8');
+      const allow = ALLOW[rel] || [];
+      for (const line of findViolations(src)) {
+        if (allow.includes(line)) continue;
+        failures.push(rel + ':' + line);
+      }
+    }
+  }
+  if (failures.length) {
+    throw new Error('[lint-null-children] conditional null among vnode siblings without .filter(Boolean):\n  ' + failures.join('\n  '));
+  }
+  console.log('[lint-null-children] OK — every conditional-children array is filter(Boolean)\'d.');
+}
+
+if (import.meta.url === 'file://' + process.argv[1] || process.argv[1]?.endsWith('lint-null-children.mjs')) {
+  lintNullChildrenOrThrow();
+}

package/src/community-app.js

@@ -214,8 +214,8 @@ export function mountCommunityApp(root, adapter = {}) {
             ),
             // overlays
             ctx.open ? ContextMenu({ items: ctx.items, anchor: { x: ctx.x, y: ctx.y }, onClose: () => { ctx = { ...ctx, open: false }; render(); } }) : null,
-            emoji.open ? EmojiPicker({ open: true, anchorX: emoji.x, anchorY: emoji.y, onSelect: (em) => { try { emoji.onSelect && emoji.onSelect(em); } catch (_) {} emoji = { ...emoji, open: false }; render(); }, onClose: () => { emoji = { ...emoji, open: false }; render(); } }) : null,
-            palette.open ? CommandPalette({ open: true, items: palette.items, onSelect: (it) => { try { palette.onSelect && palette.onSelect(it); } catch (_) {} palette = { ...palette, open: false }; render(); }, onClose: () => { palette = { ...palette, open: false }; render(); } }) : null,
+            emoji.open ? EmojiPicker({ open: true, anchorX: emoji.x, anchorY: emoji.y, onSelect: (em) => { try { emoji.onSelect && emoji.onSelect(em); } catch (_) { /* swallow: consumer onSelect callback must not break overlay close/re-render */ } emoji = { ...emoji, open: false }; render(); }, onClose: () => { emoji = { ...emoji, open: false }; render(); } }) : null,
+            palette.open ? CommandPalette({ open: true, items: palette.items, onSelect: (it) => { try { palette.onSelect && palette.onSelect(it); } catch (_) { /* swallow: consumer onSelect callback must not break overlay close/re-render */ } palette = { ...palette, open: false }; render(); }, onClose: () => { palette = { ...palette, open: false }; render(); } }) : null,
             // global overlays (visibility driven by adapter snapshot)
             s.showAuthModal ? AuthModal({ open: true, mode: s.authMode || 'extension', error: s.authError || '', busy: !!s.authBusy, onModeChange: (m) => A.setAuthMode && A.setAuthMode(m), onConnectExtension: () => A.authExtension && A.authExtension(), onGenerate: () => A.authGenerate && A.authGenerate(), onImport: (k) => A.authImport && A.authImport(k), onClose: () => A.closeAuth && A.closeAuth() }) : null,
             BootOverlay({ progress: s.bootProgress || 0, phase: s.bootPhase || '', errored: !!s.bootErrored, visible: !!s.bootVisible }),
@@ -255,5 +255,5 @@ export function mountCommunityApp(root, adapter = {}) {
     });
 
     render();
-    return { render, api, destroy: () => { if (unsub) try { unsub(); } catch (_) {} } };
+    return { render, api, destroy: () => { if (unsub) try { unsub(); } catch (_) { /* swallow: unsubscribe failure during teardown is non-fatal */ } } };
 }

package/src/components/chat-message-parts.js

@@ -20,6 +20,7 @@ import { renderMarkdownCached, highlightCodeBlockCached } from '../markdown-cach
 import { isDegraded as isMarkdownDegraded } from '../markdown.js';
 import { Icon } from './shell.js';
 import { fmtFileSize } from './files.js';
+import { t } from '../i18n.js';
 
 const h = webjsx.createElement;
 
@@ -84,7 +85,7 @@ export function copyToClipboardWithFeedback(text, btn) {
         setTimeout(() => { btn.textContent = 'copy'; btn.classList.remove('is-copied'); }, 1600);
     };
     if (navigator.clipboard && navigator.clipboard.writeText) navigator.clipboard.writeText(text).then(done).catch(() => {});
-    else { try { const t = document.createElement('textarea'); t.value = text; document.body.appendChild(t); t.select(); document.execCommand('copy'); document.body.removeChild(t); done(); } catch {} }
+    else { try { const t = document.createElement('textarea'); t.value = text; document.body.appendChild(t); t.select(); document.execCommand('copy'); document.body.removeChild(t); done(); } catch { /* swallow: legacy execCommand copy fallback unsupported, nothing more to try */ } }
 }
 
 // Inject a per-block copy button into every <pre> inside a rendered-markdown
@@ -270,13 +271,13 @@ function ToolCallNode(p) {
 function ThinkingNode(p) {
     if (p.settled) {
         return h('details', { class: 'chat-bubble chat-thinking-settled' },
-            h('summary', {}, 'View thinking'),
+            h('summary', {}, t('chat.viewThinking', 'View thinking')),
             h('div', { class: 'chat-thinking-body' }, p.text)
         );
     }
     return h('div', { class: 'chat-bubble chat-thinking', role: 'status', 'aria-live': 'polite' },
         h('span', { class: 'chat-thinking-dots', 'aria-hidden': 'true' }, h('span'), h('span'), h('span')),
-        h('span', { class: 'chat-thinking-text' }, p.text || 'thinking…')
+        h('span', { class: 'chat-thinking-text' }, p.text || t('chat.thinking', 'thinking…'))
     );
 }
 

package/src/components/chat.js

@@ -8,6 +8,7 @@ import { register } from '../debug.js';
 import { Icon } from './shell.js';
 import { fmtFileSize } from './files.js';
 import { EmojiPicker } from './overlay-primitives.js';
+import { t } from '../i18n.js';
 import { renderMessagePart as sharedRenderMessagePart, safeUrl as sharedSafeUrl, renderInline as sharedRenderInline, injectCodeCopy as sharedInjectCodeCopy } from './chat-message-parts.js';
 
 // Matches a trailing `:keyword` at the end of the composer draft (optionally
@@ -191,7 +192,7 @@ export function ChatMessage({ role, who = 'them', avatar, text, parts, time, typ
     // Flat layout leads the turn with a small role label (You / agent name)
     // above the content, the way claude.ai/code titles each turn.
     const roleLabel = isFlat
-        ? h('div', { class: 'chat-role', key: '_role' }, resolvedWho === 'you' ? 'You' : (name || 'Assistant'))
+        ? h('div', { class: 'chat-role', key: '_role' }, resolvedWho === 'you' ? t('chat.roleYou', 'You') : (name || t('chat.roleAssistant', 'Assistant')))
         : null;
     const stack = h('div', { class: 'chat-stack' }, roleLabel, ...bodyNodes, reactionRow, actionRow, meta);
     // Centered roles (system/tool/thinking) skip the avatar column entirely so
@@ -263,7 +264,7 @@ export function ChatComposer({ value, onInput, onSend, onEmoji, onCancel, busy,
                     sessionStorage.setItem('ds.composer.undoNoteShown', '1');
                     flashComposerNote(taEl.closest('.chat-composer'), 'inserted — undo history does not include this insert');
                 }
-            } catch { /* sessionStorage unavailable (private mode etc) — skip the note */ }
+            } catch { /* swallow: sessionStorage unavailable (private mode etc) — skip the note */ }
             taEl.value = next;
             taEl.focus();
             taEl.selectionStart = taEl.selectionEnd = next.length;
@@ -443,8 +444,8 @@ export function Chat({ title = 'chat', sub, messages = [], composer, header, sug
         h('div', { class: 'chat-thread', ref: threadRef, role: 'log', 'aria-label': 'chat messages' },
             messages.length === 0
                 ? h('div', { key: '_empty', class: 'chat-empty', role: 'status' },
-                    h('p', { class: 'chat-empty-title' }, 'start a conversation'),
-                    h('p', { class: 'chat-empty-sub' }, sub || 'Send a message to start the conversation'),
+                    h('p', { class: 'chat-empty-title' }, t('chat.startConversation', 'start a conversation')),
+                    h('p', { class: 'chat-empty-sub' }, sub || t('chat.emptySub', 'Send a message to start the conversation')),
                     (suggestions && suggestions.length)
                         ? h('div', { class: 'chat-empty-suggestions' },
                             ...suggestions.map((s, i) => h('button', { key: 'sug' + i, type: 'button', class: 'chat-empty-suggestion',

package/src/components/content.js

@@ -267,13 +267,17 @@ export function Install({ cmd, copied, onCopy }) {
 // every portfolio consumer theme.mjs (zellous/wireweave/247420) had hand-rolled
 // identically: lines.map((l,i) => a div per line holding a prompt span ('$' or
 // '#' for a comment line) and a cmd span, all wrapped in a Panel. This factory
-// targets the multi-line `.cli` contract already defined in app-shell.css and
-// gm-prose.css (`.cli` holding `.ds-cli-row` rows — each a prompt+cmd pair —
-// and `.ds-cli-comment` comment rows). `lines` is [{kind, text}] where kind: 'cmt' renders a
+// targets the multi-line `.ds-cli-block` contract defined in gm-prose.css
+// (`.ds-cli-block` holding `.ds-cli-row` rows — each a prompt+cmd pair — and
+// `.ds-cli-comment` comment rows). `lines` is [{kind, text}] where kind: 'cmt' renders a
 // comment-only row (no prompt glyph); any other kind (or omitted) renders a
 // command row prefixed '$'. `heading` titles the wrapping Panel ('quick start'
 // default, matching every hand-rolled instance); pass `heading: null` to
-// render the bare `.cli` block with no Panel chrome.
+// render the bare `.ds-cli-block` block with no Panel chrome.
+// Note: this is a different component than the bare `.cli` single prompt+cmd
+// row primitive (app-shell.css; see Install() above and the per-line usage
+// in terminal/site quickstart renderers) — the two used to collide on the
+// same `.cli` class name with incompatible display models.
 export function CliBlock({ lines = [], heading = 'quick start', className = '' } = {}) {
     if (!lines || !lines.length) return null;
     const rows = lines.map((l, i) => {
@@ -285,7 +289,7 @@ export function CliBlock({ lines = [], heading = 'quick start', className = '' }
                 h('span', { class: 'prompt' }, '$'),
                 h('span', { class: 'cmd' }, text));
     });
-    const body = h('div', { class: 'cli' + (className ? ' ' + className : '') }, ...rows);
+    const body = h('div', { class: 'ds-cli-block' + (className ? ' ' + className : '') }, ...rows);
     return heading == null ? body : Panel({ title: heading, children: body });
 }
 

package/src/components/editor-primitives.js

@@ -345,7 +345,7 @@ export function ResizeHandle({ axis = 'horizontal', onResize, ariaLabel } = {})
     };
     const onPointerUp = (e) => {
         dragOrigin = null;
-        try { e.currentTarget.releasePointerCapture && e.currentTarget.releasePointerCapture(e.pointerId); } catch {}
+        try { e.currentTarget.releasePointerCapture && e.currentTarget.releasePointerCapture(e.pointerId); } catch { /* swallow: pointer capture may already be released, drag end still proceeds */ }
     };
     const onKeyDown = (e) => {
         const k = e.key;
@@ -829,7 +829,7 @@ export function JsonViewer({ value, emptyText = 'no data', maxHeight, mode = 'pl
     if (!text) return h('div', { class: 'ds-ep-json ds-ep-json-empty' }, emptyText);
     const style = maxHeight ? ('max-height:' + maxHeight) : null;
     if (!knownJson && (mode === 'highlight' || mode === 'tree')) {
-        try { parsed = JSON.parse(text); knownJson = true; } catch { /* not JSON — render plain */ }
+        try { parsed = JSON.parse(text); knownJson = true; } catch { /* swallow: not JSON — render plain */ }
     }
     let body;
     if (mode === 'tree' && knownJson && parsed !== null && typeof parsed === 'object') {

package/src/components/files-modals.js

@@ -4,6 +4,7 @@ import * as webjsx from '../../vendor/webjsx/index.js';
 import { Btn, Icon } from './shell.js';
 import { fileGlyph, fmtFileSize } from './files.js';
 import { highlightAllUnder } from '../highlight.js';
+import { shortUid } from '../uid.js';
 const h = webjsx.createElement;
 
 // Full focusable set for the modal Tab trap — omitting textarea/select/a[href]
@@ -81,7 +82,7 @@ function Backdrop({ onClose, children, kind = '', labelledBy, busy = false } = {
             // Only restore focus when the modal is genuinely going away (not a
             // re-render remount) and focus is not already somewhere useful.
             if (removed && Backdrop._invoker && Backdrop._invoker.focus && Backdrop._invoker.isConnected) {
-                try { Backdrop._invoker.focus(); } catch {}
+                try { Backdrop._invoker.focus(); } catch { /* swallow: restoring focus on close is best-effort, teardown still completes */ }
             }
             if (removed) Backdrop._invoker = null;
         };
@@ -140,7 +141,7 @@ function Modal({ onClose, kind = '', head, headClass = '', headAttrs = {}, body,
     // stays constant across re-renders of the same dialog instance — an
     // incrementing counter advances on every render, leaving the previous
     // aria-labelledby reference pointing at a now-absent element.
-    const headId = head != null ? ('ds-modal-head-' + Math.random().toString(36).slice(2, 8)) : null;
+    const headId = head != null ? ('ds-modal-head-' + shortUid(6)) : null;
     return Backdrop({
         onClose,
         kind,
@@ -270,7 +271,7 @@ export function FilePreviewCode({ content = '', lang, filename } = {}) {
         const btn = e.currentTarget;
         const done = () => { btn.textContent = 'copied'; btn.classList.add('is-copied'); setTimeout(() => { btn.textContent = 'copy'; btn.classList.remove('is-copied'); }, 1600); };
         if (navigator.clipboard && navigator.clipboard.writeText) navigator.clipboard.writeText(content).then(done).catch(() => {});
-        else { try { const t = document.createElement('textarea'); t.value = content; document.body.appendChild(t); t.select(); document.execCommand('copy'); document.body.removeChild(t); done(); } catch {} }
+        else { try { const t = document.createElement('textarea'); t.value = content; document.body.appendChild(t); t.select(); document.execCommand('copy'); document.body.removeChild(t); done(); } catch { /* swallow: legacy execCommand copy fallback unsupported, nothing more to try */ } }
     };
     return h('div', { class: 'ds-preview-code-wrap' },
         h('div', { class: 'chat-code-head ds-preview-code-head' },
@@ -295,7 +296,7 @@ function codeBody({ content = '', lang } = {}) {
         : null;
     const highlightRef = (el) => {
         if (!el) return;
-        try { highlightAllUnder(el); } catch {}
+        try { highlightAllUnder(el); } catch { /* swallow: syntax highlighting is a progressive enhancement, plain code still renders */ }
     };
     return h('pre', { class: 'ds-preview-code' + (lang ? ' lang-' + lang : '') + (wantGutter ? ' has-gutter' : ''), ref: highlightRef },
         gutter,

package/src/components/freddie/helpers.js

@@ -75,7 +75,7 @@ export function saveRecentPath(path) {
     if (typeof localStorage === 'undefined' || !path) return;
     const list = getRecentPaths().filter(p => p !== path);
     list.unshift(path);
-    try { localStorage.setItem(RECENT_KEY, JSON.stringify(list.slice(0, RECENT_CAP))); } catch {}
+    try { localStorage.setItem(RECENT_KEY, JSON.stringify(list.slice(0, RECENT_CAP))); } catch { /* swallow: persistence is best-effort, recent-path history is non-critical */ }
 }
 
 // Helper used by consumers that want to render chat-message arrays with

package/src/components/freddie.js

@@ -10,20 +10,12 @@ import { getRecentPaths, saveRecentPath, skillLabel, renderChatMessages } from '
 import { Panel, Row, Table, Kpi, PageHeader, SearchInput, TextField, Select } from './content.js';
 import { Chip, Btn, Icon } from './shell.js';
 import { ChatMessage, ChatComposer } from './chat.js';
+import { fmtTime, fmtAgo } from './sessions.js';
 
 const h = webjsx.createElement;
 
 // ---- shared bits -----------------------------------------------------------
 
-const fmtTime = (t) => { try { return new Date(t).toLocaleString(); } catch { return String(t || ''); } };
-const fmtAgo = (t) => {
-    if (!t) return '';
-    const s = Math.floor((Date.now() - new Date(t).getTime()) / 1000);
-    if (s < 60) return s + 's ago';
-    if (s < 3600) return Math.floor(s / 60) + 'm ago';
-    if (s < 86400) return Math.floor(s / 3600) + 'h ago';
-    return Math.floor(s / 86400) + 'd ago';
-};
 const section = (title, ...children) => Panel({ title, children: children.flat().filter(Boolean) });
 const noteAlert = (note) => note ? h('div', { class: 'ds-alert ds-alert-' + note.kind, role: 'alert' },
     h('span', { class: 'ds-alert-icon' }, '!'),

package/src/components/interaction-primitives.js

@@ -32,7 +32,7 @@ export function useDraggable(el, { data, kind, onDragStart, onDragEnd } = {}) {
         if (!active) return;
         const wasStarted = started;
         active = false; started = false;
-        try { if (pid != null) el.releasePointerCapture(pid); } catch {}
+        try { if (pid != null) el.releasePointerCapture(pid); } catch { /* swallow: pointer capture may already be released, drag end still proceeds */ }
         pid = null;
         el.removeAttribute('data-dragging');
         const hit = document.elementFromPoint(e.clientX, e.clientY);
@@ -47,7 +47,7 @@ export function useDraggable(el, { data, kind, onDragStart, onDragEnd } = {}) {
         if (e.button != null && e.button !== 0) return;
         active = true; started = false;
         startX = e.clientX; startY = e.clientY; pid = e.pointerId;
-        try { el.setPointerCapture(e.pointerId); } catch {}
+        try { el.setPointerCapture(e.pointerId); } catch { /* swallow: pointer capture unsupported/denied, drag still tracks via listeners */ }
         window.addEventListener('pointermove', onMove);
         window.addEventListener('pointerup', onUp);
         window.addEventListener('pointercancel', onUp);
@@ -111,7 +111,7 @@ export function useNumberScrub(el, { getValue, onChange, step = 0.01, threshold
     };
     const onUp = () => {
         if (pid == null) return;
-        try { el.releasePointerCapture(pid); } catch {}
+        try { el.releasePointerCapture(pid); } catch { /* swallow: pointer capture may already be released, drag end still proceeds */ }
         pid = null;
         el.removeAttribute('data-scrubbing');
         window.removeEventListener('pointermove', onMove);
@@ -125,7 +125,7 @@ export function useNumberScrub(el, { getValue, onChange, step = 0.01, threshold
         pid = e.pointerId; startX = e.clientX; moved = false;
         const cur = getValue ? getValue() : parseFloat(el.value);
         startV = Number.isFinite(cur) ? cur : 0;
-        try { el.setPointerCapture(pid); } catch {}
+        try { el.setPointerCapture(pid); } catch { /* swallow: pointer capture unsupported/denied, drag still tracks via listeners */ }
         window.addEventListener('pointermove', onMove);
         window.addEventListener('pointerup', onUp);
         window.addEventListener('pointercancel', onUp);
@@ -157,7 +157,7 @@ export function usePointerDrag(el, { onStart, onMove, onEnd, button = 0 } = {})
     };
     const finish = (e, cancelled) => {
         if (pid == null) return;
-        try { el.releasePointerCapture(pid); } catch {}
+        try { el.releasePointerCapture(pid); } catch { /* swallow: pointer capture may already be released, drag end still proceeds */ }
         pid = null;
         el.removeAttribute('data-pointer-dragging');
         window.removeEventListener('pointermove', onMoveEv);
@@ -173,7 +173,7 @@ export function usePointerDrag(el, { onStart, onMove, onEnd, button = 0 } = {})
         if (onStart && onStart(e) === false) return; // caller declined (e.g. raycast miss)
         pid = e.pointerId;
         el.setAttribute('data-pointer-dragging', 'true');
-        try { el.setPointerCapture(pid); } catch {}
+        try { el.setPointerCapture(pid); } catch { /* swallow: pointer capture unsupported/denied, drag still tracks via listeners */ }
         window.addEventListener('pointermove', onMoveEv);
         window.addEventListener('pointerup', onUpEv);
         window.addEventListener('pointercancel', onCancelEv);

package/src/components/sessions.js

@@ -11,6 +11,21 @@ const h = webjsx.createElement;
 // ONE duration format for every surface (live cards, running panel, session
 // meta, context pane): <60s -> 'Ns', <1h -> 'Nm Ss', else 'Nh Nm'. Durations
 // roll s -> m -> h instead of an hour-long run reading '3712s'.
+// ONE absolute-time / relative-time formatter for every surface that shows a
+// timestamp (freddie pages, chat transcripts). fmtTime -> localized
+// date+time string; fmtAgo -> coarse relative ('Ns/Nm/Nh/Nd ago').
+export function fmtTime(t) {
+  try { return new Date(t).toLocaleString(); } catch { return String(t || ''); }
+}
+export function fmtAgo(t) {
+  if (!t) return '';
+  const s = Math.floor((Date.now() - new Date(t).getTime()) / 1000);
+  if (s < 60) return s + 's ago';
+  if (s < 3600) return Math.floor(s / 60) + 'm ago';
+  if (s < 86400) return Math.floor(s / 3600) + 'h ago';
+  return Math.floor(s / 86400) + 'd ago';
+}
+
 export function fmtDuration(ms) {
   if (ms == null || !isFinite(ms) || ms < 0) return '';
   const s = Math.round(ms / 1000);

package/src/components/shell.js

@@ -345,9 +345,9 @@ function toggleSide(open, fromEl) {
     if (next) {
         const drawer = shell.querySelector('.app-side-shell');
         const focusable = drawer && drawer.querySelector('button, a, input, [tabindex]');
-        if (focusable) try { focusable.focus(); } catch (_) {}
+        if (focusable) try { focusable.focus(); } catch (_) { /* swallow: focus() can throw on a detached/hidden element, drawer still opens */ }
         const onKey = (e) => {
-            if (e.key === 'Escape') { toggleSide(false, btn || body); if (btn) try { btn.focus(); } catch (_) {} return; }
+            if (e.key === 'Escape') { toggleSide(false, btn || body); if (btn) try { btn.focus(); } catch (_) { /* swallow: focus() can throw on a detached/hidden element */ } return; }
             if (drawer) trapTab(drawer, e);
         };
         body._dsSideKey = onKey;
@@ -428,7 +428,7 @@ function toggleWs(which, fromEl) {
     });
     try {
         localStorage.setItem('ds.ws.' + which, nowCollapsed ? 'collapsed' : 'open');
-    } catch (_) {}
+    } catch (_) { /* swallow: persistence is best-effort, collapse state still applies in-memory */ }
     // Expanding restores the persisted width (seed skips collapsed columns, so
     // it must run after the open flag is written).
     if (!nowCollapsed) seedWsWidths(shell);
@@ -459,7 +459,7 @@ function wsResize(col, dx, persist = true, fromEl) {
     if (handle) { handle.setAttribute('aria-valuenow', String(next)); handle.setAttribute('aria-valuetext', next + ' pixels'); }
     // Commit to storage only on a settled move (pointerup / keyboard), not on
     // every pointermove frame (that fired dozens of synchronous writes per drag).
-    if (persist) { try { localStorage.setItem('ds.ws.w.' + col, String(next)); } catch (_) {} }
+    if (persist) { try { localStorage.setItem('ds.ws.w.' + col, String(next)); } catch (_) { /* swallow: persistence is best-effort, resize still applies in-memory */ } }
 }
 // Per-column viewport caps for persisted widths: a width dragged on a wide
 // monitor must not crush the content column when the page reloads on a
@@ -474,7 +474,7 @@ function seedWsWidths(el) {
             if (wsCollapsed(col, false)) return;
             const v = localStorage.getItem('ds.ws.w.' + col);
             if (v && /^\d+$/.test(v)) el.style.setProperty('--ws-' + col + '-w', `min(${v}px, ${WS_VW_CAP[col]})`);
-        } catch (_) {}
+        } catch (_) { /* swallow: localStorage unavailable, seeding is best-effort */ }
     });
 }
 function WsResizer(col) {
@@ -534,10 +534,10 @@ function toggleWsDrawer(which, open, fromEl) {
     // into the scrim/background content behind it).
     const drawer = shell.querySelector(which === 'pane' ? '.ws-pane' : '.ws-sessions');
     const focusable = drawer && drawer.querySelector('button, a, input, [tabindex]');
-    if (focusable) try { focusable.focus(); } catch (_) {}
+    if (focusable) try { focusable.focus(); } catch (_) { /* swallow: focus() can throw on a detached/hidden element, drawer still opens */ }
     removeWsDrawerHandlers(shell); // replace, never stack (opening one drawer over the other)
     const onKey = (e) => {
-        if (e.key === 'Escape') { toggleWsDrawer(which, false, shell); if (btn) try { btn.focus(); } catch (_) {} return; }
+        if (e.key === 'Escape') { toggleWsDrawer(which, false, shell); if (btn) try { btn.focus(); } catch (_) { /* swallow: focus() can throw on a detached/hidden element */ } return; }
         if (drawer) trapTab(drawer, e);
     };
     shell._wsEscHandler = onKey;
@@ -571,7 +571,7 @@ function wsCollapsed(which, fallback) {
         const v = localStorage.getItem('ds.ws.' + which);
         if (v === 'collapsed') return true;
         if (v === 'open') return false;
-    } catch (_) {}
+    } catch (_) { /* swallow: localStorage unavailable, fall back to caller-supplied default */ }
     return !!fallback;
 }
 

package/src/components/theme-toggle.js

@@ -47,7 +47,7 @@ export function ThemeToggle({ compact = false, onChange } = {}) {
             onclick: () => {
                 const next = current === 'auto' ? 'paper' : (current === 'paper' ? 'ink' : 'auto');
                 applyTheme(next);
-                if (onChange) try { onChange(next); } catch {}
+                if (onChange) try { onChange(next); } catch { /* swallow: consumer onChange callback must not break the toggle */ }
             }
         },
         // CSS-drawn half-disc so the control still reads as the theme switch
@@ -69,7 +69,7 @@ export function ThemeToggle({ compact = false, onChange } = {}) {
             class: 'ds-seg-btn' + (current === mode ? ' is-on' : ''),
             onclick: () => {
                 applyTheme(mode);
-                if (onChange) try { onChange(mode); } catch {}
+                if (onChange) try { onChange(mode); } catch { /* swallow: consumer onChange callback must not break the toggle */ }
             }
         }, label)
     ));