fix(desktop): titlebar icon-row baseline + native cursor convention

apps/desktop/src/main/__tests__/cursor-convention-contract.test.ts

@@ -0,0 +1,57 @@
+/**
+ * Static-analysis contract for the native cursor convention.
+ *
+ * Native macOS / Windows reserve the pointing-hand cursor (`cursor: pointer`)
+ * for hyperlinks; every other control uses the default arrow. Only the
+ * link-styled in-app nav button (`.maka-markdown-link-internal`) may carry it.
+ * The runtime look-and-feel (which element shows which cursor) is still
+ * verified in a real window — this is the source bound.
+ */
+
+import { strict as assert } from 'node:assert';
+import { readFile } from 'node:fs/promises';
+import { describe, it } from 'node:test';
+import { join } from 'node:path';
+
+const STYLES_PATH = join(process.cwd(), 'src', 'renderer', 'styles.css');
+const TOKENS_PATH = join(process.cwd(), 'src', 'renderer', 'maka-tokens.css');
+
+/** Only the link-styled in-app nav button may carry the hand cursor. */
+const CURSOR_POINTER_ALLOWLIST = ['.maka-markdown-link-internal'];
+
+/**
+ * Selectors of every rule that declares `cursor: pointer`, sorted. Comments are
+ * stripped first; each hit walks back to the `{` that opens its rule and takes
+ * the selector after the previous block boundary. Depth is ignored, so a
+ * `cursor: pointer` hidden inside an at-rule (e.g. `@media`) is still caught.
+ */
+function selectorsWithHandCursor(css: string): string[] {
+ const stripped = css.replace(/\/\*[\s\S]*?\*\//g, '');
+ const selectors: string[] = [];
+ const re = /cursor:\s*pointer/g;
+ for (let m = re.exec(stripped); m; m = re.exec(stripped)) {
+ const open = stripped.lastIndexOf('{', m.index);
+ selectors.push(stripped.slice(0, open).split(/[{}]/).pop()?.trim() ?? '');
+ }
+ return selectors.sort();
+}
+
+describe('native cursor convention contract', () => {
+ it('styles.css: cursor:pointer lives only on the link-styled nav button', async () => {
+ const css = await readFile(STYLES_PATH, 'utf8');
+ assert.deepEqual(
+ selectorsWithHandCursor(css),
+ [...CURSOR_POINTER_ALLOWLIST].sort(),
+ 'Only `.maka-markdown-link-internal` may carry `cursor: pointer` — it presents as a link, and native macOS reserves the hand for links while every other control uses the default arrow. Drop the declaration, or reuse the link class if the element genuinely is the in-app link button.',
+ );
+ });
+
+ it('maka-tokens.css: defines no cursor:pointer', async () => {
+ const css = await readFile(TOKENS_PATH, 'utf8');
+ assert.deepEqual(
+ selectorsWithHandCursor(css),
+ [],
+ 'Design tokens must not set `cursor: pointer`; the hand cursor belongs only on the link-styled nav button in styles.css.',
+ );
+ });
+});

apps/desktop/src/main/__tests__/localized-main-shell-contract.test.ts

@@ -478,7 +478,13 @@ describe('localized main shell contract', () => {
  assert.ok(workspaceTopActions, '.maka-workspace-top-actions rule must exist');
  assert.ok(workspaceFeedbackAction, '.maka-workspace-feedback-action rule must exist');
  assert.match(workspaceTopActions, /position:\s*absolute/);
- assert.match(workspaceTopActions, /top:\s*11px/);
+ // PR-TITLEBAR-ROW-BASELINE: the right-side workspace top-actions
+ // share the single titlebar baseline with the two left strips —
+ // anchored on var(--maka-titlebar-control-safe-top), never a
+ // hardcoded vertical offset. We assert the baseline reference, not
+ // the per-container correction constant (geometry, free to tune):
+ // the invariant is that all three clusters key off the one baseline.
+ assert.match(workspaceTopActions, /top:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\)/);
  assert.match(workspaceTopActions, /right:\s*24px/);
  assert.match(workspaceTopActions, /gap:\s*6px/);
  assert.match(workspaceFeedbackAction, /font-size:\s*11px/);
@@ -528,7 +534,15 @@ describe('localized main shell contract', () => {
  assert.ok(collapsedTopbar, '.maka-collapsed-drag-strip rule must exist');
  assert.match(collapsedTopbar, /min-height:\s*38px/);
  assert.match(styles, /--maka-titlebar-control-safe-left:\s*94px/);
- assert.match(collapsedTopbar, /padding:\s*8px 12px 0 var\(--maka-titlebar-control-safe-left\)/);
+ // PR-TITLEBAR-ROW-BASELINE: the macOS window has ONE physical
+ // titlebar row (traffic-light center). All three top icon clusters
+ // — sidebar header strip, collapsed strip, workspace top-actions —
+ // center their 24px icons on the single --maka-titlebar-control-safe-top
+ // baseline so the row can't jump when the sidebar collapses/expands.
+ // Each cluster applies its own small per-container correction; no
+ // cluster may reintroduce an independent vertical baseline.
+ assert.match(styles, /--maka-titlebar-control-safe-top:\s*20px/);
+ assert.match(collapsedTopbar, /padding:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\) 12px 0 var\(--maka-titlebar-control-safe-left\)/);
  assert.match(collapsedTopbar, /-webkit-app-region:\s*drag/);
  const collapsedTopbarButton = extractCssRule(styles, '.maka-collapsed-topbar-button');
  assert.ok(collapsedTopbarButton, '.maka-collapsed-topbar-button rule must exist');
@@ -538,6 +552,10 @@ describe('localized main shell contract', () => {
  assert.match(sidebarTopBar, /justify-content:\s*space-between/);
  assert.match(sidebarTopBar, /box-sizing:\s*border-box/);
  assert.match(sidebarTopBar, /padding-left:\s*calc\(var\(--maka-titlebar-control-safe-left\) - 10px\)/);
+ // same shared vertical baseline as the collapsed strip + workspace
+ // top-actions — references the one var(--maka-titlebar-control-safe-top),
+ // with its own per-container correction constant (not asserted).
+ assert.match(sidebarTopBar, /padding-top:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\)/);
  assert.match(styles, /(?:^|\n)\.maka-nav-icon\s*\{[\s\S]*?width:\s*18px[\s\S]*?height:\s*18px/);
  assert.match(styles, /\.maka-sidebar-modules\b/);
  assert.doesNotMatch(styles, /\.maka-sidebar-module-hint\b/);
@@ -561,10 +579,10 @@ describe('localized main shell contract', () => {
  const icon = await stat(iconPath);
  const iconBuffer = await readFile(iconPath);
 
- assert.ok(icon.size > 1_400_000, 'the edge-filled user-provided PNG icon must be present as the desktop app icon asset');
+ assert.ok(icon.size > 700_000, 'the padded macOS-safe-area PNG icon (PR #75) must be present as the desktop app icon asset');
  assert.equal(iconBuffer.toString('ascii', 1, 4), 'PNG', 'desktop app icon must remain a PNG asset');
- assert.equal(iconBuffer.readUInt32BE(16), 1254, 'desktop app icon width must match the supplied edge-filled icon');
- assert.equal(iconBuffer.readUInt32BE(20), 1254, 'desktop app icon height must match the supplied edge-filled icon');
+ assert.equal(iconBuffer.readUInt32BE(16), 1024, 'desktop app icon width must match the supplied 1024² padded icon (PR #75)');
+ assert.equal(iconBuffer.readUInt32BE(20), 1024, 'desktop app icon height must match the supplied 1024² padded icon (PR #75)');
  assert.equal(iconBuffer[25], 6, 'desktop app icon must be RGBA so the rounded icon corners stay transparent');
  assert.match(tokens, /--background:\s*oklch\(1\.000 0 0\);/);
  assert.match(tokens, /--surface-canvas:\s*oklch\(0\.935 0 0\);/);

apps/desktop/src/renderer/maka-tokens.css

@@ -763,7 +763,6 @@
  padding: 6px 10px;
  border-radius: var(--radius-button);
  color: var(--foreground-80);
- cursor: pointer;
  font-size: 14px;
  line-height: 1.4;
  user-select: none;
@@ -790,7 +789,6 @@
  padding: 4px 8px;
  border-radius: var(--radius-button);
  color: var(--foreground-60);
- cursor: pointer;
  font-size: 13px;
  }
  .maka-sidebar-button:hover { background: var(--hover); color: var(--foreground); }
@@ -948,7 +946,6 @@
  display: flex;
  align-items: center;
  gap: 8px;
- cursor: pointer;
  font-weight: 600;
  color: var(--accent);
  letter-spacing: 0.02em;
@@ -1158,7 +1155,6 @@
  border-radius: 7px;
  background: transparent;
  color: var(--foreground-50);
- cursor: pointer;
  transition: background 120ms ease, color 120ms ease, box-shadow 120ms ease;
  }
  .maka-code-block-copy:hover {
@@ -1315,7 +1311,6 @@
  border-radius: 7px;
  background: var(--background);
  color: var(--foreground-60);
- cursor: pointer;
  opacity: 0;
  /* PR-CHAT-COPY-BUTTON-POLISH-0 (WAWQAQ 10min loop): the copy
  button used to fade in on hover but never moved — felt like
@@ -1424,7 +1419,6 @@
  .maka-tool { padding: 0; }
  .maka-tool > summary {
  list-style: none;
- cursor: pointer;
  padding: 8px 12px;
  }
  .maka-tool > summary::-webkit-details-marker { display: none; }
@@ -1670,7 +1664,6 @@
  font-size: 13px;
  font-weight: 500;
  line-height: 1.2;
- cursor: pointer;
  transition: background 120ms ease, border-color 120ms ease, color 120ms ease, transform 120ms ease, box-shadow 120ms ease;
  }
  .maka-button:hover { background: var(--hover); }

apps/desktop/src/main/__tests__/cursor-convention-contract.test.ts

@@ -0,0 +1,57 @@
+/**
+ * Static-analysis contract for the native cursor convention.
+ *
+ * Native macOS / Windows reserve the pointing-hand cursor (`cursor: pointer`)
+ * for hyperlinks; every other control uses the default arrow. Only the
+ * link-styled in-app nav button (`.maka-markdown-link-internal`) may carry it.
+ * The runtime look-and-feel (which element shows which cursor) is still
+ * verified in a real window — this is the source bound.
+ */
+
+import { strict as assert } from 'node:assert';
+import { readFile } from 'node:fs/promises';
+import { describe, it } from 'node:test';
+import { join } from 'node:path';
+
+const STYLES_PATH = join(process.cwd(), 'src', 'renderer', 'styles.css');
+const TOKENS_PATH = join(process.cwd(), 'src', 'renderer', 'maka-tokens.css');
+
+/** Only the link-styled in-app nav button may carry the hand cursor. */
+const CURSOR_POINTER_ALLOWLIST = ['.maka-markdown-link-internal'];
+
+/**
+ * Selectors of every rule that declares `cursor: pointer`, sorted. Comments are
+ * stripped first; each hit walks back to the `{` that opens its rule and takes
+ * the selector after the previous block boundary. Depth is ignored, so a
+ * `cursor: pointer` hidden inside an at-rule (e.g. `@media`) is still caught.
+ */
+function selectorsWithHandCursor(css: string): string[] {
+ const stripped = css.replace(/\/\*[\s\S]*?\*\//g, '');
+ const selectors: string[] = [];
+ const re = /cursor:\s*pointer/g;
+ for (let m = re.exec(stripped); m; m = re.exec(stripped)) {
+ const open = stripped.lastIndexOf('{', m.index);
+ selectors.push(stripped.slice(0, open).split(/[{}]/).pop()?.trim() ?? '');
+ }
+ return selectors.sort();
+}
+
+describe('native cursor convention contract', () => {
+ it('styles.css: cursor:pointer lives only on the link-styled nav button', async () => {
+ const css = await readFile(STYLES_PATH, 'utf8');
+ assert.deepEqual(
+ selectorsWithHandCursor(css),
+ [...CURSOR_POINTER_ALLOWLIST].sort(),
+ 'Only `.maka-markdown-link-internal` may carry `cursor: pointer` — it presents as a link, and native macOS reserves the hand for links while every other control uses the default arrow. Drop the declaration, or reuse the link class if the element genuinely is the in-app link button.',
+ );
+ });
+
+ it('maka-tokens.css: defines no cursor:pointer', async () => {
+ const css = await readFile(TOKENS_PATH, 'utf8');
+ assert.deepEqual(
+ selectorsWithHandCursor(css),
+ [],
+ 'Design tokens must not set `cursor: pointer`; the hand cursor belongs only on the link-styled nav button in styles.css.',
+ );
+ });
+});

apps/desktop/src/main/__tests__/localized-main-shell-contract.test.ts

@@ -478,7 +478,13 @@ describe('localized main shell contract', () => {
  assert.ok(workspaceTopActions, '.maka-workspace-top-actions rule must exist');
  assert.ok(workspaceFeedbackAction, '.maka-workspace-feedback-action rule must exist');
  assert.match(workspaceTopActions, /position:\s*absolute/);
- assert.match(workspaceTopActions, /top:\s*11px/);
+ // PR-TITLEBAR-ROW-BASELINE: the right-side workspace top-actions
+ // share the single titlebar baseline with the two left strips —
+ // anchored on var(--maka-titlebar-control-safe-top), never a
+ // hardcoded vertical offset. We assert the baseline reference, not
+ // the per-container correction constant (geometry, free to tune):
+ // the invariant is that all three clusters key off the one baseline.
+ assert.match(workspaceTopActions, /top:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\)/);
  assert.match(workspaceTopActions, /right:\s*24px/);
  assert.match(workspaceTopActions, /gap:\s*6px/);
  assert.match(workspaceFeedbackAction, /font-size:\s*11px/);
@@ -528,7 +534,15 @@ describe('localized main shell contract', () => {
  assert.ok(collapsedTopbar, '.maka-collapsed-drag-strip rule must exist');
  assert.match(collapsedTopbar, /min-height:\s*38px/);
  assert.match(styles, /--maka-titlebar-control-safe-left:\s*94px/);
- assert.match(collapsedTopbar, /padding:\s*8px 12px 0 var\(--maka-titlebar-control-safe-left\)/);
+ // PR-TITLEBAR-ROW-BASELINE: the macOS window has ONE physical
+ // titlebar row (traffic-light center). All three top icon clusters
+ // — sidebar header strip, collapsed strip, workspace top-actions —
+ // center their 24px icons on the single --maka-titlebar-control-safe-top
+ // baseline so the row can't jump when the sidebar collapses/expands.
+ // Each cluster applies its own small per-container correction; no
+ // cluster may reintroduce an independent vertical baseline.
+ assert.match(styles, /--maka-titlebar-control-safe-top:\s*20px/);
+ assert.match(collapsedTopbar, /padding:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\) 12px 0 var\(--maka-titlebar-control-safe-left\)/);
  assert.match(collapsedTopbar, /-webkit-app-region:\s*drag/);
  const collapsedTopbarButton = extractCssRule(styles, '.maka-collapsed-topbar-button');
  assert.ok(collapsedTopbarButton, '.maka-collapsed-topbar-button rule must exist');
@@ -538,6 +552,10 @@ describe('localized main shell contract', () => {
  assert.match(sidebarTopBar, /justify-content:\s*space-between/);
  assert.match(sidebarTopBar, /box-sizing:\s*border-box/);
  assert.match(sidebarTopBar, /padding-left:\s*calc\(var\(--maka-titlebar-control-safe-left\) - 10px\)/);
+ // same shared vertical baseline as the collapsed strip + workspace
+ // top-actions — references the one var(--maka-titlebar-control-safe-top),
+ // with its own per-container correction constant (not asserted).
+ assert.match(sidebarTopBar, /padding-top:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\)/);
  assert.match(styles, /(?:^|\n)\.maka-nav-icon\s*\{[\s\S]*?width:\s*18px[\s\S]*?height:\s*18px/);
  assert.match(styles, /\.maka-sidebar-modules\b/);
  assert.doesNotMatch(styles, /\.maka-sidebar-module-hint\b/);
@@ -561,10 +579,10 @@ describe('localized main shell contract', () => {
  const icon = await stat(iconPath);
  const iconBuffer = await readFile(iconPath);
 
- assert.ok(icon.size > 1_400_000, 'the edge-filled user-provided PNG icon must be present as the desktop app icon asset');
+ assert.ok(icon.size > 700_000, 'the padded macOS-safe-area PNG icon (PR #75) must be present as the desktop app icon asset');
  assert.equal(iconBuffer.toString('ascii', 1, 4), 'PNG', 'desktop app icon must remain a PNG asset');
- assert.equal(iconBuffer.readUInt32BE(16), 1254, 'desktop app icon width must match the supplied edge-filled icon');
- assert.equal(iconBuffer.readUInt32BE(20), 1254, 'desktop app icon height must match the supplied edge-filled icon');
+ assert.equal(iconBuffer.readUInt32BE(16), 1024, 'desktop app icon width must match the supplied 1024² padded icon (PR #75)');
+ assert.equal(iconBuffer.readUInt32BE(20), 1024, 'desktop app icon height must match the supplied 1024² padded icon (PR #75)');
  assert.equal(iconBuffer[25], 6, 'desktop app icon must be RGBA so the rounded icon corners stay transparent');
  assert.match(tokens, /--background:\s*oklch\(1\.000 0 0\);/);
  assert.match(tokens, /--surface-canvas:\s*oklch\(0\.935 0 0\);/);

apps/desktop/src/renderer/maka-tokens.css

@@ -763,7 +763,6 @@
  padding: 6px 10px;
  border-radius: var(--radius-button);
  color: var(--foreground-80);
- cursor: pointer;
  font-size: 14px;
  line-height: 1.4;
  user-select: none;
@@ -790,7 +789,6 @@
  padding: 4px 8px;
  border-radius: var(--radius-button);
  color: var(--foreground-60);
- cursor: pointer;
  font-size: 13px;
  }
  .maka-sidebar-button:hover { background: var(--hover); color: var(--foreground); }
@@ -948,7 +946,6 @@
  display: flex;
  align-items: center;
  gap: 8px;
- cursor: pointer;
  font-weight: 600;
  color: var(--accent);
  letter-spacing: 0.02em;
@@ -1158,7 +1155,6 @@
  border-radius: 7px;
  background: transparent;
  color: var(--foreground-50);
- cursor: pointer;
  transition: background 120ms ease, color 120ms ease, box-shadow 120ms ease;
  }
  .maka-code-block-copy:hover {
@@ -1315,7 +1311,6 @@
  border-radius: 7px;
  background: var(--background);
  color: var(--foreground-60);
- cursor: pointer;
  opacity: 0;
  /* PR-CHAT-COPY-BUTTON-POLISH-0 (WAWQAQ 10min loop): the copy
  button used to fade in on hover but never moved — felt like
@@ -1424,7 +1419,6 @@
  .maka-tool { padding: 0; }
  .maka-tool > summary {
  list-style: none;
- cursor: pointer;
  padding: 8px 12px;
  }
  .maka-tool > summary::-webkit-details-marker { display: none; }
@@ -1670,7 +1664,6 @@
  font-size: 13px;
  font-weight: 500;
  line-height: 1.2;
- cursor: pointer;
  transition: background 120ms ease, border-color 120ms ease, color 120ms ease, transform 120ms ease, box-shadow 120ms ease;
  }
  .maka-button:hover { background: var(--hover); }

apps/desktop/src/main/__tests__/cursor-convention-contract.test.ts

@@ -0,0 +1,57 @@
+/**
+ * Static-analysis contract for the native cursor convention.
+ *
+ * Native macOS / Windows reserve the pointing-hand cursor (`cursor: pointer`)
+ * for hyperlinks; every other control uses the default arrow. Only the
+ * link-styled in-app nav button (`.maka-markdown-link-internal`) may carry it.
+ * The runtime look-and-feel (which element shows which cursor) is still
+ * verified in a real window — this is the source bound.
+ */
+
+import { strict as assert } from 'node:assert';
+import { readFile } from 'node:fs/promises';
+import { describe, it } from 'node:test';
+import { join } from 'node:path';
+
+const STYLES_PATH = join(process.cwd(), 'src', 'renderer', 'styles.css');
+const TOKENS_PATH = join(process.cwd(), 'src', 'renderer', 'maka-tokens.css');
+
+/** Only the link-styled in-app nav button may carry the hand cursor. */
+const CURSOR_POINTER_ALLOWLIST = ['.maka-markdown-link-internal'];
+
+/**
+ * Selectors of every rule that declares `cursor: pointer`, sorted. Comments are
+ * stripped first; each hit walks back to the `{` that opens its rule and takes
+ * the selector after the previous block boundary. Depth is ignored, so a
+ * `cursor: pointer` hidden inside an at-rule (e.g. `@media`) is still caught.
+ */
+function selectorsWithHandCursor(css: string): string[] {
+ const stripped = css.replace(/\/\*[\s\S]*?\*\//g, '');
+ const selectors: string[] = [];
+ const re = /cursor:\s*pointer/g;
+ for (let m = re.exec(stripped); m; m = re.exec(stripped)) {
+ const open = stripped.lastIndexOf('{', m.index);
+ selectors.push(stripped.slice(0, open).split(/[{}]/).pop()?.trim() ?? '');
+ }
+ return selectors.sort();
+}
+
+describe('native cursor convention contract', () => {
+ it('styles.css: cursor:pointer lives only on the link-styled nav button', async () => {
+ const css = await readFile(STYLES_PATH, 'utf8');
+ assert.deepEqual(
+ selectorsWithHandCursor(css),
+ [...CURSOR_POINTER_ALLOWLIST].sort(),
+ 'Only `.maka-markdown-link-internal` may carry `cursor: pointer` — it presents as a link, and native macOS reserves the hand for links while every other control uses the default arrow. Drop the declaration, or reuse the link class if the element genuinely is the in-app link button.',
+ );
+ });
+
+ it('maka-tokens.css: defines no cursor:pointer', async () => {
+ const css = await readFile(TOKENS_PATH, 'utf8');
+ assert.deepEqual(
+ selectorsWithHandCursor(css),
+ [],
+ 'Design tokens must not set `cursor: pointer`; the hand cursor belongs only on the link-styled nav button in styles.css.',
+ );
+ });
+});

apps/desktop/src/main/__tests__/localized-main-shell-contract.test.ts

@@ -478,7 +478,13 @@ describe('localized main shell contract', () => {
  assert.ok(workspaceTopActions, '.maka-workspace-top-actions rule must exist');
  assert.ok(workspaceFeedbackAction, '.maka-workspace-feedback-action rule must exist');
  assert.match(workspaceTopActions, /position:\s*absolute/);
- assert.match(workspaceTopActions, /top:\s*11px/);
+ // PR-TITLEBAR-ROW-BASELINE: the right-side workspace top-actions
+ // share the single titlebar baseline with the two left strips —
+ // anchored on var(--maka-titlebar-control-safe-top), never a
+ // hardcoded vertical offset. We assert the baseline reference, not
+ // the per-container correction constant (geometry, free to tune):
+ // the invariant is that all three clusters key off the one baseline.
+ assert.match(workspaceTopActions, /top:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\)/);
  assert.match(workspaceTopActions, /right:\s*24px/);
  assert.match(workspaceTopActions, /gap:\s*6px/);
  assert.match(workspaceFeedbackAction, /font-size:\s*11px/);
@@ -528,7 +534,15 @@ describe('localized main shell contract', () => {
  assert.ok(collapsedTopbar, '.maka-collapsed-drag-strip rule must exist');
  assert.match(collapsedTopbar, /min-height:\s*38px/);
  assert.match(styles, /--maka-titlebar-control-safe-left:\s*94px/);
- assert.match(collapsedTopbar, /padding:\s*8px 12px 0 var\(--maka-titlebar-control-safe-left\)/);
+ // PR-TITLEBAR-ROW-BASELINE: the macOS window has ONE physical
+ // titlebar row (traffic-light center). All three top icon clusters
+ // — sidebar header strip, collapsed strip, workspace top-actions —
+ // center their 24px icons on the single --maka-titlebar-control-safe-top
+ // baseline so the row can't jump when the sidebar collapses/expands.
+ // Each cluster applies its own small per-container correction; no
+ // cluster may reintroduce an independent vertical baseline.
+ assert.match(styles, /--maka-titlebar-control-safe-top:\s*20px/);
+ assert.match(collapsedTopbar, /padding:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\) 12px 0 var\(--maka-titlebar-control-safe-left\)/);
  assert.match(collapsedTopbar, /-webkit-app-region:\s*drag/);
  const collapsedTopbarButton = extractCssRule(styles, '.maka-collapsed-topbar-button');
  assert.ok(collapsedTopbarButton, '.maka-collapsed-topbar-button rule must exist');
@@ -538,6 +552,10 @@ describe('localized main shell contract', () => {
  assert.match(sidebarTopBar, /justify-content:\s*space-between/);
  assert.match(sidebarTopBar, /box-sizing:\s*border-box/);
  assert.match(sidebarTopBar, /padding-left:\s*calc\(var\(--maka-titlebar-control-safe-left\) - 10px\)/);
+ // same shared vertical baseline as the collapsed strip + workspace
+ // top-actions — references the one var(--maka-titlebar-control-safe-top),
+ // with its own per-container correction constant (not asserted).
+ assert.match(sidebarTopBar, /padding-top:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\)/);
  assert.match(styles, /(?:^|\n)\.maka-nav-icon\s*\{[\s\S]*?width:\s*18px[\s\S]*?height:\s*18px/);
  assert.match(styles, /\.maka-sidebar-modules\b/);
  assert.doesNotMatch(styles, /\.maka-sidebar-module-hint\b/);
@@ -561,10 +579,10 @@ describe('localized main shell contract', () => {
  const icon = await stat(iconPath);
  const iconBuffer = await readFile(iconPath);
 
- assert.ok(icon.size > 1_400_000, 'the edge-filled user-provided PNG icon must be present as the desktop app icon asset');
+ assert.ok(icon.size > 700_000, 'the padded macOS-safe-area PNG icon (PR #75) must be present as the desktop app icon asset');
  assert.equal(iconBuffer.toString('ascii', 1, 4), 'PNG', 'desktop app icon must remain a PNG asset');
- assert.equal(iconBuffer.readUInt32BE(16), 1254, 'desktop app icon width must match the supplied edge-filled icon');
- assert.equal(iconBuffer.readUInt32BE(20), 1254, 'desktop app icon height must match the supplied edge-filled icon');
+ assert.equal(iconBuffer.readUInt32BE(16), 1024, 'desktop app icon width must match the supplied 1024² padded icon (PR #75)');
+ assert.equal(iconBuffer.readUInt32BE(20), 1024, 'desktop app icon height must match the supplied 1024² padded icon (PR #75)');
  assert.equal(iconBuffer[25], 6, 'desktop app icon must be RGBA so the rounded icon corners stay transparent');
  assert.match(tokens, /--background:\s*oklch\(1\.000 0 0\);/);
  assert.match(tokens, /--surface-canvas:\s*oklch\(0\.935 0 0\);/);

apps/desktop/src/renderer/maka-tokens.css

@@ -763,7 +763,6 @@
  padding: 6px 10px;
  border-radius: var(--radius-button);
  color: var(--foreground-80);
- cursor: pointer;
  font-size: 14px;
  line-height: 1.4;
  user-select: none;
@@ -790,7 +789,6 @@
  padding: 4px 8px;
  border-radius: var(--radius-button);
  color: var(--foreground-60);
- cursor: pointer;
  font-size: 13px;
  }
  .maka-sidebar-button:hover { background: var(--hover); color: var(--foreground); }
@@ -948,7 +946,6 @@
  display: flex;
  align-items: center;
  gap: 8px;
- cursor: pointer;
  font-weight: 600;
  color: var(--accent);
  letter-spacing: 0.02em;
@@ -1158,7 +1155,6 @@
  border-radius: 7px;
  background: transparent;
  color: var(--foreground-50);
- cursor: pointer;
  transition: background 120ms ease, color 120ms ease, box-shadow 120ms ease;
  }
  .maka-code-block-copy:hover {
@@ -1315,7 +1311,6 @@
  border-radius: 7px;
  background: var(--background);
  color: var(--foreground-60);
- cursor: pointer;
  opacity: 0;
  /* PR-CHAT-COPY-BUTTON-POLISH-0 (WAWQAQ 10min loop): the copy
  button used to fade in on hover but never moved — felt like
@@ -1424,7 +1419,6 @@
  .maka-tool { padding: 0; }
  .maka-tool > summary {
  list-style: none;
- cursor: pointer;
  padding: 8px 12px;
  }
  .maka-tool > summary::-webkit-details-marker { display: none; }
@@ -1670,7 +1664,6 @@
  font-size: 13px;
  font-weight: 500;
  line-height: 1.2;
- cursor: pointer;
  transition: background 120ms ease, border-color 120ms ease, color 120ms ease, transform 120ms ease, box-shadow 120ms ease;
  }
  .maka-button:hover { background: var(--hover); }

apps/desktop/src/main/__tests__/cursor-convention-contract.test.ts

@@ -0,0 +1,57 @@
+/**
+ * Static-analysis contract for the native cursor convention.
+ *
+ * Native macOS / Windows reserve the pointing-hand cursor (`cursor: pointer`)
+ * for hyperlinks; every other control uses the default arrow. Only the
+ * link-styled in-app nav button (`.maka-markdown-link-internal`) may carry it.
+ * The runtime look-and-feel (which element shows which cursor) is still
+ * verified in a real window — this is the source bound.
+ */
+
+import { strict as assert } from 'node:assert';
+import { readFile } from 'node:fs/promises';
+import { describe, it } from 'node:test';
+import { join } from 'node:path';
+
+const STYLES_PATH = join(process.cwd(), 'src', 'renderer', 'styles.css');
+const TOKENS_PATH = join(process.cwd(), 'src', 'renderer', 'maka-tokens.css');
+
+/** Only the link-styled in-app nav button may carry the hand cursor. */
+const CURSOR_POINTER_ALLOWLIST = ['.maka-markdown-link-internal'];
+
+/**
+ * Selectors of every rule that declares `cursor: pointer`, sorted. Comments are
+ * stripped first; each hit walks back to the `{` that opens its rule and takes
+ * the selector after the previous block boundary. Depth is ignored, so a
+ * `cursor: pointer` hidden inside an at-rule (e.g. `@media`) is still caught.
+ */
+function selectorsWithHandCursor(css: string): string[] {
+ const stripped = css.replace(/\/\*[\s\S]*?\*\//g, '');
+ const selectors: string[] = [];
+ const re = /cursor:\s*pointer/g;
+ for (let m = re.exec(stripped); m; m = re.exec(stripped)) {
+ const open = stripped.lastIndexOf('{', m.index);
+ selectors.push(stripped.slice(0, open).split(/[{}]/).pop()?.trim() ?? '');
+ }
+ return selectors.sort();
+}
+
+describe('native cursor convention contract', () => {
+ it('styles.css: cursor:pointer lives only on the link-styled nav button', async () => {
+ const css = await readFile(STYLES_PATH, 'utf8');
+ assert.deepEqual(
+ selectorsWithHandCursor(css),
+ [...CURSOR_POINTER_ALLOWLIST].sort(),
+ 'Only `.maka-markdown-link-internal` may carry `cursor: pointer` — it presents as a link, and native macOS reserves the hand for links while every other control uses the default arrow. Drop the declaration, or reuse the link class if the element genuinely is the in-app link button.',
+ );
+ });
+
+ it('maka-tokens.css: defines no cursor:pointer', async () => {
+ const css = await readFile(TOKENS_PATH, 'utf8');
+ assert.deepEqual(
+ selectorsWithHandCursor(css),
+ [],
+ 'Design tokens must not set `cursor: pointer`; the hand cursor belongs only on the link-styled nav button in styles.css.',
+ );
+ });
+});

apps/desktop/src/main/__tests__/localized-main-shell-contract.test.ts

@@ -478,7 +478,13 @@ describe('localized main shell contract', () => {
  assert.ok(workspaceTopActions, '.maka-workspace-top-actions rule must exist');
  assert.ok(workspaceFeedbackAction, '.maka-workspace-feedback-action rule must exist');
  assert.match(workspaceTopActions, /position:\s*absolute/);
- assert.match(workspaceTopActions, /top:\s*11px/);
+ // PR-TITLEBAR-ROW-BASELINE: the right-side workspace top-actions
+ // share the single titlebar baseline with the two left strips —
+ // anchored on var(--maka-titlebar-control-safe-top), never a
+ // hardcoded vertical offset. We assert the baseline reference, not
+ // the per-container correction constant (geometry, free to tune):
+ // the invariant is that all three clusters key off the one baseline.
+ assert.match(workspaceTopActions, /top:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\)/);
  assert.match(workspaceTopActions, /right:\s*24px/);
  assert.match(workspaceTopActions, /gap:\s*6px/);
  assert.match(workspaceFeedbackAction, /font-size:\s*11px/);
@@ -528,7 +534,15 @@ describe('localized main shell contract', () => {
  assert.ok(collapsedTopbar, '.maka-collapsed-drag-strip rule must exist');
  assert.match(collapsedTopbar, /min-height:\s*38px/);
  assert.match(styles, /--maka-titlebar-control-safe-left:\s*94px/);
- assert.match(collapsedTopbar, /padding:\s*8px 12px 0 var\(--maka-titlebar-control-safe-left\)/);
+ // PR-TITLEBAR-ROW-BASELINE: the macOS window has ONE physical
+ // titlebar row (traffic-light center). All three top icon clusters
+ // — sidebar header strip, collapsed strip, workspace top-actions —
+ // center their 24px icons on the single --maka-titlebar-control-safe-top
+ // baseline so the row can't jump when the sidebar collapses/expands.
+ // Each cluster applies its own small per-container correction; no
+ // cluster may reintroduce an independent vertical baseline.
+ assert.match(styles, /--maka-titlebar-control-safe-top:\s*20px/);
+ assert.match(collapsedTopbar, /padding:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\) 12px 0 var\(--maka-titlebar-control-safe-left\)/);
  assert.match(collapsedTopbar, /-webkit-app-region:\s*drag/);
  const collapsedTopbarButton = extractCssRule(styles, '.maka-collapsed-topbar-button');
  assert.ok(collapsedTopbarButton, '.maka-collapsed-topbar-button rule must exist');
@@ -538,6 +552,10 @@ describe('localized main shell contract', () => {
  assert.match(sidebarTopBar, /justify-content:\s*space-between/);
  assert.match(sidebarTopBar, /box-sizing:\s*border-box/);
  assert.match(sidebarTopBar, /padding-left:\s*calc\(var\(--maka-titlebar-control-safe-left\) - 10px\)/);
+ // same shared vertical baseline as the collapsed strip + workspace
+ // top-actions — references the one var(--maka-titlebar-control-safe-top),
+ // with its own per-container correction constant (not asserted).
+ assert.match(sidebarTopBar, /padding-top:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\)/);
  assert.match(styles, /(?:^|\n)\.maka-nav-icon\s*\{[\s\S]*?width:\s*18px[\s\S]*?height:\s*18px/);
  assert.match(styles, /\.maka-sidebar-modules\b/);
  assert.doesNotMatch(styles, /\.maka-sidebar-module-hint\b/);
@@ -561,10 +579,10 @@ describe('localized main shell contract', () => {
  const icon = await stat(iconPath);
  const iconBuffer = await readFile(iconPath);
 
- assert.ok(icon.size > 1_400_000, 'the edge-filled user-provided PNG icon must be present as the desktop app icon asset');
+ assert.ok(icon.size > 700_000, 'the padded macOS-safe-area PNG icon (PR #75) must be present as the desktop app icon asset');
  assert.equal(iconBuffer.toString('ascii', 1, 4), 'PNG', 'desktop app icon must remain a PNG asset');
- assert.equal(iconBuffer.readUInt32BE(16), 1254, 'desktop app icon width must match the supplied edge-filled icon');
- assert.equal(iconBuffer.readUInt32BE(20), 1254, 'desktop app icon height must match the supplied edge-filled icon');
+ assert.equal(iconBuffer.readUInt32BE(16), 1024, 'desktop app icon width must match the supplied 1024² padded icon (PR #75)');
+ assert.equal(iconBuffer.readUInt32BE(20), 1024, 'desktop app icon height must match the supplied 1024² padded icon (PR #75)');
  assert.equal(iconBuffer[25], 6, 'desktop app icon must be RGBA so the rounded icon corners stay transparent');
  assert.match(tokens, /--background:\s*oklch\(1\.000 0 0\);/);
  assert.match(tokens, /--surface-canvas:\s*oklch\(0\.935 0 0\);/);

apps/desktop/src/renderer/maka-tokens.css

@@ -763,7 +763,6 @@
  padding: 6px 10px;
  border-radius: var(--radius-button);
  color: var(--foreground-80);
- cursor: pointer;
  font-size: 14px;
  line-height: 1.4;
  user-select: none;
@@ -790,7 +789,6 @@
  padding: 4px 8px;
  border-radius: var(--radius-button);
  color: var(--foreground-60);
- cursor: pointer;
  font-size: 13px;
  }
  .maka-sidebar-button:hover { background: var(--hover); color: var(--foreground); }
@@ -948,7 +946,6 @@
  display: flex;
  align-items: center;
  gap: 8px;
- cursor: pointer;
  font-weight: 600;
  color: var(--accent);
  letter-spacing: 0.02em;
@@ -1158,7 +1155,6 @@
  border-radius: 7px;
  background: transparent;
  color: var(--foreground-50);
- cursor: pointer;
  transition: background 120ms ease, color 120ms ease, box-shadow 120ms ease;
  }
  .maka-code-block-copy:hover {
@@ -1315,7 +1311,6 @@
  border-radius: 7px;
  background: var(--background);
  color: var(--foreground-60);
- cursor: pointer;
  opacity: 0;
  /* PR-CHAT-COPY-BUTTON-POLISH-0 (WAWQAQ 10min loop): the copy
  button used to fade in on hover but never moved — felt like
@@ -1424,7 +1419,6 @@
  .maka-tool { padding: 0; }
  .maka-tool > summary {
  list-style: none;
- cursor: pointer;
  padding: 8px 12px;
  }
  .maka-tool > summary::-webkit-details-marker { display: none; }
@@ -1670,7 +1664,6 @@
  font-size: 13px;
  font-weight: 500;
  line-height: 1.2;
- cursor: pointer;
  transition: background 120ms ease, border-color 120ms ease, color 120ms ease, transform 120ms ease, box-shadow 120ms ease;
  }
  .maka-button:hover { background: var(--hover); }

apps/desktop/src/main/__tests__/cursor-convention-contract.test.ts

@@ -0,0 +1,57 @@
+/**
+ * Static-analysis contract for the native cursor convention.
+ *
+ * Native macOS / Windows reserve the pointing-hand cursor (`cursor: pointer`)
+ * for hyperlinks; every other control uses the default arrow. Only the
+ * link-styled in-app nav button (`.maka-markdown-link-internal`) may carry it.
+ * The runtime look-and-feel (which element shows which cursor) is still
+ * verified in a real window — this is the source bound.
+ */
+
+import { strict as assert } from 'node:assert';
+import { readFile } from 'node:fs/promises';
+import { describe, it } from 'node:test';
+import { join } from 'node:path';
+
+const STYLES_PATH = join(process.cwd(), 'src', 'renderer', 'styles.css');
+const TOKENS_PATH = join(process.cwd(), 'src', 'renderer', 'maka-tokens.css');
+
+/** Only the link-styled in-app nav button may carry the hand cursor. */
+const CURSOR_POINTER_ALLOWLIST = ['.maka-markdown-link-internal'];
+
+/**
+ * Selectors of every rule that declares `cursor: pointer`, sorted. Comments are
+ * stripped first; each hit walks back to the `{` that opens its rule and takes
+ * the selector after the previous block boundary. Depth is ignored, so a
+ * `cursor: pointer` hidden inside an at-rule (e.g. `@media`) is still caught.
+ */
+function selectorsWithHandCursor(css: string): string[] {
+ const stripped = css.replace(/\/\*[\s\S]*?\*\//g, '');
+ const selectors: string[] = [];
+ const re = /cursor:\s*pointer/g;
+ for (let m = re.exec(stripped); m; m = re.exec(stripped)) {
+ const open = stripped.lastIndexOf('{', m.index);
+ selectors.push(stripped.slice(0, open).split(/[{}]/).pop()?.trim() ?? '');
+ }
+ return selectors.sort();
+}
+
+describe('native cursor convention contract', () => {
+ it('styles.css: cursor:pointer lives only on the link-styled nav button', async () => {
+ const css = await readFile(STYLES_PATH, 'utf8');
+ assert.deepEqual(
+ selectorsWithHandCursor(css),
+ [...CURSOR_POINTER_ALLOWLIST].sort(),
+ 'Only `.maka-markdown-link-internal` may carry `cursor: pointer` — it presents as a link, and native macOS reserves the hand for links while every other control uses the default arrow. Drop the declaration, or reuse the link class if the element genuinely is the in-app link button.',
+ );
+ });
+
+ it('maka-tokens.css: defines no cursor:pointer', async () => {
+ const css = await readFile(TOKENS_PATH, 'utf8');
+ assert.deepEqual(
+ selectorsWithHandCursor(css),
+ [],
+ 'Design tokens must not set `cursor: pointer`; the hand cursor belongs only on the link-styled nav button in styles.css.',
+ );
+ });
+});

apps/desktop/src/main/__tests__/localized-main-shell-contract.test.ts

@@ -478,7 +478,13 @@ describe('localized main shell contract', () => {
  assert.ok(workspaceTopActions, '.maka-workspace-top-actions rule must exist');
  assert.ok(workspaceFeedbackAction, '.maka-workspace-feedback-action rule must exist');
  assert.match(workspaceTopActions, /position:\s*absolute/);
- assert.match(workspaceTopActions, /top:\s*11px/);
+ // PR-TITLEBAR-ROW-BASELINE: the right-side workspace top-actions
+ // share the single titlebar baseline with the two left strips —
+ // anchored on var(--maka-titlebar-control-safe-top), never a
+ // hardcoded vertical offset. We assert the baseline reference, not
+ // the per-container correction constant (geometry, free to tune):
+ // the invariant is that all three clusters key off the one baseline.
+ assert.match(workspaceTopActions, /top:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\)/);
  assert.match(workspaceTopActions, /right:\s*24px/);
  assert.match(workspaceTopActions, /gap:\s*6px/);
  assert.match(workspaceFeedbackAction, /font-size:\s*11px/);
@@ -528,7 +534,15 @@ describe('localized main shell contract', () => {
  assert.ok(collapsedTopbar, '.maka-collapsed-drag-strip rule must exist');
  assert.match(collapsedTopbar, /min-height:\s*38px/);
  assert.match(styles, /--maka-titlebar-control-safe-left:\s*94px/);
- assert.match(collapsedTopbar, /padding:\s*8px 12px 0 var\(--maka-titlebar-control-safe-left\)/);
+ // PR-TITLEBAR-ROW-BASELINE: the macOS window has ONE physical
+ // titlebar row (traffic-light center). All three top icon clusters
+ // — sidebar header strip, collapsed strip, workspace top-actions —
+ // center their 24px icons on the single --maka-titlebar-control-safe-top
+ // baseline so the row can't jump when the sidebar collapses/expands.
+ // Each cluster applies its own small per-container correction; no
+ // cluster may reintroduce an independent vertical baseline.
+ assert.match(styles, /--maka-titlebar-control-safe-top:\s*20px/);
+ assert.match(collapsedTopbar, /padding:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\) 12px 0 var\(--maka-titlebar-control-safe-left\)/);
  assert.match(collapsedTopbar, /-webkit-app-region:\s*drag/);
  const collapsedTopbarButton = extractCssRule(styles, '.maka-collapsed-topbar-button');
  assert.ok(collapsedTopbarButton, '.maka-collapsed-topbar-button rule must exist');
@@ -538,6 +552,10 @@ describe('localized main shell contract', () => {
  assert.match(sidebarTopBar, /justify-content:\s*space-between/);
  assert.match(sidebarTopBar, /box-sizing:\s*border-box/);
  assert.match(sidebarTopBar, /padding-left:\s*calc\(var\(--maka-titlebar-control-safe-left\) - 10px\)/);
+ // same shared vertical baseline as the collapsed strip + workspace
+ // top-actions — references the one var(--maka-titlebar-control-safe-top),
+ // with its own per-container correction constant (not asserted).
+ assert.match(sidebarTopBar, /padding-top:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\)/);
  assert.match(styles, /(?:^|\n)\.maka-nav-icon\s*\{[\s\S]*?width:\s*18px[\s\S]*?height:\s*18px/);
  assert.match(styles, /\.maka-sidebar-modules\b/);
  assert.doesNotMatch(styles, /\.maka-sidebar-module-hint\b/);
@@ -561,10 +579,10 @@ describe('localized main shell contract', () => {
  const icon = await stat(iconPath);
  const iconBuffer = await readFile(iconPath);
 
- assert.ok(icon.size > 1_400_000, 'the edge-filled user-provided PNG icon must be present as the desktop app icon asset');
+ assert.ok(icon.size > 700_000, 'the padded macOS-safe-area PNG icon (PR #75) must be present as the desktop app icon asset');
  assert.equal(iconBuffer.toString('ascii', 1, 4), 'PNG', 'desktop app icon must remain a PNG asset');
- assert.equal(iconBuffer.readUInt32BE(16), 1254, 'desktop app icon width must match the supplied edge-filled icon');
- assert.equal(iconBuffer.readUInt32BE(20), 1254, 'desktop app icon height must match the supplied edge-filled icon');
+ assert.equal(iconBuffer.readUInt32BE(16), 1024, 'desktop app icon width must match the supplied 1024² padded icon (PR #75)');
+ assert.equal(iconBuffer.readUInt32BE(20), 1024, 'desktop app icon height must match the supplied 1024² padded icon (PR #75)');
  assert.equal(iconBuffer[25], 6, 'desktop app icon must be RGBA so the rounded icon corners stay transparent');
  assert.match(tokens, /--background:\s*oklch\(1\.000 0 0\);/);
  assert.match(tokens, /--surface-canvas:\s*oklch\(0\.935 0 0\);/);

apps/desktop/src/renderer/maka-tokens.css

@@ -763,7 +763,6 @@
  padding: 6px 10px;
  border-radius: var(--radius-button);
  color: var(--foreground-80);
- cursor: pointer;
  font-size: 14px;
  line-height: 1.4;
  user-select: none;
@@ -790,7 +789,6 @@
  padding: 4px 8px;
  border-radius: var(--radius-button);
  color: var(--foreground-60);
- cursor: pointer;
  font-size: 13px;
  }
  .maka-sidebar-button:hover { background: var(--hover); color: var(--foreground); }
@@ -948,7 +946,6 @@
  display: flex;
  align-items: center;
  gap: 8px;
- cursor: pointer;
  font-weight: 600;
  color: var(--accent);
  letter-spacing: 0.02em;
@@ -1158,7 +1155,6 @@
  border-radius: 7px;
  background: transparent;
  color: var(--foreground-50);
- cursor: pointer;
  transition: background 120ms ease, color 120ms ease, box-shadow 120ms ease;
  }
  .maka-code-block-copy:hover {
@@ -1315,7 +1311,6 @@
  border-radius: 7px;
  background: var(--background);
  color: var(--foreground-60);
- cursor: pointer;
  opacity: 0;
  /* PR-CHAT-COPY-BUTTON-POLISH-0 (WAWQAQ 10min loop): the copy
  button used to fade in on hover but never moved — felt like
@@ -1424,7 +1419,6 @@
  .maka-tool { padding: 0; }
  .maka-tool > summary {
  list-style: none;
- cursor: pointer;
  padding: 8px 12px;
  }
  .maka-tool > summary::-webkit-details-marker { display: none; }
@@ -1670,7 +1664,6 @@
  font-size: 13px;
  font-weight: 500;
  line-height: 1.2;
- cursor: pointer;
  transition: background 120ms ease, border-color 120ms ease, color 120ms ease, transform 120ms ease, box-shadow 120ms ease;
  }
  .maka-button:hover { background: var(--hover); }

apps/desktop/src/main/__tests__/cursor-convention-contract.test.ts

@@ -0,0 +1,57 @@
+/**
+ * Static-analysis contract for the native cursor convention.
+ *
+ * Native macOS / Windows reserve the pointing-hand cursor (`cursor: pointer`)
+ * for hyperlinks; every other control uses the default arrow. Only the
+ * link-styled in-app nav button (`.maka-markdown-link-internal`) may carry it.
+ * The runtime look-and-feel (which element shows which cursor) is still
+ * verified in a real window — this is the source bound.
+ */
+
+import { strict as assert } from 'node:assert';
+import { readFile } from 'node:fs/promises';
+import { describe, it } from 'node:test';
+import { join } from 'node:path';
+
+const STYLES_PATH = join(process.cwd(), 'src', 'renderer', 'styles.css');
+const TOKENS_PATH = join(process.cwd(), 'src', 'renderer', 'maka-tokens.css');
+
+/** Only the link-styled in-app nav button may carry the hand cursor. */
+const CURSOR_POINTER_ALLOWLIST = ['.maka-markdown-link-internal'];
+
+/**
+ * Selectors of every rule that declares `cursor: pointer`, sorted. Comments are
+ * stripped first; each hit walks back to the `{` that opens its rule and takes
+ * the selector after the previous block boundary. Depth is ignored, so a
+ * `cursor: pointer` hidden inside an at-rule (e.g. `@media`) is still caught.
+ */
+function selectorsWithHandCursor(css: string): string[] {
+ const stripped = css.replace(/\/\*[\s\S]*?\*\//g, '');
+ const selectors: string[] = [];
+ const re = /cursor:\s*pointer/g;
+ for (let m = re.exec(stripped); m; m = re.exec(stripped)) {
+ const open = stripped.lastIndexOf('{', m.index);
+ selectors.push(stripped.slice(0, open).split(/[{}]/).pop()?.trim() ?? '');
+ }
+ return selectors.sort();
+}
+
+describe('native cursor convention contract', () => {
+ it('styles.css: cursor:pointer lives only on the link-styled nav button', async () => {
+ const css = await readFile(STYLES_PATH, 'utf8');
+ assert.deepEqual(
+ selectorsWithHandCursor(css),
+ [...CURSOR_POINTER_ALLOWLIST].sort(),
+ 'Only `.maka-markdown-link-internal` may carry `cursor: pointer` — it presents as a link, and native macOS reserves the hand for links while every other control uses the default arrow. Drop the declaration, or reuse the link class if the element genuinely is the in-app link button.',
+ );
+ });
+
+ it('maka-tokens.css: defines no cursor:pointer', async () => {
+ const css = await readFile(TOKENS_PATH, 'utf8');
+ assert.deepEqual(
+ selectorsWithHandCursor(css),
+ [],
+ 'Design tokens must not set `cursor: pointer`; the hand cursor belongs only on the link-styled nav button in styles.css.',
+ );
+ });
+});

apps/desktop/src/main/__tests__/localized-main-shell-contract.test.ts

@@ -478,7 +478,13 @@ describe('localized main shell contract', () => {
  assert.ok(workspaceTopActions, '.maka-workspace-top-actions rule must exist');
  assert.ok(workspaceFeedbackAction, '.maka-workspace-feedback-action rule must exist');
  assert.match(workspaceTopActions, /position:\s*absolute/);
- assert.match(workspaceTopActions, /top:\s*11px/);
+ // PR-TITLEBAR-ROW-BASELINE: the right-side workspace top-actions
+ // share the single titlebar baseline with the two left strips —
+ // anchored on var(--maka-titlebar-control-safe-top), never a
+ // hardcoded vertical offset. We assert the baseline reference, not
+ // the per-container correction constant (geometry, free to tune):
+ // the invariant is that all three clusters key off the one baseline.
+ assert.match(workspaceTopActions, /top:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\)/);
  assert.match(workspaceTopActions, /right:\s*24px/);
  assert.match(workspaceTopActions, /gap:\s*6px/);
  assert.match(workspaceFeedbackAction, /font-size:\s*11px/);
@@ -528,7 +534,15 @@ describe('localized main shell contract', () => {
  assert.ok(collapsedTopbar, '.maka-collapsed-drag-strip rule must exist');
  assert.match(collapsedTopbar, /min-height:\s*38px/);
  assert.match(styles, /--maka-titlebar-control-safe-left:\s*94px/);
- assert.match(collapsedTopbar, /padding:\s*8px 12px 0 var\(--maka-titlebar-control-safe-left\)/);
+ // PR-TITLEBAR-ROW-BASELINE: the macOS window has ONE physical
+ // titlebar row (traffic-light center). All three top icon clusters
+ // — sidebar header strip, collapsed strip, workspace top-actions —
+ // center their 24px icons on the single --maka-titlebar-control-safe-top
+ // baseline so the row can't jump when the sidebar collapses/expands.
+ // Each cluster applies its own small per-container correction; no
+ // cluster may reintroduce an independent vertical baseline.
+ assert.match(styles, /--maka-titlebar-control-safe-top:\s*20px/);
+ assert.match(collapsedTopbar, /padding:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\) 12px 0 var\(--maka-titlebar-control-safe-left\)/);
  assert.match(collapsedTopbar, /-webkit-app-region:\s*drag/);
  const collapsedTopbarButton = extractCssRule(styles, '.maka-collapsed-topbar-button');
  assert.ok(collapsedTopbarButton, '.maka-collapsed-topbar-button rule must exist');
@@ -538,6 +552,10 @@ describe('localized main shell contract', () => {
  assert.match(sidebarTopBar, /justify-content:\s*space-between/);
  assert.match(sidebarTopBar, /box-sizing:\s*border-box/);
  assert.match(sidebarTopBar, /padding-left:\s*calc\(var\(--maka-titlebar-control-safe-left\) - 10px\)/);
+ // same shared vertical baseline as the collapsed strip + workspace
+ // top-actions — references the one var(--maka-titlebar-control-safe-top),
+ // with its own per-container correction constant (not asserted).
+ assert.match(sidebarTopBar, /padding-top:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\)/);
  assert.match(styles, /(?:^|\n)\.maka-nav-icon\s*\{[\s\S]*?width:\s*18px[\s\S]*?height:\s*18px/);
  assert.match(styles, /\.maka-sidebar-modules\b/);
  assert.doesNotMatch(styles, /\.maka-sidebar-module-hint\b/);
@@ -561,10 +579,10 @@ describe('localized main shell contract', () => {
  const icon = await stat(iconPath);
  const iconBuffer = await readFile(iconPath);
 
- assert.ok(icon.size > 1_400_000, 'the edge-filled user-provided PNG icon must be present as the desktop app icon asset');
+ assert.ok(icon.size > 700_000, 'the padded macOS-safe-area PNG icon (PR #75) must be present as the desktop app icon asset');
  assert.equal(iconBuffer.toString('ascii', 1, 4), 'PNG', 'desktop app icon must remain a PNG asset');
- assert.equal(iconBuffer.readUInt32BE(16), 1254, 'desktop app icon width must match the supplied edge-filled icon');
- assert.equal(iconBuffer.readUInt32BE(20), 1254, 'desktop app icon height must match the supplied edge-filled icon');
+ assert.equal(iconBuffer.readUInt32BE(16), 1024, 'desktop app icon width must match the supplied 1024² padded icon (PR #75)');
+ assert.equal(iconBuffer.readUInt32BE(20), 1024, 'desktop app icon height must match the supplied 1024² padded icon (PR #75)');
  assert.equal(iconBuffer[25], 6, 'desktop app icon must be RGBA so the rounded icon corners stay transparent');
  assert.match(tokens, /--background:\s*oklch\(1\.000 0 0\);/);
  assert.match(tokens, /--surface-canvas:\s*oklch\(0\.935 0 0\);/);

apps/desktop/src/renderer/maka-tokens.css

@@ -763,7 +763,6 @@
  padding: 6px 10px;
  border-radius: var(--radius-button);
  color: var(--foreground-80);
- cursor: pointer;
  font-size: 14px;
  line-height: 1.4;
  user-select: none;
@@ -790,7 +789,6 @@
  padding: 4px 8px;
  border-radius: var(--radius-button);
  color: var(--foreground-60);
- cursor: pointer;
  font-size: 13px;
  }
  .maka-sidebar-button:hover { background: var(--hover); color: var(--foreground); }
@@ -948,7 +946,6 @@
  display: flex;
  align-items: center;
  gap: 8px;
- cursor: pointer;
  font-weight: 600;
  color: var(--accent);
  letter-spacing: 0.02em;
@@ -1158,7 +1155,6 @@
  border-radius: 7px;
  background: transparent;
  color: var(--foreground-50);
- cursor: pointer;
  transition: background 120ms ease, color 120ms ease, box-shadow 120ms ease;
  }
  .maka-code-block-copy:hover {
@@ -1315,7 +1311,6 @@
  border-radius: 7px;
  background: var(--background);
  color: var(--foreground-60);
- cursor: pointer;
  opacity: 0;
  /* PR-CHAT-COPY-BUTTON-POLISH-0 (WAWQAQ 10min loop): the copy
  button used to fade in on hover but never moved — felt like
@@ -1424,7 +1419,6 @@
  .maka-tool { padding: 0; }
  .maka-tool > summary {
  list-style: none;
- cursor: pointer;
  padding: 8px 12px;
  }
  .maka-tool > summary::-webkit-details-marker { display: none; }
@@ -1670,7 +1664,6 @@
  font-size: 13px;
  font-weight: 500;
  line-height: 1.2;
- cursor: pointer;
  transition: background 120ms ease, border-color 120ms ease, color 120ms ease, transform 120ms ease, box-shadow 120ms ease;
  }
  .maka-button:hover { background: var(--hover); }

apps/desktop/src/main/__tests__/cursor-convention-contract.test.ts

@@ -0,0 +1,57 @@
+/**
+ * Static-analysis contract for the native cursor convention.
+ *
+ * Native macOS / Windows reserve the pointing-hand cursor (`cursor: pointer`)
+ * for hyperlinks; every other control uses the default arrow. Only the
+ * link-styled in-app nav button (`.maka-markdown-link-internal`) may carry it.
+ * The runtime look-and-feel (which element shows which cursor) is still
+ * verified in a real window — this is the source bound.
+ */
+
+import { strict as assert } from 'node:assert';
+import { readFile } from 'node:fs/promises';
+import { describe, it } from 'node:test';
+import { join } from 'node:path';
+
+const STYLES_PATH = join(process.cwd(), 'src', 'renderer', 'styles.css');
+const TOKENS_PATH = join(process.cwd(), 'src', 'renderer', 'maka-tokens.css');
+
+/** Only the link-styled in-app nav button may carry the hand cursor. */
+const CURSOR_POINTER_ALLOWLIST = ['.maka-markdown-link-internal'];
+
+/**
+ * Selectors of every rule that declares `cursor: pointer`, sorted. Comments are
+ * stripped first; each hit walks back to the `{` that opens its rule and takes
+ * the selector after the previous block boundary. Depth is ignored, so a
+ * `cursor: pointer` hidden inside an at-rule (e.g. `@media`) is still caught.
+ */
+function selectorsWithHandCursor(css: string): string[] {
+ const stripped = css.replace(/\/\*[\s\S]*?\*\//g, '');
+ const selectors: string[] = [];
+ const re = /cursor:\s*pointer/g;
+ for (let m = re.exec(stripped); m; m = re.exec(stripped)) {
+ const open = stripped.lastIndexOf('{', m.index);
+ selectors.push(stripped.slice(0, open).split(/[{}]/).pop()?.trim() ?? '');
+ }
+ return selectors.sort();
+}
+
+describe('native cursor convention contract', () => {
+ it('styles.css: cursor:pointer lives only on the link-styled nav button', async () => {
+ const css = await readFile(STYLES_PATH, 'utf8');
+ assert.deepEqual(
+ selectorsWithHandCursor(css),
+ [...CURSOR_POINTER_ALLOWLIST].sort(),
+ 'Only `.maka-markdown-link-internal` may carry `cursor: pointer` — it presents as a link, and native macOS reserves the hand for links while every other control uses the default arrow. Drop the declaration, or reuse the link class if the element genuinely is the in-app link button.',
+ );
+ });
+
+ it('maka-tokens.css: defines no cursor:pointer', async () => {
+ const css = await readFile(TOKENS_PATH, 'utf8');
+ assert.deepEqual(
+ selectorsWithHandCursor(css),
+ [],
+ 'Design tokens must not set `cursor: pointer`; the hand cursor belongs only on the link-styled nav button in styles.css.',
+ );
+ });
+});

apps/desktop/src/main/__tests__/localized-main-shell-contract.test.ts

@@ -478,7 +478,13 @@ describe('localized main shell contract', () => {
  assert.ok(workspaceTopActions, '.maka-workspace-top-actions rule must exist');
  assert.ok(workspaceFeedbackAction, '.maka-workspace-feedback-action rule must exist');
  assert.match(workspaceTopActions, /position:\s*absolute/);
- assert.match(workspaceTopActions, /top:\s*11px/);
+ // PR-TITLEBAR-ROW-BASELINE: the right-side workspace top-actions
+ // share the single titlebar baseline with the two left strips —
+ // anchored on var(--maka-titlebar-control-safe-top), never a
+ // hardcoded vertical offset. We assert the baseline reference, not
+ // the per-container correction constant (geometry, free to tune):
+ // the invariant is that all three clusters key off the one baseline.
+ assert.match(workspaceTopActions, /top:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\)/);
  assert.match(workspaceTopActions, /right:\s*24px/);
  assert.match(workspaceTopActions, /gap:\s*6px/);
  assert.match(workspaceFeedbackAction, /font-size:\s*11px/);
@@ -528,7 +534,15 @@ describe('localized main shell contract', () => {
  assert.ok(collapsedTopbar, '.maka-collapsed-drag-strip rule must exist');
  assert.match(collapsedTopbar, /min-height:\s*38px/);
  assert.match(styles, /--maka-titlebar-control-safe-left:\s*94px/);
- assert.match(collapsedTopbar, /padding:\s*8px 12px 0 var\(--maka-titlebar-control-safe-left\)/);
+ // PR-TITLEBAR-ROW-BASELINE: the macOS window has ONE physical
+ // titlebar row (traffic-light center). All three top icon clusters
+ // — sidebar header strip, collapsed strip, workspace top-actions —
+ // center their 24px icons on the single --maka-titlebar-control-safe-top
+ // baseline so the row can't jump when the sidebar collapses/expands.
+ // Each cluster applies its own small per-container correction; no
+ // cluster may reintroduce an independent vertical baseline.
+ assert.match(styles, /--maka-titlebar-control-safe-top:\s*20px/);
+ assert.match(collapsedTopbar, /padding:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\) 12px 0 var\(--maka-titlebar-control-safe-left\)/);
  assert.match(collapsedTopbar, /-webkit-app-region:\s*drag/);
  const collapsedTopbarButton = extractCssRule(styles, '.maka-collapsed-topbar-button');
  assert.ok(collapsedTopbarButton, '.maka-collapsed-topbar-button rule must exist');
@@ -538,6 +552,10 @@ describe('localized main shell contract', () => {
  assert.match(sidebarTopBar, /justify-content:\s*space-between/);
  assert.match(sidebarTopBar, /box-sizing:\s*border-box/);
  assert.match(sidebarTopBar, /padding-left:\s*calc\(var\(--maka-titlebar-control-safe-left\) - 10px\)/);
+ // same shared vertical baseline as the collapsed strip + workspace
+ // top-actions — references the one var(--maka-titlebar-control-safe-top),
+ // with its own per-container correction constant (not asserted).
+ assert.match(sidebarTopBar, /padding-top:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\)/);
  assert.match(styles, /(?:^|\n)\.maka-nav-icon\s*\{[\s\S]*?width:\s*18px[\s\S]*?height:\s*18px/);
  assert.match(styles, /\.maka-sidebar-modules\b/);
  assert.doesNotMatch(styles, /\.maka-sidebar-module-hint\b/);
@@ -561,10 +579,10 @@ describe('localized main shell contract', () => {
  const icon = await stat(iconPath);
  const iconBuffer = await readFile(iconPath);
 
- assert.ok(icon.size > 1_400_000, 'the edge-filled user-provided PNG icon must be present as the desktop app icon asset');
+ assert.ok(icon.size > 700_000, 'the padded macOS-safe-area PNG icon (PR #75) must be present as the desktop app icon asset');
  assert.equal(iconBuffer.toString('ascii', 1, 4), 'PNG', 'desktop app icon must remain a PNG asset');
- assert.equal(iconBuffer.readUInt32BE(16), 1254, 'desktop app icon width must match the supplied edge-filled icon');
- assert.equal(iconBuffer.readUInt32BE(20), 1254, 'desktop app icon height must match the supplied edge-filled icon');
+ assert.equal(iconBuffer.readUInt32BE(16), 1024, 'desktop app icon width must match the supplied 1024² padded icon (PR #75)');
+ assert.equal(iconBuffer.readUInt32BE(20), 1024, 'desktop app icon height must match the supplied 1024² padded icon (PR #75)');
  assert.equal(iconBuffer[25], 6, 'desktop app icon must be RGBA so the rounded icon corners stay transparent');
  assert.match(tokens, /--background:\s*oklch\(1\.000 0 0\);/);
  assert.match(tokens, /--surface-canvas:\s*oklch\(0\.935 0 0\);/);

apps/desktop/src/renderer/maka-tokens.css

@@ -763,7 +763,6 @@
  padding: 6px 10px;
  border-radius: var(--radius-button);
  color: var(--foreground-80);
- cursor: pointer;
  font-size: 14px;
  line-height: 1.4;
  user-select: none;
@@ -790,7 +789,6 @@
  padding: 4px 8px;
  border-radius: var(--radius-button);
  color: var(--foreground-60);
- cursor: pointer;
  font-size: 13px;
  }
  .maka-sidebar-button:hover { background: var(--hover); color: var(--foreground); }
@@ -948,7 +946,6 @@
  display: flex;
  align-items: center;
  gap: 8px;
- cursor: pointer;
  font-weight: 600;
  color: var(--accent);
  letter-spacing: 0.02em;
@@ -1158,7 +1155,6 @@
  border-radius: 7px;
  background: transparent;
  color: var(--foreground-50);
- cursor: pointer;
  transition: background 120ms ease, color 120ms ease, box-shadow 120ms ease;
  }
  .maka-code-block-copy:hover {
@@ -1315,7 +1311,6 @@
  border-radius: 7px;
  background: var(--background);
  color: var(--foreground-60);
- cursor: pointer;
  opacity: 0;
  /* PR-CHAT-COPY-BUTTON-POLISH-0 (WAWQAQ 10min loop): the copy
  button used to fade in on hover but never moved — felt like
@@ -1424,7 +1419,6 @@
  .maka-tool { padding: 0; }
  .maka-tool > summary {
  list-style: none;
- cursor: pointer;
  padding: 8px 12px;
  }
  .maka-tool > summary::-webkit-details-marker { display: none; }
@@ -1670,7 +1664,6 @@
  font-size: 13px;
  font-weight: 500;
  line-height: 1.2;
- cursor: pointer;
  transition: background 120ms ease, border-color 120ms ease, color 120ms ease, transform 120ms ease, box-shadow 120ms ease;
  }
  .maka-button:hover { background: var(--hover); }

apps/desktop/src/main/__tests__/cursor-convention-contract.test.ts

@@ -0,0 +1,57 @@
+/**
+ * Static-analysis contract for the native cursor convention.
+ *
+ * Native macOS / Windows reserve the pointing-hand cursor (`cursor: pointer`)
+ * for hyperlinks; every other control uses the default arrow. Only the
+ * link-styled in-app nav button (`.maka-markdown-link-internal`) may carry it.
+ * The runtime look-and-feel (which element shows which cursor) is still
+ * verified in a real window — this is the source bound.
+ */
+
+import { strict as assert } from 'node:assert';
+import { readFile } from 'node:fs/promises';
+import { describe, it } from 'node:test';
+import { join } from 'node:path';
+
+const STYLES_PATH = join(process.cwd(), 'src', 'renderer', 'styles.css');
+const TOKENS_PATH = join(process.cwd(), 'src', 'renderer', 'maka-tokens.css');
+
+/** Only the link-styled in-app nav button may carry the hand cursor. */
+const CURSOR_POINTER_ALLOWLIST = ['.maka-markdown-link-internal'];
+
+/**
+ * Selectors of every rule that declares `cursor: pointer`, sorted. Comments are
+ * stripped first; each hit walks back to the `{` that opens its rule and takes
+ * the selector after the previous block boundary. Depth is ignored, so a
+ * `cursor: pointer` hidden inside an at-rule (e.g. `@media`) is still caught.
+ */
+function selectorsWithHandCursor(css: string): string[] {
+ const stripped = css.replace(/\/\*[\s\S]*?\*\//g, '');
+ const selectors: string[] = [];
+ const re = /cursor:\s*pointer/g;
+ for (let m = re.exec(stripped); m; m = re.exec(stripped)) {
+ const open = stripped.lastIndexOf('{', m.index);
+ selectors.push(stripped.slice(0, open).split(/[{}]/).pop()?.trim() ?? '');
+ }
+ return selectors.sort();
+}
+
+describe('native cursor convention contract', () => {
+ it('styles.css: cursor:pointer lives only on the link-styled nav button', async () => {
+ const css = await readFile(STYLES_PATH, 'utf8');
+ assert.deepEqual(
+ selectorsWithHandCursor(css),
+ [...CURSOR_POINTER_ALLOWLIST].sort(),
+ 'Only `.maka-markdown-link-internal` may carry `cursor: pointer` — it presents as a link, and native macOS reserves the hand for links while every other control uses the default arrow. Drop the declaration, or reuse the link class if the element genuinely is the in-app link button.',
+ );
+ });
+
+ it('maka-tokens.css: defines no cursor:pointer', async () => {
+ const css = await readFile(TOKENS_PATH, 'utf8');
+ assert.deepEqual(
+ selectorsWithHandCursor(css),
+ [],
+ 'Design tokens must not set `cursor: pointer`; the hand cursor belongs only on the link-styled nav button in styles.css.',
+ );
+ });
+});

apps/desktop/src/main/__tests__/localized-main-shell-contract.test.ts

@@ -478,7 +478,13 @@ describe('localized main shell contract', () => {
  assert.ok(workspaceTopActions, '.maka-workspace-top-actions rule must exist');
  assert.ok(workspaceFeedbackAction, '.maka-workspace-feedback-action rule must exist');
  assert.match(workspaceTopActions, /position:\s*absolute/);
- assert.match(workspaceTopActions, /top:\s*11px/);
+ // PR-TITLEBAR-ROW-BASELINE: the right-side workspace top-actions
+ // share the single titlebar baseline with the two left strips —
+ // anchored on var(--maka-titlebar-control-safe-top), never a
+ // hardcoded vertical offset. We assert the baseline reference, not
+ // the per-container correction constant (geometry, free to tune):
+ // the invariant is that all three clusters key off the one baseline.
+ assert.match(workspaceTopActions, /top:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\)/);
  assert.match(workspaceTopActions, /right:\s*24px/);
  assert.match(workspaceTopActions, /gap:\s*6px/);
  assert.match(workspaceFeedbackAction, /font-size:\s*11px/);
@@ -528,7 +534,15 @@ describe('localized main shell contract', () => {
  assert.ok(collapsedTopbar, '.maka-collapsed-drag-strip rule must exist');
  assert.match(collapsedTopbar, /min-height:\s*38px/);
  assert.match(styles, /--maka-titlebar-control-safe-left:\s*94px/);
- assert.match(collapsedTopbar, /padding:\s*8px 12px 0 var\(--maka-titlebar-control-safe-left\)/);
+ // PR-TITLEBAR-ROW-BASELINE: the macOS window has ONE physical
+ // titlebar row (traffic-light center). All three top icon clusters
+ // — sidebar header strip, collapsed strip, workspace top-actions —
+ // center their 24px icons on the single --maka-titlebar-control-safe-top
+ // baseline so the row can't jump when the sidebar collapses/expands.
+ // Each cluster applies its own small per-container correction; no
+ // cluster may reintroduce an independent vertical baseline.
+ assert.match(styles, /--maka-titlebar-control-safe-top:\s*20px/);
+ assert.match(collapsedTopbar, /padding:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\) 12px 0 var\(--maka-titlebar-control-safe-left\)/);
  assert.match(collapsedTopbar, /-webkit-app-region:\s*drag/);
  const collapsedTopbarButton = extractCssRule(styles, '.maka-collapsed-topbar-button');
  assert.ok(collapsedTopbarButton, '.maka-collapsed-topbar-button rule must exist');
@@ -538,6 +552,10 @@ describe('localized main shell contract', () => {
  assert.match(sidebarTopBar, /justify-content:\s*space-between/);
  assert.match(sidebarTopBar, /box-sizing:\s*border-box/);
  assert.match(sidebarTopBar, /padding-left:\s*calc\(var\(--maka-titlebar-control-safe-left\) - 10px\)/);
+ // same shared vertical baseline as the collapsed strip + workspace
+ // top-actions — references the one var(--maka-titlebar-control-safe-top),
+ // with its own per-container correction constant (not asserted).
+ assert.match(sidebarTopBar, /padding-top:\s*calc\(var\(--maka-titlebar-control-safe-top\) - \d+px\)/);
  assert.match(styles, /(?:^|\n)\.maka-nav-icon\s*\{[\s\S]*?width:\s*18px[\s\S]*?height:\s*18px/);
  assert.match(styles, /\.maka-sidebar-modules\b/);
  assert.doesNotMatch(styles, /\.maka-sidebar-module-hint\b/);
@@ -561,10 +579,10 @@ describe('localized main shell contract', () => {
  const icon = await stat(iconPath);
  const iconBuffer = await readFile(iconPath);
 
- assert.ok(icon.size > 1_400_000, 'the edge-filled user-provided PNG icon must be present as the desktop app icon asset');
+ assert.ok(icon.size > 700_000, 'the padded macOS-safe-area PNG icon (PR #75) must be present as the desktop app icon asset');
  assert.equal(iconBuffer.toString('ascii', 1, 4), 'PNG', 'desktop app icon must remain a PNG asset');
- assert.equal(iconBuffer.readUInt32BE(16), 1254, 'desktop app icon width must match the supplied edge-filled icon');
- assert.equal(iconBuffer.readUInt32BE(20), 1254, 'desktop app icon height must match the supplied edge-filled icon');
+ assert.equal(iconBuffer.readUInt32BE(16), 1024, 'desktop app icon width must match the supplied 1024² padded icon (PR #75)');
+ assert.equal(iconBuffer.readUInt32BE(20), 1024, 'desktop app icon height must match the supplied 1024² padded icon (PR #75)');
  assert.equal(iconBuffer[25], 6, 'desktop app icon must be RGBA so the rounded icon corners stay transparent');
  assert.match(tokens, /--background:\s*oklch\(1\.000 0 0\);/);
  assert.match(tokens, /--surface-canvas:\s*oklch\(0\.935 0 0\);/);

apps/desktop/src/renderer/maka-tokens.css

@@ -763,7 +763,6 @@
  padding: 6px 10px;
  border-radius: var(--radius-button);
  color: var(--foreground-80);
- cursor: pointer;
  font-size: 14px;
  line-height: 1.4;
  user-select: none;
@@ -790,7 +789,6 @@
  padding: 4px 8px;
  border-radius: var(--radius-button);
  color: var(--foreground-60);
- cursor: pointer;
  font-size: 13px;
  }
  .maka-sidebar-button:hover { background: var(--hover); color: var(--foreground); }
@@ -948,7 +946,6 @@
  display: flex;
  align-items: center;
  gap: 8px;
- cursor: pointer;
  font-weight: 600;
  color: var(--accent);
  letter-spacing: 0.02em;
@@ -1158,7 +1155,6 @@
  border-radius: 7px;
  background: transparent;
  color: var(--foreground-50);
- cursor: pointer;
  transition: background 120ms ease, color 120ms ease, box-shadow 120ms ease;
  }
  .maka-code-block-copy:hover {
@@ -1315,7 +1311,6 @@
  border-radius: 7px;
  background: var(--background);
  color: var(--foreground-60);
- cursor: pointer;
  opacity: 0;
  /* PR-CHAT-COPY-BUTTON-POLISH-0 (WAWQAQ 10min loop): the copy
  button used to fade in on hover but never moved — felt like
@@ -1424,7 +1419,6 @@
  .maka-tool { padding: 0; }
  .maka-tool > summary {
  list-style: none;
- cursor: pointer;
  padding: 8px 12px;
  }
  .maka-tool > summary::-webkit-details-marker { display: none; }
@@ -1670,7 +1664,6 @@
  font-size: 13px;
  font-weight: 500;
  line-height: 1.2;
- cursor: pointer;
  transition: background 120ms ease, border-color 120ms ease, color 120ms ease, transform 120ms ease, box-shadow 120ms ease;
  }
  .maka-button:hover { background: var(--hover); }